@ir-kit/openapi-kotlin 0.1.0

package/dist/project/build.js

@@ -0,0 +1,73 @@
+import { DEFAULT_PACKAGE } from "../ir/constants.js";
+import { printDecl, printFile } from "../kt-compiler/index.js";
+import { ktFile } from "../kt-dsl/index.js";
+import { importsForSource, isApiSurface } 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 });
+    }
+    return [...groups.entries()].map(([path, group]) => {
+        // Print bodies first, scan the printed output for actually-used
+        // identifiers, then re-print with the right imports. Avoids
+        // shipping unused imports per file.
+        const bodyOnly = group.decls.map((d) => printDecl(d)).join("\n\n");
+        const apiSurface = group.decls.some(isApiSurface);
+        const imports = importsForSource(bodyOnly, {
+            isApiSurface: apiSurface,
+            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/project/build.js.map

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

package/dist/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/project/gradle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.d.ts","sourceRoot":"","sources":["../../src/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/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/project/gradle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.js","sourceRoot":"","sources":["../../src/project/gradle.ts"],"names":[],"mappings":"AA2CA,MAAM,UAAU,eAAe,CAAC,OAAsB,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/project/imports.d.ts

@@ -0,0 +1,21 @@
+import type { KtDecl } from "../kt-dsl/index.js";
+/**
+ * Compute the import list for a single Kotlin file by walking the
+ * already-printed source and matching against known identifiers.
+ * Coarse-import-everything caused unused imports per file; the
+ * print-then-scan pattern is precise without needing a full type-tree
+ * walker.
+ *
+ * Identifiers that share names across packages (e.g. `Response` exists
+ * in both `okhttp3` and a hypothetical user model) are disambiguated
+ * by file kind: API-layer files always pull `okhttp3.Response`, model
+ * files never do.
+ */
+export declare function importsForSource(source: string, ctx: {
+    isApiSurface: boolean;
+    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/project/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/project/imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D,aAAa,CAAC,MAAM,CAAC,CAmEvB;AAwED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWlD"}

package/dist/project/imports.js

@@ -0,0 +1,162 @@
+/**
+ * Compute the import list for a single Kotlin file by walking the
+ * already-printed source and matching against known identifiers.
+ * Coarse-import-everything caused unused imports per file; the
+ * print-then-scan pattern is precise without needing a full type-tree
+ * walker.
+ *
+ * Identifiers that share names across packages (e.g. `Response` exists
+ * in both `okhttp3` and a hypothetical user model) are disambiguated
+ * by file kind: API-layer files always pull `okhttp3.Response`, model
+ * files never do.
+ */
+export function importsForSource(source, ctx) {
+    const set = new Set();
+    // kotlinx-serialization annotations.
+    if (/@Serializable\b/.test(source)) {
+        set.add("kotlinx.serialization.Serializable");
+    }
+    if (/@SerialName\b/.test(source)) {
+        set.add("kotlinx.serialization.SerialName");
+    }
+    // kotlinx-datetime model fields.
+    if (/\bInstant\b/.test(source))
+        set.add("kotlinx.datetime.Instant");
+    if (/\bLocalDate\b/.test(source))
+        set.add("kotlinx.datetime.LocalDate");
+    // kotlinx-serialization builtins (only when actually mentioned).
+    if (/\bListSerializer\(/.test(source)) {
+        set.add("kotlinx.serialization.builtins.ListSerializer");
+    }
+    if (/\bMapSerializer\(/.test(source)) {
+        set.add("kotlinx.serialization.builtins.MapSerializer");
+    }
+    if (/\bByteArraySerializer\(\)/.test(source)) {
+        set.add("kotlinx.serialization.builtins.ByteArraySerializer");
+    }
+    if (/\.nullable\b/.test(source)) {
+        set.add("kotlinx.serialization.builtins.nullable");
+    }
+    if (/\bserializer\(\)/.test(source) && ctx.isApiSurface) {
+        // Built-in `String.serializer()`, `Int.serializer()`, etc. live
+        // under kotlinx.serialization.builtins. Only the API surface uses
+        // them — model files use the auto-generated companion form.
+        set.add("kotlinx.serialization.builtins.serializer");
+    }
+    if (/\bJsonElement\b/.test(source)) {
+        set.add("kotlinx.serialization.json.JsonElement");
+    }
+    // OkHttp types — only API-surface files reference them.
+    if (ctx.isApiSurface) {
+        if (/\bHttpUrl\b/.test(source))
+            set.add("okhttp3.HttpUrl");
+        if (/\bRequest\b/.test(source))
+            set.add("okhttp3.Request");
+        if (/\bResponse\b/.test(source))
+            set.add("okhttp3.Response");
+        if (/\bFormBody\b/.test(source))
+            set.add("okhttp3.FormBody");
+        if (/\.toMediaType\(\)/.test(source)) {
+            set.add("okhttp3.MediaType.Companion.toMediaType");
+        }
+        if (/\.toRequestBody\(/.test(source)) {
+            set.add("okhttp3.RequestBody.Companion.toRequestBody");
+        }
+        // Cross-package model refs. The API surface lives in `<root>.api`
+        // and references model types from `<root>.models`. Wildcard-import
+        // when the file mentions any PascalCased identifier that isn't a
+        // built-in (cheap heuristic; the alternative is walking every type
+        // ref through the decl tree).
+        if (ctx.subPkg === `${ctx.rootPkg}.api` &&
+            /\b[A-Z][A-Za-z0-9_]*\b/.test(source) &&
+            hasLikelyModelRef(source)) {
+            set.add(`${ctx.rootPkg}.models.*`);
+        }
+    }
+    // Drop self-package imports — Kotlin allows them but they're noise.
+    return [...set].filter((i) => !i.startsWith(`${ctx.subPkg}.`)).sort();
+}
+/**
+ * Identifiers that ship in `kotlin.*` / `okhttp3.*` / kotlinx — and so
+ * do NOT trigger a `<root>.models.*` import. Used to keep the wildcard
+ * model import out of files that never actually reference user types.
+ */
+const NON_MODEL_TYPES = new Set([
+    // Kotlin stdlib
+    "Any",
+    "Unit",
+    "Nothing",
+    "String",
+    "Int",
+    "Long",
+    "Short",
+    "Byte",
+    "Double",
+    "Float",
+    "Boolean",
+    "ByteArray",
+    "List",
+    "Map",
+    "Pair",
+    "Triple",
+    "Throwable",
+    "Exception",
+    "RuntimeException",
+    "Result",
+    "Charsets",
+    "Base64",
+    "TimeUnit",
+    // kotlinx
+    "Instant",
+    "LocalDate",
+    "JsonElement",
+    "Json",
+    "Dispatchers",
+    "Serializable",
+    "SerialName",
+    "ListSerializer",
+    "MapSerializer",
+    "ByteArraySerializer",
+    // OkHttp
+    "HttpUrl",
+    "Request",
+    "Response",
+    "OkHttpClient",
+    "FormBody",
+    "MultipartBody",
+    "RequestBody",
+    "MediaType",
+    // Runtime helpers (same package)
+    "APIClient",
+    "APIError",
+    "APIInterceptors",
+    "Auth",
+    "APIKeyLocation",
+    "MultipartFormBody",
+    "QueryStyle",
+    "RequestOptions",
+    "URLEncoding",
+]);
+function hasLikelyModelRef(source) {
+    const matches = source.matchAll(/\b([A-Z][A-Za-z0-9_]*)\b/g);
+    for (const m of matches) {
+        if (!NON_MODEL_TYPES.has(m[1]))
+            return true;
+    }
+    return false;
+}
+/** 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/project/imports.js.map

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

package/dist/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/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/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/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/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/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/project/layout.d.ts

@@ -0,0 +1,30 @@
+import type { KtDecl } from "../kt-dsl/decl/types.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/project/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/project/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,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;AAmCD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD"}

package/dist/project/layout.js

@@ -0,0 +1,57 @@
+import { posix as pathPosix } from "node:path";
+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" };
+}
+/**
+ * Reject absolute paths and any normalized form that escapes the SDK
+ * root via `..`. Generators write into the override dir; an unguarded
+ * `../..` could clobber files outside the output tree.
+ */
+function safeRelativeDir(dir) {
+    const normalized = pathPosix.normalize(dir || ".");
+    if (pathPosix.isAbsolute(normalized) ||
+        normalized === ".." ||
+        normalized.startsWith("../")) {
+        throw new Error(`fileLocation: invalid output directory: ${dir}`);
+    }
+    return normalized;
+}
+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") {
+        const receiver = decl.fun.receiver;
+        const recvName = receiver && receiver.kind === "ref" ? receiver.name : "Extensions";
+        return `${recvName}Extensions.kt`;
+    }
+    return `${decl.name}.kt`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/project/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/project/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAsB/C,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;;;;GAIG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;QAChC,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,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,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnC,MAAM,QAAQ,GACZ,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;QACrE,OAAO,GAAG,QAAQ,eAAe,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@ir-kit/openapi-kotlin",
+  "version": "0.1.0",
+  "description": "Generate idiomatic Kotlin (OkHttp + kotlinx-serialization + suspend) client SDKs from an OpenAPI 3.x spec.",
+  "keywords": [
+    "openapi",
+    "kotlin",
+    "android",
+    "okhttp",
+    "kotlinx-serialization",
+    "codegen",
+    "sdk",
+    "client"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/openapi/kotlin",
+  "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/openapi/kotlin"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@hey-api/shared": ">=0.3.0",
+    "@hey-api/spec-types": ">=0.2.0",
+    "@ir-kit/openapi-tools": ">=0.1.0"
+  },
+  "dependencies": {
+    "@ir-kit/codegen-core": "0.1.0",
+    "@ir-kit/openapi": "0.1.0",
+    "@ir-kit/openapi-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@hey-api/shared": "^0.4.2",
+    "@hey-api/spec-types": "^0.2.0",
+    "@types/node": "^22",
+    "vitest": "^4.0.0",
+    "@ir-kit/openapi-tools": "0.1.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"
+  }
+}