@cleverbrush/schema 2.0.0 → 3.0.1

package/dist/chunk-ZUPYV5TI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/builders/UnionSchemaBuilder.ts"],"sourcesContent":["import type {\n    ObjectSchemaBuilder,\n    ObjectSchemaValidationResult\n} from './ObjectSchemaBuilder.js';\nimport {\n    type BRAND,\n    createHybridErrorArray,\n    type InferType,\n    type NestedValidationResult,\n    type PropertyDescriptor,\n    SchemaBuilder,\n    SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype UnionSchemaBuilderCreateProps<\n    T extends readonly SchemaBuilder<any, any, any, any, any>[],\n    R extends boolean = true\n> = Partial<ReturnType<UnionSchemaBuilder<T, R>['introspect']>>;\n\n/**\n * Mapped tuple type that converts a tuple of SchemaBuilder options into\n * a tuple of their corresponding validation results.\n * Union schema options get `UnionSchemaValidationResult` with recursive\n * `getNestedErrors` navigation; object schema options get\n * `ObjectSchemaValidationResult`; other types get `ValidationResult`.\n */\nexport type OptionValidationResults<\n    TOptions extends readonly SchemaBuilder<any, any, any, any, any>[]\n> = {\n    [K in keyof TOptions]: TOptions[K] extends UnionSchemaBuilder<\n        infer UOptions extends readonly SchemaBuilder<\n            any,\n            any,\n            any,\n            any,\n            any\n        >[],\n        any,\n        any\n    >\n        ? UnionSchemaValidationResult<InferType<TOptions[K]>, UOptions>\n        : TOptions[K] extends ObjectSchemaBuilder<any, any, any, any>\n          ? ObjectSchemaValidationResult<InferType<TOptions[K]>, TOptions[K]>\n          : ValidationResult<InferType<TOptions[K]>>;\n};\n\n/**\n * Validation result type returned by `UnionSchemaBuilder.validate()`.\n * Extends `ValidationResult` with:\n * - `getNestedErrors` for root-level union errors and per-branch validation results\n */\nexport type UnionSchemaValidationResult<\n    T,\n    TOptions extends readonly SchemaBuilder<any, any, any, any, any>[]\n> = ValidationResult<T> & {\n    /**\n     * Returns root-level union validation errors combined with\n     * per-branch validation results.\n     * The returned value has both `NestedValidationResult` properties\n     * (`errors`, `isValid`, `descriptor`, `seenValue`) and tuple-indexed\n     * branch results (`[0]`, `[1]`, etc.).\n     */\n    getNestedErrors(): OptionValidationResults<TOptions> &\n        NestedValidationResult<any, any, any>;\n};\n\ntype SchemaArrayToUnion<\n    TArr extends readonly SchemaBuilder<any, any, any, any, any>[]\n> = TArr['length'] extends 1\n    ? InferType<TArr[0]>\n    : TArr extends readonly [\n            infer TFirst extends SchemaBuilder<any, any, any, any, any>,\n            ...infer TRest extends SchemaBuilder<any, any, any, any, any>[]\n        ]\n      ? InferType<TFirst> | SchemaArrayToUnion<[...TRest]>\n      : never;\n\ntype TakeBeforeIndex<\n    TArr extends readonly SchemaBuilder<any, any, any, any, any>[],\n    TIndex extends number\n> = TArr extends [\n    ...infer TRest extends SchemaBuilder<any, any, any, any, any>[],\n    infer _ extends SchemaBuilder<any, any, any, any, any>\n]\n    ? TRest['length'] extends TIndex\n        ? TRest\n        : TakeBeforeIndex<TRest, TIndex>\n    : never;\n\ntype TakeAfterIndex<\n    TArr extends readonly SchemaBuilder<any, any, any, any, any>[],\n    TIndex extends number,\n    TAcc extends readonly SchemaBuilder<any, any, any, any, any>[] = []\n> = TArr extends [\n    ...infer TRest extends SchemaBuilder<any, any, any, any, any>[],\n    infer TLast extends SchemaBuilder<any, any, any, any, any>\n]\n    ? TRest['length'] extends TIndex\n        ? TAcc\n        : TakeAfterIndex<TRest, TIndex, [TLast, ...TAcc]>\n    : never;\n\ntype TakeExceptIndex<\n    TArr extends readonly SchemaBuilder<any, any, any, any, any>[],\n    TIndex extends number\n> = [...TakeBeforeIndex<TArr, TIndex>, ...TakeAfterIndex<TArr, TIndex>];\n\n/**\n * Union schema builder class. Allows to create schemas\n * containing alternatives. E.g. string | number | Date.\n * Use it when you want to define a schema for a value\n * that can be of different types. The type of the value\n * will be determined by the first schema that succeeds\n * validation. Any schema type can be supplied as variant.\n * Which means that you are not limited to primitive types and\n * can construct complex types as well, e.g. object | array.\n *\n * **NOTE** this class is exported only to give opportunity to extend it\n * by inheriting. It is not recommended to create an instance of this class\n * directly. Use {@link union | union()} function instead.\n *\n * @example\n * ```ts\n * const schema = union(string('foo')).or(string('bar'));\n * const result = schema.validate('foo');\n * // result.valid === true\n * // result.object === 'foo'\n * ```\n *\n * @example\n * ```ts\n * const schema = union(string('foo')).or(string('bar'));\n * const result = schema.validate('baz');\n * // result.valid === false\n * ```\n *\n * @example\n * ```ts\n * const schema = union(string('yes')).or(string('no')).or(number(0)).or(number(1));\n * // equals to 'yes' | 'no' | 0 | 1 in TS\n * const result = schema.validate('yes');\n * // result.valid === true\n * // result.object === 'yes'\n *\n * const result2 = schema.validate(0);\n * // result2.valid === true\n * // result2.object === 0\n *\n * const result3 = schema.validate('baz');\n * // result3.valid === false\n *\n * const result4 = schema.validate(2);\n * // result4.valid === false\n * ```\n *\n * @see {@link union}\n */\nexport class UnionSchemaBuilder<\n    TOptions extends readonly SchemaBuilder<any, any, any, any, any>[],\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<\n    TExplicitType extends undefined\n        ? SchemaArrayToUnion<TOptions>\n        : TExplicitType,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #options!: TOptions;\n    #discriminatorKey: string | null = null;\n    #discriminatorMap: Map<\n        string | number,\n        SchemaBuilder<any, any, any, any, any>\n    > | null = null;\n\n    /**\n     * @hidden\n     */\n    public static create(props: UnionSchemaBuilderCreateProps<any>) {\n        return new UnionSchemaBuilder({\n            type: 'union',\n            ...props\n        });\n    }\n\n    protected constructor(\n        props: UnionSchemaBuilderCreateProps<TOptions, TRequired>\n    ) {\n        super(props as any);\n\n        if (Array.isArray(props.options)) {\n            this.#options = props.options;\n            this.#detectDiscriminator();\n        }\n    }\n\n    /**\n     * Attempts to detect a discriminator property shared by all union options.\n     * If all options are object schemas with a common required string/number\n     * property that uses `equalsTo` with unique literal values, builds a Map\n     * for O(1) dispatch.\n     */\n    #detectDiscriminator() {\n        const options = this.#options;\n        if (!options || options.length < 2) return;\n\n        // All options must be object schemas\n        const introspected: Array<{\n            type: string;\n            isRequired: boolean;\n            properties?: Record<string, SchemaBuilder<any, any, any, any, any>>;\n            [k: string]: any;\n        }> = [];\n        for (const option of options) {\n            const info = option.introspect();\n            if (info.type !== 'object') return;\n            introspected.push(info);\n        }\n\n        // Find common property keys\n        const firstProps = introspected[0].properties;\n        if (!firstProps) return;\n\n        for (const key of Object.keys(firstProps)) {\n            const map = new Map<\n                string | number,\n                SchemaBuilder<any, any, any, any, any>\n            >();\n            let isDiscriminator = true;\n\n            for (let i = 0; i < introspected.length; i++) {\n                const props = introspected[i].properties;\n                if (!props || !(key in props)) {\n                    isDiscriminator = false;\n                    break;\n                }\n\n                const propSchema = props[key];\n                const propInfo = propSchema.introspect();\n\n                // Must be a required string or number with equalsTo\n                if (propInfo.isRequired !== true) {\n                    isDiscriminator = false;\n                    break;\n                }\n\n                const equalsTo = (propInfo as any).equalsTo;\n                if (equalsTo === undefined || equalsTo === null) {\n                    isDiscriminator = false;\n                    break;\n                }\n\n                if (\n                    typeof equalsTo !== 'string' &&\n                    typeof equalsTo !== 'number'\n                ) {\n                    isDiscriminator = false;\n                    break;\n                }\n\n                // Check for duplicate discriminator values\n                if (map.has(equalsTo)) {\n                    isDiscriminator = false;\n                    break;\n                }\n\n                map.set(equalsTo, options[i]);\n            }\n\n            if (isDiscriminator && map.size === options.length) {\n                this.#discriminatorKey = key;\n                this.#discriminatorMap = map;\n                return;\n            }\n        }\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * Array of schemas participating in the union.\n             */\n            options: this.#options\n        };\n    }\n\n    /**\n     * Null is a legitimate JavaScript value that a union option (e.g.\n     * `NullSchemaBuilder`) may accept. Override the base-class behaviour so\n     * that a required union does **not** reject `null` during pre-validation;\n     * instead, each option gets the opportunity to validate it.\n     * @override\n     */\n    protected override get isNullRequiredViolation(): boolean {\n        return false;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): UnionSchemaBuilder<\n        TOptions,\n        true,\n        TNullable,\n        T,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public clearHasType(): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    #createValidationSetup(\n        object: any,\n        superResult: ReturnType<UnionSchemaBuilder<any>['preValidateSync']>\n    ) {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            context: prevalidationContext,\n            errors\n        } = superResult;\n\n        // Create a self-referencing property descriptor for the union root\n        const selfDescriptor: PropertyDescriptor<any, any, any> = {\n            [SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]: {\n                setValue: () => false,\n                getValue: (obj: any) => ({\n                    success: true,\n                    value: obj\n                }),\n                getSchema: () => this,\n                parent: undefined\n            }\n        };\n\n        // Root error state\n        const rootErrors: string[] = [];\n\n        const optionResults = createHybridErrorArray(\n            [] as any[],\n            () => object,\n            () => rootErrors,\n            () => selfDescriptor[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n        );\n\n        const getNestedErrors = (() => optionResults) as any;\n\n        if (!valid) {\n            rootErrors.push(\n                ...(errors || []).map((e: any) => e.message || String(e))\n            );\n            return {\n                needsOptionValidation: false as const,\n                result: { valid, errors, getNestedErrors } as any\n            };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        if (\n            (typeof objToValidate === 'undefined' && !this.isRequired) ||\n            (objToValidate === null && (!this.isRequired || this.isNullable))\n        ) {\n            return {\n                needsOptionValidation: false as const,\n                result: {\n                    valid: true,\n                    object: objToValidate,\n                    getNestedErrors\n                } as any\n            };\n        }\n\n        return {\n            needsOptionValidation: true as const,\n            objToValidate,\n            prevalidationContext,\n            preValidationTransaction: preValidationTransaction!,\n            getNestedErrors,\n            optionResults,\n            rootErrors\n        };\n    }\n\n    #processOptionResult(\n        optionResult: any,\n        index: number,\n        optionResults: any,\n        preValidationTransaction: any,\n        state: {\n            objToValidate: any;\n            minErrorsCount: number;\n            resultingErrors: any[];\n        },\n        getNestedErrors: any\n    ): any | null {\n        optionResults[index] = optionResult;\n\n        if (optionResult.valid) {\n            return {\n                valid: true,\n                object: optionResult.object as any,\n                getNestedErrors\n            };\n        }\n\n        const optErrors = optionResult.errors;\n        if (\n            Array.isArray(optErrors) &&\n            optErrors.length > 0 &&\n            optErrors.length < state.minErrorsCount\n        ) {\n            state.resultingErrors = optErrors as any;\n            state.minErrorsCount = optErrors.length;\n        }\n\n        state.objToValidate =\n            preValidationTransaction.rollback().validatedObject;\n        return null;\n    }\n\n    /**\n     * Performs synchronous validation of the union schema over `object`. {@inheritDoc SchemaBuilder.validate}\n     */\n    public validate(\n        object: TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        context?: ValidationContext\n    ): UnionSchemaValidationResult<\n        TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        TOptions\n    > {\n        return super.validate(object, context) as any;\n    }\n\n    /**\n     * Performs async validation of the union schema over `object`. {@inheritDoc SchemaBuilder.validateAsync}\n     */\n    public async validateAsync(\n        object: TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        context?: ValidationContext\n    ): Promise<\n        UnionSchemaValidationResult<\n            TExplicitType extends undefined\n                ? SchemaArrayToUnion<TOptions>\n                : TExplicitType,\n            TOptions\n        >\n    > {\n        return super.validateAsync(object, context) as any;\n    }\n\n    /**\n     * Performs synchronous validation of the union schema over `object`.\n     * Throws if any preprocessor, validator, or error message provider returns a Promise.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected _validate(\n        object: TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        context?: ValidationContext\n    ): UnionSchemaValidationResult<\n        TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        TOptions\n    > {\n        // Fast path: skip preValidateSync + createValidationSetup when\n        // there are no preprocessors/validators and context is default.\n        if (\n            this.canSkipPreValidation &&\n            !context?.doNotStopOnFirstError &&\n            !context?.rootPropertyDescriptor\n        ) {\n            // Required / optional check.\n            // `undefined` is the canonical \"missing value\" signal — handle it\n            // exactly as before (default, optional valid, required error).\n            // `null` is a legitimate JavaScript value: for optional unions it is\n            // valid without consulting options (original behaviour); for required\n            // unions we fall through to option-checking so that a\n            // NullSchemaBuilder option can accept it.\n            if (typeof object === 'undefined') {\n                if (this.hasDefault) {\n                    object = this.resolveDefaultValue();\n                } else if (!this.isRequired) {\n                    return this.#fastResult(\n                        true,\n                        object,\n                        undefined,\n                        object,\n                        context\n                    );\n                } else {\n                    return this.#fastResult(\n                        false,\n                        undefined,\n                        [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object as any\n                                )\n                            }\n                        ],\n                        object,\n                        context\n                    );\n                }\n            } else if (\n                object === null &&\n                (!this.isRequired || this.isNullable)\n            ) {\n                // Optional union: null is valid without checking options.\n                return this.#fastResult(\n                    true,\n                    object,\n                    undefined,\n                    object,\n                    context\n                );\n            }\n            // null + required union: fall through to option checking below.\n\n            // Discriminated union: O(1) lookup, no setup overhead\n            if (this.#discriminatorKey && this.#discriminatorMap) {\n                if (typeof object === 'object' && object !== null) {\n                    const discriminatorValue = (object as any)[\n                        this.#discriminatorKey\n                    ];\n                    const matchedSchema =\n                        this.#discriminatorMap.get(discriminatorValue);\n                    if (matchedSchema) {\n                        const optionResult = matchedSchema.validate(\n                            object as any\n                        );\n                        return this.#fastResult(\n                            optionResult.valid,\n                            optionResult.valid\n                                ? optionResult.object\n                                : undefined,\n                            optionResult.valid\n                                ? undefined\n                                : optionResult.errors,\n                            object,\n                            context\n                        );\n                    }\n                    // Discriminator value not in map — no option matches\n                    return this.#fastResult(\n                        false,\n                        undefined,\n                        [\n                            {\n                                message:\n                                    \"value doesn't match any option in union schema\"\n                            }\n                        ],\n                        object,\n                        context\n                    );\n                }\n            }\n\n            // Non-discriminated union: try options sequentially, no transaction overhead\n            if (!this.#discriminatorKey) {\n                const options = this.#options;\n                let minErrorsCount = Number.MAX_SAFE_INTEGER;\n                let resultingErrors: any[] = [];\n\n                for (let i = 0; i < options.length; i++) {\n                    const optionResult = options[i].validate(object as any);\n                    if (optionResult.valid) {\n                        return this.#fastResult(\n                            true,\n                            optionResult.object,\n                            undefined,\n                            object,\n                            context\n                        );\n                    }\n\n                    const optErrors = optionResult.errors;\n                    if (\n                        Array.isArray(optErrors) &&\n                        optErrors.length > 0 &&\n                        optErrors.length < minErrorsCount\n                    ) {\n                        resultingErrors = optErrors as any;\n                        minErrorsCount = optErrors.length;\n                    }\n                }\n\n                return this.#fastResult(\n                    false,\n                    undefined,\n                    resultingErrors,\n                    object,\n                    context\n                );\n            }\n        }\n\n        return this.#validateFull(object, context) as any;\n    }\n\n    /**\n     * Build a fast-path result with a lazy `getNestedErrors` that\n     * defers to the full validation only when actually called.\n     */\n    #fastResult(\n        valid: boolean,\n        obj: any,\n        errors: any[] | undefined,\n        originalObject: any,\n        context: ValidationContext | undefined\n    ): any {\n        const self = this;\n        if (valid) {\n            return {\n                valid: true,\n                object: obj,\n                getNestedErrors() {\n                    return self\n                        .#validateFull(originalObject, context)\n                        .getNestedErrors();\n                }\n            };\n        }\n        return {\n            valid: false,\n            errors,\n            getNestedErrors() {\n                return self\n                    .#validateFull(originalObject, context)\n                    .getNestedErrors();\n            }\n        };\n    }\n\n    #validateFull(\n        object: any,\n        context?: ValidationContext\n    ): UnionSchemaValidationResult<any, any> {\n        const setup = this.#createValidationSetup(\n            object,\n            this.preValidateSync(object, context)\n        );\n\n        if (!setup.needsOptionValidation) return setup.result;\n\n        const {\n            prevalidationContext,\n            preValidationTransaction,\n            getNestedErrors,\n            optionResults,\n            rootErrors\n        } = setup;\n\n        // Fast path: discriminated union with O(1) lookup\n        if (this.#discriminatorKey && this.#discriminatorMap) {\n            const obj = setup.objToValidate;\n            if (typeof obj === 'object' && obj !== null) {\n                const discriminatorValue = obj[this.#discriminatorKey];\n                const matchedSchema =\n                    this.#discriminatorMap.get(discriminatorValue);\n                if (matchedSchema) {\n                    const optionResult = matchedSchema.validate(obj, {\n                        ...prevalidationContext,\n                        currentPropertyDescriptor: undefined,\n                        rootPropertyDescriptor: undefined\n                    } as any);\n                    if (optionResult.valid) {\n                        return {\n                            valid: true,\n                            object: optionResult.object as any,\n                            getNestedErrors\n                        };\n                    }\n                }\n            }\n        }\n\n        const state = {\n            objToValidate: setup.objToValidate,\n            minErrorsCount: Number.MAX_SAFE_INTEGER,\n            resultingErrors: [] as any[]\n        };\n\n        for (let i = 0; i < this.#options.length; i++) {\n            const optionResult = this.#options[i].validate(\n                state.objToValidate,\n                {\n                    ...prevalidationContext,\n                    currentPropertyDescriptor: undefined,\n                    rootPropertyDescriptor: undefined\n                } as any\n            );\n\n            const earlyReturn = this.#processOptionResult(\n                optionResult,\n                i,\n                optionResults,\n                preValidationTransaction,\n                state,\n                getNestedErrors\n            );\n            if (earlyReturn) return earlyReturn;\n        }\n\n        rootErrors.push(\"value doesn't match any option in union schema\");\n\n        return {\n            valid: false,\n            errors: state.resultingErrors,\n            getNestedErrors\n        };\n    }\n\n    /**\n     * Performs async validation of the union schema over `object`.\n     * Supports async preprocessors, validators, and error message providers.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected async _validateAsync(\n        object: TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType,\n        context?: ValidationContext\n    ): Promise<\n        UnionSchemaValidationResult<\n            TExplicitType extends undefined\n                ? SchemaArrayToUnion<TOptions>\n                : TExplicitType,\n            TOptions\n        >\n    > {\n        const setup = this.#createValidationSetup(\n            object,\n            await super.preValidateAsync(object, context)\n        );\n\n        if (!setup.needsOptionValidation) return setup.result;\n\n        const {\n            prevalidationContext,\n            preValidationTransaction,\n            getNestedErrors,\n            optionResults,\n            rootErrors\n        } = setup;\n\n        // Fast path: discriminated union with O(1) lookup\n        if (this.#discriminatorKey && this.#discriminatorMap) {\n            const obj = setup.objToValidate;\n            if (typeof obj === 'object' && obj !== null) {\n                const discriminatorValue = obj[this.#discriminatorKey];\n                const matchedSchema =\n                    this.#discriminatorMap.get(discriminatorValue);\n                if (matchedSchema) {\n                    const optionResult = await matchedSchema.validateAsync(\n                        obj,\n                        {\n                            ...prevalidationContext,\n                            currentPropertyDescriptor: undefined,\n                            rootPropertyDescriptor: undefined\n                        } as any\n                    );\n                    if (optionResult.valid) {\n                        return {\n                            valid: true,\n                            object: optionResult.object as any,\n                            getNestedErrors\n                        };\n                    }\n                }\n            }\n        }\n\n        const state = {\n            objToValidate: setup.objToValidate,\n            minErrorsCount: Number.MAX_SAFE_INTEGER,\n            resultingErrors: [] as any[]\n        };\n\n        for (let i = 0; i < this.#options.length; i++) {\n            const optionResult = await this.#options[i].validateAsync(\n                state.objToValidate,\n                {\n                    ...prevalidationContext,\n                    currentPropertyDescriptor: undefined,\n                    rootPropertyDescriptor: undefined\n                } as any\n            );\n\n            const earlyReturn = this.#processOptionResult(\n                optionResult,\n                i,\n                optionResults,\n                preValidationTransaction,\n                state,\n                getNestedErrors\n            );\n            if (earlyReturn) return earlyReturn;\n        }\n\n        rootErrors.push(\"value doesn't match any option in union schema\");\n\n        return {\n            valid: false,\n            errors: state.resultingErrors,\n            getNestedErrors\n        };\n    }\n\n    protected createFromProps<\n        T extends readonly SchemaBuilder<any, any, any, any, any>[],\n        TReq extends boolean\n    >(props: UnionSchemaBuilderCreateProps<T, TReq>): this {\n        return UnionSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): UnionSchemaBuilder<\n        TOptions,\n        true,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): UnionSchemaBuilder<\n        TOptions,\n        false,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value:\n            | (TExplicitType extends undefined\n                  ? SchemaArrayToUnion<TOptions>\n                  : TExplicitType)\n            | (() => TExplicitType extends undefined\n                  ? SchemaArrayToUnion<TOptions>\n                  : TExplicitType)\n    ): UnionSchemaBuilder<\n        TOptions,\n        true,\n        TNullable,\n        TExplicitType,\n        true,\n        TExtensions\n    > &\n        TExtensions {\n        return super.default(value as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        false,\n        TExtensions\n    > &\n        TExtensions {\n        return super.clearDefault() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public brand<TBrand extends string | symbol>(\n        _name?: TBrand\n    ): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        TNullable,\n        (TExplicitType extends undefined\n            ? SchemaArrayToUnion<TOptions>\n            : TExplicitType) & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * @hidden\n     */\n    public readonly(): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        TNullable,\n        Readonly<\n            TExplicitType extends undefined\n                ? SchemaArrayToUnion<TOptions>\n                : TExplicitType\n        >,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * Adds a new schema option described by `schema`.\n     * schema must be an instance of `SchemaBuilder` class ancestor.\n     * @param schema schema to be added as an option.\n     */\n    public or<T extends SchemaBuilder<any, any, any, any, any>>(\n        schema: T\n    ): UnionSchemaBuilder<\n        [...TOptions, T],\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (!(schema instanceof SchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the SchemaBuilder class'\n            );\n        }\n        return this.createFromProps({\n            ...this.introspect(),\n            options: [...this.#options, schema]\n        } as any) as any;\n    }\n\n    /**\n     * Removes option by its `index`. If `index` is out of bounds,\n     * an error is thrown.\n     * @param index index of the option, starting from `0`.\n     */\n    public removeOption<T extends number>(\n        index: T\n    ): UnionSchemaBuilder<\n        TakeExceptIndex<TOptions, T>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (\n            typeof index !== 'number' ||\n            index < 0 ||\n            index > this.#options.length\n        ) {\n            throw new Error('index must be >= 0 and <= count of the options');\n        }\n        return this.createFromProps({\n            ...this.introspect(),\n            options: this.#options.filter((_v, i) => i !== index)\n        } as any) as any;\n    }\n\n    /**\n     * Removes first option from the union schema.\n     */\n    public removeFirstOption(): TOptions extends [\n        infer _,\n        ...infer TRest extends SchemaBuilder<any, any, any, any, any>[]\n    ]\n        ? UnionSchemaBuilder<\n              TRest,\n              TRequired,\n              TNullable,\n              TExplicitType,\n              THasDefault,\n              TExtensions\n          > &\n              TExtensions\n        : never {\n        return this.removeOption(0) as any;\n    }\n\n    /**\n     * Removes all options and replaces them by single `schema` option.\n     * Equivalent to `union(schema)` function, but could be useful in some cases.\n     * @param schema schema to be added as a single option to the new schema.\n     */\n    public reset<T extends SchemaBuilder<any, any, any, any, any>>(\n        schema: T\n    ): UnionSchemaBuilder<\n        [T],\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (!(schema instanceof SchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the SchemaBuilder class'\n            );\n        }\n        return this.createFromProps({\n            ...this.introspect(),\n            options: [schema]\n        } as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        true,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.nullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public notNullable(): UnionSchemaBuilder<\n        TOptions,\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n}\n\n/**\n * Creates a union schema.\n * @param schema required and will be considered as a first option for the union schema.\n */\nexport const union = <T extends SchemaBuilder<any, any, any, any, any>>(\n    schema: T\n) =>\n    UnionSchemaBuilder.create({\n        isRequired: true,\n        options: [schema]\n    }) as UnionSchemaBuilder<[T]>;\n"],"mappings":"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","names":["UnionSchemaBuilder","_UnionSchemaBuilder","SchemaBuilder","#options","#discriminatorKey","#discriminatorMap","props","#detectDiscriminator","options","introspected","option","info","firstProps","key","map","isDiscriminator","i","propInfo","equalsTo","_notUsed","#createValidationSetup","object","superResult","valid","preValidationTransaction","prevalidationContext","errors","selfDescriptor","SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR","obj","rootErrors","optionResults","createHybridErrorArray","getNestedErrors","e","objToValidate","#processOptionResult","optionResult","index","state","optErrors","context","#fastResult","discriminatorValue","matchedSchema","minErrorsCount","resultingErrors","#validateFull","originalObject","self","setup","earlyReturn","errorMessage","value","_name","schema","_v","union"]}