@forgeax/app-shell 0.32.0 → 0.34.0

package/dist/dock.d.ts

@@ -217,6 +217,46 @@ 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;
+interface DockLayoutControlSnapshot<Anchor> {
+    readonly open: boolean;
+    readonly anchor: Anchor | null;
+}
+interface DockLayoutControlState<Anchor> {
+    getSnapshot(): DockLayoutControlSnapshot<Anchor>;
+    subscribe(listener: () => void): () => void;
+    /** Toggle visibility and preserve the previous anchor when none is supplied. */
+    toggle(anchor?: Anchor): void;
+    /** Close without publishing a duplicate snapshot when already closed. */
+    close(): void;
+}
+/** Own stable external-store state for a product-presented Dock layout control. */
+declare function createDockLayoutControlState<Anchor>(initialAnchor?: Anchor | null): DockLayoutControlState<Anchor>;
+interface DockLayoutControlToggleSource<Anchor> {
+    onToggle(listener: (anchor?: Anchor) => void): {
+        dispose(): void;
+    };
+}
+/** Own one layout-control toggle subscription while product callers map events and payloads. */
+declare function installDockLayoutControlToggle<Anchor>(source: DockLayoutControlToggleSource<Anchor>, state: Pick<DockLayoutControlState<Anchor>, 'toggle'>): () => void;
 type SideEdge = 'left' | 'right';
 interface RectLike {
     left: number;
@@ -254,4 +294,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 DockLayoutResetAdapter, type DockLayoutResetSource, 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, installDockLayoutReset, 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 DockLayoutControlSnapshot, type DockLayoutControlState, type DockLayoutControlToggleSource, 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, createDockLayoutControlState, createDockLayoutPersistence, createDockPanelCommands, createDockReadyActivation, createDockReadyCleanup, createDockScopeTransition, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockLayoutControlToggle, installDockLayoutObservation, installDockLayoutReset, installDockPanelCommandSubscriptions, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -517,6 +517,86 @@ 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 createDockLayoutControlState(initialAnchor = null) {
+  let snapshot = { open: false, anchor: initialAnchor };
+  const listeners = /* @__PURE__ */ new Set();
+  const commit = (open, anchor) => {
+    if (snapshot.open === open && snapshot.anchor === anchor) return;
+    snapshot = { open, anchor };
+    for (const listener of [...listeners]) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      let subscribed = true;
+      return () => {
+        if (!subscribed) return;
+        subscribed = false;
+        listeners.delete(listener);
+      };
+    },
+    toggle: (anchor) => commit(
+      !snapshot.open,
+      anchor === void 0 ? snapshot.anchor : anchor
+    ),
+    close: () => commit(false, snapshot.anchor)
+  };
+}
+function installDockLayoutControlToggle(source, state) {
+  let active = true;
+  const subscription = source.onToggle((anchor) => {
+    if (!active) return;
+    try {
+      state.toggle(anchor);
+    } catch {
+    }
+  });
+  return () => {
+    if (!active) return;
+    active = false;
+    try {
+      subscription.dispose();
+    } catch {
+    }
+  };
+}
 function isOnSideEdge(location) {
   return location.type === "edge" && (location.position === "left" || location.position === "right");
 }
@@ -571,6 +651,7 @@ function handleCrossInstanceDrop(event, targetRegion, moveTo, options) {
 export {
   DOCK_REGIONS,
   REGIONS,
+  createDockLayoutControlState,
   createDockLayoutPersistence,
   createDockPanelCommands,
   createDockReadyActivation,
@@ -581,8 +662,10 @@ export {
   getDockviewApi,
   handleCrossInstanceDrop,
   hasMountedPanelPlacement,
+  installDockLayoutControlToggle,
   installDockLayoutObservation,
   installDockLayoutReset,
+  installDockPanelCommandSubscriptions,
   installDockPanelVisibilityTracking,
   isDockPanelVisible,
   isDockRegion,

package/package.json

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