@skmtc/core 0.0.804 → 0.0.806

package/script/oas/mediaType/MediaType.d.ts

@@ -96,13 +96,30 @@ export type MediaTypeFields = {
  * ```
  */
 export declare class OasMediaType {
+    /** Type identifier for this OAS media type */
     oasType: 'mediaType';
+    /** The media type identifier (e.g., 'application/json', 'text/xml') */
     mediaType: string;
+    /** The schema defining the structure and validation rules for the content */
     schema: OasSchema | OasRef<'schema'> | undefined;
+    /** Example values demonstrating the media type content */
     examples: Record<string, OasExample | OasRef<'example'>> | undefined;
+    /** Custom extension fields (x-* properties) defined for this media type */
     extensionFields: Record<string, unknown> | undefined;
+    /** Encoding information for multipart and form data serialization */
     encoding?: Record<string, unknown> | undefined;
+    /**
+     * Creates a new OasMediaType instance.
+     *
+     * @param fields - Media type configuration including content schema, examples, and encoding
+     */
     constructor(fields: MediaTypeFields);
+    /**
+     * Converts this OAS media type to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options including reference handling and formatting preferences
+     * @returns OpenAPI v3 media type object with schema and examples
+     */
     toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.MediaTypeObject;
 }
 //# sourceMappingURL=MediaType.d.ts.map

package/script/oas/mediaType/MediaType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaType.d.ts","sourceRoot":"","sources":["../../../src/oas/mediaType/MediaType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACjD,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACrE,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAC/C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,qBAAa,YAAY;IACvB,OAAO,EAAE,WAAW,CAAc;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;gBAClC,MAAM,EAAE,eAAe;IAQnC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC,eAAe;CAMtE"}
+{"version":3,"file":"MediaType.d.ts","sourceRoot":"","sources":["../../../src/oas/mediaType/MediaType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACjD,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACrE,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAC/C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,qBAAa,YAAY;IACvB,8CAA8C;IAC9C,OAAO,EAAE,WAAW,CAAc;IAClC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAChD,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAC9C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAQnC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC,eAAe;CAMtE"}

package/script/oas/mediaType/MediaType.js

@@ -79,37 +79,48 @@ exports.OasMediaType = void 0;
  * ```
  */
 class OasMediaType {
+    /**
+     * Creates a new OasMediaType instance.
+     *
+     * @param fields - Media type configuration including content schema, examples, and encoding
+     */
     constructor(fields) {
+        /** Type identifier for this OAS media type */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'mediaType'
         });
+        /** The media type identifier (e.g., 'application/json', 'text/xml') */
         Object.defineProperty(this, "mediaType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** The schema defining the structure and validation rules for the content */
         Object.defineProperty(this, "schema", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Example values demonstrating the media type content */
         Object.defineProperty(this, "examples", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Custom extension fields (x-* properties) defined for this media type */
         Object.defineProperty(this, "extensionFields", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /** Encoding information for multipart and form data serialization */
         Object.defineProperty(this, "encoding", {
             enumerable: true,
             configurable: true,
@@ -122,6 +133,12 @@ class OasMediaType {
         this.encoding = fields.encoding;
         this.extensionFields = fields.extensionFields;
     }
+    /**
+     * Converts this OAS media type to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options including reference handling and formatting preferences
+     * @returns OpenAPI v3 media type object with schema and examples
+     */
     toJsonSchema(options) {
         return {
             schema: this.schema?.toJsonSchema(options),

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/Brand.d.ts

@@ -1,3 +1,44 @@
+/**
+ * @fileoverview Brand Type System for SKMTC Core
+ *
+ * This module provides TypeScript branded types for creating type-safe identifiers
+ * and values that are structurally identical but nominally distinct. Branded types
+ * help prevent mixing up similar primitive types and provide better type safety
+ * across the SKMTC codebase.
+ *
+ * ## Key Features
+ *
+ * - **Type Safety**: Prevents accidental mixing of similar primitive types
+ * - **Nominal Typing**: Creates distinct types from the same underlying type
+ * - **Zero Runtime Cost**: Pure TypeScript compile-time construct
+ * - **Developer Experience**: Better IntelliSense and error messages
+ *
+ * @example Creating branded types
+ * ```typescript
+ * import type { Brand } from '@skmtc/core/Brand';
+ *
+ * type UserId = Brand<string, 'UserId'>;
+ * type ProductId = Brand<string, 'ProductId'>;
+ *
+ * const userId: UserId = 'user-123' as UserId;
+ * const productId: ProductId = 'prod-456' as ProductId;
+ *
+ * // TypeScript will prevent this error:
+ * // const wrong: UserId = productId; // Type error!
+ * ```
+ *
+ * @example Using with numbers
+ * ```typescript
+ * type Score = Brand<number, 'Score'>;
+ * type Percentage = Brand<number, 'Percentage'>;
+ *
+ * function calculateGrade(score: Score, total: Score): Percentage {
+ *   return ((score / total) * 100) as Percentage;
+ * }
+ * ```
+ *
+ * @module Brand
+ */
 /**
  * Unique symbol used for branding types.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../src/types/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,sBAAsB,CAAC;AAE9B,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}
+{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../src/types/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;GAQG;AACH,OAAO,sBAAsB,CAAC;AAE9B,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/script/types/Brand.js

@@ -1,4 +1,45 @@
 "use strict";
+/**
+ * @fileoverview Brand Type System for SKMTC Core
+ *
+ * This module provides TypeScript branded types for creating type-safe identifiers
+ * and values that are structurally identical but nominally distinct. Branded types
+ * help prevent mixing up similar primitive types and provide better type safety
+ * across the SKMTC codebase.
+ *
+ * ## Key Features
+ *
+ * - **Type Safety**: Prevents accidental mixing of similar primitive types
+ * - **Nominal Typing**: Creates distinct types from the same underlying type
+ * - **Zero Runtime Cost**: Pure TypeScript compile-time construct
+ * - **Developer Experience**: Better IntelliSense and error messages
+ *
+ * @example Creating branded types
+ * ```typescript
+ * import type { Brand } from '@skmtc/core/Brand';
+ *
+ * type UserId = Brand<string, 'UserId'>;
+ * type ProductId = Brand<string, 'ProductId'>;
+ *
+ * const userId: UserId = 'user-123' as UserId;
+ * const productId: ProductId = 'prod-456' as ProductId;
+ *
+ * // TypeScript will prevent this error:
+ * // const wrong: UserId = productId; // Type error!
+ * ```
+ *
+ * @example Using with numbers
+ * ```typescript
+ * type Score = Brand<number, 'Score'>;
+ * type Percentage = Brand<number, 'Percentage'>;
+ *
+ * function calculateGrade(score: Score, total: Score): Percentage {
+ *   return ((score / total) * 100) as Percentage;
+ * }
+ * ```
+ *
+ * @module Brand
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Unique symbol used for branding types.

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"));