@forgeax/app-shell 0.10.0 → 0.11.0

package/dist/window.d.ts

@@ -0,0 +1,31 @@
+type SurfacePane = 'left' | 'center';
+type SurfaceKind = 'plugin' | 'panel';
+/** Structural identity shared by in-window and detached surface carriers. */
+interface SurfaceDescriptor {
+    readonly kind: SurfaceKind;
+    readonly id: string;
+    readonly pane?: SurfacePane;
+    readonly instance?: string;
+}
+/** Complete carrier-neutral declaration for opening one detached surface. */
+interface DetachedWindowTarget {
+    readonly surface: SurfaceDescriptor;
+    readonly title: string;
+    readonly width: number;
+    readonly height: number;
+    readonly dockBehavior: 'close' | 'keep-anchor';
+}
+/** Presence of this factory declares that a surface may be detached. */
+interface DetachedWindowCapability<Context = void> {
+    createTarget(context: Context): DetachedWindowTarget;
+}
+/** Stable identity shared by keep-alive registries and physical carriers. */
+declare function surfaceKey(surface: SurfaceDescriptor): string;
+/** Deterministic, injective and carrier-safe label for the complete identity. */
+declare function surfaceWindowLabel(surface: SurfaceDescriptor): string;
+/** Encode only structural surface identity; product carrier policy stays outside. */
+declare function encodeSurfaceQuery(surface: SurfaceDescriptor): string;
+/** Decode structural identity, or null for a normal shell/invalid entry. */
+declare function decodeSurfaceFromLocation(search?: string): SurfaceDescriptor | null;
+
+export { type DetachedWindowCapability, type DetachedWindowTarget, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, decodeSurfaceFromLocation, encodeSurfaceQuery, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -0,0 +1,57 @@
+// src/window.ts
+function surfaceKey(surface) {
+  return JSON.stringify([
+    surface.kind,
+    surface.id,
+    surface.pane ?? null,
+    surface.instance ?? null
+  ]);
+}
+var BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+function utf8ToBase64Url(value) {
+  const bytes = new TextEncoder().encode(value);
+  let encoded = "";
+  for (let index = 0; index < bytes.length; index += 3) {
+    const first = bytes[index];
+    const second = bytes[index + 1];
+    const third = bytes[index + 2];
+    encoded += BASE64URL_ALPHABET[first >> 2];
+    encoded += BASE64URL_ALPHABET[(first & 3) << 4 | (second ?? 0) >> 4];
+    if (second !== void 0) {
+      encoded += BASE64URL_ALPHABET[(second & 15) << 2 | (third ?? 0) >> 6];
+    }
+    if (third !== void 0) encoded += BASE64URL_ALPHABET[third & 63];
+  }
+  return encoded;
+}
+function surfaceWindowLabel(surface) {
+  return `fx-surface-${utf8ToBase64Url(surfaceKey(surface))}`;
+}
+function encodeSurfaceQuery(surface) {
+  const params = new URLSearchParams();
+  params.set("surface", surface.kind);
+  params.set("id", surface.id);
+  if (surface.pane) params.set("pane", surface.pane);
+  if (surface.instance !== void 0) params.set("instance", surface.instance);
+  return params.toString();
+}
+function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? window.location.search : "") {
+  const params = new URLSearchParams(search);
+  const kind = params.get("surface");
+  const id = params.get("id");
+  if (!id || kind !== "plugin" && kind !== "panel") return null;
+  const pane = params.get("pane");
+  const instance = params.get("instance");
+  return {
+    kind,
+    id,
+    pane: pane === "left" || pane === "center" ? pane : void 0,
+    instance: instance ?? void 0
+  };
+}
+export {
+  decodeSurfaceFromLocation,
+  encodeSurfaceQuery,
+  surfaceKey,
+  surfaceWindowLabel
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/app-shell",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Generic Dock, Panel, Window, and Slot composition primitives",
   "license": "Apache-2.0",
   "type": "module",
@@ -17,6 +17,10 @@
       "types": "./dist/dock.d.ts",
       "import": "./dist/dock.js"
     },
+    "./window": {
+      "types": "./dist/window.d.ts",
+      "import": "./dist/window.js"
+    },
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
@@ -27,7 +31,7 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "bun test test",
-    "build": "tsup src/index.ts src/dock.ts src/react.tsx --format esm --dts --outDir dist && bun run scripts/copy-resize-css.ts && bun run scripts/copy-panel-css.ts",
+    "build": "tsup src/index.ts src/dock.ts src/window.ts src/react.tsx --format esm --dts --outDir dist && bun run scripts/copy-resize-css.ts && bun run scripts/copy-panel-css.ts",
     "check": "bun run typecheck && bun run test && bun run build",
     "release:preflight": "bun run scripts/release-preflight.ts"
   },