incur 0.4.0 → 0.4.2

package/dist/internal/command.d.ts

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import type { FieldError } from '../Errors.js';
+import type { Handler as MiddlewareHandler } from '../middleware.js';
+/** @internal CTA block for command output. */
+export type CtaBlock = {
+    commands: unknown[];
+    description?: string | undefined;
+};
+/** @internal Unified command execution used by CLI, HTTP, and MCP transports. */
+export declare function execute(command: any, options: execute.Options): Promise<execute.Result>;
+export declare namespace execute {
+    /** Options for the unified execute function. */
+    type Options = {
+        /** Whether the consumer is an agent. */
+        agent: boolean;
+        /** Raw positional tokens (already separated from flags). For HTTP/MCP, pass `[]`. */
+        argv: string[];
+        /** Default option values from config file. */
+        defaults?: Record<string, unknown> | undefined;
+        /** The resolved binary name the user invoked (e.g. an alias). Falls back to `name`. */
+        displayName?: string | undefined;
+        /** CLI-level env schema. */
+        env?: z.ZodObject<any> | undefined;
+        /** Source for environment variables. Defaults to `process.env`. */
+        envSource?: Record<string, string | undefined> | undefined;
+        /** The resolved output format. */
+        format: string;
+        /** Whether the format was explicitly requested. */
+        formatExplicit: boolean;
+        /** Raw parsed options (from query params, JSON body, or MCP params). For CLI, pass `{}`. */
+        inputOptions: Record<string, unknown>;
+        /** Middleware handlers (root + group + command, already collected). */
+        middlewares?: MiddlewareHandler[] | undefined;
+        /** The CLI name. */
+        name: string;
+        /**
+         * How to parse input:
+         * - `'argv'` (default): parse both args and options from argv tokens (CLI mode)
+         * - `'split'`: args from argv, options from inputOptions (HTTP mode)
+         * - `'flat'`: all params from inputOptions, split by schema shapes (MCP mode)
+         */
+        parseMode?: 'argv' | 'split' | 'flat' | undefined;
+        /** The resolved command path. */
+        path: string;
+        /** Vars schema for middleware variables. */
+        vars?: z.ZodObject<any> | undefined;
+        /** CLI version string. */
+        version: string | undefined;
+    };
+    /** Result of executing a command. */
+    type Result = {
+        ok: true;
+        data: unknown;
+        cta?: CtaBlock | undefined;
+    } | {
+        ok: false;
+        error: {
+            code: string;
+            message: string;
+            retryable?: boolean | undefined;
+            fieldErrors?: FieldError[] | undefined;
+        };
+        cta?: CtaBlock | undefined;
+        exitCode?: number | undefined;
+    } | {
+        stream: AsyncGenerator<unknown, unknown, unknown>;
+    };
+}
+/** Common metadata shared by command definitions and built-in commands. */
+export type CommandMeta<options extends z.ZodObject<any> | undefined = undefined> = {
+    /** Map of option names to single-char aliases. */
+    alias?: options extends z.ZodObject<any> ? Partial<Record<keyof z.output<options>, string>> : Record<string, string> | undefined;
+    /** A short description of what the command does. */
+    description?: string | undefined;
+    /** Zod schema for named options/flags. */
+    options?: options | undefined;
+};
+/** Supported shell names for completions. */
+export declare const shells: readonly ["bash", "fish", "nushell", "zsh"];
+/** A supported shell name. */
+export type Shell = (typeof shells)[number];
+/** Built-in command metadata shared by help, completions, and handler logic. */
+export declare const builtinCommands: ({
+    name: string;
+    description: string;
+    args: z.ZodObject<{
+        shell: z.ZodEnum<{
+            bash: "bash";
+            fish: "fish";
+            nushell: "nushell";
+            zsh: "zsh";
+        }>;
+    }, z.core.$strip>;
+    hint(name: string): string;
+    subcommands?: undefined;
+    aliases?: undefined;
+} | {
+    name: string;
+    description: string;
+    subcommands: (CommandMeta<z.ZodObject<{
+        agent: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        noGlobal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>> & {
+        name: string;
+    })[];
+    args?: undefined;
+    hint?: undefined;
+    aliases?: undefined;
+} | {
+    name: string;
+    aliases: string[];
+    description: string;
+    subcommands: ((CommandMeta<z.ZodObject<{
+        depth: z.ZodOptional<z.ZodNumber>;
+        noGlobal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>> & {
+        name: string;
+    }) | (CommandMeta<z.ZodObject<any, z.core.$strip>> & {
+        name: string;
+    }))[];
+    args?: undefined;
+    hint?: undefined;
+})[];
+/** @internal Finds a builtin command by its name or alias. */
+export declare function findBuiltin(token: string): {
+    name: string;
+    description: string;
+    args: z.ZodObject<{
+        shell: z.ZodEnum<{
+            bash: "bash";
+            fish: "fish";
+            nushell: "nushell";
+            zsh: "zsh";
+        }>;
+    }, z.core.$strip>;
+    hint(name: string): string;
+    subcommands?: undefined;
+    aliases?: undefined;
+} | {
+    name: string;
+    description: string;
+    subcommands: (CommandMeta<z.ZodObject<{
+        agent: z.ZodOptional<z.ZodString>;
+        command: z.ZodOptional<z.ZodString>;
+        noGlobal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>> & {
+        name: string;
+    })[];
+    args?: undefined;
+    hint?: undefined;
+    aliases?: undefined;
+} | {
+    name: string;
+    aliases: string[];
+    description: string;
+    subcommands: ((CommandMeta<z.ZodObject<{
+        depth: z.ZodOptional<z.ZodNumber>;
+        noGlobal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>> & {
+        name: string;
+    }) | (CommandMeta<z.ZodObject<any, z.core.$strip>> & {
+        name: string;
+    }))[];
+    args?: undefined;
+    hint?: undefined;
+} | undefined;
+/** @internal Checks if a token matches a builtin command by name or alias. */
+export declare function isBuiltin(token: string): boolean;
+//# sourceMappingURL=command.d.ts.map

package/dist/internal/command.d.ts.map

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

package/dist/internal/command.js

@@ -0,0 +1,292 @@
+import { z } from 'zod';
+import { IncurError, ValidationError } from '../Errors.js';
+import * as Parser from '../Parser.js';
+/** @internal Sentinel symbol for `ok()` and `error()` return values. */
+const sentinel = Symbol.for('incur.sentinel');
+/** @internal Unified command execution used by CLI, HTTP, and MCP transports. */
+export async function execute(command, options) {
+    const { argv, inputOptions, agent, format, formatExplicit, name, path, version, envSource = process.env, env: envSchema, vars: varsSchema, middlewares = [], } = options;
+    const displayName = options.displayName ?? name;
+    const parseMode = options.parseMode ?? 'argv';
+    const varsMap = varsSchema ? varsSchema.parse({}) : {};
+    let result;
+    // For streaming with middleware: runCommand suspends on streamConsumed so middleware "after"
+    // runs after the stream is consumed. The wrapped generator resolves it in its finally block.
+    // resultReady signals that result has been set (for streams, before the chain finishes).
+    let streamConsumed;
+    let resolveStreamConsumed;
+    let resolveResultReady;
+    const resultReady = new Promise((r) => {
+        resolveResultReady = r;
+    });
+    const runCommand = async () => {
+        // Parse args and options
+        let args;
+        let parsedOptions;
+        if (parseMode === 'argv') {
+            // CLI mode: parse both args and options from argv tokens
+            const parsed = Parser.parse(argv, {
+                alias: command.alias,
+                args: command.args,
+                defaults: options.defaults,
+                options: command.options,
+            });
+            args = parsed.args;
+            parsedOptions = parsed.options;
+        }
+        else if (parseMode === 'split') {
+            // HTTP mode: positional args from URL path segments, options from body/query
+            const parsed = Parser.parse(argv, { args: command.args });
+            args = parsed.args;
+            parsedOptions = command.options ? command.options.parse(inputOptions) : {};
+        }
+        else {
+            // MCP mode: all params come from inputOptions, split into args vs options
+            const split = splitParams(inputOptions, command);
+            args = command.args ? command.args.parse(split.args) : {};
+            parsedOptions = command.options ? command.options.parse(split.options) : {};
+        }
+        // Parse env
+        const commandEnv = command.env ? Parser.parseEnv(command.env, envSource) : {};
+        // Build sentinel helpers
+        const okFn = (data, meta = {}) => ({ [sentinel]: 'ok', data, cta: meta.cta });
+        const errorFn = (opts) => ({ [sentinel]: 'error', ...opts });
+        const raw = command.run({
+            agent,
+            args,
+            displayName,
+            env: commandEnv,
+            error: errorFn,
+            format,
+            formatExplicit,
+            name,
+            ok: okFn,
+            options: parsedOptions,
+            var: varsMap,
+            version,
+        });
+        // Streaming: wrap the generator so middleware "after" runs after consumption.
+        // When middleware is active, runCommand suspends until the stream is fully consumed,
+        // keeping the middleware chain alive around the stream's lifetime.
+        if (isAsyncGenerator(raw)) {
+            if (middlewares.length > 0) {
+                streamConsumed = new Promise((r) => {
+                    resolveStreamConsumed = r;
+                });
+                async function* wrapped() {
+                    try {
+                        yield* raw;
+                    }
+                    finally {
+                        resolveStreamConsumed();
+                    }
+                }
+                result = { stream: wrapped() };
+                resolveResultReady();
+                await streamConsumed;
+            }
+            else {
+                result = { stream: raw };
+            }
+            return;
+        }
+        const awaited = await raw;
+        if (isSentinel(awaited)) {
+            if (awaited[sentinel] === 'ok') {
+                const ok = awaited;
+                result = { ok: true, data: ok.data, ...(ok.cta ? { cta: ok.cta } : undefined) };
+            }
+            else {
+                const err = awaited;
+                result = {
+                    ok: false,
+                    error: {
+                        code: err.code,
+                        message: err.message,
+                        ...(err.retryable !== undefined ? { retryable: err.retryable } : undefined),
+                    },
+                    ...(err.cta ? { cta: err.cta } : undefined),
+                    ...(err.exitCode !== undefined ? { exitCode: err.exitCode } : undefined),
+                };
+            }
+            return;
+        }
+        result = { ok: true, data: awaited };
+    };
+    try {
+        // Parse CLI-level env
+        const cliEnv = envSchema ? Parser.parseEnv(envSchema, envSource) : {};
+        if (middlewares.length > 0) {
+            const errorFn = (opts) => {
+                // Side-effect: set result directly (handles both `return c.error()` and bare `c.error()`)
+                result = {
+                    ok: false,
+                    error: {
+                        code: opts.code,
+                        message: opts.message,
+                        ...(opts.retryable !== undefined ? { retryable: opts.retryable } : undefined),
+                    },
+                    ...(opts.cta ? { cta: opts.cta } : undefined),
+                    ...(opts.exitCode !== undefined ? { exitCode: opts.exitCode } : undefined),
+                };
+                return undefined;
+            };
+            const mwCtx = {
+                agent,
+                command: path,
+                displayName,
+                env: cliEnv,
+                error: errorFn,
+                format: format,
+                formatExplicit,
+                name,
+                set(key, value) {
+                    varsMap[key] = value;
+                },
+                var: varsMap,
+                version,
+            };
+            const composed = middlewares.reduceRight((next, mw) => async () => {
+                await mw(mwCtx, next);
+            }, runCommand);
+            // Start the chain and race against resultReady. For streams with middleware,
+            // runCommand suspends on streamConsumed (keeping middleware "after" deferred)
+            // but signals resultReady so we can return the stream immediately. The transport
+            // consumes the stream, which resolves streamConsumed, letting middleware "after" run.
+            const chainPromise = composed();
+            await Promise.race([chainPromise, resultReady]);
+            if (streamConsumed)
+                return result;
+            await chainPromise;
+        }
+        else {
+            await runCommand();
+        }
+    }
+    catch (error) {
+        if (error instanceof ValidationError)
+            return {
+                ok: false,
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: error.message,
+                    fieldErrors: error.fieldErrors,
+                },
+            };
+        return {
+            ok: false,
+            error: {
+                code: error instanceof IncurError ? error.code : 'UNKNOWN',
+                message: error instanceof Error ? error.message : String(error),
+                ...(error instanceof IncurError ? { retryable: error.retryable } : undefined),
+            },
+            ...(error instanceof IncurError && error.exitCode !== undefined
+                ? { exitCode: error.exitCode }
+                : undefined),
+        };
+    }
+    return result ?? { ok: true, data: undefined };
+}
+/** @internal Splits flat params into args vs options using schema shapes. */
+function splitParams(params, command) {
+    const argKeys = new Set(command.args ? Object.keys(command.args.shape) : []);
+    const a = {};
+    const o = {};
+    for (const [key, value] of Object.entries(params))
+        if (argKeys.has(key))
+            a[key] = value;
+        else
+            o[key] = value;
+    return { args: a, options: o };
+}
+/** @internal Type guard for sentinel results. */
+function isSentinel(value) {
+    return typeof value === 'object' && value !== null && sentinel in value;
+}
+/** @internal Type guard for async generators. */
+function isAsyncGenerator(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        Symbol.asyncIterator in value &&
+        typeof value.next === 'function');
+}
+/** @internal Creates a builtin subcommand with typesafe alias inference. */
+function subcommand(def) {
+    return def;
+}
+/** Supported shell names for completions. */
+export const shells = ['bash', 'fish', 'nushell', 'zsh'];
+/** Built-in command metadata shared by help, completions, and handler logic. */
+export const builtinCommands = [
+    {
+        name: 'completions',
+        description: 'Generate shell completion script',
+        args: z.object({
+            shell: z.enum(shells).describe('Shell to generate completions for'),
+        }),
+        hint(name) {
+            const rows = [
+                ['bash', `eval "$(${name} completions bash)"`, '# add to ~/.bashrc'],
+                ['fish', `${name} completions fish | source`, '# add to ~/.config/fish/config.fish'],
+                ['nushell', `see \`${name} completions nushell\``, '# add to config.nu'],
+                ['zsh', `eval "$(${name} completions zsh)"`, '# add to ~/.zshrc'],
+            ];
+            const shellW = Math.max(...rows.map((r) => r[0].length));
+            const cmdW = Math.max(...rows.map((r) => r[1].length));
+            return ('Setup:\n' +
+                rows
+                    .map(([s, cmd, comment]) => `  ${s.padEnd(shellW)}  ${cmd.padEnd(cmdW)}  ${comment}`)
+                    .join('\n'));
+        },
+    },
+    {
+        name: 'mcp',
+        description: 'Register as MCP server',
+        subcommands: [
+            subcommand({
+                name: 'add',
+                description: 'Register as MCP server',
+                alias: { command: 'c' },
+                options: z.object({
+                    agent: z
+                        .string()
+                        .optional()
+                        .describe('Target a specific agent (e.g. claude-code, cursor)'),
+                    command: z
+                        .string()
+                        .optional()
+                        .describe('Override the command agents will run (e.g. "pnpm my-cli --mcp")'),
+                    noGlobal: z.boolean().optional().describe('Install to project instead of globally'),
+                }),
+            }),
+        ],
+    },
+    {
+        name: 'skills',
+        aliases: ['skill'],
+        description: 'Sync skill files to agents',
+        subcommands: [
+            subcommand({
+                name: 'add',
+                description: 'Sync skill files to agents',
+                options: z.object({
+                    depth: z.number().optional().describe('Grouping depth for skill files (default: 1)'),
+                    noGlobal: z.boolean().optional().describe('Install to project instead of globally'),
+                }),
+            }),
+            subcommand({
+                name: 'list',
+                description: 'List skills',
+            }),
+        ],
+    },
+];
+/** @internal Finds a builtin command by its name or alias. */
+export function findBuiltin(token) {
+    return builtinCommands.find((b) => b.name === token || b.aliases?.includes(token));
+}
+/** @internal Checks if a token matches a builtin command by name or alias. */
+export function isBuiltin(token) {
+    return builtinCommands.some((b) => b.name === token || b.aliases?.includes(token));
+}
+//# sourceMappingURL=command.js.map

package/dist/internal/command.js.map

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

package/dist/internal/configSchema.d.ts

@@ -0,0 +1,8 @@
+import * as Cli from '../Cli.js';
+/** Returns `true` if the CLI has `config` enabled on `Cli.create()`. */
+export declare function hasConfig(cli: Cli.Cli): boolean;
+/** Imports a CLI from `input` (must `export default` a `Cli`), generates the JSON Schema, and writes it to `output`. */
+export declare function generate(input: string, output: string): Promise<void>;
+/** Generates a JSON Schema describing the config file structure for a CLI. */
+export declare function fromCli(cli: Cli.Cli): Record<string, unknown>;
+//# sourceMappingURL=configSchema.d.ts.map

package/dist/internal/configSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.d.ts","sourceRoot":"","sources":["../../src/internal/configSchema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAIhC,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAE/C;AAED,wHAAwH;AACxH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU7D"}

package/dist/internal/configSchema.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs/promises';
+import * as Cli from '../Cli.js';
+import * as Schema from '../Schema.js';
+import { importCli } from './utils.js';
+/** Returns `true` if the CLI has `config` enabled on `Cli.create()`. */
+export function hasConfig(cli) {
+    return Cli.toConfigEnabled.get(cli) === true;
+}
+/** Imports a CLI from `input` (must `export default` a `Cli`), generates the JSON Schema, and writes it to `output`. */
+export async function generate(input, output) {
+    const cli = await importCli(input);
+    await fs.writeFile(output, JSON.stringify(fromCli(cli), null, 2) + '\n');
+}
+/** Generates a JSON Schema describing the config file structure for a CLI. */
+export function fromCli(cli) {
+    const commands = Cli.toCommands.get(cli);
+    if (!commands)
+        return { type: 'object' };
+    const rootOptions = Cli.toRootOptions.get(cli);
+    const node = buildNode(commands, rootOptions);
+    const properties = (node.properties ?? {});
+    properties.$schema = { type: 'string' };
+    node.properties = properties;
+    return node;
+}
+/** Builds a JSON Schema node for a command level. */
+function buildNode(commands, options) {
+    const properties = {};
+    // Add `options` property from the options schema
+    if (options) {
+        const optSchema = Schema.toJsonSchema(options);
+        const props = optSchema.properties;
+        if (props && Object.keys(props).length > 0)
+            properties.options = { type: 'object', additionalProperties: false, properties: props };
+    }
+    // Add `commands` property with subcommand namespaces
+    const commandProps = {};
+    for (const [name, entry] of commands) {
+        if ('_group' in entry && entry._group) {
+            commandProps[name] = buildNode(entry.commands, undefined);
+        }
+        else if (!('_fetch' in entry)) {
+            const cmd = entry;
+            commandProps[name] = buildNode(new Map(), cmd.options);
+        }
+    }
+    if (Object.keys(commandProps).length > 0)
+        properties.commands = { type: 'object', additionalProperties: false, properties: commandProps };
+    const node = {
+        type: 'object',
+        additionalProperties: false,
+    };
+    if (Object.keys(properties).length > 0)
+        node.properties = properties;
+    return node;
+}
+//# sourceMappingURL=configSchema.js.map

package/dist/internal/configSchema.js.map

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

package/dist/internal/dereference.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Dereferences all local `$ref` pointers in a JSON object (e.g. `{"$ref": "#/components/schemas/User"}`),
+ * replacing them inline with the resolved values. Only handles local (`#/...`) references.
+ *
+ * Handles circular references by caching a mutable placeholder before recursing.
+ *
+ * Minimal reimplementation of the dereferencing behavior from `@apidevtools/json-schema-ref-parser`
+ * (https://github.com/APIDevTools/json-schema-ref-parser). Only supports in-memory, local-pointer
+ * resolution — no file/URL resolution, no `$id` scoping.
+ */
+export declare function dereference<value>(root: value): value;
+//# sourceMappingURL=dereference.d.ts.map

package/dist/internal/dereference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dereference.d.ts","sourceRoot":"","sources":["../../src/internal/dereference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CAGrD"}

package/dist/internal/dereference.js

@@ -0,0 +1,71 @@
+/**
+ * Dereferences all local `$ref` pointers in a JSON object (e.g. `{"$ref": "#/components/schemas/User"}`),
+ * replacing them inline with the resolved values. Only handles local (`#/...`) references.
+ *
+ * Handles circular references by caching a mutable placeholder before recursing.
+ *
+ * Minimal reimplementation of the dereferencing behavior from `@apidevtools/json-schema-ref-parser`
+ * (https://github.com/APIDevTools/json-schema-ref-parser). Only supports in-memory, local-pointer
+ * resolution — no file/URL resolution, no `$id` scoping.
+ */
+export function dereference(root) {
+    const cache = new Map();
+    return walk(root, root, cache);
+}
+function walk(node, root, cache) {
+    if (Array.isArray(node))
+        return node.map((item) => walk(item, root, cache));
+    if (typeof node !== 'object' || node === null)
+        return node;
+    const obj = node;
+    // Resolve $ref pointer
+    if (typeof obj.$ref === 'string' && obj.$ref.startsWith('#')) {
+        const ref = obj.$ref;
+        if (cache.has(ref))
+            return cache.get(ref);
+        const resolved = resolvePointer(root, ref);
+        // Non-object targets (primitives, arrays) can't be circular — resolve directly
+        if (typeof resolved !== 'object' || resolved === null || Array.isArray(resolved)) {
+            const dereferenced = walk(resolved, root, cache);
+            cache.set(ref, dereferenced);
+            return dereferenced;
+        }
+        // Use a mutable placeholder so circular refs resolve to the same object.
+        // If the walked result is not a plain object (e.g. chained ref to primitive/array),
+        // skip the placeholder and cache directly.
+        const placeholder = {};
+        cache.set(ref, placeholder);
+        const dereferenced = walk(resolved, root, cache);
+        if (typeof dereferenced !== 'object' || dereferenced === null || Array.isArray(dereferenced)) {
+            cache.set(ref, dereferenced);
+            return dereferenced;
+        }
+        Object.assign(placeholder, dereferenced);
+        return placeholder;
+    }
+    const result = {};
+    for (const key of Object.keys(obj))
+        result[key] = walk(obj[key], root, cache);
+    return result;
+}
+/** Resolves a JSON Pointer (e.g. `#/components/schemas/User`) against a root object. */
+function resolvePointer(root, pointer) {
+    // "#" or "#/" → root
+    const fragment = pointer.slice(1);
+    if (fragment === '' || fragment === '/')
+        return root;
+    const parts = fragment
+        .slice(1)
+        .split('/')
+        .map((p) => p.replace(/~1/g, '/').replace(/~0/g, '~'));
+    let current = root;
+    for (const part of parts) {
+        if (typeof current !== 'object' || current === null)
+            throw new Error(`Cannot resolve $ref "${pointer}": path segment "${part}" not found`);
+        current = current[part];
+        if (current === undefined)
+            throw new Error(`Cannot resolve $ref "${pointer}": "${part}" not found`);
+    }
+    return current;
+}
+//# sourceMappingURL=dereference.js.map

package/dist/internal/dereference.js.map

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