Added new fileBrowserPrivate and fileHandler extension APIs

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 4462 matching lines @@
       {
         "name": "onDisabled",
         "description": "Fired when an app or extension has been disabled",
         "type": "function",
         "parameters": [{"name": "info", "$ref":"ExtensionInfo"}]
       }
     ]
   },
 
   {
+    "namespace":"fileSystem",
+    "nodoc": "true",
+    "functions": [
+      {
+        "name": "resolveLocalFileSystemURL",
+        "description": "Allows the user to look up the Entry for a file or directory referred to by a local URL. ",
+        "parameters": [
+          {
+            "name": "url",
+            "type": "string",
+            "description": "A URL referring to a local file in a filesystem."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name" : "entry",
+                "type": "object",
+                "optional": "true",
+                "description": "An Entry as a response to a file resolution request. It will have value of null if the request failed."
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+
+  {
     "namespace":"fileBrowserPrivate",
     "nodoc": "true",
+    "types": [
+      {
+        "id": "FileBrowserTask",
+        "type": "object",
+        "description": "Represents information about avaialble browser tasks.",

[ericu, 2011/03/31 21:31:06]

typo: available

[zel, 2011/04/01 03:01:35]

Done.

+        "properties": {
+          "taskId": {"type": "string", "description": "The unique identifier of the task."},
+          "title": {"type": "string", "description": "Task title."},
+          "iconUrl": {"type": "string", "description": "Task icon url (from chrome://extension-icon/...)"}
+        }
+      }
+    ],
     "functions": [
       {
         "name": "requestLocalFileSystem",
         "description": "Requests access to local file system",
         "parameters": [
           {
             "name": "callback",
             "type": "function",
             "optional": "false",
             "parameters": [
               {
+                "name" : "fileSystem",
                 "type": "object",
-                "isInstanceOf": "DOMFileSystem"
+                "optional": "true",
+                "description": "An DOMFileSystem instance for local file system access. null if the caller has no appropriate permissions."
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "getFileTasks",
+        "description": "Requests access to local file system",
+        "parameters": [
+          {
+            "name": "fileURLs",
+            "type": "array",
+            "description": "Array of selected file URLs",
+            "items": { "type": "string" }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name": "tasks",
+                "type": "array",
+                "items": {"$ref": "FileBrowserTask"},
+                "description": "The list of avalable tasks that can be performed on all of the passed file paths."

[ericu, 2011/03/31 21:31:06]

typo: available

[zel, 2011/04/01 03:01:35]

Done.

+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "executeTask",
+        "description": "Executes file browser task over selected files",
+        "parameters": [
+          {
+            "name": "taskId",
+            "type": "string",
+            "description": "The unique identifier of task to execute."
+          },
+          {
+            "name": "fileURLs",
+            "type": "array",
+            "description": "Array of file URLs",
+            "items": { "type": "string" }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "optional": "false",
+            "parameters": [
+              {
+                "name": "success",
+                "type": "boolean",
+                "optional": "true",
+                "description": "True of task executution was successfully initiated."

[ericu, 2011/03/31 21:31:06]

typo: execution

[zel, 2011/04/01 03:01:35]

Done.

               }
             ]
           }
         ]
       }
     ]
   },
 
   {
     "namespace":"webstorePrivate",
@@ skipping 370 matching lines @@
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
   }
 ]