@redocly/client-generator 0.3.7 → 0.4.0

package/lib/printers/go.js.map

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

package/lib/printers/index.d.ts

@@ -0,0 +1,5 @@
+export { GoPrinter, exported } from './go.js';
+export { PhpPrinter } from './php.js';
+export { PythonPrinter } from './python.js';
+export { TypeScriptPrinter } from './typescript.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/printers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/printers/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/printers/index.js

@@ -0,0 +1,9 @@
+// The four language printers (ADR-0021): the common `Printer` owns structure, each of
+// these owns one language's syntax. They fill the same slots — `typeName`, `memberName`,
+// `identifier`, `identifiers`, `string`, `literal`, `comment`, `doc`, a baked-in indent
+// unit, and (where the language demands one) a `layout` pass applied by `toString()`.
+export { GoPrinter, exported } from './go.js';
+export { PhpPrinter } from './php.js';
+export { PythonPrinter } from './python.js';
+export { TypeScriptPrinter } from './typescript.js';
+//# sourceMappingURL=index.js.map

package/lib/printers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/printers/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,yFAAyF;AACzF,wFAAwF;AACxF,sFAAsF;AAEtF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/printers/php.d.ts

@@ -0,0 +1,21 @@
+import { Printer } from '../authoring/printer.js';
+export declare class PhpPrinter extends Printer {
+    constructor();
+    /** A class/enum name: PascalCase, keyword-safe. */
+    typeName(name: string): string;
+    /** A property/method name: camelCase, keyword-safe. */
+    memberName(name: string): string;
+    /** A variable/argument name (without the `$`). */
+    identifier(name: string): string;
+    /** Names made unique among themselves and the caller's taken set (`id`, `id2`). */
+    identifiers(names: readonly string[], taken?: Iterable<string>): string[];
+    /** `'…'` with backslashes and quotes escaped — safe for any spec-supplied text. */
+    string(value: string): string;
+    /** JSON-ish data as a PHP expression (arrays for both lists and maps). */
+    literal(value: unknown): string;
+    /** A `//` line comment. */
+    comment(text: string): this;
+    /** A docblock: one line without tags, the `@tag` form with them. */
+    doc(name: string, description?: string, tags?: string[]): this;
+}
+//# sourceMappingURL=php.d.ts.map

package/lib/printers/php.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php.d.ts","sourceRoot":"","sources":["../../src/printers/php.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKlD,qBAAa,UAAW,SAAQ,OAAO;;IAKrC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,kDAAkD;IAClD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,mFAAmF;IACnF,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAIzE,mFAAmF;IACnF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI7B,0EAA0E;IAC1E,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAW/B,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,oEAAoE;IACpE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI;CAWnE"}

package/lib/printers/php.js

@@ -0,0 +1,68 @@
+// The PHP syntax printer (ADR-0021). PHP's extension: `doc` takes `@tag` lines, because
+// `array` and `\Generator` erase element types — the docblock carries what they hold.
+import { identifierFor, RESERVED_WORDS, uniqueIdentifiers } from '../authoring/naming.js';
+import { Printer } from '../authoring/printer.js';
+import { docText } from '../authoring/schema.js';
+const PHP = RESERVED_WORDS.php;
+export class PhpPrinter extends Printer {
+    constructor() {
+        super('    ');
+    }
+    /** A class/enum name: PascalCase, keyword-safe. */
+    typeName(name) {
+        return identifierFor(name, { style: 'pascal', reserved: PHP });
+    }
+    /** A property/method name: camelCase, keyword-safe. */
+    memberName(name) {
+        return identifierFor(name, { style: 'camel', reserved: PHP });
+    }
+    /** A variable/argument name (without the `$`). */
+    identifier(name) {
+        return identifierFor(name, { style: 'camel', reserved: PHP });
+    }
+    /** Names made unique among themselves and the caller's taken set (`id`, `id2`). */
+    identifiers(names, taken) {
+        return uniqueIdentifiers(names, { style: 'camel', reserved: PHP, taken });
+    }
+    /** `'…'` with backslashes and quotes escaped — safe for any spec-supplied text. */
+    string(value) {
+        return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    }
+    /** JSON-ish data as a PHP expression (arrays for both lists and maps). */
+    literal(value) {
+        if (value === null || value === undefined)
+            return 'null';
+        if (typeof value === 'boolean' || typeof value === 'number')
+            return String(value);
+        if (typeof value === 'string')
+            return this.string(value);
+        if (Array.isArray(value))
+            return `[${value.map((item) => this.literal(item)).join(', ')}]`;
+        const entries = Object.entries(value)
+            .map(([key, entry]) => `${this.string(key)} => ${this.literal(entry)}`)
+            .join(', ');
+        return `[${entries}]`;
+    }
+    /** A `//` line comment. */
+    comment(text) {
+        for (const line of docText(text))
+            this.line(line === '' ? '//' : `// ${line}`);
+        return this;
+    }
+    /** A docblock: one line without tags, the `@tag` form with them. */
+    doc(name, description, tags = []) {
+        const lines = docText(description);
+        if (lines.length === 0 && tags.length === 0)
+            return this;
+        const summary = lines.length === 0 ? name : `${name} — ${lines.join(' ')}`;
+        if (tags.length === 0)
+            return this.line(`/** ${summary} */`);
+        this.line('/**');
+        this.line(` * ${summary}`);
+        this.line(' *');
+        for (const tag of tags)
+            this.line(` * ${tag}`);
+        return this.line(' */');
+    }
+}
+//# sourceMappingURL=php.js.map

package/lib/printers/php.js.map

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

package/lib/printers/python.d.ts

@@ -0,0 +1,31 @@
+import { Printer } from '../authoring/printer.js';
+export declare class PythonPrinter extends Printer {
+    constructor();
+    /** A class name: PascalCase, keyword-safe. */
+    typeName(name: string): string;
+    /** A field/parameter name, reporting a rename so the caller can record the wire name. */
+    memberName(name: string): {
+        identifier: string;
+        renamed: boolean;
+    };
+    /** A local/argument name: snake_case, keyword-safe. */
+    identifier(name: string): string;
+    /** Names made unique among themselves and the caller's taken set (`id`, `id_2`). */
+    identifiers(names: readonly string[], taken?: Iterable<string>): string[];
+    /** A module-level constant name: SCREAMING_SNAKE. */
+    constName(name: string): string;
+    /**
+     * A double-quoted Python string literal for any spec-supplied text. Controls are
+     * escaped; a lone surrogate (a JS string can carry one) stays representable as its
+     * `\uXXXX` escape; everything else — non-ASCII included — is written as itself,
+     * because generated files are UTF-8.
+     */
+    string(value: string): string;
+    /** JSON-ish data as a Python expression (dicts/lists/strings/numbers/bools/None). */
+    literal(value: unknown): string;
+    /** A `#` line comment (multi-line text becomes one `#` line per line). */
+    comment(text: string): this;
+    /** A docstring: Python's one-line and multi-line forms differ, and this owns the rule. */
+    doc(description?: string): this;
+}
+//# sourceMappingURL=python.d.ts.map

package/lib/printers/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/printers/python.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKlD,qBAAa,aAAc,SAAQ,OAAO;;IAKxC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,yFAAyF;IACzF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAKlE,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,oFAAoF;IACpF,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAIzE,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAgB7B,qFAAqF;IACrF,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAa/B,0EAA0E;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,0FAA0F;IAC1F,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAQhC"}

package/lib/printers/python.js

@@ -0,0 +1,101 @@
+// The Python syntax printer (ADR-0021): structure from the common `Printer`, syntax —
+// identifier safety, string escaping, literal rendering, comment and docstring form —
+// owned here. The generator owns shape (classes, signatures, field lists) as template
+// literals; the test for what belongs on the printer is "is there exactly one right answer?"
+import { identifierFor, RESERVED_WORDS, uniqueIdentifiers } from '../authoring/naming.js';
+import { Printer } from '../authoring/printer.js';
+import { docText } from '../authoring/schema.js';
+const PY = RESERVED_WORDS.python;
+export class PythonPrinter extends Printer {
+    constructor() {
+        super('    ');
+    }
+    /** A class name: PascalCase, keyword-safe. */
+    typeName(name) {
+        return identifierFor(name, { style: 'pascal', reserved: PY });
+    }
+    /** A field/parameter name, reporting a rename so the caller can record the wire name. */
+    memberName(name) {
+        const identifier = identifierFor(name, { style: 'snake', reserved: PY });
+        return { identifier, renamed: identifier !== name };
+    }
+    /** A local/argument name: snake_case, keyword-safe. */
+    identifier(name) {
+        return identifierFor(name, { style: 'snake', reserved: PY });
+    }
+    /** Names made unique among themselves and the caller's taken set (`id`, `id_2`). */
+    identifiers(names, taken) {
+        return uniqueIdentifiers(names, { style: 'snake', reserved: PY, taken });
+    }
+    /** A module-level constant name: SCREAMING_SNAKE. */
+    constName(name) {
+        return identifierFor(name, { style: 'screaming', reserved: PY });
+    }
+    /**
+     * A double-quoted Python string literal for any spec-supplied text. Controls are
+     * escaped; a lone surrogate (a JS string can carry one) stays representable as its
+     * `\uXXXX` escape; everything else — non-ASCII included — is written as itself,
+     * because generated files are UTF-8.
+     */
+    string(value) {
+        let out = '"';
+        for (const char of value) {
+            const code = char.codePointAt(0);
+            if (char === '\\')
+                out += '\\\\';
+            else if (char === '"')
+                out += '\\"';
+            else if (char === '\n')
+                out += '\\n';
+            else if (char === '\r')
+                out += '\\r';
+            else if (char === '\t')
+                out += '\\t';
+            else if (code < 0x20 || code === 0x7f)
+                out += `\\x${code.toString(16).padStart(2, '0')}`;
+            else if (code >= 0xd800 && code <= 0xdfff)
+                out += `\\u${code.toString(16).padStart(4, '0')}`;
+            else
+                out += char;
+        }
+        return out + '"';
+    }
+    /** JSON-ish data as a Python expression (dicts/lists/strings/numbers/bools/None). */
+    literal(value) {
+        if (value === null || value === undefined)
+            return 'None';
+        if (value === true)
+            return 'True';
+        if (value === false)
+            return 'False';
+        if (typeof value === 'number')
+            return String(value);
+        if (typeof value === 'string')
+            return this.string(value);
+        if (Array.isArray(value))
+            return `[${value.map((item) => this.literal(item)).join(', ')}]`;
+        const entries = Object.entries(value)
+            .map(([key, entry]) => `${this.string(key)}: ${this.literal(entry)}`)
+            .join(', ');
+        return `{${entries}}`;
+    }
+    /** A `#` line comment (multi-line text becomes one `#` line per line). */
+    comment(text) {
+        for (const line of docText(text))
+            this.line(line === '' ? '#' : `# ${line}`);
+        return this;
+    }
+    /** A docstring: Python's one-line and multi-line forms differ, and this owns the rule. */
+    doc(description) {
+        const lines = docText(description);
+        if (lines.length === 0)
+            return this;
+        if (lines.length === 1)
+            return this.line(`"""${lines[0]}"""`);
+        this.line(`"""${lines[0]}`);
+        for (const line of lines.slice(1))
+            this.line(line);
+        return this.line('"""');
+    }
+}
+//# sourceMappingURL=python.js.map

package/lib/printers/python.js.map

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

package/lib/printers/typescript.d.ts

@@ -0,0 +1,82 @@
+import { Printer } from '../authoring/printer.js';
+import type { SchemaMetadata } from '../intermediate-representation/model.js';
+export declare class TypeScriptPrinter extends Printer {
+    constructor();
+    /** A type name: PascalCase over an already-sanitized name (the IR coerces op names). */
+    typeName(name: string): string;
+    /** A member (binding) name: sanitized, keyword-safe. */
+    memberName(name: string): string;
+    /** A local/argument name: sanitized, keyword-safe. */
+    identifier(name: string): string;
+    /** Names made unique among themselves and the caller's taken set (`id`, `id_2`). */
+    identifiers(names: readonly string[], taken?: Iterable<string>): string[];
+    /** An object key: bare when it is a valid non-reserved identifier, quoted otherwise. */
+    key(name: string): string;
+    /** A string literal that cannot escape the code context it lands in. */
+    string(value: string): string;
+    /** JSON-ish data as TypeScript source text. */
+    literal(value: unknown): string;
+    /** A `//` line comment. */
+    comment(text: string): this;
+    /** A JSDoc block; a star-slash in spec text is escaped so it cannot terminate it. */
+    doc(description?: string): this;
+}
+/** True when `name` matches the JS identifier grammar (reserved words still pass). */
+export declare function isIdentifier(name: string): boolean;
+/** True when `name` is a valid JS identifier AND not a reserved word — safe as a binding name. */
+export declare function isSafeIdentifier(name: string): boolean;
+/**
+ * Coerce an arbitrary spec-supplied name into a valid, non-reserved JS identifier
+ * (no uniqueness guarantee — see `uniqueIdent`). Non-identifier characters become
+ * `_`; an empty result, a leading digit, or a reserved word is prefixed with `_`.
+ * This is the security boundary for any name that lands in a declaration slot —
+ * `ts.factory.createIdentifier` prints its text verbatim, so an unsanitized name
+ * like `foo(){};evil()` would emit as executable code.
+ */
+export declare function sanitizeIdentifier(name: string): string;
+export declare function codeString(value: string): string;
+/**
+ * Render `name` as an object key or property name: bare when it is a valid,
+ * non-reserved identifier, quoted otherwise. Safe only where quoting is legal
+ * (object keys, property signatures) — not for binding names; use `uniqueIdent`
+ * there.
+ */
+export declare function safeIdent(name: string): string;
+/**
+ * `sanitizeIdentifier(name)` made unique within `used` (which it mutates):
+ * collisions get a `_2`, `_3`, … suffix. Used wherever a name lands in a binding
+ * slot that — unlike an object key — cannot be quoted (function/type/parameter
+ * names), so `safeIdent`'s quote-on-failure fallback would not compile.
+ */
+export declare function uniqueIdent(name: string, used: Set<string>): string;
+/** The one string-literal policy, under this module's historical name. */
+export declare const sanitizeCodeString: typeof codeString;
+/** A JSON-ish value as TypeScript source text. */
+export declare function codeLiteral(value: unknown): string;
+/** Backslash-escape any comment-closing star-slash so it cannot terminate a block comment. */
+export declare function escapeJsDoc(text: string): string;
+/**
+ * The JSDoc body for a description + metadata as a single `\n`-joined string,
+ * or `undefined` when there's nothing to document. The AST emitters feed this
+ * to `ts.ts`'s `jsdoc` helper (which owns the `*`-prefixing and indentation),
+ * so this returns only the raw body — no comment delimiters, no padding.
+ */
+export declare function jsdocText(text: string | undefined, metadata?: SchemaMetadata): string | undefined;
+/**
+ * Upper-case the first character of an operation name. We don't normalize the
+ * rest because almost every spec uses camelCase or PascalCase, and names that
+ * contain digits or `_` are passed through unchanged — the user named them that
+ * way for a reason.
+ *
+ * `op.name` reaches here already sanitized into a non-empty, valid TS identifier
+ * by the IR builder (see `intermediate-representation/sanitize-identifiers.ts`), so no empty-string or
+ * unsafe-character guard is needed.
+ */
+export declare function pascalCase(name: string): string;
+/**
+ * CamelCase property key for a response-header wire name (`Pagination-Total` →
+ * `paginationTotal`).
+ */
+export declare function headerPropertyKey(wireName: string): string;
+export declare function splitLines(text: string): string[];
+//# sourceMappingURL=typescript.d.ts.map

package/lib/printers/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../src/printers/typescript.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,qBAAa,iBAAkB,SAAQ,OAAO;;IAK5C,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,wDAAwD;IACxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,sDAAsD;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,oFAAoF;IACpF,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAKzE,wFAAwF;IACxF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIzB,wEAAwE;IACxE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI7B,+CAA+C;IAC/C,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAI/B,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,qFAAqF;IACrF,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAOhC;AAcD,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAeD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAOnE;AAID,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,mBAAa,CAAC;AAE7C,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYlD;AAID,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAGjG;AA8DD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}

package/lib/printers/typescript.js

@@ -0,0 +1,268 @@
+// The TypeScript syntax printer (ADR-0021). TypeScript's extension is `key(name)` — a
+// bare-or-quoted object key; no other output language has quotable keys. Its `string`
+// carries the merged escaping policy: JSON escaping plus U+2028/U+2029 (line terminators
+// in JS source) plus `<`/`>` (a `</script>` breakout when output lands in an inline
+// script) — previously two escapers with different protections, split by import site.
+import { RESERVED_WORDS } from '../authoring/naming.js';
+import { Printer } from '../authoring/printer.js';
+import { docText } from '../authoring/schema.js';
+export class TypeScriptPrinter extends Printer {
+    constructor() {
+        super('    ');
+    }
+    /** A type name: PascalCase over an already-sanitized name (the IR coerces op names). */
+    typeName(name) {
+        return pascalCase(sanitizeIdentifier(name));
+    }
+    /** A member (binding) name: sanitized, keyword-safe. */
+    memberName(name) {
+        return sanitizeIdentifier(name);
+    }
+    /** A local/argument name: sanitized, keyword-safe. */
+    identifier(name) {
+        return sanitizeIdentifier(name);
+    }
+    /** Names made unique among themselves and the caller's taken set (`id`, `id_2`). */
+    identifiers(names, taken) {
+        const used = new Set(taken ?? []);
+        return names.map((name) => uniqueIdent(name, used));
+    }
+    /** An object key: bare when it is a valid non-reserved identifier, quoted otherwise. */
+    key(name) {
+        return isSafeIdentifier(name) ? name : this.string(name);
+    }
+    /** A string literal that cannot escape the code context it lands in. */
+    string(value) {
+        return sanitizeCodeString(value);
+    }
+    /** JSON-ish data as TypeScript source text. */
+    literal(value) {
+        return codeLiteral(value);
+    }
+    /** A `//` line comment. */
+    comment(text) {
+        for (const line of docText(text))
+            this.line(line === '' ? '//' : `// ${line}`);
+        return this;
+    }
+    /** A JSDoc block; a star-slash in spec text is escaped so it cannot terminate it. */
+    doc(description) {
+        const lines = docText(description);
+        if (lines.length === 0)
+            return this;
+        this.line('/**');
+        for (const line of lines)
+            this.line(line === '' ? ' *' : ` * ${line.replace(/\*\//g, '*\\/')}`);
+        return this.line(' */');
+    }
+}
+// ─── Identifier mechanics ───
+// Identifier sanitization — mapping OpenAPI names (which may contain `-`, `.`,
+// spaces, or be reserved words) onto valid TypeScript identifiers. Pure string
+// logic with no dependency on the IR or other emitters.
+/** Matches a string that is already a valid JS identifier (ignoring reserved words). */
+const IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+// One list for the package: `identifierFor` (suffix convention) reads the same set.
+const TS_RESERVED = RESERVED_WORDS.typescript;
+/** True when `name` matches the JS identifier grammar (reserved words still pass). */
+export function isIdentifier(name) {
+    return IDENT_RE.test(name);
+}
+/** True when `name` is a valid JS identifier AND not a reserved word — safe as a binding name. */
+export function isSafeIdentifier(name) {
+    return IDENT_RE.test(name) && !TS_RESERVED.has(name);
+}
+/**
+ * Coerce an arbitrary spec-supplied name into a valid, non-reserved JS identifier
+ * (no uniqueness guarantee — see `uniqueIdent`). Non-identifier characters become
+ * `_`; an empty result, a leading digit, or a reserved word is prefixed with `_`.
+ * This is the security boundary for any name that lands in a declaration slot —
+ * `ts.factory.createIdentifier` prints its text verbatim, so an unsanitized name
+ * like `foo(){};evil()` would emit as executable code.
+ */
+export function sanitizeIdentifier(name) {
+    let base = name.replace(/[^A-Za-z0-9_$]/g, '_');
+    if (base === '' || /^[0-9]/.test(base) || TS_RESERVED.has(base))
+        base = `_${base}`;
+    return base;
+}
+/**
+ * A double-quoted TS string literal for generated code. One policy for the whole
+ * package — the stricter of the two that used to exist: U+2028/U+2029 (line terminators
+ * in JS source) AND `<`/`>` (a `</script>` breakout when output lands in an inline
+ * script). Which protection applied used to depend on which escaper the caller imported.
+ */
+const CODE_UNSAFE = {
+    '<': '\\u003C',
+    '>': '\\u003E',
+    '\u2028': '\\u2028',
+    '\u2029': '\\u2029',
+};
+export function codeString(value) {
+    return JSON.stringify(value).replace(/[<>\u2028\u2029]/g, (char) => CODE_UNSAFE[char]);
+}
+/**
+ * Render `name` as an object key or property name: bare when it is a valid,
+ * non-reserved identifier, quoted otherwise. Safe only where quoting is legal
+ * (object keys, property signatures) — not for binding names; use `uniqueIdent`
+ * there.
+ */
+export function safeIdent(name) {
+    if (IDENT_RE.test(name) && !TS_RESERVED.has(name)) {
+        return name;
+    }
+    return codeString(name);
+}
+/**
+ * `sanitizeIdentifier(name)` made unique within `used` (which it mutates):
+ * collisions get a `_2`, `_3`, … suffix. Used wherever a name lands in a binding
+ * slot that — unlike an object key — cannot be quoted (function/type/parameter
+ * names), so `safeIdent`'s quote-on-failure fallback would not compile.
+ */
+export function uniqueIdent(name, used) {
+    const base = sanitizeIdentifier(name);
+    let ident = base;
+    let n = 2;
+    while (used.has(ident))
+        ident = `${base}_${n++}`;
+    used.add(ident);
+    return ident;
+}
+// ─── Literals ───
+/** The one string-literal policy, under this module's historical name. */
+export const sanitizeCodeString = codeString;
+/** A JSON-ish value as TypeScript source text. */
+export function codeLiteral(value) {
+    if (typeof value === 'string')
+        return codeString(value);
+    if (typeof value === 'boolean' || value === null)
+        return String(value);
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value)) {
+        return `[${value.map(codeLiteral).join(', ')}]`;
+    }
+    const entries = Object.entries(value).map(([key, entryValue]) => `${isIdentifier(key) ? key : codeString(key)}: ${codeLiteral(entryValue)}`);
+    return entries.length === 0 ? '{}' : `{ ${entries.join(', ')} }`;
+}
+// ─── JSDoc ───
+/** Backslash-escape any comment-closing star-slash so it cannot terminate a block comment. */
+export function escapeJsDoc(text) {
+    return text.replace(/\*\//g, '*\\/');
+}
+/**
+ * The JSDoc body for a description + metadata as a single `\n`-joined string,
+ * or `undefined` when there's nothing to document. The AST emitters feed this
+ * to `ts.ts`'s `jsdoc` helper (which owns the `*`-prefixing and indentation),
+ * so this returns only the raw body — no comment delimiters, no padding.
+ */
+export function jsdocText(text, metadata) {
+    const lines = jsdocLines(text, metadata);
+    return lines.length === 0 ? undefined : lines.join('\n');
+}
+/**
+ * Build the body of a JSDoc block from a description and an optional metadata
+ * bag. Description lines come first (trimmed of leading/trailing blanks); then
+ * the metadata tag lines in a stable, source-driven order.
+ *
+ * Returns `[]` when there's nothing to render — callers use the empty result
+ * to skip emitting any JSDoc at all.
+ */
+function jsdocLines(text, metadata) {
+    const lines = [];
+    if (text && text.trim()) {
+        lines.push(...trimLines(splitLines(text)));
+    }
+    if (metadata) {
+        lines.push(...formatMetadata(metadata));
+    }
+    return lines;
+}
+/**
+ * Project a SchemaMetadata bag into JSDoc tag lines.
+ *
+ * Order matches the (near-)spec order so generated output is deterministic and
+ * diff-stable. `pattern` is escaped so an embedded `*​/` cannot terminate the
+ * surrounding JSDoc block.
+ */
+function formatMetadata(metadata) {
+    const lines = [];
+    const push = (tag, value) => {
+        if (value === undefined) {
+            lines.push(`@${tag}`);
+        }
+        else {
+            lines.push(`@${tag} ${value}`);
+        }
+    };
+    if (metadata.minimum !== undefined)
+        push('minimum', metadata.minimum);
+    if (metadata.maximum !== undefined)
+        push('maximum', metadata.maximum);
+    if (metadata.exclusiveMinimum !== undefined)
+        push('exclusiveMinimum', metadata.exclusiveMinimum);
+    if (metadata.exclusiveMaximum !== undefined)
+        push('exclusiveMaximum', metadata.exclusiveMaximum);
+    if (metadata.minLength !== undefined)
+        push('minLength', metadata.minLength);
+    if (metadata.maxLength !== undefined)
+        push('maxLength', metadata.maxLength);
+    if (metadata.pattern !== undefined)
+        push('pattern', escapeJsDoc(metadata.pattern));
+    if (metadata.minItems !== undefined)
+        push('minItems', metadata.minItems);
+    if (metadata.maxItems !== undefined)
+        push('maxItems', metadata.maxItems);
+    if (metadata.uniqueItems === true)
+        push('uniqueItems');
+    if (metadata.format !== undefined)
+        push('format', metadata.format);
+    if (metadata.deprecated === true)
+        push('deprecated');
+    return lines;
+}
+function trimLines(lines) {
+    let start = 0;
+    let end = lines.length;
+    while (start < end && lines[start] === '')
+        start++;
+    while (end > start && lines[end - 1] === '')
+        end--;
+    return lines.slice(start, end);
+}
+// ─── Casing and text support ───
+/**
+ * Upper-case the first character of an operation name. We don't normalize the
+ * rest because almost every spec uses camelCase or PascalCase, and names that
+ * contain digits or `_` are passed through unchanged — the user named them that
+ * way for a reason.
+ *
+ * `op.name` reaches here already sanitized into a non-empty, valid TS identifier
+ * by the IR builder (see `intermediate-representation/sanitize-identifiers.ts`), so no empty-string or
+ * unsafe-character guard is needed.
+ */
+export function pascalCase(name) {
+    return name[0].toUpperCase() + name.slice(1);
+}
+/**
+ * CamelCase property key for a response-header wire name (`Pagination-Total` →
+ * `paginationTotal`).
+ */
+export function headerPropertyKey(wireName) {
+    const camelCase = wireName
+        .split(/[-_]/)
+        .filter((part) => part.length > 0)
+        .map((part, index) => {
+        const lower = part.toLowerCase();
+        return index === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join('');
+    return sanitizeIdentifier(camelCase);
+}
+export function splitLines(text) {
+    return text
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map((line) => line.trimEnd());
+}
+//# sourceMappingURL=typescript.js.map