@skmtc/core 0.16.3 → 0.26.0

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toResponseV3 = exports.toOptionalResponsesV3 = exports.toResponsesV3 = void 0;
 const toRefV31_js_1 = require("../ref/toRefV31.js");
 const toHeadersV3_js_1 = require("../header/toHeadersV3.js");
+const toLinksV3_js_1 = require("../link/toLinksV3.js");
 const refFns_js_1 = require("../../../helpers/refFns.js");
 const toMediaTypeItemV3_js_1 = require("../mediaType/toMediaTypeItemV3.js");
 const Response_js_1 = require("../../../oas/response/Response.js");
@@ -38,7 +39,7 @@ const toResponseV3 = ({ response, stackTrail, context }) => {
     if ((0, refFns_js_1.isRef)(response)) {
         return (0, toRefV31_js_1.toRefV31)({ ref: response, refType: 'response', stackTrail, context });
     }
-    const { description, headers, content, ...skipped } = response;
+    const { description, headers, links, content, ...skipped } = response;
     const extensionFields = (0, toSpecificationExtensionsV3_js_1.toSpecificationExtensionsV3)({
         skipped,
         parent: response,
@@ -47,10 +48,12 @@ const toResponseV3 = ({ response, stackTrail, context }) => {
         parentType: 'response'
     });
     const parsedHeaders = stackTrail.trace('headers', st => (0, toHeadersV3_js_1.toHeadersV3)({ headers, stackTrail: st, context }));
+    const parsedLinks = stackTrail.trace('links', st => (0, toLinksV3_js_1.toLinksV3)({ links, stackTrail: st, context }));
     const parsedContent = stackTrail.trace('content', st => (0, toMediaTypeItemV3_js_1.toOptionalMediaTypeItemsV3)({ content, stackTrail: st, context }));
     return context.withStackTrail(stackTrail, () => new Response_js_1.OasResponse({
         description,
         headers: parsedHeaders,
+        links: parsedLinks,
         content: parsedContent,
         extensionFields
     }, context));

package/script/parse/v3-1/schema/toSchemasV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toSchemasV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/schema/toSchemasV3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAarD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;IAC3E,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,kCAIzB,eAAe,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAmB/D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IACvF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,kCAIjC,uBAAuB,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,SAM3E,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAA;IAC1D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAuPD,eAAO,MAAM,UAAU,GAAI,iCAIxB,cAAc,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAoQ9C,CAAA;AA+CD,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAA;IACtE,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,iCAIhC,sBAAsB,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAM1D,CAAA"}
+{"version":3,"file":"toSchemasV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/schema/toSchemasV3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAarD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;IAC3E,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,kCAIzB,eAAe,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAmB/D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IACvF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,kCAIjC,uBAAuB,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,SAM3E,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAA;IAC1D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAuPD,eAAO,MAAM,UAAU,GAAI,iCAIxB,cAAc,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CA6Q9C,CAAA;AA+CD,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAA;IACtE,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,iCAIhC,sBAAsB,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAM1D,CAAA"}

package/script/parse/v3-1/schema/toSchemasV3.js

@@ -244,6 +244,14 @@ const toSchemaV3 = ({ schema, stackTrail, context }) => {
     if ((0, refFns_js_1.isRef)(schema)) {
         return (0, toRefV31_js_1.toRefV31)({ ref: schema, refType: 'schema', stackTrail, context });
     }
+    // OpenAPI `not` has no faithful TypeScript representation: a generated type
+    // that ignored it would *widen* the contract (accepting shapes the schema
+    // forbids). Refuse the schema rather than emit a type that lies. The throw
+    // is isolated by `tryParseAt` into an `INVALID_SCHEMA` issue, and consumers
+    // of this schema are pruned via `removeErroredItems` (INVALID_DEPENDENCY_REF).
+    if ('not' in schema) {
+        throw new Error('Schema uses unsupported "not" keyword');
+    }
     const normalized = normalizeSchemaShape(schema);
     if (normalized !== schema) {
         return (0, exports.toSchemaV3)({ schema: normalized, stackTrail, context });

package/script/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/script/parse/v3-1/union/toUnion.js

@@ -8,13 +8,14 @@ const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toS
 const parseNullable_js_1 = require("../_helpers/parseNullable.js");
 const parseExample_js_1 = require("../_helpers/parseExample.js");
 const parseDefault_js_1 = require("../_helpers/parseDefault.js");
+const toExternalDocs_js_1 = require("../externalDocs/toExternalDocs.js");
 const toUnion = ({ value, members, parentType, stackTrail, context }) => {
     const { nullable, value: valueWithoutNullable } = (0, parseNullable_js_1.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 = (0, parseExample_js_1.parseExample)({
         value: unparsedExample,
         context,
@@ -53,6 +54,7 @@ const toUnion = ({ value, members, parentType, stackTrail, context }) => {
     return context.withStackTrail(stackTrail, () => new Union_js_1.OasUnion({
         title,
         description,
+        externalDocs: stackTrail.trace('externalDocs', st => (0, toExternalDocs_js_1.toExternalDocs)({ externalDocs, stackTrail: st, context })),
         nullable,
         default: defaultValue,
         discriminator: discriminatorParsed,

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

@@ -70,20 +70,20 @@ const CoreContext_js_1 = require("../context/CoreContext.js");
  * }
  * ```
  */
-const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap, logsPath, startAt, silent, stackTrail, attribution }) => {
+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, 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,
@@ -93,6 +93,6 @@ const toArtifacts = ({ traceId, spanId, document, settings, toGeneratorConfigMap
         startAt,
         endAt: Date.now()
     };
-    return { artifacts, manifest, sidecars, generationMap };
+    return { artifacts, manifest, sidecars, generationMap, inspection };
 };
 exports.toArtifacts = toArtifacts;

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

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toInspection = void 0;
+/**
+ * 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.
+ */
+const toInspection = (files) => walk(files, 0, new Set());
+exports.toInspection = toInspection;

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

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.emptyEnrichmentSchema = exports.generatorEnrichments = exports.isReservedEnrichmentKey = exports.GENERATOR_ENRICHMENT_KEY = exports.STACK_ENRICHMENT_KEY = exports.gqlRootKindEnrichments = exports.gqlFieldEnrichments = exports.oasPathEnrichments = exports.oasMethodEnrichments = exports.modelEnrichments = void 0;
+exports.emptyEnrichmentSchema = exports.generatorEnrichments = exports.isReservedEnrichmentKey = exports.GENERATOR_ENRICHMENT_KEY = exports.STACK_ENRICHMENT_KEY = exports.gqlRootKindEnrichments = exports.gqlFieldEnrichments = exports.oasPathEnrichments = exports.oasWebhookEnrichments = exports.oasOperationEnrichments = exports.modelEnrichments = void 0;
 /**
  * @fileoverview Enrichment hierarchy for SKMTC Core.
  *
@@ -43,7 +43,7 @@ exports.emptyEnrichmentSchema = exports.generatorEnrichments = exports.isReserve
  *   - **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
@@ -81,8 +81,9 @@ exports.emptyEnrichmentSchema = exports.generatorEnrichments = exports.isReserve
 require("../_dnt.polyfills.js");
 const v = __importStar(require("valibot"));
 exports.modelEnrichments = v.record(v.string(), v.unknown());
-exports.oasMethodEnrichments = v.record(v.string(), v.unknown());
-exports.oasPathEnrichments = v.record(v.string(), exports.oasMethodEnrichments);
+exports.oasOperationEnrichments = v.record(v.string(), v.unknown());
+exports.oasWebhookEnrichments = v.record(v.string(), v.unknown());
+exports.oasPathEnrichments = v.record(v.string(), exports.oasOperationEnrichments);
 exports.gqlFieldEnrichments = v.record(v.string(), v.unknown());
 exports.gqlRootKindEnrichments = v.record(v.string(), exports.gqlFieldEnrichments);
 /**

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

@@ -185,7 +185,6 @@ exports.manifestContent = v.object({
     region: v.optional(v.string()),
     files: v.record(v.string(), exports.manifestEntry),
     previews: v.record(v.string(), Preview_js_1.preview),
-    mappings: v.optional(v.record(v.string(), Preview_js_1.mapping)),
     results: Results_js_1.resultsItem,
     parseIssues: v.array(parseIssue),
     startAt: v.number(),

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

@@ -0,0 +1,101 @@
+"use strict";
+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.moduleTypeOf = exports.moduleSelect = exports.lensInputModuleType = void 0;
+const v = __importStar(require("valibot"));
+const ModuleExport_js_1 = require("./ModuleExport.js");
+const SchemaPath_js_1 = require("./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.
+ */
+exports.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())
+ * })
+ * ```
+ */
+const moduleSelect = (moduleType) => {
+    const schema = v.object({
+        schemaPath: SchemaPath_js_1.schemaPath,
+        module: v.optional(ModuleExport_js_1.moduleExport)
+    });
+    moduleTypes.set(schema, moduleType);
+    return schema;
+};
+exports.moduleSelect = 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`.
+ */
+const moduleTypeOf = (schema) => typeof schema === 'object' && schema !== null ? moduleTypes.get(schema) : undefined;
+exports.moduleTypeOf = moduleTypeOf;