ajsc 5.2.4 → 7.1.0

package/dist/kotlin/typeMapper.js

@@ -0,0 +1,107 @@
+import { getOrCreateEnumDecl } from "./enums.js";
+import { handleUnsupportedUnion } from "./unsupported.js";
+export const PRIMITIVES = {
+    string: "String",
+    integer: "Long",
+    number: "Double",
+    boolean: "Boolean",
+    null: "Unit",
+};
+export const FORMAT_MAP = {
+    "date-time": { type: "Instant", import: "java.time.Instant", needsContextual: true },
+    "date": { type: "LocalDate", import: "java.time.LocalDate", needsContextual: true },
+    "time": { type: "LocalTime", import: "java.time.LocalTime", needsContextual: true },
+    "uuid": { type: "UUID", import: "java.util.UUID", needsContextual: true },
+    "uri": { type: "URI", import: "java.net.URI", needsContextual: true },
+};
+export const STRING_DOC_FORMATS = new Set(["email", "hostname", "ipv4", "ipv6"]);
+/**
+ * Maps an IRNode to its Kotlin type expression. Handles primitives, formatted
+ * strings (with `@Contextual` and KDoc tracking), arrays, tuples (Pair/Triple),
+ * referenced object types, string enums, literals, and unions (T | null
+ * unwrapping, sealed-interface dispatch, unsupported-union policy).
+ */
+export function generateKotlinType(c, ir, utils) {
+    switch (ir.type) {
+        case "string": {
+            const fmt = ir.constraints?.format;
+            if (fmt && FORMAT_MAP[fmt]) {
+                const m = FORMAT_MAP[fmt];
+                c.importsSet.add(m.import);
+                if (c.isKotlinx && m.needsContextual) {
+                    c.importsSet.add("kotlinx.serialization.Contextual");
+                    c.contextualNodes.add(ir);
+                }
+                return m.type;
+            }
+            if (fmt && STRING_DOC_FORMATS.has(fmt)) {
+                c.docFormatNodes.set(ir, fmt);
+            }
+            return "String";
+        }
+        case "integer": {
+            const fmt = ir.constraints?.format;
+            if (fmt === "int32")
+                return "Int";
+            return PRIMITIVES.integer;
+        }
+        case "number":
+        case "boolean":
+        case "null":
+            return PRIMITIVES[ir.type];
+        case "array":
+            return `List<${ir.items ? generateKotlinType(c, ir.items, utils) : "Any"}>`;
+        case "tuple": {
+            const items = ir.tupleItems ?? [];
+            if (items.length === 2) {
+                return `Pair<${generateKotlinType(c, items[0], utils)}, ${generateKotlinType(c, items[1], utils)}>`;
+            }
+            if (items.length === 3) {
+                return `Triple<${items.map((i) => generateKotlinType(c, i, utils)).join(", ")}>`;
+            }
+            throw new Error(`Unsupported: Kotlin tuple of length ${items.length} at "${ir.path}"; only Pair (2) and Triple (3) are supported.`);
+        }
+        case "object": {
+            const ref = utils.getReferencedType(ir);
+            if (ref)
+                return ref;
+            return "Any";
+        }
+        case "enum": {
+            if (ir.values?.every((v) => typeof v === "string")) {
+                return getOrCreateEnumDecl(c, ir.values, ir.path);
+            }
+            // fall through to Any for non-string enums (rare)
+            return "Any";
+        }
+        case "literal": {
+            const v = ir.constraints?.value;
+            if (typeof v === "string")
+                return "String";
+            if (typeof v === "boolean")
+                return "Boolean";
+            if (typeof v === "number") {
+                return Number.isInteger(v) ? "Long" : "Double";
+            }
+            if (v === null)
+                return "Unit";
+            return "Any";
+        }
+        case "union": {
+            // T | null → unwrap, mark nullable at the property level
+            const non = ir.options?.filter((o) => o.type !== "null") ?? [];
+            if (non.length === 1)
+                return generateKotlinType(c, non[0], utils);
+            // Discriminated union: enhanceDiscriminatedUnions populated variantNames
+            if (ir.options?.length &&
+                ir.options.every((o) => c.variantNames.has(o))) {
+                return c.emitSealedInterface(ir, utils);
+            }
+            // Untagged union — apply unsupportedUnions policy
+            return handleUnsupportedUnion(c, ir);
+        }
+        default:
+            return "Any";
+    }
+}
+//# sourceMappingURL=typeMapper.js.map

package/dist/kotlin/typeMapper.js.map

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

package/dist/kotlin/unsupported.d.ts

@@ -0,0 +1,13 @@
+import { IRNode } from "../types.js";
+import type { KotlinConverterContext } from "./KotlinConverter.js";
+/**
+ * Applies the `unsupportedUnions` policy for an untagged union that survived
+ * merging and has no usable discriminator.
+ */
+export declare function handleUnsupportedUnion(c: KotlinConverterContext, ir: IRNode): string;
+/**
+ * Pre-emission guard pass that throws on JSON Schema features Kotlin codegen
+ * does not support: `not` and `patternProperties`. These are NOT silenced by
+ * `unsupportedUnions: 'fallback'`.
+ */
+export declare function guardUnsupportedKeywords(_c: KotlinConverterContext, root: IRNode): void;

package/dist/kotlin/unsupported.js

@@ -0,0 +1,53 @@
+/**
+ * Applies the `unsupportedUnions` policy for an untagged union that survived
+ * merging and has no usable discriminator.
+ */
+export function handleUnsupportedUnion(c, ir) {
+    const policy = c.baseOpts?.unsupportedUnions ?? "throw";
+    if (policy === "throw") {
+        const opts = ir.options?.map((o) => o.type).join(", ") ?? "?";
+        throw new Error(`Unsupported: untagged union at "${ir.path}"\n` +
+            `  options: [${opts}]\n` +
+            `  Add a discriminator property with a const per variant, or set unsupportedUnions:'fallback' to emit JsonElement.`);
+    }
+    // fallback
+    if (c.isKotlinx) {
+        c.importsSet.add("kotlinx.serialization.json.JsonElement");
+        return "JsonElement";
+    }
+    return "Any";
+}
+/**
+ * Pre-emission guard pass that throws on JSON Schema features Kotlin codegen
+ * does not support: `not` and `patternProperties`. These are NOT silenced by
+ * `unsupportedUnions: 'fallback'`.
+ */
+export function guardUnsupportedKeywords(_c, root) {
+    const walk = (n) => {
+        if (n.not) {
+            throw new Error(`Unsupported: \`not\` keyword at "${n.path}".`);
+        }
+        if (n.patternProperties &&
+            Object.keys(n.patternProperties).length > 0) {
+            throw new Error(`Unsupported: patternProperties at "${n.path}".`);
+        }
+        if (n.properties) {
+            for (const k of Object.keys(n.properties))
+                walk(n.properties[k]);
+        }
+        if (n.items)
+            walk(n.items);
+        if (n.tupleItems)
+            for (const t of n.tupleItems)
+                walk(t);
+        if (n.options)
+            for (const o of n.options)
+                walk(o);
+        if (n.additionalProperties &&
+            typeof n.additionalProperties !== "boolean") {
+            walk(n.additionalProperties);
+        }
+    };
+    walk(root);
+}
+//# sourceMappingURL=unsupported.js.map

package/dist/kotlin/unsupported.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported.js","sourceRoot":"","sources":["../../src/kotlin/unsupported.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAyB,EAAE,EAAU;IAC1E,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,iBAAiB,IAAI,OAAO,CAAC;IACxD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,mCAAmC,EAAE,CAAC,IAAI,KAAK;YAC7C,eAAe,IAAI,KAAK;YACxB,mHAAmH,CACtH,CAAC;IACJ,CAAC;IACD,WAAW;IACX,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAC3D,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAA0B,EAAE,IAAY;IAC/E,MAAM,IAAI,GAAG,CAAC,CAAS,EAAQ,EAAE;QAC/B,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,IACE,CAAC,CAAC,iBAAiB;YACnB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,EAC3C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,CAAC,KAAK;YAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,UAAU;YAAE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,OAAO;YAAE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,IACE,CAAC,CAAC,oBAAoB;YACtB,OAAO,CAAC,CAAC,oBAAoB,KAAK,SAAS,EAC3C,CAAC;YACD,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;AACb,CAAC"}

package/dist/swift/SwiftBaseConverter.d.ts

@@ -0,0 +1,18 @@
+import { BaseConverter, GenerateTypeUtils } from "../converter/BaseConverter.js";
+import { IRNode } from "../types.js";
+export declare const SWIFT_RESERVED: Set<string>;
+/**
+ * Converts a JSON property key to a valid Swift identifier:
+ * - kebab/snake → camelCase
+ * - non-identifier chars stripped
+ * - leading digit gets `_` prefix
+ * - reserved words wrapped in backticks
+ * - empty result becomes "value"
+ */
+export declare function sanitizeSwiftIdentifier(raw: string): string;
+export declare abstract class SwiftBaseConverter extends BaseConverter {
+    /** @internal Mutated by SwiftConverter helper modules; not part of the public API. */
+    importsSet: Set<string>;
+    /** @internal Public for `BaseConverterContext`; treat as protected for subclasses. */
+    abstract generateObjectType(ir: IRNode, utils: GenerateTypeUtils): string;
+}

package/dist/swift/SwiftBaseConverter.js

@@ -0,0 +1,38 @@
+import { BaseConverter } from "../converter/BaseConverter.js";
+export const SWIFT_RESERVED = new Set([
+    "associatedtype", "class", "deinit", "enum", "extension", "fileprivate",
+    "func", "import", "init", "inout", "internal", "let", "open", "operator",
+    "private", "protocol", "public", "static", "struct", "subscript",
+    "typealias", "var", "break", "case", "continue", "default", "defer",
+    "do", "else", "fallthrough", "for", "guard", "if", "in", "repeat",
+    "return", "switch", "where", "while", "as", "Any", "catch", "false",
+    "is", "nil", "rethrows", "super", "self", "Self", "throw", "throws",
+    "true", "try",
+]);
+/**
+ * Converts a JSON property key to a valid Swift identifier:
+ * - kebab/snake → camelCase
+ * - non-identifier chars stripped
+ * - leading digit gets `_` prefix
+ * - reserved words wrapped in backticks
+ * - empty result becomes "value"
+ */
+export function sanitizeSwiftIdentifier(raw) {
+    let name = raw.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+    name = name.replace(/[^a-zA-Z0-9_]/g, "");
+    if (!name)
+        name = "value";
+    if (/^\d/.test(name))
+        name = "_" + name;
+    if (SWIFT_RESERVED.has(name))
+        name = "`" + name + "`";
+    return name;
+}
+export class SwiftBaseConverter extends BaseConverter {
+    constructor() {
+        super(...arguments);
+        /** @internal Mutated by SwiftConverter helper modules; not part of the public API. */
+        this.importsSet = new Set();
+    }
+}
+//# sourceMappingURL=SwiftBaseConverter.js.map

package/dist/swift/SwiftBaseConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwiftBaseConverter.js","sourceRoot":"","sources":["../../src/swift/SwiftBaseConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAqB,MAAM,+BAA+B,CAAC;AAGjF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IACpC,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa;IACvE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU;IACxE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW;IAChE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO;IACnE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ;IACjE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;IACnE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;IACnE,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,IAAI,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,IAAI,GAAG,OAAO,CAAC;IAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAgB,kBAAmB,SAAQ,aAAa;IAA9D;;QACE,sFAAsF;QAC/E,eAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAIxC,CAAC;CAAA"}

package/dist/swift/SwiftConverter.d.ts

@@ -0,0 +1,60 @@
+import { JSONSchema7Definition } from "json-schema";
+import { ILanguageConverter, IRNode } from "../types.js";
+import { BaseConverterContext, BaseConverterOpts, GenerateTypeUtils, LanguageProfile } from "../converter/BaseConverter.js";
+import { SwiftBaseConverter } from "./SwiftBaseConverter.js";
+export interface SwiftConverterOpts extends BaseConverterOpts {
+    serializer?: "codable" | "none";
+    accessLevel?: "public" | "internal";
+}
+/**
+ * The state-and-method surface that helper modules in `src/swift/` need to
+ * operate on a SwiftConverter instance. SwiftConverter implements this;
+ * helpers take it as their first argument.
+ *
+ * @internal
+ */
+export interface SwiftConverterContext extends BaseConverterContext {
+    readonly isCodable: boolean;
+    readonly accessLevel: "public" | "internal";
+    needsAnyCodable: boolean;
+    readonly importsSet: Set<string>;
+    readonly docFormatNodes: WeakMap<IRNode, string>;
+    readonly enumDecls: Map<string, {
+        name: string;
+        values: string[];
+    }>;
+    readonly sealedEnumDecls: string[];
+    generateType(ir: IRNode, utils: GenerateTypeUtils): string;
+    emitSwiftDiscriminatedEnum(ir: IRNode, utils: GenerateTypeUtils): string;
+}
+export declare class SwiftConverter extends SwiftBaseConverter implements ILanguageConverter, SwiftConverterContext {
+    readonly code: string;
+    readonly rootTypeName: string;
+    readonly extractedTypeNames: string[];
+    readonly imports: string[];
+    /** @internal Public for `BaseConverterContext`; treat as protected for subclasses. */
+    readonly languageProfile: LanguageProfile;
+    /** @internal Mutated by SwiftConverter helper modules; not part of the public API. */
+    isCodable: boolean;
+    /** @internal */
+    accessLevel: "public" | "internal";
+    /** @internal */
+    enumDecls: Map<string, {
+        name: string;
+        values: string[];
+    }>;
+    /** @internal */
+    docFormatNodes: WeakMap<IRNode, string>;
+    /** @internal */
+    sealedEnumDecls: string[];
+    /** @internal */
+    needsAnyCodable: boolean;
+    constructor(schema: JSONSchema7Definition, opts?: SwiftConverterOpts);
+    protected codableConformance(): string;
+    /** @internal Public for `SwiftConverterContext`; treat as protected for subclasses. */
+    generateType(ir: IRNode, utils: GenerateTypeUtils): string;
+    /** @internal Public for `BaseConverterContext`; treat as protected for subclasses. */
+    generateObjectType(ir: IRNode, utils: GenerateTypeUtils): string;
+    /** @internal Public for `SwiftConverterContext`; treat as protected for subclasses. */
+    emitSwiftDiscriminatedEnum(ir: IRNode, utils: GenerateTypeUtils): string;
+}

package/dist/swift/SwiftConverter.js

@@ -0,0 +1,113 @@
+import { JSONSchemaConverter } from "../ir/JSONSchemaConverter.js";
+import { SwiftBaseConverter } from "./SwiftBaseConverter.js";
+import { guardUnsupportedKeywords, anyCodableHelper } from "./unsupported.js";
+import { buildEnumDeclarations } from "./enums.js";
+import { generateSwiftType } from "./typeMapper.js";
+import { generateSwiftObjectType } from "./structEmitter.js";
+import { emitSwiftDiscriminatedEnum } from "./discriminatedEnum.js";
+export class SwiftConverter extends SwiftBaseConverter {
+    constructor(schema, opts) {
+        super();
+        /** @internal */
+        this.enumDecls = new Map();
+        /** @internal */
+        this.docFormatNodes = new WeakMap();
+        /** @internal */
+        this.sealedEnumDecls = [];
+        /** @internal */
+        this.needsAnyCodable = false;
+        this.baseOpts = opts;
+        if (opts?.nameRegistry)
+            this.usedDeclarationNames = opts.nameRegistry;
+        this.isCodable = (opts?.serializer ?? "codable") === "codable";
+        this.accessLevel = opts?.accessLevel ?? "public";
+        this.languageProfile = {
+            language: "swift",
+            processOneOfAsDiscriminatedUnion: true,
+            shouldEraseDiscriminator: this.isCodable,
+            getDiscriminatedVariantParentName: () => "",
+        };
+        const ir = this.mergeCompatibleUnions(new JSONSchemaConverter(schema).irNode);
+        this.enhanceDiscriminatedUnions(ir);
+        guardUnsupportedKeywords(this, ir);
+        if (opts?.rootTypeName)
+            ir.name = opts.rootTypeName;
+        if (!ir.name)
+            ir.name = ir.title || "Root";
+        this.rootName = ir.name;
+        this.usedDeclarationNames.add(ir.name);
+        const utils = {
+            getReferencedType: this.getReferencedType.bind(this),
+        };
+        // Root-level string enum: emit a single Swift `enum` and skip the struct path.
+        if (ir.type === "enum" && ir.values?.every((v) => typeof v === "string")) {
+            const key = JSON.stringify([...ir.values].sort());
+            this.enumDecls.set(key, { name: ir.name, values: ir.values });
+            const enumCode = buildEnumDeclarations(this);
+            this.code = enumCode.join("\n\n") + "\n";
+            this.rootTypeName = ir.name;
+            this.extractedTypeNames = [];
+            this.imports = [...this.importsSet].sort();
+            return;
+        }
+        let rootDecl;
+        let needsRootStruct = true;
+        if (ir.type === "union" &&
+            ir.options?.length &&
+            ir.options.every((o) => this.variantNames.has(o))) {
+            // Root IS the discriminated union — emit it as a Swift enum directly.
+            this.emitSwiftDiscriminatedEnum(ir, utils);
+            needsRootStruct = false;
+            rootDecl = "";
+        }
+        else {
+            const rootBody = this.generateObjectType(ir, utils);
+            const rootDoc = this.rootDoc;
+            const rootDocPrefix = rootDoc ? `/// ${rootDoc}\n` : "";
+            rootDecl = `${rootDocPrefix}${this.accessLevel} struct ${ir.name}${this.codableConformance()} ${rootBody}`;
+        }
+        const childDecls = this.refTypes
+            .filter(({ name }) => name !== this.rootName)
+            .map(({ name, code, doc }) => {
+            const docPrefix = doc ? `/// ${doc}\n` : "";
+            return `${docPrefix}${this.accessLevel} struct ${name}${this.codableConformance()} ${code}`;
+        });
+        const enumCode = buildEnumDeclarations(this);
+        const allDecls = [...enumCode, ...this.sealedEnumDecls, ...childDecls];
+        if (needsRootStruct)
+            allDecls.push(rootDecl);
+        this.code = allDecls.filter(Boolean).join("\n\n") + "\n";
+        if (this.needsAnyCodable) {
+            this.code += "\n" + anyCodableHelper(this) + "\n";
+        }
+        this.rootTypeName = ir.name;
+        const refTypeNames = this.computeExtractedTypeNames().filter((n) => n !== this.rootTypeName);
+        const enumNames = [...this.enumDecls.values()].map(({ name }) => name).filter((n) => n !== this.rootTypeName);
+        const variantStructNames = [];
+        for (const decl of this.sealedEnumDecls) {
+            const matches = decl.matchAll(/struct (\w+)/g);
+            for (const m of matches) {
+                if (m[1] !== this.rootTypeName)
+                    variantStructNames.push(m[1]);
+            }
+        }
+        this.extractedTypeNames = [...new Set([...variantStructNames, ...enumNames, ...refTypeNames])];
+        this.imports = [...this.importsSet].sort();
+    }
+    codableConformance() {
+        return this.isCodable ? ": Codable" : "";
+    }
+    /** @internal Public for `SwiftConverterContext`; treat as protected for subclasses. */
+    generateType(ir, utils) {
+        return generateSwiftType(this, ir, utils);
+    }
+    /** @internal Public for `BaseConverterContext`; treat as protected for subclasses. */
+    generateObjectType(ir, utils) {
+        return generateSwiftObjectType(this, ir, utils);
+    }
+    /** @internal Public for `SwiftConverterContext`; treat as protected for subclasses. */
+    emitSwiftDiscriminatedEnum(ir, utils) {
+        return emitSwiftDiscriminatedEnum(this, ir, utils);
+    }
+}
+//# sourceMappingURL=SwiftConverter.js.map

package/dist/swift/SwiftConverter.js.map

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

package/dist/swift/discriminatedEnum.d.ts

@@ -0,0 +1,18 @@
+import { GenerateTypeUtils } from "../converter/BaseConverter.js";
+import { IRNode } from "../types.js";
+import type { SwiftConverterContext } from "./SwiftConverter.js";
+/**
+ * Emits a Swift `enum` with associated-value cases plus per-variant nested
+ * `struct` declarations for a discriminated union, registering them in
+ * `c.sealedEnumDecls`. Idempotent for nested visits: re-emitting the same
+ * enum short-circuits via `sealedEnumDeclsContainsName`.
+ */
+export declare function emitSwiftDiscriminatedEnum(c: SwiftConverterContext, ir: IRNode, utils: GenerateTypeUtils): string;
+/** Derives the Swift discriminated-enum name for a union IR node. */
+export declare function deriveSwiftSealedName(c: SwiftConverterContext, ir: IRNode): string;
+/**
+ * Substring-scans `c.sealedEnumDecls` for an existing declaration matching the
+ * given name. Used to detect prior emission so the orchestrator can skip the
+ * regular ref-types path for sealed variants.
+ */
+export declare function sealedEnumDeclsContainsName(c: SwiftConverterContext, name: string): boolean;

package/dist/swift/discriminatedEnum.js

@@ -0,0 +1,99 @@
+import { Emitter } from "../converter/Emitter.js";
+import { toSwiftCaseName } from "./enums.js";
+import { generateSwiftObjectType } from "./structEmitter.js";
+/**
+ * Emits a Swift `enum` with associated-value cases plus per-variant nested
+ * `struct` declarations for a discriminated union, registering them in
+ * `c.sealedEnumDecls`. Idempotent for nested visits: re-emitting the same
+ * enum short-circuits via `sealedEnumDeclsContainsName`.
+ */
+export function emitSwiftDiscriminatedEnum(c, ir, utils) {
+    const enumName = deriveSwiftSealedName(c, ir);
+    if (c.usedDeclarationNames.has(enumName) && sealedEnumDeclsContainsName(c, enumName)) {
+        return enumName;
+    }
+    c.usedDeclarationNames.add(enumName);
+    const options = ir.options;
+    const discriminator = c.findDiscriminatorProperty(options, c.collectUnionPropertyNames(options).sharedPropNames);
+    if (!discriminator)
+        return "Any";
+    const variants = [];
+    for (const opt of options) {
+        const variantName = c.variantNames.get(opt);
+        const discValue = c.getConstStringValue(opt.properties[discriminator]);
+        const caseName = toSwiftCaseName(discValue);
+        // Build nested struct body, optionally erasing discriminator under codable
+        const tempIR = c.stripDiscriminatorField(opt, discriminator);
+        const body = generateSwiftObjectType(c, tempIR, utils);
+        variants.push({ caseName, structName: variantName, discValue, body });
+    }
+    const accessLevel = c.accessLevel;
+    const conformance = c.isCodable ? ": Codable" : "";
+    const e = new Emitter({ indentUnit: "    " });
+    e.block(`${accessLevel} enum ${enumName}${conformance}`, () => {
+        for (const v of variants) {
+            e.line(`case ${v.caseName}(${v.structName})`);
+        }
+        e.blank();
+        // Nested variant structs. `v.body` is a `{\n  ... \n}` block with its own
+        // 2-space inner indentation; `raw()` prefixes each non-empty line with the
+        // current Emitter indent (4 spaces here), preserving the existing inner
+        // 2-space indent for struct fields.
+        for (const v of variants) {
+            e.raw(`${accessLevel} struct ${v.structName}${conformance} ${v.body}`);
+            e.blank();
+        }
+        if (c.isCodable) {
+            e.line(`private enum CodingKeys: String, CodingKey { case ${discriminator} }`);
+            const kindCases = variants
+                .map((v) => v.caseName === v.discValue
+                ? `case ${v.caseName}`
+                : `case ${v.caseName} = "${v.discValue}"`)
+                .join("; ");
+            e.line(`private enum Kind: String, Codable { ${kindCases} }`);
+            e.blank();
+            e.block(`${accessLevel} init(from decoder: Decoder) throws`, () => {
+                e.line("let container = try decoder.container(keyedBy: CodingKeys.self)");
+                e.line(`let kind = try container.decode(Kind.self, forKey: .${discriminator})`);
+                e.line("let single = try decoder.singleValueContainer()");
+                e.block("switch kind", () => {
+                    for (const v of variants) {
+                        e.line(`case .${v.caseName}: self = .${v.caseName}(try single.decode(${v.structName}.self))`);
+                    }
+                });
+            });
+            e.blank();
+            e.block(`${accessLevel} func encode(to encoder: Encoder) throws`, () => {
+                e.line("var container = encoder.singleValueContainer()");
+                e.block("switch self", () => {
+                    for (const v of variants) {
+                        e.line(`case .${v.caseName}(let v): try container.encode(v)`);
+                    }
+                });
+            });
+        }
+    });
+    c.sealedEnumDecls.push(e.toString());
+    for (const v of variants)
+        c.usedDeclarationNames.add(v.structName);
+    return enumName;
+}
+/** Derives the Swift discriminated-enum name for a union IR node. */
+export function deriveSwiftSealedName(c, ir) {
+    if (ir.name)
+        return ir.name;
+    if (ir.title)
+        return ir.title;
+    const segments = ir.path.split(".").filter((x) => !/^\d+$/.test(x));
+    const baseName = segments.map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("") || "Union";
+    return c.findAvailableName(baseName);
+}
+/**
+ * Substring-scans `c.sealedEnumDecls` for an existing declaration matching the
+ * given name. Used to detect prior emission so the orchestrator can skip the
+ * regular ref-types path for sealed variants.
+ */
+export function sealedEnumDeclsContainsName(c, name) {
+    return c.sealedEnumDecls.some((d) => d.includes(`enum ${name}`));
+}
+//# sourceMappingURL=discriminatedEnum.js.map

package/dist/swift/discriminatedEnum.js.map

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

package/dist/swift/enums.d.ts

@@ -0,0 +1,15 @@
+import type { SwiftConverterContext } from "./SwiftConverter.js";
+/**
+ * Returns or creates a Swift `enum` declaration name for a given set of
+ * string values, deduplicating by sorted-values key. Tracks the declaration
+ * for later emission via {@link buildEnumDeclarations}.
+ */
+export declare function getOrCreateEnumDecl(c: SwiftConverterContext, values: string[], path: string): string;
+/** Sanitizes a JSON enum value into a Swift enum case name (lowerCamelCase). */
+export declare function toSwiftCaseName(value: string): string;
+/**
+ * Builds Swift raw-value `enum` declarations from the converter's accumulated
+ * `enumDecls` map. Used for both nested enums (rendered alongside structs) and
+ * root-level enum schemas (where the root IS the enum).
+ */
+export declare function buildEnumDeclarations(c: SwiftConverterContext): string[];

package/dist/swift/enums.js

@@ -0,0 +1,62 @@
+import { toPascalCase } from "../utils/to-pascal-case.js";
+/**
+ * Returns or creates a Swift `enum` declaration name for a given set of
+ * string values, deduplicating by sorted-values key. Tracks the declaration
+ * for later emission via {@link buildEnumDeclarations}.
+ */
+export function getOrCreateEnumDecl(c, values, path) {
+    const key = JSON.stringify([...values].sort());
+    const existing = c.enumDecls.get(key);
+    if (existing)
+        return existing.name;
+    const segments = path.split(".").filter((x) => !/^\d+$/.test(x));
+    const baseName = segments.map((s) => toPascalCase(s)).join("") || "Value";
+    const name = c.findAvailableName(baseName);
+    c.usedDeclarationNames.add(name);
+    c.enumDecls.set(key, { name, values });
+    return name;
+}
+/** Sanitizes a JSON enum value into a Swift enum case name (lowerCamelCase). */
+export function toSwiftCaseName(value) {
+    // Step 1: kebab/snake → camelCase, then strip invalid chars.
+    let n = value.replace(/[-_](.)/g, (_, c) => c.toUpperCase());
+    n = n.replace(/[^a-zA-Z0-9_]/g, "");
+    if (!n)
+        n = "value";
+    if (/^\d/.test(n))
+        n = "_" + n;
+    // Preserve all-uppercase identifiers (e.g. "US", "URL", "ID") to match Swift convention
+    // for acronyms — otherwise they'd render awkwardly as `uS`, `uRL`, etc.
+    if (n.length >= 2 && /^[A-Z][A-Z0-9_]*$/.test(n))
+        return n;
+    // Otherwise lowerCamelCase per Swift convention.
+    return n.charAt(0).toLowerCase() + n.slice(1);
+}
+/**
+ * Builds Swift raw-value `enum` declarations from the converter's accumulated
+ * `enumDecls` map. Used for both nested enums (rendered alongside structs) and
+ * root-level enum schemas (where the root IS the enum).
+ */
+export function buildEnumDeclarations(c) {
+    return [...c.enumDecls.values()].map(({ name, values }) => {
+        const usedCases = new Set();
+        const cases = values.map((v) => {
+            let caseName = toSwiftCaseName(v);
+            const baseC = caseName;
+            let i = 2;
+            while (usedCases.has(caseName)) {
+                caseName = baseC + i;
+                i++;
+            }
+            usedCases.add(caseName);
+            // emit `case foo` if caseName matches v exactly, else `case foo = "raw"`
+            if (caseName === v) {
+                return `  case ${caseName}`;
+            }
+            return `  case ${caseName} = "${v}"`;
+        });
+        const conformance = c.isCodable ? ", Codable" : "";
+        return `${c.accessLevel} enum ${name}: String${conformance} {\n${cases.join("\n")}\n}`;
+    });
+}
+//# sourceMappingURL=enums.js.map