@fnndsc/brasa 0.1.0

package/dist/lib/semicolonParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semicolonParser.js","sourceRoot":"","sources":["../../src/lib/semicolonParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,cAAc,GAAW,EAAE,CAAC;IAChC,IAAI,aAAa,GAAY,KAAK,CAAC;IACnC,IAAI,aAAa,GAAY,KAAK,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QAE7B,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,aAAa,GAAG,CAAC,aAAa,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,cAAc,IAAI,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/spinner.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Terminal spinner utility for long-running operations.
+ *
+ * @module
+ */
+/**
+ * Terminal spinner indicating progress of async work.
+ */
+export declare class Spinner {
+    private interval;
+    private message;
+    private frames;
+    private frameIndex;
+    private spinnerActive;
+    private startTime;
+    private showTiming;
+    constructor(initialMessage?: string);
+    start(message?: string, showTiming?: boolean): void;
+    stop(clearLine?: boolean): void;
+    updateMessage(newMessage: string): void;
+}
+declare const globalSpinner: Spinner;
+export { globalSpinner as spinner };

package/dist/lib/spinner.js

@@ -0,0 +1,71 @@
+/**
+ * @file Terminal spinner utility for long-running operations.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { sink_get } from '../core/sink.js';
+/**
+ * Terminal spinner indicating progress of async work.
+ */
+export class Spinner {
+    interval = null;
+    message = '';
+    frames = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"];
+    frameIndex = 0;
+    spinnerActive = false;
+    startTime = 0;
+    showTiming = false;
+    constructor(initialMessage = 'Loading...') {
+        this.message = initialMessage;
+    }
+    start(message, showTiming = false) {
+        // Do not start spinner if not in a TTY (e.g. piped output)
+        if (!process.stdout.isTTY) {
+            return;
+        }
+        if (this.spinnerActive) {
+            this.stop(); // Stop any existing spinner
+        }
+        this.message = message || this.message;
+        this.spinnerActive = true;
+        this.frameIndex = 0;
+        this.showTiming = showTiming;
+        this.startTime = Date.now();
+        // Hide cursor
+        sink_get().status_write('\x1B[?25l');
+        this.interval = setInterval(() => {
+            const frame = this.frames[this.frameIndex = (this.frameIndex + 1) % this.frames.length];
+            let displayMessage = this.message;
+            // Add timing if enabled
+            if (this.showTiming) {
+                const elapsedSeconds = ((Date.now() - this.startTime) / 1000).toFixed(1);
+                displayMessage = `${this.message} (${elapsedSeconds}s)`;
+            }
+            // Note: We use chalk.gray for the message to match the existing "Fetching..." style.
+            // \x1b[K erases to end-of-line so a shorter message never leaves the
+            // tail of a longer previous one behind.
+            sink_get().status_write(`\r\x1b[K${chalk.bgBlack.cyanBright.bold(frame)} ${chalk.gray(displayMessage)}`);
+        }, 80);
+    }
+    stop(clearLine = true) {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        if (this.spinnerActive) {
+            if (clearLine) {
+                sink_get().status_write('\r\x1b[K'); // Clear line
+            }
+            // Show cursor
+            sink_get().status_write('\x1B[?25h');
+            this.spinnerActive = false;
+        }
+    }
+    updateMessage(newMessage) {
+        this.message = newMessage;
+    }
+}
+const globalSpinner = new Spinner();
+export { globalSpinner as spinner };
+//# sourceMappingURL=spinner.js.map

package/dist/lib/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"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"}

package/dist/lib/vfs/providers/static.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file Static Virtual File System Provider.
+ *
+ * Implements virtual directories for `/bin`, `/usr`, and `/usr/bin` under the VFSDispatcher.
+ *
+ * @module
+ */
+import { Result } from '@fnndsc/cumin';
+import { VFSProvider, VFSItem, CpOptions } from '@fnndsc/salsa';
+/**
+ * Static virtual filesystem provider for command and builtin paths.
+ */
+export declare class StaticVfsProvider implements VFSProvider {
+    /** The prefix path this provider handles. */
+    prefix: string;
+    /**
+     * Initializes the static provider with its target prefix path.
+     *
+     * @param prefix - The absolute virtual directory prefix.
+     */
+    constructor(prefix: string);
+    /**
+     * Lists the contents of the matched static prefix path.
+     *
+     * @param pathStr - The absolute path.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result of VFSItems.
+     */
+    list(pathStr: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Block copy operations for static paths.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to false always to block copying.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+    /**
+     * Standard sort helper for virtual items.
+     *
+     * @param items - The VFSItem array to sort.
+     * @param sortField - Field to sort by.
+     * @param reverse - True to reverse output sorting.
+     * @returns Sorted VFSItem array.
+     */
+    private staticVfsItems_sort;
+    /**
+     * Reads virtual file content under command and builtin static paths.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents.
+     */
+    read(pathStr: string): Promise<Result<string>>;
+    /**
+     * Reads virtual file binary content under command and builtin static paths.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary(pathStr: string): Promise<Result<Buffer>>;
+}

package/dist/lib/vfs/providers/static.js

@@ -0,0 +1,164 @@
+/**
+ * @file Static Virtual File System Provider.
+ *
+ * Implements virtual directories for `/bin`, `/usr`, and `/usr/bin` under the VFSDispatcher.
+ *
+ * @module
+ */
+import { Ok, Err, errorStack } from '@fnndsc/cumin';
+import { plugins_listAll, pipelines_getAll } from '@fnndsc/salsa';
+import { builtinCommands_list } from '../../../builtins/help.js';
+import { staticVfs_read, staticVfs_readBinary } from './static_content.js';
+/**
+ * Static virtual filesystem provider for command and builtin paths.
+ */
+export class StaticVfsProvider {
+    /** The prefix path this provider handles. */
+    prefix;
+    /**
+     * Initializes the static provider with its target prefix path.
+     *
+     * @param prefix - The absolute virtual directory prefix.
+     */
+    constructor(prefix) {
+        this.prefix = prefix;
+    }
+    /**
+     * Lists the contents of the matched static prefix path.
+     *
+     * @param pathStr - The absolute path.
+     * @param options - Sort controls.
+     * @returns Promise resolving to Result of VFSItems.
+     */
+    async list(pathStr, options) {
+        try {
+            let effectivePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+            if (effectivePath.length > 1 && effectivePath.endsWith("/")) {
+                effectivePath = effectivePath.slice(0, -1);
+            }
+            if (effectivePath === "/bin") {
+                const [plugins, pipelinesResult] = await Promise.all([
+                    plugins_listAll({}),
+                    pipelines_getAll(),
+                ]);
+                const items = [];
+                if (plugins && plugins.tableData) {
+                    plugins.tableData.forEach((plugin) => {
+                        const pluginName = typeof plugin.name === 'string' ? plugin.name : String(plugin.name);
+                        const pluginVersion = typeof plugin.version === 'string' ? plugin.version : String(plugin.version || '');
+                        const displayName = pluginVersion ? `${pluginName}-v${pluginVersion}` : pluginName;
+                        items.push({
+                            name: displayName,
+                            type: "plugin",
+                            size: 0,
+                            owner: "system",
+                            date: typeof plugin.creation_date === 'string' ? plugin.creation_date : '',
+                        });
+                    });
+                }
+                if (pipelinesResult.ok) {
+                    pipelinesResult.value.forEach((pipeline) => {
+                        const slug = typeof pipeline.slug === 'string' ? pipeline.slug : pipeline.name.replace(/\s+/g, '_');
+                        items.push({
+                            name: slug,
+                            type: "pipeline",
+                            size: 0,
+                            owner: typeof pipeline.authors === 'string' ? pipeline.authors : 'system',
+                            date: '',
+                            title: pipeline.name,
+                        });
+                    });
+                }
+                const sorted = this.staticVfsItems_sort(items, options?.sort, options?.reverse);
+                return Ok(sorted);
+            }
+            if (effectivePath === "/usr") {
+                const items = [
+                    {
+                        name: "bin",
+                        type: "vfs",
+                        size: 0,
+                        owner: "root",
+                        date: new Date().toISOString(),
+                    }
+                ];
+                return Ok(items);
+            }
+            if (effectivePath === "/usr/bin") {
+                const builtinNames = builtinCommands_list();
+                const items = builtinNames.map((name) => ({
+                    name,
+                    type: "plugin",
+                    size: 0,
+                    owner: "system",
+                    date: new Date().toISOString(),
+                }));
+                const sorted = this.staticVfsItems_sort(items, options?.sort, options?.reverse);
+                return Ok(sorted);
+            }
+            return Ok([]);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            errorStack.stack_push("error", `Static VFS list failed for prefix ${this.prefix}: ${msg}`);
+            return Err();
+        }
+    }
+    /**
+     * Block copy operations for static paths.
+     *
+     * @param src - Source path.
+     * @param dest - Destination path.
+     * @param options - Copy options.
+     * @returns Promise resolving to false always to block copying.
+     */
+    async cp(src, dest, options) {
+        errorStack.stack_push("error", `cp: Copying from static VFS path '${src}' is not supported.`);
+        return false;
+    }
+    /**
+     * Standard sort helper for virtual items.
+     *
+     * @param items - The VFSItem array to sort.
+     * @param sortField - Field to sort by.
+     * @param reverse - True to reverse output sorting.
+     * @returns Sorted VFSItem array.
+     */
+    staticVfsItems_sort(items, sortField, reverse) {
+        const field = sortField || "name";
+        const sorted = [...items].sort((a, b) => {
+            const valA = a[field];
+            const valB = b[field];
+            if (typeof valA === "string" && typeof valB === "string") {
+                return valA.localeCompare(valB);
+            }
+            if (typeof valA === "number" && typeof valB === "number") {
+                return valA - valB;
+            }
+            return 0;
+        });
+        if (reverse) {
+            sorted.reverse();
+        }
+        return sorted;
+    }
+    /**
+     * Reads virtual file content under command and builtin static paths.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents.
+     */
+    async read(pathStr) {
+        return staticVfs_read(pathStr, this.prefix);
+    }
+    /**
+     * Reads virtual file binary content under command and builtin static paths.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    async readBinary(pathStr) {
+        return staticVfs_readBinary(pathStr, this.prefix);
+    }
+}
+//# sourceMappingURL=static.js.map

package/dist/lib/vfs/providers/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../../src/lib/vfs/providers/static.ts"],"names":[],"mappings":"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"}

package/dist/lib/vfs/providers/static_content.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file Static VFS Content Handler.
+ *
+ * Implements specialized virtual file reading and content generation
+ * for static command directories (/bin, /usr/bin).
+ *
+ * @module
+ */
+import { Result } from '@fnndsc/cumin';
+/**
+ * Reads virtual file content under command and builtin static paths.
+ *
+ * Handles help text formatting for /usr/bin and fetches parameter specifications for /bin plugins.
+ *
+ * @param pathStr - The absolute virtual path of the file to read.
+ * @param prefix - The prefix of the calling provider (e.g. '/usr/bin', '/bin').
+ * @returns Promise resolving to a Result containing the file contents as a string.
+ */
+export declare function staticVfs_read(pathStr: string, prefix: string): Promise<Result<string>>;
+/**
+ * Reads virtual file binary content under command and builtin static paths.
+ *
+ * @param pathStr - The absolute virtual path of the file to read.
+ * @param prefix - The prefix of the calling provider.
+ * @returns Promise resolving to a Result containing the file contents as a Buffer.
+ */
+export declare function staticVfs_readBinary(pathStr: string, prefix: string): Promise<Result<Buffer>>;

package/dist/lib/vfs/providers/static_content.js

@@ -0,0 +1,180 @@
+/**
+ * @file Static VFS Content Handler.
+ *
+ * Implements specialized virtual file reading and content generation
+ * for static command directories (/bin, /usr/bin).
+ *
+ * @module
+ */
+import { Ok, Err, errorStack, pipeline_resolve } from '@fnndsc/cumin';
+import { commandHelp_get } from '../../../builtins/help.js';
+import { pipeline_sourceGet } from '@fnndsc/salsa';
+import chalk from 'chalk';
+import { session } from '../../../session/index.js';
+/**
+ * Formats a plugin parameter list into a beautifully aligned text manual.
+ *
+ * @param plugin - The resolved ChRIS plugin object.
+ * @param parameters - Array of plugin parameters.
+ * @param command - The exact plugin command/filename.
+ * @returns Formatted details string.
+ */
+function pluginParameters_render(plugin, parameters, command) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.magenta(`${plugin.data.name.toUpperCase()} (Version ${plugin.data.version})`));
+    lines.push(chalk.gray('─'.repeat(74)));
+    lines.push(`${chalk.bold.blue('Type:')}         ${plugin.data.type || 'ds'}`);
+    lines.push(`${chalk.bold.blue('Author:')}       ${plugin.data.authors || 'FNNDSC <dev@babymri.org>'}`);
+    if (plugin.data.documentation) {
+        lines.push(`${chalk.bold.blue('Repository:')}   ${plugin.data.documentation}`);
+    }
+    lines.push('');
+    lines.push(chalk.bold.blue('DESCRIPTION'));
+    lines.push(`  ${plugin.data.description || 'No description provided.'}`);
+    lines.push('');
+    lines.push(chalk.bold.blue('PARAMETERS'));
+    lines.push(`  ${chalk.bold.white('Flag'.padEnd(22))}${chalk.bold.white('Type'.padEnd(11))}${chalk.bold.white('Required'.padEnd(11))}${chalk.bold.white('Default'.padEnd(13))}${chalk.bold.white('Description')}`);
+    lines.push(`  ${chalk.gray('─'.repeat(74))}`);
+    parameters.forEach((param) => {
+        const flag = `--${param.data.name}`;
+        const type = param.data.type || 'string';
+        const required = param.data.optional ? 'No' : 'Yes';
+        let defaultValue = '';
+        if (param.data.default !== undefined && param.data.default !== null) {
+            defaultValue = String(param.data.default);
+            if (defaultValue === '') {
+                defaultValue = '""';
+            }
+        }
+        else {
+            defaultValue = 'None';
+        }
+        const help = param.data.help || '';
+        lines.push(`  ${chalk.yellow(flag.padEnd(22))}${type.padEnd(11)}${required.padEnd(11)}${defaultValue.padEnd(13)}${help}`);
+    });
+    lines.push('');
+    lines.push(chalk.bold.blue('USAGE EXAMPLES'));
+    const requiredParams = parameters.filter((p) => !p.data.optional);
+    const optionalParams = parameters.filter((p) => p.data.optional);
+    const requiredFlags = requiredParams.map((p) => `--${p.data.name} "value"`).join(' ');
+    const basicExample = requiredFlags ? `${command} ${requiredFlags}` : command;
+    lines.push(`  ${chalk.white(basicExample)}                     ${chalk.gray('# Basic execution')}`);
+    if (optionalParams.length > 0) {
+        const exampleParam = optionalParams[0].data.name;
+        const withOptional = requiredFlags
+            ? `${command} ${requiredFlags} --${exampleParam} "value"`
+            : `${command} --${exampleParam} "value"`;
+        lines.push(`  ${chalk.white(withOptional)}     ${chalk.gray('# With optional parameter')}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Renders a brief info block for a pipeline that has no registered YAML source.
+ *
+ * @param pipeline - The resolved PipelineRecord.
+ * @returns Formatted summary string.
+ */
+function pipelineSummary_render(pipeline) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.magenta(pipeline.name));
+    lines.push(chalk.gray('─'.repeat(74)));
+    lines.push(`${chalk.bold.blue('ID:')}       ${pipeline.id}`);
+    if (pipeline.authors)
+        lines.push(`${chalk.bold.blue('Authors:')}  ${pipeline.authors}`);
+    if (pipeline.category)
+        lines.push(`${chalk.bold.blue('Category:')} ${pipeline.category}`);
+    if (pipeline.locked !== undefined)
+        lines.push(`${chalk.bold.blue('Locked:')}   ${pipeline.locked}`);
+    if (pipeline.description) {
+        lines.push('');
+        lines.push(chalk.bold.blue('DESCRIPTION'));
+        lines.push(`  ${pipeline.description}`);
+    }
+    lines.push('');
+    lines.push(chalk.dim('No YAML source registered. Use `pipeline info <name>` for full DAG details.'));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Reads virtual file content under command and builtin static paths.
+ *
+ * Handles help text formatting for /usr/bin and fetches parameter specifications for /bin plugins.
+ *
+ * @param pathStr - The absolute virtual path of the file to read.
+ * @param prefix - The prefix of the calling provider (e.g. '/usr/bin', '/bin').
+ * @returns Promise resolving to a Result containing the file contents as a string.
+ */
+export async function staticVfs_read(pathStr, prefix) {
+    try {
+        let effectivePath = pathStr.startsWith("/") ? pathStr : "/" + pathStr;
+        if (effectivePath.length > 1 && effectivePath.endsWith("/")) {
+            effectivePath = effectivePath.slice(0, -1);
+        }
+        if (prefix === "/usr/bin") {
+            const commandName = effectivePath.substring("/usr/bin/".length);
+            const helpStr = commandHelp_get(commandName);
+            if (helpStr !== undefined) {
+                return Ok(helpStr);
+            }
+            errorStack.stack_push("error", `No help available for command: ${commandName}`);
+            return Err();
+        }
+        if (prefix === "/bin") {
+            const commandName = effectivePath.substring("/bin/".length);
+            const versionSeparatorIndex = commandName.lastIndexOf('-v');
+            if (versionSeparatorIndex === -1) {
+                const yamlResult = await pipeline_sourceGet(commandName);
+                if (yamlResult.ok)
+                    return Ok(yamlResult.value);
+                const resolveResult = await pipeline_resolve(commandName);
+                if (resolveResult.ok)
+                    return Ok(pipelineSummary_render(resolveResult.value));
+                errorStack.stack_push("error", `Unknown /bin entry: ${commandName}`);
+                return Err();
+            }
+            const name = commandName.substring(0, versionSeparatorIndex);
+            const version = commandName.substring(versionSeparatorIndex + 2);
+            const client = await session.connection.client_get();
+            if (!client) {
+                errorStack.stack_push("error", "No active ChRIS connection to fetch plugin parameter specs");
+                return Err();
+            }
+            const pluginsList = await client.getPlugins({ name_exact: name, version: version, limit: 1 });
+            const plugins = pluginsList.getItems();
+            if (!plugins || plugins.length === 0) {
+                errorStack.stack_push("error", `Plugin not found on server: ${name} v${version}`);
+                return Err();
+            }
+            const plugin = plugins[0];
+            const parametersList = await plugin.getPluginParameters({ limit: 100 });
+            const parameters = parametersList.getItems();
+            const output = pluginParameters_render(plugin, parameters, commandName);
+            return Ok(output);
+        }
+        errorStack.stack_push("error", `File not found: ${pathStr}`);
+        return Err();
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        errorStack.stack_push("error", `Static VFS read failed for prefix ${prefix}: ${msg}`);
+        return Err();
+    }
+}
+/**
+ * Reads virtual file binary content under command and builtin static paths.
+ *
+ * @param pathStr - The absolute virtual path of the file to read.
+ * @param prefix - The prefix of the calling provider.
+ * @returns Promise resolving to a Result containing the file contents as a Buffer.
+ */
+export async function staticVfs_readBinary(pathStr, prefix) {
+    const res = await staticVfs_read(pathStr, prefix);
+    if (res.ok) {
+        return Ok(Buffer.from(res.value, "utf-8"));
+    }
+    return Err();
+}
+//# sourceMappingURL=static_content.js.map

package/dist/lib/vfs/providers/static_content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static_content.js","sourceRoot":"","sources":["../../../../src/lib/vfs/providers/static_content.ts"],"names":[],"mappings":"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"}

package/dist/lib/vfs/vfs.d.ts

@@ -0,0 +1,59 @@
+import { ListingItem } from '@fnndsc/chili/models/listing.js';
+import { Result } from '@fnndsc/cumin';
+/**
+ * Virtual File System Router.
+ * Dispatches operations to Virtual or Native providers.
+ */
+export declare class VFS {
+    /**
+     * Gets data for a directory (Virtual or Native).
+     * Separated from rendering to allow Result<T> pattern.
+     *
+     * @param targetPath - The path to get data for. If empty, uses CWD.
+     * @param options - Options including directory flag and sort.
+     * @returns Result<ListingItem[]> - Ok with items or Err with error message.
+     */
+    data_get(targetPath?: string, options?: {
+        sort?: 'name' | 'size' | 'date' | 'owner';
+        reverse?: boolean;
+        directory?: boolean;
+    }): Promise<Result<ListingItem[]>>;
+    /**
+     * Returns the directory entry for `absolutePath` itself (not its contents).
+     * Looks up the entry in the parent's listing — used to implement `ls -d`.
+     *
+     * @param absolutePath - The fully resolved path of the target.
+     * @param options - Sort options forwarded to the parent listing.
+     */
+    private directoryEntry_get;
+    /**
+     * List contents of a directory (Virtual or Native).
+     * Convenience method that fetches data and renders it.
+     * Implements optimistic rendering with progress feedback:
+     * - Stale cache: serve immediately with "(cached, refreshing...)" indicator
+     * - Cache miss: show "Fetching..." after 500ms if still loading
+     *
+     * @param targetPath - The path to list. If empty, uses CWD.
+     * @param options - Listing options (long, human, sort, reverse, directory).
+     */
+    list(targetPath?: string, options?: {
+        long?: boolean;
+        human?: boolean;
+        oneColumn?: boolean;
+        sort?: 'name' | 'size' | 'date' | 'owner';
+        reverse?: boolean;
+        directory?: boolean;
+    }): Promise<void>;
+    /**
+     * Refreshes cache in the background without blocking or updating display.
+     * Used for optimistic rendering - fetch fresh data after serving stale cache.
+     *
+     * @param targetPath - The path to refresh.
+     * @param options - Options including sort and reverse.
+     */
+    private refreshInBackground;
+}
+/**
+ * Shared VFS singleton.
+ */
+export declare const vfs: VFS;