@fnndsc/chell 4.2.8

package/dist/lib/completer/index.js

@@ -0,0 +1,212 @@
+/**
+ * @file REPL Autocompletion.
+ *
+ * Provides tab-completion logic for the REPL, including built-in commands
+ * and path completion.
+ *
+ * @module
+ */
+import { session } from '../../session/index.js';
+import { plugins_listAll, vfsDispatcher, context_getSingle } from '@fnndsc/salsa';
+import { partialPath_split, completions_build } from './pathComplete.helpers.js';
+import { listCache_get } from '@fnndsc/cumin';
+import * as path from 'path';
+import { builtinCommands_list } from '../../builtins/help.js';
+import { args_tokenize } from '../parser.js';
+function completionWord_get(line) {
+    let start = 0;
+    let quote = null;
+    let escapeNext = false;
+    for (let index = 0; index < line.length; index++) {
+        const char = line[index];
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\' && quote !== "'") {
+            escapeNext = true;
+            continue;
+        }
+        if ((char === "'" || char === '"') && (!quote || quote === char)) {
+            quote = quote ? null : char;
+            continue;
+        }
+        if (!quote && /\s/.test(char)) {
+            start = index + 1;
+        }
+    }
+    const raw = line.substring(start);
+    const tokens = args_tokenize(raw);
+    const value = tokens.length > 0 ? tokens[0] : '';
+    const openingQuote = raw.startsWith("'") ? "'" : raw.startsWith('"') ? '"' : null;
+    return { raw, value, quote: openingQuote };
+}
+function completion_format(completion, word) {
+    if (word.quote === "'") {
+        return `'${completion.replace(/'/g, `'\\''`)}`;
+    }
+    if (word.quote === '"') {
+        return `"${completion.replace(/(["\\])/g, '\\$1')}`;
+    }
+    return completion.replace(/([\\\s'"`])/g, '\\$1');
+}
+/**
+ * Fetches available plugin names from /bin in the format: name-vVersion.
+ * This matches the display format used in /bin listings.
+ * Uses cache first for fast completion.
+ * @returns Array of plugin names with version suffixes.
+ */
+async function plugins_getNames() {
+    try {
+        // Check cache first for /bin
+        const listCache = listCache_get();
+        const cached = listCache.cache_get('/bin');
+        if (cached && cached.data) {
+            // Return cached plugin names immediately
+            return cached.data.map((item) => item.name);
+        }
+        // Cache miss - fetch from API (only on first tab completion)
+        const plugins = await plugins_listAll({});
+        if (plugins && plugins.tableData) {
+            const pluginNames = plugins.tableData.map((p) => {
+                const name = typeof p.name === 'string' ? p.name : String(p.name ?? '');
+                const version = typeof p.version === 'string' ? p.version : String(p.version ?? '');
+                // Format as name-vVersion to match /bin display format
+                return version ? `${name}-v${version}` : name;
+            });
+            // Cache it for next time
+            const lsItems = plugins.tableData.map((p) => {
+                const name = typeof p.name === 'string' ? p.name : String(p.name ?? '');
+                const version = typeof p.version === 'string' ? p.version : String(p.version ?? '');
+                return {
+                    name: version ? `${name}-v${version}` : name,
+                    type: 'plugin',
+                    size: 0,
+                    owner: 'system',
+                    date: p.creation_date ? String(p.creation_date) : '',
+                };
+            });
+            listCache.cache_set('/bin', lsItems);
+            return pluginNames;
+        }
+    }
+    catch (e) {
+        // Silently fail if plugins cannot be fetched
+    }
+    return [];
+}
+/**
+ * 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 function input_complete(line, callback) {
+    const trimmed = line.trimStart();
+    const args = args_tokenize(trimmed);
+    // Case 1: Command Completion (First word)
+    // If we have only one token and the line doesn't end with space, we are typing the command
+    // Or if line is empty
+    const isCommandCompletion = args.length === 0 || (args.length === 1 && !line.endsWith(' '));
+    if (isCommandCompletion) {
+        // Check builtins first (instant, no async)
+        const builtinHits = builtinCommands_list().filter((c) => c.startsWith(trimmed));
+        // Always check plugins and combine results
+        plugins_getNames().then((pluginNames) => {
+            const pluginHits = pluginNames.filter((c) => c.startsWith(trimmed));
+            // Combine both builtins and plugins
+            const allHits = [...builtinHits, ...pluginHits];
+            callback(null, [allHits, trimmed]);
+        }).catch(() => {
+            // On error, return only builtin matches
+            callback(null, [builtinHits, trimmed]);
+        });
+        return;
+    }
+    // Case 2: Path Completion (Argument to specific commands)
+    const cmd = args[0];
+    if (['cd', 'ls', 'mkdir', 'touch', 'cat', 'edit', 'cp', 'mv', 'rm', 'upload', 'download', 'du', 'tree', 'pull', 'cubepath', 'query'].includes(cmd)) {
+        const word = completionWord_get(line);
+        path_complete(word.value).then((matches) => {
+            callback(null, [matches.map((match) => completion_format(match, word)), word.raw]);
+        }).catch((err) => {
+            // On error, return no matches, don't crash REPL
+            callback(null, [[], word.raw]);
+        });
+        return;
+    }
+    // Default: no completion
+    callback(null, [[], line]);
+}
+/**
+ * Resolves directory contents for completion.
+ * @param partial - The partial path string typed so far.
+ */
+async function path_complete(partial) {
+    // 1. Handle ~ expansion for the partial path base
+    let effectivePartial = partial;
+    if (partial.startsWith('~')) {
+        const context = await context_getSingle();
+        const user = context.user;
+        const home = user ? `/home/${user}` : '/';
+        if (partial === '~' || partial === '~/') {
+            effectivePartial = home + (partial.endsWith('/') ? '/' : '');
+        }
+        else if (partial.startsWith('~/')) {
+            effectivePartial = path.posix.join(home, partial.substring(2));
+        }
+    }
+    // Resolve the directory to list and the prefix to match
+    const { dirToList, prefix } = partialPath_split(effectivePartial);
+    // 2. Resolve absolute path for listing
+    let absDirToList;
+    if (dirToList.startsWith('/')) {
+        absDirToList = dirToList;
+    }
+    else {
+        const cwd = await session.getCWD();
+        absDirToList = dirToList ? path.posix.resolve(cwd, dirToList) : cwd;
+    }
+    // 3. Fetch contents (check cache first)
+    let items = [];
+    const listCache = listCache_get();
+    // Check cache first
+    const cached = listCache.cache_get(absDirToList);
+    if (cached) {
+        items = cached.data;
+    }
+    else {
+        try {
+            // Use vfsDispatcher for all path types — handles /pacs, /bin, native, etc.
+            const vfsResult = await vfsDispatcher.list(absDirToList);
+            if (vfsResult.ok) {
+                items = vfsResult.value;
+            }
+            // Inject virtual directories at root if missing
+            if (absDirToList === '/' || absDirToList === '') {
+                const hasItem = (name) => items.some((i) => i.name === name);
+                if (!hasItem('bin')) {
+                    items.push({ name: 'bin', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+                if (!hasItem('usr')) {
+                    items.push({ name: 'usr', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+                if (!hasItem('pacs')) {
+                    items.push({ name: 'pacs', type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                }
+            }
+            // Cache the results
+            if (items.length > 0) {
+                listCache.cache_set(absDirToList, items);
+            }
+        }
+        catch (e) {
+            // Ignore errors (e.g., perms, not a dir)
+        }
+    }
+    // 4. Filter and format matches, preserving the original partial's style
+    // (tilde/relative) and appending "/" to directory-like entries.
+    return completions_build(items, prefix, partial);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/completer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/completer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAe7C,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,KAAK,GAAW,CAAC,CAAC;IACtB,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,IAAI,UAAU,GAAY,KAAK,CAAC;IAEhC,KAAK,IAAI,KAAK,GAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,GAAW,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACnC,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;YACjE,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAa,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAW,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,YAAY,GAChB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,UAAkB,EAAE,IAAoB;IACjE,IAAI,IAAI,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;IACjD,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAgB,MAAM,CAAC,CAAC;QAE1D,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1B,yCAAyC;YACzC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;QAED,6DAA6D;QAC7D,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,WAAW,GAAa,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE;gBACjF,MAAM,IAAI,GAAW,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAChF,MAAM,OAAO,GAAW,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC5F,uDAAuD;gBACvD,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,CAAC,CAAC,CAAC;YAEH,yBAAyB;YACzB,MAAM,OAAO,GAAkB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE;gBAClF,MAAM,IAAI,GAAW,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAChF,MAAM,OAAO,GAAW,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC5F,OAAO;oBACL,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;oBAC5C,IAAI,EAAE,QAAiB;oBACvB,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;iBACrD,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAErC,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,6CAA6C;IAC/C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAA2B;IACtE,MAAM,OAAO,GAAW,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,IAAI,GAAa,aAAa,CAAC,OAAO,CAAC,CAAC;IAE9C,0CAA0C;IAC1C,2FAA2F;IAC3F,sBAAsB;IACtB,MAAM,mBAAmB,GAAY,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAErG,IAAI,mBAAmB,EAAE,CAAC;QACxB,2CAA2C;QAC3C,MAAM,WAAW,GAAa,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAElG,2CAA2C;QAC3C,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;YACtC,MAAM,UAAU,GAAa,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YAE9E,oCAAoC;YACpC,MAAM,OAAO,GAAa,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC;YAC1D,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,wCAAwC;YACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,0DAA0D;IAC1D,MAAM,GAAG,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnJ,MAAM,IAAI,GAAmB,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEtD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACvC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,gDAAgD;YAChD,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,kDAAkD;IAClD,IAAI,gBAAgB,GAAW,OAAO,CAAC;IAEvC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;QACzD,MAAM,IAAI,GAAkB,OAAO,CAAC,IAAI,CAAC;QACzC,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACxC,gBAAgB,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAElE,uCAAuC;IACvC,IAAI,YAAoB,CAAC;IACzB,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3C,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACtE,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK,GAAkB,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAElC,oBAAoB;IACpB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAgB,YAAY,CAAC,CAAC;IAChE,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,2EAA2E;YAC3E,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzD,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;gBACjB,KAAK,GAAG,SAAS,CAAC,KAAiC,CAAC;YACtD,CAAC;YAED,gDAAgD;YAChD,IAAI,YAAY,KAAK,GAAG,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;gBAChD,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBAClF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACnG,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACnG,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBACpG,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,gEAAgE;IAChE,OAAO,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/completer/pathComplete.helpers.d.ts

@@ -0,0 +1,22 @@
+import type { ListingItem } from '@fnndsc/chili/models/listing.js';
+/**
+ * Splits an (already tilde-expanded) partial path into the directory to list
+ * and the basename prefix to match against.
+ *
+ * @param effectivePartial - The tilde-expanded partial path.
+ * @returns The directory to list (empty = cwd) and the prefix.
+ */
+export declare function partialPath_split(effectivePartial: string): {
+    dirToList: string;
+    prefix: string;
+};
+/**
+ * Builds completion strings from listing items, preserving the original
+ * partial's style (tilde/relative) and appending `/` to directory-like entries.
+ *
+ * @param items - The listing items in the target directory.
+ * @param prefix - The basename prefix being completed.
+ * @param partial - The original (unexpanded) partial the user typed.
+ * @returns The completion strings for matching items.
+ */
+export declare function completions_build(items: ListingItem[], prefix: string, partial: string): string[];

package/dist/lib/completer/pathComplete.helpers.js

@@ -0,0 +1,49 @@
+/**
+ * @file Pure helpers for filesystem path tab-completion.
+ *
+ * Splits a partial path into the directory to list and the prefix to match, and
+ * reconstructs completion strings from matching listing items. Dependency-free
+ * (path module only) for easy unit testing.
+ *
+ * @module
+ */
+import path from 'path';
+/**
+ * Splits an (already tilde-expanded) partial path into the directory to list
+ * and the basename prefix to match against.
+ *
+ * @param effectivePartial - The tilde-expanded partial path.
+ * @returns The directory to list (empty = cwd) and the prefix.
+ */
+export function partialPath_split(effectivePartial) {
+    if (effectivePartial.endsWith('/')) {
+        return { dirToList: effectivePartial, prefix: '' };
+    }
+    let dirToList = path.posix.dirname(effectivePartial);
+    const prefix = path.posix.basename(effectivePartial);
+    if (dirToList === '.')
+        dirToList = ''; // Relative current dir
+    return { dirToList, prefix };
+}
+/**
+ * Builds completion strings from listing items, preserving the original
+ * partial's style (tilde/relative) and appending `/` to directory-like entries.
+ *
+ * @param items - The listing items in the target directory.
+ * @param prefix - The basename prefix being completed.
+ * @param partial - The original (unexpanded) partial the user typed.
+ * @returns The completion strings for matching items.
+ */
+export function completions_build(items, prefix, partial) {
+    return items
+        .filter((i) => i.name.startsWith(prefix))
+        .map((hit) => {
+        const remainingSegment = hit.name.substring(prefix.length);
+        let completion = partial + remainingSegment;
+        if (hit.type === 'dir' || hit.type === 'vfs' || hit.type === 'link') {
+            completion += '/';
+        }
+        return completion;
+    });
+}
+//# sourceMappingURL=pathComplete.helpers.js.map

package/dist/lib/completer/pathComplete.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathComplete.helpers.js","sourceRoot":"","sources":["../../../src/lib/completer/pathComplete.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,gBAAwB;IACxD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,SAAS,KAAK,GAAG;QAAE,SAAS,GAAG,EAAE,CAAC,CAAC,uBAAuB;IAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,MAAc,EAAE,OAAe;IACrF,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE;QACxB,MAAM,gBAAgB,GAAW,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,UAAU,GAAW,OAAO,GAAG,gBAAgB,CAAC;QACpD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpE,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/lib/logo.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file ASCII logo rendering and animation frames.
+ *
+ * Pre-rendered ChRIS/CheLL logo captured with ascii-image-converter.
+ * The colored variant uses embedded ANSI 24-bit codes; the plain variant strips them.
+ */
+/**
+ * Renders the ASCII logo as an array of lines.
+ *
+ * @param colorize - Whether to apply color.
+ * @param reverse - Whether to reverse the gradient.
+ * @returns The rendered logo lines.
+ */
+export declare function logo_linesRender(colorize: boolean, reverse?: boolean): string[];
+/**
+ * Renders a single frame of the brain activity animation, where the core brain
+ * structure retains its original hue'd color gradient, and only the inner spaces
+ * (stylized nodes) pulse, grow, and fade physically as spatial blooms.
+ *
+ * @param frameIndex - The index of the animation frame.
+ * @param isStaticEndState - If true, renders the final steady state where holes are blank.
+ * @returns Array of rendered lines with color codes.
+ */
+export declare function logo_frameRender(frameIndex: number, isStaticEndState?: boolean): string[];
+/**
+ * Prints the static logo and begins tracking subsequent stdout lines.
+ * Call this at boot to show the brain art; follow with logo_animatePulse() after login.
+ *
+ * @param useColor - True to enable colored rendering and prepare for pulsing.
+ */
+export declare function logo_print(useColor: boolean): void;
+/**
+ * Starts the pulsing brain activity animation in-place above already-printed output.
+ * Must be called after logo_print(true); no-op if already running or non-TTY.
+ */
+export declare function logo_animatePulse(): void;
+/**
+ * Starts the brain activity pulsing node animation on the console.
+ * Falls back to static plain rendering if non-TTY or color is disabled.
+ *
+ * @param useColor - True to enable colored pulsing, false for static plain rendering.
+ */
+export declare function logo_animateStart(useColor: boolean): void;
+/**
+ * Stops the brain activity pulsing animation, rendering the final steady state.
+ */
+export declare function logo_animateStop(): void;