@skmtc/core 0.0.984 → 0.16.1

package/script/types/OasBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OasBase.d.ts","sourceRoot":"","sources":["../../src/types/OasBase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO;IAClB;;;;;;;OAOG;IACH,UAAU,EAAE,UAAU,CAAA;gBAEV,OAAO,CAAC,EAAE,gBAAgB;CAMvC"}

package/script/types/OasBase.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @fileoverview `OasBase` base class for parsed nodes.
+ *
+ * Shared base for OAS and GQL classes that carry a source-document
+ * position, stored as a `StackTrail`. The trail is **total**: a parsed
+ * node snapshots the visitor position; a programmatically-constructed
+ * (synthetic) node gets `StackTrail.empty()`. Callers convert to a JSON
+ * Pointer on demand via `stackTrail.toJsonPointer()`, gating on
+ * `stackTrail.isEmpty()` for synthetic nodes — there is no `undefined`.
+ *
+ * @module OasBase
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OasBase = void 0;
+const StackTrail_js_1 = require("../context/StackTrail.js");
+/**
+ * Base class for parsed nodes that carry a source-document position.
+ *
+ * Each schema / operation class extends this so the parse-position
+ * field is declared in one place. Subclass constructors call
+ * `super(context)`; `OasBase` reads `context.currentStackTrail` and
+ * snapshots it, or records `StackTrail.empty()` when there is none.
+ * Pure parse-time metadata — has no spec semantics.
+ *
+ * Adds **only** the `stackTrail` slot. Schema classes remain a
+ * discriminated union with literal `type` / `oasType` fields
+ * preserved on each subclass.
+ */
+class OasBase {
+    constructor(context) {
+        /**
+         * StackTrail snapshot captured at construction time. Cloned so that
+         * subsequent factory traversal doesn't mutate this node's recorded
+         * position. `StackTrail.empty()` when the node was constructed
+         * programmatically (no parse context / no active stack-trail scope) —
+         * a synthetic node with no source position. No parsed node is ever
+         * at the empty trail, so `isEmpty()` cleanly means "synthetic".
+         */
+        Object.defineProperty(this, "stackTrail", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // Attribution is always on — snapshot the position when parsing
+        // within an active stack-trail scope; otherwise the node is
+        // synthetic and carries the empty (positionless) trail.
+        this.stackTrail = context?.currentStackTrail?.clone() ?? StackTrail_js_1.StackTrail.empty();
+    }
+}
+exports.OasBase = OasBase;

package/script/types/Preview.d.ts

@@ -1,120 +1,144 @@
 /**
  * @fileoverview Preview and Mapping System for SKMTC Core
  *
- * This module provides comprehensive types and utilities for creating preview
- * interfaces and mapping configurations for generated code. The preview system
- * enables interactive demonstrations of generated APIs, forms, tables, and
- * other UI components within development tools and documentation.
+ * 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
+ * source schema.
  *
- * The mapping system provides metadata about how OpenAPI operations and models
- * translate to generated code, enabling rich tooling experiences and
- * reverse-engineering capabilities.
+ * ## Source descriptors
  *
- * ## Key Features
+ * The `source` discriminated union narrows on `type`:
  *
- * - **Interactive Previews**: Rich preview interfaces for generated components
- * - **Source Mapping**: Traceability from generated code back to OpenAPI sources
- * - **UI Grouping**: Organized grouping of related UI components (forms, tables, inputs)
- * - **Generator Integration**: Deep integration with the generator pipeline
- * - **Type Safety**: Comprehensive validation and type safety throughout
+ * - `oasOperation` — carries `operationPath` and `operationMethod` (HTTP)
+ * - `gqlOperation` — carries `rootKind` and `fieldName` (GraphQL)
+ * - `model` — carries `refName` (protocol-neutral)
  *
- * @example Creating operation previews
+ * @example Building an OAS operation source
  * ```typescript
- * import type { PreviewModule, OperationSource } from '@skmtc/core/Preview';
+ * import type { OasOperationSource } from '@skmtc/core/Preview';
  *
- * const operationSource: OperationSource = {
- *   type: 'operation',
+ * const source: OasOperationSource = {
+ *   type: 'oasOperation',
  *   generatorId: 'react-forms',
  *   operationPath: '/users',
- *   operationMethod: 'POST'
+ *   operationMethod: 'post'
  * };
+ * ```
+ *
+ * @example Building a GraphQL operation source
+ * ```typescript
+ * import type { GqlOperationSource } from '@skmtc/core/Preview';
  *
- * const preview: PreviewModule = {
- *   title: 'Create User Form',
- *   description: 'Interactive form for creating new users',
- *   group: 'forms',
- *   source: operationSource,
- *   moduleName: 'CreateUserForm',
- *   exportName: 'default'
+ * const source: GqlOperationSource = {
+ *   type: 'gqlOperation',
+ *   generatorId: 'react-forms',
+ *   rootKind: 'mutation',
+ *   fieldName: 'createUser'
  * };
  * ```
  *
- * @example Creating model previews
+ * @example Building a model source
  * ```typescript
- * import type { PreviewModule, ModelSource } from '@skmtc/core/Preview';
+ * import type { ModelSource } from '@skmtc/core/Preview';
  *
- * const modelSource: ModelSource = {
+ * const source: ModelSource = {
  *   type: 'model',
  *   generatorId: 'typescript-types',
- *   refName: 'User'
- * };
- *
- * const preview: PreviewModule = {
- *   title: 'User Type Definition',
- *   description: 'TypeScript interface for User model',
- *   group: 'tables',
- *   source: modelSource,
- *   moduleName: 'UserTypes',
- *   exportName: 'User'
+ *   refName: 'User',
+ *   variant: 'main'
  * };
  * ```
  *
- * @example Working with mappings
+ * @example Pairing a module with a source
  * ```typescript
- * import type { MappingModule } from '@skmtc/core/Preview';
+ * import type { Preview, PreviewModule } from '@skmtc/core/Preview';
  *
- * const mapping: MappingModule = {
- *   source: operationSource,
- *   moduleName: 'UserApi',
- *   exportName: 'createUser',
- *   generatedPath: './src/generated/UserApi.ts'
+ * const module: PreviewModule = {
+ *   name: 'CreateUserForm',
+ *   exportPath: './generated/forms/CreateUserForm.tsx',
+ *   group: 'forms'
  * };
+ *
+ * const preview: Preview = { module, source };
  * ```
  *
  * @module Preview
  */
+import "../_dnt.polyfills.js";
 import { type Method } from './Method.js';
+import type { GqlRootKind } from '../gql/operation/GqlOperation.js';
 import * as v from 'valibot';
-export type OperationSource = {
-    type: 'operation';
+export type OasOperationSource = {
+    type: 'oasOperation';
     generatorId: string;
     operationPath: string;
     operationMethod: Method;
+    /**
+     * Operation variant the artifact was emitted for. `'main'` for
+     * variants-unaware generators and for single-variant projects; one
+     * of the consumer-named variant keys otherwise (see {@link Variant}).
+     */
+    variant: string;
+};
+export type WebhookSource = {
+    type: 'webhook';
+    generatorId: string;
+    webhookName: string;
+    webhookMethod: Method;
+    /**
+     * Webhook variant the artifact was emitted for (see {@link Variant}).
+     */
+    variant: string;
+};
+export type GqlOperationSource = {
+    type: 'gqlOperation';
+    generatorId: string;
+    rootKind: GqlRootKind;
+    fieldName: string;
+    /**
+     * Operation variant the artifact was emitted for (see {@link Variant}).
+     */
+    variant: string;
 };
 export type ModelSource = {
     type: 'model';
     generatorId: string;
     refName: string;
+    /**
+     * Model variant the artifact was emitted for. `'main'` for
+     * variants-unaware generators and for single-variant projects; one
+     * of the consumer-named variant keys otherwise (see {@link Variant}).
+     */
+    variant: string;
 };
-export type PreviewGroup = 'forms' | 'tables' | 'inputs';
 export type PreviewModule = {
     name: string;
     exportPath: string;
-    group: PreviewGroup;
 };
 export type MappingModule = {
     name: string;
     exportPath: string;
-    group: PreviewGroup;
-    itemType: 'input' | 'formatter';
     schema: string;
 };
 export type Preview = {
     module: PreviewModule;
-    source: OperationSource | ModelSource;
+    source: OasOperationSource | WebhookSource | GqlOperationSource | ModelSource;
 };
 export type Mapping = {
     module: MappingModule;
-    source: OperationSource | ModelSource;
+    source: OasOperationSource | WebhookSource | GqlOperationSource | ModelSource;
 };
 /**
- * Valibot schema for validating operation source objects.
+ * Valibot schema for validating OAS operation source objects.
  *
- * Validates operation source structures including type, generator ID,
- * operation path, and HTTP method information.
+ * Validates the `oasOperation` source variant — type, generator ID,
+ * operation path, and HTTP method. See {@link gqlOperationSource} for the
+ * GraphQL counterpart.
  */
-export declare const operationSource: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<'operation', undefined>;
+export declare const oasOperationSource: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<'oasOperation', undefined>;
     readonly generatorId: v.StringSchema<undefined>;
     readonly operationPath: v.StringSchema<undefined>;
     readonly operationMethod: v.UnionSchema<[
@@ -127,6 +151,20 @@ export declare const operationSource: v.ObjectSchema<{
         v.LiteralSchema<'options', undefined>,
         v.LiteralSchema<'trace', undefined>
     ], undefined>;
+    readonly variant: v.StringSchema<undefined>;
+}, undefined>;
+/**
+ * Valibot schema for validating GraphQL operation source objects.
+ *
+ * Sibling to {@link oasOperationSource} for the GraphQL protocol — validates
+ * `rootKind` and `fieldName` instead of `path` / `method`.
+ */
+export declare const gqlOperationSource: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<'gqlOperation', undefined>;
+    readonly generatorId: v.StringSchema<undefined>;
+    readonly rootKind: v.PicklistSchema<['query', 'mutation', 'subscription'], undefined>;
+    readonly fieldName: v.StringSchema<undefined>;
+    readonly variant: v.StringSchema<undefined>;
 }, undefined>;
 /**
  * Valibot schema for validating model source objects.
@@ -138,23 +176,19 @@ export declare const modelSource: v.ObjectSchema<{
     readonly type: v.LiteralSchema<'model', undefined>;
     readonly generatorId: v.StringSchema<undefined>;
     readonly refName: v.StringSchema<undefined>;
+    readonly variant: v.StringSchema<undefined>;
 }, undefined>;
-/**
- * Valibot schema for validating preview group values.
- *
- * Validates preview group categories for UI organization.
- */
-export declare const previewGroup: v.GenericSchema<PreviewGroup>;
 /**
  * Valibot schema for validating preview module objects.
  *
- * Validates preview module structures including group, title, and description.
+ * 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 for file relationship tracking.
+ * Validates mapping module structures: name, export path, group, item type
+ * (`'input'` | `'formatter'`), and schema reference.
  */
 export declare const mappingModule: v.GenericSchema<MappingModule>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"Preview.d.ts","sourceRoot":"","sources":["../../src/types/Preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AAEH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,WAAW,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,OAAO,GAAG,WAAW,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,eAAe,GAAG,WAAW,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,eAAe,GAAG,WAAW,CAAA;CACtC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,YAAY,CAC1C;IACE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IACtD,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;CACF,EACD,SAAS,CAMT,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;CAC5C,EACD,SAAS,CAKT,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAA6C,CAAA;AAEpG;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAIvD,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAMvD,CAAA;AAKF;;;;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":"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"}

package/script/types/Preview.js

@@ -1,79 +1,4 @@
 "use strict";
-/**
- * @fileoverview Preview and Mapping System for SKMTC Core
- *
- * This module provides comprehensive types and utilities for creating preview
- * interfaces and mapping configurations for generated code. The preview system
- * enables interactive demonstrations of generated APIs, forms, tables, and
- * other UI components within development tools and documentation.
- *
- * The mapping system provides metadata about how OpenAPI operations and models
- * translate to generated code, enabling rich tooling experiences and
- * reverse-engineering capabilities.
- *
- * ## Key Features
- *
- * - **Interactive Previews**: Rich preview interfaces for generated components
- * - **Source Mapping**: Traceability from generated code back to OpenAPI sources
- * - **UI Grouping**: Organized grouping of related UI components (forms, tables, inputs)
- * - **Generator Integration**: Deep integration with the generator pipeline
- * - **Type Safety**: Comprehensive validation and type safety throughout
- *
- * @example Creating operation previews
- * ```typescript
- * import type { PreviewModule, OperationSource } from '@skmtc/core/Preview';
- *
- * const operationSource: OperationSource = {
- *   type: 'operation',
- *   generatorId: 'react-forms',
- *   operationPath: '/users',
- *   operationMethod: 'POST'
- * };
- *
- * const preview: PreviewModule = {
- *   title: 'Create User Form',
- *   description: 'Interactive form for creating new users',
- *   group: 'forms',
- *   source: operationSource,
- *   moduleName: 'CreateUserForm',
- *   exportName: 'default'
- * };
- * ```
- *
- * @example Creating model previews
- * ```typescript
- * import type { PreviewModule, ModelSource } from '@skmtc/core/Preview';
- *
- * const modelSource: ModelSource = {
- *   type: 'model',
- *   generatorId: 'typescript-types',
- *   refName: 'User'
- * };
- *
- * const preview: PreviewModule = {
- *   title: 'User Type Definition',
- *   description: 'TypeScript interface for User model',
- *   group: 'tables',
- *   source: modelSource,
- *   moduleName: 'UserTypes',
- *   exportName: 'User'
- * };
- * ```
- *
- * @example Working with mappings
- * ```typescript
- * import type { MappingModule } from '@skmtc/core/Preview';
- *
- * const mapping: MappingModule = {
- *   source: operationSource,
- *   moduleName: 'UserApi',
- *   exportName: 'createUser',
- *   generatedPath: './src/generated/UserApi.ts'
- * };
- * ```
- *
- * @module Preview
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -108,20 +33,104 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapping = exports.preview = exports.mappingModule = exports.previewModule = exports.previewGroup = exports.modelSource = exports.operationSource = void 0;
+exports.mapping = exports.preview = exports.mappingModule = exports.previewModule = exports.modelSource = exports.gqlOperationSource = exports.oasOperationSource = void 0;
+/**
+ * @fileoverview Preview and Mapping 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
+ * source schema.
+ *
+ * ## Source descriptors
+ *
+ * The `source` discriminated union narrows on `type`:
+ *
+ * - `oasOperation` — carries `operationPath` and `operationMethod` (HTTP)
+ * - `gqlOperation` — carries `rootKind` and `fieldName` (GraphQL)
+ * - `model` — carries `refName` (protocol-neutral)
+ *
+ * @example Building an OAS operation source
+ * ```typescript
+ * import type { OasOperationSource } from '@skmtc/core/Preview';
+ *
+ * const source: OasOperationSource = {
+ *   type: 'oasOperation',
+ *   generatorId: 'react-forms',
+ *   operationPath: '/users',
+ *   operationMethod: 'post'
+ * };
+ * ```
+ *
+ * @example Building a GraphQL operation source
+ * ```typescript
+ * import type { GqlOperationSource } from '@skmtc/core/Preview';
+ *
+ * const source: GqlOperationSource = {
+ *   type: 'gqlOperation',
+ *   generatorId: 'react-forms',
+ *   rootKind: 'mutation',
+ *   fieldName: 'createUser'
+ * };
+ * ```
+ *
+ * @example Building a model source
+ * ```typescript
+ * import type { ModelSource } from '@skmtc/core/Preview';
+ *
+ * const source: ModelSource = {
+ *   type: 'model',
+ *   generatorId: 'typescript-types',
+ *   refName: 'User',
+ *   variant: 'main'
+ * };
+ * ```
+ *
+ * @example Pairing a module with a source
+ * ```typescript
+ * import type { Preview, PreviewModule } from '@skmtc/core/Preview';
+ *
+ * const module: PreviewModule = {
+ *   name: 'CreateUserForm',
+ *   exportPath: './generated/forms/CreateUserForm.tsx',
+ *   group: 'forms'
+ * };
+ *
+ * const preview: Preview = { module, source };
+ * ```
+ *
+ * @module Preview
+ */
+require("../_dnt.polyfills.js");
 const Method_js_1 = require("./Method.js");
 const v = __importStar(require("valibot"));
 /**
- * Valibot schema for validating operation source objects.
+ * Valibot schema for validating OAS operation source objects.
  *
- * Validates operation source structures including type, generator ID,
- * operation path, and HTTP method information.
+ * Validates the `oasOperation` source variant — type, generator ID,
+ * operation path, and HTTP method. See {@link gqlOperationSource} for the
+ * GraphQL counterpart.
  */
-exports.operationSource = v.object({
-    type: v.literal('operation'),
+exports.oasOperationSource = v.object({
+    type: v.literal('oasOperation'),
     generatorId: v.string(),
     operationPath: v.string(),
-    operationMethod: Method_js_1.method
+    operationMethod: Method_js_1.method,
+    variant: v.string()
+});
+/**
+ * Valibot schema for validating GraphQL operation source objects.
+ *
+ * Sibling to {@link oasOperationSource} for the GraphQL protocol — validates
+ * `rootKind` and `fieldName` instead of `path` / `method`.
+ */
+exports.gqlOperationSource = v.object({
+    type: v.literal('gqlOperation'),
+    generatorId: v.string(),
+    rootKind: v.picklist(['query', 'mutation', 'subscription']),
+    fieldName: v.string(),
+    variant: v.string()
 });
 /**
  * Valibot schema for validating model source objects.
@@ -132,37 +141,30 @@ exports.operationSource = v.object({
 exports.modelSource = v.object({
     type: v.literal('model'),
     generatorId: v.string(),
-    refName: v.string()
+    refName: v.string(),
+    variant: v.string()
 });
-/**
- * Valibot schema for validating preview group values.
- *
- * Validates preview group categories for UI organization.
- */
-exports.previewGroup = v.picklist(['forms', 'tables', 'inputs']);
 /**
  * Valibot schema for validating preview module objects.
  *
- * Validates preview module structures including group, title, and description.
+ * Validates preview module structures: name, export path, and group.
  */
 exports.previewModule = v.object({
     name: v.string(),
-    exportPath: v.string(),
-    group: exports.previewGroup
+    exportPath: v.string()
 });
 /**
  * Valibot schema for validating mapping module objects.
  *
- * Validates mapping module structures for file relationship tracking.
+ * Validates mapping module structures: name, export path, group, item type
+ * (`'input'` | `'formatter'`), and schema reference.
  */
 exports.mappingModule = v.object({
     name: v.string(),
     exportPath: v.string(),
-    group: exports.previewGroup,
-    itemType: v.picklist(['input', 'formatter']),
     schema: v.string()
 });
-const source = v.variant('type', [exports.operationSource, exports.modelSource]);
+const source = v.variant('type', [exports.oasOperationSource, exports.gqlOperationSource, exports.modelSource]);
 /**
  * Valibot schema for validating preview objects.
  *

package/script/types/RefName.d.ts

@@ -68,6 +68,7 @@
  *
  * @module RefName
  */
+import "../_dnt.polyfills.js";
 import type { Brand } from './Brand.js';
 /**
  * Branded type representing a reference name for OpenAPI schemas.
@@ -97,7 +98,7 @@ import type { Brand } from './Brand.js';
  *
  * @example In generator contexts
  * ```typescript
- * class ModelGenerator extends ModelBase {
+ * class ModelGenerator extends ModelProjectionBase {
  *   constructor(args: { refName: RefName; ... }) {
  *     super(args);
  *     // this.refName is guaranteed to be a valid schema reference
@@ -107,7 +108,7 @@ import type { Brand } from './Brand.js';
  *     // RefName ensures we're working with valid schema identifiers
  *     const schemaName = this.refName; // Type: RefName
  *     return new Definition({
- *       identifier: Identifier.createType(schemaName),
+ *       identifier: createType(schemaName),
  *       // ...
  *     });
  *   }

package/script/types/RefName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RefName.d.ts","sourceRoot":"","sources":["../../src/types/RefName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA"}
+{"version":3,"file":"RefName.d.ts","sourceRoot":"","sources":["../../src/types/RefName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA"}

package/script/types/RefName.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * @fileoverview Reference Name System for SKMTC Core
  *
@@ -69,4 +70,4 @@
  *
  * @module RefName
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+require("../_dnt.polyfills.js");

package/script/types/Results.d.ts

@@ -95,6 +95,7 @@
  *
  * @module Results
  */
+import "../_dnt.polyfills.js";
 import * as v from 'valibot';
 /**
  * Type representing the possible outcomes of SKMTC processing operations.

package/script/types/Results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Results.d.ts","sourceRoot":"","sources":["../../src/types/Results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAEH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,CAAA;AAErF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAMjD,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAC3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAGpD,CAAA"}
+{"version":3,"file":"Results.d.ts","sourceRoot":"","sources":["../../src/types/Results.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,CAAA;AAErF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAMjD,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAC3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAGpD,CAAA"}