@cleverbrush/schema 1.1.10 → 2.0.0

package/dist/chunk-KESLT5EE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/NumberSchemaBuilder.ts"],"sourcesContent":["import {\n    type BRAND,\n    type PreprocessorEntry,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult,\n    type ValidatorEntry\n} from './SchemaBuilder.js';\n\ntype NumberSchemaBuilderCreateProps<\n    T = number,\n    R extends boolean = true\n> = Partial<ReturnType<NumberSchemaBuilder<T, R, any>['introspect']>>;\n\n/**\n * Number schema builder class. Allows to create Number schemas.\n * Can be required or optional, can be restricted to be equal to a certain value,\n * can be restricted to be in a certain range, can be restricted to be integer.\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 number | number()} function instead.\n *\n * @example ```ts\n * const schema = number().equals(42);\n * const result = schema.validate(42);\n * // result.valid === true\n * // result.object === 42\n * ```\n * @example ```ts\n * const schema = number();\n * const result = schema.validate('42');\n * // result.valid === false\n * // result.errors[0].message === 'is expected to be a number'\n * ```\n * @example ```ts\n * const schema = number().min(0).max(100);\n * const result = schema.validate(42);\n * // result.valid === true\n * // result.object === 42\n * ```\n *\n * @example ```ts\n * const schema = number().min(0).max(100);\n * const result = schema.validate(142.5);\n * // result.valid === false\n * // result.errors[0].message === 'is expected to be less than or equal to 100'\n * ```\n *\n * @see {@link number}\n */\nexport class NumberSchemaBuilder<\n    TResult = number,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<\n    TResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #min?: number;\n    #defaultMinErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return `expected to be at least ${this.#min}`;\n    } as any;\n    #minErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultMinErrorMessageProvider;\n\n    #max?: number;\n    #defaultMaxErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return `expected to be no more than or equal to ${this.#max}`;\n    };\n    #maxErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultMaxErrorMessageProvider;\n\n    #equalsTo?: number;\n    #defaultEqualsToErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return `expected to be equal to ${this.#equalsTo}`;\n    };\n    #equalsToErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEqualsToErrorMessageProvider;\n\n    #ensureNotNaN = true;\n    #defaultEnsureNotNaNErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return 'is not expected to be NaN';\n    };\n    #ensureNotNaNErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEnsureNotNaNErrorMessageProvider;\n\n    #ensureIsFinite = true;\n    #defaultEnsureIsFiniteErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return 'is expected to be a finite number';\n    };\n    #ensureIsFiniteErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEnsureIsFiniteErrorMessageProvider;\n\n    #isInteger = true;\n    #defaultEnsureIsIntegerErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = function (this: NumberSchemaBuilder) {\n        return 'is expected to be an integer';\n    };\n    #ensureIsIntegerErrorMessageProvider: ValidationErrorMessageProvider<\n        NumberSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEnsureIsIntegerErrorMessageProvider;\n\n    /**\n     * @hidden\n     */\n    public static create(props: NumberSchemaBuilderCreateProps) {\n        return new NumberSchemaBuilder({\n            type: 'number',\n            ...props\n        });\n    }\n\n    protected constructor(props: NumberSchemaBuilderCreateProps) {\n        super(props as any);\n\n        if (typeof props.min === 'number') {\n            this.#min = props.min;\n        }\n\n        this.#minErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.minValidationErrorMessageProvider as any,\n                this.#defaultMinErrorMessageProvider\n            );\n\n        if (typeof props.max === 'number') {\n            this.#max = props.max;\n        }\n\n        this.#maxErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.maxValidationErrorMessageProvider as any,\n                this.#defaultMaxErrorMessageProvider\n            );\n\n        if (typeof props.ensureNotNaN === 'boolean') {\n            this.#ensureNotNaN = props.ensureNotNaN;\n        }\n\n        this.#ensureNotNaNErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.ensureNotNaNErrorMessageProvider as any,\n                this.#defaultEnsureNotNaNErrorMessageProvider\n            );\n\n        if (typeof props.ensureIsFinite === 'boolean') {\n            this.#ensureIsFinite = props.ensureIsFinite;\n        }\n\n        this.#ensureIsFiniteErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.ensureIsFiniteErrorMessageProvider as any,\n                this.#defaultEnsureIsFiniteErrorMessageProvider\n            );\n\n        if (typeof props.isInteger === 'boolean') {\n            this.#isInteger = props.isInteger;\n        }\n\n        this.#ensureIsIntegerErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.ensureIsIntegerErrorMessageProvider as any,\n                this.#defaultEnsureIsIntegerErrorMessageProvider\n            );\n\n        if (\n            typeof props.equalsTo === 'number' ||\n            typeof props.equalsTo === 'undefined'\n        ) {\n            this.#equalsTo = props.equalsTo;\n        }\n\n        this.#equalsToErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.equalsToValidationErrorMessageProvider as any,\n                this.#defaultEqualsToErrorMessageProvider\n            );\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * Min valid value (if defined).\n             */\n            min: this.#min,\n            /**\n             * Min valid value error message provider.\n             * If not provided, default error message will be used.\n             */\n            minValidationErrorMessageProvider: this.#minErrorMessageProvider,\n\n            /**\n             * Max valid value (if defined).\n             */\n            max: this.#max,\n            /**\n             * Max valid value error message provider.\n             * If not provided, default error message will be used.\n             */\n            maxValidationErrorMessageProvider: this.#maxErrorMessageProvider,\n\n            /**\n             * Make sure that object is not `NaN`. `true` by default.\n             */\n            ensureNotNaN: this.#ensureNotNaN,\n            /**\n             * EnsureNotNaN error message provider.\n             * If not provided, default error message will be used.\n             */\n            ensureNotNaNErrorMessageProvider:\n                this.#ensureNotNaNErrorMessageProvider,\n\n            /**\n             * Make sure that object is not different kinds of `infinity`. `true` by default.\n             */\n            ensureIsFinite: this.#ensureIsFinite,\n            /**\n             * EnsureIsFinite error message provider.\n             */\n            ensureIsFiniteErrorMessageProvider:\n                this.#ensureIsFiniteErrorMessageProvider,\n\n            /**\n             * If set, restrict object to be equal to a certain value.\n             */\n\n            equalsTo: this.#equalsTo,\n            /**\n             * EqualsTo error message provider.\n             * If not provided, default error message will be used.\n             */\n            equalsToValidationErrorMessageProvider:\n                this.#equalsToErrorMessageProvider,\n\n            /**\n             * Allow only integer values (floating point values will be rejected\n             * as invalid)\n             */\n            isInteger: this.#isInteger,\n            /**\n             * EnsureIsInteger error message provider.\n             */\n            ensureIsIntegerErrorMessageProvider:\n                this.#ensureIsIntegerErrorMessageProvider,\n\n            /**\n             * Array of preprocessor functions\n             */\n            preprocessors: this.preprocessors as PreprocessorEntry<TResult>[],\n            /**\n             * Array of validator functions\n             */\n            validators: this.validators as ValidatorEntry<TResult>[]\n        };\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): NumberSchemaBuilder<T, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public clearHasType(): NumberSchemaBuilder<\n        number,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    #getConstraintViolation(\n        objToValidate: any\n    ): { message: string } | { provider: any } | null {\n        if (typeof objToValidate !== 'number') {\n            return {\n                message: `expected type number, but saw ${typeof objToValidate}`\n            };\n        }\n\n        if (\n            typeof this.#equalsTo !== 'undefined' &&\n            objToValidate !== this.#equalsTo\n        ) {\n            return { provider: this.#equalsToErrorMessageProvider };\n        }\n\n        if (this.#ensureNotNaN && Number.isNaN(objToValidate)) {\n            return { provider: this.#ensureNotNaNErrorMessageProvider };\n        }\n\n        if (\n            this.#ensureIsFinite &&\n            !Number.isFinite(objToValidate) &&\n            this.#ensureNotNaN &&\n            !Number.isNaN(objToValidate)\n        ) {\n            return { provider: this.#ensureIsFiniteErrorMessageProvider };\n        }\n\n        if (\n            this.#isInteger &&\n            !Number.isNaN(objToValidate) &&\n            Number.isFinite(objToValidate) &&\n            !Number.isInteger(objToValidate)\n        ) {\n            return { provider: this.#ensureIsIntegerErrorMessageProvider };\n        }\n\n        if (typeof this.#min !== 'undefined') {\n            if (objToValidate < this.#min)\n                return { provider: this.#minErrorMessageProvider };\n        }\n\n        if (typeof this.#max !== 'undefined') {\n            if (objToValidate > this.#max)\n                return { provider: this.#maxErrorMessageProvider };\n        }\n\n        return null;\n    }\n\n    #buildResult(\n        superResult: ReturnType<NumberSchemaBuilder['preValidateSync']>\n    ):\n        | { done: true; result: ValidationResult<TResult> }\n        | {\n              done: false;\n              provider: any;\n              objToValidate: any;\n          } {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { done: true, result: { valid, errors } };\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                done: true,\n                result: { valid: true, object: objToValidate }\n            };\n        }\n\n        const violation = this.#getConstraintViolation(objToValidate);\n\n        if (!violation) {\n            return {\n                done: true,\n                result: {\n                    valid: true,\n                    object: preValidationTransaction!.commit().validatedObject\n                }\n            };\n        }\n\n        if ('message' in violation) {\n            return {\n                done: true,\n                result: {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                }\n            };\n        }\n\n        return {\n            done: false,\n            provider: violation.provider,\n            objToValidate\n        };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return super.validate(object, context) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of number 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: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        // Fast path: no preprocessors or custom validators\n        if (this.canSkipPreValidation) {\n            if (typeof object === 'undefined' || object === null) {\n                if (typeof object === 'undefined' && this.hasDefault) {\n                    object = this.resolveDefaultValue();\n                } else if (\n                    !this.isRequired ||\n                    (object === null && this.isNullable)\n                ) {\n                    return { valid: true, object: object };\n                } else {\n                    return {\n                        valid: false,\n                        errors: [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object\n                                )\n                            }\n                        ]\n                    };\n                }\n            }\n\n            const violation = this.#getConstraintViolation(object);\n\n            if (!violation) {\n                return { valid: true, object: object as TResult };\n            }\n\n            if ('message' in violation) {\n                return {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                };\n            }\n\n            return {\n                valid: false,\n                errors: [\n                    {\n                        message: this.getValidationErrorMessageSync(\n                            violation.provider,\n                            object as TResult\n                        )\n                    }\n                ]\n            };\n        }\n\n        const r = this.#buildResult(this.preValidateSync(object, context));\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: this.getValidationErrorMessageSync(\n                        r.provider,\n                        r.objToValidate as TResult\n                    )\n                }\n            ]\n        };\n    }\n\n    /**\n     * Performs async validation of number 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: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const r = this.#buildResult(\n            await super.preValidateAsync(object, context)\n        );\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: await this.getValidationErrorMessage(\n                        r.provider,\n                        r.objToValidate as TResult\n                    )\n                }\n            ]\n        };\n    }\n\n    protected createFromProps<T, TReq extends boolean>(\n        props: NumberSchemaBuilderCreateProps<T, TReq>\n    ): this {\n        return NumberSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * Restricts number to be equal to `value`.\n     */\n    public equals<T extends number>(\n        value: T,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ) {\n        if (typeof value !== 'number') throw new Error('number expected');\n        return this.createFromProps({\n            ...this.introspect(),\n            equalsTo: value,\n            equalsToValidationErrorMessageProvider: errorMessage\n        }) as any as NumberSchemaBuilder<\n            T,\n            TRequired,\n            TNullable,\n            THasDefault,\n            TExtensions\n        > &\n            TExtensions;\n    }\n\n    /**\n     * Clear `equals()` call.\n     */\n    public clearEquals(): NumberSchemaBuilder<\n        number,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            equalsTo: undefined\n        }) as any;\n    }\n\n    /**\n     * @deprecated Use {@link clearIsInteger} instead.\n     * Float values will be considered as valid after this call.\n     */\n    public isFloat(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            isInteger: false,\n            ensureIsIntegerErrorMessageProvider:\n                this.#defaultEnsureIsIntegerErrorMessageProvider\n        }) as any;\n    }\n\n    /**\n     * Clear `isInteger()` call.\n     */\n    public clearIsInteger(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            isInteger: false,\n            ensureIsIntegerErrorMessageProvider:\n                this.#defaultEnsureIsIntegerErrorMessageProvider\n        }) as any;\n    }\n\n    /**\n     * Only integer values will be considered as valid after this call.\n     */\n    public isInteger(\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            isInteger: true,\n            ensureIsIntegerErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): NumberSchemaBuilder<TResult, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): NumberSchemaBuilder<\n        TResult,\n        false,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value: TResult | (() => TResult)\n    ): NumberSchemaBuilder<TResult, true, TNullable, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\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    ): NumberSchemaBuilder<\n        TResult & { readonly [K in BRAND]: TBrand },\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<number>`. Since numbers are\n     * already immutable this is an identity operation, but it sets the\n     * `isReadonly` introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): NumberSchemaBuilder<\n        Readonly<TResult>,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * Do not accept NaN value\n     */\n    public notNaN(\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            ensureNotNaN: true,\n            ensureNotNaNErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Consider NaN value as valid\n     */\n    public canBeNaN(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            ensureNotNaN: false,\n            ensureNotNaNErrorMessageProvider:\n                this.#defaultEnsureNotNaNErrorMessageProvider\n        }) as any;\n    }\n\n    /**\n     * Do not accept `Infinity`.\n     */\n    public isFinite(\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            ensureIsFinite: true,\n            ensureIsFiniteErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Consider `Infinity` as valid.\n     */\n    public canBeInfinite(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            ensureIsFinite: false,\n            ensureIsFiniteErrorMessageProvider:\n                this.#defaultEnsureIsFiniteErrorMessageProvider\n        }) as any;\n    }\n\n    /**\n     * Restrict number to be at least `minValue`.\n     */\n    public min(\n        minValue: number,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof minValue !== 'number')\n            throw new Error('minValue must be a number');\n        return this.createFromProps({\n            ...this.introspect(),\n            min: minValue,\n            minValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Clear `min()` call.\n     */\n    public clearMin(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.min;\n        return this.createFromProps({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * Restrict number to be no more than `maxValue`.\n     */\n    public max(\n        maxValue: number,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            NumberSchemaBuilder<TResult, TRequired>\n        >\n    ): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof maxValue !== 'number')\n            throw new Error('maxValue must be a number');\n        return this.createFromProps({\n            ...this.introspect(),\n            max: maxValue,\n            maxValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Clear `max()` call.\n     */\n    public clearMax(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.max;\n        return this.createFromProps({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        true,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.nullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public notNullable(): NumberSchemaBuilder<\n        TResult,\n        TRequired,\n        false,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n}\n\n/**\n * Creates a number schema restricted to `equals` value.\n * @param equals string value\n */\nexport function number<T extends number>(\n    equals: T\n): NumberSchemaBuilder<T, true>;\n\n/**\n * Creates a number schema.\n */\nexport function number(): NumberSchemaBuilder<number, true>;\n\n/**\n * Creates a number schema.\n */\nexport function number(equals?: number) {\n    if (typeof equals === 'number') {\n        return NumberSchemaBuilder.create({\n            isRequired: true,\n            equalsTo: equals\n        });\n    }\n    return NumberSchemaBuilder.create({\n        isRequired: true\n    });\n}\n"],"mappings":"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","names":["NumberSchemaBuilder","_NumberSchemaBuilder","SchemaBuilder","#min","#defaultMinErrorMessageProvider","#minErrorMessageProvider","#max","#defaultMaxErrorMessageProvider","#maxErrorMessageProvider","#equalsTo","#defaultEqualsToErrorMessageProvider","#equalsToErrorMessageProvider","#ensureNotNaN","#defaultEnsureNotNaNErrorMessageProvider","#ensureNotNaNErrorMessageProvider","#ensureIsFinite","#defaultEnsureIsFiniteErrorMessageProvider","#ensureIsFiniteErrorMessageProvider","#isInteger","#defaultEnsureIsIntegerErrorMessageProvider","#ensureIsIntegerErrorMessageProvider","props","_notUsed","#getConstraintViolation","objToValidate","#buildResult","superResult","valid","preValidationTransaction","errors","violation","object","context","r","value","errorMessage","_name","minValue","schema","maxValue","number","equals"]}

package/dist/chunk-KFTO7TMB.js

@@ -0,0 +1,2 @@
+import{f as o}from"./chunk-CTP4RHDG.js";var i=class n extends o{#e;#t=function(){return`is expected to be equal ${this.#e}`};#a=this.#t;static create(e){return new n({type:"boolean",...e})}constructor(e){super(e),(typeof e.equalsTo=="boolean"||typeof e.equalsTo>"u")&&(this.#e=e.equalsTo),this.#a=this.assureValidationErrorMessageProvider(e.equalsToValidationErrorMessageProvider,this.#t)}introspect(){return{...super.introspect(),equalsTo:this.#e,equalsToValidationErrorMessageProvider:this.#a}}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#s(e){return typeof e!="boolean"?{message:"expected to be boolean"}:typeof this.#e<"u"&&e!==this.#e?{provider:this.#a}:null}#r(e){let{valid:a,transaction:t,errors:s}=e;if(!a)return{done:!0,result:{valid:a,errors:s}};let{object:{validatedObject:r}}=t;if(typeof r>"u"&&!this.isRequired||r===null&&(!this.isRequired||this.isNullable))return{done:!0,result:{valid:!0,object:r}};let l=this.#s(r);return l?"message"in l?{done:!0,result:{valid:!1,errors:[{message:l.message}]}}:{done:!1,provider:l.provider,objToValidate:r}:{done:!0,result:{valid:!0,object:r}}}validate(e,a){return super.validate(e,a)}async validateAsync(e,a){return super.validateAsync(e,a)}_validate(e,a){if(this.canSkipPreValidation){if(typeof e>"u"||e===null)if(typeof e>"u"&&this.hasDefault)e=this.resolveDefaultValue();else return!this.isRequired||e===null&&this.isNullable?{valid:!0,object:e}:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(this.requiredErrorMessage,e)}]};let s=this.#s(e);return s?"message"in s?{valid:!1,errors:[{message:s.message}]}:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(s.provider,e)}]}:{valid:!0,object:e}}let t=this.#r(this.preValidateSync(e,a));return t.done?t.result:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(t.provider,t.objToValidate)}]}}async _validateAsync(e,a){let t=this.#r(await super.preValidateAsync(e,a));return t.done?t.result:{valid:!1,errors:[{message:await this.getValidationErrorMessage(t.provider,t.objToValidate)}]}}createFromProps(e){return n.create(e)}required(e){return super.required(e)}optional(){return super.optional()}default(e){return super.default(e)}clearDefault(){return super.clearDefault()}brand(e){return super.brand(e)}readonly(){return super.readonly()}equals(e,a){if(typeof e!="boolean")throw new Error("boolean expected");return this.createFromProps({...this.introspect(),equalsTo:e,equalsToValidationErrorMessageProvider:a})}clearEquals(){return this.createFromProps({...this.introspect(),equalsTo:void 0})}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},d=()=>i.create({isRequired:!0});export{i as a,d as b};
+//# sourceMappingURL=chunk-KFTO7TMB.js.map

package/dist/chunk-KFTO7TMB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/BooleanSchemaBuilder.ts"],"sourcesContent":["import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype BooleanSchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<BooleanSchemaBuilder<R>['introspect']>\n>;\n\n/**\n * Similar to `boolean` type in TypeScript.\n * Allows to define a schema for a boolean value. It can be required or optional.\n * It can be restricted to be equal to a certain value.\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 boolean | boolean()} function instead.\n *\n * @example ```ts\n * const schema = boolean().equals(true);\n * const result = schema.validate(true);\n * // result.valid === true\n * // result.object === true\n * ```\n * @example ```ts\n * const schema = boolean().equals(false);\n * const result = schema.validate(true);\n * // result.valid === false\n * // result.errors[0].message === 'is expected to be equal to 'false''\n * ```\n * @example ```ts\n * const schema = boolean().equals(true).optional();\n * const result = schema.validate(undefined);\n * // result.valid === true\n * // result.object === undefined\n * ```\n *\n * @see {@link boolean}\n */\nexport class BooleanSchemaBuilder<\n    TResult = boolean,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {},\n    TFinalResult = TExplicitType extends undefined ? TResult : TExplicitType\n> extends SchemaBuilder<\n    TFinalResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #equalsTo?: boolean;\n    #defaultEqualsToErrorMessageProvider: ValidationErrorMessageProvider<\n        BooleanSchemaBuilder<TResult, TRequired>\n    > = function (this: BooleanSchemaBuilder) {\n        return `is expected to be equal ${this.#equalsTo}`;\n    };\n    #equalsToErrorMessageProvider: ValidationErrorMessageProvider<\n        BooleanSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEqualsToErrorMessageProvider;\n\n    /**\n     * @hidden\n     */\n    public static create(props: BooleanSchemaBuilderCreateProps<any>) {\n        return new BooleanSchemaBuilder({\n            type: 'boolean',\n            ...props\n        });\n    }\n\n    protected constructor(props: BooleanSchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n\n        if (\n            typeof props.equalsTo === 'boolean' ||\n            typeof props.equalsTo === 'undefined'\n        ) {\n            this.#equalsTo = props.equalsTo;\n        }\n\n        this.#equalsToErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.equalsToValidationErrorMessageProvider,\n                this.#defaultEqualsToErrorMessageProvider\n            );\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * If set, restrict object to be equal to a certain value.\n             */\n            equalsTo: this.#equalsTo,\n            /**\n             * Equals to validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            equalsToValidationErrorMessageProvider:\n                this.#equalsToErrorMessageProvider\n        };\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): BooleanSchemaBuilder<\n        TResult,\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(): BooleanSchemaBuilder<\n        TResult,\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    #getConstraintViolation(\n        objToValidate: any\n    ): { message: string } | { provider: any } | null {\n        if (typeof objToValidate !== 'boolean') {\n            return { message: 'expected to be boolean' };\n        }\n\n        if (\n            typeof this.#equalsTo !== 'undefined' &&\n            objToValidate !== this.#equalsTo\n        ) {\n            return { provider: this.#equalsToErrorMessageProvider };\n        }\n\n        return null;\n    }\n\n    #buildResult(\n        superResult: ReturnType<BooleanSchemaBuilder['preValidateSync']>\n    ):\n        | { done: true; result: ValidationResult<TResult> }\n        | {\n              done: false;\n              provider: any;\n              objToValidate: any;\n          } {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { done: true, result: { valid, errors } };\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                done: true,\n                result: { valid: true, object: objToValidate }\n            };\n        }\n\n        const violation = this.#getConstraintViolation(objToValidate);\n\n        if (!violation) {\n            return {\n                done: true,\n                result: { valid: true, object: objToValidate as TResult }\n            };\n        }\n\n        if ('message' in violation) {\n            return {\n                done: true,\n                result: {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                }\n            };\n        }\n\n        return {\n            done: false,\n            provider: violation.provider,\n            objToValidate\n        };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return super.validate(object, context) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of the 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: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        // Fast path: no preprocessors or custom validators\n        if (this.canSkipPreValidation) {\n            if (typeof object === 'undefined' || object === null) {\n                if (typeof object === 'undefined' && this.hasDefault) {\n                    object = this.resolveDefaultValue() as typeof object;\n                } else if (\n                    !this.isRequired ||\n                    (object === null && this.isNullable)\n                ) {\n                    return { valid: true, object: object };\n                } else {\n                    return {\n                        valid: false,\n                        errors: [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object as TFinalResult\n                                )\n                            }\n                        ]\n                    };\n                }\n            }\n\n            const violation = this.#getConstraintViolation(object);\n\n            if (!violation) {\n                return { valid: true, object: object as TResult };\n            }\n\n            if ('message' in violation) {\n                return {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                };\n            }\n\n            return {\n                valid: false,\n                errors: [\n                    {\n                        message: this.getValidationErrorMessageSync(\n                            violation.provider,\n                            object as unknown as TFinalResult\n                        )\n                    }\n                ]\n            };\n        }\n\n        const r = this.#buildResult(this.preValidateSync(object, context));\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: this.getValidationErrorMessageSync(\n                        r.provider,\n                        r.objToValidate as TFinalResult\n                    )\n                }\n            ]\n        };\n    }\n\n    /**\n     * Performs async validation of the 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: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const r = this.#buildResult(\n            await super.preValidateAsync(object, context)\n        );\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: await this.getValidationErrorMessage(\n                        r.provider,\n                        r.objToValidate as TFinalResult\n                    )\n                }\n            ]\n        };\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: BooleanSchemaBuilderCreateProps<TReq>\n    ): this {\n        return BooleanSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): BooleanSchemaBuilder<\n        TResult,\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(): BooleanSchemaBuilder<\n        TResult,\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: TFinalResult | (() => TFinalResult)\n    ): BooleanSchemaBuilder<\n        TResult,\n        true,\n        TNullable,\n        TExplicitType,\n        true,\n        TExtensions\n    > &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): BooleanSchemaBuilder<\n        TResult,\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    ): BooleanSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        TFinalResult & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<boolean>`. Since booleans are\n     * already immutable this is an identity operation, but it sets the\n     * `isReadonly` introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): BooleanSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        Readonly<TFinalResult>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * Restricts object to be equal to `value`.\n     */\n    public equals<T extends boolean>(\n        value: T,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            BooleanSchemaBuilder<TResult, TRequired>\n        >\n    ) {\n        if (typeof value !== 'boolean') throw new Error('boolean expected');\n        return this.createFromProps({\n            ...this.introspect(),\n            equalsTo: value,\n            equalsToValidationErrorMessageProvider: errorMessage\n        } as any) as any as BooleanSchemaBuilder<\n            T,\n            TRequired,\n            TNullable,\n            TExplicitType,\n            THasDefault,\n            TExtensions\n        > &\n            TExtensions;\n    }\n\n    /**\n     * Removes a `value` defined by `equals()` call.\n     */\n    public clearEquals(): BooleanSchemaBuilder<\n        boolean,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            equalsTo: undefined\n        } as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): BooleanSchemaBuilder<\n        TResult,\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(): BooleanSchemaBuilder<\n        TResult,\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 `boolean` schema.\n */\nexport const boolean = () =>\n    BooleanSchemaBuilder.create({\n        isRequired: true\n    }) as BooleanSchemaBuilder<boolean, true>;\n"],"mappings":"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","names":["BooleanSchemaBuilder","_BooleanSchemaBuilder","SchemaBuilder","#equalsTo","#defaultEqualsToErrorMessageProvider","#equalsToErrorMessageProvider","props","_notUsed","#getConstraintViolation","objToValidate","#buildResult","superResult","valid","preValidationTransaction","errors","violation","object","context","r","errorMessage","value","_name","boolean"]}

package/dist/chunk-MKAYFPAR.js

@@ -0,0 +1,2 @@
+import{d as p,f as h}from"./chunk-CTP4RHDG.js";function S(s){return typeof s=="object"&&s!==null&&"key"in s?String(s.key):String(s)}function m(s){return s.map(S).join(".")}var T=class s extends h{#e;[p]=!0;static create(e){return new s({type:"extern",...e})}constructor(e){super(e),this.#e=e.standardSchema}get standardSchema(){return this.#e}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#a(e){return e.map(t=>({message:t.path&&t.path.length>0?`${m(t.path)}: ${t.message}`:t.message}))}#t(e,t){let i=new Map,o=[];for(let r of e)if(r.path&&r.path.length>0){let a=S(r.path[0]),d=r.path.slice(1),c=d.length>0?`${m(d)}: ${r.message}`:r.message;i.has(a)||(i.set(a,[]),o.push(a)),i.get(a).push(c)}let l=new WeakMap,n=t?.currentPropertyDescriptor;if(n)for(let r of o){let a=n[r];a&&typeof a=="object"&&l.set(a,r)}return{fn:r=>{let a;if(typeof r=="function"?a=r(n):a=n,!a||typeof a!="object")return{isValid:!0,errors:[]};let d=l.get(a),c=d?i.get(d)||[]:[];return{isValid:c.length===0,errors:c}},errorPropertyNames:o}}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){let i=this.preValidateSync(e,t);if(!i.valid)return{valid:!1,errors:i.errors};let{transaction:o}=i,l=o.object.validatedObject;if(l==null)return{valid:!0,object:l};let n=this.#e["~standard"].validate(l);if(n instanceof Promise)throw new Error("The external Standard Schema returned a Promise from validate(). Use validateAsync() for schemas with async validation.");if("value"in n){let{fn:a}=this.#t([],t);return{valid:!0,object:n.value,getErrorsFor:a}}let{fn:u,errorPropertyNames:r}=this.#t(n.issues,t);return{valid:!1,errors:this.#a(n.issues),getErrorsFor:u,__externErrorPropertyNames:r}}async _validateAsync(e,t){let i=await this.preValidateAsync(e,t);if(!i.valid)return{valid:!1,errors:i.errors};let{transaction:o}=i,l=o.object.validatedObject;if(l==null)return{valid:!0,object:l};let n=await this.#e["~standard"].validate(l);if("value"in n){let{fn:a}=this.#t([],t);return{valid:!0,object:n.value,getErrorsFor:a}}let{fn:u,errorPropertyNames:r}=this.#t(n.issues,t);return{valid:!1,errors:this.#a(n.issues),getErrorsFor:u,__externErrorPropertyNames:r}}createFromProps(e){return s.create(e)}introspect(){return{...super.introspect(),standardSchema:this.#e}}required(e){return super.required(e)}optional(){return super.optional()}default(e){return super.default(e)}clearDefault(){return super.clearDefault()}brand(e){return super.brand(e)}readonly(){return super.readonly()}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},f=s=>T.create({isRequired:!0,standardSchema:s});export{T as a,f as b};
+//# sourceMappingURL=chunk-MKAYFPAR.js.map

package/dist/chunk-MKAYFPAR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/ExternSchemaBuilder.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport {\n    type BRAND,\n    SchemaBuilder,\n    SYMBOL_HAS_PROPERTIES,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype ExternSchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<ExternSchemaBuilder<any, R>['introspect']>\n> & {\n    standardSchema: StandardSchemaV1;\n};\n\n/**\n * Extracts the first path segment from a Standard Schema issue path entry\n * as a string.\n */\nfunction firstPathSegmentStr(\n    segment: PropertyKey | StandardSchemaV1.PathSegment\n): string {\n    return typeof segment === 'object' && segment !== null && 'key' in segment\n        ? String(segment.key)\n        : String(segment);\n}\n\n/**\n * Formats a Standard Schema issue path into a dotted string.\n *\n * Standard Schema paths may contain bare `PropertyKey` values (string, number,\n * symbol) or `PathSegment` objects with a `.key` property.\n *\n * @example\n * ```\n * formatIssuePath(['address', 'city'])  // → 'address.city'\n * formatIssuePath([{ key: 'items' }, 0]) // → 'items.0'\n * ```\n */\nfunction formatIssuePath(\n    path: ReadonlyArray<PropertyKey | StandardSchemaV1.PathSegment>\n): string {\n    return path.map(firstPathSegmentStr).join('.');\n}\n\n/**\n * Schema builder that wraps an external\n * [Standard Schema v1](https://standardschema.dev/) compatible schema\n * (e.g. Zod, Valibot, ArkType) into a `@cleverbrush/schema` builder.\n *\n * This enables cross-library schema composition — you can use a Zod schema\n * as a property inside a `@cleverbrush/schema` object schema, and the\n * inferred TypeScript type will be correct.\n *\n * Validation is delegated entirely to the external schema's\n * `['~standard'].validate()` method. Standard Schema issues are mapped to\n * `@cleverbrush/schema` `ValidationError` objects, with any issue paths\n * formatted as dotted prefixes (e.g. `\"address.city: must be a string\"`).\n *\n * When used inside an `object()` schema, the property descriptor tree is\n * built dynamically (via Proxy) from the external schema's output type,\n * so `getErrorsFor(t => t.order.id)` works without any additional\n * configuration.\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 the {@link extern | extern()} factory function instead.\n *\n * @example\n * ```ts\n * import { z } from 'zod';\n * import { object, date, extern, InferType } from '@cleverbrush/schema';\n *\n * const zodUser = z.object({ first: z.string(), last: z.string() });\n *\n * const order = object({\n *   user: extern(zodUser),\n *   date: date(),\n * });\n *\n * type Order = InferType<typeof order>;\n * // { user: { first: string; last: string }; date: Date }\n * ```\n *\n * @see {@link extern}\n */\nexport class ExternSchemaBuilder<\n    TStandardSchema extends StandardSchemaV1 = StandardSchemaV1,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {},\n    TResult = TExplicitType extends undefined\n        ? StandardSchemaV1.InferOutput<TStandardSchema>\n        : TExplicitType\n> extends SchemaBuilder<\n    TResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #standardSchema: TStandardSchema;\n\n    /**\n     * Always `true` for extern schemas — enables Proxy-based property\n     * descriptor trees and nested error propagation in\n     * `ObjectSchemaBuilder`.\n     */\n    readonly [SYMBOL_HAS_PROPERTIES] = true;\n\n    /**\n     * @hidden\n     */\n    public static create(props: ExternSchemaBuilderCreateProps<any>) {\n        return new ExternSchemaBuilder({\n            type: 'extern',\n            ...props\n        });\n    }\n\n    protected constructor(props: ExternSchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n        this.#standardSchema = props.standardSchema as TStandardSchema;\n    }\n\n    /**\n     * Returns the wrapped Standard Schema instance.\n     */\n    public get standardSchema(): TStandardSchema {\n        return this.#standardSchema;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): ExternSchemaBuilder<\n        TStandardSchema,\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(): ExternSchemaBuilder<\n        TStandardSchema,\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    /**\n     * Maps a Standard Schema failure result into the library's\n     * `ValidationError[]` format.\n     */\n    #mapIssues(\n        issues: ReadonlyArray<StandardSchemaV1.Issue>\n    ): { message: string }[] {\n        return issues.map(issue => ({\n            message:\n                issue.path && issue.path.length > 0\n                    ? `${formatIssuePath(issue.path)}: ${issue.message}`\n                    : issue.message\n        }));\n    }\n\n    /**\n     * Builds a `getErrorsFor` function that maps Standard Schema issue\n     * paths to per-property error lists via the Proxy-based property\n     * descriptor tree.\n     *\n     * The function groups issues by their first path segment, then builds\n     * a WeakMap from each Proxy-created child descriptor to its property\n     * name so that `getErrorsFor(() => descriptor)` can look up errors.\n     */\n    #buildGetErrorsFor(\n        issues: ReadonlyArray<StandardSchemaV1.Issue>,\n        context?: ValidationContext\n    ): {\n        fn: (selector?: Function) => { isValid: boolean; errors: string[] };\n        errorPropertyNames: string[];\n    } {\n        const errorsByProperty = new Map<string, string[]>();\n        const errorPropertyNames: string[] = [];\n\n        for (const issue of issues) {\n            if (issue.path && issue.path.length > 0) {\n                const firstName = firstPathSegmentStr(issue.path[0]);\n\n                const restPath = issue.path.slice(1);\n                const message =\n                    restPath.length > 0\n                        ? `${formatIssuePath(restPath)}: ${issue.message}`\n                        : issue.message;\n\n                if (!errorsByProperty.has(firstName)) {\n                    errorsByProperty.set(firstName, []);\n                    errorPropertyNames.push(firstName);\n                }\n                errorsByProperty.get(firstName)!.push(message);\n            }\n        }\n\n        // Build reverse map: access each error property on the Proxy\n        // descriptor to create (and cache) the child, then map it back\n        // to the property name.\n        const descriptorToName = new WeakMap<object, string>();\n        const currentPropertyDescriptor = context?.currentPropertyDescriptor;\n        if (currentPropertyDescriptor) {\n            for (const name of errorPropertyNames) {\n                const desc = (currentPropertyDescriptor as any)[name];\n                if (desc && typeof desc === 'object') {\n                    descriptorToName.set(desc, name);\n                }\n            }\n        }\n\n        const fn = (selector?: Function) => {\n            let descriptor: any;\n            if (typeof selector === 'function') {\n                descriptor = selector(currentPropertyDescriptor);\n            } else {\n                descriptor = currentPropertyDescriptor;\n            }\n\n            if (!descriptor || typeof descriptor !== 'object') {\n                return { isValid: true, errors: [] };\n            }\n\n            const propName = descriptorToName.get(descriptor);\n            const errors = propName ? errorsByProperty.get(propName) || [] : [];\n\n            return {\n                isValid: errors.length === 0,\n                errors\n            };\n        };\n\n        return { fn, errorPropertyNames };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return super.validate(object, context) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation by delegating to the external\n     * Standard Schema's `validate()` method.\n     *\n     * If the external schema returns a `Promise` (async validation),\n     * this method throws — use {@link validateAsync} instead.\n     */\n    protected _validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        const superResult = this.preValidateSync(object, context);\n\n        if (!superResult.valid) {\n            return { valid: false, errors: superResult.errors };\n        }\n\n        const { transaction: preValidationTransaction } = superResult;\n\n        const objToValidate = preValidationTransaction!.object.validatedObject;\n\n        // When the value is null/undefined and preValidation accepted it\n        // (optional or nullable), return early without calling the external\n        // schema — it would likely reject these sentinel values.\n        if (objToValidate === undefined || objToValidate === null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        const result =\n            this.#standardSchema['~standard'].validate(objToValidate);\n\n        if (result instanceof Promise) {\n            throw new Error(\n                'The external Standard Schema returned a Promise from validate(). ' +\n                    'Use validateAsync() for schemas with async validation.'\n            );\n        }\n\n        if ('value' in result) {\n            const { fn } = this.#buildGetErrorsFor([], context);\n            return {\n                valid: true,\n                object: result.value as TResult,\n                getErrorsFor: fn\n            } as any;\n        }\n\n        const { fn, errorPropertyNames } = this.#buildGetErrorsFor(\n            result.issues,\n            context\n        );\n        return {\n            valid: false,\n            errors: this.#mapIssues(result.issues),\n            getErrorsFor: fn,\n            __externErrorPropertyNames: errorPropertyNames\n        } as any;\n    }\n\n    /**\n     * Performs async validation by delegating to the external\n     * Standard Schema's `validate()` method. Supports external schemas\n     * that return a `Promise` from their `validate()`.\n     */\n    protected async _validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const superResult = await this.preValidateAsync(object, context);\n\n        if (!superResult.valid) {\n            return { valid: false, errors: superResult.errors };\n        }\n\n        const { transaction: preValidationTransaction } = superResult;\n\n        const objToValidate = preValidationTransaction!.object.validatedObject;\n\n        if (objToValidate === undefined || objToValidate === null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        const result =\n            await this.#standardSchema['~standard'].validate(objToValidate);\n\n        if ('value' in result) {\n            const { fn } = this.#buildGetErrorsFor([], context);\n            return {\n                valid: true,\n                object: result.value as TResult,\n                getErrorsFor: fn\n            } as any;\n        }\n\n        const { fn, errorPropertyNames } = this.#buildGetErrorsFor(\n            result.issues,\n            context\n        );\n        return {\n            valid: false,\n            errors: this.#mapIssues(result.issues),\n            getErrorsFor: fn,\n            __externErrorPropertyNames: errorPropertyNames\n        } as any;\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: ExternSchemaBuilderCreateProps<TReq>\n    ): this {\n        return ExternSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * Returns a snapshot of the builder's internal state.\n     * Includes the wrapped `standardSchema` reference.\n     */\n    public introspect() {\n        return {\n            ...super.introspect(),\n            standardSchema: this.#standardSchema\n        };\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): ExternSchemaBuilder<\n        TStandardSchema,\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(): ExternSchemaBuilder<\n        TStandardSchema,\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: TResult | (() => TResult)\n    ): ExternSchemaBuilder<\n        TStandardSchema,\n        true,\n        TNullable,\n        TExplicitType,\n        true,\n        TExtensions\n    > &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): ExternSchemaBuilder<\n        TStandardSchema,\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    ): ExternSchemaBuilder<\n        TStandardSchema,\n        TRequired,\n        TNullable,\n        TResult & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<T>`. Sets the `isReadonly`\n     * introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): ExternSchemaBuilder<\n        TStandardSchema,\n        TRequired,\n        TNullable,\n        Readonly<TResult>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): ExternSchemaBuilder<\n        TStandardSchema,\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(): ExternSchemaBuilder<\n        TStandardSchema,\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n}\n\n/**\n * Wraps an external [Standard Schema v1](https://standardschema.dev/)\n * compatible schema into a `@cleverbrush/schema` builder.\n *\n * This enables cross-library schema composition — use schemas from Zod,\n * Valibot, ArkType, or any Standard Schema v1 compliant library as\n * properties inside `@cleverbrush/schema` object schemas with full type\n * inference.\n *\n * @param standardSchema - A Standard Schema v1 compliant schema instance\n *   (any object that exposes a `['~standard']` property with `version: 1`\n *   and a `validate` function).\n *\n * @example\n * ```ts\n * import { z } from 'zod';\n * import { object, date, extern, InferType } from '@cleverbrush/schema';\n *\n * const zodUser = z.object({ first: z.string(), last: z.string() });\n *\n * const order = object({\n *   user: extern(zodUser),\n *   date: date(),\n * });\n *\n * type Order = InferType<typeof order>;\n * // { user: { first: string; last: string }; date: Date }\n *\n * order.validate({\n *   user: { first: 'Alice', last: 'Smith' },\n *   date: new Date(),\n * }); // { valid: true, object: { user: …, date: … } }\n * ```\n *\n * @example\n * ```ts\n * // Optional external schema\n * const schema = extern(zodUser).optional();\n * schema.validate(undefined); // valid\n * ```\n *\n * @example\n * ```ts\n * // Inside an array\n * import { array, extern } from '@cleverbrush/schema';\n * const users = array(extern(zodUser));\n * ```\n */\nexport const extern = <T extends StandardSchemaV1>(standardSchema: T) =>\n    ExternSchemaBuilder.create({\n        isRequired: true,\n        standardSchema\n    }) as ExternSchemaBuilder<T, true>;\n"],"mappings":"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","names":["firstPathSegmentStr","segment","formatIssuePath","path","ExternSchemaBuilder","_ExternSchemaBuilder","SchemaBuilder","#standardSchema","SYMBOL_HAS_PROPERTIES","props","_notUsed","#mapIssues","issues","issue","#buildGetErrorsFor","context","errorsByProperty","errorPropertyNames","firstName","restPath","message","descriptorToName","currentPropertyDescriptor","name","desc","selector","descriptor","propName","errors","object","superResult","preValidationTransaction","objToValidate","result","fn","errorMessage","value","_name","extern","standardSchema"]}

package/dist/chunk-NXPH3ZUW.js

@@ -0,0 +1,2 @@
+import{c as f,d as j,f as R}from"./chunk-CTP4RHDG.js";var E=class{#e;#r;#t=[];#n=[];get seenValue(){let e=this.#e[f].getValue(this.#r);return e.success?e.value:void 0}get errors(){return this.#t}get isValid(){return this.#t.length===0&&this.getChildErrors().length===0}getChildErrors(){return this.#n}get descriptor(){return this.#e[f]}constructor(e,r,t){if(!x.isValidPropertyDescriptor(e))throw new Error("Invalid property descriptor");this.#e=e,this.#t=Array.isArray(t)?[...t]:[],this.#r=r}addError(e){this.#t.push(e)}addChildError(e){this.#n.push(e)}toJSON(){return{isValid:this.isValid,errors:this.errors}}};var B="must be an object",x=class c extends R{#e={};#r=!1;#t=[];[j]=!0;#n=new WeakMap;static create(e){return new c({type:"object",...e})}createFromProps(e){return c.create(e)}constructor(e){super(e),typeof e.properties=="object"&&e.properties&&(this.#e=e.properties,this.#t=Object.keys(e.properties)),typeof e.acceptUnknownProps=="boolean"&&(this.#r=e.acceptUnknownProps)}introspect(){return{...super.introspect(),properties:{...this.#e},acceptUnknownProps:this.#r}}required(e){return super.required(e)}optional(){return super.optional()}default(e){return super.default(e)}clearDefault(){return super.clearDefault()}brand(e){return super.brand(e)}readonly(){return super.readonly()}#a(e){c.isValidPropertyDescriptor(e?.context?.rootPropertyDescriptor)||(e.context.rootPropertyDescriptor=c.getPropertiesFor(this)),c.isValidPropertyDescriptor(e.context.currentPropertyDescriptor)||(e.context.currentPropertyDescriptor=e.context.rootPropertyDescriptor),!e.context.rootValidationObject&&e.transaction?.object?.validatedObject&&(e.context.rootValidationObject=e.transaction.object.validatedObject)}preValidateSync(e,r){let t=super.preValidateSync(e,r);return this.#a(t),t}async preValidateAsync(e,r){let t=await super.preValidateAsync(e,r);return this.#a(t),t}#s(e){let{valid:r,context:t,transaction:n,errors:o}=e,i=new WeakMap,{doNotStopOnFirstError:p,rootValidationObject:y}=t,a=t.rootPropertyDescriptor,s=t.currentPropertyDescriptor,T=(h,m,b)=>{if(!c.isValidPropertyDescriptor(h))throw new Error("invalid property descriptor");let S=i.has(h)?i.get(h):null;if(S||(S=new E(h,y),i.set(h,S)),S.addError(m),b&&c.isValidPropertyDescriptor(b)){let D=i.has(b)?i.get(b):null;D||(D=new E(b,y),i.set(b,D)),D.addChildError(S)}},d=(h=>{let m=typeof h=="function"?h(s):s;if(!c.isValidPropertyDescriptor(m))throw new Error("invalid property descriptor");return i.has(m)||i.set(m,new E(m,y)),i.get(m)}),l=e.errors||[];if(!r&&!p&&o){if(c.isValidPropertyDescriptor(s))for(let h of o)T(s,h.message);return{earlyReturn:!0,result:{valid:r,errors:o,getErrorsFor:d}}}let{object:{validatedObject:u}}=n;if(typeof u>"u"&&!this.isRequired||u===null&&(!this.isRequired||this.isNullable))return{earlyReturn:!0,result:{valid:!0,object:n.commit().validatedObject,getErrorsFor:d}};if(typeof u!="object"&&(l.push({message:B}),T(s,B),!p))return n&&n.rollback(),{earlyReturn:!0,result:{valid:!1,errors:[l[0]],getErrorsFor:d}};let P=this.#t,g=Object.keys(u);if(P.length===0){if(g.length===0)return p&&l.length>0?{earlyReturn:!0,result:{valid:!1,errors:l,getErrorsFor:d}}:(n&&n.commit().validatedObject,{earlyReturn:!0,result:{valid:!0,object:{},getErrorsFor:d}});if(!this.#r){for(let h=0;h<g.length;h++){let m=`unknown property '${g[h]}'`;if(l.push({message:m}),!p)break}return n&&n.rollback(),{earlyReturn:!0,result:{valid:!1,errors:p?l:[l[0]],getErrorsFor:d}}}return n&&n.commit(),{earlyReturn:!0,result:{valid:!0,object:{...u},getErrorsFor:d}}}return{earlyReturn:!1,errors:l,objToValidate:u,propKeys:P,objKeys:g,addErrorFor:T,getErrorsFor:d,doNotStopOnFirstError:!!p,rootPropertyDescriptor:a,currentPropertyDescriptor:s,validationTransaction:n}}#o(e,r){let{objToValidate:t,objKeys:n,addErrorFor:o,getErrorsFor:i,doNotStopOnFirstError:p,currentPropertyDescriptor:y,validationTransaction:a}=e,s=e.errors,T=!1;for(let{result:d}of r)if(!d.valid&&(T=!0,Array.isArray(d.errors)))for(let l of d.errors)s.push(l);for(let d=0;d<n.length;d++){let l=n[d];if(!(l in this.#e)&&!this.#r){let u=`unknown property '${l}'`;if(s.push({message:u}),o(y,u),!p)return a&&a.rollback(),{valid:!1,errors:[s[0]],getErrorsFor:i}}}if(!T&&s.length===0){let d={};for(let{key:l,result:u}of r)d[l]=u.object;if(this.#r)for(let l of n)l in this.#e||(d[l]=t[l]);return{valid:!0,object:d,getErrorsFor:i}}for(let{key:d,result:l}of r)if(!l.valid){let u=y[d];if(typeof l.getErrorsFor=="function"&&c.isValidPropertyDescriptor(u)){if(c.#y(l,u,o),Array.isArray(l.__externErrorPropertyNames)&&Array.isArray(l.errors))for(let P of l.errors)o(u,P.message,y)}else if(Array.isArray(l.errors)&&c.isValidPropertyDescriptor(u))for(let P of l.errors)o(u,P.message)}return a.rollback(),{valid:!1,errors:p?s:s[0]?[s[0]]:[],getErrorsFor:i}}validate(e,r){return super.validate(e,r)}async validateAsync(e,r){return super.validateAsync(e,r)}_validate(e,r){if(this.canSkipPreValidation&&!r?.doNotStopOnFirstError&&!r?.rootPropertyDescriptor){if(typeof e>"u"||e===null)if(typeof e>"u"&&this.hasDefault)e=this.resolveDefaultValue();else if(!this.isRequired||e===null&&this.isNullable){let t=this;return{valid:!0,object:e,getErrorsFor(n){return t.#i(e,r).getErrorsFor(n)}}}else{let t=this;return{valid:!1,errors:[{message:this.getValidationErrorMessageSync(this.requiredErrorMessage,e)}],getErrorsFor(n){return t.#i(e,r).getErrorsFor(n)}}}else if(typeof e=="object"){let t=this.#t;if(!this.#r){let i=Object.keys(e);for(let p=0;p<i.length;p++)if(!(i[p]in this.#e)){let y=this;return{valid:!1,errors:[{message:`unknown property '${i[p]}'`}],getErrorsFor(a){return y.#i(e,r).getErrorsFor(a)}}}}let n={};for(let i=0;i<t.length;i++){let p=t[i],y=this.#e[p].validate(e[p]);if(!y.valid){let a=this;return{valid:!1,errors:y.errors&&y.errors.length>0?[y.errors[0]]:[],getErrorsFor(s){return a.#i(e,r).getErrorsFor(s)}}}n[p]=y.object}if(this.#r){let i=Object.keys(e);for(let p=0;p<i.length;p++)i[p]in this.#e||(n[i[p]]=e[i[p]])}let o=this;return{valid:!0,object:n,getErrorsFor(i){return o.#i(e,r).getErrorsFor(i)}}}}return this.#i(e,r)}#i(e,r){let t=this.#s(this.preValidateSync(e,r));if(t.earlyReturn)return t.result;let{propKeys:n,objToValidate:o,doNotStopOnFirstError:i,rootPropertyDescriptor:p,currentPropertyDescriptor:y}=t,a=[];for(let s of n){let T=this.#e[s].validate(o[s],{...r,rootPropertyDescriptor:p,currentPropertyDescriptor:y[s]});if(a.push({key:s,result:T}),!T.valid&&!i)break}return this.#o(t,a)}async _validateAsync(e,r){let t=this.#s(await this.preValidateAsync(e,r));if(t.earlyReturn)return t.result;let{propKeys:n,objToValidate:o,doNotStopOnFirstError:i,rootPropertyDescriptor:p,currentPropertyDescriptor:y}=t,a=[];if(i){let s=await Promise.all(n.map(async T=>{let d=await this.#e[T].validateAsync(o[T],{...r,rootPropertyDescriptor:p,currentPropertyDescriptor:y[T]});return{key:T,result:d}}));a.push(...s)}else for(let s of n){let T=await this.#e[s].validateAsync(o[s],{...r,rootPropertyDescriptor:p,currentPropertyDescriptor:y[s]});if(a.push({key:s,result:T}),!T.valid)break}return this.#o(t,a)}acceptUnknownProps(){return this.createFromProps({...this.introspect(),acceptUnknownProps:!0})}notAcceptUnknownProps(){return this.createFromProps({...this.introspect(),acceptUnknownProps:!1})}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}addProp(e,r){if(typeof e!="string"||!e)throw new Error("propName must be a non empty string");if(e in this.#e)throw new Error(`Property ${e} already exists`);if(!(r instanceof R))throw new Error("schema must be an instance of the SchemaBuilder class");return this.createFromProps({...this.introspect(),properties:{...this.introspect().properties,[e]:r}})}optimize(){return this.createFromProps({...this.introspect()})}addProps(e){if(e instanceof c)return this.addProps(e.introspect().properties);if(typeof e!="object")throw new Error("props should be an object");if(e===null)throw new Error("props should not be null");let r={...this.#e};for(let t in e){if(t in this.#e)throw new Error(`property '${t}' already exists`);if(!(e[t]instanceof R))throw new Error(`${t} is not a SchemaBuilder`);r[t]=e[t]}return this.createFromProps({...this.introspect(),properties:r})}omit(e){if(typeof e=="string"){let r=e;if(!r||!(r in this.#e))throw new Error(`property ${r.toString()} does not exists in the schema`);return this.createFromProps({...this.introspect(),properties:(()=>{let t={...this.#e};return delete t[r],t})()})}else if(Array.isArray(e)){let r=e,t=new Map;if(r.forEach(o=>{if(typeof o!="string"||!o)throw new Error("property name must be a string");if(!(o in this.#e))throw new Error(`property ${o.toString()} does not exists in the schema`);t.set(o.toString(),!0)}),t.size===0)throw new Error("please provide at least one property to omit");let n={...this.introspect()};for(let o of t.keys())delete n.properties[o];return this.createFromProps(n)}else if(e instanceof c){let r={...e.introspect().properties},t={...this.introspect()};for(let n in r)n in t.properties&&delete t.properties[n];return this.createFromProps(t)}throw new Error("this parameter type is not supported")}intersect(e){if(!(e instanceof c))throw new Error("schema must be an instance of the ObjectSchemaBuilder class");let r=e.introspect().properties,t=this.introspect(),n=Object.keys(t.properties).reduce((o,i)=>(o[i]=i in r?r[i]:t.properties[i],o),{});return this.createFromProps({...this.introspect(),properties:n})}partial(e){if(typeof e>"u"||e===null)return this.createFromProps({...this.introspect(),properties:Object.keys(this.#e).reduce((r,t)=>(r[t]=this.#e[t].optional(),r),{})});if(Array.isArray(e)){let r=e;if(r.length===0)throw new Error("properties cannot be empty");let t={...this.introspect()};return r.forEach(n=>{if(typeof n!="string")throw new Error("each propery in property list must be as string value");if(!(n in t.properties))throw new Error(`property ${n} does not exists`);t.properties[n]=t.properties[n].optional()}),this.createFromProps(t)}if(typeof e=="string")return this.modifyPropSchema(e,r=>r.optional());throw new Error("expecting string or string[] parameter")}deepPartial(){let e={};for(let r of Object.keys(this.#e)){let t=this.#e[r];t instanceof c?e[r]=t.deepPartial().optional():e[r]=t.optional()}return this.createFromProps({...this.introspect(),properties:e})}pick(e){if(typeof e=="string"){let r=e;if(!r)throw new Error("property cannot be empty");if(!(r in this.#e))throw new Error(`property ${r} does not exists`);return this.createFromProps({...this.introspect(),properties:{[r]:this.#e[r]}})}if(Array.isArray(e)){if(e.length===0)throw new Error("properties must be a non empty erray");let r=e.reduce((t,n)=>{if(typeof n!="string"||!n)throw new Error("each property name must be a non empty string");if(!(n in this.#e))throw new Error(`property ${n} does not exists`);return t[n]=this.#e[n],t},{});return this.createFromProps({...this.introspect(),properties:r})}if(e instanceof c){let t=Object.keys(e.introspect().properties).filter(n=>typeof this.#e[n]<"u");if(t.length===0)throw new Error("there are no common properties in provided schemas");return this.pick(t)}throw new Error("string, array or ObjectSchemaBuilder is expected")}modifyPropSchema(e,r){if(typeof e!="string"||!e)throw new Error("propName must be a non empty string");if(!(e in this.#e))throw new Error(`property ${e} does not exists in the schema`);if(typeof r!="function")throw new Error("callback must be a function");let t=r(this.#e[e]);if(!(t instanceof R))throw new Error("callback must return a SchemaBuilder object");let n={...this.introspect()};return n.properties={...n.properties,[e]:t},this.createFromProps(n)}makePropOptional(e){return this.modifyPropSchema(e,r=>r.optional())}makePropRequired(e){return this.modifyPropSchema(e,r=>r.required())}makeAllPropsOptional(){return this.createFromProps({...this.introspect(),properties:Object.keys(this.#e).reduce((e,r)=>(e[r]=this.#e[r].optional(),e),{})})}makeAllPropsRequired(){return this.createFromProps({...this.introspect(),properties:Object.keys(this.#e).reduce((e,r)=>(e[r]=this.#e[r].required(),e),{})})}static#p(e,r,t,n,o){let i=e.introspect();if(!i.properties)return{};let p=Object.keys(i.properties);if(p.length===0)return{};typeof r!="function"&&(r=a=>a);let y=O((a,s)=>(t||r)(a,s),n,e,o);for(let a of p){let s=i.properties[a];if(s instanceof c){let T=s.introspect().properties;T&&typeof T=="object"&&Object.keys(T).length>0?y[a]=c.#p(s,(d,l)=>{let u=r(d,l);return u?(l&&!u[a]&&(u[a]={}),u[a]):null},r,a,y[f]):y[a]=O(r,a,s,y[f])}else if(s[j]===!0){let T=O(r,a,s,y[f]),d=(l,u)=>{let P=r(l,u);return P?(u&&!P[a]&&(P[a]={}),P[a]):null};y[a]=w(T,d)}else y[a]=O(r,a,s,y[f])}return y}static getPropertiesFor(e){if(!(e instanceof c))throw new Error("schema must be an instance of the ObjectSchemaBuilder class");if(e.#n.has(e))return e.#n.get(e);let r=c.#p(e);return e.#n.set(e,r),r}static isValidPropertyDescriptor(e){return typeof e=="object"&&e!==null&&typeof e[f]=="object"}static#y(e,r,t){let o=c.#c(r).introspect().properties,i;if(o)i=Object.keys(o);else if(Array.isArray(e.__externErrorPropertyNames))i=e.__externErrorPropertyNames;else return;for(let p of i){let y=r[p];if(!c.isValidPropertyDescriptor(y))continue;let a=e.getErrorsFor(()=>y);if(!a.isValid)for(let s of a.errors)t(y,s,r);if(o){let s=o[p];(s instanceof c||s[j]===!0)&&typeof e.getErrorsFor=="function"&&c.isValidPropertyDescriptor(y)&&c.#y(e,y,t)}}}static#c(e){if(!c.isValidPropertyDescriptor(e))throw new Error("descriptor is not a valid property descriptor");return e[f].getSchema()}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},k=(c=>x.create({isRequired:!0,properties:c})),O=(c,e,r,t)=>({[f]:{setValue:(n,o,i)=>{let p=c(n,!!i?.createMissingStructure);return p?(typeof e=="string"&&(p[e]=o),!0):!1},getValue:n=>{let o=c(n,!1);return o?typeof e!="string"?{success:!0,value:o}:Object.hasOwn(o,e)?{success:!0,value:o[e]}:{success:!1}:{success:!1}},getSchema:()=>r,parent:t}}),w=(c,e)=>new Proxy(c,{get(r,t,n){if(t===f)return r[f];if(typeof t=="string"&&!(t in r)){let o=O(e,t,void 0,r[f]),i=(p,y)=>{let a=e(p,y);return a!=null&&typeof a=="object"?(y&&!(t in a)&&(a[t]={}),a[t]):null};r[t]=w(o,i)}return Reflect.get(r,t,n)}});k.getPropertiesFor=c=>x.getPropertiesFor(c);k.isValidPropertyDescriptor=x.isValidPropertyDescriptor;export{x as a,k as b};
+//# sourceMappingURL=chunk-NXPH3ZUW.js.map

package/dist/chunk-NXPH3ZUW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/PropertyValidationResult.ts","../src/builders/ObjectSchemaBuilder.ts"],"sourcesContent":["import { ObjectSchemaBuilder } from './ObjectSchemaBuilder.js';\nimport {\n    type InferType,\n    type NestedValidationResult,\n    type PropertyDescriptorInner,\n    type PropertyDescriptorTree,\n    SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR\n} from './SchemaBuilder.js';\n\n/**\n * Mutable container for nested validation results associated with a specific\n * property descriptor. Implements {@link NestedValidationResult} and tracks\n * the seen value, accumulated error messages, and child results for\n * nested object properties.\n *\n * Used internally by `ObjectSchemaBuilder` during validation to build up\n * a tree of per-property validation results.\n */\nexport class PropertyValidationResult<\n    TSchema extends ObjectSchemaBuilder<\n        any,\n        any,\n        any,\n        any,\n        any\n    > = ObjectSchemaBuilder<any, any, any, any, any>,\n    TRootSchema extends ObjectSchemaBuilder<\n        any,\n        any,\n        any,\n        any,\n        any\n    > = ObjectSchemaBuilder<any, any, any, any, any>,\n    TParentPropertyDescriptor = any\n> implements\n        NestedValidationResult<TSchema, TRootSchema, TParentPropertyDescriptor>\n{\n    #descriptor: PropertyDescriptorTree<\n        TSchema,\n        TRootSchema,\n        any,\n        TParentPropertyDescriptor\n    >;\n    #rootObjectValue: InferType<TRootSchema> | undefined;\n    #errors: string[] = [];\n    #childErrors: NestedValidationResult<any, any, any>[] = [];\n\n    /**\n     * The value that was seen at the property location described by the descriptor.\n     * Retrieves the value from the root object using the property descriptor's `getValue` method.\n     * Returns `undefined` if the property is not found.\n     */\n    public get seenValue(): InferType<TSchema> | undefined {\n        const result = this.#descriptor[\n            SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR\n        ].getValue(this.#rootObjectValue as any);\n\n        return (result.success ? result.value : undefined) as any;\n    }\n\n    /**\n     * The list of validation error messages accumulated for this property.\n     */\n    public get errors(): ReadonlyArray<string> {\n        return this.#errors;\n    }\n\n    /**\n     * Whether validation passed for this property and all of its children.\n     * Returns `true` only when there are no errors and no child errors.\n     */\n    public get isValid(): boolean {\n        return this.#errors.length === 0 && this.getChildErrors().length === 0;\n    }\n\n    /**\n     * Returns the list of child `NestedValidationResult` instances\n     * representing validation results for nested properties.\n     */\n    public getChildErrors(): ReadonlyArray<\n        NestedValidationResult<any, any, any>\n    > {\n        return this.#childErrors;\n    }\n\n    /**\n     * The inner property descriptor providing `getValue`, `setValue`, and `getSchema`\n     * operations for the property this error relates to.\n     */\n    public get descriptor(): PropertyDescriptorInner<\n        TRootSchema,\n        TSchema,\n        TParentPropertyDescriptor\n    > {\n        return this.#descriptor[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR] as any;\n    }\n\n    /**\n     * Creates a new `PropertyValidationResult`.\n     *\n     * @param descriptor - the property descriptor tree node this error is associated with;\n     *   must be a valid descriptor (checked via `ObjectSchemaBuilder.isValidPropertyDescriptor`)\n     * @param rootObjectValue - the root object being validated, used to resolve property values\n     * @param errors - optional initial list of error message strings\n     * @throws if `descriptor` is not a valid property descriptor\n     */\n    constructor(\n        descriptor: PropertyDescriptorTree<\n            TSchema,\n            TRootSchema,\n            any,\n            TParentPropertyDescriptor\n        >,\n        rootObjectValue: InferType<TRootSchema> | undefined,\n        errors?: string[]\n    ) {\n        if (!ObjectSchemaBuilder.isValidPropertyDescriptor(descriptor)) {\n            throw new Error('Invalid property descriptor');\n        }\n        this.#descriptor = descriptor;\n        this.#errors = Array.isArray(errors) ? [...errors] : [];\n        this.#rootObjectValue = rootObjectValue;\n    }\n\n    /**\n     * Appends a validation error message to this property's error list.\n     * @param error - the error message string to add\n     */\n    addError(error: string): void {\n        this.#errors.push(error);\n    }\n\n    /**\n     * Appends a child `NestedValidationResult` for a nested property.\n     * @param childError - the child validation result to add\n     */\n    addChildError(childError: NestedValidationResult<any, any, any>): void {\n        this.#childErrors.push(childError);\n    }\n\n    /**\n     * Returns a JSON-serializable representation of this validation result.\n     * This ensures `JSON.stringify` includes `isValid` and `errors`,\n     * which are otherwise non-enumerable prototype getters.\n     */\n    toJSON(): { isValid: boolean; errors: ReadonlyArray<string> } {\n        return {\n            isValid: this.isValid,\n            errors: this.errors\n        };\n    }\n}\n","import { PropertyValidationResult } from './PropertyValidationResult.js';\nimport {\n    type BRAND,\n    type InferType,\n    type NestedValidationResult,\n    type PreValidationResult,\n    type PropertyDescriptor,\n    type PropertyDescriptorInner,\n    type PropertyDescriptorTree,\n    type PropertySetterOptions,\n    SchemaBuilder,\n    SYMBOL_HAS_PROPERTIES,\n    SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR,\n    type ValidationContext,\n    type ValidationError,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\nconst MUST_BE_AN_OBJECT_ERROR_MESSSAGE = 'must be an object';\n\n/**\n * A callback function to select properties from the schema.\n * Normally it's provided by the user to select property descriptors\n * from the schema for the further usage. e.g. to select source and destination\n * properties for object mappings\n */\nexport type SchemaPropertySelector<\n    TSchema extends ObjectSchemaBuilder<any, any, any, any, any, any>,\n    TPropertySchema extends SchemaBuilder<any, any, any, any, any>,\n    TAssignableTo = any,\n    TParentPropertyDescriptor = undefined\n> = (\n    l: PropertyDescriptorTree<TSchema, TSchema, TAssignableTo>\n) => PropertyDescriptor<TSchema, TPropertySchema, TParentPropertyDescriptor>;\n\ntype ObjectSchemaBuilderProps<\n    T extends Record<string, SchemaBuilder> = {},\n    TRequired extends boolean = true\n> = ReturnType<ObjectSchemaBuilder<T, TRequired>['introspect']>;\n\ntype ObjectSchemaBuilderCreateProps<\n    T extends Record<string, SchemaBuilder> = {},\n    TRequired extends boolean = true\n> = Partial<ObjectSchemaBuilderProps<T, TRequired>>;\n\ntype Id<T> = T extends infer U ? { [K in keyof U]: U[K] } : never;\n\nexport type RespectPropsOptionality<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = {\n    [K in RequiredProps<T>]: InferType<T[K]>;\n} & {\n    [K in NotRequiredProps<T>]?: InferType<T[K]>;\n};\n\ntype RespectPropsOptionalityForInput<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = {\n    [K in RequiredInputProps<T>]: InferType<T[K]>;\n} & {\n    [K in NotRequiredInputProps<T>]?: InferType<T[K]>;\n};\n\ntype MakeChildrenRequired<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = {\n    [K in keyof T]: ReturnType<T[K]['required']>;\n};\n\ntype MakeChildrenOptional<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = {\n    [K in keyof T]: ReturnType<T[K]['optional']>;\n};\n\n/**\n * Recursively maps each property to its optional form, descending into\n * nested `ObjectSchemaBuilder` schemas.  All other schema types (arrays,\n * unions, primitives) are only made optional at the top level.\n */\ntype DeepMakeChildrenOptional<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = {\n    [K in keyof T]: T[K] extends ObjectSchemaBuilder<\n        // biome-ignore lint/correctness/noUnusedVariables: used in extensions\n        infer P extends Record<string, SchemaBuilder<any, any, any, any, any>>,\n        any,\n        any,\n        any,\n        any,\n        any\n    >\n        ? ReturnType<ReturnType<T[K]['deepPartial']>['optional']>\n        : ReturnType<T[K]['optional']>;\n};\n\ntype MakeChildOptional<\n    T extends Record<any, SchemaBuilder<any, any, any, any, any>>,\n    TProp extends keyof T\n> = {\n    [K in keyof T]: K extends TProp ? ReturnType<T[K]['optional']> : T[K];\n};\n\ntype MakeChildRequired<\n    T extends Record<any, SchemaBuilder<any, any, any, any, any>>,\n    TProp extends keyof T\n> = {\n    [K in keyof T]: K extends TProp ? ReturnType<T[K]['required']> : T[K];\n};\n\ntype ModifyPropSchema<\n    T extends Record<any, SchemaBuilder<any, any, any, any, any>>,\n    TProp extends keyof T,\n    TSchema extends SchemaBuilder<any, any, any, any, any>\n> = {\n    [K in keyof T]: K extends TProp ? TSchema : T[K];\n};\n\nexport type ObjectSchemaValidationResult<\n    T,\n    TRootSchema extends ObjectSchemaBuilder<any, any, any, any, any, any>,\n    TSchema extends ObjectSchemaBuilder<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n    > = TRootSchema\n> = Omit<ValidationResult<T>, 'errors'> & {\n    /**\n     * A flat list of validation errors.\n     *\n     * @deprecated Use {@link ObjectSchemaValidationResult.getErrorsFor | getErrorsFor()} instead for\n     * per-property error inspection with type-safe property selectors. The `errors` array on\n     * `ObjectSchemaBuilder` validation results will be removed in a future major version.\n     */\n    errors?: ValidationError[];\n    /**\n     * Returns a nested validation error for the property selected by the `selector` function.\n     * This is the **recommended** way to inspect validation errors — it provides type-safe,\n     * per-property error details including `isValid`, `errors`, and `seenValue`.\n     *\n     * Prefer this over the deprecated `errors` array.\n     *\n     * @param selector a callback function to select property from the schema.\n     */\n    getErrorsFor<TPropertySchema, TParentPropertyDescriptor>(\n        selector?: (\n            properties: PropertyDescriptorTree<TSchema, TRootSchema>\n        ) => PropertyDescriptor<\n            TRootSchema,\n            TPropertySchema,\n            TParentPropertyDescriptor\n        >\n    ): TPropertySchema extends ObjectSchemaBuilder<any, any, any, any, any, any>\n        ? PropertyValidationResult<\n              TPropertySchema,\n              TRootSchema,\n              TParentPropertyDescriptor\n          >\n        : NestedValidationResult<\n              TPropertySchema,\n              TRootSchema,\n              TParentPropertyDescriptor\n          >;\n};\n\n/**\n * Object schema builder class. Similar to the `object` type\n * in JS. Allows to define a schema for `object` value.\n * Should be used to validate objects with specific properties.\n * Properties should be defined as their own schema builders.\n * You can use any `SchemaBuilder` e.g. `string()`, `number()`,\n * `boolean()`, `array()`, `object()`, etc. to define properties.\n * Which means that you can define nested objects and arrays of\n * any complexity.\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 object | object()} function instead.\n *\n * @example\n * ```ts\n * const schema = object({\n *    name: string(),\n *    age: number()\n * });\n *\n * const result = schema.validate({\n *   name: 'John',\n *   age: 30\n * });\n *\n * // result.valid === true\n * // result.object === { name: 'John', age: 30 }\n * ```\n *\n * @example\n * ```ts\n * const schema = object({\n *   name: string(),\n *   age: number().optional()\n * });\n *\n * const result = schema.validate({\n *  name: 'John'\n * });\n * // result.valid === true\n * // result.object === { name: 'John' }\n * ```\n *\n * @example\n * ```ts\n * const schema = object({\n *  name: string(),\n *  age: number();\n * });\n * const result = schema.validate({\n *  name: 'John'\n * });\n *\n * // result.valid === false\n * // result.errors is deprecated — use result.getErrorsFor() instead\n * // result.getErrorsFor((p) => p.age).errors // [\"is expected to have property 'age'\"]\n * ```\n *\n * @example\n * ```ts\n * const schema = object({\n * name: string(),\n * address: object({\n *     city: string(),\n *     country: string()\n *   })\n * });\n * const result = schema.validate({\n * name: 'John',\n * address: {\n *    city: 'New York',\n *    country: 'USA'\n *  }\n * });\n * // result.valid === true\n * // result.object === {\n * //   name: 'John',\n * //   address: {\n * //     city: 'New York',\n * //     country: 'USA'\n * //   }\n * // }\n * ```\n * @see {@link object}\n */\nexport class ObjectSchemaBuilder<\n    TProperties extends Record<\n        string,\n        SchemaBuilder<any, any, any, any, any>\n    > = {},\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<\n    undefined extends TExplicitType\n        ? RespectPropsOptionality<TProperties>\n        : TExplicitType,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #properties: TProperties = {} as any;\n    #acceptUnknownProps = false;\n    #propKeys: string[] = [];\n\n    /** Marks this builder as having sub-properties for descriptor tree recursion. */\n    readonly [SYMBOL_HAS_PROPERTIES] = true;\n\n    #propertyDescriptorTreeMap: PropertyDescriptorMap = new WeakMap() as any;\n\n    /**\n     * @hidden\n     */\n    public static create<\n        P extends Record<string, SchemaBuilder>,\n        R extends boolean\n    >(props: ObjectSchemaBuilderCreateProps<P, R>) {\n        return new ObjectSchemaBuilder({\n            type: 'object',\n            ...props\n        } as any);\n    }\n\n    protected createFromProps<\n        T extends Record<string, SchemaBuilder>,\n        R extends boolean = true\n    >(props: ObjectSchemaBuilderCreateProps<T, R>): this {\n        return ObjectSchemaBuilder.create(props as any) as any;\n    }\n\n    protected constructor(props: ObjectSchemaBuilderCreateProps) {\n        super(props as any);\n\n        if (typeof props.properties === 'object' && props.properties) {\n            this.#properties = props.properties as any;\n            this.#propKeys = Object.keys(props.properties);\n        }\n\n        if (typeof props.acceptUnknownProps === 'boolean') {\n            this.#acceptUnknownProps = props.acceptUnknownProps;\n        }\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * Properties defined in schema\n             */\n            properties: { ...this.#properties },\n            /**\n             * If set to `true`, schema validation will not\n             * return errors if object contains fields which\n             * are not defined in the schema `properties`.\n             * Set to `false` by default\n             */\n            acceptUnknownProps: this.#acceptUnknownProps\n        };\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): ObjectSchemaBuilder<\n        TProperties,\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(): ObjectSchemaBuilder<\n        TProperties,\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            | (undefined extends TExplicitType\n                  ? RespectPropsOptionality<TProperties>\n                  : TExplicitType)\n            | (() => undefined extends TExplicitType\n                  ? RespectPropsOptionality<TProperties>\n                  : TExplicitType)\n    ): ObjectSchemaBuilder<\n        TProperties,\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(): ObjectSchemaBuilder<\n        TProperties,\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    ): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        (undefined extends TExplicitType\n            ? RespectPropsOptionality<TProperties>\n            : TExplicitType) & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<T>` — all top-level properties\n     * become `readonly` at the type level. Validation behaviour is unchanged.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        Readonly<\n            undefined extends TExplicitType\n                ? RespectPropsOptionality<TProperties>\n                : TExplicitType\n        >,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    #applyPropertyDescriptors(\n        result: PreValidationResult<any, { validatedObject: any }>\n    ): void {\n        if (\n            !ObjectSchemaBuilder.isValidPropertyDescriptor(\n                result?.context?.rootPropertyDescriptor as any\n            )\n        ) {\n            (result.context.rootPropertyDescriptor as any) =\n                ObjectSchemaBuilder.getPropertiesFor(this as any);\n        }\n\n        if (\n            !ObjectSchemaBuilder.isValidPropertyDescriptor(\n                result.context.currentPropertyDescriptor as any\n            )\n        ) {\n            result.context.currentPropertyDescriptor =\n                result.context.rootPropertyDescriptor;\n        }\n\n        if (\n            !result.context.rootValidationObject &&\n            result.transaction?.object?.validatedObject\n        ) {\n            result.context.rootValidationObject =\n                result.transaction.object.validatedObject;\n        }\n    }\n\n    protected preValidateSync(\n        object: any,\n        context?: ValidationContext<this>\n    ): PreValidationResult<\n        InferType<\n            SchemaBuilder<\n                undefined extends TExplicitType\n                    ? Id<RespectPropsOptionality<TProperties>>\n                    : TExplicitType,\n                TRequired\n            >\n        >,\n        { validatedObject: any }\n    > {\n        const result = super.preValidateSync(object, context);\n        this.#applyPropertyDescriptors(result);\n        return result;\n    }\n\n    protected async preValidateAsync(\n        object: any,\n        context?: ValidationContext<this>\n    ): Promise<\n        PreValidationResult<\n            InferType<\n                SchemaBuilder<\n                    undefined extends TExplicitType\n                        ? Id<RespectPropsOptionality<TProperties>>\n                        : TExplicitType,\n                    TRequired\n                >\n            >,\n            { validatedObject: any }\n        >\n    > {\n        const result = await super.preValidateAsync(object, context);\n        this.#applyPropertyDescriptors(result);\n        return result;\n    }\n\n    /**\n     * Shared pre-property-validation setup for both `validate` and\n     * `validateAsync`.  Handles destructuring the prevalidated result,\n     * building the `addErrorFor` / `getErrorsFor` closures, and all early\n     * returns that happen before per-property validation.\n     */\n    #setupValidation(\n        prevalidatedResult: PreValidationResult<any, { validatedObject: any }>\n    ) {\n        const {\n            valid,\n            context: prevalidationContext,\n            transaction: validationTransaction,\n            errors: preValidationErrors\n        } = prevalidatedResult;\n\n        const propertyDescriptorToErrorMap = new WeakMap<\n            PropertyDescriptor<any, any, any>,\n            PropertyValidationResult<any, any>\n        >() as any;\n\n        const { doNotStopOnFirstError, rootValidationObject } =\n            prevalidationContext;\n\n        const rootPropertyDescriptor: PropertyDescriptor<any, any, undefined> =\n            prevalidationContext.rootPropertyDescriptor as any;\n\n        const currentPropertyDescriptor: PropertyDescriptor<any, any, unknown> =\n            prevalidationContext.currentPropertyDescriptor as any;\n\n        const addErrorFor = (\n            propertyDescriptor: PropertyDescriptor<any, any, any>,\n            message: string,\n            parentPropertyDescriptor?: PropertyDescriptor<any, any, any>\n        ) => {\n            if (\n                !ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    propertyDescriptor\n                )\n            ) {\n                throw new Error('invalid property descriptor');\n            }\n\n            let validationError: PropertyValidationResult<any, any> =\n                propertyDescriptorToErrorMap.has(propertyDescriptor)\n                    ? propertyDescriptorToErrorMap.get(propertyDescriptor)\n                    : (null as any);\n\n            if (!validationError) {\n                validationError = new PropertyValidationResult(\n                    propertyDescriptor as any,\n                    rootValidationObject\n                );\n\n                propertyDescriptorToErrorMap.set(\n                    propertyDescriptor,\n                    validationError\n                );\n            }\n\n            validationError.addError(message);\n\n            if (\n                parentPropertyDescriptor &&\n                ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    parentPropertyDescriptor\n                )\n            ) {\n                let parentValidationError: PropertyValidationResult<any, any> =\n                    propertyDescriptorToErrorMap.has(parentPropertyDescriptor)\n                        ? propertyDescriptorToErrorMap.get(\n                              parentPropertyDescriptor\n                          )\n                        : (null as any);\n\n                if (!parentValidationError) {\n                    parentValidationError = new PropertyValidationResult(\n                        parentPropertyDescriptor as any,\n                        rootValidationObject\n                    );\n                    propertyDescriptorToErrorMap.set(\n                        parentPropertyDescriptor,\n                        parentValidationError\n                    );\n                }\n\n                parentValidationError.addChildError(validationError);\n            }\n        };\n\n        const getErrorsFor = (<\n            TPropertySchema extends SchemaBuilder<any, any, any, any, any>\n        >(\n            selector?: (\n                properties: PropertyDescriptorTree<any>\n            ) => PropertyDescriptor<any, TPropertySchema, any>\n        ): PropertyValidationResult<any, any> => {\n            const descriptor: PropertyDescriptor<any, any, any> =\n                typeof selector === 'function'\n                    ? selector(currentPropertyDescriptor as any)\n                    : currentPropertyDescriptor;\n\n            if (\n                !ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    descriptor as any\n                )\n            ) {\n                throw new Error('invalid property descriptor');\n            }\n\n            if (!propertyDescriptorToErrorMap.has(descriptor)) {\n                propertyDescriptorToErrorMap.set(\n                    descriptor,\n                    new PropertyValidationResult(\n                        descriptor as any,\n                        rootValidationObject\n                    )\n                );\n            }\n\n            return propertyDescriptorToErrorMap.get(descriptor);\n        }) as any;\n\n        const errors = prevalidatedResult.errors || [];\n\n        if (!valid && !doNotStopOnFirstError && preValidationErrors) {\n            if (\n                ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    currentPropertyDescriptor\n                )\n            ) {\n                for (const error of preValidationErrors) {\n                    addErrorFor(currentPropertyDescriptor, error.message);\n                }\n            }\n\n            return {\n                earlyReturn: true as const,\n                result: {\n                    valid,\n                    errors: preValidationErrors,\n                    getErrorsFor\n                }\n            };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = validationTransaction!;\n\n        if (\n            (typeof objToValidate === 'undefined' && !this.isRequired) ||\n            (objToValidate === null && (!this.isRequired || this.isNullable))\n        ) {\n            return {\n                earlyReturn: true as const,\n                result: {\n                    valid: true,\n                    object: validationTransaction!.commit().validatedObject,\n                    getErrorsFor\n                }\n            };\n        }\n\n        if (typeof objToValidate !== 'object') {\n            errors.push({\n                message: MUST_BE_AN_OBJECT_ERROR_MESSSAGE\n            });\n            addErrorFor(\n                currentPropertyDescriptor,\n                MUST_BE_AN_OBJECT_ERROR_MESSSAGE\n            );\n\n            if (!doNotStopOnFirstError) {\n                if (validationTransaction) {\n                    validationTransaction.rollback();\n                }\n                return {\n                    earlyReturn: true as const,\n                    result: {\n                        valid: false,\n                        errors: [errors[0]],\n                        getErrorsFor\n                    }\n                };\n            }\n        }\n\n        const propKeys = this.#propKeys;\n        const objKeys = Object.keys(objToValidate as Object);\n\n        if (propKeys.length === 0) {\n            if (objKeys.length === 0) {\n                if (doNotStopOnFirstError && errors.length > 0) {\n                    return {\n                        earlyReturn: true as const,\n                        result: {\n                            valid: false,\n                            errors,\n                            getErrorsFor\n                        }\n                    };\n                }\n                if (validationTransaction) {\n                    validationTransaction.commit().validatedObject;\n                }\n                return {\n                    earlyReturn: true as const,\n                    result: {\n                        valid: true,\n                        object: {} as any,\n                        getErrorsFor\n                    }\n                };\n            }\n\n            if (!this.#acceptUnknownProps) {\n                for (let i = 0; i < objKeys.length; i++) {\n                    const message = `unknown property '${objKeys[i]}'`;\n                    errors.push({\n                        message\n                    });\n                    if (!doNotStopOnFirstError) {\n                        break;\n                    }\n                }\n                if (validationTransaction) {\n                    validationTransaction.rollback();\n                }\n                return {\n                    earlyReturn: true as const,\n                    result: {\n                        valid: false,\n                        errors: doNotStopOnFirstError ? errors : [errors[0]],\n                        getErrorsFor\n                    }\n                };\n            }\n\n            if (validationTransaction) {\n                validationTransaction.commit();\n            }\n            return {\n                earlyReturn: true as const,\n                result: {\n                    valid: true,\n                    object: { ...objToValidate } as any,\n                    getErrorsFor\n                }\n            };\n        }\n\n        return {\n            earlyReturn: false as const,\n            errors,\n            objToValidate,\n            propKeys,\n            objKeys,\n            addErrorFor,\n            getErrorsFor,\n            doNotStopOnFirstError: !!doNotStopOnFirstError,\n            rootPropertyDescriptor,\n            currentPropertyDescriptor,\n            validationTransaction: validationTransaction!\n        };\n    }\n\n    /**\n     * Shared post-property-validation processing for both `validate` and\n     * `validateAsync`.  Handles unknown-property checks, error aggregation,\n     * commit/rollback, and the final result construction.\n     */\n    #processResults(\n        setup: {\n            errors: any[];\n            objToValidate: any;\n            propKeys: string[];\n            objKeys: string[];\n            addErrorFor: (\n                propertyDescriptor: PropertyDescriptor<any, any, any>,\n                message: string,\n                parentPropertyDescriptor?: PropertyDescriptor<any, any, any>\n            ) => void;\n            getErrorsFor: any;\n            doNotStopOnFirstError: boolean;\n            rootPropertyDescriptor: any;\n            currentPropertyDescriptor: any;\n            validationTransaction: any;\n        },\n        validationResults: { key: string; result: ValidationResult<any> }[]\n    ): ObjectSchemaValidationResult<any, any> {\n        const {\n            objToValidate,\n            objKeys,\n            addErrorFor,\n            getErrorsFor,\n            doNotStopOnFirstError,\n            currentPropertyDescriptor,\n            validationTransaction\n        } = setup;\n\n        const errors = setup.errors;\n\n        let hasInvalid = false;\n        for (const { result } of validationResults) {\n            if (!result.valid) {\n                hasInvalid = true;\n                if (Array.isArray(result.errors)) {\n                    for (const error of result.errors) {\n                        errors.push(error);\n                    }\n                }\n            }\n        }\n\n        for (let i = 0; i < objKeys.length; i++) {\n            const key = objKeys[i];\n            if (!(key in this.#properties) && !this.#acceptUnknownProps) {\n                const message = `unknown property '${key}'`;\n                errors.push({\n                    message\n                });\n                addErrorFor(currentPropertyDescriptor, message);\n                if (!doNotStopOnFirstError) {\n                    if (validationTransaction) {\n                        validationTransaction.rollback();\n                    }\n                    return {\n                        valid: false,\n                        errors: [errors[0]],\n                        getErrorsFor\n                    };\n                }\n            }\n        }\n\n        if (!hasInvalid && errors.length === 0) {\n            const resultObject: Record<string, any> = {};\n            for (const { key, result } of validationResults) {\n                resultObject[key] = result.object;\n            }\n            if (this.#acceptUnknownProps) {\n                for (const key of objKeys) {\n                    if (!(key in this.#properties)) {\n                        resultObject[key] = objToValidate[key];\n                    }\n                }\n            }\n            return {\n                valid: true,\n                object: resultObject,\n                getErrorsFor\n            };\n        }\n\n        for (const { key, result } of validationResults) {\n            if (!result.valid) {\n                const descriptor = (currentPropertyDescriptor as any)[key];\n                if (\n                    typeof (result as any).getErrorsFor === 'function' &&\n                    ObjectSchemaBuilder.isValidPropertyDescriptor(descriptor)\n                ) {\n                    ObjectSchemaBuilder.#propagateNestedErrors(\n                        result as any,\n                        descriptor,\n                        addErrorFor\n                    );\n                    // For extern schemas, also record errors on the extern\n                    // descriptor itself so getErrorsFor(t => t.extern) works,\n                    // and pass the parent so getErrorsFor(t => t) is aware.\n                    if (\n                        Array.isArray(\n                            (result as any).__externErrorPropertyNames\n                        ) &&\n                        Array.isArray(result.errors)\n                    ) {\n                        for (const error of result.errors) {\n                            addErrorFor(\n                                descriptor,\n                                error.message,\n                                currentPropertyDescriptor\n                            );\n                        }\n                    }\n                } else if (Array.isArray(result.errors)) {\n                    if (\n                        ObjectSchemaBuilder.isValidPropertyDescriptor(\n                            descriptor\n                        )\n                    ) {\n                        for (const error of result.errors) {\n                            addErrorFor(descriptor, error.message);\n                        }\n                    }\n                }\n            }\n        }\n\n        validationTransaction!.rollback();\n\n        return {\n            valid: false,\n            errors: doNotStopOnFirstError\n                ? errors\n                : errors[0]\n                  ? [errors[0]]\n                  : [],\n            getErrorsFor\n        };\n    }\n\n    /**\n     * Performs synchronous validation of object schema over the `object`.\n     * Throws if any preprocessor, validator, or error message provider returns a Promise.\n     *\n     * The returned result includes a `getErrorsFor()` method for type-safe,\n     * per-property error inspection.\n     *\n     * @param object The object to validate against this schema.\n     * @param context Optional `ValidationContext` settings.\n     */\n    public validate(\n        object: undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionalityForInput<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        context?: ValidationContext<this>\n    ): ObjectSchemaValidationResult<\n        undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionality<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        this\n    > {\n        return super.validate(object, context) as any;\n    }\n\n    /**\n     * @param object The object to validate against this schema.\n     * @param context Optional `ValidationContext` settings.\n     */\n    public async validateAsync(\n        object: undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionalityForInput<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        context?: ValidationContext<this>\n    ): Promise<\n        ObjectSchemaValidationResult<\n            undefined extends TExplicitType\n                ? InferType<\n                      SchemaBuilder<\n                          undefined extends TExplicitType\n                              ? Id<RespectPropsOptionality<TProperties>>\n                              : TExplicitType,\n                          TRequired\n                      >\n                  >\n                : TExplicitType,\n            this\n        >\n    > {\n        return super.validateAsync(object, context) as any;\n    }\n\n    /**\n     * Performs synchronous validation of object schema over the `object`.\n     * Throws if any preprocessor, validator, or error message provider returns a Promise.\n     *\n     * The returned result includes a `getErrorsFor()` method for type-safe,\n     * per-property error inspection.\n     *\n     * @param object The object to validate against this schema.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected _validate(\n        object: undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionalityForInput<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        context?: ValidationContext<this>\n    ): ObjectSchemaValidationResult<\n        undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionality<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        this\n    > {\n        // Fast path: skip preValidateSync + setupValidation when no preprocessors/validators\n        if (\n            this.canSkipPreValidation &&\n            !context?.doNotStopOnFirstError &&\n            !context?.rootPropertyDescriptor\n        ) {\n            // Required / optional check\n            if (typeof object === 'undefined' || object === null) {\n                if (typeof object === 'undefined' && this.hasDefault) {\n                    object = this.resolveDefaultValue() as typeof object;\n                } else if (\n                    !this.isRequired ||\n                    (object === null && this.isNullable)\n                ) {\n                    const self = this;\n                    return {\n                        valid: true,\n                        object: object,\n                        getErrorsFor(selector?: any) {\n                            return self\n                                .#validateFull(object, context)\n                                .getErrorsFor(selector);\n                        }\n                    } as any;\n                } else {\n                    const self = this;\n                    return {\n                        valid: false,\n                        errors: [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object as any\n                                )\n                            }\n                        ],\n                        getErrorsFor(selector?: any) {\n                            return self\n                                .#validateFull(object, context)\n                                .getErrorsFor(selector);\n                        }\n                    } as any;\n                }\n            } else if (typeof object === 'object') {\n                const propKeys = this.#propKeys;\n\n                // Check for unknown properties\n                if (!this.#acceptUnknownProps) {\n                    const objKeys = Object.keys(object as Record<string, any>);\n                    for (let i = 0; i < objKeys.length; i++) {\n                        if (!(objKeys[i] in this.#properties)) {\n                            const self = this;\n                            return {\n                                valid: false,\n                                errors: [\n                                    {\n                                        message: `unknown property '${objKeys[i]}'`\n                                    }\n                                ],\n                                getErrorsFor(selector?: any) {\n                                    return self\n                                        .#validateFull(object, context)\n                                        .getErrorsFor(selector);\n                                }\n                            } as any;\n                        }\n                    }\n                }\n\n                // Validate all properties inline — no path passed to children\n                const resultObject: Record<string, any> = {};\n                for (let i = 0; i < propKeys.length; i++) {\n                    const key = propKeys[i];\n                    const result = this.#properties[key].validate(\n                        (object as any)[key]\n                    );\n                    if (!result.valid) {\n                        const self = this;\n                        return {\n                            valid: false,\n                            errors:\n                                result.errors && result.errors.length > 0\n                                    ? [result.errors[0]]\n                                    : [],\n                            getErrorsFor(selector?: any) {\n                                return self\n                                    .#validateFull(object, context)\n                                    .getErrorsFor(selector);\n                            }\n                        } as any;\n                    }\n                    resultObject[key] = result.object;\n                }\n\n                // Copy unknown props if accepted\n                if (this.#acceptUnknownProps) {\n                    const objKeys = Object.keys(object as Record<string, any>);\n                    for (let i = 0; i < objKeys.length; i++) {\n                        if (!(objKeys[i] in this.#properties)) {\n                            resultObject[objKeys[i]] = (object as any)[\n                                objKeys[i]\n                            ];\n                        }\n                    }\n                }\n\n                // Lazy getErrorsFor — only builds descriptors if called\n                const self = this;\n                return {\n                    valid: true,\n                    object: resultObject,\n                    getErrorsFor(selector?: any) {\n                        return self\n                            .#validateFull(object, context)\n                            .getErrorsFor(selector);\n                    }\n                } as any;\n            }\n        }\n\n        return this.#validateFull(object, context) as any;\n    }\n\n    /**\n     * Full validation path with complete error handling and property descriptors.\n     */\n    #validateFull(\n        object: any,\n        context?: ValidationContext<this>\n    ): ObjectSchemaValidationResult<any, any> {\n        const setup = this.#setupValidation(\n            this.preValidateSync(object, context)\n        );\n        if (setup.earlyReturn) return setup.result as any;\n\n        const {\n            propKeys,\n            objToValidate,\n            doNotStopOnFirstError,\n            rootPropertyDescriptor,\n            currentPropertyDescriptor\n        } = setup;\n\n        const validationResults: {\n            key: string;\n            result: ValidationResult<any>;\n        }[] = [];\n        for (const key of propKeys) {\n            const result = this.#properties[key].validate(objToValidate[key], {\n                ...context,\n                rootPropertyDescriptor: rootPropertyDescriptor as any,\n                currentPropertyDescriptor: (currentPropertyDescriptor as any)[\n                    key\n                ]\n            });\n            validationResults.push({ key, result });\n            if (!result.valid && !doNotStopOnFirstError) break;\n        }\n\n        return this.#processResults(setup, validationResults) as any;\n    }\n\n    /**\n     * Performs async validation of object schema over the `object`.\n     * Supports async preprocessors, validators, and error message providers.\n     *\n     * @param object The object to validate against this schema.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected async _validateAsync(\n        object: undefined extends TExplicitType\n            ? InferType<\n                  SchemaBuilder<\n                      undefined extends TExplicitType\n                          ? Id<RespectPropsOptionalityForInput<TProperties>>\n                          : TExplicitType,\n                      TRequired\n                  >\n              >\n            : TExplicitType,\n        context?: ValidationContext<this>\n    ): Promise<\n        ObjectSchemaValidationResult<\n            undefined extends TExplicitType\n                ? InferType<\n                      SchemaBuilder<\n                          undefined extends TExplicitType\n                              ? Id<RespectPropsOptionality<TProperties>>\n                              : TExplicitType,\n                          TRequired\n                      >\n                  >\n                : TExplicitType,\n            this\n        >\n    > {\n        const setup = this.#setupValidation(\n            await this.preValidateAsync(object, context)\n        );\n        if (setup.earlyReturn) return setup.result as any;\n\n        const {\n            propKeys,\n            objToValidate,\n            doNotStopOnFirstError,\n            rootPropertyDescriptor,\n            currentPropertyDescriptor\n        } = setup;\n\n        const validationResults: {\n            key: string;\n            result: ValidationResult<any>;\n        }[] = [];\n\n        if (doNotStopOnFirstError) {\n            const results = await Promise.all(\n                propKeys.map(async key => {\n                    const result = await this.#properties[key].validateAsync(\n                        objToValidate[key],\n                        {\n                            ...context,\n                            rootPropertyDescriptor:\n                                rootPropertyDescriptor as any,\n                            currentPropertyDescriptor: (\n                                currentPropertyDescriptor as any\n                            )[key]\n                        }\n                    );\n                    return { key, result };\n                })\n            );\n            validationResults.push(...results);\n        } else {\n            for (const key of propKeys) {\n                const result = await this.#properties[key].validateAsync(\n                    objToValidate[key],\n                    {\n                        ...context,\n                        rootPropertyDescriptor: rootPropertyDescriptor as any,\n                        currentPropertyDescriptor: (\n                            currentPropertyDescriptor as any\n                        )[key]\n                    }\n                );\n                validationResults.push({ key, result });\n                if (!result.valid) break;\n            }\n        }\n\n        return this.#processResults(setup, validationResults) as any;\n    }\n\n    /**\n     * Fields not defined in `properties` will not be validated\n     * and will be passed through the validation.\n     */\n    public acceptUnknownProps(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            acceptUnknownProps: true\n        } as any) as any;\n    }\n\n    /**\n     * Fields not defined in `properties` will be considered\n     * as schema violation. This is the default behavior.\n     */\n    public notAcceptUnknownProps(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            acceptUnknownProps: false\n        } as any) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\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(): ObjectSchemaBuilder<\n        TProperties,\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    /**\n     * Adds a new property to the object schema. The new property\n     * will be validated according to the provided schema.\n     * @param propName name of the new property\n     * @param schema schema builder of the new property\n     */\n    public addProp<\n        TType extends SchemaBuilder<any, any, any, any, any>,\n        TName extends string\n    >(\n        propName: TName,\n        schema: TType\n    ): ObjectSchemaBuilder<\n        TProperties & {\n            [k in TName]: TType;\n        },\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof propName !== 'string' || !propName) {\n            throw new Error('propName must be a non empty string');\n        }\n        if (propName in this.#properties) {\n            throw new Error(`Property ${propName} already exists`);\n        }\n        if (!(schema instanceof SchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the SchemaBuilder class'\n            );\n        }\n\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: {\n                ...this.introspect().properties,\n                [propName]: schema\n            }\n        } as any) as any;\n    }\n\n    /**\n     * @hidden\n     * @deprecated this is for internal use, do not use if you are\n     * not sure you need it.\n     *\n     * TODO: This is used to avoid `&` in resulting types. For example,\n     * when you have a schema like `object({prop1: string()})` and then use `addProp({prop2: string()})` method,\n     * the resulting type without `optimize` will be something like `{prop1: string} & {prop2: string}`. Which\n     * is not we would like to have. Instead we want to have `{prop1: string, prop2: string}`. This is what\n     * `optimize` method does. However it is not always possible to do this optimization without losing\n     * JSDoc comments, which is sucks. For example, I had to disable optimization for UnionSchemas, because\n     * comments were lost. Hopefully it will be fixed in the future by Typescript team or somebody will\n     * find a workaround/fix and create a pull request.\n     */\n    public optimize(): SchemaBuilder<\n        undefined extends TExplicitType\n            ? Id<RespectPropsOptionality<TProperties>>\n            : TExplicitType,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * Adds new properties to the object schema. The same as `.addProp()` but\n     * allows to add multiple properties with one call. The new properties\n     * will be validated according to the provided schemas.\n     * @param props a key/schema object map.\n     */\n    public addProps<\n        TProps extends Record<string, SchemaBuilder<any, any, any, any, any>>\n    >(\n        props: TProps\n    ): ObjectSchemaBuilder<\n        TProperties & TProps,\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n\n    /**\n     * Adds all properties from the `schema` object schema to the current schema.\n     * @param schema an instance of `ObjectSchemaBuilder`\n     */\n    public addProps<\n        K extends ObjectSchemaBuilder<any, any, any, any, any, any>\n    >(\n        schema: K\n    ): K extends ObjectSchemaBuilder<infer TProp, infer _, any, infer __>\n        ? ObjectSchemaBuilder<\n              Omit<TProperties, keyof TProp> & TProp,\n              TRequired,\n              TNullable,\n              TExplicitType,\n              THasDefault,\n              TExtensions\n          > &\n              TExtensions\n        : never;\n\n    public addProps(props: any) {\n        if (props instanceof ObjectSchemaBuilder) {\n            return this.addProps(props.introspect().properties);\n        }\n\n        if (typeof props !== 'object') {\n            throw new Error('props should be an object');\n        }\n        if (props === null) {\n            throw new Error('props should not be null');\n        }\n\n        const newProps = { ...this.#properties } as any;\n\n        for (const key in props) {\n            if (key in this.#properties) {\n                throw new Error(`property '${key}' already exists`);\n            }\n\n            if (!(props[key] instanceof SchemaBuilder)) {\n                throw new Error(`${key} is not a SchemaBuilder`);\n            }\n\n            newProps[key] = props[key] as any;\n        }\n\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: newProps\n        } as any) as any;\n    }\n\n    /**\n     * Omits properties listed in `properties` from the schema.\n     * Consider `Omit<Type, 'prop1'|'prop2'...>` as a good illustration\n     * from the TS world.\n     * @param properties - array of property names (strings) to remove from the schema.\n     */\n    public omit<K extends keyof TProperties>(\n        properties: K[]\n    ): ObjectSchemaBuilder<\n        Omit<TProperties, K>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n    /**\n     * Removes `propName` from the list of properties.\n     * @param propName property name to remove. Schema should contain\n     * this property. An error will be thrown otherwise.\n     */\n    public omit<TProperty extends keyof TProperties>(\n        propName: TProperty\n    ): ObjectSchemaBuilder<\n        Omit<TProperties, TProperty>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n    /**\n     * Removes all properties of `schema` from the current schema.\n     * `Omit<TSchema, keyof TAnotherSchema>` as a good illustration\n     * from the TS world.\n     * @param schema schema builder to take properties from.\n     */\n    public omit<T>(\n        schema: T\n    ): T extends ObjectSchemaBuilder<\n        infer TProps,\n        infer TRequired,\n        any,\n        infer TExplicitType\n    >\n        ? ObjectSchemaBuilder<\n              Omit<TProperties, keyof TProps>,\n              TRequired,\n              TNullable,\n              TExplicitType,\n              THasDefault,\n              TExtensions\n          > &\n              TExtensions\n        : never;\n\n    public omit(propNameOrArrayOrPropsOrBuilder: any): any {\n        if (typeof propNameOrArrayOrPropsOrBuilder === 'string') {\n            // remove one field\n            const propName =\n                propNameOrArrayOrPropsOrBuilder as keyof TProperties;\n\n            if (!propName || !(propName in this.#properties)) {\n                throw new Error(\n                    `property ${propName.toString()} does not exists in the schema`\n                );\n            }\n\n            return this.createFromProps({\n                ...this.introspect(),\n                properties: (() => {\n                    const result = { ...this.#properties };\n                    delete result[propName];\n                    return result;\n                })()\n            } as any);\n        } else if (Array.isArray(propNameOrArrayOrPropsOrBuilder)) {\n            const propsArray = propNameOrArrayOrPropsOrBuilder as Array<\n                keyof TProperties\n            >;\n\n            const distinctKeys = new Map<keyof TProperties, true>();\n            propsArray.forEach(key => {\n                if (typeof key !== 'string' || !key) {\n                    throw new Error('property name must be a string');\n                }\n\n                if (!(key in this.#properties)) {\n                    throw new Error(\n                        `property ${key.toString()} does not exists in the schema`\n                    );\n                }\n\n                distinctKeys.set(key.toString(), true);\n            });\n\n            if (distinctKeys.size === 0) {\n                throw new Error('please provide at least one property to omit');\n            }\n\n            const props = {\n                ...this.introspect()\n            };\n\n            for (const key of distinctKeys.keys()) {\n                delete props.properties[key];\n            }\n\n            return this.createFromProps(props as any);\n        } else if (\n            propNameOrArrayOrPropsOrBuilder instanceof ObjectSchemaBuilder\n        ) {\n            const propsToOmit = {\n                ...propNameOrArrayOrPropsOrBuilder.introspect().properties\n            };\n\n            const props = {\n                ...this.introspect()\n            };\n\n            for (const key in propsToOmit) {\n                if (key in props.properties) {\n                    delete props.properties[key];\n                }\n            }\n\n            return this.createFromProps(props as any);\n        }\n\n        throw new Error('this parameter type is not supported');\n    }\n\n    /**\n     * Adds all properties from `schema` to the current schema.\n     * `TSchema & TAnotherSchema` is a good example of the similar concept\n     * in the TS type system.\n     * @param schema an object schema to take properties from\n     */\n    public intersect<\n        T extends ObjectSchemaBuilder<any, any, any, any, any, any>\n    >(\n        schema: T\n    ): T extends ObjectSchemaBuilder<\n        infer TProps,\n        infer _,\n        any,\n        infer TExplType\n    >\n        ? ObjectSchemaBuilder<\n              Omit<TProperties, keyof TProps> & TProps,\n              TRequired,\n              TNullable,\n              TExplType,\n              THasDefault,\n              TExtensions\n          > &\n              TExtensions\n        : never {\n        if (!(schema instanceof ObjectSchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the ObjectSchemaBuilder class'\n            );\n        }\n\n        const remoteProps = schema.introspect().properties;\n\n        const localProps = this.introspect();\n\n        const newProps = Object.keys(localProps.properties).reduce(\n            (acc, curr) => {\n                acc[curr] =\n                    curr in remoteProps\n                        ? remoteProps[curr]\n                        : localProps.properties[curr];\n                return acc;\n            },\n            {} as Record<string, any>\n        );\n\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: newProps\n        } as any) as any;\n    }\n\n    /**\n     * Marks all properties in the current schema as optional.\n     * It is the same as call `.optional('propname')` where `propname` is the name\n     * of every property in the schema.\n     */\n    public partial(): ObjectSchemaBuilder<\n        MakeChildrenOptional<TProperties>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n    /**\n     * Marks all properties from `properties` as optional in the schema.\n     * @param properties list of property names (string) to make optional\n     */\n    public partial<K extends keyof TProperties>(\n        properties: K[]\n    ): ObjectSchemaBuilder<\n        Omit<TProperties, K> & Pick<MakeChildrenOptional<TProperties>, K>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n    /**\n     * Marks property `propName` as optional in the schema.\n     * @param propName the name of the property (string).\n     */\n    public partial<TProperty extends keyof TProperties>(\n        propName: TProperty\n    ): ObjectSchemaBuilder<\n        Omit<TProperties, TProperty> &\n            Pick<MakeChildrenOptional<TProperties>, TProperty>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n\n    public partial(propNameOrArray?: any): any {\n        if (\n            typeof propNameOrArray === 'undefined' ||\n            propNameOrArray === null\n        ) {\n            return this.createFromProps({\n                ...this.introspect(),\n                properties: Object.keys(this.#properties).reduce(\n                    (acc, key) => {\n                        acc[key] = this.#properties[key].optional();\n                        return acc;\n                    },\n                    {} as Record<string, any>\n                )\n            } as any);\n        }\n\n        if (Array.isArray(propNameOrArray)) {\n            const propsArray = propNameOrArray as (keyof TProperties)[];\n            if (propsArray.length === 0) {\n                throw new Error('properties cannot be empty');\n            }\n\n            const newProps = {\n                ...this.introspect()\n            } as any;\n\n            propsArray.forEach(key => {\n                if (typeof key !== 'string') {\n                    throw new Error(\n                        'each propery in property list must be as string value'\n                    );\n                }\n                if (!(key in newProps.properties)) {\n                    throw new Error(\n                        `property ${key as string} does not exists`\n                    );\n                }\n\n                newProps.properties[key as keyof TProperties] =\n                    newProps.properties[key].optional();\n            });\n\n            return this.createFromProps(newProps);\n        }\n\n        if (typeof propNameOrArray === 'string') {\n            return this.modifyPropSchema(\n                propNameOrArray as keyof TProperties,\n                schema => schema.optional()\n            );\n        }\n\n        throw new Error('expecting string or string[] parameter');\n    }\n\n    /**\n     * Recursively marks all properties — and all properties of nested\n     * `object()` schemas — as optional.  Useful for PATCH API bodies\n     * and partial form state where every field at every level is optional.\n     *\n     * Only nested `ObjectSchemaBuilder` schemas are recursed into.\n     * Other schema types (arrays, unions, primitives, lazy) are made\n     * optional at the top level but their internals are not modified.\n     *\n     * @example\n     * ```ts\n     * const Address = object({\n     *   street: string(),\n     *   city:   string()\n     * });\n     *\n     * const User = object({\n     *   name:    string(),\n     *   address: Address\n     * });\n     *\n     * const PatchUser = User.deepPartial();\n     * // PatchUser infers as:\n     * // { name?: string; address?: { street?: string; city?: string } }\n     *\n     * PatchUser.validate({ address: { city: 'Paris' } }); // valid\n     * PatchUser.validate({});                              // valid\n     * ```\n     *\n     * @example\n     * ```ts\n     * // Three-level nesting\n     * const schema = object({\n     *   a: object({\n     *     b: object({ c: string() })\n     *   })\n     * }).deepPartial();\n     *\n     * schema.validate({});               // valid\n     * schema.validate({ a: {} });        // valid\n     * schema.validate({ a: { b: {} } }); // valid\n     * ```\n     *\n     * @example\n     * ```ts\n     * // PATCH API body\n     * const CreateBody = object({\n     *   profile: object({ displayName: string(), bio: string() }),\n     *   settings: object({ theme: string(), language: string() })\n     * });\n     *\n     * const PatchBody = CreateBody.deepPartial();\n     * // All fields are optional at every level —\n     * // send only what you want to update.\n     * ```\n     *\n     * @see {@link partial} for shallow-only property optionality.\n     */\n    public deepPartial(): ObjectSchemaBuilder<\n        DeepMakeChildrenOptional<TProperties>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const newProps: Record<\n            string,\n            SchemaBuilder<any, any, any, any, any>\n        > = {};\n        for (const key of Object.keys(this.#properties)) {\n            const prop = this.#properties[key];\n            if (prop instanceof ObjectSchemaBuilder) {\n                newProps[key] = (\n                    prop as ObjectSchemaBuilder<any, any, any, any, any>\n                )\n                    .deepPartial()\n                    .optional();\n            } else {\n                newProps[key] = prop.optional();\n            }\n        }\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: newProps\n        } as any) as any;\n    }\n\n    /**\n     * Returns a new schema containing only properties listed in\n     * `properties` array.\n     * @param properties array of property names (strings)\n     */\n    public pick<K extends keyof TProperties>(\n        properties: K[]\n    ): ObjectSchemaBuilder<\n        Pick<TProperties, K>,\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n    /**\n     * Returns new schema based on the current schema. This new schema\n     * will consists only from properties which names are taken from the\n     * `schema` object schema.\n     * @param schema schema to take property names list from\n     */\n    public pick<K extends ObjectSchemaBuilder<any, any, any, any, any, any>>(\n        schema: K\n    ): K extends ObjectSchemaBuilder<infer TProps, infer _, any, infer __>\n        ? ObjectSchemaBuilder<\n              Omit<TProperties, keyof Omit<TProperties, keyof TProps>>,\n              TRequired,\n              TNullable,\n              undefined,\n              THasDefault,\n              TExtensions\n          > &\n              TExtensions\n        : never;\n\n    /**\n     * Returns a new schema consisting of only one property\n     * (taken from the `property` property name). If the property\n     * does not exists in the current schema, an error will be thrown.\n     * @param property the name of the property (string).\n     */\n    public pick<K extends keyof TProperties>(\n        property: K\n    ): ObjectSchemaBuilder<\n        Pick<TProperties, K>,\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions;\n\n    public pick(properties: any): any {\n        if (typeof properties === 'string') {\n            const property = properties as string;\n\n            if (!property) {\n                throw new Error('property cannot be empty');\n            }\n\n            if (!(property in this.#properties)) {\n                throw new Error(`property ${property} does not exists`);\n            }\n\n            return this.createFromProps({\n                ...this.introspect(),\n                properties: {\n                    [property]: this.#properties[property]\n                }\n            } as any);\n        }\n\n        if (Array.isArray(properties)) {\n            if (properties.length === 0) {\n                throw new Error('properties must be a non empty erray');\n            }\n            const newProperties = properties.reduce((acc, curr) => {\n                if (typeof curr !== 'string' || !curr) {\n                    throw new Error(\n                        'each property name must be a non empty string'\n                    );\n                }\n                if (!(curr in this.#properties)) {\n                    throw new Error(`property ${curr} does not exists`);\n                }\n\n                acc[curr] = this.#properties[curr];\n                return acc;\n            }, {});\n\n            return this.createFromProps({\n                ...this.introspect(),\n                properties: newProperties\n            } as any);\n        }\n\n        if (properties instanceof ObjectSchemaBuilder) {\n            const externalSchema = properties as ObjectSchemaBuilder;\n\n            const props = Object.keys(\n                externalSchema.introspect().properties\n            ).filter(p => typeof this.#properties[p] !== 'undefined');\n            if (props.length === 0) {\n                throw new Error(\n                    'there are no common properties in provided schemas'\n                );\n            }\n            return this.pick(props as any as keyof TProperties);\n        }\n\n        throw new Error('string, array or ObjectSchemaBuilder is expected');\n    }\n\n    /**\n     * Modify schema for `propName` and return a new schema.\n     * Could be useful if you want to leave all schema intact, but\n     * change a type of one property.\n     * @param propName name of the property (string)\n     * @param callback callback function returning a new schema fo the `propName`. As a first parameter\n     * you will receive an old schema for `propName`.\n     * @returns\n     */\n    public modifyPropSchema<\n        K extends keyof TProperties,\n        R extends SchemaBuilder<any, any, any, any, any>\n    >(\n        propName: K,\n        callback: (builder: TProperties[K]) => R\n    ): ObjectSchemaBuilder<\n        ModifyPropSchema<TProperties, K, R>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof propName !== 'string' || !propName) {\n            throw new Error('propName must be a non empty string');\n        }\n\n        if (!(propName in this.#properties)) {\n            throw new Error(\n                `property ${propName} does not exists in the schema`\n            );\n        }\n\n        if (typeof callback !== 'function') {\n            throw new Error('callback must be a function');\n        }\n\n        const callbackResult = callback(this.#properties[propName]);\n        if (!(callbackResult instanceof SchemaBuilder)) {\n            throw new Error('callback must return a SchemaBuilder object');\n        }\n\n        const props = {\n            ...this.introspect()\n        } as any;\n\n        props.properties = {\n            ...props.properties,\n            [propName]: callbackResult\n        };\n\n        return this.createFromProps(props) as any;\n    }\n\n    /**\n     * An alias for `.partial(prop: string)`\n     * @param prop name of the property\n     */\n    public makePropOptional<K extends keyof TProperties>(\n        prop: K\n    ): ObjectSchemaBuilder<\n        MakeChildOptional<TProperties, K>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.modifyPropSchema(prop, builder =>\n            builder.optional()\n        ) as any;\n    }\n\n    /**\n     * Marks `prop` as required property.\n     * If `prop` does not exists in the current schema,\n     * an error will be thrown.\n     * @param prop name of the property\n     */\n    public makePropRequired<K extends keyof TProperties>(\n        prop: K\n    ): ObjectSchemaBuilder<\n        MakeChildRequired<TProperties, K>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.modifyPropSchema(prop, builder =>\n            builder.required()\n        ) as any;\n    }\n\n    /**\n     * `Partial<T>` would be a good example of the\n     * same operation in the TS world.\n     */\n    public makeAllPropsOptional(): ObjectSchemaBuilder<\n        MakeChildrenOptional<TProperties>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: Object.keys(this.#properties).reduce(\n                (acc, curr) => {\n                    acc[curr] = this.#properties[curr].optional();\n                    return acc;\n                },\n                {} as Record<string, any>\n            )\n        } as any) as any;\n    }\n\n    /**\n     * `Required<T>` would be a good example of the\n     * same operation in the TS world.\n     */\n    public makeAllPropsRequired(): ObjectSchemaBuilder<\n        MakeChildrenRequired<TProperties>,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            properties: Object.keys(this.#properties).reduce(\n                (acc, curr) => {\n                    acc[curr] = this.#properties[curr].required();\n                    return acc;\n                },\n                {} as Record<string, any>\n            )\n        } as any) as any;\n    }\n\n    static #getPropertiesFor<\n        TProperties extends Record<\n            string,\n            SchemaBuilder<any, any, any, any, any>\n        > = {},\n        TRequired extends boolean = true,\n        TExplicitType = undefined,\n        TSchema extends ObjectSchemaBuilder<\n            any,\n            any,\n            any,\n            any\n        > = ObjectSchemaBuilder<TProperties, TRequired, false, TExplicitType>\n    >(\n        schema: TSchema,\n        /* this is to make possibility to traverse the tree and select properties */\n        selector?: (arg1: any, arg2: any) => any,\n        /* parent object to have a possibility to get link to itself */\n        parentSelector?: any,\n        /* used to pass the needed property name if `parentSelector` is provided. */\n        currentName?: string,\n        parentDescriptor?: PropertyDescriptorInner<any, any, any>\n    ): PropertyDescriptorTree<TSchema> {\n        const introspected = schema.introspect();\n        if (!introspected.properties) {\n            return {} as any;\n        }\n\n        const propsNames = Object.keys(introspected.properties);\n\n        if (propsNames.length === 0) {\n            return {} as any;\n        }\n\n        if (typeof selector !== 'function') {\n            selector = o => o;\n        }\n        const result = createPropertyDescriptorFor(\n            (obj, createMissingStructure) =>\n                (parentSelector || selector)(obj, createMissingStructure),\n            currentName,\n            schema,\n            parentDescriptor\n        );\n\n        for (const propName of propsNames) {\n            const propSchema = introspected.properties[propName];\n            if (propSchema instanceof ObjectSchemaBuilder) {\n                const childProperties = propSchema.introspect().properties;\n                if (\n                    childProperties &&\n                    typeof childProperties === 'object' &&\n                    Object.keys(childProperties).length > 0\n                ) {\n                    (result as any)[propName] = (\n                        ObjectSchemaBuilder.#getPropertiesFor as any\n                    )(\n                        propSchema,\n                        (tree: any, createMissingStructure: any) => {\n                            const selectorResult = selector(\n                                tree,\n                                createMissingStructure\n                            );\n                            if (selectorResult) {\n                                if (\n                                    createMissingStructure &&\n                                    !selectorResult[propName]\n                                ) {\n                                    selectorResult[propName] = {};\n                                }\n                                return selectorResult[propName];\n                            }\n                            return null;\n                        },\n                        selector,\n                        propName,\n                        result[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                    );\n                } else {\n                    (result as any)[propName] = createPropertyDescriptorFor(\n                        selector,\n                        propName,\n                        propSchema,\n                        result[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                    );\n                }\n            } else if ((propSchema as any)[SYMBOL_HAS_PROPERTIES] === true) {\n                // Extern schema — create a Proxy-based descriptor that\n                // lazily creates child descriptors on property access.\n                const externBase = createPropertyDescriptorFor(\n                    selector,\n                    propName,\n                    propSchema,\n                    result[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                );\n                const externValueSelector = (\n                    tree: any,\n                    createMissingStructure: boolean\n                ) => {\n                    const selectorResult = selector(\n                        tree,\n                        createMissingStructure\n                    );\n                    if (selectorResult) {\n                        if (\n                            createMissingStructure &&\n                            !selectorResult[propName]\n                        ) {\n                            selectorResult[propName] = {};\n                        }\n                        return selectorResult[propName];\n                    }\n                    return null;\n                };\n                (result as any)[propName] = createExternProxyDescriptor(\n                    externBase,\n                    externValueSelector\n                );\n            } else {\n                (result as any)[propName] = createPropertyDescriptorFor(\n                    selector,\n                    propName,\n                    propSchema,\n                    result[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                );\n            }\n        }\n\n        return result as any;\n    }\n\n    public static getPropertiesFor<\n        TProperties extends Record<\n            string,\n            SchemaBuilder<any, any, any, any, any>\n        > = {},\n        TRequired extends boolean = true,\n        TExplicitType = undefined,\n        TSchema extends ObjectSchemaBuilder<\n            any,\n            any,\n            any,\n            any\n        > = ObjectSchemaBuilder<TProperties, TRequired, false, TExplicitType>\n    >(schema: TSchema): PropertyDescriptorTree<TSchema, TSchema> {\n        if (!(schema instanceof ObjectSchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the ObjectSchemaBuilder class'\n            );\n        }\n\n        if (schema.#propertyDescriptorTreeMap.has(schema)) {\n            return schema.#propertyDescriptorTreeMap.get(schema) as any;\n        }\n\n        const result = ObjectSchemaBuilder.#getPropertiesFor(schema);\n        schema.#propertyDescriptorTreeMap.set(schema, result);\n\n        return result;\n    }\n\n    public static isValidPropertyDescriptor(\n        descriptor: PropertyDescriptor<any, any, any>\n    ) {\n        return (\n            typeof descriptor === 'object' &&\n            descriptor !== null &&\n            typeof descriptor[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR] === 'object'\n        );\n    }\n\n    static #propagateNestedErrors(\n        result: any,\n        descriptor: any,\n        addErrorFor: (\n            descriptor: any,\n            message: string,\n            parentDescriptor?: any\n        ) => void\n    ): void {\n        const schema =\n            ObjectSchemaBuilder.#getSchemaForPropertyDescriptor(descriptor);\n        const properties = (schema.introspect() as any).properties;\n\n        // Determine which property names to iterate:\n        // • For ObjectSchemaBuilder — use introspect().properties keys\n        // • For ExternSchemaBuilder — use __externErrorPropertyNames from the result\n        let propertyNames: string[];\n        if (properties) {\n            propertyNames = Object.keys(properties);\n        } else if (Array.isArray((result as any).__externErrorPropertyNames)) {\n            propertyNames = (result as any).__externErrorPropertyNames;\n        } else {\n            return;\n        }\n\n        for (const nestedPropertyName of propertyNames) {\n            const nestedPropertyDescriptor = descriptor[nestedPropertyName];\n            if (\n                !ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    nestedPropertyDescriptor\n                )\n            ) {\n                continue;\n            }\n            const nestedValidationError = result.getErrorsFor(\n                () => nestedPropertyDescriptor\n            );\n            if (!nestedValidationError.isValid) {\n                for (const validationError of nestedValidationError.errors) {\n                    addErrorFor(\n                        nestedPropertyDescriptor,\n                        validationError,\n                        descriptor\n                    );\n                }\n            }\n            // Recurse into nested object schemas (only when we have a property map)\n            if (properties) {\n                const nestedSchema = properties[nestedPropertyName];\n                if (\n                    (nestedSchema instanceof ObjectSchemaBuilder ||\n                        (nestedSchema as any)[SYMBOL_HAS_PROPERTIES] ===\n                            true) &&\n                    typeof result.getErrorsFor === 'function' &&\n                    ObjectSchemaBuilder.isValidPropertyDescriptor(\n                        nestedPropertyDescriptor\n                    )\n                ) {\n                    ObjectSchemaBuilder.#propagateNestedErrors(\n                        result,\n                        nestedPropertyDescriptor,\n                        addErrorFor\n                    );\n                }\n            }\n        }\n    }\n\n    static #getSchemaForPropertyDescriptor(\n        descriptor: PropertyDescriptor<any, any, any>\n    ): SchemaBuilder<any, any, any, any, any> {\n        if (!ObjectSchemaBuilder.isValidPropertyDescriptor(descriptor)) {\n            throw new Error('descriptor is not a valid property descriptor');\n        }\n\n        return descriptor[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR].getSchema();\n    }\n\n    public nullable(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        true,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > {\n        return super.nullable() as any;\n    }\n\n    public notNullable(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > {\n        return super.notNullable() as any;\n    }\n}\n\nexport interface Object {\n    /**\n     * Defines a schema for empty object `{}`\n     */\n    (): ObjectSchemaBuilder<{}, true>;\n    /**\n     * Defines an object schema, properties definitions are takens from `props`.\n     * @param props key/schema object map for schema's properties.\n     */\n    <TProps extends Record<string, SchemaBuilder<any, any, any, any, any>>>(\n        props: TProps\n    ): ObjectSchemaBuilder<TProps, true>;\n    /**\n     * Defines an object schema, properties definitions are takens from `props`.\n     * @param props key/schema object map for schema's properties.\n     */\n    <TProps extends Record<string, SchemaBuilder<any, any, any, any, any>>>(\n        props?: TProps\n    ): ObjectSchemaBuilder<TProps, true>;\n    /**\n     * Returns a tree of property descriptors for the given `schema`.\n     * The structure of the tree is the same as the structure of the `schema`.\n     * Which gives you an opportunity to access property descriptors for each\n     * property in the schema in a useful and type-safe way.\n     * @param schema\n     */\n    getPropertiesFor<\n        TProperties extends Record<\n            string,\n            SchemaBuilder<any, any, any, any, any>\n        > = {},\n        TRequired extends boolean = true,\n        TExplicitType = undefined,\n        TSchema extends ObjectSchemaBuilder<\n            any,\n            any,\n            any,\n            any\n        > = ObjectSchemaBuilder<TProperties, TRequired, false, TExplicitType>\n    >(schema: TSchema): PropertyDescriptorTree<TSchema, TSchema>;\n\n    /**\n     * Verifies if the given `descriptor` is a valid property descriptor.\n     * @param descriptor a property descriptor to check\n     */\n    isValidPropertyDescriptor(\n        descriptor: PropertyDescriptor<any, any, any>\n    ): boolean;\n}\n\nconst object = (props => {\n    return ObjectSchemaBuilder.create({\n        isRequired: true,\n        properties: props\n    }) as any;\n}) as Object;\n\ntype PropertyDescriptorMap = Map<\n    ObjectSchemaBuilder<any, any, any, any, any, any>,\n    PropertyDescriptorMap | PropertyDescriptorTree<any, any>\n>;\n\nconst createPropertyDescriptorFor = (\n    selector: (arg0: any, arg1: boolean) => any,\n    propertyName?: string,\n    schema?: SchemaBuilder<any, any, any, any, any>,\n    parent?: PropertyDescriptorInner<any, any, any>\n) => ({\n    [SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]: {\n        setValue: (\n            obj: any,\n            newValue: any,\n            options?: PropertySetterOptions\n        ) => {\n            const selectorResult = selector(\n                obj,\n                !!options?.createMissingStructure\n            );\n            if (!selectorResult) return false;\n\n            if (typeof propertyName === 'string') {\n                selectorResult[propertyName] = newValue;\n            }\n\n            return true;\n        },\n        getValue: (obj: any) => {\n            const selectorResult = selector(obj, false);\n            if (!selectorResult)\n                return {\n                    success: false\n                };\n\n            if (typeof propertyName !== 'string') {\n                return {\n                    success: true,\n                    value: selectorResult\n                };\n            }\n\n            if (Object.hasOwn(selectorResult, propertyName)) {\n                return {\n                    success: true,\n                    value: selectorResult[propertyName]\n                };\n            }\n\n            return {\n                success: false\n            };\n        },\n\n        getSchema: () => schema,\n        parent\n    }\n});\n\n/**\n * Creates a Proxy-wrapped property descriptor for an extern schema.\n * Child descriptors are lazily created when accessed by name, enabling\n * `getErrorsFor(t => t.order.id)` navigation without an explicit\n * property map.\n *\n * Each child is also Proxy-wrapped for arbitrary-depth navigation.\n *\n * @param baseDescriptor - The base descriptor (with SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR)\n * @param valueSelector  - Selector that navigates to the extern's VALUE in the root object\n */\nconst createExternProxyDescriptor = (\n    baseDescriptor: ReturnType<typeof createPropertyDescriptorFor>,\n    valueSelector: (obj: any, createMissingStructure: boolean) => any\n): any =>\n    new Proxy(baseDescriptor, {\n        get(target: any, prop: PropertyKey, receiver: any): any {\n            // Fast path for the descriptor symbol — no interception\n            if (prop === SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR) {\n                return target[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR];\n            }\n\n            // For string keys, lazily create and cache child descriptors\n            if (typeof prop === 'string' && !(prop in target)) {\n                const child = createPropertyDescriptorFor(\n                    valueSelector,\n                    prop,\n                    undefined,\n                    target[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                );\n\n                // Build a value selector for the child's own children\n                const childValueSelector = (\n                    obj: any,\n                    createMissingStructure: boolean\n                ) => {\n                    const parentValue = valueSelector(\n                        obj,\n                        createMissingStructure\n                    );\n                    if (\n                        parentValue != null &&\n                        typeof parentValue === 'object'\n                    ) {\n                        if (createMissingStructure && !(prop in parentValue)) {\n                            parentValue[prop as string] = {};\n                        }\n                        return parentValue[prop as string];\n                    }\n                    return null;\n                };\n\n                // Recursively wrap so deeper paths like t.order.address.city work\n                target[prop] = createExternProxyDescriptor(\n                    child,\n                    childValueSelector\n                );\n            }\n\n            return Reflect.get(target, prop, receiver);\n        }\n    });\n\n(object as any).getPropertiesFor = <\n    TProperties extends Record<\n        string,\n        SchemaBuilder<any, any, any, any, any>\n    > = {},\n    TRequired extends boolean = true,\n    TExplicitType = undefined,\n    TSchema extends ObjectSchemaBuilder<\n        any,\n        any,\n        any,\n        any\n    > = ObjectSchemaBuilder<TProperties, TRequired, false, TExplicitType>\n>(\n    schema: ObjectSchemaBuilder<TProperties, TRequired, false, TExplicitType>\n): PropertyDescriptorTree<TSchema, TSchema> =>\n    ObjectSchemaBuilder.getPropertiesFor(schema) as any;\n\n(object as any).isValidPropertyDescriptor =\n    ObjectSchemaBuilder.isValidPropertyDescriptor;\n\nexport { object };\n\ntype RequiredProps<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = keyof {\n    [k in keyof T as T[k] extends SchemaBuilder<any, infer TReq, any, any>\n        ? TReq extends true\n            ? k\n            : never\n        : never]: T[k];\n};\n\ntype NotRequiredProps<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = keyof {\n    [k in keyof T as T[k] extends SchemaBuilder<any, infer TReq, any, any>\n        ? TReq extends true\n            ? never\n            : k\n        : never]: T[k];\n};\n\ntype RequiredInputProps<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = keyof {\n    [k in keyof T as T[k] extends SchemaBuilder<\n        any,\n        infer TReq,\n        any,\n        infer THasDef\n    >\n        ? TReq extends true\n            ? THasDef extends true\n                ? never\n                : k\n            : never\n        : never]: T[k];\n};\n\ntype NotRequiredInputProps<\n    T extends Record<string, SchemaBuilder<any, any, any, any, any>>\n> = keyof {\n    [k in keyof T as T[k] extends SchemaBuilder<\n        any,\n        infer TReq,\n        any,\n        infer THasDef\n    >\n        ? TReq extends true\n            ? THasDef extends true\n                ? k\n                : never\n            : k\n        : never]: T[k];\n};\n"],"mappings":"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","names":["PropertyValidationResult","#descriptor","#rootObjectValue","#errors","#childErrors","result","SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR","descriptor","rootObjectValue","errors","ObjectSchemaBuilder","error","childError","MUST_BE_AN_OBJECT_ERROR_MESSSAGE","ObjectSchemaBuilder","_ObjectSchemaBuilder","SchemaBuilder","#properties","#acceptUnknownProps","#propKeys","SYMBOL_HAS_PROPERTIES","#propertyDescriptorTreeMap","props","errorMessage","value","_name","#applyPropertyDescriptors","result","object","context","#setupValidation","prevalidatedResult","valid","prevalidationContext","validationTransaction","preValidationErrors","propertyDescriptorToErrorMap","doNotStopOnFirstError","rootValidationObject","rootPropertyDescriptor","currentPropertyDescriptor","addErrorFor","propertyDescriptor","message","parentPropertyDescriptor","validationError","PropertyValidationResult","parentValidationError","getErrorsFor","selector","descriptor","errors","error","objToValidate","propKeys","objKeys","i","#processResults","setup","validationResults","hasInvalid","key","resultObject","#propagateNestedErrors","self","#validateFull","results","_notUsed","propName","schema","newProps","propNameOrArrayOrPropsOrBuilder","propsArray","distinctKeys","propsToOmit","remoteProps","localProps","acc","curr","propNameOrArray","prop","properties","property","newProperties","p","callback","callbackResult","builder","#getPropertiesFor","parentSelector","currentName","parentDescriptor","introspected","propsNames","o","createPropertyDescriptorFor","obj","createMissingStructure","propSchema","childProperties","tree","selectorResult","SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR","externBase","externValueSelector","createExternProxyDescriptor","#getSchemaForPropertyDescriptor","propertyNames","nestedPropertyName","nestedPropertyDescriptor","nestedValidationError","nestedSchema","propertyName","parent","newValue","options","baseDescriptor","valueSelector","target","receiver","child","childValueSelector","parentValue"]}

package/dist/chunk-S5TC6NSU.js

@@ -0,0 +1,2 @@
+import{c as p,e as f,f as T}from"./chunk-CTP4RHDG.js";var m=class h extends T{#e;#t;static create(e){return new h({type:"tuple",...e})}constructor(e){super(e),Array.isArray(e.elements)?this.#e=e.elements:this.#e=[],e.restSchema instanceof T&&(this.#t=e.restSchema)}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#a(e){if(e.length<this.#e.length){let l=this.#e.length;return`expected a tuple with at least ${l} element${l===1?"":"s"}, got ${e.length}`}if(!(this.#t instanceof T)&&e.length!==this.#e.length){let l=this.#e.length;return`expected a tuple of exactly ${l} element${l===1?"":"s"}, got ${e.length}`}return null}#n(e,l){let{valid:o,context:r,errors:a,transaction:n}=l,i={[p]:{setValue:()=>!1,getValue:t=>({success:!0,value:t}),getSchema:()=>this,parent:void 0}},d=[],y=f([],()=>e,()=>d,()=>i[p]),c=(()=>y);if(!o)return d.push(...(a||[]).map(t=>t.message||String(t))),{needsElementValidation:!1,result:{valid:o,errors:a,getNestedErrors:c}};let{object:{validatedObject:u}}=n;return typeof u>"u"&&!this.isRequired||u===null&&(!this.isRequired||this.isNullable)?{needsElementValidation:!1,result:{valid:!0,object:u,getNestedErrors:c}}:Array.isArray(u)?{needsElementValidation:!0,objToValidate:u,prevalidationContext:r,getNestedErrors:c,elementResults:y,rootErrors:d}:(d.push("array expected"),{needsElementValidation:!1,result:{valid:!1,errors:[{message:"array expected"}],getNestedErrors:c}})}#r(e,l,o){let r=!0;for(let a=0;a<e.length;a++)e[a]?.valid||(r=!1),l[a]=e[a];return Object.assign({valid:r,getNestedErrors:o},r?{}:{errors:e.map(a=>a?.errors).filter(a=>a).flatMap(a=>a?.map(n=>({...n})))},r?{object:e.map(a=>a?.object)}:{})}validate(e,l){return super.validate(e,l)}async validateAsync(e,l){return super.validateAsync(e,l)}_validate(e,l){if(this.canSkipPreValidation&&!l?.doNotStopOnFirstError){if(typeof e>"u"||e===null)if(typeof e>"u"&&this.hasDefault)e=this.resolveDefaultValue();else if(!this.isRequired||e===null&&this.isNullable){let n=this;return{valid:!0,object:e,getNestedErrors(){return n.#s(e,l).getNestedErrors()}}}else return this.#s(e,l);if(!Array.isArray(e))return this.#s(e,l);let o=this.#a(e);if(o){let n=this;return{valid:!1,errors:[{message:o}],getNestedErrors(){return n.#s(e,l).getNestedErrors()}}}let r=new Array(e.length);for(let n=0;n<this.#e.length;n++){let i=this.#e[n].validate(e[n]);if(!i.valid){let d=this;return{valid:!1,errors:i.errors&&i.errors.length>0?[i.errors[0]]:[],getNestedErrors(){return d.#s(e,l).getNestedErrors()}}}r[n]=i.object}if(this.#t instanceof T)for(let n=this.#e.length;n<e.length;n++){let i=this.#t.validate(e[n]);if(!i.valid){let d=this;return{valid:!1,errors:i.errors&&i.errors.length>0?[i.errors[0]]:[],getNestedErrors(){return d.#s(e,l).getNestedErrors()}}}r[n]=i.object}let a=this;return{valid:!0,object:r,getNestedErrors(){return a.#s(e,l).getNestedErrors()}}}return this.#s(e,l)}#s(e,l){let o=this.#n(e,this.preValidateSync(e,l));if(!o.needsElementValidation)return o.result;let{objToValidate:r,prevalidationContext:a,getNestedErrors:n,elementResults:i,rootErrors:d}=o,y=this.#a(r);if(y)return d.push(y),{valid:!1,errors:[{message:y}],getNestedErrors:n};let c=this.#t instanceof T?r.length:this.#e.length;if(a.doNotStopOnFirstError){let u=new Array(c);for(let t=0;t<this.#e.length;t++)u[t]=this.#e[t].validate(r[t],{...a});if(this.#t instanceof T)for(let t=this.#e.length;t<r.length;t++)u[t]=this.#t.validate(r[t],{...a});return this.#r(u,i,n)}else{let u=new Array(c);for(let t=0;t<this.#e.length;t++){let s=this.#e[t].validate(r[t],{...a});if(i[t]=s,s.valid)u[t]=s.object;else return{valid:!1,errors:Array.isArray(s.errors)&&s.errors.length>0?[s.errors[0]]:[],getNestedErrors:n}}if(this.#t instanceof T)for(let t=this.#e.length;t<r.length;t++){let s=this.#t.validate(r[t],{...a});if(i[t]=s,s.valid)u[t]=s.object;else return{valid:!1,errors:Array.isArray(s.errors)&&s.errors.length>0?[s.errors[0]]:[],getNestedErrors:n}}return{valid:!0,object:u,getNestedErrors:n}}}async _validateAsync(e,l){let o=this.#n(e,await super.preValidateAsync(e,l));if(!o.needsElementValidation)return o.result;let{objToValidate:r,prevalidationContext:a,getNestedErrors:n,elementResults:i,rootErrors:d}=o,y=this.#a(r);if(y)return d.push(y),{valid:!1,errors:[{message:y}],getNestedErrors:n};let c=this.#t instanceof T?r.length:this.#e.length;if(a.doNotStopOnFirstError){let u=new Array(c);for(let s=0;s<this.#e.length;s++)u[s]=this.#e[s].validateAsync(r[s],{...a});if(this.#t instanceof T)for(let s=this.#e.length;s<r.length;s++)u[s]=this.#t.validateAsync(r[s],{...a});let t=await Promise.all(u);return this.#r(t,i,n)}else{let u=new Array(c);for(let t=0;t<this.#e.length;t++){let s=await this.#e[t].validateAsync(r[t],{...a});if(i[t]=s,s.valid)u[t]=s.object;else return{valid:!1,errors:Array.isArray(s.errors)&&s.errors.length>0?[s.errors[0]]:[],getNestedErrors:n}}if(this.#t instanceof T)for(let t=this.#e.length;t<r.length;t++){let s=await this.#t.validateAsync(r[t],{...a});if(i[t]=s,s.valid)u[t]=s.object;else return{valid:!1,errors:Array.isArray(s.errors)&&s.errors.length>0?[s.errors[0]]:[],getNestedErrors:n}}return{valid:!0,object:u,getNestedErrors:n}}}createFromProps(e){return h.create(e)}required(e){return super.required(e)}optional(){return super.optional()}default(e){return super.default(e)}clearDefault(){return super.clearDefault()}brand(e){return super.brand(e)}introspect(){return{...super.introspect(),elements:this.#e,restSchema:this.#t}}rest(e){return h.create({...this.introspect(),restSchema:e})}clearRest(){return h.create({...this.introspect(),restSchema:void 0})}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},R=h=>m.create({isRequired:!0,elements:h});export{m as a,R as b};
+//# sourceMappingURL=chunk-S5TC6NSU.js.map