@fnndsc/brasa 0.1.0

package/dist/core/surface.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @file Surface capabilities: the input/interaction seam a host provides.
+ *
+ * The output sink (`./sink.js`) lets a host decide where a command's output
+ * goes. This module is its input-side counterpart: it lets a host declare
+ * what *interaction* it can offer — prompting for a line, reading a secret
+ * without echo, opening a local editor — and lets a builtin ask for a
+ * capability and fail with a clear message when the attached surface cannot
+ * provide it, rather than hanging on a standard input that is not there.
+ *
+ * The CLI host backs this with readline and the local `$EDITOR`; a future
+ * daemon backs it with request messages to a remote surface, and a surface
+ * that cannot (say) open a local editor simply declares `localEdit: false`.
+ *
+ * Capabilities the surface can act on directly (prompting) are methods here;
+ * capabilities a builtin still performs itself (local editing, whose editor
+ * mechanics remain in the `edit` builtin until a remote surface needs its
+ * own implementation) are declared as flags a builtin gates on via
+ * {@link capability_require}. This module is deliberately free of Node
+ * built-ins so it stays trivially testable and host-agnostic; the readline
+ * implementation lives in `./cliSurface.js`.
+ *
+ * @see docs/calypso.adoc — "Interactivity is a declared surface capability".
+ * @module
+ */
+/**
+ * What interaction an attached surface can provide.
+ *
+ * @property hiddenInput - The surface can read a line without echoing it
+ *   (password entry).
+ * @property localEdit - The surface can open content in a local editor and
+ *   return the edited result.
+ * @property tty - The surface is an interactive terminal (as opposed to a
+ *   pipe, a script, or a headless host).
+ * @property pipeSegments - The surface can run a pipeline's non-first
+ *   segments (`... | grep foo`) through its own tools. Nothing ever spawns on
+ *   a daemon host: the local CLI runs segments in-process, a remote CLI runs
+ *   them on the client machine, and a browser surface lacks the capability
+ *   and fails such pipelines with a clear message.
+ */
+export interface SurfaceCapabilities {
+    hiddenInput: boolean;
+    localEdit: boolean;
+    tty: boolean;
+    pipeSegments: boolean;
+}
+/**
+ * A request to prompt the user for a line of input.
+ *
+ * @property message - The prompt text to display.
+ * @property hidden - When true, the entered text is not echoed; requires the
+ *   `hiddenInput` capability.
+ */
+export interface PromptRequest {
+    message: string;
+    hidden?: boolean;
+}
+/**
+ * Content handed to a surface's local editor.
+ *
+ * @property content - The text to open in the editor.
+ * @property extension - Optional filename extension (e.g. `.txt`, `.json`) so
+ *   the editor can apply the right syntax mode.
+ */
+export interface LocalEditRequest {
+    content: string;
+    extension?: string;
+}
+/**
+ * The outcome of a local edit.
+ *
+ * @property content - The content after editing.
+ * @property changed - Whether the content differs from what was opened.
+ */
+export interface LocalEditResult {
+    content: string;
+    changed: boolean;
+}
+/**
+ * The interaction seam a host installs. Builtins reach it through
+ * {@link surface_get}; hosts declare their capabilities and back the
+ * prompt and local-edit operations with whatever their surface supports.
+ */
+export interface Surface {
+    /** What this surface can do; read by builtins before they interact. */
+    readonly capabilities: SurfaceCapabilities;
+    /**
+     * Prompts for a line of input.
+     *
+     * @param request - The prompt message and whether to hide the input.
+     * @returns The entered line, trimmed.
+     * @throws {CapabilityError} When hidden input is requested but the surface
+     *   lacks the `hiddenInput` capability, or the surface cannot prompt.
+     */
+    prompt(request: PromptRequest): Promise<string>;
+    /**
+     * Runs one pipeline segment against an input, returning its output. Where
+     * this runs is the surface's business — in-process for the local CLI, on
+     * the client machine for a remote CLI — but never on a daemon host.
+     *
+     * @param command - The segment command line (e.g. `grep foo`).
+     * @param input - The bytes to feed the segment on stdin.
+     * @returns The segment's stdout.
+     * @throws {CapabilityError} When the surface lacks the `pipeSegments`
+     *   capability.
+     */
+    pipeSegment(command: string, input: Buffer): Promise<Buffer>;
+    /**
+     * Opens content in the surface's local editor and returns the result. The
+     * editor mechanics are the surface's business — a temp file and `$EDITOR`
+     * for the local CLI, the client's editor for a remote CLI, an editor
+     * component in a browser.
+     *
+     * @param request - The content to edit and an optional extension.
+     * @returns The edited content and whether it changed.
+     * @throws {CapabilityError} When the surface lacks the `localEdit`
+     *   capability.
+     */
+    localEdit(request: LocalEditRequest): Promise<LocalEditResult>;
+}
+/**
+ * Raised when a builtin requests an interaction the attached surface cannot
+ * provide. Carries the capability name so a host can present it uniformly.
+ */
+export declare class CapabilityError extends Error {
+    /** The capability that was required but absent. */
+    readonly capability: keyof SurfaceCapabilities;
+    /**
+     * @param capability - The missing capability.
+     * @param message - Human-readable explanation.
+     */
+    constructor(capability: keyof SurfaceCapabilities, message: string);
+}
+/**
+ * The default surface for a host that has not installed one: it can do
+ * nothing interactive and says so clearly. This is the correct default for
+ * an unknown host — a CLI host replaces it (see `./cliSurface.js`), and any
+ * attempt to prompt or edit before a real surface is installed fails loudly
+ * instead of hanging.
+ */
+export declare class HeadlessSurface implements Surface {
+    /** @inheritdoc */
+    readonly capabilities: SurfaceCapabilities;
+    /** @inheritdoc */
+    prompt(_request: PromptRequest): Promise<string>;
+    /** @inheritdoc */
+    pipeSegment(_command: string, _input: Buffer): Promise<Buffer>;
+    /** @inheritdoc */
+    localEdit(_request: LocalEditRequest): Promise<LocalEditResult>;
+}
+/**
+ * Returns the currently installed surface.
+ *
+ * @returns The active surface.
+ */
+export declare function surface_get(): Surface;
+/**
+ * Installs a surface. Called by the host that owns the interaction channel.
+ *
+ * @param surface - The surface to install.
+ * @returns The previously installed surface, so callers can restore it.
+ */
+export declare function surface_set(surface: Surface): Surface;
+/**
+ * Asserts that the active surface has a capability, throwing a
+ * {@link CapabilityError} with a clear message when it does not.
+ *
+ * @param capability - The capability the caller needs.
+ * @param message - The message to present when it is absent.
+ * @throws {CapabilityError} When the active surface lacks the capability.
+ */
+export declare function capability_require(capability: keyof SurfaceCapabilities, message: string): void;

package/dist/core/surface.js

@@ -0,0 +1,105 @@
+/**
+ * @file Surface capabilities: the input/interaction seam a host provides.
+ *
+ * The output sink (`./sink.js`) lets a host decide where a command's output
+ * goes. This module is its input-side counterpart: it lets a host declare
+ * what *interaction* it can offer — prompting for a line, reading a secret
+ * without echo, opening a local editor — and lets a builtin ask for a
+ * capability and fail with a clear message when the attached surface cannot
+ * provide it, rather than hanging on a standard input that is not there.
+ *
+ * The CLI host backs this with readline and the local `$EDITOR`; a future
+ * daemon backs it with request messages to a remote surface, and a surface
+ * that cannot (say) open a local editor simply declares `localEdit: false`.
+ *
+ * Capabilities the surface can act on directly (prompting) are methods here;
+ * capabilities a builtin still performs itself (local editing, whose editor
+ * mechanics remain in the `edit` builtin until a remote surface needs its
+ * own implementation) are declared as flags a builtin gates on via
+ * {@link capability_require}. This module is deliberately free of Node
+ * built-ins so it stays trivially testable and host-agnostic; the readline
+ * implementation lives in `./cliSurface.js`.
+ *
+ * @see docs/calypso.adoc — "Interactivity is a declared surface capability".
+ * @module
+ */
+/**
+ * Raised when a builtin requests an interaction the attached surface cannot
+ * provide. Carries the capability name so a host can present it uniformly.
+ */
+export class CapabilityError extends Error {
+    /** The capability that was required but absent. */
+    capability;
+    /**
+     * @param capability - The missing capability.
+     * @param message - Human-readable explanation.
+     */
+    constructor(capability, message) {
+        super(message);
+        this.name = 'CapabilityError';
+        this.capability = capability;
+    }
+}
+/**
+ * The default surface for a host that has not installed one: it can do
+ * nothing interactive and says so clearly. This is the correct default for
+ * an unknown host — a CLI host replaces it (see `./cliSurface.js`), and any
+ * attempt to prompt or edit before a real surface is installed fails loudly
+ * instead of hanging.
+ */
+export class HeadlessSurface {
+    /** @inheritdoc */
+    capabilities = {
+        hiddenInput: false,
+        localEdit: false,
+        tty: false,
+        pipeSegments: false,
+    };
+    /** @inheritdoc */
+    prompt(_request) {
+        throw new CapabilityError('tty', 'This surface cannot prompt for input.');
+    }
+    /** @inheritdoc */
+    pipeSegment(_command, _input) {
+        throw new CapabilityError('pipeSegments', 'This surface cannot run pipeline segments.');
+    }
+    /** @inheritdoc */
+    localEdit(_request) {
+        throw new CapabilityError('localEdit', 'This surface cannot open a local editor.');
+    }
+}
+/** The active surface. Defaults to headless until a host installs one. */
+let activeSurface = new HeadlessSurface();
+/**
+ * Returns the currently installed surface.
+ *
+ * @returns The active surface.
+ */
+export function surface_get() {
+    return activeSurface;
+}
+/**
+ * Installs a surface. Called by the host that owns the interaction channel.
+ *
+ * @param surface - The surface to install.
+ * @returns The previously installed surface, so callers can restore it.
+ */
+export function surface_set(surface) {
+    const previous = activeSurface;
+    activeSurface = surface;
+    return previous;
+}
+/**
+ * Asserts that the active surface has a capability, throwing a
+ * {@link CapabilityError} with a clear message when it does not.
+ *
+ * @param capability - The capability the caller needs.
+ * @param message - The message to present when it is absent.
+ * @throws {CapabilityError} When the active surface lacks the capability.
+ */
+export function capability_require(capability, message) {
+    if (!activeSurface.capabilities[capability]) {
+        throw new CapabilityError(capability, message);
+    }
+}
+//# sourceMappingURL=surface.js.map

package/dist/core/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAyGH;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,mDAAmD;IACnC,UAAU,CAA4B;IAEtD;;;OAGG;IACH,YAAY,UAAqC,EAAE,OAAe;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,kBAAkB;IACF,YAAY,GAAwB;QAClD,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,KAAK;QAChB,GAAG,EAAE,KAAK;QACV,YAAY,EAAE,KAAK;KACpB,CAAC;IAEF,kBAAkB;IACX,MAAM,CAAC,QAAuB;QACnC,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;IAC5E,CAAC;IAED,kBAAkB;IACX,WAAW,CAAC,QAAgB,EAAE,MAAc;QACjD,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;IAC1F,CAAC;IAED,kBAAkB;IACX,SAAS,CAAC,QAA0B;QACzC,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;IACrF,CAAC;CACF;AAED,0EAA0E;AAC1E,IAAI,aAAa,GAAY,IAAI,eAAe,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,QAAQ,GAAY,aAAa,CAAC;IACxC,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EACrC,OAAe;IAEf,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/core/version.d.ts

@@ -0,0 +1,20 @@
+/** The resolved version of every layer of the stack, in sandwich order. */
+export interface StackVersions {
+    chell: string;
+    chili: string;
+    salsa: string;
+    cumin: string;
+}
+/**
+ * The resolved version of every layer of the stack.
+ *
+ * @returns The chell/chili/salsa/cumin version strings.
+ */
+export declare function versions_get(): StackVersions;
+/**
+ * Builds the multi-line version report shown by the `version` command and
+ * `--version`: chell itself plus the sandwich layers it runs with.
+ *
+ * @returns The version report string.
+ */
+export declare function versionReport_build(): string;

package/dist/core/version.js

@@ -0,0 +1,82 @@
+/**
+ * @file Version reporting for chell and its sandwich layers.
+ *
+ * Reads chell's own package.json and those of the cumin/salsa/chili layers, so
+ * the boot panel, the `version` command, and `--version` all report a
+ * consistent set of versions. In the standalone bundled binary — where no
+ * package.json exists on disk — the versions esbuild injected at build time are
+ * used instead.
+ *
+ * @module
+ */
+import { readFileSync } from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Reads chell's own package.json, falling back to the build-time version in the
+ * bundled binary where that file is not present on disk.
+ *
+ * @returns The parsed package.json (or a `{ name, version }` fallback).
+ */
+function selfPackageJson_load() {
+    try {
+        return JSON.parse(readFileSync(path.resolve(moduleDir, '../../package.json'), 'utf-8'));
+    }
+    catch {
+        const version = typeof __CHELL_VERSION__ !== 'undefined' ? __CHELL_VERSION__ : 'unknown';
+        return { name: '@fnndsc/chell', version };
+    }
+}
+/**
+ * Loads a dependency's package.json via node module resolution, so it works
+ * whether the dep is nested or hoisted to a workspace-root node_modules. In the
+ * bundled binary it falls back to the versions inlined at build time.
+ *
+ * @param name - The package name (e.g. `@fnndsc/cumin`).
+ * @returns The parsed package.json, or a fallback `{ name, version }`.
+ */
+function depPackageJson_load(name) {
+    try {
+        const req = createRequire(import.meta.url);
+        return req(`${name}/package.json`);
+    }
+    catch {
+        const version = typeof __CHELL_DEP_VERSIONS__ !== 'undefined' ? (__CHELL_DEP_VERSIONS__[name] ?? 'unknown') : 'unknown';
+        return { name, version };
+    }
+}
+const chellJson = selfPackageJson_load();
+const cuminJson = depPackageJson_load('@fnndsc/cumin');
+const salsaJson = depPackageJson_load('@fnndsc/salsa');
+const chiliJson = depPackageJson_load('@fnndsc/chili');
+/**
+ * The resolved version of every layer of the stack.
+ *
+ * @returns The chell/chili/salsa/cumin version strings.
+ */
+export function versions_get() {
+    return {
+        chell: chellJson.version,
+        chili: chiliJson.version,
+        salsa: salsaJson.version,
+        cumin: cuminJson.version,
+    };
+}
+/**
+ * Builds the multi-line version report shown by the `version` command and
+ * `--version`: chell itself plus the sandwich layers it runs with.
+ *
+ * @returns The version report string.
+ */
+export function versionReport_build() {
+    const versions = versions_get();
+    return [
+        `chell ${versions.chell}`,
+        `  chili ${versions.chili}`,
+        `  salsa ${versions.salsa}`,
+        `  cumin ${versions.cumin}`,
+    ].join('\n');
+}
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AASvC,MAAM,SAAS,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAevE;;;;;GAKG;AACH,SAAS,oBAAoB;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC,CAAgB,CAAC;IACzG,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,GAAW,OAAO,iBAAiB,KAAK,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC,GAAG,IAAI,eAAe,CAAgB,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,GACX,OAAO,sBAAsB,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1G,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAgB,oBAAoB,EAAE,CAAC;AACtD,MAAM,SAAS,GAAgB,mBAAmB,CAAC,eAAe,CAAC,CAAC;AACpE,MAAM,SAAS,GAAgB,mBAAmB,CAAC,eAAe,CAAC,CAAC;AACpE,MAAM,SAAS,GAAgB,mBAAmB,CAAC,eAAe,CAAC,CAAC;AAUpE;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAkB,YAAY,EAAE,CAAC;IAC/C,OAAO;QACL,SAAS,QAAQ,CAAC,KAAK,EAAE;QACzB,WAAW,QAAQ,CAAC,KAAK,EAAE;QAC3B,WAAW,QAAQ,CAAC,KAAK,EAAE;QAC3B,WAAW,QAAQ,CAAC,KAAK,EAAE;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * BRASA Runs Abstracted Shell Actions.
+ *
+ * The hostable ChRIS shell engine (kernel): parsing, dispatch, pipes, builtins,
+ * session and output capture, with no terminal I/O of its own. Frontends
+ * (the chell CLI, the calypso daemon, future web clients) host this engine and
+ * supply their own output sink, surface and renderer implementations.
+ *
+ * @module
+ */
+export * from './core/engine.js';
+export * from './core/dispatch.js';
+export * from './core/preprocess.js';
+export * from './core/sink.js';
+export * from './core/progress.js';
+export * from './core/surface.js';
+export * from './core/promptContext.js';
+export * from './core/connect.js';
+export * from './core/question.js';
+export * from './core/version.js';
+export * from './command-keys.js';
+export * from './session/index.js';
+export * from './builtins/index.js';
+export * from './config/storeConfig.js';
+export * from './lib/vfs/vfs.js';
+export * from './lib/spinner.js';
+export * from './lib/prefetch.js';
+export * from './lib/parser.js';
+export * from './lib/pipe.js';
+export * from './lib/semicolonParser.js';
+export * from './lib/completer/index.js';

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * BRASA Runs Abstracted Shell Actions.
+ *
+ * The hostable ChRIS shell engine (kernel): parsing, dispatch, pipes, builtins,
+ * session and output capture, with no terminal I/O of its own. Frontends
+ * (the chell CLI, the calypso daemon, future web clients) host this engine and
+ * supply their own output sink, surface and renderer implementations.
+ *
+ * @module
+ */
+export * from './core/engine.js';
+export * from './core/dispatch.js';
+export * from './core/preprocess.js';
+export * from './core/sink.js';
+export * from './core/progress.js';
+export * from './core/surface.js';
+export * from './core/promptContext.js';
+export * from './core/connect.js';
+export * from './core/question.js';
+export * from './core/version.js';
+export * from './command-keys.js';
+export * from './session/index.js';
+export * from './builtins/index.js';
+export * from './config/storeConfig.js';
+export * from './lib/vfs/vfs.js';
+export * from './lib/spinner.js';
+export * from './lib/prefetch.js';
+export * from './lib/parser.js';
+export * from './lib/pipe.js';
+export * from './lib/semicolonParser.js';
+export * from './lib/completer/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC"}

package/dist/lib/completer/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Callback function type for autocomplete results.
+ * @param err - Error if completion failed, null otherwise.
+ * @param result - Tuple of [matches array, original input string].
+ */
+type CompleterCallback = (err: Error | null, result: [string[], string]) => void;
+/**
+ * Computes autocomplete suggestions for a given input line.
+ * Uses the callback style to support asynchronous operations (fetching files).
+ *
+ * @param line - The current input line.
+ * @param callback - The callback function to return results.
+ */
+export declare function input_complete(line: string, callback: CompleterCallback): void;
+export {};