@skmtc/core 0.0.798 → 0.0.800

package/script/dsl/operation/types.d.ts

@@ -5,40 +5,88 @@ import type { Identifier } from '../Identifier.js';
 import type { EnrichmentRequest } from '../../types/EnrichmentRequest.js';
 import type * as v from 'valibot';
 import type { MappingModule, PreviewModule } from '../../types/Preview.js';
+/**
+ * Arguments passed to operation insertable constructors.
+ *
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type OperationInsertableArgs<EnrichmentType = undefined> = {
     context: GenerateContext;
     settings: ContentSettings<EnrichmentType>;
     operation: OasOperation;
 };
+/**
+ * Arguments passed to operation transformation functions.
+ *
+ * @template Acc - Accumulator type for collecting transformation results
+ */
 export type TransformOperationArgs<Acc> = {
     context: GenerateContext;
     operation: OasOperation;
     acc: Acc | undefined;
 };
+/**
+ * Interface for objects that provide operation transformation capabilities.
+ *
+ * Used by generator configurations to transform operation definitions
+ * during the code generation process.
+ */
 export type WithTransformOperation = {
     transformOperation: (operation: OasOperation) => void;
 };
+/**
+ * Arguments for checking if an operation is supported with enrichment configuration.
+ *
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type IsSupportedOperationConfigArgs<EnrichmentType = undefined> = {
     context: GenerateContext;
     operation: OasOperation;
     enrichments: EnrichmentType;
 };
+/**
+ * Arguments for checking if an operation is supported for code generation.
+ */
 export type IsSupportedOperationArgs = {
     context: GenerateContext;
     operation: OasOperation;
 };
-type ToEnrichmentsArgs = {
+/**
+ * Arguments for generating enrichment data for operations.
+ */
+export type OperationToEnrichmentsArgs = {
     operation: OasOperation;
     context: GenerateContext;
 };
+/**
+ * Arguments for generating operation preview modules.
+ *
+ * Preview modules provide quick insights into generated operations
+ * without full code generation.
+ */
 export type ToOperationPreviewModuleArgs = {
     context: GenerateContext;
     operation: OasOperation;
 };
+/**
+ * Arguments for generating operation mapping information.
+ *
+ * Mappings track relationships between OAS operations and generated code,
+ * enabling cross-references and dependency analysis.
+ */
 export type ToOperationMappingArgs = {
     context: GenerateContext;
     operation: OasOperation;
 };
+/**
+ * Configuration object for insertable operation generators.
+ *
+ * Defines the contract for operation generator classes that can be inserted
+ * into the generation context to produce type-safe operation definitions.
+ *
+ * @template V - Generated value type produced by the operation generator
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type OperationInsertable<V, EnrichmentType = undefined> = {
     prototype: V;
 } & {
@@ -47,12 +95,23 @@ export type OperationInsertable<V, EnrichmentType = undefined> = {
     type: 'operation';
     toIdentifier: (operation: OasOperation) => Identifier;
     toExportPath: (operation: OasOperation) => string;
-    toEnrichments: ({ operation, context }: ToEnrichmentsArgs) => EnrichmentType;
+    toEnrichments: ({ operation, context }: OperationToEnrichmentsArgs) => EnrichmentType;
 } & Function;
+/**
+ * Arguments for checking if an operation is supported for generation.
+ */
 export type IsSupportedArgs = {
     context: GenerateContext;
     operation: OasOperation;
 };
+/**
+ * Configuration object for operation generators.
+ *
+ * Defines the behavior and capabilities of operation generators including
+ * support detection, transformation logic, and enrichment handling.
+ *
+ * @template EnrichmentType - Optional enrichment data type for additional metadata
+ */
 export type OperationConfig<EnrichmentType = undefined> = {
     id: string;
     type: 'operation';
@@ -63,5 +122,4 @@ export type OperationConfig<EnrichmentType = undefined> = {
     toMappingModule?: ({ context, operation }: ToOperationMappingArgs) => MappingModule;
     toEnrichmentRequest?: <RequestedEnrichment extends EnrichmentType>(operation: OasOperation) => EnrichmentRequest<RequestedEnrichment> | undefined;
 };
-export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/script/oas/array/array-types.d.ts

@@ -1,6 +1,13 @@
 import * as v from 'valibot';
 import { type OasSchemaData } from '../schema/schema-types.js';
 import { type OasSchemaRefData } from '../ref/ref-types.js';
+/**
+ * Valibot schema for validating OpenAPI array data objects.
+ *
+ * Validates array schemas including item type definitions, length constraints,
+ * uniqueness requirements, and enumeration values. Uses lazy evaluation
+ * to handle recursive schema references.
+ */
 export declare const oasArrayData: v.ObjectSchema<{
     readonly type: v.LiteralSchema<"array", undefined>;
     readonly items: v.LazySchema<v.UnionSchema<[v.LazySchema<v.GenericSchema<OasSchemaData>>, v.GenericSchema<OasSchemaRefData>], undefined>>;
@@ -12,15 +19,31 @@ export declare const oasArrayData: v.ObjectSchema<{
     readonly uniqueItems: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly enums: v.OptionalSchema<v.ArraySchema<v.UnknownSchema, undefined>, undefined>;
 }, undefined>;
+/**
+ * Data type for OpenAPI array schema objects.
+ *
+ * Represents array schemas with item type specifications, length constraints,
+ * and validation rules. Used throughout the SKMTC pipeline for array type
+ * processing and code generation.
+ */
 export type OasArrayData = {
+    /** Type identifier (always 'array') */
     type: 'array';
+    /** Schema definition for array items */
     items: OasSchemaData | OasSchemaRefData;
+    /** Human-readable title for the array */
     title?: string;
+    /** Detailed description of the array's purpose */
     description?: string;
+    /** Default value for the array */
     default?: unknown[];
+    /** Maximum number of items allowed */
     maxItems?: number;
+    /** Minimum number of items required */
     minItems?: number;
+    /** Whether all items must be unique */
     uniqueItems?: boolean;
+    /** Array of valid enumeration values */
     enums?: unknown[];
 };
 //# sourceMappingURL=array-types.d.ts.map

package/script/oas/array/array-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-types.d.ts","sourceRoot":"","sources":["../../../src/oas/array/array-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,qBAAqB,CAAA;AAE7E,eAAO,MAAM,YAAY;;;;;;;;;;aAUvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAAA;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;CAClB,CAAA"}
+{"version":3,"file":"array-types.d.ts","sourceRoot":"","sources":["../../../src/oas/array/array-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,qBAAqB,CAAA;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;aAUvB,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,wCAAwC;IACxC,KAAK,EAAE,aAAa,GAAG,gBAAgB,CAAA;IACvC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;CAClB,CAAA"}

package/script/oas/array/array-types.js

@@ -37,6 +37,13 @@ exports.oasArrayData = void 0;
 const v = __importStar(require("valibot"));
 const schema_types_js_1 = require("../schema/schema-types.js");
 const ref_types_js_1 = require("../ref/ref-types.js");
+/**
+ * Valibot schema for validating OpenAPI array data objects.
+ *
+ * Validates array schemas including item type definitions, length constraints,
+ * uniqueness requirements, and enumeration values. Uses lazy evaluation
+ * to handle recursive schema references.
+ */
 exports.oasArrayData = v.object({
     type: v.literal('array'),
     items: v.lazy(() => v.union([v.lazy(() => schema_types_js_1.oasSchemaData), ref_types_js_1.oasSchemaRefData])),

package/script/oas/boolean/boolean-types.d.ts

@@ -1,10 +1,34 @@
 import * as v from 'valibot';
-export declare const oasBooleanData: v.GenericSchema<OasBooleanData>;
+/**
+ * Valibot schema for validating OpenAPI boolean data objects.
+ *
+ * Validates boolean schemas including default values and enumeration
+ * constraints. Boolean enums typically contain [true, false] or single values.
+ */
+export declare const oasBooleanData: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"boolean", undefined>;
+    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly default: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly enum: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+/**
+ * Data type for OpenAPI boolean schema objects.
+ *
+ * Represents boolean schemas with optional default values and enumeration
+ * constraints. Used throughout the SKMTC pipeline for boolean type
+ * processing and code generation.
+ */
 export type OasBooleanData = {
+    /** Type identifier (always 'boolean') */
     type: 'boolean';
+    /** Human-readable title for the boolean */
     title?: string;
+    /** Detailed description of the boolean's purpose */
     description?: string;
+    /** Default value for the boolean */
     default?: boolean;
+    /** Array of valid boolean values (typically [true], [false], or [true, false]) */
     enum?: boolean[];
 };
 //# sourceMappingURL=boolean-types.d.ts.map

package/script/oas/boolean/boolean-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boolean-types.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/boolean-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAMzD,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CACjB,CAAA"}
+{"version":3,"file":"boolean-types.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/boolean-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;aAMzB,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,yCAAyC;IACzC,IAAI,EAAE,SAAS,CAAA;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CACjB,CAAA"}

package/script/oas/boolean/boolean-types.js

@@ -35,6 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasBooleanData = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for validating OpenAPI boolean data objects.
+ *
+ * Validates boolean schemas including default values and enumeration
+ * constraints. Boolean enums typically contain [true, false] or single values.
+ */
 exports.oasBooleanData = v.object({
     type: v.literal('boolean'),
     title: v.optional(v.string()),

package/script/oas/discriminator/discriminator-types.d.ts

@@ -1,9 +1,26 @@
 import * as v from 'valibot';
+/**
+ * Data type for OpenAPI discriminator objects.
+ *
+ * Discriminators are used with union types (oneOf/anyOf) to provide
+ * hints about which schema variant to use based on a property value.
+ * This enables more efficient type resolution and better tooling support.
+ */
 export type OasDiscriminatorData = {
+    /** Type category identifier for discriminator objects */
     oasType: 'discriminator';
+    /** Name of the property that contains the discriminator value */
     propertyName: string;
+    /** Optional mapping from property values to schema names */
     mapping?: Record<string, string>;
 };
+/**
+ * Valibot schema for validating OpenAPI discriminator data objects.
+ *
+ * Validates discriminator objects including the required property name
+ * and optional value-to-schema mappings. Used to ensure discriminator
+ * objects conform to OpenAPI specification requirements.
+ */
 export declare const oasDiscriminatorData: v.ObjectSchema<{
     readonly oasType: v.LiteralSchema<"discriminator", undefined>;
     readonly propertyName: v.StringSchema<undefined>;

package/script/oas/discriminator/discriminator-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discriminator-types.d.ts","sourceRoot":"","sources":["../../../src/oas/discriminator/discriminator-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,eAAe,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;aAI/B,CAAA"}
+{"version":3,"file":"discriminator-types.d.ts","sourceRoot":"","sources":["../../../src/oas/discriminator/discriminator-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,yDAAyD;IACzD,OAAO,EAAE,eAAe,CAAA;IACxB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;aAI/B,CAAA"}

package/script/oas/discriminator/discriminator-types.js

@@ -35,6 +35,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasDiscriminatorData = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for validating OpenAPI discriminator data objects.
+ *
+ * Validates discriminator objects including the required property name
+ * and optional value-to-schema mappings. Used to ensure discriminator
+ * objects conform to OpenAPI specification requirements.
+ */
 exports.oasDiscriminatorData = v.object({
     oasType: v.literal('discriminator'),
     propertyName: v.string(),

package/script/oas/integer/integer-types.d.ts

@@ -1,6 +1,24 @@
 import * as v from 'valibot';
+/**
+ * Valibot schema for validating integer values.
+ *
+ * Ensures values are numbers and specifically integers,
+ * used for integer validation throughout OAS processing.
+ */
 export declare const integerSchema: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+/**
+ * Valibot schema for valid integer format values.
+ *
+ * Defines the size formats for integer types: int32 for 32-bit signed
+ * integers and int64 for 64-bit signed integers.
+ */
 export declare const integerFormat: v.UnionSchema<[v.LiteralSchema<"int32", undefined>, v.LiteralSchema<"int64", undefined>], undefined>;
+/**
+ * Valibot schema for validating OpenAPI integer data objects.
+ *
+ * Validates integer schemas including size formats (int32/int64),
+ * range constraints, multiple validation, and enumeration values.
+ */
 export declare const oasIntegerData: v.ObjectSchema<{
     readonly type: v.LiteralSchema<"integer", undefined>;
     readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/script/oas/integer/integer-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integer-types.d.ts","sourceRoot":"","sources":["../../../src/oas/integer/integer-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,aAAa,4FAAkC,CAAA;AAE5D,eAAO,MAAM,aAAa,sGAAoD,CAAA;AAE9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;aAczB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA"}
+{"version":3,"file":"integer-types.d.ts","sourceRoot":"","sources":["../../../src/oas/integer/integer-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,4FAAkC,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,aAAa,sGAAoD,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;aAczB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA"}

package/script/oas/integer/integer-types.js

@@ -35,8 +35,26 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasIntegerData = exports.integerFormat = exports.integerSchema = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for validating integer values.
+ *
+ * Ensures values are numbers and specifically integers,
+ * used for integer validation throughout OAS processing.
+ */
 exports.integerSchema = v.pipe(v.number(), v.integer());
+/**
+ * Valibot schema for valid integer format values.
+ *
+ * Defines the size formats for integer types: int32 for 32-bit signed
+ * integers and int64 for 64-bit signed integers.
+ */
 exports.integerFormat = v.union([v.literal('int32'), v.literal('int64')]);
+/**
+ * Valibot schema for validating OpenAPI integer data objects.
+ *
+ * Validates integer schemas including size formats (int32/int64),
+ * range constraints, multiple validation, and enumeration values.
+ */
 exports.oasIntegerData = v.object({
     type: v.literal('integer'),
     title: v.optional(v.string()),

package/script/oas/mediaType/mediaType-types.d.ts

@@ -2,12 +2,29 @@ import { type OasExampleData } from '../example/example-types.js';
 import { type OasExampleRefData, type OasSchemaRefData } from '../ref/ref-types.js';
 import { type OasSchemaData } from '../schema/schema-types.js';
 import * as v from 'valibot';
+/**
+ * Data type for OpenAPI media type objects.
+ *
+ * Represents media type definitions within request/response bodies,
+ * specifying the format, schema, and examples for different content types
+ * like application/json, multipart/form-data, etc.
+ */
 export type OasMediaTypeData = {
+    /** Type identifier for OAS media type objects */
     oasType: 'mediaType';
+    /** The media type identifier (e.g., 'application/json', 'text/plain') */
     mediaType: string;
+    /** Schema definition for the media type content */
     schema?: OasSchemaData | OasSchemaRefData;
+    /** Named examples for the media type content */
     examples?: Record<string, OasExampleData | OasExampleRefData>;
 };
+/**
+ * Valibot schema for validating OpenAPI media type data.
+ *
+ * Validates the structure of media type objects including content type
+ * identifiers, schema definitions, and example collections.
+ */
 export declare const oasMediaTypeData: v.ObjectSchema<{
     readonly oasType: v.LiteralSchema<"mediaType", undefined>;
     readonly mediaType: v.StringSchema<undefined>;

package/script/oas/mediaType/mediaType-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaType-types.d.ts","sourceRoot":"","sources":["../../../src/oas/mediaType/mediaType-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AACjF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,WAAW,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAA;IAEzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;CAE9D,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;aAO3B,CAAA"}
+{"version":3,"file":"mediaType-types.d.ts","sourceRoot":"","sources":["../../../src/oas/mediaType/mediaType-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AACjF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iDAAiD;IACjD,OAAO,EAAE,WAAW,CAAA;IACpB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAA;IAEzC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;CAE9D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;aAO3B,CAAA"}

package/script/oas/mediaType/mediaType-types.js

@@ -38,6 +38,12 @@ const example_types_js_1 = require("../example/example-types.js");
 const ref_types_js_1 = require("../ref/ref-types.js");
 const schema_types_js_1 = require("../schema/schema-types.js");
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for validating OpenAPI media type data.
+ *
+ * Validates the structure of media type objects including content type
+ * identifiers, schema definitions, and example collections.
+ */
 exports.oasMediaTypeData = v.object({
     oasType: v.literal('mediaType'),
     mediaType: v.string(),

package/script/oas/number/number-types.d.ts

@@ -1,5 +1,17 @@
 import * as v from 'valibot';
+/**
+ * Valibot schema for valid number format values.
+ *
+ * Defines the precision formats for number types: float for single-precision
+ * and double for double-precision floating-point numbers.
+ */
 export declare const numberFormat: v.UnionSchema<[v.LiteralSchema<"float", undefined>, v.LiteralSchema<"double", undefined>], undefined>;
+/**
+ * Valibot schema for validating OpenAPI number data objects.
+ *
+ * Validates number schemas including precision formats, range constraints,
+ * multiple validation, and enumeration values.
+ */
 export declare const oasNumberData: v.ObjectSchema<{
     readonly type: v.LiteralSchema<"number", undefined>;
     readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/script/oas/number/number-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-types.d.ts","sourceRoot":"","sources":["../../../src/oas/number/number-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,YAAY,uGAAqD,CAAA;AAE9E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;aAcxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA"}
+{"version":3,"file":"number-types.d.ts","sourceRoot":"","sources":["../../../src/oas/number/number-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,uGAAqD,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;aAcxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA"}

package/script/oas/number/number-types.js

@@ -35,7 +35,19 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasNumberData = exports.numberFormat = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for valid number format values.
+ *
+ * Defines the precision formats for number types: float for single-precision
+ * and double for double-precision floating-point numbers.
+ */
 exports.numberFormat = v.union([v.literal('float'), v.literal('double')]);
+/**
+ * Valibot schema for validating OpenAPI number data objects.
+ *
+ * Validates number schemas including precision formats, range constraints,
+ * multiple validation, and enumeration values.
+ */
 exports.oasNumberData = v.object({
     type: v.literal('number'),
     title: v.optional(v.string()),

package/script/oas/operation/Operation.d.ts

@@ -46,7 +46,10 @@ export type OperationFields = {
     /** OpenAPI specification extensions */
     extensionFields?: Record<string, unknown>;
 };
-type ToRequestBodyMapArgs = {
+/**
+ * Arguments passed to request body mapping functions.
+ */
+export type ToRequestBodyMapArgs = {
     schema: OasSchema | OasRef<'schema'>;
     requestBody: OasRequestBody;
 };
@@ -186,9 +189,35 @@ export declare class OasOperation {
     deprecated: boolean | undefined;
     /** OpenAPI specification extensions */
     extensionFields: Record<string, unknown> | undefined;
+    /**
+     * Creates a new OasOperation instance from operation field data.
+     *
+     * @param fields - Operation field data from OpenAPI specification
+     */
     constructor(fields: OperationFields);
+    /**
+     * Returns the successful response definition for this operation.
+     *
+     * Looks for the lowest numbered 2xx response code and returns its response definition.
+     *
+     * @returns Success response object or undefined if none found
+     */
     toSuccessResponse(): OasResponse | OasRef<'response'> | undefined;
+    /**
+     * Returns the HTTP status code for the primary success response.
+     *
+     * Finds the lowest numbered 2xx status code in the responses.
+     *
+     * @returns Success status code as string or undefined if none found
+     */
     toSuccessResponseCode(): string | undefined;
+    /**
+     * Maps the request body schema to a custom value using the provided mapping function.
+     *
+     * @param map - Function to transform the request body schema and metadata
+     * @param mediaType - Media type to extract schema from (default: 'application/json')
+     * @returns Mapped value or undefined if no request body schema found
+     */
     toRequestBody<V>(map: ({ schema, requestBody }: ToRequestBodyMapArgs) => V, mediaType?: string): V | undefined;
     /**
      * Resolve all parameters and optionally filter by location
@@ -197,9 +226,25 @@ export declare class OasOperation {
      * @returns
      */
     toParams(filter?: OasParameterLocation[]): OasParameter[];
+    /**
+     * Creates an OAS object representation of operation parameters.
+     *
+     * @param filter - Optional array of parameter locations to include
+     * @returns OAS object with parameter properties
+     */
     toParametersObject(filter?: OasParameterLocation[]): OasObject;
+    /**
+     * Converts the operation to OpenAPI v3 JSON schema format.
+     *
+     * @param options - Conversion options for nested components
+     * @returns OpenAPI v3 operation object
+     */
     toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.OperationObject;
+    /**
+     * Serializes the operation to a plain JavaScript object.
+     *
+     * @returns Plain object representation of the operation
+     */
     toJSON(): object;
 }
-export {};
 //# sourceMappingURL=Operation.d.ts.map

package/script/oas/operation/Operation.d.ts.map

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

package/script/oas/operation/Operation.js

@@ -111,6 +111,11 @@ const Object_js_1 = require("../object/Object.js");
  * ```
  */
 class OasOperation {
+    /**
+     * Creates a new OasOperation instance from operation field data.
+     *
+     * @param fields - Operation field data from OpenAPI specification
+     */
     constructor(fields) {
         /** Type identifier for OAS operation objects */
         Object.defineProperty(this, "oasType", {
@@ -224,10 +229,24 @@ class OasOperation {
         this.deprecated = fields.deprecated;
         this.extensionFields = fields.extensionFields;
     }
+    /**
+     * Returns the successful response definition for this operation.
+     *
+     * Looks for the lowest numbered 2xx response code and returns its response definition.
+     *
+     * @returns Success response object or undefined if none found
+     */
     toSuccessResponse() {
         const successCode = this.toSuccessResponseCode();
         return successCode ? this.responses[successCode] : undefined;
     }
+    /**
+     * Returns the HTTP status code for the primary success response.
+     *
+     * Finds the lowest numbered 2xx status code in the responses.
+     *
+     * @returns Success status code as string or undefined if none found
+     */
     toSuccessResponseCode() {
         const successCode = Object.keys(this.responses)
             .map(httpCode => parseInt(httpCode))
@@ -241,6 +260,13 @@ class OasOperation {
         }
         return undefined;
     }
+    /**
+     * Maps the request body schema to a custom value using the provided mapping function.
+     *
+     * @param map - Function to transform the request body schema and metadata
+     * @param mediaType - Media type to extract schema from (default: 'application/json')
+     * @returns Mapped value or undefined if no request body schema found
+     */
     toRequestBody(map, mediaType = 'application/json') {
         const requestBody = this.requestBody?.resolve();
         const schema = requestBody?.content[mediaType]?.schema;
@@ -257,6 +283,12 @@ class OasOperation {
             ?.map(param => param.resolve())
             .filter(param => (filter?.length ? filter.includes(param.location) : true)) ?? []);
     }
+    /**
+     * Creates an OAS object representation of operation parameters.
+     *
+     * @param filter - Optional array of parameter locations to include
+     * @returns OAS object with parameter properties
+     */
     toParametersObject(filter) {
         const parameters = this.toParams(filter);
         return parameters.reduce((acc, parameter) => {
@@ -267,6 +299,12 @@ class OasOperation {
             });
         }, Object_js_1.OasObject.empty());
     }
+    /**
+     * Converts the operation to OpenAPI v3 JSON schema format.
+     *
+     * @param options - Conversion options for nested components
+     * @returns OpenAPI v3 operation object
+     */
     toJsonSchema(options) {
         return {
             tags: this.tags,
@@ -281,6 +319,11 @@ class OasOperation {
             ...this.extensionFields
         };
     }
+    /**
+     * Serializes the operation to a plain JavaScript object.
+     *
+     * @returns Plain object representation of the operation
+     */
     toJSON() {
         return {
             tags: this.tags,