@skmtc/core 0.27.0 → 0.28.0

package/esm/enrichments/findUnknownKeys.js

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Unknown-key detection for enrichment leaves.
+ *
+ * Valibot's `v.object` strips keys the schema does not declare — a
+ * misspelled optional key (`submitLabl` for `submitLabel`) parses cleanly
+ * and the generator silently sees the default. `findUnknownKeys` walks a
+ * value against its schema and reports every key the schema would drop,
+ * so `parseEnrichmentUmbrella` can surface them as
+ * `UNKNOWN_ENRICHMENT_KEY` warnings.
+ *
+ * Comparing against the *schema* (not the parsed output) keeps the check
+ * immune to `v.pipe` transforms that legitimately reshape output, and
+ * gives correct "did you mean …?" suggestions — the intended key is in
+ * the schema's entries even when it is optional and absent from the
+ * parsed value. This is deliberately a warning layer, not
+ * `v.strictObject`: a shared client.json paired with an older generator
+ * version stays survivable under version skew instead of hard-failing.
+ *
+ * The walk is fail-open: unions, intersections, loose objects, and any
+ * shape it cannot attribute keys to are left alone.
+ *
+ * @module findUnknownKeys
+ */
+import { isEntriesRecord, isValibotSchema, unwrap } from './valibotShape.js';
+import { nearestKey } from '../helpers/nearestKey.js';
+const isRecord = (input) => typeof input === 'object' && input !== null && !Array.isArray(input);
+const walk = (rawSchema, value, path, out) => {
+    if (value === undefined || value === null)
+        return;
+    if (!isValibotSchema(rawSchema))
+        return;
+    // A piped schema spreads its base, so `type` / `entries` / `item` are
+    // still visible here — no explicit pipe handling needed.
+    const { inner } = unwrap(rawSchema);
+    switch (inner.type) {
+        case 'object': {
+            if (!isRecord(value) || !isEntriesRecord(inner.entries))
+                return;
+            const entries = inner.entries;
+            const declared = Object.keys(entries);
+            for (const [key, member] of Object.entries(value)) {
+                if (key in entries) {
+                    walk(entries[key], member, [...path, key], out);
+                    continue;
+                }
+                const suggestion = nearestKey(key, declared);
+                out.push({ path: [...path, key], ...(suggestion !== undefined ? { suggestion } : {}) });
+            }
+            return;
+        }
+        case 'record': {
+            if (!isRecord(value))
+                return;
+            for (const [key, member] of Object.entries(value)) {
+                walk(inner.value, member, [...path, key], out);
+            }
+            return;
+        }
+        case 'array': {
+            if (!Array.isArray(value))
+                return;
+            value.forEach((member, index) => walk(inner.item, member, [...path, String(index)], out));
+            return;
+        }
+        default:
+            // Leaves, unions, intersections, loose/strict objects: nothing to
+            // attribute, or Valibot itself errors loudly (strict). Fail open.
+            return;
+    }
+};
+/**
+ * Every key in `value` that `schema` does not declare and `v.parse` would
+ * therefore drop. Wrong-typed values are not this function's concern —
+ * the subsequent `v.parse` throws on those as before.
+ */
+export const findUnknownKeys = (schema, value) => {
+    const out = [];
+    walk(schema, value, [], out);
+    return out;
+};

package/esm/enrichments/parseEnrichmentUmbrella.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview The shared umbrella-parse seam for the projection-base
+ * factories.
+ *
+ * Every `static toEnrichments` — OAS operation, webhook, GQL operation,
+ * model — assembles the same `{ subject, generator, stack }` umbrella
+ * from three storage spots and parses it through the generator's
+ * composite schema. This helper centralizes that assembly so both
+ * enrichment-validation mechanisms ride one seam:
+ *
+ *  - the reads go through `context.readEnrichment` — the recording
+ *    accessor feeding the consumption audit (`EnrichmentAudit`);
+ *  - the raw values are diffed against the schema (`findUnknownKeys`)
+ *    and dropped keys surface as `UNKNOWN_ENRICHMENT_KEY` warnings.
+ *
+ * The `stack` scope is exempt from unknown-key detection: it is a single
+ * bag shared by every generator in the composition, and each consumer
+ * declares only the fields it reads — keys other generators own are
+ * expected, not typos.
+ *
+ * A wrong-typed value still throws exactly as before — the `v.parse` at
+ * the end is unchanged, and unknown-key detection runs first so a
+ * throwing leaf doesn't hide a dropped key.
+ *
+ * @module parseEnrichmentUmbrella
+ */
+import * as v from 'valibot';
+import { type EnrichmentWarning } from './EnrichmentWarning.js';
+/**
+ * Minimal structural view of the context the parse needs. Any
+ * `GenerateContext` satisfies it; kept structural so the helper stays
+ * decoupled from the full context type and is trivially testable.
+ */
+type UmbrellaParseContext = {
+    readEnrichment: (segments: readonly string[]) => unknown;
+    reportEnrichmentWarning: (warning: EnrichmentWarning) => void;
+};
+type ParseEnrichmentUmbrellaArgs<EnrichmentType> = {
+    context: UmbrellaParseContext;
+    generatorId: string;
+    /**
+     * Subject routing segments under `[generatorId]`, including the
+     * variant — `[path, method, variant]` for OAS operations,
+     * `[name, method, variant]` for webhooks,
+     * `[rootKind, fieldName, variant]` for GQL operations,
+     * `[refName, variant]` for models.
+     */
+    subjectSegments: readonly string[];
+    /** The generator's composite `{ subject, generator, stack }` schema. */
+    schema: v.GenericSchema<EnrichmentType>;
+};
+/**
+ * Assemble and parse one `{ subject, generator, stack }` enrichment
+ * umbrella, recording the reads for the consumption audit and reporting
+ * schema-dropped keys.
+ *
+ * @throws on a wrong-typed value, exactly like the raw `v.parse` this
+ *   wraps — the generator's item is then recorded as `error` and the run
+ *   continues (fail-open).
+ */
+export declare const parseEnrichmentUmbrella: <EnrichmentType>({ context, generatorId, subjectSegments, schema }: ParseEnrichmentUmbrellaArgs<EnrichmentType>) => EnrichmentType;
+export {};
+//# sourceMappingURL=parseEnrichmentUmbrella.d.ts.map

package/esm/enrichments/parseEnrichmentUmbrella.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseEnrichmentUmbrella.d.ts","sourceRoot":"","sources":["../../src/enrichments/parseEnrichmentUmbrella.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAErF;;;;GAIG;AACH,KAAK,oBAAoB,GAAG;IAC1B,cAAc,EAAE,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAA;IACxD,uBAAuB,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAC9D,CAAA;AAED,KAAK,2BAA2B,CAAC,cAAc,IAAI;IACjD,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,wEAAwE;IACxE,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;CACxC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAAI,cAAc,EAAE,mDAKrD,2BAA2B,CAAC,cAAc,CAAC,KAAG,cAgChD,CAAA"}

package/esm/enrichments/parseEnrichmentUmbrella.js

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview The shared umbrella-parse seam for the projection-base
+ * factories.
+ *
+ * Every `static toEnrichments` — OAS operation, webhook, GQL operation,
+ * model — assembles the same `{ subject, generator, stack }` umbrella
+ * from three storage spots and parses it through the generator's
+ * composite schema. This helper centralizes that assembly so both
+ * enrichment-validation mechanisms ride one seam:
+ *
+ *  - the reads go through `context.readEnrichment` — the recording
+ *    accessor feeding the consumption audit (`EnrichmentAudit`);
+ *  - the raw values are diffed against the schema (`findUnknownKeys`)
+ *    and dropped keys surface as `UNKNOWN_ENRICHMENT_KEY` warnings.
+ *
+ * The `stack` scope is exempt from unknown-key detection: it is a single
+ * bag shared by every generator in the composition, and each consumer
+ * declares only the fields it reads — keys other generators own are
+ * expected, not typos.
+ *
+ * A wrong-typed value still throws exactly as before — the `v.parse` at
+ * the end is unchanged, and unknown-key detection runs first so a
+ * throwing leaf doesn't hide a dropped key.
+ *
+ * @module parseEnrichmentUmbrella
+ */
+import * as v from 'valibot';
+import { GENERATOR_ENRICHMENT_KEY, STACK_ENRICHMENT_KEY } from '../types/Enrichments.js';
+import { findUnknownKeys } from './findUnknownKeys.js';
+import { formatEnrichmentPath } from './EnrichmentWarning.js';
+/**
+ * Assemble and parse one `{ subject, generator, stack }` enrichment
+ * umbrella, recording the reads for the consumption audit and reporting
+ * schema-dropped keys.
+ *
+ * @throws on a wrong-typed value, exactly like the raw `v.parse` this
+ *   wraps — the generator's item is then recorded as `error` and the run
+ *   continues (fail-open).
+ */
+export const parseEnrichmentUmbrella = ({ context, generatorId, subjectSegments, schema }) => {
+    const raw = {
+        subject: context.readEnrichment([generatorId, ...subjectSegments]),
+        generator: context.readEnrichment([generatorId, GENERATOR_ENRICHMENT_KEY]),
+        stack: context.readEnrichment([STACK_ENRICHMENT_KEY])
+    };
+    // Diff the generator-owned scopes against the schema (stack excluded —
+    // shared bag). Walking the umbrella keeps the scope schemas attributed
+    // without reaching into the composite's entries.
+    const unknownKeys = findUnknownKeys(schema, { subject: raw.subject, generator: raw.generator });
+    for (const { path, suggestion } of unknownKeys) {
+        const [scope, ...leafPath] = path;
+        const routingPath = scope === 'subject'
+            ? [generatorId, ...subjectSegments, ...leafPath]
+            : [generatorId, GENERATOR_ENRICHMENT_KEY, ...leafPath];
+        context.reportEnrichmentWarning({
+            level: 'warning',
+            type: 'UNKNOWN_ENRICHMENT_KEY',
+            path: routingPath,
+            message: `unknown enrichment key '${routingPath[routingPath.length - 1]}' at ` +
+                `'${formatEnrichmentPath(routingPath.slice(0, -1))}' — ignored` +
+                (suggestion !== undefined ? ` (did you mean '${suggestion}'?)` : ''),
+            ...(suggestion !== undefined ? { suggestion } : {})
+        });
+    }
+    return v.parse(schema, raw);
+};

package/esm/enrichments/toEnrichmentDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toEnrichmentDescriptor.d.ts","sourceRoot":"","sources":["../../src/enrichments/toEnrichmentDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAGjC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,GACD;IACE,IAAI,EAAE,cAAc,CAAA;IACpB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAA;CACtB,GACD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,kCAAkC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAEL;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAExE,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;AAEzD,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAA;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAA;CACxC,CAAA;AAqJD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,aAAa,GAAG,SAAS,KAAG,eAAe,EAKvF,CAAA;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,gBAAgB,KAAG,oBAK/D,CAAA"}
+{"version":3,"file":"toEnrichmentDescriptor.d.ts","sourceRoot":"","sources":["../../src/enrichments/toEnrichmentDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAUjC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,GACD;IACE,IAAI,EAAE,cAAc,CAAA;IACpB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GACD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAA;CACtB,GACD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,kCAAkC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAEL;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAExE,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;AAEzD,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,aAAa,CAAA;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAA;CACxC,CAAA;AAwGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,aAAa,GAAG,SAAS,KAAG,eAAe,EAKvF,CAAA;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,gBAAgB,KAAG,oBAK/D,CAAA"}

package/esm/enrichments/toEnrichmentDescriptor.js

@@ -1,25 +1,6 @@
 import { moduleTypeOf } from '../types/ModuleSelect.js';
-const isValibotSchema = (input) => typeof input === 'object' &&
-    input !== null &&
-    'type' in input &&
-    typeof input.type === 'string';
-const isEntriesRecord = (input) => typeof input === 'object' && input !== null;
+import { baseOf, isEntriesRecord, isValibotSchema, unwrap } from './valibotShape.js';
 const isOptionsArray = (input) => Array.isArray(input);
-const WRAPPER_TYPES = new Set(['optional', 'nullable', 'nullish']);
-const unwrap = (schema) => {
-    if (WRAPPER_TYPES.has(schema.type) && isValibotSchema(schema.wrapped)) {
-        return { inner: schema.wrapped, optional: true };
-    }
-    return { inner: schema, optional: false };
-};
-/**
- * A `v.pipe(base, …actions)` schema spreads `base` and adds a `pipe` array
- * whose first element IS the original base schema. The `moduleSelect`
- * registry lookup must therefore also check the pipe's base, or piping a
- * moduleSelect through metadata (`v.title(…)`) would silently demote it to
- * a generic object widget.
- */
-const baseOf = (schema) => Array.isArray(schema.pipe) && isValibotSchema(schema.pipe[0]) ? schema.pipe[0] : schema;
 /** The `v.title(…)` metadata riding a piped schema, if any — the field label. */
 const titleOf = (schema) => {
     if (!Array.isArray(schema.pipe))

package/esm/enrichments/valibotShape.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Structural view of Valibot schemas as observed at runtime.
+ *
+ * Valibot's declared `GenericSchema` is opaque (intentionally a black box
+ * for parse calls) but the runtime objects expose tagged-union shape via
+ * `type` plus the wrapper / container properties below. The walkers that
+ * traverse generator enrichment schemas — `toEnrichmentDescriptor` (form
+ * projection) and `findUnknownKeys` (dropped-key detection) — narrow into
+ * this view once at each entry point and stay inside it.
+ *
+ * @module valibotShape
+ */
+import type * as v from 'valibot';
+/**
+ * The runtime shape of a Valibot schema node. `wrapped` carries the inner
+ * schema of `optional` / `nullable` / `nullish` wrappers; `entries` the
+ * member schemas of an `object`; `item` an `array`'s element schema;
+ * `key` / `value` a `record`'s key and value schemas; `options` a
+ * `picklist` / union's choices; `pipe` a `v.pipe(...)`'s action chain
+ * (whose first element is the base schema).
+ */
+export type ValibotSchemaShape = {
+    readonly type: string;
+    readonly wrapped?: unknown;
+    readonly entries?: unknown;
+    readonly item?: unknown;
+    readonly key?: unknown;
+    readonly value?: unknown;
+    readonly options?: unknown;
+    readonly pipe?: unknown;
+};
+export declare const isValibotSchema: (input: unknown) => input is ValibotSchemaShape;
+export declare const isEntriesRecord: (input: unknown) => input is Record<string, v.GenericSchema>;
+/**
+ * Strip a single `optional` / `nullable` / `nullish` wrapper, reporting
+ * whether one was present. Wrappers don't nest in practice (a schema is
+ * declared optional once), so one level suffices.
+ */
+export declare const unwrap: (schema: ValibotSchemaShape) => {
+    inner: ValibotSchemaShape;
+    optional: boolean;
+};
+/**
+ * A `v.pipe(base, …actions)` schema spreads `base` and adds a `pipe` array
+ * whose first element IS the original base schema. Lookups keyed on schema
+ * *identity* (e.g. the `moduleSelect` registry) must therefore also check
+ * the pipe's base, or piping a schema through metadata (`v.title(…)`)
+ * would silently break the lookup.
+ */
+export declare const baseOf: (schema: ValibotSchemaShape) => ValibotSchemaShape;
+//# sourceMappingURL=valibotShape.d.ts.map

package/esm/enrichments/valibotShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valibotShape.d.ts","sourceRoot":"","sources":["../../src/enrichments/valibotShape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAEjC;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,kBAIH,CAAA;AAEvD,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAC3C,CAAA;AAI7C;;;;GAIG;AACH,eAAO,MAAM,MAAM,GACjB,QAAQ,kBAAkB,KACzB;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAKhD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,kBAAkB,KAAG,kBACqC,CAAA"}

package/esm/enrichments/valibotShape.js

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Structural view of Valibot schemas as observed at runtime.
+ *
+ * Valibot's declared `GenericSchema` is opaque (intentionally a black box
+ * for parse calls) but the runtime objects expose tagged-union shape via
+ * `type` plus the wrapper / container properties below. The walkers that
+ * traverse generator enrichment schemas — `toEnrichmentDescriptor` (form
+ * projection) and `findUnknownKeys` (dropped-key detection) — narrow into
+ * this view once at each entry point and stay inside it.
+ *
+ * @module valibotShape
+ */
+export const isValibotSchema = (input) => typeof input === 'object' &&
+    input !== null &&
+    'type' in input &&
+    typeof input.type === 'string';
+export const isEntriesRecord = (input) => typeof input === 'object' && input !== null;
+const WRAPPER_TYPES = new Set(['optional', 'nullable', 'nullish']);
+/**
+ * Strip a single `optional` / `nullable` / `nullish` wrapper, reporting
+ * whether one was present. Wrappers don't nest in practice (a schema is
+ * declared optional once), so one level suffices.
+ */
+export const unwrap = (schema) => {
+    if (WRAPPER_TYPES.has(schema.type) && isValibotSchema(schema.wrapped)) {
+        return { inner: schema.wrapped, optional: true };
+    }
+    return { inner: schema, optional: false };
+};
+/**
+ * A `v.pipe(base, …actions)` schema spreads `base` and adds a `pipe` array
+ * whose first element IS the original base schema. Lookups keyed on schema
+ * *identity* (e.g. the `moduleSelect` registry) must therefore also check
+ * the pipe's base, or piping a schema through metadata (`v.title(…)`)
+ * would silently break the lookup.
+ */
+export const baseOf = (schema) => Array.isArray(schema.pipe) && isValibotSchema(schema.pipe[0]) ? schema.pipe[0] : schema;

package/esm/helpers/nearestKey.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Nearest-key suggestion for "did you mean …?" hints.
+ *
+ * Used by the enrichment validation surfaces (`EnrichmentAudit`,
+ * `findUnknownKeys`) to pair an unrecognized key with its closest known
+ * sibling. Pure string utility — no context, no schema awareness.
+ *
+ * @module nearestKey
+ */
+/**
+ * The candidate closest to `target`, or `undefined` when nothing is close
+ * enough to be a plausible typo. A case-only mismatch (`POST` for `post`)
+ * always wins; otherwise candidates compete within a small edit-distance
+ * budget (1 for short keys, 2 otherwise). An exact match returns
+ * `undefined` — a key that exists needs no suggestion.
+ */
+export declare const nearestKey: (target: string, candidates: Iterable<string>) => string | undefined;
+//# sourceMappingURL=nearestKey.d.ts.map

package/esm/helpers/nearestKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearestKey.d.ts","sourceRoot":"","sources":["../../src/helpers/nearestKey.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+BH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,YAAY,QAAQ,CAAC,MAAM,CAAC,KAAG,MAAM,GAAG,SAmBlF,CAAA"}

package/esm/helpers/nearestKey.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Nearest-key suggestion for "did you mean …?" hints.
+ *
+ * Used by the enrichment validation surfaces (`EnrichmentAudit`,
+ * `findUnknownKeys`) to pair an unrecognized key with its closest known
+ * sibling. Pure string utility — no context, no schema awareness.
+ *
+ * @module nearestKey
+ */
+/**
+ * Levenshtein edit distance with an early-exit bound: returns
+ * `bound + 1` as soon as the distance provably exceeds `bound`, so
+ * candidate scans stay cheap on long, unrelated keys.
+ */
+const editDistance = (a, b, bound) => {
+    if (Math.abs(a.length - b.length) > bound)
+        return bound + 1;
+    if (a === b)
+        return 0;
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i++) {
+        const current = [i];
+        let rowMinimum = i;
+        for (let j = 1; j <= b.length; j++) {
+            const substitution = previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1);
+            const value = Math.min(previous[j] + 1, current[j - 1] + 1, substitution);
+            current.push(value);
+            rowMinimum = Math.min(rowMinimum, value);
+        }
+        if (rowMinimum > bound)
+            return bound + 1;
+        previous = current;
+    }
+    return previous[b.length];
+};
+/**
+ * The candidate closest to `target`, or `undefined` when nothing is close
+ * enough to be a plausible typo. A case-only mismatch (`POST` for `post`)
+ * always wins; otherwise candidates compete within a small edit-distance
+ * budget (1 for short keys, 2 otherwise). An exact match returns
+ * `undefined` — a key that exists needs no suggestion.
+ */
+export const nearestKey = (target, candidates) => {
+    const bound = target.length <= 4 ? 1 : 2;
+    const lowerTarget = target.toLowerCase();
+    let best;
+    let bestDistance = bound + 1;
+    for (const candidate of candidates) {
+        if (candidate === target)
+            return undefined;
+        if (candidate.toLowerCase() === lowerTarget)
+            return candidate;
+        const distance = editDistance(target, candidate, bound);
+        if (distance < bestDistance) {
+            best = candidate;
+            bestDistance = distance;
+        }
+    }
+    return best;
+};

package/esm/mod.d.ts

@@ -201,6 +201,8 @@ export * from './types/SchemaPath.js';
 export * from './enrichments/toEnrichmentDescriptor.js';
 export * from './enrichments/validateConfig.js';
 export * from './enrichments/readEnrichments.js';
+export * from './enrichments/EnrichmentWarning.js';
+export * from './enrichments/findUnknownKeys.js';
 export * from './types/Preview.js';
 export * from './types/RefName.js';
 export * from './types/Results.js';

package/esm/mod.d.ts.map

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

package/esm/mod.js

@@ -199,6 +199,8 @@ export * from './types/SchemaPath.js';
 export * from './enrichments/toEnrichmentDescriptor.js';
 export * from './enrichments/validateConfig.js';
 export * from './enrichments/readEnrichments.js';
+export * from './enrichments/EnrichmentWarning.js';
+export * from './enrichments/findUnknownKeys.js';
 export * from './types/Preview.js';
 export * from './types/RefName.js';
 export * from './types/Results.js';

package/esm/run/toArtifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toArtifacts.d.ts","sourceRoot":"","sources":["../../src/run/toArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,KAAK,aAAa,GAAG;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,UAAU,EAAE,UAAU,CAAA;IACtB,4DAA4D;IAC5D,oBAAoB,EAAE,CAAC,cAAc,GAAG,SAAS,OAAO,sBAAsB,CAAC,cAAc,CAAC,CAAA;IAC9F,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,WAAW,GAAI,4HAYzB,aAAa,KAAG;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACpC,UAAU,CAAC,EAAE,OAAO,CAAA;CA6BrB,CAAA"}
+{"version":3,"file":"toArtifacts.d.ts","sourceRoot":"","sources":["../../src/run/toArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AACH,KAAK,aAAa,GAAG;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,UAAU,EAAE,UAAU,CAAA;IACtB,4DAA4D;IAC5D,oBAAoB,EAAE,CAAC,cAAc,GAAG,SAAS,OAAO,sBAAsB,CAAC,cAAc,CAAC,CAAA;IAC9F,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,WAAW,GAAI,4HAYzB,aAAa,KAAG;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACpC,UAAU,CAAC,EAAE,OAAO,CAAA;CAuCrB,CAAA"}

package/esm/run/toArtifacts.js

@@ -69,7 +69,7 @@ import { CoreContext } from '../context/CoreContext.js';
  */
 export const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution, inspect }) => {
     const context = new CoreContext({ spanId, logsPath, silent });
-    const { artifacts, files, previews, results, parseIssues, sidecars, generationMap, inspection } = context.toArtifacts({
+    const { artifacts, files, previews, results, parseIssues, enrichmentWarnings, sidecars, generationMap, inspection } = context.toArtifacts({
         settings,
         toGeneratorConfigMap,
         document,
@@ -85,6 +85,7 @@ export const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorCo
         spanId,
         results,
         parseIssues,
+        enrichmentWarnings,
         deploymentId: Date.now().toString(),
         region: undefined,
         startAt,

package/esm/types/Manifest.d.ts

@@ -74,6 +74,7 @@ import "../_dnt.polyfills.js";
 import { type ResultsItem } from './Results.js';
 import { type Preview } from './Preview.js';
 import type { ParseIssue } from '../context/ParseIssue.js';
+import { type EnrichmentWarning } from '../enrichments/EnrichmentWarning.js';
 import * as v from 'valibot';
 export type ManifestEntry = {
     lines: number;
@@ -109,6 +110,14 @@ export type ManifestContent = {
      * it from `.settings/manifest.json` without re-running.
      */
     parseIssues: ParseIssue[];
+    /**
+     * Enrichment addressing / unknown-key warnings recorded during the
+     * generate phase — dead config the engine never consumed, keys the
+     * generator's schema dropped, and info lines for enrichments on
+     * skipped items. Empty for a clean run; optional so manifests written
+     * by older cores still parse.
+     */
+    enrichmentWarnings?: EnrichmentWarning[];
     startAt: number;
     endAt: number;
 };

package/esm/types/Manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../../src/types/Manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAG1D,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4D5B,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAKvD,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAGnD,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,OAAO,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAW3D,CAAA"}
+{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../../src/types/Manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAG/F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4D5B,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAKvD,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAGnD,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,OAAO,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAY3D,CAAA"}

package/esm/types/Manifest.js

@@ -73,6 +73,7 @@
 import "../_dnt.polyfills.js";
 import { resultsItem } from './Results.js';
 import { preview } from './Preview.js';
+import { enrichmentWarning } from '../enrichments/EnrichmentWarning.js';
 import { oasIssueType } from '../context/generateTypes.js';
 import { gqlIssueType } from '../context/ParseIssue.js';
 import * as v from 'valibot';
@@ -152,6 +153,7 @@ export const manifestContent = v.object({
     previews: v.record(v.string(), preview),
     results: resultsItem,
     parseIssues: v.array(parseIssue),
+    enrichmentWarnings: v.optional(v.array(enrichmentWarning)),
     startAt: v.number(),
     endAt: v.number()
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skmtc/core",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Skmtc is a declarative code generation framework",
   "keywords": [
     "openapi",

package/script/context/CoreContext.d.ts.map

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

package/script/context/CoreContext.js

@@ -272,7 +272,7 @@ class CoreContext {
             // reads this slot; RenderContext flips it around the one capturing
             // render. One object per run wires the two phases together.
             const captureChannel = { sink: undefined };
-            const { files, previews, inspection } = stackTrail.trace('generate', st => {
+            const { files, previews, inspection, enrichmentWarnings } = stackTrail.trace('generate', st => {
                 const generatePhase = __classPrivateFieldGet(this, _CoreContext_instances, "m", _CoreContext_setupGeneratePhase).call(this, {
                     toGeneratorConfigMap,
                     document: parsedDocument,
@@ -308,6 +308,7 @@ class CoreContext {
                 ...renderOutput,
                 results: __classPrivateFieldGet(this, _CoreContext_results, "f").toTree(),
                 parseIssues: phase.context.issues,
+                enrichmentWarnings,
                 inspection
             };
         }
@@ -343,7 +344,8 @@ class CoreContext {
                 files: {},
                 previews: {},
                 results: __classPrivateFieldGet(this, _CoreContext_results, "f").toTree(),
-                parseIssues: [...priorIssues, fatalIssue]
+                parseIssues: [...priorIssues, fatalIssue],
+                enrichmentWarnings: []
             };
         }
         finally {

package/script/context/GenerateContext.d.ts

@@ -26,6 +26,7 @@ import type { OasOperationSource, WebhookSource, GqlOperationSource, ModelSource
 import type { GqlOperation } from '../gql/operation/GqlOperation.js';
 import type { OasVoid } from '../oas/void/Void.js';
 import type { ModelProjection } from '../dsl/model/types.js';
+import { type EnrichmentWarning } from '../enrichments/EnrichmentWarning.js';
 type ConstructorArgs = {
     /**
      * Source document for generation, wrapped in the {@link SkmtcParsedDocument}
@@ -150,6 +151,17 @@ export declare class GenerateContext implements GenerateContextType {
     /** Tracking model nesting depth to prevent infinite recursion */
     modelDepth: Record<string, number>;
     constructor({ document, settings, logger, captureCurrentResult, toGeneratorConfigMap, captureChannel }: ConstructorArgs);
+    /**
+     * The recording enrichment accessor — the single choke point every
+     * enrichment lookup routes through (dispatch loops, projection-base
+     * `toEnrichments`, the Drivers' peer-variant guards). Segments are
+     * literal keys (the array form of `get` keeps dotted paths intact);
+     * the read is recorded so the post-walk consumption audit can flag
+     * configured entries no lookup ever touched.
+     */
+    readEnrichment(segments: readonly string[]): unknown;
+    /** Add a warning to this run's enrichment audit (deduplicated). */
+    reportEnrichmentWarning(warning: EnrichmentWarning): void;
     /**
      * The active attribution capture sink, or `undefined` outside the
      * capture interval. Every `SnippetBase` instance's `toString` wrapper