@forgeax/app-shell 0.24.0 → 0.25.0

package/dist/dock.d.ts

@@ -28,6 +28,24 @@ declare function getDockRegions(): DockRegionEntry[];
 /** Track one live mount of a dock panel and return an idempotent release. */
 declare function trackDockPanelVisibility(panelId: string): () => void;
 declare function isDockPanelVisible(panelId: string): boolean;
+interface DockPanelVisibilityEventSource {
+    onDidAddPanel(listener: (panel: {
+        readonly id: string;
+    }) => void): {
+        dispose(): void;
+    };
+    onDidRemovePanel(listener: (panel: {
+        readonly id: string;
+    }) => void): {
+        dispose(): void;
+    };
+}
+interface DockPanelVisibilityHooks {
+    readonly onAdded?: (panelId: string) => void;
+    readonly onRemoved?: (panelId: string) => void;
+}
+/** Balance one visibility lease per live panel id across an injected event source. */
+declare function installDockPanelVisibilityTracking(source: DockPanelVisibilityEventSource, hooks?: DockPanelVisibilityHooks): () => void;
 declare function hasMountedPanelPlacement(panelIds: readonly string[], mountedPanelIds: ReadonlySet<string>): boolean;
 interface DockLayoutPersistenceScope<Identity> {
     readonly key: string;
@@ -41,6 +59,7 @@ interface DockLayoutPersistenceAdapter<Layout, Identity> {
 interface DockLayoutPersistence<Layout, Identity> {
     restore(scope: DockLayoutPersistenceScope<Identity>, apply: (saved: Layout | null) => void): void;
     save(scope: DockLayoutPersistenceScope<Identity>, layout: Layout): boolean;
+    captureAndSave(scope: DockLayoutPersistenceScope<Identity>, capture: () => Layout): boolean;
     clear(scope: DockLayoutPersistenceScope<Identity>): void;
     isRestoring(): boolean;
 }
@@ -127,4 +146,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 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 };
+export { type AuthoredDockLayoutLike, type AuthoredDockNodeLike, type CrossInstanceDropEvent, DOCK_REGIONS, type DesignedDockPanelPosition, type DockLayoutOrientation, type DockLayoutPersistence, type DockLayoutPersistenceAdapter, type DockLayoutPersistenceScope, type DockPanelVisibilityEventSource, type DockPanelVisibilityHooks, 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, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -42,6 +42,59 @@ function trackDockPanelVisibility(panelId) {
 function isDockPanelVisible(panelId) {
   return visibleDockPanels.has(panelId);
 }
+function installDockPanelVisibilityTracking(source, hooks = {}) {
+  const releases = /* @__PURE__ */ new Map();
+  let active = true;
+  const added = source.onDidAddPanel(({ id }) => {
+    if (!active) return;
+    if (!releases.has(id)) releases.set(id, trackDockPanelVisibility(id));
+    try {
+      hooks.onAdded?.(id);
+    } catch {
+    }
+  });
+  let removed;
+  try {
+    removed = source.onDidRemovePanel(({ id }) => {
+      if (!active) return;
+      try {
+        releases.get(id)?.();
+      } catch {
+      }
+      releases.delete(id);
+      try {
+        hooks.onRemoved?.(id);
+      } catch {
+      }
+    });
+  } catch (error) {
+    active = false;
+    try {
+      added.dispose();
+    } catch {
+    }
+    throw error;
+  }
+  return () => {
+    if (!active) return;
+    active = false;
+    try {
+      added.dispose();
+    } catch {
+    }
+    try {
+      removed.dispose();
+    } catch {
+    }
+    releases.forEach((release) => {
+      try {
+        release();
+      } catch {
+      }
+    });
+    releases.clear();
+  };
+}
 function hasMountedPanelPlacement(panelIds, mountedPanelIds) {
   return panelIds.some((id) => mountedPanelIds.has(id));
 }
@@ -62,6 +115,11 @@ function createDockLayoutPersistence(adapter) {
       adapter.save(scope.key, scope.identity, layout);
       return true;
     },
+    captureAndSave(scope, capture) {
+      if (restoreDepth > 0) return false;
+      adapter.save(scope.key, scope.identity, capture());
+      return true;
+    },
     clear(scope) {
       adapter.remove(scope.key);
     },
@@ -238,6 +296,7 @@ export {
   getDockviewApi,
   handleCrossInstanceDrop,
   hasMountedPanelPlacement,
+  installDockPanelVisibilityTracking,
   isDockPanelVisible,
   isDockRegion,
   isOnSideEdge,

package/package.json

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