incur 0.0.0 → 0.0.2

package/dist/SyncSkills.js

@@ -0,0 +1,163 @@
+import { execFile } from 'node:child_process';
+import fsSync from 'node:fs';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { formatExamples } from './Cli.js';
+import { detectRunner } from './internal/pm.js';
+import * as Skill from './Skill.js';
+/** Generates skill files from a command map and installs them via `skills add`. */
+export async function sync(name, commands, options = {}) {
+    const cwd = options.cwd ?? resolvePackageRoot();
+    const { depth = 1, description, global = true } = options;
+    const groups = new Map();
+    if (description)
+        groups.set(name, description);
+    const entries = collectEntries(commands, [], groups);
+    const files = Skill.split(name, entries, depth, groups);
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), `incur-skills-${name}-`));
+    try {
+        const skills = [];
+        for (const file of files) {
+            const filePath = file.dir
+                ? path.join(tmpDir, file.dir, 'SKILL.md')
+                : path.join(tmpDir, 'SKILL.md');
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.writeFile(filePath, `${file.content}\n`);
+            const descMatch = file.content.match(/^description:\s*(.+)$/m);
+            skills.push({ name: file.dir || name, description: descMatch?.[1] });
+        }
+        // Include additional SKILL.md files matched by glob patterns
+        if (options.include) {
+            for (const pattern of options.include) {
+                const globPattern = pattern === '_root' ? 'SKILL.md' : path.join(pattern, 'SKILL.md');
+                for await (const match of fs.glob(globPattern, { cwd })) {
+                    try {
+                        const content = await fs.readFile(path.resolve(cwd, match), 'utf8');
+                        const nameMatch = content.match(/^name:\s*(.+)$/m);
+                        const skillName = pattern === '_root' ? (nameMatch?.[1] ?? name) : path.basename(path.dirname(match));
+                        const dest = path.join(tmpDir, skillName, 'SKILL.md');
+                        await fs.mkdir(path.dirname(dest), { recursive: true });
+                        await fs.writeFile(dest, content);
+                        if (!skills.some((s) => s.name === skillName)) {
+                            const descMatch = content.match(/^description:\s*(.+)$/m);
+                            skills.push({ name: skillName, description: descMatch?.[1], external: true });
+                        }
+                    }
+                    catch { }
+                }
+            }
+        }
+        const runner = options.runner ?? detectRunner();
+        const [cmd, ...prefix] = runner.split(' ');
+        const flags = ['--yes', ...(global ? ['--global'] : [])];
+        const { stdout } = await exec(cmd, [...prefix, 'skills', 'add', tmpDir, ...flags]);
+        // Extract installed paths from `skills add` output (lines like "✓ ~/path/to/skill")
+        const paths = stdout
+            .split('\n')
+            .filter((l) => l.includes('✓'))
+            .map((l) => l
+            .replace(/.*✓\s*/, '')
+            .replace(/[│┃|]/g, '')
+            .trim())
+            .filter(Boolean);
+        // Write skills hash for staleness detection
+        const entries = collectEntries(commands, []);
+        writeHash(name, Skill.hash(entries));
+        return { skills, paths };
+    }
+    finally {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    }
+}
+/** Recursively collects leaf commands as `Skill.CommandInfo`. */
+function collectEntries(commands, prefix, groups = new Map()) {
+    const result = [];
+    for (const [name, entry] of commands) {
+        const entryPath = [...prefix, name];
+        if ('_group' in entry && entry._group) {
+            if (entry.description)
+                groups.set(entryPath.join(' '), entry.description);
+            result.push(...collectEntries(entry.commands, entryPath, groups));
+        }
+        else {
+            const cmd = { name: entryPath.join(' ') };
+            if (entry.description)
+                cmd.description = entry.description;
+            if (entry.args)
+                cmd.args = entry.args;
+            if (entry.env)
+                cmd.env = entry.env;
+            if (entry.hint)
+                cmd.hint = entry.hint;
+            if (entry.options)
+                cmd.options = entry.options;
+            if (entry.output)
+                cmd.output = entry.output;
+            const examples = formatExamples(entry.examples);
+            if (examples) {
+                const cmdName = entryPath.join(' ');
+                cmd.examples = examples.map((e) => ({
+                    ...e,
+                    command: e.command ? `${cmdName} ${e.command}` : cmdName,
+                }));
+            }
+            result.push(cmd);
+        }
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Resolves the package root from the executing bin script (`process.argv[1]`). Walks up from the bin's directory looking for `package.json`. Falls back to `process.cwd()`. */
+function resolvePackageRoot() {
+    const bin = process.argv[1];
+    if (!bin)
+        return process.cwd();
+    let dir = path.dirname(fsSync.realpathSync(bin));
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        try {
+            fsSync.accessSync(path.join(dir, 'package.json'));
+            return dir;
+        }
+        catch { }
+        dir = path.dirname(dir);
+    }
+    return process.cwd();
+}
+/** Returns the hash file path for a CLI. */
+function hashPath(name) {
+    const dir = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+    return path.join(dir, 'incur', `${name}.json`);
+}
+/** @internal Writes the skills hash for staleness detection. */
+function writeHash(name, hash) {
+    const file = hashPath(name);
+    const dir = path.dirname(file);
+    if (!fsSync.existsSync(dir))
+        fsSync.mkdirSync(dir, { recursive: true });
+    fsSync.writeFileSync(file, JSON.stringify({ hash, at: new Date().toISOString() }) + '\n');
+}
+/** Reads the stored skills hash for a CLI. Returns `undefined` if no hash exists. */
+export function readHash(name) {
+    try {
+        const data = JSON.parse(fsSync.readFileSync(hashPath(name), 'utf-8'));
+        return data.hash;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Promisified execFile with stderr in error message. */
+function exec(cmd, args) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, (error, stdout, stderr) => {
+            if (error) {
+                const msg = stderr?.trim() || stdout?.trim() || error.message;
+                reject(new Error(msg));
+            }
+            else
+                resolve({ stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=SyncSkills.js.map

package/dist/SyncSkills.js.map

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

package/dist/Typegen.d.ts

@@ -0,0 +1,6 @@
+import * as Cli from './Cli.js';
+/** Imports a CLI from `input` (must `export default` a `Cli`), generates the `.d.ts`, and writes it to `output`. */
+export declare function generate(input: string, output: string): Promise<void>;
+/** Generates a `.d.ts` declaration string for the `incur` module augmentation. */
+export declare function fromCli(cli: Cli.Cli): string;
+//# sourceMappingURL=Typegen.d.ts.map

package/dist/Typegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Typegen.d.ts","sourceRoot":"","sources":["../src/Typegen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAG/B,oHAAoH;AACpH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAe5C"}

package/dist/Typegen.js

@@ -0,0 +1,92 @@
+import fs from 'node:fs/promises';
+import { z } from 'zod';
+import * as Cli from './Cli.js';
+import { importCli } from './internal/utils.js';
+/** Imports a CLI from `input` (must `export default` a `Cli`), generates the `.d.ts`, and writes it to `output`. */
+export async function generate(input, output) {
+    const cli = await importCli(input);
+    await fs.writeFile(output, fromCli(cli));
+}
+/** Generates a `.d.ts` declaration string for the `incur` module augmentation. */
+export function fromCli(cli) {
+    const commands = Cli.toCommands.get(cli);
+    if (!commands)
+        throw new Error('No commands registered on this CLI instance');
+    const entries = collectEntries(commands, []);
+    const lines = ["declare module 'incur' {", '  interface Register {', '    commands: {'];
+    for (const { name, args, options } of entries)
+        lines.push(`      '${name}': { args: ${schemaToType(args)}; options: ${schemaToType(options)} }`);
+    lines.push('    }', '  }', '}', '');
+    return lines.join('\n');
+}
+/** Recursively collects leaf commands with their full paths and schemas. */
+function collectEntries(commands, prefix) {
+    const result = [];
+    for (const [name, entry] of commands) {
+        const path = [...prefix, name];
+        if ('_group' in entry && entry._group)
+            result.push(...collectEntries(entry.commands, path));
+        else
+            result.push({ name: path.join(' '), args: entry.args, options: entry.options });
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Converts a Zod object schema to a TypeScript type string. Returns `{}` for undefined schemas. */
+function schemaToType(schema) {
+    if (!schema)
+        return '{}';
+    const json = z.toJSONSchema(schema);
+    const defs = (json.$defs ?? {});
+    const properties = json.properties;
+    if (!properties || Object.keys(properties).length === 0)
+        return '{}';
+    const entries = Object.entries(properties).map(([key, value]) => `${key}: ${resolveType(value, defs)}`);
+    return `{ ${entries.join('; ')} }`;
+}
+/** Recursively resolves a JSON Schema node to a TypeScript type string. */
+function resolveType(schema, defs) {
+    if (schema.$ref) {
+        const ref = schema.$ref.replace('#/$defs/', '');
+        const resolved = defs[ref];
+        if (resolved)
+            return resolveType(resolved, defs);
+        return 'unknown';
+    }
+    if ('const' in schema)
+        return JSON.stringify(schema.const);
+    if (schema.enum)
+        return schema.enum.map((v) => JSON.stringify(v)).join(' | ');
+    if (schema.anyOf)
+        return schema.anyOf.map((s) => resolveType(s, defs)).join(' | ');
+    const type = schema.type;
+    if (Array.isArray(type))
+        return type
+            .map((t) => (t === 'null' ? 'null' : resolveType({ ...schema, type: t }, defs)))
+            .join(' | ');
+    switch (type) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'array': {
+            const items = schema.items;
+            const itemType = items ? resolveType(items, defs) : 'unknown';
+            return itemType.includes(' | ') ? `(${itemType})[]` : `${itemType}[]`;
+        }
+        case 'object': {
+            const properties = schema.properties;
+            if (!properties || Object.keys(properties).length === 0)
+                return '{}';
+            const entries = Object.entries(properties).map(([key, value]) => `${key}: ${resolveType(value, defs)}`);
+            return `{ ${entries.join('; ')} }`;
+        }
+        default:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=Typegen.js.map

package/dist/Typegen.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import * as Cli from './Cli.js';
+declare const cli: Cli.Cli<{
+    gen: {
+        args: {};
+        options: {
+            dir?: string | undefined;
+            entry?: string | undefined;
+            output?: string | undefined;
+        };
+    };
+}>;
+export default cli;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAG/B,QAAA,MAAM,GAAG;;;;;;;;;EAqBP,CAAA;AAIF,eAAe,GAAG,CAAA"}

package/dist/bin.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { z } from 'zod';
+import * as Cli from './Cli.js';
+import * as Typegen from './Typegen.js';
+const cli = Cli.create('incur', {
+    description: 'CLI for incur',
+    sync: {
+        depth: 1,
+        include: ['_root'],
+        suggestions: ['build a cli with incur', 'generate incur types'],
+    },
+}).command('gen', {
+    description: 'Generate type definitions for development.',
+    options: z.object({
+        dir: z.string().optional().describe('Project root directory'),
+        entry: z.string().optional().describe('Entrypoint path (absolute)'),
+        output: z.string().optional().describe('Output path (absolute)'),
+    }),
+    async run({ options }) {
+        const dir = options.dir ?? '.';
+        const entry = options.entry ?? dir;
+        const output = options.output ?? path.join(dir, 'incur.generated.ts');
+        await Typegen.generate(entry, output);
+        return { dir, entry, output };
+    },
+});
+cli.serve();
+export default cli;
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,eAAe;IAC5B,IAAI,EAAE;QACJ,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,WAAW,EAAE,CAAC,wBAAwB,EAAE,sBAAsB,CAAC;KAChE;CACF,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE;IAChB,WAAW,EAAE,4CAA4C;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACjE,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE;QACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAA;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAA;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAA;QACrE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACrC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC/B,CAAC;CACF,CAAC,CAAA;AAEF,GAAG,CAAC,KAAK,EAAE,CAAA;AAEX,eAAe,GAAG,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { z } from 'zod';
+export * as Cli from './Cli.js';
+export * as Errors from './Errors.js';
+export * as Formatter from './Formatter.js';
+export * as Help from './Help.js';
+export * as Mcp from './Mcp.js';
+export * as Parser from './Parser.js';
+export type { Register } from './Register.js';
+export * as Schema from './Schema.js';
+export * as Skill from './Skill.js';
+export * as Skillgen from './Skillgen.js';
+export * as SyncMcp from './SyncMcp.js';
+export * as SyncSkills from './SyncSkills.js';
+export * as Typegen from './Typegen.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { z } from 'zod';
+export * as Cli from './Cli.js';
+export * as Errors from './Errors.js';
+export * as Formatter from './Formatter.js';
+export * as Help from './Help.js';
+export * as Mcp from './Mcp.js';
+export * as Parser from './Parser.js';
+export * as Schema from './Schema.js';
+export * as Skill from './Skill.js';
+export * as Skillgen from './Skillgen.js';
+export * as SyncMcp from './SyncMcp.js';
+export * as SyncSkills from './SyncSkills.js';
+export * as Typegen from './Typegen.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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA"}

package/dist/internal/pm.d.ts

@@ -0,0 +1,3 @@
+/** Detects the package manager runner (`npx`, `pnpx`, `bunx`) from the current process environment. */
+export declare function detectRunner(): string;
+//# sourceMappingURL=pm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pm.d.ts","sourceRoot":"","sources":["../../src/internal/pm.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,wBAAgB,YAAY,IAAI,MAAM,CAMrC"}

package/dist/internal/pm.js

@@ -0,0 +1,11 @@
+/** Detects the package manager runner (`npx`, `pnpx`, `bunx`) from the current process environment. */
+export function detectRunner() {
+    const userAgent = process.env.npm_config_user_agent ?? '';
+    const execPath = process.env.npm_execpath ?? '';
+    if (userAgent.includes('pnpm') || execPath.includes('pnpm'))
+        return 'pnpx';
+    if (userAgent.includes('bun') || execPath.includes('bun'))
+        return 'bunx';
+    return 'npx';
+}
+//# sourceMappingURL=pm.js.map

package/dist/internal/pm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm.js","sourceRoot":"","sources":["../../src/internal/pm.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,MAAM,UAAU,YAAY;IAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAA;IACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAA;IAC/C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IAC1E,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IACxE,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/internal/types.d.ts

@@ -0,0 +1,11 @@
+/** Combines members of an intersection into a readable type. */
+export type Compute<type> = {
+    [key in keyof type]: type[key];
+} & unknown;
+/** Collects all keys across every member of a union. */
+export type KeyofUnion<type> = type extends type ? keyof type : never;
+/** Creates a mutually exclusive union where each variant's missing keys are `?: undefined`. */
+export type OneOf<union extends object, fallback extends object | undefined = undefined, keys extends KeyofUnion<union> = KeyofUnion<union>> = union extends infer item ? Compute<item & {
+    [key in Exclude<keys, keyof item>]?: fallback extends object ? key extends keyof fallback ? fallback[key] : undefined : undefined;
+}> : never;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;CAAE,GAAG,OAAO,CAAA;AAExE,wDAAwD;AACxD,MAAM,MAAM,UAAU,CAAC,IAAI,IAAI,IAAI,SAAS,IAAI,GAAG,MAAM,IAAI,GAAG,KAAK,CAAA;AAErE,+FAA+F;AAC/F,MAAM,MAAM,KAAK,CACf,KAAK,SAAS,MAAM,EACpB,QAAQ,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,EAC/C,IAAI,SAAS,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAChD,KAAK,SAAS,MAAM,IAAI,GACxB,OAAO,CACL,IAAI,GAAG;KACJ,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,GACxD,GAAG,SAAS,MAAM,QAAQ,GACxB,QAAQ,CAAC,GAAG,CAAC,GACb,SAAS,GACX,SAAS;CACd,CACF,GACD,KAAK,CAAA"}

package/dist/internal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":""}

package/dist/internal/utils.d.ts

@@ -0,0 +1,8 @@
+import * as Cli from '../Cli.js';
+/**
+ * Dynamically imports a module and extracts its default-exported CLI instance.
+ * Temporarily replaces `process.argv` and `process.exit` to prevent imported
+ * modules that call `.serve()` at the top level from interfering.
+ */
+export declare function importCli(input: string): Promise<Cli.Cli>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAEhC;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAuB/D"}

package/dist/internal/utils.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import url from 'node:url';
+import * as Cli from '../Cli.js';
+/**
+ * Dynamically imports a module and extracts its default-exported CLI instance.
+ * Temporarily replaces `process.argv` and `process.exit` to prevent imported
+ * modules that call `.serve()` at the top level from interfering.
+ */
+export async function importCli(input) {
+    const resolved = path.resolve(input);
+    const stat = await fs.stat(resolved);
+    const file = stat.isDirectory() ? await resolveEntry(resolved) : resolved;
+    const href = url.pathToFileURL(file).href;
+    const savedArgv = process.argv;
+    const savedExit = process.exit;
+    const savedWrite = process.stdout.write;
+    process.argv = [savedArgv[0]];
+    process.exit = (() => { });
+    process.stdout.write = (() => true);
+    try {
+        const mod = await import(href);
+        const cli = mod.default;
+        if (!cli || !Cli.toCommands.has(cli))
+            throw new Error(`Expected default export to be a \`Cli\` instance: ${input}`);
+        return cli;
+    }
+    finally {
+        process.argv = savedArgv;
+        process.exit = savedExit;
+        process.stdout.write = savedWrite;
+    }
+}
+/** Resolves the CLI entry file from a directory by checking `package.json` `bin`, then falling back to `cli.ts`. */
+async function resolveEntry(dir) {
+    try {
+        const pkg = JSON.parse(await fs.readFile(path.join(dir, 'package.json'), 'utf8'));
+        if (pkg.bin) {
+            const entries = typeof pkg.bin === 'string' ? [pkg.bin] : Object.values(pkg.bin);
+            const src = entries.find((e) => e.endsWith('.ts'));
+            const entry = src ?? entries[0];
+            if (entry)
+                return path.join(dir, entry);
+        }
+        if (pkg.main)
+            return path.join(dir, pkg.main);
+    }
+    catch { }
+    return path.join(dir, 'cli.ts');
+}
+//# sourceMappingURL=utils.js.map

package/dist/internal/utils.js.map

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