@sectui/operations 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hadi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# @sectui/operations
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Data transformation operations (encoding, decoding, hashing, extraction) inspired by [CyberChef](https://github.com/gchq/CyberChef), written in TypeScript for [Node.js](https://nodejs.org) 26 or later. Part of the **sectui** family of security tools for the terminal.
+
+## Install
+
+With npm (Node.js 26 or later):
+
+```sh
+npx @sectui/operations to-base64 hello            # run without installing
+npm install -g @sectui/operations                 # then: ops to-base64 hello
+```
+
+With Nix, from the [sectui NUR](https://github.com/sectui/nur):
+
+```sh
+nix run github:sectui/nur#operations -- to-base64 hello
+```
+
+```nix
+# flake: inputs.nur-sectui.url = "github:sectui/nur";
+environment.systemPackages = [ nur-sectui.packages.${system}.operations ];
+
+# or through NUR
+environment.systemPackages = [ pkgs.nur.repos.sectui.operations ];
+```
+
+Each [GitHub release](https://github.com/sectui/operations/releases) also has the CLI as a single file, `node ops-<version>.mjs`.
+
+## Documentation
+
+- [Operations](docs/operations.md): every supported operation and its arguments
+- [Library](docs/library.md): using `@sectui/operations` from TypeScript
+- [CLI](docs/cli.md): the `ops` command
+- [Templates](docs/template.md): the `operation{...}` text syntax
+
+## Quick start
+
+```sh
+ops to-base64 hello                                  # aGVsbG8=
+cat token.txt | ops from-base64 | ops url-encode --encode-all
+ops render "hello my name is to-base64{hadi}"        # hello my name is aGFkaQ==
+```
+
+```ts
+import { runText } from "@sectui/operations";
+import { render } from "@sectui/operations/template";
+
+runText("to-base64", "hello"); // "aGVsbG8="
+render("hello my name is to-base64{hadi}"); // "hello my name is aGFkaQ=="
+```

package/dist/args.d.ts

@@ -0,0 +1,8 @@
+import type { ArgDef, Operation } from "./operation.ts";
+export declare const kebab: (key: string) => string;
+/** Finds an argument by its kebab-case name, as used by the CLI and templates. */
+export declare function findArg(op: Operation, name: string): [key: string, def: ArgDef] | undefined;
+/** Throws a readable error if `value` does not fit the argument definition. */
+export declare function checkArg(def: ArgDef, name: string, value: unknown): void;
+/** Converts a raw CLI or template value to the argument's type, then checks it. */
+export declare function coerceArg(def: ArgDef, name: string, raw: string | boolean): unknown;

package/dist/args.js

@@ -0,0 +1,47 @@
+export const kebab = (key) => key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+/** Finds an argument by its kebab-case name, as used by the CLI and templates. */
+export function findArg(op, name) {
+    return Object.entries(op.args).find(([key]) => kebab(key) === name);
+}
+/** Throws a readable error if `value` does not fit the argument definition. */
+export function checkArg(def, name, value) {
+    switch (def.type) {
+        case "boolean":
+            if (typeof value !== "boolean")
+                throw new Error(`"${name}" expects true or false, got ${JSON.stringify(value)}`);
+            return;
+        case "string":
+            if (typeof value !== "string")
+                throw new Error(`"${name}" expects a string, got ${JSON.stringify(value)}`);
+            return;
+        case "number":
+            if (typeof value !== "number" || Number.isNaN(value)) {
+                throw new Error(`"${name}" expects a number, got ${JSON.stringify(value)}`);
+            }
+            if ((def.min !== undefined && value < def.min) || (def.max !== undefined && value > def.max)) {
+                throw new Error(`"${name}" must be between ${def.min ?? "-∞"} and ${def.max ?? "∞"}, got ${value}`);
+            }
+            return;
+        case "select":
+            if (!def.options.some((o) => o.value === value)) {
+                const expected = def.options.map((o) => o.value).join(", ");
+                throw new Error(`Invalid value ${JSON.stringify(value)} for "${name}" (expected: ${expected})`);
+            }
+    }
+}
+/** Converts a raw CLI or template value to the argument's type, then checks it. */
+export function coerceArg(def, name, raw) {
+    let value = raw;
+    if (typeof raw === "string") {
+        if (def.type === "boolean" && (raw === "true" || raw === "false"))
+            value = raw === "true";
+        if (def.type === "number" && raw.trim() !== "")
+            value = Number(raw);
+    }
+    if (def.type === "number" && typeof value !== "number") {
+        throw new Error(`"${name}" expects a number, got ${JSON.stringify(raw)}`);
+    }
+    checkArg(def, name, value);
+    return value;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAE1F,kFAAkF;AAClF,MAAM,UAAU,OAAO,CAAC,EAAa,EAAE,IAAY;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,KAAc;IAChE,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,gCAAgC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjH,OAAO;QACT,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3G,OAAO;QACT,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7F,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,qBAAqB,GAAG,CAAC,GAAG,IAAI,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC;YACtG,CAAC;YACD,OAAO;QACT,KAAK,QAAQ;YACX,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5D,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,IAAI,gBAAgB,QAAQ,GAAG,CAAC,CAAC;YAClG,CAAC;IACL,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAY,EAAE,GAAqB;IACxE,IAAI,KAAK,GAAY,GAAG,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC;YAAE,KAAK,GAAG,GAAG,KAAK,MAAM,CAAC;QAC1F,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,2BAA2B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli-flags.d.ts

@@ -0,0 +1,7 @@
+import type { ArgDef, Example, Operation } from "./operation.ts";
+/** The flag users type: booleans that default to true are toggled with `--no-*`. */
+export declare function cliFlag(key: string, def: ArgDef): string;
+/** Quotes a value for a POSIX shell, using $'...' when it contains control characters. */
+export declare function shellQuote(value: string): string;
+/** The CLI invocation of an example, e.g. `ops to-base64 --no-padding hi`. */
+export declare function cliExample(op: Operation, example: Example): string;

package/dist/cli-flags.js

@@ -0,0 +1,28 @@
+import { kebab } from "./args.js";
+/** The flag users type: booleans that default to true are toggled with `--no-*`. */
+export function cliFlag(key, def) {
+    return def.type === "boolean" && def.default ? `--no-${kebab(key)}` : `--${kebab(key)}`;
+}
+/** Quotes a value for a POSIX shell, using $'...' when it contains control characters. */
+export function shellQuote(value) {
+    if (/^[\w\-.,/=+:@%]+$/.test(value))
+        return value;
+    if (!/[\x00-\x1f\x7f]/.test(value))
+        return `'${value.replaceAll("'", `'\\''`)}'`;
+    const escaped = value.replace(/[\\'\x00-\x1f\x7f]/g, (c) => c === "\n" ? "\\n" : c === "\t" ? "\\t" : c === "\\" || c === "'" ? `\\${c}` : `\\x${c.charCodeAt(0).toString(16).padStart(2, "0")}`);
+    return `$'${escaped}'`;
+}
+/** The CLI invocation of an example, e.g. `ops to-base64 --no-padding hi`. */
+export function cliExample(op, example) {
+    const parts = ["ops", op.id];
+    for (const [key, value] of Object.entries(example.args ?? {})) {
+        const def = op.args[key];
+        if (def.type !== "boolean")
+            parts.push(`--${kebab(key)}`, shellQuote(String(value)));
+        else if (value !== def.default)
+            parts.push(cliFlag(key, def));
+    }
+    parts.push(shellQuote(example.input));
+    return parts.join(" ");
+}
+//# sourceMappingURL=cli-flags.js.map

package/dist/cli-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.js","sourceRoot":"","sources":["../src/cli-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW;IAC9C,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1F,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;IACjF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,CACzD,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACrI,CAAC;IACF,OAAO,KAAK,OAAO,GAAG,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,EAAa,EAAE,OAAgB;IACxD,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAChF,IAAI,KAAK,KAAK,GAAG,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { buffer } from "node:stream/consumers";
+import { parseArgs } from "node:util";
+import { coerceArg, kebab } from "./args.js";
+import { cliExample, cliFlag } from "./cli-flags.js";
+import { completions, SHELLS } from "./completions.js";
+import { hexdump, isPrintable } from "./display.js";
+import { OperationError } from "./errors.js";
+import { getOperation, isOperationId, operations, run } from "./registry.js";
+import { renderBytes } from "./template.js";
+// Read at run time: the same relative path works from src/ and from the built dist/.
+const pkg = typeof BUNDLED_PACKAGE !== "undefined"
+    ? BUNDLED_PACKAGE
+    : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+class UsageError extends Error {
+}
+const USAGE = `ops ${pkg.version} - ${pkg.description}
+
+Usage:
+  ops <operation> [options] [input]   Apply an operation (input from stdin if omitted)
+  ops render [text]                   Replace operation{...} blocks in text
+  ops list                            List available operations
+  ops help [operation]                Show help
+  ops completions <${SHELLS.join("|")}>       Print a shell completion script
+
+Global options:
+  --raw    Write binary output to the terminal as is (by default it is shown as a hexdump)
+  --help   Show help
+
+Examples:
+  ops to-base64 hello
+  echo -n aGVsbG8= | ops from-base64
+  cat token.txt | ops from-base64 | ops url-encode --encode-all
+  ops render "hello my name is to-base64{hadi}"`;
+const RENDER_HELP = `ops render [--raw] [text]
+
+Replaces every operation{...} block in the text (or stdin) with the result of the operation.
+Arguments go between parentheses: to-hex(delimiter=colon){hadi}
+
+Example:
+  ops render "hello my name is to-base64{hadi}"`;
+function describeArg(key, def) {
+    const value = def.type === "select" ? ` <${def.options.map((o) => o.value).join("|")}>` : def.type === "boolean" ? "" : ` <${def.type}>`;
+    const details = [def.name, def.description, def.type === "boolean" ? undefined : `default: ${def.default}`].filter(Boolean).join(". ");
+    return `  ${cliFlag(key, def)}${value}\n      ${details}`;
+}
+function operationHelp(op) {
+    const lines = [`${op.id} - ${op.name}`, "", op.description];
+    if (op.aliases?.length)
+        lines.push("", `Aliases: ${op.aliases.join(", ")}`);
+    if (op.inverse)
+        lines.push(`Inverse: ${op.inverse}`);
+    const args = Object.entries(op.args);
+    if (args.length)
+        lines.push("", "Options:", ...args.map(([key, def]) => describeArg(key, def)));
+    lines.push("", "Examples:", ...op.examples.map((ex) => `  ${cliExample(op, ex)}\n      -> ${JSON.stringify(ex.output)}`));
+    return lines.join("\n");
+}
+function list() {
+    const byCategory = Map.groupBy(operations, (op) => op.category);
+    const width = Math.max(...operations.map((op) => op.id.length));
+    return [...byCategory]
+        .map(([category, ops]) => [category, ...ops.map((op) => `  ${op.id.padEnd(width)}  ${op.name}`)].join("\n"))
+        .join("\n\n");
+}
+/** Extracts the global flags, which are only recognized before a `--` separator. */
+function splitGlobalFlags(argv) {
+    const end = argv.includes("--") ? argv.indexOf("--") : argv.length;
+    const isGlobal = (arg, i) => i < end && ["--raw", "--help", "-h"].includes(arg);
+    return {
+        raw: argv.some((arg, i) => isGlobal(arg, i) && arg === "--raw"),
+        help: argv.some((arg, i) => isGlobal(arg, i) && arg !== "--raw"),
+        rest: argv.filter((arg, i) => !isGlobal(arg, i)),
+    };
+}
+function parse(argv, options, helpHint) {
+    try {
+        return parseArgs({ args: argv, options, allowPositionals: true, allowNegative: true, strict: true });
+    }
+    catch (error) {
+        throw new UsageError(`${error.message} (see: ${helpHint})`);
+    }
+}
+function parseOperationArgs(op, argv) {
+    const options = {};
+    for (const [key, def] of Object.entries(op.args)) {
+        options[kebab(key)] = { type: def.type === "boolean" ? "boolean" : "string" };
+    }
+    const parsed = parse(argv, options, `ops help ${op.id}`);
+    const args = {};
+    for (const [key, def] of Object.entries(op.args)) {
+        const raw = parsed.values[kebab(key)];
+        if (raw === undefined || Array.isArray(raw))
+            continue;
+        try {
+            args[key] = coerceArg(def, `--${kebab(key)}`, raw);
+        }
+        catch (error) {
+            throw new UsageError(error.message);
+        }
+    }
+    return { args, positionals: parsed.positionals };
+}
+async function readInput(positionals) {
+    if (positionals.length)
+        return new TextEncoder().encode(positionals.join(" "));
+    if (process.stdin.isTTY)
+        throw new UsageError("No input: pass it as an argument or pipe it through stdin");
+    return new Uint8Array(await buffer(process.stdin));
+}
+async function write(output, { raw = false } = {}) {
+    let bytes = typeof output === "string" ? new TextEncoder().encode(output) : output;
+    if (process.stdout.isTTY) {
+        // Decoded data may hold escape sequences that would drive the terminal.
+        if (!raw && !isPrintable(bytes)) {
+            console.error("ops: output contains binary data or control characters, shown as a hexdump (use --raw to print it as is)");
+            bytes = new TextEncoder().encode(hexdump(bytes));
+        }
+        // Keep the shell prompt off the output line, without altering piped bytes.
+        bytes = new Uint8Array([...bytes, 0x0a]);
+    }
+    await new Promise((resolve, reject) => process.stdout.write(bytes, (error) => (error ? reject(error) : resolve())));
+}
+async function main(argv) {
+    const [command, ...args] = argv;
+    const { raw, help, rest } = splitGlobalFlags(args);
+    if (command === undefined || command === "--help" || command === "-h")
+        return write(USAGE);
+    if (command === "--version" || command === "-v")
+        return write(pkg.version);
+    if (command === "list")
+        return write(list());
+    if (command === "help") {
+        const id = rest[0];
+        if (id === undefined)
+            return write(USAGE);
+        if (id === "render")
+            return write(RENDER_HELP);
+        if (!isOperationId(id))
+            throw new UsageError(`Unknown operation "${id}" (see: ops list)`);
+        return write(operationHelp(getOperation(id)));
+    }
+    if (command === "completions") {
+        const shell = rest[0];
+        if (!SHELLS.includes(shell))
+            throw new UsageError(`Expected a shell: ${SHELLS.join(", ")}`);
+        return write(completions(shell));
+    }
+    if (command === "render") {
+        if (help)
+            return write(RENDER_HELP);
+        const { positionals } = parse(rest, {}, "ops help render");
+        const input = await readInput(positionals);
+        return write(renderBytes(new TextDecoder().decode(input)), { raw });
+    }
+    if (!isOperationId(command))
+        throw new UsageError(`Unknown operation "${command}" (see: ops list)`);
+    const op = getOperation(command);
+    if (help)
+        return write(operationHelp(op));
+    const { args: opArgs, positionals } = parseOperationArgs(op, rest);
+    return write(run(command, await readInput(positionals), opArgs), { raw });
+}
+if (import.meta.main) {
+    // The reader went away (e.g. `ops ... | head`): stop quietly like other Unix tools.
+    process.stdout.on("error", (error) => {
+        if (error.code === "EPIPE")
+            process.exit(0);
+        throw error;
+    });
+    try {
+        await main(process.argv.slice(2));
+    }
+    catch (error) {
+        // The reader went away (e.g. `ops ... | head`): stop quietly like other Unix tools.
+        if (error.code === "EPIPE")
+            process.exit(0);
+        const message = error instanceof Error ? error.message : String(error);
+        const prefix = error instanceof OperationError && error.operation ? `${error.operation}: ` : "";
+        console.error(`ops: ${prefix}${message}`);
+        process.exit(error instanceof UsageError ? 2 : 1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/completions.d.ts

@@ -0,0 +1,3 @@
+export declare const SHELLS: readonly ["bash", "zsh", "fish"];
+export type Shell = (typeof SHELLS)[number];
+export declare function completions(shell: Shell): string;

package/dist/completions.js

@@ -0,0 +1,113 @@
+import { cliFlag } from "./cli-flags.js";
+import { operations } from "./registry.js";
+export const SHELLS = ["bash", "zsh", "fish"];
+const COMMANDS = [
+    ["list", "List available operations"],
+    ["help", "Show help"],
+    ["render", "Replace operation{...} blocks in text"],
+    ["completions", "Print a shell completion script"],
+];
+const GLOBAL_FLAGS = [
+    ["--raw", "Write raw bytes even to a terminal"],
+    ["--help", "Show help"],
+];
+const ops = operations;
+/** Wraps a string in single quotes for any POSIX-like shell. */
+const sq = (s) => `'${s.replaceAll("'", `'\\''`)}'`;
+function flagsOf(op) {
+    return Object.entries(op.args).map(([key, def]) => ({
+        flag: cliFlag(key, def),
+        description: def.name,
+        values: def.type === "select" ? def.options.map((o) => o.value) : def.type === "boolean" ? undefined : [],
+    }));
+}
+function bash() {
+    const ids = ops.map((op) => op.id).join(" ");
+    const cases = ops.map((op) => {
+        const flags = flagsOf(op);
+        const valueCases = flags
+            .filter((f) => f.values)
+            .map((f) => `        ${f.flag}) COMPREPLY=($(compgen -W ${sq(f.values.join(" "))} -- "$cur")); return ;;`);
+        const all = [...flags.map((f) => f.flag), ...GLOBAL_FLAGS.map(([f]) => f)].join(" ");
+        return [
+            `    ${op.id})`,
+            ...(valueCases.length ? ['      case "$prev" in', ...valueCases, "      esac"] : []),
+            `      [[ $cur == -* ]] && COMPREPLY=($(compgen -W ${sq(all)} -- "$cur"))`,
+            "      ;;",
+        ].join("\n");
+    });
+    return `# bash completion for ops
+_ops() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}" prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  if (( COMP_CWORD == 1 )); then
+    COMPREPLY=($(compgen -W ${sq(`${COMMANDS.map(([c]) => c).join(" ")} ${ids}`)} -- "$cur"))
+    return
+  fi
+  case "\${COMP_WORDS[1]}" in
+    help) (( COMP_CWORD == 2 )) && COMPREPLY=($(compgen -W ${sq(ids)} -- "$cur")) ;;
+    completions) (( COMP_CWORD == 2 )) && COMPREPLY=($(compgen -W ${sq(SHELLS.join(" "))} -- "$cur")) ;;
+    render) [[ $cur == -* ]] && COMPREPLY=($(compgen -W ${sq(GLOBAL_FLAGS.map(([f]) => f).join(" "))} -- "$cur")) ;;
+${cases.join("\n")}
+  esac
+}
+complete -F _ops ops
+`;
+}
+function zsh() {
+    // Escapes characters that are special in _describe entries and _arguments specs.
+    const esc = (s) => s.replace(/([:[\]\\])/g, "\\$1");
+    const describe = (items) => items.map(([n, d]) => sq(`${esc(n)}:${esc(d)}`)).join(" ");
+    const globals = GLOBAL_FLAGS.map(([f, d]) => sq(`${f}[${esc(d)}]`)).join(" ");
+    const cases = ops.map((op) => {
+        const specs = flagsOf(op).map((f) => {
+            const action = f.values === undefined ? "" : f.values.length ? `:value:(${f.values.join(" ")})` : ":value:";
+            return sq(`${f.flag}[${esc(f.description)}]${action}`);
+        });
+        return `    ${op.id}) _arguments ${[...specs, globals, sq("*:input:")].join(" ")} ;;`;
+    });
+    return `#compdef ops
+_ops() {
+  if (( CURRENT == 2 )); then
+    local -a commands=(${describe([...COMMANDS, ...ops.map((op) => [op.id, op.name])])})
+    _describe command commands
+    return
+  fi
+  local cmd=$words[2]
+  shift words
+  (( CURRENT-- ))
+  case $cmd in
+    help) (( CURRENT == 2 )) && { local -a ids=(${describe(ops.map((op) => [op.id, op.name]))}); _describe operation ids } ;;
+    completions) (( CURRENT == 2 )) && _values shell ${SHELLS.join(" ")} ;;
+    render) _arguments ${globals} ${sq("*:text:")} ;;
+${cases.join("\n")}
+  esac
+}
+if [[ $funcstack[1] == _ops ]]; then _ops "$@"; else compdef _ops ops; fi
+`;
+}
+function fish() {
+    const lines = ["# fish completion for ops", "complete -c ops -f"];
+    for (const [command, description] of COMMANDS) {
+        lines.push(`complete -c ops -n __fish_use_subcommand -a ${command} -d ${sq(description)}`);
+    }
+    for (const op of ops)
+        lines.push(`complete -c ops -n __fish_use_subcommand -a ${op.id} -d ${sq(op.name)}`);
+    const ids = sq(ops.map((op) => op.id).join(" "));
+    lines.push(`complete -c ops -n '__fish_seen_subcommand_from help' -a ${ids}`);
+    lines.push(`complete -c ops -n '__fish_seen_subcommand_from completions' -a ${sq(SHELLS.join(" "))}`);
+    const withGlobals = ["render", ...ops.map((op) => op.id)].join(" ");
+    for (const [flag, description] of GLOBAL_FLAGS) {
+        lines.push(`complete -c ops -n ${sq(`__fish_seen_subcommand_from ${withGlobals}`)} -l ${flag.slice(2)} -d ${sq(description)}`);
+    }
+    for (const op of ops) {
+        for (const f of flagsOf(op)) {
+            const values = f.values === undefined ? "" : f.values.length ? ` -x -a ${sq(f.values.join(" "))}` : " -x";
+            lines.push(`complete -c ops -n ${sq(`__fish_seen_subcommand_from ${op.id}`)} -l ${f.flag.slice(2)}${values} -d ${sq(f.description)}`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function completions(shell) {
+    return { bash, zsh, fish }[shell]();
+}
+//# sourceMappingURL=completions.js.map

package/dist/completions.js.map

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

package/dist/display.d.ts

@@ -0,0 +1,4 @@
+/** True if the bytes are valid UTF-8 text without characters that can control a terminal. */
+export declare function isPrintable(bytes: Uint8Array): boolean;
+/** Canonical hex+ASCII dump, like `hexdump -C`. */
+export declare function hexdump(bytes: Uint8Array): string;

package/dist/display.js

@@ -0,0 +1,29 @@
+// C0 controls except tab/LF/CR, DEL, C1 controls (e.g. U+009B is a CSI on some terminals),
+// and bidi overrides that can make text display differently from its content.
+const UNSAFE_CHARS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f‪-‮⁦-⁩]/;
+/** True if the bytes are valid UTF-8 text without characters that can control a terminal. */
+export function isPrintable(bytes) {
+    let text;
+    try {
+        text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        return false;
+    }
+    return !UNSAFE_CHARS.test(text);
+}
+/** Canonical hex+ASCII dump, like `hexdump -C`. */
+export function hexdump(bytes) {
+    const lines = [];
+    for (let offset = 0; offset < bytes.length; offset += 16) {
+        const row = bytes.subarray(offset, offset + 16);
+        const hex = [...row].map((b) => b.toString(16).padStart(2, "0"));
+        const left = hex.slice(0, 8).join(" ");
+        const right = hex.slice(8).join(" ");
+        const ascii = [...row].map((b) => (b >= 0x20 && b < 0x7f ? String.fromCharCode(b) : ".")).join("");
+        lines.push(`${offset.toString(16).padStart(8, "0")}  ${left.padEnd(23)}  ${right.padEnd(23)}  |${ascii}|`);
+    }
+    lines.push(bytes.length.toString(16).padStart(8, "0"));
+    return lines.join("\n");
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,8EAA8E;AAC9E,MAAM,YAAY,GAAG,6DAA6D,CAAC;AAEnF,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;IAC7G,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+/** Error raised when an operation cannot process its input or arguments. */
+export declare class OperationError extends Error {
+    name: string;
+    /** Id of the failing operation, set by `run`. */
+    operation?: string;
+}

package/dist/errors.js

@@ -0,0 +1,7 @@
+/** Error raised when an operation cannot process its input or arguments. */
+export class OperationError extends Error {
+    name = "OperationError";
+    /** Id of the failing operation, set by `run`. */
+    operation;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,GAAG,gBAAgB,CAAC;IACjC,iDAAiD;IACjD,SAAS,CAAU;CACpB"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./display.ts";
+export * from "./errors.ts";
+export * from "./operation.ts";
+export * from "./registry.ts";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./display.js";
+export * from "./errors.js";
+export * from "./operation.js";
+export * from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}