@poe-platform/safe-bash 0.1.0

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

@@ -0,0 +1,242 @@
+import { FsError, resolvePath } from "../../contracts/index.js";
+import { compareObservedEntries } from "../copy-identity.js";
+import { parse, help } from "./arguments.js";
+import { escaped, message, TreeLimitError, UsageError, WalkBudget } from "./io.js";
+import { settings } from "./options.js";
+import { matches } from "./pattern.js";
+function directory(entry) { return (entry.followed ?? entry.stat)?.type === "directory"; }
+function serialized(value, budget) {
+    let size = 2;
+    const add = (count) => { budget.checkOutput(size += count); };
+    const string = (text) => {
+        budget.outputText(text);
+        add(2);
+        for (const character of text) {
+            const point = character.codePointAt(0);
+            if (point === 34 || point === 92 || point === 8 || point === 9 || point === 10 || point === 12 || point === 13)
+                add(2);
+            else if (point < 32 || (point >= 0xd800 && point <= 0xdfff) || /[\u007f-\u009f\u2028\u2029\p{Cf}]/u.test(character))
+                add(6 * character.length);
+            else
+                add(point < 0x80 ? 1 : point < 0x800 ? 2 : point < 0x10000 ? 3 : 4);
+        }
+    };
+    let first = true;
+    for (const [key, field] of Object.entries(value)) {
+        if (!first)
+            add(1);
+        first = false;
+        string(key);
+        add(1);
+        if (typeof field === "string")
+            string(field);
+        else if (typeof field === "number")
+            add(String(field).length);
+        else
+            throw new TypeError("tree JSON fields must be strings or numbers");
+    }
+    return JSON.stringify(value).replace(/[\u007f-\u009f\u2028\u2029\p{Cf}]/gu, character => character.split("").map(unit => `\\u${unit.charCodeAt(0).toString(16).padStart(4, "0")}`).join(""));
+}
+class Walker {
+    budget;
+    args;
+    directories = 0;
+    files = 0;
+    failed = false;
+    constructor(budget, args) {
+        this.budget = budget;
+        this.args = args;
+    }
+    async inspect(path, display, name) {
+        const { context } = this.budget;
+        const options = { signal: context.signal };
+        const entry = { path, display, name };
+        this.budget.text(path);
+        this.budget.text(display);
+        try {
+            entry.stat = await this.budget.fs(() => context.fs.lstat(path, options));
+            if (entry.stat.type === "symlink") {
+                if (!context.fs.readlink)
+                    throw new FsError("ENOTSUP", { path, syscall: "readlink" });
+                entry.target = await this.budget.fs(() => context.fs.readlink(path, options));
+                try {
+                    entry.followed = await this.budget.fs(() => context.fs.stat(path, options));
+                }
+                catch (error) {
+                    context.signal.throwIfAborted();
+                    if (!(error instanceof FsError) || (error.code !== "ENOENT" && error.code !== "ENOTDIR"))
+                        throw error;
+                }
+            }
+        }
+        catch (error) {
+            context.signal.throwIfAborted();
+            if (error instanceof TreeLimitError)
+                throw error;
+            entry.error = message(error, this.budget);
+        }
+        if (entry.target !== undefined)
+            this.budget.text(entry.target);
+        return entry;
+    }
+    async children(entry, ancestors, depth) {
+        const { context, limits } = this.budget;
+        if (entry.error || !directory(entry) || (entry.stat?.type === "symlink" && !this.args.follow))
+            return [];
+        if (depth === this.args.level)
+            return [];
+        this.budget.check(depth + 1, limits.maxDepth, "depth");
+        let listing;
+        try {
+            for (const ancestor of ancestors) {
+                const same = await this.budget.fs(() => compareObservedEntries(context.fs, entry.path, (entry.followed ?? entry.stat), context.fs, ancestor.path, (ancestor.followed ?? ancestor.stat), { signal: context.signal }));
+                if (same === "same") {
+                    entry.cycle = true;
+                    return [];
+                }
+            }
+            listing = await this.budget.fs(() => context.fs.readdir(entry.path, { signal: context.signal }));
+        }
+        catch (error) {
+            context.signal.throwIfAborted();
+            if (error instanceof TreeLimitError)
+                throw error;
+            entry.error = message(error, this.budget);
+            return [];
+        }
+        this.budget.check(listing.length, limits.maxDirectoryEntries, "directory entry");
+        this.budget.entry(listing.length);
+        const names = new Set();
+        const candidates = [];
+        for (const item of listing) {
+            this.budget.step();
+            this.budget.text(item.name);
+            if (item.name === "." || item.name === "..")
+                continue;
+            if (!item.name || item.name.includes("/") || item.name.includes("\0") || /[\ud800-\udfff]/u.test(item.name) || names.has(item.name)) {
+                entry.error = "invalid or duplicate directory entry";
+                return [];
+            }
+            names.add(item.name);
+            if (!this.args.all && item.name.startsWith("."))
+                continue;
+            const bytes = new TextEncoder().encode(item.name);
+            if (this.args.exclude.some(pattern => matches(pattern, bytes, this.budget)))
+                continue;
+            candidates.push({ name: item.name, bytes });
+        }
+        candidates.sort((left, right) => {
+            this.budget.step(1 + left.bytes.length + right.bytes.length);
+            return Buffer.compare(left.bytes, right.bytes) * (this.args.reverse ? -1 : 1);
+        });
+        const children = [];
+        for (const item of candidates) {
+            const child = await this.inspect(resolvePath(entry.path, item.name), `${entry.display.replace(/\/$/u, "")}/${item.name}`, item.name);
+            if (!child.error) {
+                if (this.args.directories && !directory(child))
+                    continue;
+                const includeDirectory = child.stat?.type === "directory" || (this.args.follow && directory(child));
+                if (!includeDirectory && this.args.include.length && !this.args.include.some(pattern => matches(pattern, item.bytes, this.budget)))
+                    continue;
+            }
+            children.push(child);
+        }
+        if (this.args.dirsFirst)
+            children.sort((left, right) => {
+                this.budget.step();
+                return Number(directory(right)) - Number(directory(left));
+            });
+        return children;
+    }
+    async visit(entry, ancestors, prefix, last, depth) {
+        const children = await this.children(entry, ancestors, depth);
+        if (directory(entry)) {
+            if (depth > 0 || children.length)
+                this.directories++;
+        }
+        else if (entry.stat)
+            this.files++;
+        if (entry.error) {
+            this.budget.text(entry.error);
+            this.failed = true;
+            await this.budget.emit(this.budget.context.stderr, `tree: ${escaped(entry.display, this.budget)}: ${escaped(entry.error, this.budget)}\n`);
+        }
+        const name = depth === 0 || this.args.full ? entry.display : entry.name;
+        const annotation = entry.error ?? (entry.cycle ? "recursive, not followed" : undefined);
+        if (this.args.json) {
+            const fields = { type: entry.stat?.type === "symlink" ? "link" : entry.stat?.type ?? "unknown", name,
+                ...(entry.target === undefined ? {} : { target: entry.target }), ...(annotation === undefined ? {} : { error: annotation }) };
+            await this.write(`${this.padding(depth + 1)}${serialized(fields, this.budget).slice(0, -1)}`);
+            if (children.length) {
+                await this.write(`,"contents":[${this.newline()}`);
+                for (let index = 0; index < children.length; index++) {
+                    if (index)
+                        await this.write(`,${this.newline()}`);
+                    await this.visit(children[index], [...ancestors, entry], "", index === children.length - 1, depth + 1);
+                }
+                await this.write(`${this.newline()}${this.padding(depth + 1)}]`);
+            }
+            await this.write("}");
+        }
+        else {
+            const utf8 = this.args.charset === "UTF-8";
+            const branch = this.args.indent && depth > 0 ? prefix + (last ? (utf8 ? "└── " : "`-- ") : (utf8 ? "├── " : "|-- ")) : "";
+            await this.write(`${branch}${escaped(name, this.budget)}${entry.target === undefined ? "" : ` -> ${escaped(entry.target, this.budget)}`}${annotation === undefined ? "" : `  [${escaped(annotation, this.budget)}]`}\n`);
+            const childPrefix = depth === 0 ? "" : prefix + (last ? "    " : utf8 ? "│   " : "|   ");
+            for (let index = 0; index < children.length; index++) {
+                await this.visit(children[index], [...ancestors, entry], childPrefix, index === children.length - 1, depth + 1);
+            }
+        }
+    }
+    newline() { return this.args.indent ? "\n" : ""; }
+    padding(depth) { return this.args.indent ? "  ".repeat(depth) : ""; }
+    write(value) { return this.budget.emit(this.budget.context.stdout, value); }
+    async run() {
+        this.budget.text(this.budget.context.cwd);
+        if (this.args.json)
+            await this.write(`[${this.newline()}`);
+        for (let index = 0; index < this.args.operands.length; index++) {
+            const operand = this.args.operands[index];
+            this.budget.text(operand);
+            this.budget.entry();
+            if (this.args.json && index)
+                await this.write(`,${this.newline()}`);
+            const entry = await this.inspect(resolvePath(this.budget.context.cwd, operand), operand, operand);
+            await this.visit(entry, [], "", true, 0);
+        }
+        if (this.args.report) {
+            if (this.args.json) {
+                await this.write(`,${this.newline()}${this.padding(1)}${serialized({ type: "report", directories: this.directories,
+                    ...(this.args.directories ? {} : { files: this.files }) }, this.budget)}`);
+            }
+            else
+                await this.write(`\n${this.directories} ${this.directories === 1 ? "directory" : "directories"}${this.args.directories ? "" : `, ${this.files} ${this.files === 1 ? "file" : "files"}`}\n`);
+        }
+        if (this.args.json)
+            await this.write(`${this.newline()}]\n`);
+        return this.failed ? 1 : 0;
+    }
+}
+export function createTreeCommand(options = {}) {
+    const limits = settings(options);
+    return { name: "tree", description: "List a bounded virtual directory tree", async execute(context) {
+            const budget = new WalkBudget(context, limits);
+            let args;
+            try {
+                args = parse(context.args, budget);
+            }
+            catch (error) {
+                context.signal.throwIfAborted();
+                if (!(error instanceof UsageError))
+                    throw error;
+                await budget.emit(context.stderr, `tree: ${escaped(error.message, budget)}\n`);
+                return { exitCode: 2 };
+            }
+            if (args.help || args.version) {
+                await budget.emit(context.stdout, args.help ? help : "tree (virtual-bash bounded profile) 1\n");
+                return { exitCode: 0 };
+            }
+            return { exitCode: await new Walker(budget, args).run() };
+        } };
+}
+//# sourceMappingURL=tree.js.map

package/dist/safe-bash/commands/tree/tree.js.map

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

package/dist/safe-bash/commands/which/index.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDefinition, VirtualShellPlugin } from "../../contracts/index.js";
+import type { WhichCommandsOptions } from "./options.js";
+export { createWhichCommand } from "./which.js";
+export type { WhichCommandsOptions, WhichLimits } from "./options.js";
+export declare function createWhichCommands(options?: WhichCommandsOptions): readonly CommandDefinition[];
+export declare function whichCommands(options?: WhichCommandsOptions): VirtualShellPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/safe-bash/commands/which/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/which/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,iBAAiB,EAAE,CAEpG;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,kBAAkB,CAYpF"}

package/dist/safe-bash/commands/which/index.js

@@ -0,0 +1,22 @@
+import { createWhichCommand } from "./which.js";
+export { createWhichCommand } from "./which.js";
+export function createWhichCommands(options = {}) {
+    return Object.freeze([createWhichCommand(options)]);
+}
+export function whichCommands(options = {}) {
+    const commands = createWhichCommands(options);
+    const replace = options.replace ?? false;
+    return {
+        name: "which-commands",
+        setup(host) {
+            if (!replace)
+                for (const command of commands) {
+                    if (host.commands.has(command.name))
+                        throw new Error(`Command already registered: ${command.name}`);
+                }
+            for (const command of commands)
+                host.commands.register(command, { replace });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/safe-bash/commands/which/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/which/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,OAAO;gBAAE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtG,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/safe-bash/commands/which/options.d.ts

@@ -0,0 +1,15 @@
+export interface WhichLimits {
+    readonly maxArguments: number;
+    readonly maxArgumentBytes: number;
+    readonly maxPathEnvBytes: number;
+    readonly maxPathComponents: number;
+    readonly maxPathBytes: number;
+    readonly maxProbes: number;
+    readonly maxOutputBytes: number;
+}
+export interface WhichCommandsOptions {
+    readonly replace?: boolean;
+    readonly limits?: Partial<WhichLimits>;
+}
+export declare function settings(options: WhichCommandsOptions): WhichLimits;
+//# sourceMappingURL=options.d.ts.map

package/dist/safe-bash/commands/which/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/commands/which/options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACxC;AAYD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAYnE"}

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

@@ -0,0 +1,24 @@
+const DEFAULT_LIMITS = Object.freeze({
+    maxArguments: 4096,
+    maxArgumentBytes: 65536,
+    maxPathEnvBytes: 65536,
+    maxPathComponents: 4096,
+    maxPathBytes: 16384,
+    maxProbes: 65536,
+    maxOutputBytes: 8388608,
+});
+export function settings(options) {
+    for (const key of Reflect.ownKeys(options.limits ?? {})) {
+        if (!Object.hasOwn(DEFAULT_LIMITS, key))
+            throw new RangeError(`Unknown which limit: ${String(key)}`);
+    }
+    const limits = { ...DEFAULT_LIMITS, ...options.limits };
+    for (const [key, value] of Object.entries(limits)) {
+        if (!Number.isSafeInteger(value) || value < 1
+            || (key === "maxPathBytes" && value > Number.MAX_SAFE_INTEGER - 256)) {
+            throw new RangeError(`Invalid which limit: ${key}`);
+        }
+    }
+    return Object.freeze(limits);
+}
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/commands/which/options.ts"],"names":[],"mappings":"AAeA,MAAM,cAAc,GAAgB,MAAM,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,KAAK;IAChB,cAAc,EAAE,OAAO;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,QAAQ,CAAC,OAA6B;IACpD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,wBAAwB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;eACxC,CAAC,GAAG,KAAK,cAAc,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,GAAG,GAAG,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,UAAU,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type CommandDefinition } from "../../contracts/index.js";
+import { type WhichCommandsOptions } from "./options.js";
+export declare function createWhichCommand(options?: WhichCommandsOptions): CommandDefinition;
+//# sourceMappingURL=which.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["../../../src/commands/which/which.ts"],"names":[],"mappings":"AAAA,OAAO,EAE+B,KAAK,iBAAiB,EAC3D,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAY,KAAK,oBAAoB,EAAoB,MAAM,cAAc,CAAC;AA8PrF,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,iBAAiB,CAMxF"}

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

@@ -0,0 +1,284 @@
+import { ACCESS_MODES, isAbsolutePath, isFsError, validatePath, writeBytes, } from "../../contracts/index.js";
+import { settings } from "./options.js";
+const USAGE = "usage: which [-as] program ...\n";
+const encoder = new TextEncoder();
+const descriptions = {
+    EACCES: "permission denied",
+    EAGAIN: "resource temporarily unavailable",
+    EBADF: "bad file descriptor",
+    EBUSY: "resource busy or locked",
+    ECANCELED: "operation canceled",
+    EEXIST: "file already exists",
+    EFBIG: "file too large",
+    EINTR: "interrupted system call",
+    EINVAL: "invalid argument",
+    EIO: "input/output error",
+    EISDIR: "illegal operation on a directory",
+    ELOOP: "too many symbolic links encountered",
+    EMFILE: "too many open files",
+    ENAMETOOLONG: "name too long",
+    ENFILE: "file table overflow",
+    ENOENT: "no such file or directory",
+    ENOMEM: "not enough memory",
+    ENOSPC: "no space left on device",
+    ENOSYS: "function not implemented",
+    ENOTDIR: "not a directory",
+    ENOTEMPTY: "directory not empty",
+    ENOTSUP: "operation not supported",
+    EOPNOTSUPP: "operation not supported",
+    EPERM: "operation not permitted",
+    EPIPE: "broken pipe",
+    EROFS: "read-only file system",
+    ETIMEDOUT: "operation timed out",
+    EXDEV: "cross-device link not permitted",
+};
+const misses = new Set([
+    "ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP", "ENAMETOOLONG",
+]);
+class Diagnostic extends Error {
+}
+class Invocation {
+    context;
+    limits;
+    hasNul = false;
+    probes = 0;
+    outputBytes = 0;
+    all = false;
+    quiet = false;
+    cwd = "";
+    cwdBytes = 0;
+    constructor(context, limits) {
+        this.context = context;
+        this.limits = limits;
+    }
+    check() {
+        this.context.signal.throwIfAborted();
+    }
+    limit(key) {
+        throw new Diagnostic(`which: ${key} limit exceeded\n`);
+    }
+    add(current, increment, maximum, key) {
+        if (increment > maximum - current)
+            this.limit(key);
+        return current + increment;
+    }
+    bytes(text, maximum, key, start = 0, end = text.length) {
+        this.check();
+        if (end - start > maximum)
+            this.limit(key);
+        let count = 0;
+        let checkpoint = start;
+        for (let cursor = start; cursor < end; cursor++) {
+            if (cursor >= checkpoint) {
+                this.check();
+                checkpoint = cursor + 4096;
+            }
+            const code = text.charCodeAt(cursor);
+            let width = code < 0x80 ? 1 : code < 0x800 ? 2 : 3;
+            if (code === 0)
+                this.hasNul = true;
+            if (code >= 0xd800 && code <= 0xdbff && cursor + 1 < end) {
+                const next = text.charCodeAt(cursor + 1);
+                if (next >= 0xdc00 && next <= 0xdfff) {
+                    width = 4;
+                    cursor++;
+                }
+            }
+            count = this.add(count, width, maximum, key);
+        }
+        this.check();
+        return count;
+    }
+    parse() {
+        const args = this.context.args;
+        let operand = 0;
+        for (; operand < args.length; operand++) {
+            this.check();
+            const argument = args[operand];
+            if (argument === "--") {
+                operand++;
+                break;
+            }
+            if (argument === "-" || !argument.startsWith("-"))
+                break;
+            for (let cursor = 1; cursor < argument.length; cursor++) {
+                if ((cursor - 1) % 4096 === 0)
+                    this.check();
+                const flag = argument.charAt(cursor);
+                if (flag === "a")
+                    this.all = true;
+                else if (flag === "s")
+                    this.quiet = true;
+                else
+                    throw new Diagnostic(`which: illegal option -- ${String.fromCodePoint(argument.codePointAt(cursor))}\n${USAGE}`);
+            }
+        }
+        this.check();
+        if (operand === args.length)
+            throw new Diagnostic(USAGE);
+        return operand;
+    }
+    async write(sink, text) {
+        this.check();
+        const bytes = encoder.encode(text);
+        this.check();
+        try {
+            await writeBytes(sink, bytes, this.context.signal);
+        }
+        catch (error) {
+            this.check();
+            throw error;
+        }
+        this.check();
+    }
+    async probe(name, nameBytes, path, start = 0, end = 0) {
+        this.check();
+        this.probes = this.add(this.probes, 1, this.limits.maxProbes, "maxProbes");
+        let displayBytes = nameBytes;
+        if (path !== undefined) {
+            const componentBytes = start === end ? 1 : this.bytes(path, this.limits.maxPathBytes, "maxPathBytes", start, end);
+            displayBytes = this.add(componentBytes, 1, this.limits.maxPathBytes, "maxPathBytes");
+            displayBytes = this.add(displayBytes, nameBytes, this.limits.maxPathBytes, "maxPathBytes");
+        }
+        else if (displayBytes > this.limits.maxPathBytes)
+            this.limit("maxPathBytes");
+        const absolute = path === undefined ? isAbsolutePath(name) : path.charAt(start) === "/";
+        if (!absolute) {
+            const prefixBytes = this.cwd === "/" ? 0 : this.cwdBytes;
+            const lookupPrefixBytes = this.add(prefixBytes, 1, this.limits.maxPathBytes, "maxPathBytes");
+            this.add(lookupPrefixBytes, displayBytes, this.limits.maxPathBytes, "maxPathBytes");
+        }
+        this.check();
+        const display = path === undefined ? name : `${start === end ? "." : path.slice(start, end)}/${name}`;
+        const lookup = absolute ? display : `${this.cwd === "/" ? "" : this.cwd}/${display}`;
+        validatePath(lookup);
+        this.check();
+        if (display.endsWith("/") || display.endsWith("/.") || display.endsWith("/.."))
+            return false;
+        try {
+            this.check();
+            const stat = await this.context.fs.stat(lookup, { signal: this.context.signal });
+            this.check();
+            if (stat.type !== "file")
+                return false;
+            this.check();
+            await this.context.fs.access(lookup, ACCESS_MODES.X_OK, { signal: this.context.signal });
+            this.check();
+        }
+        catch (error) {
+            this.check();
+            if (isFsError(error) && misses.has(error.code))
+                return false;
+            const description = isFsError(error) ? descriptions[error.code] : "filesystem operation failed";
+            throw new Diagnostic(`which: ${display}: ${description}\n`);
+        }
+        this.check();
+        if (!this.quiet) {
+            const lineBytes = this.add(displayBytes, 1, this.limits.maxOutputBytes - this.outputBytes, "maxOutputBytes");
+            this.outputBytes += lineBytes;
+            this.check();
+            await this.write(this.context.stdout, `${display}\n`);
+        }
+        this.check();
+        return true;
+    }
+    async search() {
+        this.check();
+        const { args } = this.context;
+        if (args.length > this.limits.maxArguments)
+            this.limit("maxArguments");
+        const path = this.context.env.PATH;
+        this.cwd = this.context.cwd;
+        let argumentBytes = 0;
+        for (const argument of args) {
+            this.check();
+            argumentBytes += this.bytes(argument, this.limits.maxArgumentBytes - argumentBytes, "maxArgumentBytes");
+        }
+        if (path !== undefined) {
+            this.bytes(path, this.limits.maxPathEnvBytes, "maxPathEnvBytes");
+            let components = 1;
+            for (let cursor = 0; cursor < path.length; cursor++) {
+                if (cursor % 4096 === 0)
+                    this.check();
+                if (path.charAt(cursor) === ":")
+                    components = this.add(components, 1, this.limits.maxPathComponents, "maxPathComponents");
+            }
+        }
+        this.cwdBytes = this.bytes(this.cwd, this.limits.maxPathBytes, "maxPathBytes");
+        if (this.hasNul)
+            throw new Diagnostic("which: invalid argument: NUL byte\n");
+        const firstOperand = this.parse();
+        if (!isAbsolutePath(this.cwd))
+            throw new Diagnostic("which: cwd must be an absolute virtual path\n");
+        validatePath(this.cwd);
+        this.check();
+        if (path === undefined)
+            return { exitCode: 1 };
+        let everyFound = true;
+        for (let operand = firstOperand; operand < args.length; operand++) {
+            this.check();
+            const name = args[operand];
+            if (name === "") {
+                everyFound = false;
+                continue;
+            }
+            const nameBytes = this.bytes(name, this.limits.maxArgumentBytes, "maxArgumentBytes");
+            let slash = false;
+            for (let cursor = 0; cursor < name.length; cursor++) {
+                if (cursor % 4096 === 0)
+                    this.check();
+                if (name.charAt(cursor) === "/") {
+                    slash = true;
+                    break;
+                }
+            }
+            let found = false;
+            if (slash)
+                found = await this.probe(name, nameBytes);
+            else {
+                let start = 0;
+                for (let cursor = 0; cursor <= path.length; cursor++) {
+                    if (cursor % 4096 === 0)
+                        this.check();
+                    if (cursor === path.length || path.charAt(cursor) === ":") {
+                        if (await this.probe(name, nameBytes, path, start, cursor)) {
+                            found = true;
+                            if (!this.all)
+                                break;
+                        }
+                        start = cursor + 1;
+                    }
+                }
+            }
+            if (!found)
+                everyFound = false;
+        }
+        this.check();
+        return { exitCode: everyFound ? 0 : 1 };
+    }
+    async execute() {
+        this.check();
+        try {
+            const result = await this.search();
+            this.check();
+            return result;
+        }
+        catch (error) {
+            this.check();
+            if (!(error instanceof Diagnostic))
+                throw error;
+            this.bytes(error.message, this.limits.maxPathBytes + 256, "maxPathBytes");
+            await this.write(this.context.stderr, error.message);
+            this.check();
+            return { exitCode: 1 };
+        }
+    }
+}
+export function createWhichCommand(options = {}) {
+    const limits = settings(options);
+    return Object.freeze({
+        name: "which",
+        execute(context) { return new Invocation(context, limits).execute(); },
+    });
+}
+//# sourceMappingURL=which.js.map