@skmtc/core 0.27.0 → 0.28.1

package/esm/enrichments/EnrichmentWarning.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview The enrichment-warning surface — the manifest's record of
+ * enrichment config that did not do what the consumer intended.
+ *
+ * Three validation layers precede this one: structural validation at CLI
+ * load (`generatorEnrichments`), the per-leaf Valibot parse at generate
+ * time (a wrongly-typed value in a reached leaf throws), and the
+ * missing-`'main'` variant throw (`toVariantList`). All three are loud.
+ * What they cannot see is *addressing*: a typo'd generator id, path,
+ * method, or model name makes `get()` miss silently — defaults apply and
+ * the config entry is dead. Unknown leaf keys are equally silent:
+ * `v.object` strips them before the generator sees them.
+ *
+ * `EnrichmentWarning` is the shared shape for both detectors:
+ *
+ *  - the **consumption audit** (`EnrichmentAudit`) — records every
+ *    enrichment lookup the engine performs during the generate walk and,
+ *    post-walk, flags configured entries no lookup ever touched;
+ *  - **unknown-key detection** (`findUnknownKeys`, run inside
+ *    `parseEnrichmentUmbrella`) — flags leaf keys the generator's schema
+ *    does not declare.
+ *
+ * Both are warn-level and fail-open: generation output is never affected.
+ * The warnings ride the manifest (`manifest.enrichmentWarnings`) so
+ * post-run diagnostics can re-read them without re-running.
+ *
+ * @module EnrichmentWarning
+ */
+import * as v from 'valibot';
+export const enrichmentWarningType = v.picklist([
+    'UNCONSUMED_ENRICHMENT',
+    'UNKNOWN_GENERATOR_ID',
+    'UNKNOWN_ENRICHMENT_KEY',
+    'SKIPPED_SUBJECT_ENRICHMENT',
+    'SKIPPED_GENERATOR_ENRICHMENT'
+]);
+export const enrichmentWarning = v.object({
+    level: v.picklist(['warning', 'info']),
+    type: enrichmentWarningType,
+    path: v.array(v.string()),
+    message: v.string(),
+    suggestion: v.optional(v.string())
+});
+/**
+ * Render a routing path for warning messages:
+ * `['@skmtc/gen-shadcn-form', '/pets', 'post']` →
+ * `'@skmtc/gen-shadcn-form → /pets → post'`. The arrow separator keeps
+ * segments visually distinct even when they contain dots or slashes.
+ */
+export const formatEnrichmentPath = (path) => path.join(' → ');

package/esm/enrichments/findUnknownKeys.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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
+ */
+/**
+ * One key the schema would silently drop. `path` runs from the walked
+ * root down to the unknown key (array indices as strings); `suggestion`
+ * is the nearest declared key at the same level, when a plausible typo
+ * target exists.
+ */
+export type UnknownKey = {
+    path: string[];
+    suggestion?: string;
+};
+/**
+ * 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 declare const findUnknownKeys: (schema: unknown, value: unknown) => UnknownKey[];
+//# sourceMappingURL=findUnknownKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findUnknownKeys.d.ts","sourceRoot":"","sources":["../../src/enrichments/findUnknownKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAgDD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,EAAE,OAAO,OAAO,KAAG,UAAU,EAI3E,CAAA"}

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()
 });