@skmtc/core 0.0.800 → 0.0.802

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';
@@ -135,6 +185,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-types.d.ts

@@ -8,17 +8,8 @@ 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>;
+export declare const oasArrayDataWithoutItems: v.GenericSchema<OasArrayDataWithoutItems>;
 /**
  * Data type for OpenAPI array schema objects.
  *
@@ -46,4 +37,22 @@ export type OasArrayData = {
     /** Array of valid enumeration values */
     enums?: unknown[];
 };
+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,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,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,13 @@ export const oasArrayData = v.object({
     uniqueItems: v.optional(v.boolean()),
     enums: v.optional(v.array(v.unknown()))
 });
+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-types.d.ts

@@ -5,13 +5,7 @@ import * as v from 'valibot';
  * 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>;
+export declare const oasBooleanData: v.GenericSchema<OasBooleanData>;
 /**
  * Data type for OpenAPI boolean schema objects.
  *

package/esm/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;;;;;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"}
+{"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,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAMzD,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/esm/oas/components/components-types.d.ts

@@ -0,0 +1,19 @@
+import { type OasExampleData } from '../example/example-types.js';
+import { type OasHeaderData } from '../header/header-types.js';
+import { type OasParameterData } from '../parameter/parameter-types.js';
+import type { OasExampleRefData, OasHeaderRefData, OasParameterRefData, OasRequestBodyRefData, OasResponseRefData, OasSchemaRefData } from '../ref/ref-types.js';
+import { type OasRequestBodyData } from '../requestBody/requestBody-types.js';
+import { type OasResponseData } from '../response/response-types.js';
+import { type OasSchemaData } from '../schema/schema-types.js';
+import * as v from 'valibot';
+export type OasComponentsData = {
+    oasType: 'components';
+    schemas?: Record<string, OasSchemaData | OasSchemaRefData>;
+    responses?: Record<string, OasResponseData | OasResponseRefData>;
+    parameters?: Record<string, OasParameterData | OasParameterRefData>;
+    examples?: Record<string, OasExampleData | OasExampleRefData>;
+    requestBodies?: Record<string, OasRequestBodyData | OasRequestBodyRefData>;
+    headers?: Record<string, OasHeaderData | OasHeaderRefData>;
+};
+export declare const oasComponentsData: v.GenericSchema<OasComponentsData>;
+//# sourceMappingURL=components-types.d.ts.map

package/esm/oas/components/components-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-types.d.ts","sourceRoot":"","sources":["../../../src/oas/components/components-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AACjF,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,iCAAiC,CAAA;AACzF,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAS5B,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,qCAAqC,CAAA;AACjG,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,+BAA+B,CAAA;AACrF,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAAC,CAAA;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC,CAAA;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAAC,CAAA;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,CAAA;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAAC,CAAA;CAC3D,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,aAAa,CAAC,iBAAiB,CAc/D,CAAA"}

package/esm/oas/components/components-types.js

@@ -0,0 +1,21 @@
+import { oasExampleData } from '../example/example-types.js';
+import { oasHeaderData } from '../header/header-types.js';
+import { oasParameterData } from '../parameter/parameter-types.js';
+import { oasExampleRefData, oasHeaderRefData, oasParameterRefData, oasRequestBodyRefData, oasResponseRefData, oasSchemaRefData } from '../ref/ref-types.js';
+import { oasRequestBodyData } from '../requestBody/requestBody-types.js';
+import { oasResponseData } from '../response/response-types.js';
+import { oasSchemaData } from '../schema/schema-types.js';
+import * as v from 'valibot';
+export const oasComponentsData = v.object({
+    oasType: v.literal('components'),
+    schemas: v.optional(v.record(v.string(), v.union([oasSchemaData, oasSchemaRefData]))),
+    responses: v.optional(v.record(v.string(), v.union([oasResponseData, oasResponseRefData]))),
+    parameters: v.optional(v.record(v.string(), v.union([oasParameterData, oasParameterRefData]))),
+    examples: v.optional(v.record(v.string(), v.union([oasExampleData, oasExampleRefData]))),
+    requestBodies: v.optional(v.record(v.string(), v.union([oasRequestBodyData, oasRequestBodyRefData]))),
+    headers: v.optional(v.record(v.string(), v.union([oasHeaderData, oasHeaderRefData])))
+    // securitySchemes: z.record(z.union([securityScheme, ref])),
+    // links: z.record(z.union([link, ref])),
+    // callbacks: z.never(),
+    // pathItems: z.record(z.union([oasPathItemData, oasPathItemRefData])).optional()
+});

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

@@ -0,0 +1,9 @@
+import * as v from 'valibot';
+export type OasContactData = {
+    oasType: 'contact';
+    name?: string;
+    url?: string;
+    email?: string;
+};
+export declare const oasContactData: v.GenericSchema<OasContactData>;
+//# sourceMappingURL=contact-types.d.ts.map

package/esm/oas/contact/contact-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-types.d.ts","sourceRoot":"","sources":["../../../src/oas/contact/contact-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,SAAS,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAKzD,CAAA"}

package/esm/oas/contact/contact-types.js

@@ -0,0 +1,7 @@
+import * as v from 'valibot';
+export const oasContactData = v.object({
+    oasType: v.literal('contact'),
+    name: v.optional(v.string()),
+    url: v.optional(v.string()),
+    email: v.optional(v.string())
+});

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

@@ -21,9 +21,5 @@ export type OasDiscriminatorData = {
  * 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>;
-    readonly mapping: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, undefined>;
-}, undefined>;
+export declare const oasDiscriminatorData: v.GenericSchema<OasDiscriminatorData>;
 //# sourceMappingURL=discriminator-types.d.ts.map

package/esm/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;;;;;;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"}
+{"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,EAAE,CAAC,CAAC,aAAa,CAAC,oBAAoB,CAIrE,CAAA"}

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

@@ -0,0 +1,16 @@
+import { type OasTagData } from '../tag/tag-types.js';
+import { type OasOperationData } from '../operation/operation-types.js';
+import * as v from 'valibot';
+import { type OasComponentsData } from '../components/components-types.js';
+import { type OasInfoData } from '../info/info-types.js';
+export type OasDocumentData = {
+    oasType: 'openapi';
+    openapi: string;
+    info: OasInfoData;
+    jsonSchemaDialect?: string;
+    operations: OasOperationData[];
+    components?: OasComponentsData;
+    tags?: OasTagData[];
+};
+export declare const oasDocumentData: v.GenericSchema<OasDocumentData>;
+//# sourceMappingURL=document-types.d.ts.map

package/esm/oas/document/document-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-types.d.ts","sourceRoot":"","sources":["../../../src/oas/document/document-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,iCAAiC,CAAA;AACzF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,mCAAmC,CAAA;AAC7F,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,uBAAuB,CAAA;AAErE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,WAAW,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAE9B,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAE9B,IAAI,CAAC,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,eAAe,CAY3D,CAAA"}

package/esm/oas/document/document-types.js

@@ -0,0 +1,18 @@
+import { oasTagData } from '../tag/tag-types.js';
+import { oasOperationData } from '../operation/operation-types.js';
+import * as v from 'valibot';
+import { oasComponentsData } from '../components/components-types.js';
+import { oasInfoData } from '../info/info-types.js';
+export const oasDocumentData = v.object({
+    oasType: v.literal('openapi'),
+    openapi: v.string(),
+    info: oasInfoData,
+    jsonSchemaDialect: v.optional(v.string()),
+    // servers: z.array(server).optional(),
+    operations: v.array(oasOperationData),
+    // webhooks: z.record(z.union([pathItem, ref])).optional(),
+    components: v.optional(oasComponentsData),
+    // security: z.never(),
+    tags: v.optional(v.array(oasTagData))
+    // externalDocs: externalDocs.optional()
+});

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

@@ -5,10 +5,5 @@ export type OasExampleData = {
     description?: string;
     value?: unknown;
 };
-export declare const oasExampleData: v.ObjectSchema<{
-    readonly oasType: v.LiteralSchema<"example", undefined>;
-    readonly summary: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly description: v.OptionalSchema<v.GenericSchema<string>, undefined>;
-    readonly value: v.OptionalSchema<v.UnknownSchema, undefined>;
-}, undefined>;
+export declare const oasExampleData: v.GenericSchema<OasExampleData>;
 //# sourceMappingURL=example-types.d.ts.map

package/esm/oas/example/example-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example-types.d.ts","sourceRoot":"","sources":["../../../src/oas/example/example-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAEhB,CAAA;AAED,eAAO,MAAM,cAAc;;;;;aAMzB,CAAA"}
+{"version":3,"file":"example-types.d.ts","sourceRoot":"","sources":["../../../src/oas/example/example-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAEhB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,cAAc,CAMzD,CAAA"}