"Redirecting URLs to Packaged Apps" implementation: revised

chrome/common/extensions/api/app_runtime.idl

Index: chrome/common/extensions/api/app_runtime.idl
diff --git a/chrome/common/extensions/api/app_runtime.idl b/chrome/common/extensions/api/app_runtime.idl
index da8ddb885a9fdff4924676a59a7743a08a837db5..51b38626563dda5be5d805c729a0b052201f5290 100644
--- a/chrome/common/extensions/api/app_runtime.idl
+++ b/chrome/common/extensions/api/app_runtime.idl
@@ -15,12 +15,26 @@ namespace app.runtime {
     DOMString type;
   };
 
-  // Optional data for the launch.
+  // Optional data for the launch. Either <code>items</code>, or
+  // the pair (<code>url, referrerUrl</code>) can be present for any given
+  // launch.
   [inline_doc] dictionary LaunchData {
-    // The id of the file handler that the app is being invoked with.
+    // The ID of the file or URL handler that the app is being invoked with.
+    // Handler IDs are the top-level keys in the <code>file_handlers</code>
+    // and/or <code>url_handlers</code> dictionaries in the manifest.
     DOMString? id;
 
+    // The file entries for the <code>onLaunched</code> event triggered by a
+    // matching file handler in the <code>file_handlers</code> manifest key.
     LaunchItem[]? items;
+
+    // The URL for the <code>onLaunched</code> event triggered by a matching
+    // URL handler in the <code>url_handlers</code> manifest key.
+    DOMString? url;
+
+    // The referrer URL for the <code>onLaunched</code> event triggered by a
+    // matching URL handler in the <code>url_handlers</code> manifest key.
+    DOMString? referrerUrl;
   };
 
   interface Events {