@skmtc/core 0.16.3 → 0.26.0

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,SAAS,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,kBAAkB,GAAG,WAAW,CAAA;CAC9E,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,kBAAkB,GAAG,WAAW,CAAA;CAC9E,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,YAAY,CAC7C;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IACzD,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC/C,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC,WAAW,CACrC;QACE,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;QACjC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;QAClC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;QACjC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;QACnC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;QACpC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;QAClC,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;QACrC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;KACpC,EACD,SAAS,CACV,CAAA;IACD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;CAC5C,EACD,SAAS,CAOT,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,YAAY,CAC7C;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IACzD,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC,CAAA;IACrF,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;CAC5C,EACD,SAAS,CAOT,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,YAAY,CACtC;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAClD,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;CAC5C,EACD,SAAS,CAMT,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGvD,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAIvD,CAAA;AAQF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAG3C,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAG3C,CAAA"}
+{"version":3,"file":"Preview.d.ts","sourceRoot":"","sources":["../../src/types/Preview.ts"],"names":[],"mappings":"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"}

package/esm/types/Preview.js

@@ -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,17 +116,6 @@ export const previewModule = v.object({
     name: v.string(),
     exportPath: v.string()
 });
-/**
- * Valibot schema for validating mapping module objects.
- *
- * Validates mapping module structures: name, export path, group, item type
- * (`'input'` | `'formatter'`), and schema reference.
- */
-export const mappingModule = v.object({
-    name: v.string(),
-    exportPath: v.string(),
-    schema: v.string()
-});
 const source = v.variant('type', [oasOperationSource, gqlOperationSource, modelSource]);
 /**
  * Valibot schema for validating preview objects.
@@ -138,12 +126,3 @@ export const preview = v.object({
     module: previewModule,
     source: source
 });
-/**
- * Valibot schema for validating mapping objects.
- *
- * Validates complete mapping structures including module and source information.
- */
-export const mapping = v.object({
-    module: mappingModule,
-    source: source
-});

package/esm/types/SchemaPath.d.ts

@@ -0,0 +1,17 @@
+import * as v from 'valibot';
+/**
+ * A path of property names into a parsed schema document — e.g.
+ * `['customer', 'primaryAddress', 'type']` to reach the nested
+ * `type` property. Generators that overlay per-field enrichments
+ * key those overlays by schema path.
+ */
+export type SchemaPath = string[];
+/**
+ * Canonical Valibot schema for an `SchemaPath`. There is deliberately no
+ * standalone path-picker widget: a path is declared together with its
+ * component binding as one `moduleSelect` field (this schema is the
+ * `schemaPath` half of that pair). Used standalone it renders as a generic
+ * array of strings.
+ */
+export declare const schemaPath: v.GenericSchema<SchemaPath>;
+//# sourceMappingURL=SchemaPath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaPath.d.ts","sourceRoot":"","sources":["../../src/types/SchemaPath.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAA;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAAuB,CAAA"}

package/esm/types/SchemaPath.js

@@ -0,0 +1,9 @@
+import * as v from 'valibot';
+/**
+ * Canonical Valibot schema for an `SchemaPath`. There is deliberately no
+ * standalone path-picker widget: a path is declared together with its
+ * component binding as one `moduleSelect` field (this schema is the
+ * `schemaPath` half of that pair). Used standalone it renders as a generic
+ * array of strings.
+ */
+export const schemaPath = v.array(v.string());

package/esm/types/Settings.d.ts

@@ -49,9 +49,9 @@
  * @module Settings
  */
 import "../_dnt.polyfills.js";
-import { type GeneratorEnrichments } from './Enrichments.js';
-import * as v from 'valibot';
-import { type Method } from './Method.js';
+import { type GeneratorEnrichments } from "./Enrichments.js";
+import * as v from "valibot";
+import { type Method } from "./Method.js";
 /**
  * Valibot schema for {@link ModulePackage}.
  *
@@ -430,6 +430,13 @@ export type ClientSettings = {
      * in v1. See {@link AnchorsSettings}.
      */
     anchors?: AnchorsSettings;
+    /**
+     * Preview input-matcher discovery directories (project-root relative, e.g.
+     * `src/fields`, `src/inputs`). A preview/hub concern: the generation engine
+     * ignores it. Declared here so the CLI preserves it when reading `client.json`
+     * and carries it through `skmtc push` to the hub.
+     */
+    inputDirs?: string[];
 };
 /**
  * Configuration for SKMTC client with optional project identification.
@@ -442,6 +449,20 @@ export type SkmtcClientConfig = {
     serverUrl?: string;
     /** Optional project identifier for organizational contexts */
     projectKey?: string;
+    /**
+     * skmtc-hub push destination in `@<account>/<slug>` form (the account may be
+     * a user or an org) — the `skmtc push` target, analogous to a git remote.
+     * Ignored by `skmtc generate`; consumed only by `skmtc push`.
+     */
+    project?: string;
+    /**
+     * skmtc-hub API binding in `@<account>/<slug>` form — the registered schema
+     * this project's `source` maps to on the hub, analogous to a git remote.
+     * Recorded by `skmtc project create` (the schema-register write-back) so a
+     * re-run versions the same API instead of creating a duplicate. Ignored by
+     * `skmtc generate`.
+     */
+    api?: string;
     /** Optional schema path or url for OpenAPI schema */
     source?: string;
     /** Client settings for customizing generation behavior */

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

@@ -1 +1 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../src/types/Settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAUjD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAWvD,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAGhD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAmC,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGxD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAAuC,CAAA;AAI1F;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAGtD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAGhE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,aAAa,CAAC,gBAAgB,CAG9D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGxD,CAAA;AAQD;;;;;GAKG;AACH;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAG3D,CAAA;AAEF,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAQzD,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,cAAc,GAAG,UAAU,GAAG,MAAM,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AAE5E;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,OAAO,GAAG,iBAAiB,GAAG,aAAa,GAAG,MAAM,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;IAC1B,kDAAkD;IAClD,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAK/D,CAAA"}
+{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../src/types/Settings.ts"],"names":[],"mappings":"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"}