@synopackageland/ui 0.25.14 → 0.25.16

package/dist/lib/nativeShell.d.ts

@@ -1,8 +1,40 @@
-/** Whether this page runs in the phone app and may go back to its App list. */
-export declare function canCloseToShell(): boolean;
 /**
- * Asks the phone app to go back to its App list. Call it from a tap: the app
+ * The Package Land launcher (the "shell") as seen from an App page in it. Its
+ * Home request, `{ v: 1, type: 'close' }`, takes the user back to the
+ * launcher's home. Two shells offer it:
+ *
+ * - The phone app injects `window.SynoPkgNative` (SynoPkgNative v1) into a
+ *   registered App's main frame only; its optional `features` lists the
+ *   requests it understands beyond the v1 baseline, `close` among them. The
+ *   request goes through the bridge's `post`.
+ * - The browser launcher opens each App in a same-origin frame named
+ *   `synopkg-shell:1:<features>` (comma-separated, e.g. `synopkg-shell:1:close`).
+ *   The request is posted to the parent window at this page's own origin.
+ *
+ * In a plain browser tab, a DSM window or any other frame there is no shell
+ * and nothing here offers anything. The shell honors a request only right
+ * after a tap, so call it from a click.
+ */
+type CloseMessage = {
+    v: 1;
+    type: 'close';
+};
+type ShellBridge = {
+    protocol: number;
+    features?: readonly unknown[];
+    post(message: CloseMessage): void;
+};
+type ShellWindow = Pick<Window, 'name' | 'parent' | 'top' | 'location'> & {
+    SynoPkgNative?: Partial<ShellBridge>;
+};
+/** The name the browser launcher gives an App's frame, and the features it lists. */
+export declare const SHELL_FRAME_PREFIX = "synopkg-shell:1:";
+/** Whether this page runs in the launcher (phone app or browser) and may go back to its home. */
+export declare function canCloseToShell(view?: ShellWindow | undefined): boolean;
+/**
+ * Asks the launcher to go back to its home. Call it from a tap: the launcher
  * ignores a request without a recent user gesture. Returns false when there is
- * no phone app to ask.
+ * no launcher to ask.
  */
-export declare function closeToShell(): boolean;
+export declare function closeToShell(view?: ShellWindow | undefined): boolean;
+export {};

package/dist/reka-runtime.json

@@ -3,7 +3,7 @@
   "version": "2.11.0",
   "delivery": "bundled-patched-esm",
   "patchManifestSha256": "9c5b9c9a162fa584b4695a683368a4484b3ac6e70177fd063b77aa618c051627",
-  "bundleSha256": "414632bf6f179e9856f560fa3d5c2cf03912cb5993cfc8491ff011f395eea148",
+  "bundleSha256": "0613c4649ba3a597c7c6d972e93541034089c6176d953a0a7d2426dc0fe6165a",
   "sourceHashes": {
     "shared/useBodyScrollLock.js": "287bfb604318c4202769e4b5191896eaf0e52a952e1de898967cbe09467fcfda",
     "DismissableLayer/DismissableLayer.js": "3c8d248f0a32e01f89ca1f6202b1bb691bf5d0e4012a92535e161c35e69cdc32",