@skmtc/core 0.18.1 → 0.27.0

package/esm/context/GenerateContext.js

@@ -9,8 +9,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _GenerateContext_instances, _GenerateContext_files, _GenerateContext_previews, _GenerateContext_mappings, _GenerateContext_captureChannel, _GenerateContext_schemaRefNames, _GenerateContext_subjectDefaults, _GenerateContext_runOasOperationGenerator, _GenerateContext_runWebhookGenerator, _GenerateContext_runGqlOperationGenerator, _GenerateContext_runModelGenerator, _GenerateContext_addPreview, _GenerateContext_addMapping;
-import { normalize } from '../deps/jsr.io/@std/path/1.1.4/normalize.js';
+var _GenerateContext_instances, _GenerateContext_files, _GenerateContext_previews, _GenerateContext_captureChannel, _GenerateContext_schemaRefNames, _GenerateContext_subjectDefaults, _GenerateContext_runOasOperationGenerator, _GenerateContext_runWebhookGenerator, _GenerateContext_runGqlOperationGenerator, _GenerateContext_runModelGenerator, _GenerateContext_addPreview, _GenerateContext_toContentSettingsExportPath, _GenerateContext_ejectedBySuffixedPath_get, _GenerateContext_ejectedBySuffixedPathCache;
+import { normalize } from '../deps/jsr.io/@std/path/1.1.6/normalize.js';
+import { applyGeneratedSuffix, DEFAULT_GENERATED_SUFFIX } from '../helpers/applyGeneratedSuffix.js';
 import { OasOperationDriver } from '../dsl/operation/oas/OasOperationDriver.js';
 import { WebhookDriver } from '../dsl/webhook/WebhookDriver.js';
 import { GqlOperationDriver } from '../dsl/operation/gql/GqlOperationDriver.js';
@@ -22,6 +23,7 @@ import get from 'lodash-es/get.js';
 import { Inserted } from '../dsl/Inserted.js';
 import { CodeFileBase } from '../dsl/CodeFileBase.js';
 import { JsonFile } from '../dsl/JsonFile.js';
+import { MarkdownFile } from '../dsl/MarkdownFile.js';
 import invariant from 'tiny-invariant';
 /**
  * The generation context for the second phase of the SKMTC transformation pipeline.
@@ -76,7 +78,6 @@ export class GenerateContext {
         _GenerateContext_instances.add(this);
         _GenerateContext_files.set(this, void 0);
         _GenerateContext_previews.set(this, void 0);
-        _GenerateContext_mappings.set(this, void 0);
         /**
          * Parsed source document, wrapped in the {@link SkmtcParsedDocument}
          * discriminated union. Canonical representation; both protocol-neutral
@@ -130,10 +131,10 @@ export class GenerateContext {
          */
         /** Shared attribution capture channel (see {@link ConstructorArgs}). */
         _GenerateContext_captureChannel.set(this, void 0);
+        _GenerateContext_ejectedBySuffixedPathCache.set(this, void 0);
         this.logger = logger;
         __classPrivateFieldSet(this, _GenerateContext_files, new Map(), "f");
         __classPrivateFieldSet(this, _GenerateContext_previews, {}, "f");
-        __classPrivateFieldSet(this, _GenerateContext_mappings, {}, "f");
         this.document = document;
         this.settings = settings;
         this.captureCurrentResult = captureCurrentResult;
@@ -224,8 +225,7 @@ export class GenerateContext {
         });
         return {
             files: __classPrivateFieldGet(this, _GenerateContext_files, "f"),
-            previews: __classPrivateFieldGet(this, _GenerateContext_previews, "f"),
-            mappings: __classPrivateFieldGet(this, _GenerateContext_mappings, "f")
+            previews: __classPrivateFieldGet(this, _GenerateContext_previews, "f")
         };
     }
     /**
@@ -244,8 +244,11 @@ export class GenerateContext {
                 case 'oasOperation': {
                     const operations = this.document.type === 'oas'
                         ? this.document.value.operations
-                            .filter(operation => typeof generatorConfig.isSupported !== 'function' ||
-                            generatorConfig.isSupported({ operation, context: this, variant: DEFAULT_VARIANT }))
+                            .filter(operation => generatorConfig.isSupported({
+                            operation,
+                            context: this,
+                            variant: DEFAULT_VARIANT
+                        }))
                             .map(operation => ({ path: operation.path, method: operation.method }))
                         : [];
                     out[generatorConfig.id] = { type: 'oasOperation', operations };
@@ -254,8 +257,11 @@ export class GenerateContext {
                 case 'webhook': {
                     const webhooks = this.document.type === 'oas'
                         ? this.document.value.webhooks
-                            .filter(webhook => typeof generatorConfig.isSupported !== 'function' ||
-                            generatorConfig.isSupported({ webhook, context: this, variant: DEFAULT_VARIANT }))
+                            .filter(webhook => generatorConfig.isSupported({
+                            webhook,
+                            context: this,
+                            variant: DEFAULT_VARIANT
+                        }))
                             .map(webhook => ({ name: webhook.name, method: webhook.method }))
                         : [];
                     out[generatorConfig.id] = { type: 'webhook', webhooks };
@@ -264,8 +270,11 @@ export class GenerateContext {
                 case 'gqlOperation': {
                     const operations = this.document.type === 'gql'
                         ? this.document.value.operations
-                            .filter(operation => typeof generatorConfig.isSupported !== 'function' ||
-                            generatorConfig.isSupported({ operation, context: this, variant: DEFAULT_VARIANT }))
+                            .filter(operation => generatorConfig.isSupported({
+                            operation,
+                            context: this,
+                            variant: DEFAULT_VARIANT
+                        }))
                             .map(operation => ({
                             rootKind: operation.rootKind,
                             fieldName: operation.fieldName
@@ -275,8 +284,7 @@ export class GenerateContext {
                     break;
                 }
                 case 'model': {
-                    const models = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_schemaRefNames).call(this).filter(refName => typeof generatorConfig.isSupported !== 'function' ||
-                        generatorConfig.isSupported({ refName, context: this, variant: DEFAULT_VARIANT }));
+                    const models = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_schemaRefNames).call(this).filter(refName => generatorConfig.isSupported({ refName, context: this, variant: DEFAULT_VARIANT }));
                     out[generatorConfig.id] = { type: 'model', models };
                     break;
                 }
@@ -313,8 +321,7 @@ export class GenerateContext {
                         break;
                     const operations = {};
                     this.document.value.operations.forEach(operation => {
-                        if (typeof generatorConfig.isSupported === 'function' &&
-                            !generatorConfig.isSupported({ operation, context: this, variant: DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ operation, context: this, variant: DEFAULT_VARIANT })) {
                             return;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ operation, context: this, variant: DEFAULT_VARIANT }));
@@ -334,8 +341,7 @@ export class GenerateContext {
                         break;
                     const webhooks = {};
                     this.document.value.webhooks.forEach(webhook => {
-                        if (typeof generatorConfig.isSupported === 'function' &&
-                            !generatorConfig.isSupported({ webhook, context: this, variant: DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ webhook, context: this, variant: DEFAULT_VARIANT })) {
                             return;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ webhook, context: this, variant: DEFAULT_VARIANT }));
@@ -359,8 +365,7 @@ export class GenerateContext {
                     // `undefined` for schemas it doesn't seed.
                     const models = {};
                     for (const refName of __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_schemaRefNames).call(this)) {
-                        if (typeof generatorConfig.isSupported === 'function' &&
-                            !generatorConfig.isSupported({ refName, context: this, variant: DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ refName, context: this, variant: DEFAULT_VARIANT })) {
                             continue;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ refName, context: this, variant: DEFAULT_VARIANT }));
@@ -398,6 +403,19 @@ export class GenerateContext {
     getFile(filePath) {
         return __classPrivateFieldGet(this, _GenerateContext_files, "f").get(normalize(filePath));
     }
+    /**
+     * Read-only view of every file generated so far, keyed by (normalized)
+     * export path. An **inspection / tooling** seam — NOT a coordination
+     * surface: generators must still register via `register` / `insert*`, and
+     * the storage stays `#`-private so nothing outside can mutate or re-bind it.
+     *
+     * Unlike {@link getFile} (which needs a path) this lets tooling *enumerate*
+     * the files map — e.g. a debugger visualiser snapshotting the in-progress
+     * state at a breakpoint. The `ReadonlyMap` type signals look-don't-touch.
+     */
+    get inspectedFiles() {
+        return __classPrivateFieldGet(this, _GenerateContext_files, "f");
+    }
     /**
      * Store a language-constructed file. The engine never constructs a
      * concrete (language) `File`; the language's `register` builds its own
@@ -427,6 +445,25 @@ export class GenerateContext {
         invariant(currentFile instanceof JsonFile, `File at "${destinationPath}" is not a "JsonFile" type`);
         currentFile.content = json;
     }
+    /**
+     * Registers Markdown content for output to a file.
+     *
+     * The Markdown counterpart of {@link registerJson} — create-or-replace, last
+     * write wins. The `markdown` is any {@link Stringable} (typically a composed
+     * snippet tree), rendered verbatim into a {@link MarkdownFile}.
+     *
+     * @experimental This method is experimental and may change in future versions
+     */
+    registerMarkdown({ destinationPath, markdown }) {
+        const normalizedPath = normalize(destinationPath);
+        let currentFile = this.getFile(normalizedPath);
+        if (!currentFile) {
+            currentFile = new MarkdownFile({ path: normalizedPath, content: '' });
+            this.addFile(currentFile);
+        }
+        invariant(currentFile instanceof MarkdownFile, `File at "${destinationPath}" is not a "MarkdownFile" type`);
+        currentFile.content = markdown;
+    }
     /**
      * Insert supplied `imports` and `definitions` into file at `destinationPath`.
      *
@@ -438,7 +475,7 @@ export class GenerateContext {
      *
      * @mutates this.files
      */
-    register({ imports = [], reExports = [], definitions, destinationPath }) {
+    register({ imports = [], reExports = [], definitions, custom, destinationPath }) {
         const normalizedPath = normalize(destinationPath);
         const currentFile = this.getFile(normalizedPath);
         // `register` never creates files — it speaks pure data and the engine
@@ -448,22 +485,27 @@ export class GenerateContext {
         // caller.
         invariant(currentFile, `Cannot register into '${normalizedPath}' — the file does not exist. ` +
             `Pre-create it through your lang (its register function does this).`);
-        // Definitions merge is language-neutral — `addDefinition` lives on
-        // `FileBase`, so this works for any language's file.
-        definitions?.forEach(definition => {
-            if (definition) {
-                currentFile.addDefinition(definition);
-            }
-        });
-        // Imports and re-exports are standardised `ImportBase` /
-        // `ReExportBase` objects; the neutral merges (keyed by `mergeKey`)
-        // live on `CodeFileBase`. `JsonFile` has neither, so the guard skips
-        // it.
-        if (imports.length > 0 && currentFile instanceof CodeFileBase) {
-            currentFile.addImports(imports);
+        // `custom` is language-neutral — it lives on `FileBase`, so any file
+        // (code or not, e.g. a JSON/Markdown file) can receive it. Last
+        // non-`undefined` write wins.
+        if (custom !== undefined) {
+            currentFile.custom = custom;
         }
-        if (reExports.length > 0 && currentFile instanceof CodeFileBase) {
-            currentFile.addReExports(reExports);
+        // Definitions, imports, and re-exports — and their duplication/merge
+        // policy — are code-file concerns owned by the language subclass.
+        // `JsonFile` (no definitions/imports) is skipped by the guard.
+        if (currentFile instanceof CodeFileBase) {
+            definitions?.forEach(definition => {
+                if (definition) {
+                    currentFile.addDefinition(definition);
+                }
+            });
+            if (imports.length > 0) {
+                currentFile.addImports(imports);
+            }
+            if (reExports.length > 0) {
+                currentFile.addReExports(reExports);
+            }
         }
     }
     /**
@@ -601,7 +643,7 @@ export class GenerateContext {
      * given operation.
      */
     toOperationContentSettings(args) {
-        const { variant } = args;
+        const variant = args.variant ?? DEFAULT_VARIANT;
         if (isGqlToOperationSettingsArgs(args)) {
             const enrichments = args.projection.toEnrichments({
                 operation: args.operation,
@@ -617,11 +659,11 @@ export class GenerateContext {
                     }),
                     ...args.projection.toIdentifierType(args.operation, this)
                 }),
-                exportPath: args.projection.toExportPath({
+                exportPath: __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toContentSettingsExportPath).call(this, args.projection.toExportPath({
                     operation: args.operation,
                     enrichments,
                     variant
-                }),
+                })),
                 enrichments,
                 variant
             });
@@ -640,11 +682,11 @@ export class GenerateContext {
                 }),
                 ...args.projection.toIdentifierType(args.operation, this)
             }),
-            exportPath: args.projection.toExportPath({
+            exportPath: __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toContentSettingsExportPath).call(this, args.projection.toExportPath({
                 operation: args.operation,
                 enrichments,
                 variant
-            }),
+            })),
             enrichments,
             variant
         });
@@ -655,7 +697,7 @@ export class GenerateContext {
      * protocol discrimination.
      */
     toWebhookContentSettings(args) {
-        const { variant } = args;
+        const variant = args.variant ?? DEFAULT_VARIANT;
         const enrichments = args.projection.toEnrichments({
             webhook: args.webhook,
             context: this,
@@ -670,11 +712,11 @@ export class GenerateContext {
                 }),
                 ...args.projection.toIdentifierType(args.webhook, this)
             }),
-            exportPath: args.projection.toExportPath({
+            exportPath: __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toContentSettingsExportPath).call(this, args.projection.toExportPath({
                 webhook: args.webhook,
                 enrichments,
                 variant
-            }),
+            })),
             enrichments,
             variant
         });
@@ -682,19 +724,19 @@ export class GenerateContext {
     /**
      * Build content settings for a model projection by calling its statics
      * `toIdentifierName` (pure, for the name) + `toIdentifierType`
-     * (context-aware, for kind/typeName/exported), `toExportPath`, and
+     * (context-aware, for type/typeName/exported), `toExportPath`, and
      * `toEnrichments` against the given `refName` and `variant`. The full
      * identifier is assembled through the projection's language
      * (`lang.toIdentifier`).
      */
-    toModelContentSettings({ refName, projection, variant }) {
+    toModelContentSettings({ refName, projection, variant = DEFAULT_VARIANT }) {
         const enrichments = projection.toEnrichments({ refName, context: this, variant });
         return new ContentSettings({
             identifier: projection.lang.toIdentifier({
                 name: projection.toIdentifierName({ refName, enrichments, variant }),
                 ...projection.toIdentifierType(refName, this)
             }),
-            exportPath: projection.toExportPath({ refName, enrichments, variant }),
+            exportPath: __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toContentSettingsExportPath).call(this, projection.toExportPath({ refName, enrichments, variant })),
             enrichments,
             variant
         });
@@ -728,12 +770,14 @@ export class GenerateContext {
      * @returns Matching definition if found or `undefined` otherwise
      */
     findDefinition({ name, exportPath }) {
-        // Pure lookup — no file is created on a miss. `definitions` lives on
-        // `FileBase`, so this reads any language's file without narrowing.
-        return this.getFile(exportPath)?.definitions.get(name);
+        // Pure lookup — no file is created on a miss. Definitions live on the
+        // code-file subclass, so narrow; a non-code file (`JsonFile`) has none.
+        // The cache wants the single primary for the name → first match.
+        const file = this.getFile(exportPath);
+        return file instanceof CodeFileBase ? file.findDefinitions({ name })?.[0] : undefined;
     }
 }
-_GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(), _GenerateContext_mappings = new WeakMap(), _GenerateContext_captureChannel = new WeakMap(), _GenerateContext_instances = new WeakSet(), _GenerateContext_schemaRefNames = function _GenerateContext_schemaRefNames() {
+_GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(), _GenerateContext_captureChannel = new WeakMap(), _GenerateContext_ejectedBySuffixedPathCache = new WeakMap(), _GenerateContext_instances = new WeakSet(), _GenerateContext_schemaRefNames = function _GenerateContext_schemaRefNames() {
     switch (this.document.type) {
         case 'oas':
             return [...(this.document.value.components?.toSchemasRefNames() ?? [])];
@@ -771,7 +815,12 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
             //     at config-load time once it lands)
             //   - present, object → enumerate keys; 'main' must be among
             //     them or we throw (loud beats silent zero-output)
-            const opEnrichments = get(this.settings, ['enrichments', generatorConfig.id, operation.path, operation.method]);
+            const opEnrichments = get(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                operation.path,
+                operation.method
+            ]);
             const variants = toVariantList({
                 opEnrichments,
                 generatorId: generatorConfig.id,
@@ -791,11 +840,21 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                         // this method"; a populated array names the variants the
                         // entry applies to.
                         if (include !== undefined &&
-                            !matchesPathFilter({ paths: include, path: operation.path, method: operation.method, variant })) {
+                            !matchesPathFilter({
+                                paths: include,
+                                path: operation.path,
+                                method: operation.method,
+                                variant
+                            })) {
                             this.captureCurrentResult('skipped', st);
                             return;
                         }
-                        if (matchesPathFilter({ paths: skip, path: operation.path, method: operation.method, variant })) {
+                        if (matchesPathFilter({
+                            paths: skip,
+                            path: operation.path,
+                            method: operation.method,
+                            variant
+                        })) {
                             this.captureCurrentResult('skipped', st);
                             return;
                         }
@@ -810,7 +869,6 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                             variant
                         });
                         __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addPreview).call(this, source, generatorConfig.toPreviewModule?.({ context: this, operation, variant }));
-                        __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addMapping).call(this, source, generatorConfig.toMappingModule?.({ context: this, operation, variant }));
                         this.captureCurrentResult('success', st);
                     }
                     catch (error) {
@@ -828,7 +886,12 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
             // the webhook analogue of the operation routing. `toVariantList`
             // handles absent / non-object / object enrichment blocks and
             // enforces the `'main'`-must-be-present rule.
-            const webhookEnrichments = get(this.settings, ['enrichments', generatorConfig.id, webhook.name, webhook.method]);
+            const webhookEnrichments = get(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                webhook.name,
+                webhook.method
+            ]);
             const variants = toVariantList({
                 opEnrichments: webhookEnrichments,
                 generatorId: generatorConfig.id,
@@ -847,11 +910,21 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                         // operations (the webhook name occupies the `path` slot), so
                         // `matchesPathFilter` is reused with `path: webhook.name`.
                         if (include !== undefined &&
-                            !matchesPathFilter({ paths: include, path: webhook.name, method: webhook.method, variant })) {
+                            !matchesPathFilter({
+                                paths: include,
+                                path: webhook.name,
+                                method: webhook.method,
+                                variant
+                            })) {
                             this.captureCurrentResult('skipped', st);
                             return;
                         }
-                        if (matchesPathFilter({ paths: skip, path: webhook.name, method: webhook.method, variant })) {
+                        if (matchesPathFilter({
+                            paths: skip,
+                            path: webhook.name,
+                            method: webhook.method,
+                            variant
+                        })) {
                             this.captureCurrentResult('skipped', st);
                             return;
                         }
@@ -866,7 +939,6 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                             variant
                         });
                         __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addPreview).call(this, source, generatorConfig.toPreviewModule?.({ context: this, webhook, variant }));
-                        __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addMapping).call(this, source, generatorConfig.toMappingModule?.({ context: this, webhook, variant }));
                         this.captureCurrentResult('success', st);
                     }
                     catch (error) {
@@ -882,7 +954,12 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
         stackTrail.trace(operation.identifier, opTrail => {
             // GraphQL enrichment routing key is
             // `[generatorId][rootKind][fieldName][variant]`.
-            const opEnrichments = get(this.settings, ['enrichments', generatorConfig.id, operation.rootKind, operation.fieldName]);
+            const opEnrichments = get(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                operation.rootKind,
+                operation.fieldName
+            ]);
             const variants = toVariantList({
                 opEnrichments,
                 generatorId: generatorConfig.id,
@@ -907,7 +984,6 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                             variant
                         });
                         __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addPreview).call(this, source, generatorConfig.toPreviewModule?.({ context: this, operation, variant }));
-                        __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addMapping).call(this, source, generatorConfig.toMappingModule?.({ context: this, operation, variant }));
                         this.captureCurrentResult('success', st);
                     }
                     catch (error) {
@@ -935,7 +1011,11 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
             //     at config-load time once it lands)
             //   - present, object → enumerate keys; 'main' must be among
             //     them or we throw (loud beats silent zero-output)
-            const modelEnrichments = get(this.settings, ['enrichments', generatorConfig.id, refName]);
+            const modelEnrichments = get(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                refName
+            ]);
             const variants = toVariantList({
                 opEnrichments: modelEnrichments,
                 generatorId: generatorConfig.id,
@@ -953,8 +1033,7 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                         // (deny). Match is on `(refName, variant)`. An empty variant
                         // array on a refName means "every variant of this refName"; a
                         // populated array names the variants the entry applies to.
-                        if (include !== undefined &&
-                            !matchesRefFilter({ refs: include, refName, variant })) {
+                        if (include !== undefined && !matchesRefFilter({ refs: include, refName, variant })) {
                             this.captureCurrentResult('skipped', st);
                             return;
                         }
@@ -973,7 +1052,6 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
                             variant
                         });
                         __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addPreview).call(this, source, generatorConfig.toPreviewModule?.({ context: this, refName, variant }));
-                        __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addMapping).call(this, source, generatorConfig.toMappingModule?.({ context: this, refName, variant }));
                         this.captureCurrentResult('success', st);
                     }
                     catch (error) {
@@ -992,20 +1070,25 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
         throw new Error(`Cannot override preview module "${module.name}"`);
     }
     __classPrivateFieldGet(this, _GenerateContext_previews, "f")[module.name] = {
-        module,
+        // Preview export paths are hand-assembled in `toPreviewModule`
+        // (generators call the static `toExportPath` directly), so they
+        // bypass the ContentSettings construction path — run them through the same
+        // suffix injection or previews point at files that don't exist.
+        module: { ...module, exportPath: __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toContentSettingsExportPath).call(this, module.exportPath) },
         source
     };
-}, _GenerateContext_addMapping = function _GenerateContext_addMapping(source, module) {
-    if (!module) {
-        return;
-    }
-    if (__classPrivateFieldGet(this, _GenerateContext_mappings, "f")[module.name]) {
-        throw new Error(`Cannot override mapping module "${module.name}"`);
+}, _GenerateContext_toContentSettingsExportPath = function _GenerateContext_toContentSettingsExportPath(exportPath) {
+    const suffixed = applyGeneratedSuffix(exportPath, this.settings?.generatedSuffix ?? DEFAULT_GENERATED_SUFFIX);
+    return __classPrivateFieldGet(this, _GenerateContext_instances, "a", _GenerateContext_ejectedBySuffixedPath_get).get(normalize(suffixed)) ?? suffixed;
+}, _GenerateContext_ejectedBySuffixedPath_get = function _GenerateContext_ejectedBySuffixedPath_get() {
+    if (__classPrivateFieldGet(this, _GenerateContext_ejectedBySuffixedPathCache, "f") === undefined) {
+        const suffix = this.settings?.generatedSuffix ?? DEFAULT_GENERATED_SUFFIX;
+        __classPrivateFieldSet(this, _GenerateContext_ejectedBySuffixedPathCache, new Map((this.settings?.ejected ?? []).map(ejectedPath => {
+            const normalized = normalize(ejectedPath);
+            return [normalize(applyGeneratedSuffix(normalized, suffix)), normalized];
+        })), "f");
     }
-    __classPrivateFieldGet(this, _GenerateContext_mappings, "f")[module.name] = {
-        module,
-        source
-    };
+    return __classPrivateFieldGet(this, _GenerateContext_ejectedBySuffixedPathCache, "f");
 };
 /**
  * Match a `(path, method, variant)` tuple against an operation-shaped

package/esm/context/ParseContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AAIzD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAE5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAMjD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC/D,YAAY,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAExB,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,KAAK,CAAA;IACX,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,WAAW,CAAA;IACrB;;;;;;OAMG;IACH,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,eAAe,CAAA;CACzB,CAAA;AAED,KAAK,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAGxD,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,kBAAkB,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,eAAe,CAAA;KAAE,CAAA;CACpC,CAAA;AAED,qBAAa,YAAY;;IACvB,MAAM,EAAE,UAAU,EAAE,CAAK;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;IACvB;;;;;OAKG;IACH,iBAAiB,EAAE,UAAU,GAAG,SAAS,CAAA;gBAQ7B,EAAE,KAAK,EAAE,MAAM,EAAE,MAAa,EAAE,OAAO,EAAE,EAAE,eAAe;IAoCtE;;;;OAIG;IACH,IAAI,WAAW,IAAI,WAAW,CAK7B;IAED,kEAAkE;IAClE,IAAI,cAAc,IAAI,SAAS,CAAC,QAAQ,CAKvC;IAED,6DAA6D;IAC7D,IAAI,MAAM,IAAI,aAAa,CAK1B;IAED,6DAA6D;IAC7D,IAAI,QAAQ,IAAI,WAAW,CAK1B;IAED;;;;;OAKG;IACH,IAAI,WAAW,IAAI,WAAW,CAK7B;IAED;;;;;OAKG;IACH,IAAI,cAAc,IAAI,mBAAmB,CAWxC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB;IAoDlD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,kBAAkB,IAAI,IAAI;IAqD1B;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAUzD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IASvD;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAUlE;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAiBzD,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,IAAI;IAMzE,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAkE9E;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,IAAI;IAK1D;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EACf,OAAO,EACP,UAAU,EACV,MAAM,EACN,UAAU,EACV,IAA4B,EAC7B,EAAE,oBAAoB,GAAG,IAAI;CAY/B"}
+{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"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"}

package/esm/context/ParseIssue.d.ts

@@ -31,7 +31,7 @@ import type { OasIssueType } from './generateTypes.js';
  *
  * - `NESTED_LIST_LOSSY` — `[[T]]` collapsed to `OasUnknown`.
  * - `UNKNOWN_TYPE_KIND` — defensive fallback for an unrecognized
- *   GraphQL type kind. Should never fire in practice.
+ *   GraphQL type type. Should never fire in practice.
  * - `DROPPED_DIRECTIVE` — applied directive ignored during mapping
  *   (other than `@deprecated`, whose `reason` we capture).
  * - `SKIPPED_FIELD_ARGUMENTS` — non-root object/interface field

package/esm/context/RenderContext.d.ts

@@ -5,7 +5,7 @@ import type { ResultType } from '../types/Results.js';
 import type * as log from '../deps/jsr.io/@std/log/0.224.14/mod.js';
 import type { Logger } from '../types/Logger.js';
 import type { FileBase } from '../dsl/FileBase.js';
-import type { Preview, Mapping } from '../types/Preview.js';
+import type { Preview } from '../types/Preview.js';
 import type { StackTrail } from './StackTrail.js';
 import { type CaptureChannel } from '../anchors/CaptureSink.js';
 import type { GenerationMapEntry } from '../anchors/generationMap.js';
@@ -28,8 +28,6 @@ type ConstructorArgs = {
     files: Map<string, FileBase>;
     /** Preview data for generated content */
     previews: Record<string, Preview>;
-    /** Mapping data for file relationships */
-    mappings: Record<string, Mapping>;
     /** Base path for resolving file paths */
     basePath: string | undefined;
     /** Logger instance for debug information */
@@ -56,8 +54,6 @@ export declare class RenderContext {
     files: Map<string, FileBase>;
     /** Preview data for generated content */
     previews: Record<string, Preview>;
-    /** Mapping data for file relationships */
-    mappings: Record<string, Mapping>;
     /** Base path for resolving file paths */
     basePath: string | undefined;
     /** Logger instance for debug information */
@@ -74,7 +70,7 @@ export declare class RenderContext {
      *
      * @param args - Constructor arguments containing all required configuration
      */
-    constructor({ files, previews, mappings, basePath, logger, captureCurrentResult, attribution, captureChannel }: ConstructorArgs);
+    constructor({ files, previews, basePath, logger, captureCurrentResult, attribution, captureChannel }: ConstructorArgs);
     /**
      * Renders all files in the context to their final form.
      *

package/esm/context/RenderContext.d.ts.map

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

package/esm/context/RenderContext.js

@@ -11,7 +11,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _RenderContext_captureChannel, _RenderContext_sink, _RenderContext_captures;
 import invariant from 'tiny-invariant';
-import { normalize } from '../deps/jsr.io/@std/path/1.1.4/normalize.js';
+import { normalize } from '../deps/jsr.io/@std/path/1.1.6/normalize.js';
 import { toResolvedArtifactPath } from '../helpers/toResolvedArtifactPath.js';
 import { CodeFileBase } from '../dsl/CodeFileBase.js';
 import { CaptureSink } from '../anchors/CaptureSink.js';
@@ -26,7 +26,7 @@ export class RenderContext {
      *
      * @param args - Constructor arguments containing all required configuration
      */
-    constructor({ files, previews, mappings, basePath, logger, captureCurrentResult, attribution, captureChannel }) {
+    constructor({ files, previews, basePath, logger, captureCurrentResult, attribution, captureChannel }) {
         /** Map of generated files to render */
         Object.defineProperty(this, "files", {
             enumerable: true,
@@ -41,13 +41,6 @@ export class RenderContext {
             writable: true,
             value: void 0
         });
-        /** Mapping data for file relationships */
-        Object.defineProperty(this, "mappings", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         /** Base path for resolving file paths */
         Object.defineProperty(this, "basePath", {
             enumerable: true,
@@ -106,7 +99,6 @@ export class RenderContext {
         );
         this.files = files;
         this.previews = previews;
-        this.mappings = mappings;
         this.basePath = basePath;
         this.logger = logger;
         this.captureCurrentResult = captureCurrentResult;
@@ -152,8 +144,7 @@ export class RenderContext {
             return {
                 artifacts: result.artifacts,
                 files: result.files,
-                previews: this.previews,
-                mappings: this.mappings
+                previews: this.previews
             };
         }
         // Capturing render: open the capture interval by publishing a sink on
@@ -199,7 +190,6 @@ export class RenderContext {
             artifacts: result.artifacts,
             files: result.files,
             previews: this.previews,
-            mappings: this.mappings,
             sidecars,
             generationMap
         };
@@ -340,7 +330,7 @@ export class RenderContext {
     pick({ name, exportPath }) {
         const file = this.getFile(exportPath);
         invariant(file instanceof CodeFileBase, `File at "${exportPath}" is not a code file`);
-        return file.definitions.get(name);
+        return file.findDefinitions({ name })?.[0];
     }
 }
 _RenderContext_captureChannel = new WeakMap(), _RenderContext_sink = new WeakMap(), _RenderContext_captures = new WeakMap();