@skmtc/core 0.0.984 → 0.16.2

package/esm/context/StackTrail.js

@@ -10,13 +10,28 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _StackTrail_stack;
+import "../_dnt.polyfills.js";
 import { componentsKeys } from '../oas/components/Components.js';
+import { toJsonPointer } from '../types/JsonPointer.js';
 export class StackTrail {
     constructor(stack = []) {
         /** Internal stack of traversal frames */
         _StackTrail_stack.set(this, void 0);
         __classPrivateFieldSet(this, _StackTrail_stack, stack, "f");
     }
+    /**
+     * The canonical empty trail — used for nodes that were synthesized
+     * programmatically rather than parsed from a source document (they
+     * have no position). Distinct from any parsed position: no parsed
+     * `OasBase` node ever sits at the empty trail.
+     */
+    static empty() {
+        return new StackTrail([]);
+    }
+    /** True when the trail holds no frames (a synthetic / positionless node). */
+    isEmpty() {
+        return __classPrivateFieldGet(this, _StackTrail_stack, "f").length === 0;
+    }
     /**
      * Creates a shallow copy of the stack trail.
      *
@@ -131,6 +146,75 @@ export class StackTrail {
      * console.log(ref); // undefined
      * ```
      */
+    /**
+     * Converts the trail to an RFC 6901 JSON Pointer (URI fragment form).
+     *
+     * Unlike {@link toStackRef}, this works for *any* visitor path — not
+     * just components-rooted references. Used by the gen-maps system to
+     * attach a `location` field to every parsed OAS schema, recording
+     * exactly where in the document the schema lives.
+     *
+     * Special characters in stack frames (`/`, `~`) are escaped per
+     * RFC 6901.
+     *
+     * @returns A JSON Pointer string starting with `#/`
+     *
+     * @example Components-rooted
+     * ```typescript
+     * const trail = new StackTrail(['components', 'schemas', 'User'])
+     * trail.toJsonPointer() // '#/components/schemas/User'
+     * ```
+     *
+     * @example Path-rooted (escapes slashes in path segments)
+     * ```typescript
+     * const trail = new StackTrail(['paths', '/users/{id}', 'get'])
+     * trail.toJsonPointer() // '#/paths/~1users~1{id}/get'
+     * ```
+     */
+    toJsonPointer() {
+        return toJsonPointer(__classPrivateFieldGet(this, _StackTrail_stack, "f"));
+    }
+    /**
+     * The **document-relative** JSON Pointer for a parsed node, with the
+     * run's operational prefix stripped — the resolvable form used as a
+     * schema pointer in gen-maps.
+     *
+     * A parsed node's trail is seeded with operational frames before any
+     * document traversal: the worker pushes `[traceId, spanId]` and
+     * `CoreContext.toArtifacts` wraps each phase in `.trace('parse', …)` /
+     * `.trace('generate', …)` etc. The document path
+     * (`components/schemas/Pet/properties/name`) is appended on top. Unlike
+     * {@link toJsonPointer} — which serializes the *whole* trail and so does
+     * NOT resolve against the input document — this drops everything up to
+     * and including the phase frame, leaving only the document-relative path.
+     *
+     * Protocol-agnostic: the remaining frames are the input document's own
+     * keys (`components`, `paths`, … for OAS), never an `oas:`/`gql:` scheme.
+     *
+     * Falls back to the full trail when no phase frame is present (a trail
+     * seeded empty — e.g. in tests — is already document-relative). Returns
+     * `#/` (document root) for the empty trail.
+     *
+     * @example
+     * ```typescript
+     * new StackTrail(['trace-1', 'span-1', 'parse', 'components', 'schemas', 'Pet'])
+     *   .toSchemaPointer() // '#/components/schemas/Pet'
+     *
+     * new StackTrail(['components', 'schemas', 'User']) // already doc-relative
+     *   .toSchemaPointer() // '#/components/schemas/User'
+     * ```
+     */
+    toSchemaPointer() {
+        // Phase frames seeded by `CoreContext.toArtifacts` (PhaseType plus the
+        // `post-pass` trace). The operational phase always sits before any
+        // document key, so the FIRST match is the boundary — a document key
+        // that happens to share a phase name (e.g. a schema literally named
+        // `parse`) appears later and is unaffected.
+        const phaseFrames = new Set(['parse', 'generate', 'render', 'post-pass']);
+        const phaseIndex = __classPrivateFieldGet(this, _StackTrail_stack, "f").findIndex(frame => phaseFrames.has(frame));
+        const documentFrames = phaseIndex === -1 ? __classPrivateFieldGet(this, _StackTrail_stack, "f") : __classPrivateFieldGet(this, _StackTrail_stack, "f").slice(phaseIndex + 1);
+        return toJsonPointer(documentFrames);
+    }
     toStackRef() {
         const [first, second, third] = this.stackTrail;
         if (first !== 'components') {

package/esm/context/generateTypes.d.ts

@@ -1,25 +1,35 @@
+import * as v from 'valibot';
 import type { ManifestEntry } from '../types/Manifest.js';
+import type { ParseIssue } from './ParseIssue.js';
 import type { Mapping, Preview } from '../types/Preview.js';
 import type { ResultsItem } from '../types/Results.js';
 import type { OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
-import type { JsonFile } from '../dsl/JsonFile.js';
 import type { GeneratedValue } from '../dsl/GeneratedValue.js';
-import type { Definition } from '../dsl/Definition.js';
+import type { DefinitionBase } from '../dsl/Definition.js';
 import type { OasOperation } from '../oas/operation/Operation.js';
-import type { OperationInsertable } from '../dsl/operation/types.js';
+import type { OasOperationProjection } from '../dsl/operation/oas/types.js';
+import type { OasWebhook } from '../oas/webhook/Webhook.js';
+import type { WebhookProjection } from '../dsl/webhook/types.js';
 import type { Inserted } from '../dsl/Inserted.js';
 import type { OasSchema } from '../oas/schema/Schema.js';
 import type { OasRef } from '../oas/ref/Ref.js';
 import type { OasVoid } from '../oas/void/Void.js';
-import type { ModelInsertable } from '../dsl/model/types.js';
-import type { Identifier } from '../dsl/Identifier.js';
-import type { ImportNameArg } from '../dsl/Import.js';
+import type { ModelProjection } from '../dsl/model/types.js';
 import type { ContentSettings } from '../dsl/ContentSettings.js';
 import type { RefName } from '../types/RefName.js';
 import type { SchemaToNonRef, TypeSystemOutput } from '../types/TypeSystem.js';
-import type { File } from '../dsl/File.js';
+import type { FileBase } from '../dsl/FileBase.js';
+import type { ImportBase } from '../dsl/ImportBase.js';
+import type { ReExportBase } from '../dsl/ReExportBase.js';
 import type { ClientSettings } from '../types/Settings.js';
 import type { StackTrail } from './StackTrail.js';
+import type { GqlOperationProjection } from '../dsl/operation/gql/types.js';
+import type { GqlOperation } from '../gql/operation/GqlOperation.js';
+import type { SkmtcParsedDocument } from '../types/SkmtcDocument.js';
+import type { AttributionState } from '../types/AttributionState.js';
+import type { CaptureSink } from '../anchors/CaptureSink.js';
+import type { Sidecar } from '../anchors/sidecar.js';
+import type { GenerationMapEntry } from '../anchors/generationMap.js';
 /**
  * Options for inserting an operation into the generation context.
  *
@@ -33,6 +43,82 @@ export type InsertOperationOptions = {
     noExport?: boolean;
     /** Custom destination path for the operation */
     destinationPath?: string;
+    /**
+     * Target variant of the peer projection. Omit for `'main'` (the
+     * universally-safe default that every peer is guaranteed to
+     * honour). Pass explicitly only when the peer declares this
+     * variant — the Driver throws on mismatch.
+     */
+    variant?: string;
+};
+/**
+ * Arguments for `GenerateContext.insertOperation`.
+ *
+ * @template V - Generated value type
+ * @template EnrichmentType - Optional enrichment data type
+ */
+export type InsertOasOperationArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
+    /** The operation projection to insert */
+    projection: OasOperationProjection<V, EnrichmentType>;
+    /** The OpenAPI operation to process */
+    operation: OasOperation;
+    /** Custom destination path for the operation */
+    destinationPath?: string;
+    /** Whether to exclude this operation from exports */
+    noExport?: boolean;
+    /**
+     * Target variant of the peer projection. Omit for the canonical
+     * `'main'` variant — the only variant guaranteed to exist on every
+     * peer. Pass explicitly only when threading a caller's variant
+     * deliberately; the Driver throws if the requested variant isn't
+     * declared in the peer's enrichments.
+     */
+    variant?: string;
+};
+/**
+ * Arguments for `GenerateContext.insertOperation`.
+ *
+ * @template V - Generated value type
+ * @template EnrichmentType - Optional enrichment data type
+ */
+export type InsertGqlOperationArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
+    /** The operation projection to insert */
+    projection: GqlOperationProjection<V, EnrichmentType>;
+    /** The GraphQL operation to process */
+    operation: GqlOperation;
+    /** Custom destination path for the operation */
+    destinationPath?: string;
+    /** Whether to exclude this operation from exports */
+    noExport?: boolean;
+    /**
+     * Target variant of the peer projection. Omit for the canonical
+     * `'main'` variant — the only variant guaranteed to exist on every
+     * peer. Pass explicitly only when threading a caller's variant
+     * deliberately; the Driver throws if the requested variant isn't
+     * declared in the peer's enrichments.
+     */
+    variant?: string;
+};
+export type InsertOperationArgs<V extends GeneratedValue, EnrichmentType = undefined> = InsertOasOperationArgs<V, EnrichmentType> | InsertGqlOperationArgs<V, EnrichmentType>;
+/**
+ * Arguments for `GenerateContext.insertWebhook`. Webhooks are OAS-only (no
+ * GraphQL counterpart), so this is a single shape rather than a union.
+ */
+export type InsertWebhookArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
+    /** The webhook projection to insert */
+    projection: WebhookProjection<V, EnrichmentType>;
+    /** The OpenAPI 3.1 webhook to process */
+    webhook: OasWebhook;
+    /** Custom destination path for the webhook */
+    destinationPath?: string;
+    /** Whether to exclude this webhook from exports */
+    noExport?: boolean;
+    /**
+     * Target variant of the peer projection. Omit for the canonical `'main'`
+     * variant; pass explicitly only when the peer declares this variant — the
+     * Driver throws if it isn't declared in the peer's enrichments.
+     */
+    variant?: string;
 };
 /**
  * Type representing the three phases of the SKMTC pipeline.
@@ -63,25 +149,34 @@ export type RenderResult = {
     /** Map of file paths to metadata */
     files: Record<string, ManifestEntry>;
     /** Preview data for generated content */
-    previews: Record<string, Record<string, Preview>>;
+    previews: Record<string, Preview>;
     /** Mapping data for file relationships */
-    mappings: Record<string, Record<string, Mapping>>;
+    mappings: Record<string, Mapping>;
     /** Hierarchical results tracking */
     results: ResultsItem;
 };
 /**
- * Base arguments for registering generated content in the generation context.
- *
- * Provides the fundamental configuration options for registering imports,
- * re-exports, and definitions that will be included in generated files.
+ * Return shape of `CoreContext.toArtifacts` — the {@link RenderResult}
+ * plus the parse-time {@link ParseIssue} list collected from whichever
+ * protocol-specific parse context ran. Lives here rather than on
+ * `RenderResult` because the render phase itself doesn't produce
+ * parse issues; they're collected one phase earlier.
  */
-export type BaseRegisterArgs = {
-    /** Import statements to include, organized by module path */
-    imports?: Record<string, ImportNameArg[]>;
-    /** Re-export statements to include, organized by module path */
-    reExports?: Record<string, Identifier[]>;
-    /** Definition objects to include in the generated content */
-    definitions?: (Definition | undefined)[];
+export type ToArtifactsResult = RenderResult & {
+    parseIssues: ParseIssue[];
+    /**
+     * Per-file gen-maps sidecars. Populated only when
+     * `attribution.postPass` was configured on `ToArtifactsArgs`;
+     * otherwise omitted. Keys are the original file paths (the CLI
+     * writes them under `<basePath>/../.skmtc/<project>/.maps/`).
+     */
+    sidecars?: Record<string, Sidecar>;
+    /**
+     * Per-Definition generation-map entries gathered across every
+     * sidecar. Used for reverse queries ("which files came from refName
+     * X?"). Populated only when `attribution.postPass` was configured.
+     */
+    generationMap?: GenerationMapEntry[];
 };
 /**
  * Union type representing any supported OpenAPI document version.
@@ -89,12 +184,24 @@ export type BaseRegisterArgs = {
 export type AnyOasDocument = OpenAPIV2.Document | OpenAPIV3.Document | OpenAPIV3_1.Document;
 /**
  * Types of issues that can be encountered during OpenAPI schema parsing.
+ *
+ * The TS type and the valibot schema below stay in sync via the
+ * `v.GenericSchema<OasIssueType>` annotation — adding a variant in one
+ * place without the other fails to type-check.
+ */
+export type OasIssueType = 'UNEXPECTED_PROPERTY' | 'MISSING_OBJECT_TYPE' | 'MISSING_STRING_TYPE' | 'MISSING_ARRAY_TYPE' | 'MISSING_BOOLEAN_TYPE' | 'INVALID_EXAMPLE' | 'INVALID_ENUM' | 'INVALID_DEFAULT' | 'INVALID_NULLABLE' | 'UNEXPECTED_FORMAT' | 'INVALID_RESPONSE' | 'INVALID_FORMAT' | 'INVALID_OPERATION' | 'INVALID_SCHEMA' | 'INVALID_PARAMETER' | 'INVALID_SECURITY_SCHEME' | 'INVALID_DEPENDENCY_REF' | 'EXAMPLE_AND_EXAMPLES_DEFINED';
+/**
+ * Valibot schema for {@link OasIssueType}. Annotation deliberately omitted
+ * so the precise literal-union output type flows through to consumers
+ * (e.g. the `parseIssue` schema in `types/Manifest.ts`). Drift between
+ * this list and {@link OasIssueType} is caught by `assertSchemaMatchesType`
+ * below.
  */
-export type IssueType = 'UNEXPECTED_PROPERTY' | 'MISSING_OBJECT_TYPE' | 'MISSING_STRING_TYPE' | 'MISSING_ARRAY_TYPE' | 'MISSING_BOOLEAN_TYPE' | 'INVALID_EXAMPLE' | 'INVALID_ENUM' | 'INVALID_DEFAULT' | 'INVALID_NULLABLE' | 'UNEXPECTED_FORMAT' | 'INVALID_RESPONSE' | 'INVALID_FORMAT' | 'INVALID_OPERATION' | 'INVALID_SCHEMA' | 'INVALID_PARAMETER' | 'INVALID_DEPENDENCY_REF' | 'EXAMPLE_AND_EXAMPLES_DEFINED';
+export declare const oasIssueType: v.UnionSchema<[v.LiteralSchema<"UNEXPECTED_PROPERTY", undefined>, v.LiteralSchema<"MISSING_OBJECT_TYPE", undefined>, v.LiteralSchema<"MISSING_STRING_TYPE", undefined>, v.LiteralSchema<"MISSING_ARRAY_TYPE", undefined>, v.LiteralSchema<"MISSING_BOOLEAN_TYPE", undefined>, v.LiteralSchema<"INVALID_EXAMPLE", undefined>, v.LiteralSchema<"INVALID_ENUM", undefined>, v.LiteralSchema<"INVALID_DEFAULT", undefined>, v.LiteralSchema<"INVALID_NULLABLE", undefined>, v.LiteralSchema<"UNEXPECTED_FORMAT", undefined>, v.LiteralSchema<"INVALID_RESPONSE", undefined>, v.LiteralSchema<"INVALID_FORMAT", undefined>, v.LiteralSchema<"INVALID_OPERATION", undefined>, v.LiteralSchema<"INVALID_SCHEMA", undefined>, v.LiteralSchema<"INVALID_PARAMETER", undefined>, v.LiteralSchema<"INVALID_SECURITY_SCHEME", undefined>, v.LiteralSchema<"INVALID_DEPENDENCY_REF", undefined>, v.LiteralSchema<"EXAMPLE_AND_EXAMPLES_DEFINED", undefined>], undefined>;
 export type GenerateResult = {
-    files: Map<string, File | JsonFile>;
-    previews: Record<string, Record<string, Preview>>;
-    mappings: Record<string, Record<string, Mapping>>;
+    files: Map<string, FileBase>;
+    previews: Record<string, Preview>;
+    mappings: Record<string, Mapping>;
 };
 /**
  * Arguments for registering a JSON file in the generation context.
@@ -109,37 +216,23 @@ export type RegisterJsonArgs = {
     json: Record<string, unknown>;
 };
 /**
- * Arguments for defining and registering a value in the generation context.
- *
- * Used to create definitions from pre-generated values and register them
- * in the generation context for inclusion in output files.
- *
- * @template V - The generated value type extending GeneratedValue
- */
-export type DefineAndRegisterArgs<V extends GeneratedValue> = {
-    /** The identifier for the definition */
-    identifier: Identifier;
-    /** The generated value to define */
-    value: V;
-    /** The destination file path where the definition should be registered */
-    destinationPath: string;
-    /** Whether to exclude this definition from exports */
-    noExport?: boolean;
-};
-/**
- * Arguments for registering generated content with a specific destination.
- *
- * Extends BaseRegisterArgs to include a destination path, allowing content
- * to be registered and associated with a specific output file location.
+ * The neutral arguments the engine's `context.register` speaks — **pure
+ * data**, already standardised into language objects. `imports` are
+ * {@link ImportBase} (each language's register function converted its own
+ * concise form upstream); `definitions` are {@link DefinitionBase}. The
+ * engine never sees a concise / TS-shaped import vocabulary and never
+ * creates files: callers pre-create the destination file through their
+ * language (the lang's register function, the Drivers), and a file-miss
+ * here is a loud throw.
  */
-export type RegisterArgs = {
-    /** Import statements to include, organized by module path */
-    imports?: Record<string, ImportNameArg[]>;
-    /** Re-export statements to include, organized by module path */
-    reExports?: Record<string, Identifier[]>;
-    /** Definition objects to include in the generated content */
-    definitions?: (Definition | undefined)[];
-    /** The destination file path where the content should be registered */
+export type ContextRegisterArgs = {
+    /** Standardised imports to merge into the destination file. */
+    imports?: ImportBase[];
+    /** Standardised re-exports to merge into the destination file. */
+    reExports?: ReExportBase[];
+    /** Definition objects to include in the destination file. */
+    definitions?: (DefinitionBase | undefined)[];
+    /** The destination file path. */
     destinationPath: string;
 };
 /**
@@ -150,7 +243,7 @@ export type RegisterArgs = {
  *
  * @template Schema - The schema type (OasSchema, OasRef, or OasVoid)
  */
-export type InsertNormalisedModelArgs<Schema extends OasSchema | OasRef<'schema'> | OasVoid> = {
+export type InsertNormalizedModelArgs<Schema extends OasSchema | OasRef<'schema'> | OasVoid> = {
     /** Fallback name to use if the schema doesn't have a name */
     fallbackName: string;
     /** The OpenAPI schema to normalize and insert */
@@ -170,13 +263,27 @@ export type InsertModelOptions = {
     noExport?: boolean;
     /** Custom destination path for the model */
     destinationPath?: string;
+    /**
+     * Target variant of the peer model projection. Omit for `'main'`
+     * (the universally-safe default that every peer is guaranteed to
+     * honour). Pass explicitly only when the peer declares this
+     * variant — the Driver throws on mismatch.
+     */
+    variant?: string;
 };
 /**
  * Options for inserting a normalized model.
  */
-export type InsertNormalisedModelOptions = {
+export type InsertNormalizedModelOptions = {
     /** Whether to exclude this model from exports */
     noExport?: boolean;
+    /**
+     * Target variant of the peer model projection (`$ref` branch only).
+     * Omit for `'main'`. The inline-schema branch ignores this option
+     * because its Definition is one-off — bake the variant into
+     * `fallbackName` if you need variant-distinct inline schemas.
+     */
+    variant?: string;
 };
 /**
  * Arguments for picking a specific export from a generator module.
@@ -196,19 +303,72 @@ export type PickArgs = {
  * @template V - The value type for the model
  * @template EnrichmentType - Optional enrichment type for the model
  */
-export type BuildModelSettingsArgs<V, EnrichmentType = undefined> = {
+export type BuildModelSettingsArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
     refName: RefName;
-    insertable: ModelInsertable<V, EnrichmentType>;
+    projection: ModelProjection<V, EnrichmentType>;
+    /**
+     * Model variant whose enrichment / identifier / export path
+     * should be resolved (see {@link Variant}). Threaded from the
+     * Driver into the projection's static methods and the
+     * {@link ContentSettings} built for this insertion.
+     */
+    variant: string;
 };
 /**
- * Arguments for generating operation content settings.
+ * Arguments for generating OAS operation content settings.
  *
  * @template V - The value type for the operation
  * @template EnrichmentType - Optional enrichment type for the operation
  */
-export type ToOperationSettingsArgs<V, EnrichmentType = undefined> = {
+export type ToOasOperationSettingsArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
     operation: OasOperation;
-    insertable: OperationInsertable<V, EnrichmentType>;
+    projection: OasOperationProjection<V, EnrichmentType>;
+    /**
+     * Operation variant whose enrichment / identifier / export path
+     * should be resolved (see {@link Variant}). Threaded from the
+     * Driver into the projection's static methods and the
+     * {@link ContentSettings} built for this insertion.
+     */
+    variant: string;
+};
+/**
+ * Arguments for generating GraphQL operation content settings.
+ *
+ * @template V - The value type for the operation
+ * @template EnrichmentType - Optional enrichment type for the operation
+ */
+export type ToGqlOperationSettingsArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
+    operation: GqlOperation;
+    projection: GqlOperationProjection<V, EnrichmentType>;
+    /**
+     * Operation variant whose enrichment / identifier / export path
+     * should be resolved (see {@link Variant}).
+     */
+    variant: string;
+};
+/**
+ * Arguments accepted by `GenerateContext.toOperationContentSettings`.
+ *
+ * Discriminated by the runtime shape of `operation` — OAS operations carry
+ * an `oasType: 'operation'` discriminator; GraphQL operations carry
+ * `oasType: 'gqlOperation'`. The dispatcher narrows on this discriminator
+ * to look up the right enrichment path and identifier.
+ */
+export type ToOperationSettingsArgs<V extends GeneratedValue, EnrichmentType = undefined> = ToOasOperationSettingsArgs<V, EnrichmentType> | ToGqlOperationSettingsArgs<V, EnrichmentType>;
+/**
+ * Arguments accepted by `GenerateContext.toWebhookContentSettings`.
+ * Webhooks are OAS-only, so this is a single shape (no protocol union).
+ */
+export type ToWebhookSettingsArgs<V extends GeneratedValue, EnrichmentType = undefined> = {
+    webhook: OasWebhook;
+    projection: WebhookProjection<V, EnrichmentType>;
+    /**
+     * Webhook variant whose enrichment / identifier / export path should be
+     * resolved (see {@link Variant}). Threaded from the Driver into the
+     * projection's static methods and the {@link ContentSettings} built for
+     * this insertion.
+     */
+    variant: string;
 };
 /**
  * Return type for inserting a normalized model.
@@ -220,20 +380,43 @@ export type ToOperationSettingsArgs<V, EnrichmentType = undefined> = {
  * @template V - The generated value type
  * @template Schema - The schema type being processed
  */
-export type InsertNormalisedModelReturn<V extends GeneratedValue, Schema extends OasSchema | OasRef<'schema'> | OasVoid> = Schema extends OasRef<'schema'> ? Definition<V> : Definition<TypeSystemOutput<SchemaToNonRef<Schema>['type']>>;
+export type InsertNormalizedModelReturn<V extends GeneratedValue, Schema extends OasSchema | OasRef<'schema'> | OasVoid> = Schema extends OasRef<'schema'> ? DefinitionBase<V> : DefinitionBase<TypeSystemOutput<SchemaToNonRef<Schema>['type']>>;
 export type GenerateContextType = {
     settings: ClientSettings | undefined;
     modelDepth: Record<string, number>;
+    document: SkmtcParsedDocument;
+    /**
+     * Attribution (gen-maps) state. When set, every `SnippetBase`
+     * instance wraps its `toString` to record parent/child edges in a
+     * module-level render stack, so the post-render span resolver can
+     * attribute byte ranges to producers. When omitted, the wrap is
+     * skipped entirely — zero cost.
+     */
+    attribution?: AttributionState;
+    /**
+     * The active attribution capture sink, or `undefined` outside the
+     * capture interval. Read by every `SnippetBase` instance's `toString`
+     * wrapper; `RenderContext` opens/closes the interval through the shared
+     * {@link import('@/anchors/CaptureSink.ts').CaptureChannel} that
+     * `CoreContext` wires into both contexts. Bare test mocks read
+     * `undefined` and take the pass-through path.
+     */
+    captureSink: CaptureSink | undefined;
     toArtifacts: (stackTrail: StackTrail) => GenerateResult;
-    defineAndRegister: <V extends GeneratedValue>({ identifier, value, destinationPath, noExport }: DefineAndRegisterArgs<V>) => Definition<V>;
     registerJson: ({ destinationPath, json }: RegisterJsonArgs) => void;
-    register: ({ imports, definitions, destinationPath, reExports }: RegisterArgs) => void;
-    insertOperation: <V extends GeneratedValue, EnrichmentType = undefined>(insertable: OperationInsertable<V, EnrichmentType>, operation: OasOperation, options?: InsertOperationOptions) => Inserted<V, EnrichmentType>;
-    insertNormalisedModel: <V extends GeneratedValue, Schema extends OasSchema | OasRef<'schema'> | OasVoid, EnrichmentType>(insertable: ModelInsertable<V, EnrichmentType>, { schema, fallbackName, destinationPath }: InsertNormalisedModelArgs<Schema>, options?: InsertNormalisedModelOptions) => InsertNormalisedModelReturn<V, Schema>;
-    insertModel: <V extends GeneratedValue, EnrichmentType>(insertable: ModelInsertable<V, EnrichmentType>, refName: RefName, options?: InsertModelOptions) => Inserted<V, EnrichmentType>;
-    toOperationContentSettings: <V, EnrichmentType>({ operation, insertable }: ToOperationSettingsArgs<V, EnrichmentType>) => ContentSettings<EnrichmentType>;
-    toModelContentSettings: <V, EnrichmentType>({ refName, insertable }: BuildModelSettingsArgs<V, EnrichmentType>) => ContentSettings<EnrichmentType>;
+    register: (args: ContextRegisterArgs) => void;
+    /** Look up an existing file by path (no creation); the neutral read primitive. */
+    getFile: (filePath: string) => FileBase | undefined;
+    /** Store a language-constructed file; the neutral write primitive. */
+    addFile: (file: FileBase) => void;
+    insertOperation: <V extends GeneratedValue, EnrichmentType = undefined>(args: InsertOperationArgs<V, EnrichmentType>) => Inserted<V, EnrichmentType>;
+    insertNormalizedModel: <V extends GeneratedValue, Schema extends OasSchema | OasRef<'schema'> | OasVoid, EnrichmentType>(projection: ModelProjection<V, EnrichmentType>, { schema, fallbackName, destinationPath }: InsertNormalizedModelArgs<Schema>, options?: InsertNormalizedModelOptions) => InsertNormalizedModelReturn<V, Schema>;
+    insertModel: <V extends GeneratedValue, EnrichmentType>(projection: ModelProjection<V, EnrichmentType>, refName: RefName, options?: InsertModelOptions) => Inserted<V, EnrichmentType>;
+    toOperationContentSettings: <V extends GeneratedValue, EnrichmentType>({ operation, projection }: ToOperationSettingsArgs<V, EnrichmentType>) => ContentSettings<EnrichmentType>;
+    insertWebhook: <V extends GeneratedValue, EnrichmentType = undefined>(args: InsertWebhookArgs<V, EnrichmentType>) => Inserted<V, EnrichmentType>;
+    toWebhookContentSettings: <V extends GeneratedValue, EnrichmentType>({ webhook, projection, variant }: ToWebhookSettingsArgs<V, EnrichmentType>) => ContentSettings<EnrichmentType>;
+    toModelContentSettings: <V extends GeneratedValue, EnrichmentType>({ refName, projection, variant }: BuildModelSettingsArgs<V, EnrichmentType>) => ContentSettings<EnrichmentType>;
     resolveSchemaRefOnce: (refName: RefName, generatorId: string) => OasSchema | OasRef<'schema'>;
-    findDefinition: ({ name, exportPath }: PickArgs) => Definition | undefined;
+    findDefinition: ({ name, exportPath }: PickArgs) => DefinitionBase | undefined;
 };
 //# sourceMappingURL=generateTypes.d.ts.map

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

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

package/esm/context/generateTypes.js

@@ -1 +1,33 @@
-export {};
+import * as v from 'valibot';
+/**
+ * Valibot schema for {@link OasIssueType}. Annotation deliberately omitted
+ * so the precise literal-union output type flows through to consumers
+ * (e.g. the `parseIssue` schema in `types/Manifest.ts`). Drift between
+ * this list and {@link OasIssueType} is caught by `assertSchemaMatchesType`
+ * below.
+ */
+export const oasIssueType = v.union([
+    v.literal('UNEXPECTED_PROPERTY'),
+    v.literal('MISSING_OBJECT_TYPE'),
+    v.literal('MISSING_STRING_TYPE'),
+    v.literal('MISSING_ARRAY_TYPE'),
+    v.literal('MISSING_BOOLEAN_TYPE'),
+    v.literal('INVALID_EXAMPLE'),
+    v.literal('INVALID_ENUM'),
+    v.literal('INVALID_DEFAULT'),
+    v.literal('INVALID_NULLABLE'),
+    v.literal('UNEXPECTED_FORMAT'),
+    v.literal('INVALID_RESPONSE'),
+    v.literal('INVALID_FORMAT'),
+    v.literal('INVALID_OPERATION'),
+    v.literal('INVALID_SCHEMA'),
+    v.literal('INVALID_PARAMETER'),
+    v.literal('INVALID_SECURITY_SCHEME'),
+    v.literal('INVALID_DEPENDENCY_REF'),
+    v.literal('EXAMPLE_AND_EXAMPLES_DEFINED')
+]);
+// Compile-time drift detector: this binding fails to type-check if
+// `OasIssueType` and the literal list above disagree in either
+// direction (added/removed/typoed variant).
+const _oasIssueTypeDriftCheck = oasIssueType;
+void _oasIssueTypeDriftCheck;