@forgeax/app-shell 0.29.0 → 0.30.0

package/dist/dock.d.ts

@@ -27,6 +27,23 @@ interface DockReadyActivation<T> {
 }
 /** Own current-value publication and reentrant replacement for dock-ready sessions. */
 declare function createDockReadyActivation<T>(): DockReadyActivation<T>;
+interface DockScopeTransitionAdapter<Scope, Live> {
+    /** Resolve the currently published dock value without retaining it here. */
+    getLive(): Live | null;
+    /** Persist the previous product-owned scope before it is replaced. */
+    save(live: Live, scope: Scope): void;
+    /** Apply the next product-owned scope to the live dock value. */
+    apply(live: Live, scope: Scope | null): void;
+}
+interface DockScopeTransition<Scope> {
+    getCurrent(): Scope | null;
+    /** Save the previous scope, publish the next scope, then apply it when live. */
+    transition(next: Scope | null): boolean;
+    /** Apply the stable current scope to a newly ready or otherwise refreshed dock. */
+    applyCurrent(): boolean;
+}
+/** Own ordered, reentrant-safe scope transitions while product adapters retain policy. */
+declare function createDockScopeTransition<Scope, Live>(adapter: DockScopeTransitionAdapter<Scope, Live>, initial?: Scope | null): DockScopeTransition<Scope>;
 interface PanelDescriptorLite {
     defaultRegion?: DockRegion;
 }
@@ -198,4 +215,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 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 };
+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 DockScopeTransition, type DockScopeTransitionAdapter, type DockviewApiLike, type PanelDescriptorLite, REGIONS, type RectLike, type Region, type SerializedDockLayoutLike, type SerializedDockPanelLike, type SideEdge, createDockLayoutPersistence, createDockPanelCommands, createDockReadyActivation, createDockReadyCleanup, createDockScopeTransition, designedDockPanelPosition, getDockRegions, getDockviewApi, handleCrossInstanceDrop, hasMountedPanelPlacement, installDockPanelVisibilityTracking, isDockPanelVisible, isDockRegion, isOnSideEdge, nearerSideEdge, pruneSerializedDockLayout, registerDockRegion, registerDockviewApi, replaceDockReadyAdapters, resolveRegion, trackDockPanelVisibility };

package/dist/dock.js

@@ -75,6 +75,69 @@ function createDockReadyActivation() {
     }
   };
 }
+function createDockScopeTransition(adapter, initial = null) {
+  let current = initial;
+  let generation = 0;
+  let processing = false;
+  let pending = null;
+  const getLive = () => {
+    try {
+      return adapter.getLive();
+    } catch {
+      return null;
+    }
+  };
+  const enqueue = (next, savePrevious) => {
+    const request = { generation: ++generation, next, savePrevious };
+    pending = request;
+    if (processing) return true;
+    processing = true;
+    let requestedResult = true;
+    let savedPrevious = null;
+    try {
+      while (pending) {
+        const candidate = pending;
+        pending = null;
+        const previous = current;
+        const live = getLive();
+        if (pending) {
+          if (candidate === request) requestedResult = false;
+          continue;
+        }
+        if (candidate.savePrevious && live && previous !== null && savedPrevious !== previous) {
+          try {
+            adapter.save(live, previous);
+          } catch {
+          }
+          savedPrevious = previous;
+          if (pending) {
+            if (candidate === request) requestedResult = false;
+            continue;
+          }
+        }
+        current = candidate.next;
+        if (live) {
+          try {
+            adapter.apply(live, candidate.next);
+          } catch {
+            if (candidate === request) requestedResult = false;
+          }
+        } else if (!candidate.savePrevious && candidate === request) {
+          requestedResult = false;
+        }
+        if (pending && candidate === request) requestedResult = false;
+      }
+    } finally {
+      processing = false;
+    }
+    return requestedResult;
+  };
+  return {
+    getCurrent: () => current,
+    transition: (next) => enqueue(next, true),
+    applyCurrent: () => enqueue(current, false)
+  };
+}
 function resolveRegion(id, descriptor, overrides) {
   return overrides[id] ?? descriptor.defaultRegion ?? "DockShell";
 }
@@ -420,6 +483,7 @@ export {
   createDockPanelCommands,
   createDockReadyActivation,
   createDockReadyCleanup,
+  createDockScopeTransition,
   designedDockPanelPosition,
   getDockRegions,
   getDockviewApi,

package/package.json

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