@forgeax/app-shell 0.21.0 → 0.23.0

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

@@ -1,4 +1,43 @@
 // src/window.ts
+function createEdgePinStore() {
+  const emptySnapshot = Object.freeze({});
+  const pinnedByGroup = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  let snapshot = emptySnapshot;
+  const publish = () => {
+    snapshot = pinnedByGroup.size === 0 ? emptySnapshot : Object.freeze(Object.fromEntries([...pinnedByGroup.entries()].sort(([a], [b]) => a.localeCompare(b))));
+    for (const listener of listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  return {
+    snapshot: () => snapshot,
+    onChange(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    pinnedIn: (groupId) => pinnedByGroup.get(groupId),
+    setPinned(groupId, panelId) {
+      if (panelId === void 0) {
+        if (!pinnedByGroup.delete(groupId)) return;
+      } else {
+        if (pinnedByGroup.get(groupId) === panelId) return;
+        pinnedByGroup.set(groupId, panelId);
+      }
+      publish();
+    },
+    clear() {
+      if (pinnedByGroup.size === 0) return;
+      pinnedByGroup.clear();
+      publish();
+    }
+  };
+}
 function canOpenPanelWindow(capability, carrierAvailable) {
   return capability !== void 0 && carrierAvailable;
 }
@@ -68,6 +107,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 {
@@ -258,9 +353,11 @@ function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? wind
 }
 
 export {
+  createEdgePinStore,
   canOpenPanelWindow,
   shouldShowDetachedPlaceholder,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   createBrowserWindowManager,
   createExternalWindowManager,
   surfaceKey,

package/dist/react.js

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

package/dist/window.d.ts

@@ -82,10 +82,32 @@ 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;
+}
+interface EdgePinStore {
+    snapshot(): Readonly<Record<string, string>>;
+    onChange(listener: () => void): () => void;
+    pinnedIn(groupId: string): string | undefined;
+    setPinned(groupId: string, panelId: string | undefined): void;
+    clear(): void;
+}
+/** Product-neutral state for one mutually-exclusive pinned item per edge group. */
+declare function createEdgePinStore(): EdgePinStore;
 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 +121,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 EdgePinStore, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type OpenPanelWindowOptions, type PanelWindowingController, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type SurfaceWindowingController, type WindowManager, canOpenPanelWindow, createBrowserWindowManager, createEdgePinStore, createExternalWindowManager, createPanelWindowingController, createSurfaceWindowingController, decodeSurfaceFromLocation, encodeSurfaceQuery, shouldShowDetachedPlaceholder, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -1,19 +1,23 @@
 import {
   canOpenPanelWindow,
   createBrowserWindowManager,
+  createEdgePinStore,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,
   surfaceKey,
   surfaceWindowLabel
-} from "./chunk-ZYCR2LSP.js";
+} from "./chunk-QMT4V6XC.js";
 export {
   canOpenPanelWindow,
   createBrowserWindowManager,
+  createEdgePinStore,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,

package/package.json

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