@poe-platform/safe-bash 0.1.0

package/dist/safe-bash/shell/shell.d.ts

@@ -0,0 +1,15 @@
+import { CommandRegistry } from "../contracts/index.js";
+import type { CommandDefinition, FileSystemFactory, Middleware, PluginHost, RegisterCommandOptions, VirtualShellPlugin } from "../contracts/index.js";
+import type { ShellExecOptions, ShellOptions, ShellResult } from "./types.js";
+export declare class Shell implements PluginHost {
+    #private;
+    readonly commands: CommandRegistry;
+    constructor(options: ShellOptions);
+    use(middleware: Middleware | VirtualShellPlugin): this;
+    register(command: CommandDefinition, options?: RegisterCommandOptions): this;
+    registerFileSystem(scheme: string, factory: FileSystemFactory): void;
+    createFileSystem(scheme: string, options?: Readonly<Record<string, unknown>>): Promise<Awaited<ReturnType<FileSystemFactory>>>;
+    exec(source: string, options?: ShellExecOptions): Promise<ShellResult>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=shell.d.ts.map

package/dist/safe-bash/shell/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/shell/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwC,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EACA,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EACtE,sBAAsB,EAAE,kBAAkB,EAC3C,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+E9E,qBAAa,KAAM,YAAW,UAAU;;IACtC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;gBAUvB,OAAO,EAAE,YAAY;IAOjC,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,kBAAkB,GAAG,IAAI;IA6BtD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAM5E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAW9D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAQlI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgJhF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BzB"}

package/dist/safe-bash/shell/shell.js

@@ -0,0 +1,355 @@
+import { CommandRegistry, resolvePath, toByteSource, writeText } from "../contracts/index.js";
+import { parseShellUnit } from "./parser.js";
+import { ShellInput } from "./input.js";
+import { byteLocale } from "./locale.js";
+import { Budget, Capture, interruptible, resolveLimits, Runtime, RuntimeCancellationState } from "./runtime.js";
+import { ShellLimitError, ShellSyntaxError } from "./types.js";
+import { InvocationScope, invocationScope, throwCleanupFailures } from "./cleanup.js";
+import { createRootCancellationLink, selectRuntimeCancellationOutcome, subscribeCancellation, } from "./cancellation.js";
+class RootInvocationCancellationOwner {
+    scope;
+    finalized;
+    #resolveFinalized;
+    #admissionOpen = true;
+    #boundary;
+    #observedOrigin;
+    #captureCancellation;
+    #detach;
+    #finished = false;
+    constructor(scope) {
+        this.scope = scope;
+        this.finalized = new Promise(resolve => { this.#resolveFinalized = resolve; });
+        scope.register(() => { this.#admissionOpen = false; });
+    }
+    activate(boundary) {
+        if (!this.#admissionOpen)
+            throw new Error("Root cancellation admission is closed");
+        this.#boundary = boundary;
+        this.#detach = subscribeCancellation(boundary, origin => { this.#captureCancellation?.(origin); });
+    }
+    assertAdmissionOpen() {
+        if (!this.#admissionOpen)
+            throw new Error("Root cancellation admission is closed");
+    }
+    capture(execute) {
+        return new Promise(resolve => {
+            let settled = false;
+            let raw;
+            let queuedOrigin = false;
+            const settle = (captured) => {
+                if (settled)
+                    return;
+                settled = true;
+                this.#captureCancellation = undefined;
+                resolve(captured);
+            };
+            this.#captureCancellation = origin => {
+                if (settled || queuedOrigin)
+                    return;
+                queuedOrigin = true;
+                queueMicrotask(() => {
+                    if (settled)
+                        return;
+                    this.#observedOrigin = origin;
+                    settle({ kind: "throw", reason: origin.signal.reason });
+                    void raw?.catch(() => undefined);
+                });
+            };
+            try {
+                raw = Promise.resolve(execute());
+            }
+            catch (reason) {
+                settle({ kind: "throw", reason });
+                return;
+            }
+            void raw.then(value => settle({ kind: "return", value }), reason => settle({ kind: "throw", reason }));
+            if (settled)
+                void raw.catch(() => undefined);
+        });
+    }
+    finish(captured) {
+        if (this.#finished)
+            throw new Error("Root cancellation was already finalized");
+        this.#finished = true;
+        this.#admissionOpen = false;
+        try {
+            try {
+                this.#detach?.();
+            }
+            catch (error) {
+                this.scope.failures.push(error);
+            }
+            this.#detach = undefined;
+            const close = this.#boundary.close();
+            this.scope.failures.push(...close.failures);
+            return selectRuntimeCancellationOutcome(this.#boundary, captured, this.#observedOrigin);
+        }
+        finally {
+            this.#resolveFinalized();
+        }
+    }
+}
+export class Shell {
+    commands;
+    #middleware = [];
+    #filesystems = new Map();
+    #plugins = [];
+    #options;
+    #ready = Promise.resolve();
+    #disposed = false;
+    #disposal;
+    #active = new Set();
+    constructor(options) {
+        if (!options?.fs)
+            throw new TypeError("Shell requires an explicit filesystem");
+        resolveLimits(options.limits);
+        this.#options = { ...options, cwd: resolvePath("/", options.cwd ?? "/"), env: { ...options.env }, limits: { ...options.limits } };
+        this.commands = options.commands ?? new CommandRegistry();
+    }
+    use(middleware) {
+        if (this.#disposed)
+            throw new Error("Shell is disposed");
+        this.#install(middleware);
+        return this;
+    }
+    #install(middleware) {
+        if (typeof middleware === "function")
+            this.#middleware.push(middleware);
+        else {
+            if (!middleware || typeof middleware.setup !== "function")
+                throw new TypeError("Expected middleware or shell plugin");
+            this.#ready = this.#ready.then(async () => {
+                let active = true;
+                const admit = () => {
+                    if (this.#disposed && !active)
+                        throw new Error("Shell is disposed");
+                };
+                const host = {
+                    commands: this.commands,
+                    use: (middleware) => { admit(); this.#install(middleware); },
+                    registerFileSystem: (scheme, factory) => { admit(); this.#registerFileSystem(scheme, factory); },
+                };
+                try {
+                    await middleware.setup(host);
+                    this.#plugins.push(middleware);
+                }
+                finally {
+                    active = false;
+                }
+            });
+            void this.#ready.catch(() => undefined);
+        }
+    }
+    register(command, options) {
+        if (this.#disposed)
+            throw new Error("Shell is disposed");
+        this.commands.register(command, options);
+        return this;
+    }
+    registerFileSystem(scheme, factory) {
+        if (this.#disposed)
+            throw new Error("Shell is disposed");
+        this.#registerFileSystem(scheme, factory);
+    }
+    #registerFileSystem(scheme, factory) {
+        if (!/^[a-z][a-z0-9+.-]*$/u.test(scheme))
+            throw new TypeError("Invalid filesystem scheme");
+        if (this.#filesystems.has(scheme))
+            throw new Error(`Filesystem already registered: ${scheme}`);
+        this.#filesystems.set(scheme, factory);
+    }
+    async createFileSystem(scheme, options = {}) {
+        if (this.#disposed)
+            throw new Error("Shell is disposed");
+        await this.#ready;
+        const factory = this.#filesystems.get(scheme);
+        if (!factory)
+            throw new Error(`Unknown filesystem scheme: ${scheme}`);
+        return factory(options);
+    }
+    async exec(source, options = {}) {
+        if (this.#disposed)
+            throw new Error("Shell is disposed");
+        const budget = new Budget(resolveLimits(this.#options.limits, options.limits), options.signal);
+        const scope = new InvocationScope(options.signal);
+        const cancellationState = new RuntimeCancellationState();
+        const owner = new RootInvocationCancellationOwner(scope);
+        const boundary = createRootCancellationLink({
+            admission: Runtime.rootCancellationAdmission(budget),
+            callerSignal: options.signal,
+            controls: [{ role: "budget-control", signal: budget.controller.signal }],
+        });
+        try {
+            Runtime.registerEreRoot(budget, scope);
+            owner.activate(boundary);
+        }
+        catch (error) {
+            scope.failures.push(...boundary.close().failures);
+            await scope.close();
+            cancellationState.close();
+            throw error;
+        }
+        const active = { scope, budget, owner };
+        this.#active.add(active);
+        let captured;
+        try {
+            captured = await owner.capture(() => this.#execute(source, options, scope, budget, boundary, cancellationState, owner));
+        }
+        finally {
+            await scope.close();
+        }
+        const selection = owner.finish(captured);
+        cancellationState.close();
+        this.#active.delete(active);
+        if (selection.outcome.kind === "throw")
+            throw selection.outcome.reason;
+        throwCleanupFailures(scope.failures);
+        return selection.outcome.value;
+    }
+    async #execute(source, options, scope, budget, cancellation, cancellationState, owner) {
+        if (typeof source !== "string")
+            throw new TypeError("Shell source must be a string");
+        if (Buffer.byteLength(source) > budget.limits.maxSourceBytes)
+            throw new ShellLimitError("maxSourceBytes");
+        budget.source(Buffer.byteLength(source));
+        budget.signal.throwIfAborted();
+        const stdout = new Capture();
+        const stderr = new Capture();
+        const sink = (capture, external) => budget.sink({
+            ...(external?.ownedOutput ? { ownedOutput: {
+                    consumerClosed: external.ownedOutput.consumerClosed,
+                    write: async (chunk) => {
+                        await capture.write(chunk);
+                        await external.ownedOutput.write(chunk);
+                    },
+                } } : {}),
+            write: async (chunk) => {
+                await capture.write(chunk);
+                if (external)
+                    await external.write(chunk);
+            },
+        });
+        let stdin;
+        const io = {
+            [invocationScope]: scope,
+            stdin: toByteSource(""),
+            stdinIsDefault: options.stdin === undefined,
+            stdout: sink(stdout, options.stdout), stderr: sink(stderr, options.stderr),
+        };
+        let exitCode;
+        let failed = false;
+        try {
+            try {
+                let unit = parseShellUnit(source, 0, byteLocale({ ...this.#options.env, ...options.env }));
+                stdin = new ShellInput(typeof options.stdin === "string" || options.stdin instanceof Uint8Array ? toByteSource(options.stdin) : options.stdin ?? toByteSource(""), budget);
+                io.stdin = stdin;
+                await interruptible(this.#ready, budget.signal);
+                const cwd = resolvePath("/", options.cwd ?? this.#options.cwd ?? "/");
+                const variables = Object.assign(Object.create(null), this.#options.env, options.env, { PWD: cwd });
+                for (const [name, value] of Object.entries(variables)) {
+                    if (name.includes("\0") || name.includes("=") || typeof value !== "string" || value.includes("\0"))
+                        throw new TypeError("Invalid environment entry");
+                }
+                const exported = new Set(Object.keys(variables));
+                variables.OPTIND = "1";
+                variables.OPTERR = "1";
+                const state = {
+                    cwd, variables, exported, functions: new Map(), positional: [], getopts: { cursor: { index: 0 }, integer: true },
+                    directoryStack: { entries: [], bytes: 0 },
+                    dotglob: false,
+                    status: 0, substitutionStatus: 0, depth: 0, loopDepth: 0, functionDepth: 0, locals: [], pipefail: false, profile: "bash",
+                };
+                const admission = Runtime.rootCancellationAdmission(budget);
+                const runtime = new Runtime(options.fs ?? this.#options.fs, this.commands, [...this.#middleware], budget, AbortSignal.any([cancellation.deliverySignal, scope.signal]), undefined, undefined, cancellation.deliverySignal, cancellation, cancellationState, owner, 0, admission.maxDepth);
+                exitCode = 0;
+                while (true) {
+                    for (const warning of unit.script.warnings ?? [])
+                        await writeText(io.stderr, `shell: warning: ${warning}\n`);
+                    if (unit.script.lists.length) {
+                        const result = await interruptible(runtime.runUnit(unit.script, state, io), budget.signal);
+                        exitCode = result.exitCode;
+                        if (result.terminated)
+                            break;
+                    }
+                    if (unit.next >= source.length)
+                        break;
+                    budget.signal.throwIfAborted();
+                    unit = parseShellUnit(source, unit.next, byteLocale(state.variables));
+                }
+            }
+            catch (error) {
+                if (!(error instanceof ShellSyntaxError))
+                    throw error;
+                const line = source.slice(0, error.offset).split("\n").length;
+                if (error.unclosedQuote) {
+                    await writeText(io.stderr, `shell: -c: line ${error.unclosedQuote.line}: unexpected EOF while looking for matching \`${error.unclosedQuote.quote}'\n`);
+                }
+                else if (error.exitCode === 127) {
+                    const token = /^[;&|()<>]|^[^\s;&|()<>]+/u.exec(source.slice(error.offset))?.[0] ?? "newline";
+                    await writeText(io.stderr, `shell: -c: line ${line}: syntax error near unexpected token \`${token}'\nshell: -c: line ${line}: \`${source.split("\n")[line - 1] ?? ""}'\n`);
+                }
+                else if (error.offset >= source.length && !/Unterminated|nesting|Unsupported/u.test(error.reason)) {
+                    const context = error.incompleteCommand ? ` from \`${error.incompleteCommand.name}' command on line ${error.incompleteCommand.line}` : "";
+                    await writeText(io.stderr, `shell: -c: line ${source.split("\n").length + Number(!source.endsWith("\n"))}: syntax error: unexpected end of file${context}\n`);
+                }
+                else
+                    await writeText(io.stderr, `shell: ${error.message}\n`);
+                exitCode = error.exitCode;
+            }
+        }
+        catch (error) {
+            failed = true;
+            throw error;
+        }
+        finally {
+            if (failed)
+                await stdin?.close().catch(() => { });
+            else
+                await stdin?.close();
+        }
+        const stdoutBytes = stdout.bytes();
+        const stderrBytes = stderr.bytes();
+        return {
+            stdout: new TextDecoder("utf-8", { ignoreBOM: true }).decode(stdoutBytes),
+            stderr: new TextDecoder("utf-8", { ignoreBOM: true }).decode(stderrBytes),
+            stdoutBytes, stderrBytes, exitCode,
+        };
+    }
+    dispose() {
+        if (this.#disposal)
+            return this.#disposal;
+        this.#disposed = true;
+        const active = [...this.#active];
+        const drains = [];
+        this.#disposal = Promise.resolve().then(() => this.#dispose(active, drains));
+        for (const { scope, budget } of active) {
+            const drain = scope.close();
+            budget.controller.abort(new Error("Shell is disposed"));
+            drains.push(drain);
+        }
+        return this.#disposal;
+    }
+    async #dispose(active, drains) {
+        await Promise.all(drains);
+        await Promise.all(active.map(({ owner }) => owner.finalized));
+        let ready;
+        do {
+            ready = this.#ready;
+            await ready.catch(() => undefined);
+        } while (ready !== this.#ready);
+        const failures = [];
+        for (const plugin of [...this.#plugins].reverse()) {
+            try {
+                await plugin.dispose?.();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        const cleanupFailures = active.flatMap(({ scope }) => scope.failures);
+        if (failures.length)
+            throw new AggregateError([...cleanupFailures, ...failures], "Plugin disposal failed");
+        throwCleanupFailures(cleanupFailures);
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/safe-bash/shell/shell.js.map

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

package/dist/safe-bash/shell/types.d.ts

@@ -0,0 +1,76 @@
+import type { ByteSink, ByteSource, CommandContext, CommandRegistry, CommandResult, FileSystem } from "../contracts/index.js";
+import type { CommandArguments } from "../contracts/command.js";
+export interface ShellInvokeOptions {
+    readonly argumentValues?: CommandArguments;
+    readonly signal?: AbortSignal | undefined;
+    readonly stdin?: ByteSource;
+    readonly stdinIsDefault?: boolean;
+    readonly stdout?: ByteSink;
+    readonly stderr?: ByteSink;
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly replaceEnv?: boolean;
+}
+export interface ShellCommandContext extends CommandContext {
+    readonly invoke: (command: string, args: readonly string[], options?: ShellInvokeOptions) => Promise<CommandResult>;
+}
+export interface ShellLimits {
+    readonly maxInputBytes?: number;
+    readonly maxOutputBytes?: number;
+    readonly maxCommands?: number;
+    readonly maxLoopIterations?: number;
+    readonly maxSubstitutionDepth?: number;
+    readonly maxSourceBytes?: number;
+    readonly maxExpansionFields?: number;
+    readonly maxExpansionBytes?: number;
+    readonly pipeHighWaterMark?: number;
+}
+export interface ShellOptions {
+    readonly fs: FileSystem;
+    readonly commands?: CommandRegistry;
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly limits?: ShellLimits;
+}
+export interface ShellExecOptions {
+    readonly fs?: FileSystem;
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly stdin?: string | Uint8Array | ByteSource;
+    readonly stdout?: ByteSink;
+    readonly stderr?: ByteSink;
+    readonly signal?: AbortSignal;
+    readonly limits?: ShellLimits;
+}
+export interface ShellResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly stdoutBytes: Uint8Array;
+    readonly stderrBytes: Uint8Array;
+    readonly exitCode: number;
+}
+export declare class ShellSyntaxError extends SyntaxError {
+    readonly reason: string;
+    readonly offset: number;
+    readonly exitCode: number;
+    readonly incompleteCommand?: {
+        name: string;
+        line: number;
+    } | undefined;
+    readonly unclosedQuote?: {
+        quote: string;
+        line: number;
+    } | undefined;
+    constructor(reason: string, offset: number, exitCode?: number, incompleteCommand?: {
+        name: string;
+        line: number;
+    } | undefined, unclosedQuote?: {
+        quote: string;
+        line: number;
+    } | undefined);
+}
+export declare class ShellLimitError extends Error {
+    readonly limit: keyof ShellLimits;
+    constructor(limit: keyof ShellLimits);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/safe-bash/shell/types.d.ts.map

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

package/dist/safe-bash/shell/types.js

@@ -0,0 +1,25 @@
+export class ShellSyntaxError extends SyntaxError {
+    reason;
+    offset;
+    exitCode;
+    incompleteCommand;
+    unclosedQuote;
+    constructor(reason, offset, exitCode = 2, incompleteCommand, unclosedQuote) {
+        super(`${reason} at offset ${offset}`);
+        this.reason = reason;
+        this.offset = offset;
+        this.exitCode = exitCode;
+        this.incompleteCommand = incompleteCommand;
+        this.unclosedQuote = unclosedQuote;
+        this.name = "ShellSyntaxError";
+    }
+}
+export class ShellLimitError extends Error {
+    limit;
+    constructor(limit) {
+        super(`Shell limit exceeded: ${limit}`);
+        this.limit = limit;
+        this.name = "ShellLimitError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/safe-bash/shell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shell/types.ts"],"names":[],"mappings":"AA0DA,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC1B;IAAyB;IAAyB;IAAuB;IAA6D;IAA3J,YAAqB,MAAc,EAAW,MAAc,EAAW,WAAW,CAAC,EAAW,iBAAkD,EAAW,aAA+C;QACxM,KAAK,CAAC,GAAG,MAAM,cAAc,MAAM,EAAE,CAAC,CAAC;QADpB,WAAM,GAAN,MAAM,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAI;QAAW,sBAAiB,GAAjB,iBAAiB,CAAiC;QAAW,kBAAa,GAAb,aAAa,CAAkC;QAExM,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACnB;IAArB,YAAqB,KAAwB;QAC3C,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;QADrB,UAAK,GAAL,KAAK,CAAmB;QAE3C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/safe-bash/shell/value-state.d.ts

@@ -0,0 +1,57 @@
+import type { ByteShellValue, ShellValue, ValueAllocation, ValueReservation } from "../contracts/value.js";
+interface AllocationRecord {
+    readonly bytes: number;
+    readonly slots: number;
+    references: number;
+    object?: object;
+}
+export interface HeldValue {
+    readonly value: ShellValue;
+    release(): void;
+}
+export declare class ValueArena {
+    #private;
+    readonly maximumBytes: number;
+    readonly maximumSlots: number;
+    readonly checkpoint: () => void;
+    readonly fail: (limit: "maxExpansionBytes" | "maxExpansionFields") => never;
+    constructor(maximumBytes: number, maximumSlots: number, checkpoint: () => void, fail?: (limit: "maxExpansionBytes" | "maxExpansionFields") => never);
+    get usage(): {
+        bytes: number;
+        slots: number;
+    };
+    assertOpen(): void;
+    assertRetained(): void;
+    scope(): ValueScope;
+    allocate(bytes: number, slots: number): AllocationRecord;
+    commit(record: AllocationRecord, object: object): void;
+    release(record: AllocationRecord): void;
+    hold(value: ByteShellValue): HeldValue;
+    close(): void;
+}
+export declare class ValueScope implements ValueAllocation {
+    #private;
+    readonly arena: ValueArena;
+    constructor(arena: ValueArena);
+    assertOpen(): void;
+    reserve(bytes: number, slots: number): ValueReservation;
+    hold(value: ShellValue): HeldValue;
+    prepareTransfer(held: HeldValue, destination: ValueScope): () => void;
+    close(): void;
+}
+export declare class ValueStore {
+    #private;
+    readonly arena: ValueArena;
+    readonly scope: ValueScope;
+    constructor(arena: ValueArena);
+    get(name: string, text: string): ShellValue;
+    publish(name: string, value: ShellValue, action: () => boolean): boolean;
+    invalidate(name?: string): void;
+    clone(): ValueStore;
+    replace(entries: Iterable<readonly [string, ShellValue]>, action: () => void): void;
+    restore(source: ValueStore, action: () => void): void;
+    restoreHeld(name: string, held: HeldValue, action: () => void): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=value-state.d.ts.map

package/dist/safe-bash/shell/value-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-state.d.ts","sourceRoot":"","sources":["../../src/shell/value-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG3G,UAAU,gBAAgB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,UAAU;;IAOT,QAAQ,CAAC,YAAY,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,KAAK,KAAK;gBAAjK,YAAY,EAAE,MAAM,EAAW,YAAY,EAAE,MAAM,EAAW,UAAU,EAAE,MAAM,IAAI,EAAW,IAAI,GAAE,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,KAAK,KAAsD;IAEvO,IAAI,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAuD;IAEpG,UAAU,IAAI,IAAI;IAKlB,cAAc,IAAI,IAAI;IAItB,KAAK,IAAI,UAAU;IAEnB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAYxD,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtD,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IASvC,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS;IAsBtC,KAAK,IAAI,IAAI;CAOd;AAED,qBAAa,UAAW,YAAW,eAAe;;IAMpC,QAAQ,CAAC,KAAK,EAAE,UAAU;gBAAjB,KAAK,EAAE,UAAU;IAEtC,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAevD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAiBlC,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,GAAG,MAAM,IAAI;IAkBrE,KAAK,IAAI,IAAI;CAMd;AAED,qBAAa,UAAU;;IAIT,QAAQ,CAAC,KAAK,EAAE,UAAU;IAFtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;gBAEN,KAAK,EAAE,UAAU;IAEtC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAE3C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,GAAG,OAAO;IAUxE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAU/B,KAAK,IAAI,UAAU;IAQnB,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAmBnF,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAYrD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAQpE,KAAK,IAAI,IAAI;CACd"}