@skmtc/core 0.0.800 → 0.0.802

package/script/mod.js

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

package/script/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/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;;;;;;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/script/oas/array/array-types.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.oasArrayData = void 0;
+exports.oasArrayDataWithoutItems = 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");
@@ -55,3 +55,13 @@ exports.oasArrayData = v.object({
     uniqueItems: v.optional(v.boolean()),
     enums: v.optional(v.array(v.unknown()))
 });
+exports.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/script/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/script/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/script/oas/array/toArray.js

@@ -43,6 +43,65 @@ const parseEnum_js_1 = require("../_helpers/parseEnum.js");
 const v = __importStar(require("valibot"));
 const array_types_js_1 = require("./array-types.js");
 const parseDefault_js_1 = require("../_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]
+ * ```
+ */
 const toArray = ({ value, context }) => {
     const { nullable, value: valueWithoutNullable } = (0, parseNullable_js_1.parseNullable)({
         value,
@@ -76,11 +135,64 @@ const toArray = ({ value, context }) => {
     });
 };
 exports.toArray = toArray;
+/**
+ * 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' }
+ *   }
+ * });
+ * ```
+ */
 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(array_types_js_1.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(array_types_js_1.oasArrayDataWithoutItems, rest);
+    const { type: _type, title, description, uniqueItems, maxItems, minItems, ...skipped } = parsed;
     const extensionFields = (0, toSpecificationExtensionsV3_js_1.toSpecificationExtensionsV3)({
         skipped,
         parent: value,

package/script/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/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;;;;;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/script/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/script/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/script/oas/components/components-types.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oasComponentsData = void 0;
+const example_types_js_1 = require("../example/example-types.js");
+const header_types_js_1 = require("../header/header-types.js");
+const parameter_types_js_1 = require("../parameter/parameter-types.js");
+const ref_types_js_1 = require("../ref/ref-types.js");
+const requestBody_types_js_1 = require("../requestBody/requestBody-types.js");
+const response_types_js_1 = require("../response/response-types.js");
+const schema_types_js_1 = require("../schema/schema-types.js");
+const v = __importStar(require("valibot"));
+exports.oasComponentsData = v.object({
+    oasType: v.literal('components'),
+    schemas: v.optional(v.record(v.string(), v.union([schema_types_js_1.oasSchemaData, ref_types_js_1.oasSchemaRefData]))),
+    responses: v.optional(v.record(v.string(), v.union([response_types_js_1.oasResponseData, ref_types_js_1.oasResponseRefData]))),
+    parameters: v.optional(v.record(v.string(), v.union([parameter_types_js_1.oasParameterData, ref_types_js_1.oasParameterRefData]))),
+    examples: v.optional(v.record(v.string(), v.union([example_types_js_1.oasExampleData, ref_types_js_1.oasExampleRefData]))),
+    requestBodies: v.optional(v.record(v.string(), v.union([requestBody_types_js_1.oasRequestBodyData, ref_types_js_1.oasRequestBodyRefData]))),
+    headers: v.optional(v.record(v.string(), v.union([header_types_js_1.oasHeaderData, ref_types_js_1.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/script/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/script/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/script/oas/contact/contact-types.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oasContactData = void 0;
+const v = __importStar(require("valibot"));
+exports.oasContactData = v.object({
+    oasType: v.literal('contact'),
+    name: v.optional(v.string()),
+    url: v.optional(v.string()),
+    email: v.optional(v.string())
+});

package/script/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/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;;;;;;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/script/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/script/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"}