@skmtc/core 0.27.0 → 0.28.1

package/esm/dsl/operation/gql/toGqlOperationProjectionBase.js

@@ -1,8 +1,6 @@
 import { toGqlOperationGeneratorKey } from '../../GeneratorKeys.js';
-import * as v from 'valibot';
-import get from 'lodash-es/get.js';
 import { DEFAULT_VARIANT } from '../../../types/Variant.js';
-import { GENERATOR_ENRICHMENT_KEY, STACK_ENRICHMENT_KEY } from '../../../types/Enrichments.js';
+import { parseEnrichmentUmbrella } from '../../../enrichments/parseEnrichmentUmbrella.js';
 /**
  * Build a GraphQL operation projection base class from a per-generator
  * config.
@@ -148,18 +146,14 @@ export const toGqlOperationProjectionBase = (base, config) => {
                 // and the variant axis is core-owned; generator and stack are
                 // run-constants (`[id][_generator]`, `[_stack]`). The required composite
                 // schema parses the raw umbrella once — typed, cast-free.
-                const raw = {
-                    subject: get(context.settings, [
-                        'enrichments',
-                        config.id,
-                        operation.rootKind,
-                        operation.fieldName,
-                        variant
-                    ]),
-                    generator: get(context.settings, ['enrichments', config.id, GENERATOR_ENRICHMENT_KEY]),
-                    stack: get(context.settings, ['enrichments', STACK_ENRICHMENT_KEY])
-                };
-                return v.parse(config.toEnrichmentSchema(), raw);
+                // The helper routes the reads through the recording accessor
+                // (consumption audit) and reports schema-dropped keys.
+                return parseEnrichmentUmbrella({
+                    context,
+                    generatorId: config.id,
+                    subjectSegments: [operation.rootKind, operation.fieldName, variant],
+                    schema: config.toEnrichmentSchema()
+                });
             }
         }),
         _a;

package/esm/dsl/operation/oas/OasOperationDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OasOperationDriver.d.ts","sourceRoot":"","sources":["../../../../src/dsl/operation/oas/OasOperationDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAK5E,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS,IAAI;IAC/E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IACrD,SAAS,EAAE,YAAY,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS;IAClF,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IACrD,SAAS,EAAE,YAAY,CAAA;IACvB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,eAAe,EACf,QAAQ,EACR,OAAyB,EAC1B,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BzC,OAAO,CAAC,KAAK;IAsBb;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;CAsBzB"}
+{"version":3,"file":"OasOperationDriver.d.ts","sourceRoot":"","sources":["../../../../src/dsl/operation/oas/OasOperationDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAG5E,KAAK,mBAAmB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS,IAAI;IAC/E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IACrD,SAAS,EAAE,YAAY,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS;IAClF,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,sBAAsB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IACrD,SAAS,EAAE,YAAY,CAAA;IACvB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,eAAe,EACf,QAAQ,EACR,OAAyB,EAC1B,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BzC,OAAO,CAAC,KAAK;IAsBb;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;CAsBzB"}

package/esm/dsl/operation/oas/OasOperationDriver.js

@@ -1,7 +1,6 @@
 import { normalize } from '../../../deps/jsr.io/@std/path/1.1.6/normalize.js';
 import { toOasOperationGeneratorKey } from '../../GeneratorKeys.js';
 import { DEFAULT_VARIANT } from '../../../types/Variant.js';
-import get from 'lodash-es/get.js';
 /**
  * Driver for the OAS operation insertion lifecycle.
  *
@@ -171,8 +170,7 @@ const assertPeerVariantExists = ({ context, generatorId, operation, variant }) =
     if (variant === DEFAULT_VARIANT) {
         return;
     }
-    const opEnrichments = get(context.settings, [
-        'enrichments',
+    const opEnrichments = context.readEnrichment([
         generatorId,
         operation.path,
         operation.method

package/esm/dsl/operation/oas/toOasOperationProjectionBase.d.ts

@@ -12,7 +12,7 @@ import type { OasSchema } from '../../../oas/schema/Schema.js';
 import type { OasRef } from '../../../oas/ref/Ref.js';
 import type { OasVoid } from '../../../oas/void/Void.js';
 import type { OasOperationProjection, OasOperationProjectionConstructorArgs, ToOasOperationIdentifierNameArgs, ToOasOperationExportPathArgs } from './types.js';
-import * as v from 'valibot';
+import type * as v from 'valibot';
 /**
  * Configuration for {@link toOasOperationProjectionBase}.
  *

package/esm/dsl/operation/oas/toOasOperationProjectionBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toOasOperationProjectionBase.d.ts","sourceRoot":"","sources":["../../../../src/dsl/operation/oas/toOasOperationProjectionBase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"toOasOperationProjectionBase.d.ts","sourceRoot":"","sources":["../../../../src/dsl/operation/oas/toOasOperationProjectionBase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAC5E,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,qCAAqC,EACrC,gCAAgC,EAChC,4BAA4B,EAC7B,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAIjC;;;;;;;GAOG;AACH,MAAM,MAAM,gCAAgC,CAC1C,cAAc,GAAG,SAAS,EAC1B,MAAM,SAAS,cAAc,GAAG,cAAc,IAC5C;IACF,EAAE,EAAE,MAAM,CAAA;IACV,iEAAiE;IACjE,gBAAgB,EAAE,CAAC,IAAI,EAAE,gCAAgC,CAAC,cAAc,CAAC,KAAK,MAAM,CAAA;IACpF;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,KAAK,MAAM,CAAA;IACnF,YAAY,EAAE,CAAC,IAAI,EAAE,4BAA4B,CAAC,cAAc,CAAC,KAAK,MAAM,CAAA;IAC5E;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IACzD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,cAAc,GAAG,SAAS,CAAA;IAC9E;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,KAAK,OAAO,CAAA;CAC3F,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,4BAA4B,GACvC,cAAc,GAAG,SAAS,EAC1B,MAAM,SAAS,cAAc,GAAG,cAAc,EAE9C,MAAM,sBAAsB,EAC5B,QAAQ,gCAAgC,CAAC,cAAc,EAAE,MAAM,CAAC;eAwC5C,qCAAqC,CAAC,cAAc,CAAC;kBAH7D,eAAe,CAAC,cAAc,CAAC;mBAC9B,YAAY;QAgBvB;;;;;;;;;WASG;wBACa,CAAC,SAAS,cAAc,EAAE,kBAAkB,0BAC9C,sBAAsB,CAAC,CAAC,EAAE,kBAAkB,CAAC,aAC9C,YAAY,YACd,IAAI,CAAC,sBAAsB,EAAE,UAAU,GAAG,SAAS,CAAC,GAC5D,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAC;QAUlC;;;;;WAKG;oBACS,CAAC,SAAS,cAAc,gDACtB,eAAe,CAAC,CAAC,EAAE,oBAAkB,CAAC,WACzC,OAAO,YACP,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC,GACxD,QAAQ,CAAC,CAAC,EAAE,oBAAkB,CAAC;QAQlC;;;;;;;WAOG;8BAED,CAAC,SAAS,cAAc,EACxB,MAAM,SAAS,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,gDAGzC,eAAe,CAAC,CAAC,EAAE,oBAAkB,CAAC,4BACxB,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,YAC3E,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC,GACxD,2BAA2B,CAAC,CAAC,EAAE,MAAM,CAAC;;;;;;;UA5G3B,cAAc;kFAvEgD,MAAM;kCAOtD,YAAY,WAAW,mBAAmB;0EACF,MAAM;wBAwBvD;QAAE,SAAS,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,KAAK,OAAO;oBA+ChE,iCAAiC,iBAAiB,KAAG,cAAc;IAiB3F;;;;OAIG;2BAC4B,MAAM,iBAAiB,KAAG,cAAc,GAAG,SAAS;;CA6FtF,CAAA"}

package/esm/dsl/operation/oas/toOasOperationProjectionBase.js

@@ -1,8 +1,6 @@
 import { toOasOperationGeneratorKey } from '../../GeneratorKeys.js';
-import * as v from 'valibot';
-import get from 'lodash-es/get.js';
 import { DEFAULT_VARIANT } from '../../../types/Variant.js';
-import { GENERATOR_ENRICHMENT_KEY, STACK_ENRICHMENT_KEY } from '../../../types/Enrichments.js';
+import { parseEnrichmentUmbrella } from '../../../enrichments/parseEnrichmentUmbrella.js';
 /**
  * Build an OAS operation projection base class from a per-generator config.
  *
@@ -148,18 +146,14 @@ export const toOasOperationProjectionBase = (base, config) => {
                 // the engine has already asserted `'main'` exists; generator and stack
                 // are run-constants (`[id][_generator]`, `[_stack]`). The required
                 // composite schema parses the raw umbrella once — typed, cast-free.
-                const raw = {
-                    subject: get(context.settings, [
-                        'enrichments',
-                        config.id,
-                        operation.path,
-                        operation.method,
-                        variant
-                    ]),
-                    generator: get(context.settings, ['enrichments', config.id, GENERATOR_ENRICHMENT_KEY]),
-                    stack: get(context.settings, ['enrichments', STACK_ENRICHMENT_KEY])
-                };
-                return v.parse(config.toEnrichmentSchema(), raw);
+                // The helper routes the reads through the recording accessor
+                // (consumption audit) and reports schema-dropped keys.
+                return parseEnrichmentUmbrella({
+                    context,
+                    generatorId: config.id,
+                    subjectSegments: [operation.path, operation.method, variant],
+                    schema: config.toEnrichmentSchema()
+                });
             }
         }),
         /**

package/esm/dsl/webhook/WebhookDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebhookDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/webhook/WebhookDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAKzE,KAAK,iBAAiB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS,IAAI;IAC7E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS;IAC7E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EACf,QAAQ,EACR,OAAyB,EAC1B,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BvC,OAAO,CAAC,KAAK;IAiBb;;;OAGG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;CAsBzB"}
+{"version":3,"file":"WebhookDriver.d.ts","sourceRoot":"","sources":["../../../src/dsl/webhook/WebhookDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAGzE,KAAK,iBAAiB,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS,IAAI;IAC7E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAWD;;;;;;;;GAQG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,cAAc,EAAE,cAAc,GAAG,SAAS;IAC7E,OAAO,EAAE,mBAAmB,CAAA;IAC5B,UAAU,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,eAAe,CAAC,cAAc,CAAC,CAAA;IACzC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;gBAEH,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,eAAe,EACf,QAAQ,EACR,OAAyB,EAC1B,EAAE,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC;IA0BvC,OAAO,CAAC,KAAK;IAiBb;;;OAGG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;CAsBzB"}

package/esm/dsl/webhook/WebhookDriver.js

@@ -1,7 +1,6 @@
 import { normalize } from '../../deps/jsr.io/@std/path/1.1.6/normalize.js';
 import { toWebhookGeneratorKey } from '../GeneratorKeys.js';
 import { DEFAULT_VARIANT } from '../../types/Variant.js';
-import get from 'lodash-es/get.js';
 /**
  * Driver for the webhook insertion lifecycle.
  *
@@ -155,8 +154,7 @@ const assertPeerVariantExists = ({ context, generatorId, webhook, variant }) =>
     if (variant === DEFAULT_VARIANT) {
         return;
     }
-    const webhookEnrichments = get(context.settings, [
-        'enrichments',
+    const webhookEnrichments = context.readEnrichment([
         generatorId,
         webhook.name,
         webhook.method

package/esm/dsl/webhook/toWebhookProjectionBase.d.ts

@@ -14,7 +14,7 @@ import type { OasSchema } from '../../oas/schema/Schema.js';
 import type { OasRef } from '../../oas/ref/Ref.js';
 import type { OasVoid } from '../../oas/void/Void.js';
 import type { WebhookProjectionConstructorArgs, ToWebhookIdentifierNameArgs, ToWebhookExportPathArgs } from './types.js';
-import * as v from 'valibot';
+import type * as v from 'valibot';
 /**
  * Configuration for {@link toWebhookProjectionBase}.
  *

package/esm/dsl/webhook/toWebhookProjectionBase.d.ts.map

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

package/esm/dsl/webhook/toWebhookProjectionBase.js

@@ -1,8 +1,6 @@
 import { toWebhookGeneratorKey } from '../GeneratorKeys.js';
-import * as v from 'valibot';
-import get from 'lodash-es/get.js';
 import { DEFAULT_VARIANT } from '../../types/Variant.js';
-import { GENERATOR_ENRICHMENT_KEY, STACK_ENRICHMENT_KEY } from '../../types/Enrichments.js';
+import { parseEnrichmentUmbrella } from '../../enrichments/parseEnrichmentUmbrella.js';
 /**
  * Build a webhook projection base class from a per-generator config.
  *
@@ -131,18 +129,14 @@ export const toWebhookProjectionBase = (base, config) => {
                 // the engine has already asserted `'main'` exists; generator and stack
                 // are run-constants (`[id][_generator]`, `[_stack]`). The required
                 // composite schema parses the raw umbrella once — typed, cast-free.
-                const raw = {
-                    subject: get(context.settings, [
-                        'enrichments',
-                        config.id,
-                        webhook.name,
-                        webhook.method,
-                        variant
-                    ]),
-                    generator: get(context.settings, ['enrichments', config.id, GENERATOR_ENRICHMENT_KEY]),
-                    stack: get(context.settings, ['enrichments', STACK_ENRICHMENT_KEY])
-                };
-                return v.parse(config.toEnrichmentSchema(), raw);
+                // The helper routes the reads through the recording accessor
+                // (consumption audit) and reports schema-dropped keys.
+                return parseEnrichmentUmbrella({
+                    context,
+                    generatorId: config.id,
+                    subjectSegments: [webhook.name, webhook.method, variant],
+                    schema: config.toEnrichmentSchema()
+                });
             }
         }),
         /**

package/esm/enrichments/EnrichmentAudit.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview The enrichment consumption audit.
+ *
+ * The engine already performs every enrichment lookup during the generate
+ * walk — the dispatch loops read each `[generatorId][...subject]` block to
+ * enumerate variants, the projection statics read each subject leaf and
+ * the run-constant scopes, and the Drivers read peer blocks for the
+ * variant guard. `EnrichmentAudit` records those lookups (every read is
+ * routed through `GenerateContext.readEnrichment`, the single choke
+ * point) and, post-walk, diffs them against the paths actually present in
+ * `settings.enrichments`. A configured path no lookup touched is dead
+ * config — a typo'd generator id / path / method / model name, or an
+ * entry orphaned by spec evolution — and becomes an
+ * `UNCONSUMED_ENRICHMENT` warning on the manifest.
+ *
+ * Consumption is recorded prefix-closed: consuming
+ * `[id, '/pets', 'post', 'main']` also marks `[id, '/pets', 'post']`,
+ * `[id, '/pets']`, and `[id]`. The present-path enumeration walks each
+ * generator's slice to the block depth its entry type dictates (model:
+ * `[refName]`; operation / webhook / GQL: two segments), so the diff
+ * compares like with like. Reserved keys (`_generator`, `_stack`) are
+ * engine-owned constants and never flagged.
+ *
+ * Everything here is warn-level and fail-open — the audit can only add
+ * warnings to the manifest, never change generation output.
+ *
+ * @module EnrichmentAudit
+ */
+import { type GeneratorEnrichments } from '../types/Enrichments.js';
+import { type EnrichmentWarning } from './EnrichmentWarning.js';
+/**
+ * The slice of a generator entry the audit needs: its id and the entry
+ * type that dictates its enrichment routing depth.
+ */
+export type AuditGenerator = {
+    readonly id: string;
+    readonly type: 'oasOperation' | 'gqlOperation' | 'model' | 'webhook';
+};
+type FinalizeArgs = {
+    /** The consumer's `client.json#settings.enrichments` record. */
+    enrichments: GeneratorEnrichments | undefined;
+    /** The generators configured for this run. */
+    generators: readonly AuditGenerator[];
+    /**
+     * Generator ids the consumer skipped wholesale (string entries in
+     * `settings.skip`). Their slices are reported as info, not warnings —
+     * a temporary skip is legitimate, not dead config.
+     */
+    skippedGeneratorIds: readonly string[];
+};
+export declare class EnrichmentAudit {
+    #private;
+    /**
+     * Record one enrichment lookup. Every prefix of `segments` is marked
+     * consumed, so block-level and leaf-level reads land in one namespace.
+     */
+    consume(segments: readonly string[]): void;
+    /**
+     * Add a warning, deduplicated on `(type, path)` — the same lookup can
+     * repeat many times per run (one per insert call) and must produce one
+     * warning.
+     */
+    report(warning: EnrichmentWarning): void;
+    /**
+     * Diff the configured enrichment paths against the consumed set and
+     * return every warning gathered during the run plus the addressing
+     * misses found here. Called once, after the generate walk.
+     */
+    finalize({ enrichments, generators, skippedGeneratorIds }: FinalizeArgs): EnrichmentWarning[];
+}
+/**
+ * Whether an enrichment block declares the given variant — the presence
+ * probe behind `SKIPPED_SUBJECT_ENRICHMENT` info lines. Exported for the
+ * dispatch loops; a non-record block (absent or malformed) has no
+ * variants.
+ */
+export declare const hasVariantEnrichment: (block: unknown, variant: string) => boolean;
+export {};
+//# sourceMappingURL=EnrichmentAudit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnrichmentAudit.d.ts","sourceRoot":"","sources":["../../src/enrichments/EnrichmentAudit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAGrF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;CACrE,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,gEAAgE;IAChE,WAAW,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC7C,8CAA8C;IAC9C,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;IACrC;;;;OAIG;IACH,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC,CAAA;AAOD,qBAAa,eAAe;;IAS1B;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAkB1C;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IA6CxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,EAAE,YAAY,GAAG,iBAAiB,EAAE;CAgG9F;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,EAAE,SAAS,MAAM,KAAG,OAClC,CAAA"}

package/esm/enrichments/EnrichmentAudit.js

@@ -0,0 +1,210 @@
+/**
+ * @fileoverview The enrichment consumption audit.
+ *
+ * The engine already performs every enrichment lookup during the generate
+ * walk — the dispatch loops read each `[generatorId][...subject]` block to
+ * enumerate variants, the projection statics read each subject leaf and
+ * the run-constant scopes, and the Drivers read peer blocks for the
+ * variant guard. `EnrichmentAudit` records those lookups (every read is
+ * routed through `GenerateContext.readEnrichment`, the single choke
+ * point) and, post-walk, diffs them against the paths actually present in
+ * `settings.enrichments`. A configured path no lookup touched is dead
+ * config — a typo'd generator id / path / method / model name, or an
+ * entry orphaned by spec evolution — and becomes an
+ * `UNCONSUMED_ENRICHMENT` warning on the manifest.
+ *
+ * Consumption is recorded prefix-closed: consuming
+ * `[id, '/pets', 'post', 'main']` also marks `[id, '/pets', 'post']`,
+ * `[id, '/pets']`, and `[id]`. The present-path enumeration walks each
+ * generator's slice to the block depth its entry type dictates (model:
+ * `[refName]`; operation / webhook / GQL: two segments), so the diff
+ * compares like with like. Reserved keys (`_generator`, `_stack`) are
+ * engine-owned constants and never flagged.
+ *
+ * Everything here is warn-level and fail-open — the audit can only add
+ * warnings to the manifest, never change generation output.
+ *
+ * @module EnrichmentAudit
+ */
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _EnrichmentAudit_instances, _EnrichmentAudit_consumed, _EnrichmentAudit_children, _EnrichmentAudit_warnings, _EnrichmentAudit_reported, _EnrichmentAudit_isConsumed, _EnrichmentAudit_divergenceSuggestion, _EnrichmentAudit_checkBlock;
+import { STACK_ENRICHMENT_KEY, isReservedEnrichmentKey } from '../types/Enrichments.js';
+import { formatEnrichmentPath } from './EnrichmentWarning.js';
+import { nearestKey } from '../helpers/nearestKey.js';
+const toPathKey = (segments) => JSON.stringify(segments);
+const isRecord = (input) => typeof input === 'object' && input !== null && !Array.isArray(input);
+export class EnrichmentAudit {
+    constructor() {
+        _EnrichmentAudit_instances.add(this);
+        /** Prefix-closed set of consumed routing paths, keyed by {@link toPathKey}. */
+        _EnrichmentAudit_consumed.set(this, new Set()
+        /** Consumed child segments per parent path — the suggestion candidates. */
+        );
+        /** Consumed child segments per parent path — the suggestion candidates. */
+        _EnrichmentAudit_children.set(this, new Map());
+        _EnrichmentAudit_warnings.set(this, []
+        /** Identity keys of reported warnings — reads repeat, warnings must not. */
+        );
+        /** Identity keys of reported warnings — reads repeat, warnings must not. */
+        _EnrichmentAudit_reported.set(this, new Set()
+        /**
+         * Record one enrichment lookup. Every prefix of `segments` is marked
+         * consumed, so block-level and leaf-level reads land in one namespace.
+         */
+        );
+    }
+    /**
+     * Record one enrichment lookup. Every prefix of `segments` is marked
+     * consumed, so block-level and leaf-level reads land in one namespace.
+     */
+    consume(segments) {
+        let parentKey = toPathKey([]);
+        for (let end = 1; end <= segments.length; end++) {
+            const key = toPathKey(segments.slice(0, end));
+            __classPrivateFieldGet(this, _EnrichmentAudit_consumed, "f").add(key);
+            const siblings = __classPrivateFieldGet(this, _EnrichmentAudit_children, "f").get(parentKey);
+            if (siblings) {
+                siblings.add(segments[end - 1]);
+            }
+            else {
+                __classPrivateFieldGet(this, _EnrichmentAudit_children, "f").set(parentKey, new Set([segments[end - 1]]));
+            }
+            parentKey = key;
+        }
+    }
+    /**
+     * Add a warning, deduplicated on `(type, path)` — the same lookup can
+     * repeat many times per run (one per insert call) and must produce one
+     * warning.
+     */
+    report(warning) {
+        const key = toPathKey([warning.type, ...warning.path]);
+        if (__classPrivateFieldGet(this, _EnrichmentAudit_reported, "f").has(key))
+            return;
+        __classPrivateFieldGet(this, _EnrichmentAudit_reported, "f").add(key);
+        __classPrivateFieldGet(this, _EnrichmentAudit_warnings, "f").push(warning);
+    }
+    /**
+     * Diff the configured enrichment paths against the consumed set and
+     * return every warning gathered during the run plus the addressing
+     * misses found here. Called once, after the generate walk.
+     */
+    finalize({ enrichments, generators, skippedGeneratorIds }) {
+        if (!isRecord(enrichments))
+            return [...__classPrivateFieldGet(this, _EnrichmentAudit_warnings, "f")];
+        const generatorsById = new Map(generators.map(generator => [generator.id, generator]));
+        const skipped = new Set(skippedGeneratorIds);
+        for (const [generatorId, slot] of Object.entries(enrichments)) {
+            if (generatorId === STACK_ENRICHMENT_KEY)
+                continue;
+            // Other `_`-prefixed keys are structurally invalid — the
+            // `generatorEnrichments` schema flags those at config load.
+            if (isReservedEnrichmentKey(generatorId))
+                continue;
+            if (skipped.has(generatorId)) {
+                this.report({
+                    level: 'info',
+                    type: 'SKIPPED_GENERATOR_ENRICHMENT',
+                    path: [generatorId],
+                    message: `generator '${generatorId}' is skipped in this run — ` +
+                        `its enrichments were not applied`
+                });
+                continue;
+            }
+            const generator = generatorsById.get(generatorId);
+            if (!generator) {
+                // An insert-only peer (reached via insertOperation / insertModel
+                // without an entry of its own) still consumes its slice through
+                // the projection statics — a consumed prefix means the slice is
+                // live, and without an entry type its depth is unknowable, so the
+                // audit leaves it alone.
+                if (__classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_isConsumed).call(this, [generatorId]))
+                    continue;
+                const suggestion = nearestKey(generatorId, generatorsById.keys());
+                this.report({
+                    level: 'warning',
+                    type: 'UNKNOWN_GENERATOR_ID',
+                    path: [generatorId],
+                    message: `enrichments are configured for '${generatorId}' but no generator ` +
+                        `with that id is in this run` +
+                        (suggestion !== undefined ? ` (did you mean '${suggestion}'?)` : ''),
+                    ...(suggestion !== undefined ? { suggestion } : {})
+                });
+                continue;
+            }
+            if (!isRecord(slot))
+                continue;
+            // The generator is in the run but consumed nothing at all — the
+            // document has no subjects of its type (or the wrong protocol).
+            // Per-entry warnings would fall back to cross-generator siblings for
+            // their "did you mean …?" and could name an unrelated generator, so
+            // collapse to one generator-level warning that says what happened.
+            const hasSubjectEntries = Object.keys(slot).some(key => !isReservedEnrichmentKey(key));
+            if (!__classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_isConsumed).call(this, [generatorId]) && hasSubjectEntries) {
+                this.report({
+                    level: 'warning',
+                    type: 'UNCONSUMED_ENRICHMENT',
+                    path: [generatorId],
+                    message: `enrichments are configured for '${generatorId}' but it matched ` +
+                        `no subjects in this run — its enrichments were never read`
+                });
+                continue;
+            }
+            // Block depth per entry type: `[refName]` for models,
+            // `[path][method]` / `[name][method]` / `[rootKind][fieldName]`
+            // for the operation-shaped types.
+            const subjectDepth = generator.type === 'model' ? 1 : 2;
+            for (const [subjectKey, subjectValue] of Object.entries(slot)) {
+                // `_generator` (and any other reserved key) is engine-owned — read
+                // through the dedicated helpers by known key, always consumed.
+                if (isReservedEnrichmentKey(subjectKey))
+                    continue;
+                if (subjectDepth === 1 ||
+                    !isRecord(subjectValue) ||
+                    Object.keys(subjectValue).length === 0) {
+                    __classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_checkBlock).call(this, [generatorId, subjectKey]);
+                    continue;
+                }
+                for (const methodKey of Object.keys(subjectValue)) {
+                    __classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_checkBlock).call(this, [generatorId, subjectKey, methodKey]);
+                }
+            }
+        }
+        return [...__classPrivateFieldGet(this, _EnrichmentAudit_warnings, "f")];
+    }
+}
+_EnrichmentAudit_consumed = new WeakMap(), _EnrichmentAudit_children = new WeakMap(), _EnrichmentAudit_warnings = new WeakMap(), _EnrichmentAudit_reported = new WeakMap(), _EnrichmentAudit_instances = new WeakSet(), _EnrichmentAudit_isConsumed = function _EnrichmentAudit_isConsumed(segments) {
+    return __classPrivateFieldGet(this, _EnrichmentAudit_consumed, "f").has(toPathKey(segments));
+}, _EnrichmentAudit_divergenceSuggestion = function _EnrichmentAudit_divergenceSuggestion(path) {
+    for (let depth = 0; depth < path.length; depth++) {
+        if (__classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_isConsumed).call(this, path.slice(0, depth + 1)))
+            continue;
+        const siblings = __classPrivateFieldGet(this, _EnrichmentAudit_children, "f").get(toPathKey(path.slice(0, depth)));
+        return siblings ? nearestKey(path[depth], siblings) : undefined;
+    }
+    return undefined;
+}, _EnrichmentAudit_checkBlock = function _EnrichmentAudit_checkBlock(path) {
+    if (__classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_isConsumed).call(this, path))
+        return;
+    const suggestion = __classPrivateFieldGet(this, _EnrichmentAudit_instances, "m", _EnrichmentAudit_divergenceSuggestion).call(this, path);
+    this.report({
+        level: 'warning',
+        type: 'UNCONSUMED_ENRICHMENT',
+        path,
+        message: `enrichment entry '${formatEnrichmentPath(path)}' was never consumed — ` +
+            `no matching generator or subject in this run` +
+            (suggestion !== undefined ? ` (did you mean '${suggestion}'?)` : ''),
+        ...(suggestion !== undefined ? { suggestion } : {})
+    });
+};
+/**
+ * Whether an enrichment block declares the given variant — the presence
+ * probe behind `SKIPPED_SUBJECT_ENRICHMENT` info lines. Exported for the
+ * dispatch loops; a non-record block (absent or malformed) has no
+ * variants.
+ */
+export const hasVariantEnrichment = (block, variant) => isRecord(block) && variant in block;

package/esm/enrichments/EnrichmentWarning.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @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';
+/**
+ * Discriminates what went wrong with an enrichment entry:
+ *
+ *  - `UNCONSUMED_ENRICHMENT` — a configured routing path no engine lookup
+ *    consumed (typo'd path / method / model name, or an entry orphaned by
+ *    spec evolution). Warning.
+ *  - `UNKNOWN_GENERATOR_ID` — a top-level enrichment key that matches no
+ *    generator in the run (and no insert-only peer consumed it). Warning.
+ *  - `UNKNOWN_ENRICHMENT_KEY` — a leaf key the generator's enrichment
+ *    schema does not declare; Valibot strips it silently. Warning.
+ *  - `SKIPPED_SUBJECT_ENRICHMENT` — the entry is addressed correctly but
+ *    its subject was excluded by `skip`/`include`. Info: temporary skips
+ *    are legitimate, so this is not treated as dead config.
+ *  - `SKIPPED_GENERATOR_ENRICHMENT` — the whole generator is skipped
+ *    (string entry in `settings.skip`) while enrichments for it exist.
+ *    Info, for the same reason.
+ */
+export type EnrichmentWarningType = 'UNCONSUMED_ENRICHMENT' | 'UNKNOWN_GENERATOR_ID' | 'UNKNOWN_ENRICHMENT_KEY' | 'SKIPPED_SUBJECT_ENRICHMENT' | 'SKIPPED_GENERATOR_ENRICHMENT';
+export declare const enrichmentWarningType: v.GenericSchema<EnrichmentWarningType>;
+/**
+ * One enrichment-config warning. `path` is the routing key sequence under
+ * `client.json#settings.enrichments` locating the offending entry —
+ * `[generatorId, ...subjectSegments]` for addressing warnings, extended
+ * down to the leaf key for `UNKNOWN_ENRICHMENT_KEY`. `suggestion` carries
+ * the nearest known key when a close match exists (`submitLabl` →
+ * `submitLabel`); the human-readable `message` already folds it in.
+ */
+export type EnrichmentWarning = {
+    level: 'warning' | 'info';
+    type: EnrichmentWarningType;
+    path: readonly string[];
+    message: string;
+    suggestion?: string;
+};
+export declare const enrichmentWarning: v.GenericSchema<EnrichmentWarning>;
+/**
+ * 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 declare const formatEnrichmentPath: (path: readonly string[]) => string;
+//# sourceMappingURL=EnrichmentWarning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnrichmentWarning.d.ts","sourceRoot":"","sources":["../../src/enrichments/EnrichmentWarning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,sBAAsB,GACtB,wBAAwB,GACxB,4BAA4B,GAC5B,8BAA8B,CAAA;AAElC,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,qBAAqB,CAMvE,CAAA;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,IAAI,EAAE,qBAAqB,CAAA;IAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAM/D,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,SAAS,MAAM,EAAE,KAAG,MAA0B,CAAA"}