@skmtc/core 0.0.800 → 0.0.803

package/esm/mod.js

@@ -69,11 +69,15 @@ export * from './app/validate.js';
 export * from './context/CoreContext.js';
 export * from './context/GenerateContext.js';
 export * from './context/ParseContext.js';
+export * from './context/RenderContext.js';
+export * from './context/types.js';
 export * from './dsl/constants.js';
 export * from './dsl/ContentBase.js';
 export * from './dsl/ContentSettings.js';
 export * from './dsl/Definition.js';
 export * from './dsl/EntityType.js';
+export * from './dsl/File.js';
+export * from './dsl/JsonFile.js';
 export * from './dsl/GeneratedValueList.js';
 export * from './dsl/Identifier.js';
 export * from './dsl/Import.js';
@@ -99,25 +103,71 @@ export * from './helpers/refFns.js';
 export * from './helpers/strings.js';
 export * from './helpers/parseModuleName.js';
 export * from './helpers/toResolvedArtifactPath.js';
+export * from './context/StackTrail.js';
 export * from './oas/array/Array.js';
+export * from './oas/array/array-types.js';
+export * from './oas/array/toArray.js';
 export * from './oas/boolean/Boolean.js';
+export * from './oas/boolean/boolean-types.js';
+export * from './oas/boolean/toBoolean.js';
 export * from './oas/components/Components.js';
+export * from './oas/components/components-types.js';
+export * from './oas/contact/Contact.js';
+export * from './oas/contact/contact-types.js';
 export * from './oas/discriminator/Discriminator.js';
+export * from './oas/discriminator/discriminator-types.js';
 export * from './oas/document/Document.js';
+export * from './oas/document/document-types.js';
+export * from './oas/example/Example.js';
+export * from './oas/example/example-types.js';
+export * from './oas/header/Header.js';
+export * from './oas/header/header-types.js';
 export * from './oas/info/Info.js';
+export * from './oas/info/info-types.js';
+export * from './oas/license/License.js';
+export * from './oas/license/license-types.js';
+export * from './oas/mediaType/MediaType.js';
+export * from './oas/mediaType/mediaType-types.js';
 export * from './oas/integer/Integer.js';
+export * from './oas/integer/integer-types.js';
+export * from './oas/integer/toInteger.js';
 export * from './oas/number/Number.js';
+export * from './oas/number/number-types.js';
+export * from './oas/number/toNumber.js';
 export * from './oas/object/Object.js';
+export * from './oas/object/object-types.js';
+export * from './oas/object/toObject.js';
 export * from './oas/operation/Operation.js';
+export * from './oas/operation/operation-types.js';
 export * from './oas/parameter/Parameter.js';
+export * from './oas/parameter/parameter-types.js';
+export * from './oas/pathItem/PathItem.js';
+export * from './oas/pathItem/pathItem-types.js';
 export * from './oas/ref/Ref.js';
+export * from './oas/ref/ref-types.js';
+export * from './oas/ref/toRefV31.js';
 export * from './oas/requestBody/RequestBody.js';
+export * from './oas/requestBody/requestBody-types.js';
 export * from './oas/response/Response.js';
+export * from './oas/response/response-types.js';
 export * from './oas/schema/Schema.js';
+export * from './oas/schema/schema-types.js';
+export * from './oas/schema/toSchemasV3.js';
+export * from './oas/securityRequirement/SecurityRequirement.js';
+export * from './oas/securitySchemes/SecurityScheme.js';
+export * from './oas/server/Server.js';
+export * from './oas/serverVariable/ServerVariable.js';
 export * from './oas/string/String.js';
+export * from './oas/string/string-types.js';
+export * from './oas/string/toString.js';
 export * from './oas/tag/Tag.js';
+export * from './oas/tag/tag-types.js';
 export * from './oas/union/Union.js';
+export * from './oas/union/union-types.js';
+export * from './oas/union/toUnion.js';
 export * from './oas/unknown/Unknown.js';
+export * from './oas/unknown/unknown-types.js';
+export * from './oas/unknown/toUnknown.js';
 export * from './oas/void/Void.js';
 export * from './run/toArtifacts.js';
 export * from './run/toV3JsonDocument.js';
@@ -128,6 +178,7 @@ export * from './types/Enrichments.js';
 export * from './types/GeneratedValue.js';
 export * from './types/GeneratorKeys.js';
 export * from './types/GeneratorType.js';
+export * from './types/Logger.js';
 export * from './types/Manifest.js';
 export * from './types/Method.js';
 export * from './types/Modifiers.js';
@@ -135,6 +186,7 @@ export * from './types/ModuleExport.js';
 export * from './types/PrettierConfig.js';
 export * from './types/Preview.js';
 export * from './types/RefName.js';
+export * from './types/Results.js';
 export * from './types/Settings.js';
 export * from './types/TypeSystem.js';
 export * from './typescript/FunctionParameter.js';

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

@@ -178,10 +178,36 @@ export declare class OasArray<Nullable extends boolean | undefined = boolean | u
      * The default value for the array.
      */
     defaultValue: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
+    /**
+     * Creates a new OasArray instance.
+     *
+     * @param fields - Array configuration fields including items schema, validation constraints, and metadata
+     */
     constructor(fields: ArrayFields<Nullable>);
+    /**
+     * Determines if this array is a reference object.
+     *
+     * @returns Always returns false since this is a concrete array instance, not a reference
+     */
     isRef(): this is OasRef<'schema'>;
+    /**
+     * Resolves this array object.
+     *
+     * @returns The array instance itself since it's already a concrete object, not a reference
+     */
     resolve(): OasArray<Nullable>;
+    /**
+     * Resolves this array object one level.
+     *
+     * @returns The array instance itself since it's already a concrete object, not a reference
+     */
     resolveOnce(): OasArray<Nullable>;
+    /**
+     * Converts this OAS array to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options including reference handling and formatting preferences
+     * @returns OpenAPI v3 array schema object with type, items schema, and all validation constraints
+     */
     toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.ArraySchemaObject;
 }
 //# sourceMappingURL=Array.d.ts.map

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

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

package/esm/oas/array/Array.js

@@ -95,6 +95,11 @@ import "../../_dnt.polyfills.js";
  * ```
  */
 export class OasArray {
+    /**
+     * Creates a new OasArray instance.
+     *
+     * @param fields - Array configuration fields including items schema, validation constraints, and metadata
+     */
     constructor(fields) {
         /**
          * Object is part the 'schema' set which is used
@@ -224,15 +229,36 @@ export class OasArray {
         this.enums = fields.enums;
         this.defaultValue = fields.defaultValue;
     }
+    /**
+     * Determines if this array is a reference object.
+     *
+     * @returns Always returns false since this is a concrete array instance, not a reference
+     */
     isRef() {
         return false;
     }
+    /**
+     * Resolves this array object.
+     *
+     * @returns The array instance itself since it's already a concrete object, not a reference
+     */
     resolve() {
         return this;
     }
+    /**
+     * Resolves this array object one level.
+     *
+     * @returns The array instance itself since it's already a concrete object, not a reference
+     */
     resolveOnce() {
         return this;
     }
+    /**
+     * Converts this OAS array to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options including reference handling and formatting preferences
+     * @returns OpenAPI v3 array schema object with type, items schema, and all validation constraints
+     */
     toJsonSchema(options) {
         return {
             type: 'array',

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

@@ -8,17 +8,14 @@ import { type OasSchemaRefData } from '../ref/ref-types.js';
  * 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>>;
-    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly default: v.OptionalSchema<v.ArraySchema<v.UnknownSchema, undefined>, undefined>;
-    readonly maxItems: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-    readonly minItems: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-    readonly uniqueItems: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly enums: v.OptionalSchema<v.ArraySchema<v.UnknownSchema, undefined>, undefined>;
-}, undefined>;
+export declare const oasArrayData: v.GenericSchema<OasArrayData>;
+/**
+ * Valibot schema for array data without the items property.
+ *
+ * Used for parsing array schemas when the items property is handled separately,
+ * typically during schema transformation and validation processes.
+ */
+export declare const oasArrayDataWithoutItems: v.GenericSchema<OasArrayDataWithoutItems>;
 /**
  * Data type for OpenAPI array schema objects.
  *
@@ -46,4 +43,28 @@ export type OasArrayData = {
     /** Array of valid enumeration values */
     enums?: unknown[];
 };
+/**
+ * Array schema data without the items property.
+ *
+ * Represents an array schema with all properties except the items definition.
+ * Used during parsing phases where item schemas are processed separately.
+ */
+export type OasArrayDataWithoutItems = {
+    /** Type identifier (always 'array') */
+    type: 'array';
+    /** 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/esm/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;;;;;;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"}
+{"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,EAAE,CAAC,CAAC,aAAa,CAAC,YAAY,CAUrD,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,aAAa,CAAC,wBAAwB,CAS7E,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;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,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/esm/oas/array/array-types.js

@@ -19,3 +19,19 @@ export const oasArrayData = v.object({
     uniqueItems: v.optional(v.boolean()),
     enums: v.optional(v.array(v.unknown()))
 });
+/**
+ * Valibot schema for array data without the items property.
+ *
+ * Used for parsing array schemas when the items property is handled separately,
+ * typically during schema transformation and validation processes.
+ */
+export const oasArrayDataWithoutItems = v.object({
+    type: v.literal('array'),
+    title: v.optional(v.string()),
+    description: v.optional(v.string()),
+    default: v.optional(v.array(v.unknown())),
+    maxItems: v.optional(v.number()),
+    minItems: v.optional(v.number()),
+    uniqueItems: v.optional(v.boolean()),
+    enums: v.optional(v.array(v.unknown()))
+});

package/esm/oas/array/toArray.d.ts

@@ -5,6 +5,65 @@ type ToArrayArgs = {
     value: OpenAPIV3.ArraySchemaObject;
     context: ParseContext;
 };
+/**
+ * Transforms an OpenAPI v3 array schema object into an internal OAS array representation.
+ *
+ * This function processes OpenAPI array schemas by extracting and parsing nullable values,
+ * examples, enumerations, and default values. It handles the complete transformation from
+ * raw OpenAPI JSON to the SKMTC internal array representation with proper type safety.
+ *
+ * The transformation follows a pipeline approach:
+ * 1. Parse nullable flag and extract base value
+ * 2. Parse example values with nullable support
+ * 3. Parse enumeration constraints
+ * 4. Parse default values
+ * 5. Create final OasArray instance
+ *
+ * @param args - Transformation arguments
+ * @param args.value - The OpenAPI v3 array schema object to transform
+ * @param args.context - Parse context providing utilities and tracing
+ * @returns Transformed OAS array object with parsed properties
+ *
+ * @example Basic array transformation
+ * ```typescript
+ * import { toArray } from '@skmtc/core';
+ *
+ * const openApiArray = {
+ *   type: 'array',
+ *   items: { type: 'string' },
+ *   maxItems: 10,
+ *   uniqueItems: true
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: openApiArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.maxItems); // 10
+ * console.log(oasArray.uniqueItems); // true
+ * ```
+ *
+ * @example Array with nullable and examples
+ * ```typescript
+ * const complexArray = {
+ *   type: 'array',
+ *   items: { type: 'number' },
+ *   nullable: true,
+ *   example: [1, 2, 3],
+ *   default: [],
+ *   enum: [[1, 2], [3, 4], null]
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: complexArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.nullable); // true
+ * console.log(oasArray.example); // [1, 2, 3]
+ * ```
+ */
 export declare const toArray: ({ value, context }: ToArrayArgs) => OasArray;
 type ToParsedArrayArgs<Nullable extends boolean | undefined> = {
     value: Omit<OpenAPIV3.ArraySchemaObject, 'nullable' | 'example' | 'enums' | 'default'>;
@@ -14,6 +73,58 @@ type ToParsedArrayArgs<Nullable extends boolean | undefined> = {
     enums: Nullable extends true ? (unknown[] | null)[] | undefined : unknown[] | undefined;
     defaultValue: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
 };
+/**
+ * Creates an OAS array instance from pre-parsed array schema components.
+ *
+ * This function is the final step in the array transformation pipeline, taking
+ * already-parsed nullable, example, enum, and default values and combining them
+ * with the remaining array properties to create the complete OasArray instance.
+ *
+ * The function handles type-safe nullable parsing, items schema resolution,
+ * and specification extension processing. It uses Valibot for schema validation
+ * and maintains proper type relationships between nullable flags and value types.
+ *
+ * @template Nullable - Boolean type indicating if the array can be null
+ * @param args - Pre-parsed array components
+ * @param args.value - OpenAPI array object without parsed fields
+ * @param args.context - Parse context for tracing and utilities
+ * @param args.nullable - Parsed nullable flag
+ * @param args.example - Parsed example value (type-safe with nullable)
+ * @param args.enums - Parsed enumeration constraints (type-safe with nullable)
+ * @param args.defaultValue - Parsed default value (type-safe with nullable)
+ * @returns Complete OAS array instance with all properties
+ *
+ * @example Type-safe nullable array
+ * ```typescript
+ * const nullableArray = toParsedArray({
+ *   context: parseContext,
+ *   nullable: true,
+ *   example: [1, 2, 3], // Can be null due to nullable: true
+ *   enums: [[1], [2], null], // Null allowed in enums
+ *   defaultValue: null,
+ *   value: {
+ *     type: 'array',
+ *     items: { type: 'number' },
+ *     maxItems: 5
+ *   }
+ * });
+ * ```
+ *
+ * @example Non-nullable array
+ * ```typescript
+ * const regularArray = toParsedArray({
+ *   context: parseContext,
+ *   nullable: false,
+ *   example: ['a', 'b'], // Cannot be null
+ *   enums: [['x'], ['y']], // No null values allowed
+ *   defaultValue: [],
+ *   value: {
+ *     type: 'array',
+ *     items: { type: 'string' }
+ *   }
+ * });
+ * ```
+ */
 export declare const toParsedArray: <Nullable extends boolean | undefined>({ context, nullable, example, enums, defaultValue, value }: ToParsedArrayArgs<Nullable>) => OasArray<Nullable>;
 export {};
 //# sourceMappingURL=toArray.d.ts.map

package/esm/oas/array/toArray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../../src/oas/array/toArray.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAQjE,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,SAAS,CAAC,iBAAiB,CAAA;IAClC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,oBAAoB,WAAW,KAAG,QAmCzD,CAAA;AAED,KAAK,iBAAiB,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAC7D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;IACtF,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACvF,YAAY,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;CAC3F,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,OAAO,GAAG,SAAS,EAAE,4DAOjE,iBAAiB,CAAC,QAAQ,CAAC,KAAG,QAAQ,CAAC,QAAQ,CAyCjD,CAAA"}
+{"version":3,"file":"toArray.d.ts","sourceRoot":"","sources":["../../../src/oas/array/toArray.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAQjE,KAAK,WAAW,GAAG;IACjB,KAAK,EAAE,SAAS,CAAC,iBAAiB,CAAA;IAClC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,OAAO,GAAI,oBAAoB,WAAW,KAAG,QAmCzD,CAAA;AAED,KAAK,iBAAiB,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAC7D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;IACtF,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACvF,YAAY,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;CAC3F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,OAAO,GAAG,SAAS,EAAE,4DAOjE,iBAAiB,CAAC,QAAQ,CAAC,KAAG,QAAQ,CAAC,QAAQ,CAyCjD,CAAA"}

package/esm/oas/array/toArray.js

@@ -5,8 +5,67 @@ import { parseNullable } from '../_helpers/parseNullable.js';
 import { parseExample } from '../_helpers/parseExample.js';
 import { parseEnum } from '../_helpers/parseEnum.js';
 import * as v from 'valibot';
-import { oasArrayData } from './array-types.js';
+import { oasArrayDataWithoutItems } from './array-types.js';
 import { parseDefault } from '../_helpers/parseDefault.js';
+/**
+ * Transforms an OpenAPI v3 array schema object into an internal OAS array representation.
+ *
+ * This function processes OpenAPI array schemas by extracting and parsing nullable values,
+ * examples, enumerations, and default values. It handles the complete transformation from
+ * raw OpenAPI JSON to the SKMTC internal array representation with proper type safety.
+ *
+ * The transformation follows a pipeline approach:
+ * 1. Parse nullable flag and extract base value
+ * 2. Parse example values with nullable support
+ * 3. Parse enumeration constraints
+ * 4. Parse default values
+ * 5. Create final OasArray instance
+ *
+ * @param args - Transformation arguments
+ * @param args.value - The OpenAPI v3 array schema object to transform
+ * @param args.context - Parse context providing utilities and tracing
+ * @returns Transformed OAS array object with parsed properties
+ *
+ * @example Basic array transformation
+ * ```typescript
+ * import { toArray } from '@skmtc/core';
+ *
+ * const openApiArray = {
+ *   type: 'array',
+ *   items: { type: 'string' },
+ *   maxItems: 10,
+ *   uniqueItems: true
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: openApiArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.maxItems); // 10
+ * console.log(oasArray.uniqueItems); // true
+ * ```
+ *
+ * @example Array with nullable and examples
+ * ```typescript
+ * const complexArray = {
+ *   type: 'array',
+ *   items: { type: 'number' },
+ *   nullable: true,
+ *   example: [1, 2, 3],
+ *   default: [],
+ *   enum: [[1, 2], [3, 4], null]
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: complexArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.nullable); // true
+ * console.log(oasArray.example); // [1, 2, 3]
+ * ```
+ */
 export const toArray = ({ value, context }) => {
     const { nullable, value: valueWithoutNullable } = parseNullable({
         value,
@@ -39,11 +98,64 @@ export const toArray = ({ value, context }) => {
         value: valueWithoutDefault
     });
 };
+/**
+ * Creates an OAS array instance from pre-parsed array schema components.
+ *
+ * This function is the final step in the array transformation pipeline, taking
+ * already-parsed nullable, example, enum, and default values and combining them
+ * with the remaining array properties to create the complete OasArray instance.
+ *
+ * The function handles type-safe nullable parsing, items schema resolution,
+ * and specification extension processing. It uses Valibot for schema validation
+ * and maintains proper type relationships between nullable flags and value types.
+ *
+ * @template Nullable - Boolean type indicating if the array can be null
+ * @param args - Pre-parsed array components
+ * @param args.value - OpenAPI array object without parsed fields
+ * @param args.context - Parse context for tracing and utilities
+ * @param args.nullable - Parsed nullable flag
+ * @param args.example - Parsed example value (type-safe with nullable)
+ * @param args.enums - Parsed enumeration constraints (type-safe with nullable)
+ * @param args.defaultValue - Parsed default value (type-safe with nullable)
+ * @returns Complete OAS array instance with all properties
+ *
+ * @example Type-safe nullable array
+ * ```typescript
+ * const nullableArray = toParsedArray({
+ *   context: parseContext,
+ *   nullable: true,
+ *   example: [1, 2, 3], // Can be null due to nullable: true
+ *   enums: [[1], [2], null], // Null allowed in enums
+ *   defaultValue: null,
+ *   value: {
+ *     type: 'array',
+ *     items: { type: 'number' },
+ *     maxItems: 5
+ *   }
+ * });
+ * ```
+ *
+ * @example Non-nullable array
+ * ```typescript
+ * const regularArray = toParsedArray({
+ *   context: parseContext,
+ *   nullable: false,
+ *   example: ['a', 'b'], // Cannot be null
+ *   enums: [['x'], ['y']], // No null values allowed
+ *   defaultValue: [],
+ *   value: {
+ *     type: 'array',
+ *     items: { type: 'string' }
+ *   }
+ * });
+ * ```
+ */
 export const toParsedArray = ({ context, nullable, example, enums, defaultValue, value }) => {
     // We only want parse non-items fields here since items is handled below
     const { items, ...rest } = value;
-    const oasArrayDataSchemaWithItems = v.omit(oasArrayData, ['items']);
-    const { type: _type, title, description, uniqueItems, maxItems, minItems, ...skipped } = v.parse(oasArrayDataSchemaWithItems, rest);
+    // Parse the object without items field
+    const parsed = v.parse(oasArrayDataWithoutItems, rest);
+    const { type: _type, title, description, uniqueItems, maxItems, minItems, ...skipped } = parsed;
     const extensionFields = toSpecificationExtensionsV3({
         skipped,
         parent: value,

package/esm/oas/boolean/Boolean.d.ts

@@ -191,10 +191,36 @@ export declare class OasBoolean<Nullable extends boolean | undefined = boolean |
      * The default value of the boolean.
      */
     default: Nullable extends true ? boolean | null | undefined : boolean | undefined;
+    /**
+     * Creates a new OasBoolean instance.
+     *
+     * @param fields - Boolean configuration fields including validation constraints and metadata
+     */
     constructor(fields?: BooleanFields<Nullable>);
+    /**
+     * Determines if this boolean is a reference object.
+     *
+     * @returns Always returns false since this is a concrete boolean instance, not a reference
+     */
     isRef(): this is OasRef<'schema'>;
+    /**
+     * Resolves this boolean object.
+     *
+     * @returns The boolean instance itself since it's already a concrete object, not a reference
+     */
     resolve(): OasBoolean<Nullable>;
+    /**
+     * Resolves this boolean object one level.
+     *
+     * @returns The boolean instance itself since it's already a concrete object, not a reference
+     */
     resolveOnce(): OasBoolean<Nullable>;
+    /**
+     * Converts this OAS boolean to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options (currently unused for boolean schemas)
+     * @returns OpenAPI v3 boolean schema object with type and all validation constraints
+     */
     toJsonSchema(options?: ToJsonSchemaOptions): OpenAPIV3.NonArraySchemaObject;
 }
 //# sourceMappingURL=Boolean.d.ts.map

package/esm/oas/boolean/Boolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/Boolean.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAChE,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,uEAAuE;IACvE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAClF,oFAAoF;IACpF,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,uEAAuE;IACvE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CACnF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmIG;AACH,qBAAa,UAAU,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS;IAChF;;;OAGG;IACH,OAAO,EAAG,QAAQ,CAAS;IAC3B;;OAEG;IACH,IAAI,EAAG,SAAS,CAAS;IACzB;;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;IAE9B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAEjF;;OAEG;IACH,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;gBAErE,MAAM,GAAE,aAAa,CAAC,QAAQ,CAAM;IAUhD,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC;IAI/B,WAAW,IAAI,UAAU,CAAC,QAAQ,CAAC;IAKnC,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC,oBAAoB;CAW5E"}
+{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/Boolean.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAChE,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,uEAAuE;IACvE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAClF,oFAAoF;IACpF,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,uEAAuE;IACvE,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CACnF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmIG;AACH,qBAAa,UAAU,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS;IAChF;;;OAGG;IACH,OAAO,EAAG,QAAQ,CAAS;IAC3B;;OAEG;IACH,IAAI,EAAG,SAAS,CAAS;IACzB;;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;IAE9B,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACpD;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAEjF;;OAEG;IACH,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IAEjF;;;;OAIG;gBACS,MAAM,GAAE,aAAa,CAAC,QAAQ,CAAM;IAUhD;;;;OAIG;IACH,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC;;;;OAIG;IACH,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC;IAI/B;;;;OAIG;IACH,WAAW,IAAI,UAAU,CAAC,QAAQ,CAAC;IAInC;;;;;OAKG;IAEH,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC,oBAAoB;CAW5E"}

package/esm/oas/boolean/Boolean.js

@@ -132,6 +132,11 @@ import "../../_dnt.polyfills.js";
  * ```
  */
 export class OasBoolean {
+    /**
+     * Creates a new OasBoolean instance.
+     *
+     * @param fields - Boolean configuration fields including validation constraints and metadata
+     */
     constructor(fields = {}) {
         /**
          * Object is part the 'schema' set which is used
@@ -221,15 +226,36 @@ export class OasBoolean {
         this.enums = fields.enums;
         this.default = fields.default;
     }
+    /**
+     * Determines if this boolean is a reference object.
+     *
+     * @returns Always returns false since this is a concrete boolean instance, not a reference
+     */
     isRef() {
         return false;
     }
+    /**
+     * Resolves this boolean object.
+     *
+     * @returns The boolean instance itself since it's already a concrete object, not a reference
+     */
     resolve() {
         return this;
     }
+    /**
+     * Resolves this boolean object one level.
+     *
+     * @returns The boolean instance itself since it's already a concrete object, not a reference
+     */
     resolveOnce() {
         return this;
     }
+    /**
+     * Converts this OAS boolean to an OpenAPI v3 JSON schema representation.
+     *
+     * @param options - Conversion options (currently unused for boolean schemas)
+     * @returns OpenAPI v3 boolean schema object with type and all validation constraints
+     */
     // deno-lint-ignore no-unused-vars
     toJsonSchema(options) {
         return {