@skmtc/core 0.0.805 → 0.0.807

package/esm/types/GeneratorKeys.d.ts

@@ -1,3 +1,67 @@
+/**
+ * @fileoverview Generator Key System for SKMTC Core
+ *
+ * This module provides a comprehensive type-safe key system for identifying and
+ * organizing generated content within the SKMTC pipeline. Generator keys provide
+ * unique identification for operations, models, and other generated artifacts,
+ * ensuring proper organization and preventing collisions.
+ *
+ * The key system uses branded types to ensure type safety and provides utilities
+ * for creating, parsing, and manipulating keys throughout the generation process.
+ *
+ * ## Key Features
+ *
+ * - **Type Safety**: Branded types prevent mixing different kinds of keys
+ * - **Unique Identification**: Composite keys ensure global uniqueness
+ * - **Parsing Utilities**: Safe extraction of components from composite keys
+ * - **Generator Organization**: Clear mapping between generators and their artifacts
+ * - **Reference Integration**: Seamless integration with OpenAPI reference system
+ *
+ * @example Creating operation generator keys
+ * ```typescript
+ * import { toOperationGeneratorKey, parseOperationGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * // Create a key for a GET /users operation in api-client generator
+ * const key = toOperationGeneratorKey({
+ *   generatorId: 'api-client',
+ *   path: '/users',
+ *   method: 'GET'
+ * });
+ *
+ * // Parse the key back into components
+ * const parsed = parseOperationGeneratorKey(key);
+ * console.log(parsed); // { generatorId: 'api-client', path: '/users', method: 'GET' }
+ * ```
+ *
+ * @example Working with model keys
+ * ```typescript
+ * import { toModelGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * const modelKey = toModelGeneratorKey({
+ *   generatorId: 'typescript-models',
+ *   refName: 'User' as RefName
+ * });
+ * ```
+ *
+ * @example Type-safe key handling
+ * ```typescript
+ * import type { OperationGeneratorKey, ModelGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * function handleOperationKey(key: OperationGeneratorKey) {
+ *   // TypeScript ensures this is specifically an operation key
+ *   const parsed = parseOperationGeneratorKey(key);
+ *   return `Processing ${parsed.method} ${parsed.path}`;
+ * }
+ *
+ * function handleModelKey(key: ModelGeneratorKey) {
+ *   // TypeScript ensures this is specifically a model key
+ *   const parsed = parseModelGeneratorKey(key);
+ *   return `Processing model ${parsed.refName}`;
+ * }
+ * ```
+ *
+ * @module GeneratorKeys
+ */
 import "../_dnt.polyfills.js";
 import type { OasOperation } from '../oas/operation/Operation.js';
 import type { Brand } from './Brand.js';

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

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

package/esm/types/GeneratorKeys.js

@@ -1,3 +1,67 @@
+/**
+ * @fileoverview Generator Key System for SKMTC Core
+ *
+ * This module provides a comprehensive type-safe key system for identifying and
+ * organizing generated content within the SKMTC pipeline. Generator keys provide
+ * unique identification for operations, models, and other generated artifacts,
+ * ensuring proper organization and preventing collisions.
+ *
+ * The key system uses branded types to ensure type safety and provides utilities
+ * for creating, parsing, and manipulating keys throughout the generation process.
+ *
+ * ## Key Features
+ *
+ * - **Type Safety**: Branded types prevent mixing different kinds of keys
+ * - **Unique Identification**: Composite keys ensure global uniqueness
+ * - **Parsing Utilities**: Safe extraction of components from composite keys
+ * - **Generator Organization**: Clear mapping between generators and their artifacts
+ * - **Reference Integration**: Seamless integration with OpenAPI reference system
+ *
+ * @example Creating operation generator keys
+ * ```typescript
+ * import { toOperationGeneratorKey, parseOperationGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * // Create a key for a GET /users operation in api-client generator
+ * const key = toOperationGeneratorKey({
+ *   generatorId: 'api-client',
+ *   path: '/users',
+ *   method: 'GET'
+ * });
+ *
+ * // Parse the key back into components
+ * const parsed = parseOperationGeneratorKey(key);
+ * console.log(parsed); // { generatorId: 'api-client', path: '/users', method: 'GET' }
+ * ```
+ *
+ * @example Working with model keys
+ * ```typescript
+ * import { toModelGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * const modelKey = toModelGeneratorKey({
+ *   generatorId: 'typescript-models',
+ *   refName: 'User' as RefName
+ * });
+ * ```
+ *
+ * @example Type-safe key handling
+ * ```typescript
+ * import type { OperationGeneratorKey, ModelGeneratorKey } from '@skmtc/core/GeneratorKeys';
+ *
+ * function handleOperationKey(key: OperationGeneratorKey) {
+ *   // TypeScript ensures this is specifically an operation key
+ *   const parsed = parseOperationGeneratorKey(key);
+ *   return `Processing ${parsed.method} ${parsed.path}`;
+ * }
+ *
+ * function handleModelKey(key: ModelGeneratorKey) {
+ *   // TypeScript ensures this is specifically a model key
+ *   const parsed = parseModelGeneratorKey(key);
+ *   return `Processing model ${parsed.refName}`;
+ * }
+ * ```
+ *
+ * @module GeneratorKeys
+ */
 import "../_dnt.polyfills.js";
 import { isMethod } from './Method.js';
 /**

package/esm/types/Manifest.d.ts

@@ -1,3 +1,75 @@
+/**
+ * @fileoverview Generation Manifest System for SKMTC Core
+ *
+ * This module provides comprehensive manifest generation for tracking and organizing
+ * all artifacts produced during the SKMTC code generation process. The manifest
+ * system captures metadata about generated files, including size metrics, locations,
+ * preview information, and generation statistics.
+ *
+ * Manifests serve as a complete inventory of generated content, enabling tools,
+ * IDEs, and other systems to understand what was generated and how to interact
+ * with the generated code.
+ *
+ * ## Key Features
+ *
+ * - **File Tracking**: Complete inventory of all generated files with metrics
+ * - **Size Analytics**: Line counts, character counts, and size statistics
+ * - **Preview Integration**: Rich preview metadata for UI generation
+ * - **Generation Stats**: Detailed metrics about the generation process
+ * - **Type Safety**: Comprehensive validation with Valibot schemas
+ *
+ * @example Creating a manifest entry
+ * ```typescript
+ * import type { ManifestEntry } from '@skmtc/core/Manifest';
+ *
+ * const entry: ManifestEntry = {
+ *   lines: 150,
+ *   characters: 4200,
+ *   destinationPath: './src/generated/UserApi.ts'
+ * };
+ * ```
+ *
+ * @example Processing manifest content
+ * ```typescript
+ * import type { ManifestContent } from '@skmtc/core/Manifest';
+ *
+ * const manifest: ManifestContent = {
+ *   files: {
+ *     'UserApi.ts': {
+ *       lines: 150,
+ *       characters: 4200,
+ *       destinationPath: './src/generated/UserApi.ts'
+ *     }
+ *   },
+ *   stats: {
+ *     totalFiles: 1,
+ *     totalLines: 150,
+ *     totalCharacters: 4200,
+ *     generatedAt: new Date().toISOString()
+ *   },
+ *   previews: [],
+ *   mappings: []
+ * };
+ * ```
+ *
+ * @example Using manifest for tooling
+ * ```typescript
+ * function analyzeGeneration(manifest: ManifestContent) {
+ *   const fileCount = Object.keys(manifest.files).length;
+ *   const totalSize = Object.values(manifest.files)
+ *     .reduce((sum, file) => sum + file.characters, 0);
+ *
+ *   console.log(`Generated ${fileCount} files with ${totalSize} characters`);
+ *
+ *   // Process previews for UI generation
+ *   manifest.previews.forEach(preview => {
+ *     console.log(`Preview available: ${preview.title}`);
+ *   });
+ * }
+ * ```
+ *
+ * @module Manifest
+ */
 import "../_dnt.polyfills.js";
 import { type ResultsItem } from './Results.js';
 import { type Preview, type Mapping } from './Preview.js';

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

@@ -1 +1 @@
-{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../../src/types/Manifest.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAW,KAAK,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,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,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAW3D,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,KAAK,OAAO,EAAW,MAAM,cAAc,CAAA;AAC3E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,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,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,OAAO,EAAE,WAAW,CAAA;IACpB,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

@@ -1,3 +1,75 @@
+/**
+ * @fileoverview Generation Manifest System for SKMTC Core
+ *
+ * This module provides comprehensive manifest generation for tracking and organizing
+ * all artifacts produced during the SKMTC code generation process. The manifest
+ * system captures metadata about generated files, including size metrics, locations,
+ * preview information, and generation statistics.
+ *
+ * Manifests serve as a complete inventory of generated content, enabling tools,
+ * IDEs, and other systems to understand what was generated and how to interact
+ * with the generated code.
+ *
+ * ## Key Features
+ *
+ * - **File Tracking**: Complete inventory of all generated files with metrics
+ * - **Size Analytics**: Line counts, character counts, and size statistics
+ * - **Preview Integration**: Rich preview metadata for UI generation
+ * - **Generation Stats**: Detailed metrics about the generation process
+ * - **Type Safety**: Comprehensive validation with Valibot schemas
+ *
+ * @example Creating a manifest entry
+ * ```typescript
+ * import type { ManifestEntry } from '@skmtc/core/Manifest';
+ *
+ * const entry: ManifestEntry = {
+ *   lines: 150,
+ *   characters: 4200,
+ *   destinationPath: './src/generated/UserApi.ts'
+ * };
+ * ```
+ *
+ * @example Processing manifest content
+ * ```typescript
+ * import type { ManifestContent } from '@skmtc/core/Manifest';
+ *
+ * const manifest: ManifestContent = {
+ *   files: {
+ *     'UserApi.ts': {
+ *       lines: 150,
+ *       characters: 4200,
+ *       destinationPath: './src/generated/UserApi.ts'
+ *     }
+ *   },
+ *   stats: {
+ *     totalFiles: 1,
+ *     totalLines: 150,
+ *     totalCharacters: 4200,
+ *     generatedAt: new Date().toISOString()
+ *   },
+ *   previews: [],
+ *   mappings: []
+ * };
+ * ```
+ *
+ * @example Using manifest for tooling
+ * ```typescript
+ * function analyzeGeneration(manifest: ManifestContent) {
+ *   const fileCount = Object.keys(manifest.files).length;
+ *   const totalSize = Object.values(manifest.files)
+ *     .reduce((sum, file) => sum + file.characters, 0);
+ *
+ *   console.log(`Generated ${fileCount} files with ${totalSize} characters`);
+ *
+ *   // Process previews for UI generation
+ *   manifest.previews.forEach(preview => {
+ *     console.log(`Preview available: ${preview.title}`);
+ *   });
+ * }
+ * ```
+ *
+ * @module Manifest
+ */
 import "../_dnt.polyfills.js";
 import { resultsItem } from './Results.js';
 import { preview, mapping } from './Preview.js';

package/esm/types/Method.d.ts

@@ -1,3 +1,70 @@
+/**
+ * @fileoverview HTTP Method System for SKMTC Core
+ *
+ * This module provides comprehensive HTTP method definitions and utilities for
+ * handling OpenAPI operations. It includes type-safe method definitions,
+ * validation utilities, and constants for all HTTP methods supported by
+ * the OpenAPI v3 specification.
+ *
+ * The module ensures type safety when working with HTTP methods throughout
+ * the SKMTC pipeline and provides utilities for method validation and processing.
+ *
+ * ## Key Features
+ *
+ * - **Complete Method Support**: All HTTP methods from OpenAPI v3 specification
+ * - **Type Safety**: Branded types and type guards for method handling
+ * - **Validation**: Runtime validation with Valibot integration
+ * - **Case Handling**: Proper case normalization for method strings
+ * - **Specification Compliance**: Full adherence to OpenAPI v3 method definitions
+ *
+ * @example Working with HTTP methods
+ * ```typescript
+ * import { Method, isMethod, methodValues } from '@skmtc/core/Method';
+ *
+ * // Type-safe method handling
+ * const method: Method = 'GET';
+ *
+ * // Validate unknown method strings
+ * const userInput = 'post';
+ * if (isMethod(userInput)) {
+ *   console.log(`Valid method: ${userInput}`); // TypeScript knows it's a Method
+ * }
+ *
+ * // List all supported methods
+ * console.log('Supported methods:', methodValues);
+ * ```
+ *
+ * @example Method validation in generators
+ * ```typescript
+ * import { isMethod, Method } from '@skmtc/core/Method';
+ *
+ * function processOperation(path: string, method: string, operation: any) {
+ *   if (!isMethod(method)) {
+ *     throw new Error(`Unsupported HTTP method: ${method}`);
+ *   }
+ *
+ *   // TypeScript now knows method is of type Method
+ *   return generateOperationCode(path, method, operation);
+ * }
+ * ```
+ *
+ * @example Case-insensitive method handling
+ * ```typescript
+ * import { normalizeMethod, isMethod } from '@skmtc/core/Method';
+ *
+ * function handleMethodString(methodStr: string) {
+ *   const normalized = methodStr.toLowerCase();
+ *
+ *   if (isMethod(normalized)) {
+ *     return processValidMethod(normalized);
+ *   } else {
+ *     throw new Error(`Invalid method: ${methodStr}`);
+ *   }
+ * }
+ * ```
+ *
+ * @module Method
+ */
 import "../_dnt.polyfills.js";
 import * as v from 'valibot';
 /**
@@ -5,6 +72,7 @@ import * as v from 'valibot';
  *
  * This constant array includes all HTTP methods that can be used
  * in OpenAPI path operations, as defined by the OpenAPI specification.
+ * All methods are in lowercase to match OpenAPI conventions.
  */
 export declare const methodValues: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"Method.d.ts","sourceRoot":"","sources":["../../src/types/Method.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gFASf,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UAA+D,CAAA;AAE/F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAChC;IACE,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;IACjC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;IAClC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;IACjC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;IACnC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;IACpC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;IAClC,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;IACrC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;CACpC,EACD,SAAS,CAUT,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAG/F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,MAAM,EAAE,SAAS,CAAmB,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAE9C,CAAA"}
+{"version":3,"file":"Method.d.ts","sourceRoot":"","sources":["../../src/types/Method.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,gFASf,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UAA+D,CAAA;AAE/F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,WAAW,CAChC;IACE,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;IACjC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;IAClC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC;IACjC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;IACnC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC;IACpC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC;IAClC,CAAC,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;IACrC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC;CACpC,EACD,SAAS,CAUT,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAG/F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,MAAM,EAAE,SAAS,CAAmB,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAE9C,CAAA"}

package/esm/types/Method.js

@@ -1,3 +1,70 @@
+/**
+ * @fileoverview HTTP Method System for SKMTC Core
+ *
+ * This module provides comprehensive HTTP method definitions and utilities for
+ * handling OpenAPI operations. It includes type-safe method definitions,
+ * validation utilities, and constants for all HTTP methods supported by
+ * the OpenAPI v3 specification.
+ *
+ * The module ensures type safety when working with HTTP methods throughout
+ * the SKMTC pipeline and provides utilities for method validation and processing.
+ *
+ * ## Key Features
+ *
+ * - **Complete Method Support**: All HTTP methods from OpenAPI v3 specification
+ * - **Type Safety**: Branded types and type guards for method handling
+ * - **Validation**: Runtime validation with Valibot integration
+ * - **Case Handling**: Proper case normalization for method strings
+ * - **Specification Compliance**: Full adherence to OpenAPI v3 method definitions
+ *
+ * @example Working with HTTP methods
+ * ```typescript
+ * import { Method, isMethod, methodValues } from '@skmtc/core/Method';
+ *
+ * // Type-safe method handling
+ * const method: Method = 'GET';
+ *
+ * // Validate unknown method strings
+ * const userInput = 'post';
+ * if (isMethod(userInput)) {
+ *   console.log(`Valid method: ${userInput}`); // TypeScript knows it's a Method
+ * }
+ *
+ * // List all supported methods
+ * console.log('Supported methods:', methodValues);
+ * ```
+ *
+ * @example Method validation in generators
+ * ```typescript
+ * import { isMethod, Method } from '@skmtc/core/Method';
+ *
+ * function processOperation(path: string, method: string, operation: any) {
+ *   if (!isMethod(method)) {
+ *     throw new Error(`Unsupported HTTP method: ${method}`);
+ *   }
+ *
+ *   // TypeScript now knows method is of type Method
+ *   return generateOperationCode(path, method, operation);
+ * }
+ * ```
+ *
+ * @example Case-insensitive method handling
+ * ```typescript
+ * import { normalizeMethod, isMethod } from '@skmtc/core/Method';
+ *
+ * function handleMethodString(methodStr: string) {
+ *   const normalized = methodStr.toLowerCase();
+ *
+ *   if (isMethod(normalized)) {
+ *     return processValidMethod(normalized);
+ *   } else {
+ *     throw new Error(`Invalid method: ${methodStr}`);
+ *   }
+ * }
+ * ```
+ *
+ * @module Method
+ */
 import "../_dnt.polyfills.js";
 import * as v from 'valibot';
 /**
@@ -5,6 +72,7 @@ import * as v from 'valibot';
  *
  * This constant array includes all HTTP methods that can be used
  * in OpenAPI path operations, as defined by the OpenAPI specification.
+ * All methods are in lowercase to match OpenAPI conventions.
  */
 export const methodValues = [
     'get',

package/esm/types/Preview.d.ts

@@ -1,3 +1,78 @@
+/**
+ * @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
+ */
 import "../_dnt.polyfills.js";
 import { type Method } from './Method.js';
 import * as v from 'valibot';

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

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

package/esm/types/Preview.js

@@ -1,3 +1,78 @@
+/**
+ * @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
+ */
 import "../_dnt.polyfills.js";
 import { method } from './Method.js';
 import * as v from 'valibot';