@fnndsc/chell 4.4.0 → 5.0.1

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

@@ -1,164 +0,0 @@
-/**
- * @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

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

@@ -1,27 +0,0 @@
-/**
- * @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

@@ -1,180 +0,0 @@
-/**
- * @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

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

@@ -1,59 +0,0 @@
-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;

package/dist/lib/vfs/vfs.js

@@ -1,202 +0,0 @@
-/**
- * @file Virtual File System Router.
- *
- * Handles path resolution and dispatching to appropriate file system providers
- * (native ChRIS or virtual overlays like /bin).
- *
- * @module
- */
-import { vfsDispatcher } from '@fnndsc/salsa';
-import { session } from '../../session/index.js';
-import chalk from 'chalk';
-import * as path from 'path';
-import { grid_render, long_render } from '@fnndsc/chili/views/ls.js';
-import { list_applySort } from '@fnndsc/chili/utils/sort.js';
-import { listCache_get, Ok, Err, errorStack } from '@fnndsc/cumin';
-import { spinner } from '../spinner.js';
-import { error_stripDebugPrefix } from '../../builtins/utils.js';
-/**
- * Virtual File System Router.
- * Dispatches operations to Virtual or Native providers.
- */
-export 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.
-     */
-    async data_get(targetPath, options = {}) {
-        try {
-            const cwd = await session.getCWD();
-            const effectivePath = targetPath
-                ? path.posix.resolve(cwd, targetPath)
-                : cwd;
-            // -d: show the target entry itself rather than descending into it
-            if (options.directory && targetPath) {
-                return this.directoryEntry_get(effectivePath, options);
-            }
-            // /proc paths are backed by ProcCache which manages its own freshness —
-            // skip listCache entirely so proc refresh and live status reads are visible.
-            const isProcPath = effectivePath.startsWith('/proc');
-            // Check cache first (not for /proc paths)
-            const listCache = listCache_get();
-            if (!isProcPath) {
-                const cached = listCache.cache_get(effectivePath);
-                if (cached) {
-                    const sortField = options.sort || 'name';
-                    const sortedItems = list_applySort(cached.data, sortField, options.reverse);
-                    return Ok(sortedItems);
-                }
-            }
-            // Delegate path queries to the unified vfsDispatcher (which handles both virtual and native paths)
-            const vfsResult = await vfsDispatcher.list(effectivePath, options);
-            if (vfsResult.ok) {
-                const items = vfsResult.value;
-                // Cache the results (not for /proc paths)
-                if (!isProcPath) {
-                    listCache.cache_set(effectivePath, items);
-                }
-                return Ok(items);
-            }
-            return Err();
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            errorStack.stack_push("error", `Failed to get directory data: ${errorMsg}`);
-            return Err();
-        }
-    }
-    /**
-     * 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.
-     */
-    async directoryEntry_get(absolutePath, options) {
-        const baseName = path.posix.basename(absolutePath);
-        const parentPath = path.posix.dirname(absolutePath);
-        if (!baseName || absolutePath === '/') {
-            return Ok([{ name: '/', type: 'vfs', size: 0, owner: 'root', date: '' }]);
-        }
-        // Fetch parent listing (use cache when available)
-        const listCache = listCache_get();
-        let parentItems = null;
-        const cached = listCache.cache_get(parentPath);
-        if (cached) {
-            parentItems = cached.data;
-        }
-        else {
-            const parentResult = await vfsDispatcher.list(parentPath, options);
-            if (parentResult.ok) {
-                parentItems = parentResult.value;
-                listCache.cache_set(parentPath, parentItems);
-            }
-        }
-        if (parentItems) {
-            const match = parentItems.find((item) => item.name === baseName);
-            if (match)
-                return Ok([match]);
-        }
-        // Fallback: synthesize an entry from the path name
-        return Ok([{ name: baseName, type: 'dir', size: 0, owner: 'system', date: '' }]);
-    }
-    /**
-     * 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).
-     */
-    async list(targetPath, options = {}) {
-        // Resolve effective path for cache checking
-        const cwd = await session.getCWD();
-        const effectivePath = targetPath
-            ? path.posix.resolve(cwd, targetPath)
-            : cwd;
-        // Check if we're serving from stale cache BEFORE fetching
-        const listCache = listCache_get();
-        const cached = listCache.cache_get(effectivePath);
-        const wasStale = cached && !cached.fresh;
-        const isCacheMiss = !cached;
-        // For cache miss, show loading indicator after 500ms timeout
-        let spinnerStarted = false; // Flag to track if spinner was actually started
-        let spinnerDelayTimeout = null;
-        if (isCacheMiss) {
-            spinnerDelayTimeout = setTimeout(() => {
-                spinner.start('Fetching directory from remote', true); // The spinner message with timing
-                spinnerStarted = true;
-            }, 500);
-        }
-        // Fetch data (may be from cache)
-        const result = await this.data_get(targetPath, options);
-        // Clear loading timeout and indicator
-        if (spinnerDelayTimeout) {
-            clearTimeout(spinnerDelayTimeout);
-        }
-        if (spinnerStarted) {
-            spinner.stop();
-        }
-        if (!result.ok) {
-            const lastError = errorStack.stack_pop();
-            if (lastError) {
-                console.error(chalk.red(error_stripDebugPrefix(lastError.message)));
-            }
-            return;
-        }
-        if (result.value.length === 0) {
-            return;
-        }
-        // Render based on options
-        if (options.long) {
-            console.log(long_render(result.value, { human: !!options.human }));
-        }
-        else {
-            console.log(grid_render(result.value, { oneColumn: !!options.oneColumn }));
-        }
-        // If we served stale cache, show indicator and refresh in background
-        if (wasStale) {
-            console.log(chalk.gray('(cached, refreshing...)'));
-            // Trigger background refresh - don't await. Fenced in its own error-stack
-            // scope so its pushes/pops cannot corrupt a concurrent foreground
-            // command's error-drain window.
-            errorStack.scope_run(() => {
-                this.refreshInBackground(effectivePath, options).catch(() => {
-                    // Silently ignore refresh errors - user has moved on
-                });
-            });
-        }
-    }
-    /**
-     * 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.
-     */
-    async refreshInBackground(targetPath, options) {
-        try {
-            // Invalidate cache to force fresh fetch
-            const listCache = listCache_get();
-            listCache.cache_invalidate(targetPath);
-            // Fetch fresh data - this will repopulate cache
-            await this.data_get(targetPath, options);
-            // Don't update display - user has moved on
-            // Fresh data is now cached for next access
-        }
-        catch (_error) {
-            // Silently fail - background refresh is best-effort
-        }
-    }
-}
-/**
- * Shared VFS singleton.
- */
-export const vfs = new VFS();
-//# sourceMappingURL=vfs.js.map