@cleverbrush/schema 4.5.0 → 5.0.0

package/dist/chunk-JEBLDVKG.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     * Inspect root or property-specific validation errors with a selector.\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 for type annotations and advanced use.\n * Customize via extensions rather than subclassing. Avoid instantiating it\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 * // Inspect property errors using result.getErrorsFor().\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    /** Native type parameters for extension rebinding; never emitted at runtime. @internal */\n    declare readonly __cleverbrush_builder_type__: readonly [\n        'object',\n        TProperties,\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TConstructorSchemas\n    ];\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                        if (\n                            Array.isArray((result as any).getNestedErrors?.())\n                        ) {\n                            ObjectSchemaBuilder.#propagateIndexedErrors(\n                                result,\n                                descriptor,\n                                addErrorFor\n                            );\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.derive({\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.derive({\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.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) 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.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) 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.derive({\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.derive({\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.derive({\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.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) 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.derive({\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.derive({\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.derive(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.derive(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.derive({\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.derive({\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.derive(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.derive({\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.derive({\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.derive({\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.derive(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.derive({\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.derive({\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.introspect().type === 'array') {\n                (result as any)[propName] = createIndexedDescriptor(\n                    propSchema,\n                    selector,\n                    propName,\n                    result[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\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            // Indexed descriptors are created lazily, so they are not keys in\n            // an object's static property map. Copy precise invalid descriptors\n            // below this property as well as the existing aggregate messages.\n            if (\n                nestedPropertyDescriptor[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR]\n                    .getSchema()\n                    ?.introspect().type === 'array' &&\n                typeof result.getInvalidProperties === 'function'\n            ) {\n                const prefix =\n                    nestedPropertyDescriptor[\n                        SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR\n                    ].toJsonPointer() + '/';\n                for (const invalid of result.getInvalidProperties()) {\n                    const pointer = invalid.descriptor.toJsonPointer();\n                    if (!pointer.startsWith(prefix)) continue;\n                    const target = pointer\n                        .slice(prefix.length)\n                        .split('/')\n                        .reduce(\n                            (node: any, part: string) =>\n                                node?.[\n                                    part.replace(/~1/g, '/').replace(/~0/g, '~')\n                                ],\n                            nestedPropertyDescriptor\n                        );\n                    if (!ObjectSchemaBuilder.isValidPropertyDescriptor(target))\n                        continue;\n                    for (const message of invalid.errors)\n                        addErrorFor(target, message, nestedPropertyDescriptor);\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    /** Propagate structured array results without interpreting message strings. */\n    static #propagateIndexedErrors(\n        result: any,\n        descriptor: any,\n        addErrorFor: (descriptor: any, message: string, parent?: any) => void\n    ): void {\n        const children = result.getNestedErrors?.();\n        if (!Array.isArray(children)) return;\n        children.forEach((child, index) => {\n            const indexed = descriptor[index];\n            if (\n                !child ||\n                child.valid ||\n                !ObjectSchemaBuilder.isValidPropertyDescriptor(indexed)\n            )\n                return;\n            if (typeof child.getInvalidProperties === 'function') {\n                const prefix =\n                    indexed[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR].toJsonPointer();\n                for (const invalid of child.getInvalidProperties()) {\n                    const pointer = invalid.descriptor.toJsonPointer();\n                    const relative =\n                        pointer === prefix\n                            ? ''\n                            : pointer.startsWith(prefix + '/')\n                              ? pointer.slice(prefix.length)\n                              : pointer;\n                    const target =\n                        relative === ''\n                            ? indexed\n                            : relative\n                                  .slice(1)\n                                  .split('/')\n                                  .reduce(\n                                      (node: any, part: string) =>\n                                          node?.[\n                                              part\n                                                  .replace(/~1/g, '/')\n                                                  .replace(/~0/g, '~')\n                                          ],\n                                      indexed\n                                  );\n                    if (!ObjectSchemaBuilder.isValidPropertyDescriptor(target))\n                        continue;\n                    for (const message of invalid.errors)\n                        addErrorFor(target, message, descriptor);\n                }\n            } else {\n                for (const error of child.errors ?? [])\n                    addErrorFor(indexed, error.message, descriptor);\n                ObjectSchemaBuilder.#propagateIndexedErrors(\n                    child,\n                    indexed,\n                    addErrorFor\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/** Build only requested array indices, preserving descriptor identity. */\nconst createIndexedDescriptor = (\n    schema: SchemaBuilder<any, any, any, any, any>,\n    parentSelector: (value: any, create: boolean) => any,\n    name: string,\n    parent: PropertyDescriptorInner<any, any, any>\n): any => {\n    const base = createPropertyDescriptorFor(\n        parentSelector,\n        name,\n        schema,\n        parent\n    );\n    const intro = schema.introspect() as any;\n    const valueSelector = (root: any, create: boolean) => {\n        const container = parentSelector(root, create);\n        if (!container || typeof container !== 'object') return null;\n        if (\n            create &&\n            (!Object.hasOwn(container, name) || container[name] == null)\n        ) {\n            Object.defineProperty(container, name, {\n                value: intro.type === 'array' ? [] : {},\n                enumerable: true,\n                writable: true,\n                configurable: true\n            });\n        }\n        return Object.hasOwn(container, name) ? container[name] : null;\n    };\n    const inner = base[SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR];\n    if (intro.type === 'array') {\n        const indices = new Map<string, any>();\n        return new Proxy(base, {\n            get(target, key, receiver) {\n                if (\n                    typeof key !== 'string' ||\n                    !/^(0|[1-9]\\d*)$/.test(key) ||\n                    Number(key) >= 4294967295\n                ) {\n                    return Reflect.get(target, key, receiver);\n                }\n                if (!intro.elementSchema) return undefined;\n                if (!indices.has(key)) {\n                    indices.set(\n                        key,\n                        createIndexedDescriptor(\n                            intro.elementSchema,\n                            (root, create) => {\n                                const array = valueSelector(root, create);\n                                return Array.isArray(array) ? array : null;\n                            },\n                            key,\n                            inner as any\n                        )\n                    );\n                }\n                return indices.get(key);\n            }\n        });\n    }\n    if (intro.properties) {\n        for (const [key, child] of Object.entries(intro.properties)) {\n            Object.defineProperty(base, key, {\n                value: createIndexedDescriptor(\n                    child as any,\n                    valueSelector,\n                    key,\n                    inner as any\n                ),\n                enumerable: true\n            });\n        }\n    } else if ((schema as any)[SYMBOL_HAS_PROPERTIES]) {\n        return createExternProxyDescriptor(base, valueSelector);\n    }\n    return base;\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","#propagateIndexedErrors","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","createPropertyDescriptorFor","obj","createMissingStructure","propSchema","childProperties","tree","selectorResult","SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR","createIndexedDescriptor","externBase","externValueSelector","createExternProxyDescriptor","#getSchemaForPropertyDescriptor","propertyNames","nestedPropertyName","nestedPropertyDescriptor","nestedValidationError","prefix","invalid","pointer","target","node","part","nestedSchema","children","child","index","indexed","relative","propertyName","parent","newValue","segments","ancestor","name","base","intro","valueSelector","root","create","container","inner","indices","receiver","array","baseDescriptor","childValueSelector","parentValue"]}

package/dist/chunk-JH7VLA6C.js

@@ -0,0 +1,2 @@
+import{f as u}from"./chunk-2BKBVVZ3.js";var l=class a extends u{#t;#T=function(){return`is expected to have a length of at least ${this.#t} characters`};#n=this.#T;#i;#g=function(){return`is expected to have a length of no more than ${this.#i} characters`};#l=this.#g;#s;#c=function(e){return`is expected to be equal to "${this.#s}" but saw "${e}"`};#u=this.#c;#e;#m=function(){return`is expected to start with "${this.#e}"`};#o=this.#m;#r;#f=function(){return`is expected to end with "${this.#r}"`};#d=this.#f;#a;#E=function(){return`is expected to match the pattern ${this.#a}`};#h=this.#E;static create(e){return new a({type:"string",...e})}constructor(e){super(e),typeof e.minLength=="number"&&(this.#t=e.minLength),this.#n=this.assureValidationErrorMessageProvider(e.minLengthValidationErrorMessageProvider,this.#T),typeof e.maxLength=="number"&&(this.#i=e.maxLength),this.#l=this.assureValidationErrorMessageProvider(e.maxLengthValidationErrorMessageProvider,this.#g),(typeof e.equalsTo=="string"||typeof e.equalsTo>"u")&&(this.#s=e.equalsTo),this.#u=this.assureValidationErrorMessageProvider(e.equalsToValidationErrorMessageProvider,this.#c),typeof e.startsWith=="string"&&e.startsWith.length>0&&(this.#e=e.startsWith),this.#o=this.assureValidationErrorMessageProvider(e.startsWithValidationErrorMessageProvider,this.#m),typeof e.endsWith=="string"&&e.endsWith.length>0&&(this.#r=e.endsWith),this.#d=this.assureValidationErrorMessageProvider(e.endsWithValidationErrorMessageProvider,this.#f),e.matches instanceof RegExp&&(this.#a=e.matches),this.#h=this.assureValidationErrorMessageProvider(e.matchesValidationErrorMessageProvider,this.#E)}introspect(){return{...super.introspect(),minLength:this.#t,minLengthValidationErrorMessageProvider:this.#n,maxLength:this.#i,maxLengthValidationErrorMessageProvider:this.#l,equalsTo:this.#s,equalsToValidationErrorMessageProvider:this.#u,startsWith:this.#e,startsWithValidationErrorMessageProvider:this.#o,endsWith:this.#r,endsWithValidationErrorMessageProvider:this.#d,matches:this.#a,matchesValidationErrorMessageProvider:this.#h,preprocessors:this.preprocessors,validators:this.validators}}hasType(e){return this.derive({...this.introspect()},!0)}clearHasType(){return this.derive({...this.introspect()},!0)}#R(e){return typeof e!="string"?{message:`expected type string, but saw ${typeof e}`}:typeof this.#s<"u"&&e!==this.#s?{provider:this.#u}:typeof this.#e=="string"&&this.#e.length>0&&!e.startsWith(this.#e)?{provider:this.#o}:typeof this.#r=="string"&&this.#r.length>0&&!e.endsWith(this.#r)?{provider:this.#d}:typeof this.#t<"u"&&e.length<this.#t?{provider:this.#n}:typeof this.#i<"u"&&e.length>this.#i?{provider:this.#l}:this.#a instanceof RegExp&&!this.#a.test(e)?{provider:this.#h}:null}#S(e){let{valid:r,transaction:t,errors:i}=e;if(!r)return{done:!0,result:{valid:r,errors:i}};let{object:{validatedObject:s}}=t;if(typeof s>"u"&&!this.isRequired||s===null&&(!this.isRequired||this.isNullable))return{done:!0,result:{valid:!0,object:s}};let n=this.#R(s);return n?"message"in n?{done:!0,result:{valid:!1,errors:[{message:n.message}]}}:{done:!1,provider:n.provider,objToValidate:s}:{done:!0,result:{valid:!0,object:s}}}validate(e,r){return super.validate(e,r)}async validateAsync(e,r){return super.validateAsync(e,r)}_validate(e,r){if(this.canSkipPreValidation){if(typeof e>"u"||e===null)if(typeof e>"u"&&this.hasDefault)e=this.resolveDefaultValue();else return!this.isRequired||e===null&&this.isNullable?{valid:!0,object:e}:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(this.requiredErrorMessage,e)}]};let i=this.#R(e);return i?"message"in i?{valid:!1,errors:[{message:i.message}]}:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(i.provider,e)}]}:{valid:!0,object:e}}let t=this.#S(this.preValidateSync(e,r));return t.done?t.result:{valid:!1,errors:[{message:this.getValidationErrorMessageSync(t.provider,t.objToValidate)}]}}async _validateAsync(e,r){let t=this.#S(await super.preValidateAsync(e,r));return t.done?t.result:{valid:!1,errors:[{message:await this.getValidationErrorMessage(t.provider,t.objToValidate)}]}}createFromProps(e){return a.create(e)}equals(e,r){if(typeof e!="string")throw new Error("string expected");return this.derive({...this.introspect(),equalsTo:e,equalsToValidationErrorMessageProvider:r})}clearEquals(){return this.derive({...this.introspect(),equalsTo:void 0})}nullable(){return super.nullable()}notNullable(){return super.notNullable()}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()}minLength(e,r){if(typeof e!="number")throw new Error("length must be a number");return this.derive({...this.introspect(),minLength:e,minLengthValidationErrorMessageProvider:r})}clearMinLength(){let e=this.introspect();return delete e.minLength,this.derive({...e})}maxLength(e,r){if(typeof e!="number")throw new Error("length must be a number");return this.derive({...this.introspect(),maxLength:e,maxLengthValidationErrorMessageProvider:r})}clearMaxLength(){let e=this.introspect();return delete e.maxLength,this.derive({...e})}startsWith(e,r){if(typeof e!="string"||!e)throw new Error("non empty string expected");return this.derive({...this.introspect(),startsWith:e,startsWithValidationErrorMessageProvider:r})}clearStartsWith(){let e=this.introspect();return delete e.startsWith,this.derive({...e})}endsWith(e,r){if(typeof e!="string"||!e)throw new Error("non empty string expected");return this.derive({...this.introspect(),endsWith:e,endsWithValidationErrorMessageProvider:r})}clearEndsWith(){let e=this.introspect();return delete e.endsWith,this.derive({...e})}matches(e,r){if(!(e instanceof RegExp))throw new Error("regexp expected");return this.derive({...this.introspect(),matches:e,matchesValidationErrorMessageProvider:r})}clearMatches(){let e=this.introspect();return delete e.matches,this.derive({...e})}};function d(a,e){return typeof a=="string"?l.create({isRequired:!0,equalsTo:a,equalsToValidationErrorMessageProvider:e}):l.create({isRequired:!0})}export{l as a,d as b};
+//# sourceMappingURL=chunk-JH7VLA6C.js.map

package/dist/chunk-JH7VLA6C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/StringSchemaBuilder.ts"],"sourcesContent":["import {\n    type BRAND,\n    type PreprocessorEntry,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult,\n    type ValidatorEntry\n} from './SchemaBuilder.js';\n\ntype StringSchemaBuilderCreateProps<\n    T = string,\n    R extends boolean = true\n> = Partial<ReturnType<StringSchemaBuilder<T, R>['introspect']>>;\n\n/**\n * Allows to define a schema for a string. It can be: required or optional,\n * restricted to be equal to a certain value, restricted to have a certain\n * length, restricted to start with a certain value, restricted to end with\n * a certain value, restricted to match a certain regular expression.\n *\n * **NOTE** this class is exported for type annotations and advanced use.\n * Customize via extensions rather than subclassing. Avoid instantiating it\n * directly. Use {@link string | string()} function instead.\n *\n * @example\n * ```ts\n * const schema = string().equals('hello');\n * const result = schema.validate('hello');\n * // result.valid === true\n * // result.object === 'hello'\n * ```\n *\n * @example\n * ```ts\n * const schema = string().equals('hello');\n * const result = schema.validate('world');\n * // result.valid === false\n * // result.errors[0].message === \"is expected to be equal to 'hello'\"\n * ```\n *\n * @example\n * ```ts\n * const schema = string().minLength(5);\n * const result = schema.validate('hello');\n * // result.valid === true\n * // result.object === 'hello'\n * ```\n *\n * @example\n * ```ts\n * const schema = string().minLength(5);\n * const result = schema.validate('hi');\n * // result.valid === false\n * // result.errors[0].message === 'is expected to have a length of at least 5'\n * ```\n *\n * @example\n * ```ts\n * const schema = string().minLength(2).maxLength(5);\n * const result = schema.validate('yes');\n * // result.valid === true\n * // result.object === 'yes'\n * ```\n *\n * @example\n * ```ts\n * const schema = string('no');\n * const result = schema.validate('yes');\n * // result.valid === false\n * // result.errors[0].message === \"is expected to be equal to 'no'\"\n * ```\n *\n * @see {@link string}\n */\nexport class StringSchemaBuilder<\n    TResult = string,\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    /** Native type parameters for extension rebinding; never emitted at runtime. @internal */\n    declare readonly __cleverbrush_builder_type__: readonly [\n        'string',\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault\n    ];\n\n    #minLength?: number;\n    #defaultMinLengthErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder) {\n        return `is expected to have a length of at least ${this.#minLength} characters`;\n    };\n    #minLengthErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultMinLengthErrorMessageProvider;\n\n    #maxLength?: number;\n    #defaultMaxLengthErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder) {\n        return `is expected to have a length of no more than ${this.#maxLength} characters`;\n    };\n    #maxLengthErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultMaxLengthErrorMessageProvider;\n\n    #equalsTo?: string;\n    #defaultEqualsToErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder, seenValue?: TResult) {\n        return `is expected to be equal to \"${this.#equalsTo}\" but saw \"${seenValue}\"`;\n    };\n    #equalsToErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEqualsToErrorMessageProvider;\n\n    #startsWith?: string;\n    #defaultStartsWithErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder) {\n        return `is expected to start with \"${this.#startsWith}\"`;\n    };\n    #startsWithErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultStartsWithErrorMessageProvider;\n\n    #endsWith?: string;\n    #defaultEndsWithErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder) {\n        return `is expected to end with \"${this.#endsWith}\"`;\n    };\n    #endsWithErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultEndsWithErrorMessageProvider;\n\n    #matches?: RegExp;\n    #defaultMatchesErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = function (this: StringSchemaBuilder) {\n        return `is expected to match the pattern ${this.#matches}`;\n    };\n    #matchesErrorMessageProvider: ValidationErrorMessageProvider<\n        StringSchemaBuilder<TResult, TRequired>\n    > = this.#defaultMatchesErrorMessageProvider;\n\n    /**\n     * @hidden\n     */\n    public static create(props: StringSchemaBuilderCreateProps) {\n        return new StringSchemaBuilder({\n            type: 'string',\n            ...props\n        });\n    }\n\n    protected constructor(props: StringSchemaBuilderCreateProps) {\n        super(props as any);\n\n        if (typeof props.minLength === 'number') {\n            this.#minLength = props.minLength;\n        }\n\n        this.#minLengthErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.minLengthValidationErrorMessageProvider,\n                this.#defaultMinLengthErrorMessageProvider\n            );\n\n        if (typeof props.maxLength === 'number') {\n            this.#maxLength = props.maxLength;\n        }\n\n        this.#maxLengthErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.maxLengthValidationErrorMessageProvider,\n                this.#defaultMaxLengthErrorMessageProvider\n            );\n\n        if (\n            typeof props.equalsTo === 'string' ||\n            typeof props.equalsTo === 'undefined'\n        ) {\n            this.#equalsTo = props.equalsTo;\n        }\n\n        this.#equalsToErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.equalsToValidationErrorMessageProvider,\n                this.#defaultEqualsToErrorMessageProvider\n            );\n\n        if (\n            typeof props.startsWith === 'string' &&\n            props.startsWith.length > 0\n        ) {\n            this.#startsWith = props.startsWith;\n        }\n\n        this.#startsWithErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.startsWithValidationErrorMessageProvider,\n                this.#defaultStartsWithErrorMessageProvider\n            );\n\n        if (typeof props.endsWith === 'string' && props.endsWith.length > 0) {\n            this.#endsWith = props.endsWith;\n        }\n\n        this.#endsWithErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.endsWithValidationErrorMessageProvider,\n                this.#defaultEndsWithErrorMessageProvider\n            );\n\n        if (props.matches instanceof RegExp) {\n            this.#matches = props.matches;\n        }\n\n        this.#matchesErrorMessageProvider =\n            this.assureValidationErrorMessageProvider(\n                props.matchesValidationErrorMessageProvider,\n                this.#defaultMatchesErrorMessageProvider\n            );\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * Min length of the string (if defined).\n             */\n            minLength: this.#minLength,\n\n            /**\n             * Min length validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            minLengthValidationErrorMessageProvider:\n                this.#minLengthErrorMessageProvider,\n\n            /**\n             * Max length of the string (if defined).\n             */\n            maxLength: this.#maxLength,\n\n            /**\n             * Max length validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            maxLengthValidationErrorMessageProvider:\n                this.#maxLengthErrorMessageProvider,\n\n            /**\n             * If set, restrict object to be equal to a certain value.\n             */\n            equalsTo: this.#equalsTo,\n\n            /**\n             * Equals validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            equalsToValidationErrorMessageProvider:\n                this.#equalsToErrorMessageProvider,\n\n            /**\n             * If set, restrict string to start with a certain value.\n             */\n            startsWith: this.#startsWith,\n\n            /**\n             * Starts with validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            startsWithValidationErrorMessageProvider:\n                this.#startsWithErrorMessageProvider,\n\n            /**\n             * If set, restrict string to end with a certain value.\n             */\n            endsWith: this.#endsWith,\n\n            /**\n             * Ends with validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            endsWithValidationErrorMessageProvider:\n                this.#endsWithErrorMessageProvider,\n\n            /**\n             * If set, restrict string to match a certain regular expression.\n             */\n            matches: this.#matches,\n\n            /**\n             * Matches validation error message provider.\n             * If not provided, default error message will be used.\n             */\n            matchesValidationErrorMessageProvider:\n                this.#matchesErrorMessageProvider,\n\n            /**\n             * Array of preprocessor functions\n             */\n            preprocessors: this.preprocessors as PreprocessorEntry<TResult>[],\n\n            /**\n             * Array of validator functions\n             */\n            validators: this.validators as ValidatorEntry<TResult>[]\n        };\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): StringSchemaBuilder<T, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public clearHasType(): StringSchemaBuilder<\n        string,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    #getConstraintViolation(\n        objToValidate: any\n    ): { message: string } | { provider: any } | null {\n        if (typeof objToValidate !== 'string') {\n            return {\n                message: `expected type string, but saw ${typeof objToValidate}`\n            };\n        }\n\n        if (\n            typeof this.#equalsTo !== 'undefined' &&\n            objToValidate !== this.#equalsTo\n        ) {\n            return { provider: this.#equalsToErrorMessageProvider };\n        }\n\n        if (\n            typeof this.#startsWith === 'string' &&\n            this.#startsWith.length > 0 &&\n            !objToValidate.startsWith(this.#startsWith)\n        ) {\n            return { provider: this.#startsWithErrorMessageProvider };\n        }\n\n        if (\n            typeof this.#endsWith === 'string' &&\n            this.#endsWith.length > 0 &&\n            !objToValidate.endsWith(this.#endsWith)\n        ) {\n            return { provider: this.#endsWithErrorMessageProvider };\n        }\n\n        if (typeof this.#minLength !== 'undefined') {\n            if (objToValidate.length < this.#minLength)\n                return { provider: this.#minLengthErrorMessageProvider };\n        }\n\n        if (typeof this.#maxLength !== 'undefined') {\n            if (objToValidate.length > this.#maxLength)\n                return { provider: this.#maxLengthErrorMessageProvider };\n        }\n\n        if (this.#matches instanceof RegExp) {\n            if (!this.#matches.test(objToValidate)) {\n                return { provider: this.#matchesErrorMessageProvider };\n            }\n        }\n\n        return null;\n    }\n\n    #buildResult(\n        superResult: ReturnType<StringSchemaBuilder['preValidateSync']>\n    ):\n        | { done: true; result: ValidationResult<TResult> }\n        | {\n              done: false;\n              provider: any;\n              objToValidate: any;\n          } {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { done: true, result: { valid, errors } };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        if (\n            (typeof objToValidate === 'undefined' && !this.isRequired) ||\n            (objToValidate === null && (!this.isRequired || this.isNullable))\n        ) {\n            return {\n                done: true,\n                result: { valid: true, object: objToValidate }\n            };\n        }\n\n        const violation = this.#getConstraintViolation(objToValidate);\n\n        if (!violation) {\n            return {\n                done: true,\n                result: { valid: true, object: objToValidate as TResult }\n            };\n        }\n\n        if ('message' in violation) {\n            return {\n                done: true,\n                result: {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                }\n            };\n        }\n\n        return {\n            done: false,\n            provider: violation.provider,\n            objToValidate\n        };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return super.validate(object, context) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of string schema over `object`.\n     * Throws if any preprocessor, validator, or error message provider returns a Promise.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected _validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        // Fast path: no preprocessors or custom validators — skip preValidateSync entirely\n        if (this.canSkipPreValidation) {\n            // Required / optional check\n            if (typeof object === 'undefined' || object === null) {\n                if (typeof object === 'undefined' && this.hasDefault) {\n                    object = this.resolveDefaultValue();\n                } else if (\n                    !this.isRequired ||\n                    (object === null && this.isNullable)\n                ) {\n                    return { valid: true, object: object };\n                } else {\n                    return {\n                        valid: false,\n                        errors: [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object\n                                )\n                            }\n                        ]\n                    };\n                }\n            }\n\n            const violation = this.#getConstraintViolation(object);\n\n            if (!violation) {\n                return { valid: true, object: object as TResult };\n            }\n\n            if ('message' in violation) {\n                return {\n                    valid: false,\n                    errors: [{ message: violation.message }]\n                };\n            }\n\n            return {\n                valid: false,\n                errors: [\n                    {\n                        message: this.getValidationErrorMessageSync(\n                            violation.provider,\n                            object as TResult\n                        )\n                    }\n                ]\n            };\n        }\n\n        const r = this.#buildResult(this.preValidateSync(object, context));\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: this.getValidationErrorMessageSync(\n                        r.provider,\n                        r.objToValidate as TResult\n                    )\n                }\n            ]\n        };\n    }\n\n    /**\n     * Performs async validation of string schema over `object`.\n     * Supports async preprocessors, validators, and error message providers.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected async _validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const r = this.#buildResult(\n            await super.preValidateAsync(object, context)\n        );\n        if (r.done) return r.result;\n        return {\n            valid: false,\n            errors: [\n                {\n                    message: await this.getValidationErrorMessage(\n                        r.provider,\n                        r.objToValidate as TResult\n                    )\n                }\n            ]\n        };\n    }\n\n    protected createFromProps<T, TReq extends boolean>(\n        props: StringSchemaBuilderCreateProps<T, TReq>\n    ): this {\n        return StringSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * Restricts string to be equal to `value`.\n     */\n    public equals<T extends string>(\n        value: T,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ) {\n        if (typeof value !== 'string') throw new Error('string expected');\n        return this.derive({\n            ...this.introspect(),\n            equalsTo: value,\n            equalsToValidationErrorMessageProvider: errorMessage\n        }) as any as StringSchemaBuilder<\n            T,\n            TRequired,\n            TNullable,\n            THasDefault,\n            TExtensions\n        > &\n            TExtensions;\n    }\n\n    /**\n     * Cancels `equals()` call.\n     */\n    public clearEquals(): StringSchemaBuilder<\n        string,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.derive({\n            ...this.introspect(),\n            equalsTo: undefined\n        }) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): StringSchemaBuilder<\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(): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        false,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): StringSchemaBuilder<TResult, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): StringSchemaBuilder<\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    ): StringSchemaBuilder<TResult, true, TNullable, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): StringSchemaBuilder<\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    ): StringSchemaBuilder<\n        TResult & { readonly [K in BRAND]: TBrand },\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<string>`. Since strings are\n     * already immutable this is an identity operation, but it sets the\n     * `isReadonly` introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): StringSchemaBuilder<\n        Readonly<TResult>,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * Set minimal length of the valid value for schema.\n     * @param length minimum string length\n     */\n    public minLength(\n        length: number,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof length !== 'number')\n            throw new Error('length must be a number');\n        return this.derive({\n            ...this.introspect(),\n            minLength: length,\n            minLengthValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Cancel `minLength()` call.\n     */\n    public clearMinLength(): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.minLength;\n        return this.derive({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * Set maximal length of the valid value for schema.\n     * @param length maximum string length\n     */\n    public maxLength(\n        length: number,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof length !== 'number')\n            throw new Error('length must be a number');\n        return this.derive({\n            ...this.introspect(),\n            maxLength: length,\n            maxLengthValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Cancel `maxLength()` call.\n     */\n    public clearMaxLength(): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.maxLength;\n        return this.derive({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * Restricts string to start with `val`.\n     */\n    public startsWith<T extends string>(\n        val: T,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ): StringSchemaBuilder<\n        TResult extends string ? `${T}${TResult}` : TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof val !== 'string' || !val)\n            throw new Error('non empty string expected');\n        return this.derive({\n            ...this.introspect(),\n            startsWith: val,\n            startsWithValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Cancels `startsWith()` call.\n     */\n    public clearStartsWith(): StringSchemaBuilder<\n        string,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.startsWith;\n        return this.derive({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * Restricts string to end with `val`.\n     */\n    public endsWith<T extends string>(\n        val: T,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ): StringSchemaBuilder<\n        TResult extends string ? `${TResult}${T}` : TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (typeof val !== 'string' || !val)\n            throw new Error('non empty string expected');\n        return this.derive({\n            ...this.introspect(),\n            endsWith: val,\n            endsWithValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Cancels `endsWith()` call.\n     */\n    public clearEndsWith(): StringSchemaBuilder<\n        string,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.endsWith;\n        return this.derive({\n            ...schema\n        }) as any;\n    }\n\n    /**\n     * Restricts string to match `regexp`.\n     * @param regexp regular expression pattern to match against\n     */\n    public matches(\n        regexp: RegExp,\n        /**\n         * Custom error message provider.\n         */\n        errorMessage?: ValidationErrorMessageProvider<\n            StringSchemaBuilder<TResult, TRequired>\n        >\n    ): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        if (!(regexp instanceof RegExp)) throw new Error('regexp expected');\n        return this.derive({\n            ...this.introspect(),\n            matches: regexp,\n            matchesValidationErrorMessageProvider: errorMessage\n        }) as any;\n    }\n\n    /**\n     * Cancels `matches()` call.\n     */\n    public clearMatches(): StringSchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        const schema = this.introspect();\n        delete schema.matches;\n        return this.derive({\n            ...schema\n        }) as any;\n    }\n}\n\n/**\n * Creates a string schema restricted to be equal to `equals`.\n * @param equals string value the schema is restricted to\n */\nexport function string<T extends string>(\n    equals: T\n): StringSchemaBuilder<T, true>;\n\n/**\n * Creates a string schema restricted to be equal to `equals` with a custom error message.\n * @param equals string value the schema is restricted to\n */\nexport function string<T extends string>(\n    equals: T,\n    errorMessage: ValidationErrorMessageProvider<StringSchemaBuilder<T, true>>\n): StringSchemaBuilder<T, true>;\n\nexport function string(): StringSchemaBuilder<string, true>;\n\n/**\n * Creates a string schema.\n */\nexport function string(\n    equals?: string,\n    errorMessage?: ValidationErrorMessageProvider<\n        StringSchemaBuilder<string, true>\n    >\n) {\n    if (typeof equals === 'string') {\n        return StringSchemaBuilder.create({\n            isRequired: true,\n            equalsTo: equals,\n            equalsToValidationErrorMessageProvider: errorMessage\n        });\n    }\n    return StringSchemaBuilder.create({\n        isRequired: true\n    });\n}\n"],"mappings":"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","names":["StringSchemaBuilder","_StringSchemaBuilder","SchemaBuilder","#minLength","#defaultMinLengthErrorMessageProvider","#minLengthErrorMessageProvider","#maxLength","#defaultMaxLengthErrorMessageProvider","#maxLengthErrorMessageProvider","#equalsTo","#defaultEqualsToErrorMessageProvider","seenValue","#equalsToErrorMessageProvider","#startsWith","#defaultStartsWithErrorMessageProvider","#startsWithErrorMessageProvider","#endsWith","#defaultEndsWithErrorMessageProvider","#endsWithErrorMessageProvider","#matches","#defaultMatchesErrorMessageProvider","#matchesErrorMessageProvider","props","_notUsed","#getConstraintViolation","objToValidate","#buildResult","superResult","valid","preValidationTransaction","errors","violation","object","context","r","value","errorMessage","_name","length","schema","val","regexp","string","equals"]}

package/dist/chunk-K7TDPKGQ.js

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

package/dist/chunk-K7TDPKGQ.js.map

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

package/dist/chunk-NDESVCWI.js

@@ -0,0 +1,2 @@
+import{f as n}from"./chunk-2BKBVVZ3.js";var a=class l extends n{static create(e){return new l({type:"any",...e})}constructor(e){super(e)}hasType(e){return this.derive({...this.introspect()},!0)}clearHasType(){return this.derive({...this.introspect()},!0)}#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()}},T=()=>a.create({isRequired:!0});export{a,T as b};
+//# sourceMappingURL=chunk-NDESVCWI.js.map

package/dist/chunk-NDESVCWI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/AnySchemaBuilder.ts"],"sourcesContent":["import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype AnySchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<AnySchemaBuilder<R>['introspect']>\n>;\n\n/**\n * Any schema builder class. Similar to the `any` type\n * in TypeScript. Allows to define a schema for `any` value.\n * Use it when you don't know the type of the value.\n *\n * **NOTE** this class is exported for type annotations and advanced use.\n * Customize via extensions rather than subclassing. Avoid instantiating it\n * directly. Use `any()` function instead.\n *\n * @example\n * ```ts\n * const schema = any();\n * const result = schema.validate(123);\n * // result.valid === true\n * // result.object === 123\n * ```\n */\nexport class AnySchemaBuilder<\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 ? any : TExplicitType\n> extends SchemaBuilder<\n    TResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    /** Native type parameters for extension rebinding; never emitted at runtime. @internal */\n    declare readonly __cleverbrush_builder_type__: readonly [\n        'any',\n        TRequired,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TResult\n    ];\n\n    /**\n     * @hidden\n     */\n    public static create(props: AnySchemaBuilderCreateProps<any>) {\n        return new AnySchemaBuilder({\n            type: 'any',\n            ...props\n        });\n    }\n\n    protected constructor(props: AnySchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): AnySchemaBuilder<true, TNullable, T, THasDefault, TExtensions> &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public clearHasType(): AnySchemaBuilder<\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    #buildResult(\n        superResult: ReturnType<AnySchemaBuilder['preValidateSync']>\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        return { valid: true, object: objToValidate };\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(this.preValidateSync(object, context));\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.#buildResult(await super.preValidateAsync(object, context));\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: AnySchemaBuilderCreateProps<TReq>\n    ): this {\n        return AnySchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): AnySchemaBuilder<\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(): AnySchemaBuilder<\n        false,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value: TResult | (() => TResult)\n    ): AnySchemaBuilder<true, TNullable, TExplicitType, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): AnySchemaBuilder<\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    ): AnySchemaBuilder<\n        TRequired,\n        TNullable,\n        TResult & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<T>`. Sets the `isReadonly`\n     * introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): AnySchemaBuilder<\n        TRequired,\n        TNullable,\n        Readonly<TResult>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): AnySchemaBuilder<\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(): AnySchemaBuilder<\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 `any` schema.\n * @example\n * ```\n *  const anyObject = any();\n *\n * // null - invalid\n * // undefined - invalid\n * // string - valid\n * // {} - valid\n * // Date -valid\n * // { someProp: 123 } - valid\n * // etc\n * ```\n * @example\n * ```\n *  const anyObject = any().optional();\n *  // null - valid\n *  // undefined - valid\n *  // string - valid\n *  // {} - valid\n *  // Date -valid\n *  // { someProp: 123 } - valid\n * ```\n */\nexport const any = () =>\n    AnySchemaBuilder.create({\n        isRequired: true\n    }) as AnySchemaBuilder<true>;\n"],"mappings":"wCA6BO,IAAMA,EAAN,MAAMC,UAOHC,CAMR,CAcE,OAAc,OAAOC,EAAyC,CAC1D,OAAO,IAAIF,EAAiB,CACxB,KAAM,MACN,GAAGE,CACP,CAAC,CACL,CAEU,YAAYA,EAA+C,CACjE,MAAMA,CAAY,CACtB,CAKO,QACHC,EAEY,CACZ,OAAO,KAAK,OACR,CACI,GAAG,KAAK,WAAW,CACvB,EACA,EACJ,CACJ,CAKO,cAOS,CACZ,OAAO,KAAK,OACR,CACI,GAAG,KAAK,WAAW,CACvB,EACA,EACJ,CACJ,CAEAC,GACIC,EACyB,CACzB,GAAM,CACF,MAAAC,EACA,YAAaC,EACb,OAAAC,CACJ,EAAIH,EAEJ,GAAI,CAACC,EACD,MAAO,CAAE,MAAAA,EAAO,OAAAE,CAAO,EAG3B,GAAM,CACF,OAAQ,CAAE,gBAAiBC,CAAc,CAC7C,EAAIF,EAEJ,MAAO,CAAE,MAAO,GAAM,OAAQE,CAAc,CAChD,CAGO,SACHC,EACAC,EACyB,CACzB,OAAO,MAAM,SAASD,EAAQC,CAAO,CACzC,CAGA,MAAa,cACTD,EACAC,EACkC,CAClC,OAAO,MAAM,cAAcD,EAAQC,CAAO,CAG9C,CAOU,UACND,EACAC,EACyB,CACzB,OAAO,KAAKP,GAAa,KAAK,gBAAgBM,EAAQC,CAAO,CAAC,CAClE,CAOA,MAAgB,eACZD,EACAC,EACkC,CAClC,OAAO,KAAKP,GAAa,MAAM,MAAM,iBAAiBM,EAAQC,CAAO,CAAC,CAC1E,CAEU,gBACNT,EACI,CACJ,OAAOF,EAAiB,OAAOE,CAAY,CAC/C,CAKO,SACHU,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,CAQO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,UAOS,CACZ,OAAO,MAAM,SAAS,CAC1B,CAKO,aAOS,CACZ,OAAO,MAAM,YAAY,CAC7B,CACJ,EA2BaC,EAAM,IACfhB,EAAiB,OAAO,CACpB,WAAY,EAChB,CAAC","names":["AnySchemaBuilder","_AnySchemaBuilder","SchemaBuilder","props","_notUsed","#buildResult","superResult","valid","preValidationTransaction","errors","objToValidate","object","context","errorMessage","value","_name","any"]}

package/dist/chunk-VBPZRO7L.js

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