Add idl for managing focus in app_shell

extensions/shell/common/api/shell_window.idl

Index: extensions/shell/common/api/shell_window.idl
diff --git a/extensions/shell/common/api/shell_window.idl b/extensions/shell/common/api/shell_window.idl
new file mode 100644
index 0000000000000000000000000000000000000000..9a6ef09cf2ae59e9ef4ec6050b10694f3cccf37c
--- /dev/null
+++ b/extensions/shell/common/api/shell_window.idl
@@ -0,0 +1,50 @@
+// Copyright 2014 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// Allows control of focused window in app_shell
+namespace shell.window {
+
+  dictionary RequestInfo {
+    // The id of the app making the request.
+    DOMString appId;
+  };
+
+  dictionary ShowInfo {
+    // The id of the app to show.
+    DOMString? appId;
+
+    // The name of the app to show.
+    DOMString? appName;
+  };
+
+  interface Functions {
+    // Bring the specified app to the foreground.  Can only be called by the
+    // master app.  In showInfo, one of appId or appName must be provided.
+    static void showApp(ShowInfo showInfo);
+
+    // Request the current app be brought to the foreground.  The request will
+    // be forwarded to the master app.
+    static void requestShow();
+
+    // Request the current app be hidden.  The request will be forwarded to the
+    // master app.
+    static void requestHide();
+  };
+
+  interface Events {
+    // Fired when an app requests to be shown.  Only the master app can receive
+    // this.
+    static void onShowRequest(RequestInfo info);
+
+    // Fired when an app requests to be hidden.  Only the master app can receive
+    // this.
+    static void onHideRequest(RequestInfo info);
+
+    // Fired when this app is shown.
+    static void onShow();
+
+    // Fired when this app is hidden.
+    static void onHide();
+  };
+};