@poe-platform/safe-bash 0.1.0

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

@@ -0,0 +1,156 @@
+import { prepareArithmetic } from "./arithmetic.js";
+function digit(source, position) {
+    const code = source.charCodeAt(position);
+    return code >= 48 && code <= 57;
+}
+function positionalTemplate(source, checkpoint) {
+    let found = false;
+    let nextCheckpoint = 0;
+    for (let position = 0; position < source.length;) {
+        if (position >= nextCheckpoint) {
+            checkpoint();
+            nextCheckpoint = position + 128;
+        }
+        const character = source[position];
+        if (character === "\\" || character === "'" || character === '"' || character === "`")
+            return false;
+        if (character !== "$") {
+            position++;
+            continue;
+        }
+        position++;
+        if (digit(source, position)) {
+            found = true;
+            position++;
+            continue;
+        }
+        if (source[position] !== "{")
+            return false;
+        const start = ++position;
+        while (digit(source, position)) {
+            if (position >= nextCheckpoint) {
+                checkpoint();
+                nextCheckpoint = position + 128;
+            }
+            position++;
+        }
+        if (position === start || source[position] !== "}")
+            return false;
+        found = true;
+        position++;
+    }
+    return found;
+}
+function positionalValue(name, options) {
+    let index = 0;
+    let outside = false;
+    for (let position = 0; position < name.length; position++) {
+        if (position % 128 === 0)
+            options.checkpoint();
+        const next = name.charCodeAt(position) - 48;
+        if (index > Math.floor((options.positional.length - next) / 10))
+            outside = true;
+        if (!outside)
+            index = index * 10 + next;
+    }
+    return outside ? undefined : index === 0 ? options.arg0 : options.positional[index - 1];
+}
+export function evaluatePositionalArithmetic(program, options, evaluate) {
+    const source = program.source;
+    if (!source.includes("$"))
+        return evaluate(program);
+    options.checkpoint();
+    if (!positionalTemplate(source, options.checkpoint))
+        return evaluate(program);
+    const header = options.owner?.reserve({ metadata: 128, allocatedSlots: 2, work: source.length * 2 + 8 });
+    const admissions = [];
+    const chunks = [];
+    let bytes = 0;
+    const reserve = (payload) => {
+        const admission = options.owner?.reserve({ payload, metadata: 64, allocatedSlots: 2, work: 4 });
+        if (admission)
+            admissions.push(admission);
+    };
+    const length = (text, start, end, maximum) => {
+        let size = 0;
+        let nextCheckpoint = start;
+        for (let position = start; position < end;) {
+            if (position >= nextCheckpoint) {
+                options.checkpoint();
+                nextCheckpoint = position + 128;
+            }
+            const code = text.charCodeAt(position++);
+            if (code <= 0x7f)
+                size++;
+            else if (code <= 0x7ff)
+                size += 2;
+            else if (code >= 0xd800 && code <= 0xdbff && position < end && text.charCodeAt(position) >= 0xdc00 && text.charCodeAt(position) <= 0xdfff) {
+                size += 4;
+                position++;
+            }
+            else
+                size += 3;
+            if (size > maximum)
+                options.limit();
+        }
+        options.owner?.reserve({ work: end - start }).release();
+        return size;
+    };
+    const literal = (start, end) => {
+        if (start === end)
+            return;
+        const size = length(source, start, end, options.maximumBytes - bytes);
+        reserve(size);
+        chunks.push(source.slice(start, end));
+        bytes += size;
+    };
+    try {
+        let start = 0;
+        let nextCheckpoint = 0;
+        for (let position = 0; position < source.length;) {
+            if (position >= nextCheckpoint) {
+                options.checkpoint();
+                nextCheckpoint = position + 128;
+            }
+            if (source[position] !== "$") {
+                position++;
+                continue;
+            }
+            literal(start, position);
+            const braced = source[position + 1] === "{";
+            const nameStart = position + (braced ? 2 : 1);
+            let nameEnd = nameStart + 1;
+            if (braced)
+                while (digit(source, nameEnd)) {
+                    if (nameEnd >= nextCheckpoint) {
+                        options.checkpoint();
+                        nextCheckpoint = nameEnd + 128;
+                    }
+                    nameEnd++;
+                }
+            reserve(nameEnd - nameStart);
+            const name = source.slice(nameStart, nameEnd);
+            const value = positionalValue(name, options);
+            options.requireParameter(name, value);
+            const text = value ?? "";
+            const size = length(text, 0, text.length, options.maximumBytes - bytes);
+            reserve(size);
+            chunks.push(text);
+            bytes += size;
+            position = nameEnd + (braced ? 1 : 0);
+            start = position;
+        }
+        literal(start, source.length);
+        options.checkpoint();
+        reserve(bytes);
+        const expanded = chunks.join("");
+        options.checkpoint();
+        return evaluate(prepareArithmetic(expanded));
+    }
+    finally {
+        for (let position = admissions.length - 1; position >= 0; position--)
+            admissions[position].release();
+        header?.release();
+    }
+}
+//# sourceMappingURL=arithmetic-parameters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arithmetic-parameters.js","sourceRoot":"","sources":["../../src/shell/arithmetic-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAcpD,SAAS,KAAK,CAAC,MAAc,EAAE,QAAgB;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,UAAsB;IAChE,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;QACjD,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;YAAC,UAAU,EAAE,CAAC;YAAC,cAAc,GAAG,QAAQ,GAAG,GAAG,CAAC;QAAC,CAAC;QAClF,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACpG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAAC,QAAQ,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAChD,QAAQ,EAAE,CAAC;QACX,IAAI,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YAAC,KAAK,GAAG,IAAI,CAAC;YAAC,QAAQ,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,KAAK,GAAG,EAAE,QAAQ,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/B,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAAC,UAAU,EAAE,CAAC;gBAAC,cAAc,GAAG,QAAQ,GAAG,GAAG,CAAC;YAAC,CAAC;YAClF,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,IAAI,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACjE,KAAK,GAAG,IAAI,CAAC;QACb,QAAQ,EAAE,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,OAAoC;IACzE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC1D,IAAI,QAAQ,GAAG,GAAG,KAAK,CAAC;YAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAE,OAAO,GAAG,IAAI,CAAC;QAChF,IAAI,CAAC,OAAO;YAAE,KAAK,GAAG,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA0B,EAC1B,OAAoC,EACpC,QAAiD;IAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzG,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,CAAC,OAAe,EAAQ,EAAE;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAChG,IAAI,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,OAAe,EAAU,EAAE;QACnF,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,KAAK,IAAI,QAAQ,GAAG,KAAK,EAAE,QAAQ,GAAG,GAAG,GAAG,CAAC;YAC3C,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAAC,cAAc,GAAG,QAAQ,GAAG,GAAG,CAAC;YAAC,CAAC;YAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzC,IAAI,IAAI,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC;iBACpB,IAAI,IAAI,IAAI,KAAK;gBAAE,IAAI,IAAI,CAAC,CAAC;iBAC7B,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,QAAQ,GAAG,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;gBAAC,IAAI,IAAI,CAAC,CAAC;gBAAC,QAAQ,EAAE,CAAC;YAAC,CAAC;;gBAChK,IAAI,IAAI,CAAC,CAAC;YACf,IAAI,IAAI,GAAG,OAAO;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,GAAW,EAAQ,EAAE;QACnD,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACtC,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC,CAAC;IACF,IAAI,CAAC;QACH,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;YACjD,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAAC,cAAc,GAAG,QAAQ,GAAG,GAAG,CAAC;YAAC,CAAC;YAC1F,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;gBAAC,QAAQ,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YACvD,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YAC5C,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM;gBAAE,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;oBAAC,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;wBAAC,OAAO,CAAC,UAAU,EAAE,CAAC;wBAAC,cAAc,GAAG,OAAO,GAAG,GAAG,CAAC;oBAAC,CAAC;oBAAC,OAAO,EAAE,CAAC;gBAAC,CAAC;YAClJ,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,KAAK,IAAI,IAAI,CAAC;YACd,QAAQ,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,KAAK,IAAI,QAAQ,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,IAAI,CAAC,EAAE,QAAQ,EAAE;YAAE,UAAU,CAAC,QAAQ,CAAE,CAAC,OAAO,EAAE,CAAC;QACtG,MAAM,EAAE,OAAO,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,35 @@
+import { ShellSyntaxError } from "./types.js";
+export type Arithmetic = ({
+    kind: "literal";
+    value: bigint;
+} | {
+    kind: "name";
+    name: string;
+} | {
+    kind: "unary";
+    operator: string;
+    operand: Arithmetic;
+    postfix: boolean;
+} | {
+    kind: "binary";
+    operator: string;
+    left: Arithmetic;
+    right: Arithmetic;
+} | {
+    kind: "conditional";
+    condition: Arithmetic;
+    yes: Arithmetic;
+    no: Arithmetic;
+}) & {
+    start?: number;
+};
+export interface ArithmeticProgram {
+    readonly source: string;
+    readonly tree?: Arithmetic;
+    readonly error?: ShellSyntaxError;
+}
+export declare function prepareArithmetic(source: string): ArithmeticProgram;
+export declare function parseArithmetic(source: string, offset?: number): Arithmetic;
+export declare function arithmeticEnd(source: string, start: number): number;
+export declare function evaluateArithmetic(program: ArithmeticProgram, variables: Record<string, string>): bigint;
+//# sourceMappingURL=arithmetic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arithmetic.d.ts","sourceRoot":"","sources":["../../src/shell/arithmetic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,CACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAClF,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAMnE;AA4BD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,UAAU,CAgEtE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAWnE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAmFxG"}

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

@@ -0,0 +1,265 @@
+import { ShellSyntaxError } from "./types.js";
+class ArithmeticFailure extends Error {
+    offset;
+    constructor(message, offset) {
+        super(message);
+        this.offset = offset;
+    }
+}
+export function prepareArithmetic(source) {
+    try {
+        return { source, tree: parseArithmetic(source) };
+    }
+    catch (error) {
+        if (!(error instanceof ShellSyntaxError) || /nesting/u.test(error.reason))
+            throw error;
+        return { source, error };
+    }
+}
+const precedence = {
+    ",": 1, "=": 2, "+=": 2, "-=": 2, "*=": 2, "/=": 2, "%=": 2,
+    "<<=": 2, ">>=": 2, "&=": 2, "^=": 2, "|=": 2,
+    "?": 3, "||": 4, "&&": 5, "|": 6, "^": 7, "&": 8,
+    "==": 9, "!=": 9, "<": 10, "<=": 10, ">": 10, ">=": 10,
+    "<<": 11, ">>": 11, "+": 12, "-": 12, "*": 13, "/": 13, "%": 13, "**": 14,
+};
+function integer(text) {
+    if (/^0[xX][\da-fA-F]+$/u.test(text))
+        return BigInt(text);
+    if (/^0[0-7]+$/u.test(text))
+        return BigInt(`0o${text.slice(1)}`);
+    if (/^0\d+$/u.test(text))
+        throw new Error("Invalid octal constant");
+    if (/^\d+$/u.test(text))
+        return BigInt(text);
+    const match = /^(\d+)#([\da-zA-Z@_]+)$/u.exec(text);
+    if (!match)
+        throw new Error("Invalid arithmetic constant");
+    const base = Number(match[1]);
+    if (base < 2 || base > 64)
+        throw new Error("Invalid arithmetic base");
+    let value = 0n;
+    for (const character of match[2]) {
+        const digit = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ@_".indexOf(base <= 36 ? character.toLowerCase() : character);
+        if (digit >= base || digit < 0)
+            throw new Error("Digit exceeds arithmetic base");
+        value = value * BigInt(base) + BigInt(digit);
+    }
+    return value;
+}
+export function parseArithmetic(source, offset = 0) {
+    const tokens = [];
+    let position = 0;
+    while (position < source.length) {
+        if (/\s/u.test(source[position])) {
+            position++;
+            continue;
+        }
+        const value = /^(?:\d+#[\da-zA-Z@_]+|0[xX][\da-fA-F]+|\d+|[a-zA-Z_][a-zA-Z_0-9]*|<<=|>>=|\*\*|\+\+|--|&&|\|\||<<|>>|[+*/%&^|!<>=-]=|[()+*/%~!<>=&^|?:,\-])/u.exec(source.slice(position))?.[0];
+        if (!value)
+            throw new ShellSyntaxError("Unsupported arithmetic token", offset + position);
+        tokens.push({ value, offset: offset + position });
+        position += value.length;
+    }
+    let cursor = 0;
+    let depth = 0;
+    const current = () => tokens[cursor]?.value ?? "";
+    const error = (message) => { throw new ShellSyntaxError(message, tokens[cursor]?.offset ?? offset + source.length); };
+    const expression = (minimum = 1) => {
+        if (++depth > 64)
+            error("Arithmetic nesting exceeds 64");
+        let left;
+        const start = tokens[cursor]?.offset ?? offset + source.length;
+        const token = current();
+        cursor++;
+        if (["+", "-", "!", "~", "++", "--"].includes(token)) {
+            const operand = expression(15);
+            if (["++", "--"].includes(token) && operand.kind !== "name")
+                error("Arithmetic assignment requires a variable");
+            left = { kind: "unary", operator: token, operand, postfix: false };
+        }
+        else if (token === "(") {
+            left = expression();
+            if (current() !== ")")
+                error("Unclosed arithmetic parenthesis");
+            cursor++;
+        }
+        else if (/^[a-zA-Z_]/u.test(token))
+            left = { kind: "name", name: token };
+        else {
+            try {
+                left = { kind: "literal", value: BigInt.asIntN(64, integer(token)) };
+            }
+            catch {
+                error("Invalid arithmetic operand");
+            }
+        }
+        left.start = start;
+        while (true) {
+            const operator = current();
+            if (operator === "++" || operator === "--") {
+                if (left.kind !== "name")
+                    error("Arithmetic assignment requires a variable");
+                cursor++;
+                left = { kind: "unary", operator, operand: left, postfix: true, start };
+                continue;
+            }
+            const priority = Object.hasOwn(precedence, operator) ? precedence[operator] : 0;
+            if (priority < minimum || priority === 0)
+                break;
+            cursor++;
+            if (operator === "?") {
+                const yes = expression();
+                if (current() !== ":")
+                    error("Expected arithmetic colon");
+                cursor++;
+                left = { kind: "conditional", condition: left, yes, no: expression(3), start };
+            }
+            else {
+                const assignment = priority === 2;
+                if (assignment && left.kind !== "name")
+                    error("Arithmetic assignment requires a variable");
+                const right = expression(priority + (assignment || operator === "**" ? 0 : 1));
+                left = { kind: "binary", operator, left: left, right, start };
+            }
+        }
+        depth--;
+        return left;
+    };
+    if (!tokens.length)
+        return { kind: "literal", value: 0n };
+    const tree = expression();
+    if (cursor < tokens.length)
+        error("Unexpected arithmetic token");
+    return tree;
+}
+export function arithmeticEnd(source, start) {
+    let depth = 0;
+    for (let position = start; position < source.length; position++) {
+        const character = source[position];
+        if (character === "(")
+            depth++;
+        if (character === ")") {
+            if (depth === 0 && source[position + 1] === ")")
+                return position;
+            if (--depth < 0)
+                break;
+        }
+    }
+    throw new ShellSyntaxError("Unterminated arithmetic expression", start);
+}
+export function evaluateArithmetic(program, variables) {
+    const visiting = new Set();
+    let steps = 0;
+    const binary = (operator, left, right, offset) => {
+        switch (operator) {
+            case "+": return left + right;
+            case "-": return left - right;
+            case "*": return left * right;
+            case "/":
+                if (right === 0n)
+                    throw new ArithmeticFailure("division by 0", offset);
+                return left / right;
+            case "%":
+                if (right === 0n)
+                    throw new ArithmeticFailure("division by 0", offset);
+                return left % right;
+            case "**": {
+                if (right < 0n)
+                    throw new ArithmeticFailure("exponent less than 0", offset);
+                let result = 1n;
+                let base = left;
+                let exponent = right;
+                while (exponent) {
+                    if (exponent & 1n)
+                        result = BigInt.asIntN(64, result * base);
+                    exponent >>= 1n;
+                    base = BigInt.asIntN(64, base * base);
+                }
+                return result;
+            }
+            case "<<": return left << (right & 63n);
+            case ">>": return left >> (right & 63n);
+            case "&": return left & right;
+            case "|": return left | right;
+            case "^": return left ^ right;
+            case "==": return BigInt(left === right);
+            case "!=": return BigInt(left !== right);
+            case "<": return BigInt(left < right);
+            case "<=": return BigInt(left <= right);
+            case ">": return BigInt(left > right);
+            case ">=": return BigInt(left >= right);
+            default: throw new Error(`Unsupported arithmetic operator ${operator}`);
+        }
+    };
+    const evaluate = (node) => {
+        if (++steps > 10_000)
+            throw new Error("Arithmetic operation limit exceeded");
+        let value;
+        if (node.kind === "literal")
+            return node.value;
+        if (node.kind === "name") {
+            if (visiting.has(node.name) || visiting.size >= 64)
+                throw new Error("Arithmetic variable recursion");
+            visiting.add(node.name);
+            try {
+                return evaluate(parseArithmetic(variables[node.name] ?? "0"));
+            }
+            finally {
+                visiting.delete(node.name);
+            }
+        }
+        if (node.kind === "conditional")
+            return evaluate(evaluate(node.condition) ? node.yes : node.no);
+        if (node.kind === "unary") {
+            const operand = evaluate(node.operand);
+            if (node.operator === "+")
+                value = operand;
+            else if (node.operator === "-")
+                value = -operand;
+            else if (node.operator === "!")
+                value = BigInt(!operand);
+            else if (node.operator === "~")
+                value = ~operand;
+            else {
+                value = BigInt.asIntN(64, operand + (node.operator === "++" ? 1n : -1n));
+                variables[node.operand.name] = String(value);
+                if (node.postfix)
+                    value = operand;
+            }
+        }
+        else {
+            if (node.operator === "=")
+                value = evaluate(node.right);
+            else {
+                const left = evaluate(node.left);
+                if (node.operator === "&&")
+                    return left ? BigInt(evaluate(node.right) !== 0n) : 0n;
+                if (node.operator === "||")
+                    return left ? 1n : BigInt(evaluate(node.right) !== 0n);
+                if (node.operator === ",")
+                    return evaluate(node.right);
+                value = binary(precedence[node.operator] === 2 ? node.operator.slice(0, -1) : node.operator, left, evaluate(node.right), node.right.start ?? 0);
+            }
+            if (precedence[node.operator] === 2)
+                variables[node.left.name] = String(BigInt.asIntN(64, value));
+        }
+        return BigInt.asIntN(64, value);
+    };
+    try {
+        if (program.error)
+            throw program.error;
+        return evaluate(program.tree);
+    }
+    catch (error) {
+        if (error instanceof ArithmeticFailure)
+            throw new Error(`${program.source.trimStart()}: ${error.message} (error token is "${program.source.slice(error.offset)}")`);
+        if (error instanceof ShellSyntaxError) {
+            const offset = error.offset >= program.source.trimEnd().length ? Math.max(0, program.source.trimEnd().length - 1) : error.offset;
+            const reason = error.reason === "Invalid arithmetic operand" ? "arithmetic syntax error: operand expected" : "arithmetic syntax error in expression";
+            throw new Error(`${program.source.trimStart()}: ${reason} (error token is "${program.source.slice(offset)}")`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=arithmetic.js.map

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

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

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

@@ -0,0 +1,83 @@
+import { Admission, ArrayOwner } from "./ledger.js";
+import type { Tickets } from "./ledger.js";
+export declare const controlNames: ReadonlySet<string>;
+export declare class OwnedText {
+    readonly value: string;
+    readonly bytes: number;
+    readonly admission: Admission;
+    references: number;
+    constructor(value: string, bytes: number, admission: Admission);
+    retain(): this;
+    release(): void;
+}
+export declare function textToken(owner: ArrayOwner, value: string, signal: AbortSignal): Promise<OwnedText>;
+export interface Element {
+    readonly text: OwnedText;
+    readonly slot: Admission;
+}
+export declare class IndexedBinding {
+    readonly owner: ArrayOwner;
+    readonly values: Map<number, Element>;
+    maximum: number;
+    generation: number;
+    version: number;
+    references: number;
+    private constructor();
+    static create(parent: ArrayOwner): IndexedBinding;
+    get(index: number): string | undefined;
+    retain(): this;
+    release(): Promise<void> | undefined;
+    insert(index: number, text: OwnedText): void;
+    copy(signal: AbortSignal): Promise<IndexedBinding>;
+    indices(owner: ArrayOwner, signal: AbortSignal): Promise<number[]>;
+}
+interface Watch {
+    generation: number;
+    version: number;
+    observers: number;
+    typedVersion: number;
+    readonly admission: Admission;
+    readonly name: OwnedText;
+}
+export declare class BindingWatch {
+    #private;
+    readonly store: BindingStore;
+    readonly name: string;
+    readonly watch: Watch;
+    readonly admission: Admission;
+    readonly generation: number;
+    readonly version: number;
+    readonly typedVersion: number;
+    constructor(store: BindingStore, name: string, watch: Watch, admission: Admission);
+    valid(): boolean;
+    close(): void;
+}
+interface NamedBinding {
+    binding: IndexedBinding;
+    readonly name: OwnedText;
+    readonly admission: Admission;
+}
+export declare class BindingStore {
+    owner: ArrayOwner;
+    readonly bindings: Map<string, NamedBinding>;
+    readonly watches: Map<string, Watch>;
+    epoch: number;
+    private constructor();
+    static create(parent: ArrayOwner): BindingStore;
+    get(name: string): IndexedBinding | undefined;
+    watch(name: string, operation: ArrayOwner, signal: AbortSignal, owner?: ArrayOwner): Promise<BindingWatch>;
+    retire(name: string, watch: Watch): void;
+    tickets(name?: string): Admission;
+    changed(tickets: Tickets, name?: string): void;
+    prepareName(name: string, operation: ArrayOwner, signal: AbortSignal): Promise<{
+        readonly name: OwnedText;
+        readonly admission: Admission;
+    } | undefined>;
+    publish(name: string, binding: IndexedBinding, tickets: Tickets, prepared?: {
+        readonly name: OwnedText;
+        readonly admission: Admission;
+    }, restoring?: boolean, owner?: ArrayOwner): Promise<void> | undefined;
+    remove(name: string, tickets: Tickets): Promise<void> | undefined;
+}
+export {};
+//# sourceMappingURL=bindings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/shell/arrays/bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,UAAU,EAAY,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAE3C,CAAC;AAEH,qBAAa,SAAS;IAGR,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,SAAS,EAAE,SAAS;IAFzF,UAAU,SAAK;gBAEM,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,MAAM,EAAW,SAAS,EAAE,SAAS;IAEzF,MAAM,IAAI,IAAI;IAMd,OAAO,IAAI,IAAI;CAGhB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAczG;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,qBAAa,cAAc;IAOL,QAAQ,CAAC,KAAK,EAAE,UAAU;IAN9C,QAAQ,CAAC,MAAM,uBAA8B;IAC7C,OAAO,SAAM;IACb,UAAU,SAAK;IACf,OAAO,SAAK;IACZ,UAAU,SAAK;IAEf,OAAO;IAEP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc;IAWjD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAEtC,MAAM,IAAI,IAAI;IAMd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;IAKpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAatC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBlD,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA2BzE;AAED,UAAU,KAAK;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,qBAAa,YAAY;;IAMX,QAAQ,CAAC,KAAK,EAAE,YAAY;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK;IAAE,QAAQ,CAAC,SAAS,EAAE,SAAS;IAJrH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAET,KAAK,EAAE,YAAY,EAAW,IAAI,EAAE,MAAM,EAAW,KAAK,EAAE,KAAK,EAAW,SAAS,EAAE,SAAS;IAMrH,KAAK,IAAI,OAAO;IAEhB,KAAK,IAAI,IAAI;CAMd;AAED,UAAU,YAAY;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,qBAAa,YAAY;IAKI,KAAK,EAAE,UAAU;IAJ5C,QAAQ,CAAC,QAAQ,4BAAmC;IACpD,QAAQ,CAAC,OAAO,qBAA4B;IAC5C,KAAK,SAAK;IAEV,OAAO;IAEP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY;IAK/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAEvC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBhH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS;IAKjC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAUxC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IAS7J,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAAE,SAAS,UAAQ,EAAE,KAAK,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;IAuB1M,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;CASlE"}