ts-procedures 6.1.0 → 6.2.0

package/build/codegen/pipeline.js

@@ -1,15 +1,17 @@
-import { mkdir, rm, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
 import { createHash } from 'node:crypto';
 import { groupRoutesByScope } from './group-routes.js';
-import { emitScopeFile } from './emit-scope.js';
-import { emitIndexFile } from './emit-index.js';
-import { emitErrorsFile } from './emit-errors.js';
-import { emitClientTypesFile } from './emit-client-types.js';
-import { emitClientRuntimeFile } from './emit-client-runtime.js';
 import { validateServiceName } from './naming.js';
-import { emitKotlinScope } from './targets/kotlin/emit-scope-kotlin.js';
-import { pickDefined } from './targets/kotlin/format-kotlin.js';
+import { runKotlinPipeline } from './targets/kotlin/run.js';
+import { runSwiftPipeline } from './targets/swift/run.js';
+import { runTsPipeline } from './targets/ts/run.js';
+/**
+ * Top-level codegen entry. Validates the service name, computes the source
+ * hash, groups routes by scope, then dispatches to the per-target run module.
+ *
+ * Per-target modules own their language-specific emission and the file-write
+ * tail (dryRun / cleanOutDir / mkdir / writeFile via
+ * `_shared/write-files.ts`).
+ */
 export async function runPipeline(options) {
     const { envelope, outDir, ajsc: ajscOpts, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = false } = options;
     const serviceName = options.serviceName ?? 'Api';
@@ -19,142 +21,41 @@ export async function runPipeline(options) {
         console.warn('[ts-procedures-codegen] --self-contained overrides --client-import-path; using ./_types');
     }
     const hash = createHash('md5').update(JSON.stringify(envelope)).digest('hex');
-    const hashComment = `// Source hash: ${hash}`;
-    const groups = groupRoutesByScope(envelope.routes);
-    const groupArray = Array.from(groups.values());
-    if (options.target === 'kotlin') {
-        if (options.kotlinPackage == null) {
-            throw new Error('[ts-procedures-codegen] target=kotlin requires kotlinPackage');
-        }
-        if (options.kotlinEmitter == null) {
-            throw new Error('[ts-procedures-codegen] target=kotlin requires a kotlinEmitter (CLI resolves via resolveProductionKotlinEmitter)');
-        }
-        // Route errors are taxonomy keys (string[]); look up actual schemas from the
-        // envelope's top-level errors array. Mirrors the existing TS scope emitter.
-        const errorSchemas = new Map();
-        for (const e of envelope.errors) {
-            if (e.schema != null)
-                errorSchemas.set(e.name, e.schema);
-        }
-        // Spec §"CLI flags" — `--array-item-naming`, `--depluralize`, `--uncountable-words`
-        // also apply to the Kotlin target. The CLI parks them on `options.ajsc` (a TS-target
-        // structure historically); copy the Kotlin-relevant subset onto the scope opts here.
-        const ajscPassthrough = options.ajsc ?? {};
-        const AJSC_PASSTHROUGH_KEYS = ['arrayItemNaming', 'depluralize', 'uncountableWords'];
-        const kotlinFiles = [];
-        const allSkipped = [];
-        for (const group of groupArray) {
-            const emitted = emitKotlinScope(group, {
-                kotlinPackage: options.kotlinPackage,
-                sourceHash: hash,
-                ...(options.kotlinSerializer !== undefined ? { serializer: options.kotlinSerializer } : {}),
-                ...(options.unsupportedUnions !== undefined ? { unsupportedUnions: options.unsupportedUnions } : {}),
-                ...pickDefined(ajscPassthrough, AJSC_PASSTHROUGH_KEYS),
-            }, options.kotlinEmitter, errorSchemas);
-            kotlinFiles.push({ path: join(outDir, emitted.filename), code: emitted.code });
-            allSkipped.push(...emitted.skippedStreams);
-        }
-        if (allSkipped.length > 0) {
-            console.log(`[ts-procedures-codegen] Skipped ${allSkipped.length} stream route${allSkipped.length === 1 ? '' : 's'} (kotlin target): ${allSkipped.join(', ')}`);
-        }
-        if (dryRun) {
-            if (cleanOutDir) {
-                console.log(`[dry-run] Would clean outDir: ${outDir}`);
-            }
-            for (const f of kotlinFiles) {
-                const bytes = Buffer.byteLength(f.code, 'utf-8');
-                console.log(`[dry-run] Would write: ${f.path} (${bytes} bytes)`);
-            }
-        }
-        else {
-            if (cleanOutDir) {
-                await rm(outDir, { recursive: true, force: true });
-            }
-            await mkdir(outDir, { recursive: true });
-            for (const f of kotlinFiles) {
-                await writeFile(f.path, f.code, 'utf-8');
-            }
-        }
-        return kotlinFiles;
-    }
-    // Error keys that will be emitted in `_errors.ts` — only those with a schema.
-    // Scope emit uses this to filter `route.errors` so generated code never
-    // references an undefined error type.
-    const errorKeys = new Set(envelope.errors.filter((e) => e.schema != null).map((e) => e.name));
-    if (selfContained) {
-        for (const group of groupArray) {
-            if (group.scopeKey === '_types' || group.scopeKey === '_client') {
-                throw new Error(`[ts-procedures-codegen] Scope "${group.scopeKey}" conflicts with self-contained mode reserved filename "${group.scopeKey}.ts". Rename the scope to avoid collision.`);
-            }
-        }
-    }
-    const files = [];
-    for (const group of groupArray) {
-        const rawCode = await emitScopeFile(group, {
-            ajsc: ajscOpts,
-            clientImportPath,
-            namespaceTypes,
-            serviceName,
-            errorKeys: errorKeys.size > 0 ? errorKeys : undefined,
-        });
-        const lines = rawCode.split('\n');
-        lines.splice(1, 0, hashComment);
-        const code = lines.join('\n');
-        files.push({ path: join(outDir, `${group.scopeKey}.ts`), code });
-    }
-    const errorsCode = await emitErrorsFile(envelope.errors, { ajsc: ajscOpts, clientImportPath, namespaceTypes, serviceName });
-    const hasErrors = errorsCode != null;
-    if (errorsCode != null) {
-        const errorsLines = errorsCode.split('\n');
-        errorsLines.splice(1, 0, hashComment);
-        const errorsWithHash = errorsLines.join('\n');
-        files.push({ path: join(outDir, '_errors.ts'), code: errorsWithHash });
-    }
-    // In self-contained mode types come from `./_types` but the runtime
-    // (`createClient`) lives in `./_client`. In regular mode both share the
-    // single `clientImportPath` (e.g. `ts-procedures/client`).
-    const clientRuntimeImportPath = selfContained ? './_client' : clientImportPath;
-    const rawIndexCode = emitIndexFile(groupArray, {
+    const groups = Array.from(groupRoutesByScope(envelope.routes).values());
+    const base = {
+        envelope,
+        outDir,
+        hash,
+        groups,
+        serviceName,
+        ajsc: ajscOpts,
         clientImportPath,
-        clientRuntimeImportPath,
-        hasErrors,
+        dryRun,
         namespaceTypes,
-        serviceName,
-    });
-    const indexLines = rawIndexCode.split('\n');
-    indexLines.splice(1, 0, hashComment);
-    const indexCode = indexLines.join('\n');
-    files.push({ path: join(outDir, 'index.ts'), code: indexCode });
-    if (selfContained) {
-        const rawTypesCode = await emitClientTypesFile();
-        const typesLines = rawTypesCode.split('\n');
-        typesLines.splice(1, 0, hashComment);
-        const typesCode = typesLines.join('\n');
-        files.push({ path: join(outDir, '_types.ts'), code: typesCode });
-        const rawClientCode = await emitClientRuntimeFile();
-        const clientLines = rawClientCode.split('\n');
-        clientLines.splice(1, 0, hashComment);
-        const clientCode = clientLines.join('\n');
-        files.push({ path: join(outDir, '_client.ts'), code: clientCode });
-    }
-    if (dryRun) {
-        if (cleanOutDir) {
-            console.log(`[dry-run] Would clean outDir: ${outDir}`);
-        }
-        for (const file of files) {
-            const bytes = Buffer.byteLength(file.code, 'utf-8');
-            console.log(`[dry-run] Would write: ${file.path} (${bytes} bytes)`);
-        }
-    }
-    else {
-        if (cleanOutDir) {
-            await rm(outDir, { recursive: true, force: true });
-        }
-        await mkdir(outDir, { recursive: true });
-        for (const file of files) {
-            await writeFile(file.path, file.code, 'utf-8');
-        }
+        selfContained,
+        cleanOutDir,
+    };
+    switch (options.target) {
+        case 'kotlin':
+            return runKotlinPipeline({
+                ...base,
+                kotlinPackage: options.kotlinPackage,
+                kotlinSerializer: options.kotlinSerializer,
+                unsupportedUnions: options.unsupportedUnions,
+                kotlinEmitter: options.kotlinEmitter,
+            });
+        case 'swift':
+            return runSwiftPipeline({
+                ...base,
+                swiftSerializer: options.swiftSerializer,
+                swiftAccessLevel: options.swiftAccessLevel,
+                unsupportedUnions: options.unsupportedUnions,
+                swiftEmitter: options.swiftEmitter,
+            });
+        case 'ts':
+        case undefined:
+        default:
+            return runTsPipeline(base);
     }
-    return files;
 }
 //# sourceMappingURL=pipeline.js.map

package/build/codegen/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/codegen/pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/codegen/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA0BnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB;IACxD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IACxI,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAA;IAChD,mBAAmB,CAAC,WAAW,CAAC,CAAA;IAEhC,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAA;IAC9E,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAA;IACzG,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IAEvE,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,MAAM;QACN,IAAI;QACJ,MAAM;QACN,WAAW;QACX,IAAI,EAAE,QAAQ;QACd,gBAAgB;QAChB,MAAM;QACN,cAAc;QACd,aAAa;QACb,WAAW;KACZ,CAAA;IAED,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC;gBACvB,GAAG,IAAI;gBACP,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAA;QACJ,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;gBACtB,GAAG,IAAI;gBACP,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAA;QACJ,KAAK,IAAI,CAAC;QACV,KAAK,SAAS,CAAC;QACf;YACE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC"}

package/build/codegen/targets/_shared/error-schemas.d.ts

@@ -0,0 +1,10 @@
+import type { ErrorDoc } from '../../../implementations/types.js';
+/**
+ * Builds a lookup map from a {@link DocEnvelope}'s top-level `errors` array
+ * keyed by `name`. Only entries with a `schema` are included — errors
+ * documented without a schema cannot have a corresponding generated type.
+ *
+ * Targets pass this map to per-route emission so taxonomy keys on
+ * `route.errors` (a `string[]`) can be resolved to actual JSON Schemas.
+ */
+export declare function buildErrorSchemasMap(errors: readonly ErrorDoc[]): Map<string, unknown>;

package/build/codegen/targets/_shared/error-schemas.js

@@ -0,0 +1,17 @@
+/**
+ * Builds a lookup map from a {@link DocEnvelope}'s top-level `errors` array
+ * keyed by `name`. Only entries with a `schema` are included — errors
+ * documented without a schema cannot have a corresponding generated type.
+ *
+ * Targets pass this map to per-route emission so taxonomy keys on
+ * `route.errors` (a `string[]`) can be resolved to actual JSON Schemas.
+ */
+export function buildErrorSchemasMap(errors) {
+    const errorSchemas = new Map();
+    for (const e of errors) {
+        if (e.schema != null)
+            errorSchemas.set(e.name, e.schema);
+    }
+    return errorSchemas;
+}
+//# sourceMappingURL=error-schemas.js.map

package/build/codegen/targets/_shared/error-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-schemas.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/error-schemas.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA2B;IAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC"}

package/build/codegen/targets/_shared/error-schemas.test.d.ts

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

package/build/codegen/targets/_shared/error-schemas.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import { buildErrorSchemasMap } from './error-schemas.js';
+describe('buildErrorSchemasMap', () => {
+    it('returns an empty map when there are no errors', () => {
+        expect(buildErrorSchemasMap([])).toEqual(new Map());
+    });
+    it('includes errors with schemas', () => {
+        const schemaA = { type: 'object', tag: 'a' };
+        const schemaB = { type: 'object', tag: 'b' };
+        const errors = [
+            { name: 'A', statusCode: 400, description: '', schema: schemaA },
+            { name: 'B', statusCode: 500, description: '', schema: schemaB },
+        ];
+        const map = buildErrorSchemasMap(errors);
+        expect(map.size).toBe(2);
+        expect(map.get('A')).toBe(schemaA);
+        expect(map.get('B')).toBe(schemaB);
+    });
+    it('skips errors without a schema', () => {
+        const schemaA = { type: 'object' };
+        const errors = [
+            { name: 'A', statusCode: 400, description: '', schema: schemaA },
+            { name: 'NoSchema', statusCode: 500, description: '' },
+        ];
+        const map = buildErrorSchemasMap(errors);
+        expect(map.size).toBe(1);
+        expect(map.has('A')).toBe(true);
+        expect(map.has('NoSchema')).toBe(false);
+    });
+    it('keys the map by error name', () => {
+        const schema = { type: 'object' };
+        const map = buildErrorSchemasMap([
+            { name: 'NotFound', statusCode: 404, description: '', schema },
+        ]);
+        expect(Array.from(map.keys())).toEqual(['NotFound']);
+    });
+});
+//# sourceMappingURL=error-schemas.test.js.map

package/build/codegen/targets/_shared/error-schemas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-schemas.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/error-schemas.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAGzD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QAC5C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QAC5C,MAAM,MAAM,GAAe;YACzB,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;YAChE,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SACjE,CAAA;QACD,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAClC,MAAM,MAAM,GAAe;YACzB,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;YAChE,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE;SACvD,CAAA;QACD,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;QACxC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QACjC,MAAM,GAAG,GAAG,oBAAoB,CAAC;YAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE;SAC/D,CAAC,CAAA;QACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/indent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Indents every non-blank line of `text` by `level * 4` spaces. Blank lines
+ * are preserved as empty (no trailing whitespace). Suitable for languages
+ * that use 4-space indentation (Kotlin, Swift).
+ */
+export declare function indent(text: string, level: number): string;

package/build/codegen/targets/_shared/indent.js

@@ -0,0 +1,13 @@
+/**
+ * Indents every non-blank line of `text` by `level * 4` spaces. Blank lines
+ * are preserved as empty (no trailing whitespace). Suitable for languages
+ * that use 4-space indentation (Kotlin, Swift).
+ */
+export function indent(text, level) {
+    const prefix = '    '.repeat(level);
+    return text
+        .split('\n')
+        .map((line) => (line.length === 0 ? line : `${prefix}${line}`))
+        .join('\n');
+}
+//# sourceMappingURL=indent.js.map

package/build/codegen/targets/_shared/indent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/indent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,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/_shared/indent.test.d.ts

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

package/build/codegen/targets/_shared/indent.test.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+import { indent } from './indent.js';
+describe('indent', () => {
+    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');
+    });
+    it('returns the input unchanged at level 0', () => {
+        expect(indent('a\n\nb', 0)).toBe('a\n\nb');
+    });
+    it('indents a single line', () => {
+        expect(indent('hello', 1)).toBe('    hello');
+    });
+    it('returns empty string for empty input', () => {
+        expect(indent('', 1)).toBe('');
+    });
+});
+//# sourceMappingURL=indent.test.js.map

package/build/codegen/targets/_shared/indent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indent.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/indent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,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;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/pascal-case.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a kebab-case (or single-word) scope key to PascalCase. Used by
+ * codegen targets to derive top-level type/namespace identifiers from scope
+ * names (e.g. `user-management` → `UserManagement`).
+ */
+export declare function pascalCase(scope: string): string;

package/build/codegen/targets/_shared/pascal-case.js

@@ -0,0 +1,13 @@
+/**
+ * Converts a kebab-case (or single-word) scope key to PascalCase. Used by
+ * codegen targets to derive top-level type/namespace identifiers from scope
+ * names (e.g. `user-management` → `UserManagement`).
+ */
+export function pascalCase(scope) {
+    return scope
+        .split('-')
+        .filter((p) => p.length > 0)
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+}
+//# sourceMappingURL=pascal-case.js.map

package/build/codegen/targets/_shared/pascal-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascal-case.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/pascal-case.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,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"}

package/build/codegen/targets/_shared/pascal-case.test.d.ts

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

package/build/codegen/targets/_shared/pascal-case.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest';
+import { pascalCase } from './pascal-case.js';
+describe('pascalCase', () => {
+    it('converts a single-word scope', () => {
+        expect(pascalCase('users')).toBe('Users');
+    });
+    it('converts a kebab-case scope', () => {
+        expect(pascalCase('user-management')).toBe('UserManagement');
+    });
+    it('handles multi-segment kebab-case', () => {
+        expect(pascalCase('a-b-c')).toBe('ABC');
+    });
+    it('drops empty segments from leading/trailing/double dashes', () => {
+        expect(pascalCase('-users')).toBe('Users');
+        expect(pascalCase('users-')).toBe('Users');
+        expect(pascalCase('user--mgmt')).toBe('UserMgmt');
+    });
+    it('returns empty string for empty input', () => {
+        expect(pascalCase('')).toBe('');
+    });
+    it('preserves casing of letters after the leading character', () => {
+        expect(pascalCase('user-API')).toBe('UserAPI');
+    });
+});
+//# sourceMappingURL=pascal-case.test.js.map

package/build/codegen/targets/_shared/pascal-case.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pascal-case.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/pascal-case.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/path-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Language-agnostic path-template utilities used by every codegen target that
+ * emits HTTP routes. Routes carry colon-prefixed path templates (e.g.
+ * `/users/:id`); targets typically need both the brace form (`/users/{id}`)
+ * for documentation/template constants and the parameter-name list for
+ * generating typed path-builder functions.
+ */
+export declare const COLON_PARAM_RE: RegExp;
+/** Converts colon-prefixed path params (`:foo`) to brace form (`{foo}`). */
+export declare function toBracePath(template: string): string;
+/** Extracts the parameter names from a colon-prefixed path template. */
+export declare function pathParamNames(template: string): string[];

package/build/codegen/targets/_shared/path-utils.js

@@ -0,0 +1,20 @@
+/**
+ * Language-agnostic path-template utilities used by every codegen target that
+ * emits HTTP routes. Routes carry colon-prefixed path templates (e.g.
+ * `/users/:id`); targets typically need both the brace form (`/users/{id}`)
+ * for documentation/template constants and the parameter-name list for
+ * generating typed path-builder functions.
+ */
+export const COLON_PARAM_RE = /:([A-Za-z_][A-Za-z0-9_]*)/g;
+/** Converts colon-prefixed path params (`:foo`) to brace form (`{foo}`). */
+export function toBracePath(template) {
+    return template.replace(COLON_PARAM_RE, '{$1}');
+}
+/** Extracts the parameter names from a colon-prefixed path template. */
+export function pathParamNames(template) {
+    const names = [];
+    for (const match of template.matchAll(COLON_PARAM_RE))
+        names.push(match[1]);
+    return names;
+}
+//# sourceMappingURL=path-utils.js.map

package/build/codegen/targets/_shared/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,4BAA4B,CAAA;AAE1D,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;IAC5E,OAAO,KAAK,CAAA;AACd,CAAC"}

package/build/codegen/targets/_shared/path-utils.test.d.ts

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

package/build/codegen/targets/_shared/path-utils.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { COLON_PARAM_RE, toBracePath, pathParamNames } from './path-utils.js';
+describe('path-utils', () => {
+    describe('toBracePath', () => {
+        it('converts colon params to brace form', () => {
+            expect(toBracePath('/users/:id')).toBe('/users/{id}');
+        });
+        it('converts multiple params', () => {
+            expect(toBracePath('/orgs/:orgId/users/:userId')).toBe('/orgs/{orgId}/users/{userId}');
+        });
+        it('returns the template unchanged when there are no params', () => {
+            expect(toBracePath('/users')).toBe('/users');
+        });
+        it('supports underscore-prefixed param names', () => {
+            expect(toBracePath('/x/:_id')).toBe('/x/{_id}');
+        });
+        it('does not match leading-digit identifiers', () => {
+            // ":1abc" is not a valid identifier; should not be rewritten.
+            expect(toBracePath('/x/:1abc')).toBe('/x/:1abc');
+        });
+    });
+    describe('pathParamNames', () => {
+        it('returns an empty list for templates without params', () => {
+            expect(pathParamNames('/users')).toEqual([]);
+        });
+        it('returns the single param name', () => {
+            expect(pathParamNames('/users/:id')).toEqual(['id']);
+        });
+        it('preserves the order of multiple params', () => {
+            expect(pathParamNames('/orgs/:orgId/users/:userId')).toEqual(['orgId', 'userId']);
+        });
+        it('matches identifiers with digits and underscores', () => {
+            expect(pathParamNames('/x/:user_id1')).toEqual(['user_id1']);
+        });
+    });
+    describe('COLON_PARAM_RE', () => {
+        it('is a global regex (so matchAll works)', () => {
+            expect(COLON_PARAM_RE.global).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=path-utils.test.js.map

package/build/codegen/targets/_shared/path-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/path-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE7E,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACxF,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,8DAA8D;YAC9D,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAClD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,cAAc,CAAC,4BAA4B,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QACnF,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;QAC9D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/pick-defined.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Returns a new object containing only the keys of `src` whose values are
+ * not `undefined`. Useful for building option objects where unset keys must
+ * be ABSENT (not `undefined`-valued), so they don't shadow downstream
+ * defaults — e.g., when forwarding into a target's `Emit*Options`.
+ *
+ * @example
+ *   pickDefined({ a: 1, b: undefined, c: false }, ['a', 'b', 'c'])
+ *   // → { a: 1, c: false }
+ */
+export declare function pickDefined<T extends object, K extends keyof T>(src: T, keys: readonly K[]): Partial<Pick<T, K>>;

package/build/codegen/targets/_shared/pick-defined.js

@@ -0,0 +1,21 @@
+/**
+ * Returns a new object containing only the keys of `src` whose values are
+ * not `undefined`. Useful for building option objects where unset keys must
+ * be ABSENT (not `undefined`-valued), so they don't shadow downstream
+ * defaults — e.g., when forwarding into a target's `Emit*Options`.
+ *
+ * @example
+ *   pickDefined({ a: 1, b: undefined, c: false }, ['a', 'b', 'c'])
+ *   // → { a: 1, c: false }
+ */
+export function pickDefined(src, keys) {
+    const out = {};
+    for (const key of keys) {
+        const value = src[key];
+        if (value !== undefined) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=pick-defined.js.map

package/build/codegen/targets/_shared/pick-defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-defined.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/pick-defined.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,GAAM,EACN,IAAkB;IAElB,MAAM,GAAG,GAAwB,EAAE,CAAA;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/codegen/targets/_shared/pick-defined.test.d.ts

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

package/build/codegen/targets/_shared/pick-defined.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest';
+import { pickDefined } from './pick-defined.js';
+describe('pickDefined', () => {
+    it('returns only the keys whose values are not undefined', () => {
+        expect(pickDefined({ a: 1, b: undefined, c: 3 }, ['a', 'b', 'c'])).toEqual({ a: 1, c: 3 });
+    });
+    it('preserves the literal `false` value for boolean opts', () => {
+        expect(pickDefined({ depluralize: false, x: undefined }, ['depluralize', 'x'])).toEqual({ depluralize: false });
+    });
+    it('preserves the literal `false` for `string | false` opts (e.g. arrayItemNaming)', () => {
+        const result = pickDefined({ arrayItemNaming: false }, ['arrayItemNaming']);
+        expect(result).toEqual({ arrayItemNaming: false });
+        expect('arrayItemNaming' in result).toBe(true);
+    });
+    it('omits keys not in the keys list even if they are defined on src', () => {
+        expect(pickDefined({ a: 1, b: 2 }, ['a'])).toEqual({ a: 1 });
+    });
+    it('returns an empty object when all keys are undefined', () => {
+        expect(pickDefined({ a: undefined, b: undefined }, ['a', 'b'])).toEqual({});
+    });
+    it('returns an empty object when keys is empty', () => {
+        expect(pickDefined({ a: 1 }, [])).toEqual({});
+    });
+});
+//# sourceMappingURL=pick-defined.test.js.map

package/build/codegen/targets/_shared/pick-defined.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-defined.test.js","sourceRoot":"","sources":["../../../../src/codegen/targets/_shared/pick-defined.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CACJ,WAAW,CACT,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAA4C,EACtE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAChB,CACF,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CACJ,WAAW,CACT,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAA2C,EAC7E,CAAC,aAAa,EAAE,GAAG,CAAC,CACrB,CACF,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QAExF,MAAM,MAAM,GAAG,WAAW,CAAmB,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAC7F,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAA;QAClD,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CACJ,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAgC,EAAE,CAAC,GAAG,CAAC,CAAC,CACjE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CACJ,WAAW,CACT,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAgC,EAC5D,CAAC,GAAG,EAAE,GAAG,CAAC,CACX,CACF,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAa,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/targets/_shared/route-slots.d.ts

@@ -0,0 +1,17 @@
+import type { AnyHttpRouteDoc } from '../../../implementations/types.js';
+/**
+ * A "slot" is one of the deterministic schema sources a route exposes:
+ * `pathParams`, `query`, `body` (under `schema.input`) and the response
+ * (`schema.returnType`). Targets emit one type per non-null slot.
+ */
+export interface RouteSlot {
+    /** Stable identifier used as the emitted type's `rootTypeName`. */
+    rootName: string;
+    /** The raw JSON Schema source for this slot, or `null`/`undefined` when absent. */
+    source: unknown;
+}
+/**
+ * Returns the deterministic ordered slot list for a route, filtered to slots
+ * with non-null sources. Order is fixed at the module level for stable output.
+ */
+export declare function extractRouteSlots(route: AnyHttpRouteDoc): RouteSlot[];