@forgeax/app-shell 0.25.0 → 0.26.0

package/dist/dock.d.ts

@@ -109,6 +109,34 @@ type DesignedDockPanelPosition = {
  * Returns undefined when the panel is absent or no live sibling can anchor it.
  */
 declare function designedDockPanelPosition(layout: AuthoredDockLayoutLike, panelId: string, isOpen: (id: string) => boolean): DesignedDockPanelPosition | undefined;
+interface DockCommandPanel {
+    close(): void;
+    setActive(): void;
+}
+interface DockPanelCommandAdapter {
+    getPanel(id: string): DockCommandPanel | undefined;
+    addPanel(options: {
+        id: string;
+        component: string;
+        title: string;
+        position?: {
+            referencePanel?: string;
+            direction: DockReopenDirection;
+        };
+    }): void;
+    canOpen(id: string): boolean;
+    titleFor(id: string): string;
+    authoredLayout?(): AuthoredDockLayoutLike | undefined;
+    fallbackPanelId?(): string | undefined;
+}
+interface DockPanelCommands {
+    open(id: string): boolean;
+    close(id: string): boolean;
+    focus(id: string): boolean;
+    reveal(id: string): boolean;
+}
+/** Own idempotent panel commands while callers retain membership and product policy. */
+declare function createDockPanelCommands(adapter: DockPanelCommandAdapter): DockPanelCommands;
 type SideEdge = 'left' | 'right';
 interface RectLike {
     left: number;
@@ -146,4 +174,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 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 };
+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 DockRegion, type DockRegionEntry, type DockReopenDirection, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, createDockPanelCommands, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -236,6 +236,61 @@ function designedDockPanelPosition(layout, panelId, isOpen) {
   }
   return void 0;
 }
+function createDockPanelCommands(adapter) {
+  const panel = (id) => {
+    try {
+      return adapter.getPanel(id);
+    } catch {
+      return void 0;
+    }
+  };
+  const focus = (id) => {
+    const target = panel(id);
+    if (!target) return false;
+    try {
+      target.setActive();
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const open = (id) => {
+    if (panel(id)) return false;
+    try {
+      if (!adapter.canOpen(id)) return false;
+      const layout = adapter.authoredLayout?.();
+      const designed = layout ? designedDockPanelPosition(layout, id, (candidate) => panel(candidate) !== void 0) : void 0;
+      const referencePanel = designed?.kind === "relative" ? designed.referencePanel : designed === void 0 ? adapter.fallbackPanelId?.() : void 0;
+      adapter.addPanel({
+        id,
+        component: id,
+        title: adapter.titleFor(id),
+        position: designed?.kind === "edge" ? { direction: designed.direction } : referencePanel ? { referencePanel, direction: designed?.direction ?? "right" } : void 0
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  return {
+    open,
+    close(id) {
+      const target = panel(id);
+      if (!target) return false;
+      try {
+        target.close();
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    focus,
+    reveal(id) {
+      if (!panel(id) && !open(id)) return false;
+      return focus(id);
+    }
+  };
+}
 function isOnSideEdge(location) {
   return location.type === "edge" && (location.position === "left" || location.position === "right");
 }
@@ -291,6 +346,7 @@ export {
   DOCK_REGIONS,
   REGIONS,
   createDockLayoutPersistence,
+  createDockPanelCommands,
   designedDockPanelPosition,
   getDockRegions,
   getDockviewApi,

package/package.json

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