@forgeax/app-shell 0.9.1 → 0.10.0

package/dist/dock.d.ts

@@ -43,6 +43,32 @@ interface SerializedDockLayoutLike {
  * leaves and branches. The input snapshot is never mutated.
  */
 declare function pruneSerializedDockLayout<T extends SerializedDockLayoutLike>(layout: T, knownComponents: ReadonlySet<string>, allowedPanelIds?: ReadonlySet<string>): T | null;
+type DockLayoutOrientation = 'HORIZONTAL' | 'VERTICAL';
+type DockReopenDirection = 'left' | 'right' | 'above' | 'below' | 'within';
+/** Structural shape shared by concrete serialized dock tree implementations. */
+interface AuthoredDockNodeLike {
+    readonly type: 'leaf' | 'branch';
+    readonly data: unknown;
+}
+interface AuthoredDockLayoutLike {
+    readonly grid?: {
+        readonly orientation: DockLayoutOrientation;
+        readonly root?: AuthoredDockNodeLike;
+    };
+}
+type DesignedDockPanelPosition = {
+    readonly kind: 'relative';
+    readonly referencePanel: string;
+    readonly direction: DockReopenDirection;
+} | {
+    readonly kind: 'edge';
+    readonly direction: Exclude<DockReopenDirection, 'within'>;
+};
+/**
+ * Derive a closed panel's authored seat against a panel that is still open.
+ * 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;
 type SideEdge = 'left' | 'right';
 interface RectLike {
     left: number;
@@ -80,4 +106,4 @@ declare function handleCrossInstanceDrop(event: CrossInstanceDropEvent, targetRe
     titleFor?: (panelId: string) => string | undefined;
 }): void;
 
-export { type CrossInstanceDropEvent, DOCK_REGIONS, type DockRegion, type DockRegionEntry, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };
+export { type AuthoredDockLayoutLike, type AuthoredDockNodeLike, type CrossInstanceDropEvent, DOCK_REGIONS, type DesignedDockPanelPosition, type DockLayoutOrientation, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -84,6 +84,75 @@ function pruneSerializedDockLayout(layout, knownComponents, allowedPanelIds) {
     grid: layout.grid ? { ...layout.grid, root } : layout.grid
   };
 }
+function authoredLeafViews(node) {
+  if (node.type !== "leaf" || !node.data || typeof node.data !== "object") return [];
+  const views = node.data.views;
+  return Array.isArray(views) ? views : [];
+}
+function authoredBranchChildren(node) {
+  return node.type === "branch" && Array.isArray(node.data) ? node.data : [];
+}
+function firstOpenAuthoredPanel(node, isOpen) {
+  if (node.type === "leaf") return authoredLeafViews(node).find(isOpen);
+  for (const child of authoredBranchChildren(node)) {
+    const match = firstOpenAuthoredPanel(child, isOpen);
+    if (match) return match;
+  }
+  return void 0;
+}
+function findAuthoredPanelPath(root, panelId) {
+  if (root.type === "leaf") {
+    return authoredLeafViews(root).includes(panelId) ? [root] : void 0;
+  }
+  for (const child of authoredBranchChildren(root)) {
+    const path = findAuthoredPanelPath(child, panelId);
+    if (path) return [root, ...path];
+  }
+  return void 0;
+}
+function authoredBranchOrientation(rootOrientation, depth) {
+  if (depth % 2 === 0) return rootOrientation;
+  return rootOrientation === "HORIZONTAL" ? "VERTICAL" : "HORIZONTAL";
+}
+function designedDockPanelPosition(layout, panelId, isOpen) {
+  const root = layout.grid?.root;
+  if (!root) return void 0;
+  const path = findAuthoredPanelPath(root, panelId);
+  if (!path) return void 0;
+  const leaf = path[path.length - 1];
+  const tabMate = authoredLeafViews(leaf).find((id) => id !== panelId && isOpen(id));
+  if (tabMate) return { kind: "relative", referencePanel: tabMate, direction: "within" };
+  if (path.length === 2 && path[0].type === "branch") {
+    const siblings = authoredBranchChildren(path[0]);
+    const index = siblings.indexOf(leaf);
+    const horizontal = layout.grid?.orientation === "HORIZONTAL";
+    if (index === 0) return { kind: "edge", direction: horizontal ? "left" : "above" };
+    if (index === siblings.length - 1) {
+      return { kind: "edge", direction: horizontal ? "right" : "below" };
+    }
+  }
+  for (let depth = path.length - 2; depth >= 0; depth--) {
+    const branch = path[depth];
+    if (branch.type !== "branch") continue;
+    const children = authoredBranchChildren(branch);
+    const index = children.indexOf(path[depth + 1]);
+    if (index < 0) continue;
+    const horizontal = authoredBranchOrientation(layout.grid.orientation, depth) === "HORIZONTAL";
+    for (let i = index + 1; i < children.length; i++) {
+      const referencePanel = firstOpenAuthoredPanel(children[i], isOpen);
+      if (referencePanel) {
+        return { kind: "relative", referencePanel, direction: horizontal ? "left" : "above" };
+      }
+    }
+    for (let i = index - 1; i >= 0; i--) {
+      const referencePanel = firstOpenAuthoredPanel(children[i], isOpen);
+      if (referencePanel) {
+        return { kind: "relative", referencePanel, direction: horizontal ? "right" : "below" };
+      }
+    }
+  }
+  return void 0;
+}
 function isOnSideEdge(location) {
   return location.type === "edge" && (location.position === "left" || location.position === "right");
 }
@@ -138,6 +207,7 @@ function handleCrossInstanceDrop(event, targetRegion, moveTo, options) {
 export {
   DOCK_REGIONS,
   REGIONS,
+  designedDockPanelPosition,
   getDockRegions,
   getDockviewApi,
   handleCrossInstanceDrop,

package/package.json

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