@redocly/client-generator 0.3.7 → 0.4.0

package/lib/pagination.js.map

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

package/lib/pipeline.d.ts

@@ -0,0 +1,17 @@
+import type { EmitOptions, GeneratedFile, GeneratorDescriptor, OutputMode } from './generators/types.js';
+import { type ApiModel } from './intermediate-representation/model.js';
+import { type ModelPagination } from './pagination.js';
+import type { GenerateClientOptions, GenerateClientResult } from './types.js';
+export declare function runGenerators(model: ApiModel, options: {
+    outputPath: string;
+    outputMode: OutputMode;
+    emit: EmitOptions;
+    /** Pagination resolved once for the whole run (see `GeneratorInput.pagination`). */
+    pagination?: ModelPagination;
+    generators: string[];
+    registry: Map<string, GeneratorDescriptor>;
+    /** Per-generator options, already validated (see `resolveGeneratorOptions`). */
+    generatorOptions?: Map<string, Record<string, unknown>>;
+}): GeneratedFile[];
+export declare function generateClient(options: GenerateClientOptions): Promise<GenerateClientResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/lib/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAEV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,UAAU,EACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAGtF,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAc9E,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD,GACA,aAAa,EAAE,CAuEjB;AAoED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA0G/B"}

package/lib/pipeline.js

@@ -0,0 +1,244 @@
+// The generation pipeline: loadSpec → IR → resolve generators → run → write.
+// This module must stay free of static `typescript` imports (pinned by
+// pipeline-ts-free.test.ts): built-in generators load lazily through
+// generators/meta.js, and the TS-specific setup baking loads on demand — so a
+// run selecting only non-TypeScript generators never loads the `typescript`
+// package. The `/generate` entry re-exports `generateClient` from here and
+// layers the sync TS toolkit on top.
+import { logger, stringifyYaml } from '@redocly/openapi-core';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, parse, resolve, sep } from 'node:path';
+import { NotSupportedError } from './errors.js';
+import { validateSelection } from './generators/meta.js';
+import { resolveGeneratorOptions } from './generators/options.js';
+import { resolveGenerators } from './generators/resolve.js';
+import { buildApiModel } from './intermediate-representation/build.js';
+import { allOperations } from './intermediate-representation/model.js';
+import { normalizeSwagger2 } from './intermediate-representation/normalize-swagger2.js';
+import { loadSpec } from './loader.js';
+import { resolveModelPagination } from './pagination.js';
+/**
+ * Run each generator of a fully-loaded registry against the IR and concatenate
+ * their files. Throws on a duplicate output path so two generators can't
+ * silently clobber each other. Validation is the caller's job (`validateSelection`).
+ */
+// The generated-by banner, comment-marker-free — each generator prepends it in its own
+// comment syntax (the TypeScript family's HEADER renders these same lines with `//`).
+const BANNER_LINES = [
+    'Generated by @redocly/client-generator — do not edit by hand.',
+    'Source: OpenAPI description. Re-run `redocly generate-client` to update.',
+];
+export function runGenerators(model, options) {
+    const files = [];
+    const seen = new Set();
+    // Every emitted path must stay under the --output directory: generator modules are
+    // user-chosen code, but a stray `../` or absolute path must not write elsewhere.
+    const outputRoot = resolve(dirname(options.outputPath));
+    const { dir, name: stem, ext } = parse(options.outputPath);
+    const output = { path: options.outputPath, dir, stem, ext };
+    const banner = BANNER_LINES;
+    let documented = false;
+    for (const name of options.generators) {
+        const generator = options.registry.get(name);
+        const input = {
+            model,
+            output,
+            banner,
+            outputMode: options.outputMode,
+            emit: options.emit,
+            pagination: options.pagination,
+            selected: options.generators,
+            options: options.generatorOptions?.get(name) ?? {},
+        };
+        let generated;
+        try {
+            // `docs` documents what `run` emits, so both run behind the same name and their
+            // files land together. A generator without a `docs` hook simply has no page.
+            if (options.emit.docs === true && generator.docs !== undefined) {
+                generated = [...generator.run(input), ...generator.docs(input)];
+                documented = true;
+            }
+            else {
+                generated = generator.run(input);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Generator "${name}" failed: ${message}`);
+        }
+        if (!Array.isArray(generated) ||
+            generated.some((file) => typeof file?.path !== 'string' || file.path === '' || typeof file.content !== 'string')) {
+            throw new Error(`Generator "${name}" failed: run() must return an array of { path, content } files.`);
+        }
+        for (const file of generated) {
+            const resolved = resolve(outputRoot, file.path);
+            if (resolved !== outputRoot && !resolved.startsWith(outputRoot + sep)) {
+                throw new Error(`Generator "${name}" failed: file path escapes the output directory: ${file.path}`);
+            }
+            if (seen.has(resolved)) {
+                throw new Error(`Generator conflict: ${file.path} already emitted by an earlier generator`);
+            }
+            seen.add(resolved);
+            // Carry the resolved path forward so the write goes where the guard looked —
+            // a relative `file.path` would otherwise resolve against the cwd at write time.
+            files.push({ path: resolved, content: file.content });
+        }
+    }
+    // Asking for documentation and getting none is worth saying: `zod` and the framework
+    // wrappers document nothing, so a selection of only those writes no page.
+    if (options.emit.docs === true && !documented) {
+        logger.warn(`generate-client: docs is on, but no selected generator writes documentation (${options.generators.join(', ')}).\n`);
+    }
+    return files;
+}
+/**
+ * A parameter name used in two locations of one operation — `id` in the path AND in the
+ * query, which OpenAPI permits. Every SDK still sends both, under their own wire names, but
+ * the languages that pass parameters as separate arguments have to rename the second one, so
+ * the publisher should hear about it once and can rename it in the description instead.
+ */
+function warnRepeatedParamNames(model) {
+    for (const service of model.services) {
+        for (const op of service.operations) {
+            const seen = new Set();
+            const repeated = new Set();
+            for (const param of [
+                ...op.pathParams,
+                ...op.queryParams,
+                ...op.headerParams,
+                ...op.cookieParams,
+            ]) {
+                if (seen.has(param.name))
+                    repeated.add(param.name);
+                seen.add(param.name);
+            }
+            if (repeated.size === 0)
+                continue;
+            logger.warn(`generate-client: operation "${op.specName ?? op.name}" uses ${[...repeated]
+                .map((name) => `"${name}"`)
+                .join(', ')} in more than one parameter location. Every SDK sends both, and the SDKs whose methods take one argument per parameter give the later one a suffixed name — rename it in the description to choose the name yourself.\n`);
+        }
+    }
+}
+/**
+ * An OpenAPI Overlay (1.0.0) adding per-operation `x-codeSamples`, collected from
+ * every selected generator that implements the `sample` hook; undefined when no
+ * generator contributed a sample. Docs tooling applies it to the description —
+ * generation stays side-effect-free on the source.
+ */
+function codeSamplesOverlay(model, emit, selected, registry, outputPath, pagination) {
+    const actions = [];
+    for (const op of allOperations(model.services)) {
+        const samples = selected
+            .map((name) => registry.get(name)?.sample?.(op, { model, emit, outputPath, pagination }))
+            .filter((sample) => sample !== undefined);
+        if (samples.length > 0) {
+            actions.push({
+                target: `$.paths['${op.path.replaceAll("'", "''")}'].${op.method}`,
+                update: { 'x-codeSamples': samples },
+            });
+        }
+    }
+    if (actions.length === 0)
+        return undefined;
+    return stringifyYaml({
+        overlay: '1.0.0',
+        info: { title: `Code samples for ${model.title}`, version: model.version },
+        actions,
+    });
+}
+export async function generateClient(options) {
+    // A path segment that is literally "undefined"/"null" is the telltale of an
+    // interpolation bug in the caller (`\`${dir}/client.ts\`` with `dir` unset) — reject
+    // it instead of silently creating an `undefined/` directory.
+    if (options.output.split(/[\\/]/).some((segment) => segment === 'undefined' || segment === 'null')) {
+        throw new Error(`output path "${options.output}" contains a literal "undefined" or "null" segment — this looks like an interpolation bug in the caller`);
+    }
+    // Setup is a LOCAL module (its code is baked into the generated client) — reject
+    // URL-ish specifiers upfront, before any spec loading, instead of failing later as
+    // an unreadable file path. Two+ letter scheme, so Windows drive paths don't match.
+    if (options.setup && /^[a-z][a-z0-9+.-]+:/i.test(options.setup)) {
+        throw new NotSupportedError(`setup must be a local file path — remote setup modules are not supported (got: ${options.setup})`);
+    }
+    const outputPath = resolve(options.output);
+    const { document, version } = await loadSpec(options.api, options.config);
+    const normalized = version === 'oas2'
+        ? // loadSpec types the parsed document as OAS3 for the common path; a detected
+            // swagger-2 document is re-viewed as raw data for normalization.
+            normalizeSwagger2(document)
+        : document;
+    const model = buildApiModel(normalized);
+    warnRepeatedParamNames(model);
+    // A publisher `--setup` module is read, validated, and transformed into the neutral setup
+    // expression baked into the client. Applied across all output modes by the emitter.
+    // Baking parses TypeScript, so the module loads only when setup is actually used.
+    let setupBlock;
+    if (options.setup) {
+        const { bakeSetup } = await import('./setup-bake.js');
+        // A relative setup path resolves against `configDir` (cwd when absent), like
+        // generator specifiers. The CLI pre-resolves its inputs, so they arrive absolute.
+        const setupPath = resolve(options.configDir ?? process.cwd(), options.setup);
+        setupBlock = bakeSetup(await readFile(setupPath, 'utf-8'));
+    }
+    // Resolve the selection into a registry: built-in names load lazily, inline
+    // `customGenerators` register, and any other entry is imported as a plugin
+    // specifier (path/package). An empty list (e.g. `generators: []` in config, or
+    // no `--generator` flags) means "unspecified" — fall back to the default
+    // typescript client rather than emitting nothing.
+    const requested = options.generators?.length ? options.generators : ['typescript'];
+    const { selected, registry } = await resolveGenerators(requested, {
+        customGenerators: options.customGenerators,
+        configDir: options.configDir,
+    });
+    // ONE pagination resolution for the run: fit-verified, pointers resolved, errors
+    // reported before any generator writes a file.
+    const pagination = resolveModelPagination(model, options.pagination);
+    const emit = {
+        serverUrl: options.serverUrl,
+        argsStyle: options.argsStyle,
+        errorMode: options.errorMode,
+        dateType: options.dateType,
+        mockData: options.mockData,
+        mockSeed: options.mockSeed,
+        queryKeyPrefix: options.queryKeyPrefix,
+        setup: setupBlock,
+        runtime: options.runtime,
+        importExt: options.importExt,
+        goPackage: options.goPackage,
+        pagination,
+        docs: options.docs,
+        docsFrontmatter: options.docsFrontmatter,
+    };
+    // Fail fast on an incompatible selection (missing prerequisite, unsupported
+    // error-mode/date-type/runtime) before producing any file, and warn about options a
+    // selected generator can't apply.
+    validateSelection(selected, emit, registry, options.outputMode);
+    const generatorOptions = resolveGeneratorOptions(selected, registry, options.options);
+    const files = runGenerators(model, {
+        outputPath,
+        outputMode: options.outputMode ?? 'single',
+        emit,
+        pagination,
+        generators: selected,
+        generatorOptions,
+        registry,
+    });
+    if (options.codeSamples === true) {
+        const overlay = codeSamplesOverlay(model, emit, selected, registry, outputPath, pagination);
+        if (overlay !== undefined) {
+            files.push({ path: outputPath.replace(/\.[^.]+$/, '.code-samples.yaml'), content: overlay });
+        }
+    }
+    const written = [];
+    for (const file of files) {
+        await mkdir(dirname(file.path), { recursive: true });
+        await writeFile(file.path, file.content, 'utf-8');
+        written.push({ path: file.path, bytes: Buffer.byteLength(file.content, 'utf-8') });
+    }
+    return {
+        outputPath,
+        bytes: written.reduce((sum, file) => sum + file.bytes, 0),
+        files: written,
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/lib/pipeline.js.map

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

package/lib/plugin.d.ts

@@ -1,4 +1,5 @@
 import type { CustomGenerator } from './generators/types.js';
+export { GENERATOR_VERSION } from './generators/compatibility.js';
 /**
  * Identity helper for authoring a custom generator with full type inference and one validation
  * choke-point. `export default defineGenerator({ name, run, … })`. Returns its argument unchanged.
@@ -6,8 +7,7 @@ import type { CustomGenerator } from './generators/types.js';
  * @experimental The plugin API may change between minor versions until stabilized.
  */
 export declare function defineGenerator(generator: CustomGenerator): CustomGenerator;
-export type { CustomGenerator, GeneratedFile, Generator, GeneratorInput, GeneratorName, OutputMode, } from './generators/types.js';
-export type { ArgsStyle, ErrorMode } from './emitters/operations.js';
-export type { DateType } from './emitters/types.js';
-export type { ApiModel, NamedSchemaModel, OperationModel, ParamModel, PropertyModel, RequestBodyModel, ResponseBodyModel, ScalarKind, SchemaMetadata, SchemaModel, ServiceModel, } from './intermediate-representation/model.js';
+export type { ArgsStyle, CodeSample, CustomGenerator, DateType, EmitOptions, ErrorMode, GeneratedFile, Generator, GeneratorInput, GeneratorName, GeneratorOptionsSchema, OutputAnchor, OutputMode, SampleContext, } from './generators/types.js';
+export { allOperations } from './intermediate-representation/model.js';
+export type { ApiModel, DiscriminatorModel, NamedSchemaModel, OperationModel, ParamModel, PropertyModel, RequestBodyModel, ResponseBodyModel, ResponseHeaderModel, ScalarKind, SchemaMetadata, SchemaModel, SecuritySchemeModel, ServerModel, ServiceModel, SseModel, } from './intermediate-representation/model.js';
 //# sourceMappingURL=plugin.d.ts.map

package/lib/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAE3E;AAGD,YAAY,EACV,eAAe,EACf,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAE3E;AAGD,YAAY,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,YAAY,EACV,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,wCAAwC,CAAC"}

package/lib/plugin.js

@@ -7,24 +7,25 @@
 // A custom generator is `(GeneratorInput) => GeneratedFile[]` plus a `name`; select it in
 // `generators` by name (inline via `customGenerators`) or by import specifier (path/package). It
 // receives the same spec-agnostic IR (`model`) the built-in generators consume, and may use the same
-// TypeScript-emitting toolkit re-exported below, so a plugin is a first-class peer of `sdk`/`zod`/…
+// TypeScript-emitting toolkit re-exported below, so a plugin is a first-class peer of `typescript`/`zod`/…
 // The generated client stays dependency-free: a plugin's output is its own file(s), and its runtime
 // libraries are peers of the consumer's app, never of the client.
 //
 //   // my-generator.ts
 //   import { defineGenerator } from '@redocly/client-generator';
-//   // AST toolkit, when string-building isn't enough:
-//   // import { ts, printStatements } from '@redocly/client-generator/generate';
+//   // TypeScript renderers, when a real type is needed rather than guessed text:
+//   // import { tsType } from '@redocly/client-generator/generate';
 //   export default defineGenerator({
 //     name: 'route-map',
-//     requires: ['sdk'],
-//     run({ model, outputPath }) {
+//     requires: ['typescript'],
+//     run({ model, output }) {
 //       const routes = model.services.flatMap((s) => s.operations)
 //         .map((op) => `  ${op.name}: '${op.method.toUpperCase()} ${op.path}',`).join('\n');
-//       return [{ path: outputPath.replace(/\.ts$/, '.routes.ts'),
+//       return [{ path: output.path.replace(/\.ts$/, '.routes.ts'),
 //                 content: `export const routes = {\n${routes}\n} as const;\n` }];
 //     },
 //   });
+export { GENERATOR_VERSION } from './generators/compatibility.js';
 /**
  * Identity helper for authoring a custom generator with full type inference and one validation
  * choke-point. `export default defineGenerator({ name, run, … })`. Returns its argument unchanged.
@@ -34,7 +35,9 @@
 export function defineGenerator(generator) {
     return generator;
 }
-// The TypeScript-emitting toolkit (`ts`, `printStatements`, `operationSignature`, …) is
-// exported from `@redocly/client-generator/generate` — it loads `typescript`, which the
-// runtime-only package root must not reach statically.
+// --- The intermediate representation (the `model` a generator walks) ---------------------------
+export { allOperations } from './intermediate-representation/model.js';
+// The TypeScript-emitting renderers (`tsType`, `operationSignature`, …) are exported from
+// `@redocly/client-generator/generate`, which also carries the generation entry point —
+// the package root stays a small authoring surface.
 //# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8CAA8C;AAC9C,EAAE;AACF,gGAAgG;AAChG,uFAAuF;AACvF,EAAE;AACF,0FAA0F;AAC1F,iGAAiG;AACjG,qGAAqG;AACrG,oGAAoG;AACpG,oGAAoG;AACpG,kEAAkE;AAClE,EAAE;AACF,uBAAuB;AACvB,iEAAiE;AACjE,uDAAuD;AACvD,iFAAiF;AACjF,qCAAqC;AACrC,yBAAyB;AACzB,yBAAyB;AACzB,mCAAmC;AACnC,mEAAmE;AACnE,6FAA6F;AAC7F,mEAAmE;AACnE,mFAAmF;AACnF,SAAS;AACT,QAAQ;AAIR;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAA0B;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AA6BD,wFAAwF;AACxF,wFAAwF;AACxF,uDAAuD"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8CAA8C;AAC9C,EAAE;AACF,gGAAgG;AAChG,uFAAuF;AACvF,EAAE;AACF,0FAA0F;AAC1F,iGAAiG;AACjG,qGAAqG;AACrG,2GAA2G;AAC3G,oGAAoG;AACpG,kEAAkE;AAClE,EAAE;AACF,uBAAuB;AACvB,iEAAiE;AACjE,kFAAkF;AAClF,oEAAoE;AACpE,qCAAqC;AACrC,yBAAyB;AACzB,gCAAgC;AAChC,+BAA+B;AAC/B,mEAAmE;AACnE,6FAA6F;AAC7F,oEAAoE;AACpE,mFAAmF;AACnF,SAAS;AACT,QAAQ;AAIR,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAA0B;IACxD,OAAO,SAAS,CAAC;AACnB,CAAC;AAoBD,kGAAkG;AAClG,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAoBvE,0FAA0F;AAC1F,wFAAwF;AACxF,oDAAoD"}

package/lib/printers/go.d.ts

@@ -0,0 +1,33 @@
+import { Printer } from '../authoring/printer.js';
+export declare class GoPrinter extends Printer {
+    constructor();
+    /** An exported type name: PascalCase, with the digit-leading `N` rule. */
+    typeName(name: string): string;
+    /** An exported field/method name — same rule as `typeName`; Go has one namespace. */
+    memberName(name: string): string;
+    /** A local/argument name: camelCase, keyword-safe. */
+    identifier(name: string): string;
+    /** Exported names made unique among themselves and the caller's taken set (`Id`, `Id2`). */
+    identifiers(names: readonly string[], taken?: Iterable<string>): string[];
+    /** A package clause name: lower-case letters and digits only, never empty. */
+    packageName(name: string): string;
+    /**
+     * A double-quoted Go string literal for any spec-supplied text. Controls are escaped;
+     * a lone surrogate (a JS string can carry one) has no Go spelling — `\uD800` is an
+     * invalid code point to the compiler — so it becomes U+FFFD; everything else,
+     * non-ASCII included, is written as itself, because generated files are UTF-8.
+     */
+    string(value: string): string;
+    /** JSON-ish data as a Go expression (`map[string]any` / `[]any` composites). */
+    literal(value: unknown): string;
+    /** A `//` line comment. */
+    comment(text: string): this;
+    /** A doc comment: `// Name — summary`, blank lines collapsed the way gofmt rewrites them. */
+    doc(name: string, description?: string): this;
+    /** gofmt-clean text: column alignment plus the whitespace shape gofmt produces. */
+    layout(source: string): string;
+    toString(): string;
+}
+/** An exported Go identifier: PascalCase, digit-leading names get `N` (never `_`). */
+export declare function exported(name: string): string;
+//# sourceMappingURL=go.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../src/printers/go.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKlD,qBAAa,SAAU,SAAQ,OAAO;;IAKpC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,qFAAqF;IACrF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,sDAAsD;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC,4FAA4F;IAC5F,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAWzE,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAgB7B,gFAAgF;IAChF,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAa/B,2BAA2B;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,6FAA6F;IAC7F,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAiB7C,mFAAmF;IACnF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrB,QAAQ,IAAI,MAAM;CAG5B;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C"}

package/lib/printers/go.js

@@ -0,0 +1,209 @@
+// The Go syntax printer (ADR-0021). Go's extensions carry knowledge that must not be
+// re-derived: `typeName`/`memberName` apply the digit-leading `N` rule (a `_` prefix
+// means UNexported, so `encoding/json` would silently skip the field), and `layout` is
+// applied by `toString()` because CI commonly runs `gofmt -l` and fails on any file it
+// would reformat — column padding cannot be computed line-by-line, since the width for
+// the first field depends on the longest field in a run that has not been emitted yet.
+import { identifierFor, RESERVED_WORDS } from '../authoring/naming.js';
+import { Printer } from '../authoring/printer.js';
+import { docText } from '../authoring/schema.js';
+const GO = RESERVED_WORDS.go;
+export class GoPrinter extends Printer {
+    constructor() {
+        super('\t');
+    }
+    /** An exported type name: PascalCase, with the digit-leading `N` rule. */
+    typeName(name) {
+        return exported(name);
+    }
+    /** An exported field/method name — same rule as `typeName`; Go has one namespace. */
+    memberName(name) {
+        return exported(name);
+    }
+    /** A local/argument name: camelCase, keyword-safe. */
+    identifier(name) {
+        return identifierFor(name, { style: 'camel', reserved: GO });
+    }
+    /** Exported names made unique among themselves and the caller's taken set (`Id`, `Id2`). */
+    identifiers(names, taken) {
+        const used = new Set(taken ?? []);
+        return names.map((name) => {
+            const base = exported(name);
+            let ident = base;
+            for (let suffix = 2; used.has(ident); suffix++)
+                ident = `${base}${suffix}`;
+            used.add(ident);
+            return ident;
+        });
+    }
+    /** A package clause name: lower-case letters and digits only, never empty. */
+    packageName(name) {
+        const cleaned = name.toLowerCase().replace(/[^a-z0-9]/g, '');
+        return cleaned === '' || /^[0-9]/.test(cleaned) ? 'client' : cleaned;
+    }
+    /**
+     * A double-quoted Go string literal for any spec-supplied text. Controls are escaped;
+     * a lone surrogate (a JS string can carry one) has no Go spelling — `\uD800` is an
+     * invalid code point to the compiler — so it becomes U+FFFD; 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 += '\\uFFFD';
+            else
+                out += char;
+        }
+        return out + '"';
+    }
+    /** JSON-ish data as a Go expression (`map[string]any` / `[]any` composites). */
+    literal(value) {
+        if (value === null || value === undefined)
+            return 'nil';
+        if (typeof value === 'boolean' || typeof value === 'number')
+            return String(value);
+        if (typeof value === 'string')
+            return this.string(value);
+        if (Array.isArray(value)) {
+            return `[]any{${value.map((item) => this.literal(item)).join(', ')}}`;
+        }
+        const entries = Object.entries(value)
+            .map(([key, entry]) => `${this.string(key)}: ${this.literal(entry)}`)
+            .join(', ');
+        return `map[string]any{${entries}}`;
+    }
+    /** A `//` line comment. */
+    comment(text) {
+        for (const line of docText(text))
+            this.line(line === '' ? '//' : `// ${line}`);
+        return this;
+    }
+    /** A doc comment: `// Name — summary`, blank lines collapsed the way gofmt rewrites them. */
+    doc(name, description) {
+        const lines = docText(description);
+        if (lines.length === 0)
+            return this;
+        this.line(`// ${name} — ${lines[0]}`);
+        let previousWasBlank = false;
+        for (const line of lines.slice(1)) {
+            if (line === '') {
+                if (!previousWasBlank)
+                    this.line('//');
+                previousWasBlank = true;
+                continue;
+            }
+            this.line(`// ${line}`);
+            previousWasBlank = false;
+        }
+        return this;
+    }
+    /** gofmt-clean text: column alignment plus the whitespace shape gofmt produces. */
+    layout(source) {
+        return gofmtShape(alignGoColumns(source));
+    }
+    toString() {
+        return this.layout(super.toString());
+    }
+}
+/** An exported Go identifier: PascalCase, digit-leading names get `N` (never `_`). */
+export function exported(name) {
+    const ident = identifierFor(name, { style: 'pascal', reserved: GO });
+    return ident.startsWith('_') ? `N${ident.slice(1)}` : ident;
+}
+/**
+ * The whitespace shape gofmt produces: never more than one blank line, and exactly one
+ * trailing newline. Both entry points below run through it, so the models view is as
+ * gofmt-clean as the full client.
+ */
+function gofmtShape(source) {
+    return `${source.replace(/\n{3,}/g, '\n\n').trimEnd()}\n`;
+}
+/**
+ * Align columns the way gofmt does, so the emitted file is already idiomatic and a
+ * `gofmt` run is a no-op. gofmt pads with spaces inside a contiguous run of similar
+ * lines: struct fields align their type and tag columns, `const`/`var` entries align
+ * their type and `=`. A line that doesn't fit the shape (a comment, a blank line, a
+ * type containing spaces) ends the run, exactly like gofmt's tabwriter.
+ */
+function alignGoColumns(source) {
+    const lines = source.split('\n');
+    const out = [...lines];
+    // `\tName Type` optionally followed by a `json:"…"` tag, `\tName Type = value`, or a
+    // quoted map key. A statement starting with a Go keyword (`case "x":`, `return y`) is
+    // NOT a declaration and must never be padded.
+    const FIELD = /^(\t+)([A-Za-z_]\w*) (\S+)( `[^`]*`)?$/;
+    const CONST = /^(\t+)([A-Za-z_]\w*) (\S+) = (.+)$/;
+    const ENTRY = /^(\t+)("(?:[^"\\]|\\.)*":) (.+)$/;
+    const flush = (run) => {
+        if (run.length < 2)
+            return;
+        const widths = [];
+        for (const { parts } of run) {
+            parts.forEach((part, column) => {
+                // The last column never needs padding.
+                if (column < parts.length - 1)
+                    widths[column] = Math.max(widths[column] ?? 0, part.length);
+            });
+        }
+        for (const { index, parts, indent } of run) {
+            const padded = parts.map((part, column) => column < parts.length - 1 ? part.padEnd(widths[column] ?? 0) : part);
+            out[index] = indent + padded.join(' ').trimEnd();
+        }
+    };
+    let run = [];
+    let runKind;
+    lines.forEach((line, index) => {
+        const entryMatch = ENTRY.exec(line);
+        const constMatch = entryMatch === null ? CONST.exec(line) : null;
+        const fieldCandidate = entryMatch === null && constMatch === null ? FIELD.exec(line) : null;
+        // `case`, `return`, `var`, … start statements, not declarations.
+        const fieldMatch = fieldCandidate !== null && !GO.has(fieldCandidate[2]) ? fieldCandidate : null;
+        const kind = entryMatch !== null
+            ? 'entry'
+            : constMatch !== null
+                ? 'const'
+                : fieldMatch !== null
+                    ? 'field'
+                    : undefined;
+        if (kind === undefined || kind !== runKind) {
+            flush(run);
+            run = [];
+            runKind = kind;
+        }
+        if (entryMatch !== null) {
+            run.push({ index, indent: entryMatch[1], parts: [entryMatch[2], entryMatch[3]] });
+            return;
+        }
+        if (constMatch !== null) {
+            run.push({
+                index,
+                indent: constMatch[1],
+                parts: [constMatch[2], constMatch[3], '=', constMatch[4]],
+            });
+            return;
+        }
+        if (fieldMatch !== null) {
+            const parts = [fieldMatch[2], fieldMatch[3]];
+            if (fieldMatch[4] !== undefined)
+                parts.push(fieldMatch[4].trimStart());
+            run.push({ index, indent: fieldMatch[1], parts });
+        }
+    });
+    flush(run);
+    return out.join('\n');
+}
+//# sourceMappingURL=go.js.map