@redocly/client-generator 0.3.8 → 0.4.0

package/eject-assets/skills/transformers-generator/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: transformers-generator
+description: Design of the ejected Redocly `transformers` client generator. Read it, and update it, before changing generators/transformers/.
+---
+
+# The `transformers` generator — its skill
+
+This file is the DESIGN of your ejected `transformers` generator (`generators/transformers/`):
+**to change the generator, edit this skill first, then make the code match it** — a diff
+to `generators/transformers/` that has no covering sentence here is incomplete.
+
+## What it emits
+
+Per-schema `to<Name>()` / `from<Name>()` converters that turn wire JSON into typed
+values and back — the bridge for `dateType: Date` clients.
+
+## Design decisions that must hold
+
+- **Requires `dateType: Date`** (declared as `dateTypes: ['Date']`, so a mismatched
+  selection fails fast): the converters assign `Date` objects to fields the sdk types as
+  `Date`, which only type-checks in that mode.
+- **Imports the sdk's schema TYPES** (so `typescript` is required) and nothing else.
+- Converters are pure and total: every named schema gets a pair, nested structures
+  recurse, and a missing optional stays missing.
+
+## The stage files
+
+`render.ts` holds the whole converter renderer; `index.ts` is the entry. Naming comes
+from the TypeScript printer (`@redocly/client-generator/printers/typescript`).
+
+## Ejecting it
+
+`redocly eject-generator transformers` copies this generator's TypeScript source folder
+to `generators/transformers/`, exactly as we wrote it, importing
+`@redocly/client-generator` and `@redocly/client-generator/printers/typescript`. Running
+a `.ts` generator uses Node's type stripping (Node 22.18, 23.6, or newer); newer built-in
+versions merge in per file with `--update`. Change which fields are converted, or how,
+and regenerate.
+
+## The modify loop
+
+1. Edit this skill: state the new behavior or decision.
+2. Make `generators/transformers/` match it.
+3. Run `redocly generate-client` and inspect the `git diff` of the generated output —
+   generated files are never hand-edited.
+
+Newer built-in versions merge in with `redocly eject-generator transformers --update`.

package/eject-assets/skills/typescript-generator/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: typescript-generator
+description: Design of the ejected Redocly `typescript` client generator. Read it, and update it, before changing generators/typescript/.
+---
+
+# The `typescript` generator — its skill
+
+This file is the DESIGN of your ejected `typescript` generator (`generators/typescript/`):
+**to change the generator, edit this skill first, then make the code match it** — a diff
+to `generators/typescript/` that has no covering sentence here is incomplete.
+
+## What it emits
+
+The typed TypeScript client itself: model types with JSDoc, type guards, the `Ops`
+type map, the `OPERATIONS` descriptor table, a `client` instance, one binding per
+operation, and the runtime — embedded in the file (`runtime: inline`, the default) or
+written as real modules in a `runtime/` folder beside it that the client imports
+relatively (`runtime: module`).
+
+## Design decisions that must hold
+
+- **Descriptor-driven:** generated code is DATA (`OPERATIONS` + `Ops`) plus wiring;
+  request behavior lives in the runtime, never in per-operation code.
+  `satisfies Record<string, OperationDescriptor>` is the version-skew guard.
+- **`single` vs `split`:** split derives `<stem>.schemas.ts` (types, enums, guards) and
+  an entry that `export *`s it; the entry type-imports only the schema names it
+  references (`collectEntrySchemaRefs`).
+- **Zero runtime dependencies.** `Date`, `Blob`, `fetch` — nothing else.
+- **Names are collision-safe:** `packageIdents` seeds every reserved wiring name before
+  any operation is sanitized, so renames are deterministic (`configure` → `configure_2`).
+  A rename becomes part of the SDK's public API, so the warning must say WHICH cause it
+  is and what the publisher can do: a duplicate `operationId` in the description (fix the
+  description — the only real fix), a name that isn't a valid identifier, or a clash with
+  a name the generated module already declares. A vague "collides or is invalid" message
+  leaves the publisher unable to act.
+- **One operation, one function, one input shape.** The module-level names are bindings
+  of the client's own methods (`export const { getOrder } = client;`), never wrappers, so
+  `getOrder` and `client.getOrder` cannot disagree about their arguments. `argsStyle`
+  shapes the method itself: `grouped` (the default) namespaces the inputs by transport
+  layer — `path`, `query`, `headers`, `cookies`, `body` — and `flat` merges them into one
+  object, which the runtime converts back using the descriptor's own parameter list. An
+  operation whose merged names would collide keeps the grouped shape.
+- **Throw mode returns the body**; `{ envelope: true }` opts into
+  `{ data, headers, response }` with typed declared headers. Result mode returns
+  `{ data, error, response }` and ignores `envelope`.
+
+## The stage files
+
+One file per stage of the emit, same skeleton as the other generators:
+`types.ts` renders type text (`tsType`, JSDoc, the model type aliases);
+`operations.ts` the per-operation surface (the `Ops` map, the `<Op>*` aliases, the
+input shapes, `flatInputShape`);
+`descriptor.ts` the `OPERATIONS` wire table and the collision-safe `packageIdents`;
+`client.ts` the assembly (single/split entries, the runtime needs, the module-mode
+runtime files);
+`type-guards.ts`, `response-headers.ts`, `operation-types.ts`, `operation-signature.ts`
+the narrower questions their names state;
+`banner.ts` the generated-by header and title comment;
+`inline-runtime.ts` the runtime assembly for both modes. The runtime's real sources ship
+inside the package and reach the generator through
+`@redocly/client-generator/runtime-sources` (in this repo they live in `runtime/` beside
+these files). Naming and string escaping live in the TypeScript printer
+(`@redocly/client-generator/printers/typescript`).
+
+## Ejecting it
+
+`redocly eject-generator typescript` copies this generator's TypeScript source folder to
+`generators/typescript/` — the stage files above, exactly as we wrote them. Imports stay
+package specifiers: `@redocly/client-generator` (the toolkit and IR types),
+`@redocly/client-generator/printers/typescript` (naming and text mechanics), and
+`@redocly/client-generator/runtime-sources` (the runtime sources it embeds). Running a
+`.ts` generator uses Node's own type stripping (Node 22.18, 23.6, or newer), and newer
+built-in versions merge into your copy per file with
+`redocly eject-generator typescript --update`.
+
+It is the largest of them, so reach for the smaller paths first when they fit:
+`client.setup` bakes publisher defaults into the generated client, and middleware or
+`configure()` change behavior at run time rather than generation time.
+
+- **It documents itself.** With `client.docs` (or `--docs`), the `docs` hook writes
+  `<stem>.typescript.md`: the security schemes, then one section per operation with its parameters,
+  body, response type, and behavior notes. The call snippets come from this generator's own
+  `sample` hook, so the page can only show the syntax of the SDK beside it, and the layout
+  comes from `renderReferencePage` in the authoring toolkit — reachable from an ejected copy
+  through `@redocly/client-generator`. Pagination on the page is decided by
+  `paginationRuleFor`, the same helper this generator resolves pagination with.
+
+## The modify loop
+
+1. Edit this skill: state the new behavior or decision.
+2. Make `generators/typescript/` match it.
+3. Run `redocly generate-client` and inspect the `git diff` of the generated output —
+   generated files are never hand-edited.
+
+Newer built-in versions merge in with `redocly eject-generator typescript --update`.

package/eject-assets/skills/zod-generator/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: zod-generator
+description: Design of the ejected Redocly `zod` client generator. Read it, and update it, before changing generators/zod/.
+---
+
+# The `zod` generator — its skill
+
+This file is the DESIGN of your ejected `zod` generator (`generators/zod/`):
+**to change the generator, edit this skill first, then make the code match it** — a diff
+to `generators/zod/` that has no covering sentence here is incomplete.
+
+## What it emits
+
+A standalone `<stem>.zod.ts`: one `export const <Name>Schema` per named IR schema, the
+`operationSchemas` request/response map, and a `zodValidation()` middleware.
+
+## Design decisions that must hold
+
+- **The client stays dependency-free.** zod is the CONSUMER's peer dependency; the
+  generated client never imports this module, and this module never imports the client.
+- **Output-mode-agnostic:** one module beside the client whatever the sdk's layout.
+- **Emits nothing** when the model has neither named schemas nor JSON operation bodies —
+  an empty file is worse than no file.
+- Validation is opt-in at runtime (`use(zodValidation())`), never automatic.
+- **Only ERASABLE TypeScript.** The module must run under `node --experimental-strip-types`
+  with no build step, so nothing that needs a transform is emitted: no `enum`, no
+  `namespace`, and no constructor parameter properties. `ZodValidationError` therefore
+  declares its fields and assigns them in the constructor body — `constructor(readonly
+operationId: string)` fails strip-only mode, which is how the generated CLI broke when it
+  imported this module.
+
+## The stage files
+
+`schemas.ts` holds the whole renderer — schema expressions, the `operationSchemas` map,
+and the module assembly; `index.ts` is the entry. Naming and literal escaping come from
+the TypeScript printer (`@redocly/client-generator/printers/typescript`).
+
+## Ejecting it
+
+`redocly eject-generator zod` copies this generator's TypeScript source folder to
+`generators/zod/`, exactly as we wrote it, importing `@redocly/client-generator` and
+`@redocly/client-generator/printers/typescript`. Running a `.ts` generator uses Node's
+type stripping (Node 22.18, 23.6, or newer); newer built-in versions merge in per file
+with `--update`. Change the schema shapes, the naming, or what gets a schema at all, and
+regenerate.
+
+## The modify loop
+
+1. Edit this skill: state the new behavior or decision.
+2. Make `generators/zod/` match it.
+3. Run `redocly generate-client` and inspect the `git diff` of the generated output —
+   generated files are never hand-edited.
+
+Newer built-in versions merge in with `redocly eject-generator zod --update`.

package/lib/authoring/index.d.ts

@@ -0,0 +1,11 @@
+export { NotSupportedError } from '../errors.js';
+export { Printer } from './printer.js';
+export type { DateType } from './options.js';
+export { casing, identifierFor, RESERVED_WORDS, uniqueIdentifiers } from './naming.js';
+export { paginationRuleFor, type NeutralPaginationRule } from './pagination.js';
+export { renderReferencePage, type ReferenceLanguage, type ReferencePageOptions, } from './reference-page.js';
+export { isMultipartBody, jsonSuccessSchema, paginationItemSchema, securityRequirements, serverUrlParts, sseResponse, type SecurityRequirement, type ServerUrlPart, } from './operation.js';
+export { deref, discriminatorCases, docText, enumValues, flattenAllOf, headerCoerceType, isNullable, schemaAtPointer, unwrapNullable, } from './schema.js';
+/** Every value exported above — the skill's helper table and Tier-2 telemetry key off this. */
+export declare const AUTHORING_HELPER_NAMES: readonly ["Printer", "casing", "identifierFor", "uniqueIdentifiers", "RESERVED_WORDS", "flattenAllOf", "deref", "discriminatorCases", "jsonSuccessSchema", "sseResponse", "isMultipartBody", "serverUrlParts", "securityRequirements", "paginationItemSchema", "isNullable", "unwrapNullable", "enumValues", "docText", "headerCoerceType", "schemaAtPointer", "paginationRuleFor", "renderReferencePage", "NotSupportedError"];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGhF,OAAO,EACL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,iaAwBzB,CAAC"}

package/lib/authoring/index.js

@@ -0,0 +1,42 @@
+// The language-neutral authoring toolkit barrel. Pure functions over the IR —
+// no typescript, no @redocly/openapi-core, no Node builtins — so it is exported
+// from the package ROOT: a custom generator importing only these stays TS-free.
+// A generator rejects an option it can't honor by throwing this — the CLI prints its
+// message as a user error instead of an unexpected crash. Part of the authoring surface
+// because an ejected generator only imports from this barrel.
+export { NotSupportedError } from '../errors.js';
+export { Printer } from './printer.js';
+export { casing, identifierFor, RESERVED_WORDS, uniqueIdentifiers } from './naming.js';
+export { paginationRuleFor } from './pagination.js';
+// The Markdown reference page a generator's `docs` hook returns. Here rather than in the
+// emitters, so a generator ejected as source reaches it through the package like we do.
+export { renderReferencePage, } from './reference-page.js';
+export { isMultipartBody, jsonSuccessSchema, paginationItemSchema, securityRequirements, serverUrlParts, sseResponse, } from './operation.js';
+export { deref, discriminatorCases, docText, enumValues, flattenAllOf, headerCoerceType, isNullable, schemaAtPointer, unwrapNullable, } from './schema.js';
+/** Every value exported above — the skill's helper table and Tier-2 telemetry key off this. */
+export const AUTHORING_HELPER_NAMES = [
+    'Printer',
+    'casing',
+    'identifierFor',
+    'uniqueIdentifiers',
+    'RESERVED_WORDS',
+    'flattenAllOf',
+    'deref',
+    'discriminatorCases',
+    'jsonSuccessSchema',
+    'sseResponse',
+    'isMultipartBody',
+    'serverUrlParts',
+    'securityRequirements',
+    'paginationItemSchema',
+    'isNullable',
+    'unwrapNullable',
+    'enumValues',
+    'docText',
+    'headerCoerceType',
+    'schemaAtPointer',
+    'paginationRuleFor',
+    'renderReferencePage',
+    'NotSupportedError',
+];
+//# sourceMappingURL=index.js.map

package/lib/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,gFAAgF;AAEhF,qFAAqF;AACrF,wFAAwF;AACxF,8DAA8D;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAA8B,MAAM,iBAAiB,CAAC;AAChF,yFAAyF;AACzF,wFAAwF;AACxF,OAAO,EACL,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS;IACT,QAAQ;IACR,eAAe;IACf,mBAAmB;IACnB,gBAAgB;IAChB,cAAc;IACd,OAAO;IACP,oBAAoB;IACpB,mBAAmB;IACnB,aAAa;IACb,iBAAiB;IACjB,gBAAgB;IAChB,sBAAsB;IACtB,sBAAsB;IACtB,YAAY;IACZ,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;CACX,CAAC"}

package/lib/authoring/naming.d.ts

@@ -0,0 +1,34 @@
+export declare const casing: {
+    camel: (name: string) => string;
+    pascal: (name: string) => string;
+    snake: (name: string) => string;
+    screaming: (name: string) => string;
+};
+/** Keyword sets for the first-party target languages; authors pass their own set for others. */
+export declare const RESERVED_WORDS: Record<'typescript' | 'python' | 'go' | 'php', ReadonlySet<string>>;
+/**
+ * A safe identifier for any C-like or snake-case language: applies the casing
+ * style (which strips invalid characters), prefixes `_` when the result starts
+ * with a digit, and suffixes `_` when it is a reserved word — the cross-language
+ * convention (Python's `class_`, Go's `type_`).
+ */
+export declare function identifierFor(name: string, options?: {
+    style?: keyof typeof casing;
+    reserved?: ReadonlySet<string>;
+}): string;
+/**
+ * `identifierFor` over a list of wire names, made unique among themselves and among the
+ * names already `taken` — `id`, `id_2`, `id_3`, … A language that passes parameters as
+ * separate arguments needs this: OpenAPI lets one name appear in two locations (`id` in the
+ * path AND in the query), and a signature cannot declare that name twice. Seed `taken` with
+ * the argument slots the method itself declares (a body, a headers bag, a timeout), so a
+ * parameter named after one of them moves aside instead of shadowing it.
+ *
+ * The wire name is untouched: only the binding moves, so the request is unchanged.
+ */
+export declare function uniqueIdentifiers(names: readonly string[], options?: {
+    style?: keyof typeof casing;
+    reserved?: ReadonlySet<string>;
+    taken?: Iterable<string>;
+}): string[];
+//# sourceMappingURL=naming.d.ts.map

package/lib/authoring/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/authoring/naming.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,MAAM;kBACH,MAAM,KAAG,MAAM;mBAId,MAAM,KAAG,MAAM;kBAChB,MAAM,KAAG,MAAM;sBACX,MAAM,KAAG,MAAM;CAClC,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAoC9F,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,OAAO,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAO,GAC5E,MAAM,CAIR;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,OAAO,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrB,GACL,MAAM,EAAE,CAYV"}

package/lib/authoring/naming.js

@@ -0,0 +1,104 @@
+// Language-neutral naming: one word splitter, four casings, and an identifier
+// sanitizer parameterized by the target language's reserved words. TypeScript
+// keeps its specialized sanitizer in the TypeScript printer; this is for the
+// other output languages.
+/** Split on delimiters and camel/acronym boundaries: 'APIKey-v2' → ['api', 'key', 'v2']. */
+function splitWords(name) {
+    return (name
+        // A leading sign on a number is meaning, not a delimiter: '+1'/'-1' (GitHub
+        // reactions) must not collapse to the same identifier.
+        .replace(/^\+(?=\d)/, 'plus ')
+        .replace(/^-(?=\d)/, 'minus ')
+        // A plural acronym is one word: fold the trailing 's' in so the
+        // acronym-boundary rule below doesn't split 'APIs' into 'AP Is'.
+        .replace(/([A-Z]{2,})s(?![a-z])/g, '$1S')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .split(/[^A-Za-z0-9]+/)
+        .filter((word) => word !== '')
+        .map((word) => word.toLowerCase()));
+}
+const capitalize = (word) => word.charAt(0).toUpperCase() + word.slice(1);
+export const casing = {
+    camel: (name) => {
+        const [first, ...rest] = splitWords(name);
+        return (first ?? '') + rest.map(capitalize).join('');
+    },
+    pascal: (name) => splitWords(name).map(capitalize).join(''),
+    snake: (name) => splitWords(name).join('_'),
+    screaming: (name) => splitWords(name).join('_').toUpperCase(),
+};
+/** Keyword sets for the first-party target languages; authors pass their own set for others. */
+export const RESERVED_WORDS = {
+    // prettier-ignore
+    typescript: new Set([
+        'break', 'case', 'catch', 'class', 'const', 'continue', 'debugger', 'default', 'delete',
+        'do', 'else', 'enum', 'export', 'extends', 'false', 'finally', 'for', 'function', 'if',
+        'import', 'in', 'instanceof', 'new', 'null', 'return', 'super', 'switch', 'this', 'throw',
+        'true', 'try', 'typeof', 'var', 'void', 'while', 'with', 'implements', 'interface', 'let',
+        'package', 'private', 'protected', 'public', 'static', 'yield', 'await',
+    ]),
+    // prettier-ignore
+    python: new Set([
+        'false', 'none', 'true', 'and', 'as', 'assert', 'async', 'await', 'break', 'class',
+        'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global',
+        'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return',
+        'try', 'while', 'with', 'yield', 'match', 'case', 'type',
+    ]),
+    // prettier-ignore
+    go: new Set([
+        'break', 'case', 'chan', 'const', 'continue', 'default', 'defer', 'else', 'fallthrough',
+        'for', 'func', 'go', 'goto', 'if', 'import', 'interface', 'map', 'package', 'range',
+        'return', 'select', 'struct', 'switch', 'type', 'var',
+    ]),
+    // PHP keywords + compile-time constants are case-insensitive; the set stays lowercase
+    // because `identifierFor` matches on the lowercased candidate.
+    // prettier-ignore
+    php: new Set([
+        'abstract', 'and', 'array', 'as', 'break', 'callable', 'case', 'catch', 'class', 'clone',
+        'const', 'continue', 'declare', 'default', 'die', 'do', 'echo', 'else', 'elseif', 'empty',
+        'enddeclare', 'endfor', 'endforeach', 'endif', 'endswitch', 'endwhile', 'enum', 'eval',
+        'exit', 'extends', 'final', 'finally', 'fn', 'for', 'foreach', 'function', 'global', 'goto',
+        'if', 'implements', 'include', 'instanceof', 'insteadof', 'interface', 'isset', 'list',
+        'match', 'namespace', 'new', 'or', 'print', 'private', 'protected', 'public', 'readonly',
+        'require', 'return', 'static', 'switch', 'throw', 'trait', 'try', 'unset', 'use', 'var',
+        'while', 'xor', 'yield', 'true', 'false', 'null', 'int', 'float', 'bool', 'string', 'void',
+        'iterable', 'object', 'mixed', 'never', 'self', 'parent',
+    ]),
+};
+/**
+ * A safe identifier for any C-like or snake-case language: applies the casing
+ * style (which strips invalid characters), prefixes `_` when the result starts
+ * with a digit, and suffixes `_` when it is a reserved word — the cross-language
+ * convention (Python's `class_`, Go's `type_`).
+ */
+export function identifierFor(name, options = {}) {
+    const styled = casing[options.style ?? 'camel'](name);
+    const base = styled === '' ? '_' : /^[0-9]/.test(styled) ? `_${styled}` : styled;
+    return options.reserved?.has(base.toLowerCase()) ? `${base}_` : base;
+}
+/**
+ * `identifierFor` over a list of wire names, made unique among themselves and among the
+ * names already `taken` — `id`, `id_2`, `id_3`, … A language that passes parameters as
+ * separate arguments needs this: OpenAPI lets one name appear in two locations (`id` in the
+ * path AND in the query), and a signature cannot declare that name twice. Seed `taken` with
+ * the argument slots the method itself declares (a body, a headers bag, a timeout), so a
+ * parameter named after one of them moves aside instead of shadowing it.
+ *
+ * The wire name is untouched: only the binding moves, so the request is unchanged.
+ */
+export function uniqueIdentifiers(names, options = {}) {
+    const used = new Set(options.taken ?? []);
+    // The separator follows the casing style, so the result stays idiomatic: `order_id_2` in
+    // snake-case languages, `orderId2` where names run together.
+    const separator = options.style === 'snake' || options.style === 'screaming' ? '_' : '';
+    return names.map((name) => {
+        const base = identifierFor(name, options);
+        let unique = base;
+        for (let suffix = 2; used.has(unique); suffix++)
+            unique = `${base}${separator}${suffix}`;
+        used.add(unique);
+        return unique;
+    });
+}
+//# sourceMappingURL=naming.js.map

package/lib/authoring/naming.js.map

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

package/lib/authoring/operation.d.ts

@@ -0,0 +1,47 @@
+import type { ApiModel, OperationModel, ResponseBodyModel, SchemaModel, ServerModel } from '../intermediate-representation/model.js';
+/** The schema of the operation's primary JSON success response, if it has one. */
+export declare function jsonSuccessSchema(op: OperationModel): SchemaModel | undefined;
+/** The `text/event-stream` success response — present exactly when the operation streams. */
+export declare function sseResponse(op: OperationModel): ResponseBodyModel | undefined;
+/** Whether the request body is multipart (any `multipart/*` content type). */
+export declare function isMultipartBody(op: OperationModel): boolean;
+/** One piece of a parsed server-URL template: literal text, or a declared variable's name. */
+export type ServerUrlPart = {
+    kind: 'literal';
+    value: string;
+} | {
+    kind: 'variable';
+    name: string;
+};
+/**
+ * A server's URL template as parts a generator concatenates in its own syntax:
+ * `https://{region}.api.example.com/v1` → literal, variable `region`, literal. A variable
+ * the server does not declare has nothing to substitute, so its placeholder stays literal
+ * text and remains visible in the generated code.
+ */
+export declare function serverUrlParts(server: ServerModel): ServerUrlPart[];
+/** One resolved security requirement: the scheme's key, kind, and (for apiKey) placement. */
+export type SecurityRequirement = {
+    scheme: string;
+    kind: 'bearer' | 'basic';
+} | {
+    scheme: string;
+    kind: 'apiKey';
+    name: string;
+    in: 'header' | 'query' | 'cookie';
+};
+/**
+ * The operation's security as OR-alternatives of AND-sets, denormalized against the
+ * declared schemes — the shape every generated runtime's auth resolver consumes. A key that
+ * names no declared scheme is dropped, and an alternative that ends up empty with it.
+ * Generators print this in their own literal syntax; the mapping itself has one answer.
+ */
+export declare function securityRequirements(op: OperationModel, model: Pick<ApiModel, 'securitySchemes'>): SecurityRequirement[][];
+/**
+ * The element type of a paginated operation's items: resolve the rule's `items` pointer to
+ * the items ARRAY, then take its raw element — a `ref` element keeps its class name (a
+ * deref'd result would hydrate as plain data). Undefined when the pointer misses or the
+ * target is not an array.
+ */
+export declare function paginationItemSchema(pageSchema: SchemaModel | undefined, itemsPointer: string | undefined, model: ApiModel): SchemaModel | undefined;
+//# sourceMappingURL=operation.d.ts.map

package/lib/authoring/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/authoring/operation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,WAAW,EACZ,MAAM,yCAAyC,CAAC;AAGjD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,CAG7E;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAI7E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAE3D;AAED,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,CAoBnE;AAED,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;CAAE,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,GACvC,mBAAmB,EAAE,EAAE,CAmBzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,EAAE,QAAQ,GACd,WAAW,GAAG,SAAS,CAIzB"}

package/lib/authoring/operation.js

@@ -0,0 +1,86 @@
+// Language-neutral operation-shape helpers: the questions every generator asks of an
+// operation before deciding what to emit — which response is the JSON success, whether it
+// streams, whether the body is multipart. One answer each, so two generators cannot
+// disagree about the same operation.
+import { schemaAtPointer } from './schema.js';
+/** The schema of the operation's primary JSON success response, if it has one. */
+export function jsonSuccessSchema(op) {
+    return op.successResponses.find((response) => response.contentType.toLowerCase().includes('json'))
+        ?.schema;
+}
+/** The `text/event-stream` success response — present exactly when the operation streams. */
+export function sseResponse(op) {
+    return op.successResponses.find((response) => response.contentType.toLowerCase().includes('text/event-stream'));
+}
+/** Whether the request body is multipart (any `multipart/*` content type). */
+export function isMultipartBody(op) {
+    return op.requestBody?.contentType.toLowerCase().includes('multipart') ?? false;
+}
+/**
+ * A server's URL template as parts a generator concatenates in its own syntax:
+ * `https://{region}.api.example.com/v1` → literal, variable `region`, literal. A variable
+ * the server does not declare has nothing to substitute, so its placeholder stays literal
+ * text and remains visible in the generated code.
+ */
+export function serverUrlParts(server) {
+    const declared = new Set(server.variables.map((variable) => variable.name));
+    const parts = [];
+    let literal = '';
+    let rest = server.url;
+    const template = /\{([^{}]+)\}/;
+    for (let match = template.exec(rest); match !== null; match = template.exec(rest)) {
+        literal += rest.slice(0, match.index);
+        if (declared.has(match[1])) {
+            if (literal !== '')
+                parts.push({ kind: 'literal', value: literal });
+            literal = '';
+            parts.push({ kind: 'variable', name: match[1] });
+        }
+        else {
+            literal += match[0];
+        }
+        rest = rest.slice(match.index + match[0].length);
+    }
+    literal += rest;
+    if (literal !== '' || parts.length === 0)
+        parts.push({ kind: 'literal', value: literal });
+    return parts;
+}
+/**
+ * The operation's security as OR-alternatives of AND-sets, denormalized against the
+ * declared schemes — the shape every generated runtime's auth resolver consumes. A key that
+ * names no declared scheme is dropped, and an alternative that ends up empty with it.
+ * Generators print this in their own literal syntax; the mapping itself has one answer.
+ */
+export function securityRequirements(op, model) {
+    return op.security
+        .map((alternative) => alternative.flatMap((key) => {
+        const scheme = model.securitySchemes.find((candidate) => candidate.key === key);
+        if (scheme === undefined)
+            return [];
+        if (scheme.kind === 'bearer' || scheme.kind === 'basic') {
+            return [{ scheme: key, kind: scheme.kind }];
+        }
+        if (scheme.kind === 'apiKeyHeader') {
+            return [{ scheme: key, kind: 'apiKey', name: scheme.headerName, in: 'header' }];
+        }
+        if (scheme.kind === 'apiKeyQuery') {
+            return [{ scheme: key, kind: 'apiKey', name: scheme.paramName, in: 'query' }];
+        }
+        return [{ scheme: key, kind: 'apiKey', name: scheme.cookieName, in: 'cookie' }];
+    }))
+        .filter((alternative) => alternative.length > 0);
+}
+/**
+ * The element type of a paginated operation's items: resolve the rule's `items` pointer to
+ * the items ARRAY, then take its raw element — a `ref` element keeps its class name (a
+ * deref'd result would hydrate as plain data). Undefined when the pointer misses or the
+ * target is not an array.
+ */
+export function paginationItemSchema(pageSchema, itemsPointer, model) {
+    if (pageSchema === undefined || itemsPointer === undefined)
+        return undefined;
+    const itemsArray = schemaAtPointer(pageSchema, itemsPointer, model);
+    return itemsArray?.kind === 'array' ? itemsArray.items : undefined;
+}
+//# sourceMappingURL=operation.js.map

package/lib/authoring/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/authoring/operation.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,0FAA0F;AAC1F,oFAAoF;AACpF,qCAAqC;AASrC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,EAAkB;IAClD,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChG,EAAE,MAAM,CAAC;AACb,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,EAAkB;IAC5C,OAAO,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3C,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CACjE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,EAAkB;IAChD,OAAO,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;AAClF,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;IACtB,MAAM,QAAQ,GAAG,cAAc,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACpE,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,OAAO,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1F,OAAO,KAAK,CAAC;AACf,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAkB,EAClB,KAAwC;IAExC,OAAO,EAAE,CAAC,QAAQ;SACf,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACnB,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAyB,EAAE;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAChF,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACxD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CACH;SACA,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAmC,EACnC,YAAgC,EAChC,KAAe;IAEf,IAAI,UAAU,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO,UAAU,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC"}

package/lib/authoring/options.d.ts

@@ -0,0 +1,9 @@
+/**
+ * How `format: date-time`/`date` string fields are typed:
+ * - `'string'` (default): the wire shape — an ISO string.
+ * - `'Date'`: the target language's date object (`Date` in TypeScript, `datetime`
+ *   in Python, `time.Time` in Go, `DateTimeImmutable` in PHP). The generated
+ *   client converts on the wire boundary, so the values match the types.
+ */
+export type DateType = 'string' | 'Date';
+//# sourceMappingURL=options.d.ts.map

package/lib/authoring/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/authoring/options.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC"}

package/lib/authoring/options.js

@@ -0,0 +1,5 @@
+// Neutral option types every generator (any output language) may need to honor.
+// They live in the authoring toolkit — not the TypeScript emitters — so a language
+// generator can type its plumbing without importing TS-specific modules.
+export {};
+//# sourceMappingURL=options.js.map

package/lib/authoring/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/authoring/options.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,yEAAyE"}

package/lib/authoring/pagination.d.ts

@@ -0,0 +1,19 @@
+import type { OperationModel } from '../intermediate-representation/model.js';
+/** The normalized rule a generator renders into its runtime's pagination spec. */
+export type NeutralPaginationRule = {
+    style: string;
+    /** The advance query parameter (cursor/offset/page styles). */
+    param?: string;
+    nextCursor?: string;
+    hasMore?: string;
+    limitParam?: string;
+    items?: string;
+};
+/**
+ * Pagination for one operation. The convention rule applies only where it structurally
+ * fits — the advance parameter exists on the operation, or for `link` (which has no
+ * parameter) the success response documents a `Link` header; `exclude` kills every source.
+ * Returns undefined when the operation does not paginate.
+ */
+export declare function paginationRuleFor(op: OperationModel, config: Record<string, unknown> | undefined): NeutralPaginationRule | undefined;
+//# sourceMappingURL=pagination.d.ts.map

package/lib/authoring/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/authoring/pagination.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,qBAAqB,GAAG,SAAS,CAgCnC"}