@fnndsc/brasa 0.56.1 → 0.56.2

package/dist/core/paths.d.ts

@@ -16,3 +16,26 @@ export declare function path_resolveFrom(inputPath: string, home: string, cwd: s
  * @returns The absolute path.
  */
 export declare function path_resolve(inputPath: string): Promise<string>;
+/**
+ * Where a path lives in the backend's store: the one answer every reader
+ * and lister asks before it goes to the dispatcher.
+ *
+ * The session's namespace first (`~`, a relative path), then, hop by hop,
+ * whatever stands in the way: a mount that stands for a store folder hands
+ * back the store path (`/proc/jobs/…/data/…` is the job's output folder and
+ * the rest of the path in it), and the backend follows the store's own links
+ * on a store path (ChRIS: `.chrislink`s at any depth). A link may land
+ * under another mount, and a mount's answer may pass through links, so the
+ * two are asked in turn until neither moves the path.
+ *
+ * Best effort by design: a path that resolves no further stands as it is,
+ * and the read that follows refuses it by its own name.
+ *
+ * @param inputPath - The path as typed or as a surface gave it.
+ * @returns The store path; a path a mount holds itself (a file it makes),
+ *   as resolved in the namespace.
+ * @example
+ * await storePath_resolve('/proc/jobs/feed_7/pl-dircopy_12/data/home_alice_uploads_set/a.txt');
+ * // '/home/alice/uploads/set/a.txt', the dircopy's output holding a link to ~/uploads/set
+ */
+export declare function storePath_resolve(inputPath: string): Promise<string>;

package/dist/core/paths.js

@@ -1,12 +1,15 @@
 /**
- * @file A path as the session means it: `~` is the session's home, and a
- * relative path stands under the working directory.
+ * @file A path as the session means it: `~` is the session's home, a
+ * relative path stands under the working directory, and where the store
+ * keeps it (`storePath_resolve`), which every reader and lister asks.
  *
  * @module
  */
 import * as path from 'path';
+import { errorStack } from '@fnndsc/fond';
 import { session } from '../session/index.js';
 import { backendInstalled_get } from './backend.js';
+import { vfsDispatcher_get } from './filesystem.js';
 /**
  * Resolves a path against a home and a working directory, without asking
  * anything: `~` and `~/x` under the home, a relative path under the working
@@ -46,4 +49,72 @@ export async function path_resolve(inputPath) {
     const cwd = await session.getCWD();
     return path_resolveFrom(inputPath, home, cwd);
 }
+/** How many mount-and-link hops a path may take before it is read where it stands. */
+const STORE_HOPS_MAX = 8;
+/**
+ * Where a path lives in the backend's store: the one answer every reader
+ * and lister asks before it goes to the dispatcher.
+ *
+ * The session's namespace first (`~`, a relative path), then, hop by hop,
+ * whatever stands in the way: a mount that stands for a store folder hands
+ * back the store path (`/proc/jobs/…/data/…` is the job's output folder and
+ * the rest of the path in it), and the backend follows the store's own links
+ * on a store path (ChRIS: `.chrislink`s at any depth). A link may land
+ * under another mount, and a mount's answer may pass through links, so the
+ * two are asked in turn until neither moves the path.
+ *
+ * Best effort by design: a path that resolves no further stands as it is,
+ * and the read that follows refuses it by its own name.
+ *
+ * @param inputPath - The path as typed or as a surface gave it.
+ * @returns The store path; a path a mount holds itself (a file it makes),
+ *   as resolved in the namespace.
+ * @example
+ * await storePath_resolve('/proc/jobs/feed_7/pl-dircopy_12/data/home_alice_uploads_set/a.txt');
+ * // '/home/alice/uploads/set/a.txt', the dircopy's output holding a link to ~/uploads/set
+ */
+export async function storePath_resolve(inputPath) {
+    // An absolute path needs no session to stand where it is.
+    let at = inputPath.startsWith('/') ? path_resolveFrom(inputPath, '/', '/') : await path_resolve(inputPath);
+    const dispatcher = vfsDispatcher_get();
+    const links = backendInstalled_get()?.vfs?.path_physical;
+    // A dispatcher that cannot say where its mounts are holds none.
+    const mounted = (candidate) => typeof dispatcher.path_isVirtual === 'function' && dispatcher.path_isVirtual(candidate);
+    for (let hop = 0; hop < STORE_HOPS_MAX; hop++) {
+        if (mounted(at)) {
+            const mount = dispatcher.provider_get(at);
+            if (mount.storePath_resolve === undefined)
+                return at;
+            let mapped;
+            try {
+                mapped = await mount.storePath_resolve(at);
+            }
+            catch {
+                return at;
+            }
+            if (!mapped.ok || mapped.value === null || mapped.value === at)
+                return at;
+            at = mapped.value;
+            continue;
+        }
+        if (links === undefined)
+            return at;
+        // A walk that cannot follow a link (one that fails, or throws) leaves
+        // the path as it was; what it noted on the way is not the read's
+        // reason, which the read gives.
+        const mark = errorStack.checkpoint_mark();
+        let followed = at;
+        try {
+            followed = await links(at);
+        }
+        catch {
+            // The path stands as asked.
+        }
+        errorStack.checkpoint_drain(mark);
+        if (followed === at || !mounted(followed))
+            return followed;
+        at = followed;
+    }
+    return at;
+}
 //# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,IAAY,EAAE,GAAW;IAC3E,IAAI,QAAQ,GAAW,SAAS,CAAC;IAEjC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5C,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,MAAM,IAAI,GAAW,CAAC,MAAM,oBAAoB,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC;IAC/E,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;IAC3C,OAAO,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"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"}

package/dist/core/preprocess.d.ts

@@ -1,18 +1,20 @@
 import { Result } from '@fnndsc/fond';
 /**
- * Determines whether an argument belongs to the CFS/VFS shell namespace.
+ * Determines whether an argument of a command not yet declared belongs to the
+ * CFS/VFS shell namespace. A declared command never asks: its grammar says
+ * which operands glob (core/commandParse.ts), and each command leaves this
+ * table as it is declared.
  *
- * Ordinary ChELL words expand before dispatch. Transfer commands mark their
- * host-local operands as a different realm: upload owns host-source expansion,
- * while download keeps its final host destination literal.
+ * Ordinary ChELL words expand before dispatch. `upload` marks its host-local
+ * operands as a different realm and owns host-source expansion.
  *
  * @param command - Command word being executed.
- * @param index - Zero-based argument position before expansion.
- * @param argumentCount - Number of arguments before expansion.
- * @param args - Argument values before expansion.
+ * @param _index - Zero-based argument position before expansion.
+ * @param _argumentCount - Number of arguments before expansion.
+ * @param _args - Argument values before expansion.
  * @returns True if the word is eligible for CFS/VFS pathname expansion.
  */
-export declare function pathnameExpansion_isEligible(command: string, index: number, argumentCount: number, args?: readonly string[]): boolean;
+export declare function pathnameExpansion_isEligible(command: string, _index: number, _argumentCount: number, _args?: readonly string[]): boolean;
 /**
  * Returns true if the input line is a shell escape (starts with `!`).
  *

package/dist/core/preprocess.js

@@ -11,31 +11,22 @@ import { args_tokenize } from '../lib/parser.js';
 import { Ok, Err, errorStack } from '@fnndsc/fond';
 import { backslash_escapesNext } from '../lib/quoting.js';
 /**
- * Determines whether an argument belongs to the CFS/VFS shell namespace.
+ * Determines whether an argument of a command not yet declared belongs to the
+ * CFS/VFS shell namespace. A declared command never asks: its grammar says
+ * which operands glob (core/commandParse.ts), and each command leaves this
+ * table as it is declared.
  *
- * Ordinary ChELL words expand before dispatch. Transfer commands mark their
- * host-local operands as a different realm: upload owns host-source expansion,
- * while download keeps its final host destination literal.
+ * Ordinary ChELL words expand before dispatch. `upload` marks its host-local
+ * operands as a different realm and owns host-source expansion.
  *
  * @param command - Command word being executed.
- * @param index - Zero-based argument position before expansion.
- * @param argumentCount - Number of arguments before expansion.
- * @param args - Argument values before expansion.
+ * @param _index - Zero-based argument position before expansion.
+ * @param _argumentCount - Number of arguments before expansion.
+ * @param _args - Argument values before expansion.
  * @returns True if the word is eligible for CFS/VFS pathname expansion.
  */
-export function pathnameExpansion_isEligible(command, index, argumentCount, args = []) {
-    if (command === 'upload')
-        return false;
-    if (command === 'download') {
-        const positionalIndexes = args.reduce((indexes, arg, argIndex) => {
-            if (arg !== '-f' && arg !== '--force')
-                indexes.push(argIndex);
-            return indexes;
-        }, []);
-        const destinationIndex = positionalIndexes.at(-1);
-        return destinationIndex !== undefined && index !== destinationIndex && positionalIndexes.includes(index);
-    }
-    return true;
+export function pathnameExpansion_isEligible(command, _index, _argumentCount, _args = []) {
+    return command !== 'upload';
 }
 /**
  * Returns true if the input line is a shell escape (starts with `!`).

package/dist/core/preprocess.js.map

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

package/dist/core/warmupFailures.d.ts

@@ -1,11 +1,15 @@
 /**
- * @file Warm-up steps that failed behind the prompt.
+ * @file Warm-up steps behind the prompt: those still running, and those that failed.
  *
  * A warm-up moved off the boot gate reports its failure afterwards, and a
  * boot readout has scrolled away by then. So a failure is held here until
  * a later attempt succeeds, and every surface reads it from the prompt
  * context: a message that vanishes is one nobody acts on.
  *
+ * A step still running is held here too, from its start to its outcome: a
+ * daemon listens before its warm-up ends, and a surface that attaches
+ * meanwhile is told what the session is still warming.
+ *
  * Kept free of imports so it can be unit tested; the engine graph cannot
  * be loaded under jest.
  *
@@ -21,6 +25,34 @@ export interface WarmupFailure {
     label: string;
     message: string;
 }
+/**
+ * Records that a deferred warm-up step has started and not yet settled.
+ *
+ * @param label - The boot-step label.
+ *
+ * @example
+ * warmupPending_note('Public');
+ * warmupPending_list(); // ['Public']
+ */
+export declare function warmupPending_note(label: string): void;
+/**
+ * Records that a deferred warm-up step has settled, whatever its outcome.
+ *
+ * @param label - The boot-step label.
+ *
+ * @example
+ * warmupPending_clear('Public');
+ */
+export declare function warmupPending_clear(label: string): void;
+/**
+ * The steps still warming, in the order they started.
+ *
+ * @returns One label per step that has started and not yet settled.
+ *
+ * @example
+ * warmupPending_list(); // ['Public', 'Queries'] while those two run
+ */
+export declare function warmupPending_list(): string[];
 /**
  * Records that a deferred warm-up step failed.
  *
@@ -40,5 +72,5 @@ export declare function warmupFailure_clear(label: string): void;
  * @returns One entry per step that failed and has not since succeeded.
  */
 export declare function warmupFailures_list(): WarmupFailure[];
-/** Forgets every recorded failure (tests, and a session starting over). */
+/** Forgets every recorded failure and running step (tests, and a session starting over). */
 export declare function warmupFailures_reset(): void;

package/dist/core/warmupFailures.js

@@ -1,11 +1,15 @@
 /**
- * @file Warm-up steps that failed behind the prompt.
+ * @file Warm-up steps behind the prompt: those still running, and those that failed.
  *
  * A warm-up moved off the boot gate reports its failure afterwards, and a
  * boot readout has scrolled away by then. So a failure is held here until
  * a later attempt succeeds, and every surface reads it from the prompt
  * context: a message that vanishes is one nobody acts on.
  *
+ * A step still running is held here too, from its start to its outcome: a
+ * daemon listens before its warm-up ends, and a surface that attaches
+ * meanwhile is told what the session is still warming.
+ *
  * Kept free of imports so it can be unit tested; the engine graph cannot
  * be loaded under jest.
  *
@@ -13,6 +17,42 @@
  */
 /** Failures by label, so a later attempt replaces rather than repeats. */
 const failures = new Map();
+/** Labels of the steps still running, in the order they started. */
+const pending = new Set();
+/**
+ * Records that a deferred warm-up step has started and not yet settled.
+ *
+ * @param label - The boot-step label.
+ *
+ * @example
+ * warmupPending_note('Public');
+ * warmupPending_list(); // ['Public']
+ */
+export function warmupPending_note(label) {
+    pending.add(label);
+}
+/**
+ * Records that a deferred warm-up step has settled, whatever its outcome.
+ *
+ * @param label - The boot-step label.
+ *
+ * @example
+ * warmupPending_clear('Public');
+ */
+export function warmupPending_clear(label) {
+    pending.delete(label);
+}
+/**
+ * The steps still warming, in the order they started.
+ *
+ * @returns One label per step that has started and not yet settled.
+ *
+ * @example
+ * warmupPending_list(); // ['Public', 'Queries'] while those two run
+ */
+export function warmupPending_list() {
+    return Array.from(pending);
+}
 /**
  * Records that a deferred warm-up step failed.
  *
@@ -38,8 +78,9 @@ export function warmupFailure_clear(label) {
 export function warmupFailures_list() {
     return Array.from(failures, ([label, message]) => ({ label, message }));
 }
-/** Forgets every recorded failure (tests, and a session starting over). */
+/** Forgets every recorded failure and running step (tests, and a session starting over). */
 export function warmupFailures_reset() {
     failures.clear();
+    pending.clear();
 }
 //# sourceMappingURL=warmupFailures.js.map

package/dist/core/warmupFailures.js.map

@@ -1 +1 @@
-{"version":3,"file":"warmupFailures.js","sourceRoot":"","sources":["../../src/core/warmupFailures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,0EAA0E;AAC1E,MAAM,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,OAAe;IAC/D,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAmB,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"warmupFailures.js","sourceRoot":"","sources":["../../src/core/warmupFailures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,0EAA0E;AAC1E,MAAM,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;AAEhD,oEAAoE;AACpE,MAAM,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,OAAe;IAC/D,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAmB,EAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * The entries of the folder a partial path names that start with its last
+ * part, in the partial's own style (tilde or relative kept), a folder
+ * ending in `/`.
+ *
+ * @param partial - The path typed so far.
+ * @returns The candidates; none when the folder cannot be listed.
+ *
+ * @example
+ * ```ts
+ * await cfsPaths_complete('/home/mise-e2e/'); // ['/home/mise-e2e/feeds/', '/home/mise-e2e/uploads/', …]
+ * ```
+ */
+export declare function cfsPaths_complete(partial: string): Promise<string[]>;

package/dist/lib/completer/cfsPaths.js

@@ -0,0 +1,91 @@
+/**
+ * @file Completion of a path in ChRIS's filesystem (CFS): the entries of the
+ * folder a partial path names that start with its last part, read through
+ * the session's filesystem and kept in the listing cache.
+ *
+ * Key components:
+ * - cfsPaths_complete: the candidates for a partial path.
+ *
+ * Typical usage:
+ * ```ts
+ * const candidates: string[] = await cfsPaths_complete('~/uploads/sub');
+ * ```
+ *
+ * Dependencies: the session's working directory and home, its filesystem
+ * dispatcher and listing cache.
+ *
+ * @module
+ */
+import * as path from 'path';
+import { session } from '../../session/index.js';
+import { listingItemsFromVfs_make } from '../vfs/listing.js';
+import { partialPath_split, completions_build } from './pathComplete.helpers.js';
+import { backendInstalled_get } from '../../core/backend.js';
+import { listingCache_get, vfsDispatcher_get } from '../../core/filesystem.js';
+/**
+ * The entries of the folder a partial path names that start with its last
+ * part, in the partial's own style (tilde or relative kept), a folder
+ * ending in `/`.
+ *
+ * @param partial - The path typed so far.
+ * @returns The candidates; none when the folder cannot be listed.
+ *
+ * @example
+ * ```ts
+ * await cfsPaths_complete('/home/mise-e2e/'); // ['/home/mise-e2e/feeds/', '/home/mise-e2e/uploads/', …]
+ * ```
+ */
+export async function cfsPaths_complete(partial) {
+    let effectivePartial = partial;
+    if (partial.startsWith('~')) {
+        const home = (await backendInstalled_get()?.session.home_get()) ?? '/';
+        if (partial === '~' || partial === '~/') {
+            effectivePartial = home + (partial.endsWith('/') ? '/' : '');
+        }
+        else if (partial.startsWith('~/')) {
+            effectivePartial = path.posix.join(home, partial.substring(2));
+        }
+    }
+    const { dirToList, prefix } = partialPath_split(effectivePartial);
+    let absDirToList;
+    if (dirToList.startsWith('/')) {
+        absDirToList = dirToList;
+    }
+    else {
+        const cwd = await session.getCWD();
+        absDirToList = dirToList ? path.posix.resolve(cwd, dirToList) : cwd;
+    }
+    let items = [];
+    const listCache = listingCache_get();
+    const cached = listCache.cache_get(absDirToList);
+    if (cached) {
+        items = cached.data;
+    }
+    else {
+        try {
+            // The session's filesystem answers every path: the backend's mounts and fallback, and the core's.
+            const vfsResult = await vfsDispatcher_get().list(absDirToList);
+            if (vfsResult.ok) {
+                items = listingItemsFromVfs_make(vfsResult.value);
+            }
+            // Names completed at the root even when its listing lacks them.
+            if (absDirToList === '/' || absDirToList === '') {
+                const hasItem = (name) => items.some((item) => item.name === name);
+                for (const name of backendInstalled_get()?.completion?.rootWords ?? ['usr']) {
+                    if (!hasItem(name)) {
+                        items.push({ name, type: 'vfs', size: 0, owner: 'root', date: new Date().toISOString() });
+                    }
+                }
+            }
+            if (items.length > 0) {
+                listCache.cache_set(absDirToList, items);
+            }
+        }
+        catch {
+            // A folder that cannot be listed (permissions, not a folder) completes nothing.
+        }
+    }
+    // The partial's own style (tilde or relative) is kept, and a folder ends in "/".
+    return completions_build(items, prefix, partial);
+}
+//# sourceMappingURL=cfsPaths.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { type AnyCommandDeclaration } from '../../core/commandDeclaration.js';
+/**
+ * The candidates for the word being typed in a declared command's line.
+ *
+ * @param declaration - The command.
+ * @param prior - The words after the command, before the one being typed.
+ * @param word - The word typed so far (quotes removed).
+ * @returns The candidates, each the whole word; a folder ends in `/`.
+ *
+ * @example
+ * ```ts
+ * await declaredWord_complete(lsCommand, ['--sort'], 's'); // ['size']
+ * ```
+ */
+export declare function declaredWord_complete(declaration: AnyCommandDeclaration, prior: readonly string[], word: string): Promise<string[]>;