@forgeax/app-shell 0.26.0 → 0.27.0

package/dist/dock.d.ts

@@ -3,6 +3,14 @@ type Region = typeof REGIONS[number];
 declare const DOCK_REGIONS: readonly ["DockShell", "AuxBar", "ChatDock"];
 type DockRegion = typeof DOCK_REGIONS[number];
 declare function isDockRegion(value: string): value is DockRegion;
+interface DockReadyCleanup {
+    /** Register one teardown while active; late registrations are disposed immediately. */
+    add(dispose: () => void): boolean;
+    /** Dispose registered teardowns once, in reverse registration order. */
+    dispose(): void;
+}
+/** Own the best-effort teardown lifecycle of one dock-ready session. */
+declare function createDockReadyCleanup(): DockReadyCleanup;
 interface PanelDescriptorLite {
     defaultRegion?: DockRegion;
 }
@@ -174,4 +182,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 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 };
+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 DockReadyCleanup, type DockRegion, type DockRegionEntry, type DockReopenDirection, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, createDockPanelCommands, createDockReadyCleanup, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -4,6 +4,33 @@ var DOCK_REGIONS = ["DockShell", "AuxBar", "ChatDock"];
 function isDockRegion(value) {
   return DOCK_REGIONS.includes(value);
 }
+function createDockReadyCleanup() {
+  const disposers = [];
+  let active = true;
+  return {
+    add(dispose) {
+      if (active) {
+        disposers.push(dispose);
+        return true;
+      }
+      try {
+        dispose();
+      } catch {
+      }
+      return false;
+    },
+    dispose() {
+      if (!active) return;
+      active = false;
+      while (disposers.length > 0) {
+        try {
+          disposers.pop()?.();
+        } catch {
+        }
+      }
+    }
+  };
+}
 function resolveRegion(id, descriptor, overrides) {
   return overrides[id] ?? descriptor.defaultRegion ?? "DockShell";
 }
@@ -347,6 +374,7 @@ export {
   REGIONS,
   createDockLayoutPersistence,
   createDockPanelCommands,
+  createDockReadyCleanup,
   designedDockPanelPosition,
   getDockRegions,
   getDockviewApi,

package/package.json

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