@poe-platform/safe-bash 0.1.0

package/dist/safe-bash/commands/archive/options.js

@@ -0,0 +1,265 @@
+import { collectBytes } from "../../contracts/index.js";
+import { checkPath, fail, operation, smallFile, text, vfsPath } from "./internal.js";
+export async function parseOptions(context, limits) {
+    if (context.args.reduce((total, argument) => total + Buffer.byteLength(argument), 0) > limits.maxArgumentBytes)
+        fail("argument byte limit exceeded");
+    let mode;
+    let archive = "-";
+    let gzip = false;
+    let verbose = false;
+    let strip = 0;
+    let format = "pax";
+    let cwd = context.cwd;
+    let nullFiles = false;
+    let verbatim = false;
+    let filesFrom = false;
+    let stdinUsed = false;
+    let filesFromBytes = 0;
+    let lateExclude = false;
+    const operands = [];
+    const excludes = [];
+    const operand = (name) => {
+        checkPath(name, limits);
+        if (operands.length >= limits.maxMembers)
+            fail("operand limit exceeded");
+        operands.push({ name, cwd });
+    };
+    const directory = async (name) => {
+        checkPath(name, limits);
+        const path = await operation(context, () => context.fs.realpath(vfsPath(cwd, name), { signal: context.signal }));
+        const stat = await operation(context, () => context.fs.stat(path, { signal: context.signal }));
+        if (stat.type !== "directory")
+            fail(`not a directory: ${name}`);
+        cwd = path;
+    };
+    const names = async (path) => {
+        filesFrom = true;
+        if (path === "-" && stdinUsed)
+            fail("standard input file list can only be read once");
+        const bytes = path === "-"
+            ? await collectBytes(context.stdin, { maxBytes: limits.maxFilesFromBytes, signal: context.signal })
+            : await smallFile(context, vfsPath(context.cwd, path), limits);
+        if (path === "-")
+            stdinUsed = true;
+        filesFromBytes += bytes.length;
+        if (filesFromBytes > limits.maxFilesFromBytes)
+            fail("files-from byte limit exceeded");
+        const contents = text(bytes);
+        if (!nullFiles && contents.includes("\0"))
+            fail("NUL in newline file list; use --null");
+        const lines = contents.split(nullFiles ? "\0" : "\n");
+        for (let index = 0; index < lines.length; index++) {
+            const line = lines[index];
+            if (!line)
+                continue;
+            if (!nullFiles && !verbatim && line.startsWith("-")) {
+                if (line === "-C") {
+                    const next = lines[++index];
+                    if (!next)
+                        fail("missing -C argument in file list");
+                    await directory(next);
+                }
+                else if (line.startsWith("-C") && !/\s/u.test(line[2] ?? ""))
+                    await directory(line.slice(2));
+                else if (line.startsWith("--directory="))
+                    await directory(line.slice(12));
+                else
+                    fail(`unsupported option in file list: ${line}; use --verbatim-files-from for literal names`);
+            }
+            else {
+                if (!nullFiles && !verbatim && line.includes("\\"))
+                    fail("backslash quoting in file lists is unsupported; use --verbatim-files-from or --null");
+                operand(line);
+            }
+        }
+    };
+    const apply = async (flag, value) => {
+        if (flag === "c" || flag === "t" || flag === "x") {
+            if (mode)
+                fail("exactly one of -c, -t, -x is required");
+            mode = flag;
+        }
+        else if (flag === "z")
+            gzip = true;
+        else if (flag === "v")
+            verbose = true;
+        else if (flag === "f") {
+            if (!value)
+                fail("empty archive name");
+            archive = value;
+        }
+        else if (flag === "C")
+            await directory(value);
+        else if (flag === "T")
+            await names(value);
+        else if (flag === "exclude") {
+            checkPath(value, limits);
+            if (operands.length)
+                lateExclude = true;
+            excludes.push(value);
+        }
+        else if (flag === "strip-components") {
+            if (!/^[0-9]+$/u.test(value) || !Number.isSafeInteger(Number(value)))
+                fail("invalid strip-components count");
+            strip = Number(value);
+        }
+        else if (flag === "format") {
+            if (value !== "ustar" && value !== "pax" && value !== "posix")
+                fail(`unsupported archive format: ${value}`);
+            format = value === "ustar" ? "ustar" : "pax";
+        }
+        else if (flag === "null") {
+            nullFiles = true;
+            verbatim = true;
+        }
+        else if (flag === "no-null")
+            nullFiles = false;
+        else if (flag === "verbatim-files-from")
+            verbatim = true;
+        else if (flag === "no-verbatim-files-from")
+            verbatim = false;
+        else
+            fail(`unsupported option: ${flag}`);
+    };
+    const long = { create: "c", list: "t", extract: "x", get: "x", file: "f", gzip: "z", verbose: "v", directory: "C", "files-from": "T" };
+    const values = new Set(["f", "C", "T", "exclude", "strip-components", "format"]);
+    let end = false;
+    for (let index = 0; index < context.args.length; index++) {
+        const argument = context.args[index];
+        if (!end && argument === "--") {
+            end = true;
+            continue;
+        }
+        if (!end && argument.startsWith("--")) {
+            const equals = argument.indexOf("=");
+            const name = argument.slice(2, equals < 0 ? undefined : equals);
+            const flag = long[name] ?? name;
+            let value = equals < 0 ? undefined : argument.slice(equals + 1);
+            if (values.has(flag) && value === undefined)
+                value = context.args[++index];
+            if (values.has(flag) && value === undefined)
+                fail(`missing argument for --${name}`);
+            if (!values.has(flag) && value !== undefined)
+                fail(`option --${name} does not take an argument`);
+            await apply(flag, value);
+        }
+        else if (!end && ((argument.startsWith("-") && argument !== "-") || (index === 0 && /^[ctxzvfCT]+$/u.test(argument)))) {
+            const old = !argument.startsWith("-");
+            const cluster = old ? argument : argument.slice(1);
+            for (let offset = 0; offset < cluster.length; offset++) {
+                const flag = cluster[offset];
+                let value;
+                if (values.has(flag)) {
+                    value = !old && offset + 1 < cluster.length ? cluster.slice(offset + 1) : context.args[++index];
+                    if (value === undefined)
+                        fail(`missing argument for -${flag}`);
+                    if (!old)
+                        offset = cluster.length;
+                }
+                await apply(flag, value);
+            }
+        }
+        else
+            operand(argument);
+    }
+    if (!mode)
+        fail("exactly one of -c, -t, -x is required");
+    if (mode !== "c" && archive === "-" && stdinUsed)
+        fail("archive and file list cannot both use standard input");
+    if (mode === "c" && strip !== 0)
+        fail("--strip-components is only supported when reading archives");
+    if (mode === "c" && lateExclude)
+        fail("--exclude after source operands is unsupported; place exclusions before operands");
+    if (mode === "c" && !operands.length && !filesFrom)
+        fail("refusing to create an empty archive without -T");
+    if (archive !== "-")
+        checkPath(archive, limits);
+    return { mode, archive, gzip, verbose, strip, format, cwd, operands, excludes };
+}
+function tokenize(pattern) {
+    const characters = Array.from(pattern);
+    const tokens = [];
+    for (let index = 0; index < characters.length; index++) {
+        const character = characters[index];
+        if (character === "*") {
+            if (tokens.at(-1)?.kind !== "star")
+                tokens.push({ kind: "star" });
+        }
+        else if (character === "?")
+            tokens.push({ kind: "any" });
+        else if (character === "\\") {
+            if (++index === characters.length)
+                fail("trailing escape in exclude pattern");
+            tokens.push({ kind: "literal", value: characters[index] });
+        }
+        else if (character === "[") {
+            const ranges = [];
+            index++;
+            const negative = characters[index] === "!" || characters[index] === "^";
+            if (negative)
+                index++;
+            while (index < characters.length && (characters[index] !== "]" || ranges.length === 0)) {
+                const first = characters[index];
+                if (first === "[" || first === "\\")
+                    fail("POSIX classes and escapes inside exclude brackets are unsupported");
+                let last = first;
+                if (characters[index + 1] === "-" && characters[index + 2] && characters[index + 2] !== "]") {
+                    last = characters[index + 2];
+                    index += 2;
+                }
+                if (first.codePointAt(0) > last.codePointAt(0))
+                    fail("invalid exclude bracket range");
+                ranges.push([first.codePointAt(0), last.codePointAt(0)]);
+                index++;
+            }
+            if (characters[index] !== "]")
+                fail("unclosed exclude bracket");
+            tokens.push({ kind: "class", ranges, negative });
+        }
+        else
+            tokens.push({ kind: "literal", value: character });
+    }
+    return tokens;
+}
+export class Exclusions {
+    maxWork;
+    patterns;
+    work = 0;
+    constructor(patterns, maxWork = 10_000_000) {
+        this.maxWork = maxWork;
+        this.patterns = patterns.map(tokenize);
+    }
+    matches(name) {
+        const characters = Array.from(name);
+        for (const tokens of this.patterns) {
+            let states = new Uint8Array(characters.length + 1);
+            states[0] = 1;
+            for (let index = 0; index < characters.length; index++)
+                if (characters[index] === "/")
+                    states[index + 1] = 1;
+            for (const token of tokens) {
+                this.work += characters.length + 1;
+                if (this.work > this.maxWork)
+                    fail("exclude pattern work limit exceeded");
+                const next = new Uint8Array(states.length);
+                for (let index = 0; index < states.length; index++) {
+                    if (token.kind === "star")
+                        next[index] = states[index] || (index > 0 ? next[index - 1] : 0);
+                    else if (states[index] && index < characters.length) {
+                        const character = characters[index];
+                        const matches = token.kind === "any" || (token.kind === "literal" ? token.value === character
+                            : token.ranges.some(([first, last]) => character.codePointAt(0) >= first && character.codePointAt(0) <= last) !== token.negative);
+                        if (matches)
+                            next[index + 1] = 1;
+                    }
+                }
+                states = next;
+            }
+            for (let index = 0; index < states.length; index++)
+                if (states[index] && (index === characters.length || characters[index] === "/"))
+                    return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=options.js.map

package/dist/safe-bash/commands/archive/options.js.map

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

package/dist/safe-bash/commands/archive/stream.d.ts

@@ -0,0 +1,18 @@
+import { type ByteSource } from "../../contracts/index.js";
+import { type ArchiveLimits } from "./internal.js";
+export declare function compressed(source: ByteSource, decode: boolean, signal: AbortSignal, limits: ArchiveLimits): ByteSource;
+export declare class Reader {
+    readonly signal: AbortSignal;
+    readonly iterator: AsyncIterator<Uint8Array>;
+    private chunk;
+    private offset;
+    constructor(source: ByteSource, signal: AbortSignal);
+    take(maximum: number): Promise<Uint8Array | undefined>;
+    exact(size: number): Promise<Uint8Array>;
+    body(size: number): ByteSource;
+    discard(size: number): Promise<void>;
+    padding(size: number): Promise<void>;
+    finish(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/safe-bash/commands/archive/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/commands/archive/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAExE,wBAAuB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,UAAU,CAiC7H;AAED,qBAAa,MAAM;IAIe,QAAQ,CAAC,MAAM,EAAE,WAAW;IAH5D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAAK;gBACP,MAAM,EAAE,UAAU,EAAW,MAAM,EAAE,WAAW;IAGtD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAatD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAWvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAS/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACpC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/safe-bash/commands/archive/stream.js

@@ -0,0 +1,108 @@
+import { createGunzip, createGzip } from "node:zlib";
+import { readBytes } from "../../contracts/index.js";
+import { bounded, fail, wait } from "./internal.js";
+export async function* compressed(source, decode, signal, limits) {
+    signal.throwIfAborted();
+    const controller = new AbortController();
+    const combined = AbortSignal.any([signal, controller.signal]);
+    const streamOptions = { chunkSize: limits.chunkSize, highWaterMark: limits.chunkSize };
+    const transform = decode ? createGunzip(streamOptions) : createGzip(streamOptions);
+    transform.on("error", () => { });
+    const destroy = () => { transform.destroy(new Error("archive compression cancelled")); };
+    combined.addEventListener("abort", destroy, { once: true });
+    const pump = (async () => {
+        try {
+            for await (const chunk of bounded(source, limits.maxArchiveBytes, combined, limits.chunkSize)) {
+                await wait(combined, () => new Promise((resolve, reject) => {
+                    transform.write(chunk, error => error ? reject(error) : resolve());
+                }));
+            }
+            combined.throwIfAborted();
+            transform.end();
+        }
+        catch (error) {
+            transform.destroy(error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    })();
+    void pump.catch(() => { });
+    try {
+        yield* bounded(transform, limits.maxArchiveBytes, combined, limits.chunkSize);
+        await pump;
+    }
+    finally {
+        controller.abort(new Error("archive compression finished"));
+        combined.removeEventListener("abort", destroy);
+        transform.destroy();
+        await pump.catch(() => { });
+    }
+}
+export class Reader {
+    signal;
+    iterator;
+    chunk = new Uint8Array();
+    offset = 0;
+    constructor(source, signal) {
+        this.signal = signal;
+        this.iterator = readBytes(source, signal)[Symbol.asyncIterator]();
+    }
+    async take(maximum) {
+        this.signal.throwIfAborted();
+        while (this.offset === this.chunk.length) {
+            const result = await this.iterator.next();
+            if (result.done)
+                return undefined;
+            this.chunk = result.value;
+            this.offset = 0;
+        }
+        const end = Math.min(this.chunk.length, this.offset + maximum);
+        const bytes = this.chunk.subarray(this.offset, end);
+        this.offset = end;
+        return bytes;
+    }
+    async exact(size) {
+        const result = new Uint8Array(size);
+        let offset = 0;
+        while (offset < size) {
+            const bytes = await this.take(size - offset);
+            if (!bytes)
+                fail("truncated archive");
+            result.set(bytes, offset);
+            offset += bytes.length;
+        }
+        return result;
+    }
+    async *body(size) {
+        let remaining = size;
+        while (remaining > 0) {
+            const bytes = await this.take(remaining);
+            if (!bytes)
+                fail("truncated archive body");
+            remaining -= bytes.length;
+            yield bytes;
+        }
+    }
+    async discard(size) {
+        for await (const ignoredChunk of this.body(size))
+            this.signal.throwIfAborted();
+    }
+    async padding(size) { await this.discard((512 - size % 512) % 512); }
+    async finish() {
+        let trailing = 0;
+        while (true) {
+            const bytes = await this.take(64 * 1024);
+            if (!bytes)
+                break;
+            if (bytes.some(byte => byte !== 0))
+                fail("nonzero trailing archive data or concatenated archive is unsupported");
+            trailing += bytes.length;
+        }
+        if (trailing % 512 !== 0)
+            fail("truncated archive trailing record");
+    }
+    async close() {
+        if (this.iterator.return)
+            await this.iterator.return();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/safe-bash/commands/archive/stream.js.map

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

package/dist/safe-bash/commands/basic.d.ts

@@ -0,0 +1,3 @@
+import { type CommandDefinition } from "../contracts/index.js";
+export declare function basicCommands(): CommandDefinition[];
+//# sourceMappingURL=basic.d.ts.map

package/dist/safe-bash/commands/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../src/commands/basic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGnH,wBAAgB,aAAa,IAAI,iBAAiB,EAAE,CAkKnD"}

package/dist/safe-bash/commands/basic.js

@@ -0,0 +1,208 @@
+import { basename, dirname, getCommandArguments, writeBytes } from "../contracts/index.js";
+import { decoder, define, encoder, escapeBytes, options, output, requireOperands, UsageError, value } from "./internal.js";
+export function basicCommands() {
+    return [
+        define("true", () => ({ exitCode: 0 })),
+        define("false", () => ({ exitCode: 1 })),
+        define("echo", async (context) => {
+            const arguments_ = getCommandArguments(context);
+            let newline = true;
+            let escapes = false;
+            let offset = 0;
+            while (/^-[neE]+$/u.test(arguments_.args[offset] ?? "")) {
+                for (const flag of arguments_.args[offset].slice(1)) {
+                    if (flag === "n")
+                        newline = false;
+                    else
+                        escapes = flag === "e";
+                }
+                offset++;
+            }
+            const joined = arguments_.slice(offset).join(" ");
+            const text = typeof joined === "string" ? joined : arguments_.withValues([joined]).bytes(0);
+            if (escapes) {
+                const escaped = escapeBytes(text, true);
+                await output(context, escaped.bytes);
+                if (escaped.stop)
+                    newline = false;
+            }
+            else
+                await output(context, text);
+            if (newline)
+                await output(context, "\n");
+            return { exitCode: 0 };
+        }),
+        define("pwd", async (context) => {
+            const parsed = options(context.args, "LP");
+            requireOperands(parsed.operands, 0, 0);
+            await output(context, `${parsed.flags.has("P") ? await context.fs.realpath(context.cwd, { signal: context.signal }) : context.cwd}\n`);
+            return { exitCode: 0 };
+        }),
+        define("basename", async (context) => {
+            const parsed = options(context.args, "as:z", { multiple: "a", suffix: "s", zero: "z" });
+            const multiple = parsed.flags.has("a") || parsed.flags.has("s");
+            requireOperands(parsed.operands, 1, multiple ? Infinity : 2);
+            const suffix = value(parsed, "s") ?? (multiple ? undefined : parsed.operands[1]);
+            for (const operand of multiple ? parsed.operands : parsed.operands.slice(0, 1)) {
+                let result = /^\/+$/u.test(operand) ? "/" : basename(operand);
+                if (suffix && result !== suffix && result.endsWith(suffix))
+                    result = result.slice(0, -suffix.length);
+                await output(context, result + (parsed.flags.has("z") ? "\0" : "\n"));
+            }
+            return { exitCode: 0 };
+        }),
+        define("dirname", async (context) => {
+            const parsed = options(context.args, "z", { zero: "z" });
+            requireOperands(parsed.operands);
+            for (const operand of parsed.operands)
+                await output(context, dirname(operand.replace(/\/+$/u, "") || (operand.startsWith("/") ? "/" : ".")) + (parsed.flags.has("z") ? "\0" : "\n"));
+            return { exitCode: 0 };
+        }),
+        define("printf", async (context) => {
+            const incoming = getCommandArguments(context);
+            const arguments_ = incoming.args[0] === "--" ? incoming.slice(1) : incoming;
+            const args = arguments_.args;
+            requireOperands(args);
+            const format = args[0];
+            if (format.startsWith("-") && incoming.args[0] !== "--")
+                throw new UsageError(`invalid option '${format}'`);
+            const rawFormat = typeof arguments_.values[0] === "string" ? undefined : arguments_.bytes(0);
+            const formatLength = rawFormat?.length ?? format.length;
+            let argument = 1;
+            let exitCode = 0;
+            let stopped = false;
+            do {
+                const before = argument;
+                for (let offset = 0; offset < formatLength && !stopped;) {
+                    if (rawFormat ? rawFormat[offset] !== 37 : format[offset] !== "%") {
+                        const end = rawFormat ? rawFormat.indexOf(37, offset) : format.indexOf("%", offset);
+                        const limit = end < 0 ? formatLength : end;
+                        const literal = rawFormat ? rawFormat.subarray(offset, limit) : format.slice(offset, limit);
+                        const escaped = escapeBytes(literal);
+                        await output(context, escaped.bytes);
+                        stopped = escaped.stop;
+                        offset += literal.length;
+                        continue;
+                    }
+                    if (rawFormat ? rawFormat[offset + 1] === 37 : format[offset + 1] === "%") {
+                        await output(context, "%");
+                        offset += 2;
+                        continue;
+                    }
+                    let tokenEnd = offset + 1;
+                    if (rawFormat)
+                        while (tokenEnd < rawFormat.length && (rawFormat[tokenEnd] >= 48 && rawFormat[tokenEnd] <= 57 || [32, 35, 43, 45, 46].includes(rawFormat[tokenEnd])))
+                            tokenEnd++;
+                    const fragment = rawFormat ? decoder.decode(rawFormat.subarray(offset, tokenEnd + 1)) : format.slice(offset);
+                    const match = /^%([-+ #0]*)(\d+)?(?:\.(\d+))?([sbqcdiouxXfFeEgG])/u.exec(fragment);
+                    if (!match)
+                        throw new UsageError(`invalid format near '${fragment}'`);
+                    offset += match[0].length;
+                    const flags = match[1];
+                    const width = Number(match[2] ?? 0);
+                    const precision = match[3] === undefined ? undefined : Number(match[3]);
+                    if (width > 1_000_000 || (precision ?? 0) > 1000)
+                        throw new UsageError("format width or precision is too large");
+                    const specifier = match[4];
+                    if (/[fFeEgG]/u.test(specifier) && (precision ?? 0) > 100)
+                        throw new UsageError("floating-point precision is too large");
+                    const suppliedIndex = argument++;
+                    const supplied = args[suppliedIndex] ?? "";
+                    let text;
+                    if (specifier === "b" || specifier === "s") {
+                        const suppliedValue = arguments_.values[suppliedIndex] ?? "";
+                        const raw = specifier === "b" && typeof suppliedValue === "string" ? suppliedValue : arguments_.bytes(suppliedIndex) ?? new Uint8Array();
+                        const escaped = specifier === "b" ? escapeBytes(raw, true, true) : { bytes: raw, stop: false };
+                        const bytes = escaped.bytes.subarray(0, precision);
+                        const padding = " ".repeat(Math.max(0, width - bytes.length));
+                        if (!flags.includes("-"))
+                            await output(context, padding);
+                        await output(context, bytes);
+                        if (flags.includes("-"))
+                            await output(context, padding);
+                        stopped = escaped.stop;
+                        continue;
+                    }
+                    if (specifier === "q")
+                        text = supplied === "" ? "''" : supplied.replace(/[^a-zA-Z0-9_./-]/gu, character => character === "\n" ? "$'\\n'" : `\\${character}`);
+                    else if (specifier === "c")
+                        text = supplied ? String.fromCodePoint(supplied.codePointAt(0)) : "\0";
+                    else {
+                        let number = supplied === "" ? 0 : /^["']/u.test(supplied) ? supplied.codePointAt(1) ?? 0 : Number(supplied);
+                        if (/^[+-]0[xX][0-9a-fA-F]+$/u.test(supplied.trim())) {
+                            number = Number(supplied.trim().slice(1)) * (supplied.trim().startsWith("-") ? -1 : 1);
+                        }
+                        if (/^[+-]?0[0-9]+$/u.test(supplied) && !/[fFeEgG]/u.test(specifier)) {
+                            if (/[89]/u.test(supplied))
+                                number = NaN;
+                            else
+                                number = parseInt(supplied.replace(/^[+-]?0/u, ""), 8) * (supplied.startsWith("-") ? -1 : 1);
+                        }
+                        if (!Number.isFinite(number)) {
+                            await writeBytes(context.stderr, encoder.encode(`printf: '${supplied}': invalid number\n`), context.signal);
+                            exitCode = 1;
+                            number = 0;
+                        }
+                        if (/[fF]/u.test(specifier))
+                            text = number.toFixed(precision ?? 6);
+                        else if (/[eE]/u.test(specifier))
+                            text = number.toExponential(precision ?? 6).replace(/e([+-])(\d)$/u, "e$10$2");
+                        else if (/[gG]/u.test(specifier))
+                            text = Number(number.toPrecision(Math.max(1, precision ?? 6))).toString();
+                        else {
+                            const radix = /[xX]/u.test(specifier) ? 16 : specifier === "o" ? 8 : 10;
+                            const unsigned = /[uoxX]/u.test(specifier);
+                            let integral;
+                            try {
+                                const token = supplied.trim();
+                                if (!token || /^["']/u.test(token))
+                                    integral = BigInt(Math.trunc(number));
+                                else {
+                                    const magnitude = token.replace(/^[+-]/u, "");
+                                    if (!/^(?:0[xX][0-9a-fA-F]+|0[0-7]*|[1-9][0-9]*)$/u.test(magnitude))
+                                        throw new Error("invalid integer");
+                                    integral = BigInt(/^0[0-7]+$/u.test(magnitude) ? `0o${magnitude.slice(1)}` : magnitude) * (token.startsWith("-") ? -1n : 1n);
+                                }
+                            }
+                            catch {
+                                integral = 0n;
+                                if (exitCode === 0)
+                                    await writeBytes(context.stderr, encoder.encode(`printf: '${supplied}': invalid integer\n`), context.signal);
+                                exitCode = 1;
+                            }
+                            text = (unsigned ? BigInt.asUintN(64, integral) : integral).toString(radix);
+                            if (precision === 0 && integral === 0n)
+                                text = "";
+                            if (precision !== undefined)
+                                text = text.startsWith("-") ? `-${text.slice(1).padStart(precision, "0")}` : text.padStart(precision, "0");
+                            if (flags.includes("#")) {
+                                if (radix === 16 && integral !== 0n)
+                                    text = "0x" + text;
+                                else if (radix === 8 && !text.startsWith("0"))
+                                    text = "0" + text;
+                            }
+                        }
+                        if (/[XFEG]/u.test(specifier))
+                            text = text.toUpperCase();
+                        if (number >= 0 && /[difFeEgG]/u.test(specifier))
+                            text = (flags.includes("+") ? "+" : flags.includes(" ") ? " " : "") + text;
+                    }
+                    if (flags.includes("-"))
+                        text = text.padEnd(width, " ");
+                    else if (flags.includes("0") && /[diouxXfFeEgG]/u.test(specifier)
+                        && (precision === undefined || /[fFeEgG]/u.test(specifier))) {
+                        const prefix = /^[+ -]|^0[xX]/u.exec(text)?.[0] ?? "";
+                        text = prefix + text.slice(prefix.length).padStart(Math.max(0, width - prefix.length), "0");
+                    }
+                    else
+                        text = text.padStart(width, " ");
+                    await output(context, text);
+                }
+                if (argument === before)
+                    break;
+            } while (argument < args.length && !stopped);
+            return { exitCode };
+        }),
+    ];
+}
+//# sourceMappingURL=basic.js.map