@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/sdk/kotlin/ir/type/property-naming.d.ts

@@ -0,0 +1,26 @@
+export interface PropertyName {
+    /** The original key as it appears in the OpenAPI schema / JSON wire format. */
+    jsonKey: string;
+    /** The idiomatic Kotlin identifier the generated data class uses (already
+     *  backtick-escaped if it would collide with a reserved keyword). */
+    kotlinName: string;
+    /** True when the kotlin name differs from the JSON key — emit
+     *  `@SerialName(jsonKey)` on the property. */
+    renamed: boolean;
+}
+/**
+ * Translate an OpenAPI property name into a Kotlin identifier following
+ * lower-camelCase conventions. When the result differs from the JSON
+ * key the caller is responsible for emitting a `@SerialName` annotation
+ * to preserve wire compatibility.
+ *
+ *   first_name   → firstName   (renamed)
+ *   first-name   → firstName   (renamed)
+ *   firstName    → firstName   (no rename)
+ *   id           → id          (no rename)
+ *   class        → `class`     (no rename, but escaped — caller still
+ *                              emits `@SerialName("class")` to avoid
+ *                              the backticks being part of the wire)
+ */
+export declare function propertyName(jsonKey: string): PropertyName;
+//# sourceMappingURL=property-naming.d.ts.map

package/dist/sdk/kotlin/ir/type/property-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-naming.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/property-naming.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB;yEACqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;kDAC8C;IAC9C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAS1D"}

package/dist/sdk/kotlin/ir/type/property-naming.js

@@ -0,0 +1,27 @@
+import { camel } from "../../../../codegen/index.js";
+import { paramIdent } from "../identifiers.js";
+/**
+ * Translate an OpenAPI property name into a Kotlin identifier following
+ * lower-camelCase conventions. When the result differs from the JSON
+ * key the caller is responsible for emitting a `@SerialName` annotation
+ * to preserve wire compatibility.
+ *
+ *   first_name   → firstName   (renamed)
+ *   first-name   → firstName   (renamed)
+ *   firstName    → firstName   (no rename)
+ *   id           → id          (no rename)
+ *   class        → `class`     (no rename, but escaped — caller still
+ *                              emits `@SerialName("class")` to avoid
+ *                              the backticks being part of the wire)
+ */
+export function propertyName(jsonKey) {
+    const camelName = camel(jsonKey);
+    const kotlinName = paramIdent(jsonKey);
+    // Backtick-escaping for reserved keywords doesn't constitute a rename
+    // for serialization purposes (the wire still uses the bare name), but
+    // we still emit `@SerialName` because kotlinx-serialization sees the
+    // backticked form as a distinct identifier.
+    const renamed = camelName !== jsonKey;
+    return { jsonKey, kotlinName, renamed };
+}
+//# sourceMappingURL=property-naming.js.map

package/dist/sdk/kotlin/ir/type/property-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-naming.js","sourceRoot":"","sources":["../../../../../src/sdk/kotlin/ir/type/property-naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAa/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,sEAAsE;IACtE,sEAAsE;IACtE,qEAAqE;IACrE,4CAA4C;IAC5C,MAAM,OAAO,GAAG,SAAS,KAAK,OAAO,CAAC;IACtC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/sdk/kotlin/ir/type-ops.d.ts

@@ -0,0 +1,13 @@
+import { type SchemaToTypeOps } from "../../../openapi/index.js";
+import type { KtDecl } from "../ast/index.js";
+import { type KtType } from "../ast/index.js";
+/**
+ * Kotlin's plug into the shared `schemaToType` dispatcher. Per-target
+ * choices: `kotlinx-serialization` `@Serializable` annotations and
+ * `@SerialName` rewrites for renamed JSON keys; `Map<String, V>` for
+ * additionalProperties; `enum class(val raw: String)` for string
+ * enums and `typealias = Int` for integer enums (kotlinx's enum
+ * support only round-trips strings).
+ */
+export declare const ktOps: SchemaToTypeOps<KtType, KtDecl>;
+//# sourceMappingURL=type-ops.d.ts.map

package/dist/sdk/kotlin/ir/type-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-ops.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/ir/type-ops.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,KAAK,MAAM,EAgBZ,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAwEjD,CAAC"}

package/dist/sdk/kotlin/ir/type-ops.js

@@ -0,0 +1,76 @@
+import { synthName } from "../../../codegen/index.js";
+import { uniqueEnumEntries, } from "../../../openapi/index.js";
+import { ktAnnotation, ktDataClass, ktEnum, ktEnumEntry, ktInt, ktJsonElement, ktList, ktMap, ktNullable, ktProp, ktRef, ktStr, ktString, ktTypeAlias, ktUnit, } from "../ast/index.js";
+import { enumEntryIdent } from "./identifiers.js";
+import { typeForPrimitive } from "./type/primitive.js";
+import { propertyName } from "./type/property-naming.js";
+/**
+ * Kotlin's plug into the shared `schemaToType` dispatcher. Per-target
+ * choices: `kotlinx-serialization` `@Serializable` annotations and
+ * `@SerialName` rewrites for renamed JSON keys; `Map<String, V>` for
+ * additionalProperties; `enum class(val raw: String)` for string
+ * enums and `typealias = Int` for integer enums (kotlinx's enum
+ * support only round-trips strings).
+ */
+export const ktOps = {
+    refType: ktRef,
+    arrayType: ktList,
+    mapType: (value) => ktMap(ktString, value),
+    voidType: () => ktUnit,
+    anyType: () => ktJsonElement,
+    // `null`-typed primitive → `Any?`.
+    nullableAnyType: () => ktNullable(ktJsonElement),
+    // Single non-null + nullable → wrap in nullable iff not already.
+    wrapForUnionSingle: (inner, nullable) => nullable ? ktNullable(inner) : inner,
+    unionFallback: (nullable) => nullable ? ktNullable(ktJsonElement) : ktJsonElement,
+    primitiveType: typeForPrimitive,
+    // kotlinx convention: `Owner_Property` (underscore joiner).
+    synthName,
+    buildStructDecl: (name, properties, ctx, dispatch) => {
+        const props = properties.map(({ jsonKey, schema: propSchema, required, propPathSegment }) => {
+            const naming = propertyName(jsonKey);
+            const t = dispatch(propSchema, {
+                emit: ctx.emit,
+                names: ctx.names,
+                ownerName: name,
+                propPath: [propPathSegment],
+            });
+            const optional = !required;
+            const finalType = optional ? ktNullable(t) : t;
+            return ktProp({
+                name: naming.kotlinName,
+                type: finalType,
+                default: optional ? "null" : undefined,
+                annotations: naming.renamed
+                    ? [ktAnnotation("SerialName", ktStr(naming.jsonKey))]
+                    : [],
+            });
+        });
+        return ktDataClass({
+            name,
+            annotations: [ktAnnotation("Serializable")],
+            properties: props,
+        });
+    },
+    emitStringEnum: (name, rawValues, emit) => {
+        const idents = uniqueEnumEntries(rawValues, enumEntryIdent, (b, n) => `${b}_${n}`);
+        const entries = idents.map(({ identifier, raw }) => ktEnumEntry(identifier, ktStr(raw), [
+            ktAnnotation("SerialName", ktStr(raw)),
+        ]));
+        emit(ktEnum({
+            name,
+            annotations: [ktAnnotation("Serializable")],
+            properties: [ktProp({ name: "raw", type: ktString })],
+            entries,
+        }));
+        return ktRef(name);
+    },
+    // kotlinx-serialization can't round-trip integer enums via
+    // `@SerialName`; degrade to a typealias that preserves the wire
+    // shape but loses enum-value constraint at the type level.
+    emitIntegerEnum: (name, _rawValues, emit) => {
+        emit(ktTypeAlias({ name, type: ktInt }));
+        return ktRef(name);
+    },
+};
+//# sourceMappingURL=type-ops.js.map

package/dist/sdk/kotlin/ir/type-ops.js.map

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

package/dist/sdk/kotlin/kt-compiler/index.d.ts

@@ -0,0 +1,4 @@
+import type { KtDecl, KtFile } from "../ast/index.js";
+export declare function printFile(file: KtFile): string;
+export declare const printDecl: (d: KtDecl) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/kotlin/kt-compiler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/kt-compiler/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAMtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MACF,CAAC"}

package/dist/sdk/kotlin/kt-compiler/index.js

@@ -0,0 +1,9 @@
+import { kt } from "../../../compilers/kotlin/index.js";
+const f = kt.factory;
+const printer = kt.createPrinter({ indentSize: 4 });
+const trimEnd = (s) => s.replace(/\n+$/, "");
+export function printFile(file) {
+    return printer.printFile(f.createSourceFile(file.decls.map((d) => d.node), file.pkg ? f.createPackageHeader(file.pkg) : undefined, file.imports.map((i) => f.createImportDirective(i))));
+}
+export const printDecl = (d) => trimEnd(printer.printFile(d.node));
+//# sourceMappingURL=index.js.map

package/dist/sdk/kotlin/kt-compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/kt-compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,oCAAoC,CAAC;AAIxD,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;AACrB,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;AACpD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAErD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,SAAS,CACtB,CAAC,CAAC,gBAAgB,CAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CACpD,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAC7C,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/sdk/kotlin/project/build.d.ts

@@ -0,0 +1,33 @@
+import { type KtDecl } from "../ast/index.js";
+import { type PlacementOptions } from "./layout.js";
+export interface BuildOptions extends PlacementOptions {
+    /**
+     * Kotlin package every generated file lives in (e.g. `"com.example.petstore"`).
+     * Default: `"com.example.api"`. Pass an explicit value to match the
+     * consumer's app structure.
+     */
+    packageName?: string;
+}
+export interface BuiltFile {
+    /** Output path relative to the SDK root, using POSIX separators. */
+    path: string;
+    content: string;
+}
+/**
+ * Project assembler: places each decl in a file, picks imports, prints
+ * one Kotlin source per group. Decls that share an output path
+ * (currently the per-receiver extension-fun bundle) collapse into one
+ * file; everything else lives in its own.
+ *
+ * The package directory layout (`com/example/petstore/...`) is built
+ * into `path` so the result drops directly into a `src/main/kotlin/`
+ * tree.
+ */
+export declare function buildKotlinProject(decls: ReadonlyArray<KtDecl>, opts?: BuildOptions): BuiltFile[];
+/**
+ * Wrap a runtime-helper file (raw kotlin source) in a `BuiltFile`. The
+ * runtime templates already carry their own `package` directive, so we
+ * just route them through the layout.
+ */
+export declare function runtimeFileToBuilt(pkg: string, pkgDir: string, fileName: string, content: string): BuiltFile;
+//# sourceMappingURL=build.d.ts.map

package/dist/sdk/kotlin/project/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAU,MAAM,iBAAiB,CAAC;AAItD,OAAO,EAAgB,KAAK,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,IAAI,GAAE,YAAiB,GACtB,SAAS,EAAE,CAgCb;AAcD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,SAAS,CAMX"}

package/dist/sdk/kotlin/project/build.js

@@ -0,0 +1,71 @@
+import { ktFile } from "../ast/index.js";
+import { DEFAULT_PACKAGE } from "../ir/constants.js";
+import { printFile } from "../kt-compiler/index.js";
+import { importsFor, isApiSurface, referencedNames } from "./imports.js";
+import { declFileName, placeDecl } from "./layout.js";
+/**
+ * Project assembler: places each decl in a file, picks imports, prints
+ * one Kotlin source per group. Decls that share an output path
+ * (currently the per-receiver extension-fun bundle) collapse into one
+ * file; everything else lives in its own.
+ *
+ * The package directory layout (`com/example/petstore/...`) is built
+ * into `path` so the result drops directly into a `src/main/kotlin/`
+ * tree.
+ */
+export function buildKotlinProject(decls, opts = {}) {
+    const pkg = opts.packageName ?? DEFAULT_PACKAGE;
+    const pkgPath = pkg.replace(/\./g, "/");
+    const groups = new Map();
+    for (const decl of decls) {
+        const { dir } = placeDecl(decl, opts);
+        const fileName = declFileName(decl);
+        const subPath = dir === "." ? fileName : `${dir}/${fileName}`;
+        const path = `${pkgPath}/${subPath}`;
+        const subPkg = declPackage(pkg, dir);
+        const existing = groups.get(path);
+        if (existing)
+            existing.decls.push(decl);
+        else
+            groups.set(path, { decls: [decl], subPkg });
+    }
+    const declared = new Map(decls.map((d) => [d.name, declPackage(pkg, placeDecl(d, opts).dir)]));
+    return [...groups.entries()].map(([path, group]) => {
+        const apiSurface = group.decls.some(isApiSurface);
+        const imports = importsFor(referencedNames(group.decls), {
+            isApiSurface: apiSurface,
+            declared,
+            rootPkg: pkg,
+            subPkg: group.subPkg,
+        });
+        return {
+            path,
+            content: printFile(ktFile({ pkg: group.subPkg, imports, decls: group.decls })),
+        };
+    });
+}
+/**
+ * Sub-package suffix for a decl based on its placement dir. Mirrors
+ * the kotlin convention where filesystem directories under
+ * `src/main/kotlin/` map to package suffixes — e.g. files placed in
+ * `api/` belong to `<root>.api`.
+ */
+function declPackage(rootPkg, dir) {
+    if (dir === "." || dir === "")
+        return rootPkg;
+    const suffix = dir.replace(/\//g, ".");
+    return `${rootPkg}.${suffix}`;
+}
+/**
+ * Wrap a runtime-helper file (raw kotlin source) in a `BuiltFile`. The
+ * runtime templates already carry their own `package` directive, so we
+ * just route them through the layout.
+ */
+export function runtimeFileToBuilt(pkg, pkgDir, fileName, content) {
+    const pkgPath = pkg.replace(/\./g, "/");
+    return {
+        path: `${pkgPath}/${pkgDir}/${fileName}`,
+        content,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/sdk/kotlin/project/build.js.map

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

package/dist/sdk/kotlin/project/gradle.d.ts

@@ -0,0 +1,48 @@
+import type { BuiltFile } from "./build.js";
+/**
+ * `build.gradle.kts` emission for the standalone-library mode.
+ *
+ * Two consumption modes for the generated SDK:
+ *
+ *  1. **Drop into an existing Gradle module.** Paste the package
+ *     directory (e.g. `com/example/petstore/`) into your module's
+ *     `src/main/kotlin/` tree. Make sure the surrounding module already
+ *     applies `kotlin("plugin.serialization")` and depends on OkHttp +
+ *     kotlinx-serialization-json. This is the default; nothing extra
+ *     is emitted.
+ *
+ *  2. **Standalone Gradle module.** Pass `gradle: true` (or an options
+ *     object) to `generate()` and a `build.gradle.kts` is emitted at
+ *     the output root with the right plugins + dependencies.
+ *
+ * Mode 2 is the right choice when the SDK is shared across multiple
+ * apps, lives in its own repo, or you want a clean module boundary
+ * inside a monorepo.
+ */
+export interface GradleOptions {
+    /** Module group (Gradle's `group =`). Required for publishing; safe
+     *  to omit otherwise. */
+    group?: string;
+    /** Module version. Default: `"0.1.0"`. */
+    version?: string;
+    /** Kotlin Gradle plugin version. Default: `"2.0.21"`. */
+    kotlinVersion?: string;
+    /** kotlinx-serialization version. Default: `"1.7.3"`. */
+    kotlinxSerializationVersion?: string;
+    /** OkHttp version. Default: `"4.12.0"`. */
+    okhttpVersion?: string;
+    /** kotlinx-coroutines version. Default: `"1.9.0"`. */
+    kotlinxCoroutinesVersion?: string;
+    /** kotlinx-datetime version (used by `Instant` / `LocalDate` model fields).
+     *  Default: `"0.6.1"`. */
+    kotlinxDatetimeVersion?: string;
+    /** JVM target. Default: `"17"`. */
+    jvmTarget?: string;
+}
+export declare function buildGradleFile(opts?: GradleOptions): BuiltFile;
+/**
+ * Minimal `settings.gradle.kts` so the directory works as a standalone
+ * Gradle build (`gradle build`).
+ */
+export declare function settingsGradleFile(name: string): BuiltFile;
+//# sourceMappingURL=gradle.d.ts.map

package/dist/sdk/kotlin/project/gradle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/gradle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B;6BACyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;8BAC0B;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,aAAkB,GAAG,SAAS,CAkCnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAK1D"}

package/dist/sdk/kotlin/project/gradle.js

@@ -0,0 +1,46 @@
+export function buildGradleFile(opts = {}) {
+    const kotlin = opts.kotlinVersion ?? "2.0.21";
+    const serialization = opts.kotlinxSerializationVersion ?? "1.7.3";
+    const okhttp = opts.okhttpVersion ?? "4.12.0";
+    const coroutines = opts.kotlinxCoroutinesVersion ?? "1.9.0";
+    const datetime = opts.kotlinxDatetimeVersion ?? "0.6.1";
+    const jvmTarget = opts.jvmTarget ?? "17";
+    const version = opts.version ?? "0.1.0";
+    const groupLine = opts.group ? `group = "${opts.group}"\n` : "";
+    return {
+        path: "build.gradle.kts",
+        content: `plugins {
+    kotlin("jvm") version "${kotlin}"
+    kotlin("plugin.serialization") version "${kotlin}"
+}
+
+${groupLine}version = "${version}"
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:${serialization}")
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:${coroutines}")
+    implementation("org.jetbrains.kotlinx:kotlinx-datetime:${datetime}")
+    implementation("com.squareup.okhttp3:okhttp:${okhttp}")
+}
+
+kotlin {
+    jvmToolchain(${jvmTarget})
+}
+`,
+    };
+}
+/**
+ * Minimal `settings.gradle.kts` so the directory works as a standalone
+ * Gradle build (`gradle build`).
+ */
+export function settingsGradleFile(name) {
+    return {
+        path: "settings.gradle.kts",
+        content: `rootProject.name = "${name}"\n`,
+    };
+}
+//# sourceMappingURL=gradle.js.map

package/dist/sdk/kotlin/project/gradle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/gradle.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,eAAe,CAAC,IAAI,GAAkB,EAAE;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,2BAA2B,IAAI,OAAO,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,IAAI,OAAO,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,IAAI,OAAO,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE;6BACgB,MAAM;8CACW,MAAM;;;EAGlD,SAAS,cAAc,OAAO;;;;;;;uEAOuC,aAAa;oEAChB,UAAU;6DACjB,QAAQ;kDACnB,MAAM;;;;mBAIrC,SAAS;;CAE3B;KACE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,uBAAuB,IAAI,KAAK;KAC1C,CAAC;AACJ,CAAC"}

package/dist/sdk/kotlin/project/imports.d.ts

@@ -0,0 +1,21 @@
+import type { KtDecl } from "../ast/index.js";
+/**
+ * Every identifier, type and annotation name the declarations reference,
+ * collected from the AST (string literals and comments never count).
+ */
+export declare function referencedNames(decls: ReadonlyArray<KtDecl>): ReadonlySet<string>;
+/**
+ * Import list for one Kotlin file. Names shared across packages (e.g.
+ * `Response` in `okhttp3` vs. a user model) are disambiguated by file
+ * kind: API-layer files pull `okhttp3.Response`, model files never do.
+ */
+export declare function importsFor(names: ReadonlySet<string>, ctx: {
+    isApiSurface: boolean;
+    /** Package of every generated declaration, by name. */
+    declared: ReadonlyMap<string, string>;
+    rootPkg: string;
+    subPkg: string;
+}): ReadonlyArray<string>;
+/** API-surface predicate, exposed for the build orchestrator. */
+export declare function isApiSurface(decl: KtDecl): boolean;
+//# sourceMappingURL=imports.d.ts.map

package/dist/sdk/kotlin/project/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/imports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,WAAW,CAAC,MAAM,CAAC,CAqBrB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,GAAG,EAAE;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,aAAa,CAAC,MAAM,CAAC,CAmCvB;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWlD"}

package/dist/sdk/kotlin/project/imports.js

@@ -0,0 +1,84 @@
+import { kt } from "../../../compilers/kotlin/index.js";
+const K = kt.KotlinNodeKind;
+const NAME_TOKEN = /[A-Za-z_][A-Za-z0-9_]*/g;
+/**
+ * Every identifier, type and annotation name the declarations reference,
+ * collected from the AST (string literals and comments never count).
+ */
+export function referencedNames(decls) {
+    const names = new Set();
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item);
+            return;
+        }
+        if (!value || typeof value !== "object")
+            return;
+        const node = value;
+        if ((node.kind === K.Identifier ||
+            node.kind === K.UserType ||
+            node.kind === K.Annotation) &&
+            typeof node.name === "string") {
+            for (const m of node.name.matchAll(NAME_TOKEN))
+                names.add(m[0]);
+        }
+        for (const child of Object.values(value))
+            visit(child);
+    };
+    for (const decl of decls)
+        visit(decl.node);
+    return names;
+}
+/**
+ * Import list for one Kotlin file. Names shared across packages (e.g.
+ * `Response` in `okhttp3` vs. a user model) are disambiguated by file
+ * kind: API-layer files pull `okhttp3.Response`, model files never do.
+ */
+export function importsFor(names, ctx) {
+    const set = new Set();
+    const when = (name, imp) => {
+        if (names.has(name))
+            set.add(imp);
+    };
+    when("Serializable", "kotlinx.serialization.Serializable");
+    when("SerialName", "kotlinx.serialization.SerialName");
+    when("Instant", "kotlinx.datetime.Instant");
+    when("LocalDate", "kotlinx.datetime.LocalDate");
+    when("ListSerializer", "kotlinx.serialization.builtins.ListSerializer");
+    when("MapSerializer", "kotlinx.serialization.builtins.MapSerializer");
+    when("ByteArraySerializer", "kotlinx.serialization.builtins.ByteArraySerializer");
+    when("nullable", "kotlinx.serialization.builtins.nullable");
+    when("JsonElement", "kotlinx.serialization.json.JsonElement");
+    if (ctx.isApiSurface) {
+        // `String.serializer()` etc.; model files use generated companions.
+        when("serializer", "kotlinx.serialization.builtins.serializer");
+        when("HttpUrl", "okhttp3.HttpUrl");
+        when("Request", "okhttp3.Request");
+        when("Response", "okhttp3.Response");
+        when("FormBody", "okhttp3.FormBody");
+        when("toMediaType", "okhttp3.MediaType.Companion.toMediaType");
+        when("toRequestBody", "okhttp3.RequestBody.Companion.toRequestBody");
+    }
+    for (const name of names) {
+        const pkg = ctx.declared.get(name);
+        if (pkg && pkg !== ctx.subPkg)
+            set.add(`${pkg}.${name}`);
+    }
+    return [...set].filter((i) => !i.startsWith(`${ctx.subPkg}.`)).sort();
+}
+/** API-surface predicate, exposed for the build orchestrator. */
+export function isApiSurface(decl) {
+    if (decl.kind === "interface")
+        return true;
+    if (decl.kind === "class")
+        return true;
+    if (decl.kind === "topLevelFun")
+        return true;
+    return Boolean((decl.kind === "enum" ||
+        decl.kind === "sealedClass" ||
+        decl.kind === "dataClass" ||
+        decl.kind === "object") &&
+        decl.runtime);
+}
+//# sourceMappingURL=imports.js.map

package/dist/sdk/kotlin/project/imports.js.map

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

package/dist/sdk/kotlin/project/index.d.ts

@@ -0,0 +1,6 @@
+export type { BuildOptions, BuiltFile } from "./build.js";
+export { buildKotlinProject, runtimeFileToBuilt } from "./build.js";
+export type { GradleOptions } from "./gradle.js";
+export { buildGradleFile, settingsGradleFile } from "./gradle.js";
+export type { LayoutKind, PlacementOptions } from "./layout.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/kotlin/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/sdk/kotlin/project/index.js

@@ -0,0 +1,3 @@
+export { buildKotlinProject, runtimeFileToBuilt } from "./build.js";
+export { buildGradleFile, settingsGradleFile } from "./gradle.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/kotlin/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/sdk/kotlin/project/layout.d.ts

@@ -0,0 +1,30 @@
+import type { KtDecl } from "../ast/index.js";
+export type LayoutKind = "flat" | "split";
+export interface PlacedDecl {
+    decl: KtDecl;
+    /** Output dir relative to the SDK root, using `/` separators. */
+    dir: string;
+}
+export interface PlacementOptions {
+    /**
+     * `split` (default) → API-layer decls (interfaces, impl classes,
+     * top-level extension funs) live in `api/` and value types in
+     * `models/`. `flat` → everything in the SDK root (single package).
+     */
+    layout?: LayoutKind;
+    /** Per-decl override; `undefined` falls back to layout default. */
+    fileLocation?: (decl: KtDecl) => {
+        dir: string;
+    } | undefined;
+}
+export declare function placeDecl(decl: KtDecl, opts: PlacementOptions): PlacedDecl;
+/**
+ * Pick the file name a decl renders into.
+ *
+ * Top-level extension funs don't have their own decl name — they're
+ * named for the function plus receiver. Convention: render them into
+ * `<ReceiverName>Extensions.kt`; when several share a receiver they
+ * collapse into the same file at orchestration time.
+ */
+export declare function declFileName(decl: KtDecl): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/sdk/kotlin/project/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/layout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,mEAAmE;IACnE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAM1E;AAkBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/sdk/kotlin/project/layout.js

@@ -0,0 +1,41 @@
+import { safeRelativeDir } from "../../../codegen/index.js";
+export function placeDecl(decl, opts) {
+    const override = opts.fileLocation?.(decl);
+    if (override)
+        return { decl, dir: safeRelativeDir(override.dir) };
+    const layout = opts.layout ?? "split";
+    if (layout === "flat")
+        return { decl, dir: "." };
+    return { decl, dir: isApiDecl(decl) ? "api" : "models" };
+}
+function isApiDecl(decl) {
+    if (decl.kind === "interface")
+        return true;
+    if (decl.kind === "class")
+        return true;
+    if (decl.kind === "topLevelFun")
+        return true;
+    if ((decl.kind === "enum" ||
+        decl.kind === "object" ||
+        decl.kind === "sealedClass" ||
+        decl.kind === "dataClass") &&
+        decl.runtime) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Pick the file name a decl renders into.
+ *
+ * Top-level extension funs don't have their own decl name — they're
+ * named for the function plus receiver. Convention: render them into
+ * `<ReceiverName>Extensions.kt`; when several share a receiver they
+ * collapse into the same file at orchestration time.
+ */
+export function declFileName(decl) {
+    if (decl.kind === "topLevelFun") {
+        return `${decl.receiver ?? "Extensions"}Extensions.kt`;
+    }
+    return `${decl.name}.kt`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/sdk/kotlin/project/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../src/sdk/kotlin/project/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAuB5D,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAsB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC7C,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;QACnB,IAAI,CAAC,IAAI,KAAK,QAAQ;QACtB,IAAI,CAAC,IAAI,KAAK,aAAa;QAC3B,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;QAC5B,IAAI,CAAC,OAAO,EACZ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,YAAY,eAAe,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;AAC3B,CAAC"}