@veilio-inc/cli 0.6.0 → 0.7.0

package/dist/flags.d.ts

@@ -0,0 +1,211 @@
+export interface CommandSpec {
+    /** A top-level command, or a group with its action (`maps pull`). */
+    readonly key: string;
+    /** Reaches the network. Listed after the offline commands in `--help`. */
+    readonly cloud: boolean;
+    /** Its lines in the COMMANDS section of `--help`. */
+    readonly help: readonly {
+        readonly usage: string;
+        readonly text: string;
+    }[];
+}
+/** In the order `--help` prints them. */
+export declare const COMMAND_SPECS: readonly [{
+    readonly key: "scrub";
+    readonly cloud: false;
+    readonly help: readonly [{
+        readonly usage: "scrub --team";
+        readonly text: "Number new placeholders from the team's allocation.";
+    }, {
+        readonly usage: "scrub [files...]";
+        readonly text: "Mask identifiers and redact credentials. Reads stdin when no file is given. Writes the symbol map to .veilio/map.json.";
+    }];
+}, {
+    readonly key: "restore";
+    readonly cloud: false;
+    readonly help: readonly [{
+        readonly usage: "restore [files...]";
+        readonly text: "Swap placeholders back and strip AI-generated noise.";
+    }];
+}, {
+    readonly key: "scan";
+    readonly cloud: false;
+    readonly help: readonly [{
+        readonly usage: "scan [files...]";
+        readonly text: "Detect credentials only; never rewrites. Exits 1 on a credential (with --strict, on any finding) — use it in a pre-commit hook or CI.";
+    }];
+}, {
+    readonly key: "map";
+    readonly cloud: false;
+    readonly help: readonly [{
+        readonly usage: "map";
+        readonly text: "Show the current symbol map (--clear to wipe it).";
+    }];
+}, {
+    readonly key: "login";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "login";
+        readonly text: "Sign in to Veilio Cloud (--instance for self-hosted, --device to approve in a browser).";
+    }];
+}, {
+    readonly key: "logout";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "logout";
+        readonly text: "Revoke the session and forget the credential.";
+    }];
+}, {
+    readonly key: "whoami";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "whoami";
+        readonly text: "Show the signed-in account. Answers from disk; makes no request, so it works with the instance down.";
+    }];
+}, {
+    readonly key: "maps list";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "maps list";
+        readonly text: "List the maps this account holds in Cloud.";
+    }];
+}, {
+    readonly key: "maps pull";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "maps pull <id>";
+        readonly text: "Fetch one into the local store. A personal map is decrypted here — the passphrase never leaves the machine. A team map opens with the key from `team unlock`.";
+    }];
+}, {
+    readonly key: "maps push";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "maps push [name]";
+        readonly text: "Encrypt the local map and upload it as a new map.";
+    }, {
+        readonly usage: "maps push --team";
+        readonly text: "Publish it as the TEAM's shared map instead.";
+    }];
+}, {
+    readonly key: "maps update";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "maps update <id>";
+        readonly text: "Replace a Cloud map's entries with the local map's, in place: same id, name and project. Refuses to drop entries unless --allow-drop is given.";
+    }];
+}, {
+    readonly key: "maps rm";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "maps rm <id>";
+        readonly text: "Remove a map from Cloud.";
+    }];
+}, {
+    readonly key: "team unlock";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "team unlock";
+        readonly text: "Open this account's team keys with the vault passphrase and keep them on this machine (7 days), so team maps - and the MCP server's shared namespace - work unattended.";
+    }];
+}, {
+    readonly key: "team lock";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "team lock";
+        readonly text: "Remove the unlocked team keys from this machine.";
+    }];
+}, {
+    readonly key: "vault unlock";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "vault unlock";
+        readonly text: "Unlock the personal-maps key with the vault passphrase and keep only that key here (7 days), so personal maps - and the MCP server's map tools - work without a passphrase. Re-seals older personal maps under it.";
+    }];
+}, {
+    readonly key: "vault lock";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "vault lock";
+        readonly text: "Remove the personal-maps key from this machine.";
+    }];
+}, {
+    readonly key: "projects";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "projects";
+        readonly text: "List the projects your team works in; * marks the one in use. A team map belongs to exactly one project.";
+    }];
+}, {
+    readonly key: "projects list";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "projects list";
+        readonly text: "The same as `projects`.";
+    }];
+}, {
+    readonly key: "projects use";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "projects use <name>";
+        readonly text: "Work in that project: team maps, pushes, updates and scrub --team use it only. Kept with the sign-in, so the MCP server uses it too. VEILIO_PROJECT=<name|id> overrides it for one shell, CI job or MCP server.";
+    }];
+}, {
+    readonly key: "rules pull";
+    readonly cloud: true;
+    readonly help: readonly [{
+        readonly usage: "rules pull";
+        readonly text: "Fetch this account's custom rules (personal and team). `scrub` then applies them offline, as the web app does.";
+    }];
+}];
+/** The command a flag is checked against: a top-level command, or a group
+ *  command with its action (`maps pull`). */
+export type CommandKey = (typeof COMMAND_SPECS)[number]['key'];
+/** The first word of a key: `maps` for `maps pull`. */
+export type CommandWord<K extends string = CommandKey> = K extends `${infer W} ${string}` ? W : K;
+/** The actions of a group: `'list' | 'pull' | …` for `maps`. */
+export type ActionOf<G extends string> = CommandKey extends infer K ? K extends `${G} ${infer A}` ? A : never : never;
+export declare const COMMAND_KEYS: readonly CommandKey[];
+/** Every top-level word the parser accepts as a command, in table order. */
+export declare const COMMAND_WORDS: readonly string[];
+/** The actions of a group, in table order. Empty for a plain command. */
+export declare function actionsOf(word: string): string[];
+/** Whether a group can also run with no action (`projects` lists). */
+export declare function runsBare(word: string): boolean;
+/** `list, pull, push, update or rm`, for the messages that name the actions. */
+export declare function actionList(word: string): string;
+export interface FlagSpec {
+    long: string;
+    short?: string;
+    /** The value's placeholder in `--help` (`<lang>`). Absent: a switch. */
+    value?: string;
+    /** What the flag does, and the notes a user needs. Wrapped by `--help`. */
+    help: string;
+    /** The commands this flag belongs to. `'all'`: every command. */
+    commands: readonly CommandKey[] | 'all';
+    /** The ParsedArgs field it sets. The table-vs-code test reads it. */
+    field?: string;
+}
+export declare const FLAGS: readonly FlagSpec[];
+/** The flag a spelling (`-l` or `--language`) names, if any. */
+export declare function flagFor(spelling: string): FlagSpec | undefined;
+export declare function belongsTo(flag: FlagSpec, command: CommandKey): boolean;
+/** The flags a command takes, the ones for every command included. */
+export declare function flagsOf(command: CommandKey): FlagSpec[];
+/** `--language (-l)`, for an error message. */
+export declare function spell(flag: FlagSpec): string;
+/** Every line of `--help` fits in this many columns. */
+export declare const HELP_WIDTH = 80;
+/** Words of `text`, in lines no wider than `width`. */
+export declare function wrap(text: string, width: number): string[];
+/** The OPTIONS block for some flags: each flag, its text, and the commands
+ *  it belongs to, every line within HELP_WIDTH. */
+export declare function optionsHelp(flags?: readonly FlagSpec[]): string;
+/** The COMMANDS block for some commands. */
+export declare function commandsHelp(specs: readonly CommandSpec[]): string;
+/** The COMMANDS section of the general help: the offline commands, a note,
+ *  then the ones that reach the network. */
+export declare function allCommandsHelp(): string;
+/** `veilio scrub --help`: that command's lines and its own options. For a
+ *  group with no action (`veilio maps --help`), every action of the group. */
+export declare function commandHelp(topic: string): string;
+//# sourceMappingURL=flags.d.ts.map

package/dist/flags.d.ts.map

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

package/dist/flags.js

@@ -0,0 +1,410 @@
+/**
+ * Every command and every flag, in one table. The parser reads its commands,
+ * group verbs and flags from here. `--help` (general and per command) is
+ * rendered from here. The docs test reads it. So a new action or flag is
+ * added in one place, and the parser, the help and the docs check cannot drift
+ * apart.
+ *
+ * Before this table, the parser took any flag on any command and ignored the
+ * ones that did not apply: `veilio scrub --days 3` ran, and `--days` did
+ * nothing. That is the same silent failure as the engine's removed
+ * `options.style`. A reader who writes a flag into a script believes it does
+ * something. Now a flag on a command it does not belong to is refused, with
+ * exit code 2 and the list of options that command does take.
+ */
+import { BIN_NAME, STORE_DIR } from '@veilio-inc/engine';
+/** In the order `--help` prints them. */
+export const COMMAND_SPECS = [
+    {
+        key: 'scrub',
+        cloud: false,
+        help: [
+            { usage: 'scrub --team', text: "Number new placeholders from the team's allocation." },
+            {
+                usage: 'scrub [files...]',
+                text: `Mask identifiers and redact credentials. Reads stdin when no file is given. Writes the symbol map to ${STORE_DIR}/map.json.`,
+            },
+        ],
+    },
+    {
+        key: 'restore',
+        cloud: false,
+        help: [
+            {
+                usage: 'restore [files...]',
+                text: 'Swap placeholders back and strip AI-generated noise.',
+            },
+        ],
+    },
+    {
+        key: 'scan',
+        cloud: false,
+        help: [
+            {
+                usage: 'scan [files...]',
+                text: 'Detect credentials only; never rewrites. Exits 1 on a credential (with --strict, on any finding) — use it in a pre-commit hook or CI.',
+            },
+        ],
+    },
+    {
+        key: 'map',
+        cloud: false,
+        help: [{ usage: 'map', text: 'Show the current symbol map (--clear to wipe it).' }],
+    },
+    {
+        key: 'login',
+        cloud: true,
+        help: [
+            {
+                usage: 'login',
+                text: 'Sign in to Veilio Cloud (--instance for self-hosted, --device to approve in a browser).',
+            },
+        ],
+    },
+    {
+        key: 'logout',
+        cloud: true,
+        help: [{ usage: 'logout', text: 'Revoke the session and forget the credential.' }],
+    },
+    {
+        key: 'whoami',
+        cloud: true,
+        help: [
+            {
+                usage: 'whoami',
+                text: 'Show the signed-in account. Answers from disk; makes no request, so it works with the instance down.',
+            },
+        ],
+    },
+    {
+        key: 'maps list',
+        cloud: true,
+        help: [{ usage: 'maps list', text: 'List the maps this account holds in Cloud.' }],
+    },
+    {
+        key: 'maps pull',
+        cloud: true,
+        help: [
+            {
+                usage: 'maps pull <id>',
+                text: 'Fetch one into the local store. A personal map is decrypted here — the passphrase never leaves the machine. A team map opens with the key from `team unlock`.',
+            },
+        ],
+    },
+    {
+        key: 'maps push',
+        cloud: true,
+        help: [
+            {
+                usage: 'maps push [name]',
+                text: 'Encrypt the local map and upload it as a new map.',
+            },
+            { usage: 'maps push --team', text: "Publish it as the TEAM's shared map instead." },
+        ],
+    },
+    {
+        key: 'maps update',
+        cloud: true,
+        help: [
+            {
+                usage: 'maps update <id>',
+                text: "Replace a Cloud map's entries with the local map's, in place: same id, name and project. Refuses to drop entries unless --allow-drop is given.",
+            },
+        ],
+    },
+    {
+        key: 'maps rm',
+        cloud: true,
+        help: [{ usage: 'maps rm <id>', text: 'Remove a map from Cloud.' }],
+    },
+    {
+        key: 'team unlock',
+        cloud: true,
+        help: [
+            {
+                usage: 'team unlock',
+                text: "Open this account's team keys with the vault passphrase and keep them on this machine (7 days), so team maps - and the MCP server's shared namespace - work unattended.",
+            },
+        ],
+    },
+    {
+        key: 'team lock',
+        cloud: true,
+        help: [{ usage: 'team lock', text: 'Remove the unlocked team keys from this machine.' }],
+    },
+    {
+        key: 'vault unlock',
+        cloud: true,
+        help: [
+            {
+                usage: 'vault unlock',
+                text: "Unlock the personal-maps key with the vault passphrase and keep only that key here (7 days), so personal maps - and the MCP server's map tools - work without a passphrase. Re-seals older personal maps under it.",
+            },
+        ],
+    },
+    {
+        key: 'vault lock',
+        cloud: true,
+        help: [{ usage: 'vault lock', text: 'Remove the personal-maps key from this machine.' }],
+    },
+    {
+        key: 'projects',
+        cloud: true,
+        help: [
+            {
+                usage: 'projects',
+                text: 'List the projects your team works in; * marks the one in use. A team map belongs to exactly one project.',
+            },
+        ],
+    },
+    {
+        key: 'projects list',
+        cloud: true,
+        help: [{ usage: 'projects list', text: 'The same as `projects`.' }],
+    },
+    {
+        key: 'projects use',
+        cloud: true,
+        help: [
+            {
+                usage: 'projects use <name>',
+                text: 'Work in that project: team maps, pushes, updates and scrub --team use it only. Kept with the sign-in, so the MCP server uses it too. VEILIO_PROJECT=<name|id> overrides it for one shell, CI job or MCP server.',
+            },
+        ],
+    },
+    {
+        key: 'rules pull',
+        cloud: true,
+        help: [
+            {
+                usage: 'rules pull',
+                text: "Fetch this account's custom rules (personal and team). `scrub` then applies them offline, as the web app does.",
+            },
+        ],
+    },
+];
+export const COMMAND_KEYS = COMMAND_SPECS.map((c) => c.key);
+/** Every top-level word the parser accepts as a command, in table order. */
+export const COMMAND_WORDS = [
+    ...new Set(COMMAND_KEYS.map((k) => k.split(' ')[0])),
+];
+/** The actions of a group, in table order. Empty for a plain command. */
+export function actionsOf(word) {
+    return COMMAND_KEYS.filter((k) => k.startsWith(`${word} `)).map((k) => k.split(' ')[1]);
+}
+/** Whether a group can also run with no action (`projects` lists). */
+export function runsBare(word) {
+    return COMMAND_KEYS.includes(word);
+}
+/** `list, pull, push, update or rm`, for the messages that name the actions. */
+export function actionList(word) {
+    const actions = actionsOf(word);
+    return actions.length > 1
+        ? `${actions.slice(0, -1).join(', ')} or ${actions[actions.length - 1]}`
+        : (actions[0] ?? '');
+}
+export const FLAGS = [
+    {
+        long: '--language',
+        short: '-l',
+        value: '<lang>',
+        help: 'auto (default), typescript, python, go, java, csharp, rust, ruby, php, c, sql',
+        commands: ['scrub'],
+        field: 'language',
+    },
+    {
+        long: '--secrets',
+        short: '-s',
+        value: '<policy>',
+        help: 'redact (default) | warn | off',
+        commands: ['scrub'],
+        field: 'secrets',
+    },
+    {
+        long: '--preamble',
+        short: '-p',
+        help: 'Prepend the downstream-AI note and placeholder legend',
+        commands: ['scrub'],
+        field: 'preamble',
+    },
+    {
+        long: '--map',
+        short: '-m',
+        value: '<path>',
+        help: 'Use a specific map file',
+        commands: ['scrub', 'restore', 'map', 'maps pull', 'maps push', 'maps update'],
+        field: 'mapPath',
+    },
+    {
+        long: '--json',
+        help: 'Machine-readable output',
+        commands: ['scan', 'map'],
+        field: 'json',
+    },
+    {
+        long: '--strict',
+        help: 'scan: also fail on advisory findings. restore: write nothing and exit 1 if a placeholder would be left',
+        commands: ['scan', 'restore'],
+        field: 'strict',
+    },
+    {
+        long: '--keep-docs',
+        help: 'Keep JSDoc blocks the model wrote',
+        commands: ['restore'],
+        field: 'keepDocs',
+    },
+    {
+        long: '--clear',
+        help: 'Wipe the symbol map',
+        commands: ['map'],
+        field: 'clear',
+    },
+    {
+        long: '--force',
+        short: '-f',
+        help: 'Allow a map write that would drop existing entries',
+        commands: ['scrub', 'maps pull'],
+        field: 'force',
+    },
+    {
+        long: '--team',
+        help: "scrub: number new placeholders out of the team's shared allocation, for a map you intend to publish. maps push: publish as the team's shared map",
+        commands: ['scrub', 'maps push'],
+        field: 'team',
+    },
+    {
+        long: '--days',
+        value: '<n>',
+        help: 'Keep the key for n days (1 to 30; 7 by default)',
+        commands: ['team unlock', 'vault unlock'],
+        field: 'days',
+    },
+    {
+        long: '--allow-drop',
+        help: 'Allow dropping entries the Cloud map has and the local map does not',
+        commands: ['maps update'],
+        field: 'allowDrop',
+    },
+    {
+        long: '--quiet',
+        short: '-q',
+        help: 'Suppress the all-clear summary (findings always show)',
+        commands: ['scrub', 'restore', 'scan'],
+        field: 'quiet',
+    },
+    {
+        long: '--device',
+        help: 'Sign in through a browser instead of typing a password here. Required for an SSO-bound account, and used automatically when the instance asks for a CAPTCHA',
+        commands: ['login'],
+        field: 'device',
+    },
+    {
+        long: '--instance',
+        value: '<url>',
+        help: 'The Veilio instance to sign in to. Defaults to the public Cloud; https required (localhost excepted)',
+        // Only `login` reads it. Every later command takes the instance from the
+        // stored sign-in, so a command cannot be pointed at another host while it
+        // holds the first one's token. Accepting it elsewhere would let
+        // `veilio whoami --instance …` look like a check of that host.
+        commands: ['login'],
+        field: 'instance',
+    },
+    { long: '--help', short: '-h', help: 'Show this help', commands: 'all' },
+    { long: '--version', short: '-v', help: 'Show the version', commands: 'all' },
+];
+const BY_SPELLING = new Map();
+for (const f of FLAGS) {
+    BY_SPELLING.set(f.long, f);
+    if (f.short)
+        BY_SPELLING.set(f.short, f);
+}
+/** The flag a spelling (`-l` or `--language`) names, if any. */
+export function flagFor(spelling) {
+    return BY_SPELLING.get(spelling);
+}
+export function belongsTo(flag, command) {
+    return flag.commands === 'all' || flag.commands.includes(command);
+}
+/** The flags a command takes, the ones for every command included. */
+export function flagsOf(command) {
+    return FLAGS.filter((f) => belongsTo(f, command));
+}
+/** `--language (-l)`, for an error message. */
+export function spell(flag) {
+    return flag.short ? `${flag.long} (${flag.short})` : flag.long;
+}
+/** Every line of `--help` fits in this many columns. */
+export const HELP_WIDTH = 80;
+/** Words of `text`, in lines no wider than `width`. */
+export function wrap(text, width) {
+    const lines = [];
+    let line = '';
+    for (const word of text.split(/\s+/).filter(Boolean)) {
+        if (line && line.length + 1 + word.length > width) {
+            lines.push(line);
+            line = word;
+        }
+        else
+            line = line ? `${line} ${word}` : word;
+    }
+    if (line)
+        lines.push(line);
+    return lines;
+}
+/** A two-column block: each name, then its text wrapped under a column. */
+function columns(rows, column) {
+    const out = [];
+    for (const { name, text } of rows) {
+        const body = wrap(text, HELP_WIDTH - column);
+        const first = name.length + 2 < column ? `  ${name.padEnd(column - 2)}${body[0] ?? ''}` : `  ${name}`;
+        out.push(first);
+        const rest = name.length + 2 < column ? body.slice(1) : body;
+        for (const line of rest)
+            out.push(`${' '.repeat(column)}${line}`);
+    }
+    return out.join('\n');
+}
+const OPTION_COLUMN = 26;
+const COMMAND_COLUMN = 23;
+function optionName(f) {
+    return `${f.short ? `${f.short}, ` : '    '}${f.long}${f.value ? ` ${f.value}` : ''}`;
+}
+/** The OPTIONS block for some flags: each flag, its text, and the commands
+ *  it belongs to, every line within HELP_WIDTH. */
+export function optionsHelp(flags = FLAGS) {
+    const out = [];
+    for (const f of flags) {
+        out.push(columns([{ name: optionName(f), text: f.help }], OPTION_COLUMN));
+        if (f.commands !== 'all') {
+            const forLines = wrap(`For: ${f.commands.join(', ')}`, HELP_WIDTH - OPTION_COLUMN);
+            for (const line of forLines)
+                out.push(`${' '.repeat(OPTION_COLUMN)}${line}`);
+        }
+    }
+    return out.join('\n');
+}
+/** The COMMANDS block for some commands. */
+export function commandsHelp(specs) {
+    return columns(specs.flatMap((c) => c.help.map((h) => ({ name: h.usage, text: h.text }))), COMMAND_COLUMN);
+}
+/** The COMMANDS section of the general help: the offline commands, a note,
+ *  then the ones that reach the network. */
+export function allCommandsHelp() {
+    const offline = COMMAND_SPECS.filter((c) => !c.cloud);
+    const cloud = COMMAND_SPECS.filter((c) => c.cloud);
+    const note = wrap('Everything above works offline, with no account. The commands below connect a Veilio Cloud subscription and are the only ones that touch the network.', HELP_WIDTH - 2)
+        .map((l) => `  ${l}`)
+        .join('\n');
+    return `${commandsHelp(offline)}\n\n${note}\n\n${commandsHelp(cloud)}`;
+}
+/** `veilio scrub --help`: that command's lines and its own options. For a
+ *  group with no action (`veilio maps --help`), every action of the group. */
+export function commandHelp(topic) {
+    const specs = COMMAND_SPECS.filter((c) => c.key === topic || c.key.startsWith(`${topic} `));
+    const keys = specs.map((c) => c.key);
+    const flags = FLAGS.filter((f) => keys.some((k) => belongsTo(f, k)));
+    return (`${BIN_NAME} ${topic}\n\nUSAGE\n${specs
+        .flatMap((c) => c.help.map((h) => `  ${BIN_NAME} ${h.usage}`))
+        .join('\n')}\n\n` + `COMMANDS\n${commandsHelp(specs)}\n\nOPTIONS\n${optionsHelp(flags)}\n`);
+}
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAWxD,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE;YACJ,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,qDAAqD,EAAE;YACtF;gBACE,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,wGAAwG,SAAS,YAAY;aACpI;SACF;KACF;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,oBAAoB;gBAC3B,IAAI,EAAE,sDAAsD;aAC7D;SACF;KACF;IACD;QACE,GAAG,EAAE,MAAM;QACX,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,uIAAuI;aAC9I;SACF;KACF;IACD;QACE,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,mDAAmD,EAAE,CAAC;KACpF;IACD;QACE,GAAG,EAAE,OAAO;QACZ,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,yFAAyF;aAChG;SACF;KACF;IACD;QACE,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAAC;KACnF;IACD;QACE,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,sGAAsG;aAC7G;SACF;KACF;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,4CAA4C,EAAE,CAAC;KACnF;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,+JAA+J;aACtK;SACF;KACF;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,mDAAmD;aAC1D;YACD,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,8CAA8C,EAAE;SACpF;KACF;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,gJAAgJ;aACvJ;SACF;KACF;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;KACpE;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,yKAAyK;aAChL;SACF;KACF;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,kDAAkD,EAAE,CAAC;KACzF;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,cAAc;gBACrB,IAAI,EAAE,oNAAoN;aAC3N;SACF;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,iDAAiD,EAAE,CAAC;KACzF;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,0GAA0G;aACjH;SACF;KACF;IACD;QACE,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;KACpE;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,qBAAqB;gBAC5B,IAAI,EAAE,iNAAiN;aACxN;SACF;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ;gBACE,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,gHAAgH;aACvH;SACF;KACF;CACwC,CAAA;AAgB3C,MAAM,CAAC,MAAM,YAAY,GAA0B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAElF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACrD,CAAA;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAQ,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAC3D,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC/B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;QACxE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AACxB,CAAC;AAeD,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,+EAA+E;QACrF,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,UAAU;KAClB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,SAAS;KACjB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,uDAAuD;QAC7D,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,UAAU;KAClB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC;QAC9E,KAAK,EAAE,SAAS;KACjB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM;KACd;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,wGAAwG;QAC9G,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAC7B,KAAK,EAAE,QAAQ;KAChB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,mCAAmC;QACzC,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,KAAK,EAAE,UAAU;KAClB;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,KAAK,EAAE,OAAO;KACf;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,oDAAoD;QAC1D,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QAChC,KAAK,EAAE,OAAO;KACf;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,kJAAkJ;QACxJ,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QAChC,KAAK,EAAE,MAAM;KACd;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,iDAAiD;QACvD,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;QACzC,KAAK,EAAE,MAAM;KACd;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,qEAAqE;QAC3E,QAAQ,EAAE,CAAC,aAAa,CAAC;QACzB,KAAK,EAAE,WAAW;KACnB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,uDAAuD;QAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;QACtC,KAAK,EAAE,OAAO;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,6JAA6J;QACnK,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,QAAQ;KAChB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,sGAAsG;QAC5G,yEAAyE;QACzE,0EAA0E;QAC1E,gEAAgE;QAChE,+DAA+D;QAC/D,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,UAAU;KAClB;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC9E,CAAA;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAA;AAC/C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;IACtB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC1B,IAAI,CAAC,CAAC,KAAK;QAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,OAAmB;IAC3D,OAAO,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACnE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,OAAmB;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,KAAK,CAAC,IAAc;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;AAChE,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAA;AAE5B,uDAAuD;AACvD,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAa;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChB,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;;YAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC/C,CAAC;IACD,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,KAAK,CAAA;AACd,CAAC;AAED,2EAA2E;AAC3E,SAAS,OAAO,CAAC,IAA+C,EAAE,MAAc;IAC9E,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,CAAA;QAC5C,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAA;QACzF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC5D,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,aAAa,GAAG,EAAE,CAAA;AACxB,MAAM,cAAc,GAAG,EAAE,CAAA;AAEzB,SAAS,UAAU,CAAC,CAAW;IAC7B,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AACvF,CAAC;AAED;mDACmD;AACnD,MAAM,UAAU,WAAW,CAAC,QAA6B,KAAK;IAC5D,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAA;QACzE,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,CAAC,CAAA;YAClF,KAAK,MAAM,IAAI,IAAI,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,KAA6B;IACxD,OAAO,OAAO,CACZ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAC1E,cAAc,CACf,CAAA;AACH,CAAC;AAED;4CAC4C;AAC5C,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG,IAAI,CACf,uJAAuJ,EACvJ,UAAU,GAAG,CAAC,CACf;SACE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;SACpB,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAA;AACxE,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAA;IAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,OAAO,CACL,GAAG,QAAQ,IAAI,KAAK,cAAc,KAAK;SACpC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,YAAY,CAAC,KAAK,CAAC,gBAAgB,WAAW,CAAC,KAAK,CAAC,IAAI,CAC7F,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
+import { type ParsedArgs } from './args.js';
 import { type Io } from './commands.js';
 import { VERSION } from './version.js';
 export { VERSION };
 /** Testable entry point: everything that touches the process is injected. */
 export declare function main(argv: readonly string[], io: Io): Promise<number>;
+/**
+ * Run parsed arguments. Separate from \`main\` so a test can hand it \`args\`
+ * wrapped in a Proxy and see every field each command reads.
+ */
+export declare function run(args: ParsedArgs, io: Io): Promise<number>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAA2D,KAAK,EAAE,EAAE,MAAM,eAAe,CAAA;AAyBhG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAE,CAAA;AAElB,6EAA6E;AAC7E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwF3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAE/E,OAAO,EAA2D,KAAK,EAAE,EAAE,MAAM,eAAe,CAAA;AA0BhG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAE,CAAA;AAElB,6EAA6E;AAC7E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3E;AAED;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+EnE"}