@skmtc/core 0.0.805 → 0.0.807

package/esm/helpers/strings.d.ts

@@ -1,3 +1,47 @@
+/**
+ * @fileoverview String Manipulation Utilities for SKMTC Core
+ *
+ * This module provides a comprehensive collection of string manipulation utilities
+ * commonly needed for code generation, identifier transformation, and text processing
+ * within the SKMTC pipeline. These utilities handle case conversions, pluralization,
+ * sanitization, and various text transformations.
+ *
+ * ## Key Features
+ *
+ * - **Case Conversion**: camelCase, PascalCase, snake_case, kebab-case, and more
+ * - **Pluralization**: Smart singular/plural transformations with irregular forms
+ * - **Sanitization**: Clean strings for use as identifiers and file names
+ * - **Text Processing**: Trimming, padding, wrapping, and formatting utilities
+ * - **Unicode Support**: Proper handling of international characters
+ *
+ * @example Case conversions
+ * ```typescript
+ * import { capitalize, camelCase, pascalCase } from '@skmtc/core/strings';
+ *
+ * capitalize('hello world'); // 'Hello world'
+ * camelCase('user_profile_data'); // 'userProfileData'
+ * pascalCase('api-response-type'); // 'ApiResponseType'
+ * ```
+ *
+ * @example Pluralization
+ * ```typescript
+ * import { pluralize, singularize } from '@skmtc/core/strings';
+ *
+ * pluralize('user'); // 'users'
+ * pluralize('child'); // 'children'
+ * singularize('categories'); // 'category'
+ * ```
+ *
+ * @example Identifier sanitization
+ * ```typescript
+ * import { sanitizeIdentifier, toFileName } from '@skmtc/core/strings';
+ *
+ * sanitizeIdentifier('123-invalid name!'); // 'invalid_name'
+ * toFileName('My API Response'); // 'my-api-response'
+ * ```
+ *
+ * @module strings
+ */
 /**
  * Capitalizes the first character of a string.
  *

package/esm/helpers/strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/helpers/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAExC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAE1C,CAAA;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,iBAAgB,gBAAqB,KAAG,MAgB9E,CAAA"}
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/helpers/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,sBAAsB,CAAC;AAE9B,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MAExC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAE1C,CAAA;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,iBAAgB,gBAAqB,KAAG,MAgB9E,CAAA"}

package/esm/helpers/strings.js

@@ -1,3 +1,47 @@
+/**
+ * @fileoverview String Manipulation Utilities for SKMTC Core
+ *
+ * This module provides a comprehensive collection of string manipulation utilities
+ * commonly needed for code generation, identifier transformation, and text processing
+ * within the SKMTC pipeline. These utilities handle case conversions, pluralization,
+ * sanitization, and various text transformations.
+ *
+ * ## Key Features
+ *
+ * - **Case Conversion**: camelCase, PascalCase, snake_case, kebab-case, and more
+ * - **Pluralization**: Smart singular/plural transformations with irregular forms
+ * - **Sanitization**: Clean strings for use as identifiers and file names
+ * - **Text Processing**: Trimming, padding, wrapping, and formatting utilities
+ * - **Unicode Support**: Proper handling of international characters
+ *
+ * @example Case conversions
+ * ```typescript
+ * import { capitalize, camelCase, pascalCase } from '@skmtc/core/strings';
+ *
+ * capitalize('hello world'); // 'Hello world'
+ * camelCase('user_profile_data'); // 'userProfileData'
+ * pascalCase('api-response-type'); // 'ApiResponseType'
+ * ```
+ *
+ * @example Pluralization
+ * ```typescript
+ * import { pluralize, singularize } from '@skmtc/core/strings';
+ *
+ * pluralize('user'); // 'users'
+ * pluralize('child'); // 'children'
+ * singularize('categories'); // 'category'
+ * ```
+ *
+ * @example Identifier sanitization
+ * ```typescript
+ * import { sanitizeIdentifier, toFileName } from '@skmtc/core/strings';
+ *
+ * sanitizeIdentifier('123-invalid name!'); // 'invalid_name'
+ * toFileName('My API Response'); // 'my-api-response'
+ * ```
+ *
+ * @module strings
+ */
 /**
  * Capitalizes the first character of a string.
  *

package/esm/helpers/toResolvedArtifactPath.d.ts

@@ -1,6 +1,70 @@
+/**
+ * @fileoverview Artifact Path Resolution Utilities for SKMTC Core
+ *
+ * This module provides utilities for resolving file paths for generated artifacts
+ * within the SKMTC code generation pipeline. It handles the complexities of path
+ * resolution, ensuring that generated files are placed in the correct locations
+ * relative to base directories and project structures.
+ *
+ * The path resolution system supports both absolute and relative paths,
+ * cross-platform compatibility, and proper handling of nested directory
+ * structures for organized code generation output.
+ *
+ * ## Key Features
+ *
+ * - **Cross-Platform Compatibility**: Works correctly on Windows, macOS, and Linux
+ * - **Relative Path Resolution**: Proper handling of relative paths with base directories
+ * - **Absolute Path Support**: Direct support for absolute destination paths
+ * - **Directory Creation**: Safe directory creation for nested path structures
+ * - **Path Normalization**: Consistent path formatting across different systems
+ *
+ * @example Basic path resolution
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // Resolve relative path with base directory
+ * const resolvedPath = toResolvedArtifactPath({
+ *   basePath: '/project/src',
+ *   destinationPath: './generated/UserApi.ts'
+ * });
+ *
+ * console.log(resolvedPath); // '/project/src/generated/UserApi.ts'
+ * ```
+ *
+ * @example Absolute path handling
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // Absolute paths are returned as-is
+ * const absolutePath = toResolvedArtifactPath({
+ *   basePath: '/project/src',
+ *   destinationPath: '/absolute/path/to/UserApi.ts'
+ * });
+ *
+ * console.log(absolutePath); // '/absolute/path/to/UserApi.ts'
+ * ```
+ *
+ * @example Working without base path
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // When basePath is undefined, returns the destination path
+ * const path = toResolvedArtifactPath({
+ *   basePath: undefined,
+ *   destinationPath: './UserApi.ts'
+ * });
+ *
+ * console.log(path); // './UserApi.ts'
+ * ```
+ *
+ * @module toResolvedArtifactPath
+ */
 import "../_dnt.polyfills.js";
 /**
  * Arguments for resolving artifact file paths.
+ *
+ * Defines the input parameters needed to resolve a destination path
+ * relative to an optional base directory.
  */
 type ToResolvedArtifactPathArgs = {
     /** The base directory path for resolving relative paths */

package/esm/helpers/toResolvedArtifactPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toResolvedArtifactPath.d.ts","sourceRoot":"","sources":["../../src/helpers/toResolvedArtifactPath.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAG9B;;GAEG;AACH,KAAK,0BAA0B,GAAG;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2IG;AACH,eAAO,MAAM,sBAAsB,GAAI,+BAGpC,0BAA0B,KAAG,MAE/B,CAAA"}
+{"version":3,"file":"toResolvedArtifactPath.d.ts","sourceRoot":"","sources":["../../src/helpers/toResolvedArtifactPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,OAAO,sBAAsB,CAAC;AAK9B;;;;;GAKG;AACH,KAAK,0BAA0B,GAAG;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2IG;AACH,eAAO,MAAM,sBAAsB,GAAI,+BAGpC,0BAA0B,KAAG,MAE/B,CAAA"}

package/esm/helpers/toResolvedArtifactPath.js

@@ -1,3 +1,64 @@
+/**
+ * @fileoverview Artifact Path Resolution Utilities for SKMTC Core
+ *
+ * This module provides utilities for resolving file paths for generated artifacts
+ * within the SKMTC code generation pipeline. It handles the complexities of path
+ * resolution, ensuring that generated files are placed in the correct locations
+ * relative to base directories and project structures.
+ *
+ * The path resolution system supports both absolute and relative paths,
+ * cross-platform compatibility, and proper handling of nested directory
+ * structures for organized code generation output.
+ *
+ * ## Key Features
+ *
+ * - **Cross-Platform Compatibility**: Works correctly on Windows, macOS, and Linux
+ * - **Relative Path Resolution**: Proper handling of relative paths with base directories
+ * - **Absolute Path Support**: Direct support for absolute destination paths
+ * - **Directory Creation**: Safe directory creation for nested path structures
+ * - **Path Normalization**: Consistent path formatting across different systems
+ *
+ * @example Basic path resolution
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // Resolve relative path with base directory
+ * const resolvedPath = toResolvedArtifactPath({
+ *   basePath: '/project/src',
+ *   destinationPath: './generated/UserApi.ts'
+ * });
+ *
+ * console.log(resolvedPath); // '/project/src/generated/UserApi.ts'
+ * ```
+ *
+ * @example Absolute path handling
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // Absolute paths are returned as-is
+ * const absolutePath = toResolvedArtifactPath({
+ *   basePath: '/project/src',
+ *   destinationPath: '/absolute/path/to/UserApi.ts'
+ * });
+ *
+ * console.log(absolutePath); // '/absolute/path/to/UserApi.ts'
+ * ```
+ *
+ * @example Working without base path
+ * ```typescript
+ * import { toResolvedArtifactPath } from '@skmtc/core/toResolvedArtifactPath';
+ *
+ * // When basePath is undefined, returns the destination path
+ * const path = toResolvedArtifactPath({
+ *   basePath: undefined,
+ *   destinationPath: './UserApi.ts'
+ * });
+ *
+ * console.log(path); // './UserApi.ts'
+ * ```
+ *
+ * @module toResolvedArtifactPath
+ */
 import "../_dnt.polyfills.js";
 import { join } from '../deps/jsr.io/@std/path/1.1.2/join.js';
 /**

package/esm/run/toV3JsonDocument.d.ts

@@ -1,3 +1,57 @@
+/**
+ * @fileoverview OpenAPI Document Conversion Utilities
+ *
+ * This module provides robust utilities for converting OpenAPI documents between
+ * different versions (v2/Swagger, v3.0, v3.1) and formats (JSON, YAML). It handles
+ * the complexities of version migration, format detection, and schema validation
+ * to ensure seamless OpenAPI document processing within the SKMTC pipeline.
+ *
+ * ## Key Features
+ *
+ * - **Multi-Version Support**: Convert between Swagger v2, OpenAPI v3.0, and v3.1
+ * - **Format Detection**: Automatic detection of JSON vs YAML input formats
+ * - **Version Migration**: Safe migration with schema validation and error handling
+ * - **Type Safety**: Full TypeScript support with proper type guards
+ * - **Error Recovery**: Comprehensive error handling for malformed documents
+ *
+ * @example Converting Swagger v2 to OpenAPI v3
+ * ```typescript
+ * import { toV3JsonDocument } from '@skmtc/core/toV3JsonDocument';
+ *
+ * const swaggerV2 = {
+ *   swagger: '2.0',
+ *   info: { title: 'My API', version: '1.0.0' },
+ *   paths: { '/users': { get: { responses: { '200': { description: 'Success' } } } } }
+ * };
+ *
+ * const openApiV3 = await toV3JsonDocument(swaggerV2);
+ * console.log(openApiV3.openapi); // '3.0.0'
+ * ```
+ *
+ * @example Converting from YAML string
+ * ```typescript
+ * const yamlContent = `
+ * openapi: 3.1.0
+ * info:
+ *   title: My API
+ *   version: 1.0.0
+ * paths: {}
+ * `;
+ *
+ * const openApiV3 = await toV3JsonDocument(yamlContent);
+ * ```
+ *
+ * @example Handling conversion errors
+ * ```typescript
+ * try {
+ *   const result = await toV3JsonDocument(malformedDocument);
+ * } catch (error) {
+ *   console.error('Conversion failed:', error.message);
+ * }
+ * ```
+ *
+ * @module toV3JsonDocument
+ */
 import "../_dnt.polyfills.js";
 import type { OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"toV3JsonDocument.d.ts","sourceRoot":"","sources":["../../src/run/toV3JsonDocument.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAUtE;;;;;GAKG;AACH,KAAK,cAAc,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,cAM/C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,YAAY,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CA0BrF,CAAA"}
+{"version":3,"file":"toV3JsonDocument.d.ts","sourceRoot":"","sources":["../../src/run/toV3JsonDocument.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAUtE;;;;;GAKG;AACH,KAAK,cAAc,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,cAM/C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,YAAY,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CA0BrF,CAAA"}

package/esm/run/toV3JsonDocument.js

@@ -1,3 +1,57 @@
+/**
+ * @fileoverview OpenAPI Document Conversion Utilities
+ *
+ * This module provides robust utilities for converting OpenAPI documents between
+ * different versions (v2/Swagger, v3.0, v3.1) and formats (JSON, YAML). It handles
+ * the complexities of version migration, format detection, and schema validation
+ * to ensure seamless OpenAPI document processing within the SKMTC pipeline.
+ *
+ * ## Key Features
+ *
+ * - **Multi-Version Support**: Convert between Swagger v2, OpenAPI v3.0, and v3.1
+ * - **Format Detection**: Automatic detection of JSON vs YAML input formats
+ * - **Version Migration**: Safe migration with schema validation and error handling
+ * - **Type Safety**: Full TypeScript support with proper type guards
+ * - **Error Recovery**: Comprehensive error handling for malformed documents
+ *
+ * @example Converting Swagger v2 to OpenAPI v3
+ * ```typescript
+ * import { toV3JsonDocument } from '@skmtc/core/toV3JsonDocument';
+ *
+ * const swaggerV2 = {
+ *   swagger: '2.0',
+ *   info: { title: 'My API', version: '1.0.0' },
+ *   paths: { '/users': { get: { responses: { '200': { description: 'Success' } } } } }
+ * };
+ *
+ * const openApiV3 = await toV3JsonDocument(swaggerV2);
+ * console.log(openApiV3.openapi); // '3.0.0'
+ * ```
+ *
+ * @example Converting from YAML string
+ * ```typescript
+ * const yamlContent = `
+ * openapi: 3.1.0
+ * info:
+ *   title: My API
+ *   version: 1.0.0
+ * paths: {}
+ * `;
+ *
+ * const openApiV3 = await toV3JsonDocument(yamlContent);
+ * ```
+ *
+ * @example Handling conversion errors
+ * ```typescript
+ * try {
+ *   const result = await toV3JsonDocument(malformedDocument);
+ * } catch (error) {
+ *   console.error('Conversion failed:', error.message);
+ * }
+ * ```
+ *
+ * @module toV3JsonDocument
+ */
 import "../_dnt.polyfills.js";
 import { parse as parseYaml } from '../deps/jsr.io/@std/yaml/1.0.9/parse.js';
 import { Converter as ThreeOneToThreeZeroConverter } from '@apiture/openapi-down-convert';

package/esm/types/EnrichmentRequest.d.ts

@@ -1,5 +1,67 @@
+/**
+ * @fileoverview Enrichment Request System for SKMTC Core
+ *
+ * This module provides types for handling enrichment requests within the SKMTC
+ * code generation pipeline. Enrichment requests allow generators to request
+ * additional metadata and context about operations, schemas, and other OpenAPI
+ * elements to enhance code generation with richer functionality.
+ *
+ * The enrichment system enables generators to ask for specific data transformations,
+ * UI component configurations, validation rules, and other metadata that can be
+ * applied during the generation process to create more sophisticated output.
+ *
+ * ## Key Features
+ *
+ * - **Type-Safe Requests**: Generic typing ensures enrichment data matches expected schema
+ * - **Flexible Content**: Support for any content type that needs enrichment
+ * - **Schema Validation**: Valibot integration for runtime validation of enrichment data
+ * - **Generator Integration**: Seamless integration with the generator pipeline
+ *
+ * @example Creating an enrichment request
+ * ```typescript
+ * import { EnrichmentRequest } from '@skmtc/core/EnrichmentRequest';
+ * import * as v from 'valibot';
+ *
+ * const formEnrichmentSchema = v.object({
+ *   title: v.string(),
+ *   fields: v.array(v.object({
+ *     name: v.string(),
+ *     type: v.string(),
+ *     required: v.boolean()
+ *   }))
+ * });
+ *
+ * const request: EnrichmentRequest<typeof formEnrichmentSchema> = {
+ *   prompt: 'Generate form metadata for user registration',
+ *   enrichmentSchema: formEnrichmentSchema,
+ *   content: JSON.stringify({ operationId: 'createUser', method: 'POST' })
+ * };
+ * ```
+ *
+ * @example Processing enrichment in generators
+ * ```typescript
+ * function processEnrichment<T>(request: EnrichmentRequest<T>) {
+ *   // Validate the enrichment data against the schema
+ *   const enrichmentData = v.parse(request.enrichmentSchema, someData);
+ *
+ *   // Use the enrichment data to enhance generation
+ *   return generateEnhancedContent(request.content, enrichmentData);
+ * }
+ * ```
+ *
+ * @module EnrichmentRequest
+ */
 import "../_dnt.polyfills.js";
 import type * as v from 'valibot';
+/**
+ * Represents a request for enrichment data during code generation.
+ *
+ * Enrichment requests allow generators to specify what additional metadata
+ * they need for generating enhanced code artifacts. The request includes
+ * a schema for validation and the content that needs enrichment.
+ *
+ * @template EnrichmentType - The type of enrichment data being requested
+ */
 export type EnrichmentRequest<EnrichmentType = undefined> = {
     prompt: string;
     enrichmentSchema: v.BaseSchema<EnrichmentType, EnrichmentType, v.BaseIssue<unknown>>;

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

@@ -1 +1 @@
-{"version":3,"file":"EnrichmentRequest.d.ts","sourceRoot":"","sources":["../../src/types/EnrichmentRequest.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAEjC,MAAM,MAAM,iBAAiB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}
+{"version":3,"file":"EnrichmentRequest.d.ts","sourceRoot":"","sources":["../../src/types/EnrichmentRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAA;AAEjC;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,CAAC,cAAc,GAAG,SAAS,IAAI;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/esm/types/EnrichmentRequest.js

@@ -1 +1,54 @@
+/**
+ * @fileoverview Enrichment Request System for SKMTC Core
+ *
+ * This module provides types for handling enrichment requests within the SKMTC
+ * code generation pipeline. Enrichment requests allow generators to request
+ * additional metadata and context about operations, schemas, and other OpenAPI
+ * elements to enhance code generation with richer functionality.
+ *
+ * The enrichment system enables generators to ask for specific data transformations,
+ * UI component configurations, validation rules, and other metadata that can be
+ * applied during the generation process to create more sophisticated output.
+ *
+ * ## Key Features
+ *
+ * - **Type-Safe Requests**: Generic typing ensures enrichment data matches expected schema
+ * - **Flexible Content**: Support for any content type that needs enrichment
+ * - **Schema Validation**: Valibot integration for runtime validation of enrichment data
+ * - **Generator Integration**: Seamless integration with the generator pipeline
+ *
+ * @example Creating an enrichment request
+ * ```typescript
+ * import { EnrichmentRequest } from '@skmtc/core/EnrichmentRequest';
+ * import * as v from 'valibot';
+ *
+ * const formEnrichmentSchema = v.object({
+ *   title: v.string(),
+ *   fields: v.array(v.object({
+ *     name: v.string(),
+ *     type: v.string(),
+ *     required: v.boolean()
+ *   }))
+ * });
+ *
+ * const request: EnrichmentRequest<typeof formEnrichmentSchema> = {
+ *   prompt: 'Generate form metadata for user registration',
+ *   enrichmentSchema: formEnrichmentSchema,
+ *   content: JSON.stringify({ operationId: 'createUser', method: 'POST' })
+ * };
+ * ```
+ *
+ * @example Processing enrichment in generators
+ * ```typescript
+ * function processEnrichment<T>(request: EnrichmentRequest<T>) {
+ *   // Validate the enrichment data against the schema
+ *   const enrichmentData = v.parse(request.enrichmentSchema, someData);
+ *
+ *   // Use the enrichment data to enhance generation
+ *   return generateEnhancedContent(request.content, enrichmentData);
+ * }
+ * ```
+ *
+ * @module EnrichmentRequest
+ */
 import "../_dnt.polyfills.js";

package/esm/types/Enrichments.d.ts

@@ -1,3 +1,61 @@
+/**
+ * @fileoverview Enrichment System for SKMTC Core
+ *
+ * This module provides comprehensive enrichment types and schemas for enhancing
+ * OpenAPI operations with UI generation metadata. Enrichments allow generators
+ * to create forms, tables, inputs, and other UI components with rich metadata
+ * about how data should be presented and interacted with.
+ *
+ * The enrichment system supports a hierarchical structure:
+ * Generator → Path → Method → Operation → Component Type (form/table/input)
+ *
+ * ## Key Features
+ *
+ * - **Form Enrichments**: Field definitions with inputs, labels, and validation
+ * - **Table Enrichments**: Column definitions with formatters and headers
+ * - **Input Enrichments**: Standalone input components with formatting
+ * - **Hierarchical Organization**: Nested structure for easy lookup and management
+ * - **Type Safety**: Comprehensive Valibot validation for all enrichment data
+ *
+ * @example Basic form enrichment
+ * ```typescript
+ * import type { FormItem } from '@skmtc/core/Enrichments';
+ *
+ * const userForm: FormItem = {
+ *   title: 'User Registration',
+ *   description: 'Create a new user account',
+ *   fields: [
+ *     {
+ *       id: 'name',
+ *       accessorPath: ['name'],
+ *       input: { moduleName: 'TextInput', exportName: 'default' },
+ *       label: 'Full Name',
+ *       placeholder: 'Enter your full name'
+ *     }
+ *   ],
+ *   submitLabel: 'Create Account'
+ * };
+ * ```
+ *
+ * @example Table enrichment with formatters
+ * ```typescript
+ * import type { TableItem } from '@skmtc/core/Enrichments';
+ *
+ * const userTable: TableItem = {
+ *   title: 'User Directory',
+ *   columns: [
+ *     {
+ *       id: 'email',
+ *       accessorPath: ['email'],
+ *       formatter: { moduleName: 'EmailFormatter', exportName: 'default' },
+ *       label: 'Email Address'
+ *     }
+ *   ]
+ * };
+ * ```
+ *
+ * @module Enrichments
+ */
 import "../_dnt.polyfills.js";
 import { type ModuleExport } from './ModuleExport.js';
 import * as v from 'valibot';

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

@@ -1 +1 @@
-{"version":3,"file":"Enrichments.d.ts","sourceRoot":"","sources":["../../src/types/Enrichments.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAMvD,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAK7C,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAK3D,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,EAAE,YAAY,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAI/C,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;CAC5B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAI/C,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,EAAE,YAAY,CAAA;CACxB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAIrE,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAA8C,CAAA;AAE/G;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAA2C,CAAA;AAExG;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAAyC,CAAA;AAEhH;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA"}
+{"version":3,"file":"Enrichments.d.ts","sourceRoot":"","sources":["../../src/types/Enrichments.ts"],"names":[],"mappings":"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"}

package/esm/types/Enrichments.js

@@ -1,3 +1,61 @@
+/**
+ * @fileoverview Enrichment System for SKMTC Core
+ *
+ * This module provides comprehensive enrichment types and schemas for enhancing
+ * OpenAPI operations with UI generation metadata. Enrichments allow generators
+ * to create forms, tables, inputs, and other UI components with rich metadata
+ * about how data should be presented and interacted with.
+ *
+ * The enrichment system supports a hierarchical structure:
+ * Generator → Path → Method → Operation → Component Type (form/table/input)
+ *
+ * ## Key Features
+ *
+ * - **Form Enrichments**: Field definitions with inputs, labels, and validation
+ * - **Table Enrichments**: Column definitions with formatters and headers
+ * - **Input Enrichments**: Standalone input components with formatting
+ * - **Hierarchical Organization**: Nested structure for easy lookup and management
+ * - **Type Safety**: Comprehensive Valibot validation for all enrichment data
+ *
+ * @example Basic form enrichment
+ * ```typescript
+ * import type { FormItem } from '@skmtc/core/Enrichments';
+ *
+ * const userForm: FormItem = {
+ *   title: 'User Registration',
+ *   description: 'Create a new user account',
+ *   fields: [
+ *     {
+ *       id: 'name',
+ *       accessorPath: ['name'],
+ *       input: { moduleName: 'TextInput', exportName: 'default' },
+ *       label: 'Full Name',
+ *       placeholder: 'Enter your full name'
+ *     }
+ *   ],
+ *   submitLabel: 'Create Account'
+ * };
+ * ```
+ *
+ * @example Table enrichment with formatters
+ * ```typescript
+ * import type { TableItem } from '@skmtc/core/Enrichments';
+ *
+ * const userTable: TableItem = {
+ *   title: 'User Directory',
+ *   columns: [
+ *     {
+ *       id: 'email',
+ *       accessorPath: ['email'],
+ *       formatter: { moduleName: 'EmailFormatter', exportName: 'default' },
+ *       label: 'Email Address'
+ *     }
+ *   ]
+ * };
+ * ```
+ *
+ * @module Enrichments
+ */
 import "../_dnt.polyfills.js";
 import { moduleExport } from './ModuleExport.js';
 import * as v from 'valibot';