@forgeax/app-shell 0.21.0 → 0.22.0

package/dist/{chunk-ZYCR2LSP.js → chunk-EEPX63DF.js}

@@ -68,6 +68,62 @@ function createPanelWindowingController() {
     }
   };
 }
+function createSurfaceWindowingController(options) {
+  const emptySnapshot = Object.freeze({});
+  const floating = /* @__PURE__ */ new Set();
+  const listeners = /* @__PURE__ */ new Set();
+  let snapshot = emptySnapshot;
+  const publish = () => {
+    snapshot = floating.size === 0 ? emptySnapshot : Object.freeze(Object.fromEntries([...floating].sort().map((key) => [key, true])));
+    for (const listener of listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  const markFloating = (surface) => {
+    const key = surfaceKey(surface);
+    if (floating.has(key)) return;
+    floating.add(key);
+    publish();
+  };
+  const markDocked = (surface) => {
+    if (!floating.delete(surfaceKey(surface))) return;
+    publish();
+  };
+  return {
+    snapshot: () => snapshot,
+    onChange(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    async detachSurface(surface, detachOptions) {
+      if (!options.manager.canDetach()) return false;
+      try {
+        options.beforeDetach?.(surface);
+      } catch {
+        return false;
+      }
+      markFloating(surface);
+      let opened = false;
+      try {
+        opened = await options.manager.openSurfaceWindow(surface, detachOptions);
+      } catch {
+        opened = false;
+      }
+      if (!opened) markDocked(surface);
+      return opened;
+    },
+    async redockSurface(surface) {
+      await options.manager.closeSurfaceWindow(surface);
+      markDocked(surface);
+    },
+    markSurfaceDocked: markDocked
+  };
+}
 function currentBrowserHost() {
   if (typeof window === "undefined" || typeof window.open !== "function") return void 0;
   return {
@@ -261,6 +317,7 @@ export {
   canOpenPanelWindow,
   shouldShowDetachedPlaceholder,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   createBrowserWindowManager,
   createExternalWindowManager,
   surfaceKey,

package/dist/react.js

@@ -1,6 +1,6 @@
 import {
   shouldShowDetachedPlaceholder
-} from "./chunk-ZYCR2LSP.js";
+} from "./chunk-EEPX63DF.js";
 
 // src/react.tsx
 import { createElement } from "react";

package/dist/window.d.ts

@@ -82,10 +82,23 @@ interface PanelWindowingController {
     openPanelWindow(panelId: string, capability: DetachedWindowCapability | undefined, options: OpenPanelWindowOptions): Promise<boolean>;
     panelForClosedSurface(surface: SurfaceDescriptor): string | undefined;
 }
+interface CreateSurfaceWindowingControllerOptions {
+    readonly manager: WindowManager;
+    readonly beforeDetach?: (surface: SurfaceDescriptor) => void;
+}
+interface SurfaceWindowingController {
+    snapshot(): Readonly<Record<string, true>>;
+    onChange(listener: () => void): () => void;
+    detachSurface(surface: SurfaceDescriptor, options?: DetachWindowOptions): Promise<boolean>;
+    redockSurface(surface: SurfaceDescriptor): Promise<void>;
+    markSurfaceDocked(surface: SurfaceDescriptor): void;
+}
 declare function canOpenPanelWindow(capability: DetachedWindowCapability | undefined, carrierAvailable: boolean): capability is DetachedWindowCapability;
 declare function shouldShowDetachedPlaceholder(floatingSurfaces: Readonly<Record<string, true>>, surface: SurfaceDescriptor): boolean;
 /** Product-neutral transaction joining a dock placement to a detached carrier. */
 declare function createPanelWindowingController(): PanelWindowingController;
+/** Product-neutral state machine joining floating presentation to a carrier. */
+declare function createSurfaceWindowingController(options: CreateSurfaceWindowingControllerOptions): SurfaceWindowingController;
 /** Product-neutral browser popup carrier with injected surface URL policy. */
 declare function createBrowserWindowManager(options: CreateBrowserWindowManagerOptions): WindowManager;
 /** Event-driven external-window lifecycle with all native policy injected. */
@@ -99,4 +112,4 @@ 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 BrowserPopupWindow, type BrowserWindowHost, type CreateBrowserWindowManagerOptions, type CreateExternalWindowManagerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type OpenPanelWindowOptions, type PanelWindowingController, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type WindowManager, canOpenPanelWindow, createBrowserWindowManager, createExternalWindowManager, createPanelWindowingController, decodeSurfaceFromLocation, encodeSurfaceQuery, shouldShowDetachedPlaceholder, surfaceKey, surfaceWindowLabel };
+export { type BrowserPopupWindow, type BrowserWindowHost, type CreateBrowserWindowManagerOptions, type CreateExternalWindowManagerOptions, type CreateSurfaceWindowingControllerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type OpenPanelWindowOptions, type PanelWindowingController, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type SurfaceWindowingController, type WindowManager, canOpenPanelWindow, createBrowserWindowManager, createExternalWindowManager, createPanelWindowingController, createSurfaceWindowingController, decodeSurfaceFromLocation, encodeSurfaceQuery, shouldShowDetachedPlaceholder, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -3,17 +3,19 @@ import {
   createBrowserWindowManager,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,
   surfaceKey,
   surfaceWindowLabel
-} from "./chunk-ZYCR2LSP.js";
+} from "./chunk-EEPX63DF.js";
 export {
   canOpenPanelWindow,
   createBrowserWindowManager,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/app-shell",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Generic Dock, Panel, Window, and Slot composition primitives",
   "license": "Apache-2.0",
   "type": "module",