@wirecat/cli-base 0.0.0-stage → 0.22.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/codegen/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,UAAU,YAAY;IACpB,gBAAgB,EAAE,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd;AAmBD,UAAU,KAAK;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD,+DAA+D;AAC/D,eAAO,MAAM,KAAK,WAAW,KAAK,qOAQ/B,CAAA;AAEH,iGAAiG;AACjG,eAAO,MAAM,OAAO,WAAW,KAAK,qOAQjC,CAAA;AAEH,eAAO,MAAM,MAAM,WAAW,KAAK,kNAQhC,CAAA;AAEH,eAAO,MAAM,MAAM,UAAW,SAAS,OAAO,EAAE,KAAG,OACuB,CAAA"}

package/dist/codegen/runtime.js

@@ -0,0 +1,38 @@
+/**
+ * What generated Valibot schemas call at run time. Kept apart from the generator so a CLI loads
+ * these few functions, not the code that writes code.
+ *
+ * Numbers arrive from a lossless JSON parser (`lossless-json` or anything shaped like its
+ * `LosslessNumber`), because a 64-bit id read as a JS number is silently a different id.
+ */
+import * as v from "valibot";
+const isLossless = (input) => typeof input === "object" &&
+    input !== null &&
+    input.isLosslessNumber === true &&
+    typeof input.value === "string";
+const INTEGER = /^-?\d+$/;
+const INT64_MIN = -(2n ** 63n);
+const INT64_MAX = 2n ** 63n - 1n;
+const digitsOf = (input) => {
+    if (isLossless(input))
+        return INTEGER.test(input.value) ? input.value : undefined;
+    if (typeof input === "bigint")
+        return input.toString();
+    if (typeof input === "number" && Number.isSafeInteger(input))
+        return String(input);
+    return undefined;
+};
+const inRange = (value, { minimum, maximum }) => (minimum === undefined || value >= minimum) && (maximum === undefined || value <= maximum);
+/** A 64-bit integer, handed on as its exact decimal string. */
+export const int64 = (range = {}) => v.pipe(v.custom((input) => digitsOf(input) !== undefined, "expected an integer"), v.transform((input) => digitsOf(input)), v.check((digits) => {
+    const value = BigInt(digits);
+    return value >= INT64_MIN && value <= INT64_MAX && inRange(value, range);
+}, "integer out of range"));
+/** An integer that must fit a JS number exactly; one that does not fails instead of rounding. */
+export const integer = (range = {}) => v.pipe(v.custom((input) => {
+    const digits = digitsOf(input);
+    return digits !== undefined && Number.isSafeInteger(Number(digits));
+}, "expected an integer within ±2^53"), v.transform((input) => Number(digitsOf(input))), v.check((value) => inRange(value, range), "integer out of range"));
+export const number = (range = {}) => v.pipe(v.custom((input) => (isLossless(input) ? Number.isFinite(Number(input.value)) : Number.isFinite(input)), "expected a number"), v.transform((input) => (isLossless(input) ? Number(input.value) : input)), v.check((value) => inRange(value, range), "number out of range"));
+export const unique = (items) => new Set(items.map((item) => JSON.stringify(item))).size === items.length;
+//# sourceMappingURL=runtime.js.map

package/dist/codegen/runtime.js.map

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

package/dist/codegen/tree.d.ts

@@ -0,0 +1,29 @@
+import type { ApiModel, ApiSchema, SchemaNode } from "./model.js";
+type ObjectNode = Extract<SchemaNode, {
+    type: "object";
+}>;
+export interface NamedSchema {
+    name: string;
+    schema: ApiSchema;
+}
+/**
+ * The schema index generators share: named components, inline request and response bodies given a
+ * name of their own, and which subtype each discriminator value selects.
+ */
+export declare class SchemaTree {
+    #private;
+    readonly named: NamedSchema[];
+    constructor(model: ApiModel);
+    schema(id: string): ApiSchema;
+    requestName(operationId: string): string | undefined;
+    responseName(operationId: string): string | undefined;
+    /** The value a subtype's discriminator property must hold, if the schema is a subtype. */
+    literalFor(id: string): {
+        property: string;
+        value: string;
+    } | undefined;
+    /** Merges inheritance into one object. A member that is not an object stops generation. */
+    flatten(node: SchemaNode, where: string): ObjectNode;
+}
+export {};
+//# sourceMappingURL=tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/codegen/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAIjE,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAEzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;CAClB;AAED;;;GAGG;AACH,qBAAa,UAAU;;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAA;IAM7B,YAAY,KAAK,EAAE,QAAQ,EA8B1B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAI5B;IAED,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnD;IAED,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpD;IAED,0FAA0F;IAC1F,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAEtE;IAED,2FAA2F;IAC3F,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAiBnD;CACF"}

package/dist/codegen/tree.js

@@ -0,0 +1,87 @@
+import { identifier } from "./names.js";
+import { CodegenError } from "./pipeline.js";
+/**
+ * The schema index generators share: named components, inline request and response bodies given a
+ * name of their own, and which subtype each discriminator value selects.
+ */
+export class SchemaTree {
+    named;
+    #byId;
+    #literals = new Map();
+    #requests = new Map();
+    #responses = new Map();
+    constructor(model) {
+        this.#byId = new Map(model.schemas.map((schema) => [schema.id, schema]));
+        this.named = model.schemas.map((schema) => ({ name: identifier(schema.id), schema }));
+        const taken = new Set(this.named.map((entry) => entry.name));
+        const nameInline = (operationId, suffix, node) => {
+            if (!node)
+                return undefined;
+            if (node.type === "ref")
+                return identifier(node.ref);
+            const name = identifier(`${operationId} ${suffix}`);
+            if (taken.has(name))
+                throw new CodegenError([`inline ${suffix.toLowerCase()} of "${operationId}" collides with ${name}`]);
+            taken.add(name);
+            this.named.push({ name, schema: { id: name, schema: node } });
+            return name;
+        };
+        for (const operation of model.operations) {
+            const request = nameInline(operation.id, "Request", operation.requestBody?.schema);
+            const response = nameInline(operation.id, "Response", operation.response?.schema);
+            if (request)
+                this.#requests.set(operation.id, request);
+            if (response)
+                this.#responses.set(operation.id, response);
+        }
+        for (const schema of model.schemas) {
+            for (const [value, target] of Object.entries(schema.discriminator?.mapping ?? {})) {
+                if (this.#literals.has(target)) {
+                    throw new CodegenError([`schema "${target}" is a subtype of two discriminated schemas`]);
+                }
+                this.#literals.set(target, { property: schema.discriminator?.property ?? "", value });
+            }
+        }
+    }
+    schema(id) {
+        const schema = this.#byId.get(id);
+        if (!schema)
+            throw new CodegenError([`unknown schema "${id}"`]);
+        return schema;
+    }
+    requestName(operationId) {
+        return this.#requests.get(operationId);
+    }
+    responseName(operationId) {
+        return this.#responses.get(operationId);
+    }
+    /** The value a subtype's discriminator property must hold, if the schema is a subtype. */
+    literalFor(id) {
+        return this.#literals.get(id);
+    }
+    /** Merges inheritance into one object. A member that is not an object stops generation. */
+    flatten(node, where) {
+        if (node.type === "object")
+            return node;
+        if (node.type === "ref")
+            return this.flatten(this.schema(node.ref).schema, `${where} → ${node.ref}`);
+        if (node.type !== "allOf") {
+            throw new CodegenError([`${where}: allOf member of type "${node.type}" cannot be merged into an object`]);
+        }
+        const merged = {
+            properties: {},
+            required: [],
+        };
+        for (const member of node.of) {
+            const part = this.flatten(member, where);
+            Object.assign(merged.properties, part.properties);
+            for (const name of part.required)
+                if (!merged.required.includes(name))
+                    merged.required.push(name);
+            if (part.additionalProperties)
+                merged.additionalProperties = part.additionalProperties;
+        }
+        return { type: "object", description: node.description, nullable: node.nullable, ...merged };
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/codegen/tree.js.map

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

package/dist/codegen/typescript.d.ts

@@ -0,0 +1,6 @@
+import type { CodeGenerator } from "./model.js";
+/** TypeScript types for every schema: what a caller holds after the response has been validated. */
+export declare const typesGenerator: (options: {
+    path: string;
+}) => CodeGenerator;
+//# sourceMappingURL=typescript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/codegen/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAc,MAAM,YAAY,CAAA;AAqErE,oGAAoG;AACpG,eAAO,MAAM,cAAc,YACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,aAY5B,CAAA"}

package/dist/codegen/typescript.js

@@ -0,0 +1,78 @@
+import { identifier } from "./names.js";
+import { SchemaTree } from "./tree.js";
+const doc = (text, indent) => {
+    const line = text?.replace(/\s+/g, " ").replace(/\*\//g, "*\\/").trim();
+    return line ? `${indent}/** ${line} */\n` : "";
+};
+const key = (name) => (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name));
+class TypeWriter {
+    tree;
+    constructor(tree) {
+        this.tree = tree;
+    }
+    node(node, where, literal) {
+        const base = this.#bare(node, where, literal);
+        return node.nullable ? `${base} | null` : base;
+    }
+    #bare(node, where, literal) {
+        switch (node.type) {
+            case "ref":
+                return identifier(node.ref);
+            case "string":
+                return node.enum ? node.enum.map((value) => JSON.stringify(value)).join(" | ") : "string";
+            case "integer":
+                if (node.format === "int64")
+                    return "string";
+                return node.enum ? node.enum.map(String).join(" | ") : "number";
+            case "number":
+                return "number";
+            case "boolean":
+                return node.enum ? node.enum.map(String).join(" | ") : "boolean";
+            case "union":
+                return `(${node.of.map((member) => this.node(member, where)).join(" | ")})`;
+            case "unknown":
+                return "unknown";
+            case "array": {
+                return `Array<${this.node(node.items, `${where}[]`)}>`;
+            }
+            case "allOf":
+                if (node.of.length === 1 && node.of[0] && !literal)
+                    return this.#bare(node.of[0], where);
+                return this.#object(this.tree.flatten(node, where), where, literal);
+            case "object":
+                return this.#object(node, where, literal);
+        }
+    }
+    #object(node, where, literal) {
+        const names = Object.keys(node.properties);
+        if (literal && !names.includes(literal.property))
+            names.unshift(literal.property);
+        const rest = node.additionalProperties
+            ? `Record<string, ${this.node(node.additionalProperties, where)}>`
+            : undefined;
+        if (names.length === 0)
+            return rest ?? "Record<string, unknown>";
+        const fields = names.map((name) => {
+            const property = node.properties[name] ?? { type: "string" };
+            const optional = node.required.includes(name) || literal?.property === name ? "" : "?";
+            const type = literal?.property === name ? JSON.stringify(literal.value) : this.node(property, `${where}.${name}`);
+            return `${doc(property.description, "  ")}  ${key(name)}${optional}: ${type}`;
+        });
+        const body = `{\n${fields.join("\n")}\n}`;
+        return rest ? `${body} & ${rest}` : body;
+    }
+}
+/** TypeScript types for every schema: what a caller holds after the response has been validated. */
+export const typesGenerator = (options) => (model) => {
+    const tree = new SchemaTree(model);
+    const writer = new TypeWriter(tree);
+    const declarations = tree.named.map(({ name, schema }) => {
+        const union = schema.discriminator
+            ? Object.values(schema.discriminator.mapping).map(identifier).join(" | ")
+            : undefined;
+        const type = union ?? writer.node(schema.schema, schema.id, tree.literalFor(schema.id));
+        return `${doc(schema.schema.description, "")}export type ${name} = ${type}\n`;
+    });
+    return [{ path: options.path, content: declarations.join("\n") }];
+};
+//# sourceMappingURL=typescript.js.map

package/dist/codegen/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../src/codegen/typescript.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,GAAG,GAAG,CAAC,IAAwB,EAAE,MAAc,EAAU,EAAE;IAC/D,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;IACvE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,GAAG,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AAE7G,MAAM,UAAU;IACO,IAAI;IAAzB,YAAqB,IAAgB;oBAAhB,IAAI;IAAe,CAAC;IAEzC,IAAI,CAAC,IAAgB,EAAE,KAAa,EAAE,OAA6C;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,IAAgB,EAAE,KAAa,EAAE,OAA6C;QAClF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,KAAK;gBACR,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC7B,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;YAC3F,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;oBAAE,OAAO,QAAQ,CAAA;gBAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;YACjE,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAA;YACjB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAClE,KAAK,OAAO;gBACV,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAA;YAC7E,KAAK,SAAS;gBACZ,OAAO,SAAS,CAAA;YAClB,KAAK,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,CAAA;YACxD,CAAC;YACD,KAAK,OAAO;gBACV,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;gBACxF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;YACrE,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,CACL,IAA6C,EAC7C,KAAa,EACb,OAA6C;QAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC1C,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB;YACpC,CAAC,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG;YAClE,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,IAAI,yBAAyB,CAAA;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAe,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;YACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;YACtF,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAA;YACjH,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,KAAK,IAAI,EAAE,CAAA;QAC/E,CAAC,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAA;QACzC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GACzB,CAAC,OAAyB,EAAiB,EAAE,CAC7C,CAAC,KAAe,EAAE,EAAE;IAClB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa;YAChC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACzE,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,IAAI,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QACvF,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,eAAe,IAAI,MAAM,IAAI,IAAI,CAAA;IAC/E,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/codegen/valibot.d.ts

@@ -0,0 +1,10 @@
+import type { CodeGenerator } from "./model.js";
+export interface ValibotOptions {
+    path: string;
+    /** Module the types come from, relative to `path`. */
+    typesImport: string;
+    runtimeImport?: string;
+}
+/** Valibot schemas that keep the source's constraints at run time, which plain generated types lose. */
+export declare const valibotGenerator: (options: ValibotOptions) => CodeGenerator;
+//# sourceMappingURL=valibot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"valibot.d.ts","sourceRoot":"","sources":["../../src/codegen/valibot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,aAAa,EAAc,MAAM,YAAY,CAAA;AAqGrE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wGAAwG;AACxG,eAAO,MAAM,gBAAgB,YACjB,cAAc,KAAG,aAqB1B,CAAA"}

package/dist/codegen/valibot.js

@@ -0,0 +1,132 @@
+import { identifier } from "./names.js";
+import { CodegenError } from "./pipeline.js";
+import { SchemaTree } from "./tree.js";
+const key = (name) => (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name));
+const piped = (base, actions) => actions.length === 0 ? base : `v.pipe(${base}, ${actions.join(", ")})`;
+const range = (node) => {
+    const parts = [];
+    if (node.minimum !== undefined)
+        parts.push(`minimum: ${node.minimum}`);
+    if (node.maximum !== undefined)
+        parts.push(`maximum: ${node.maximum}`);
+    return parts.length === 0 ? "" : `{ ${parts.join(", ")} }`;
+};
+class SchemaWriter {
+    tree;
+    helpers = new Set();
+    constructor(tree) {
+        this.tree = tree;
+    }
+    node(node, where, literal) {
+        const base = this.#bare(node, where, literal);
+        return node.nullable ? `v.nullable(${base})` : base;
+    }
+    #bare(node, where, literal) {
+        switch (node.type) {
+            case "ref":
+                return `v.lazy(() => ${identifier(node.ref)})`;
+            case "string": {
+                if (node.enum)
+                    return `v.picklist(${JSON.stringify(node.enum)})`;
+                const actions = [];
+                if (node.format === "binary")
+                    actions.push('v.startsWith("attach://")');
+                if (node.minLength !== undefined)
+                    actions.push(`v.minLength(${node.minLength})`);
+                if (node.maxLength !== undefined)
+                    actions.push(`v.maxLength(${node.maxLength})`);
+                if (node.pattern !== undefined) {
+                    try {
+                        new RegExp(node.pattern);
+                    }
+                    catch {
+                        throw new CodegenError([`${where}: pattern ${JSON.stringify(node.pattern)} is not a JS regular expression`]);
+                    }
+                    actions.push(`v.regex(new RegExp(${JSON.stringify(node.pattern)}))`);
+                }
+                return piped("v.string()", actions);
+            }
+            case "integer": {
+                const helper = node.format === "int64" ? "int64" : "integer";
+                this.helpers.add(helper);
+                const call = `${helper}(${range(node)})`;
+                if (!node.enum)
+                    return call;
+                const values = helper === "int64" ? node.enum.map(String) : node.enum;
+                return piped(call, [`v.picklist(${JSON.stringify(values)})`]);
+            }
+            case "number":
+                this.helpers.add("number");
+                return `number(${range(node)})`;
+            case "boolean":
+                if (!node.enum)
+                    return "v.boolean()";
+                if (node.enum.length === 1)
+                    return `v.literal(${node.enum[0]})`;
+                return `v.union([${node.enum.map((value) => `v.literal(${value})`).join(", ")}])`;
+            case "union":
+                return `v.union([${node.of.map((member) => this.node(member, where)).join(", ")}])`;
+            case "unknown":
+                return "v.unknown()";
+            case "array": {
+                const actions = [];
+                if (node.minItems !== undefined)
+                    actions.push(`v.minLength(${node.minItems})`);
+                if (node.maxItems !== undefined)
+                    actions.push(`v.maxLength(${node.maxItems})`);
+                if (node.uniqueItems)
+                    this.helpers.add("unique");
+                if (node.uniqueItems)
+                    actions.push(`v.check((items) => unique(items), "items must be unique")`);
+                return piped(`v.array(${this.node(node.items, `${where}[]`)})`, actions);
+            }
+            case "allOf":
+                if (node.of.length === 1 && node.of[0] && !literal)
+                    return this.#bare(node.of[0], where);
+                return this.#object(this.tree.flatten(node, where), where, literal);
+            case "object":
+                return this.#object(node, where, literal);
+        }
+    }
+    // Loose on purpose: MAX adds fields, and a response with a field we have never seen is still valid.
+    #object(node, where, literal) {
+        const names = Object.keys(node.properties);
+        if (literal && !names.includes(literal.property))
+            names.unshift(literal.property);
+        const rest = node.additionalProperties ? this.node(node.additionalProperties, where) : undefined;
+        if (names.length === 0)
+            return rest ? `v.record(v.string(), ${rest})` : "v.looseObject({})";
+        const entries = names.map((name) => {
+            if (literal?.property === name)
+                return `  ${key(name)}: v.literal(${JSON.stringify(literal.value)}),`;
+            const property = node.properties[name];
+            const schema = this.node(property, `${where}.${name}`);
+            return `  ${key(name)}: ${node.required.includes(name) ? schema : `v.optional(${schema})`},`;
+        });
+        const body = `{\n${entries.join("\n")}\n}`;
+        return rest ? `v.objectWithRest(${body}, ${rest})` : `v.looseObject(${body})`;
+    }
+}
+/** Valibot schemas that keep the source's constraints at run time, which plain generated types lose. */
+export const valibotGenerator = (options) => (model) => {
+    const tree = new SchemaTree(model);
+    const writer = new SchemaWriter(tree);
+    const declarations = tree.named.map(({ name, schema }) => {
+        const expression = schema.discriminator
+            ? `v.union([${Object.values(schema.discriminator.mapping)
+                .map((target) => `v.lazy(() => ${identifier(target)})`)
+                .join(", ")}])`
+            : writer.node(schema.schema, schema.id, tree.literalFor(schema.id));
+        return `export const ${name}: v.GenericSchema<unknown, T.${name}> = ${expression}\n`;
+    });
+    const helpers = [...writer.helpers].sort();
+    const runtime = options.runtimeImport ?? "@wirecat/cli-base/codegen/runtime";
+    const packages = [
+        `import * as v from "valibot"`,
+        ...(helpers.length > 0 ? [`import { ${helpers.join(", ")} } from "${runtime}"`] : []),
+    ].sort((a, b) => (a.split(" from ")[1] ?? "").localeCompare(b.split(" from ")[1] ?? ""));
+    const header = [...packages, `import type * as T from "${options.typesImport}"`, ""];
+    const registry = `export const schemas = {\n${tree.named.map(({ name }) => `  ${name},`).join("\n")}\n} as const\n`;
+    return [{ path: options.path, content: `${header.join("\n")}\n${declarations.join("\n")}\n${registry}` }];
+};
+//# sourceMappingURL=valibot.js.map

package/dist/codegen/valibot.js.map

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

package/dist/commands/document.d.ts

@@ -0,0 +1,72 @@
+import type { Command } from "commander";
+import * as v from "valibot";
+import { type CommandInfo, type OptionInfo } from "./index.js";
+/**
+ * What `<cli> commands --json` prints, in every CLI on cli-base. `scope` and `inheritedOptions` are
+ * there only when one command path was asked for. Nothing else at the top: `cli-dev lint` refuses it.
+ */
+export declare const commandsDocumentSchema: v.StrictObjectSchema<{
+    readonly cli: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+    readonly version: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+    /** The major version of the JSON the CLI's commands print. */
+    readonly contract: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly description: v.StringSchema<undefined>;
+    readonly globalOptions: v.ArraySchema<v.ObjectSchema<{
+        readonly flags: v.StringSchema<undefined>;
+        readonly description: v.StringSchema<undefined>;
+        readonly takesValue: v.BooleanSchema<undefined>;
+        readonly mandatory: v.BooleanSchema<undefined>;
+        readonly choices: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly default: v.OptionalSchema<v.UnknownSchema, undefined>;
+        readonly env: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly conflicts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly implies: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly scope: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    readonly inheritedOptions: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly path: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly options: v.ArraySchema<v.ObjectSchema<{
+            readonly flags: v.StringSchema<undefined>;
+            readonly description: v.StringSchema<undefined>;
+            readonly takesValue: v.BooleanSchema<undefined>;
+            readonly mandatory: v.BooleanSchema<undefined>;
+            readonly choices: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly default: v.OptionalSchema<v.UnknownSchema, undefined>;
+            readonly env: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly conflicts: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly implies: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
+    readonly commands: v.ArraySchema<v.GenericSchema<CommandInfo>, undefined>;
+    readonly exitCodes: v.RecordSchema<v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
+}, undefined>;
+export interface CommandsDocument {
+    cli: string;
+    version: string;
+    contract: number;
+    description: string;
+    globalOptions: OptionInfo[];
+    scope?: string[];
+    inheritedOptions?: {
+        path: string[];
+        options: OptionInfo[];
+    }[];
+    commands: CommandInfo[];
+    exitCodes: Record<string, number>;
+}
+export declare const commandsDocumentJsonSchema: () => import("@valibot/to-json-schema").JsonSchema;
+export declare const parseCommandsDocument: (value: unknown) => {
+    document: CommandsDocument;
+    problems?: undefined;
+} | {
+    document?: undefined;
+    problems: string[];
+};
+export interface CommandsDocumentAbout {
+    cli: string;
+    version: string;
+    contract: number;
+}
+/** The whole tree; a CLI that answers `commands <path>` adds `scope` and `inheritedOptions` itself. */
+export declare const commandsDocument: (root: Command, about: CommandsDocumentAbout) => CommandsDocument;
+//# sourceMappingURL=document.d.ts.map

package/dist/commands/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/commands/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,OAAO,EAAE,KAAK,WAAW,EAAoC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAwChG;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;IAGjC,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQ9D,CAAA;AAEF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,UAAU,EAAE,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,gBAAgB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,EAAE,CAAA;IAC9D,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,eAAO,MAAM,0BAA0B,oDAA6E,CAAA;AAEpH,eAAO,MAAM,qBAAqB,UACzB,OAAO,KACb;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAGnG,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,SAAU,OAAO,SAAS,qBAAqB,KAAG,gBAQ7E,CAAA"}

package/dist/commands/document.js

@@ -0,0 +1,71 @@
+import * as v from "valibot";
+import { EXIT_CODES, GENERIC_FAILURE } from "../exit-codes.js";
+import { issuesOf, jsonSchemaOf } from "../standards/registry.js";
+import { describeOptions, describeProgram } from "./index.js";
+const argumentInfoSchema = v.object({
+    name: v.string(),
+    required: v.boolean(),
+    variadic: v.boolean(),
+    description: v.string(),
+    choices: v.optional(v.array(v.string())),
+    default: v.optional(v.unknown()),
+});
+const optionInfoSchema = v.object({
+    flags: v.string(),
+    description: v.string(),
+    takesValue: v.boolean(),
+    mandatory: v.boolean(),
+    choices: v.optional(v.array(v.string())),
+    default: v.optional(v.unknown()),
+    env: v.optional(v.string()),
+    conflicts: v.optional(v.array(v.string())),
+    implies: v.optional(v.record(v.string(), v.unknown())),
+});
+const commandInfoSchema = v.object({
+    path: v.array(v.string()),
+    name: v.string(),
+    summary: v.optional(v.string()),
+    description: v.string(),
+    usage: v.string(),
+    origin: v.picklist(["handwritten", "generated"]),
+    operationId: v.optional(v.string()),
+    mutates: v.optional(v.boolean()),
+    local: v.optional(v.boolean()),
+    state: v.optional(v.picklist(["beta", "deprecated"])),
+    examples: v.optional(v.array(v.string())),
+    arguments: v.array(argumentInfoSchema),
+    options: v.array(optionInfoSchema),
+    commands: v.array(v.lazy(() => commandInfoSchema)),
+});
+/**
+ * What `<cli> commands --json` prints, in every CLI on cli-base. `scope` and `inheritedOptions` are
+ * there only when one command path was asked for. Nothing else at the top: `cli-dev lint` refuses it.
+ */
+export const commandsDocumentSchema = v.strictObject({
+    cli: v.pipe(v.string(), v.nonEmpty()),
+    version: v.pipe(v.string(), v.nonEmpty()),
+    /** The major version of the JSON the CLI's commands print. */
+    contract: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    description: v.string(),
+    globalOptions: v.array(optionInfoSchema),
+    scope: v.optional(v.array(v.string())),
+    inheritedOptions: v.optional(v.array(v.object({ path: v.array(v.string()), options: v.array(optionInfoSchema) }))),
+    commands: v.array(commandInfoSchema),
+    exitCodes: v.record(v.string(), v.pipe(v.number(), v.integer())),
+});
+export const commandsDocumentJsonSchema = () => jsonSchemaOf(commandsDocumentSchema, { command: commandInfoSchema });
+export const parseCommandsDocument = (value) => {
+    const parsed = v.safeParse(commandsDocumentSchema, value);
+    return parsed.success ? { document: parsed.output } : { problems: issuesOf(parsed.issues) };
+};
+/** The whole tree; a CLI that answers `commands <path>` adds `scope` and `inheritedOptions` itself. */
+export const commandsDocument = (root, about) => ({
+    cli: about.cli,
+    version: about.version,
+    contract: about.contract,
+    description: root.description(),
+    globalOptions: describeOptions(root),
+    commands: describeProgram(root),
+    exitCodes: { ok: 0, generic_failure: GENERIC_FAILURE, ...EXIT_CODES },
+});
+//# sourceMappingURL=document.js.map

package/dist/commands/document.js.map

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