@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/cli/commands/spec-diff.js

@@ -0,0 +1,58 @@
+import { writeFile } from "node:fs/promises";
+import { diffSpecs } from "../../spec/diff/index.js";
+const args = {
+    type: "object",
+    properties: {
+        before: {
+            type: "string",
+            description: "Base spec (file path or URL)",
+        },
+        after: {
+            type: "string",
+            description: "Head spec to compare against base (file path or URL)",
+        },
+        out: {
+            type: "string",
+            description: "Write full JSON diff report to this path",
+        },
+        failOnBreaking: {
+            type: "boolean",
+            description: "Exit non-zero if any breaking changes are detected",
+            default: false,
+        },
+    },
+    required: ["before", "after"],
+};
+export const specDiffCommand = {
+    path: ["spec", "diff"],
+    description: "Diff two specs (any supported format) — converts both to OpenAPI 3 and classifies breaking vs non-breaking changes",
+    args,
+    handler: async (input) => {
+        const result = await diffSpecs({
+            before: input.before,
+            after: input.after,
+        });
+        const { summary, diffs } = result;
+        const lines = [
+            `${summary.total} change(s): ${summary.breaking} breaking, ${summary.nonBreaking} non-breaking, ${summary.annotation} annotation, ${summary.unclassified} unclassified, ${summary.deprecated} deprecated`,
+            `(${result.before.from} → ${result.after.from})`,
+            "",
+        ];
+        for (const diff of diffs) {
+            lines.push(`  [${diff.type}] ${diff.action} ${toJsonPointer(diff.path)}${diff.description ? ` — ${diff.description}` : ""}`);
+        }
+        process.stdout.write(`${lines.join("\n")}\n`);
+        if (input.out) {
+            await writeFile(input.out, JSON.stringify(result, null, 2));
+        }
+        if (input.failOnBreaking && summary.breaking > 0) {
+            process.exit(1);
+        }
+    },
+};
+function toJsonPointer(path) {
+    return path
+        .map((segment) => `/${String(segment).replaceAll("~", "~0").replaceAll("/", "~1")}`)
+        .join("");
+}
+//# sourceMappingURL=spec-diff.js.map

package/dist/cli/commands/spec-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-diff.js","sourceRoot":"","sources":["../../../src/cli/commands/spec-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAWrD,MAAM,IAAI,GAAW;IACnB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8BAA8B;SAC5C;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sDAAsD;SACpE;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SACxD;QACD,cAAc,EAAE;YACd,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oDAAoD;YACjE,OAAO,EAAE,KAAK;SACf;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACtB,WAAW,EACT,oHAAoH;IACtH,IAAI;IACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QAEH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAClC,MAAM,KAAK,GAAG;YACZ,GAAG,OAAO,CAAC,KAAK,eAAe,OAAO,CAAC,QAAQ,cAAc,OAAO,CAAC,WAAW,kBAAkB,OAAO,CAAC,UAAU,gBAAgB,OAAO,CAAC,YAAY,kBAAkB,OAAO,CAAC,UAAU,aAAa;YACzM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG;YAChD,EAAE;SACH,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GACzD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAChD,EAAE,CACH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,aAAa,CAAC,IAAoC;IACzD,OAAO,IAAI;SACR,GAAG,CACF,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CACpE;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,10 @@
+export type { AnyCommandSpec, CommandSpec, OutputFormat, } from "./command-spec.js";
+export { generateCommand, watchCommand } from "./commands/generate.js";
+export { initCommand } from "./commands/init.js";
+export { reconCommand } from "./commands/recon.js";
+export { sdkAllCommand } from "./commands/sdk-all.js";
+export { sdkGoCommand, sdkJavaCommand, sdkK6Command, sdkKotlinCommand, sdkSwiftCommand, sdkTypescriptCommand, } from "./commands/sdk-targets.js";
+export { specConvertCommand } from "./commands/spec-convert.js";
+export { type RunCliOptions, runCli } from "./runtime.js";
+export { fillFromPrompts, schemaToCittyArgs, validateInput, } from "./schema-args.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,9 @@
+export { generateCommand, watchCommand } from "./commands/generate.js";
+export { initCommand } from "./commands/init.js";
+export { reconCommand } from "./commands/recon.js";
+export { sdkAllCommand } from "./commands/sdk-all.js";
+export { sdkGoCommand, sdkJavaCommand, sdkK6Command, sdkKotlinCommand, sdkSwiftCommand, sdkTypescriptCommand, } from "./commands/sdk-targets.js";
+export { specConvertCommand } from "./commands/spec-convert.js";
+export { runCli } from "./runtime.js";
+export { fillFromPrompts, schemaToCittyArgs, validateInput, } from "./schema-args.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAsB,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/cli/log.d.ts

@@ -0,0 +1,12 @@
+/** CLI output. `error` still prints when quiet. */
+export declare const log: {
+    success: (message: string) => void;
+    info: (message: string) => void;
+    start: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+    /** A summary line, set apart from the rest. */
+    box: (message: string) => void;
+    setQuiet: (value: boolean) => void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/cli/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/cli/log.ts"],"names":[],"mappings":"AAcA,mDAAmD;AACnD,eAAO,MAAM,GAAG;IACd,OAAO,YARG,MAAM;IAShB,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,+CAA+C;IAC/C,GAAG,YAAY,MAAM;IAIrB,QAAQ,UAAU,OAAO;CAG1B,CAAC"}

package/dist/cli/log.js

@@ -0,0 +1,26 @@
+import { styleText } from "node:util";
+let quiet = false;
+const line = (mark, color, stream, always = false) => (message) => {
+    if (quiet && !always)
+        return;
+    const out = process[stream];
+    out.write(`${styleText(color, mark, { stream: out })} ${message}\n`);
+};
+/** CLI output. `error` still prints when quiet. */
+export const log = {
+    success: line("✔", "green", "stdout"),
+    info: line("ℹ", "cyan", "stdout"),
+    start: line("◐", "magenta", "stdout"),
+    warn: line("⚠", "yellow", "stderr"),
+    error: line("✖", "red", "stderr", true),
+    /** A summary line, set apart from the rest. */
+    box: (message) => {
+        if (quiet)
+            return;
+        process.stdout.write(`\n${styleText("bold", message)}\n\n`);
+    },
+    setQuiet: (value) => {
+        quiet = value;
+    },
+};
+//# sourceMappingURL=log.js.map

package/dist/cli/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/cli/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,IAAI,KAAK,GAAG,KAAK,CAAC;AAElB,MAAM,IAAI,GACR,CAAC,IAAY,EAAE,KAAY,EAAE,MAA2B,EAAE,MAAM,GAAG,KAAK,EAAE,EAAE,CAC5E,CAAC,OAAe,EAAE,EAAE;IAClB,IAAI,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;AACvE,CAAC,CAAC;AAEJ,mDAAmD;AACnD,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC;IACrC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC;IACjC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC;IACrC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACnC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC;IACvC,+CAA+C;IAC/C,GAAG,EAAE,CAAC,OAAe,EAAE,EAAE;QACvB,IAAI,KAAK;YAAE,OAAO;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,QAAQ,EAAE,CAAC,KAAc,EAAE,EAAE;QAC3B,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/cli/prompt.d.ts

@@ -0,0 +1,8 @@
+export declare const interactive: () => boolean;
+/** Ask for text. Empty answers fall back to `fallback`, or ask again. */
+export declare function ask(message: string, fallback?: string): Promise<string>;
+/** Ask for one of `choices`, by number or name. */
+export declare function choose<T extends string>(message: string, choices: ReadonlyArray<T>, fallback?: T): Promise<T>;
+/** Ask for some of `choices`, comma-separated, by number or name. */
+export declare function chooseSome<T extends string>(message: string, choices: ReadonlyArray<T>): Promise<T[]>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/cli/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/cli/prompt.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAAO,OAA+C,CAAC;AAgB/E,yEAAyE;AACzE,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7E;AAED,mDAAmD;AACnD,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,QAAQ,GAAE,CAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,qEAAqE;AACrE,wBAAsB,UAAU,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,EAAE,CAAC,CAUd"}

package/dist/cli/prompt.js

@@ -0,0 +1,51 @@
+import { stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { styleText } from "node:util";
+export const interactive = () => Boolean(stdin.isTTY && stdout.isTTY);
+async function question(message) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    rl.once("SIGINT", () => {
+        rl.close();
+        stdout.write("\nCancelled.\n");
+        process.exit(1);
+    });
+    try {
+        return (await rl.question(`${styleText("cyan", "?")} ${message} `)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Ask for text. Empty answers fall back to `fallback`, or ask again. */
+export async function ask(message, fallback) {
+    for (;;) {
+        const hint = fallback ? styleText("dim", `(${fallback})`) : "";
+        const answer = (await question(`${message} ${hint}`)) || fallback;
+        if (answer)
+            return answer;
+    }
+}
+/** Ask for one of `choices`, by number or name. */
+export async function choose(message, choices, fallback = choices[0]) {
+    const list = choices.map((c, i) => `  ${i + 1}. ${c}`).join("\n");
+    for (;;) {
+        const answer = await ask(`${message}\n${list}\n `, fallback);
+        const picked = choices[Number(answer) - 1] ?? choices.find((c) => c === answer);
+        if (picked)
+            return picked;
+    }
+}
+/** Ask for some of `choices`, comma-separated, by number or name. */
+export async function chooseSome(message, choices) {
+    const list = choices.map((c, i) => `  ${i + 1}. ${c}`).join("\n");
+    for (;;) {
+        const answer = await ask(`${message} (comma-separated)\n${list}\n `);
+        const picked = answer
+            .split(",")
+            .map((a) => a.trim())
+            .map((a) => choices[Number(a) - 1] ?? choices.find((c) => c === a));
+        if (picked.length > 0 && picked.every(Boolean))
+            return picked;
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/prompt.js.map

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

package/dist/cli/runtime.d.ts

@@ -0,0 +1,10 @@
+import type { AnyCommandSpec } from "./command-spec.js";
+export interface RunCliOptions {
+    name: string;
+    version: string;
+    description: string;
+    commands: ReadonlyArray<AnyCommandSpec>;
+}
+export declare function runCli(opts: RunCliOptions): Promise<void>;
+export type { AnyCommandSpec };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/cli/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAqFxD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACzC;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/D;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/cli/runtime.js

@@ -0,0 +1,83 @@
+import { defineCommand, runMain } from "citty";
+import { log } from "./log.js";
+import { fillFromPrompts, schemaToCittyArgs, validateInput, } from "./schema-args.js";
+function commandToCitty(spec) {
+    const argsDef = schemaToCittyArgs(spec.args);
+    const name = spec.path[spec.path.length - 1] ?? "command";
+    return defineCommand({
+        meta: { name, description: spec.description },
+        args: argsDef,
+        run: async ({ args }) => {
+            const partial = stripCittyMeta(args);
+            const filled = await fillFromPrompts(spec.args, partial);
+            try {
+                validateInput(spec.args, filled);
+                await spec.handler(filled);
+            }
+            catch (error) {
+                log.error(error instanceof Error ? error.message : String(error));
+                process.exit(1);
+            }
+        },
+    });
+}
+function stripCittyMeta(args) {
+    const out = {};
+    for (const [k, v] of Object.entries(args)) {
+        if (k === "_")
+            continue;
+        if (v === undefined)
+            continue;
+        if (typeof v === "string" && v === "")
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+function buildTree(commands) {
+    const root = { subCommands: {} };
+    for (const cmd of commands) {
+        let cursor = root;
+        for (let i = 0; i < cmd.path.length - 1; i++) {
+            const seg = cmd.path[i];
+            cursor.subCommands[seg] ??= { subCommands: {} };
+            cursor = cursor.subCommands[seg];
+        }
+        const leafName = cmd.path[cmd.path.length - 1];
+        cursor.subCommands[leafName] = { subCommands: {}, leaf: cmd };
+    }
+    return root;
+}
+function treeToCitty(node, name, description) {
+    const subCommands = {};
+    for (const [childName, child] of Object.entries(node.subCommands)) {
+        if (child.leaf) {
+            subCommands[childName] = commandToCitty(child.leaf);
+        }
+        else {
+            subCommands[childName] = treeToCitty(child, childName, `${childName} subcommands`);
+        }
+    }
+    return defineCommand({
+        meta: { name, description },
+        subCommands,
+    });
+}
+export async function runCli(opts) {
+    const tree = buildTree(opts.commands);
+    const root = defineCommand({
+        meta: {
+            name: opts.name,
+            version: opts.version,
+            description: opts.description,
+        },
+        subCommands: Object.fromEntries(Object.entries(tree.subCommands).map(([childName, child]) => [
+            childName,
+            child.leaf
+                ? commandToCitty(child.leaf)
+                : treeToCitty(child, childName, `${childName} subcommands`),
+        ])),
+    });
+    await runMain(root);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/cli/runtime.js.map

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

package/dist/cli/schema-args.d.ts

@@ -0,0 +1,22 @@
+import type { ArgsDef } from "citty";
+import { type Schema } from "../schema/index.js";
+/**
+ * Convert a JSON Schema 2020-12 object schema into citty's `ArgsDef` map.
+ * Each top-level property becomes one citty arg. The first required
+ * string property is rendered positional; everything else is a named flag.
+ * `enum` constraints become `string` flags + are validated post-parse.
+ */
+export declare function schemaToCittyArgs(schema: Schema): ArgsDef;
+/**
+ * Walk a JSON Schema and prompt the user for any required field whose
+ * value is missing in `partial`. Returns a fully-populated input object.
+ * Run AFTER citty has parsed argv so explicit flags win over prompts.
+ */
+export declare function fillFromPrompts<T extends Record<string, unknown>>(schema: Schema, partial: Partial<T>): Promise<T>;
+/**
+ * Validate a fully-populated input against the schema's `enum` /
+ * required constraints. Throws on validation failure with a one-line
+ * error matching the offending property.
+ */
+export declare function validateInput(schema: Schema, input: Record<string, unknown>): void;
+//# sourceMappingURL=schema-args.d.ts.map

package/dist/cli/schema-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-args.d.ts","sourceRoot":"","sources":["../../src/cli/schema-args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAmDzD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAmBN"}

package/dist/cli/schema-args.js

@@ -0,0 +1,104 @@
+import { isSchemaObject } from "../schema/index.js";
+import { ask, choose, interactive } from "./prompt.js";
+/**
+ * Convert a JSON Schema 2020-12 object schema into citty's `ArgsDef` map.
+ * Each top-level property becomes one citty arg. The first required
+ * string property is rendered positional; everything else is a named flag.
+ * `enum` constraints become `string` flags + are validated post-parse.
+ */
+export function schemaToCittyArgs(schema) {
+    const args = {};
+    const required = new Set(schema.required ?? []);
+    const props = Object.entries(schema.properties ?? {});
+    const firstRequiredString = props.find(([name, p]) => required.has(name) &&
+        isSchemaObject(p) &&
+        p.type === "string")?.[0];
+    for (const [name, propUnknown] of props) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        const description = prop.description ?? "";
+        if (name === firstRequiredString) {
+            args[name] = {
+                type: "positional",
+                description,
+                required: true,
+            };
+            continue;
+        }
+        const t = Array.isArray(prop.type) ? prop.type[0] : prop.type;
+        if (t === "boolean") {
+            args[name] = {
+                type: "boolean",
+                description,
+                default: prop.default,
+            };
+        }
+        else if (t === "number" || t === "integer") {
+            args[name] = {
+                type: "string",
+                description,
+                default: prop.default,
+                required: required.has(name) && prop.default === undefined,
+            };
+        }
+        else {
+            args[name] = {
+                type: "string",
+                description,
+                default: prop.default,
+                required: required.has(name) && prop.default === undefined,
+            };
+        }
+    }
+    return args;
+}
+/**
+ * Walk a JSON Schema and prompt the user for any required field whose
+ * value is missing in `partial`. Returns a fully-populated input object.
+ * Run AFTER citty has parsed argv so explicit flags win over prompts.
+ */
+export async function fillFromPrompts(schema, partial) {
+    const required = new Set(schema.required ?? []);
+    const props = Object.entries(schema.properties ?? {});
+    const missing = props.filter(([name]) => required.has(name) && partial[name] === undefined);
+    if (missing.length === 0 || !interactive())
+        return partial;
+    const filled = { ...partial };
+    for (const [name, propUnknown] of missing) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        const message = prop.description ?? name;
+        filled[name] =
+            Array.isArray(prop.enum) && prop.enum.length > 0
+                ? await choose(message, prop.enum.map(String), prop.default)
+                : await ask(message, prop.default);
+    }
+    return filled;
+}
+/**
+ * Validate a fully-populated input against the schema's `enum` /
+ * required constraints. Throws on validation failure with a one-line
+ * error matching the offending property.
+ */
+export function validateInput(schema, input) {
+    const required = schema.required ?? [];
+    for (const name of required) {
+        if (input[name] === undefined || input[name] === "") {
+            throw new Error(`Missing required argument: --${name}`);
+        }
+    }
+    for (const [name, propUnknown] of Object.entries(schema.properties ?? {})) {
+        if (!isSchemaObject(propUnknown))
+            continue;
+        const prop = propUnknown;
+        if (Array.isArray(prop.enum) && input[name] !== undefined) {
+            const allowed = prop.enum.map(String);
+            if (!allowed.includes(String(input[name]))) {
+                throw new Error(`Invalid value for --${name}: ${input[name]}. Allowed: ${allowed.join(", ")}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=schema-args.js.map

package/dist/cli/schema-args.js.map

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

package/dist/codegen/fs.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Refuse to wipe the current working directory or a filesystem root.
+ * `clean: true` runs `rm -rf` on the resolved output directory at the
+ * start of `generate()`, which would destroy the user's repo if they
+ * pointed `output` at `.` or `/`. Cheap guardrail with no false
+ * positives — generators always want output under a dedicated subdir.
+ */
+export declare function assertSafeOutputDir(out: string): void;
+/**
+ * Normalize a directory relative to the output root, rejecting absolute
+ * paths and anything that climbs out of it with `..`.
+ */
+export declare function safeRelativeDir(dir: string): string;
+/**
+ * Derive a project name from the output directory's basename, with
+ * non-alphanumerics collapsed to dashes. Used as the fallback for
+ * Gradle's `rootProject.name` / SwiftPM `Package(name:)` /
+ * `module name` defaults. Empty result (e.g. output is `/`) falls
+ * back to the literal `"generated-sdk"` so the build files always
+ * have a valid name slot.
+ */
+export declare function defaultProjectName(outputDir: string): string;
+export interface OutputFile {
+    /** Path relative to the output directory. */
+    path: string;
+    /** File contents. */
+    content: string;
+}
+/**
+ * Write `files` under `out`, first wiping `out` unless `clean` is `false`.
+ */
+export declare function writeOutput(out: string, files: ReadonlyArray<OutputFile>, { clean }?: {
+    clean?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/codegen/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/codegen/fs.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,EAAE,KAAY,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/codegen/fs.js

@@ -0,0 +1,55 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join, parse as parsePath, posix as pathPosix, resolve, } from "node:path";
+/**
+ * Refuse to wipe the current working directory or a filesystem root.
+ * `clean: true` runs `rm -rf` on the resolved output directory at the
+ * start of `generate()`, which would destroy the user's repo if they
+ * pointed `output` at `.` or `/`. Cheap guardrail with no false
+ * positives — generators always want output under a dedicated subdir.
+ */
+export function assertSafeOutputDir(out) {
+    const dir = resolve(out);
+    if (dir === process.cwd() || dir === parsePath(dir).root) {
+        throw new Error(`Refusing to clean output directory: ${out} (would wipe cwd or filesystem root). Use a dedicated subdirectory.`);
+    }
+}
+/**
+ * Normalize a directory relative to the output root, rejecting absolute
+ * paths and anything that climbs out of it with `..`.
+ */
+export function safeRelativeDir(dir) {
+    const normalized = pathPosix.normalize(dir || ".");
+    if (pathPosix.isAbsolute(normalized) ||
+        normalized === ".." ||
+        normalized.startsWith("../")) {
+        throw new Error(`fileLocation: invalid output directory: ${dir}`);
+    }
+    return normalized;
+}
+/**
+ * Derive a project name from the output directory's basename, with
+ * non-alphanumerics collapsed to dashes. Used as the fallback for
+ * Gradle's `rootProject.name` / SwiftPM `Package(name:)` /
+ * `module name` defaults. Empty result (e.g. output is `/`) falls
+ * back to the literal `"generated-sdk"` so the build files always
+ * have a valid name slot.
+ */
+export function defaultProjectName(outputDir) {
+    const base = basename(outputDir).replace(/[^A-Za-z0-9-]+/g, "-");
+    return base || "generated-sdk";
+}
+/**
+ * Write `files` under `out`, first wiping `out` unless `clean` is `false`.
+ */
+export async function writeOutput(out, files, { clean = true } = {}) {
+    if (clean) {
+        assertSafeOutputDir(out);
+        await rm(out, { recursive: true, force: true });
+    }
+    for (const file of files) {
+        const full = join(out, file.path);
+        await mkdir(dirname(full), { recursive: true });
+        await writeFile(full, file.content);
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/codegen/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/codegen/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,KAAK,IAAI,SAAS,EAClB,KAAK,IAAI,SAAS,EAClB,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,uCAAuC,GAAG,qEAAqE,CAChH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAChC,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,IAAI,eAAe,CAAC;AACjC,CAAC;AASD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,KAAgC,EAChC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAwB,EAAE;IAE1C,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/codegen/identifiers.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Identifier transforms shared by every native-SDK generator. All
+ * functions here are pure string ↔ string — they do *not* know about
+ * any target language's reserved-word set or visibility rules. Each
+ * generator layers its own `paramIdent` / `exportedIdent` /
+ * `enumEntryIdent` on top, calling these as primitives.
+ *
+ * The pascal regex deliberately strips both leading and trailing
+ * non-alphanumeric runs so identifiers like `timeframe[]` (PHP-style
+ * array param names from real-world specs) become `Timeframe`, not
+ * `TimeframeNullNull` or similar. Wire-level names are unaffected —
+ * generators preserve the original param.name when emitting the URL.
+ */
+export declare function pascal(s: string): string;
+export declare function camel(s: string): string;
+/** PascalCase, prepended with `_` if it would otherwise start with a
+ *  digit. Used wherever a type-name slot can't begin with a number. */
+export declare function safeIdent(s: string): string;
+/** camelCase, prepended with `_` if it would otherwise start with a
+ *  digit. Used for enum case names where the source is numeric. */
+export declare function safeCaseName(s: string): string;
+/**
+ * Camel-like transform that PRESERVES the first character's casing —
+ * collapses non-alnum word boundaries and uppercases the following
+ * character. Diverges from `camel()` in that it does NOT lowercase
+ * the leading letter, so `softCamel("FirstName")` stays `"FirstName"`
+ * while `camel("FirstName")` returns `"firstName"`. Used by emitters
+ * that want to respect user-given casing on parameter identifiers
+ * while still normalising word boundaries (snake_case → camelCase but
+ * already-cased inputs pass through).
+ */
+export declare function softCamel(s: string): string;
+/** Prepend `_` when the string would otherwise start with a digit;
+ *  pass through unchanged otherwise. Most identifier-safe transforms
+ *  end with this guard. */
+export declare function avoidLeadingDigit(s: string): string;
+/** Wrap a name through a target-specific escape iff it collides with
+ *  the target's reserved-keyword set. Centralises the
+ *  `RESERVED.has(name) ? escape(name) : name` pattern each emitter's
+ *  `paramIdent` open-coded. */
+export declare function escapeIfReserved(name: string, reserved: ReadonlySet<string>, escape: (name: string) => string): string;
+/**
+ * Build a synthetic top-level type name for an inline schema, owned
+ * by some declared type. The owner part stays as-is so collisions
+ * across owners are impossible (`User_Address` vs `Order_Address`).
+ * Path segments get pascal'd individually so `["properties","streetName"]`
+ * collapses to `User_Properties_StreetName` rather than running the
+ * pascal regex over the joined string.
+ */
+export declare function synthName(owner: string, path: ReadonlyArray<string>): string;
+/**
+ * PascalCase that keeps `_` as a word separator (`Owner_Path` stays
+ * intact) while collapsing every other non-alphanumeric run. Leading
+ * digits get a `_` prefix. Empty results become `"Empty"`.
+ */
+export declare function typeIdent(s: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/codegen/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/codegen/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvC;AAED;uEACuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;mEACmE;AACnE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;2BAE2B;AAC3B,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;+BAG+B;AAC/B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C"}