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

package/dist/theme.js

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+// =============================================================================
+// Terminal colors
+// =============================================================================
+const HexColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/, {
+    message: 'Expected a #rrggbb color',
+});
+const Ansi256ColorSchema = z.number().int().min(0).max(255);
+/**
+ * Named ANSI foreground colors supported by Dirvi themes.
+ *
+ * Renderers translate these symbolic names into their own color APIs. The CLI
+ * renderer currently maps them to terminal colors; another renderer does not
+ * need to depend on Chalk to interpret the same theme.
+ */
+export const basicColorNames = [
+    'black',
+    'red',
+    'green',
+    'yellow',
+    'blue',
+    'cyan',
+    'magenta',
+    'white',
+    // Common aliases for blackBright.
+    'gray',
+    'grey',
+    'blackBright',
+    'redBright',
+    'greenBright',
+    'yellowBright',
+    'blueBright',
+    'cyanBright',
+    'magentaBright',
+    'whiteBright',
+];
+const BasicColorSchema = z.enum(basicColorNames);
+export const ColorConfigSchema = z
+    .object({
+    hex: HexColorSchema.optional(),
+    ansi256: Ansi256ColorSchema.optional(),
+    basic: BasicColorSchema.optional(),
+})
+    .refine((value) => value.hex !== undefined ||
+    value.ansi256 !== undefined ||
+    value.basic !== undefined, {
+    message: 'Expected at least one terminal color profile',
+});
+// =============================================================================
+// Highlights
+// =============================================================================
+// Note: these schemas are meant to be non-strict
+export const ForegroundHighlightConfigSchema = z.object({
+    fg: ColorConfigSchema,
+});
+export const OptionalForegroundHighlightConfigSchema = z.object({
+    fg: ColorConfigSchema.optional(),
+});
+export const BackgroundHighlightConfigSchema = z.object({
+    bg: ColorConfigSchema,
+});
+export const ForegroundBackgroundHighlightConfigSchema = z.object({
+    fg: ColorConfigSchema,
+    bg: ColorConfigSchema,
+});
+// =============================================================================
+// Theme defaults
+// =============================================================================
+const black = {
+    hex: '#28282a',
+    ansi256: 235,
+    basic: 'black',
+};
+const lightGray = {
+    hex: '#eaeaec',
+    ansi256: 254,
+    basic: 'gray',
+};
+const leaf = {
+    hex: '#e5e5e5',
+    ansi256: 254,
+    basic: 'white',
+};
+const branch = {
+    hex: '#2472c8',
+    ansi256: 26,
+    basic: 'blue',
+};
+const folded = {
+    hex: '#808080',
+    ansi256: 245,
+    basic: 'gray',
+};
+const indentGuide = {
+    hex: '#808080',
+    ansi256: 245,
+    basic: 'gray',
+};
+const cursorLine = {
+    hex: '#3a3a3c',
+    ansi256: 237,
+    basic: 'gray',
+};
+const success = {
+    hex: '#238c4b',
+    ansi256: 28,
+    basic: 'green',
+};
+const error = {
+    hex: '#be2d2d',
+    ansi256: 160,
+    basic: 'red',
+};
+const themeDefaults = {
+    statusBar: {
+        command: { fg: black },
+        normal: { fg: black },
+        background: { bg: lightGray },
+    },
+    tree: {
+        leaf: { fg: leaf },
+        branch: { fg: branch },
+        folded: { fg: folded },
+        cursorLine: { bg: cursorLine },
+        indentGuide: { fg: indentGuide },
+    },
+    feedbackBar: {
+        message: {
+            fg: black,
+            bg: lightGray,
+        },
+        success: {
+            fg: success,
+            bg: lightGray,
+        },
+        error: {
+            fg: error,
+            bg: lightGray,
+        },
+    },
+};
+// =============================================================================
+// Theme schema
+// =============================================================================
+export const ThemeSchema = z.object({
+    statusBar: z
+        .object({
+        command: ForegroundHighlightConfigSchema.default(themeDefaults.statusBar.command),
+        normal: ForegroundHighlightConfigSchema.default(themeDefaults.statusBar.normal),
+        background: BackgroundHighlightConfigSchema.default(themeDefaults.statusBar.background),
+    })
+        .default(themeDefaults.statusBar),
+    tree: z
+        .object({
+        leaf: ForegroundHighlightConfigSchema.default(themeDefaults.tree.leaf),
+        branch: ForegroundHighlightConfigSchema.default(themeDefaults.tree.branch),
+        folded: ForegroundHighlightConfigSchema.default(themeDefaults.tree.folded),
+        cursorLine: BackgroundHighlightConfigSchema.default(themeDefaults.tree.cursorLine),
+        indentGuide: OptionalForegroundHighlightConfigSchema.default(themeDefaults.tree.indentGuide),
+    })
+        .default(themeDefaults.tree),
+    feedbackBar: z
+        .object({
+        message: ForegroundBackgroundHighlightConfigSchema.default(themeDefaults.feedbackBar.message),
+        success: ForegroundBackgroundHighlightConfigSchema.default(themeDefaults.feedbackBar.success),
+        error: ForegroundBackgroundHighlightConfigSchema.default(themeDefaults.feedbackBar.error),
+    })
+        .default(themeDefaults.feedbackBar),
+});
+export const defaultTheme = ThemeSchema.parse({});

package/dist/ui/App.d.ts

@@ -0,0 +1,18 @@
+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';
+type AppProps<Id extends SerializableKey, Value, ViewKey = string> = {
+    screenRenderer: AppScreenRenderer;
+    appApi: AppApi<Id, Value, ViewKey>;
+    config: Config;
+    initialState: State<Id, Value>;
+    reducer: Reducer<Id, Value>;
+    intentToEffect: IntentToEffect<Id, Value>;
+    effectToAction: EffectToAction<Id, Value>;
+    stdout?: (message: string) => void;
+    clipboard?: (value: string) => void;
+    onError?: (error: Error) => void;
+};
+export declare function App<Id extends SerializableKey, Value, ViewKey = string>({ screenRenderer, appApi, config, 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

@@ -0,0 +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;AAMlE,KAAK,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,IAAI;IACnE,cAAc,EAAE,iBAAiB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,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,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,cAAc,EACd,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAkT9B"}

package/dist/ui/App.js

@@ -0,0 +1,225 @@
+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, appApi, config, 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
+    // see current state
+    stateRef.current = state;
+    const navEntry = useMemo(() => {
+        const navigation = appApi.navNodeApi.from(state.root, state.folds);
+        if (navigation === undefined) {
+            throw new Error('Tree-surfer state root must be a loaded branch.');
+        }
+        return navigation;
+    }, [appApi.navNodeApi, state.root, state.folds]);
+    const [inputState, setInputState] = useState({
+        inputMode: 'normal',
+        normalBuffer: '',
+    });
+    const [feedback, setFeedback] = useState();
+    const [exitStatus, setExitStatus] = useState();
+    const [rowCount, setRowCount] = useState(0);
+    const handleRowsChange = useCallback((nextRows) => {
+        setRowCount((currentRows) => currentRows === nextRows ? currentRows : nextRows);
+    }, []);
+    // ===========================================================================
+    // Display hooks
+    // ===========================================================================
+    const feedbackApi = useMemo(() => createFeedbackApi((nextFeedback) => {
+        setFeedback(nextFeedback);
+    }), []);
+    const view = useView(navEntry, state, appApi.navNodeApi, appApi.cursorApi, rowCount);
+    // ===========================================================================
+    // Resync Subscriptions
+    // ===========================================================================
+    useEffect(() => {
+        let active = true;
+        const unsubscribe = appApi.subscribeToResync(() => {
+            const oldState = stateRef.current;
+            void appApi.stateApi
+                .resync(oldState, appApi.loadBranches)
+                .then((newState) => {
+                if (!active) {
+                    return;
+                }
+                dispatch({
+                    kind: 'setState',
+                    oldState: oldState,
+                    newState: newState,
+                });
+            })
+                .catch((error) => {
+                const appError = error instanceof Error ? error : new Error(String(error));
+                onError?.(appError);
+            });
+        });
+        return () => {
+            active = false;
+            unsubscribe();
+        };
+    }, [appApi, onError]);
+    // ===========================================================================
+    // Executing Effects
+    // ===========================================================================
+    const executeEffect = useCallback((effect) => {
+        if (effect === undefined) {
+            return;
+        }
+        switch (effect.effectType) {
+            case 'dispatchEffectAction':
+                const effectActionResult = effectToAction(effect.action, navEntry, state);
+                // A completed normal-mode command or submitted Ex command always
+                // leaves its input buffer, whether it succeeds, is rejected, or no-ops.
+                setInputState({
+                    inputMode: 'normal',
+                    normalBuffer: '',
+                });
+                switch (effectActionResult.kind) {
+                    case 'action':
+                        dispatch(effectActionResult.action);
+                        return;
+                    case 'rejected':
+                        feedbackApi.addMessage(effectActionResult.message, 'error');
+                        return;
+                    case 'ignored':
+                        return;
+                    default:
+                        return;
+                }
+            case 'setInputState':
+                setInputState(effect.inputState);
+                return;
+            case 'loadBranchEntries': {
+                void appApi
+                    .loadBranches(effect.path)
+                    .then((entries) => {
+                    dispatch({
+                        kind: 'updateBranch',
+                        path: effect.path,
+                        entries,
+                    });
+                })
+                    .catch((error) => {
+                    const appError = error instanceof Error ? error : new Error(String(error));
+                    feedbackApi.addMessage(`Unable to open directory: ${appError.message}`);
+                });
+                return;
+            }
+            case 'emitVisibleLeavesPaths':
+                const navigation = navEntry.children;
+                if (navigation === null) {
+                    return;
+                }
+                const visibleLeavesPaths = appApi.navNodeApi.visibleLeavesPaths(navigation);
+                stdout?.(JSON.stringify({
+                    type: 'displayed-leaves-paths',
+                    paths: visibleLeavesPaths,
+                }));
+                setInputState({
+                    inputMode: 'normal',
+                    normalBuffer: '',
+                });
+                return;
+            case 'saveView': {
+                // void appApi.viewApi
+                //   .save(appApi.viewKey, effect.name, stateRef.current)
+                //   .then(() => {
+                //     setInputState({
+                //       inputMode: 'normal',
+                //       normalBuffer: '',
+                //     });
+                //     feedbackApi.addMessage(`Saved view: ${effect.name}`);
+                //   })
+                //   .catch((error: unknown) => {
+                //     feedbackApi.addMessage(
+                //       `Unable to save view: ${toError(error).message}`,
+                //     );
+                //   });
+                return;
+            }
+            case 'loadView': {
+                // void appApi.viewApi
+                //   .load(appApi.viewKey, effect.name)
+                //   .then((loadedState) => {
+                //     if (loadedState === undefined) {
+                //       throw new Error(`View not found: ${effect.name}`);
+                //     }
+                //
+                //     // The saved buffer may be stale because the filesystem could have
+                //     // changed since the view was saved.
+                //     return appApi.stateApi.resync(loadedState, appApi.loadBranches);
+                //   })
+                //   .then((newState) => {
+                //     const oldState = stateRef.current;
+                //
+                //     dispatch({
+                //       kind: 'setState',
+                //       oldState,
+                //       newState,
+                //     });
+                //
+                //     setInputState({
+                //       inputMode: 'normal',
+                //       normalBuffer: '',
+                //     });
+                //   })
+                //   .catch((error: unknown) => {
+                //     onError?.(toError(error));
+                //   });
+                return;
+            }
+            // TODO: Add descriptions with `...` truncation.
+            case 'listFolds': {
+                const folds = state.folds;
+                const foldTrees = [...appApi.foldsApi.indexes(folds)].map((index) => ({
+                    index,
+                    info: appApi.foldsApi.getInfoAtIndex(folds, index),
+                    active: appApi.foldsApi.isActiveAtIndex(folds, index),
+                }));
+                const indexWidth = Math.max(...foldTrees.map(({ index }) => String(index).length));
+                const lines = foldTrees.map(({ index, info, active }) => {
+                    const status = active === true ? 'active' : 'inactive';
+                    const name = info?.name ?? '<unavailable>';
+                    return `${String(index).padStart(indexWidth)}  ${status.padEnd(8)}  ${name}`;
+                });
+                setInputState({
+                    inputMode: 'normal',
+                    normalBuffer: '',
+                });
+                feedbackApi.addMessage(['Fold trees:', ...lines].join('\n'));
+                return;
+            }
+            case 'unrecognizedCommand':
+                feedbackApi.addMessage(`Unrecognized command: ${effect.commandLine}`, 'error');
+                return;
+            case 'quit':
+                setExitStatus(effect.exitMessage);
+                return;
+        }
+    }, [appApi, effectToAction, feedbackApi, navEntry, onError, state, stdout]);
+    // ===========================================================================
+    // Input hook
+    // ===========================================================================
+    const handleInput = useCallback((userInput) => {
+        const intent = userInputToIntent(userInput, inputState);
+        if (intent === undefined) {
+            return;
+        }
+        const effectResult = intentToEffect(intent, state);
+        if (effectResult === undefined) {
+            return;
+        }
+        setFeedback(undefined);
+        executeEffect(effectResult);
+    }, [executeEffect, inputState, intentToEffect, state]);
+    // ===========================================================================
+    // Render
+    // ===========================================================================
+    return (_jsx(ScreenRenderer, { view: view, feedback: feedback, feedbackApi: feedbackApi, config: config, inputState: inputState, handleInput: handleInput, onRowsChange: handleRowsChange, exitStatus: exitStatus }));
+}

package/dist/ui/AppSetup.d.ts

@@ -0,0 +1,17 @@
+import type { AppApi, SerializableKey } from 'dirvi-lib';
+import type { LoadingScreenRenderer } from './loading-screen-renderer.js';
+import type { AppScreenRenderer } from './app-screen-renderer.js';
+import { ShellApi } from '../domain/shell-api.js';
+import { Initialization } from '../domain/initialization.js';
+type LoadingAppProps<Id extends SerializableKey, Value, ViewKey = string> = {
+    appScreenRenderer: AppScreenRenderer;
+    loadingScreenRenderer: LoadingScreenRenderer;
+    initialization: Initialization;
+    shellApi: ShellApi;
+    appApi: AppApi<Id, Value, ViewKey>;
+    stdout?: (message: string) => void;
+    clipboard?: (value: string) => void;
+};
+export declare function AppSetup<Id extends SerializableKey, Value, ViewKey = string>({ appScreenRenderer, loadingScreenRenderer, appApi, initialization, stdout, clipboard, }: LoadingAppProps<Id, Value, ViewKey>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=AppSetup.d.ts.map

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

@@ -0,0 +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;AAE7D,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,MAAM,EACN,cAAc,EACd,MAAM,EACN,SAAS,GACV,EAAE,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,+BAgIrC"}

package/dist/ui/AppSetup.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { createEffectToAction, createIntentToEffect, createReducer, } from 'dirvi-lib';
+import { App } from './App.js';
+export function AppSetup({ appScreenRenderer, loadingScreenRenderer, appApi, initialization, stdout, clipboard, }) {
+    const [initialState, setInitialState] = useState();
+    const [config, setConfig] = useState(initialization.config);
+    // Load the initial configuration and keep it synchronized with changes made
+    // by another process or another running dirvi instance.
+    // useEffect(() => {
+    //   let mounted = true;
+    //   let latestLoad = 0;
+    //
+    //   const loadConfig = (): void => {
+    //     const loadNumber = ++latestLoad;
+    //
+    //     void configApi
+    //       .load()
+    //       .then((nextConfig) => {
+    //         // Ignore a stale read if a newer config read has begun meanwhile.
+    //         if (!mounted || loadNumber !== latestLoad) {
+    //           return;
+    //         }
+    //
+    //         setConfig(nextConfig);
+    //       })
+    //       .catch((cause: unknown) => {
+    //         if (!mounted || loadNumber !== latestLoad) {
+    //           return;
+    //         }
+    //
+    //         const nextError =
+    //           cause instanceof Error ? cause : new Error(String(cause));
+    //
+    //         setError(nextError);
+    //         onError?.(nextError);
+    //       });
+    //   };
+    //
+    //   // Subscribe before the first load so a change during startup is not missed.
+    //   const unsubscribe = configApi.subscribeToResync(loadConfig);
+    //   loadConfig();
+    //
+    //   return () => {
+    //     mounted = false;
+    //     unsubscribe();
+    //   };
+    // }, [configApi, onError]);
+    // Loading and setting initial state.
+    useEffect(() => {
+        let mounted = true;
+        appApi
+            .createRoot()
+            .then((root) => {
+            if (!mounted) {
+                return;
+            }
+            setInitialState({
+                root,
+                folds: appApi.foldsApi.create(appApi.rootId, {
+                    name: 'default',
+                    description: null,
+                }),
+                cursor: [],
+            });
+        })
+            .catch((cause) => {
+            const nextError = cause instanceof Error ? cause : new Error(String(cause));
+            if (!mounted) {
+                return;
+            }
+            throw nextError;
+        });
+        return () => {
+            mounted = false;
+        };
+    }, [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 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, appApi: appApi, config: config, initialState: initialState, reducer: reducer, intentToEffect: intentToEffect, effectToAction: effectToAction, ...(stdout === undefined ? {} : { stdout }), ...(clipboard === undefined ? {} : { clipboard }) }));
+}

package/dist/ui/Shell.d.ts

@@ -0,0 +1,49 @@
+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}.
+ *
+ * The API loader functions are injected so the shell does not depend directly
+ * on a platform-specific infrastructure implementation.
+ */
+export type ShellAppProps = {
+    /**
+     * Host-specific React implementation.
+     */
+    readonly loadingScreenRenderer: LoadingScreenRenderer;
+    readonly appScreenRenderer: AppScreenRenderer;
+    readonly initialAppOptions: InitialAppOptions;
+    readonly initialization: Initialization;
+    readonly packageLoader: PackageLoader;
+    /** Writes non-interactive application output. */
+    readonly stdout?: (message: string) => void;
+    /** Copies a value to the platform clipboard. */
+    readonly clipboard?: (value: string) => void;
+};
+/**
+ * Hosts the currently active application inside the persistent terminal shell.
+ *
+ * Shell deliberately does not depend on a concrete AppApi type. OpenApp keeps
+ * each application's Id, Value, and ViewKey types coherent while hiding those
+ * details from shell-level concerns such as startup, app selection, terminal
+ * integration, clipboard access, and error reporting.
+ *
+ * AppSetup receives the concrete AppApi and mounts the app-specific tree UI.
+ */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,54 @@
+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.
+ *
+ * Shell deliberately does not depend on a concrete AppApi type. OpenApp keeps
+ * each application's Id, Value, and ViewKey types coherent while hiding those
+ * details from shell-level concerns such as startup, app selection, terminal
+ * integration, clipboard access, and error reporting.
+ *
+ * AppSetup receives the concrete AppApi and mounts the app-specific tree UI.
+ */
+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);
+    const [appError, setAppError] = useState(undefined);
+    const shellApi = useMemo(() => {
+        return {
+            openApp: async (appId, input) => {
+                const appReference = initialization.registeredApps.get(appId);
+                if (appReference === undefined) {
+                    throw new Error(`App "${appId}" has not been registered.`);
+                }
+                setAppApiApplicator(undefined);
+                setAppError(undefined);
+                const appPlugin = await packageLoader.loadAppPlugin(appReference);
+                const appDefinitionApplicator = appPlugin.createAppDefinitionApplicator(input);
+                const loadedAppApiApplicator = createAppApiApplicator(appDefinitionApplicator);
+                setAppApiApplicator(() => loadedAppApiApplicator);
+            },
+        };
+    }, [initialization.registeredApps, packageLoader]);
+    useEffect(() => {
+        void shellApi
+            .openApp(initialization.initialAppId, initialAppOptions.input)
+            .catch((error) => {
+            setAppError(error instanceof Error ? error : new Error(String(error)));
+        });
+    }, [initialAppOptions.input, initialization.initialAppId, shellApi]);
+    if (appError !== undefined) {
+        throw appError;
+    }
+    if (appApiApplicator === undefined) {
+        const LoadingScreenRenderer = loadingScreenRenderer;
+        return _jsx(LoadingScreenRenderer, {});
+    }
+    // Result type is specified here to be AppSetup
+    return appApiApplicator((appApi) => (_jsx(AppSetup, { appScreenRenderer: appScreenRenderer, loadingScreenRenderer: loadingScreenRenderer, initialization: initialization, shellApi: shellApi, appApi: appApi, ...(stdout === undefined ? {} : { stdout }), ...(clipboard === undefined ? {} : { clipboard }) })));
+}

package/dist/ui/app-screen-renderer.d.ts

@@ -0,0 +1,28 @@
+import type { ComponentType } from 'react';
+import type { Feedback, FeedbackApi, InputModeState, UserInput } from 'dirvi-lib';
+import type { Config } from '../domain/config.js';
+import { View } from './view.js';
+/**
+ * State and callbacks required by a React host screen.
+ *
+ * The screen owns host-specific concerns such as input subscription, viewport
+ * measurement, and host exit. App owns Dirvi state transitions and effects.
+ */
+export type AppScreenProps = {
+    readonly view: View;
+    readonly feedback: Feedback | undefined;
+    readonly feedbackApi: FeedbackApi;
+    readonly config: Config;
+    readonly inputState: InputModeState;
+    readonly handleInput: (userInput: UserInput) => void;
+    readonly onRowsChange: (rows: number) => void;
+    readonly exitStatus: string | undefined;
+};
+/**
+ * A host-specific React implementation of the Dirvi application screen.
+ *
+ * InkScreen is the terminal implementation. A future web or React Native host
+ * can provide a different component that conforms to this same contract.
+ */
+export type AppScreenRenderer = ComponentType<AppScreenProps>;
+//# sourceMappingURL=app-screen-renderer.d.ts.map

package/dist/ui/app-screen-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-screen-renderer.d.ts","sourceRoot":"","sources":["../../src/ui/app-screen-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,SAAS,EACV,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC"}