@skmtc/core 0.18.1 → 0.26.0

package/esm/parse/v3-1/response/toResponseV3.js

@@ -1,5 +1,6 @@
 import { toRefV31 } from '../ref/toRefV31.js';
 import { toHeadersV3 } from '../header/toHeadersV3.js';
+import { toLinksV3 } from '../link/toLinksV3.js';
 import { isRef } from '../../../helpers/refFns.js';
 import { toOptionalMediaTypeItemsV3 } from '../mediaType/toMediaTypeItemV3.js';
 import { OasResponse } from '../../../oas/response/Response.js';
@@ -33,7 +34,7 @@ export const toResponseV3 = ({ response, stackTrail, context }) => {
     if (isRef(response)) {
         return toRefV31({ ref: response, refType: 'response', stackTrail, context });
     }
-    const { description, headers, content, ...skipped } = response;
+    const { description, headers, links, content, ...skipped } = response;
     const extensionFields = toSpecificationExtensionsV3({
         skipped,
         parent: response,
@@ -42,10 +43,12 @@ export const toResponseV3 = ({ response, stackTrail, context }) => {
         parentType: 'response'
     });
     const parsedHeaders = stackTrail.trace('headers', st => toHeadersV3({ headers, stackTrail: st, context }));
+    const parsedLinks = stackTrail.trace('links', st => toLinksV3({ links, stackTrail: st, context }));
     const parsedContent = stackTrail.trace('content', st => toOptionalMediaTypeItemsV3({ content, stackTrail: st, context }));
     return context.withStackTrail(stackTrail, () => new OasResponse({
         description,
         headers: parsedHeaders,
+        links: parsedLinks,
         content: parsedContent,
         extensionFields
     }, context));

package/esm/parse/v3-1/union/toUnion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toUnion.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/union/toUnion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAStD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,OAAO,EAAE,CAAC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,EAAE,CAAA;IAC/D,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,qDAMrB,WAAW,KAAG,QA0EhB,CAAA"}
+{"version":3,"file":"toUnion.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/union/toUnion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAUtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,OAAO,EAAE,CAAC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,EAAE,CAAA;IAC/D,UAAU,EAAE,OAAO,GAAG,OAAO,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,qDAMrB,WAAW,KAAG,QA8EhB,CAAA"}

package/esm/parse/v3-1/union/toUnion.js

@@ -5,13 +5,14 @@ import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecif
 import { parseNullable } from '../_helpers/parseNullable.js';
 import { parseExample } from '../_helpers/parseExample.js';
 import { parseDefault } from '../_helpers/parseDefault.js';
+import { toExternalDocs } from '../externalDocs/toExternalDocs.js';
 export const toUnion = ({ value, members, parentType, stackTrail, context }) => {
     const { nullable, value: valueWithoutNullable } = parseNullable({
         value,
         context,
         stackTrail
     });
-    const { discriminator, title, description, example: unparsedExample, default: unparsedDefaultValue, ...skipped } = valueWithoutNullable;
+    const { discriminator, title, description, externalDocs, example: unparsedExample, default: unparsedDefaultValue, ...skipped } = valueWithoutNullable;
     const example = parseExample({
         value: unparsedExample,
         context,
@@ -50,6 +51,7 @@ export const toUnion = ({ value, members, parentType, stackTrail, context }) =>
     return context.withStackTrail(stackTrail, () => new OasUnion({
         title,
         description,
+        externalDocs: stackTrail.trace('externalDocs', st => toExternalDocs({ externalDocs, stackTrail: st, context })),
         nullable,
         default: defaultValue,
         discriminator: discriminatorParsed,

package/esm/run/toArtifacts.d.ts

@@ -55,6 +55,12 @@ type TransformArgs = {
      * alongside the standard artifacts. See {@link AttributionState}.
      */
     attribution?: AttributionState;
+    /**
+     * When `true`, the result carries an `inspection` snapshot — a cycle-safe,
+     * depth-bounded JSON serialization of the live `inspectedFiles` graph. Opt-in;
+     * the generate/render pipeline is unaffected.
+     */
+    inspect?: boolean;
 };
 /**
  * Transforms an OpenAPI v3 document into generated code artifacts and metadata.
@@ -124,11 +130,12 @@ type TransformArgs = {
  * }
  * ```
  */
-export declare const toArtifacts: ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution }: TransformArgs) => {
+export declare const toArtifacts: ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution, inspect }: TransformArgs) => {
     artifacts: Record<string, string>;
     manifest: ManifestContent;
     sidecars?: Record<string, Sidecar>;
     generationMap?: GenerationMapEntry[];
+    inspection?: unknown;
 };
 export {};
 //# sourceMappingURL=toArtifacts.d.ts.map

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;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,WAAW,GAAI,mHAWzB,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;CAqCrC,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;CAqCrB,CAAA"}

package/esm/run/toArtifacts.js

@@ -67,20 +67,20 @@ import { CoreContext } from '../context/CoreContext.js';
  * }
  * ```
  */
-export const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution }) => {
+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, mappings, parseIssues, sidecars, generationMap } = context.toArtifacts({
+    const { artifacts, files, previews, results, parseIssues, sidecars, generationMap, inspection } = context.toArtifacts({
         settings,
         toGeneratorConfigMap,
         document,
         stackTrail,
         silent,
-        attribution
+        attribution,
+        inspect
     });
     const manifest = {
         files,
         previews,
-        mappings,
         traceId,
         spanId,
         results,
@@ -90,5 +90,5 @@ export const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorCo
         startAt,
         endAt: Date.now()
     };
-    return { artifacts, manifest, sidecars, generationMap };
+    return { artifacts, manifest, sidecars, generationMap, inspection };
 };

package/esm/run/toInspection.d.ts

@@ -0,0 +1,8 @@
+import type { FileBase } from '../dsl/FileBase.js';
+/**
+ * Serialize the live `inspectedFiles` map into a cycle-safe, depth-bounded plain
+ * JSON tree — the real object graph, not the rendered text. Consumed by
+ * `skmtc inspect` and the VS Code debugger views.
+ */
+export declare const toInspection: (files: ReadonlyMap<string, FileBase>) => unknown;
+//# sourceMappingURL=toInspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toInspection.d.ts","sourceRoot":"","sources":["../../src/run/toInspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AA+ElD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAG,OACzC,CAAA"}

package/esm/run/toInspection.js

@@ -0,0 +1,78 @@
+/**
+ * Cycle-safe, depth-bounded serializer for the engine's live `inspectedFiles`
+ * graph — turns the real `File` / `Definition` / `Snippet` instances (with their
+ * Maps and Sets) into plain JSON a debugger UI or `skmtc inspect` can render
+ * generically, without the rendered text hiding the structure.
+ *
+ * Walks own enumerable properties (the leaf `toString` is non-enumerable, so it
+ * never appears), tags each instance with `__class`, and converts Maps/Sets to
+ * plain data. Omits `context` (the shared graph that would explode the output),
+ * `stackTrail`, and `captureSink` — pure noise on every node.
+ *
+ * Opt-in via `toArtifacts({ inspect: true })`; the pipeline is otherwise
+ * untouched.
+ */
+const OMIT_KEYS = new Set(['context', 'stackTrail', 'captureSink']);
+const MAX_DEPTH = 8;
+const MAX_STRING = 400;
+const className = (value) => value.constructor?.name ?? 'Object';
+const walk = (value, depth, seen) => {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        return value.length > MAX_STRING ? `${value.slice(0, MAX_STRING)}…` : value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'function') {
+        return `[Function ${value.name || 'anonymous'}]`;
+    }
+    if (typeof value !== 'object') {
+        return String(value);
+    }
+    if (seen.has(value)) {
+        return '[Circular]';
+    }
+    if (depth >= MAX_DEPTH) {
+        return `[${className(value)} …]`;
+    }
+    seen.add(value);
+    try {
+        if (value instanceof Map) {
+            const out = { __class: 'Map' };
+            for (const [key, val] of value) {
+                out[String(key)] = walk(val, depth + 1, seen);
+            }
+            return out;
+        }
+        if (value instanceof Set) {
+            return { __class: 'Set', values: [...value].map(item => walk(item, depth + 1, seen)) };
+        }
+        if (Array.isArray(value)) {
+            return value.map(item => walk(item, depth + 1, seen));
+        }
+        const out = {};
+        const cls = className(value);
+        if (cls !== 'Object') {
+            out.__class = cls;
+        }
+        for (const key of Object.keys(value)) {
+            if (OMIT_KEYS.has(key)) {
+                continue;
+            }
+            out[key] = walk(Reflect.get(value, key), depth + 1, seen);
+        }
+        return out;
+    }
+    finally {
+        seen.delete(value);
+    }
+};
+/**
+ * Serialize the live `inspectedFiles` map into a cycle-safe, depth-bounded plain
+ * JSON tree — the real object graph, not the rendered text. Consumed by
+ * `skmtc inspect` and the VS Code debugger views.
+ */
+export const toInspection = (files) => walk(files, 0, new Set());

package/esm/types/Enrichments.d.ts

@@ -7,7 +7,7 @@
  *   - **Models** are keyed by name (component schema name in OAS;
  *     registry-named type in GraphQL).
  *   - **OAS operations** are keyed by HTTP path → method.
- *   - **GraphQL operations** are keyed by root kind → field name.
+ *   - **GraphQL operations** are keyed by root type → field name.
  *
  * The leaf at the bottom of each hierarchy is opaque to core — its
  * shape is owned by the generator that consumes it. Each generator
@@ -59,14 +59,25 @@ export type EnrichmentLeaf = unknown;
 export type ModelEnrichments = Record<string, EnrichmentLeaf>;
 export declare const modelEnrichments: v.GenericSchema<ModelEnrichments>;
 /**
- * OAS method enrichments: HTTP method (`get`, `post`, ...) → leaf payload.
+ * OAS operation enrichments: HTTP method (`get`, `post`, ...) → leaf payload.
+ * One entry per operation defined at a path; the leaf is opaque to core.
  */
-export type OasMethodEnrichments = Record<string, EnrichmentLeaf>;
-export declare const oasMethodEnrichments: v.GenericSchema<OasMethodEnrichments>;
+export type OasOperationEnrichments = Record<string, EnrichmentLeaf>;
+export declare const oasOperationEnrichments: v.GenericSchema<OasOperationEnrichments>;
 /**
- * OAS path enrichments: path template → method enrichments.
+ * OAS webhook enrichments: HTTP method (`get`, `post`, ...) → leaf payload.
+ * Structurally identical to {@link OasOperationEnrichments} — an OpenAPI 3.1
+ * webhook is a path-item keyed by method, the same shape as an operation — but
+ * named distinctly so a webhook generator's slot reads as webhook-scoped (the
+ * `webhook` subject type) rather than operation-scoped. The leaf is opaque to
+ * core.
  */
-export type OasPathEnrichments = Record<string, OasMethodEnrichments>;
+export type OasWebhookEnrichments = Record<string, EnrichmentLeaf>;
+export declare const oasWebhookEnrichments: v.GenericSchema<OasWebhookEnrichments>;
+/**
+ * OAS path enrichments: path template → operation enrichments.
+ */
+export type OasPathEnrichments = Record<string, OasOperationEnrichments>;
 export declare const oasPathEnrichments: v.GenericSchema<OasPathEnrichments>;
 /**
  * GraphQL field enrichments: root field name → leaf payload.
@@ -74,7 +85,7 @@ export declare const oasPathEnrichments: v.GenericSchema<OasPathEnrichments>;
 export type GqlFieldEnrichments = Record<string, EnrichmentLeaf>;
 export declare const gqlFieldEnrichments: v.GenericSchema<GqlFieldEnrichments>;
 /**
- * GraphQL root-kind enrichments: `query` / `mutation` / `subscription`
+ * GraphQL root-type enrichments: `query` / `mutation` / `subscription`
  * → field enrichments.
  */
 export type GqlRootKindEnrichments = Record<string, GqlFieldEnrichments>;
@@ -107,7 +118,7 @@ export declare const isReservedEnrichmentKey: (key: string) => boolean;
  * Top-level enrichments: generator id → hierarchy, plus the reserved
  * `_stack` key (stack-scoped leaf). Each generator's slot is one of
  * three structurally-distinct hierarchies depending on the generator's
- * entry kind:
+ * entry type:
  *  - `ModelEnrichments` for `toModelEntry`
  *  - `OasPathEnrichments` for `toOasOperationEntry`
  *  - `GqlRootKindEnrichments` for `toGqlOperationEntry`

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

@@ -1 +1 @@
-{"version":3,"file":"Enrichments.d.ts","sourceRoot":"","sources":["../../src/types/Enrichments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAE7D,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,aAAa,CAAC,gBAAgB,CAAqC,CAAA;AAEpG;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEjE,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAGtE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAErE,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,aAAa,CAAC,kBAAkB,CAGlE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEhE,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,aAAa,CAAC,mBAAmB,CAGpE,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAExE,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,aAAa,CAAC,sBAAsB,CAG1E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAA;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,KAAG,OAA8B,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN,gBAAgB,GAAG,kBAAkB,GAAG,sBAAsB,CAC/D,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAiCtE,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,GAAG,SAAS,IAAI;IACvF,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAK5F,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"Enrichments.d.ts","sourceRoot":"","sources":["../../src/types/Enrichments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAE7D,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,aAAa,CAAC,gBAAgB,CAAqC,CAAA;AAEpG;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEpE,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,aAAa,CAAC,uBAAuB,CAG5E,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAElE,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,qBAAqB,CAGxE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;AAExE,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,aAAa,CAAC,kBAAkB,CAGlE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEhE,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,aAAa,CAAC,mBAAmB,CAGpE,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAExE,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,aAAa,CAAC,sBAAsB,CAG1E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAA;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,KAAG,OAA8B,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN,gBAAgB,GAAG,kBAAkB,GAAG,sBAAsB,CAC/D,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAiCtE,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,GAAG,SAAS,IAAI;IACvF,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAK5F,CAAA;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/esm/types/Enrichments.js

@@ -7,7 +7,7 @@
  *   - **Models** are keyed by name (component schema name in OAS;
  *     registry-named type in GraphQL).
  *   - **OAS operations** are keyed by HTTP path → method.
- *   - **GraphQL operations** are keyed by root kind → field name.
+ *   - **GraphQL operations** are keyed by root type → field name.
  *
  * The leaf at the bottom of each hierarchy is opaque to core — its
  * shape is owned by the generator that consumes it. Each generator
@@ -45,8 +45,9 @@
 import "../_dnt.polyfills.js";
 import * as v from 'valibot';
 export const modelEnrichments = v.record(v.string(), v.unknown());
-export const oasMethodEnrichments = v.record(v.string(), v.unknown());
-export const oasPathEnrichments = v.record(v.string(), oasMethodEnrichments);
+export const oasOperationEnrichments = v.record(v.string(), v.unknown());
+export const oasWebhookEnrichments = v.record(v.string(), v.unknown());
+export const oasPathEnrichments = v.record(v.string(), oasOperationEnrichments);
 export const gqlFieldEnrichments = v.record(v.string(), v.unknown());
 export const gqlRootKindEnrichments = v.record(v.string(), gqlFieldEnrichments);
 /**

package/esm/types/GeneratorType.d.ts

@@ -1,7 +1,7 @@
-import type { OasOperationConfig } from '../dsl/operation/oas/types.js';
-import type { WebhookConfig } from '../dsl/webhook/types.js';
-import type { GqlOperationConfig } from '../dsl/operation/gql/types.js';
-import type { ModelConfig } from '../dsl/model/types.js';
+import type { OasOperationEntry } from '../dsl/operation/oas/toOasOperationEntry.js';
+import type { WebhookEntry } from '../dsl/webhook/toWebhookEntry.js';
+import type { GqlOperationEntry } from '../dsl/operation/gql/toGqlOperationEntry.js';
+import type { ModelEntry } from '../dsl/model/toModelEntry.js';
 /**
  * Discriminated union of every generator configuration the dispatcher
  * recognizes. The `type` field discriminates the variant — `'oasOperation'`
@@ -48,7 +48,7 @@ import type { ModelConfig } from '../dsl/model/types.js';
  * // modelEntry.type === 'model'
  * ```
  */
-export type GeneratorConfig<EnrichmentType = undefined> = OasOperationConfig<EnrichmentType> | WebhookConfig<EnrichmentType> | GqlOperationConfig<EnrichmentType> | ModelConfig<EnrichmentType>;
+export type GeneratorConfig<EnrichmentType = undefined> = OasOperationEntry<EnrichmentType> | WebhookEntry<EnrichmentType> | GqlOperationEntry<EnrichmentType> | ModelEntry<EnrichmentType>;
 /**
  * A name → generator-config map. Keys are arbitrary generator
  * identifiers (the same string a caller might pass to `--skip` etc.);

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

@@ -1 +1 @@
-{"version":3,"file":"GeneratorType.d.ts","sourceRoot":"","sources":["../../src/types/GeneratorType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,MAAM,eAAe,CAAC,cAAc,GAAG,SAAS,IAClD,kBAAkB,CAAC,cAAc,CAAC,GAClC,aAAa,CAAC,cAAc,CAAC,GAC7B,kBAAkB,CAAC,cAAc,CAAC,GAClC,WAAW,CAAC,cAAc,CAAC,CAAA;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,sBAAsB,CAAC,cAAc,GAAG,SAAS,IAAI,MAAM,CACrE,MAAM,EACN,eAAe,CAAC,cAAc,CAAC,CAChC,CAAA"}
+{"version":3,"file":"GeneratorType.d.ts","sourceRoot":"","sources":["../../src/types/GeneratorType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,MAAM,eAAe,CAAC,cAAc,GAAG,SAAS,IAClD,iBAAiB,CAAC,cAAc,CAAC,GACjC,YAAY,CAAC,cAAc,CAAC,GAC5B,iBAAiB,CAAC,cAAc,CAAC,GACjC,UAAU,CAAC,cAAc,CAAC,CAAA;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,sBAAsB,CAAC,cAAc,GAAG,SAAS,IAAI,MAAM,CACrE,MAAM,EACN,eAAe,CAAC,cAAc,CAAC,CAChC,CAAA"}

package/esm/types/Manifest.d.ts

@@ -72,7 +72,7 @@
  */
 import "../_dnt.polyfills.js";
 import { type ResultsItem } from './Results.js';
-import { type Preview, type Mapping } from './Preview.js';
+import { type Preview } from './Preview.js';
 import type { ParseIssue } from '../context/ParseIssue.js';
 import * as v from 'valibot';
 export type ManifestEntry = {
@@ -93,7 +93,6 @@ export type ManifestContent = {
     region?: string;
     files: Record<string, ManifestEntry>;
     previews: Record<string, Preview>;
-    mappings?: Record<string, Mapping>;
     results: ResultsItem;
     /**
      * Issues recorded during the parse phase — both protocol-agnostic

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,KAAK,OAAO,EAAW,MAAM,cAAc,CAAA;AAC3E,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;CACxB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAIvD,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,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,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,CAY3D,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;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;CACxB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAIvD,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"}

package/esm/types/Manifest.js

@@ -72,7 +72,7 @@
  */
 import "../_dnt.polyfills.js";
 import { resultsItem } from './Results.js';
-import { preview, mapping } from './Preview.js';
+import { preview } from './Preview.js';
 import { oasIssueType } from '../context/generateTypes.js';
 import { gqlIssueType } from '../context/ParseIssue.js';
 import * as v from 'valibot';
@@ -149,7 +149,6 @@ export const manifestContent = v.object({
     region: v.optional(v.string()),
     files: v.record(v.string(), manifestEntry),
     previews: v.record(v.string(), preview),
-    mappings: v.optional(v.record(v.string(), mapping)),
     results: resultsItem,
     parseIssues: v.array(parseIssue),
     startAt: v.number(),

package/esm/types/ModuleSelect.d.ts

@@ -0,0 +1,81 @@
+import * as v from 'valibot';
+import { type ModuleExport } from './ModuleExport.js';
+import { type SchemaPath } from './SchemaPath.js';
+/**
+ * One field binding: WHERE in the subject's data shape the field lives
+ * (`schemaPath`) and — optionally — WHICH consumer component renders it
+ * (`module`). The two are one unit by construction, asymmetrically:
+ * a component can never be stored without the path that gives it a type
+ * (which is what lets the editor's type-aware matcher verify the pair
+ * before it is ever written), while a path WITHOUT a component is the
+ * everyday "use the generator's default rendering" state — it's how
+ * schema-seeded fields start out, and how label/order overrides are
+ * expressed for fields that need no custom input.
+ *
+ * Stored in `client.json` under the literal key `moduleSelect`:
+ *
+ * ```jsonc
+ * {
+ *   "moduleSelect": {
+ *     "schemaPath": ["RequestBody", "officeIds"],
+ *     "module": { "exportName": "OfficesMultiSelectField", "exportPath": "@/inputs/OfficesMultiSelectField.generated.tsx" }
+ *   },
+ *   "label": "Offices"
+ * }
+ * ```
+ */
+export type ModuleSelect = {
+    /** Path into the subject's data shape: a target token (`RequestBody` /
+     *  `SuccessResponse` / `Model`) followed by property names. */
+    schemaPath: SchemaPath;
+    /** The consumer component bound to that field; absent = the generator's
+     *  default rendering for the field's type. */
+    module?: ModuleExport;
+};
+/**
+ * The standard lens/input module type: a candidate module fits a field when
+ * it accepts `{ lens: Lens<Normalize<FieldType>> }` (react-hook-form lenses).
+ * `__SlotNormalize` mirrors what generated form code does with
+ * `lens.focus(path).defined()` — optional/nullable wrappers are stripped on
+ * primitives and made recursively optional on objects — so an optional
+ * `string | undefined` field still matches a `Lens<string>` input.
+ *
+ * Pass as `moduleSelect(lensInputModuleType)`. Generators with a custom
+ * binding (e.g. a table cell renderer taking `{ value: F }`) declare their
+ * own `export type XModule<F> = …` source instead.
+ */
+export declare const lensInputModuleType: string;
+/**
+ * Declare a `moduleSelect` enrichment field: the `{ schemaPath, module? }`
+ * binding validated as one value. The enrichment editor renders it as a
+ * single composite control (path picker + type-matched component picker,
+ * the component gated on the path), and `toEnrichmentDescriptor` projects
+ * it as `type: 'moduleSelect'` carrying the declared `moduleType`.
+ *
+ * `moduleType` is the TypeScript source of the contract a chosen module
+ * must satisfy for the field — a single `export type XModule<F> = …` the
+ * editor's matcher checks candidates against
+ * (`typeof Candidate extends XModule<FieldType>`). It is a required part of
+ * the declaration, so the contract is always explicit — there is no hidden
+ * editor-side default. For the common lens/input case pass
+ * {@link lensInputModuleType}; only generators with a genuinely custom
+ * binding write their own source.
+ *
+ * ```ts
+ * import { lensInputModuleType, moduleSelect } from '@skmtc/core'
+ *
+ * export const formFieldItem = v.object({
+ *   moduleSelect: v.optional(v.pipe(moduleSelect(lensInputModuleType), v.title('Input'))),
+ *   label: v.optional(v.string())
+ * })
+ * ```
+ */
+export declare const moduleSelect: (moduleType: string) => v.GenericSchema<ModuleSelect>;
+/**
+ * The module type a schema was declared with, or `undefined` when the schema
+ * is not a {@link moduleSelect}. Callers pass the schema as observed at
+ * runtime (the descriptor walker's structural view), so the parameter is
+ * deliberately `unknown`.
+ */
+export declare const moduleTypeOf: (schema: unknown) => string | undefined;
+//# sourceMappingURL=ModuleSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleSelect.d.ts","sourceRoot":"","sources":["../../src/types/ModuleSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;mEAC+D;IAC/D,UAAU,EAAE,UAAU,CAAA;IACtB;kDAC8C;IAC9C,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAGkD,CAAA;AAOpF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,KAAG,CAAC,CAAC,aAAa,CAAC,YAAY,CAO7E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,KAAG,MAAM,GAAG,SAC6B,CAAA"}

package/esm/types/ModuleSelect.js

@@ -0,0 +1,63 @@
+import * as v from 'valibot';
+import { moduleExport } from './ModuleExport.js';
+import { schemaPath } from './SchemaPath.js';
+/**
+ * The standard lens/input module type: a candidate module fits a field when
+ * it accepts `{ lens: Lens<Normalize<FieldType>> }` (react-hook-form lenses).
+ * `__SlotNormalize` mirrors what generated form code does with
+ * `lens.focus(path).defined()` — optional/nullable wrappers are stripped on
+ * primitives and made recursively optional on objects — so an optional
+ * `string | undefined` field still matches a `Lens<string>` input.
+ *
+ * Pass as `moduleSelect(lensInputModuleType)`. Generators with a custom
+ * binding (e.g. a table cell renderer taking `{ value: F }`) declare their
+ * own `export type XModule<F> = …` source instead.
+ */
+export const lensInputModuleType = `import type { Lens } from '@hookform/lenses'
+type __SlotPrimitive = string | number | boolean | bigint | symbol | null | undefined | Date
+type __SlotNormalize<T> = [T] extends [__SlotPrimitive] ? NonNullable<T> : T extends ReadonlyArray<infer U> ? Array<__SlotNormalize<U>> : { [K in keyof T]?: __SlotNormalize<NonNullable<T[K]>> }
+export type InputModule<F> = (props: { lens: Lens<__SlotNormalize<F>> }) => unknown`;
+// Factory-created schemas can't be reference-compared to a singleton (unlike
+// `moduleExport`), so the descriptor walker recognises them — and reads their
+// declared module type — through this registry.
+const moduleTypes = new WeakMap();
+/**
+ * Declare a `moduleSelect` enrichment field: the `{ schemaPath, module? }`
+ * binding validated as one value. The enrichment editor renders it as a
+ * single composite control (path picker + type-matched component picker,
+ * the component gated on the path), and `toEnrichmentDescriptor` projects
+ * it as `type: 'moduleSelect'` carrying the declared `moduleType`.
+ *
+ * `moduleType` is the TypeScript source of the contract a chosen module
+ * must satisfy for the field — a single `export type XModule<F> = …` the
+ * editor's matcher checks candidates against
+ * (`typeof Candidate extends XModule<FieldType>`). It is a required part of
+ * the declaration, so the contract is always explicit — there is no hidden
+ * editor-side default. For the common lens/input case pass
+ * {@link lensInputModuleType}; only generators with a genuinely custom
+ * binding write their own source.
+ *
+ * ```ts
+ * import { lensInputModuleType, moduleSelect } from '@skmtc/core'
+ *
+ * export const formFieldItem = v.object({
+ *   moduleSelect: v.optional(v.pipe(moduleSelect(lensInputModuleType), v.title('Input'))),
+ *   label: v.optional(v.string())
+ * })
+ * ```
+ */
+export const moduleSelect = (moduleType) => {
+    const schema = v.object({
+        schemaPath,
+        module: v.optional(moduleExport)
+    });
+    moduleTypes.set(schema, moduleType);
+    return schema;
+};
+/**
+ * The module type a schema was declared with, or `undefined` when the schema
+ * is not a {@link moduleSelect}. Callers pass the schema as observed at
+ * runtime (the descriptor walker's structural view), so the parameter is
+ * deliberately `unknown`.
+ */
+export const moduleTypeOf = (schema) => typeof schema === 'object' && schema !== null ? moduleTypes.get(schema) : undefined;

package/esm/types/Preview.d.ts

@@ -1,10 +1,9 @@
 /**
- * @fileoverview Preview and Mapping System for SKMTC Core
+ * @fileoverview Preview System for SKMTC Core
  *
- * Types and Valibot schemas for the preview and mapping systems. Generators
- * may emit a {@link PreviewModule} and/or a {@link MappingModule} per
- * operation or model; the dispatcher pairs each module with a `*Source`
- * descriptor so tooling can trace generated code back to its origin in the
+ * Types and Valibot schemas for the preview system. Generators may emit a
+ * {@link PreviewModule} per operation or model; the dispatcher pairs each
+ * module with a `*Source` descriptor so tooling can trace generated code back to its origin in the
  * source schema.
  *
  * ## Source descriptors
@@ -117,19 +116,10 @@ export type PreviewModule = {
     name: string;
     exportPath: string;
 };
-export type MappingModule = {
-    name: string;
-    exportPath: string;
-    schema: string;
-};
 export type Preview = {
     module: PreviewModule;
     source: OasOperationSource | WebhookSource | GqlOperationSource | ModelSource;
 };
-export type Mapping = {
-    module: MappingModule;
-    source: OasOperationSource | WebhookSource | GqlOperationSource | ModelSource;
-};
 /**
  * Valibot schema for validating OAS operation source objects.
  *
@@ -184,23 +174,10 @@ export declare const modelSource: v.ObjectSchema<{
  * Validates preview module structures: name, export path, and group.
  */
 export declare const previewModule: v.GenericSchema<PreviewModule>;
-/**
- * Valibot schema for validating mapping module objects.
- *
- * Validates mapping module structures: name, export path, group, item type
- * (`'input'` | `'formatter'`), and schema reference.
- */
-export declare const mappingModule: v.GenericSchema<MappingModule>;
 /**
  * Valibot schema for validating preview objects.
  *
  * Validates complete preview structures including module and source information.
  */
 export declare const preview: v.GenericSchema<Preview>;
-/**
- * Valibot schema for validating mapping objects.
- *
- * Validates complete mapping structures including module and source information.
- */
-export declare const mapping: v.GenericSchema<Mapping>;
 //# sourceMappingURL=Preview.d.ts.map

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

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