@mak-98/dirvi-app 0.11.0-beta.2 → 0.11.0-beta.3

package/dist/application/create-app-api.d.ts

@@ -0,0 +1,11 @@
+import { type SerializableKey, type AppApi } from 'dirvi-lib';
+import type { AppApiApplicator, AppDefinition, AppDefinitionApplicator } from 'dirvi-apis';
+/**
+ * Turns a plugin-owned app definition into a host-owned runtime AppApi.
+ *
+ * The plugin's concrete generic types remain hidden by the applicator
+ * boundary, while the host creates the matching AppApi specialization.
+ */
+export declare function createAppApiApplicator(appDefinitionApplicator: AppDefinitionApplicator): AppApiApplicator;
+export declare function createAppApi<Id extends SerializableKey, Value>(appDefinition: AppDefinition<Id, Value>): AppApi<Id, Value>;
+//# sourceMappingURL=create-app-api.d.ts.map

package/dist/application/create-app-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app-api.d.ts","sourceRoot":"","sources":["../../src/application/create-app-api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,MAAM,EAMZ,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,gBAAgB,EAAkB,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE3G;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,uBAAuB,EAAE,uBAAuB,GAC/C,gBAAgB,CAQlB;AAED,wBAAgB,YAAY,CAC1B,EAAE,SAAS,eAAe,EAC1B,KAAK,EACL,aAAa,EAAE,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAyB5D"}

package/dist/application/create-app-api.js

@@ -0,0 +1,33 @@
+import { createCursorApi, createFoldsApi, createNavNodeApi, createStateApi, createTreeNodeApi, } from 'dirvi-lib';
+/**
+ * Turns a plugin-owned app definition into a host-owned runtime AppApi.
+ *
+ * The plugin's concrete generic types remain hidden by the applicator
+ * boundary, while the host creates the matching AppApi specialization.
+ */
+export function createAppApiApplicator(appDefinitionApplicator) {
+    return appDefinitionApplicator((appDefinition) => {
+        const appApi = createAppApi(appDefinition);
+        return (appApiConsumer) => appApiConsumer(appApi);
+    });
+}
+export function createAppApi(appDefinition) {
+    const treeNodeApi = createTreeNodeApi();
+    const foldTreeNodeApi = createTreeNodeApi();
+    const foldsApi = createFoldsApi(foldTreeNodeApi);
+    const cursorApi = createCursorApi();
+    const stateApi = createStateApi(treeNodeApi, cursorApi);
+    const navNodeApi = createNavNodeApi(treeNodeApi, foldsApi, cursorApi, appDefinition.createNavNodeApiOptions);
+    return {
+        name: appDefinition.displayName,
+        rootId: appDefinition.rootId,
+        createRoot: appDefinition.createRoot,
+        loadBranches: appDefinition.loadChildren,
+        subscribeToResync: appDefinition.subscribeToResync,
+        treeNodeApi,
+        foldsApi,
+        cursorApi,
+        stateApi,
+        navNodeApi,
+    };
+}

package/dist/application/package-loader.d.ts

@@ -1,9 +1,9 @@
 import type { AppPackageReference } from '../domain/app-pack-ref.js';
-import type { AppPlugin } from 'dirvi-apis';
+import type { AppPlugin2 } from 'dirvi-apis';
 /**
  * In the future will be expanded to load other plugins too.
  */
 export type PackageLoader = {
-    loadAppPlugin: (reference: AppPackageReference) => Promise<AppPlugin>;
+    loadAppPlugin: (reference: AppPackageReference) => Promise<AppPlugin2>;
 };
 //# sourceMappingURL=package-loader.d.ts.map

package/dist/application/package-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-loader.d.ts","sourceRoot":"","sources":["../../src/application/package-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACvE,CAAC"}
+{"version":3,"file":"package-loader.d.ts","sourceRoot":"","sources":["../../src/application/package-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACxE,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export type { ShellApi } from './domain/shell-api.js';
 export { AppPackageReference } from './domain/app-pack-ref.js';
 export type { PackageLoader } from './application/package-loader.js';
 export { createInitRuntime } from './application/init-runtime.js';
+export { createAppApi } from './application/create-app-api.js';
 export type { ViewRow } from './ui/view.js';
 export { View } from './ui/view.js';
 export { viewNameSchema } from './domain/view-name-schema.js';
@@ -14,4 +15,5 @@ export type { LoadingScreenRenderer } from './ui/loading-screen-renderer.js';
 export { colorConfigToInkColor } from './ui/color-resolver.js';
 export type { AppScreenProps, AppScreenRenderer, } from './ui/app-screen-renderer.js';
 export { Shell } from './ui/Shell.js';
+export type { InitialAppOptions } from './ui/Shell.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { AppPackageReference } from './domain/app-pack-ref.js';
 export { createInitRuntime } from './application/init-runtime.js';
+export { createAppApi } from './application/create-app-api.js';
 export { View } from './ui/view.js';
 export { viewNameSchema } from './domain/view-name-schema.js';
 export { colorConfigToInkColor } from './ui/color-resolver.js';

package/dist/ui/Shell.d.ts

@@ -1,8 +1,20 @@
-import type { AppInput } from '../domain/app.js';
 import type { AppScreenRenderer } from './app-screen-renderer.js';
 import type { LoadingScreenRenderer } from './loading-screen-renderer.js';
 import type { Initialization } from '../domain/initialization.js';
 import type { PackageLoader } from '../application/package-loader.js';
+export type InitialAppOptions = Readonly<{
+    /**
+     * Requested app ID at startup.
+     *
+     * The Shell will later use this to override or select the app chosen by
+     * initialization.
+     */
+    readonly app?: string;
+    /**
+     * Host-provided startup input interpreted by the selected app.
+     */
+    readonly input?: string;
+}>;
 /**
  * Dependencies and output callbacks required by {@link Shell}.
  *
@@ -15,7 +27,7 @@ export type ShellAppProps = {
      */
     readonly loadingScreenRenderer: LoadingScreenRenderer;
     readonly appScreenRenderer: AppScreenRenderer;
-    readonly initialAppInput: AppInput;
+    readonly initialAppOptions: InitialAppOptions;
     readonly initialization: Initialization;
     readonly packageLoader: PackageLoader;
     /** Writes non-interactive application output. */
@@ -33,5 +45,5 @@ export type ShellAppProps = {
  *
  * AppSetup receives the concrete AppApi and mounts the app-specific tree UI.
  */
-export declare function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppInput, initialization, packageLoader, stdout, clipboard, }: ShellAppProps): import("react").JSX.Element;
+export declare function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppOptions, initialization, packageLoader, stdout, clipboard, }: ShellAppProps): import("react").JSX.Element;
 //# sourceMappingURL=Shell.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Shell.d.ts","sourceRoot":"","sources":["../../src/ui/Shell.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE9C,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,MAAM,EACN,SAAS,GACV,EAAE,aAAa,+BAiEf"}
+{"version":3,"file":"Shell.d.ts","sourceRoot":"","sources":["../../src/ui/Shell.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAItE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE9C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,MAAM,EACN,SAAS,GACV,EAAE,aAAa,+BAsEf"}

package/dist/ui/Shell.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useMemo, useState } from 'react';
 import { AppSetup } from './AppSetup.js';
+import { createAppApiApplicator } from '../application/create-app-api.js';
 /**
  * Hosts the currently active application inside the persistent terminal shell.
  *
@@ -11,9 +12,9 @@ import { AppSetup } from './AppSetup.js';
  *
  * AppSetup receives the concrete AppApi and mounts the app-specific tree UI.
  */
-export function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppInput, initialization, packageLoader, stdout, clipboard, }) {
-    const appReference = initialization.registeredApps.get(initialization.initialAppId);
-    if (appReference === undefined) {
+export function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppOptions, initialization, packageLoader, stdout, clipboard, }) {
+    const initialAppReference = initialization.registeredApps.get(initialization.initialAppId);
+    if (initialAppReference === undefined) {
         throw new Error(`Startup app "${initialization.initialAppId}" has not been registered.`);
     }
     const [appApiApplicator, setAppApiApplicator] = useState(undefined);
@@ -28,18 +29,19 @@ export function Shell({ loadingScreenRenderer, appScreenRenderer, initialAppInpu
                 setAppApiApplicator(undefined);
                 setAppError(undefined);
                 const appPlugin = await packageLoader.loadAppPlugin(appReference);
-                const loadedAppApiApplicator = appPlugin.createAppApiApplicator(input);
+                const appDefinitionApplicator = appPlugin.createAppDefinitionApplicator(input);
+                const loadedAppApiApplicator = createAppApiApplicator(appDefinitionApplicator);
                 setAppApiApplicator(() => loadedAppApiApplicator);
             },
         };
     }, [initialization.registeredApps, packageLoader]);
     useEffect(() => {
         void shellApi
-            .openApp(initialization.initialAppId, initialAppInput)
+            .openApp(initialization.initialAppId, initialAppOptions.input)
             .catch((error) => {
             setAppError(error instanceof Error ? error : new Error(String(error)));
         });
-    }, [initialAppInput, initialization.initialAppId, shellApi]);
+    }, [initialAppOptions.input, initialization.initialAppId, shellApi]);
     if (appError !== undefined) {
         throw appError;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mak-98/dirvi-app",
-  "version": "0.11.0-beta.2",
+  "version": "0.11.0-beta.3",
   "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.2",
-    "dirvi-lib": "0.11.0-beta.2",
+    "dirvi-apis": "0.11.0-beta.3",
+    "dirvi-lib": "0.11.0-beta.3",
     "zod": "^4.4.3"
   },
   "peerDependencies": {