@fnndsc/brasa 0.56.1 → 0.56.3

package/dist/core/preprocess.d.ts

@@ -1,18 +1,19 @@
 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.
+ * Every word of such a command is a CFS/VFS word, expanded before dispatch.
  *
- * @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 _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.
  * @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,30 +11,20 @@ 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.
+ * Every word of such a command is a CFS/VFS word, expanded before dispatch.
  *
- * @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 _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.
  * @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);
-    }
+export function pathnameExpansion_isEligible(_command, _index, _argumentCount, _args = []) {
     return true;
 }
 /**

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[]>;

package/dist/lib/completer/declared.js

@@ -0,0 +1,189 @@
+/**
+ * @file Completion of a declared command's line, read from its grammar: its
+ * subcommand words, its option names, an option's value by its kind, and an
+ * operand by the kind of the operand it stands in.
+ *
+ * The line is walked as the parser walks it, but forgivingly: what is typed
+ * so far may be half a line, and nothing is refused.
+ *
+ * Key components:
+ * - declaredWord_complete: the candidates for the word being typed.
+ *
+ * Typical usage:
+ * ```ts
+ * await declaredWord_complete(berthCommand, [], 'an'); // ['anchor']
+ * await declaredWord_complete(lsCommand, [], '-'); // ['-l', '-1', …, '--sort']
+ * ```
+ *
+ * Dependencies: the argument kinds, whose completion sources answer the values.
+ *
+ * @module
+ */
+import { argumentKind_get, candidates_filter } from '../../core/argumentKinds.js';
+import { declaration_isParsed, } from '../../core/commandDeclaration.js';
+/** A word that reads as a negative number. */
+const NEGATIVE_NUMBER = /^-\d+(?:\.\d+)?$/;
+/**
+ * The options in reach: the subcommand's (the bare command's while none is
+ * typed), then the command's.
+ *
+ * @param grammar - The command's grammar.
+ * @param subcommand - The subcommand's, or null.
+ * @returns The options.
+ */
+function optionsInReach_list(grammar, subcommand) {
+    const own = subcommand === null ? (grammar.bare?.options ?? {}) : (subcommand.options ?? {});
+    return [...Object.values(own), ...Object.values(grammar.options ?? {})];
+}
+/**
+ * The option a word of short options leaves waiting for its value: one
+ * that takes a value and ends the word (`-o`); none when the value is in
+ * the word (`-ofile`) or no letter takes one.
+ *
+ * @param options - The options in reach.
+ * @param word - The word, `-` and letters.
+ * @returns The option waiting, or null.
+ */
+function shortValue_pending(options, word) {
+    for (let index = 1; index < word.length; index += 1) {
+        const option = options.find((one) => one.short === word[index]);
+        if (option?.value !== undefined)
+            return index === word.length - 1 && option.value.optional !== true ? option : null;
+    }
+    return null;
+}
+/**
+ * Walks the words before the one being typed, as the parser would.
+ *
+ * @param grammar - The command's grammar.
+ * @param prior - The words after the command, before the word being typed.
+ * @returns Where the line stands.
+ */
+function lineReach_walk(grammar, prior) {
+    const reach = { subcommand: null, optionsEnded: false, pending: null, operands: 0 };
+    for (const word of prior) {
+        const options = optionsInReach_list(grammar, reach.subcommand);
+        if (reach.pending !== null) {
+            reach.pending = null;
+        }
+        else if (!reach.optionsEnded && word === '--') {
+            reach.optionsEnded = true;
+        }
+        else if (!reach.optionsEnded && word.startsWith('--')) {
+            const option = options.find((one) => one.long === word.slice(2));
+            // An optional value is in the option's own word, so the next word is not it.
+            reach.pending = option?.value !== undefined && option.value.optional !== true && !word.includes('=') ? option : null;
+        }
+        else if (!reach.optionsEnded && word.startsWith('-') && word.length > 1 && !NEGATIVE_NUMBER.test(word)) {
+            reach.pending = shortValue_pending(options, word);
+        }
+        else if (grammar.subcommands !== undefined && reach.subcommand === null && reach.operands === 0 && !reach.optionsEnded && Object.hasOwn(grammar.subcommands, word)) {
+            reach.subcommand = grammar.subcommands[word] ?? null;
+        }
+        else {
+            reach.operands += 1;
+        }
+    }
+    return reach;
+}
+/**
+ * The operands a word at a place may stand in: the one there, or, past the
+ * operands before a repeated one, the repeated one and those after it.
+ *
+ * @param operands - The operands, in order.
+ * @param place - How many operands stand before the word.
+ * @returns The operands it may be.
+ */
+function operandsAtPlace_list(operands, place) {
+    let at = 0;
+    for (const [index, operand] of operands.entries()) {
+        if (operand.repeat === true)
+            return place === at ? [operand] : [operand, ...operands.slice(index + 1)];
+        if (place === at)
+            return [operand];
+        at += 1;
+    }
+    return [];
+}
+/**
+ * Completes a value by its argument's kind.
+ *
+ * @param argument - The argument.
+ * @param partial - The value typed so far.
+ * @returns The candidates.
+ */
+async function value_complete(argument, partial) {
+    const kind = argumentKind_get(argument.kind);
+    if (kind?.words_complete === undefined)
+        return [];
+    try {
+        return await kind.words_complete(partial, argument);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The option names in reach that start with a word: `-l` and `--long` alike.
+ *
+ * @param options - The options.
+ * @param word - The word typed.
+ * @returns The names.
+ */
+function optionNames_complete(options, word) {
+    const names = [];
+    for (const option of options) {
+        if (option.short !== undefined)
+            names.push(`-${option.short}`);
+    }
+    for (const option of options) {
+        if (option.long !== undefined)
+            names.push(`--${option.long}`);
+    }
+    return candidates_filter([...new Set(names)], word);
+}
+/**
+ * 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 async function declaredWord_complete(declaration, prior, word) {
+    if (!declaration_isParsed(declaration))
+        return (await declaration.complete?.(prior, word)) ?? [];
+    const grammar = declaration.grammar;
+    const reach = lineReach_walk(grammar, prior);
+    if (reach.pending?.value !== undefined)
+        return value_complete(reach.pending.value, word);
+    const options = optionsInReach_list(grammar, reach.subcommand);
+    if (!reach.optionsEnded && word.startsWith('--') && word.includes('=')) {
+        const name = word.slice(2, word.indexOf('='));
+        const option = options.find((one) => one.long === name);
+        if (option?.value === undefined)
+            return [];
+        const head = word.slice(0, word.indexOf('=') + 1);
+        return (await value_complete(option.value, word.slice(head.length))).map((value) => `${head}${value}`);
+    }
+    if (!reach.optionsEnded && word.startsWith('-') && !NEGATIVE_NUMBER.test(word))
+        return optionNames_complete(options, word);
+    const subcommands = grammar.subcommands;
+    const operands = reach.subcommand?.operands ?? grammar.operands ?? [];
+    const candidates = [];
+    if (subcommands !== undefined && reach.subcommand === null && reach.operands === 0 && !reach.optionsEnded) {
+        candidates.push(...candidates_filter(Object.keys(subcommands), word));
+        if ((grammar.operands ?? []).length === 0)
+            return candidates;
+    }
+    for (const operand of operandsAtPlace_list(operands, reach.operands)) {
+        candidates.push(...await value_complete(operand, word));
+    }
+    return [...new Set(candidates)];
+}
+//# sourceMappingURL=declared.js.map

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

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