@skmtc/core 0.0.805 → 0.0.806

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/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/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';

package/esm/types/Settings.d.ts

@@ -1,3 +1,53 @@
+/**
+ * @fileoverview SKMTC Core Settings and Configuration
+ *
+ * This module provides comprehensive configuration types and schemas for the SKMTC
+ * code generation pipeline. It defines settings for generators, modules, packages,
+ * and runtime behavior that control how OpenAPI documents are processed and what
+ * artifacts are generated.
+ *
+ * ## Key Features
+ *
+ * - **Generator Configuration**: Settings for individual code generators
+ * - **Module Management**: Package and module resolution configuration
+ * - **Runtime Settings**: Control generation behavior and output preferences
+ * - **Enrichment Integration**: Support for UI enrichment metadata
+ * - **Type Safety**: Comprehensive Valibot validation for all configuration
+ *
+ * @example Basic generator settings
+ * ```typescript
+ * import type { Settings } from '@skmtc/core/Settings';
+ *
+ * const settings: Settings = {
+ *   generators: {
+ *     'my-generator': {
+ *       enabled: true,
+ *       config: {
+ *         outputPath: './generated',
+ *         typescript: true
+ *       }
+ *     }
+ *   },
+ *   enrichments: {},
+ *   filters: {
+ *     includePaths: ['/api/v1/*'],
+ *     excludeMethods: ['OPTIONS']
+ *   }
+ * };
+ * ```
+ *
+ * @example Module package configuration
+ * ```typescript
+ * import type { ModulePackage } from '@skmtc/core/Settings';
+ *
+ * const moduleConfig: ModulePackage = {
+ *   rootPath: './src/generated',
+ *   moduleName: '@my-org/api-client'
+ * };
+ * ```
+ *
+ * @module Settings
+ */
 import "../_dnt.polyfills.js";
 import { type GeneratorEnrichments } from './Enrichments.js';
 import * as v from 'valibot';

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

@@ -1 +1 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../src/types/Settings.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGvD,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;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAAyC,CAAA;AAE1F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAmC,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAA6C,CAAA;AAIhG;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAKzD,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEjD;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,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,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAG/D,CAAA"}
+{"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;AAEjD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGvD,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;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAAyC,CAAA;AAE1F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAmC,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAA6C,CAAA;AAIhG;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAKzD,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEjD;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,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,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAG/D,CAAA"}

package/esm/types/Settings.js

@@ -1,3 +1,53 @@
+/**
+ * @fileoverview SKMTC Core Settings and Configuration
+ *
+ * This module provides comprehensive configuration types and schemas for the SKMTC
+ * code generation pipeline. It defines settings for generators, modules, packages,
+ * and runtime behavior that control how OpenAPI documents are processed and what
+ * artifacts are generated.
+ *
+ * ## Key Features
+ *
+ * - **Generator Configuration**: Settings for individual code generators
+ * - **Module Management**: Package and module resolution configuration
+ * - **Runtime Settings**: Control generation behavior and output preferences
+ * - **Enrichment Integration**: Support for UI enrichment metadata
+ * - **Type Safety**: Comprehensive Valibot validation for all configuration
+ *
+ * @example Basic generator settings
+ * ```typescript
+ * import type { Settings } from '@skmtc/core/Settings';
+ *
+ * const settings: Settings = {
+ *   generators: {
+ *     'my-generator': {
+ *       enabled: true,
+ *       config: {
+ *         outputPath: './generated',
+ *         typescript: true
+ *       }
+ *     }
+ *   },
+ *   enrichments: {},
+ *   filters: {
+ *     includePaths: ['/api/v1/*'],
+ *     excludeMethods: ['OPTIONS']
+ *   }
+ * };
+ * ```
+ *
+ * @example Module package configuration
+ * ```typescript
+ * import type { ModulePackage } from '@skmtc/core/Settings';
+ *
+ * const moduleConfig: ModulePackage = {
+ *   rootPath: './src/generated',
+ *   moduleName: '@my-org/api-client'
+ * };
+ * ```
+ *
+ * @module Settings
+ */
 import "../_dnt.polyfills.js";
 import { generatorEnrichments } from './Enrichments.js';
 import * as v from 'valibot';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skmtc/core",
-  "version": "0.0.805",
+  "version": "0.0.806",
   "repository": {
     "type": "git",
     "url": "https://github.com/skmtc/skmtc.git"

package/script/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/script/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/script/helpers/strings.js

@@ -1,4 +1,48 @@
 "use strict";
+/**
+ * @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
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.camelCase = exports.decapitalize = exports.capitalize = void 0;
 /**

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

@@ -4,6 +4,60 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toV3Document = exports.stringToSchema = void 0;
+/**
+ * @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
+ */
 require("../_dnt.polyfills.js");
 const parse_js_1 = require("../deps/jsr.io/@std/yaml/1.0.9/parse.js");
 const openapi_down_convert_1 = require("@apiture/openapi-down-convert");

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

@@ -34,6 +34,64 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generatorEnrichments = exports.pathEnrichments = exports.methodEnrichments = exports.operationEnrichments = exports.inputItem = exports.tableItem = exports.tableColumnItem = exports.formItem = exports.formFieldItem = void 0;
+/**
+ * @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
+ */
 require("../_dnt.polyfills.js");
 const ModuleExport_js_1 = require("./ModuleExport.js");
 const v = __importStar(require("valibot"));

package/script/types/Settings.d.ts

@@ -1,3 +1,53 @@
+/**
+ * @fileoverview SKMTC Core Settings and Configuration
+ *
+ * This module provides comprehensive configuration types and schemas for the SKMTC
+ * code generation pipeline. It defines settings for generators, modules, packages,
+ * and runtime behavior that control how OpenAPI documents are processed and what
+ * artifacts are generated.
+ *
+ * ## Key Features
+ *
+ * - **Generator Configuration**: Settings for individual code generators
+ * - **Module Management**: Package and module resolution configuration
+ * - **Runtime Settings**: Control generation behavior and output preferences
+ * - **Enrichment Integration**: Support for UI enrichment metadata
+ * - **Type Safety**: Comprehensive Valibot validation for all configuration
+ *
+ * @example Basic generator settings
+ * ```typescript
+ * import type { Settings } from '@skmtc/core/Settings';
+ *
+ * const settings: Settings = {
+ *   generators: {
+ *     'my-generator': {
+ *       enabled: true,
+ *       config: {
+ *         outputPath: './generated',
+ *         typescript: true
+ *       }
+ *     }
+ *   },
+ *   enrichments: {},
+ *   filters: {
+ *     includePaths: ['/api/v1/*'],
+ *     excludeMethods: ['OPTIONS']
+ *   }
+ * };
+ * ```
+ *
+ * @example Module package configuration
+ * ```typescript
+ * import type { ModulePackage } from '@skmtc/core/Settings';
+ *
+ * const moduleConfig: ModulePackage = {
+ *   rootPath: './src/generated',
+ *   moduleName: '@my-org/api-client'
+ * };
+ * ```
+ *
+ * @module Settings
+ */
 import "../_dnt.polyfills.js";
 import { type GeneratorEnrichments } from './Enrichments.js';
 import * as v from 'valibot';

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

@@ -1 +1 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../src/types/Settings.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGvD,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;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAAyC,CAAA;AAE1F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAmC,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAA6C,CAAA;AAIhG;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAKzD,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEjD;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,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,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAG/D,CAAA"}
+{"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;AAEjD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAGvD,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;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,CAAyC,CAAA;AAE1F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAAmC,CAAA;AAE9F;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,aAAa,CAAC,UAAU,CAA6C,CAAA;AAIhG;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAKzD,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEjD;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,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,sDAAsD;IACtD,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAG/D,CAAA"}

package/script/types/Settings.js

@@ -34,6 +34,56 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.skmtcClientConfig = exports.clientSettings = exports.skipModels = exports.skipOperations = exports.skipPaths = exports.modulePackage = void 0;
+/**
+ * @fileoverview SKMTC Core Settings and Configuration
+ *
+ * This module provides comprehensive configuration types and schemas for the SKMTC
+ * code generation pipeline. It defines settings for generators, modules, packages,
+ * and runtime behavior that control how OpenAPI documents are processed and what
+ * artifacts are generated.
+ *
+ * ## Key Features
+ *
+ * - **Generator Configuration**: Settings for individual code generators
+ * - **Module Management**: Package and module resolution configuration
+ * - **Runtime Settings**: Control generation behavior and output preferences
+ * - **Enrichment Integration**: Support for UI enrichment metadata
+ * - **Type Safety**: Comprehensive Valibot validation for all configuration
+ *
+ * @example Basic generator settings
+ * ```typescript
+ * import type { Settings } from '@skmtc/core/Settings';
+ *
+ * const settings: Settings = {
+ *   generators: {
+ *     'my-generator': {
+ *       enabled: true,
+ *       config: {
+ *         outputPath: './generated',
+ *         typescript: true
+ *       }
+ *     }
+ *   },
+ *   enrichments: {},
+ *   filters: {
+ *     includePaths: ['/api/v1/*'],
+ *     excludeMethods: ['OPTIONS']
+ *   }
+ * };
+ * ```
+ *
+ * @example Module package configuration
+ * ```typescript
+ * import type { ModulePackage } from '@skmtc/core/Settings';
+ *
+ * const moduleConfig: ModulePackage = {
+ *   rootPath: './src/generated',
+ *   moduleName: '@my-org/api-client'
+ * };
+ * ```
+ *
+ * @module Settings
+ */
 require("../_dnt.polyfills.js");
 const Enrichments_js_1 = require("./Enrichments.js");
 const v = __importStar(require("valibot"));