@skmtc/core 0.27.0 → 0.28.1

package/script/enrichments/parseEnrichmentUmbrella.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * @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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEnrichmentUmbrella = void 0;
+const v = __importStar(require("valibot"));
+const Enrichments_js_1 = require("../types/Enrichments.js");
+const findUnknownKeys_js_1 = require("./findUnknownKeys.js");
+const EnrichmentWarning_js_1 = require("./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).
+ */
+const parseEnrichmentUmbrella = ({ context, generatorId, subjectSegments, schema }) => {
+    const raw = {
+        subject: context.readEnrichment([generatorId, ...subjectSegments]),
+        generator: context.readEnrichment([generatorId, Enrichments_js_1.GENERATOR_ENRICHMENT_KEY]),
+        stack: context.readEnrichment([Enrichments_js_1.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 = (0, findUnknownKeys_js_1.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, Enrichments_js_1.GENERATOR_ENRICHMENT_KEY, ...leafPath];
+        context.reportEnrichmentWarning({
+            level: 'warning',
+            type: 'UNKNOWN_ENRICHMENT_KEY',
+            path: routingPath,
+            message: `unknown enrichment key '${routingPath[routingPath.length - 1]}' at ` +
+                `'${(0, EnrichmentWarning_js_1.formatEnrichmentPath)(routingPath.slice(0, -1))}' — ignored` +
+                (suggestion !== undefined ? ` (did you mean '${suggestion}'?)` : ''),
+            ...(suggestion !== undefined ? { suggestion } : {})
+        });
+    }
+    return v.parse(schema, raw);
+};
+exports.parseEnrichmentUmbrella = parseEnrichmentUmbrella;

package/script/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/script/enrichments/toEnrichmentDescriptor.js

@@ -2,27 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toEnrichmentDescriptor = exports.toEnrichmentFields = void 0;
 const ModuleSelect_js_1 = require("../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;
+const valibotShape_js_1 = require("./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))
@@ -49,7 +30,7 @@ const titleOf = (schema) => {
  * rule is structural — it names no scope, so it composes with the generic
  * object walk rather than special-casing `subject` / `generator` / `stack`.
  */
-const isOmittedMember = (rawSchema) => isValibotSchema(rawSchema) && unwrap(rawSchema).inner.type === 'undefined';
+const isOmittedMember = (rawSchema) => (0, valibotShape_js_1.isValibotSchema)(rawSchema) && (0, valibotShape_js_1.unwrap)(rawSchema).inner.type === 'undefined';
 const toLabel = (key) => {
     if (key === '')
         return '';
@@ -57,7 +38,7 @@ const toLabel = (key) => {
     return spaced.charAt(0).toUpperCase() + spaced.slice(1);
 };
 const typeFor = (schema) => {
-    const moduleType = (0, ModuleSelect_js_1.moduleTypeOf)(schema) ?? (0, ModuleSelect_js_1.moduleTypeOf)(baseOf(schema));
+    const moduleType = (0, ModuleSelect_js_1.moduleTypeOf)(schema) ?? (0, ModuleSelect_js_1.moduleTypeOf)((0, valibotShape_js_1.baseOf)(schema));
     if (moduleType !== undefined) {
         return { type: 'moduleSelect', moduleType };
     }
@@ -73,14 +54,14 @@ const typeFor = (schema) => {
             return { type: 'select', options: opts };
         }
         case 'object': {
-            const entries = isEntriesRecord(schema.entries) ? schema.entries : {};
+            const entries = (0, valibotShape_js_1.isEntriesRecord)(schema.entries) ? schema.entries : {};
             return {
                 type: 'object',
                 fields: walkEntries(entries)
             };
         }
         case 'array': {
-            if (isValibotSchema(schema.item)) {
+            if ((0, valibotShape_js_1.isValibotSchema)(schema.item)) {
                 return { type: 'array', item: walkFromShape('', schema.item) };
             }
             // An unrecognisable item schema degrades to a text item — consistent
@@ -92,14 +73,14 @@ const typeFor = (schema) => {
     }
 };
 const walkFromShape = (key, rawSchema) => {
-    const { inner, optional } = unwrap(rawSchema);
+    const { inner, optional } = (0, valibotShape_js_1.unwrap)(rawSchema);
     // A `v.title(…)` label wins over the key-derived one; the title may ride
     // the schema itself or sit inside an optional wrapper.
     const label = titleOf(inner) ?? titleOf(rawSchema) ?? toLabel(key);
     return { key, label, optional, ...typeFor(inner) };
 };
 const walkField = (key, rawSchema) => {
-    if (!isValibotSchema(rawSchema)) {
+    if (!(0, valibotShape_js_1.isValibotSchema)(rawSchema)) {
         return { key, label: toLabel(key), optional: false, type: 'text' };
     }
     return walkFromShape(key, rawSchema);
@@ -134,10 +115,10 @@ const walkEntries = (entries) => Object.keys(entries)
  * when only the field shape is needed.
  */
 const toEnrichmentFields = (schema) => {
-    if (!isValibotSchema(schema))
+    if (!(0, valibotShape_js_1.isValibotSchema)(schema))
         return [];
-    const { inner } = unwrap(schema);
-    if (inner.type !== 'object' || !isEntriesRecord(inner.entries))
+    const { inner } = (0, valibotShape_js_1.unwrap)(schema);
+    if (inner.type !== 'object' || !(0, valibotShape_js_1.isEntriesRecord)(inner.entries))
         return [];
     return walkEntries(inner.entries);
 };

package/script/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/script/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/script/enrichments/valibotShape.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.baseOf = exports.unwrap = exports.isEntriesRecord = exports.isValibotSchema = void 0;
+const isValibotSchema = (input) => typeof input === 'object' &&
+    input !== null &&
+    'type' in input &&
+    typeof input.type === 'string';
+exports.isValibotSchema = isValibotSchema;
+const isEntriesRecord = (input) => typeof input === 'object' && input !== null;
+exports.isEntriesRecord = isEntriesRecord;
+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.
+ */
+const unwrap = (schema) => {
+    if (WRAPPER_TYPES.has(schema.type) && (0, exports.isValibotSchema)(schema.wrapped)) {
+        return { inner: schema.wrapped, optional: true };
+    }
+    return { inner: schema, optional: false };
+};
+exports.unwrap = unwrap;
+/**
+ * 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.
+ */
+const baseOf = (schema) => Array.isArray(schema.pipe) && (0, exports.isValibotSchema)(schema.pipe[0]) ? schema.pipe[0] : schema;
+exports.baseOf = baseOf;

package/script/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/script/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/script/helpers/nearestKey.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nearestKey = void 0;
+/**
+ * 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.
+ */
+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;
+};
+exports.nearestKey = nearestKey;

package/script/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/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,OAAO,qBAAqB,CAAC;AAG7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,0BAA0B,CAAA;AACxC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sCAAsC,CAAA;AACpD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2CAA2C,CAAA;AACzD,cAAc,qDAAqD,CAAA;AACnE,cAAc,4CAA4C,CAAA;AAC1D,cAAc,8BAA8B,CAAA;AAC5C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0CAA0C,CAAA;AACxD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wBAAwB,CAAA;AACtC,cAAc,2CAA2C,CAAA;AACzD,cAAc,qDAAqD,CAAA;AACnE,cAAc,4CAA4C,CAAA;AAC1D,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qCAAqC,CAAA;AACnD,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mCAAmC,CAAA;AACjD,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sCAAsC,CAAA;AACpD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,wBAAwB,CAAA;AACtC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sCAAsC,CAAA;AACpD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kCAAkC,CAAA;AAChD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,oCAAoC,CAAA;AAClD,cAAc,oCAAoC,CAAA;AAClD,cAAc,kDAAkD,CAAA;AAChE,cAAc,yCAAyC,CAAA;AACvD,cAAc,wBAAwB,CAAA;AACtC,cAAc,wCAAwC,CAAA;AACtD,cAAc,wBAAwB,CAAA;AACtC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,mBAAmB,8BAA8B,CAAA;AACjD,cAAc,+BAA+B,CAAA;AAC7C,mBAAmB,+BAA+B,CAAA;AAClD,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yCAAyC,CAAA;AACvD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/script/mod.js

@@ -215,6 +215,8 @@ __exportStar(require("./types/SchemaPath.js"), exports);
 __exportStar(require("./enrichments/toEnrichmentDescriptor.js"), exports);
 __exportStar(require("./enrichments/validateConfig.js"), exports);
 __exportStar(require("./enrichments/readEnrichments.js"), exports);
+__exportStar(require("./enrichments/EnrichmentWarning.js"), exports);
+__exportStar(require("./enrichments/findUnknownKeys.js"), exports);
 __exportStar(require("./types/Preview.js"), exports);
 __exportStar(require("./types/RefName.js"), exports);
 __exportStar(require("./types/Results.js"), exports);

package/script/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/script/run/toArtifacts.js

@@ -72,7 +72,7 @@ const CoreContext_js_1 = require("../context/CoreContext.js");
  */
 const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution, inspect }) => {
     const context = new CoreContext_js_1.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,
@@ -88,6 +88,7 @@ const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap
         spanId,
         results,
         parseIssues,
+        enrichmentWarnings,
         deploymentId: Date.now().toString(),
         region: undefined,
         startAt,

package/script/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/script/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/script/types/Manifest.js

@@ -109,6 +109,7 @@ exports.manifestContent = exports.previewItem = exports.manifestEntry = void 0;
 require("../_dnt.polyfills.js");
 const Results_js_1 = require("./Results.js");
 const Preview_js_1 = require("./Preview.js");
+const EnrichmentWarning_js_1 = require("../enrichments/EnrichmentWarning.js");
 const generateTypes_js_1 = require("../context/generateTypes.js");
 const ParseIssue_js_1 = require("../context/ParseIssue.js");
 const v = __importStar(require("valibot"));
@@ -188,6 +189,7 @@ exports.manifestContent = v.object({
     previews: v.record(v.string(), Preview_js_1.preview),
     results: Results_js_1.resultsItem,
     parseIssues: v.array(parseIssue),
+    enrichmentWarnings: v.optional(v.array(EnrichmentWarning_js_1.enrichmentWarning)),
     startAt: v.number(),
     endAt: v.number()
 });