@skmtc/core 0.0.799 → 0.0.802

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"}

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

@@ -0,0 +1,54 @@
+"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.oasDocumentData = void 0;
+const tag_types_js_1 = require("../tag/tag-types.js");
+const operation_types_js_1 = require("../operation/operation-types.js");
+const v = __importStar(require("valibot"));
+const components_types_js_1 = require("../components/components-types.js");
+const info_types_js_1 = require("../info/info-types.js");
+exports.oasDocumentData = v.object({
+    oasType: v.literal('openapi'),
+    openapi: v.string(),
+    info: info_types_js_1.oasInfoData,
+    jsonSchemaDialect: v.optional(v.string()),
+    // servers: z.array(server).optional(),
+    operations: v.array(operation_types_js_1.oasOperationData),
+    // webhooks: z.record(z.union([pathItem, ref])).optional(),
+    components: v.optional(components_types_js_1.oasComponentsData),
+    // security: z.never(),
+    tags: v.optional(v.array(tag_types_js_1.oasTagData))
+    // externalDocs: externalDocs.optional()
+});

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

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

@@ -0,0 +1,50 @@
+import { type OasExampleData } from '../example/example-types.js';
+import { type OasMediaTypeData } from '../mediaType/mediaType-types.js';
+import { type OasExampleRefData, type OasSchemaRefData } from '../ref/ref-types.js';
+import { type OasSchemaData } from '../schema/schema-types.js';
+import * as v from 'valibot';
+/**
+ * Data type for OpenAPI header objects in the SKMTC internal representation.
+ *
+ * Represents HTTP headers in OpenAPI specifications, including validation
+ * rules, examples, and serialization parameters. Headers are used in
+ * responses and can include complex schemas and multiple examples.
+ */
+export type OasHeaderData = {
+    /** Type identifier for OAS header objects */
+    oasType: 'header';
+    /** Human-readable description of the header */
+    description?: string;
+    /** Whether the header is required */
+    required?: boolean;
+    /** Whether the header is deprecated */
+    deprecated?: boolean;
+    /** Whether empty values are allowed for the header */
+    allowEmptyValue?: boolean;
+    /** Schema definition for the header value */
+    schema?: OasSchemaData | OasSchemaRefData;
+    /** Named examples for the header value */
+    examples?: Record<string, OasExampleData | OasExampleRefData>;
+    /** Media type definitions for complex header content */
+    content?: Record<string, OasMediaTypeData>;
+    /** Serialization style (always 'simple' for headers) */
+    style?: OasHeaderStyle;
+    /** Whether to explode parameter values */
+    explode?: boolean;
+};
+/**
+ * Valid serialization styles for OpenAPI headers.
+ *
+ * Headers can only use the 'simple' serialization style according to
+ * the OpenAPI specification.
+ */
+export type OasHeaderStyle = 'simple';
+/**
+ * Valibot schema for validating OAS header data structures.
+ *
+ * Validates the structure and content of OpenAPI header objects,
+ * ensuring proper types for all fields including nested schemas,
+ * examples, and content definitions.
+ */
+export declare const oasHeaderData: v.GenericSchema<OasHeaderData>;
+//# sourceMappingURL=header-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"header-types.d.ts","sourceRoot":"","sources":["../../../src/oas/header/header-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AAEjF,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,iCAAiC,CAAA;AACzF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,QAAQ,CAAA;IACjB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAA;IACzC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;IAC7D,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC1C,wDAAwD;IACxD,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAID;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAA;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAcvD,CAAA"}

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

@@ -0,0 +1,66 @@
+"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.oasHeaderData = void 0;
+const example_types_js_1 = require("../example/example-types.js");
+const markdown_types_js_1 = require("../markdown/markdown-types.js");
+const mediaType_types_js_1 = require("../mediaType/mediaType-types.js");
+const ref_types_js_1 = require("../ref/ref-types.js");
+const schema_types_js_1 = require("../schema/schema-types.js");
+const v = __importStar(require("valibot"));
+const oasHeaderStyle = v.literal('simple');
+/**
+ * Valibot schema for validating OAS header data structures.
+ *
+ * Validates the structure and content of OpenAPI header objects,
+ * ensuring proper types for all fields including nested schemas,
+ * examples, and content definitions.
+ */
+exports.oasHeaderData = v.object({
+    oasType: v.literal('header'),
+    description: v.optional(markdown_types_js_1.markdown),
+    required: v.optional(v.boolean()),
+    deprecated: v.optional(v.boolean()),
+    allowEmptyValue: v.optional(v.boolean()),
+    // Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
+    style: v.optional(oasHeaderStyle),
+    explode: v.optional(v.boolean()),
+    // allowReserved: v.boolean().optional(),
+    schema: v.optional(v.union([schema_types_js_1.oasSchemaData, ref_types_js_1.oasSchemaRefData])),
+    // example: z.any().optional(),
+    examples: v.optional(v.record(v.string(), v.union([example_types_js_1.oasExampleData, ref_types_js_1.oasExampleRefData]))),
+    content: v.optional(v.record(v.string(), mediaType_types_js_1.oasMediaTypeData))
+});
+// export type OasHeaders = Record<string, OasHeader | OasHeaderRef>

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

@@ -0,0 +1,14 @@
+import { type OasLicenseData } from '../license/license-types.js';
+import { type OasContactData } from '../contact/contact-types.js';
+import * as v from 'valibot';
+export type OasInfoData = {
+    oasType: 'info';
+    title: string;
+    description?: string;
+    termsOfService?: string;
+    contact?: OasContactData;
+    license?: OasLicenseData;
+    version: string;
+};
+export declare const oasInfoData: v.GenericSchema<OasInfoData>;
+//# sourceMappingURL=info-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"info-types.d.ts","sourceRoot":"","sources":["../../../src/oas/info/info-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AACjF,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AAEjF,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,aAAa,CAAC,WAAW,CAQnD,CAAA"}

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

@@ -0,0 +1,49 @@
+"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.oasInfoData = void 0;
+const license_types_js_1 = require("../license/license-types.js");
+const contact_types_js_1 = require("../contact/contact-types.js");
+const markdown_types_js_1 = require("../markdown/markdown-types.js");
+const v = __importStar(require("valibot"));
+exports.oasInfoData = v.object({
+    oasType: v.literal('info'),
+    title: v.string(),
+    description: v.optional(markdown_types_js_1.markdown),
+    termsOfService: v.optional(v.string()),
+    contact: v.optional(contact_types_js_1.oasContactData),
+    license: v.optional(license_types_js_1.oasLicenseData),
+    version: v.string()
+});

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

@@ -5,35 +5,21 @@ import * as v from 'valibot';
  * Ensures values are numbers and specifically integers,
  * used for integer validation throughout OAS processing.
  */
-export declare const integerSchema: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+export declare const integerSchema: v.GenericSchema<number>;
 /**
  * Valibot schema for valid integer format values.
  *
  * Defines the size formats for integer types: int32 for 32-bit signed
  * integers and int64 for 64-bit signed integers.
  */
-export declare const integerFormat: v.UnionSchema<[v.LiteralSchema<"int32", undefined>, v.LiteralSchema<"int64", undefined>], undefined>;
+export declare const integerFormat: v.GenericSchema<'int32' | 'int64'>;
 /**
  * Valibot schema for validating OpenAPI integer data objects.
  *
  * Validates integer schemas including size formats (int32/int64),
  * range constraints, multiple validation, and enumeration values.
  */
-export declare const oasIntegerData: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"integer", undefined>;
-    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
-    readonly format: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"int32", undefined>, v.LiteralSchema<"int64", undefined>], undefined>, undefined>;
-    readonly enum: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>, undefined>;
-    readonly nullable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly example: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
-    readonly multipleOf: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
-    readonly maximum: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
-    readonly exclusiveMaximum: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly minimum: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
-    readonly exclusiveMinimum: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-}, undefined>;
+export declare const oasIntegerData: v.GenericSchema<OasIntegerData>;
 export type OasIntegerData = {
     type: 'integer';
     title?: string;