@forgeax/app-shell 0.34.0 → 0.36.0

package/dist/dock.d.ts

@@ -236,6 +236,19 @@ interface DockPanelCommandSubscriptionSource {
  * payload mapping, membership, titles, layout policy, and concrete Dock APIs.
  */
 declare function installDockPanelCommandSubscriptions(source: DockPanelCommandSubscriptionSource, commands: DockPanelCommands): () => void;
+interface DockLayoutPanelControlAdapter {
+    isOpen(panelId: string): boolean;
+    close(panelId: string): void;
+    reopen(panelId: string): void;
+}
+interface DockLayoutPanelControl {
+    /** Project whether the live Dock currently contains the panel. */
+    isOpen(panelId: string): boolean;
+    /** Close an open panel or reopen a closed panel. Returns false when the adapter fails. */
+    toggle(panelId: string): boolean;
+}
+/** Own product-neutral panel projection and close-vs-reopen selection for a layout control. */
+declare function createDockLayoutPanelControl(adapter: DockLayoutPanelControlAdapter): DockLayoutPanelControl;
 interface DockLayoutControlSnapshot<Anchor> {
     readonly open: boolean;
     readonly anchor: Anchor | null;
@@ -243,6 +256,8 @@ interface DockLayoutControlSnapshot<Anchor> {
 interface DockLayoutControlState<Anchor> {
     getSnapshot(): DockLayoutControlSnapshot<Anchor>;
     subscribe(listener: () => void): () => void;
+    /** Publish a fresh snapshot after the live Dock projection changes. */
+    refresh(): 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. */
@@ -294,4 +309,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 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 };
+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 DockLayoutPanelControl, type DockLayoutPanelControlAdapter, 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, createDockLayoutPanelControl, 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

@@ -548,11 +548,37 @@ function installDockPanelCommandSubscriptions(source, commands) {
   }
   return cleanup;
 }
+function createDockLayoutPanelControl(adapter) {
+  const readOpen = (panelId) => {
+    try {
+      return { ok: true, value: adapter.isOpen(panelId) };
+    } catch {
+      return { ok: false };
+    }
+  };
+  return {
+    isOpen(panelId) {
+      const result = readOpen(panelId);
+      return result.ok ? result.value : false;
+    },
+    toggle(panelId) {
+      const result = readOpen(panelId);
+      if (!result.ok) return false;
+      try {
+        if (result.value) adapter.close(panelId);
+        else adapter.reopen(panelId);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
 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;
+  const commit = (open, anchor, force = false) => {
+    if (!force && snapshot.open === open && snapshot.anchor === anchor) return;
     snapshot = { open, anchor };
     for (const listener of [...listeners]) {
       try {
@@ -572,6 +598,7 @@ function createDockLayoutControlState(initialAnchor = null) {
         listeners.delete(listener);
       };
     },
+    refresh: () => commit(snapshot.open, snapshot.anchor, true),
     toggle: (anchor) => commit(
       !snapshot.open,
       anchor === void 0 ? snapshot.anchor : anchor
@@ -652,6 +679,7 @@ export {
   DOCK_REGIONS,
   REGIONS,
   createDockLayoutControlState,
+  createDockLayoutPanelControl,
   createDockLayoutPersistence,
   createDockPanelCommands,
   createDockReadyActivation,

package/package.json

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