@forgeax/app-shell 0.8.0 → 0.9.1

package/README.md

@@ -84,6 +84,20 @@ import { PanelSurface } from '@forgeax/app-shell/react';
 </PanelSurface>
 ```
 
+Dock state adapters are available without a Dockview runtime dependency:
+
+```ts
+import {
+  hasMountedPanelPlacement,
+  isDockPanelVisible,
+  pruneSerializedDockLayout,
+  trackDockPanelVisibility,
+} from '@forgeax/app-shell/dock';
+```
+
+Products own event subscription and layout persistence; the adapters only track
+stable panel ids and transform structural serialized snapshots.
+
 ## Ownership boundary
 
 | Package | Owns |

package/dist/dock.d.ts

@@ -25,6 +25,24 @@ interface DockRegionEntry {
 }
 declare function registerDockRegion(entry: DockRegionEntry): () => void;
 declare function getDockRegions(): DockRegionEntry[];
+/** Track one live mount of a dock panel and return an idempotent release. */
+declare function trackDockPanelVisibility(panelId: string): () => void;
+declare function isDockPanelVisible(panelId: string): boolean;
+declare function hasMountedPanelPlacement(panelIds: readonly string[], mountedPanelIds: ReadonlySet<string>): boolean;
+interface SerializedDockPanelLike {
+    readonly contentComponent?: string;
+}
+interface SerializedDockLayoutLike {
+    readonly panels?: Readonly<Record<string, SerializedDockPanelLike>>;
+    readonly grid?: Readonly<{
+        readonly root?: unknown;
+    }>;
+}
+/**
+ * Remove panels that the current shell cannot render, then prune empty grid
+ * 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 SideEdge = 'left' | 'right';
 interface RectLike {
     left: number;
@@ -62,4 +80,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 SideEdge, getDockRegions, getDockviewApi, handleCrossInstanceDrop, isDockRegion, isOnSideEdge, nearerSideEdge, registerDockRegion, registerDockviewApi, resolveRegion };
+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 };

package/dist/dock.js

@@ -27,6 +27,63 @@ function registerDockRegion(entry) {
 function getDockRegions() {
   return [...dockRegions.values()];
 }
+var visibleDockPanels = /* @__PURE__ */ new Map();
+function trackDockPanelVisibility(panelId) {
+  visibleDockPanels.set(panelId, (visibleDockPanels.get(panelId) ?? 0) + 1);
+  let active = true;
+  return () => {
+    if (!active) return;
+    active = false;
+    const next = (visibleDockPanels.get(panelId) ?? 1) - 1;
+    if (next > 0) visibleDockPanels.set(panelId, next);
+    else visibleDockPanels.delete(panelId);
+  };
+}
+function isDockPanelVisible(panelId) {
+  return visibleDockPanels.has(panelId);
+}
+function hasMountedPanelPlacement(panelIds, mountedPanelIds) {
+  return panelIds.some((id) => mountedPanelIds.has(id));
+}
+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));
+  if (removed.size === 0) return layout;
+  const panels = Object.fromEntries(
+    Object.entries(layout.panels).filter(([id]) => !removed.has(id))
+  );
+  if (Object.keys(panels).length === 0) return null;
+  const pruneNode = (node) => {
+    if (!node || typeof node !== "object") return node;
+    const value = node;
+    if (value.type === "leaf") {
+      const data = value.data;
+      if (!Array.isArray(data?.views)) return node;
+      const views = data.views.filter((id) => !removed.has(id));
+      if (views.length === 0) return null;
+      return {
+        ...value,
+        data: {
+          ...data,
+          views,
+          activeView: views.includes(data.activeView ?? "") ? data.activeView : views[0]
+        }
+      };
+    }
+    if (value.type === "branch" && Array.isArray(value.data)) {
+      const children = value.data.map(pruneNode).filter((child) => child !== null);
+      return children.length === 0 ? null : { ...value, data: children };
+    }
+    return node;
+  };
+  const root = pruneNode(layout.grid?.root);
+  if (root === null) return null;
+  return {
+    ...layout,
+    panels,
+    grid: layout.grid ? { ...layout.grid, root } : layout.grid
+  };
+}
 function isOnSideEdge(location) {
   return location.type === "edge" && (location.position === "left" || location.position === "right");
 }
@@ -84,10 +141,14 @@ export {
   getDockRegions,
   getDockviewApi,
   handleCrossInstanceDrop,
+  hasMountedPanelPlacement,
+  isDockPanelVisible,
   isDockRegion,
   isOnSideEdge,
   nearerSideEdge,
+  pruneSerializedDockLayout,
   registerDockRegion,
   registerDockviewApi,
-  resolveRegion
+  resolveRegion,
+  trackDockPanelVisibility
 };

package/package.json

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