@mak-98/dirvi-app 0.11.0-beta.5 → 0.11.0-beta.6

package/dist/application/init-runtime.d.ts

@@ -11,10 +11,18 @@ export type InitRuntime = {
     readonly finish: () => Initialization;
 };
 /**
- * Creates a fresh startup configuration session.
+ * Creates an isolated startup configuration session.
  *
- * Each runtime owns its own mutable configuration while registration is open.
- * The mutable state is not exposed directly to the config script.
+ * The returned API is exposed to `init.mjs` while the script is evaluated.
+ * Registration calls validate their runtime inputs, and option updates validate
+ * the merged configuration. The session keeps its mutable state private.
+ *
+ * Call `finish()` after evaluating `init.mjs` to seal the session and obtain
+ * the validated initialization. A successful call can happen only once; later
+ * API calls and calls to `finish()` throw an error.
+ *
+ * @returns A fresh initialization runtime with a public registration API and
+ *          a function for sealing the session.
  */
 export declare function createInitRuntime(): InitRuntime;
 //# sourceMappingURL=init-runtime.d.ts.map

package/dist/application/init-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-runtime.d.ts","sourceRoot":"","sources":["../../src/application/init-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,cAAc,CAAC;CACvC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAiI/C"}
+{"version":3,"file":"init-runtime.d.ts","sourceRoot":"","sources":["../../src/application/init-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,cAAc,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CA+G/C"}

package/dist/application/init-runtime.js

@@ -1,101 +1,101 @@
 import { ConfigSchema, defaultConfig, merge } from '../domain/config.js';
+import { AppPackageReference } from '../domain/app-pack-ref.js';
 /**
- * Creates a fresh startup configuration session.
+ * Creates an isolated startup configuration session.
  *
- * Each runtime owns its own mutable configuration while registration is open.
- * The mutable state is not exposed directly to the config script.
+ * The returned API is exposed to `init.mjs` while the script is evaluated.
+ * Registration calls validate their runtime inputs, and option updates validate
+ * the merged configuration. The session keeps its mutable state private.
+ *
+ * Call `finish()` after evaluating `init.mjs` to seal the session and obtain
+ * the validated initialization. A successful call can happen only once; later
+ * API calls and calls to `finish()` throw an error.
+ *
+ * @returns A fresh initialization runtime with a public registration API and
+ *          a function for sealing the session.
  */
 export function createInitRuntime() {
     let config = defaultConfig;
     let initialAppId;
-    const apps = new Map();
+    const registeredApps = new Map();
     const exCommands = new Map();
     let finished = false;
+    const checkFinished = () => {
+        if (finished) {
+            throw new Error('Initialization has finished. Make all initializations while init.mjs is evaluated.');
+        }
+    };
+    const checkNonEmptyString = (value, label) => {
+        if (typeof value !== 'string') {
+            throw new Error(`${label} must be a string.`);
+        }
+        if (value.trim().length === 0) {
+            throw new Error(`${label} must not be empty.`);
+        }
+    };
     return {
         api: {
             options: {
                 set: (patch) => {
-                    // init.mjs is a startup script. It must not modify startup options
-                    // after the host has finished evaluating and consuming it.
-                    if (finished) {
-                        throw new Error('Initialization has finished. Configure dirvi while init.mjs is being evaluated.');
-                    }
+                    checkFinished();
                     // Validate the complete result, not merely the patch. This preserves
                     // domain invariants even when a patch changes nested configuration.
                     config = ConfigSchema.parse(merge(config, patch));
                 },
             },
-            apps: {
+            app: {
                 register: (id, appReference) => {
-                    if (finished) {
-                        throw new Error('Initialization has finished. Register apps while ' +
-                            'init.mjs is being evaluated.');
-                    }
-                    if (id.trim().length === 0) {
-                        throw new Error('App ID must not be empty.');
-                    }
-                    if (apps.has(id)) {
+                    checkFinished();
+                    checkNonEmptyString(id, 'App ID');
+                    if (registeredApps.has(id)) {
                         throw new Error(`An app with ID "${id}" was registered multiple times.`);
                     }
-                    apps.set(id, appReference);
+                    registeredApps.set(id, AppPackageReference.parse(appReference));
                 },
-                initialAppId: (appId) => {
-                    if (finished) {
-                        throw new Error('Initialization has finished. Select an initial app while ' +
-                            'init.mjs is being evaluated.');
-                    }
-                    if (appId.trim().length === 0) {
-                        throw new Error('App ID must not be empty.');
-                    }
+                initial: (appId) => {
+                    checkFinished();
+                    checkNonEmptyString(appId, 'App ID');
                     initialAppId = appId;
                 },
             },
             ex: {
                 register: (name, execute) => {
-                    if (finished) {
-                        throw new Error('Initialization has finished. Register Ex commands while ' +
-                            'init.mjs is being evaluated.');
-                    }
-                    if (name.trim().length === 0) {
-                        throw new Error('Ex command name must not be empty.');
+                    checkFinished();
+                    checkNonEmptyString(name, 'Ex command name');
+                    if (typeof execute !== 'function') {
+                        throw new Error('Ex command handler must be a function.');
                     }
                     if (exCommands.has(name)) {
                         throw new Error(`An Ex command named "${name}" was registered multiple times.`);
                     }
-                    exCommands.set(name, {
-                        name,
-                        execute,
-                    });
+                    exCommands.set(name, { name, execute });
                 },
             },
         },
         finish: () => {
-            if (finished) {
-                throw new Error('Initialization has already finished.');
-            }
-            if (apps.size === 0) {
+            checkFinished();
+            if (registeredApps.size === 0) {
                 throw new Error('Initialization did not register any apps. Call ' +
                     'dirvi.apps.register(id, appReference) at least once in init.mjs.');
             }
+            let initial;
             if (initialAppId !== undefined) {
-                if (!apps.has(initialAppId)) {
+                if (!registeredApps.has(initialAppId)) {
                     throw new Error(`Startup app "${initialAppId}" has not been registered.`);
                 }
-                finished = true;
-                return {
-                    config,
-                    initialAppId: initialAppId,
-                    registeredApps: new Map(apps),
-                    exCommands: [...exCommands.values()],
-                };
+                initial = initialAppId;
+            }
+            else {
+                initial = getLastRegisteredAppId(registeredApps);
             }
-            const lastRegisteredAppRef = getLastRegisteredAppId(apps);
             finished = true;
             return {
                 config,
-                initialAppId: lastRegisteredAppRef,
-                registeredApps: new Map(apps),
-                exCommands: [...exCommands.values()],
+                app: {
+                    initial,
+                    registered: new Map(registeredApps),
+                },
+                exCommands: new Map(exCommands),
             };
         },
     };

package/dist/domain/ex-command.d.ts

@@ -1,12 +1,15 @@
 import { ShellApi } from './shell-api.js';
+export type DirviApi = {
+    shell: ShellApi;
+};
 /**
  * A command registered by init.mjs and invoked through Ex mode.
  *
- * The command receives the live DirviApi only when it is executed. This keeps
+ * The command receives the live Api only when it is executed. This keeps
  * initialization separate from the running application lifecycle.
  */
 export type ExCommand = {
     readonly name: string;
-    readonly execute: (shell: ShellApi) => void | Promise<void>;
+    readonly execute: (api: DirviApi) => void | Promise<void>;
 };
 //# sourceMappingURL=ex-command.d.ts.map

package/dist/domain/ex-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ex-command.d.ts","sourceRoot":"","sources":["../../src/domain/ex-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC"}
+{"version":3,"file":"ex-command.d.ts","sourceRoot":"","sources":["../../src/domain/ex-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAA;AAGD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D,CAAC"}

package/dist/domain/initialization.d.ts

@@ -14,8 +14,10 @@ export type AppInput = string | undefined;
  */
 export type Initialization = {
     readonly config: Readonly<Config>;
-    readonly initialAppId: string;
-    readonly registeredApps: ReadonlyMap<string, AppPackageReference>;
-    readonly exCommands: readonly ExCommand[];
+    readonly app: {
+        initial: string;
+        registered: ReadonlyMap<string, AppPackageReference>;
+    };
+    readonly exCommands: ReadonlyMap<string, ExCommand>;
 };
 //# sourceMappingURL=initialization.d.ts.map

package/dist/domain/initialization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../src/domain/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAClE,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3C,CAAC"}
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../src/domain/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACtD,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrD,CAAC"}

package/dist/domain/public-init-api.d.ts

@@ -1,23 +1,28 @@
 import { AppPackageReference } from './app-pack-ref.js';
 import { ConfigPatch } from './config.js';
-import { ShellApi } from './shell-api.js';
+import { DirviApi } from './ex-command.js';
 /**
- * The startup configuration API exposed to init.mjs as the global `dirvi`.
+ * The startup configuration API exposed to `init.mjs` as the global `dirvi`.
  *
- * This is intentionally a narrow facade. It is the public scripting boundary,
- * rather than an escape hatch into UI state or infrastructure implementations.
+ * These types describe the intended API for TypeScript consumers and provide
+ * editor guidance and compile-time checking. They do not validate values at
+ * runtime: `init.mjs` may be plain JavaScript and can pass values that do not
+ * match these types. The runtime must validate inputs at the scripting
+ * boundary before relying on them.
+ *
+ * This is intentionally a narrow facade; it is the public scripting boundary.
  */
 export type PublicInitApi = {
     readonly options: {
         set: (patch: ConfigPatch) => void;
     };
-    readonly apps: {
+    readonly app: {
         /**
          * Optionally selects the app initially opened by the shell.
          *
          * If omitted, the runtime falls back to the most recently registered app.
          */
-        initialAppId: (appId: string) => void;
+        initial: (appId: string) => void;
         /**
          * Registers an application made available by init.mjs.
          */
@@ -36,7 +41,7 @@ export type PublicInitApi = {
          * });
          * ```
          */
-        register: (name: string, execute: (shell: ShellApi) => void | Promise<void>) => void;
+        register: (name: string, execute: (api: DirviApi) => void | Promise<void>) => void;
     };
 };
 //# sourceMappingURL=public-init-api.d.ts.map

package/dist/domain/public-init-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-init-api.d.ts","sourceRoot":"","sources":["../../src/domain/public-init-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAChB,GAAG,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;KACnC,CAAC;IAEF,QAAQ,CAAC,IAAI,EAAE;QACb;;;;WAIG;QACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QACtC;;WAEG;QACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;KACnE,CAAC;IAEF,QAAQ,CAAC,EAAE,EAAE;QACX;;;;;;;;;;;WAWG;QACH,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC/C,IAAI,CAAC;KACX,CAAC;CACH,CAAC"}
+{"version":3,"file":"public-init-api.d.ts","sourceRoot":"","sources":["../../src/domain/public-init-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAChB,GAAG,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;KACnC,CAAC;IAEF,QAAQ,CAAC,GAAG,EAAE;QACZ;;;;WAIG;QACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC;;WAEG;QACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;KACnE,CAAC;IAEF,QAAQ,CAAC,EAAE,EAAE;QACX;;;;;;;;;;;WAWG;QACH,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC7C,IAAI,CAAC;KACX,CAAC;CACH,CAAC"}

package/dist/ui/App.d.ts

@@ -1,14 +1,12 @@
 import type { AppApi, EffectToAction, IntentToEffect, Reducer, SerializableKey, State } from 'dirvi-lib';
-import type { Config } from '../domain/config.js';
 import type { AppScreenRenderer } from './app-screen-renderer.js';
-import { AppPackageReference } from '../domain/app-pack-ref.js';
 import { ShellApi } from '../domain/shell-api.js';
+import { Initialization } from '../domain/initialization.js';
 type AppProps<Id extends SerializableKey, Value, ViewKey = string> = {
     screenRenderer: AppScreenRenderer;
     shellApi: ShellApi;
     appApi: AppApi<Id, Value, ViewKey>;
-    config: Config;
-    registeredApps: ReadonlyMap<string, AppPackageReference>;
+    initialization: Initialization;
     initialState: State<Id, Value>;
     reducer: Reducer<Id, Value>;
     intentToEffect: IntentToEffect<Id, Value>;
@@ -17,6 +15,6 @@ type AppProps<Id extends SerializableKey, Value, ViewKey = string> = {
     clipboard?: (value: string) => void;
     onError?: (error: Error) => void;
 };
-export declare function App<Id extends SerializableKey, Value, ViewKey = string>({ screenRenderer, shellApi, appApi, config, registeredApps, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }: AppProps<Id, Value, ViewKey>): import("react").JSX.Element;
+export declare function App<Id extends SerializableKey, Value, ViewKey = string>({ screenRenderer, shellApi, appApi, initialization, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }: AppProps<Id, Value, ViewKey>): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=App.d.ts.map

package/dist/ui/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,MAAM,EAEN,cAAc,EAEd,cAAc,EAEd,OAAO,EACP,eAAe,EACf,KAAK,EAGN,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMlD,KAAK,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,IAAI;IACnE,cAAc,EAAE,iBAAiB,CAAC;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACzD,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,GAAG,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EACvE,cAAc,EACd,QAAQ,EACR,MAAM,EACN,MAAM,EACN,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAmU9B"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,MAAM,EAEN,cAAc,EAEd,cAAc,EAEd,OAAO,EACP,eAAe,EACf,KAAK,EAGN,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,KAAK,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,IAAI;IACnE,cAAc,EAAE,iBAAiB,CAAC;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,GAAG,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EACvE,cAAc,EACd,QAAQ,EACR,MAAM,EACN,cAAc,EACd,YAAY,EACZ,OAAO,EACP,cAAc,EACd,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAgW9B"}

package/dist/ui/App.js

@@ -2,10 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useReducer, useRef, useState, } from 'react';
 import { createFeedbackApi, userInputToIntent } from 'dirvi-lib';
 import { useView } from './hooks/useView.js';
-function toError(error) {
-    return error instanceof Error ? error : new Error(String(error));
-}
-export function App({ screenRenderer, shellApi, appApi, config, registeredApps, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }) {
+export function App({ screenRenderer, shellApi, appApi, initialization, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }) {
     const ScreenRenderer = screenRenderer;
     const [state, dispatch] = useReducer(reducer, initialState);
     const stateRef = useRef(state); // Gives `subscribeToResync` callback a way to
@@ -72,11 +69,29 @@ export function App({ screenRenderer, shellApi, appApi, config, registeredApps,
             return;
         }
         switch (effect.effectType) {
+            case 'userExCommand': {
+                setInputState({
+                    inputMode: 'normal',
+                    normalBuffer: '',
+                });
+                const command = initialization.exCommands.get(effect.name);
+                if (command === undefined) {
+                    feedbackApi.addMessage(`Command is no longer registered: ${effect.name}`, 'error');
+                    return;
+                }
+                void Promise.resolve()
+                    .then(() => command.execute({ shell: shellApi })) // TODO: Add args
+                    .catch((error) => {
+                    const appError = error instanceof Error ? error : new Error(String(error));
+                    feedbackApi.addMessage(`Command "${effect.name}" failed: ${appError.message}`, 'error');
+                });
+                return;
+            }
             case 'quit':
                 setExitStatus(effect.exitMessage);
                 return;
             case 'listApps': {
-                const appIds = [...registeredApps.keys()];
+                const appIds = [...initialization.app.registered.keys()];
                 const lines = appIds.map((id) => `${id}`);
                 setInputState({
                     inputMode: 'normal',
@@ -211,11 +226,11 @@ export function App({ screenRenderer, shellApi, appApi, config, registeredApps,
                 feedbackApi.addMessage(['Fold trees:', ...lines].join('\n'));
                 return;
             }
-            case 'unrecognizedCommand':
-                feedbackApi.addMessage(`Unrecognized command: ${effect.commandLine}`, 'error');
+            case 'emitError':
+                feedbackApi.addMessage(effect.message, 'error');
                 return;
         }
-    }, [appApi, effectToAction, feedbackApi, navEntry, state, stdout, registeredApps]);
+    }, [appApi, effectToAction, feedbackApi, navEntry, state, stdout, initialization.app.registered, shellApi]);
     // ===========================================================================
     // Input hook
     // ===========================================================================
@@ -234,5 +249,5 @@ export function App({ screenRenderer, shellApi, appApi, config, registeredApps,
     // ===========================================================================
     // Render
     // ===========================================================================
-    return (_jsx(ScreenRenderer, { view: view, feedback: feedback, feedbackApi: feedbackApi, config: config, inputState: inputState, handleInput: handleInput, onRowsChange: handleRowsChange, exitStatus: exitStatus }));
+    return (_jsx(ScreenRenderer, { view: view, feedback: feedback, feedbackApi: feedbackApi, config: initialization.config, inputState: inputState, handleInput: handleInput, onRowsChange: handleRowsChange, exitStatus: exitStatus }));
 }

package/dist/ui/AppSetup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppSetup.d.ts","sourceRoot":"","sources":["../../src/ui/AppSetup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAS,MAAM,WAAW,CAAC;AAOhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,KAAK,eAAe,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,IAAI;IAC1E,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EAC5E,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAwFrC"}
+{"version":3,"file":"AppSetup.d.ts","sourceRoot":"","sources":["../../src/ui/AppSetup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAS,MAAM,WAAW,CAAC;AAOhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,KAAK,eAAe,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,IAAI;IAC1E,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EAC5E,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,QAAQ,EACR,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAuFrC"}

package/dist/ui/AppSetup.js

@@ -4,7 +4,6 @@ import { createEffectToAction, createIntentToEffect, createReducer, } from 'dirv
 import { App } from './App.js';
 export function AppSetup({ appScreenRenderer, loadingScreenRenderer, initialization, shellApi, appApi, stdout, clipboard, }) {
     const [initialState, setInitialState] = useState();
-    const [config, setConfig] = useState(initialization.config);
     // Loading and setting initial state.
     useEffect(() => {
         let mounted = true;
@@ -36,12 +35,12 @@ export function AppSetup({ appScreenRenderer, loadingScreenRenderer, initializat
     }, [appApi]);
     // --- Pure function deps ---
     const reducer = useMemo(() => createReducer(appApi.treeNodeApi, appApi.foldsApi), [appApi.treeNodeApi, appApi.foldsApi]);
-    const intentToEffect = useMemo(() => createIntentToEffect(appApi.stateApi, appApi.cursorApi, appApi.treeNodeApi), [appApi.stateApi, appApi.cursorApi, appApi.treeNodeApi]);
+    const intentToEffect = useMemo(() => createIntentToEffect(new Set(initialization.exCommands.keys()), appApi.stateApi, appApi.cursorApi, appApi.treeNodeApi), [appApi.stateApi, appApi.cursorApi, appApi.treeNodeApi, initialization.exCommands]);
     const effectToAction = useMemo(() => createEffectToAction(appApi.foldsApi, appApi.cursorApi, appApi.navNodeApi), [appApi.navNodeApi, appApi.cursorApi, appApi.foldsApi]);
     // --- JSX ---
     const LoadingScreenRenderer = loadingScreenRenderer;
     if (initialState === undefined) {
         return _jsx(LoadingScreenRenderer, {});
     }
-    return (_jsx(App, { screenRenderer: appScreenRenderer, shellApi: shellApi, appApi: appApi, config: config, registeredApps: initialization.registeredApps, initialState: initialState, reducer: reducer, intentToEffect: intentToEffect, effectToAction: effectToAction, ...(stdout === undefined ? {} : { stdout }), ...(clipboard === undefined ? {} : { clipboard }) }));
+    return (_jsx(App, { screenRenderer: appScreenRenderer, shellApi: shellApi, appApi: appApi, initialization: initialization, initialState: initialState, reducer: reducer, intentToEffect: intentToEffect, effectToAction: effectToAction, ...(stdout === undefined ? {} : { stdout }), ...(clipboard === undefined ? {} : { clipboard }) }));
 }

package/dist/ui/Shell.js

@@ -18,7 +18,7 @@ export function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppOpti
     const shellApi = useMemo(() => {
         return {
             openApp: async (appId, input) => {
-                const appReference = initialization.registeredApps.get(appId);
+                const appReference = initialization.app.registered.get(appId);
                 if (appReference === undefined) {
                     throw new Error(`App "${appId}" has not been registered.`);
                 }
@@ -29,20 +29,20 @@ export function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppOpti
                 setAppApiApplicator(() => loadedAppApiApplicator);
             },
         };
-    }, [initialization.registeredApps, packageLoader]);
+    }, [packageLoader, initialization.app.registered]);
     useEffect(() => {
         void shellApi
-            .openApp(initialAppOptions.app ?? initialization.initialAppId, initialAppOptions.input)
+            .openApp(initialAppOptions.app ?? initialization.app.initial, initialAppOptions.input)
             .catch((error) => {
             setAppError(error instanceof Error ? error : new Error(String(error)));
         });
-    }, [initialAppOptions.input, initialization.initialAppId, shellApi]);
+    }, [initialAppOptions.input, initialization.app.initial, shellApi]);
     if (appError !== undefined) {
         throw appError;
     }
-    const initialAppReference = initialization.registeredApps.get(initialization.initialAppId);
+    const initialAppReference = initialization.app.registered.get(initialization.app.initial);
     if (initialAppReference === undefined) {
-        throw new Error(`Startup app "${initialization.initialAppId}" has not been registered.`);
+        throw new Error(`Startup app "${initialization.app.initial}" has not been registered.`);
     }
     if (appApiApplicator === undefined) {
         const LoadingScreenRenderer = loadingScreenRenderer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mak-98/dirvi-app",
-  "version": "0.11.0-beta.5",
+  "version": "0.11.0-beta.6",
   "description": "Shared React application logic for dirvi hosts.",
   "type": "module",
   "license": "GPL-3.0-or-later",
@@ -16,8 +16,8 @@
     "dist"
   ],
   "dependencies": {
-    "dirvi-apis": "0.11.0-beta.5",
-    "dirvi-lib": "0.11.0-beta.5",
+    "dirvi-apis": "0.11.0-beta.6",
+    "dirvi-lib": "0.11.0-beta.6",
     "zod": "^4.4.3"
   },
   "peerDependencies": {