@skmtc/core 0.0.785 → 0.0.787

package/script/dsl/operation/OperationBase.d.ts.map

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

package/script/dsl/operation/OperationBase.js

@@ -200,6 +200,47 @@ class OperationBase extends ContentBase_js_1.ContentBase {
             noExport: options.noExport
         });
     }
+    /**
+     * Inserts a related model with forced generation.
+     *
+     * This method adds a model to the current generation context, typically used
+     * for request/response models or other types related to the operation. The model
+     * will be generated and can be referenced in the operation code.
+     *
+     * @template V - Type of generated value returned by the insertable
+     * @template EnrichmentType - Type of enrichment data for the insertable
+     * @param insertable - The model generator to insert
+     * @param refName - Reference name for the inserted model
+     * @param options - Insertion options
+     * @param options.noExport - Whether to skip exporting the inserted model
+     * @returns Inserted model reference with generated value
+     *
+     * @example Inserting request/response models
+     * ```typescript
+     * class ApiOperation extends OperationBase {
+     *   toDefinition(): Definition {
+     *     // Insert request model
+     *     const requestModel = this.insertModel(
+     *       new RequestModel({ ... }),
+     *       'CreateUserRequest'
+     *     );
+     *
+     *     // Insert response model
+     *     const responseModel = this.insertModel(
+     *       new ResponseModel({ ... }),
+     *       'CreateUserResponse'
+     *     );
+     *
+     *     return new Definition({
+     *       name: this.operation.operationId,
+     *       content: `async ${this.operation.operationId}(data: ${requestModel.value}): Promise<${responseModel.value}> {
+     *         return this.request('${this.operation.method}', '${this.operation.path}', data);
+     *       }`
+     *     });
+     *   }
+     * }
+     * ```
+     */
     insertModel(insertable, refName, options = {}) {
         return this.context.insertModel(insertable, refName, {
             generation: 'force',
@@ -207,6 +248,62 @@ class OperationBase extends ContentBase_js_1.ContentBase {
             noExport: options.noExport
         });
     }
+    /**
+     * Inserts a related model with automatic schema normalization and reference resolution.
+     *
+     * This method intelligently handles schema references from operation request/response
+     * bodies, automatically resolving schema references to appropriate model names.
+     * This is particularly useful for operations with complex request/response schemas.
+     *
+     * @template V - Type of generated value returned by the insertable
+     * @template Schema - Type of OpenAPI schema (schema object, reference, or void)
+     * @template EnrichmentType - Type of enrichment data for the insertable
+     * @param insertable - The model generator to insert
+     * @param args - Schema normalization arguments
+     * @param args.schema - The OpenAPI schema to normalize (from request/response)
+     * @param args.fallbackName - Name to use if schema is not a reference
+     * @param options - Insertion options
+     * @param options.noExport - Whether to skip exporting the inserted model
+     * @returns Inserted model reference with normalized name and generated value
+     *
+     * @example Handling operation request/response schemas
+     * ```typescript
+     * class RestApiOperation extends OperationBase {
+     *   toDefinition(): Definition {
+     *     const operation = this.operation;
+     *
+     *     // Handle request body schema
+     *     let requestType = 'void';
+     *     const requestSchema = operation.requestBody?.content?.['application/json']?.schema;
+     *     if (requestSchema) {
+     *       const requestModel = this.insertNormalizedModel(
+     *         new TypeScriptInterface({ ... }),
+     *         {
+     *           schema: requestSchema,
+     *           fallbackName: `${operation.operationId}Request`
+     *         }
+     *       );
+     *       requestType = requestModel.value;
+     *     }
+     *
+     *     // Handle response schema
+     *     const responseSchema = operation.responses?.['200']?.content?.['application/json']?.schema;
+     *     const responseModel = this.insertNormalizedModel(
+     *       new TypeScriptInterface({ ... }),
+     *       {
+     *         schema: responseSchema,
+     *         fallbackName: `${operation.operationId}Response`
+     *       }
+     *     );
+     *
+     *     return new Definition({
+     *       name: operation.operationId,
+     *       content: `async ${operation.operationId}(data: ${requestType}): Promise<${responseModel.value}>`
+     *     });
+     *   }
+     * }
+     * ```
+     */
     insertNormalizedModel(insertable, { schema, fallbackName }, options = {}) {
         return this.context.insertNormalisedModel(insertable, {
             schema,
@@ -214,7 +311,43 @@ class OperationBase extends ContentBase_js_1.ContentBase {
             destinationPath: this.settings.exportPath
         }, options);
     }
-    /** @experimental */
+    /**
+     * Defines and registers a new definition in the generation context.
+     *
+     * This is an experimental method that allows creating and registering
+     * definitions directly without going through the standard insertion flow.
+     * Use with caution as the API may change in future versions.
+     *
+     * @experimental This method's API may change in future versions
+     * @template V - Type of generated value
+     * @param args - Definition arguments
+     * @param args.identifier - Unique identifier for the definition
+     * @param args.value - The generated value to associate with the definition
+     * @param args.noExport - Whether to skip exporting the definition
+     * @returns The created and registered definition
+     *
+     * @example Creating inline definitions
+     * ```typescript
+     * class InlineHelperOperation extends OperationBase {
+     *   toDefinition(): Definition {
+     *     // Create an inline helper function
+     *     const helper = this.defineAndRegister({
+     *       identifier: 'validateRequest',
+     *       value: 'function validateRequest(data: any) { ... }',
+     *       noExport: true
+     *     });
+     *
+     *     return new Definition({
+     *       name: this.operation.operationId,
+     *       content: `async ${this.operation.operationId}(data: any) {
+     *         ${helper.value}(data);
+     *         return this.request('${this.operation.method}', '${this.operation.path}', data);
+     *       }`
+     *     });
+     *   }
+     * }
+     * ```
+     */
     defineAndRegister({ identifier, value, noExport }) {
         return this.context.defineAndRegister({
             identifier,
@@ -223,6 +356,53 @@ class OperationBase extends ContentBase_js_1.ContentBase {
             noExport
         });
     }
+    /**
+     * Registers a file-level artifact with the generation context.
+     *
+     * This method allows the operation generator to register additional content
+     * (like imports, exports, or file-level definitions) that should be included
+     * in the generated file. The registration is automatically scoped to this
+     * operation's export path.
+     *
+     * @param args - Registration arguments
+     * @param args.content - The content to register (import, export, etc.)
+     * @param args.phase - When to register the content ('pre' or 'post')
+     *
+     * @example Registering API client imports
+     * ```typescript
+     * class HttpOperation extends OperationBase {
+     *   toDefinition(): Definition {
+     *     // Register imports needed for HTTP operations
+     *     this.register({
+     *       content: "import { ApiClient } from './client';",
+     *       phase: 'pre'
+     *     });
+     *
+     *     this.register({
+     *       content: "import { RequestOptions } from './types';",
+     *       phase: 'pre'
+     *     });
+     *
+     *     return new Definition({ ... });
+     *   }
+     * }
+     * ```
+     *
+     * @example Registering utility exports
+     * ```typescript
+     * class ApiOperationGroup extends OperationBase {
+     *   toDefinition(): Definition {
+     *     // Register a utility export after all operations
+     *     this.register({
+     *       content: "export const API_VERSION = '1.0';",
+     *       phase: 'post'
+     *     });
+     *
+     *     return new Definition({ ... });
+     *   }
+     * }
+     * ```
+     */
     register(args) {
         this.context.register({
             ...args,

package/script/oas/array/Array.d.ts

@@ -2,21 +2,129 @@ import "../../_dnt.polyfills.js";
 import type { OasSchema, ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { OasRef } from '../ref/Ref.js';
 import type { OpenAPIV3 } from 'openapi-types';
+/**
+ * Constructor fields for {@link OasArray}.
+ *
+ * @template Nullable - Whether the array value can be null
+ */
 export type ArrayFields<Nullable extends boolean | undefined> = {
+    /** Schema definition for array items */
     items: OasSchema | OasRef<'schema'>;
+    /** A short summary of the array schema */
     title?: string;
+    /** A description of the array schema */
     description?: string;
+    /** Whether the array value can be null */
     nullable?: Nullable;
+    /** Whether array items must be unique */
     uniqueItems?: boolean;
+    /** Custom extension fields (x-* properties) */
     extensionFields?: Record<string, unknown>;
+    /** Example array value */
     example?: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
+    /** Maximum number of items allowed */
     maxItems?: number;
+    /** Minimum number of items required */
     minItems?: number;
+    /** Array of allowed enum values for the entire array */
     enums?: Nullable extends true ? (unknown | null)[] | undefined : unknown[] | undefined;
+    /** Default value for the array */
     defaultValue?: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
 };
 /**
- * Object representing an array in the OpenAPI Specification.
+ * Represents an array schema in the OpenAPI Specification.
+ *
+ * `OasArray` handles array type definitions with comprehensive validation
+ * constraints including item count limits, uniqueness requirements, and
+ * item type specifications. It supports nested schemas and references
+ * for complex array structures.
+ *
+ * This class is used throughout the OAS processing pipeline to represent
+ * array fields in API schemas, including lists of objects, primitive arrays,
+ * and complex nested array structures.
+ *
+ * ## Key Features
+ *
+ * - **Item Type Definition**: Support for any schema type as array items
+ * - **Size Constraints**: Minimum and maximum item count validation
+ * - **Uniqueness Validation**: Ensure array items are unique (like Set behavior)
+ * - **Nested Schemas**: Support for complex nested array structures
+ * - **Reference Handling**: Seamless integration with schema references
+ * - **Nullable Support**: Type-safe nullable array handling
+ * - **JSON Schema**: Conversion to standard JSON Schema format
+ *
+ * @template Nullable - Whether the array value can be null
+ *
+ * @example String array
+ * ```typescript
+ * import { OasArray, OasString } from '@skmtc/core';
+ *
+ * const tagsArray = new OasArray({
+ *   title: 'Tags',
+ *   description: 'List of tags associated with the item',
+ *   items: new OasString({ minLength: 1 }),
+ *   minItems: 1,
+ *   uniqueItems: true,
+ *   example: ['javascript', 'typescript', 'react']
+ * });
+ * ```
+ *
+ * @example Object array with references
+ * ```typescript
+ * import { OasArray, OasRef } from '@skmtc/core';
+ *
+ * const usersArray = new OasArray({
+ *   title: 'Users',
+ *   description: 'List of user objects',
+ *   items: new OasRef({ refName: 'User' }),
+ *   maxItems: 100,
+ *   example: [
+ *     { id: 1, name: 'John' },
+ *     { id: 2, name: 'Jane' }
+ *   ]
+ * });
+ * ```
+ *
+ * @example Nested array (array of arrays)
+ * ```typescript
+ * const matrixArray = new OasArray({
+ *   title: 'Matrix',
+ *   description: '2D array of numbers',
+ *   items: new OasArray({
+ *     items: new OasInteger({ minimum: 0 })
+ *   }),
+ *   example: [
+ *     [1, 2, 3],
+ *     [4, 5, 6],
+ *     [7, 8, 9]
+ *   ]
+ * });
+ * ```
+ *
+ * @example Nullable array with constraints
+ * ```typescript
+ * const optionalIdsArray = new OasArray<true>({
+ *   title: 'Optional IDs',
+ *   description: 'Optional list of IDs',
+ *   items: new OasInteger({ format: 'int64', minimum: 1 }),
+ *   nullable: true,
+ *   minItems: 0,
+ *   maxItems: 10,
+ *   defaultValue: null
+ * });
+ * ```
+ *
+ * @example Unique items validation
+ * ```typescript
+ * const uniqueEmailsArray = new OasArray({
+ *   title: 'Email Recipients',
+ *   description: 'List of unique email addresses',
+ *   items: new OasString({ format: 'email' }),
+ *   uniqueItems: true, // Ensures no duplicate emails
+ *   minItems: 1,
+ *   example: ['user1@example.com', 'user2@example.com']
+ * });
+ * ```
  */
 export declare class OasArray<Nullable extends boolean | undefined = boolean | undefined> {
     /**

package/script/oas/array/Array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAC9D,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,YAAY,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;CAC5F,CAAA;AAED;;GAEG;AACH,qBAAa,QAAQ,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS;IAC9E;;;OAGG;IACH,OAAO,EAAG,QAAQ,CAAS;IAC3B;;OAEG;IACH,IAAI,EAAG,OAAO,CAAS;IACvB;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;IAEhC,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAEpD;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAE5B;;OAEG;IACH,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IAErF;;OAEG;IACH,YAAY,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;gBAE9E,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;IAczC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAI7B,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAIjC,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC,iBAAiB;CAexE"}
+{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"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"}

package/script/oas/array/Array.js

@@ -3,7 +3,99 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasArray = void 0;
 require("../../_dnt.polyfills.js");
 /**
- * Object representing an array in the OpenAPI Specification.
+ * Represents an array schema in the OpenAPI Specification.
+ *
+ * `OasArray` handles array type definitions with comprehensive validation
+ * constraints including item count limits, uniqueness requirements, and
+ * item type specifications. It supports nested schemas and references
+ * for complex array structures.
+ *
+ * This class is used throughout the OAS processing pipeline to represent
+ * array fields in API schemas, including lists of objects, primitive arrays,
+ * and complex nested array structures.
+ *
+ * ## Key Features
+ *
+ * - **Item Type Definition**: Support for any schema type as array items
+ * - **Size Constraints**: Minimum and maximum item count validation
+ * - **Uniqueness Validation**: Ensure array items are unique (like Set behavior)
+ * - **Nested Schemas**: Support for complex nested array structures
+ * - **Reference Handling**: Seamless integration with schema references
+ * - **Nullable Support**: Type-safe nullable array handling
+ * - **JSON Schema**: Conversion to standard JSON Schema format
+ *
+ * @template Nullable - Whether the array value can be null
+ *
+ * @example String array
+ * ```typescript
+ * import { OasArray, OasString } from '@skmtc/core';
+ *
+ * const tagsArray = new OasArray({
+ *   title: 'Tags',
+ *   description: 'List of tags associated with the item',
+ *   items: new OasString({ minLength: 1 }),
+ *   minItems: 1,
+ *   uniqueItems: true,
+ *   example: ['javascript', 'typescript', 'react']
+ * });
+ * ```
+ *
+ * @example Object array with references
+ * ```typescript
+ * import { OasArray, OasRef } from '@skmtc/core';
+ *
+ * const usersArray = new OasArray({
+ *   title: 'Users',
+ *   description: 'List of user objects',
+ *   items: new OasRef({ refName: 'User' }),
+ *   maxItems: 100,
+ *   example: [
+ *     { id: 1, name: 'John' },
+ *     { id: 2, name: 'Jane' }
+ *   ]
+ * });
+ * ```
+ *
+ * @example Nested array (array of arrays)
+ * ```typescript
+ * const matrixArray = new OasArray({
+ *   title: 'Matrix',
+ *   description: '2D array of numbers',
+ *   items: new OasArray({
+ *     items: new OasInteger({ minimum: 0 })
+ *   }),
+ *   example: [
+ *     [1, 2, 3],
+ *     [4, 5, 6],
+ *     [7, 8, 9]
+ *   ]
+ * });
+ * ```
+ *
+ * @example Nullable array with constraints
+ * ```typescript
+ * const optionalIdsArray = new OasArray<true>({
+ *   title: 'Optional IDs',
+ *   description: 'Optional list of IDs',
+ *   items: new OasInteger({ format: 'int64', minimum: 1 }),
+ *   nullable: true,
+ *   minItems: 0,
+ *   maxItems: 10,
+ *   defaultValue: null
+ * });
+ * ```
+ *
+ * @example Unique items validation
+ * ```typescript
+ * const uniqueEmailsArray = new OasArray({
+ *   title: 'Email Recipients',
+ *   description: 'List of unique email addresses',
+ *   items: new OasString({ format: 'email' }),
+ *   uniqueItems: true, // Ensures no duplicate emails
+ *   minItems: 1,
+ *   example: ['user1@example.com', 'user2@example.com']
+ * });
+ * ```
  */
 class OasArray {
     constructor(fields) {

package/script/oas/document/Document.d.ts

@@ -8,23 +8,156 @@ import type { OasSecurityRequirement } from '../securityRequirement/SecurityRequ
 import type { StackTrail } from '../../context/StackTrail.js';
 import type { OasSchema } from '../schema/Schema.js';
 import type { OasRef } from '../ref/Ref.js';
+/**
+ * Fields that define the structure of an OpenAPI v3 document.
+ *
+ * This type represents the normalized structure of an OpenAPI document after
+ * parsing, with operations flattened from the nested paths structure into
+ * a simple array for easier processing.
+ */
 export type DocumentFields = {
+    /** OpenAPI specification version (e.g., '3.0.0', '3.1.0') */
     openapi: string;
+    /** API metadata including title, version, description */
     info: OasInfo;
+    /** Array of server objects providing connectivity information */
     servers?: OasServer[] | undefined;
+    /** Flattened array of all operations from all paths */
     operations: OasOperation[];
+    /** Container for reusable components (schemas, responses, etc.) */
     components?: OasComponents | undefined;
+    /** List of tags used by operations with additional metadata */
     tags?: OasTag[] | undefined;
+    /** Default security requirements that apply to all operations */
     security?: OasSecurityRequirement[] | undefined;
+    /** Custom extension fields (x-* properties) */
     extensionFields?: Record<string, unknown>;
 };
-/** Top level document object describing the API */
+/**
+ * Represents a complete OpenAPI v3 document in the SKMTC OAS processing system.
+ *
+ * The `OasDocument` class is the root object in the OAS hierarchy, containing all
+ * the information needed to describe a complete REST API. It provides normalized
+ * access to document properties with built-in validation and error handling.
+ *
+ * ## Key Features
+ *
+ * - **Normalized Structure**: Operations are flattened from nested paths for easier processing
+ * - **Lazy Initialization**: Fields are set after construction during parsing
+ * - **Type Safety**: All properties are typed and validated on access
+ * - **Extensibility**: Supports OpenAPI extension fields (x-* properties)
+ * - **JSON Serialization**: Can be converted back to standard OpenAPI JSON format
+ *
+ * @example Basic document access
+ * ```typescript
+ * import { OasDocument } from '@skmtc/core';
+ *
+ * // Document is typically created during parsing
+ * const document = new OasDocument();
+ * document.fields = {
+ *   openapi: '3.0.0',
+ *   info: { title: 'My API', version: '1.0.0' },
+ *   operations: [
+ *     // ... parsed operations
+ *   ],
+ *   components: {
+ *     schemas: {
+ *       User: { type: 'object', properties: { id: { type: 'string' } } }
+ *     }
+ *   }
+ * };
+ *
+ * console.log(document.info.title); // 'My API'
+ * console.log(document.operations.length); // Number of operations
+ * ```
+ *
+ * @example Iterating over operations
+ * ```typescript
+ * // Process all operations in the document
+ * for (const operation of document.operations) {
+ *   console.log(`${operation.method.toUpperCase()} ${operation.path}`);
+ *
+ *   if (operation.operationId) {
+ *     console.log(`Operation ID: ${operation.operationId}`);
+ *   }
+ * }
+ * ```
+ *
+ * @example Working with components
+ * ```typescript
+ * if (document.components?.schemas) {
+ *   const userSchema = document.components.schemas.get('User');
+ *   if (userSchema) {
+ *     console.log('User schema found:', userSchema);
+ *   }
+ * }
+ * ```
+ */
 export declare class OasDocument {
     #private;
     /** Static identifier property for OasDocument */
     oasType: 'openapi';
+    /**
+     * Creates a new OasDocument instance.
+     *
+     * The document is typically created with undefined fields and populated
+     * later during the parsing process. This allows for lazy initialization
+     * and proper error handling during document processing.
+     *
+     * @param fields - Optional document fields (usually set later during parsing)
+     *
+     * @example
+     * ```typescript
+     * // Usually created without fields during parsing
+     * const document = new OasDocument();
+     *
+     * // Fields are set later by the parser
+     * document.fields = parsedDocumentFields;
+     * ```
+     */
     constructor(fields?: DocumentFields);
+    /**
+     * Removes an item from the document based on a stack trail path.
+     *
+     * This method is used internally during document processing to remove
+     * specific operations or schema components. The stack trail indicates
+     * the path to the item within the document structure.
+     *
+     * @param stackTrail - Path to the item to remove
+     * @returns The removed item, or undefined if not found
+     *
+     * @internal This method is primarily used by the processing pipeline
+     *
+     * @example
+     * ```typescript
+     * // Remove an operation at /users POST
+     * const removed = document.removeItem(new StackTrail(['paths', '/users', 'post']));
+     *
+     * // Remove a schema component
+     * const removedSchema = document.removeItem(new StackTrail(['components', 'schemas', 'User']));
+     * ```
+     */
     removeItem(stackTrail: StackTrail): OasOperation | OasSchema | OasRef<'schema'> | undefined;
+    /**
+     * Sets the document fields after parsing.
+     *
+     * This setter is called by the parsing pipeline to populate the document
+     * with parsed OpenAPI data. It enables lazy initialization and proper
+     * error handling during document processing.
+     *
+     * @param fields - The parsed document fields
+     *
+     * @example
+     * ```typescript
+     * const document = new OasDocument();
+     * document.fields = {
+     *   openapi: '3.0.0',
+     *   info: { title: 'API', version: '1.0' },
+     *   operations: [],
+     *   // ... other fields
+     * };
+     * ```
+     */
     set fields(fields: DocumentFields);
     /** OpenAPI specification version */
     get openapi(): string;
@@ -41,6 +174,27 @@ export declare class OasDocument {
     get security(): OasSecurityRequirement[] | undefined;
     /** Specification Extension fields */
     get extensionFields(): Record<string, unknown> | undefined;
+    /**
+     * Converts the document back to a JSON-serializable OpenAPI object.
+     *
+     * This method serializes the document to a standard OpenAPI v3 format,
+     * which can be used for output, validation, or further processing. The
+     * resulting object follows the OpenAPI specification structure.
+     *
+     * @returns A JSON-serializable object representing the OpenAPI document
+     *
+     * @example
+     * ```typescript
+     * // Convert document back to standard OpenAPI format
+     * const openApiJson = document.toJSON();
+     *
+     * // Can be stringified for output
+     * const yamlString = JSON.stringify(openApiJson, null, 2);
+     *
+     * // Or used with OpenAPI tools
+     * await validateOpenApiDocument(openApiJson);
+     * ```
+     */
     toJSON(): object;
 }
 //# sourceMappingURL=Document.d.ts.map

package/script/oas/document/Document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../../src/oas/document/Document.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAA;IACjC,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3B,QAAQ,CAAC,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAA;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C,CAAA;AAED,mDAAmD;AACnD,qBAAa,WAAW;;IACtB,iDAAiD;IACjD,OAAO,EAAE,SAAS,CAAY;gBAIlB,MAAM,CAAC,EAAE,cAAc;IAInC,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IA6B3F,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAEhC;IAED,oCAAoC;IACpC,IAAI,OAAO,IAAI,MAAM,CAMpB;IAED,mBAAmB;IACnB,IAAI,IAAI,IAAI,OAAO,CAMlB;IAED,IAAI,OAAO,IAAI,SAAS,EAAE,GAAG,SAAS,CAMrC;IAED,yCAAyC;IACzC,IAAI,UAAU,IAAI,YAAY,EAAE,CAM/B;IAED,iEAAiE;IACjE,IAAI,UAAU,IAAI,aAAa,GAAG,SAAS,CAM1C;IAED,wDAAwD;IACxD,IAAI,IAAI,IAAI,MAAM,EAAE,GAAG,SAAS,CAM/B;IAED,gDAAgD;IAChD,IAAI,QAAQ,IAAI,sBAAsB,EAAE,GAAG,SAAS,CAMnD;IAED,qCAAqC;IACrC,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMzD;IAED,MAAM,IAAI,MAAM;CAYjB"}
+{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../../src/oas/document/Document.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,IAAI,EAAE,OAAO,CAAA;IACb,iEAAiE;IACjE,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAA;IACjC,uDAAuD;IACvD,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,mEAAmE;IACnE,UAAU,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACtC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAA;IAC/C,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,qBAAa,WAAW;;IACtB,iDAAiD;IACjD,OAAO,EAAE,SAAS,CAAY;IAK9B;;;;;;;;;;;;;;;;;OAiBG;gBACS,MAAM,CAAC,EAAE,cAAc;IAInC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IA6B3F;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAEhC;IAED,oCAAoC;IACpC,IAAI,OAAO,IAAI,MAAM,CAMpB;IAED,mBAAmB;IACnB,IAAI,IAAI,IAAI,OAAO,CAMlB;IAED,IAAI,OAAO,IAAI,SAAS,EAAE,GAAG,SAAS,CAMrC;IAED,yCAAyC;IACzC,IAAI,UAAU,IAAI,YAAY,EAAE,CAM/B;IAED,iEAAiE;IACjE,IAAI,UAAU,IAAI,aAAa,GAAG,SAAS,CAM1C;IAED,wDAAwD;IACxD,IAAI,IAAI,IAAI,MAAM,EAAE,GAAG,SAAS,CAM/B;IAED,gDAAgD;IAChD,IAAI,QAAQ,IAAI,sBAAsB,EAAE,GAAG,SAAS,CAMnD;IAED,qCAAqC;IACrC,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMzD;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,IAAI,MAAM;CAYjB"}