@skmtc/core 0.29.0 → 0.31.0

package/esm/parse/v3-2/_merge-all-of/merge-object-constraints.js

@@ -0,0 +1,28 @@
+import { mergeSchemasOrRefs } from './merge.js';
+import { genericMerge } from './generic-merge.js';
+import * as v from 'valibot';
+import { checkTypeConflicts } from './check-type-conflicts.js';
+export const mergeObjectConstraints = (first, second, getRef) => {
+    // Check for type conflicts
+    checkTypeConflicts(first, second);
+    const result = genericMerge(first, second, getRef, v.record(v.string(), v.any()));
+    if (typeof second.additionalProperties === 'object' &&
+        typeof first.additionalProperties === 'object') {
+        // If both have additionalProperties as schemas, merge them
+        result.additionalProperties = mergeSchemasOrRefs(first.additionalProperties, second.additionalProperties, getRef);
+    }
+    else if (second.additionalProperties !== undefined) {
+        result.additionalProperties = second.additionalProperties;
+    }
+    else if (first.additionalProperties !== undefined) {
+        result.additionalProperties = first.additionalProperties;
+    }
+    // Merge minProperties and maxProperties
+    if (second.minProperties !== undefined || first.minProperties !== undefined) {
+        result.minProperties = Math.max(second.minProperties ?? 0, first.minProperties ?? 0);
+    }
+    if (second.maxProperties !== undefined || first.maxProperties !== undefined) {
+        result.maxProperties = Math.min(second.maxProperties ?? Infinity, first.maxProperties ?? Infinity);
+    }
+    return result;
+};

package/esm/parse/v3-2/_merge-all-of/merge-properties.d.ts

@@ -0,0 +1,2 @@
+import type { SchemaObject, GetRefFn } from './types.js';
+export declare const mergeProperties: (first: SchemaObject, second: SchemaObject, getRef: GetRefFn) => SchemaObject | undefined;

package/esm/parse/v3-2/_merge-all-of/merge-properties.js

@@ -0,0 +1,25 @@
+import { mergeSchemasOrRefs } from './merge.js';
+export const mergeProperties = (first, second, getRef) => {
+    if (containsProperties(first, second)) {
+        const properties = { ...first.properties };
+        if (!properties) {
+            return {
+                properties: second.properties
+            };
+        }
+        for (const key in second.properties) {
+            if (key in properties) {
+                properties[key] = mergeSchemasOrRefs(properties[key], second.properties[key], getRef);
+            }
+            else {
+                properties[key] = second.properties[key];
+            }
+        }
+        return {
+            properties
+        };
+    }
+};
+const containsProperties = (first, second) => {
+    return Boolean(first.properties || second.properties);
+};

package/esm/parse/v3-2/_merge-all-of/merge-required.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaObject } from './types.js';
+export declare const containsRequired: (first: SchemaObject, second: SchemaObject) => boolean;
+export declare const mergeRequired: (first: SchemaObject, second: SchemaObject) => SchemaObject | undefined;

package/esm/parse/v3-2/_merge-all-of/merge-required.js

@@ -0,0 +1,10 @@
+export const containsRequired = (first, second) => {
+    return Boolean(first.required || second.required);
+};
+export const mergeRequired = (first, second) => {
+    if (containsRequired(first, second)) {
+        return {
+            required: [...(first.required ?? []), ...(second.required ?? [])]
+        };
+    }
+};

package/esm/parse/v3-2/_merge-all-of/merge-string-constraints.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { GetRefFn } from './types.js';
+export declare function mergeStringConstraints(first: OpenAPIV3.SchemaObject, second: OpenAPIV3.SchemaObject, getRef: GetRefFn): OpenAPIV3.SchemaObject;

package/esm/parse/v3-2/_merge-all-of/merge-string-constraints.js

@@ -0,0 +1,55 @@
+import { genericMerge } from './generic-merge.js';
+import * as v from 'valibot';
+import { checkTypeConflicts } from './check-type-conflicts.js';
+import { checkAtLeastOneTypeMatch } from './check-at-least-one-type-match.js';
+export function mergeStringConstraints(first, second, getRef) {
+    checkTypeConflicts(first, second);
+    if (!checkAtLeastOneTypeMatch(first, second, 'string')) {
+        return genericMerge(first, second, getRef);
+    }
+    // First merge enum values if present
+    const result = genericMerge(first, second, getRef, v.string());
+    // Then merge other constraints
+    result.type = 'string';
+    // Merge minLength
+    if (first.minLength !== undefined || second.minLength !== undefined) {
+        const minA = first.minLength ?? 0;
+        const minB = second.minLength ?? 0;
+        result.minLength = Math.max(minA, minB);
+    }
+    // Merge maxLength
+    if (first.maxLength !== undefined || second.maxLength !== undefined) {
+        const maxA = first.maxLength ?? Infinity;
+        const maxB = second.maxLength ?? Infinity;
+        result.maxLength = Math.min(maxA, maxB);
+    }
+    // Merge pattern
+    if (first.pattern !== undefined && second.pattern !== undefined) {
+        // If both have patterns, they must match
+        if (first.pattern !== second.pattern) {
+            throw new Error(`Cannot merge schemas: conflicting patterns '${first.pattern}' and '${second.pattern}'`);
+        }
+        result.pattern = first.pattern;
+    }
+    else if (first.pattern !== undefined) {
+        result.pattern = first.pattern;
+    }
+    else if (second.pattern !== undefined) {
+        result.pattern = second.pattern;
+    }
+    // Merge format
+    if (first.format !== undefined && second.format !== undefined) {
+        // If both have formats, they must match
+        if (first.format !== second.format) {
+            throw new Error('Incompatible string formats');
+        }
+        result.format = first.format;
+    }
+    else if (first.format !== undefined) {
+        result.format = first.format;
+    }
+    else if (second.format !== undefined) {
+        result.format = second.format;
+    }
+    return result;
+}

package/esm/parse/v3-2/_merge-all-of/merge-union.d.ts

@@ -0,0 +1,15 @@
+import type { GetRefFn, SchemaOrReference, SchemaObject } from './types.js';
+type MergeUnionArgs = {
+    schema: SchemaObject;
+    getRef: GetRefFn;
+    groupType: 'oneOf' | 'anyOf';
+};
+export declare const mergeUnion: ({ schema, getRef, groupType }: MergeUnionArgs) => SchemaOrReference;
+type MergeCrossProductArgs = {
+    first: SchemaObject;
+    second: SchemaObject;
+    getRef: GetRefFn;
+    groupType: 'oneOf' | 'anyOf';
+};
+export declare const mergeCrossProduct: ({ first, second, getRef, groupType }: MergeCrossProductArgs) => SchemaObject;
+export {};

package/esm/parse/v3-2/_merge-all-of/merge-union.js

@@ -0,0 +1,53 @@
+import { decomposeUnion } from './decompose-union.js';
+import { mergeSchemasOrRefs } from './merge.js';
+import { crossProduct } from './cross-product.js';
+import { isRef } from '../../../helpers/refFns.js';
+export const mergeUnion = ({ schema, getRef, groupType }) => {
+    const { beforeExcluded, decomposed, afterExcluded } = decomposeUnion({ schema, groupType });
+    // if (decomposed.length === 1) {
+    //   console.log('DECOMPOSED', JSON.stringify(decomposed[0], null, 2))
+    //   const result = {
+    //     ...beforeExcluded,
+    //     ...decomposed[0],
+    //     ...afterExcluded
+    //   }
+    //   console.log('MERGED UNION - SHORT', JSON.stringify(result, null, 2))
+    //   return result
+    // }
+    const dereffed = decomposed.map(decomposed => {
+        return '$ref' in decomposed ? getRef(decomposed) : decomposed;
+    });
+    const result = dereffed.reduce((acc, decomposed) => {
+        const merged = mergeCrossProduct({ first: acc, second: decomposed, getRef, groupType });
+        return merged;
+    }, {});
+    const output = {
+        ...beforeExcluded,
+        ...result,
+        ...afterExcluded
+    };
+    return output;
+};
+export const mergeCrossProduct = ({ first, second, getRef, groupType }) => {
+    const firstGroup = Array.isArray(first[groupType]) ? first[groupType] : [first];
+    const secondGroup = Array.isArray(second[groupType]) ? second[groupType] : [second];
+    const mergedGroup = crossProduct(firstGroup, secondGroup)
+        .map(([firstItem, secondItem]) => {
+        try {
+            const result = mergeSchemasOrRefs(firstItem, secondItem, getRef);
+            return result;
+        }
+        catch (_error) {
+            return undefined;
+        }
+    })
+        .filter(item => item !== undefined);
+    return {
+        [groupType]: mergedGroup.flatMap(item => {
+            if (!isRef(item) && Array.isArray(item[groupType])) {
+                return item[groupType];
+            }
+            return [item];
+        })
+    };
+};

package/esm/parse/v3-2/_merge-all-of/merge.d.ts

@@ -0,0 +1,2 @@
+import type { SchemaOrReference, GetRefFn } from './types.js';
+export declare const mergeSchemasOrRefs: (first: SchemaOrReference, second: SchemaOrReference, getRef: GetRefFn) => SchemaOrReference;

package/esm/parse/v3-2/_merge-all-of/merge.js

@@ -0,0 +1,155 @@
+import { isRef } from '../../../helpers/refFns.js';
+import { checkTypeConflicts } from './check-type-conflicts.js';
+import { checkReadOnlyWriteOnlyConflicts } from './check-read-only-write-only-conflicts.js';
+import { checkFormatConflicts } from './check-format-conflicts.js';
+import { checkEnumConflicts } from './check-enum-conflicts.js';
+import { checkNumberConstraintsConflicts } from './check-number-constraints-conflicts.js';
+import { checkArrayItemTypeConflicts } from './check-array-item-type-conflicts.js';
+import { mergeObjectConstraints } from './merge-object-constraints.js';
+import { mergeArrayConstraints } from './merge-array-constraints.js';
+import { mergeStringConstraints } from './merge-string-constraints.js';
+import { mergeNumberConstraints } from './merge-number-constraints.js';
+import { mergeIntegerConstraints } from './merge-integer-constraints.js';
+import { mergeBooleanConstraints } from './merge-boolean-constraints.js';
+import { genericMerge } from './generic-merge.js';
+import { checkAtLeastOneTypeMatch } from './check-at-least-one-type-match.js';
+import { mergeIntersection } from './merge-intersection.js';
+import { mergeCrossProduct } from './merge-union.js';
+import { isEmpty } from '../../../helpers/isEmpty.js';
+import { isNullOnly, mergeNullOnly } from './nullable-merge.js';
+export const mergeSchemasOrRefs = (first, second, getRef) => {
+    if (containsRef(first, second)) {
+        return mergeWithRef(first, second, getRef);
+    }
+    if (isRef(first)) {
+        throw new Error('Ref in first');
+    }
+    if (isRef(second)) {
+        throw new Error('Ref in second');
+    }
+    if (containsAllOf(first) || containsAllOf(second)) {
+        const mergedFirst = containsAllOf(first) ? mergeIntersection({ schema: first, getRef }) : first;
+        const mergedSecond = containsAllOf(second)
+            ? mergeIntersection({ schema: second, getRef })
+            : second;
+        return mergeSchemasOrRefs(mergedFirst, mergedSecond, getRef);
+    }
+    if (containsOneOf(first, second)) {
+        return mergeCrossProduct({ first, second, getRef, groupType: 'oneOf' });
+    }
+    if (containsAnyOf(first, second)) {
+        return mergeCrossProduct({ first, second, getRef, groupType: 'anyOf' });
+    }
+    if (isNullOnly(first)) {
+        return mergeNullOnly(second);
+    }
+    if (isNullOnly(second)) {
+        return mergeNullOnly(first);
+    }
+    return mergeSchemas(first, second, getRef);
+};
+const containsAllOf = (schema) => {
+    if (schema.allOf) {
+        if (schema.allOf?.length) {
+            return true;
+        }
+        throw new Error('Empty allOf');
+    }
+    return false;
+};
+const containsAnyOf = (first, second) => {
+    if (first.anyOf) {
+        if (first.anyOf?.length) {
+            return true;
+        }
+        throw new Error('Empty anyOf');
+    }
+    if (second.anyOf) {
+        if (second.anyOf?.length) {
+            return true;
+        }
+        throw new Error('Empty anyOf');
+    }
+    return false;
+};
+const containsOneOf = (first, second) => {
+    if (first.oneOf) {
+        if (first.oneOf?.length) {
+            return true;
+        }
+        throw new Error('Empty oneOf');
+    }
+    if (second.oneOf) {
+        if (second.oneOf?.length) {
+            return true;
+        }
+        throw new Error('Empty oneOf');
+    }
+    return false;
+};
+const containsRef = (first, second) => {
+    return isRef(first) || isRef(second);
+};
+const mergeSchemas = (first, second, getRef) => {
+    try {
+        checkTypeConflicts(first, second);
+    }
+    catch (e) {
+        throw e;
+    }
+    checkReadOnlyWriteOnlyConflicts(first, second);
+    checkFormatConflicts(first, second);
+    checkEnumConflicts(first, second);
+    checkNumberConstraintsConflicts(first, second);
+    checkArrayItemTypeConflicts(first, second);
+    if (first.not || second.not) {
+        throw new Error('Merging schemas with "not" keyword is not supported');
+    }
+    return typedMerge(first, second, getRef);
+};
+const typedMerge = (first, second, getRef) => {
+    if (!first.type && !second.type) {
+        return genericMerge(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'object')) {
+        return mergeObjectConstraints(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'array')) {
+        return mergeArrayConstraints(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'string')) {
+        return mergeStringConstraints(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'number')) {
+        return mergeNumberConstraints(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'integer')) {
+        return mergeIntegerConstraints(first, second, getRef);
+    }
+    if (checkAtLeastOneTypeMatch(first, second, 'boolean')) {
+        return mergeBooleanConstraints(first, second, getRef);
+    }
+    throw new Error(`Cannot merge schemas with type "${first.type}" with type "${second.type}"`);
+};
+const mergeWithRef = (first, second, getRef) => {
+    if (isRef(first) && isRef(second)) {
+        if (first.$ref === second.$ref) {
+            return {
+                ...first,
+                ...second
+            };
+        }
+        else {
+            return mergeSchemas(getRef(first), getRef(second), getRef);
+        }
+    }
+    if (isRef(first) && !isRef(second)) {
+        const merged = isEmpty(second) ? first : mergeSchemas(getRef(first), second, getRef);
+        return merged;
+    }
+    if (!isRef(first) && isRef(second)) {
+        const merged = isEmpty(first) ? second : mergeSchemas(first, getRef(second), getRef);
+        return merged;
+    }
+    throw new Error('Invalid input');
+};

package/esm/parse/v3-2/_merge-all-of/nullable-merge.d.ts

@@ -0,0 +1,3 @@
+import type { OpenAPIV3 } from 'openapi-types';
+export declare const mergeNullOnly: (schema: OpenAPIV3.SchemaObject) => OpenAPIV3.SchemaObject;
+export declare const isNullOnly: (schema: OpenAPIV3.SchemaObject) => boolean;

package/esm/parse/v3-2/_merge-all-of/nullable-merge.js

@@ -0,0 +1,12 @@
+import { isEmpty } from '../../../helpers/isEmpty.js';
+export const mergeNullOnly = (schema) => {
+    if (schema.enum && !schema.enum.includes(null)) {
+        schema.enum.push(null);
+    }
+    schema.nullable = true;
+    return schema;
+};
+export const isNullOnly = (schema) => {
+    const { type: _type, nullable, enum: enumValues, ...rest } = schema;
+    return (Boolean(nullable) && enumValues?.length === 1 && enumValues[0] === null && isEmpty(rest ?? {}));
+};

package/esm/parse/v3-2/_merge-all-of/types.d.ts

@@ -0,0 +1,14 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import * as v from 'valibot';
+export type GetRefFn = (ref: OpenAPIV3.ReferenceObject) => OpenAPIV3.SchemaObject;
+export type OneOfObject = {
+    oneOf?: (OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject)[];
+} & OpenAPIV3.SchemaObject;
+export type AnyOfObject = {
+    anyOf?: (OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject)[];
+} & OpenAPIV3.SchemaObject;
+export type SchemaObject = OpenAPIV3.SchemaObject;
+export type ReferenceObject = OpenAPIV3.ReferenceObject;
+export type SchemaOrReference = SchemaObject | ReferenceObject;
+export type ArraySchemaObject = OpenAPIV3.ArraySchemaObject;
+export declare const IntegerSchema: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, "The number must be an integer.">]>;

package/esm/parse/v3-2/_merge-all-of/types.js

@@ -0,0 +1,2 @@
+import * as v from 'valibot';
+export const IntegerSchema = v.pipe(v.number(), v.integer('The number must be an integer.'));

package/esm/parse/v3-2/array/toArray.d.ts

@@ -0,0 +1,80 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import { OasArray } from '../../../oas/array/Array.js';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToArrayArgs = {
+    value: OpenAPIV3.ArraySchemaObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+/**
+ * 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, stackTrail }: ToArrayArgs) => OasArray;
+type ToParsedArrayArgs<Nullable extends boolean | undefined> = {
+    value: Omit<OpenAPIV3.ArraySchemaObject, 'nullable' | 'example' | 'enums' | 'default'>;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+    nullable: Nullable;
+    example: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
+    enums: Nullable extends true ? (unknown[] | null)[] | undefined : unknown[] | undefined;
+    defaultValue: Nullable extends true ? unknown[] | null | undefined : unknown[] | undefined;
+};
+export declare const toParsedArray: <Nullable extends boolean | undefined>({ context, stackTrail, nullable, example, enums, defaultValue, value }: ToParsedArrayArgs<Nullable>) => OasArray<Nullable>;
+export {};

package/esm/parse/v3-2/array/toArray.js

@@ -0,0 +1,165 @@
+import { OasArray } from '../../../oas/array/Array.js';
+import { toSchemaV3 } from '../schema/toSchemasV3.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { parseNullable } from '../_helpers/parseNullable.js';
+import { parseEnum } from '../_helpers/parseEnum.js';
+import { parseExample } from '../_helpers/parseExample.js';
+import { parseDefault } from '../_helpers/parseDefault.js';
+import * as v from 'valibot';
+import { oasArrayDataWithoutItems } from '../../../oas/array/array-types.js';
+/**
+ * Transforms an OpenAPI v3 array schema object into an internal OAS array representation.
+ *
+ * This function processes OpenAPI array schemas by extracting and parsing nullable values,
+ * examples, enumerations, and default values. It handles the complete transformation from
+ * raw OpenAPI JSON to the SKMTC internal array representation with proper type safety.
+ *
+ * The transformation follows a pipeline approach:
+ * 1. Parse nullable flag and extract base value
+ * 2. Parse example values with nullable support
+ * 3. Parse enumeration constraints
+ * 4. Parse default values
+ * 5. Create final OasArray instance
+ *
+ * @param args - Transformation arguments
+ * @param args.value - The OpenAPI v3 array schema object to transform
+ * @param args.context - Parse context providing utilities and tracing
+ * @returns Transformed OAS array object with parsed properties
+ *
+ * @example Basic array transformation
+ * ```typescript
+ * import { toArray } from '@skmtc/core';
+ *
+ * const openApiArray = {
+ *   type: 'array',
+ *   items: { type: 'string' },
+ *   maxItems: 10,
+ *   uniqueItems: true
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: openApiArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.maxItems); // 10
+ * console.log(oasArray.uniqueItems); // true
+ * ```
+ *
+ * @example Array with nullable and examples
+ * ```typescript
+ * const complexArray = {
+ *   type: 'array',
+ *   items: { type: 'number' },
+ *   nullable: true,
+ *   example: [1, 2, 3],
+ *   default: [],
+ *   enum: [[1, 2], [3, 4], null]
+ * };
+ *
+ * const oasArray = toArray({
+ *   value: complexArray,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasArray.nullable); // true
+ * console.log(oasArray.example); // [1, 2, 3]
+ * ```
+ */
+export const toArray = ({ value, context, stackTrail }) => {
+    const { nullable, value: valueWithoutNullable } = parseNullable({
+        value,
+        context,
+        stackTrail
+    });
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        value: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable,
+        check: isArray,
+        toMessage: item => `Removed invalid example. Expected "array", got: ${item}`,
+        stackTrail
+    });
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
+        nullable,
+        stackTrail,
+        parent: valueWithoutExample,
+        context,
+        check: Array.isArray,
+        toMessage: item => `Removed invalid enum. Expected "array", got: ${item}`
+    });
+    const { default: unparsedDefaultValue, ...valueWithoutDefault } = valueWithoutEnums;
+    const defaultValue = parseDefault({
+        value: unparsedDefaultValue,
+        context,
+        parent: valueWithoutEnums,
+        nullable,
+        check: isArray,
+        toMessage: item => `Removed invalid default. Expected "array", got: ${item}`,
+        stackTrail
+    });
+    return toParsedArray({
+        context,
+        nullable,
+        example,
+        enums,
+        defaultValue,
+        stackTrail,
+        value: valueWithoutDefault
+    });
+};
+export const toParsedArray = ({ context, stackTrail, nullable, example, enums, defaultValue, value }) => {
+    // We only want parse non-items fields here since items is handled below
+    const { items, ...rest } = value;
+    // Parse the object without items field
+    if (!v.is(oasArrayDataWithoutItems, rest)) {
+        v.parse(oasArrayDataWithoutItems, rest);
+    }
+    const { type: _type, title, description, uniqueItems, maxItems, minItems, readOnly, writeOnly, deprecated, ...skipped } = rest;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: value,
+        context,
+        stackTrail,
+        parentType: 'schema:array'
+    });
+    return context.withStackTrail(stackTrail, () => new OasArray({
+        title,
+        description,
+        nullable,
+        defaultValue,
+        items: stackTrail.trace('items', st => {
+            // An array schema with no `items` is invalid OAS but must not
+            // kill the run (fail open): log the issue and treat the items
+            // as unknown — `{}` falls through toSchemaV3 to OasUnknown.
+            if (items === undefined) {
+                context.logIssue({
+                    key: 'items',
+                    level: 'warning',
+                    message: 'Array schema has no "items" — treating as an array of unknown values',
+                    parent: value,
+                    stackTrail: st,
+                    type: 'INVALID_SCHEMA'
+                });
+                return toSchemaV3({ schema: {}, stackTrail: st, context });
+            }
+            return toSchemaV3({ schema: items, stackTrail: st, context });
+        }),
+        extensionFields,
+        example,
+        uniqueItems,
+        maxItems,
+        minItems,
+        enums,
+        readOnly,
+        writeOnly,
+        deprecated
+    }, context));
+};
+const isArray = (value) => {
+    return Array.isArray(value);
+};