@ir-kit/schema 0.2.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed Rowaihi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# `@ir-kit/schema`
+
+Canonical JSON Schema 2020-12 IR shared across the OpenAPI and AsyncAPI codegen families. Source-agnostic — adapters fold hey-api's `IR.SchemaObject`, raw JSON Schema (any draft), and OpenAPI 3.0 `nullable` quirks into one shape so every emitter (`@ir-kit/openapi-{go,kotlin,swift,typescript}`, `@ir-kit/asyncapi-typescript`, `@ir-kit/k6-codegen`) reads the same model.
+
+## Install
+
+```sh
+npm install @ir-kit/schema
+# adapter from hey-api needs:
+npm install @hey-api/shared
+```
+
+## Use
+
+```ts
+import {
+  type Schema,
+  classifyUnion,
+  classifyObject,
+  classifyEnumLiterals,
+  extractEnumValues,
+} from "@ir-kit/schema";
+
+const schema: Schema = {
+  oneOf: [{ type: "string" }, { type: "null" }],
+};
+
+const shape = classifyUnion(schema);
+// → { kind: "single", inner: { type: "string" }, nullable: true }
+```
+
+## Adapters
+
+```ts
+import { fromHeyApi } from "@ir-kit/schema/adapters/heyapi";
+import { fromJsonSchema } from "@ir-kit/schema/adapters/jsonschema";
+
+const canonical = fromHeyApi(heyApiIrSchemaObject);
+const fromAsync = fromJsonSchema(asyncSchema.json(), { dialect: "draft-07" });
+const fromOas3  = fromJsonSchema(openapi30Schema); // `nullable: true` folded into type[]
+```
+
+## Scope
+
+This is the **dialect**: types + classifiers + adapters. Per-target rendering (Go pointer vs Kotlin nullable, struct emission, enum identifier transforms) lives in each emitter package — see `@ir-kit/openapi`'s `SchemaToTypeOps<T,D>` interface.
+
+Subset of JSON Schema 2020-12. Omitted (codegen can't bind cleanly): `$dynamicRef`, `$dynamicAnchor`, `unevaluatedProperties`, `unevaluatedItems`, `if`/`then`/`else`, `dependentSchemas`, `dependentRequired`, `contains`.
+
+## Status
+
+`0.1.0` — first release. Consumers (`@ir-kit/openapi`, `@ir-kit/asyncapi-typescript`, `@ir-kit/k6-codegen`) migrate incrementally in follow-up changesets.
+
+## Repo
+
+Source at [ir-kit/ir-kit](https://github.com/ir-kit/ir-kit/tree/main/packages/shared/schema).

package/dist/adapters/heyapi.d.ts

@@ -0,0 +1,16 @@
+import type { IR } from "@hey-api/shared";
+import type { Schema } from "../types.js";
+/**
+ * Adapt `IR.SchemaObject` (hey-api's normalized intermediate form) to
+ * canonical {@link Schema}.
+ *
+ * Normalizations:
+ *  - `type:"enum"` + `items[].const` → `enum: [...]`
+ *  - `type:"tuple"`                  → `type:"array"` + `prefixItems`
+ *  - `type:"void"|"never"|"undefined"` → `type` left unset
+ *  - `logicalOperator:"or"|"and"`      → `oneOf` / `allOf`
+ *  - untyped + items[]                 → `oneOf` (hey-api's implicit
+ *                                        union convention)
+ */
+export declare function fromHeyApi(s: IR.SchemaObject): Schema;
+//# sourceMappingURL=heyapi.d.ts.map

package/dist/adapters/heyapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heyapi.d.ts","sourceRoot":"","sources":["../../src/adapters/heyapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,MAAM,CAsGrD"}

package/dist/adapters/heyapi.js

@@ -0,0 +1,137 @@
+/**
+ * Adapt `IR.SchemaObject` (hey-api's normalized intermediate form) to
+ * canonical {@link Schema}.
+ *
+ * Normalizations:
+ *  - `type:"enum"` + `items[].const` → `enum: [...]`
+ *  - `type:"tuple"`                  → `type:"array"` + `prefixItems`
+ *  - `type:"void"|"never"|"undefined"` → `type` left unset
+ *  - `logicalOperator:"or"|"and"`      → `oneOf` / `allOf`
+ *  - untyped + items[]                 → `oneOf` (hey-api's implicit
+ *                                        union convention)
+ */
+export function fromHeyApi(s) {
+    const out = {};
+    if (s.$ref) {
+        out.$ref = s.$ref;
+    }
+    else {
+        // hey-api's post-resolution marker for a generated symbol —
+        // express it canonically as a $ref into `#/components/schemas`.
+        const sym = s.symbolRef;
+        if (sym?.name)
+            out.$ref = `#/components/schemas/${sym.name}`;
+    }
+    if (s.title)
+        out.title = s.title;
+    if (s.description)
+        out.description = s.description;
+    if (s.deprecated !== undefined)
+        out.deprecated = s.deprecated;
+    if (s.default !== undefined)
+        out.default = s.default;
+    if (s.format)
+        out.format = s.format;
+    if (s.pattern)
+        out.pattern = s.pattern;
+    if (s.minLength !== undefined)
+        out.minLength = s.minLength;
+    if (s.maxLength !== undefined)
+        out.maxLength = s.maxLength;
+    if (s.minimum !== undefined)
+        out.minimum = s.minimum;
+    if (s.maximum !== undefined)
+        out.maximum = s.maximum;
+    if (typeof s.exclusiveMinimum === "number")
+        out.exclusiveMinimum = s.exclusiveMinimum;
+    if (typeof s.exclusiveMaximum === "number")
+        out.exclusiveMaximum = s.exclusiveMaximum;
+    if (s.const !== undefined)
+        out.const = s.const;
+    if (s.logicalOperator === "and" && Array.isArray(s.items)) {
+        out.allOf = s.items.map(fromHeyApi);
+    }
+    else if (s.logicalOperator === "or" && Array.isArray(s.items)) {
+        out.oneOf = s.items.map(fromHeyApi);
+    }
+    else if (!s.type && Array.isArray(s.items) && s.items.length > 0) {
+        out.oneOf = s.items.map(fromHeyApi);
+    }
+    if (s.properties) {
+        out.properties = {};
+        for (const [k, v] of Object.entries(s.properties)) {
+            out.properties[k] = fromHeyApi(v);
+        }
+    }
+    if (s.required && s.required.length > 0)
+        out.required = [...s.required];
+    if (s.additionalProperties !== undefined) {
+        const ap = s.additionalProperties;
+        if (typeof ap === "boolean") {
+            out.additionalProperties = ap;
+        }
+        else if (ap.type === "never" ||
+            ap.type === "void" ||
+            ap.type === "undefined") {
+            // hey-api represents `additionalProperties: false` as a never/void/
+            // undefined-typed schema after normalization — collapse back to
+            // the canonical boolean form so emitters can sealed-detect.
+            out.additionalProperties = false;
+        }
+        else {
+            out.additionalProperties = fromHeyApi(ap);
+        }
+    }
+    switch (s.type) {
+        case "enum": {
+            const values = (s.items ?? [])
+                .map((i) => i.const)
+                .filter((v) => typeof v === "string" ||
+                typeof v === "number" ||
+                typeof v === "boolean");
+            if (values.length > 0)
+                out.enum = values;
+            out.type = inferEnumType(values);
+            break;
+        }
+        case "tuple": {
+            out.type = "array";
+            if (Array.isArray(s.items) && s.items.length > 0) {
+                out.prefixItems = s.items.map(fromHeyApi);
+            }
+            break;
+        }
+        case "array": {
+            out.type = "array";
+            const elem = Array.isArray(s.items) ? s.items[0] : undefined;
+            if (elem)
+                out.items = fromHeyApi(elem);
+            break;
+        }
+        case "void":
+        case "never":
+        case "undefined":
+            break;
+        case "object":
+        case "string":
+        case "number":
+        case "integer":
+        case "boolean":
+        case "null":
+            out.type = s.type;
+            break;
+    }
+    return out;
+}
+function inferEnumType(values) {
+    if (values.every((v) => typeof v === "string"))
+        return "string";
+    if (values.every((v) => typeof v === "number" && Number.isInteger(v)))
+        return "integer";
+    if (values.every((v) => typeof v === "number"))
+        return "number";
+    if (values.every((v) => typeof v === "boolean"))
+        return "boolean";
+    return undefined;
+}
+//# sourceMappingURL=heyapi.js.map

package/dist/adapters/heyapi.js.map

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

package/dist/adapters/jsonschema.d.ts

@@ -0,0 +1,16 @@
+import type { Schema } from "../types.js";
+export type JsonSchemaDialect = "draft-04" | "draft-06" | "draft-07" | "2019-09" | "2020-12";
+export interface FromJsonSchemaOptions {
+    /** Source dialect — drives normalization of legacy quirks (boolean
+     *  `exclusiveMinimum`, array-form `items` as tuple, `definitions` →
+     *  `$defs`). Defaults to `2020-12` (pass-through). */
+    dialect?: JsonSchemaDialect;
+}
+/**
+ * Adapt raw JSON Schema (any draft) → canonical {@link Schema}. Pure
+ * conversion: no validation, no ref resolution. Unknown keywords are
+ * dropped. OpenAPI 3.0's `nullable: true` is folded into the type
+ * array regardless of dialect (it's a common quirk).
+ */
+export declare function fromJsonSchema(raw: unknown, opts?: FromJsonSchemaOptions): Schema;
+//# sourceMappingURL=jsonschema.d.ts.map

package/dist/adapters/jsonschema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.d.ts","sourceRoot":"","sources":["../../src/adapters/jsonschema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,UAAU,GACV,UAAU,GACV,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC;;0DAEsD;IACtD,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAYD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,qBAA0B,GAC/B,MAAM,CAwIR"}

package/dist/adapters/jsonschema.js

@@ -0,0 +1,161 @@
+const PRIMITIVE_TYPES = new Set([
+    "string",
+    "number",
+    "integer",
+    "boolean",
+    "null",
+    "object",
+    "array",
+]);
+/**
+ * Adapt raw JSON Schema (any draft) → canonical {@link Schema}. Pure
+ * conversion: no validation, no ref resolution. Unknown keywords are
+ * dropped. OpenAPI 3.0's `nullable: true` is folded into the type
+ * array regardless of dialect (it's a common quirk).
+ */
+export function fromJsonSchema(raw, opts = {}) {
+    if (typeof raw !== "object" || raw === null)
+        return {};
+    const r = raw;
+    const dialect = opts.dialect ?? "2020-12";
+    const out = {};
+    if (typeof r.$ref === "string")
+        out.$ref = r.$ref;
+    if (typeof r.title === "string")
+        out.title = r.title;
+    if (typeof r.description === "string")
+        out.description = r.description;
+    if (typeof r.deprecated === "boolean")
+        out.deprecated = r.deprecated;
+    if (typeof r.readOnly === "boolean")
+        out.readOnly = r.readOnly;
+    if (typeof r.writeOnly === "boolean")
+        out.writeOnly = r.writeOnly;
+    if (r.default !== undefined)
+        out.default = r.default;
+    if (typeof r.format === "string")
+        out.format = r.format;
+    if (typeof r.pattern === "string")
+        out.pattern = r.pattern;
+    if (typeof r.minLength === "number")
+        out.minLength = r.minLength;
+    if (typeof r.maxLength === "number")
+        out.maxLength = r.maxLength;
+    if (typeof r.minimum === "number")
+        out.minimum = r.minimum;
+    if (typeof r.maximum === "number")
+        out.maximum = r.maximum;
+    if (typeof r.multipleOf === "number")
+        out.multipleOf = r.multipleOf;
+    if (typeof r.minItems === "number")
+        out.minItems = r.minItems;
+    if (typeof r.maxItems === "number")
+        out.maxItems = r.maxItems;
+    if (typeof r.uniqueItems === "boolean")
+        out.uniqueItems = r.uniqueItems;
+    if (r.const !== undefined)
+        out.const = r.const;
+    if (Array.isArray(r.enum) && r.enum.length > 0)
+        out.enum = r.enum;
+    if (Array.isArray(r.examples))
+        out.examples = r.examples;
+    if (Array.isArray(r.required)) {
+        const req = r.required.filter((x) => typeof x === "string");
+        if (req.length > 0)
+            out.required = req;
+    }
+    if (dialect === "draft-04") {
+        if (r.exclusiveMinimum === true && typeof r.minimum === "number") {
+            out.exclusiveMinimum = r.minimum;
+        }
+        else if (typeof r.exclusiveMinimum === "number") {
+            out.exclusiveMinimum = r.exclusiveMinimum;
+        }
+        if (r.exclusiveMaximum === true && typeof r.maximum === "number") {
+            out.exclusiveMaximum = r.maximum;
+        }
+        else if (typeof r.exclusiveMaximum === "number") {
+            out.exclusiveMaximum = r.exclusiveMaximum;
+        }
+    }
+    else {
+        if (typeof r.exclusiveMinimum === "number")
+            out.exclusiveMinimum = r.exclusiveMinimum;
+        if (typeof r.exclusiveMaximum === "number")
+            out.exclusiveMaximum = r.exclusiveMaximum;
+    }
+    const nullable = r.nullable === true;
+    if (typeof r.type === "string" && isPrimitiveTag(r.type)) {
+        out.type = nullable && r.type !== "null" ? [r.type, "null"] : r.type;
+    }
+    else if (Array.isArray(r.type)) {
+        const tags = r.type.filter((t) => typeof t === "string" && isPrimitiveTag(t));
+        if (tags.length > 0) {
+            out.type = nullable && !tags.includes("null") ? [...tags, "null"] : tags;
+        }
+    }
+    else if (nullable) {
+        out.type = ["null"];
+    }
+    if (Array.isArray(r.oneOf))
+        out.oneOf = r.oneOf.map((b) => fromJsonSchema(b, opts));
+    if (Array.isArray(r.anyOf))
+        out.anyOf = r.anyOf.map((b) => fromJsonSchema(b, opts));
+    if (Array.isArray(r.allOf))
+        out.allOf = r.allOf.map((b) => fromJsonSchema(b, opts));
+    if (r.not && typeof r.not === "object")
+        out.not = fromJsonSchema(r.not, opts);
+    if (r.properties && typeof r.properties === "object") {
+        out.properties = {};
+        for (const [k, v] of Object.entries(r.properties)) {
+            out.properties[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (r.patternProperties && typeof r.patternProperties === "object") {
+        out.patternProperties = {};
+        for (const [k, v] of Object.entries(r.patternProperties)) {
+            out.patternProperties[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (typeof r.additionalProperties === "boolean") {
+        out.additionalProperties = r.additionalProperties;
+    }
+    else if (r.additionalProperties &&
+        typeof r.additionalProperties === "object") {
+        out.additionalProperties = fromJsonSchema(r.additionalProperties, opts);
+    }
+    if (r.propertyNames && typeof r.propertyNames === "object") {
+        out.propertyNames = fromJsonSchema(r.propertyNames, opts);
+    }
+    if (Array.isArray(r.items)) {
+        out.prefixItems = r.items.map((b) => fromJsonSchema(b, opts));
+    }
+    else if (r.items && typeof r.items === "object") {
+        out.items = fromJsonSchema(r.items, opts);
+    }
+    if (Array.isArray(r.prefixItems)) {
+        out.prefixItems = r.prefixItems.map((b) => fromJsonSchema(b, opts));
+    }
+    const defs = (r.$defs ?? r.definitions);
+    if (defs && typeof defs === "object") {
+        out.$defs = {};
+        for (const [k, v] of Object.entries(defs)) {
+            out.$defs[k] = fromJsonSchema(v, opts);
+        }
+    }
+    if (r.discriminator &&
+        typeof r.discriminator === "object" &&
+        typeof r.discriminator.propertyName ===
+            "string") {
+        const d = r.discriminator;
+        out.discriminator = {
+            propertyName: d.propertyName,
+            ...(d.mapping ? { mapping: d.mapping } : {}),
+        };
+    }
+    return out;
+}
+function isPrimitiveTag(t) {
+    return PRIMITIVE_TYPES.has(t);
+}
+//# sourceMappingURL=jsonschema.js.map

package/dist/adapters/jsonschema.js.map

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

package/dist/enum.d.ts

@@ -0,0 +1,26 @@
+import { type Schema } from "./types.js";
+export type EnumLiteral = string | number | boolean;
+export type EnumKind = "string" | "integer";
+/**
+ * Extract enum literals from a schema. Recognises both explicit
+ * `enum: [...]` and `oneOf`/`anyOf` of `{const}` branches. Returns
+ * `undefined` when neither shape is present.
+ */
+export declare function extractEnumValues(schema: Schema): ReadonlyArray<unknown> | undefined;
+/**
+ * Throws on mixed shapes. The `name` is woven into the error so the
+ * caller doesn't have to re-wrap.
+ */
+export declare function classifyEnumLiterals(values: ReadonlyArray<unknown>, name: string): EnumKind;
+export interface EnumEntryIdent<T extends string | number> {
+    identifier: string;
+    raw: T;
+}
+/**
+ * Throws if two raw values normalize to the same target identifier
+ * (otherwise the emitted source won't compile). `noun` preserves the
+ * per-target wording — Go/Kotlin say `entry name`, Swift says `case
+ * name`; tests pin the exact phrase.
+ */
+export declare function assertNoEnumCollisions<T extends string | number>(schemaName: string, entries: Iterable<EnumEntryIdent<T>>, noun?: "entry name" | "case name"): void;
+//# sourceMappingURL=enum.d.ts.map

package/dist/enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../src/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAWpC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,QAAQ,CAWV;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,CAAC,CAAC;CACR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC9D,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EACpC,IAAI,GAAE,YAAY,GAAG,WAA0B,GAC9C,IAAI,CAiBN"}

package/dist/enum.js

@@ -0,0 +1,58 @@
+import { isSchemaObject } from "./types.js";
+/**
+ * Extract enum literals from a schema. Recognises both explicit
+ * `enum: [...]` and `oneOf`/`anyOf` of `{const}` branches. Returns
+ * `undefined` when neither shape is present.
+ */
+export function extractEnumValues(schema) {
+    if (Array.isArray(schema.enum) && schema.enum.length > 0)
+        return schema.enum;
+    const branches = schema.oneOf ?? schema.anyOf;
+    if (!branches)
+        return undefined;
+    const consts = [];
+    for (const b of branches) {
+        if (!isSchemaObject(b))
+            return undefined;
+        if (Object.hasOwn(b, "const"))
+            consts.push(b.const);
+        else
+            return undefined;
+    }
+    return consts.length > 0 ? consts : undefined;
+}
+/**
+ * Throws on mixed shapes. The `name` is woven into the error so the
+ * caller doesn't have to re-wrap.
+ */
+export function classifyEnumLiterals(values, name) {
+    const allStrings = values.every((v) => typeof v === "string");
+    const allIntegers = values.every((v) => typeof v === "number" && Number.isInteger(v));
+    if (!allStrings && !allIntegers) {
+        throw new Error(`Enum ${name}: members must all be strings or all integers; got ${JSON.stringify(values)}`);
+    }
+    return allIntegers ? "integer" : "string";
+}
+/**
+ * Throws if two raw values normalize to the same target identifier
+ * (otherwise the emitted source won't compile). `noun` preserves the
+ * per-target wording — Go/Kotlin say `entry name`, Swift says `case
+ * name`; tests pin the exact phrase.
+ */
+export function assertNoEnumCollisions(schemaName, entries, noun = "entry name") {
+    const collisions = new Map();
+    for (const { identifier, raw } of entries) {
+        const list = collisions.get(identifier) ?? [];
+        list.push(raw);
+        collisions.set(identifier, list);
+    }
+    for (const [identifier, raws] of collisions) {
+        if (raws.length > 1) {
+            const formatted = raws
+                .map((r) => (typeof r === "string" ? `"${r}"` : String(r)))
+                .join(", ");
+            throw new Error(`Enum ${schemaName}: ${noun} "${identifier}" collides for raw values [${formatted}]`);
+        }
+    }
+}
+//# sourceMappingURL=enum.js.map

package/dist/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../src/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAKzD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc;IAEd,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;;YAC/C,OAAO,SAAS,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA8B,EAC9B,IAAY;IAEZ,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CACpD,CAAC;IACF,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,QAAQ,IAAI,sDAAsD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5C,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,OAAoC,EACpC,OAAmC,YAAY;IAE/C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAe,CAAC;IAC1C,KAAK,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI;iBACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC1D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CACb,QAAQ,UAAU,KAAK,IAAI,KAAK,UAAU,8BAA8B,SAAS,GAAG,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { assertNoEnumCollisions, classifyEnumLiterals, type EnumEntryIdent, type EnumKind, type EnumLiteral, extractEnumValues, } from "./enum.js";
+export { classifyObject, iterateObjectProperties, type ObjectProperty, type ObjectShape, } from "./object.js";
+export { isPrimitive, isPrimitiveTag, primitiveTag, } from "./primitive.js";
+export { refName } from "./ref.js";
+export { isNullable, isRefOnly, isSchemaObject, type Schema, type SchemaDiscriminator, type SchemaOrBool, type SchemaPrimitiveType, typeList, } from "./types.js";
+export { classifyUnion, isUnionShape, type UnionShape, } from "./union.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,KAAK,MAAM,EACX,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { assertNoEnumCollisions, classifyEnumLiterals, extractEnumValues, } from "./enum.js";
+export { classifyObject, iterateObjectProperties, } from "./object.js";
+export { isPrimitive, isPrimitiveTag, primitiveTag, } from "./primitive.js";
+export { refName } from "./ref.js";
+export { isNullable, isRefOnly, isSchemaObject, typeList, } from "./types.js";
+export { classifyUnion, isUnionShape, } from "./union.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAIpB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EACL,UAAU,EACV,SAAS,EACT,cAAc,EAKd,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,YAAY,GAEb,MAAM,YAAY,CAAC"}

package/dist/object.d.ts

@@ -0,0 +1,30 @@
+import { type Schema } from "./types.js";
+/**
+ * Three-way object dispatch. Emitters render:
+ *  - `named-struct` → synth name, emit struct/data-class, return ref
+ *  - `map`          → wrap value in target map (`map[string]V`, etc.)
+ *  - `open-map`     → same map, value is target `any`
+ */
+export type ObjectShape = {
+    kind: "named-struct";
+} | {
+    kind: "map";
+    valueSchema: Schema;
+} | {
+    kind: "open-map";
+};
+export declare function classifyObject(schema: Schema): ObjectShape;
+export interface ObjectProperty {
+    jsonKey: string;
+    schema: Schema;
+    required: boolean;
+    /** `string` + `format: "binary"`. Common enough across emitters
+     *  (multipart-binary handling) to surface alongside the iteration. */
+    isBinary: boolean;
+    /** Pre-pascal'd segment ready to plug into `synthName(owner, [seg])`.
+     *  All emitters synth identifiers from PascalCase pieces; computing
+     *  once here keeps emitters narrow. */
+    propPathSegment: string;
+}
+export declare function iterateObjectProperties(schema: Schema): Generator<ObjectProperty>;
+//# sourceMappingURL=object.d.ts.map

package/dist/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAO1D;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB;0EACsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB;;2CAEuC;IACvC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAiB,uBAAuB,CACtC,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,cAAc,CAAC,CAY3B"}

package/dist/object.js

@@ -0,0 +1,25 @@
+import { pascal } from "@ir-kit/codegen-core";
+import { isSchemaObject } from "./types.js";
+export function classifyObject(schema) {
+    if (Object.keys(schema.properties ?? {}).length > 0)
+        return { kind: "named-struct" };
+    const ap = schema.additionalProperties;
+    if (ap && isSchemaObject(ap))
+        return { kind: "map", valueSchema: ap };
+    return { kind: "open-map" };
+}
+export function* iterateObjectProperties(schema) {
+    const required = new Set(schema.required ?? []);
+    for (const [jsonKey, propSchema] of Object.entries(schema.properties ?? {})) {
+        if (!isSchemaObject(propSchema))
+            continue;
+        yield {
+            jsonKey,
+            schema: propSchema,
+            required: required.has(jsonKey),
+            isBinary: propSchema.type === "string" && propSchema.format === "binary",
+            propPathSegment: pascal(jsonKey),
+        };
+    }
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAazD,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,oBAAoB,CAAC;IACvC,IAAI,EAAE,IAAI,cAAc,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,EAAY,EAAE,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAeD,MAAM,SAAS,CAAC,CAAC,uBAAuB,CACtC,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;YAAE,SAAS;QAC1C,MAAM;YACJ,OAAO;YACP,MAAM,EAAE,UAAoB;YAC5B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAC/B,QAAQ,EAAE,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ;YACxE,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC;SACjC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/primitive.d.ts

@@ -0,0 +1,7 @@
+import type { Schema, SchemaPrimitiveType } from "./types.js";
+export declare function isPrimitiveTag(t: SchemaPrimitiveType): boolean;
+export declare function isPrimitive(schema: Schema): boolean;
+/** Sole non-null primitive tag, or `undefined` if the schema is
+ *  compound / multi-typed / null-only. */
+export declare function primitiveTag(schema: Schema): SchemaPrimitiveType | undefined;
+//# sourceMappingURL=primitive.d.ts.map

package/dist/primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../src/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAW9D,wBAAgB,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAE9D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;0CAC0C;AAC1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAI5E"}

package/dist/primitive.js

@@ -0,0 +1,24 @@
+import { typeList } from "./types.js";
+const PRIMITIVE_TAGS = new Set([
+    "string",
+    "number",
+    "integer",
+    "boolean",
+    "null",
+]);
+export function isPrimitiveTag(t) {
+    return PRIMITIVE_TAGS.has(t);
+}
+export function isPrimitive(schema) {
+    const tags = typeList(schema).filter((t) => t !== "null");
+    return tags.length === 1 && isPrimitiveTag(tags[0]);
+}
+/** Sole non-null primitive tag, or `undefined` if the schema is
+ *  compound / multi-typed / null-only. */
+export function primitiveTag(schema) {
+    const tags = typeList(schema).filter((t) => t !== "null");
+    if (tags.length !== 1)
+        return undefined;
+    return isPrimitiveTag(tags[0]) ? tags[0] : undefined;
+}
+//# sourceMappingURL=primitive.js.map

package/dist/primitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.js","sourceRoot":"","sources":["../src/primitive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAsB;IAClD,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,CAAsB;IACnD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AACvD,CAAC;AAED;0CAC0C;AAC1C,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/ref.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Last `/`-separated segment of a JSON-pointer ref (with `~1`/`~0`
+ * decoded) — the conventional codegen "schema name". Handles both
+ * `#/$defs/X` (2020-12) and `#/components/schemas/X` (OpenAPI)
+ * uniformly. External / empty refs are returned untouched.
+ */
+export declare function refName(ref: string): string;
+//# sourceMappingURL=ref.d.ts.map

package/dist/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C"}

package/dist/ref.js

@@ -0,0 +1,17 @@
+/**
+ * Last `/`-separated segment of a JSON-pointer ref (with `~1`/`~0`
+ * decoded) — the conventional codegen "schema name". Handles both
+ * `#/$defs/X` (2020-12) and `#/components/schemas/X` (OpenAPI)
+ * uniformly. External / empty refs are returned untouched.
+ */
+export function refName(ref) {
+    if (!ref)
+        return ref;
+    const hashIdx = ref.lastIndexOf("#");
+    const fragment = hashIdx >= 0 ? ref.slice(hashIdx + 1) : ref;
+    const last = fragment.split("/").pop();
+    if (!last)
+        return ref;
+    return last.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+//# sourceMappingURL=ref.js.map

package/dist/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../src/ref.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,51 @@
+import type { JSONSchema, TypeName } from "json-schema-typed/draft-2020-12";
+/**
+ * Canonical schema model — re-exports of the JSON Schema 2020-12
+ * typings from [`json-schema-typed`](https://www.npmjs.com/package/json-schema-typed).
+ * Adapters fold each spec family (hey-api's `IR.SchemaObject`, raw
+ * JSON Schema of any draft, OpenAPI 3.0 `nullable`) into this shape;
+ * emitters consume only this.
+ *
+ * We add one OpenAPI-only extension (`discriminator`) since it's
+ * common enough across the emitter surface to carry at the top level.
+ */
+/** Primitive type tags. Sourced from the upstream `TypeName` enum so
+ *  values stay in sync with the spec. */
+export type SchemaPrimitiveType = `${TypeName}`;
+/** OpenAPI-only — emitters use it for tagged-union dispatch. Not part
+ *  of vanilla JSON Schema. */
+export interface SchemaDiscriminator {
+    propertyName: string;
+    mapping?: Record<string, string>;
+}
+/**
+ * Canonical schema node. Structurally `JSONSchema.Interface` (the
+ * object form of `json-schema-typed`'s `JSONSchema` — i.e. the spec
+ * type with the `true`/`false` schema booleans excluded) plus our
+ * OpenAPI `discriminator` extension. Nested recursive fields
+ * (`properties`, `items`, `oneOf`, `additionalProperties`, etc.) still
+ * type to upstream `JSONSchema` (= `Interface | boolean`), per the
+ * spec — guard for `boolean` at use sites.
+ */
+export type Schema = JSONSchema.Interface & {
+    discriminator?: SchemaDiscriminator;
+};
+/** A nested schema slot per the spec — either an object schema or the
+ *  `true`/`false` boolean schema. Equivalent to upstream `JSONSchema`. */
+export type SchemaOrBool = JSONSchema;
+/** Narrowing helper: a nested `SchemaOrBool` slot is a real object schema. */
+export declare function isSchemaObject(s: SchemaOrBool): s is JSONSchema.Interface;
+export declare function isRefOnly(schema: Schema): schema is Schema & {
+    $ref: string;
+};
+/**
+ * Normalize `schema.type` to an array form for uniform handling.
+ * Returns `[]` for untyped schemas — those are typically composition
+ * shells whose `type` is implied by `oneOf` / `anyOf`.
+ */
+export declare function typeList(schema: Schema): ReadonlyArray<SchemaPrimitiveType>;
+/** True when the schema permits `null` — either via `type` containing
+ *  `"null"` or via a `oneOf`/`anyOf` branch that is exactly
+ *  `{ type: "null" }`. */
+export declare function isNullable(schema: Schema): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;;;;;;;;GASG;AAEH;yCACyC;AACzC,MAAM,MAAM,mBAAmB,GAAG,GAAG,QAAQ,EAAE,CAAC;AAEhD;8BAC8B;AAC9B,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,GAAG;IAC1C,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC,CAAC;AAEF;0EAC0E;AAC1E,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,IAAI,UAAU,CAAC,SAAS,CAEzE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAK3E;AAED;;0BAE0B;AAC1B,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CASlD"}

package/dist/types.js

@@ -0,0 +1,33 @@
+/** Narrowing helper: a nested `SchemaOrBool` slot is a real object schema. */
+export function isSchemaObject(s) {
+    return typeof s === "object" && s !== null;
+}
+export function isRefOnly(schema) {
+    return typeof schema.$ref === "string";
+}
+/**
+ * Normalize `schema.type` to an array form for uniform handling.
+ * Returns `[]` for untyped schemas — those are typically composition
+ * shells whose `type` is implied by `oneOf` / `anyOf`.
+ */
+export function typeList(schema) {
+    const t = schema.type;
+    if (t === undefined)
+        return [];
+    if (Array.isArray(t))
+        return t;
+    return [t];
+}
+/** True when the schema permits `null` — either via `type` containing
+ *  `"null"` or via a `oneOf`/`anyOf` branch that is exactly
+ *  `{ type: "null" }`. */
+export function isNullable(schema) {
+    if (typeList(schema).includes("null"))
+        return true;
+    const branches = schema.oneOf ?? schema.anyOf;
+    if (!branches)
+        return false;
+    return branches.some((b) => isSchemaObject(b) &&
+        (b.type === "null" || (Array.isArray(b.type) && b.type.includes("null"))));
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyCA,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,CAAe;IAC5C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAuC,CAAC;IACrE,OAAO,CAAC,CAAwB,CAAC,CAAC;AACpC,CAAC;AAED;;0BAE0B;AAC1B,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAC9C,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,EAAE,CACJ,cAAc,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAC5E,CAAC;AACJ,CAAC"}

package/dist/union.d.ts

@@ -0,0 +1,23 @@
+import { type Schema, type SchemaOrBool } from "./types.js";
+/**
+ * Composition-shape outcomes. Each emitter renders per-target — Go
+ * pointer vs Kotlin nullable vs Swift optional, fallback to `any` vs
+ * `Any`. `nullable` is reported on `single`/`multi` but caller decides
+ * whether to apply it (Go drops, Kotlin/Swift wrap).
+ */
+export type UnionShape = {
+    kind: "intersection-with-properties";
+} | {
+    kind: "intersection-empty";
+} | {
+    kind: "single";
+    inner: Schema;
+    nullable: boolean;
+} | {
+    kind: "multi";
+    nullable: boolean;
+};
+export declare function classifyUnion(schema: Schema): UnionShape;
+export declare function isUnionShape(schema: Schema): boolean;
+export type { SchemaOrBool };
+//# sourceMappingURL=union.d.ts.map

package/dist/union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../src/union.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,8BAA8B,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAqCxD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKpD;AAMD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/union.js

@@ -0,0 +1,46 @@
+import { isNullable, isSchemaObject, typeList, } from "./types.js";
+export function classifyUnion(schema) {
+    if (schema.allOf && schema.allOf.length > 0) {
+        return schema.properties
+            ? { kind: "intersection-with-properties" }
+            : { kind: "intersection-empty" };
+    }
+    const branches = schema.oneOf ?? schema.anyOf;
+    if (branches && branches.length > 0) {
+        const objectBranches = branches.filter(isSchemaObject);
+        const nonNull = objectBranches.filter((b) => b.type !== "null" && !(Array.isArray(b.type) && onlyNull(b.type)));
+        const nullable = nonNull.length < branches.length ||
+            objectBranches.some((b) => isNullable(b));
+        if (nonNull.length === 1) {
+            return { kind: "single", inner: nonNull[0], nullable };
+        }
+        return { kind: "multi", nullable };
+    }
+    const types = typeList(schema);
+    const nonNullTypes = types.filter((t) => t !== "null");
+    if (types.length > 1) {
+        const nullable = isNullable(schema);
+        if (nonNullTypes.length === 1) {
+            return {
+                kind: "single",
+                inner: { ...schema, type: nonNullTypes[0] },
+                nullable,
+            };
+        }
+        return { kind: "multi", nullable };
+    }
+    return { kind: "multi", nullable: false };
+}
+export function isUnionShape(schema) {
+    if (schema.allOf && schema.allOf.length > 0)
+        return true;
+    if (schema.oneOf && schema.oneOf.length > 0)
+        return true;
+    if (schema.anyOf && schema.anyOf.length > 0)
+        return true;
+    return Array.isArray(schema.type) && schema.type.length > 1;
+}
+function onlyNull(t) {
+    return t.length === 1 && t[0] === "null";
+}
+//# sourceMappingURL=union.js.map

package/dist/union.js.map

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

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@ir-kit/schema",
+  "version": "0.2.0",
+  "description": "Canonical JSON Schema 2020-12 IR shared across OpenAPI and AsyncAPI codegen families. Source-agnostic schema model + adapters from hey-api's IR.SchemaObject and @asyncapi/parser schemas.",
+  "keywords": [
+    "json-schema",
+    "json-schema-2020-12",
+    "ir",
+    "codegen",
+    "openapi",
+    "asyncapi"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/shared/schema",
+  "bugs": {
+    "url": "https://github.com/ir-kit/ir-kit/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "directory": "packages/shared/schema"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapters/heyapi": {
+      "types": "./dist/adapters/heyapi.d.ts",
+      "import": "./dist/adapters/heyapi.js"
+    },
+    "./adapters/jsonschema": {
+      "types": "./dist/adapters/jsonschema.d.ts",
+      "import": "./dist/adapters/jsonschema.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@hey-api/shared": ">=0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@hey-api/shared": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "json-schema-typed": "^8.0.2",
+    "@ir-kit/codegen-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@hey-api/shared": "^0.4.2",
+    "@types/node": "^22",
+    "vitest": "^4.0.0",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}