@ir-kit/kit 0.0.1 → 1.0.0

package/dist/openapi/spec/normalize/prune.js

@@ -0,0 +1,87 @@
+import { refToName } from "@hey-api/shared";
+import { getSchemasObject, schemasPointerPrefix } from "./walk.js";
+/**
+ * Drop unreferenced `components.schemas` entries. Scoped to `targets`
+ * when supplied; otherwise performs a global reachability sweep
+ * (operations + non-schema components, then transitive closure).
+ */
+export function pruneUnusedSchemas(spec, opts = {}) {
+    if (opts.targets && opts.targets.size === 0)
+        return;
+    const schemas = getSchemasObject(spec);
+    if (!schemas)
+        return;
+    const pointerPrefix = schemasPointerPrefix(spec);
+    if (!pointerPrefix)
+        return;
+    const reachable = new Set();
+    if (opts.targets) {
+        // Any reference anywhere — even from a dead authored schema — keeps
+        // a hoisted target alive, otherwise the surviving authored schema
+        // would carry a dangling `$ref`.
+        collectRefs(spec, reachable, 
+        /* skipComponentsSchemas */ false, pointerPrefix);
+    }
+    else {
+        collectRefs(spec, reachable, 
+        /* skipComponentsSchemas */ true, pointerPrefix);
+        let frontier = new Set(reachable);
+        while (frontier.size > 0) {
+            const next = new Set();
+            for (const name of frontier) {
+                const schema = schemas[name];
+                if (!schema)
+                    continue;
+                const refs = new Set();
+                collectRefs(schema, refs, 
+                /* skipComponentsSchemas */ false, pointerPrefix);
+                for (const ref of refs) {
+                    if (!reachable.has(ref)) {
+                        reachable.add(ref);
+                        next.add(ref);
+                    }
+                }
+            }
+            frontier = next;
+        }
+    }
+    for (const name of Object.keys(schemas)) {
+        if (reachable.has(name))
+            continue;
+        if (opts.targets && !opts.targets.has(name))
+            continue;
+        delete schemas[name];
+    }
+}
+function collectRefs(node, out, skipComponentsSchemas, pointerPrefix, inComponents = false) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            collectRefs(item, out, skipComponentsSchemas, pointerPrefix, inComponents);
+        }
+        return;
+    }
+    const value = node;
+    for (const [k, v] of Object.entries(value)) {
+        if (k === "$ref" && typeof v === "string" && v.startsWith(pointerPrefix)) {
+            out.add(refToName(v));
+            continue;
+        }
+        if (skipComponentsSchemas && !inComponents && k === "components") {
+            collectRefsInComponents(v, out, pointerPrefix);
+            continue;
+        }
+        collectRefs(v, out, skipComponentsSchemas, pointerPrefix, inComponents);
+    }
+}
+function collectRefsInComponents(node, out, pointerPrefix) {
+    if (!node || typeof node !== "object" || Array.isArray(node))
+        return;
+    for (const [k, v] of Object.entries(node)) {
+        if (k === "schemas")
+            continue;
+        collectRefs(v, out, /* skip */ false, pointerPrefix, true);
+    }
+}
+//# sourceMappingURL=prune.js.map

package/dist/openapi/spec/normalize/prune.js.map

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

package/dist/openapi/spec/normalize/refs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Give every schema that is `$ref`'d from outside the components section
+ * (e.g. `#/paths/~1apps/get/responses/200/.../properties/cors`) a home in
+ * `components.schemas`, and point those refs at it. Generators then only
+ * ever see refs to declared components. Returns the added schema names.
+ */
+export declare function hoistForeignSchemaRefs(spec: unknown): Set<string>;
+//# sourceMappingURL=refs.d.ts.map

package/dist/openapi/spec/normalize/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../src/openapi/spec/normalize/refs.ts"],"names":[],"mappings":"AAsDA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAoCjE"}

package/dist/openapi/spec/normalize/refs.js

@@ -0,0 +1,98 @@
+import { uniqueComponentName } from "./name.js";
+import { getSchemasObject, schemasPointerPrefix } from "./walk.js";
+const STRUCTURAL = new Set([
+    "additionalProperties",
+    "allOf",
+    "anyOf",
+    "content",
+    "items",
+    "not",
+    "oneOf",
+    "properties",
+    "schema",
+]);
+function decodePointer(ref) {
+    return ref
+        .slice(2)
+        .split("/")
+        .map((s) => decodeURIComponent(s).replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+function resolvePointer(spec, segments) {
+    let node = spec;
+    for (const seg of segments) {
+        if (!node || typeof node !== "object")
+            return undefined;
+        node = node[seg];
+    }
+    return node;
+}
+function visitRefs(node, visit) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node)
+            visitRefs(item, visit);
+        return;
+    }
+    const obj = node;
+    if (typeof obj.$ref === "string")
+        visit(obj, obj.$ref);
+    for (const v of Object.values(obj))
+        visitRefs(v, visit);
+}
+function nameFor(segments) {
+    for (let i = segments.length - 1; i >= 0; i--) {
+        const seg = segments[i];
+        if (!STRUCTURAL.has(seg) && !/^\d+$/.test(seg) && !seg.includes("/"))
+            return seg;
+    }
+    return "Schema";
+}
+/**
+ * Give every schema that is `$ref`'d from outside the components section
+ * (e.g. `#/paths/~1apps/get/responses/200/.../properties/cors`) a home in
+ * `components.schemas`, and point those refs at it. Generators then only
+ * ever see refs to declared components. Returns the added schema names.
+ */
+export function hoistForeignSchemaRefs(spec) {
+    const added = new Set();
+    const schemas = getSchemasObject(spec);
+    const prefix = schemasPointerPrefix(spec);
+    if (!schemas || !prefix)
+        return added;
+    const isForeign = (ref) => {
+        if (!ref.startsWith("#/") || ref.startsWith("#/components/"))
+            return false;
+        if (ref.startsWith("#/definitions/"))
+            return false;
+        return decodePointer(ref).some((s) => s === "schema" || s === "schemas");
+    };
+    const targets = new Map();
+    visitRefs(spec, (_, ref) => {
+        if (!isForeign(ref) || targets.has(ref))
+            return;
+        const segments = decodePointer(ref);
+        let target = resolvePointer(spec, segments);
+        if (!target || typeof target !== "object")
+            return;
+        const inner = target.$ref;
+        if (typeof inner === "string" && !isForeign(inner)) {
+            targets.set(ref, inner);
+            return;
+        }
+        const name = uniqueComponentName(nameFor(segments), schemas, added);
+        target = structuredClone(target);
+        schemas[name] = target;
+        added.add(name);
+        targets.set(ref, `${prefix}${name}`);
+    });
+    if (targets.size === 0)
+        return added;
+    visitRefs(spec, (holder, ref) => {
+        const next = targets.get(ref);
+        if (next)
+            holder.$ref = next;
+    });
+    return added;
+}
+//# sourceMappingURL=refs.js.map

package/dist/openapi/spec/normalize/refs.js.map

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

package/dist/openapi/spec/normalize/walk.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pattern adapted from @hey-api/openapi-ts (MIT) —
+ * `packages/shared/src/openApi/shared/transforms/enums.ts`.
+ * Walker, root-path detection, and pointer-prefix logic mirror the
+ * upstream private helpers, which aren't re-exported.
+ */
+export interface SchemaNode {
+    key: string | number | null;
+    node: unknown;
+    parent: unknown;
+    path: ReadonlyArray<string | number>;
+}
+/** Visit every schema-shaped object in `spec`. */
+export declare function walkSchemas(spec: unknown, visit: (n: SchemaNode) => void): void;
+/** True when `path` points at `components.schemas.<X>` or `definitions.<X>`. */
+export declare function isRootSchemaPath(path: ReadonlyArray<string | number>): boolean;
+/** Pointer prefix for shared schemas (OpenAPI 3.x or Swagger 2.0). */
+export declare function schemasPointerPrefix(spec: unknown): string;
+/** Live handle on the spec's shared-schema map; creates containers if absent. */
+export declare function getSchemasObject(spec: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=walk.d.ts.map

package/dist/openapi/spec/normalize/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../../src/openapi/spec/normalize/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACtC;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAC7B,IAAI,CAEN;AAgCD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GACnC,OAAO,CAKT;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAK1D;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBrC"}

package/dist/openapi/spec/normalize/walk.js

@@ -0,0 +1,91 @@
+/**
+ * Pattern adapted from @hey-api/openapi-ts (MIT) —
+ * `packages/shared/src/openApi/shared/transforms/enums.ts`.
+ * Walker, root-path detection, and pointer-prefix logic mirror the
+ * upstream private helpers, which aren't re-exported.
+ */
+/** JSON Schema keywords that hold child schemas. */
+const CHILD_SCHEMA_KEYWORDS = [
+    "additionalProperties",
+    "allOf",
+    "anyOf",
+    "contains",
+    "dependentSchemas",
+    "else",
+    "if",
+    "items",
+    "oneOf",
+    "patternProperties",
+    "properties",
+    "propertyNames",
+    "then",
+    "unevaluatedProperties",
+];
+/** Visit every schema-shaped object in `spec`. */
+export function walkSchemas(spec, visit) {
+    walk({ key: null, node: spec, parent: null, path: [] }, visit);
+}
+function walk(n, visit) {
+    const { node, path } = n;
+    if (!node || typeof node !== "object" || Array.isArray(node))
+        return;
+    const value = node;
+    if (isSchemaShaped(value))
+        visit(n);
+    for (const [k, v] of Object.entries(value)) {
+        if (v === null || typeof v !== "object")
+            continue;
+        if (Array.isArray(v)) {
+            v.forEach((item, index) => walk({ key: index, node: item, parent: v, path: [...path, k, index] }, visit));
+        }
+        else {
+            walk({ key: k, node: v, parent: node, path: [...path, k] }, visit);
+        }
+    }
+}
+function isSchemaShaped(value) {
+    if ("type" in value || "enum" in value)
+        return true;
+    for (const keyword of CHILD_SCHEMA_KEYWORDS) {
+        if (keyword in value)
+            return true;
+    }
+    return false;
+}
+/** True when `path` points at `components.schemas.<X>` or `definitions.<X>`. */
+export function isRootSchemaPath(path) {
+    if (path.length === 3 && path[0] === "components" && path[1] === "schemas") {
+        return true;
+    }
+    return path.length === 2 && path[0] === "definitions";
+}
+/** Pointer prefix for shared schemas (OpenAPI 3.x or Swagger 2.0). */
+export function schemasPointerPrefix(spec) {
+    if (!spec || typeof spec !== "object")
+        return "";
+    if ("openapi" in spec)
+        return "#/components/schemas/";
+    if ("swagger" in spec)
+        return "#/definitions/";
+    return "";
+}
+/** Live handle on the spec's shared-schema map; creates containers if absent. */
+export function getSchemasObject(spec) {
+    if (!spec || typeof spec !== "object")
+        return undefined;
+    const s = spec;
+    if ("openapi" in s) {
+        const components = (s.components ?? {});
+        s.components = components;
+        const schemas = (components.schemas ?? {});
+        components.schemas = schemas;
+        return schemas;
+    }
+    if ("swagger" in s) {
+        const defs = (s.definitions ?? {});
+        s.definitions = defs;
+        return defs;
+    }
+    return undefined;
+}
+//# sourceMappingURL=walk.js.map

package/dist/openapi/spec/normalize/walk.js.map

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

package/dist/openapi/spec/ref.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from "../../schema/index.js";
+/**
+ * Empty / unknown / void schemas — short-circuits a 2xx response to a
+ * no-payload return (Kotlin `Unit`, Swift `Void`, Go's absent return).
+ */
+export declare function isMeaningless(s: Schema): boolean;
+//# sourceMappingURL=ref.d.ts.map

package/dist/openapi/spec/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../../src/openapi/spec/ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAOhD"}

package/dist/openapi/spec/ref.js

@@ -0,0 +1,18 @@
+/**
+ * Empty / unknown / void schemas — short-circuits a 2xx response to a
+ * no-payload return (Kotlin `Unit`, Swift `Void`, Go's absent return).
+ */
+export function isMeaningless(s) {
+    if (s.$ref || s.const !== undefined)
+        return false;
+    if (s.items)
+        return false;
+    if (s.properties && Object.keys(s.properties).length > 0)
+        return false;
+    if (s.oneOf?.length || s.anyOf?.length || s.allOf?.length)
+        return false;
+    if (s.enum && s.enum.length > 0)
+        return false;
+    return s.type === undefined;
+}
+//# sourceMappingURL=ref.js.map

package/dist/openapi/spec/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/openapi/spec/ref.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC1B,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9B,CAAC"}

package/dist/openapi/type/components.d.ts

@@ -0,0 +1,36 @@
+import type { Namespace } from "../../codegen/index.js";
+import type { IR } from "../../ir/index.js";
+import { type Schema } from "../../schema/index.js";
+/** How a top-level component schema maps onto a declaration. */
+export type ComponentShape = 
+/** Alias of another component, by its claimed type name. */
+{
+    kind: "ref";
+    target: string;
+} | {
+    kind: "enum";
+}
+/** Object with properties, or sealed (`additionalProperties: false`). */
+ | {
+    kind: "struct";
+}
+/** Open object; `value` is the typed `additionalProperties`, if any. */
+ | {
+    kind: "map";
+    value?: Schema;
+}
+/** Anything else: an alias of the schema's own type. */
+ | {
+    kind: "type";
+};
+export interface Component {
+    name: string;
+    schema: Schema;
+    shape: ComponentShape;
+}
+/**
+ * Claim every component's type name, then classify each one. Names are
+ * claimed up front so they win over synthesized inline type names.
+ */
+export declare function classifyComponents(schemas: Record<string, IR.Schema>, names: Namespace): Component[];
+//# sourceMappingURL=components.d.ts.map

package/dist/openapi/type/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/openapi/type/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI7D,gEAAgE;AAChE,MAAM,MAAM,cAAc;AACxB,4DAA4D;AAC1D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,yEAAyE;GACvE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB,wEAAwE;GACtE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACjC,wDAAwD;GACtD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAClC,KAAK,EAAE,SAAS,GACf,SAAS,EAAE,CAUb"}

package/dist/openapi/type/components.js

@@ -0,0 +1,33 @@
+import { refName } from "../../schema/index.js";
+import { schemaTypeName } from "./dispatch.js";
+/**
+ * Claim every component's type name, then classify each one. Names are
+ * claimed up front so they win over synthesized inline type names.
+ */
+export function classifyComponents(schemas, names) {
+    for (const rawName of Object.keys(schemas))
+        schemaTypeName(names, rawName);
+    return Object.entries(schemas).map(([rawName, heySchema]) => {
+        const schema = heySchema;
+        return {
+            name: schemaTypeName(names, rawName),
+            schema,
+            shape: componentShape(schema, names),
+        };
+    });
+}
+function componentShape(schema, names) {
+    if (schema.$ref) {
+        return { kind: "ref", target: schemaTypeName(names, refName(schema.$ref)) };
+    }
+    if (Array.isArray(schema.enum) && schema.enum.length > 0) {
+        return { kind: "enum" };
+    }
+    if (schema.type !== "object")
+        return { kind: "type" };
+    const ap = schema.additionalProperties;
+    if (schema.properties || ap === false)
+        return { kind: "struct" };
+    return { kind: "map", value: ap && typeof ap === "object" ? ap : undefined };
+}
+//# sourceMappingURL=components.js.map

package/dist/openapi/type/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../src/openapi/type/components.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAe,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAoB/C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAkC,EAClC,KAAgB;IAEhB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE;QAC1D,MAAM,MAAM,GAAG,SAAS,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;YACpC,MAAM;YACN,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,KAAgB;IACtD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,oBAAoB,CAAC;IACvC,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,KAAK,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC/E,CAAC"}

package/dist/openapi/type/context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared type-walker context, generic over the per-target Decl type.
+ * Each emitter narrows `D` to its own AST node — `GoDecl`, `KtDecl`,
+ * `SwDecl`, etc. — and re-exports a concrete alias.
+ *
+ * The walker uses `emit` to promote synthesised inline types
+ * (objects, enums) to top-level declarations; `ownerName` and
+ * `propPath` drive deterministic names for those synthesised types
+ * (e.g. `Owner_Path`).
+ */
+import type { Namespace } from "../../codegen/index.js";
+export interface TypeCtx<D> {
+    emit: (d: D) => void;
+    /** Owns every top-level type name for one generation run. Component
+     *  schemas, `$ref`s and synthesized inline types all resolve through
+     *  it, so a name is spelled the same at every site and never declared
+     *  twice. */
+    names: Namespace;
+    /** Used to synthesise names for inline objects/enums: `Owner_Path`. */
+    ownerName: string;
+    propPath: ReadonlyArray<string>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/openapi/type/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/openapi/type/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACrB;;;iBAGa;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC"}

package/dist/openapi/type/context.js

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

package/dist/openapi/type/context.js.map

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

package/dist/openapi/type/dispatch.d.ts

@@ -0,0 +1,77 @@
+import type { Namespace } from "../../codegen/index.js";
+import { type EnumLiteral, type ObjectProperty, type Schema } from "../../schema/index.js";
+import type { TypeCtx } from "./context.js";
+/**
+ * Per-target leaf operations the shared dispatchers (`schemaToType`,
+ * `unionToType`, `inlineObjectType`) call into. `T` is the emitter's
+ * target type (`GoType` / `KtType` / `SwType`), `D` its decl type.
+ *
+ * Each emitter writes one of these records. All per-target rendering
+ * (pointer vs nullable, naming conventions, synthName joiner, decl
+ * construction) lives here; the dispatchers stay neutral.
+ */
+export interface SchemaToTypeOps<T, D> {
+    refType(name: string): T;
+    arrayType(elem: T): T;
+    mapType(valueType: T): T;
+    /** Caller's "no return" analog — `goAny` (drops the result slot),
+     *  `ktUnit`, `swVoid`. */
+    voidType(): T;
+    /** Caller's untyped fallback — `goAny` / `ktAny` / `swAny`. */
+    anyType(): T;
+    /** Standalone nullable-any — what `null`-typed primitives become. */
+    nullableAnyType(): T;
+    /** Wrap a known type in the target's optional wrapper for the union
+     *  "single + nullable" path. Go's choice is conditional
+     *  (`isPointerable`), so the hook receives both the inner type and
+     *  the nullable bit. */
+    wrapForUnionSingle(inner: T, nullable: boolean): T;
+    /** Fallback type for unions with 2+ non-null branches. Go ignores
+     *  `nullable` (interface already holds nil); Kotlin / Swift wrap. */
+    unionFallback(nullable: boolean): T;
+    /** Primitive dispatch. Returns `undefined` for non-primitive schemas
+     *  so the outer dispatcher can fall through. */
+    primitiveType(schema: Schema): T | undefined;
+    /** Build a synth name from `ctx.ownerName` + `propPath`. Joiner is
+     *  per-target — Go uses `""` to keep `go vet` quiet, Kotlin / Swift
+     *  use `"_"`. */
+    synthName(ownerName: string, propPath: ReadonlyArray<string>): string;
+    buildStructDecl(name: string, properties: ReadonlyArray<ObjectProperty>, ctx: TypeCtx<D>, dispatch: (s: Schema, c: TypeCtx<D>) => T): D;
+    emitStringEnum(name: string, raws: ReadonlyArray<string>, emit: (d: D) => void, names: Namespace): T;
+    emitIntegerEnum(name: string, raws: ReadonlyArray<number>, emit: (d: D) => void, names: Namespace): T;
+    /** Unions with 2+ non-null branches. Targets with a native sum type
+     *  (e.g. protobuf `oneof`) build it here; others fall back to
+     *  `unionFallback`. */
+    multiUnion?(schema: Schema, ctx: TypeCtx<D>, dispatch: (s: Schema, c: TypeCtx<D>) => T): T;
+}
+export declare function unionToType<T, D>(schema: Schema, ctx: TypeCtx<D>, ops: SchemaToTypeOps<T, D>, dispatch: (s: Schema, c: TypeCtx<D>) => T): T;
+export declare function inlineObjectType<T, D>(schema: Schema, ctx: TypeCtx<D>, ops: SchemaToTypeOps<T, D>, dispatch: (s: Schema, c: TypeCtx<D>) => T): T;
+/**
+ * Top-level dispatch from a canonical {@link Schema} to a target type.
+ * Routes each schema shape to the appropriate handler (`unionToType` /
+ * `inlineObjectType` / per-target enum emitter / target leaf constructor).
+ * Per-target leaf decisions live in `ops`.
+ *
+ * Dispatch order:
+ *  1. `$ref` → named ref
+ *  2. enum (`enum: [...]` or `oneOf`-of-consts)
+ *  3. union shape (`oneOf` / `anyOf` / `allOf` / array-form `type`)
+ *  4. primitive (per-target hook decides)
+ *  5. compound by `type` (array / object / null)
+ */
+export declare function schemaToType<T, D>(schema: Schema, ctx: TypeCtx<D>, ops: SchemaToTypeOps<T, D>): T;
+/** Type name for the component schema `rawName` (`#/components/schemas/<rawName>`). */
+export declare function schemaTypeName(names: Namespace, rawName: string): string;
+/** Type name for the inline schema at `ctx.ownerName` + `ctx.propPath`. */
+export declare function synthTypeName<T, D>(ctx: TypeCtx<D>, ops: Pick<SchemaToTypeOps<T, D>, "synthName">, path?: ReadonlyArray<string>): string;
+/**
+ * Map enum literals onto a target type. String / integer domains emit a
+ * named enum (`named: true`); number / boolean domains become the
+ * matching primitive and mixed domains the untyped fallback — those
+ * leave `name` unused so the caller decides whether to alias it.
+ */
+export declare function enumType<T, D>(name: string, literals: ReadonlyArray<EnumLiteral>, ops: SchemaToTypeOps<T, D>, { emit, names }: Pick<TypeCtx<D>, "emit" | "names">): {
+    type: T;
+    named: boolean;
+};
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/openapi/type/dispatch.d.ts.map

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