ts-procedures 6.0.1 → 6.0.2

package/build/codegen/targets/kotlin/ajsc-adapter.d.ts

@@ -0,0 +1,24 @@
+export interface KotlinEmitResult {
+    code: string;
+    rootTypeName: string;
+    extractedTypeNames: string[];
+    imports: string[];
+}
+export interface KotlinEmitOptions {
+    rootTypeName: string;
+    inlineTypes?: boolean;
+    serializer?: 'kotlinx';
+    enumStyle?: string;
+    depluralize?: boolean;
+    arrayItemNaming?: string;
+    uncountableWords?: string[];
+}
+export interface KotlinEmitter {
+    emit(schema: Record<string, unknown>, opts: KotlinEmitOptions): KotlinEmitResult;
+}
+export declare function createStubKotlinEmitter(results: Record<string, KotlinEmitResult>): KotlinEmitter;
+/**
+ * Resolves the production Kotlin emitter from `ajsc`. Throws a clear error
+ * if the ajsc package does not yet expose `emitKotlin` (Phase A pending).
+ */
+export declare function resolveProductionKotlinEmitter(): Promise<KotlinEmitter>;

package/build/codegen/targets/kotlin/ajsc-adapter.js

@@ -0,0 +1,33 @@
+export function createStubKotlinEmitter(results) {
+    return {
+        emit(_schema, opts) {
+            const result = results[opts.rootTypeName];
+            if (result == null) {
+                throw new Error(`[stub-kotlin-emitter] No stubbed result for rootTypeName "${opts.rootTypeName}". ` +
+                    `Provide one in the results map.`);
+            }
+            return result;
+        },
+    };
+}
+/**
+ * Resolves the production Kotlin emitter from `ajsc`. Throws a clear error
+ * if the ajsc package does not yet expose `emitKotlin` (Phase A pending).
+ */
+export async function resolveProductionKotlinEmitter() {
+    // TODO(ajsc-phase-a): replace dynamic import with a static import once ajsc ships emitKotlin.
+    const ajsc = await import('ajsc').catch(() => null);
+    const emitKotlin = ajsc?.emitKotlin;
+    if (typeof emitKotlin !== 'function') {
+        throw new Error('[ts-procedures-codegen] ajsc.emitKotlin is not available. ' +
+            'Kotlin codegen requires ajsc Phase A. See docs/superpowers/specs/2026-04-24-kotlin-swift-codegen-design.md.');
+    }
+    return {
+        emit(schema, opts) {
+            // ajsc's return shape is normalized to KotlinEmitResult here.
+            const r = emitKotlin(schema, opts);
+            return r;
+        },
+    };
+}
+//# sourceMappingURL=ajsc-adapter.js.map

package/build/codegen/targets/kotlin/ajsc-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajsc-adapter.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/ajsc-adapter.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,uBAAuB,CACrC,OAAyC;IAEzC,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,IAAI;YAChB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YACzC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,YAAY,KAAK;oBACjF,iCAAiC,CACpC,CAAA;YACH,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B;IAClD,8FAA8F;IAC9F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,UAAU,GAAI,IAAwC,EAAE,UAAU,CAAA;IACxE,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,4DAA4D;YAC5D,6GAA6G,CAC9G,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,IAAI;YACf,8DAA8D;YAC9D,MAAM,CAAC,GAAI,UAA2D,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YACpF,OAAO,CAAC,CAAA;QACV,CAAC;KACF,CAAA;AACH,CAAC"}

package/build/codegen/targets/kotlin/ajsc-adapter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/ajsc-adapter.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+import { createStubKotlinEmitter } from './ajsc-adapter.js';
+describe('createStubKotlinEmitter', () => {
+    it('returns the configured EmitResult for the matching root name', () => {
+        const expected = {
+            code: '@Serializable data class User(val id: String)',
+            rootTypeName: 'User',
+            extractedTypeNames: [],
+            imports: ['kotlinx.serialization.Serializable'],
+        };
+        const emitter = createStubKotlinEmitter({ User: expected });
+        expect(emitter.emit({ type: 'object' }, { rootTypeName: 'User' })).toEqual(expected);
+    });
+    it('throws when asked to emit a name not in the stub map', () => {
+        const emitter = createStubKotlinEmitter({});
+        expect(() => emitter.emit({}, { rootTypeName: 'Missing' })).toThrow(/Missing/);
+    });
+});
+//# sourceMappingURL=ajsc-adapter.test.js.map

package/build/codegen/targets/kotlin/ajsc-adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajsc-adapter.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/ajsc-adapter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAyB,MAAM,mBAAmB,CAAA;AAElF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,QAAQ,GAAqB;YACjC,IAAI,EAAE,+CAA+C;YACrD,YAAY,EAAE,MAAM;YACpB,kBAAkB,EAAE,EAAE;YACtB,OAAO,EAAE,CAAC,oCAAoC,CAAC;SAChD,CAAA;QACD,MAAM,OAAO,GAAG,uBAAuB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAA;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/kotlin/e2e-compile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/e2e-compile.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { execSync } from 'node:child_process';
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runPipeline } from '../../pipeline.js';
+import { resolveProductionKotlinEmitter } from './ajsc-adapter.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function kotlincAvailable() {
+    try {
+        execSync('kotlinc -version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe('kotlin codegen — kotlinc compile (gated)', () => {
+    it.skipIf(!kotlincAvailable() || process.env.TS_PROCEDURES_KOTLIN_E2E !== '1')('compiles generated output without errors', async () => {
+        const emitter = await resolveProductionKotlinEmitter();
+        const envelope = JSON.parse(await readFile(join(__dirname, '__fixtures__/users-envelope.json'), 'utf8'));
+        const files = await runPipeline({
+            envelope,
+            outDir: 'out',
+            dryRun: true,
+            target: 'kotlin',
+            kotlinPackage: 'com.example.api',
+            kotlinEmitter: emitter,
+        });
+        const dir = mkdtempSync(join(tmpdir(), 'tsp-kotlin-e2e-'));
+        for (const f of files) {
+            writeFileSync(join(dir, f.path.split('/').pop()), f.code);
+        }
+        // Compile against the kotlinx-serialization runtime jar present in the test env.
+        // If the jar isn't on the classpath, this fails; CI must provide it.
+        execSync(`kotlinc ${dir}/*.kt -d ${dir}/out.jar`, { stdio: 'inherit' });
+        expect(true).toBe(true); // reaching here means compile succeeded
+    });
+});
+//# sourceMappingURL=e2e-compile.test.js.map

package/build/codegen/targets/kotlin/e2e-compile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-compile.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/e2e-compile.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAA;AAElE,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACjD,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,MAAM,CAAC,CAAC,gBAAgB,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAC5E,0CAA0C,EAC1C,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,8BAA8B,EAAE,CAAA;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,kCAAkC,CAAC,EAAE,MAAM,CAAC,CAC5E,CAAA;QACD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,QAAQ;YACR,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,iBAAiB;YAChC,aAAa,EAAE,OAAO;SACvB,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAC1D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QAC5D,CAAC;QACD,iFAAiF;QACjF,qEAAqE;QACrE,QAAQ,CAAC,WAAW,GAAG,YAAY,GAAG,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACvE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAC,wCAAwC;IAClE,CAAC,CACF,CAAA;AACH,CAAC,CAAC,CAAA"}

package/build/codegen/targets/kotlin/emit-route-kotlin.d.ts

@@ -0,0 +1,11 @@
+import type { AnyHttpRouteDoc } from '../../../implementations/types.js';
+import type { KotlinEmitter } from './ajsc-adapter.js';
+export interface EmitRouteResult {
+    /** Inner body of the `object RouteName { ... }` block — already indented one level. */
+    code: string;
+    /** Imports collected from every ajsc emit + any helpers this route used. */
+    imports: string[];
+    /** Outer route name used as the `object RouteName` identifier. */
+    routeName: string;
+}
+export declare function emitKotlinRoute(route: AnyHttpRouteDoc, emitter: KotlinEmitter, errorSchemas: Map<string, unknown>): EmitRouteResult;

package/build/codegen/targets/kotlin/emit-route-kotlin.js

@@ -0,0 +1,73 @@
+import { indent } from './format-kotlin.js';
+const COLON_PARAM_RE = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+function toBracePath(template) {
+    return template.replace(COLON_PARAM_RE, '{$1}');
+}
+function pathParamNames(template) {
+    const names = [];
+    for (const match of template.matchAll(COLON_PARAM_RE))
+        names.push(match[1]);
+    return names;
+}
+function buildPathFn(bracePath, params) {
+    if (params.length === 0)
+        return `const val path = "${bracePath}"`;
+    let body = bracePath;
+    for (const name of params)
+        body = body.replace(`{${name}}`, `\${p.${name}}`);
+    return `fun path(p: PathParams): String = "${body}"`;
+}
+export function emitKotlinRoute(route, emitter, errorSchemas) {
+    const kind = route.kind;
+    if (kind === 'stream') {
+        console.warn(`[ts-procedures-codegen] Skipping stream route "${route.name}" — streams are out of scope for kotlin target.`);
+        return { code: '', imports: [], routeName: route.name };
+    }
+    const isApi = kind === 'api' || 'fullPath' in route;
+    const rawPath = isApi ? route.fullPath : route.path;
+    const method = String(route.method).toUpperCase();
+    const bracePath = toBracePath(rawPath);
+    const params = pathParamNames(rawPath);
+    const lines = [
+        `const val method = "${method}"`,
+        `const val pathTemplate = "${bracePath}"`,
+        buildPathFn(bracePath, params),
+    ];
+    const imports = [];
+    const schema = route.schema ?? {};
+    const input = (schema.input ?? {});
+    // Per-slot emission. Order is fixed for deterministic output.
+    const slots = [
+        { key: 'pathParams', rootName: 'PathParams', source: input.pathParams },
+        { key: 'query', rootName: 'Query', source: input.query },
+        { key: 'body', rootName: 'Body', source: input.body },
+        { key: 'response', rootName: 'Response', source: schema.returnType },
+    ];
+    for (const slot of slots) {
+        if (slot.source == null)
+            continue;
+        const result = emitter.emit(slot.source, { rootTypeName: slot.rootName });
+        lines.push('');
+        lines.push(result.code);
+        imports.push(...result.imports);
+    }
+    // Errors namespace — route.errors is `string[]` of taxonomy keys; look up each schema
+    // from the envelope-level errors map. Keys without schemas are skipped silently
+    // (matching the existing TS scope emitter's `errorKeys` filter).
+    const routeErrorKeys = (route.errors ?? [])
+        .filter((key) => errorSchemas.has(key));
+    if (routeErrorKeys.length > 0) {
+        const inner = [];
+        for (const key of routeErrorKeys) {
+            const r = emitter.emit(errorSchemas.get(key), { rootTypeName: key });
+            inner.push(r.code);
+            imports.push(...r.imports);
+        }
+        lines.push('');
+        lines.push('object Errors {');
+        lines.push(indent(inner.join('\n\n'), 1));
+        lines.push('}');
+    }
+    return { code: lines.join('\n'), imports, routeName: route.name };
+}
+//# sourceMappingURL=emit-route-kotlin.js.map

package/build/codegen/targets/kotlin/emit-route-kotlin.js.map

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

package/build/codegen/targets/kotlin/emit-route-kotlin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/emit-route-kotlin.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+import { emitKotlinRoute } from './emit-route-kotlin.js';
+import { createStubKotlinEmitter } from './ajsc-adapter.js';
+const ok = (code, rootTypeName) => ({
+    code,
+    rootTypeName,
+    extractedTypeNames: [],
+    imports: ['kotlinx.serialization.Serializable'],
+});
+const noErrors = new Map();
+describe('emitKotlinRoute', () => {
+    it('emits an api-kind route with path params and a response', () => {
+        const route = {
+            kind: 'api',
+            name: 'GetUser',
+            method: 'GET',
+            fullPath: '/users/:id',
+            schema: {
+                input: {
+                    pathParams: { type: 'object' },
+                },
+                returnType: { type: 'object' },
+            },
+            errors: [],
+        };
+        const emitter = createStubKotlinEmitter({
+            PathParams: ok('@Serializable data class PathParams(val id: String)', 'PathParams'),
+            Response: ok('@Serializable data class Response(val id: String, val name: String)', 'Response'),
+        });
+        const result = emitKotlinRoute(route, emitter, noErrors);
+        expect(result.imports).toContain('kotlinx.serialization.Serializable');
+        expect(result.code).toContain('const val method = "GET"');
+        expect(result.code).toContain('const val pathTemplate = "/users/{id}"');
+        expect(result.code).toContain('fun path(p: PathParams): String = "/users/${p.id}"');
+        expect(result.code).toContain('@Serializable data class PathParams(val id: String)');
+        expect(result.code).toContain('@Serializable data class Response(val id: String, val name: String)');
+    });
+    it('emits a route with no path params using a path constant', () => {
+        const route = {
+            kind: 'api',
+            name: 'CreateUser',
+            method: 'POST',
+            fullPath: '/users',
+            schema: { input: { body: { type: 'object' } }, returnType: { type: 'object' } },
+            errors: [],
+        };
+        const emitter = createStubKotlinEmitter({
+            Body: ok('@Serializable data class Body(val name: String)', 'Body'),
+            Response: ok('@Serializable data class Response(val id: String)', 'Response'),
+        });
+        const result = emitKotlinRoute(route, emitter, noErrors);
+        expect(result.code).toContain('const val path = "/users"');
+        expect(result.code).not.toContain('fun path(');
+    });
+    it('emits an Errors namespace for routes whose error keys have schemas in the envelope', () => {
+        const route = {
+            kind: 'api',
+            name: 'GetUser',
+            method: 'GET',
+            fullPath: '/users/:id',
+            schema: { input: { pathParams: { type: 'object' } }, returnType: { type: 'object' } },
+            errors: ['NotFound'],
+        };
+        const emitter = createStubKotlinEmitter({
+            PathParams: ok('@Serializable data class PathParams(val id: String)', 'PathParams'),
+            Response: ok('@Serializable data class Response(val id: String)', 'Response'),
+            NotFound: ok('@Serializable data class NotFound(val name: String, val message: String)', 'NotFound'),
+        });
+        const errorSchemas = new Map([['NotFound', { type: 'object' }]]);
+        const result = emitKotlinRoute(route, emitter, errorSchemas);
+        expect(result.code).toContain('object Errors {');
+        expect(result.code).toContain('@Serializable data class NotFound(val name: String, val message: String)');
+    });
+    it('silently skips error keys with no schema in the envelope map', () => {
+        const route = {
+            kind: 'api', name: 'GetUser', method: 'GET', fullPath: '/users',
+            schema: {}, errors: ['UnknownTaxonomyKey'],
+        };
+        const result = emitKotlinRoute(route, createStubKotlinEmitter({}), new Map());
+        expect(result.code).not.toContain('object Errors {');
+    });
+    it('skips stream routes with a warning', () => {
+        const route = { kind: 'stream', name: 'WatchUsers', method: 'GET', path: '/users/stream', schema: {}, errors: [] };
+        const result = emitKotlinRoute(route, createStubKotlinEmitter({}), noErrors);
+        expect(result.code).toBe('');
+    });
+});
+//# sourceMappingURL=emit-route-kotlin.test.js.map

package/build/codegen/targets/kotlin/emit-route-kotlin.test.js.map

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

package/build/codegen/targets/kotlin/emit-scope-kotlin.d.ts

@@ -0,0 +1,11 @@
+import type { ScopeGroup } from '../../group-routes.js';
+import type { KotlinEmitter } from './ajsc-adapter.js';
+export interface EmitScopeOptions {
+    kotlinPackage: string;
+    sourceHash: string;
+}
+export interface EmittedKotlinFile {
+    filename: string;
+    code: string;
+}
+export declare function emitKotlinScope(group: ScopeGroup, opts: EmitScopeOptions, emitter: KotlinEmitter, errorSchemas: Map<string, unknown>): EmittedKotlinFile;

package/build/codegen/targets/kotlin/emit-scope-kotlin.js

@@ -0,0 +1,35 @@
+import { emitKotlinRoute } from './emit-route-kotlin.js';
+import { kotlinPackageDecl, kotlinSourceHashHeader, kotlinImports, indent } from './format-kotlin.js';
+function pascalCase(scope) {
+    return scope
+        .split('-')
+        .filter((p) => p.length > 0)
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+}
+export function emitKotlinScope(group, opts, emitter, errorSchemas) {
+    const scopeName = pascalCase(group.scopeKey);
+    const allImports = [];
+    const routeBlocks = [];
+    for (const route of group.routes) {
+        const r = emitKotlinRoute(route, emitter, errorSchemas);
+        if (r.code === '')
+            continue;
+        allImports.push(...r.imports);
+        const wrapped = `object ${r.routeName} {\n${indent(r.code, 1)}\n}`;
+        routeBlocks.push(wrapped);
+    }
+    const innerScope = routeBlocks.length === 0 ? '' : indent(routeBlocks.join('\n\n'), 1);
+    const scopeBlock = innerScope === ''
+        ? `object ${scopeName} {\n}`
+        : `object ${scopeName} {\n${innerScope}\n}`;
+    const importsBlock = kotlinImports(allImports);
+    const parts = [
+        kotlinPackageDecl(opts.kotlinPackage),
+        kotlinSourceHashHeader(opts.sourceHash),
+        importsBlock,
+        scopeBlock,
+    ].filter((p) => p.length > 0);
+    return { filename: `${scopeName}.kt`, code: parts.join('\n\n') + '\n' };
+}
+//# sourceMappingURL=emit-scope-kotlin.js.map

package/build/codegen/targets/kotlin/emit-scope-kotlin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-scope-kotlin.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/emit-scope-kotlin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAYrG,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,IAAsB,EACtB,OAAsB,EACtB,YAAkC;IAElC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QACvD,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE;YAAE,SAAQ;QAC3B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,SAAS,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAA;QAClE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IACtF,MAAM,UAAU,GAAG,UAAU,KAAK,EAAE;QAClC,CAAC,CAAC,UAAU,SAAS,OAAO;QAC5B,CAAC,CAAC,UAAU,SAAS,OAAO,UAAU,KAAK,CAAA;IAE7C,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG;QACZ,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC;QACrC,sBAAsB,CAAC,IAAI,CAAC,UAAU,CAAC;QACvC,YAAY;QACZ,UAAU;KACX,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE7B,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAA;AACzE,CAAC"}

package/build/codegen/targets/kotlin/emit-scope-kotlin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/emit-scope-kotlin.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it } from 'vitest';
+import { emitKotlinScope } from './emit-scope-kotlin.js';
+import { createStubKotlinEmitter } from './ajsc-adapter.js';
+const ok = (code, rootTypeName) => ({
+    code,
+    rootTypeName,
+    extractedTypeNames: [],
+    imports: ['kotlinx.serialization.Serializable'],
+});
+describe('emitKotlinScope', () => {
+    it('produces a complete kotlin source file for a single-route scope', () => {
+        const route = {
+            kind: 'api',
+            name: 'GetUser',
+            method: 'GET',
+            fullPath: '/users/:id',
+            schema: { input: { pathParams: { type: 'object' } }, returnType: { type: 'object' } },
+            errors: [],
+        };
+        const group = { scopeKey: 'users', camelCase: 'users', routes: [route] };
+        const emitter = createStubKotlinEmitter({
+            PathParams: ok('@Serializable data class PathParams(val id: String)', 'PathParams'),
+            Response: ok('@Serializable data class Response(val id: String)', 'Response'),
+        });
+        const file = emitKotlinScope(group, { kotlinPackage: 'com.example.api', sourceHash: 'abc123' }, emitter, new Map());
+        expect(file.filename).toBe('Users.kt');
+        expect(file.code).toContain('package com.example.api');
+        expect(file.code).toContain('// Source hash: abc123');
+        expect(file.code).toContain('import kotlinx.serialization.Serializable');
+        expect(file.code).toContain('object Users {');
+        expect(file.code).toContain('object GetUser {');
+        expect(file.code).toContain('const val method = "GET"');
+    });
+    it('joins multiple routes inside one scope object', () => {
+        const route1 = { kind: 'api', name: 'GetUser', method: 'GET', fullPath: '/users/:id', schema: {}, errors: [] };
+        const route2 = { kind: 'api', name: 'CreateUser', method: 'POST', fullPath: '/users', schema: {}, errors: [] };
+        const group = { scopeKey: 'users', camelCase: 'users', routes: [route1, route2] };
+        const emitter = createStubKotlinEmitter({});
+        const file = emitKotlinScope(group, { kotlinPackage: 'com.example.api', sourceHash: 'h' }, emitter, new Map());
+        expect(file.code).toContain('object GetUser {');
+        expect(file.code).toContain('object CreateUser {');
+        // exactly one outer scope object
+        expect((file.code.match(/^object Users \{/gm) ?? []).length).toBe(1);
+    });
+    it('uses PascalCase scope name for the filename and outer object', () => {
+        const group = { scopeKey: 'admin-users', camelCase: 'adminUsers', routes: [] };
+        const file = emitKotlinScope(group, { kotlinPackage: 'p', sourceHash: 'h' }, createStubKotlinEmitter({}), new Map());
+        expect(file.filename).toBe('AdminUsers.kt');
+        expect(file.code).toContain('object AdminUsers {');
+    });
+});
+//# sourceMappingURL=emit-scope-kotlin.test.js.map

package/build/codegen/targets/kotlin/emit-scope-kotlin.test.js.map

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

package/build/codegen/targets/kotlin/format-kotlin.d.ts

@@ -0,0 +1,4 @@
+export declare function kotlinPackageDecl(pkg: string): string;
+export declare function kotlinSourceHashHeader(hash: string): string;
+export declare function kotlinImports(imports: string[]): string;
+export declare function indent(text: string, level: number): string;

package/build/codegen/targets/kotlin/format-kotlin.js

@@ -0,0 +1,20 @@
+export function kotlinPackageDecl(pkg) {
+    return `package ${pkg}`;
+}
+export function kotlinSourceHashHeader(hash) {
+    return `// Source hash: ${hash}`;
+}
+export function kotlinImports(imports) {
+    if (imports.length === 0)
+        return '';
+    const unique = Array.from(new Set(imports)).sort();
+    return unique.map((i) => `import ${i}`).join('\n');
+}
+export function indent(text, level) {
+    const prefix = '    '.repeat(level);
+    return text
+        .split('\n')
+        .map((line) => (line.length === 0 ? line : `${prefix}${line}`))
+        .join('\n');
+}
+//# sourceMappingURL=format-kotlin.js.map

package/build/codegen/targets/kotlin/format-kotlin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-kotlin.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/format-kotlin.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,WAAW,GAAG,EAAE,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,mBAAmB,IAAI,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAa;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC"}

package/build/codegen/targets/kotlin/format-kotlin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/format-kotlin.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { kotlinPackageDecl, kotlinSourceHashHeader, kotlinImports, indent, } from './format-kotlin.js';
+describe('format-kotlin', () => {
+    it('emits a package declaration', () => {
+        expect(kotlinPackageDecl('com.example.api')).toBe('package com.example.api');
+    });
+    it('emits a source-hash header line', () => {
+        expect(kotlinSourceHashHeader('abc123')).toBe('// Source hash: abc123');
+    });
+    it('dedupes and sorts imports', () => {
+        expect(kotlinImports(['kotlinx.serialization.Serializable', 'kotlinx.serialization.SerialName', 'kotlinx.serialization.Serializable'])).toBe('import kotlinx.serialization.SerialName\nimport kotlinx.serialization.Serializable');
+    });
+    it('returns empty string when no imports', () => {
+        expect(kotlinImports([])).toBe('');
+    });
+    it('indents every line by 4 spaces per level', () => {
+        expect(indent('a\nb', 1)).toBe('    a\n    b');
+        expect(indent('a', 2)).toBe('        a');
+    });
+    it('preserves blank lines without trailing whitespace when indenting', () => {
+        expect(indent('a\n\nb', 1)).toBe('    a\n\n    b');
+    });
+});
+//# sourceMappingURL=format-kotlin.test.js.map

package/build/codegen/targets/kotlin/format-kotlin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-kotlin.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/format-kotlin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,MAAM,GACP,MAAM,oBAAoB,CAAA;AAE3B,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,aAAa,CAAC,CAAC,oCAAoC,EAAE,kCAAkC,EAAE,oCAAoC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC1I,oFAAoF,CACrF,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/kotlin/integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/targets/kotlin/integration.test.js

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runPipeline } from '../../pipeline.js';
+import { createStubKotlinEmitter } from './ajsc-adapter.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+describe('kotlin codegen — integration', () => {
+    it('produces byte-identical output against the golden fixture', async () => {
+        const envelopePath = join(__dirname, '__fixtures__/users-envelope.json');
+        const goldenPath = join(__dirname, '__fixtures__/users-golden.kt');
+        const envelope = JSON.parse(await readFile(envelopePath, 'utf8'));
+        const goldenTemplate = await readFile(goldenPath, 'utf8');
+        const emitter = createStubKotlinEmitter({
+            PathParams: { code: '@Serializable\ndata class PathParams(val id: String)', rootTypeName: 'PathParams', extractedTypeNames: [], imports: ['kotlinx.serialization.Serializable'] },
+            Response: { code: '@Serializable\ndata class Response(val id: String, val name: String)', rootTypeName: 'Response', extractedTypeNames: [], imports: ['kotlinx.serialization.Serializable'] },
+            Body: { code: '@Serializable\ndata class Body(val name: String, val email: String)', rootTypeName: 'Body', extractedTypeNames: [], imports: ['kotlinx.serialization.Serializable'] },
+            NotFound: { code: '@Serializable\ndata class NotFound(val name: String = "NotFound", val message: String)', rootTypeName: 'NotFound', extractedTypeNames: [], imports: ['kotlinx.serialization.Serializable'] },
+        });
+        const files = await runPipeline({
+            envelope, outDir: 'out', dryRun: true,
+            target: 'kotlin', kotlinPackage: 'com.example.api',
+            kotlinEmitter: emitter,
+        });
+        expect(files).toHaveLength(1);
+        expect(files[0].path).toBe(join('out', 'Users.kt'));
+        // Hash is deterministic given envelope contents; splice into golden template.
+        const sourceHashLine = files[0].code.split('\n').find((l) => l.startsWith('// Source hash:')) ?? '';
+        const goldenWithHash = goldenTemplate.replace('// Source hash: <PLACEHOLDER>', sourceHashLine);
+        expect(files[0].code).toBe(goldenWithHash);
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/build/codegen/targets/kotlin/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/kotlin/integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAA;QACxE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAA;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;QACjE,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QAEzD,MAAM,OAAO,GAAG,uBAAuB,CAAC;YACtC,UAAU,EAAE,EAAE,IAAI,EAAE,sDAAsD,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,oCAAoC,CAAC,EAAE;YACjL,QAAQ,EAAE,EAAE,IAAI,EAAE,sEAAsE,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,oCAAoC,CAAC,EAAE;YAC7L,IAAI,EAAE,EAAE,IAAI,EAAE,qEAAqE,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,oCAAoC,CAAC,EAAE;YACpL,QAAQ,EAAE,EAAE,IAAI,EAAE,wFAAwF,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,oCAAoC,CAAC,EAAE;SAChN,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;YAC9B,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI;YACrC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB;YAClD,aAAa,EAAE,OAAO;SACvB,CAAC,CAAA;QAEF,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;QAEpD,8EAA8E;QAC9E,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAA;QACpG,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,+BAA+B,EAAE,cAAc,CAAC,CAAA;QAC9F,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/docs/http-integrations.md

@@ -271,6 +271,38 @@ The observer is awaited before the response is sent, and any error it throws is
 
 Configuring only the taxonomy, only `onError`, both, or neither are all valid. When neither is configured the builder goes straight from step 1 to step 4.
 
+## One Hono Server, Multiple Builders
+
+You don't need a separate Hono instance per builder. `HonoRPCAppBuilder`, `HonoAPIAppBuilder`, and `HonoStreamAppBuilder` each accept an optional `app?: Hono` in their config — pass the same instance and they all mount their routes onto the same server:
+
+```typescript
+import { Hono } from 'hono'
+import { HonoRPCAppBuilder } from 'ts-procedures/hono-rpc'
+import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
+import { HonoStreamAppBuilder } from 'ts-procedures/hono-stream'
+import { DocRegistry } from 'ts-procedures/http-docs'
+
+const app = new Hono()
+
+const rpcBuilder = new HonoRPCAppBuilder({ app, pathPrefix: '/rpc' })
+  .register(RPC, ctxResolver)
+const apiBuilder = new HonoAPIAppBuilder({ app, pathPrefix: '/api' })
+  .register(API, ctxResolver)
+const streamBuilder = new HonoStreamAppBuilder({ app })
+  .register(Stream, ctxResolver)
+
+rpcBuilder.build()
+apiBuilder.build()
+streamBuilder.build()
+
+const docs = new DocRegistry().from(rpcBuilder).from(apiBuilder).from(streamBuilder)
+app.get('/docs', (c) => c.json(docs.toJSON()))
+```
+
+One server, one Hono instance, one `/docs` endpoint. The three builders are **registration scopes**, not separate servers — each owns the routes it mounts (RPC vs API vs Stream) but all of them coexist on the same listener. Mix in custom middleware (`app.use(...)`), health checks, or static routes on the shared `app` before or after `.build()`.
+
+If you omit `app`, each builder constructs its own internal `Hono` instance — useful when you really do want isolated apps (multi-tenant routing, separate ports, etc.).
+
 ## DocRegistry — Composing Docs from Multiple Builders
 
 Use `DocRegistry` to compose route documentation from any combination of HTTP builders into a typed envelope: