@forgeax/app-shell 0.13.0 → 0.14.0

package/dist/window.d.ts

@@ -73,6 +73,19 @@ interface CreateExternalWindowManagerOptions {
     readonly loadHost: () => Promise<ExternalWindowHost | undefined>;
     readonly createdTimeoutMs?: number;
 }
+interface OpenPanelWindowOptions {
+    readonly detachSurface: (surface: SurfaceDescriptor, options: Required<Pick<DetachWindowOptions, 'title' | 'width' | 'height'>> & Pick<DetachWindowOptions, 'x' | 'y'>) => Promise<boolean>;
+    readonly position?: Readonly<Pick<DetachWindowOptions, 'x' | 'y'>>;
+    readonly closeDockPanel?: () => void;
+}
+interface PanelWindowingController {
+    openPanelWindow(panelId: string, capability: DetachedWindowCapability | undefined, options: OpenPanelWindowOptions): Promise<boolean>;
+    panelForClosedSurface(surface: SurfaceDescriptor): string | undefined;
+}
+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 browser popup carrier with injected surface URL policy. */
 declare function createBrowserWindowManager(options: CreateBrowserWindowManagerOptions): WindowManager;
 /** Event-driven external-window lifecycle with all native policy injected. */
@@ -86,4 +99,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 SurfaceDescriptor, type SurfaceKind, type SurfacePane, type WindowManager, createBrowserWindowManager, createExternalWindowManager, decodeSurfaceFromLocation, encodeSurfaceQuery, surfaceKey, surfaceWindowLabel };
+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 };

package/dist/window.js

@@ -1,4 +1,73 @@
 // src/window.ts
+function canOpenPanelWindow(capability, carrierAvailable) {
+  return capability !== void 0 && carrierAvailable;
+}
+function shouldShowDetachedPlaceholder(floatingSurfaces, surface) {
+  return floatingSurfaces[surfaceKey(surface)] === true;
+}
+function createPanelWindowingController() {
+  const detachedPanels = /* @__PURE__ */ new Map();
+  return {
+    async openPanelWindow(panelId, capability, options) {
+      if (!capability) return false;
+      let target;
+      try {
+        target = capability.createTarget();
+      } catch {
+        return false;
+      }
+      const key = surfaceKey(target.surface);
+      const closesPlacement = target.dockBehavior === "close";
+      let reservation;
+      if (closesPlacement) {
+        if (!options.closeDockPanel || detachedPanels.has(key)) return false;
+        reservation = { panelId, state: "pending" };
+        detachedPanels.set(key, reservation);
+      }
+      let opened;
+      try {
+        opened = await options.detachSurface(target.surface, {
+          title: target.title,
+          width: target.width,
+          height: target.height,
+          ...options.position
+        });
+      } catch {
+        if (reservation && detachedPanels.get(key) === reservation) detachedPanels.delete(key);
+        return false;
+      }
+      if (!opened) {
+        if (reservation && detachedPanels.get(key) === reservation) detachedPanels.delete(key);
+        return false;
+      }
+      if (closesPlacement) {
+        if (detachedPanels.get(key) !== reservation) return false;
+        try {
+          options.closeDockPanel();
+        } catch {
+          if (detachedPanels.get(key) === reservation) detachedPanels.delete(key);
+          return false;
+        }
+        reservation.state = "leased";
+      }
+      return true;
+    },
+    panelForClosedSurface(surface) {
+      const key = surfaceKey(surface);
+      const lease = detachedPanels.get(key);
+      if (lease?.state === "pending") {
+        detachedPanels.delete(key);
+        return void 0;
+      }
+      if (lease?.state === "leased") {
+        queueMicrotask(() => {
+          if (detachedPanels.get(key) === lease) detachedPanels.delete(key);
+        });
+      }
+      return lease?.state === "leased" ? lease.panelId : void 0;
+    }
+  };
+}
 function currentBrowserHost() {
   if (typeof window === "undefined" || typeof window.open !== "function") return void 0;
   return {
@@ -188,10 +257,13 @@ function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? wind
   };
 }
 export {
+  canOpenPanelWindow,
   createBrowserWindowManager,
   createExternalWindowManager,
+  createPanelWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
+  shouldShowDetachedPlaceholder,
   surfaceKey,
   surfaceWindowLabel
 };

package/package.json

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