@redocly/client-generator 0.0.0-snapshot.1784554531

package/lib/emitters/transformers.js

@@ -0,0 +1,334 @@
+// Emits standalone Date-transformer functions from the IR. For each named
+// schema that (recursively) carries a `format: date-time`/`date` string field,
+// emits `export const transform<Name> = (data: <Name>): <Name> => { … };` that
+// walks the value and rewrites those wire ISO strings to `new Date(...)` in
+// place, so the runtime value matches the sdk's `--date-type Date` types.
+//
+// Pairs with the sdk generated under `dateType: 'Date'`; the client itself
+// stays zero-dep (Date is standard). Transformers compose across refs:
+// `transformPet` calls `transformPerson(data["owner"])` when `Pet.owner` is a
+// `Person` that has dates.
+import { safeIdent } from './identifier.js';
+import { pascalCase } from './support.js';
+import { arrow, exportConstStatement, printStatements, ts } from './ts.js';
+const { factory } = ts;
+/** `transform<Name>` — the function bound to a named schema. */
+function transformName(name) {
+    return `transform${pascalCase(name)}`;
+}
+/** A scalar string with a `date-time`/`date` format — the leaf we convert. */
+function isDateScalar(schema) {
+    return (schema.kind === 'scalar' &&
+        schema.scalar === 'string' &&
+        (schema.metadata?.format === 'date-time' || schema.metadata?.format === 'date'));
+}
+/**
+ * Whether a schema contains a date leaf, following refs. `seen` guards ref
+ * cycles (a self-referential schema would otherwise recurse forever); a ref
+ * back into the visited set carries no *new* dates from here.
+ */
+function hasDates(schema, byName, seen) {
+    if (isDateScalar(schema))
+        return true;
+    switch (schema.kind) {
+        case 'array':
+            return hasDates(schema.items, byName, seen);
+        case 'record':
+            return hasDates(schema.value, byName, seen);
+        case 'object':
+            return schema.properties.some((p) => hasDates(p.schema, byName, seen));
+        case 'union':
+        case 'intersection':
+            return schema.members.some((m) => hasDates(m, byName, seen));
+        case 'ref': {
+            const target = byName.get(schema.name);
+            return target !== undefined && !seen.has(schema.name)
+                ? hasDates(target, byName, new Set(seen).add(schema.name))
+                : false;
+        }
+        default:
+            return false;
+    }
+}
+/** `<target>["key"]` — bracket access, robust for any (incl. non-identifier) key. */
+function index(target, key) {
+    return factory.createElementAccessExpression(target, factory.createStringLiteral(key));
+}
+/** `new Date(<arg>)`. */
+function newDate(arg) {
+    return factory.createNewExpression(factory.createIdentifier('Date'), undefined, [arg]);
+}
+/** `typeof <expr> === "string"`. */
+function isStringGuard(expr) {
+    return factory.createBinaryExpression(factory.createTypeOfExpression(expr), factory.createToken(ts.SyntaxKind.EqualsEqualsEqualsToken), factory.createStringLiteral('string'));
+}
+/** `Array.isArray(<expr>)`. */
+function isArrayGuard(expr) {
+    return factory.createCallExpression(factory.createPropertyAccessExpression(factory.createIdentifier('Array'), 'isArray'), undefined, [expr]);
+}
+/** `<expr> && typeof <expr> === "object"` — truthy and a (non-null) object. */
+function isObjectGuard(expr) {
+    return factory.createBinaryExpression(expr, factory.createToken(ts.SyntaxKind.AmpersandAmpersandToken), factory.createBinaryExpression(factory.createTypeOfExpression(expr), factory.createToken(ts.SyntaxKind.EqualsEqualsEqualsToken), factory.createStringLiteral('object')));
+}
+/** `<expr> as <Type>` — a type assertion, to satisfy a union-narrowing transform. */
+function asType(expr, typeName) {
+    return factory.createAsExpression(expr, factory.createTypeReferenceNode(pascalCase(typeName)));
+}
+/** `if (<cond>) <then>;`. */
+function ifThen(cond, then) {
+    return factory.createIfStatement(cond, then);
+}
+function exprStatement(expr) {
+    return factory.createExpressionStatement(expr);
+}
+/** `<target> = <value>;`. */
+function assign(target, value) {
+    return exprStatement(factory.createBinaryExpression(target, factory.createToken(ts.SyntaxKind.EqualsToken), value));
+}
+/** `<recv>.<method>(<args>)`. */
+function method(recv, name, args) {
+    return factory.createCallExpression(factory.createPropertyAccessExpression(recv, name), undefined, args);
+}
+function param(name) {
+    return factory.createParameterDeclaration(undefined, undefined, name);
+}
+/** Next nested loop variable: `item`, `item2`, `item3`, … (avoids shadowing). */
+function nextItemVar(current) {
+    if (current === 'data')
+        return 'item';
+    return `item${Number(current.slice('item'.length)) + 1}`;
+}
+/**
+ * Conversion statements that, given the runtime value at `target` typed by
+ * `schema`, rewrite date leaves in place. Each branch self-gates by returning
+ * `[]` when nothing under it carries a date, so callers need no pre-check.
+ * `seen` follows refs and guards cycles; `itemVar` names nested loop variables.
+ *
+ * Covers the shapes a date can hide in: date scalars, arrays of them, refs to
+ * date-bearing schemas (composed via `transform<Ref>`), arrays of such refs,
+ * records, nested inline objects, and the date-bearing members of a
+ * union/intersection.
+ */
+function convert(target, schema, byName, seen, itemVar) {
+    if (isDateScalar(schema)) {
+        return [ifThen(isStringGuard(target), assign(target, newDate(target)))];
+    }
+    switch (schema.kind) {
+        case 'ref':
+            return convertRef(target, schema.name, byName, seen);
+        case 'object': {
+            const stmts = [];
+            for (const p of schema.properties) {
+                stmts.push(...convertProperty(index(target, p.name), p.schema, byName, seen, itemVar));
+            }
+            return stmts;
+        }
+        case 'array':
+            return convertArray(target, schema.items, byName, seen, itemVar);
+        case 'record':
+            return convertCollection(target, schema.value, byName, seen, itemVar, true);
+        case 'intersection': {
+            // An intersection value satisfies *every* member type, so each member's
+            // transform applies directly to `target` with no narrowing needed.
+            const stmts = [];
+            for (const m of schema.members)
+                stmts.push(...convert(target, m, byName, seen, itemVar));
+            return stmts;
+        }
+        case 'union':
+            return convertUnion(target, schema.members, byName, seen, itemVar);
+        default:
+            return [];
+    }
+}
+/**
+ * A union position. A runtime value inhabits exactly one member, so we apply
+ * every date-bearing member's conversion to the same `target` and let the
+ * unmatched members' runtime guards no-op.
+ *
+ * Type-safety is the catch: `target` is typed as the whole union, so an
+ * object/ref member's `transform<Ref>(target)` would fail `--date-type Date`
+ * strict-tsc (TS2345). We therefore gate the object-shaped members behind a
+ * single `typeof target === "object"` check and CAST `target` to each member's
+ * type — the cast makes it compile, the cast target's own internal string
+ * guards make a wrong-member application a safe runtime no-op. Scalar date
+ * members keep their `typeof === "string"` guard (their type is `Date` under
+ * `--date-type Date`, so the assignment type-checks).
+ */
+function convertUnion(target, members, byName, seen, itemVar) {
+    const stmts = [];
+    const objectGuarded = [];
+    for (const m of members) {
+        if (isDateScalar(m)) {
+            stmts.push(...convert(target, m, byName, seen, itemVar));
+        }
+        else if (m.kind === 'ref') {
+            if (!hasDates(m, byName, seen))
+                continue;
+            objectGuarded.push(exprStatement(factory.createCallExpression(factory.createIdentifier(transformName(m.name)), undefined, [
+                asType(target, m.name),
+            ])));
+        }
+        else {
+            // Object/array/record members: recurse under the shared object guard.
+            objectGuarded.push(...convert(target, m, byName, seen, itemVar));
+        }
+    }
+    if (objectGuarded.length > 0) {
+        stmts.push(ifThen(isObjectGuard(target), factory.createBlock(objectGuarded, true)));
+    }
+    return stmts;
+}
+/**
+ * A ref position: `if (<target>) transform<Ref>(<target>);`, emitted only when
+ * the ref target carries dates (so the sibling transform exists).
+ */
+function convertRef(target, name, byName, seen) {
+    if (!hasDates({ kind: 'ref', name }, byName, seen))
+        return [];
+    const call = factory.createCallExpression(factory.createIdentifier(transformName(name)), undefined, [target]);
+    return [ifThen(target, exprStatement(call))];
+}
+/**
+ * A property position: a nested inline object guards presence and recurses
+ * inside a block; everything else (scalars, refs, arrays, …) delegates to
+ * `convert`, which guards itself.
+ */
+function convertProperty(target, schema, byName, seen, itemVar) {
+    if (schema.kind === 'ref')
+        return convertRef(target, schema.name, byName, seen);
+    if (schema.kind === 'object') {
+        const inner = convert(target, schema, byName, seen, itemVar);
+        return inner.length === 0 ? [] : [ifThen(target, factory.createBlock(inner, true))];
+    }
+    return convert(target, schema, byName, seen, itemVar);
+}
+/**
+ * A "replace-by-value" element is one a transform must overwrite wholesale
+ * rather than mutate in place: a date scalar (`new Date(v)`) or an array of
+ * such elements (`v.map(...)`). Returns the expression that yields the replaced
+ * value for the element bound to `value`, or `null` when the element instead
+ * mutates in place (object/ref/record). Recurses for arrays-of-arrays.
+ *
+ * Reassigning a loop *variable* is a no-op, so date scalars (and arrays of
+ * them) can only be converted by reassigning their container slot — an array
+ * via `slot = slot.map(...)`, a record via per-key assignment. This builds the
+ * per-element value for those write-backs.
+ */
+function replacer(value, element, depth = 0) {
+    if (isDateScalar(element))
+        return newDate(value);
+    if (element.kind === 'array') {
+        // Map var for the level below: `v` over the scalar leaf, else `row`, `row2`,
+        // … per array level — distinct names by depth avoid shadowing. Yields
+        // `.map((v) => new Date(v))` and `.map((row) => row.map((v) => new Date(v)))`.
+        const varName = element.items.kind === 'array' ? rowVar(depth + 1) : 'v';
+        const inner = replacer(factory.createIdentifier(varName), element.items, depth + 1);
+        if (inner === null)
+            return null;
+        return method(value, 'map', [arrow([param(varName)], inner)]);
+    }
+    return null;
+}
+/** Array map-var name by depth: `row`, `row2`, `row3`, … (avoids shadowing). */
+function rowVar(depth) {
+    return depth <= 1 ? 'row' : `row${depth}`;
+}
+/** Conversions for `target` being an array whose elements are typed by `items`. */
+function convertArray(target, items, byName, seen, itemVar) {
+    // Date scalars / arrays-of-date-scalars are replace-by-value: map over the
+    // array and reassign the slot (reassigning a loop var would be lost).
+    const varName = items.kind === 'array' ? rowVar(1) : 'v';
+    const mapped = replacer(factory.createIdentifier(varName), items, 1);
+    if (mapped !== null) {
+        // `if (Array.isArray(t)) t = t.map((v) => new Date(v));`  (or nested `row`)
+        return [
+            ifThen(isArrayGuard(target), assign(target, method(target, 'map', [arrow([param(varName)], mapped)]))),
+        ];
+    }
+    if (items.kind === 'ref') {
+        if (!hasDates(items, byName, seen))
+            return [];
+        // `if (Array.isArray(t)) t.forEach(transformRef);`
+        const forEach = method(target, 'forEach', [
+            factory.createIdentifier(transformName(items.name)),
+        ]);
+        return [ifThen(isArrayGuard(target), exprStatement(forEach))];
+    }
+    return convertCollection(target, items, byName, seen, itemVar, false);
+}
+/**
+ * Iterate a collection (array or record) of mutate-in-place elements (objects,
+ * refs, records) and recurse with a fresh loop variable. Arrays iterate the
+ * value directly; records iterate `Object.values(...)`. `[]` when the element
+ * bears no dates.
+ *
+ * Replace-by-value elements (date scalars) never reach the array path here —
+ * `convertArray` handles them via map-and-reassign. A *record* of date scalars
+ * does land here: a `forEach` loop variable can't write back, so we iterate the
+ * keys and assign back into the record (`rec[k] = new Date(rec[k])`).
+ */
+function convertCollection(target, element, byName, seen, itemVar, isRecord) {
+    if (isRecord) {
+        // Replace-by-value elements (date scalars, arrays of them) can't be written
+        // through a `forEach` loop var, so iterate the keys and assign back into the
+        // record slot. Date scalars are string-guarded; nested arrays array-guarded.
+        const slot = factory.createElementAccessExpression(target, factory.createIdentifier('__k'));
+        const replaced = replacer(slot, element);
+        if (replaced !== null) {
+            const guard = isDateScalar(element) ? isStringGuard(slot) : isArrayGuard(slot);
+            return [ifThen(target, keyLoop(target, ifThen(guard, assign(slot, replaced))))];
+        }
+    }
+    const next = nextItemVar(itemVar);
+    const body = convert(factory.createIdentifier(next), element, byName, seen, next);
+    if (body.length === 0)
+        return [];
+    const iterable = isRecord
+        ? method(factory.createIdentifier('Object'), 'values', [target])
+        : target;
+    const forEach = method(iterable, 'forEach', [
+        arrow([param(next)], factory.createBlock(body, true)),
+    ]);
+    return [ifThen(isRecord ? target : isArrayGuard(target), exprStatement(forEach))];
+}
+/** `for (const __k of Object.keys(<target>)) <body>`. */
+function keyLoop(target, body) {
+    return factory.createForOfStatement(undefined, factory.createVariableDeclarationList([factory.createVariableDeclaration('__k')], ts.NodeFlags.Const), method(factory.createIdentifier('Object'), 'keys', [target]), body);
+}
+/** `export const transform<Name> = (data: <Name>): <Name> => { … };`. */
+function transformStatement(named, byName) {
+    const typeName = pascalCase(named.name);
+    const data = factory.createIdentifier('data');
+    const body = named.schema.kind === 'ref'
+        ? convertRef(data, named.schema.name, byName, new Set())
+        : convert(data, named.schema, byName, new Set(), 'data');
+    const fn = arrow([
+        factory.createParameterDeclaration(undefined, undefined, 'data', undefined, factory.createTypeReferenceNode(typeName)),
+    ], factory.createBlock([...body, factory.createReturnStatement(data)], true));
+    const typed = factory.createArrowFunction(fn.modifiers, fn.typeParameters, fn.parameters, factory.createTypeReferenceNode(typeName), fn.equalsGreaterThanToken, fn.body);
+    return exportConstStatement(transformName(named.name), typed);
+}
+/** `import type { <Name>, … } from "<module>";`. */
+function typeImport(names, module) {
+    return factory.createImportDeclaration(undefined, factory.createImportClause(true, undefined, factory.createNamedImports(names.map((n) => factory.createImportSpecifier(false, undefined, factory.createIdentifier(safeIdent(n)))))), factory.createStringLiteral(module));
+}
+/**
+ * Render the transformers module. Emits one `transform<Name>` per named schema
+ * that carries a date field; `''` when none do. `opts.sdkModule` is the import
+ * specifier the schema TYPES are pulled from (the transformers call each other
+ * as siblings, so only the types need importing).
+ */
+export function renderTransformersModule(model, opts) {
+    const byName = new Map(model.schemas.map((s) => [s.name, s.schema]));
+    const dated = model.schemas.filter((s) => hasDates(s.schema, byName, new Set()));
+    if (dated.length === 0)
+        return '';
+    const types = dated.map((s) => pascalCase(s.name));
+    const statements = [
+        typeImport(types, opts.sdkModule),
+        ...dated.map((s) => transformStatement(s, byName)),
+    ];
+    return printStatements(statements);
+}
+//# sourceMappingURL=transformers.js.map

package/lib/emitters/transformers.js.map

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

package/lib/emitters/ts.d.ts

@@ -0,0 +1,40 @@
+import ts from 'typescript';
+export { ts };
+/** Print a list of nodes to source, tight (one per line) — for import/export groups and single nodes. */
+export declare function printNodes(nodes: readonly ts.Node[]): string;
+/** Print top-level declarations separated by one blank line, for readable declaration bodies. */
+export declare function printStatements(nodes: readonly ts.Node[]): string;
+/** Parse a source string into its top-level statements (for embedding hand-authored code). */
+export declare function parseStatements(source: string): ts.Statement[];
+/** Parse a single source expression into a ts.Expression (for emitting generator-authored
+ *  expressions like `new Blob([])` that aren't plain data literals). */
+export declare function parseExpression(source: string): ts.Expression;
+/**
+ * Attach a block JSDoc leading comment to `node` so it prints as a `/** … *​/`
+ * block above the node. Multi-line `text` becomes `*`-prefixed lines.
+ */
+export declare function jsdoc<T extends ts.Node>(node: T, text: string): T;
+/** Backslash-escape any comment-closing star-slash so it cannot terminate a block comment. */
+export declare function escapeJsDoc(text: string): string;
+/**
+ * Shared `ts.factory` builders for the handful of node shapes every emitter was
+ * re-implementing locally (variable statements, arrow functions, `as const`
+ * arrays). Centralizing them keeps emitters terse and their output identical.
+ */
+/** `export const <name> = <init>;` */
+export declare function exportConstStatement(name: string, init: ts.Expression): ts.Statement;
+/** An arrow function `(<params>) => <body>` (no explicit return type). */
+export declare function arrow(params: ts.ParameterDeclaration[], body: ts.ConciseBody): ts.ArrowFunction;
+/** `[<elements…>] as const`. */
+export declare function constArray(elements: ts.Expression[]): ts.Expression;
+/**
+ * A plain JS value as a printable literal expression. Negative numbers print as
+ * a unary minus over the positive literal (a `NumericLiteral` node cannot carry
+ * the sign); arrays and objects recurse and print compact, with keys quoted only
+ * when they fail the identifier GRAMMAR — reserved words (a descriptor's `in`
+ * field) are legal bare object-literal keys. The primitive overload's narrower
+ * return type fits `factory.createLiteralTypeNode`.
+ */
+export declare function literalExpression(value: string | number | boolean | null): ts.LiteralExpression | ts.BooleanLiteral | ts.NullLiteral | ts.PrefixUnaryExpression;
+export declare function literalExpression(value: unknown): ts.Expression;
+//# sourceMappingURL=ts.d.ts.map

package/lib/emitters/ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts.d.ts","sourceRoot":"","sources":["../../src/emitters/ts.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,OAAO,EAAE,EAAE,EAAE,CAAC;AASd,yGAAyG;AACzG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAE5D;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAEjE;AAkBD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,SAAS,EAAE,CAK9D;AAED;wEACwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CAU7D;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CASjE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAID;;;;GAIG;AAEH,sCAAsC;AACtC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,SAAS,CAQpF;AAED,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,aAAa,CAS/F;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAKnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GACtC,EAAE,CAAC,iBAAiB,GAAG,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,qBAAqB,CAAC;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC"}

package/lib/emitters/ts.js

@@ -0,0 +1,104 @@
+// Foundation for AST-based code emission: a shared TypeScript printer plus
+// `ts.factory` ergonomics. Emitters build `ts.Node`s and print them through
+// `printNodes`; hand-authored reference TypeScript is embedded via
+// `parseStatements`. The compiler (`ts`) is re-exported so emitters import the
+// factory from one place.
+import ts from 'typescript';
+import { isIdentifier } from './identifier.js';
+export { ts };
+const printer = ts.createPrinter({
+    newLine: ts.NewLineKind.LineFeed,
+    removeComments: false,
+});
+const blankFile = ts.createSourceFile('', '', ts.ScriptTarget.Latest, false, ts.ScriptKind.TS);
+/** Print a list of nodes to source, tight (one per line) — for import/export groups and single nodes. */
+export function printNodes(nodes) {
+    return nodes.map(printOne).join('\n');
+}
+/** Print top-level declarations separated by one blank line, for readable declaration bodies. */
+export function printStatements(nodes) {
+    return nodes.map(printOne).join('\n\n');
+}
+function printOne(node) {
+    return printer.printNode(ts.EmitHint.Unspecified, node, sourceFileOf(node));
+}
+// Synthesized (`ts.factory`) nodes have no parent chain — print them against the
+// shared blank file. Parsed nodes (from `parseStatements`, built with parent
+// nodes set) must print against their own source so literal token text survives.
+function sourceFileOf(node) {
+    let current = node;
+    while (current) {
+        if (ts.isSourceFile(current))
+            return current;
+        current = current.parent;
+    }
+    return blankFile;
+}
+/** Parse a source string into its top-level statements (for embedding hand-authored code). */
+export function parseStatements(source) {
+    return [
+        ...ts.createSourceFile('__embed.ts', source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS)
+            .statements,
+    ];
+}
+/** Parse a single source expression into a ts.Expression (for emitting generator-authored
+ *  expressions like `new Blob([])` that aren't plain data literals). */
+export function parseExpression(source) {
+    const stmt = ts.createSourceFile('__expr.ts', `(${source});`, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS).statements[0];
+    const parenthesized = stmt.expression;
+    return parenthesized.expression;
+}
+/**
+ * Attach a block JSDoc leading comment to `node` so it prints as a `/** … *​/`
+ * block above the node. Multi-line `text` becomes `*`-prefixed lines.
+ */
+export function jsdoc(node, text) {
+    // Neutralize any embedded `*/` here, at the single choke point every JSDoc block
+    // flows through: a spec-supplied description/summary/title containing `*/` would
+    // otherwise close the comment early and turn the rest into live code (injection).
+    const body = `*\n${escapeJsDoc(text)
+        .split('\n')
+        .map((line) => ` * ${line}`.replace(/ +$/, ''))
+        .join('\n')}\n `;
+    return ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, body, true);
+}
+/** Backslash-escape any comment-closing star-slash so it cannot terminate a block comment. */
+export function escapeJsDoc(text) {
+    return text.replace(/\*\//g, '*\\/');
+}
+const { factory } = ts;
+/**
+ * Shared `ts.factory` builders for the handful of node shapes every emitter was
+ * re-implementing locally (variable statements, arrow functions, `as const`
+ * arrays). Centralizing them keeps emitters terse and their output identical.
+ */
+/** `export const <name> = <init>;` */
+export function exportConstStatement(name, init) {
+    return factory.createVariableStatement([factory.createModifier(ts.SyntaxKind.ExportKeyword)], factory.createVariableDeclarationList([factory.createVariableDeclaration(name, undefined, undefined, init)], ts.NodeFlags.Const));
+}
+/** An arrow function `(<params>) => <body>` (no explicit return type). */
+export function arrow(params, body) {
+    return factory.createArrowFunction(undefined, undefined, params, undefined, factory.createToken(ts.SyntaxKind.EqualsGreaterThanToken), body);
+}
+/** `[<elements…>] as const`. */
+export function constArray(elements) {
+    return factory.createAsExpression(factory.createArrayLiteralExpression(elements, false), factory.createTypeReferenceNode('const'));
+}
+export function literalExpression(value) {
+    if (typeof value === 'string')
+        return factory.createStringLiteral(value);
+    if (typeof value === 'boolean')
+        return value ? factory.createTrue() : factory.createFalse();
+    if (typeof value === 'number') {
+        return value < 0
+            ? factory.createPrefixUnaryExpression(ts.SyntaxKind.MinusToken, factory.createNumericLiteral(-value))
+            : factory.createNumericLiteral(value);
+    }
+    if (value === null)
+        return factory.createNull();
+    if (Array.isArray(value)) {
+        return factory.createArrayLiteralExpression(value.map(literalExpression), false);
+    }
+    return factory.createObjectLiteralExpression(Object.entries(value).map(([key, entryValue]) => factory.createPropertyAssignment(isIdentifier(key) ? key : factory.createStringLiteral(key), literalExpression(entryValue))), false);
+}
+//# sourceMappingURL=ts.js.map

package/lib/emitters/ts.js.map

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

package/lib/emitters/type-guards.d.ts

@@ -0,0 +1,21 @@
+import type { NamedSchemaModel } from '../intermediate-representation/model.js';
+import { ts } from './ts.js';
+/**
+ * Emit `is<Member>(value): value is <Member>` type guards for every discriminated
+ * union with a usable discriminator — whether it is a top-level named schema
+ * (`MenuItem = A | B`) or nested inside one (e.g. the `items` of an array, the
+ * value of a property). Two discriminator sources:
+ *
+ * - Explicit: the union carries a `discriminator` (built from the spec).
+ * - Implicit: no discriminator, but every member is a ref to a named schema and
+ *   they all constrain one shared property to a distinct string `const`.
+ *
+ * Nested unions only qualify when every member is a ref to a named schema, so the
+ * `value` parameter is a clean union of exported types. Guard names are globally
+ * deduped (`is<Member>`), keeping the first in document order — so a top-level
+ * union wins its nicer `value: <UnionName>` parameter over a nested re-occurrence.
+ * Undiscriminated unions are skipped — TypeScript can't soundly narrow them.
+ * Returns the guard declarations as nodes (empty when no union narrows).
+ */
+export declare function typeGuardStatements(schemas: NamedSchemaModel[]): ts.FunctionDeclaration[];
+//# sourceMappingURL=type-guards.d.ts.map

package/lib/emitters/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/emitters/type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAS,EAAE,EAAE,MAAM,SAAS,CAAC;AAgBpC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAuCzF"}