@fnndsc/brasa 0.23.2 → 0.25.0

package/dist/core/expansion.js

@@ -0,0 +1,289 @@
+/**
+ * @file What a `${reference}` refers to, for every line the session runs.
+ *
+ * There was more than one answer to this. The dispatcher substituted the
+ * environment after tokenizing (so a single-quoted `$HOME` expanded anyway),
+ * and `play` substituted parameters and session pronouns before tokenizing
+ * (so a gathered path with a space had to be quoted by hand). Two expanders
+ * over one syntax is two sources of truth, and they composed by accident
+ * rather than by design.
+ *
+ * One resolver now answers for all of them, in a fixed order:
+ *
+ * . *Session pronouns*, a closed RESERVED set — the cohort, the feed, the
+ *   run, the query, the place the session stands.
+ * . *Parameters* of the manifest being played, if one is.
+ * . *The environment*.
+ *
+ * A name nothing answers refuses the LINE rather than expanding to nothing
+ * or standing as text: `rm -rf ${DIR}/scratch` with `DIR` unset is how a
+ * script deletes the wrong thing, and this stack does not do silent
+ * workarounds.
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { session } from '../session/index.js';
+import { recentFeed_get, recentQuery_get, recentRunPlace_get, recentRuns_get } from '../session/recent.js';
+import { ANSWER_KINDS, answer_get, answerKind_count, answerRow_get } from '../session/answer.js';
+/** The names the session answers for; a manifest may not take them. */
+export const RESERVED_REFERENCES = new Set([
+    'gather', 'feed', 'run', 'query', 'cwd',
+]);
+/** Whether an unanswerable reference may stand as written: what a dry run does. */
+const standsScope = new AsyncLocalStorage();
+/** Parameters of the manifest being played, if one is. */
+const paramScope = new AsyncLocalStorage();
+/**
+ * Runs work with a manifest's parameters in scope.
+ *
+ * @param params - The parameters, already checked for completeness.
+ * @param operation - The work to run.
+ * @returns The operation's result.
+ */
+export async function paramScope_run(params, operation) {
+    return await paramScope.run(params, operation);
+}
+/**
+ * Runs work in which an unanswerable reference stands as written.
+ *
+ * A dry run has run nothing, so a reference to what an earlier line WOULD
+ * have produced cannot be answered — and refusing there would make a dry run
+ * useless for exactly the manifests that chain, which is most of them.
+ *
+ * @param operation - The work to run.
+ * @returns The operation's result.
+ */
+export async function unresolvedStands_run(operation) {
+    return await standsScope.run(true, operation);
+}
+/**
+ * Whether the work on this async path lets a reference stand unanswered.
+ *
+ * @returns True inside a dry run.
+ */
+export function unresolvedStands_get() {
+    return standsScope.getStore() === true;
+}
+/**
+ * Whether a name is one the session answers for.
+ *
+ * @param name - The reference's name, dots and all.
+ * @returns True when the session owns it.
+ */
+export function reference_isReserved(name) {
+    return RESERVED_REFERENCES.has(name.split('.')[0]);
+}
+/**
+ * What the cohort answers, for the pronoun that names part of it.
+ *
+ * @param name - The reference, such as `gather`, `gather.first.place`.
+ * @returns The values, or null when the cohort cannot answer.
+ */
+async function cohort_reference(name) {
+    // Loaded on demand: the resolver sits under dispatch, and the cohort sits
+    // above it in a builtin.
+    const { cohort_read } = await import('../builtins/res/gather.store.js');
+    const state = await cohort_read();
+    const members = state.series;
+    // A member has two addresses and the difference is load-bearing: where it
+    // was gathered FROM, which `pull` takes, and where it LANDED, which a
+    // viewer and a run take.
+    const wantsPlace = name.endsWith('.place');
+    const stem = wantsPlace ? name.slice(0, -'.place'.length) : name;
+    const addressOf = (member) => {
+        if (!wantsPlace)
+            return member.vfsPath;
+        const landed = member.folderPath;
+        if (typeof landed === 'string' && landed.length > 0)
+            return landed;
+        return member.kind === 'series' ? null : member.vfsPath;
+    };
+    if (stem === 'gather') {
+        const addresses = members.map(addressOf);
+        if (addresses.some((address) => address === null))
+            return null;
+        return { values: addresses };
+    }
+    const which = stem.slice('gather.'.length);
+    if (which === 'size')
+        return { values: [`${members.length}`] };
+    if (which === 'name')
+        return { values: [state.name ?? ''] };
+    const pick = (member) => {
+        if (member === undefined)
+            return null;
+        const address = addressOf(member);
+        return address === null ? null : { values: [address] };
+    };
+    if (which === 'first')
+        return pick(members[0]);
+    if (which === 'last')
+        return pick(members[members.length - 1]);
+    const nth = Number(which);
+    if (Number.isInteger(nth) && nth >= 1 && nth <= members.length)
+        return pick(members[nth - 1]);
+    return null;
+}
+/**
+ * Reads what an index names: `@SER3`, `@STD001`, `@FIL2,3,7`, `@DIR2-4`.
+ *
+ * The kind is written once and the ordinals follow; zero padding is how
+ * the pill draws it, not something the operator must type. A range written
+ * backwards is still a range: the operator meant those rows.
+ *
+ * @param spec - The index without its sigil.
+ * @returns The handles, in the order written, or null when the spec is not
+ *   an index.
+ */
+export function indices_parse(spec) {
+    const match = spec.match(/^([A-Z]{3})(\d+(?:-\d+)?(?:,\d+(?:-\d+)?)*)$/);
+    if (match === null)
+        return null;
+    const kind = match[1];
+    if (!ANSWER_KINDS.includes(kind))
+        return null;
+    const handles = [];
+    for (const part of match[2].split(',')) {
+        const range = part.match(/^(\d+)-(\d+)$/);
+        if (range === null) {
+            handles.push({ kind: kind, ordinal: Number(part) });
+            continue;
+        }
+        const from = Number(range[1]);
+        const to = Number(range[2]);
+        const step = from <= to ? 1 : -1;
+        for (let at = from; step > 0 ? at <= to : at >= to; at += step) {
+            handles.push({ kind: kind, ordinal: at });
+        }
+    }
+    return handles;
+}
+/**
+ * What each verb can be handed, by kind.
+ *
+ * A verb that is given the wrong kind refuses BY NAME at expansion —
+ * "IMAGE takes a series or a folder; STD001 is a study" — rather than
+ * resolving to a path and failing three steps later for a reason that
+ * names nothing the operator typed. A verb not listed takes any kind.
+ */
+const VERB_TAKES = new Map([
+    ['image', ['SER', 'DIR', 'FIL']],
+    ['dcm', ['SER', 'DIR', 'FIL']],
+    ['pull', ['SER', 'STD', 'PAT']],
+    ['cat', ['FIL']],
+    ['cd', ['DIR', 'SER', 'STD']],
+    ['download', ['FIL']],
+]);
+/** The kind a refusal names, in words. */
+const KIND_WORDS = {
+    PAT: 'a patient', STD: 'a study', SER: 'a series', FIL: 'a file', DIR: 'a folder',
+};
+/** The verb the line began with, set by the dispatcher before expansion. */
+let verbInHand = null;
+/**
+ * Tells the resolver which verb the line is for, so an index can be
+ * refused by kind.
+ *
+ * @param verb - The command word, or null between lines.
+ */
+export function verbInHand_set(verb) {
+    verbInHand = verb;
+}
+/** Why the last index was refused, when it was refused by kind. */
+let kindRefusal = null;
+/**
+ * What the rows an index names are worth, as operands.
+ *
+ * @param name - The index, sigil included.
+ * @returns The rows' values, or null when nothing is numbered, a number is
+ *   past the end of its kind, or the verb in hand does not take the kind.
+ */
+function index_resolve(name) {
+    kindRefusal = null;
+    const handles = indices_parse(name.slice(1));
+    if (handles === null || handles.length === 0)
+        return null;
+    const takes = verbInHand === null ? undefined : VERB_TAKES.get(verbInHand);
+    const values = [];
+    for (const handle of handles) {
+        if (takes !== undefined && !takes.includes(handle.kind)) {
+            kindRefusal = `${verbInHand} takes ${takes.map((kind) => KIND_WORDS[kind]).join(' or ')}; `
+                + `${handle.kind}${`${handle.ordinal}`.padStart(3, '0')} is ${KIND_WORDS[handle.kind]}.`;
+            return null;
+        }
+        const row = answerRow_get(handle);
+        if (row === null)
+            return null;
+        values.push(...row.values);
+    }
+    return { values };
+}
+/**
+ * Answers a reference: an index, then the session, then the manifest, then
+ * the environment.
+ *
+ * @param name - The reference's name.
+ * @returns What it refers to, or null when nothing does.
+ */
+export async function reference_resolve(name) {
+    if (name.startsWith('@'))
+        return index_resolve(name);
+    if (name === 'cwd')
+        return { values: [await session.getCWD()] };
+    if (name === 'feed') {
+        const feed = recentFeed_get();
+        return feed === null ? null : { values: [`${feed}`] };
+    }
+    if (name === 'run') {
+        const runs = recentRuns_get();
+        return runs.length === 0 ? null : { values: [`${runs[runs.length - 1]}`] };
+    }
+    if (name === 'run.place') {
+        const place = recentRunPlace_get();
+        return place === null ? null : { values: [place] };
+    }
+    if (name === 'query') {
+        const query = recentQuery_get();
+        return query === null ? null : { values: [query] };
+    }
+    if (name === 'gather' || name.startsWith('gather.'))
+        return await cohort_reference(name);
+    const params = paramScope.getStore();
+    const given = params?.get(name);
+    if (given !== undefined)
+        return { values: [given] };
+    const environment = process.env[name];
+    return environment === undefined ? null : { values: [environment] };
+}
+/**
+ * Says where a reference was looked for, for a refusal an operator can act on.
+ *
+ * @param name - The reference nothing answered.
+ * @returns The refusal's text.
+ */
+export function reference_refusal(name) {
+    const scoped = paramScope.getStore() !== undefined;
+    const places = scoped ? "the session, this manifest's parameters, the environment" : 'the session, the environment';
+    if (name.startsWith('@')) {
+        if (kindRefusal !== null)
+            return `${name}: ${kindRefusal}`;
+        const numbered = answer_get();
+        if (numbered === null)
+            return `${name}: nothing is numbered yet — list something first.`;
+        const handles = indices_parse(name.slice(1));
+        if (handles === null) {
+            return `${name}: an index says what it counts — @SER3, @STD1, @FIL2, @DIR4 — and may list or range them (@SER2,3 or @SER2-5).`;
+        }
+        const kind = handles[0].kind;
+        const count = answerKind_count(kind);
+        return count === 0
+            ? `${name}: the last answer (${numbered.source}) holds no ${KIND_WORDS[kind]} rows.`
+            : `${name}: the last answer (${numbered.source}) holds ${count} ${kind} row${count === 1 ? '' : 's'}.`;
+    }
+    const hint = reference_isReserved(name)
+        ? ` — nothing in this session has one yet`
+        : '';
+    return `\${${name}}: nothing to put there${hint}. Looked in ${places}.`;
+}
+//# sourceMappingURL=expansion.js.map

package/dist/core/expansion.js.map

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

package/dist/core/promptContext.js

@@ -56,10 +56,13 @@ export async function sessionPromptContext_build(options = {}) {
         id: load.feedID, loaded: load.loaded, total: load.total, ...(load.failed !== undefined ? { failed: load.failed } : {}),
     }));
     const arrived = procCache_get().arrivals_recent();
+    // Feeds whose topology just landed, each with its shape: the space of
+    // everything run here, materialising on a surface as the index reads it.
+    const landed = procCache_get().topologyLanded_recent();
     const roster = procCache_get().rosterSync_get();
     const sweeping = warmupRaw.active || lifecycle.state === 'reconciling' || lifecycle.state === 'failed';
     const warmupFailures = warmupFailures_list();
-    const procWarmup = sweeping || feedLoad !== null || arrived.length > 0 || roster !== null
+    const procWarmup = sweeping || feedLoad !== null || arrived.length > 0 || landed.length > 0 || roster !== null
         ? {
             loaded: warmupRaw.loaded,
             total: warmupRaw.total,
@@ -68,6 +71,7 @@ export async function sessionPromptContext_build(options = {}) {
             sweeping,
             ...(feedLoad !== null ? { feed: feeds[0], feeds } : {}),
             ...(arrived.length > 0 ? { arrived } : {}),
+            ...(landed.length > 0 ? { landed } : {}),
             ...(roster !== null ? { roster } : {}),
         }
         : undefined;

package/dist/core/promptContext.js.map

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

package/dist/lib/duration.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file How the language reads a duration.
+ *
+ * `expect --within` and `play --pace` are the same notion of time, so they
+ * read it with the same function: a second parser beside this one is a
+ * second set of durations that mean something slightly else, and a manifest
+ * that says `20m` in two places must mean twenty minutes in both.
+ *
+ * @module
+ */
+/**
+ * Reads a duration the way an operator writes one.
+ *
+ * @param text - A duration such as `30s`, `20m`, `2h`, `250ms`, or bare seconds.
+ * @returns Milliseconds, or null when the text is not a duration.
+ */
+export declare function duration_parse(text: string): number | null;

package/dist/lib/duration.js

@@ -0,0 +1,25 @@
+/**
+ * @file How the language reads a duration.
+ *
+ * `expect --within` and `play --pace` are the same notion of time, so they
+ * read it with the same function: a second parser beside this one is a
+ * second set of durations that mean something slightly else, and a manifest
+ * that says `20m` in two places must mean twenty minutes in both.
+ *
+ * @module
+ */
+/** How long each unit lasts, in milliseconds. */
+const UNIT_MS = { ms: 1, s: 1000, m: 60000, h: 3600000 };
+/**
+ * Reads a duration the way an operator writes one.
+ *
+ * @param text - A duration such as `30s`, `20m`, `2h`, `250ms`, or bare seconds.
+ * @returns Milliseconds, or null when the text is not a duration.
+ */
+export function duration_parse(text) {
+    const match = text.trim().match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
+    if (match === null)
+        return null;
+    return Number(match[1]) * UNIT_MS[match[2] ?? 's'];
+}
+//# sourceMappingURL=duration.js.map

package/dist/lib/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/lib/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iDAAiD;AACjD,MAAM,OAAO,GAA2B,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACzF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/lib/parser.d.ts

@@ -5,12 +5,32 @@
  * backslash escapes. Quotes are stripped from rendered values, but their
  * pathname-expansion meaning is retained.
  */
+/**
+ * One piece of a word: literal text, or a reference the line asked for.
+ *
+ * The tokenizer records references rather than resolving them, because
+ * resolving is asynchronous (a pronoun asks the session) and tokenizing is
+ * not. What it must record is the QUOTING, since that is known only here:
+ * inside single quotes a `$` is text, inside double quotes a reference is
+ * one operand however many values it carries, and bare it may become
+ * several — the shell's rule, which the stack claims to wear.
+ */
+export interface ShellSegment {
+    /** Literal text, when this piece is text. */
+    text: string;
+    /** The reference's name, when this piece is one. */
+    ref: string | null;
+    /** Whether the reference stood inside double quotes. */
+    quoted: boolean;
+}
 /** A rendered shell word and the glob pattern it may contribute. */
 export interface ShellWord {
     value: string;
     globPattern: string;
     pathnameExpansion: boolean;
     pathnameExpanded: boolean;
+    /** The word's pieces, when it holds a reference; absent when it is plain text. */
+    segments?: ShellSegment[];
 }
 /** String arguments with per-operand pathname-expansion provenance. */
 export type ShellArguments = string[] & {
@@ -84,3 +104,33 @@ export declare function shellWords_tokenize(line: string): ShellWord[];
  * @returns Array of tokens with quotes removed.
  */
 export declare function args_tokenize(line: string): string[];
+/** What a reference turned out to be. */
+export type ReferenceValue = {
+    values: string[];
+} | null;
+/** Answers what a reference refers to, or null when nothing does. */
+export type ReferenceResolver = (name: string) => Promise<ReferenceValue>;
+/** How reference expansion went. */
+export type ReferenceExpansion = {
+    ok: true;
+    words: ShellWord[];
+} | {
+    ok: false;
+    missing: string;
+};
+/**
+ * Resolves the references in a line's words, respecting how they were quoted.
+ *
+ * The shell's rule, kept: a bare reference carrying several values becomes
+ * several operands, a double-quoted one stays a single operand however many
+ * values it holds, and a single-quoted `$` never got here at all. An
+ * expanded value never globs afterwards — a filename with a bracket in it is
+ * a filename, not a pattern.
+ *
+ * @param words - The tokenized words.
+ * @param resolve - Answers what a reference refers to.
+ * @param unresolvedStands - Leave an unanswerable reference as written
+ *   instead of refusing: what a dry run does, having run nothing.
+ * @returns The expanded words, or the reference nothing could answer.
+ */
+export declare function shellWords_referencesExpand(words: readonly ShellWord[], resolve: ReferenceResolver, unresolvedStands?: boolean): Promise<ReferenceExpansion>;

package/dist/lib/parser.js

@@ -5,6 +5,23 @@
  * backslash escapes. Quotes are stripped from rendered values, but their
  * pathname-expansion meaning is retained.
  */
+/**
+ * What a reference looks like: `${name}` or a bare `$NAME`.
+ *
+ * A braced name may carry dots, which is how a session pronoun names part
+ * of what it refers to (`${gather.first.place}`); a bare one may not, so
+ * `$HOME.txt` keeps its extension.
+ */
+const REFERENCE_PATTERN = /^\$(?:\{([A-Za-z_][A-Za-z0-9_.]*)\}|([A-Za-z_][A-Za-z0-9_]*))/;
+/**
+ * What an index looks like: `@SER3`, `@STD001`, `@FIL2,3,7`, `@DIR2-4`.
+ *
+ * A row of the session's last answer, named by the handle the listing shows
+ * beside it — the KIND it counts, then its place in that kind's sequence.
+ * The sigil keeps it unambiguous: a directory called `SER3` is a path, and
+ * `@SER3` never is.
+ */
+const INDEX_PATTERN = /^@([A-Z]{3}\d+(?:-\d+)?(?:,\d+(?:-\d+)?)*)/;
 /** Escapes wildcard metacharacters for literal minimatch use. */
 function globLiteral_escape(value) {
     return value.replace(/[\\*?\[\]]/g, '\\$&');
@@ -132,25 +149,49 @@ export function shellWords_tokenize(line) {
     let inSingle = false;
     let inDouble = false;
     let escapeNext = false;
+    let segments = [];
+    let pendingText = '';
+    const text_flush = () => {
+        if (pendingText.length === 0)
+            return;
+        segments.push({ text: pendingText, ref: null, quoted: false });
+        pendingText = '';
+    };
     const character_append = (char, literal) => {
         currentValue += char;
         currentPattern += literal ? globLiteral_escape(char) : char;
         pathnameExpansion ||= !literal && /[*?[\]]/.test(char);
+        pendingText += char;
+        wordStarted = true;
+    };
+    const reference_append = (name, raw, quoted) => {
+        text_flush();
+        segments.push({ text: '', ref: name, quoted });
+        // The value keeps the reference as written: every reader that does not
+        // resolve references (completion, help, the tests) sees the line as the
+        // operator typed it.
+        currentValue += raw;
+        currentPattern += globLiteral_escape(raw);
         wordStarted = true;
     };
     const word_pushCurrent = () => {
         if (!wordStarted)
             return;
+        text_flush();
+        const held = segments;
         tokens.push({
             value: currentValue,
             globPattern: currentPattern,
             pathnameExpansion,
             pathnameExpanded: false,
+            ...(held.some((segment) => segment.ref !== null) ? { segments: held } : {}),
         });
         currentValue = '';
         currentPattern = '';
         pathnameExpansion = false;
         wordStarted = false;
+        segments = [];
+        pendingText = '';
     };
     for (let i = 0; i < line.length; i++) {
         const char = line[i];
@@ -178,6 +219,29 @@ export function shellWords_tokenize(line) {
             word_pushCurrent();
             continue;
         }
+        // An index into the session's last answer, unless it stands in quotes.
+        // Only at the START of a word: `user@host` is not an index, and neither
+        // is an email address in a tag value.
+        if (char === '@' && !inSingle && !inDouble && !wordStarted) {
+            const rest = line.slice(i);
+            const match = rest.match(INDEX_PATTERN);
+            if (match !== null) {
+                reference_append(`@${match[1]}`, match[0], false);
+                i += match[0].length - 1;
+                continue;
+            }
+        }
+        // A reference, unless it stands in single quotes, where a `$` is text —
+        // which is what makes a quoted DICOM value or a literal price safe.
+        if (char === '$' && !inSingle) {
+            const rest = line.slice(i);
+            const match = rest.match(REFERENCE_PATTERN);
+            if (match !== null) {
+                reference_append(match[1] ?? match[2], match[0], inDouble);
+                i += match[0].length - 1;
+                continue;
+            }
+        }
         character_append(char, inSingle || inDouble);
     }
     word_pushCurrent();
@@ -192,4 +256,59 @@ export function shellWords_tokenize(line) {
 export function args_tokenize(line) {
     return shellWords_tokenize(line).map((word) => word.value);
 }
+/**
+ * Resolves the references in a line's words, respecting how they were quoted.
+ *
+ * The shell's rule, kept: a bare reference carrying several values becomes
+ * several operands, a double-quoted one stays a single operand however many
+ * values it holds, and a single-quoted `$` never got here at all. An
+ * expanded value never globs afterwards — a filename with a bracket in it is
+ * a filename, not a pattern.
+ *
+ * @param words - The tokenized words.
+ * @param resolve - Answers what a reference refers to.
+ * @param unresolvedStands - Leave an unanswerable reference as written
+ *   instead of refusing: what a dry run does, having run nothing.
+ * @returns The expanded words, or the reference nothing could answer.
+ */
+export async function shellWords_referencesExpand(words, resolve, unresolvedStands = false) {
+    const expanded = [];
+    for (const word of words) {
+        const segments = word.segments;
+        if (segments === undefined) {
+            expanded.push(word);
+            continue;
+        }
+        // A word that is nothing but one bare reference is the list case: it may
+        // leave as several operands. Anything else joins into one word.
+        const lone = segments.length === 1 && segments[0].ref !== null && !segments[0].quoted;
+        let rendered = '';
+        let split = null;
+        for (const segment of segments) {
+            if (segment.ref === null) {
+                rendered += segment.text;
+                continue;
+            }
+            const held = await resolve(segment.ref);
+            if (held === null) {
+                if (!unresolvedStands)
+                    return { ok: false, missing: segment.ref };
+                rendered += `\${${segment.ref}}`;
+                continue;
+            }
+            if (lone && held.values.length !== 1) {
+                split = held.values;
+                continue;
+            }
+            rendered += held.values.join(' ');
+        }
+        if (split !== null) {
+            for (const value of split)
+                expanded.push(shellWord_literal(value));
+            continue;
+        }
+        expanded.push(shellWord_literal(rendered));
+    }
+    return { ok: true, words: expanded };
+}
 //# sourceMappingURL=parser.js.map

package/dist/lib/parser.js.map

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