@mak-98/dirvi-app 0.0.0-stage → 0.11.0-beta.13

package/dist/domain/dirvi-api.d.ts

@@ -0,0 +1,24 @@
+import type { Config } from './config.js';
+import type { AppInput } from './app.js';
+import type { AppApiApplicator } from 'dirvi-apis';
+import type { ExCommand } from './ex-command.js';
+/**
+ * The configured, long-lived Dirvi application API.
+ *
+ * This is created after init.mjs has finished evaluating. Unlike PublicInitApi,
+ * it cannot install packages or register apps: startup composition is sealed.
+ */
+export type DirviApi = {
+    readonly config: Config;
+    readonly initialAppId: string;
+    readonly appIds: readonly string[];
+    readonly customExCommands: readonly ExCommand[];
+    /**
+     * Opens a registered app using host-provided startup input.
+     *
+     * The returned applicator preserves the concrete AppApi generic parameters
+     * selected by the app plugin without exposing them to the host or Shell.
+     */
+    readonly openApp: (appId: string, input: AppInput) => AppApiApplicator;
+};
+//# sourceMappingURL=dirvi-api.d.ts.map

package/dist/domain/dirvi-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirvi-api.d.ts","sourceRoot":"","sources":["../../src/domain/dirvi-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,SAAS,EAAE,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,gBAAgB,CAAC;CACxE,CAAC"}

package/dist/domain/dirvi-api.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,9 @@
+import { DirviApi } from 'dirvi-apis';
+/**
+ * A command registered by init.mjs and invoked through Ex mode.
+ */
+export type ExCommand = {
+    readonly name: string;
+    readonly execute: (api: DirviApi, args: readonly string[]) => void | Promise<void>;
+};
+//# sourceMappingURL=ex-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ex-command.d.ts","sourceRoot":"","sources":["../../src/domain/ex-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpF,CAAC"}

package/dist/domain/ex-command.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,41 @@
+import { AppPlugin } from 'dirvi-apis';
+import { AppPackageReference } from './app-pack-ref.js';
+import { Config, ConfigPatch } from './config.js';
+import { App } from './app.js';
+/**
+ * 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.
+ */
+export type PublicInitApi = {
+    readonly options: {
+        set: (patch: ConfigPatch) => void;
+    };
+    readonly apps: {
+        install: (reference: AppPackageReference) => Promise<AppPlugin>;
+        /**
+         * Registers an application made available by init.mjs.
+         */
+        register: (id: string, appPlugin: AppPlugin) => void;
+        /**
+         * 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;
+    };
+};
+/**
+ * Everything registered while init.mjs was evaluated.
+ *
+ * Config is shared tree-UI configuration. App selection is distinct from Config
+ * value. initialAppId is always the ID of one app in apps: either the app
+ * explicitly selected by init.mjs or the most recently registered app.
+ */
+export type Init = {
+    readonly config: Config;
+    readonly apps: readonly App[];
+    readonly initialAppId: string;
+};
+//# sourceMappingURL=init-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-runtime.d.ts","sourceRoot":"","sources":["../../src/domain/init-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;;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,OAAO,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAChE;;WAEG;QACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;QACrD;;;;WAIG;QACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACvC,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC"}

package/dist/domain/init-runtime.js

@@ -0,0 +1 @@
+export {};

package/dist/domain/initialization.d.ts

@@ -0,0 +1,26 @@
+import { AppPackageReference, Config } from 'dirvi-apis';
+import { ExCommand } from './ex-command.js';
+/**
+ * Resolved startup state produced by evaluating `init.mjs`.
+ *
+ * The initialization script runs before the terminal UI starts. It uses the
+ * temporary `dirvi` configuration facade to set shared options, register app
+ * packages, choose the initial app, and register Ex commands.
+ */
+export type Initialization = {
+    /** Dirvi-wide configuration resolved from the initialization script. */
+    readonly config: Readonly<Config>;
+    /** Registered apps and the app selected for startup. */
+    readonly app: {
+        /** ID of the app to open initially; must be present in `registered`. */
+        initial: string;
+        /** App package references keyed by app ID. */
+        registered: ReadonlyMap<string, AppPackageReference>;
+    };
+    /**
+     * Ex commands registered by the initialization script, keyed by appId and
+     * command name.
+     * */
+    readonly exCommands: ReadonlyMap<string, ReadonlyMap<string, ExCommand>>;
+};
+//# sourceMappingURL=initialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialization.d.ts","sourceRoot":"","sources":["../../src/domain/initialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElC,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE;QACZ,wEAAwE;QACxE,OAAO,EAAE,MAAM,CAAC;QAEhB,8CAA8C;QAC9C,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACtD,CAAC;IAEF;;;SAGK;IACL,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC1E,CAAC"}

package/dist/domain/initialization.js

@@ -0,0 +1 @@
+export {};

package/dist/domain/node-presentation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A semantic highlight name, not a concrete terminal color.
+ *
+ * Dot-separated names allow fallback to broader categories:
+ * "filesystem.directory" can fall back to "filesystem".
+ */
+export type HighlightToken = string;
+export type NodePresentation = Readonly<{
+    content: string;
+    highlight: HighlightToken;
+}>;
+//# sourceMappingURL=node-presentation.d.ts.map

package/dist/domain/node-presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-presentation.d.ts","sourceRoot":"","sources":["../../src/domain/node-presentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;CAC3B,CAAC,CAAC"}

package/dist/domain/node-presentation.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,48 @@
+import { AppPackageReference } from './app-pack-ref.js';
+import { ConfigPatch } from './config.js';
+import { DirviApi } from './dirvi-api/dirvi-api.js';
+/**
+ * The public API exposed to `init.mjs` as the global `dirvi` object.
+ *
+ * An {@link InitRuntime} provides this API while the script runs. It describes
+ * the intended API for TypeScript consumers and provides editor guidance and
+ * compile-time checking. The script uses it to configure Dirvi by evaluation
+ * creating {@link Initialization} object used internally by Dirvi.
+ *
+ * WARNING: Does 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 before relying on them.
+ */
+export type PublicInitApi = {
+    readonly options: {
+        set: (patch: ConfigPatch) => void;
+    };
+    readonly app: {
+        /**
+         * Optionally selects the app initially opened by the shell.
+         *
+         * If omitted, the runtime falls back to the most recently registered app.
+         */
+        initial: (appId: string) => void;
+        /**
+         * Registers an application made available by init.mjs.
+         */
+        register: (id: string, appReference: AppPackageReference) => void;
+    };
+    readonly ex: {
+        /**
+         * Registers an Ex command invoked as `:${name}`.
+         *
+         * The closure receives the live DirviApi when the user invokes the command,
+         * not while init.mjs is being evaluated. E.g.
+         *
+         * ```js
+         * dirvi.ex.register('hello', (api) => {
+         *     // Do something with api
+         * });
+         * ```
+         */
+        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

@@ -0,0 +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,0BAA0B,CAAC;AAEpD;;;;;;;;;;;GAWG;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/domain/public-init-api.js

@@ -0,0 +1 @@
+export {};

package/dist/domain/shell-api.d.ts

@@ -0,0 +1,9 @@
+import type { AppInput } from './app-input.js';
+/**
+ * API exposing methods at the dirvi shell-level.
+ */
+export type ShellApi = {
+    readonly openApp: (appId: string, input: AppInput) => Promise<void>;
+    readonly quit: (message?: string) => void;
+};
+//# sourceMappingURL=shell-api.d.ts.map

package/dist/domain/shell-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-api.d.ts","sourceRoot":"","sources":["../../src/domain/shell-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC"}

package/dist/domain/shell-api.js

@@ -0,0 +1 @@
+export {};