@forgeax/app-shell 0.30.0 → 0.31.0

package/dist/dock.d.ts

@@ -110,6 +110,24 @@ interface DockLayoutPersistence<Layout, Identity> {
  * storage, snapshot validation, and concrete Dockview mutation.
  */
 declare function createDockLayoutPersistence<Layout, Identity>(adapter: DockLayoutPersistenceAdapter<Layout, Identity>): DockLayoutPersistence<Layout, Identity>;
+interface DockLayoutObservationSource {
+    onDidLayoutChange(listener: () => void): {
+        dispose(): void;
+    };
+}
+interface DockLayoutObservationAdapter<Scope> {
+    /** Resolve the current product-owned scope at event time. */
+    getCurrentScope(): Scope | null;
+    /** Capture and persist a scoped layout; false identifies a suppressed capture. */
+    readonly captureAndSave?: (scope: Scope) => boolean;
+    /** Publish one stable notification only after capture succeeds or is not required. */
+    onCommitted(): void;
+}
+/**
+ * Own one layout-change subscription and its capture-before-notify sequencing.
+ * Product callers retain concrete event, scope, snapshot, persistence, and UI adapters.
+ */
+declare function installDockLayoutObservation<Scope>(source: DockLayoutObservationSource, adapter: DockLayoutObservationAdapter<Scope>): () => void;
 interface SerializedDockPanelLike {
     readonly contentComponent?: string;
 }
@@ -215,4 +233,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 DockCommandPanel, type DockLayoutOrientation, type DockLayoutPersistence, type DockLayoutPersistenceAdapter, type DockLayoutPersistenceScope, type DockPanelCommandAdapter, type DockPanelCommands, type DockPanelVisibilityEventSource, type DockPanelVisibilityHooks, type DockReadyActivation, type DockReadyAdapterInstaller, type DockReadyAdapterSession, type DockReadyCleanup, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockScopeTransition, type DockScopeTransitionAdapter, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, createDockPanelCommands, createDockReadyActivation, createDockReadyCleanup, createDockScopeTransition, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };
+export { type AuthoredDockLayoutLike, type AuthoredDockNodeLike, type CrossInstanceDropEvent, DOCK_REGIONS, type DesignedDockPanelPosition, type DockCommandPanel, type DockLayoutObservationAdapter, type DockLayoutObservationSource, type DockLayoutOrientation, type DockLayoutPersistence, type DockLayoutPersistenceAdapter, type DockLayoutPersistenceScope, type DockPanelCommandAdapter, type DockPanelCommands, type DockPanelVisibilityEventSource, type DockPanelVisibilityHooks, type DockReadyActivation, type DockReadyAdapterInstaller, type DockReadyAdapterSession, type DockReadyCleanup, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockScopeTransition, type DockScopeTransitionAdapter, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, createDockPanelCommands, createDockReadyActivation, createDockReadyCleanup, createDockScopeTransition, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockLayoutObservation, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -262,6 +262,39 @@ function createDockLayoutPersistence(adapter) {
     }
   };
 }
+function installDockLayoutObservation(source, adapter) {
+  let active = true;
+  const subscription = source.onDidLayoutChange(() => {
+    if (!active) return;
+    let scope;
+    try {
+      scope = adapter.getCurrentScope();
+    } catch {
+      return;
+    }
+    if (!active) return;
+    if (scope !== null && adapter.captureAndSave) {
+      try {
+        if (!adapter.captureAndSave(scope)) return;
+      } catch {
+        return;
+      }
+      if (!active) return;
+    }
+    try {
+      adapter.onCommitted();
+    } catch {
+    }
+  });
+  return () => {
+    if (!active) return;
+    active = false;
+    try {
+      subscription.dispose();
+    } catch {
+    }
+  };
+}
 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));
@@ -489,6 +522,7 @@ export {
   getDockviewApi,
   handleCrossInstanceDrop,
   hasMountedPanelPlacement,
+  installDockLayoutObservation,
   installDockPanelVisibilityTracking,
   isDockPanelVisible,
   isDockRegion,

package/package.json

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