@cleverbrush/schema 2.0.0 → 3.0.0

package/dist/chunk-GXPV6UQK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/GenericSchemaBuilder.ts","../src/builders/LazySchemaBuilder.ts","../src/builders/NullSchemaBuilder.ts","../src/extension.ts"],"sourcesContent":["import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype GenericSchemaBuilderCreateProps<TRequired extends boolean = true> =\n    Partial<ReturnType<GenericSchemaBuilder<any, TRequired>['introspect']>>;\n\n/**\n * Schema builder that wraps a generic template function, enabling reusable\n * parameterized schemas. Call {@link GenericSchemaBuilder.apply | `.apply()`}\n * with concrete schema arguments to obtain a fully typed concrete schema\n * builder whose TypeScript type is inferred from the template function's\n * generic signature.\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 generic | generic()} function instead.\n *\n * @example Single type parameter\n * ```ts\n * import { generic, object, array, number, string, InferType } from '@cleverbrush/schema';\n *\n * const PaginatedList = generic(\n *   <T extends SchemaBuilder<any, any, any, any, any>>(itemSchema: T) =>\n *     object({\n *       items: array(itemSchema),\n *       total: number(),\n *       page:  number(),\n *     })\n * );\n *\n * const userSchema = object({ name: string(), age: number() });\n * const PaginatedUsers = PaginatedList.apply(userSchema);\n *\n * type PaginatedUsersType = InferType<typeof PaginatedUsers>;\n * // → { items: { name: string; age: number }[]; total: number; page: number }\n * ```\n *\n * @example Multiple type parameters\n * ```ts\n * const Result = generic(\n *   <T extends SchemaBuilder<any, any, any, any, any>,\n *    E extends SchemaBuilder<any, any, any, any, any>>(\n *     valueSchema: T,\n *     errorSchema: E\n *   ) =>\n *     object({\n *       ok:    boolean(),\n *       value: valueSchema.optional(),\n *       error: errorSchema.optional(),\n *     })\n * );\n *\n * const StringResult = Result.apply(string(), number());\n * // InferType → { ok: boolean; value?: string; error?: number }\n * ```\n *\n * @example With default arguments (enables direct `.validate()` on the template)\n * ```ts\n * const AnyList = generic(\n *   [any()],   // default args — one per template parameter\n *   <T extends SchemaBuilder<any, any, any, any, any>>(itemSchema: T) =>\n *     object({ items: array(itemSchema), total: number() })\n * );\n *\n * // Validate directly using defaults:\n * AnyList.validate({ items: [1, 'two', true], total: 3 }); // valid\n *\n * // Or apply concrete schemas first:\n * AnyList.apply(string()).validate({ items: ['a', 'b'], total: 2 }); // valid\n * ```\n *\n * @see {@link generic}\n *\n * @typeParam TFn - The generic template function type. Its return type\n *   determines `TResult` (the validated value type) when no explicit type\n *   override has been applied via `.hasType<T>()`.\n * @typeParam TRequired - `true` when the schema is required (default),\n *   `false` after calling `.optional()`. Governs whether `undefined` is a\n *   valid value.\n * @typeParam TNullable - `true` after calling `.nullable()`. Governs whether\n *   `null` is a valid value.\n * @typeParam TExplicitType - Type override set via `.hasType<T>()`. When\n *   `undefined` (the default), `TResult` is derived from `TFn`'s return type.\n * @typeParam THasDefault - `true` after calling `.default(value)`. Governs\n *   whether `InferType` emits `T` instead of `T | undefined` for optional\n *   schemas with a default.\n * @typeParam TExtensions - Object type carrying extension methods added via\n *   `withExtensions()`. Defaults to `{}`.\n * @typeParam TResult - The inferred result type: `TExplicitType` when set,\n *   otherwise the value type inferred from `ReturnType<TFn>`.\n */\nexport class GenericSchemaBuilder<\n    TFn extends (...args: any[]) => SchemaBuilder<any, any, any, any, any>,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {},\n    TResult = TExplicitType extends undefined\n        ? ReturnType<TFn> extends SchemaBuilder<infer R, any, any, any, any>\n            ? R\n            : any\n        : TExplicitType\n> extends SchemaBuilder<\n    TResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #templateFn?: (...args: any[]) => SchemaBuilder<any, any, any, any, any>;\n    #defaults?: readonly any[];\n    #cachedDefaultSchema?: SchemaBuilder<any, any, any, any, any>;\n\n    /**\n     * Applies the template function with concrete schema arguments, returning\n     * a fully typed concrete schema builder. TypeScript infers the result type\n     * from the template function's own generic signature.\n     *\n     * The returned builder is independent of this `GenericSchemaBuilder` and\n     * can be used like any other schema: `.validate()`, `.optional()`, etc.\n     *\n     * @example\n     * ```ts\n     * const Wrapper = generic(\n     *   <T extends SchemaBuilder<any, any, any, any, any>>(schema: T) =>\n     *     object({ data: schema })\n     * );\n     *\n     * const s = Wrapper.apply(string());\n     * // InferType<typeof s> → { data: string }\n     * s.validate({ data: 'hello' }); // { valid: true }\n     * ```\n     */\n    // Set to the actual function in the constructor; declared here for TypeScript.\n    public declare readonly apply: TFn;\n\n    /**\n     * @hidden\n     */\n    public static create(props: GenericSchemaBuilderCreateProps<any>) {\n        return new GenericSchemaBuilder({\n            type: 'generic',\n            ...props\n        });\n    }\n\n    protected constructor(props: GenericSchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n        this.#templateFn = (props as any).templateFn;\n        this.#defaults = (props as any).defaults;\n\n        // Own property: typed as TFn so generic inference works at call sites.\n        (this as any).apply = (...args: any[]) => {\n            if (!this.#templateFn) {\n                throw new Error(\n                    'GenericSchemaBuilder: no template function defined'\n                );\n            }\n            return this.#templateFn(...args);\n        };\n    }\n\n    /**\n     * Returns an object describing the current schema configuration.\n     *\n     * In addition to the base fields exposed by {@link SchemaBuilder.introspect},\n     * the following fields are included:\n     *\n     * - `templateFn` — the template function passed to {@link generic}.\n     * - `defaults` — the default argument list passed to the two-argument\n     *   form of {@link generic}, or `undefined` when no defaults were provided.\n     *\n     * @example\n     * ```ts\n     * const schema = generic([string()], <T>(s: T) => object({ data: s }));\n     *\n     * const info = schema.introspect();\n     * // info.type         → 'generic'\n     * // info.templateFn   → [Function]\n     * // info.defaults     → [StringSchemaBuilder]\n     * ```\n     */\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /** Template function passed to {@link generic}. */\n            templateFn: this.#templateFn,\n            /** Default positional arguments for the template function, or `undefined`. */\n            defaults: this.#defaults\n        };\n    }\n\n    #getOrCreateDefaultSchema():\n        | SchemaBuilder<any, any, any, any, any>\n        | undefined {\n        if (!this.#templateFn || !this.#defaults) {\n            return undefined;\n        }\n        if (!this.#cachedDefaultSchema) {\n            this.#cachedDefaultSchema = this.#templateFn(...this.#defaults);\n        }\n        return this.#cachedDefaultSchema;\n    }\n\n    #buildResult(\n        superResult: ReturnType<\n            GenericSchemaBuilder<TFn, TRequired>['preValidateSync']\n        >,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { 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 { valid: true, object: objToValidate };\n        }\n\n        const defaultSchema = this.#getOrCreateDefaultSchema();\n        if (!defaultSchema) {\n            return {\n                valid: false,\n                errors: [\n                    {\n                        message:\n                            'This is a generic schema template. Call .apply() with concrete schemas to get a validatable schema, or provide default arguments to generic().'\n                    }\n                ]\n            };\n        }\n\n        return defaultSchema.validate(\n            objToValidate,\n            context\n        ) as ValidationResult<TResult>;\n    }\n\n    async #buildAsyncResult(\n        superResult: Awaited<\n            ReturnType<GenericSchemaBuilder<TFn, TRequired>['preValidateAsync']>\n        >,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { 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 { valid: true, object: objToValidate };\n        }\n\n        const defaultSchema = this.#getOrCreateDefaultSchema();\n        if (!defaultSchema) {\n            return {\n                valid: false,\n                errors: [\n                    {\n                        message:\n                            'This is a generic schema template. Call .apply() with concrete schemas to get a validatable schema, or provide default arguments to generic().'\n                    }\n                ]\n            };\n        }\n\n        return (await defaultSchema.validateAsync(\n            objToValidate,\n            context\n        )) as ValidationResult<TResult>;\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        return this.#buildResult(\n            this.preValidateSync(object, context),\n            context\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        return this.#buildAsyncResult(\n            await super.preValidateAsync(object, context),\n            context\n        );\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: GenericSchemaBuilderCreateProps<TReq>\n    ): this {\n        return GenericSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): GenericSchemaBuilder<TFn, true, TNullable, T, THasDefault, TExtensions> &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearHasType(): GenericSchemaBuilder<\n        TFn,\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     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): GenericSchemaBuilder<\n        TFn,\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(): GenericSchemaBuilder<\n        TFn,\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 nullable(): GenericSchemaBuilder<\n        TFn,\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(): GenericSchemaBuilder<\n        TFn,\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value: TResult | (() => TResult)\n    ): GenericSchemaBuilder<\n        TFn,\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(): GenericSchemaBuilder<\n        TFn,\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    ): GenericSchemaBuilder<\n        TFn,\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     * @hidden\n     */\n    public readonly(): GenericSchemaBuilder<\n        TFn,\n        TRequired,\n        TNullable,\n        Readonly<TResult>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n}\n\n/**\n * Creates a generic schema template — a reusable, parameterized schema factory\n * whose TypeScript type is inferred from the template function's generic\n * signature.\n *\n * Call {@link GenericSchemaBuilder.apply | `.apply()`} on the returned builder\n * to instantiate the template with concrete schema arguments and receive a\n * fully typed concrete schema.\n *\n * There are two overloads:\n *\n * 1. **`generic(templateFn)`** — Provide only the template function. The\n *    template must be called via `.apply()` before validation.\n * 2. **`generic(defaults, templateFn)`** — Provide positional default arguments\n *    followed by the template function. The template can be validated directly\n *    using those defaults (without calling `.apply()` first).\n *\n * @param templateFn - A (generic) function that accepts schema arguments and\n *   returns a concrete schema. TypeScript infers the result type from this\n *   function's generic signature when `.apply()` is called.\n *\n * @returns A new {@link GenericSchemaBuilder} with `isRequired` set to `true`.\n *\n * @example Single type parameter\n * ```ts\n * import { generic, object, array, number, string, any, InferType } from '@cleverbrush/schema';\n *\n * const PaginatedList = generic(\n *   <T extends SchemaBuilder<any, any, any, any, any>>(itemSchema: T) =>\n *     object({ items: array(itemSchema), total: number(), page: number() })\n * );\n *\n * const UserList = PaginatedList.apply(object({ name: string() }));\n * type UserListType = InferType<typeof UserList>;\n * // → { items: { name: string }[]; total: number; page: number }\n *\n * UserList.validate({ items: [{ name: 'Alice' }], total: 1, page: 1 }); // valid\n * ```\n *\n * @example Multiple type parameters\n * ```ts\n * const Result = generic(\n *   <T extends SchemaBuilder<any, any, any, any, any>,\n *    E extends SchemaBuilder<any, any, any, any, any>>(\n *     valueSchema: T,\n *     errorSchema: E\n *   ) =>\n *     union(\n *       object({ ok: boolean().equalsTo(true),  value: valueSchema }),\n *       object({ ok: boolean().equalsTo(false), error: errorSchema })\n *     )\n * );\n *\n * const StringResult = Result.apply(string(), number());\n * ```\n *\n * @example With defaults (enables direct validation on the template)\n * ```ts\n * const AnyList = generic(\n *   [any()],   // default args — positional, one per template parameter\n *   <T extends SchemaBuilder<any, any, any, any, any>>(itemSchema: T) =>\n *     object({ items: array(itemSchema), total: number() })\n * );\n *\n * // Validate directly — uses the default any() schema:\n * AnyList.validate({ items: [1, 'two'], total: 2 }); // valid\n *\n * // Or apply concrete schemas first:\n * AnyList.apply(string()).validate({ items: ['x'], total: 1 }); // valid\n * ```\n *\n * @see {@link GenericSchemaBuilder}\n */\nexport function generic<\n    TFn extends (...args: any[]) => SchemaBuilder<any, any, any, any, any>\n>(\n    templateFn: TFn\n): GenericSchemaBuilder<TFn, true, false, undefined, false, {}>;\nexport function generic<\n    TFn extends (...args: any[]) => SchemaBuilder<any, any, any, any, any>\n>(\n    defaults: readonly any[],\n    templateFn: TFn\n): GenericSchemaBuilder<TFn, true, false, undefined, false, {}>;\nexport function generic<\n    TFn extends (...args: any[]) => SchemaBuilder<any, any, any, any, any>\n>(\n    fnOrDefaults: TFn | readonly any[],\n    templateFn?: TFn\n): GenericSchemaBuilder<TFn, true, false, undefined, false, {}> {\n    const fn = templateFn !== undefined ? templateFn : (fnOrDefaults as TFn);\n    const defaults =\n        templateFn !== undefined ? (fnOrDefaults as readonly any[]) : undefined;\n    return GenericSchemaBuilder.create({\n        isRequired: true,\n        templateFn: fn,\n        defaults\n    }) as any;\n}\n","import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype LazySchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<LazySchemaBuilder<any, R>['introspect']>\n>;\n\n/**\n * Lazy schema builder class. Allows defining recursive/self-referential schemas\n * by wrapping a getter function that returns the target schema. The getter is\n * called once on first validation and the result is cached.\n *\n * This is the primary mechanism for building recursive data structures such as\n * tree nodes, nested menus, and threaded comments.\n *\n * **NOTE** TypeScript cannot infer recursive types automatically, so you must\n * provide an explicit type annotation on the variable holding the schema:\n *\n * @example\n * ```ts\n * type TreeNode = { value: number; children: TreeNode[] };\n *\n * const treeNode: SchemaBuilder<TreeNode, true> = object({\n *     value: number(),\n *     children: array(lazy(() => treeNode))\n * });\n *\n * treeNode.validate({ value: 1, children: [{ value: 2, children: [] }] });\n * // { valid: true, object: { value: 1, children: [{ value: 2, children: [] }] } }\n * ```\n *\n * @example\n * ```ts\n * type Comment = { text: string; replies: Comment[] };\n *\n * const commentSchema: SchemaBuilder<Comment, true> = object({\n *     text: string(),\n *     replies: array(lazy(() => commentSchema))\n * });\n * ```\n */\nexport class LazySchemaBuilder<\n    TResult = any,\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    #getter: () => SchemaBuilder<TResult, any, any>;\n    #resolvedSchema: SchemaBuilder<TResult, any, any> | null = null;\n\n    /**\n     * @hidden\n     */\n    public static create(props: LazySchemaBuilderCreateProps<any>) {\n        return new LazySchemaBuilder({\n            type: 'lazy',\n            ...props\n        });\n    }\n\n    protected constructor(props: LazySchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n        if (typeof (props as any).getter !== 'function') {\n            throw new Error('LazySchemaBuilder: getter must be a function');\n        }\n        this.#getter = (props as any).getter;\n    }\n\n    /**\n     * Resolves the lazy schema by calling the getter (once; result is cached).\n     * After the first call subsequent calls return the cached schema instance.\n     */\n    public resolve(): SchemaBuilder<TResult, any, any> {\n        if (this.#resolvedSchema === null) {\n            this.#resolvedSchema = this.#getter();\n        }\n        return this.#resolvedSchema;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * The getter function that returns the lazily-resolved schema.\n             * Call {@link LazySchemaBuilder.resolve} to obtain the schema instance.\n             */\n            getter: this.#getter\n        };\n    }\n\n    #buildResult(\n        superResult: ReturnType<LazySchemaBuilder['preValidateSync']>,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { valid, errors };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        // Value is null/undefined and the schema is optional — skip delegation.\n        if (objToValidate == null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        return this.resolve().validate(\n            objToValidate,\n            context\n        ) as ValidationResult<TResult>;\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        return this.#buildResult(\n            this.preValidateSync(object, context),\n            context\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 superResult = await super.preValidateAsync(object, context);\n\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { valid, errors };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        if (objToValidate == null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        return this.resolve().validateAsync(objToValidate, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: LazySchemaBuilderCreateProps<TReq>\n    ): this {\n        return LazySchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): LazySchemaBuilder<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(): LazySchemaBuilder<\n        TResult,\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    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): LazySchemaBuilder<TResult, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): LazySchemaBuilder<\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    ): LazySchemaBuilder<TResult, true, TNullable, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): LazySchemaBuilder<\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    ): LazySchemaBuilder<\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     * @hidden\n     */\n    public readonly(): LazySchemaBuilder<\n        Readonly<TResult>,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): LazySchemaBuilder<\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(): LazySchemaBuilder<\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 lazy schema that defers the schema definition until first validation.\n * Use this to define recursive/self-referential schemas.\n *\n * The getter function is called **once** on first use and the result is cached.\n * You **must** provide an explicit TypeScript type annotation on the variable\n * holding the outer schema — TypeScript cannot infer recursive types automatically.\n *\n * @param getter - A function that returns the schema to use for validation.\n *\n * @example\n * ```ts\n * // Tree structure\n * type TreeNode = { value: number; children: TreeNode[] };\n *\n * const treeNode: SchemaBuilder<TreeNode, true> = object({\n *     value: number(),\n *     children: array(lazy(() => treeNode))\n * });\n * ```\n *\n * @example\n * ```ts\n * // Optional recursive field (submenu)\n * type MenuItem = { label: string; submenu?: MenuItem[] };\n *\n * const menuItem: SchemaBuilder<MenuItem, true> = object({\n *     label: string(),\n *     submenu: array(lazy(() => menuItem)).optional()\n * });\n * ```\n */\nexport function lazy<TResult>(\n    getter: () => SchemaBuilder<TResult, any, any>\n): LazySchemaBuilder<TResult, true, false, false, {}> {\n    return LazySchemaBuilder.create({\n        type: 'lazy',\n        isRequired: true,\n        preprocessors: [],\n        validators: [],\n        getter\n    } as any);\n}\n","import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype NullSchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<NullSchemaBuilder<R>['introspect']>\n>;\n\n/**\n * Schema builder for `null` values. Validates that the input is exactly `null`.\n *\n * When required (the default), only `null` is accepted. When optional (via\n * `.optional()`), both `null` and `undefined` are accepted; any other value\n * is rejected.\n *\n * This builder is useful when you need to represent an explicitly-null field\n * in a typed schema, for example in discriminated-union branches or when\n * modelling a JSON payload that may carry a JSON `null` 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 nul | nul()} function instead.\n *\n * @example\n * ```ts\n * import { nul } from '@cleverbrush/schema';\n *\n * const schema = nul();\n *\n * schema.validate(null);       // { valid: true,  object: null }\n * schema.validate(undefined);  // { valid: false }\n * schema.validate(0);          // { valid: false }\n * schema.validate('');         // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Optional — accepts null or undefined\n * const schema = nul().optional();\n *\n * schema.validate(null);       // { valid: true, object: null }\n * schema.validate(undefined);  // { valid: true, object: undefined }\n * schema.validate(false);      // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Use inside a union to model a nullable string field\n * import { union, string, nul, InferType } from '@cleverbrush/schema';\n *\n * const NullableString = union(string()).or(nul());\n * type NullableString = InferType<typeof NullableString>;\n * // string | null\n *\n * NullableString.validate('hello');  // valid\n * NullableString.validate(null);     // valid\n * NullableString.validate(42);       // invalid\n * ```\n *\n * @see {@link nul}\n */\nexport class NullSchemaBuilder<\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<null, TRequired, TNullable, THasDefault, TExtensions> {\n    /**\n     * @hidden\n     */\n    public static create(props: NullSchemaBuilderCreateProps<any>) {\n        return new NullSchemaBuilder({\n            type: 'null',\n            ...props\n        });\n    }\n\n    protected constructor(props: NullSchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n    }\n\n    /**\n     * @hidden\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): NullSchemaBuilder<true, TNullable, T, THasDefault, TExtensions> &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearHasType(): NullSchemaBuilder<\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    // The SchemaBuilder base-class preValidateSync/preValidateAsync treats\n    // null as an invalid value for required schemas, which would prevent null\n    // from ever passing validation here. We therefore bypass preValidateSync\n    // entirely and implement the full (and simple) validation inline.\n    #buildResult(object: any): ValidationResult<null> {\n        if (object === null) return { valid: true, object: null };\n\n        if (object === undefined && this.hasDefault) {\n            const defaultVal = this.resolveDefaultValue();\n            if (defaultVal === null) return { valid: true, object: null };\n            return { valid: false, errors: [{ message: 'must be null' }] };\n        }\n\n        if (object === undefined && !this.isRequired) {\n            return { valid: true, object: undefined as any };\n        }\n\n        return {\n            valid: false,\n            errors: [{ message: 'must be null' }]\n        };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: null,\n        context?: ValidationContext\n    ): ValidationResult<null> {\n        return super.validate(object, context) as ValidationResult<null>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: null,\n        context?: ValidationContext\n    ): Promise<ValidationResult<null>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<null>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of the schema over `object`.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected _validate(\n        object: null,\n        _context?: ValidationContext\n    ): ValidationResult<null> {\n        return this.#buildResult(object);\n    }\n\n    /**\n     * Performs async validation of the schema over `object`.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected async _validateAsync(\n        object: null,\n        _context?: ValidationContext\n    ): Promise<ValidationResult<null>> {\n        return this.#buildResult(object);\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: NullSchemaBuilderCreateProps<TReq>\n    ): this {\n        return NullSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): NullSchemaBuilder<\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(): NullSchemaBuilder<\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: null | (() => null)\n    ): NullSchemaBuilder<true, TNullable, TExplicitType, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): NullSchemaBuilder<\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    ): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        null & { 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<null>`. Since `null` is already\n     * immutable this is an identity operation, but it sets the `isReadonly`\n     * introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        Readonly<null>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): NullSchemaBuilder<\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(): NullSchemaBuilder<\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 schema that validates the value is exactly `null`.\n *\n * By default the schema is **required** — only `null` is accepted.\n * Call `.optional()` to also allow `undefined`.\n *\n * @example\n * ```ts\n * import { nul } from '@cleverbrush/schema';\n *\n * nul().validate(null);       // { valid: true,  object: null }\n * nul().validate(undefined);  // { valid: false }\n * nul().validate(0);          // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * nul().optional().validate(null);       // { valid: true, object: null }\n * nul().optional().validate(undefined);  // { valid: true, object: undefined }\n * nul().optional().validate(false);      // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Nullable field in an object schema\n * import { object, string, nul, union, InferType } from '@cleverbrush/schema';\n *\n * const Schema = object({\n *   name:    string(),\n *   deleted: union(nul()).or(string()),   // null | string\n * });\n *\n * type T = InferType<typeof Schema>;\n * // { name: string; deleted: null | string }\n * ```\n */\nexport const nul = () =>\n    NullSchemaBuilder.create({\n        isRequired: true\n    }) as NullSchemaBuilder<true>;\n","/**\n * @module extension\n *\n * The **extension system** for `@cleverbrush/schema` allows third-party and\n * first-party code to add custom methods to any schema builder type\n * (`string`, `number`, `date`, `object`, …) without modifying the core\n * library.\n *\n * ## Overview\n *\n * Extensions follow a two-step workflow:\n *\n * 1. **Define** an extension with {@link defineExtension} — declare which\n *    builder types it targets and what methods it adds.\n * 2. **Apply** one or more extensions with {@link withExtensions} — get back\n *    augmented factory functions (`string()`, `number()`, …) whose return\n *    types include the new methods.\n *\n * ## Ergonomic authoring\n *\n * Extension methods do **not** need to call `withExtension()` manually.\n * The system automatically attaches metadata using the method name as the\n * extension key and the method arguments as the value. This keeps extension\n * definitions concise:\n *\n * ```ts\n * const slugExt = defineExtension({\n *   string: {\n *     slug(this: StringSchemaBuilder) {\n *       return this.addValidator((val) => {\n *         const valid = /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(val);\n *         return { valid, errors: valid ? [] : [{ message: 'must be a valid URL slug' }] };\n *       });\n *     }\n *   }\n * });\n * ```\n *\n * If you need **custom metadata** (e.g. a different key or a transformed\n * value), call `this.withExtension(key, value)` explicitly — the auto-infer\n * logic will detect the existing key and skip the automatic attachment.\n *\n * ## Stacking and composition\n *\n * Multiple extensions can target the same builder type. Pass them all to\n * `withExtensions()` and the methods are merged. A runtime error is thrown\n * if two extensions define the same method name on the same builder type.\n *\n * ```ts\n * const s = withExtensions(emailExt, slugExt, rangeExt);\n * const schema = s.string().email().slug(); // both methods available\n * ```\n *\n * ## Introspection\n *\n * Extension metadata is accessible via `schema.introspect().extensions`.\n * Each key corresponds to an extension method name and its value is whatever\n * was passed (or auto-inferred) as the extension data.\n *\n * @see {@link defineExtension} — define an extension\n * @see {@link withExtensions} — apply extensions to builder factories\n * @see {@link ExtensionConfig} — shape of the configuration object\n * @see {@link ExtensionDescriptor} — branded descriptor returned by `defineExtension`\n */\nimport { AnySchemaBuilder, any } from './builders/AnySchemaBuilder.js';\nimport { ArraySchemaBuilder, array } from './builders/ArraySchemaBuilder.js';\nimport {\n    BooleanSchemaBuilder,\n    boolean\n} from './builders/BooleanSchemaBuilder.js';\nimport { DateSchemaBuilder, date } from './builders/DateSchemaBuilder.js';\nimport {\n    FunctionSchemaBuilder,\n    func\n} from './builders/FunctionSchemaBuilder.js';\nimport {\n    GenericSchemaBuilder,\n    generic\n} from './builders/GenericSchemaBuilder.js';\nimport { NumberSchemaBuilder, number } from './builders/NumberSchemaBuilder.js';\nimport { ObjectSchemaBuilder, object } from './builders/ObjectSchemaBuilder.js';\nimport {\n    PromiseSchemaBuilder,\n    promise\n} from './builders/PromiseSchemaBuilder.js';\nimport { RecordSchemaBuilder, record } from './builders/RecordSchemaBuilder.js';\nimport type { SchemaBuilder } from './builders/SchemaBuilder.js';\nimport { StringSchemaBuilder, string } from './builders/StringSchemaBuilder.js';\nimport { TupleSchemaBuilder, tuple } from './builders/TupleSchemaBuilder.js';\nimport { UnionSchemaBuilder, union } from './builders/UnionSchemaBuilder.js';\n\n// ---------------------------------------------------------------------------\n// Builder type name mapping\n// ---------------------------------------------------------------------------\n\n/**\n * Maps each builder type name to the corresponding generic builder class.\n *\n * Used internally to type-check extension method `this` bindings — for\n * example, an extension targeting `\"string\"` receives `this: StringSchemaBuilder`.\n *\n * @internal Not exported — used only by the extension type machinery.\n */\ntype BuilderMap = {\n    string: StringSchemaBuilder<any, any, any, any, any>;\n    number: NumberSchemaBuilder<any, any, any, any, any>;\n    boolean: BooleanSchemaBuilder<any, any, any, any, any, any, any>;\n    date: DateSchemaBuilder<any, any, any, any, any>;\n    object: ObjectSchemaBuilder<any, any, any, any, any, any, any>;\n    array: ArraySchemaBuilder<any, any, any, any, any, any, any>;\n    tuple: TupleSchemaBuilder<any, any, any, any, any, any, any>;\n    record: RecordSchemaBuilder<any, any, any, any, any, any, any>;\n    union: UnionSchemaBuilder<any, any, any, any, any, any>;\n    func: FunctionSchemaBuilder<any, any, any, any, any>;\n    any: AnySchemaBuilder<any, any, any, any, any, any>;\n    promise: PromiseSchemaBuilder<any, any, any, any, any>;\n    generic: GenericSchemaBuilder<any, any, any, any, any, any>;\n};\n\ntype BuilderTypeName = keyof BuilderMap;\n\n// Runtime mapping from type name to the actual class constructor\nconst builderClasses: Record<BuilderTypeName, typeof SchemaBuilder> = {\n    string: StringSchemaBuilder as any,\n    number: NumberSchemaBuilder as any,\n    boolean: BooleanSchemaBuilder as any,\n    date: DateSchemaBuilder as any,\n    object: ObjectSchemaBuilder as any,\n    array: ArraySchemaBuilder as any,\n    tuple: TupleSchemaBuilder as any,\n    record: RecordSchemaBuilder as any,\n    union: UnionSchemaBuilder as any,\n    func: FunctionSchemaBuilder as any,\n    any: AnySchemaBuilder as any,\n    promise: PromiseSchemaBuilder as any,\n    generic: GenericSchemaBuilder as any\n};\n\n// Runtime mapping from type name to factory function\nconst builderFactories: Record<BuilderTypeName, (...args: any[]) => any> = {\n    string,\n    number,\n    boolean,\n    date,\n    object,\n    array,\n    tuple,\n    record,\n    union,\n    func,\n    any,\n    promise,\n    generic\n};\n\n// ---------------------------------------------------------------------------\n// Extension configuration types\n// ---------------------------------------------------------------------------\n\n/**\n * Defines the shape of an extension configuration object passed to\n * {@link defineExtension}.\n *\n * Each key is a **builder type name** — one of `\"string\"`, `\"number\"`,\n * `\"boolean\"`, `\"date\"`, `\"object\"`, `\"array\"`, `\"union\"`, `\"func\"`, or\n * `\"any\"`. The value is a record of **method implementations** to add to\n * that builder type.\n *\n * Method implementations receive `this` bound to the target builder instance\n * (e.g. `StringSchemaBuilder` for the `\"string\"` key) and **must** return a\n * builder of the same type to support fluent chaining.\n *\n * @remarks\n * Extension methods that only add validators/preprocessors do not need to\n * call `this.withExtension()` — the system will auto-attach metadata using\n * the method name as the key and the arguments as the value. Call\n * `this.withExtension(key, value)` explicitly only when you need custom\n * metadata (e.g. a transformed value or a different key).\n *\n * @example\n * ```ts\n * // Minimal extension config — auto-inferred metadata\n * const config: ExtensionConfig = {\n *   string: {\n *     slug(this: StringSchemaBuilder) {\n *       return this.addValidator((v) => ({ valid: /^[a-z0-9-]+$/.test(v), errors: [] }));\n *     }\n *   },\n *   number: {\n *     port(this: NumberSchemaBuilder) {\n *       return this.isInteger().min(1).max(65535);\n *     }\n *   }\n * };\n * ```\n *\n * @see {@link defineExtension}\n */\nexport type ExtensionConfig = {\n    [K in BuilderTypeName]?: Record<\n        string,\n        (this: BuilderMap[K], ...args: any[]) => any\n    >;\n};\n\n/**\n * A branded descriptor returned by {@link defineExtension}.\n *\n * The descriptor captures the extension's method signatures at the **type\n * level** so that {@link withExtensions} can produce correctly-typed factory\n * functions. At runtime it holds the (possibly wrapped) configuration object.\n *\n * Extension descriptors are intentionally **opaque** — consumers should not\n * access `config` directly. Instead, pass descriptors to\n * {@link withExtensions} to obtain augmented builder factories.\n *\n * @typeParam T - The concrete {@link ExtensionConfig} shape. Inferred\n *   automatically by `defineExtension`; you rarely need to specify it.\n *\n * @example\n * ```ts\n * // The type is inferred — no need to annotate\n * const myExt: ExtensionDescriptor<{ string: { slug: ... } }> = defineExtension({ ... });\n * ```\n *\n * @see {@link defineExtension}\n * @see {@link withExtensions}\n */\nexport type ExtensionDescriptor<T extends ExtensionConfig = ExtensionConfig> = {\n    readonly __brand: unique symbol;\n    readonly config: T;\n};\n\n// ---------------------------------------------------------------------------\n// Type-level extraction of extension methods per builder type\n// ---------------------------------------------------------------------------\n\n/** Extracts the method signatures an extension adds to a given builder type. */\ntype ExtractMethods<\n    TExt extends ExtensionConfig,\n    TType extends BuilderTypeName\n> =\n    TExt[TType] extends Record<string, (...args: any[]) => any>\n        ? TExt[TType]\n        : {};\n\n/** Merges the methods from multiple extensions for a given builder type. */\ntype MergeExtensionMethods<\n    TExts extends readonly ExtensionDescriptor<any>[],\n    TType extends BuilderTypeName\n> = TExts extends readonly [\n    ExtensionDescriptor<infer TFirst>,\n    ...infer TRest extends readonly ExtensionDescriptor<any>[]\n]\n    ? ExtractMethods<TFirst, TType> & MergeExtensionMethods<TRest, TType>\n    : {};\n\n// ---------------------------------------------------------------------------\n// Return types for withExtensions()\n// ---------------------------------------------------------------------------\n\n/**\n * Intersected onto consumer-facing builder types to make `withExtension`\n * and `getExtension` uncallable (`never`). Using an intersection instead\n * of `Omit` preserves the class identity so extended builders remain\n * assignable to `SchemaBuilder<any, any, any, any, any>`.\n */\nexport type HiddenExtensionMethods = {\n    /** @internal Extension-author only — use inside `defineExtension()`. */\n    withExtension: never;\n    /** @internal Extension-author only — use inside `defineExtension()`. */\n    getExtension: never;\n};\n\n/**\n * Overrides extension method return types so they always return the full\n * extended builder type. This ensures extension methods preserve all other\n * extension methods through chaining (e.g. `s.string().email().slug()`).\n *\n * The self-reference (`FixedMethods` appears in its own mapped return\n * types) is resolved lazily by TypeScript because the recursion sits\n * inside a function-return position within a conditional mapped type.\n */\nexport type FixedMethods<TRawMethods, TBase> = {\n    [K in keyof TRawMethods]: TRawMethods[K] extends (\n        this: any,\n        ...args: infer A\n    ) => any\n        ? (\n              ...args: A\n          ) => TBase & FixedMethods<TRawMethods, TBase> & HiddenExtensionMethods\n        : TRawMethods[K];\n};\n\n/**\n * Produces the consumer-facing type for an extended builder: the base\n * builder intersected with its fixed extension methods, with\n * `withExtension` / `getExtension` overridden to `never` so they\n * don't appear as callable in consumer code.\n */\nexport type CleanExtended<TBuilder, TExt> = TBuilder &\n    FixedMethods<TExt, TBuilder> &\n    HiddenExtensionMethods;\n\n// -- Factory types that return builders with corrected extension methods ------\n\ntype ExtendedStringFactory<TExt> = {\n    (): CleanExtended<\n        StringSchemaBuilder<string, true, false, false, TExt>,\n        TExt\n    >;\n    <T extends string>(\n        equals: T\n    ): CleanExtended<StringSchemaBuilder<T, true, false, false, TExt>, TExt>;\n};\n\ntype ExtendedNumberFactory<TExt> = {\n    (): CleanExtended<\n        NumberSchemaBuilder<number, true, false, false, TExt>,\n        TExt\n    >;\n    <T extends number>(\n        equals: T\n    ): CleanExtended<NumberSchemaBuilder<T, true, false, false, TExt>, TExt>;\n};\n\ntype ExtendedBooleanFactory<TExt> = () => CleanExtended<\n    BooleanSchemaBuilder<boolean, true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedDateFactory<TExt> = () => CleanExtended<\n    DateSchemaBuilder<Date, true, false, false, TExt>,\n    TExt\n>;\n\ntype ExtendedObjectFactory<TExt> = <\n    P extends Record<string, SchemaBuilder<any, any, any, any, any>>\n>(\n    properties?: P\n) => CleanExtended<\n    ObjectSchemaBuilder<P, true, false, undefined, false, TExt, []>,\n    TExt\n>;\n\ntype ExtendedArrayFactory<TExt> = <\n    TElementSchema extends SchemaBuilder<any, any, any, any, any>\n>(\n    elementSchema?: TElementSchema\n) => CleanExtended<\n    ArraySchemaBuilder<TElementSchema, true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedUnionFactory<TExt> = <\n    T extends SchemaBuilder<any, any, any, any, any>\n>(\n    schema: T\n) => CleanExtended<\n    UnionSchemaBuilder<[T], true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedFuncFactory<TExt> = () => CleanExtended<\n    FunctionSchemaBuilder<true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedAnyFactory<TExt> = () => CleanExtended<\n    AnySchemaBuilder<true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedTupleFactory<TExt> = <\n    const TElements extends readonly SchemaBuilder<any, any, any, any, any>[]\n>(\n    elements: [...TElements]\n) => CleanExtended<\n    TupleSchemaBuilder<TElements, true, false, undefined, false, TExt>,\n    TExt\n>;\n\ntype ExtendedRecordFactory<TExt> = <\n    TKeySchema extends StringSchemaBuilder<any, any, any, any>,\n    TValueSchema extends SchemaBuilder<any, any, any, any, any>\n>(\n    keySchema: TKeySchema,\n    valueSchema: TValueSchema\n) => CleanExtended<\n    RecordSchemaBuilder<\n        TKeySchema,\n        TValueSchema,\n        true,\n        false,\n        undefined,\n        false,\n        TExt\n    >,\n    TExt\n>;\n\ntype ExtendedPromiseFactory<TExt> = <\n    TSchema extends SchemaBuilder<any, any, any, any, any>\n>(\n    resolvedTypeSchema?: TSchema\n) => CleanExtended<\n    PromiseSchemaBuilder<true, false, undefined, false, TExt, TSchema>,\n    TExt\n>;\n\ntype ExtendedGenericFactory<TExt> = <\n    TFn extends (...args: any[]) => SchemaBuilder<any, any, any, any, any>\n>(\n    templateFn: TFn\n) => CleanExtended<\n    GenericSchemaBuilder<TFn, true, false, undefined, false, TExt>,\n    TExt\n>;\n\n/**\n * The return type of {@link withExtensions}.\n *\n * Contains a factory function for every builder type (`string`, `number`,\n * `boolean`, `date`, `object`, `array`, `union`, `func`, `any`). Each\n * factory returns a builder whose type includes the methods contributed\n * by all provided extension descriptors.\n *\n * @typeParam TExts - Tuple of extension descriptors passed to `withExtensions`.\n *\n * @see {@link withExtensions}\n */\ntype WithExtensionsResult<TExts extends readonly ExtensionDescriptor<any>[]> = {\n    string: ExtendedStringFactory<MergeExtensionMethods<TExts, 'string'>>;\n    number: ExtendedNumberFactory<MergeExtensionMethods<TExts, 'number'>>;\n    boolean: ExtendedBooleanFactory<MergeExtensionMethods<TExts, 'boolean'>>;\n    date: ExtendedDateFactory<MergeExtensionMethods<TExts, 'date'>>;\n    object: ExtendedObjectFactory<MergeExtensionMethods<TExts, 'object'>>;\n    array: ExtendedArrayFactory<MergeExtensionMethods<TExts, 'array'>>;\n    tuple: ExtendedTupleFactory<MergeExtensionMethods<TExts, 'tuple'>>;\n    record: ExtendedRecordFactory<MergeExtensionMethods<TExts, 'record'>>;\n    union: ExtendedUnionFactory<MergeExtensionMethods<TExts, 'union'>>;\n    func: ExtendedFuncFactory<MergeExtensionMethods<TExts, 'func'>>;\n    any: ExtendedAnyFactory<MergeExtensionMethods<TExts, 'any'>>;\n    promise: ExtendedPromiseFactory<MergeExtensionMethods<TExts, 'promise'>>;\n    generic: ExtendedGenericFactory<MergeExtensionMethods<TExts, 'generic'>>;\n};\n\n// ---------------------------------------------------------------------------\n// Reserved method names — cannot be overridden by extensions\n// ---------------------------------------------------------------------------\n\n/**\n * Method names on `SchemaBuilder` that extensions are **not** allowed to\n * override. An error is thrown at definition time if an extension tries\n * to use any of these names.\n *\n * @internal\n */\nconst RESERVED_METHODS = new Set([\n    'validate',\n    'validateAsync',\n    'parse',\n    'parseAsync',\n    'safeParse',\n    'safeParseAsync',\n    'introspect',\n    'optional',\n    'required',\n    'addPreprocessor',\n    'clearPreprocessors',\n    'addValidator',\n    'clearValidators',\n    'hasType',\n    'clearHasType',\n    'createFromProps',\n    'preValidate',\n    'preValidateSync',\n    'preValidateAsync',\n    'getValidationErrorMessage',\n    'getValidationErrorMessageSync',\n    'assureValidationErrorMessageProvider',\n    'withExtension',\n    'getExtension'\n]);\n\n// ---------------------------------------------------------------------------\n// defineExtension()\n// ---------------------------------------------------------------------------\n\n/**\n * Defines an extension targeting one or more schema builder types.\n *\n * Each extension is a plain object keyed by builder type name (`\"string\"`,\n * `\"number\"`, `\"date\"`, …) whose values are method implementations.\n * Methods receive `this` bound to the builder instance and must return a\n * builder to support fluent chaining.\n *\n * ## Ergonomic metadata (auto-infer)\n *\n * Extension methods **do not** have to call `this.withExtension()`. The\n * system wraps each method and automatically attaches\n * `withExtension(methodName, args)` to the returned builder when the key\n * is not already present. This eliminates the most common source of\n * duplication in extension code.\n *\n * - **Zero-arg methods** → metadata value is `true`\n * - **Single-arg methods** → metadata value is the argument itself\n * - **Multi-arg methods** → metadata value is the arguments array\n *\n * If you need **custom metadata** (e.g. a different key, a transformed\n * value, or a structured object), call `this.withExtension(key, value)`\n * explicitly inside the method — the auto-infer logic detects the existing\n * key and skips automatic attachment.\n *\n * ## Validation\n *\n * `defineExtension` validates the configuration eagerly:\n * - Unknown builder type names throw immediately.\n * - {@link RESERVED_METHODS | Reserved method names} (e.g. `validate`,\n *   `introspect`) cannot be overridden.\n * - Non-function values in the method record are rejected.\n *\n * @param config - An {@link ExtensionConfig} object mapping builder type\n *   names to method records.\n * @returns A branded {@link ExtensionDescriptor} ready to pass to\n *   {@link withExtensions}.\n *\n * @example Simple extension (auto-inferred metadata)\n * ```ts\n * const slugExt = defineExtension({\n *   string: {\n *     slug(this: StringSchemaBuilder) {\n *       return this.addValidator((val) => {\n *         const valid = /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(val);\n *         return { valid, errors: valid ? [] : [{ message: 'invalid slug' }] };\n *       });\n *     }\n *   }\n * });\n *\n * // Usage:\n * const s = withExtensions(slugExt);\n * const schema = s.string().slug();\n * schema.introspect().extensions.slug; // true\n * ```\n *\n * @example Extension with custom metadata\n * ```ts\n * const currencyExt = defineExtension({\n *   number: {\n *     currency(this: NumberSchemaBuilder, opts?: { maxDecimals?: number }) {\n *       const maxDec = opts?.maxDecimals ?? 2;\n *       return this.withExtension('currency', { maxDecimals: maxDec })\n *         .min(0)\n *         .addValidator((val) => {\n *           const decimals = (String(val).split('.')[1] ?? '').length;\n *           const valid = decimals <= maxDec;\n *           return { valid, errors: valid ? [] : [{ message: `max ${maxDec} decimals` }] };\n *         });\n *     }\n *   }\n * });\n * ```\n *\n * @example Multi-builder extension\n * ```ts\n * const myExt = defineExtension({\n *   string: {\n *     email(this: StringSchemaBuilder) { return this.addValidator(...); }\n *   },\n *   number: {\n *     port(this: NumberSchemaBuilder) { return this.isInteger().min(1).max(65535); }\n *   }\n * });\n * ```\n *\n * @throws {Error} If a builder type name is unknown.\n * @throws {Error} If a method name is reserved.\n * @throws {Error} If a method value is not a function.\n *\n * @see {@link withExtensions} — apply the defined extension\n * @see {@link ExtensionConfig} — configuration shape\n */\nexport function defineExtension<T extends ExtensionConfig>(\n    config: T\n): ExtensionDescriptor<T> {\n    // Validate at definition time and wrap methods for auto-infer extension key\n    const wrappedConfig: any = {};\n    for (const builderName of Object.keys(config) as BuilderTypeName[]) {\n        if (!(builderName in builderClasses)) {\n            throw new Error(\n                `Unknown builder type \"${builderName}\". Valid types: ${Object.keys(builderClasses).join(', ')}`\n            );\n        }\n\n        const methods = config[builderName];\n        if (!methods || typeof methods !== 'object') {\n            throw new Error(\n                `Extension config for \"${builderName}\" must be an object of methods`\n            );\n        }\n\n        wrappedConfig[builderName] = {};\n        for (const methodName of Object.keys(methods)) {\n            if (RESERVED_METHODS.has(methodName)) {\n                throw new Error(\n                    `Cannot override reserved method \"${methodName}\" on \"${builderName}\"`\n                );\n            }\n            const origMethod = methods[methodName];\n            if (typeof origMethod !== 'function') {\n                throw new Error(\n                    `Extension method \"${builderName}.${methodName}\" must be a function`\n                );\n            }\n            // Wrap the method to auto-infer extension key if not already set\n            wrappedConfig[builderName][methodName] = function (\n                this: any,\n                ...args: any[]\n            ) {\n                const result = (origMethod as any).apply(this, args);\n                // If result is a builder and does not have the extension key, auto-apply withExtension\n                if (\n                    result &&\n                    typeof result === 'object' &&\n                    typeof result.withExtension === 'function' &&\n                    // Only auto-apply if the extension key is not already present\n                    (typeof result.getExtension !== 'function' ||\n                        result.getExtension(methodName) === undefined)\n                ) {\n                    // Only auto-apply if the original method did not call withExtension\n                    return result.withExtension(\n                        methodName,\n                        args.length === 1\n                            ? args[0]\n                            : args.length === 0\n                              ? true\n                              : args\n                    );\n                }\n                return result;\n            };\n        }\n    }\n\n    return { config: wrappedConfig } as ExtensionDescriptor<T>;\n}\n\n// ---------------------------------------------------------------------------\n// withExtensions()\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a set of schema factory functions with the provided extensions\n * applied.\n *\n * Each factory function (`string()`, `number()`, `date()`, …) returned by\n * `withExtensions` produces builder instances whose prototypes include the\n * extension methods. All built-in builder methods remain available and\n * fully chainable alongside the new ones.\n *\n * ## Stacking multiple extensions\n *\n * Pass any number of {@link ExtensionDescriptor}s — their methods are\n * merged per builder type. If two extensions define the **same** method\n * name on the same builder type, a runtime error is thrown to prevent\n * silent conflicts.\n *\n * ## Type safety\n *\n * The return type is fully inferred: TypeScript knows exactly which\n * extension methods are available on each builder factory. Extension\n * methods return the full extended builder type, so chaining like\n * `s.string().email().slug().minLength(3)` is fully typed.\n *\n * ## Builder types without extensions\n *\n * Builders that have no methods from any of the provided extensions\n * use the standard (unextended) factory, so there is zero overhead.\n *\n * @param extensions - One or more {@link ExtensionDescriptor}s created\n *   by {@link defineExtension}.\n * @returns An object with factory functions for all builder types\n *   (`string`, `number`, `boolean`, `date`, `object`, `array`, `union`,\n *   `func`, `any`), each returning augmented builders.\n *\n * @example Basic usage\n * ```ts\n * const s = withExtensions(emailExt, rangeExt);\n *\n * // string() now has .email()\n * const emailSchema = s.string().email().minLength(5);\n *\n * // number() now has .range()\n * const rangeSchema = s.number().range(0, 100);\n *\n * // builders without targeted extensions work as normal\n * const dateSchema = s.date();\n * ```\n *\n * @example Stacking extensions on the same builder\n * ```ts\n * const s = withExtensions(emailExt, slugExt, trimmedExt);\n * const schema = s.string().email().slug().trimmed();\n * ```\n *\n * @example Using extensions in object schemas\n * ```ts\n * const s = withExtensions(emailExt, portExt);\n * const ServerConfig = s.object({\n *   host: s.string().email(),\n *   port: s.number().port()\n * });\n * ```\n *\n * @throws {Error} If two extensions define the same method name on the\n *   same builder type.\n *\n * @see {@link defineExtension} — create extension descriptors\n * @see {@link ExtensionDescriptor}\n */\nexport function withExtensions<\n    const TExts extends readonly ExtensionDescriptor<any>[]\n>(...extensions: TExts): WithExtensionsResult<TExts> {\n    // Collect all methods per builder type and check for collisions\n    const methodsByBuilder = new Map<BuilderTypeName, Map<string, Function>>();\n\n    for (const ext of extensions) {\n        for (const builderName of Object.keys(\n            ext.config\n        ) as BuilderTypeName[]) {\n            if (!methodsByBuilder.has(builderName)) {\n                methodsByBuilder.set(builderName, new Map());\n            }\n            const methods = methodsByBuilder.get(builderName)!;\n            const extMethods = ext.config[builderName]!;\n\n            for (const methodName of Object.keys(extMethods)) {\n                if (methods.has(methodName)) {\n                    throw new Error(\n                        `Extension method collision: \"${methodName}\" is defined by multiple extensions for \"${builderName}\"`\n                    );\n                }\n                methods.set(methodName, extMethods[methodName]);\n            }\n        }\n    }\n\n    // For each builder type, create a dynamic subclass if there are extension methods\n    const factories: Record<string, (...args: any[]) => any> = {};\n\n    for (const builderName of Object.keys(\n        builderClasses\n    ) as BuilderTypeName[]) {\n        const methods = methodsByBuilder.get(builderName);\n\n        if (!methods || methods.size === 0) {\n            // No extensions for this builder type — use the standard factory\n            factories[builderName] = builderFactories[builderName];\n            continue;\n        }\n\n        const BaseClass = builderClasses[builderName] as any;\n\n        // Create a dynamic subclass\n        const ExtendedClass = class extends BaseClass {\n            // biome-ignore lint/complexity/noUselessConstructor: required\n            constructor(...args: any[]) {\n                super(...args);\n            }\n\n            static create(props: any) {\n                return new ExtendedClass({\n                    ...props\n                });\n            }\n\n            protected createFromProps(props: any): any {\n                return ExtendedClass.create(props);\n            }\n        };\n\n        // Add extension methods to the subclass prototype\n        for (const [methodName, methodFn] of methods) {\n            Object.defineProperty(ExtendedClass.prototype, methodName, {\n                value: methodFn,\n                writable: true,\n                configurable: true,\n                enumerable: false\n            });\n        }\n\n        // Create a factory that uses the extended class\n        factories[builderName] = (...args: any[]) => {\n            // Delegate to the original factory to get an initialized instance,\n            // then upgrade its prototype so it gains the extension methods.\n            // Note: Object.setPrototypeOf can cause V8 hidden-class deoptimization\n            // on the mutated object, but avoids the double allocation and\n            // introspect() round-trip of the previous approach.\n            const original = builderFactories[builderName](...args);\n            Object.setPrototypeOf(original, ExtendedClass.prototype);\n            return original;\n        };\n    }\n\n    return factories as WithExtensionsResult<TExts>;\n}\n"],"mappings":"4lBAgGO,IAAMA,EAAN,MAAMC,UAYHC,CAMR,CACEC,GACAC,GACAC,GA4BA,OAAc,OAAOC,EAA6C,CAC9D,OAAO,IAAIL,EAAqB,CAC5B,KAAM,UACN,GAAGK,CACP,CAAC,CACL,CAEU,YAAYA,EAAmD,CACrE,MAAMA,CAAY,EAClB,KAAKH,GAAeG,EAAc,WAClC,KAAKF,GAAaE,EAAc,SAG/B,KAAa,MAAQ,IAAIC,IAAgB,CACtC,GAAI,CAAC,KAAKJ,GACN,MAAM,IAAI,MACN,oDACJ,EAEJ,OAAO,KAAKA,GAAY,GAAGI,CAAI,CACnC,CACJ,CAsBO,YAAa,CAChB,MAAO,CACH,GAAG,MAAM,WAAW,EAEpB,WAAY,KAAKJ,GAEjB,SAAU,KAAKC,EACnB,CACJ,CAEAI,IAEgB,CACZ,GAAI,GAAC,KAAKL,IAAe,CAAC,KAAKC,IAG/B,OAAK,KAAKC,KACN,KAAKA,GAAuB,KAAKF,GAAY,GAAG,KAAKC,EAAS,GAE3D,KAAKC,EAChB,CAEAI,GACIC,EAGAC,EACyB,CACzB,GAAM,CACF,MAAAC,EACA,YAAaC,EACb,OAAAC,CACJ,EAAIJ,EAEJ,GAAI,CAACE,EACD,MAAO,CAAE,MAAAA,EAAO,OAAAE,CAAO,EAG3B,GAAM,CACF,OAAQ,CAAE,gBAAiBC,CAAc,CAC7C,EAAIF,EAEJ,GACK,OAAOE,EAAkB,KAAe,CAAC,KAAK,YAC9CA,IAAkB,OAAS,CAAC,KAAK,YAAc,KAAK,YAErD,MAAO,CAAE,MAAO,GAAM,OAAQA,CAAc,EAGhD,IAAMC,EAAgB,KAAKR,GAA0B,EACrD,OAAKQ,EAYEA,EAAc,SACjBD,EACAJ,CACJ,EAdW,CACH,MAAO,GACP,OAAQ,CACJ,CACI,QACI,gJACR,CACJ,CACJ,CAOR,CAEA,KAAMM,GACFP,EAGAC,EACkC,CAClC,GAAM,CACF,MAAAC,EACA,YAAaC,EACb,OAAAC,CACJ,EAAIJ,EAEJ,GAAI,CAACE,EACD,MAAO,CAAE,MAAAA,EAAO,OAAAE,CAAO,EAG3B,GAAM,CACF,OAAQ,CAAE,gBAAiBC,CAAc,CAC7C,EAAIF,EAEJ,GACK,OAAOE,EAAkB,KAAe,CAAC,KAAK,YAC9CA,IAAkB,OAAS,CAAC,KAAK,YAAc,KAAK,YAErD,MAAO,CAAE,MAAO,GAAM,OAAQA,CAAc,EAGhD,IAAMC,EAAgB,KAAKR,GAA0B,EACrD,OAAKQ,EAYG,MAAMA,EAAc,cACxBD,EACAJ,CACJ,EAdW,CACH,MAAO,GACP,OAAQ,CACJ,CACI,QACI,gJACR,CACJ,CACJ,CAOR,CAGO,SACHO,EACAP,EACyB,CACzB,OAAO,MAAM,SAASO,EAAQP,CAAO,CACzC,CAGA,MAAa,cACTO,EACAP,EACkC,CAClC,OAAO,MAAM,cAAcO,EAAQP,CAAO,CAG9C,CAOU,UACNO,EACAP,EACyB,CACzB,OAAO,KAAKF,GACR,KAAK,gBAAgBS,EAAQP,CAAO,EACpCA,CACJ,CACJ,CAOA,MAAgB,eACZO,EACAP,EACkC,CAClC,OAAO,KAAKM,GACR,MAAM,MAAM,iBAAiBC,EAAQP,CAAO,EAC5CA,CACJ,CACJ,CAEU,gBACNL,EACI,CACJ,OAAOL,EAAqB,OAAOK,CAAY,CACnD,CAKO,QACHa,EAEY,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAKO,cAQS,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAKO,SACHC,EASY,CACZ,OAAO,MAAM,SAASA,CAAY,CACtC,CAKO,UAQS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,UAQS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,aAQS,CACZ,OAAO,MAAM,YAAY,CAC7B,CAKO,QACHC,EASY,CACZ,OAAO,MAAM,QAAQA,CAAK,CAC9B,CAKO,cAQS,CACZ,OAAO,MAAM,aAAa,CAC9B,CAKO,MACHC,EASY,CACZ,OAAO,MAAM,MAAMA,CAAK,CAC5B,CAKO,UAQS,CACZ,OAAO,MAAM,SAAS,CAC1B,CACJ,EAsFO,SAASC,EAGZC,EACAC,EAC4D,CAC5D,IAAMC,EAAKD,IAAe,OAAYA,EAAcD,EAC9CG,EACFF,IAAe,OAAaD,EAAkC,OAClE,OAAOxB,EAAqB,OAAO,CAC/B,WAAY,GACZ,WAAY0B,EACZ,SAAAC,CACJ,CAAC,CACL,CCpjBO,IAAMC,EAAN,MAAMC,UAMHC,CAMR,CACEC,GACAC,GAA2D,KAK3D,OAAc,OAAOC,EAA0C,CAC3D,OAAO,IAAIJ,EAAkB,CACzB,KAAM,OACN,GAAGI,CACP,CAAC,CACL,CAEU,YAAYA,EAAgD,CAElE,GADA,MAAMA,CAAY,EACd,OAAQA,EAAc,QAAW,WACjC,MAAM,IAAI,MAAM,8CAA8C,EAElE,KAAKF,GAAWE,EAAc,MAClC,CAMO,SAA4C,CAC/C,OAAI,KAAKD,KAAoB,OACzB,KAAKA,GAAkB,KAAKD,GAAQ,GAEjC,KAAKC,EAChB,CAKO,YAAa,CAChB,MAAO,CACH,GAAG,MAAM,WAAW,EAKpB,OAAQ,KAAKD,EACjB,CACJ,CAEAG,GACIC,EACAC,EACyB,CACzB,GAAM,CACF,MAAAC,EACA,YAAaC,EACb,OAAAC,CACJ,EAAIJ,EAEJ,GAAI,CAACE,EACD,MAAO,CAAE,MAAAA,EAAO,OAAAE,CAAO,EAG3B,GAAM,CACF,OAAQ,CAAE,gBAAiBC,CAAc,CAC7C,EAAIF,EAGJ,OAAIE,GAAiB,KACV,CAAE,MAAO,GAAM,OAAQA,CAAc,EAGzC,KAAK,QAAQ,EAAE,SAClBA,EACAJ,CACJ,CACJ,CAGO,SACHK,EACAL,EACyB,CACzB,OAAO,MAAM,SAASK,EAAQL,CAAO,CACzC,CAGA,MAAa,cACTK,EACAL,EACkC,CAClC,OAAO,MAAM,cAAcK,EAAQL,CAAO,CAG9C,CAOU,UACNK,EACAL,EACyB,CACzB,OAAO,KAAKF,GACR,KAAK,gBAAgBO,EAAQL,CAAO,EACpCA,CACJ,CACJ,CAOA,MAAgB,eACZK,EACAL,EACkC,CAClC,IAAMD,EAAc,MAAM,MAAM,iBAAiBM,EAAQL,CAAO,EAE1D,CACF,MAAAC,EACA,YAAaC,EACb,OAAAC,CACJ,EAAIJ,EAEJ,GAAI,CAACE,EACD,MAAO,CAAE,MAAAA,EAAO,OAAAE,CAAO,EAG3B,GAAM,CACF,OAAQ,CAAE,gBAAiBC,CAAc,CAC7C,EAAIF,EAEJ,OAAIE,GAAiB,KACV,CAAE,MAAO,GAAM,OAAQA,CAAc,EAGzC,KAAK,QAAQ,EAAE,cAAcA,EAAeJ,CAAO,CAG9D,CAEU,gBACNH,EACI,CACJ,OAAOJ,EAAkB,OAAOI,CAAY,CAChD,CAKO,QACHS,EAEY,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAKO,cAOS,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAKO,SACHC,EAEY,CACZ,OAAO,MAAM,SAASA,CAAY,CACtC,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,QACHC,EAEY,CACZ,OAAO,MAAM,QAAQA,CAAK,CAC9B,CAKO,cAOS,CACZ,OAAO,MAAM,aAAa,CAC9B,CAKO,MACHC,EAQY,CACZ,OAAO,MAAM,MAAMA,CAAK,CAC5B,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,aAOS,CACZ,OAAO,MAAM,YAAY,CAC7B,CACJ,EAkCO,SAASC,EACZC,EACkD,CAClD,OAAOnB,EAAkB,OAAO,CAC5B,KAAM,OACN,WAAY,GACZ,cAAe,CAAC,EAChB,WAAY,CAAC,EACb,OAAAmB,CACJ,CAAQ,CACZ,CC/TO,IAAMC,EAAN,MAAMC,UAMHC,CAAoE,CAI1E,OAAc,OAAOC,EAA0C,CAC3D,OAAO,IAAIF,EAAkB,CACzB,KAAM,OACN,GAAGE,CACP,CAAC,CACL,CAEU,YAAYA,EAAgD,CAClE,MAAMA,CAAY,CACtB,CAKO,QACHC,EAEY,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAKO,cAOS,CACZ,OAAO,KAAK,gBAAgB,CACxB,GAAG,KAAK,WAAW,CACvB,CAAQ,CACZ,CAMAC,GAAaC,EAAqC,CAC9C,OAAIA,IAAW,KAAa,CAAE,MAAO,GAAM,OAAQ,IAAK,EAEpDA,IAAW,QAAa,KAAK,WACV,KAAK,oBAAoB,IACzB,KAAa,CAAE,MAAO,GAAM,OAAQ,IAAK,EACrD,CAAE,MAAO,GAAO,OAAQ,CAAC,CAAE,QAAS,cAAe,CAAC,CAAE,EAG7DA,IAAW,QAAa,CAAC,KAAK,WACvB,CAAE,MAAO,GAAM,OAAQ,MAAiB,EAG5C,CACH,MAAO,GACP,OAAQ,CAAC,CAAE,QAAS,cAAe,CAAC,CACxC,CACJ,CAGO,SACHA,EACAC,EACsB,CACtB,OAAO,MAAM,SAASD,EAAQC,CAAO,CACzC,CAGA,MAAa,cACTD,EACAC,EAC+B,CAC/B,OAAO,MAAM,cAAcD,EAAQC,CAAO,CAG9C,CAMU,UACND,EACAE,EACsB,CACtB,OAAO,KAAKH,GAAaC,CAAM,CACnC,CAMA,MAAgB,eACZA,EACAE,EAC+B,CAC/B,OAAO,KAAKH,GAAaC,CAAM,CACnC,CAEU,gBACNH,EACI,CACJ,OAAOF,EAAkB,OAAOE,CAAY,CAChD,CAKO,SACHM,EAQY,CACZ,OAAO,MAAM,SAASA,CAAY,CACtC,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,QACHC,EAEY,CACZ,OAAO,MAAM,QAAQA,CAAK,CAC9B,CAKO,cAOS,CACZ,OAAO,MAAM,aAAa,CAC9B,CAKO,MACHC,EAQY,CACZ,OAAO,MAAM,MAAMA,CAAK,CAC5B,CASO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,aAOS,CACZ,OAAO,MAAM,YAAY,CAC7B,CACJ,EAsCaC,EAAM,IACfZ,EAAkB,OAAO,CACrB,WAAY,EAChB,CAAC,ECzNL,IAAMa,EAAgE,CAClE,OAAQC,EACR,OAAQC,EACR,QAASC,EACT,KAAMC,EACN,OAAQC,EACR,MAAOC,EACP,MAAOC,EACP,OAAQC,EACR,MAAOC,EACP,KAAMC,EACN,IAAKC,EACL,QAASC,EACT,QAASC,CACb,EAGMC,EAAqE,CACvE,OAAAC,EACA,OAAAC,EACA,QAAAC,EACA,KAAAC,EACA,OAAAC,EACA,MAAAC,EACA,MAAAC,EACA,OAAAC,EACA,MAAAC,EACA,KAAAC,EACA,IAAAC,EACA,QAAAC,EACA,QAAAC,CACJ,EAiTMC,EAAmB,IAAI,IAAI,CAC7B,WACA,gBACA,QACA,aACA,YACA,iBACA,aACA,WACA,WACA,kBACA,qBACA,eACA,kBACA,UACA,eACA,kBACA,cACA,kBACA,mBACA,4BACA,gCACA,uCACA,gBACA,cACJ,CAAC,EAoGM,SAASC,EACZC,EACsB,CAEtB,IAAMC,EAAqB,CAAC,EAC5B,QAAWC,KAAe,OAAO,KAAKF,CAAM,EAAwB,CAChE,GAAI,EAAEE,KAAehC,GACjB,MAAM,IAAI,MACN,yBAAyBgC,CAAW,mBAAmB,OAAO,KAAKhC,CAAc,EAAE,KAAK,IAAI,CAAC,EACjG,EAGJ,IAAMiC,EAAUH,EAAOE,CAAW,EAClC,GAAI,CAACC,GAAW,OAAOA,GAAY,SAC/B,MAAM,IAAI,MACN,yBAAyBD,CAAW,gCACxC,EAGJD,EAAcC,CAAW,EAAI,CAAC,EAC9B,QAAWE,KAAc,OAAO,KAAKD,CAAO,EAAG,CAC3C,GAAIL,EAAiB,IAAIM,CAAU,EAC/B,MAAM,IAAI,MACN,oCAAoCA,CAAU,SAASF,CAAW,GACtE,EAEJ,IAAMG,EAAaF,EAAQC,CAAU,EACrC,GAAI,OAAOC,GAAe,WACtB,MAAM,IAAI,MACN,qBAAqBH,CAAW,IAAIE,CAAU,sBAClD,EAGJH,EAAcC,CAAW,EAAEE,CAAU,EAAI,YAElCE,EACL,CACE,IAAMC,EAAUF,EAAmB,MAAM,KAAMC,CAAI,EAEnD,OACIC,GACA,OAAOA,GAAW,UAClB,OAAOA,EAAO,eAAkB,aAE/B,OAAOA,EAAO,cAAiB,YAC5BA,EAAO,aAAaH,CAAU,IAAM,QAGjCG,EAAO,cACVH,EACAE,EAAK,SAAW,EACVA,EAAK,CAAC,EACNA,EAAK,SAAW,EACd,GACAA,CACZ,EAEGC,CACX,CACJ,CACJ,CAEA,MAAO,CAAE,OAAQN,CAAc,CACnC,CA2EO,SAASO,KAEXC,EAAgD,CAEjD,IAAMC,EAAmB,IAAI,IAE7B,QAAWC,KAAOF,EACd,QAAWP,KAAe,OAAO,KAC7BS,EAAI,MACR,EAAwB,CACfD,EAAiB,IAAIR,CAAW,GACjCQ,EAAiB,IAAIR,EAAa,IAAI,GAAK,EAE/C,IAAMC,EAAUO,EAAiB,IAAIR,CAAW,EAC1CU,EAAaD,EAAI,OAAOT,CAAW,EAEzC,QAAWE,KAAc,OAAO,KAAKQ,CAAU,EAAG,CAC9C,GAAIT,EAAQ,IAAIC,CAAU,EACtB,MAAM,IAAI,MACN,gCAAgCA,CAAU,4CAA4CF,CAAW,GACrG,EAEJC,EAAQ,IAAIC,EAAYQ,EAAWR,CAAU,CAAC,CAClD,CACJ,CAIJ,IAAMS,EAAqD,CAAC,EAE5D,QAAWX,KAAe,OAAO,KAC7BhC,CACJ,EAAwB,CACpB,IAAMiC,EAAUO,EAAiB,IAAIR,CAAW,EAEhD,GAAI,CAACC,GAAWA,EAAQ,OAAS,EAAG,CAEhCU,EAAUX,CAAW,EAAIlB,EAAiBkB,CAAW,EACrD,QACJ,CAEA,IAAMY,EAAY5C,EAAegC,CAAW,EAGtCa,EAAgB,cAAcD,CAAU,CAE1C,eAAeR,EAAa,CACxB,MAAM,GAAGA,CAAI,CACjB,CAEA,OAAO,OAAOU,EAAY,CACtB,OAAO,IAAID,EAAc,CACrB,GAAGC,CACP,CAAC,CACL,CAEU,gBAAgBA,EAAiB,CACvC,OAAOD,EAAc,OAAOC,CAAK,CACrC,CACJ,EAGA,OAAW,CAACZ,EAAYa,CAAQ,IAAKd,EACjC,OAAO,eAAeY,EAAc,UAAWX,EAAY,CACvD,MAAOa,EACP,SAAU,GACV,aAAc,GACd,WAAY,EAChB,CAAC,EAILJ,EAAUX,CAAW,EAAI,IAAII,IAAgB,CAMzC,IAAMY,EAAWlC,EAAiBkB,CAAW,EAAE,GAAGI,CAAI,EACtD,cAAO,eAAeY,EAAUH,EAAc,SAAS,EAChDG,CACX,CACJ,CAEA,OAAOL,CACX","names":["GenericSchemaBuilder","_GenericSchemaBuilder","SchemaBuilder","#templateFn","#defaults","#cachedDefaultSchema","props","args","#getOrCreateDefaultSchema","#buildResult","superResult","context","valid","preValidationTransaction","errors","objToValidate","defaultSchema","#buildAsyncResult","object","_notUsed","errorMessage","value","_name","generic","fnOrDefaults","templateFn","fn","defaults","LazySchemaBuilder","_LazySchemaBuilder","SchemaBuilder","#getter","#resolvedSchema","props","#buildResult","superResult","context","valid","preValidationTransaction","errors","objToValidate","object","_notUsed","errorMessage","value","_name","lazy","getter","NullSchemaBuilder","_NullSchemaBuilder","SchemaBuilder","props","_notUsed","#buildResult","object","context","_context","errorMessage","value","_name","nul","builderClasses","StringSchemaBuilder","NumberSchemaBuilder","BooleanSchemaBuilder","DateSchemaBuilder","ObjectSchemaBuilder","ArraySchemaBuilder","TupleSchemaBuilder","RecordSchemaBuilder","UnionSchemaBuilder","FunctionSchemaBuilder","AnySchemaBuilder","PromiseSchemaBuilder","GenericSchemaBuilder","builderFactories","string","number","boolean","date","object","array","tuple","record","union","func","any","promise","generic","RESERVED_METHODS","defineExtension","config","wrappedConfig","builderName","methods","methodName","origMethod","args","result","withExtensions","extensions","methodsByBuilder","ext","extMethods","factories","BaseClass","ExtendedClass","props","methodFn","original"]}

package/dist/{chunk-ZAN4ZHCJ.js → chunk-HN774HD7.js}

@@ -1,2 +1,2 @@
-import{f as n}from"./chunk-CTP4RHDG.js";var a=class l extends n{static create(e){return new l({type:"any",...e})}constructor(e){super(e)}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#e(e){let{valid:t,transaction:s,errors:i}=e;if(!t)return{valid:t,errors:i};let{object:{validatedObject:r}}=s;return{valid:!0,object:r}}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){return this.#e(this.preValidateSync(e,t))}async _validateAsync(e,t){return this.#e(await super.preValidateAsync(e,t))}createFromProps(e){return l.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()}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},o=()=>a.create({isRequired:!0});export{a,o as b};
-//# sourceMappingURL=chunk-ZAN4ZHCJ.js.map
+import{f as n}from"./chunk-3JMDGYDT.js";var a=class l extends n{static create(e){return new l({type:"any",...e})}constructor(e){super(e)}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#e(e){let{valid:t,transaction:s,errors:i}=e;if(!t)return{valid:t,errors:i};let{object:{validatedObject:r}}=s;return{valid:!0,object:r}}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){return this.#e(this.preValidateSync(e,t))}async _validateAsync(e,t){return this.#e(await super.preValidateAsync(e,t))}createFromProps(e){return l.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()}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},o=()=>a.create({isRequired:!0});export{a,o as b};
+//# sourceMappingURL=chunk-HN774HD7.js.map

package/dist/chunk-K6Z47OQY.js

@@ -0,0 +1,2 @@
+import{c as f,d as k,f as S}from"./chunk-3JMDGYDT.js";var O=class{#e;#t;#n=[];#a=[];get seenValue(){let e=this.#e[f].getValue(this.#t);return e.success?e.value:void 0}get errors(){return this.#n}get isValid(){return this.#n.length===0&&this.getChildErrors().length===0}getChildErrors(){return this.#a}get descriptor(){return this.#e[f]}constructor(e,r,t){if(!b.isValidPropertyDescriptor(e))throw new Error("Invalid property descriptor");this.#e=e,this.#n=Array.isArray(t)?[...t]:[],this.#t=r}addError(e){this.#n.push(e)}addChildError(e){this.#a.push(e)}toJSON(){return{isValid:this.isValid,errors:this.errors}}};var V="must be an object",b=class p extends S{#e={};#t=!1;#n=[];#a=[];[k]=!0;#s=new WeakMap;static create(e){return new p({type:"object",...e})}createFromProps(e){return p.create(e)}constructor(e){super(e),typeof e.properties=="object"&&e.properties&&(this.#e=e.properties,this.#n=Object.keys(e.properties)),typeof e.acceptUnknownProps=="boolean"&&(this.#t=e.acceptUnknownProps),Array.isArray(e.constructorSchemas)&&(this.#a=e.constructorSchemas.filter(r=>r instanceof S))}introspect(){return{...super.introspect(),properties:{...this.#e},acceptUnknownProps:this.#t,constructorSchemas:[...this.#a]}}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()}#i(e){p.isValidPropertyDescriptor(e?.context?.rootPropertyDescriptor)||(e.context.rootPropertyDescriptor=p.getPropertiesFor(this)),p.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.#i(t),t}async preValidateAsync(e,r){let t=await super.preValidateAsync(e,r);return this.#i(t),t}#o(e){let{valid:r,context:t,transaction:n,errors:a}=e,s=new WeakMap,y=new Set,{doNotStopOnFirstError:o,rootValidationObject:i}=t,l=t.rootPropertyDescriptor,u=t.currentPropertyDescriptor,P=(h,m,R)=>{if(!p.isValidPropertyDescriptor(h))throw new Error("invalid property descriptor");let g=s.has(h)?s.get(h):null;if(g||(g=new O(h,i),s.set(h,g)),g.addError(m),y.add(g),R&&p.isValidPropertyDescriptor(R)){let j=s.has(R)?s.get(R):null;j||(j=new O(R,i),s.set(R,j)),j.addChildError(g)}},d=(h=>{let m=typeof h=="function"?h(u):u;if(!p.isValidPropertyDescriptor(m))throw new Error("invalid property descriptor");return s.has(m)||s.set(m,new O(m,i)),s.get(m)}),c=()=>[...y].filter(h=>h.errors.length>0),T=e.errors||[],E=h=>{if(typeof h.property=="function"&&p.isValidPropertyDescriptor(u)){let m=h.property(u);if(p.isValidPropertyDescriptor(m)){P(m,h.message,u);return}}p.isValidPropertyDescriptor(u)&&P(u,h.message)};if(!r&&!o&&a){for(let h of a)E(h);return{earlyReturn:!0,result:{valid:r,errors:a,getErrorsFor:d,getInvalidProperties:c}}}if(o&&a)for(let h of a)E(h);let{object:{validatedObject:x}}=n;if(typeof x>"u"&&!this.isRequired||x===null&&(!this.isRequired||this.isNullable))return{earlyReturn:!0,result:{valid:!0,object:n.commit().validatedObject,getErrorsFor:d,getInvalidProperties:c}};if(typeof x!="object"||x===null)return T.length===0&&(T.push({message:V}),P(u,V)),n&&n.rollback(),{earlyReturn:!0,result:{valid:!1,errors:o?T:[T[0]],getErrorsFor:d,getInvalidProperties:c}};let w=this.#n,D=Object.keys(x);if(w.length===0){if(D.length===0)return o&&T.length>0?{earlyReturn:!0,result:{valid:!1,errors:T,getErrorsFor:d,getInvalidProperties:c}}:(n&&n.commit().validatedObject,{earlyReturn:!0,result:{valid:!0,object:{},getErrorsFor:d,getInvalidProperties:c}});if(!this.#t){for(let h=0;h<D.length;h++){let m=`unknown property '${D[h]}'`;if(T.push({message:m}),!o)break}return n&&n.rollback(),{earlyReturn:!0,result:{valid:!1,errors:o?T:[T[0]],getErrorsFor:d,getInvalidProperties:c}}}return n&&n.commit(),{earlyReturn:!0,result:{valid:!0,object:{...x},getErrorsFor:d,getInvalidProperties:c}}}return{earlyReturn:!1,errors:T,objToValidate:x,propKeys:w,objKeys:D,addErrorFor:P,getErrorsFor:d,getInvalidProperties:c,doNotStopOnFirstError:!!o,rootPropertyDescriptor:l,currentPropertyDescriptor:u,validationTransaction:n}}#p(e,r){let{objToValidate:t,objKeys:n,addErrorFor:a,getErrorsFor:s,getInvalidProperties:y,doNotStopOnFirstError:o,currentPropertyDescriptor:i,validationTransaction:l}=e,u=e.errors,P=!1;for(let{result:d}of r)if(!d.valid&&(P=!0,Array.isArray(d.errors)))for(let c of d.errors)u.push(c);for(let d=0;d<n.length;d++){let c=n[d];if(!(c in this.#e)&&!this.#t){let T=`unknown property '${c}'`;if(u.push({message:T}),a(i,T),!o)return l&&l.rollback(),{valid:!1,errors:[u[0]],getErrorsFor:s,getInvalidProperties:y}}}if(!P&&u.length===0){let d={};for(let{key:c,result:T}of r)d[c]=T.object;if(this.#t)for(let c of n)c in this.#e||(d[c]=t[c]);return{valid:!0,object:d,getErrorsFor:s,getInvalidProperties:y}}for(let{key:d,result:c}of r)if(!c.valid){let T=i[d];if(typeof c.getErrorsFor=="function"&&p.isValidPropertyDescriptor(T)){if(p.#c(c,T,a),Array.isArray(c.__externErrorPropertyNames)&&Array.isArray(c.errors))for(let E of c.errors)a(T,E.message,i)}else if(Array.isArray(c.errors)&&p.isValidPropertyDescriptor(T))for(let E of c.errors)a(T,E.message)}return l.rollback(),{valid:!1,errors:o?u:u[0]?[u[0]]:[],getErrorsFor:s,getInvalidProperties:y}}addValidator(e,r){return super.addValidator(e,r)}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.#r(e,r).getErrorsFor(n)},getInvalidProperties(){return t.#r(e,r).getInvalidProperties()}}}else{let t=this;return{valid:!1,errors:[{message:this.getValidationErrorMessageSync(this.requiredErrorMessage,e)}],getErrorsFor(n){return t.#r(e,r).getErrorsFor(n)},getInvalidProperties(){return t.#r(e,r).getInvalidProperties()}}}else if(typeof e=="object"){let t=this.#n;if(!this.#t){let s=Object.keys(e);for(let y=0;y<s.length;y++)if(!(s[y]in this.#e)){let o=this;return{valid:!1,errors:[{message:`unknown property '${s[y]}'`}],getErrorsFor(i){return o.#r(e,r).getErrorsFor(i)},getInvalidProperties(){return o.#r(e,r).getInvalidProperties()}}}}let n={};for(let s=0;s<t.length;s++){let y=t[s],o=this.#e[y].validate(e[y]);if(!o.valid){let i=this;return{valid:!1,errors:o.errors&&o.errors.length>0?[o.errors[0]]:[],getErrorsFor(l){return i.#r(e,r).getErrorsFor(l)},getInvalidProperties(){return i.#r(e,r).getInvalidProperties()}}}n[y]=o.object}if(this.#t){let s=Object.keys(e);for(let y=0;y<s.length;y++)s[y]in this.#e||(n[s[y]]=e[s[y]])}let a=this;return{valid:!0,object:n,getErrorsFor(s){return a.#r(e,r).getErrorsFor(s)},getInvalidProperties(){return a.#r(e,r).getInvalidProperties()}}}}return this.#r(e,r)}#r(e,r){let t=this.#o(this.preValidateSync(e,r));if(t.earlyReturn)return t.result;let{propKeys:n,objToValidate:a,doNotStopOnFirstError:s,rootPropertyDescriptor:y,currentPropertyDescriptor:o}=t,i=[];for(let l of n){let u=this.#e[l].validate(a[l],{...r,rootPropertyDescriptor:y,currentPropertyDescriptor:o[l]});if(i.push({key:l,result:u}),!u.valid&&!s)break}return this.#p(t,i)}async _validateAsync(e,r){let t=this.#o(await this.preValidateAsync(e,r));if(t.earlyReturn)return t.result;let{propKeys:n,objToValidate:a,doNotStopOnFirstError:s,rootPropertyDescriptor:y,currentPropertyDescriptor:o}=t,i=[];if(s){let l=await Promise.all(n.map(async u=>{let P=await this.#e[u].validateAsync(a[u],{...r,rootPropertyDescriptor:y,currentPropertyDescriptor:o[u]});return{key:u,result:P}}));i.push(...l)}else for(let l of n){let u=await this.#e[l].validateAsync(a[l],{...r,rootPropertyDescriptor:y,currentPropertyDescriptor:o[l]});if(i.push({key:l,result:u}),!u.valid)break}return this.#p(t,i)}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()})}addConstructor(e){if(!(e instanceof S))throw new Error("schema must be an instance of the SchemaBuilder class");return this.createFromProps({...this.introspect(),constructorSchemas:[...this.#a,e]})}clearConstructors(){return this.createFromProps({...this.introspect(),constructorSchemas:[]})}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 S))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 p)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 S))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(a=>{if(typeof a!="string"||!a)throw new Error("property name must be a string");if(!(a in this.#e))throw new Error(`property ${a.toString()} does not exists in the schema`);t.set(a.toString(),!0)}),t.size===0)throw new Error("please provide at least one property to omit");let n={...this.introspect()};for(let a of t.keys())delete n.properties[a];return this.createFromProps(n)}else if(e instanceof p){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 p))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((a,s)=>(a[s]=s in r?r[s]:t.properties[s],a),{});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 p?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 p){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 S))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#y(e,r,t,n,a){let s=e.introspect();if(!s.properties)return{};let y=Object.keys(s.properties);if(y.length===0)return{};typeof r!="function"&&(r=i=>i);let o=B((i,l)=>(t||r)(i,l),n,e,a);for(let i of y){let l=s.properties[i];if(l instanceof p){let u=l.introspect().properties;u&&typeof u=="object"&&Object.keys(u).length>0?o[i]=p.#y(l,(P,d)=>{let c=r(P,d);return c?(d&&!c[i]&&(c[i]={}),c[i]):null},r,i,o[f]):o[i]=B(r,i,l,o[f])}else if(l[k]===!0){let u=B(r,i,l,o[f]),P=(d,c)=>{let T=r(d,c);return T?(c&&!T[i]&&(T[i]={}),T[i]):null};o[i]=q(u,P)}else o[i]=B(r,i,l,o[f])}return o}static getPropertiesFor(e){if(!(e instanceof p))throw new Error("schema must be an instance of the ObjectSchemaBuilder class");if(e.#s.has(e))return e.#s.get(e);let r=p.#y(e);return e.#s.set(e,r),r}static isValidPropertyDescriptor(e){return typeof e=="object"&&e!==null&&typeof e[f]=="object"}static#c(e,r,t){let a=p.#l(r).introspect().properties,s;if(a)s=Object.keys(a);else if(Array.isArray(e.__externErrorPropertyNames))s=e.__externErrorPropertyNames;else return;for(let y of s){let o=r[y];if(!p.isValidPropertyDescriptor(o))continue;let i=e.getErrorsFor(()=>o);if(!i.isValid)for(let l of i.errors)t(o,l,r);if(a){let l=a[y];(l instanceof p||l[k]===!0)&&typeof e.getErrorsFor=="function"&&p.isValidPropertyDescriptor(o)&&p.#c(e,o,t)}}}static#l(e){if(!p.isValidPropertyDescriptor(e))throw new Error("descriptor is not a valid property descriptor");return e[f].getSchema()}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},v=(p=>b.create({isRequired:!0,properties:p})),B=(p,e,r,t)=>({[f]:{setValue:(n,a,s)=>{let y=p(n,!!s?.createMissingStructure);return y?(typeof e=="string"&&(y[e]=a),!0):!1},getValue:n=>{let a=p(n,!1);return a?typeof e!="string"?{success:!0,value:a}:Object.hasOwn(a,e)?{success:!0,value:a[e]}:{success:!1}:{success:!1}},getSchema:()=>r,parent:t,propertyName:e,toJsonPointer:()=>{let n=[];typeof e=="string"&&n.push(e.replace(/~/g,"~0").replace(/\//g,"~1"));let a=t;for(;a;)typeof a.propertyName=="string"&&n.push(a.propertyName.replace(/~/g,"~0").replace(/\//g,"~1")),a=a.parent;return n.reverse(),n.length>0?"/"+n.join("/"):""}}}),q=(p,e)=>new Proxy(p,{get(r,t,n){if(t===f)return r[f];if(typeof t=="string"&&!(t in r)){let a=B(e,t,void 0,r[f]),s=(y,o)=>{let i=e(y,o);return i!=null&&typeof i=="object"?(o&&!(t in i)&&(i[t]={}),i[t]):null};r[t]=q(a,s)}return Reflect.get(r,t,n)}});v.getPropertiesFor=p=>b.getPropertiesFor(p);v.isValidPropertyDescriptor=b.isValidPropertyDescriptor;export{b as a,v as b};
+//# sourceMappingURL=chunk-K6Z47OQY.js.map

package/dist/chunk-K6Z47OQY.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, 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\n/**\n * Extracts the positional argument types from a schema whose inferred type is a\n * function.  When the branded `InferType<T>` resolves to a function type the\n * parameter tuple is extracted; otherwise `any[]` is used as a safe fallback.\n *\n * @example\n * ```ts\n * type Args = ConstructorParams<typeof func().addParameter(string()).addParameter(number())>;\n * // → [string, number]\n * ```\n */\ntype ConstructorParams<T extends SchemaBuilder<any, any, any, any, any>> =\n    InferType<T> extends (...args: infer A) => any ? A : any[];\n\n/**\n * Converts a tuple of `FunctionSchemaBuilder`s into an intersection of\n * `new (...args) => TInstance` call signatures, producing overloaded\n * construct signatures in the inferred type.\n *\n * The recursion peels schemas off the front of `TSchemas` one at a time,\n * each contributing one construct overload to the intersection.\n *\n * @example\n * ```ts\n * type Sigs = ConstructorSignatures<\n *   [typeof func().addParameter(string()), typeof func().addParameter(number())],\n *   { name: string }\n * >;\n * // → { new (p0: string): { name: string } }\n * //   & { new (p0: number): { name: string } }\n * ```\n */\ntype ConstructorSignatures<\n    TSchemas extends SchemaBuilder<any, any, any, any, any>[],\n    TInstance\n> = TSchemas extends [\n    infer THead extends SchemaBuilder<any, any, any, any, any>,\n    ...infer TTail extends SchemaBuilder<any, any, any, any, any>[]\n]\n    ? {\n          new (...args: ConstructorParams<THead>): TInstance;\n      } & ConstructorSignatures<TTail, TInstance>\n    : unknown;\n\n/**\n * Wraps `TInstance` with constructor overload signatures derived from\n * `TSchemas`.  When the tuple is empty the type is returned unchanged\n * (no-op); otherwise the result is an intersection of all construct\n * signatures with `TInstance`.\n *\n * This is the type projected onto `InferType<ObjectSchemaBuilder>` when one\n * or more constructors have been registered via `.addConstructor()`.\n *\n * @example\n * ```ts\n * // No constructors — passthrough\n * type A = WithConstructors<[], { name: string }>;\n * // → { name: string }\n *\n * // One constructor\n * type B = WithConstructors<[typeof func().addParameter(string())], { name: string }>;\n * // → { new (p0: string): { name: string } } & { name: string }\n *\n * // Two constructors → overloaded construct signatures\n * type C = WithConstructors<\n *   [typeof func().addParameter(string()), typeof func().addParameter(number())],\n *   { name: string }\n * >;\n * // → { new (p0: string): { name: string } }\n * //   & { new (p0: number): { name: string } }\n * //   & { name: string }\n * ```\n */\ntype WithConstructors<\n    TSchemas extends SchemaBuilder<any, any, any, any, any>[],\n    TInstance\n> = TSchemas extends []\n    ? TInstance\n    : ConstructorSignatures<TSchemas, TInstance> & TInstance;\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        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, any>,\n    TSchema extends ObjectSchemaBuilder<\n        any,\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<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n    >\n        ? PropertyValidationResult<\n              TPropertySchema,\n              TRootSchema,\n              TParentPropertyDescriptor\n          >\n        : NestedValidationResult<\n              TPropertySchema,\n              TRootSchema,\n              TParentPropertyDescriptor\n          >;\n\n    /**\n     * Returns a list of all property validation results that have direct\n     * validation errors. Each entry exposes `.descriptor` (with\n     * `.toJsonPointer()` for the property's path) and `.errors`.\n     *\n     * This is useful for collecting all errors with their full JSON Pointer\n     * paths, e.g. for building RFC 9457 Problem Details responses.\n     */\n    getInvalidProperties(): ReadonlyArray<\n        NestedValidationResult<any, TRootSchema, any>\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    TConstructorSchemas extends SchemaBuilder<any, any, any, any, any>[] = []\n> extends SchemaBuilder<\n    undefined extends TExplicitType\n        ? WithConstructors<\n              TConstructorSchemas,\n              RespectPropsOptionality<TProperties>\n          >\n        : TExplicitType,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #properties: TProperties = {} as any;\n    #acceptUnknownProps = false;\n    #propKeys: string[] = [];\n    #constructorSchemas: SchemaBuilder<any, any, any, any, any>[] = [];\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        if (Array.isArray(props.constructorSchemas)) {\n            this.#constructorSchemas = (\n                props.constructorSchemas as SchemaBuilder<\n                    any,\n                    any,\n                    any,\n                    any,\n                    any\n                >[]\n            ).filter(s => s instanceof SchemaBuilder);\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             * The list of constructor schemas registered via `.addConstructor()`.\n             * Each element is a `FunctionSchemaBuilder` whose inferred function\n             * type provides one overloaded construct signature in `InferType`.\n             * Empty array when no constructors have been added.\n             */\n            constructorSchemas: [\n                ...this.#constructorSchemas\n            ] as TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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 invalidResults = new Set<PropertyValidationResult<any, 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            invalidResults.add(validationError);\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 getInvalidProperties = () =>\n            [...invalidResults].filter(r => r.errors.length > 0);\n\n        const errors = prevalidatedResult.errors || [];\n\n        /**\n         * Routes a pre-validation error through `addErrorFor`, respecting\n         * the optional `property` selector on `ValidationError`.\n         */\n        const routePreValidationError = (error: {\n            message: string;\n            property?: (tree: any) => any;\n        }) => {\n            if (\n                typeof error.property === 'function' &&\n                ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    currentPropertyDescriptor\n                )\n            ) {\n                const targetDescriptor = error.property(\n                    currentPropertyDescriptor\n                );\n                if (\n                    ObjectSchemaBuilder.isValidPropertyDescriptor(\n                        targetDescriptor\n                    )\n                ) {\n                    addErrorFor(\n                        targetDescriptor,\n                        error.message,\n                        currentPropertyDescriptor\n                    );\n                    return;\n                }\n            }\n            // Fallback: attach to root descriptor\n            if (\n                ObjectSchemaBuilder.isValidPropertyDescriptor(\n                    currentPropertyDescriptor\n                )\n            ) {\n                addErrorFor(currentPropertyDescriptor, error.message);\n            }\n        };\n\n        if (!valid && !doNotStopOnFirstError && preValidationErrors) {\n            for (const error of preValidationErrors) {\n                routePreValidationError(error);\n            }\n\n            return {\n                earlyReturn: true as const,\n                result: {\n                    valid,\n                    errors: preValidationErrors,\n                    getErrorsFor,\n                    getInvalidProperties\n                }\n            };\n        }\n\n        // When doNotStopOnFirstError is true and there are pre-validation\n        // errors (e.g. from addValidator), route them through addErrorFor\n        // so they are visible via getErrorsFor().\n        if (doNotStopOnFirstError && preValidationErrors) {\n            for (const error of preValidationErrors) {\n                routePreValidationError(error);\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                    getInvalidProperties\n                }\n            };\n        }\n\n        if (typeof objToValidate !== 'object' || objToValidate === null) {\n            // Only add \"must be an object\" when there is no prior error (e.g.\n            // a required-violation error already pushed by preValidateAsync).\n            if (errors.length === 0) {\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 (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                    getInvalidProperties\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                            getInvalidProperties\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                        getInvalidProperties\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                        getInvalidProperties\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                    getInvalidProperties\n                }\n            };\n        }\n\n        return {\n            earlyReturn: false as const,\n            errors,\n            objToValidate,\n            propKeys,\n            objKeys,\n            addErrorFor,\n            getErrorsFor,\n            getInvalidProperties,\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            getInvalidProperties: 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            getInvalidProperties,\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                        getInvalidProperties\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                getInvalidProperties\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            getInvalidProperties\n        };\n    }\n\n    /**\n     * Adds a `validator` to validators list.\n     *\n     * Object-level validators can return errors with a `property` selector\n     * to route the error to a specific property, making it visible via\n     * `getErrorsFor()`.\n     *\n     * ```ts\n     * schema.addValidator((value) => ({\n     *     valid: false,\n     *     errors: [{\n     *         message: 'Passwords do not match',\n     *         property: (t) => t.confirmPassword\n     *     }]\n     * }));\n     * ```\n     *\n     * The `property` selector uses the same `PropertyDescriptorTree`\n     * as `getErrorsFor()` and react-form's `forProperty`.\n     */\n    public addValidator(\n        validator: (\n            object: undefined extends TExplicitType\n                ? WithConstructors<\n                      TConstructorSchemas,\n                      RespectPropsOptionality<TProperties>\n                  >\n                : TExplicitType\n        ) =>\n            | {\n                  valid: boolean;\n                  errors?: Array<{\n                      message: string;\n                      property?: (\n                          properties: PropertyDescriptorTree<\n                              ObjectSchemaBuilder<TProperties>\n                          >\n                      ) => PropertyDescriptor<any, any, any>;\n                  }>;\n              }\n            | Promise<{\n                  valid: boolean;\n                  errors?: Array<{\n                      message: string;\n                      property?: (\n                          properties: PropertyDescriptorTree<\n                              ObjectSchemaBuilder<TProperties>\n                          >\n                      ) => PropertyDescriptor<any, any, any>;\n                  }>;\n              }>,\n        options?: { mutates?: boolean }\n    ): this {\n        return super.addValidator(validator as any, options);\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                        getInvalidProperties() {\n                            return self\n                                .#validateFull(object, context)\n                                .getInvalidProperties();\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                        getInvalidProperties() {\n                            return self\n                                .#validateFull(object, context)\n                                .getInvalidProperties();\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                                getInvalidProperties() {\n                                    return self\n                                        .#validateFull(object, context)\n                                        .getInvalidProperties();\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                            getInvalidProperties() {\n                                return self\n                                    .#validateFull(object, context)\n                                    .getInvalidProperties();\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                    getInvalidProperties() {\n                        return self\n                            .#validateFull(object, context)\n                            .getInvalidProperties();\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect()\n        } as any) as any;\n    }\n\n    /**\n     * Appends a constructor overload to the object schema.\n     *\n     * Each call extends the set of construct signatures on the inferred type by\n     * one overload.  The accumulated argument lists are taken from the\n     * `FunctionSchemaBuilder` passed in — specifically from the positional\n     * parameter schemas registered via `.addParameter()`.\n     *\n     * At **runtime** the schema continues to validate plain objects; the\n     * constructor information is purely a TypeScript-level annotation and is\n     * stored in `introspect().constructorSchemas` for tooling use.\n     *\n     * Multiple calls are supported and produce **overloaded** construct\n     * signatures in the inferred type, modelling a class that exposes several\n     * constructor overloads.\n     *\n     * @param schema - A `FunctionSchemaBuilder` describing one constructor\n     *   overload.  Use `.addParameter()` on the function schema to declare the\n     *   parameter types.  The return type, if set via `.hasReturnType()`, is\n     *   ignored — the return type of a constructor is always the instance type\n     *   derived from the object schema's properties.\n     *\n     * @returns A new `ObjectSchemaBuilder` whose `TConstructorSchemas` tuple has\n     *   been extended by `schema`, updating `InferType` to include the new\n     *   construct signature.\n     *\n     * @example\n     * ```ts\n     * import { object, string, number, func, InferType } from '@cleverbrush/schema';\n     *\n     * // Single constructor\n     * const PersonSchema = object({ name: string(), age: number() })\n     *     .addConstructor(\n     *         func().addParameter(string()).addParameter(number())\n     *     );\n     *\n     * type Person = InferType<typeof PersonSchema>;\n     * // → { new (p0: string, p1: number): { name: string; age: number } }\n     * //   & { name: string; age: number }\n     * ```\n     *\n     * @example\n     * ```ts\n     * import { object, string, number, func, InferType } from '@cleverbrush/schema';\n     *\n     * // Multiple constructors via chained calls → overloaded signatures\n     * const PointSchema = object({ x: number(), y: number() })\n     *     .addConstructor(func())                                     // no-arg ctor\n     *     .addConstructor(func().addParameter(number()).addParameter(number())); // (x, y) ctor\n     *\n     * type Point = InferType<typeof PointSchema>;\n     * // → { new (): { x: number; y: number } }\n     * //   & { new (p0: number, p1: number): { x: number; y: number } }\n     * //   & { x: number; y: number }\n     *\n     * // Validation still operates on plain objects — the constructor type is\n     * // a compile-time annotation only.\n     * const result = PointSchema.validate({ x: 1, y: 2 });\n     * // result.valid === true\n     *\n     * // Introspect the registered constructor schemas at runtime:\n     * const info = PointSchema.introspect();\n     * // info.constructorSchemas.length === 2\n     * ```\n     */\n    public addConstructor<TFunc extends SchemaBuilder<any, any, any, any, any>>(\n        schema: TFunc\n    ): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions,\n        [...TConstructorSchemas, TFunc]\n    > &\n        TExtensions {\n        if (!(schema instanceof SchemaBuilder)) {\n            throw new Error(\n                'schema must be an instance of the SchemaBuilder class'\n            );\n        }\n\n        return this.createFromProps({\n            ...this.introspect(),\n            constructorSchemas: [...this.#constructorSchemas, schema]\n        } as any) as any;\n    }\n\n    /**\n     * Removes all constructor overloads previously registered via\n     * `.addConstructor()`, resetting the `TConstructorSchemas` tuple to `[]`.\n     *\n     * After calling this method `InferType` reverts to the plain object type\n     * derived from the schema's properties — no construct signatures are\n     * included.\n     *\n     * `introspect().constructorSchemas` will return an empty array.\n     *\n     * @returns A new `ObjectSchemaBuilder` with `TConstructorSchemas = []`.\n     *\n     * @example\n     * ```ts\n     * import { object, string, func, InferType } from '@cleverbrush/schema';\n     *\n     * const WithCtor = object({ name: string() })\n     *     .addConstructor(func().addParameter(string()));\n     *\n     * type WithCtorType = InferType<typeof WithCtor>;\n     * // → { new (p0: string): { name: string } } & { name: string }\n     *\n     * const Plain = WithCtor.clearConstructors();\n     *\n     * type PlainType = InferType<typeof Plain>;\n     * // → { name: string }\n     *\n     * Plain.introspect().constructorSchemas; // []\n     * ```\n     */\n    public clearConstructors(): ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions,\n        []\n    > &\n        TExtensions {\n        return this.createFromProps({\n            ...this.introspect(),\n            constructorSchemas: []\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        TConstructorSchemas\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            ? WithConstructors<\n                  TConstructorSchemas,\n                  Id<RespectPropsOptionality<TProperties>>\n              >\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        TConstructorSchemas\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, 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              TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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              TConstructorSchemas\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, 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              TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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<\n        K extends ObjectSchemaBuilder<any, any, any, any, any, any, any>\n    >(\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              TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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        TConstructorSchemas\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, 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        propertyName,\n        toJsonPointer: () => {\n            const segments: string[] = [];\n            if (typeof propertyName === 'string') {\n                segments.push(\n                    propertyName.replace(/~/g, '~0').replace(/\\//g, '~1')\n                );\n            }\n            let ancestor = parent;\n            while (ancestor) {\n                if (typeof ancestor.propertyName === 'string') {\n                    segments.push(\n                        ancestor.propertyName\n                            .replace(/~/g, '~0')\n                            .replace(/\\//g, '~1')\n                    );\n                }\n                ancestor = ancestor.parent as any;\n            }\n            segments.reverse();\n            return segments.length > 0 ? '/' + segments.join('/') : '';\n        }\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        any,\n        any,\n        any\n    > = ObjectSchemaBuilder<\n        TProperties,\n        TRequired,\n        false,\n        TExplicitType,\n        false,\n        {},\n        []\n    >\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","#constructorSchemas","SYMBOL_HAS_PROPERTIES","#propertyDescriptorTreeMap","props","s","errorMessage","value","_name","#applyPropertyDescriptors","result","object","context","#setupValidation","prevalidatedResult","valid","prevalidationContext","validationTransaction","preValidationErrors","propertyDescriptorToErrorMap","invalidResults","doNotStopOnFirstError","rootValidationObject","rootPropertyDescriptor","currentPropertyDescriptor","addErrorFor","propertyDescriptor","message","parentPropertyDescriptor","validationError","PropertyValidationResult","parentValidationError","getErrorsFor","selector","descriptor","getInvalidProperties","r","errors","routePreValidationError","error","targetDescriptor","objToValidate","propKeys","objKeys","i","#processResults","setup","validationResults","hasInvalid","key","resultObject","#propagateNestedErrors","validator","options","self","#validateFull","results","_notUsed","schema","propName","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","segments","ancestor","baseDescriptor","valueSelector","target","receiver","child","childValueSelector","parentValue"]}

package/dist/chunk-NUW3VXZV.js

@@ -0,0 +1,2 @@
+import{c as T,e as p,f as h}from"./chunk-3JMDGYDT.js";var y=class m extends h{#r;#l=function(){return`is expected to have no less than ${this.#r} elements`};#n=this.#l;#t;#u=function(){return`is expected to have no more than ${this.#t} elements`};#s=this.#u;#e;static create(e){return new m({type:"array",...e})}constructor(e){super(e),typeof e.minLength=="number"&&(this.#r=e.minLength),this.#n=this.assureValidationErrorMessageProvider(e.minLengthValidationErrorMessageProvider,this.#l),typeof e.maxLength=="number"&&(this.#t=e.maxLength),this.#s=this.assureValidationErrorMessageProvider(e.maxLengthValidationErrorMessageProvider,this.#u),e.elementSchema instanceof h&&(this.#e=e.elementSchema)}hasType(e){return this.createFromProps({...this.introspect()})}clearHasType(){return this.createFromProps({...this.introspect()})}#o(e,t){let{valid:u,context:r,errors:a,transaction:l}=t,d={[T]:{setValue:()=>!1,getValue:i=>({success:!0,value:i}),getSchema:()=>this,parent:void 0,propertyName:void 0,toJsonPointer:()=>""}},o=[],c=p([],()=>e,()=>o,()=>d[T]),s=(()=>c);if(!u)return o.push(...(a||[]).map(i=>i.message||String(i))),{needsElementValidation:!1,result:{valid:u,errors:a,getNestedErrors:s}};let{object:{validatedObject:n}}=l;return typeof n>"u"&&!this.isRequired||n===null&&(!this.isRequired||this.isNullable)?{needsElementValidation:!1,result:{valid:!0,object:n,getNestedErrors:s}}:Array.isArray(n)?{needsElementValidation:!0,objToValidate:n,prevalidationContext:r,getNestedErrors:s,elementResults:c,rootErrors:o}:(o.push("array expected"),{needsElementValidation:!1,result:{valid:!1,errors:[{message:"array expected"}],getNestedErrors:s}})}#i(e){return typeof this.#t=="number"&&e.length>this.#t?{provider:this.#s}:typeof this.#r=="number"&&e.length<this.#r?{provider:this.#n}:null}#d(e,t,u){let r=!0;for(let a=0;a<e.length;a++)e[a]?.valid||(r=!1),t[a]=e[a];return Object.assign({valid:r,getNestedErrors:u},r?{}:{errors:e.map(a=>a?.errors).filter(a=>a).flatMap(a=>a?.map(l=>({...l})))},r?{object:e.map(a=>a?.object)}:{})}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){if(this.canSkipPreValidation&&!t?.doNotStopOnFirstError&&this.#e instanceof h){if(typeof e>"u"||e===null)if(typeof e>"u"&&this.hasDefault)e=this.resolveDefaultValue();else if(!this.isRequired||e===null&&this.isNullable){let a=this;return{valid:!0,object:e,getNestedErrors(){return a.#a(e,t).getNestedErrors()}}}else return this.#a(e,t);if(!Array.isArray(e))return this.#a(e,t);if(this.#i(e))return this.#a(e,t);let u=e.length;if(u>0){let a=new Array(u);for(let d=0;d<u;d++){let o=this.#e.validate(e[d]);if(!o.valid){let c=this;return{valid:!1,errors:o.errors&&o.errors.length>0?[o.errors[0]]:[],getNestedErrors(){return c.#a(e,t).getNestedErrors()}}}a[d]=o.object}let l=this;return{valid:!0,object:a,getNestedErrors(){return l.#a(e,t).getNestedErrors()}}}let r=this;return{valid:!0,object:e,getNestedErrors(){return r.#a(e,t).getNestedErrors()}}}return this.#a(e,t)}#a(e,t){let u=this.#o(e,this.preValidateSync(e,t));if(!u.needsElementValidation)return u.result;let{objToValidate:r,prevalidationContext:a,getNestedErrors:l,elementResults:d,rootErrors:o}=u,c=this.#i(r);if(c){let s=this.getValidationErrorMessageSync(c.provider,r);return o.push(s),{valid:!1,errors:[{message:s}],getNestedErrors:l}}if(r.length>0&&this.#e instanceof h)if(a.doNotStopOnFirstError){let s=[];for(let n=0;n<r.length;n++)s.push(this.#e.validate(r[n],{...a}));return this.#d(s,d,l)}else{let s=new Array(r.length);for(let n=0;n<r.length;n++){let i=this.#e.validate(r[n],{...a});if(d[n]=i,i.valid)s[n]=i.object;else return{valid:!1,errors:Array.isArray(i.errors)&&i.errors.length>0?[i.errors[0]]:[],getNestedErrors:l}}return{valid:!0,object:s,getNestedErrors:l}}return{valid:!0,object:r,getNestedErrors:l}}async _validateAsync(e,t){let u=this.#o(e,await super.preValidateAsync(e,t));if(!u.needsElementValidation)return u.result;let{objToValidate:r,prevalidationContext:a,getNestedErrors:l,elementResults:d,rootErrors:o}=u,c=this.#i(r);if(c){let s=await this.getValidationErrorMessage(c.provider,r);return o.push(s),{valid:!1,errors:[{message:s}],getNestedErrors:l}}if(r.length>0&&this.#e instanceof h)if(a.doNotStopOnFirstError){let s=await Promise.all(r.map(n=>this.#e?.validateAsync(n,a)));return this.#d(s,d,l)}else{let s=new Array(r.length);for(let n=0;n<r.length;n++){let i=await this.#e.validateAsync(r[n],{...a});if(d[n]=i,i.valid)s[n]=i.object;else return{valid:!1,errors:Array.isArray(i.errors)&&i.errors.length>0?[i.errors[0]]:[],getNestedErrors:l}}return{valid:!0,object:s,getNestedErrors:l}}return{valid:!0,object:r,getNestedErrors:l}}createFromProps(e){return m.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()}introspect(){return{...super.introspect(),elementSchema:this.#e,minLength:this.#r,minLengthValidationErrorMessageProvider:this.#n,maxLength:this.#t,maxLengthValidationErrorMessageProvider:this.#s}}of(e){return m.create({...this.introspect(),elementSchema:e})}clearOf(){return m.create({...this.introspect(),elementSchema:void 0})}minLength(e,t){if(typeof e!="number"||e<0)throw new Error("length is expected to be a number which is >= 0");return m.create({...this.introspect(),minLength:e,minLengthValidationErrorMessageProvider:t})}clearMinLength(){let e=this.introspect();return delete e.minLength,this.createFromProps({...e})}maxLength(e,t){if(typeof e!="number"||e<0)throw new Error("length is expected to be a number which is >= 0");return m.create({...this.introspect(),maxLength:e,maxLengthValidationErrorMessageProvider:t})}clearMaxLength(){let e=this.introspect();return delete e.maxLength,this.createFromProps({...e})}nullable(){return super.nullable()}notNullable(){return super.notNullable()}},S=m=>y.create({isRequired:!0,elementSchema:m});export{y as a,S as b};
+//# sourceMappingURL=chunk-NUW3VXZV.js.map