@skmtc/core 0.0.924 → 0.0.929

package/script/oas/_helpers/parseEnum.d.ts

@@ -1,140 +1,12 @@
-import type { OpenAPIV3 } from 'openapi-types';
-import type { ParseContext } from '../../context/ParseContext.js';
-import * as v from 'valibot';
-/**
- * Arguments for parsing OpenAPI schema enum values.
- *
- * @template T - The expected type of enum values
- * @template Nullable - Whether the schema allows null values
- * @template Value - The OpenAPI schema object type
- */
-type ParseEnumArgs<T, Nullable extends boolean | undefined, Value extends OpenAPIV3.SchemaObject> = {
-    /** The OpenAPI schema object without nullable property */
-    value: Omit<Value, 'nullable'>;
-    /** Whether the schema allows null values */
-    nullable: Nullable;
-    /** Valibot schema for validating enum values */
-    valibotSchema: v.GenericSchema<T>;
-    /** Parse context for error handling */
+import type { ParseContext } from '../../mod.js';
+type ParseEnumArgs = {
+    value: unknown;
+    nullable: boolean | undefined;
+    parent: unknown;
+    check: (item: unknown) => boolean;
+    toMessage: (item: unknown) => string;
     context: ParseContext;
 };
-/**
- * Return type for parsed enum data.
- *
- * @template T - The expected type of enum values
- * @template Nullable - Whether the schema allows null values
- * @template Value - The OpenAPI schema object type
- */
-type ParseEnumReturn<T, Nullable extends boolean | undefined, Value extends OpenAPIV3.SchemaObject> = {
-    /** The parsed and validated enum array */
-    enum: Nullable extends true ? (T | null)[] | undefined : T[] | undefined;
-    /** The schema object without enum and nullable properties */
-    value: Omit<Value, 'nullable' | 'enum'>;
-};
-/**
- * Parses and validates OpenAPI schema enum values with type safety.
- *
- * This function extracts and validates enum arrays from OpenAPI schema objects,
- * ensuring all enum values conform to the expected type and handling nullable
- * schemas correctly. Invalid enum values are removed and logged as warnings
- * through the parse context.
- *
- * The function provides full type safety, with the return type reflecting whether
- * null values are allowed in the enum array based on the nullable parameter.
- *
- * @template T - The expected type of enum values
- * @template Nullable - Whether the schema allows null values in enums
- * @template Value - The OpenAPI schema object type
- *
- * @param args - Parsing configuration
- * @returns Parsed enum data with the validated enum array and cleaned schema
- *
- * @example Basic string enum parsing
- * ```typescript
- * import { parseEnum } from '@skmtc/core/oas/_helpers';
- * import * as v from 'valibot';
- *
- * const result = parseEnum({
- *   value: {
- *     type: 'string',
- *     enum: ['active', 'inactive', 'pending'],
- *     description: 'User status'
- *   },
- *   nullable: false,
- *   valibotSchema: v.string(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // ['active', 'inactive', 'pending']
- * console.log(result.value); // { type: 'string', description: 'User status' }
- * ```
- *
- * @example Nullable enum parsing
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'string',
- *     enum: ['red', 'green', 'blue', null],
- *     description: 'Optional color selection'
- *   },
- *   nullable: true,
- *   valibotSchema: v.string(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // ['red', 'green', 'blue', null]
- * // Type: (string | null)[] | undefined
- * ```
- *
- * @example Number enum parsing
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'number',
- *     enum: [1, 2, 3, 5, 8, 13],
- *     description: 'Fibonacci subset'
- *   },
- *   nullable: false,
- *   valibotSchema: v.number(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // [1, 2, 3, 5, 8, 13]
- * ```
- *
- * @example Invalid enum handling
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'number',
- *     enum: [1, 'invalid', 3], // Contains invalid value
- *     description: 'Mixed enum (invalid)'
- *   },
- *   nullable: false,
- *   valibotSchema: v.number(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // undefined (entire enum removed due to invalid value)
- * // Context will log a warning about the invalid enum
- * ```
- *
- * @example Boolean enum (essentially optional boolean)
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'boolean',
- *     enum: [true, false],
- *     description: 'Explicit boolean enum'
- *   },
- *   nullable: false,
- *   valibotSchema: v.boolean(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // [true, false]
- * ```
- */
-export declare const parseEnum: <T, Nullable extends boolean | undefined, Value extends OpenAPIV3.SchemaObject>({ value, nullable, valibotSchema, context }: ParseEnumArgs<T, Nullable, Value>) => ParseEnumReturn<T, Nullable, Value>;
+export declare const parseEnum: ({ value, nullable, parent, context, check, toMessage }: ParseEnumArgs) => any[] | undefined;
 export {};
 //# sourceMappingURL=parseEnum.d.ts.map

package/script/oas/_helpers/parseEnum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseEnum.d.ts","sourceRoot":"","sources":["../../../src/oas/_helpers/parseEnum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,KAAK,aAAa,CAChB,CAAC,EACD,QAAQ,SAAS,OAAO,GAAG,SAAS,EACpC,KAAK,SAAS,SAAS,CAAC,YAAY,IAClC;IACF,0DAA0D;IAC1D,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAC9B,4CAA4C;IAC5C,QAAQ,EAAE,QAAQ,CAAA;IAClB,gDAAgD;IAChD,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IACjC,uCAAuC;IACvC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;GAMG;AACH,KAAK,eAAe,CAClB,CAAC,EACD,QAAQ,SAAS,OAAO,GAAG,SAAS,EACpC,KAAK,SAAS,SAAS,CAAC,YAAY,IAClC;IACF,0CAA0C;IAC1C,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,EAAE,GAAG,SAAS,CAAA;IACxE,6DAA6D;IAC7D,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,CAAA;CACxC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AACH,eAAO,MAAM,SAAS,GACpB,CAAC,EACD,QAAQ,SAAS,OAAO,GAAG,SAAS,EACpC,KAAK,SAAS,SAAS,CAAC,YAAY,EACpC,6CAKC,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAG,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAgBxE,CAAA"}
+{"version":3,"file":"parseEnum.d.ts","sourceRoot":"","sources":["../../../src/oas/_helpers/parseEnum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,OAAO,CAAA;IAEd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAA;IACpC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,wDAOvB,aAAa,sBA0Bf,CAAA"}

package/script/oas/_helpers/parseEnum.js

@@ -1,157 +1,26 @@
 "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.parseEnum = void 0;
-const v = __importStar(require("valibot"));
-/**
- * Parses and validates OpenAPI schema enum values with type safety.
- *
- * This function extracts and validates enum arrays from OpenAPI schema objects,
- * ensuring all enum values conform to the expected type and handling nullable
- * schemas correctly. Invalid enum values are removed and logged as warnings
- * through the parse context.
- *
- * The function provides full type safety, with the return type reflecting whether
- * null values are allowed in the enum array based on the nullable parameter.
- *
- * @template T - The expected type of enum values
- * @template Nullable - Whether the schema allows null values in enums
- * @template Value - The OpenAPI schema object type
- *
- * @param args - Parsing configuration
- * @returns Parsed enum data with the validated enum array and cleaned schema
- *
- * @example Basic string enum parsing
- * ```typescript
- * import { parseEnum } from '@skmtc/core/oas/_helpers';
- * import * as v from 'valibot';
- *
- * const result = parseEnum({
- *   value: {
- *     type: 'string',
- *     enum: ['active', 'inactive', 'pending'],
- *     description: 'User status'
- *   },
- *   nullable: false,
- *   valibotSchema: v.string(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // ['active', 'inactive', 'pending']
- * console.log(result.value); // { type: 'string', description: 'User status' }
- * ```
- *
- * @example Nullable enum parsing
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'string',
- *     enum: ['red', 'green', 'blue', null],
- *     description: 'Optional color selection'
- *   },
- *   nullable: true,
- *   valibotSchema: v.string(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // ['red', 'green', 'blue', null]
- * // Type: (string | null)[] | undefined
- * ```
- *
- * @example Number enum parsing
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'number',
- *     enum: [1, 2, 3, 5, 8, 13],
- *     description: 'Fibonacci subset'
- *   },
- *   nullable: false,
- *   valibotSchema: v.number(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // [1, 2, 3, 5, 8, 13]
- * ```
- *
- * @example Invalid enum handling
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'number',
- *     enum: [1, 'invalid', 3], // Contains invalid value
- *     description: 'Mixed enum (invalid)'
- *   },
- *   nullable: false,
- *   valibotSchema: v.number(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // undefined (entire enum removed due to invalid value)
- * // Context will log a warning about the invalid enum
- * ```
- *
- * @example Boolean enum (essentially optional boolean)
- * ```typescript
- * const result = parseEnum({
- *   value: {
- *     type: 'boolean',
- *     enum: [true, false],
- *     description: 'Explicit boolean enum'
- *   },
- *   nullable: false,
- *   valibotSchema: v.boolean(),
- *   context: parseContext
- * });
- *
- * console.log(result.enum); // [true, false]
- * ```
- */
-const parseEnum = ({ value, nullable, valibotSchema, context }) => {
-    const { enum: enums, ...rest } = value;
-    const parsedEnum = context.provisionalParse({
-        key: 'enum',
-        value: enums,
-        parent: value,
-        schema: nullable === true ? v.array(v.nullable(valibotSchema)) : v.array(valibotSchema),
-        toMessage: value => `Removed invalid enum. Expected ${valibotSchema.type}, got: ${value}`,
-        type: 'INVALID_ENUM'
-    });
-    return {
-        enum: parsedEnum,
-        value: rest
-    };
+const parseEnum = ({ value, nullable, parent, context, check, toMessage }) => {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (nullable && item === null) {
+                continue;
+            }
+            if (check(item)) {
+                continue;
+            }
+            context.logIssue({
+                key: 'default',
+                level: 'warning',
+                message: toMessage(item),
+                parent,
+                type: 'INVALID_DEFAULT'
+            });
+            return undefined;
+        }
+        return value;
+    }
+    return undefined;
 };
 exports.parseEnum = parseEnum;

package/script/oas/_helpers/parseNullable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseNullable.d.ts","sourceRoot":"","sources":["../../../src/oas/_helpers/parseNullable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,CAAC,YAAY,IAAI;IACpE,iEAAiE;IACjE,KAAK,EAAE,KAAK,CAAA;IACZ,uCAAuC;IACvC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,SAAS,CAAC,YAAY,IAAI;IACtE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,sDAAsD;IACtD,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,SAAS,CAAC,YAAY,EAAE,oBAGjE,iBAAiB,CAAC,KAAK,CAAC,KAAG,mBAAmB,CAAC,KAAK,CAgBtD,CAAA"}
+{"version":3,"file":"parseNullable.d.ts","sourceRoot":"","sources":["../../../src/oas/_helpers/parseNullable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,CAAC,YAAY,IAAI;IACpE,iEAAiE;IACjE,KAAK,EAAE,KAAK,CAAA;IACZ,uCAAuC;IACvC,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,SAAS,CAAC,YAAY,IAAI;IACtE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,sDAAsD;IACtD,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgHG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,SAAS,CAAC,YAAY,EAAE,oBAGjE,iBAAiB,CAAC,KAAK,CAAC,KAAG,mBAAmB,CAAC,KAAK,CA6BtD,CAAA"}

package/script/oas/_helpers/parseNullable.js

@@ -1,40 +1,6 @@
 "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.parseNullable = void 0;
-const v = __importStar(require("valibot"));
 /**
  * Parses and validates the nullable property from OpenAPI schema objects.
  *
@@ -149,17 +115,28 @@ const v = __importStar(require("valibot"));
  * ```
  */
 const parseNullable = ({ value, context }) => {
+    if (value.nullable === undefined) {
+        return {
+            nullable: undefined,
+            value: value
+        };
+    }
     const { nullable, ...rest } = value;
-    const parsedNullable = context.provisionalParse({
+    if (typeof nullable === 'boolean') {
+        return {
+            nullable: nullable,
+            value: rest
+        };
+    }
+    context.logIssue({
         key: 'nullable',
-        value: nullable,
         parent: value,
-        schema: v.optional(v.boolean()),
-        toMessage: (input) => `Invalid nullable: ${input}`,
+        level: 'warning',
+        message: `Invalid nullable: ${value}`,
         type: 'INVALID_NULLABLE'
     });
     return {
-        nullable: parsedNullable,
+        nullable: undefined,
         value: rest
     };
 };

package/script/oas/_merge-all-of/merge-enum-values.js

@@ -56,7 +56,7 @@ function mergeEnumValues(first, second, typeCheck) {
     // Find intersection of enum values
     const intersection = first
         .enum.filter(value => second.enum.some(bValue => (0, is_equal_js_1.isEqual)(value, bValue)))
-        .map(value => (typeCheck ? v.parse(typeCheck, value) : value));
+        .map(value => (typeCheck ? (v.is(typeCheck, value) ? value : undefined) : value));
     // If intersection is empty, throw error
     if (intersection.length === 0) {
         throw new Error('Merged schema has empty enum array');

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

@@ -1,4 +1,3 @@
-import "../../_dnt.polyfills.js";
 import type { OasSchema, ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { OasRef } from '../ref/Ref.js';
 import type { OpenAPIV3 } from 'openapi-types';
@@ -30,102 +29,13 @@ export type ArrayFields<Nullable extends boolean | undefined> = {
     enums?: Nullable extends true ? (unknown | null)[] | undefined : unknown[] | undefined;
     /** Default value for the array */
     defaultValue?: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
+    /** Whether the array is read-only */
+    readOnly?: boolean;
+    /** Whether the array is write-only */
+    writeOnly?: boolean;
+    /** Whether the array is deprecated */
+    deprecated?: boolean;
 };
-/**
- * Represents an array schema in the OpenAPI Specification.
- *
- * `OasArray` handles array type definitions with comprehensive validation
- * constraints including item count limits, uniqueness requirements, and
- * item type specifications. It supports nested schemas and references
- * for complex array structures.
- *
- * This class is used throughout the OAS processing pipeline to represent
- * array fields in API schemas, including lists of objects, primitive arrays,
- * and complex nested array structures.
- *
- * ## Key Features
- *
- * - **Item Type Definition**: Support for any schema type as array items
- * - **Size Constraints**: Minimum and maximum item count validation
- * - **Uniqueness Validation**: Ensure array items are unique (like Set behavior)
- * - **Nested Schemas**: Support for complex nested array structures
- * - **Reference Handling**: Seamless integration with schema references
- * - **Nullable Support**: Type-safe nullable array handling
- * - **JSON Schema**: Conversion to standard JSON Schema format
- *
- * @template Nullable - Whether the array value can be null
- *
- * @example String array
- * ```typescript
- * import { OasArray, OasString } from '@skmtc/core';
- *
- * const tagsArray = new OasArray({
- *   title: 'Tags',
- *   description: 'List of tags associated with the item',
- *   items: new OasString({ minLength: 1 }),
- *   minItems: 1,
- *   uniqueItems: true,
- *   example: ['javascript', 'typescript', 'react']
- * });
- * ```
- *
- * @example Object array with references
- * ```typescript
- * import { OasArray, OasRef } from '@skmtc/core';
- *
- * const usersArray = new OasArray({
- *   title: 'Users',
- *   description: 'List of user objects',
- *   items: new OasRef({ refName: 'User' }),
- *   maxItems: 100,
- *   example: [
- *     { id: 1, name: 'John' },
- *     { id: 2, name: 'Jane' }
- *   ]
- * });
- * ```
- *
- * @example Nested array (array of arrays)
- * ```typescript
- * const matrixArray = new OasArray({
- *   title: 'Matrix',
- *   description: '2D array of numbers',
- *   items: new OasArray({
- *     items: new OasInteger({ minimum: 0 })
- *   }),
- *   example: [
- *     [1, 2, 3],
- *     [4, 5, 6],
- *     [7, 8, 9]
- *   ]
- * });
- * ```
- *
- * @example Nullable array with constraints
- * ```typescript
- * const optionalIdsArray = new OasArray<true>({
- *   title: 'Optional IDs',
- *   description: 'Optional list of IDs',
- *   items: new OasInteger({ format: 'int64', minimum: 1 }),
- *   nullable: true,
- *   minItems: 0,
- *   maxItems: 10,
- *   defaultValue: null
- * });
- * ```
- *
- * @example Unique items validation
- * ```typescript
- * const uniqueEmailsArray = new OasArray({
- *   title: 'Email Recipients',
- *   description: 'List of unique email addresses',
- *   items: new OasString({ format: 'email' }),
- *   uniqueItems: true, // Ensures no duplicate emails
- *   minItems: 1,
- *   example: ['user1@example.com', 'user2@example.com']
- * });
- * ```
- */
 export declare class OasArray<Nullable extends boolean | undefined = boolean | undefined> {
     /**
      * Object is part the 'schema' set which is used
@@ -183,6 +93,18 @@ export declare class OasArray<Nullable extends boolean | undefined = boolean | u
      *
      * @param fields - Array configuration fields including items schema, validation constraints, and metadata
      */
+    /**
+     * Whether the array is read-only.
+     */
+    readOnly: boolean | undefined;
+    /**
+     * Whether the array is write-only.
+     */
+    writeOnly: boolean | undefined;
+    /**
+     * Whether the array is deprecated.
+     */
+    deprecated: boolean | undefined;
     constructor(fields: ArrayFields<Nullable>);
     /**
      * Determines if this array is a reference object.

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

@@ -1 +1 @@
-{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAC9D,wCAAwC;IACxC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,0BAA0B;IAC1B,OAAO,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACtF,kCAAkC;IAClC,YAAY,CAAC,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;CAC5F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,qBAAa,QAAQ,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS;IAC9E;;;OAGG;IACH,OAAO,EAAG,QAAQ,CAAS;IAC3B;;OAEG;IACH,IAAI,EAAG,OAAO,CAAS;IACvB;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;IAEhC,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAEpD;;OAEG;IACH,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAE5B;;OAEG;IACH,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IAErF;;OAEG;IACH,YAAY,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IAE1F;;;;OAIG;gBACS,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;IAczC;;;;OAIG;IACH,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC;;;;OAIG;IACH,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAI7B;;;;OAIG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAIjC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC,iBAAiB;CAexE"}
+{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"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"}