@forgeax/interface 0.9.2 → 0.9.4

package/dist/package/browser/appHostBootstrap.js

@@ -15,6 +15,7 @@
 // the extension's cleanup, so a pure-UI extension needs no setup at all.
 import { createAppHost, } from './core/app-shell';
 import { createExtensionLoader } from './core/extension-foundation/loader';
+import { ExtensionCleanupDeferredError, ExtensionSetupRollbackDeferredError } from '@forgeax/extension-platform/extensions';
 import { foundationCommandsExtension } from './core/extensions/foundation-commands';
 import { foundationBusExtension } from './core/extensions/foundation-bus';
 import { foundationStorageExtension } from './core/extensions/foundation-storage';
@@ -63,6 +64,12 @@ export async function bootstrapAppHost(overrides = {}) {
             control.beginSetup(m);
             const cleanups = [];
             let pageCleanup;
+            const rollback = async () => {
+                // Page preparation is the barrier before any destructive cleanup.
+                await pageCleanup?.();
+                for (const cleanup of cleanups.slice().reverse())
+                    await cleanup();
+            };
             try {
                 for (const menu of m.contributes?.menus ?? []) {
                     cleanups.push(host.menus.register(menu));
@@ -89,20 +96,18 @@ export async function bootstrapAppHost(overrides = {}) {
                     cleanups.push(r);
                 if (cleanups.length === 0 && !pageCleanup)
                     return undefined;
-                return async () => {
-                    // Controllers get the first say. If one vetoes/needs a user decision,
-                    // no declarative or imperative contribution is torn down underneath it.
-                    await pageCleanup?.();
-                    for (const c of cleanups.slice().reverse())
-                        await c();
-                };
+                return rollback;
             }
             catch (error) {
-                // Preserve the same page-close decision boundary on failed setup.
-                // A dirty page must not lose its surrounding contributions underneath it.
-                await pageCleanup?.();
-                for (const cleanup of cleanups.slice().reverse())
-                    await cleanup();
+                try {
+                    await rollback();
+                }
+                catch (rollbackError) {
+                    if (rollbackError instanceof ExtensionCleanupDeferredError) {
+                        throw new ExtensionSetupRollbackDeferredError({ cause: error, rollback });
+                    }
+                    throw rollbackError;
+                }
                 throw error;
             }
             finally {

package/dist/package/browser/core/app-shell/catalog-page-extensions.js

@@ -4,6 +4,7 @@ import { listExtensions, listExtensionsShared, } from '../../lib/extension-api';
 import { ExtensionHostPanel } from '../../components/DockShell/ExtensionHostPanel';
 import { isExtensionHostExtension } from '../../components/DockShell/extensionRuntime';
 import { getLocale } from '../../i18n';
+import { ExtensionCleanupDeferredError } from '@forgeax/extension-platform/extensions';
 function title(value) {
     if (typeof value === 'string')
         return value;
@@ -162,22 +163,42 @@ export function createCatalogPageExtensionRuntime(options) {
     let events;
     let chain = Promise.resolve();
     let disposed = false;
+    const reportError = (error, id, phase) => {
+        try {
+            onError(error, id, phase);
+        }
+        catch { /* Isolate the diagnostic sink. */ }
+    };
+    const retire = async (id, record) => {
+        try {
+            await record.cleanup();
+        }
+        catch (error) {
+            reportError(error, id, 'cleanup');
+            if (error instanceof ExtensionCleanupDeferredError)
+                throw error;
+            // Ordinary teardown may already be destructive; never retry it.
+        }
+        active.delete(id);
+        generation = undefined;
+    };
     const reconcile = async (response) => {
         if (generation !== undefined && response.generation === generation)
             return;
         const itemsById = new Map(response.items.map((item) => [item.id, item]));
         const next = new Map(catalogPageExtensions(response.items, options.overriddenIds)
             .map((extension) => [extension.id, extension]));
-        for (const [id, record] of [...active]) {
+        for (const [id, record] of [...active].reverse()) {
             const item = itemsById.get(id);
             const signature = catalogItemSignature(item);
             if (!next.has(id) || signature !== record.signature) {
                 try {
-                    await record.cleanup();
-                    active.delete(id);
+                    await retire(id, record);
                 }
                 catch (error) {
-                    onError(error, id, 'cleanup');
+                    // Keep the barrier and allow a later refresh of this same generation.
+                    generation = undefined;
+                    return;
                 }
             }
         }
@@ -195,7 +216,7 @@ export function createCatalogPageExtensionRuntime(options) {
                 active.set(id, { signature: catalogItemSignature(itemsById.get(id)), cleanup });
             }
             catch (error) {
-                onError(error, id, 'register');
+                reportError(error, id, 'register');
             }
         }
         generation = response.generation;
@@ -221,14 +242,17 @@ export function createCatalogPageExtensionRuntime(options) {
                 }
             }
         },
-        async dispose() {
-            disposed = true;
-            events?.close();
-            events = undefined;
-            await chain.catch(() => undefined);
-            for (const record of [...active.values()].reverse())
-                await record.cleanup();
-            active.clear();
+        dispose() {
+            chain = chain.catch(() => undefined).then(async () => {
+                if (disposed)
+                    return;
+                for (const [id, record] of [...active].reverse())
+                    await retire(id, record);
+                disposed = true;
+                events?.close();
+                events = undefined;
+            });
+            return chain;
         },
     };
 }

package/dist/package/browser/core/app-shell/host.js

@@ -7,13 +7,14 @@ import { createCapabilityRegistry } from '../extension-foundation/capabilities';
 import { createContributionRegistry } from '../extension-foundation/contribution-registry';
 import { ExtensionConflictError } from '../extension-foundation/errors';
 import { createPanelActionRegistry, createPanelControlRegistry } from '../panels';
-import { createPageRegistry, createPageSession, createActivityRegistry, createResourceEditorResolver, } from '../page-platform';
+import { createPageRegistry, createPageSession, PageClosePreparationDeferredError, createActivityRegistry, createResourceEditorResolver, } from '../page-platform';
 import { consoleLogger } from './logger';
 import { derivePanelRenderers } from './derive-panel-renderers';
 import { DEFAULT_PANEL_RENDERERS } from '../../components/DockShell/panelRenderers';
 import { installPageNavigation } from '../page-navigation';
 import { createContextualKeybindings } from '../contextual-keybindings';
 import { createApplicationShortcutRegistry, createApplicationMenuRegistry } from '@forgeax/app-shell/application';
+import { ExtensionCleanupDeferredError } from '@forgeax/extension-platform/extensions';
 const BUILT_IN_CAPS = [
     'commands', 'keybindings', 'shortcuts', 'menus', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
     'activities', 'resourceEditors',
@@ -158,7 +159,15 @@ export function createAppHost(deps = {}) {
                     return;
                 // The registry still knows the owner while controllers preflight close.
                 // A dirty/vetoed page rejects cleanup and leaves the contribution live.
-                await pageSession.closeOwnedBy(owner);
+                try {
+                    await pageSession.closeOwnedBy(owner);
+                }
+                catch (error) {
+                    if (error instanceof PageClosePreparationDeferredError) {
+                        throw new ExtensionCleanupDeferredError(error.message);
+                    }
+                    throw error;
+                }
                 removeContribution();
                 removed = true;
             };
@@ -181,8 +190,8 @@ export function createAppHost(deps = {}) {
             }
         },
         async dispose() {
-            removePageNavigation();
             await pageSession.dispose();
+            removePageNavigation();
             keybindings.dispose();
             shortcuts.dispose();
             menus.dispose();

package/dist/package/browser/core/page-platform/session.d.ts

@@ -1,4 +1,9 @@
 import type { PageCloseDecision, PageCloseReason, PagePort, PageRegistry } from './types';
+import { PagePlatformError } from './types';
+/** Explicit close decision barrier, emitted before any controller teardown. */
+export declare class PageClosePreparationDeferredError extends PagePlatformError {
+    constructor(code: 'PAGE_CLOSE_VETOED' | 'PAGE_CLOSE_REQUIRES_DECISION', message: string, details?: Readonly<Record<string, unknown>>);
+}
 export interface PageSession extends PagePort {
     closeOwnedBy(owner: string, reason?: PageCloseReason, decision?: PageCloseDecision): Promise<void>;
     dispose(): Promise<void>;

package/dist/package/browser/core/page-platform/session.js

@@ -1,6 +1,13 @@
 import { decodePageKey, encodePageKey, } from '@forgeax/types';
 import { PagePlatformError } from './types';
 import { getCurrentProject, subscribeCurrentProject } from '../../lib/project-context';
+/** Explicit close decision barrier, emitted before any controller teardown. */
+export class PageClosePreparationDeferredError extends PagePlatformError {
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = 'PageClosePreparationDeferredError';
+    }
+}
 const inertController = {
     prepareClose: () => ({ status: 'ready' }),
     dispose: () => undefined,
@@ -103,17 +110,17 @@ export function createPageSession(registry, options = {}) {
         if (preparation.status === 'ready')
             return;
         if (preparation.status === 'vetoed') {
-            throw new PagePlatformError('PAGE_CLOSE_VETOED', preparation.message ?? 'page refused to close', {
+            throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', preparation.message ?? 'page refused to close', {
                 key: entry.instance.encodedKey,
                 reason,
             });
         }
         if (!decision || decision === 'cancel') {
-            throw new PagePlatformError('PAGE_CLOSE_REQUIRES_DECISION', preparation.message ?? 'page has unsaved changes', { key: entry.instance.encodedKey, reason });
+            throw new PageClosePreparationDeferredError('PAGE_CLOSE_REQUIRES_DECISION', preparation.message ?? 'page has unsaved changes', { key: entry.instance.encodedKey, reason });
         }
         if (decision === 'save') {
             if (!entry.controller.save) {
-                throw new PagePlatformError('PAGE_CLOSE_VETOED', 'page cannot save its dirty state', {
+                throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', 'page cannot save its dirty state', {
                     key: entry.instance.encodedKey,
                     reason,
                 });
@@ -122,7 +129,7 @@ export function createPageSession(registry, options = {}) {
         }
         else {
             if (!entry.controller.discard) {
-                throw new PagePlatformError('PAGE_CLOSE_VETOED', 'page cannot discard its dirty state', {
+                throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', 'page cannot discard its dirty state', {
                     key: entry.instance.encodedKey,
                     reason,
                 });

package/dist/package/browser/core/panels/panel-action-registry.d.ts

@@ -1,6 +1,4 @@
-import type { Cleanup } from '../extension-foundation/types';
-import type { PanelActionContribution, PanelActionsApi } from './types';
-export interface PanelActionRegistry extends PanelActionsApi {
-    contribute(owner: string, actions: readonly PanelActionContribution[]): Cleanup;
-}
-export declare function createPanelActionRegistry(): PanelActionRegistry;
+import { type PanelActionRegistry as Registry } from '@forgeax/app-shell/application';
+import type { PanelActionContribution } from './types';
+export type PanelActionRegistry = Registry<PanelActionContribution>;
+export declare const createPanelActionRegistry: () => Registry<PanelActionContribution>;

package/dist/package/browser/core/panels/panel-action-registry.js

@@ -1,62 +1,2 @@
-export function createPanelActionRegistry() {
-    const entries = [];
-    const listeners = new Set();
-    let cache = null;
-    let version = 0;
-    const emit = () => {
-        cache = null;
-        version++;
-        for (const listener of [...listeners])
-            listener();
-    };
-    // Batch-deferred notification: data mutations (push/splice) happen
-    // immediately so reads (list/all) always return fresh data, but listener
-    // notifications are deferred to a microtask. This avoids triggering
-    // forceStoreRerender (useSyncExternalStore) during React 19's commit
-    // phase, which otherwise causes "Maximum update depth exceeded".
-    let emitScheduled = false;
-    const scheduleEmit = () => {
-        cache = null;
-        if (emitScheduled)
-            return;
-        emitScheduled = true;
-        queueMicrotask(() => {
-            emitScheduled = false;
-            emit();
-        });
-    };
-    const all = () => {
-        if (cache)
-            return cache;
-        cache = entries.flatMap((entry) => entry.actions).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
-        return cache;
-    };
-    return {
-        contribute(owner, actions) {
-            const entry = { owner, actions };
-            entries.push(entry);
-            scheduleEmit();
-            let removed = false;
-            return () => {
-                if (removed)
-                    return;
-                removed = true;
-                const index = entries.indexOf(entry);
-                if (index >= 0)
-                    entries.splice(index, 1);
-                scheduleEmit();
-            };
-        },
-        list(panelId) {
-            return all().filter((action) => action.panelId === panelId);
-        },
-        all,
-        onChange(listener) {
-            listeners.add(listener);
-            return () => { listeners.delete(listener); };
-        },
-        version() {
-            return version;
-        },
-    };
-}
+import { createPanelActionRegistry as createRegistry, } from '@forgeax/app-shell/application';
+export const createPanelActionRegistry = (createRegistry);

package/dist/package/browser/core/panels/panel-control-registry.d.ts

@@ -1,6 +1,4 @@
-import type { Cleanup } from '../extension-foundation/types';
-import type { PanelControlContribution, PanelControlsApi } from './types';
-export interface PanelControlRegistry extends PanelControlsApi {
-    contribute(owner: string, controls: readonly PanelControlContribution[]): Cleanup;
-}
-export declare function createPanelControlRegistry(): PanelControlRegistry;
+import { type PanelControlRegistry as Registry } from '@forgeax/app-shell/application';
+import type { PanelControlContribution } from './types';
+export type PanelControlRegistry = Registry<PanelControlContribution>;
+export declare const createPanelControlRegistry: () => Registry<PanelControlContribution>;

package/dist/package/browser/core/panels/panel-control-registry.js

@@ -1,54 +1,2 @@
-export function createPanelControlRegistry() {
-    const entries = [];
-    const listeners = new Set();
-    let version = 0;
-    const emit = () => {
-        version++;
-        for (const listener of [...listeners])
-            listener();
-    };
-    // Batch-deferred notification: data mutations (push/splice) happen
-    // immediately so reads (list/get) always return fresh data, but listener
-    // notifications are deferred to a microtask. This avoids triggering
-    // forceStoreRerender (useSyncExternalStore) during React 19's commit
-    // phase, which otherwise causes "Maximum update depth exceeded".
-    let emitScheduled = false;
-    const scheduleEmit = () => {
-        if (emitScheduled)
-            return;
-        emitScheduled = true;
-        queueMicrotask(() => {
-            emitScheduled = false;
-            emit();
-        });
-    };
-    const list = () => entries.flatMap((entry) => entry.controls);
-    return {
-        contribute(owner, controls) {
-            const entry = { owner, controls };
-            entries.push(entry);
-            scheduleEmit();
-            let removed = false;
-            return () => {
-                if (removed)
-                    return;
-                removed = true;
-                const index = entries.indexOf(entry);
-                if (index >= 0)
-                    entries.splice(index, 1);
-                scheduleEmit();
-            };
-        },
-        get(id) {
-            return list().find((control) => control.id === id);
-        },
-        list,
-        onChange(listener) {
-            listeners.add(listener);
-            return () => { listeners.delete(listener); };
-        },
-        version() {
-            return version;
-        },
-    };
-}
+import { createPanelControlRegistry as createRegistry, } from '@forgeax/app-shell/application';
+export const createPanelControlRegistry = (createRegistry);

package/dist/package/node/appHostBootstrap.js

@@ -15,6 +15,7 @@
 // the extension's cleanup, so a pure-UI extension needs no setup at all.
 import { createAppHost, } from './core/app-shell/index.js';
 import { createExtensionLoader } from './core/extension-foundation/loader.js';
+import { ExtensionCleanupDeferredError, ExtensionSetupRollbackDeferredError } from '@forgeax/extension-platform/extensions';
 import { foundationCommandsExtension } from './core/extensions/foundation-commands.js';
 import { foundationBusExtension } from './core/extensions/foundation-bus.js';
 import { foundationStorageExtension } from './core/extensions/foundation-storage.js';
@@ -63,6 +64,12 @@ export async function bootstrapAppHost(overrides = {}) {
             control.beginSetup(m);
             const cleanups = [];
             let pageCleanup;
+            const rollback = async () => {
+                // Page preparation is the barrier before any destructive cleanup.
+                await pageCleanup?.();
+                for (const cleanup of cleanups.slice().reverse())
+                    await cleanup();
+            };
             try {
                 for (const menu of m.contributes?.menus ?? []) {
                     cleanups.push(host.menus.register(menu));
@@ -89,20 +96,18 @@ export async function bootstrapAppHost(overrides = {}) {
                     cleanups.push(r);
                 if (cleanups.length === 0 && !pageCleanup)
                     return undefined;
-                return async () => {
-                    // Controllers get the first say. If one vetoes/needs a user decision,
-                    // no declarative or imperative contribution is torn down underneath it.
-                    await pageCleanup?.();
-                    for (const c of cleanups.slice().reverse())
-                        await c();
-                };
+                return rollback;
             }
             catch (error) {
-                // Preserve the same page-close decision boundary on failed setup.
-                // A dirty page must not lose its surrounding contributions underneath it.
-                await pageCleanup?.();
-                for (const cleanup of cleanups.slice().reverse())
-                    await cleanup();
+                try {
+                    await rollback();
+                }
+                catch (rollbackError) {
+                    if (rollbackError instanceof ExtensionCleanupDeferredError) {
+                        throw new ExtensionSetupRollbackDeferredError({ cause: error, rollback });
+                    }
+                    throw rollbackError;
+                }
                 throw error;
             }
             finally {

package/dist/package/node/core/app-shell/catalog-page-extensions.js

@@ -4,6 +4,7 @@ import { listExtensions, listExtensionsShared, } from '../../lib/extension-api.j
 import { ExtensionHostPanel } from '../../components/DockShell/ExtensionHostPanel.js';
 import { isExtensionHostExtension } from '../../components/DockShell/extensionRuntime.js';
 import { getLocale } from '../../i18n/index.js';
+import { ExtensionCleanupDeferredError } from '@forgeax/extension-platform/extensions';
 function title(value) {
     if (typeof value === 'string')
         return value;
@@ -162,22 +163,42 @@ export function createCatalogPageExtensionRuntime(options) {
     let events;
     let chain = Promise.resolve();
     let disposed = false;
+    const reportError = (error, id, phase) => {
+        try {
+            onError(error, id, phase);
+        }
+        catch { /* Isolate the diagnostic sink. */ }
+    };
+    const retire = async (id, record) => {
+        try {
+            await record.cleanup();
+        }
+        catch (error) {
+            reportError(error, id, 'cleanup');
+            if (error instanceof ExtensionCleanupDeferredError)
+                throw error;
+            // Ordinary teardown may already be destructive; never retry it.
+        }
+        active.delete(id);
+        generation = undefined;
+    };
     const reconcile = async (response) => {
         if (generation !== undefined && response.generation === generation)
             return;
         const itemsById = new Map(response.items.map((item) => [item.id, item]));
         const next = new Map(catalogPageExtensions(response.items, options.overriddenIds)
             .map((extension) => [extension.id, extension]));
-        for (const [id, record] of [...active]) {
+        for (const [id, record] of [...active].reverse()) {
             const item = itemsById.get(id);
             const signature = catalogItemSignature(item);
             if (!next.has(id) || signature !== record.signature) {
                 try {
-                    await record.cleanup();
-                    active.delete(id);
+                    await retire(id, record);
                 }
                 catch (error) {
-                    onError(error, id, 'cleanup');
+                    // Keep the barrier and allow a later refresh of this same generation.
+                    generation = undefined;
+                    return;
                 }
             }
         }
@@ -195,7 +216,7 @@ export function createCatalogPageExtensionRuntime(options) {
                 active.set(id, { signature: catalogItemSignature(itemsById.get(id)), cleanup });
             }
             catch (error) {
-                onError(error, id, 'register');
+                reportError(error, id, 'register');
             }
         }
         generation = response.generation;
@@ -221,14 +242,17 @@ export function createCatalogPageExtensionRuntime(options) {
                 }
             }
         },
-        async dispose() {
-            disposed = true;
-            events?.close();
-            events = undefined;
-            await chain.catch(() => undefined);
-            for (const record of [...active.values()].reverse())
-                await record.cleanup();
-            active.clear();
+        dispose() {
+            chain = chain.catch(() => undefined).then(async () => {
+                if (disposed)
+                    return;
+                for (const [id, record] of [...active].reverse())
+                    await retire(id, record);
+                disposed = true;
+                events?.close();
+                events = undefined;
+            });
+            return chain;
         },
     };
 }

package/dist/package/node/core/app-shell/host.js

@@ -7,13 +7,14 @@ import { createCapabilityRegistry } from '../extension-foundation/capabilities.j
 import { createContributionRegistry } from '../extension-foundation/contribution-registry.js';
 import { ExtensionConflictError } from '../extension-foundation/errors.js';
 import { createPanelActionRegistry, createPanelControlRegistry } from '../panels/index.js';
-import { createPageRegistry, createPageSession, createActivityRegistry, createResourceEditorResolver, } from '../page-platform/index.js';
+import { createPageRegistry, createPageSession, PageClosePreparationDeferredError, createActivityRegistry, createResourceEditorResolver, } from '../page-platform/index.js';
 import { consoleLogger } from './logger.js';
 import { derivePanelRenderers } from './derive-panel-renderers.js';
 import { DEFAULT_PANEL_RENDERERS } from '../../components/DockShell/panelRenderers.js';
 import { installPageNavigation } from '../page-navigation.js';
 import { createContextualKeybindings } from '../contextual-keybindings.js';
 import { createApplicationShortcutRegistry, createApplicationMenuRegistry } from '@forgeax/app-shell/application';
+import { ExtensionCleanupDeferredError } from '@forgeax/extension-platform/extensions';
 const BUILT_IN_CAPS = [
     'commands', 'keybindings', 'shortcuts', 'menus', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
     'activities', 'resourceEditors',
@@ -158,7 +159,15 @@ export function createAppHost(deps = {}) {
                     return;
                 // The registry still knows the owner while controllers preflight close.
                 // A dirty/vetoed page rejects cleanup and leaves the contribution live.
-                await pageSession.closeOwnedBy(owner);
+                try {
+                    await pageSession.closeOwnedBy(owner);
+                }
+                catch (error) {
+                    if (error instanceof PageClosePreparationDeferredError) {
+                        throw new ExtensionCleanupDeferredError(error.message);
+                    }
+                    throw error;
+                }
                 removeContribution();
                 removed = true;
             };
@@ -181,8 +190,8 @@ export function createAppHost(deps = {}) {
             }
         },
         async dispose() {
-            removePageNavigation();
             await pageSession.dispose();
+            removePageNavigation();
             keybindings.dispose();
             shortcuts.dispose();
             menus.dispose();

package/dist/package/node/core/page-platform/session.js

@@ -1,6 +1,13 @@
 import { decodePageKey, encodePageKey, } from '@forgeax/types';
 import { PagePlatformError } from './types.js';
 import { getCurrentProject, subscribeCurrentProject } from '../../lib/project-context.js';
+/** Explicit close decision barrier, emitted before any controller teardown. */
+export class PageClosePreparationDeferredError extends PagePlatformError {
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = 'PageClosePreparationDeferredError';
+    }
+}
 const inertController = {
     prepareClose: () => ({ status: 'ready' }),
     dispose: () => undefined,
@@ -103,17 +110,17 @@ export function createPageSession(registry, options = {}) {
         if (preparation.status === 'ready')
             return;
         if (preparation.status === 'vetoed') {
-            throw new PagePlatformError('PAGE_CLOSE_VETOED', preparation.message ?? 'page refused to close', {
+            throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', preparation.message ?? 'page refused to close', {
                 key: entry.instance.encodedKey,
                 reason,
             });
         }
         if (!decision || decision === 'cancel') {
-            throw new PagePlatformError('PAGE_CLOSE_REQUIRES_DECISION', preparation.message ?? 'page has unsaved changes', { key: entry.instance.encodedKey, reason });
+            throw new PageClosePreparationDeferredError('PAGE_CLOSE_REQUIRES_DECISION', preparation.message ?? 'page has unsaved changes', { key: entry.instance.encodedKey, reason });
         }
         if (decision === 'save') {
             if (!entry.controller.save) {
-                throw new PagePlatformError('PAGE_CLOSE_VETOED', 'page cannot save its dirty state', {
+                throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', 'page cannot save its dirty state', {
                     key: entry.instance.encodedKey,
                     reason,
                 });
@@ -122,7 +129,7 @@ export function createPageSession(registry, options = {}) {
         }
         else {
             if (!entry.controller.discard) {
-                throw new PagePlatformError('PAGE_CLOSE_VETOED', 'page cannot discard its dirty state', {
+                throw new PageClosePreparationDeferredError('PAGE_CLOSE_VETOED', 'page cannot discard its dirty state', {
                     key: entry.instance.encodedKey,
                     reason,
                 });

package/dist/package/node/core/panels/panel-action-registry.js

@@ -1,62 +1,2 @@
-export function createPanelActionRegistry() {
-    const entries = [];
-    const listeners = new Set();
-    let cache = null;
-    let version = 0;
-    const emit = () => {
-        cache = null;
-        version++;
-        for (const listener of [...listeners])
-            listener();
-    };
-    // Batch-deferred notification: data mutations (push/splice) happen
-    // immediately so reads (list/all) always return fresh data, but listener
-    // notifications are deferred to a microtask. This avoids triggering
-    // forceStoreRerender (useSyncExternalStore) during React 19's commit
-    // phase, which otherwise causes "Maximum update depth exceeded".
-    let emitScheduled = false;
-    const scheduleEmit = () => {
-        cache = null;
-        if (emitScheduled)
-            return;
-        emitScheduled = true;
-        queueMicrotask(() => {
-            emitScheduled = false;
-            emit();
-        });
-    };
-    const all = () => {
-        if (cache)
-            return cache;
-        cache = entries.flatMap((entry) => entry.actions).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
-        return cache;
-    };
-    return {
-        contribute(owner, actions) {
-            const entry = { owner, actions };
-            entries.push(entry);
-            scheduleEmit();
-            let removed = false;
-            return () => {
-                if (removed)
-                    return;
-                removed = true;
-                const index = entries.indexOf(entry);
-                if (index >= 0)
-                    entries.splice(index, 1);
-                scheduleEmit();
-            };
-        },
-        list(panelId) {
-            return all().filter((action) => action.panelId === panelId);
-        },
-        all,
-        onChange(listener) {
-            listeners.add(listener);
-            return () => { listeners.delete(listener); };
-        },
-        version() {
-            return version;
-        },
-    };
-}
+import { createPanelActionRegistry as createRegistry, } from '@forgeax/app-shell/application';
+export const createPanelActionRegistry = (createRegistry);

package/dist/package/node/core/panels/panel-control-registry.js

@@ -1,54 +1,2 @@
-export function createPanelControlRegistry() {
-    const entries = [];
-    const listeners = new Set();
-    let version = 0;
-    const emit = () => {
-        version++;
-        for (const listener of [...listeners])
-            listener();
-    };
-    // Batch-deferred notification: data mutations (push/splice) happen
-    // immediately so reads (list/get) always return fresh data, but listener
-    // notifications are deferred to a microtask. This avoids triggering
-    // forceStoreRerender (useSyncExternalStore) during React 19's commit
-    // phase, which otherwise causes "Maximum update depth exceeded".
-    let emitScheduled = false;
-    const scheduleEmit = () => {
-        if (emitScheduled)
-            return;
-        emitScheduled = true;
-        queueMicrotask(() => {
-            emitScheduled = false;
-            emit();
-        });
-    };
-    const list = () => entries.flatMap((entry) => entry.controls);
-    return {
-        contribute(owner, controls) {
-            const entry = { owner, controls };
-            entries.push(entry);
-            scheduleEmit();
-            let removed = false;
-            return () => {
-                if (removed)
-                    return;
-                removed = true;
-                const index = entries.indexOf(entry);
-                if (index >= 0)
-                    entries.splice(index, 1);
-                scheduleEmit();
-            };
-        },
-        get(id) {
-            return list().find((control) => control.id === id);
-        },
-        list,
-        onChange(listener) {
-            listeners.add(listener);
-            return () => { listeners.delete(listener); };
-        },
-        version() {
-            return version;
-        },
-    };
-}
+import { createPanelControlRegistry as createRegistry, } from '@forgeax/app-shell/application';
+export const createPanelControlRegistry = (createRegistry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/interface",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "module",
   "description": "ForgeaX product interface shell and application composition boundary.",
   "license": "Apache-2.0",
@@ -92,9 +92,9 @@
     "lint:dep": "depcruise -c .dependency-cruiser.cjs src"
   },
   "dependencies": {
-    "@forgeax/app-shell": "0.88.0",
+    "@forgeax/app-shell": "0.89.0",
     "@forgeax/extension-host": "0.3.2",
-    "@forgeax/extension-platform": "0.5.0",
+    "@forgeax/extension-platform": "0.7.0",
     "@forgeax/toolkit": "0.1.2",
     "@forgeax/types": "^0.1.3",
     "@google/model-viewer": "^4.2.0",