@skmtc/core 0.18.1 → 0.26.0

package/script/context/GenerateContext.js

@@ -13,10 +13,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-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;
+var _GenerateContext_instances, _GenerateContext_files, _GenerateContext_previews, _GenerateContext_captureChannel, _GenerateContext_schemaRefNames, _GenerateContext_subjectDefaults, _GenerateContext_runOasOperationGenerator, _GenerateContext_runWebhookGenerator, _GenerateContext_runGqlOperationGenerator, _GenerateContext_runModelGenerator, _GenerateContext_addPreview;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toModelSource = exports.toGqlOperationSource = exports.toWebhookSource = exports.toOasOperationSource = exports.GenerateContext = void 0;
-const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.4/normalize.js");
+const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.6/normalize.js");
 const OasOperationDriver_js_1 = require("../dsl/operation/oas/OasOperationDriver.js");
 const WebhookDriver_js_1 = require("../dsl/webhook/WebhookDriver.js");
 const GqlOperationDriver_js_1 = require("../dsl/operation/gql/GqlOperationDriver.js");
@@ -28,6 +28,7 @@ const get_js_1 = __importDefault(require("lodash-es/get.js"));
 const Inserted_js_1 = require("../dsl/Inserted.js");
 const CodeFileBase_js_1 = require("../dsl/CodeFileBase.js");
 const JsonFile_js_1 = require("../dsl/JsonFile.js");
+const MarkdownFile_js_1 = require("../dsl/MarkdownFile.js");
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
 /**
  * The generation context for the second phase of the SKMTC transformation pipeline.
@@ -82,7 +83,6 @@ 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
@@ -139,7 +139,6 @@ class GenerateContext {
         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;
@@ -230,8 +229,7 @@ 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")
         };
     }
     /**
@@ -250,8 +248,11 @@ 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: Variant_js_1.DEFAULT_VARIANT }))
+                            .filter(operation => generatorConfig.isSupported({
+                            operation,
+                            context: this,
+                            variant: Variant_js_1.DEFAULT_VARIANT
+                        }))
                             .map(operation => ({ path: operation.path, method: operation.method }))
                         : [];
                     out[generatorConfig.id] = { type: 'oasOperation', operations };
@@ -260,8 +261,11 @@ 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: Variant_js_1.DEFAULT_VARIANT }))
+                            .filter(webhook => generatorConfig.isSupported({
+                            webhook,
+                            context: this,
+                            variant: Variant_js_1.DEFAULT_VARIANT
+                        }))
                             .map(webhook => ({ name: webhook.name, method: webhook.method }))
                         : [];
                     out[generatorConfig.id] = { type: 'webhook', webhooks };
@@ -270,8 +274,11 @@ 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: Variant_js_1.DEFAULT_VARIANT }))
+                            .filter(operation => generatorConfig.isSupported({
+                            operation,
+                            context: this,
+                            variant: Variant_js_1.DEFAULT_VARIANT
+                        }))
                             .map(operation => ({
                             rootKind: operation.rootKind,
                             fieldName: operation.fieldName
@@ -281,8 +288,7 @@ 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: Variant_js_1.DEFAULT_VARIANT }));
+                    const models = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_schemaRefNames).call(this).filter(refName => generatorConfig.isSupported({ refName, context: this, variant: Variant_js_1.DEFAULT_VARIANT }));
                     out[generatorConfig.id] = { type: 'model', models };
                     break;
                 }
@@ -319,8 +325,7 @@ class GenerateContext {
                         break;
                     const operations = {};
                     this.document.value.operations.forEach(operation => {
-                        if (typeof generatorConfig.isSupported === 'function' &&
-                            !generatorConfig.isSupported({ operation, context: this, variant: Variant_js_1.DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ operation, context: this, variant: Variant_js_1.DEFAULT_VARIANT })) {
                             return;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ operation, context: this, variant: Variant_js_1.DEFAULT_VARIANT }));
@@ -340,8 +345,7 @@ class GenerateContext {
                         break;
                     const webhooks = {};
                     this.document.value.webhooks.forEach(webhook => {
-                        if (typeof generatorConfig.isSupported === 'function' &&
-                            !generatorConfig.isSupported({ webhook, context: this, variant: Variant_js_1.DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ webhook, context: this, variant: Variant_js_1.DEFAULT_VARIANT })) {
                             return;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ webhook, context: this, variant: Variant_js_1.DEFAULT_VARIANT }));
@@ -365,8 +369,7 @@ 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: Variant_js_1.DEFAULT_VARIANT })) {
+                        if (!generatorConfig.isSupported({ refName, context: this, variant: Variant_js_1.DEFAULT_VARIANT })) {
                             continue;
                         }
                         const leaf = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_subjectDefaults).call(this, () => toDefaults({ refName, context: this, variant: Variant_js_1.DEFAULT_VARIANT }));
@@ -404,6 +407,19 @@ class GenerateContext {
     getFile(filePath) {
         return __classPrivateFieldGet(this, _GenerateContext_files, "f").get((0, normalize_js_1.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
@@ -433,6 +449,25 @@ class GenerateContext {
         (0, tiny_invariant_1.default)(currentFile instanceof JsonFile_js_1.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 = (0, normalize_js_1.normalize)(destinationPath);
+        let currentFile = this.getFile(normalizedPath);
+        if (!currentFile) {
+            currentFile = new MarkdownFile_js_1.MarkdownFile({ path: normalizedPath, content: '' });
+            this.addFile(currentFile);
+        }
+        (0, tiny_invariant_1.default)(currentFile instanceof MarkdownFile_js_1.MarkdownFile, `File at "${destinationPath}" is not a "MarkdownFile" type`);
+        currentFile.content = markdown;
+    }
     /**
      * Insert supplied `imports` and `definitions` into file at `destinationPath`.
      *
@@ -444,7 +479,7 @@ class GenerateContext {
      *
      * @mutates this.files
      */
-    register({ imports = [], reExports = [], definitions, destinationPath }) {
+    register({ imports = [], reExports = [], definitions, custom, destinationPath }) {
         const normalizedPath = (0, normalize_js_1.normalize)(destinationPath);
         const currentFile = this.getFile(normalizedPath);
         // `register` never creates files — it speaks pure data and the engine
@@ -454,22 +489,27 @@ class GenerateContext {
         // caller.
         (0, tiny_invariant_1.default)(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_js_1.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_js_1.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_js_1.CodeFileBase) {
+            definitions?.forEach(definition => {
+                if (definition) {
+                    currentFile.addDefinition(definition);
+                }
+            });
+            if (imports.length > 0) {
+                currentFile.addImports(imports);
+            }
+            if (reExports.length > 0) {
+                currentFile.addReExports(reExports);
+            }
         }
     }
     /**
@@ -607,7 +647,7 @@ class GenerateContext {
      * given operation.
      */
     toOperationContentSettings(args) {
-        const { variant } = args;
+        const variant = args.variant ?? Variant_js_1.DEFAULT_VARIANT;
         if (isGqlToOperationSettingsArgs(args)) {
             const enrichments = args.projection.toEnrichments({
                 operation: args.operation,
@@ -661,7 +701,7 @@ class GenerateContext {
      * protocol discrimination.
      */
     toWebhookContentSettings(args) {
-        const { variant } = args;
+        const variant = args.variant ?? Variant_js_1.DEFAULT_VARIANT;
         const enrichments = args.projection.toEnrichments({
             webhook: args.webhook,
             context: this,
@@ -688,12 +728,12 @@ 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 = Variant_js_1.DEFAULT_VARIANT }) {
         const enrichments = projection.toEnrichments({ refName, context: this, variant });
         return new ContentSettings_js_1.ContentSettings({
             identifier: projection.lang.toIdentifier({
@@ -734,13 +774,15 @@ 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_js_1.CodeFileBase ? file.findDefinitions({ name })?.[0] : undefined;
     }
 }
 exports.GenerateContext = GenerateContext;
-_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_instances = new WeakSet(), _GenerateContext_schemaRefNames = function _GenerateContext_schemaRefNames() {
     switch (this.document.type) {
         case 'oas':
             return [...(this.document.value.components?.toSchemasRefNames() ?? [])];
@@ -778,7 +820,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 = (0, get_js_1.default)(this.settings, ['enrichments', generatorConfig.id, operation.path, operation.method]);
+            const opEnrichments = (0, get_js_1.default)(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                operation.path,
+                operation.method
+            ]);
             const variants = (0, toVariantList_js_1.toVariantList)({
                 opEnrichments,
                 generatorId: generatorConfig.id,
@@ -798,11 +845,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;
                         }
@@ -817,7 +874,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) {
@@ -835,7 +891,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 = (0, get_js_1.default)(this.settings, ['enrichments', generatorConfig.id, webhook.name, webhook.method]);
+            const webhookEnrichments = (0, get_js_1.default)(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                webhook.name,
+                webhook.method
+            ]);
             const variants = (0, toVariantList_js_1.toVariantList)({
                 opEnrichments: webhookEnrichments,
                 generatorId: generatorConfig.id,
@@ -854,11 +915,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;
                         }
@@ -873,7 +944,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) {
@@ -889,7 +959,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 = (0, get_js_1.default)(this.settings, ['enrichments', generatorConfig.id, operation.rootKind, operation.fieldName]);
+            const opEnrichments = (0, get_js_1.default)(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                operation.rootKind,
+                operation.fieldName
+            ]);
             const variants = (0, toVariantList_js_1.toVariantList)({
                 opEnrichments,
                 generatorId: generatorConfig.id,
@@ -914,7 +989,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) {
@@ -927,7 +1001,7 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
     });
 }, _GenerateContext_runModelGenerator = function _GenerateContext_runModelGenerator(document, generatorConfig, include, skip, stackTrail) {
     const refNames = document.type === 'oas'
-        ? (document.value.components?.toSchemasRefNames() ?? [])
+        ? document.value.components?.toSchemasRefNames() ?? []
         : document.value.registry.toSchemasRefNames();
     refNames.forEach(refName => {
         stackTrail.trace(refName, refTrail => {
@@ -942,7 +1016,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 = (0, get_js_1.default)(this.settings, ['enrichments', generatorConfig.id, refName]);
+            const modelEnrichments = (0, get_js_1.default)(this.settings, [
+                'enrichments',
+                generatorConfig.id,
+                refName
+            ]);
             const variants = (0, toVariantList_js_1.toVariantList)({
                 opEnrichments: modelEnrichments,
                 generatorId: generatorConfig.id,
@@ -960,8 +1038,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;
                         }
@@ -980,7 +1057,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) {
@@ -1002,17 +1078,6 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_previews = new WeakMap(
         module,
         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}"`);
-    }
-    __classPrivateFieldGet(this, _GenerateContext_mappings, "f")[module.name] = {
-        module,
-        source
-    };
 };
 /**
  * Match a `(path, method, variant)` tuple against an operation-shaped

package/script/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/script/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/script/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/script/context/RenderContext.js

@@ -17,7 +17,7 @@ var _RenderContext_captureChannel, _RenderContext_sink, _RenderContext_captures;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderContext = void 0;
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
-const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.4/normalize.js");
+const normalize_js_1 = require("../deps/jsr.io/@std/path/1.1.6/normalize.js");
 const toResolvedArtifactPath_js_1 = require("../helpers/toResolvedArtifactPath.js");
 const CodeFileBase_js_1 = require("../dsl/CodeFileBase.js");
 const CaptureSink_js_1 = require("../anchors/CaptureSink.js");
@@ -32,7 +32,7 @@ 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,
@@ -47,13 +47,6 @@ 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,
@@ -112,7 +105,6 @@ class RenderContext {
         );
         this.files = files;
         this.previews = previews;
-        this.mappings = mappings;
         this.basePath = basePath;
         this.logger = logger;
         this.captureCurrentResult = captureCurrentResult;
@@ -158,8 +150,7 @@ 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
@@ -205,7 +196,6 @@ class RenderContext {
             artifacts: result.artifacts,
             files: result.files,
             previews: this.previews,
-            mappings: this.mappings,
             sidecars,
             generationMap
         };
@@ -346,7 +336,7 @@ class RenderContext {
     pick({ name, exportPath }) {
         const file = this.getFile(exportPath);
         (0, tiny_invariant_1.default)(file instanceof CodeFileBase_js_1.CodeFileBase, `File at "${exportPath}" is not a code file`);
-        return file.definitions.get(name);
+        return file.findDefinitions({ name })?.[0];
     }
 }
 exports.RenderContext = RenderContext;