@forgeax/app-shell 0.31.0 → 0.33.0

package/dist/dock.d.ts

@@ -128,6 +128,27 @@ interface DockLayoutObservationAdapter<Scope> {
  * Product callers retain concrete event, scope, snapshot, persistence, and UI adapters.
  */
 declare function installDockLayoutObservation<Scope>(source: DockLayoutObservationSource, adapter: DockLayoutObservationAdapter<Scope>): () => void;
+interface DockLayoutResetSource {
+    onReset(listener: () => void): {
+        dispose(): void;
+    };
+}
+interface DockLayoutResetAdapter<Scope, Live> {
+    /** Resolve the current product-owned scope at reset time. */
+    getCurrentScope(): Scope | null;
+    /** Remove the persisted layout for a concrete product-owned scope. */
+    clear(scope: Scope): void;
+    /** Resolve the currently published dock value without retaining it here. */
+    getLive(): Live | null;
+    /** Reapply the current product-owned scope after persistence is cleared. */
+    apply(live: Live, scope: Scope | null): void;
+}
+/**
+ * Own one reset subscription and clear-before-reapply sequencing. Reentrant
+ * requests are serialized so the newest reset is applied last; product callers
+ * retain the concrete event, scope, persistence, live dock, and layout adapters.
+ */
+declare function installDockLayoutReset<Scope, Live>(source: DockLayoutResetSource, adapter: DockLayoutResetAdapter<Scope, Live>): () => void;
 interface SerializedDockPanelLike {
     readonly contentComponent?: string;
 }
@@ -196,6 +217,25 @@ interface DockPanelCommands {
 }
 /** Own idempotent panel commands while callers retain membership and product policy. */
 declare function createDockPanelCommands(adapter: DockPanelCommandAdapter): DockPanelCommands;
+interface DockPanelCommandSubscriptionSource {
+    onOpen(listener: (panelId: string) => void): {
+        dispose(): void;
+    };
+    onClose(listener: (panelId: string) => void): {
+        dispose(): void;
+    };
+    onFocus(listener: (panelId: string) => void): {
+        dispose(): void;
+    };
+    onReveal(listener: (panelId: string) => void): {
+        dispose(): void;
+    };
+}
+/**
+ * Own balanced panel-command subscriptions while callers retain event names,
+ * payload mapping, membership, titles, layout policy, and concrete Dock APIs.
+ */
+declare function installDockPanelCommandSubscriptions(source: DockPanelCommandSubscriptionSource, commands: DockPanelCommands): () => void;
 type SideEdge = 'left' | 'right';
 interface RectLike {
     left: number;
@@ -233,4 +273,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 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 };
+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 DockLayoutResetAdapter, type DockLayoutResetSource, type DockPanelCommandAdapter, type DockPanelCommandSubscriptionSource, 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, installDockLayoutReset, installDockPanelCommandSubscriptions, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -295,6 +295,65 @@ function installDockLayoutObservation(source, adapter) {
     }
   };
 }
+function installDockLayoutReset(source, adapter) {
+  let active = true;
+  let processing = false;
+  let pending = false;
+  const reset = () => {
+    if (!active) return;
+    pending = true;
+    if (processing) return;
+    processing = true;
+    try {
+      while (active && pending) {
+        pending = false;
+        let scope;
+        try {
+          scope = adapter.getCurrentScope();
+        } catch {
+          continue;
+        }
+        if (!active) break;
+        if (pending) continue;
+        if (scope !== null) {
+          try {
+            adapter.clear(scope);
+          } catch {
+            continue;
+          }
+          if (!active) break;
+          if (pending) continue;
+        }
+        let live;
+        try {
+          live = adapter.getLive();
+        } catch {
+          continue;
+        }
+        if (!active) break;
+        if (pending) continue;
+        if (live) {
+          try {
+            adapter.apply(live, scope);
+          } catch {
+          }
+        }
+      }
+    } finally {
+      processing = false;
+    }
+  };
+  const subscription = source.onReset(reset);
+  return () => {
+    if (!active) return;
+    active = false;
+    pending = 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));
@@ -458,6 +517,37 @@ function createDockPanelCommands(adapter) {
     }
   };
 }
+function installDockPanelCommandSubscriptions(source, commands) {
+  const subscriptions = [];
+  let active = true;
+  const cleanup = () => {
+    if (!active) return;
+    active = false;
+    while (subscriptions.length > 0) {
+      try {
+        subscriptions.pop()?.dispose();
+      } catch {
+      }
+    }
+  };
+  const route = (command) => (panelId) => {
+    if (!active) return;
+    try {
+      command(panelId);
+    } catch {
+    }
+  };
+  try {
+    subscriptions.push(source.onOpen(route((id) => commands.open(id))));
+    subscriptions.push(source.onClose(route((id) => commands.close(id))));
+    subscriptions.push(source.onFocus(route((id) => commands.focus(id))));
+    subscriptions.push(source.onReveal(route((id) => commands.reveal(id))));
+  } catch (error) {
+    cleanup();
+    throw error;
+  }
+  return cleanup;
+}
 function isOnSideEdge(location) {
   return location.type === "edge" && (location.position === "left" || location.position === "right");
 }
@@ -523,6 +613,8 @@ export {
   handleCrossInstanceDrop,
   hasMountedPanelPlacement,
   installDockLayoutObservation,
+  installDockLayoutReset,
+  installDockPanelCommandSubscriptions,
   installDockPanelVisibilityTracking,
   isDockPanelVisible,
   isDockRegion,

package/package.json

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