@forgeax/interface 0.9.4 → 0.9.5

package/dist/package/browser/appHostBootstrap.d.ts

@@ -11,6 +11,10 @@ export interface AppHostBootstrapOverrides {
 export interface AppHostBootstrapResult {
     host: AppHost;
     control: AppHostControl;
+    /** Begins terminal shutdown. A rejection may follow successful owner cleanup:
+     * the runtime is not safe to resume using and disposal is not atomic. Resolve
+     * an explicit cleanup deferral and retry dispose to finish remaining owners;
+     * already retired owners are not restored or cleaned up again. */
     dispose: () => Promise<void>;
 }
 export declare function bootstrapAppHost(overrides?: AppHostBootstrapOverrides): Promise<AppHostBootstrapResult>;

package/dist/package/browser/application.d.ts

@@ -8,6 +8,9 @@ export interface InterfaceApplicationStartupOptions {
     /** Product-selected initial locale. Persisted locale remains authoritative when omitted. */
     readonly locale?: Locale;
 }
+/** Products retain this owner above their replaceable recovery/runtime subtree.
+ * Only the explicit pre-destructive deferrals permit a user-requested retry. */
+export declare function createInterfaceApplicationOwner(): import("@forgeax/app-shell/application").ApplicationRuntimeOwner;
 /**
  * Lets a product replace one shell overlay with its own destination. Interface
  * owns observation, clearing and synchronous reentry; the product owns routing.

package/dist/package/browser/application.js

@@ -1,7 +1,19 @@
+import { ApplicationStartupCleanupError, createApplicationRuntimeOwner } from '@forgeax/app-shell/application';
+import { ExtensionCleanupDeferredError, ExtensionUnloadDeferredError } from '@forgeax/extension-platform/extensions';
+import { PageClosePreparationDeferredError } from './core/page-platform/session';
 import { bootstrapAppHost, } from './appHostBootstrap';
 import { bootStageAppMounted } from './boot/driver';
 import { changeLanguage, initI18n } from './i18n';
 import { useShellStore } from './store';
+/** Products retain this owner above their replaceable recovery/runtime subtree.
+ * Only the explicit pre-destructive deferrals permit a user-requested retry. */
+export function createInterfaceApplicationOwner() {
+    return createApplicationRuntimeOwner({
+        isCleanupDeferred: error => error instanceof ExtensionCleanupDeferredError
+            || error instanceof ExtensionUnloadDeferredError
+            || error instanceof PageClosePreparationDeferredError,
+    });
+}
 /**
  * Lets a product replace one shell overlay with its own destination. Interface
  * owns observation, clearing and synchronous reentry; the product owns routing.
@@ -43,8 +55,9 @@ export async function startInterfaceApplication(overrides = {}, options = {}) {
         try {
             await runtime.dispose();
         }
-        catch {
-            // Startup failure stays authoritative when rollback also fails.
+        catch (cleanupError) {
+            // Transfer unfinished ownership instead of dropping the only disposer.
+            throw new ApplicationStartupCleanupError(error, runtime, cleanupError);
         }
         throw error;
     }

package/dist/package/node/application.js

@@ -1,7 +1,19 @@
+import { ApplicationStartupCleanupError, createApplicationRuntimeOwner } from '@forgeax/app-shell/application';
+import { ExtensionCleanupDeferredError, ExtensionUnloadDeferredError } from '@forgeax/extension-platform/extensions';
+import { PageClosePreparationDeferredError } from './core/page-platform/session.js';
 import { bootstrapAppHost, } from './appHostBootstrap.js';
 import { bootStageAppMounted } from './boot/driver.js';
 import { changeLanguage, initI18n } from './i18n/index.js';
 import { useShellStore } from './store.js';
+/** Products retain this owner above their replaceable recovery/runtime subtree.
+ * Only the explicit pre-destructive deferrals permit a user-requested retry. */
+export function createInterfaceApplicationOwner() {
+    return createApplicationRuntimeOwner({
+        isCleanupDeferred: error => error instanceof ExtensionCleanupDeferredError
+            || error instanceof ExtensionUnloadDeferredError
+            || error instanceof PageClosePreparationDeferredError,
+    });
+}
 /**
  * Lets a product replace one shell overlay with its own destination. Interface
  * owns observation, clearing and synchronous reentry; the product owns routing.
@@ -43,8 +55,9 @@ export async function startInterfaceApplication(overrides = {}, options = {}) {
         try {
             await runtime.dispose();
         }
-        catch {
-            // Startup failure stays authoritative when rollback also fails.
+        catch (cleanupError) {
+            // Transfer unfinished ownership instead of dropping the only disposer.
+            throw new ApplicationStartupCleanupError(error, runtime, cleanupError);
         }
         throw error;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/interface",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "type": "module",
   "description": "ForgeaX product interface shell and application composition boundary.",
   "license": "Apache-2.0",
@@ -92,7 +92,7 @@
     "lint:dep": "depcruise -c .dependency-cruiser.cjs src"
   },
   "dependencies": {
-    "@forgeax/app-shell": "0.89.0",
+    "@forgeax/app-shell": "0.90.0",
     "@forgeax/extension-host": "0.3.2",
     "@forgeax/extension-platform": "0.7.0",
     "@forgeax/toolkit": "0.1.2",