@forgeax/app-shell 0.27.0 → 0.29.0

package/dist/dock.d.ts

@@ -11,6 +11,22 @@ interface DockReadyCleanup {
 }
 /** Own the best-effort teardown lifecycle of one dock-ready session. */
 declare function createDockReadyCleanup(): DockReadyCleanup;
+type DockReadyAdapterInstaller = () => void | (() => void);
+interface DockReadyAdapterSession extends DockReadyCleanup {
+    readonly installed: boolean;
+}
+/** Replace one dock-ready adapter session with an ordered, rollback-safe transaction. */
+declare function replaceDockReadyAdapters(previous: DockReadyCleanup | null | undefined, installers: readonly DockReadyAdapterInstaller[]): DockReadyAdapterSession;
+interface DockReadyActivation<T> {
+    /** Return the current value only after its complete adapter transaction succeeds. */
+    getCurrent(): T | null;
+    /** Replace the current ready session; failed or stale transactions stay unpublished. */
+    replace(value: T, installers: readonly DockReadyAdapterInstaller[]): boolean;
+    /** Revoke the current value and dispose its ready session once. */
+    dispose(): void;
+}
+/** Own current-value publication and reentrant replacement for dock-ready sessions. */
+declare function createDockReadyActivation<T>(): DockReadyActivation<T>;
 interface PanelDescriptorLite {
     defaultRegion?: DockRegion;
 }
@@ -182,4 +198,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 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 };
+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 DockReadyActivation, type DockReadyAdapterInstaller, type DockReadyAdapterSession, 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, createDockReadyActivation, createDockReadyCleanup, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -31,6 +31,50 @@ function createDockReadyCleanup() {
     }
   };
 }
+function replaceDockReadyAdapters(previous, installers) {
+  try {
+    previous?.dispose();
+  } catch {
+  }
+  const cleanup = createDockReadyCleanup();
+  try {
+    for (const install of installers) {
+      const dispose = install();
+      if (dispose) cleanup.add(dispose);
+    }
+    return { ...cleanup, installed: true };
+  } catch {
+    cleanup.dispose();
+    return { ...cleanup, installed: false };
+  }
+}
+function createDockReadyActivation() {
+  let current = null;
+  let session = null;
+  let generation = 0;
+  return {
+    getCurrent: () => current,
+    replace(value, installers) {
+      const candidateGeneration = ++generation;
+      current = null;
+      const candidate = replaceDockReadyAdapters(session, installers);
+      if (candidateGeneration !== generation) {
+        candidate.dispose();
+        return false;
+      }
+      session = candidate;
+      if (!candidate.installed) return false;
+      current = value;
+      return true;
+    },
+    dispose() {
+      generation += 1;
+      current = null;
+      session?.dispose();
+      session = null;
+    }
+  };
+}
 function resolveRegion(id, descriptor, overrides) {
   return overrides[id] ?? descriptor.defaultRegion ?? "DockShell";
 }
@@ -374,6 +418,7 @@ export {
   REGIONS,
   createDockLayoutPersistence,
   createDockPanelCommands,
+  createDockReadyActivation,
   createDockReadyCleanup,
   designedDockPanelPosition,
   getDockRegions,
@@ -388,6 +433,7 @@ export {
   pruneSerializedDockLayout,
   registerDockRegion,
   registerDockviewApi,
+  replaceDockReadyAdapters,
   resolveRegion,
   trackDockPanelVisibility
 };

package/package.json

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