@forgeax/app-shell 0.22.0 → 0.24.0

package/dist/{chunk-EEPX63DF.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;
 }
@@ -314,6 +353,7 @@ function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? wind
 }
 
 export {
+  createEdgePinStore,
   canOpenPanelWindow,
   shouldShowDetachedPlaceholder,
   createPanelWindowingController,

package/dist/dock.d.ts

@@ -29,6 +29,27 @@ declare function getDockRegions(): DockRegionEntry[];
 declare function trackDockPanelVisibility(panelId: string): () => void;
 declare function isDockPanelVisible(panelId: string): boolean;
 declare function hasMountedPanelPlacement(panelIds: readonly string[], mountedPanelIds: ReadonlySet<string>): boolean;
+interface DockLayoutPersistenceScope<Identity> {
+    readonly key: string;
+    readonly identity: Identity;
+}
+interface DockLayoutPersistenceAdapter<Layout, Identity> {
+    load(key: string, identity: Identity): Layout | null;
+    save(key: string, identity: Identity, layout: Layout): void;
+    remove(key: string): void;
+}
+interface DockLayoutPersistence<Layout, Identity> {
+    restore(scope: DockLayoutPersistenceScope<Identity>, apply: (saved: Layout | null) => void): void;
+    save(scope: DockLayoutPersistenceScope<Identity>, layout: Layout): boolean;
+    clear(scope: DockLayoutPersistenceScope<Identity>): void;
+    isRestoring(): boolean;
+}
+/**
+ * Own the load-before-mutation and reentrant-save suppression required by dock
+ * layout restoration. Product callers retain key construction, identity,
+ * storage, snapshot validation, and concrete Dockview mutation.
+ */
+declare function createDockLayoutPersistence<Layout, Identity>(adapter: DockLayoutPersistenceAdapter<Layout, Identity>): DockLayoutPersistence<Layout, Identity>;
 interface SerializedDockPanelLike {
     readonly contentComponent?: string;
 }
@@ -106,4 +127,4 @@ declare function handleCrossInstanceDrop(event: CrossInstanceDropEvent, targetRe
     titleFor?: (panelId: string) => string | undefined;
 }): void;
 
-export { type AuthoredDockLayoutLike, type AuthoredDockNodeLike, type CrossInstanceDropEvent, DOCK_REGIONS, type DesignedDockPanelPosition, type DockLayoutOrientation, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };
+export { type AuthoredDockLayoutLike, type AuthoredDockNodeLike, type CrossInstanceDropEvent, DOCK_REGIONS, type DesignedDockPanelPosition, type DockLayoutOrientation, type DockLayoutPersistence, type DockLayoutPersistenceAdapter, type DockLayoutPersistenceScope, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -45,6 +45,31 @@ function isDockPanelVisible(panelId) {
 function hasMountedPanelPlacement(panelIds, mountedPanelIds) {
   return panelIds.some((id) => mountedPanelIds.has(id));
 }
+function createDockLayoutPersistence(adapter) {
+  let restoreDepth = 0;
+  return {
+    restore(scope, apply) {
+      const saved = adapter.load(scope.key, scope.identity);
+      restoreDepth += 1;
+      try {
+        apply(saved);
+      } finally {
+        restoreDepth -= 1;
+      }
+    },
+    save(scope, layout) {
+      if (restoreDepth > 0) return false;
+      adapter.save(scope.key, scope.identity, layout);
+      return true;
+    },
+    clear(scope) {
+      adapter.remove(scope.key);
+    },
+    isRestoring() {
+      return restoreDepth > 0;
+    }
+  };
+}
 function pruneSerializedDockLayout(layout, knownComponents, allowedPanelIds) {
   if (!layout.panels) return layout;
   const removed = new Set(Object.entries(layout.panels).filter(([id, panel]) => !knownComponents.has(panel.contentComponent ?? id) || allowedPanelIds !== void 0 && !allowedPanelIds.has(id)).map(([id]) => id));
@@ -207,6 +232,7 @@ function handleCrossInstanceDrop(event, targetRegion, moveTo, options) {
 export {
   DOCK_REGIONS,
   REGIONS,
+  createDockLayoutPersistence,
   designedDockPanelPosition,
   getDockRegions,
   getDockviewApi,

package/dist/react.js

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

package/dist/window.d.ts

@@ -93,6 +93,15 @@ interface SurfaceWindowingController {
     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. */
@@ -112,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 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 };
+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,6 +1,7 @@
 import {
   canOpenPanelWindow,
   createBrowserWindowManager,
+  createEdgePinStore,
   createExternalWindowManager,
   createPanelWindowingController,
   createSurfaceWindowingController,
@@ -9,10 +10,11 @@ import {
   shouldShowDetachedPlaceholder,
   surfaceKey,
   surfaceWindowLabel
-} from "./chunk-EEPX63DF.js";
+} from "./chunk-QMT4V6XC.js";
 export {
   canOpenPanelWindow,
   createBrowserWindowManager,
+  createEdgePinStore,
   createExternalWindowManager,
   createPanelWindowingController,
   createSurfaceWindowingController,

package/package.json

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