@ir-kit/openapi-kotlin 0.1.0

package/dist/kt-dsl/stmt/binding.js

@@ -0,0 +1,70 @@
+/**
+ * Immutable binding (`val`).
+ *
+ * @example
+ * ```kotlin
+ * // ktVal("status", ktIntLit(200))
+ * //   → val status = 200
+ * ```
+ */
+export const ktVal = (name, expr, type) => ({
+    kind: "val",
+    name,
+    expr,
+    type,
+});
+/**
+ * Mutable binding (`var`).
+ *
+ * @example
+ * ```kotlin
+ * // ktVar("builder", ktCall(ktIdent("Request.Builder")))
+ * //   → var builder = Request.Builder()
+ * ```
+ */
+export const ktVar = (name, expr, type) => ({
+    kind: "var",
+    name,
+    expr,
+    type,
+});
+/**
+ * Assignment to an existing l-value.
+ *
+ * @example
+ * ```kotlin
+ * // ktAssign(ktMember(ktIdent("req"), "method"), ktStr("GET"))
+ * //   → req.method = "GET"
+ * ```
+ */
+export const ktAssign = (target, value) => ({
+    kind: "assign",
+    target,
+    value,
+});
+/**
+ * Bare expression statement (the value is discarded).
+ *
+ * @example
+ * ```kotlin
+ * // ktExprStmt(ktCall(ktMember(ktIdent("req"), "build"), []))
+ * //   → req.build()
+ * ```
+ */
+export const ktExprStmt = (expr) => ({ kind: "expr", expr });
+/**
+ * Single-expression body marker — e.g. for property getters or
+ * single-expression functions. The printer renders this as `= expr`
+ * instead of a braced block when it's the only statement in a body.
+ *
+ * @example
+ * ```kotlin
+ * // ktReturnExpr(ktMember(ktIdent("foo"), "bar"))
+ * //   → = foo.bar
+ * ```
+ */
+export const ktReturnExpr = (expr) => ({
+    kind: "returnExpr",
+    expr,
+});
+//# sourceMappingURL=binding.js.map

package/dist/kt-dsl/stmt/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/binding.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa,EAAU,EAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,KAAK;IACX,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa,EAAU,EAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,KAAK;IACX,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,KAAa,EAAU,EAAE,CAAC,CAAC;IAClE,IAAI,EAAE,QAAQ;IACd,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC;IACrD,IAAI,EAAE,YAAY;IAClB,IAAI;CACL,CAAC,CAAC"}

package/dist/kt-dsl/stmt/control.d.ts

@@ -0,0 +1,80 @@
+import type { KtExpr } from "../expr/types.js";
+import type { KtType } from "../type/types.js";
+import type { KtCatchClause, KtStmt, KtWhenCase } from "./types.js";
+/**
+ * `return` (with or without an expression).
+ *
+ * @example
+ * ```kotlin
+ * // ktReturn()                   → return
+ * // ktReturn(ktIdent("data"))    → return data
+ * ```
+ */
+export declare const ktReturn: (expr?: KtExpr) => KtStmt;
+/**
+ * `throw expr`.
+ *
+ * @example
+ * ```kotlin
+ * // ktThrow(ktCall(ktIdent("ApiError.Decoding"), [ktArg(ktIdent("e"))]))
+ * //   → throw ApiError.Decoding(e)
+ * ```
+ */
+export declare const ktThrow: (expr: KtExpr) => KtStmt;
+/**
+ * `if (cond) { then } [else { else_ }]`.
+ *
+ * @example
+ * ```kotlin
+ * // ktIf(ktEq(ktIdent("status"), ktIntLit(200)),
+ * //      [ktReturn(ktIdent("data"))])
+ * //   → if (status == 200) { return data }
+ * ```
+ */
+export declare const ktIf: (cond: KtExpr, then: ReadonlyArray<KtStmt>, else_?: ReadonlyArray<KtStmt>) => KtStmt;
+/**
+ * `when (on) { … }` — multi-arm dispatch. Pass no `on` for the
+ * boolean-arm form (`when { cond -> … }`).
+ *
+ * @example
+ * ```kotlin
+ * // ktWhen(ktIdent("location"), [
+ * //   ktWhenCase([ktIdent("Header")], [ktExprStmt(…)]),
+ * // ], [ktExprStmt(…)])
+ * //   → when (location) { Header -> { … } else -> { … } }
+ * ```
+ */
+export declare const ktWhen: (on: KtExpr | undefined, cases: ReadonlyArray<KtWhenCase>, default_?: ReadonlyArray<KtStmt>) => KtStmt;
+/**
+ * One arm of a `when` — a list of patterns paired with a body. The
+ * printer joins multiple patterns with `, ` and wraps the body in `{ }`
+ * unless it's a single statement.
+ */
+export declare const ktWhenCase: (patterns: ReadonlyArray<KtExpr>, body: ReadonlyArray<KtStmt>) => KtWhenCase;
+/**
+ * `for (name in source) { body }`.
+ *
+ * @example
+ * ```kotlin
+ * // ktForIn("interceptor", ktIdent("interceptors"), [
+ * //   ktAssign(ktIdent("req"), ktCall(ktIdent("interceptor"), [ktArg(ktIdent("req"))])),
+ * // ])
+ * //   → for (interceptor in interceptors) { req = interceptor(req) }
+ * ```
+ */
+export declare const ktForIn: (name: string, source: KtExpr, body: ReadonlyArray<KtStmt>) => KtStmt;
+/**
+ * `try { body } catch (e: T) { … }`.
+ *
+ * @example
+ * ```kotlin
+ * // ktTryCatch([ktReturn(…)], [ktCatch("e", ktRef("Throwable"), [ktThrow(…)])])
+ * //   → try { … } catch (e: Throwable) { … }
+ * ```
+ */
+export declare const ktTryCatch: (body: ReadonlyArray<KtStmt>, catches: ReadonlyArray<KtCatchClause>) => KtStmt;
+/**
+ * One `catch` clause for `ktTryCatch`.
+ */
+export declare const ktCatch: (name: string, type: KtType, body: ReadonlyArray<KtStmt>) => KtCatchClause;
+//# sourceMappingURL=control.d.ts.map

package/dist/kt-dsl/stmt/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,MAAoC,CAAC;AAE9E;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AAE3E;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,MAAM,EACZ,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,QAAQ,aAAa,CAAC,MAAM,CAAC,KAC5B,MAA6C,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM,GACjB,IAAI,MAAM,GAAG,SAAS,EACtB,OAAO,aAAa,CAAC,UAAU,CAAC,EAChC,WAAW,aAAa,CAAC,MAAM,CAAC,KAC/B,MAAiD,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,aAAa,CAAC,MAAM,CAAC,EAC/B,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,UAAkC,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,QAAQ,MAAM,EACd,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAiD,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,SAAS,aAAa,CAAC,aAAa,CAAC,KACpC,MAA+C,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,aAAuC,CAAC"}

package/dist/kt-dsl/stmt/control.js

@@ -0,0 +1,77 @@
+/**
+ * `return` (with or without an expression).
+ *
+ * @example
+ * ```kotlin
+ * // ktReturn()                   → return
+ * // ktReturn(ktIdent("data"))    → return data
+ * ```
+ */
+export const ktReturn = (expr) => ({ kind: "return", expr });
+/**
+ * `throw expr`.
+ *
+ * @example
+ * ```kotlin
+ * // ktThrow(ktCall(ktIdent("ApiError.Decoding"), [ktArg(ktIdent("e"))]))
+ * //   → throw ApiError.Decoding(e)
+ * ```
+ */
+export const ktThrow = (expr) => ({ kind: "throw", expr });
+/**
+ * `if (cond) { then } [else { else_ }]`.
+ *
+ * @example
+ * ```kotlin
+ * // ktIf(ktEq(ktIdent("status"), ktIntLit(200)),
+ * //      [ktReturn(ktIdent("data"))])
+ * //   → if (status == 200) { return data }
+ * ```
+ */
+export const ktIf = (cond, then, else_) => ({ kind: "if", cond, then, else_ });
+/**
+ * `when (on) { … }` — multi-arm dispatch. Pass no `on` for the
+ * boolean-arm form (`when { cond -> … }`).
+ *
+ * @example
+ * ```kotlin
+ * // ktWhen(ktIdent("location"), [
+ * //   ktWhenCase([ktIdent("Header")], [ktExprStmt(…)]),
+ * // ], [ktExprStmt(…)])
+ * //   → when (location) { Header -> { … } else -> { … } }
+ * ```
+ */
+export const ktWhen = (on, cases, default_) => ({ kind: "when", on, cases, default_ });
+/**
+ * One arm of a `when` — a list of patterns paired with a body. The
+ * printer joins multiple patterns with `, ` and wraps the body in `{ }`
+ * unless it's a single statement.
+ */
+export const ktWhenCase = (patterns, body) => ({ patterns, body });
+/**
+ * `for (name in source) { body }`.
+ *
+ * @example
+ * ```kotlin
+ * // ktForIn("interceptor", ktIdent("interceptors"), [
+ * //   ktAssign(ktIdent("req"), ktCall(ktIdent("interceptor"), [ktArg(ktIdent("req"))])),
+ * // ])
+ * //   → for (interceptor in interceptors) { req = interceptor(req) }
+ * ```
+ */
+export const ktForIn = (name, source, body) => ({ kind: "forIn", name, source, body });
+/**
+ * `try { body } catch (e: T) { … }`.
+ *
+ * @example
+ * ```kotlin
+ * // ktTryCatch([ktReturn(…)], [ktCatch("e", ktRef("Throwable"), [ktThrow(…)])])
+ * //   → try { … } catch (e: Throwable) { … }
+ * ```
+ */
+export const ktTryCatch = (body, catches) => ({ kind: "tryCatch", body, catches });
+/**
+ * One `catch` clause for `ktTryCatch`.
+ */
+export const ktCatch = (name, type, body) => ({ name, type, body });
+//# sourceMappingURL=control.js.map

package/dist/kt-dsl/stmt/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/control.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,IAAY,EACZ,IAA2B,EAC3B,KAA6B,EACrB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,EAAsB,EACtB,KAAgC,EAChC,QAAgC,EACxB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAA+B,EAC/B,IAA2B,EACf,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EACZ,MAAc,EACd,IAA2B,EACnB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAA2B,EAC3B,OAAqC,EAC7B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAY,EACZ,IAAY,EACZ,IAA2B,EACZ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC"}

package/dist/kt-dsl/stmt/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./binding.js";
+export * from "./control.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/kt-dsl/stmt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/kt-dsl/stmt/index.js

@@ -0,0 +1,4 @@
+export * from "./binding.js";
+export * from "./control.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/kt-dsl/stmt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/kt-dsl/stmt/types.d.ts

@@ -0,0 +1,62 @@
+import type { KtExpr } from "../expr/types.js";
+import type { KtType } from "../type/types.js";
+export type KtStmt = KtBindingStmt | KtControlStmt | {
+    kind: "assign";
+    target: KtExpr;
+    value: KtExpr;
+} | {
+    kind: "expr";
+    expr: KtExpr;
+} | {
+    kind: "returnExpr";
+    expr: KtExpr;
+} | {
+    kind: "tryCatch";
+    body: ReadonlyArray<KtStmt>;
+    catches: ReadonlyArray<KtCatchClause>;
+};
+export interface KtCatchClause {
+    /** The exception variable name; defaults to `e`. */
+    name: string;
+    /** Exception type (e.g. `Throwable`, `IOException`). */
+    type: KtType;
+    body: ReadonlyArray<KtStmt>;
+}
+export type KtBindingStmt = {
+    kind: "val";
+    name: string;
+    expr: KtExpr;
+    type?: KtType;
+} | {
+    kind: "var";
+    name: string;
+    expr: KtExpr;
+    type?: KtType;
+};
+export type KtControlStmt = {
+    kind: "return";
+    expr?: KtExpr;
+} | {
+    kind: "throw";
+    expr: KtExpr;
+} | {
+    kind: "if";
+    cond: KtExpr;
+    then: ReadonlyArray<KtStmt>;
+    else_?: ReadonlyArray<KtStmt>;
+} | {
+    kind: "when";
+    on?: KtExpr;
+    cases: ReadonlyArray<KtWhenCase>;
+    default_?: ReadonlyArray<KtStmt>;
+} | {
+    kind: "forIn";
+    name: string;
+    source: KtExpr;
+    body: ReadonlyArray<KtStmt>;
+};
+export interface KtWhenCase {
+    patterns: ReadonlyArray<KtExpr>;
+    body: ReadonlyArray<KtStmt>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kt-dsl/stmt/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,MAAM,MAAM,GACd,aAAa,GACb,aAAa,GACb;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACvC,CAAC;AAEN,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IACE,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC7B"}

package/dist/kt-dsl/stmt/types.js

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

package/dist/kt-dsl/stmt/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kt-dsl/stmt/types.ts"],"names":[],"mappings":""}

package/dist/kt-dsl/type/builders.d.ts

@@ -0,0 +1,75 @@
+import type { KtType } from "./types.js";
+/**
+ * Common Kotlin primitive shortcuts. Each renders to its bare type
+ * name in source.
+ *
+ * @example
+ * ```kotlin
+ * // ktString → String
+ * // ktLong   → Long
+ * // ktUnit   → Unit
+ * ```
+ */
+export declare const ktString: KtType;
+export declare const ktInt: KtType;
+export declare const ktLong: KtType;
+export declare const ktShort: KtType;
+export declare const ktByte: KtType;
+export declare const ktDouble: KtType;
+export declare const ktFloat: KtType;
+export declare const ktBoolean: KtType;
+export declare const ktUnit: KtType;
+export declare const ktAny: KtType;
+export declare const ktNothing: KtType;
+export declare const ktByteArray: KtType;
+/**
+ * Nullable wrapper — renders as `Inner?`. Idempotent: wrapping an
+ * already-nullable type is a no-op so callers don't have to track
+ * nullability state.
+ *
+ * @example
+ * ```kotlin
+ * // ktNullable(ktString) → String?
+ * ```
+ */
+export declare const ktNullable: (inner: KtType) => KtType;
+/**
+ * `List<Element>`.
+ *
+ * @example
+ * ```kotlin
+ * // ktList(ktString) → List<String>
+ * ```
+ */
+export declare const ktList: (element: KtType) => KtType;
+/**
+ * `Map<Key, Value>`.
+ *
+ * @example
+ * ```kotlin
+ * // ktMap(ktString, ktInt) → Map<String, Int>
+ * ```
+ */
+export declare const ktMap: (key: KtType, value: KtType) => KtType;
+/**
+ * Named type reference, optionally parameterized.
+ *
+ * @example
+ * ```kotlin
+ * // ktRef("Request")              → Request
+ * // ktRef("Pair", [ktString, ktInt]) → Pair<String, Int>
+ * ```
+ */
+export declare const ktRef: (name: string, args?: ReadonlyArray<KtType>) => KtType;
+/**
+ * Function type — renders as `(Params...) -> Return` or
+ * `suspend (Params...) -> Return`.
+ *
+ * @example
+ * ```kotlin
+ * // ktFunc([ktRef("Request")], ktRef("Request"), true)
+ * //   → suspend (Request) -> Request
+ * ```
+ */
+export declare const ktFunc: (params: ReadonlyArray<KtType>, returnType: KtType, suspend?: boolean) => KtType;
+//# sourceMappingURL=builders.d.ts.map

package/dist/kt-dsl/type/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/type/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,YAAY,CAAC;AAItD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,QAAiB,CAAC;AACvC,eAAO,MAAM,KAAK,QAAc,CAAC;AACjC,eAAO,MAAM,MAAM,QAAe,CAAC;AACnC,eAAO,MAAM,OAAO,QAAgB,CAAC;AACrC,eAAO,MAAM,MAAM,QAAe,CAAC;AACnC,eAAO,MAAM,QAAQ,QAAiB,CAAC;AACvC,eAAO,MAAM,OAAO,QAAgB,CAAC;AACrC,eAAO,MAAM,SAAS,QAAkB,CAAC;AACzC,eAAO,MAAM,MAAM,QAAe,CAAC;AACnC,eAAO,MAAM,KAAK,QAAc,CAAC;AACjC,eAAO,MAAM,SAAS,QAAkB,CAAC;AACzC,eAAO,MAAM,WAAW,QAAoB,CAAC;AAE7C;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MACsB,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,MAAM,KAAG,MAAqC,CAAC;AAE/E;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,MAIjD,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,EAAE,OAAO,aAAa,CAAC,MAAM,CAAC,KAAG,MAIjE,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GACjB,QAAQ,aAAa,CAAC,MAAM,CAAC,EAC7B,YAAY,MAAM,EAClB,iBAAe,KACd,MAAyD,CAAC"}

package/dist/kt-dsl/type/builders.js

@@ -0,0 +1,83 @@
+const prim = (name) => ({ kind: "primitive", name });
+/**
+ * Common Kotlin primitive shortcuts. Each renders to its bare type
+ * name in source.
+ *
+ * @example
+ * ```kotlin
+ * // ktString → String
+ * // ktLong   → Long
+ * // ktUnit   → Unit
+ * ```
+ */
+export const ktString = prim("String");
+export const ktInt = prim("Int");
+export const ktLong = prim("Long");
+export const ktShort = prim("Short");
+export const ktByte = prim("Byte");
+export const ktDouble = prim("Double");
+export const ktFloat = prim("Float");
+export const ktBoolean = prim("Boolean");
+export const ktUnit = prim("Unit");
+export const ktAny = prim("Any");
+export const ktNothing = prim("Nothing");
+export const ktByteArray = prim("ByteArray");
+/**
+ * Nullable wrapper — renders as `Inner?`. Idempotent: wrapping an
+ * already-nullable type is a no-op so callers don't have to track
+ * nullability state.
+ *
+ * @example
+ * ```kotlin
+ * // ktNullable(ktString) → String?
+ * ```
+ */
+export const ktNullable = (inner) => inner.kind === "nullable" ? inner : { kind: "nullable", inner };
+/**
+ * `List<Element>`.
+ *
+ * @example
+ * ```kotlin
+ * // ktList(ktString) → List<String>
+ * ```
+ */
+export const ktList = (element) => ({ kind: "list", element });
+/**
+ * `Map<Key, Value>`.
+ *
+ * @example
+ * ```kotlin
+ * // ktMap(ktString, ktInt) → Map<String, Int>
+ * ```
+ */
+export const ktMap = (key, value) => ({
+    kind: "map",
+    key,
+    value,
+});
+/**
+ * Named type reference, optionally parameterized.
+ *
+ * @example
+ * ```kotlin
+ * // ktRef("Request")              → Request
+ * // ktRef("Pair", [ktString, ktInt]) → Pair<String, Int>
+ * ```
+ */
+export const ktRef = (name, args) => ({
+    kind: "ref",
+    name,
+    args,
+});
+/**
+ * Function type — renders as `(Params...) -> Return` or
+ * `suspend (Params...) -> Return`.
+ *
+ * @example
+ * ```kotlin
+ * // ktFunc([ktRef("Request")], ktRef("Request"), true)
+ * //   → suspend (Request) -> Request
+ * ```
+ */
+export const ktFunc = (params, returnType, suspend = false) => ({ kind: "func", params, returnType, suspend });
+//# sourceMappingURL=builders.js.map

package/dist/kt-dsl/type/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/kt-dsl/type/builders.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG,CAAC,IAAiB,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAClD,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,KAAa,EAAU,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,KAAK;IACX,GAAG;IACH,KAAK;CACN,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAA4B,EAAU,EAAE,CAAC,CAAC;IAC5E,IAAI,EAAE,KAAK;IACX,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,MAA6B,EAC7B,UAAkB,EAClB,OAAO,GAAG,KAAK,EACP,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC"}

package/dist/kt-dsl/type/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./builders.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/kt-dsl/type/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/kt-dsl/type/index.js

@@ -0,0 +1,3 @@
+export * from "./builders.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/kt-dsl/type/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/kt-dsl/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/kt-dsl/type/types.d.ts

@@ -0,0 +1,25 @@
+export type KtPrimitive = "String" | "Int" | "Long" | "Short" | "Byte" | "Double" | "Float" | "Boolean" | "Unit" | "Any" | "Nothing" | "ByteArray";
+export type KtType = {
+    kind: "primitive";
+    name: KtPrimitive;
+} | {
+    kind: "list";
+    element: KtType;
+} | {
+    kind: "map";
+    key: KtType;
+    value: KtType;
+} | {
+    kind: "ref";
+    name: string;
+    args?: ReadonlyArray<KtType>;
+} | {
+    kind: "nullable";
+    inner: KtType;
+} | {
+    kind: "func";
+    params: ReadonlyArray<KtType>;
+    returnType: KtType;
+    suspend: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/kt-dsl/type/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kt-dsl/type/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,GACT,MAAM,GACN,KAAK,GACL,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/kt-dsl/type/types.js

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

package/dist/kt-dsl/type/types.js.map

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

package/dist/kt-dsl/visibility.d.ts

@@ -0,0 +1,2 @@
+export type KtVisibility = "public" | "internal" | "private" | "protected";
+//# sourceMappingURL=visibility.d.ts.map

package/dist/kt-dsl/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/kt-dsl/visibility.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC"}

package/dist/kt-dsl/visibility.js

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

package/dist/kt-dsl/visibility.js.map

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

package/dist/project/build.d.ts

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/project/build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAU,MAAM,oBAAoB,CAAC;AAEzD,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"}