@skmtc/core 0.18.1 → 0.26.0

package/esm/context/GenerateContext.js

@@ -9,8 +9,8 @@ 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;
+import { normalize } from '../deps/jsr.io/@std/path/1.1.6/normalize.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 +22,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 +77,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
@@ -133,7 +133,6 @@ export 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;
@@ -224,8 +223,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 +242,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 +255,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 +268,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 +282,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 +319,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 +339,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 +363,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 +401,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 +443,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 +473,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 +483,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 +641,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,
@@ -655,7 +695,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,
@@ -682,12 +722,12 @@ 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({
@@ -728,12 +768,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_instances = new WeakSet(), _GenerateContext_schemaRefNames = function _GenerateContext_schemaRefNames() {
     switch (this.document.type) {
         case 'oas':
             return [...(this.document.value.components?.toSchemasRefNames() ?? [])];
@@ -771,7 +813,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 +838,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 +867,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 +884,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 +908,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 +937,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 +952,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 +982,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) {
@@ -920,7 +994,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 => {
@@ -935,7 +1009,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 +1031,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 +1050,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) {
@@ -995,17 +1071,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/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();