@cleverbrush/schema 4.5.0 → 5.1.0

package/dist/chunk-Z4SFUZSP.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 (\n            typeof objToValidate !== 'object' ||\n            objToValidate === null ||\n            Array.isArray(objToValidate)\n        ) {\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' && !Array.isArray(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 (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-ZYWDTLNL.js

@@ -0,0 +1,2 @@
+import{f as u}from"./chunk-2BKBVVZ3.js";var o=class i extends u{#e;#t;static create(e){return new i({type:"intersection",...e})}constructor(e){super(e),e.left instanceof u&&(this.#e=e.left),e.right instanceof u&&(this.#t=e.right)}introspect(){return{...super.introspect(),left:this.#e,right:this.#t}}get isNullRequiredViolation(){return!1}hasType(e){return this.derive({...this.introspect()},!0)}clearHasType(){return this.derive({...this.introspect()},!0)}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}#a(e,t){return typeof e=="object"&&e!==null&&typeof t=="object"&&t!==null&&!Array.isArray(e)&&!Array.isArray(t)?{...e,...t}:t}#r(e){let{valid:t,transaction:a,context:n,errors:l}=e;if(!t)return{needsValidation:!1,result:{valid:t,errors:l}};let{object:{validatedObject:r}}=a;return typeof r>"u"&&!this.isRequired||r===null&&(!this.isRequired||this.isNullable)?{needsValidation:!1,result:{valid:!0,object:r}}:{needsValidation:!0,objToValidate:r,prevalidationContext:n}}_validate(e,t){if(this.canSkipPreValidation&&!t?.doNotStopOnFirstError&&!t?.rootPropertyDescriptor){if(typeof e>"u")if(this.hasDefault)e=this.resolveDefaultValue();else return this.isRequired?{valid:!1,errors:[{message:this.getValidationErrorMessageSync(this.requiredErrorMessage,e)}]}:{valid:!0,object:e};else if(e===null&&(!this.isRequired||this.isNullable))return{valid:!0,object:e};let a=this.#e.validate(e);if(!a.valid)return{valid:!1,errors:a.errors};let n=this.#t.validate(e);return n.valid?{valid:!0,object:this.#a(a.object,n.object)}:{valid:!1,errors:n.errors}}return this.#n(e,t)}#n(e,t){let a=this.#r(this.preValidateSync(e,t));if(!a.needsValidation)return a.result;let{objToValidate:n,prevalidationContext:l}=a,r=this.#e.validate(n,{...l,currentPropertyDescriptor:void 0,rootPropertyDescriptor:void 0});if(!r.valid)return{valid:!1,errors:r.errors};let s=this.#t.validate(n,{...l,currentPropertyDescriptor:void 0,rootPropertyDescriptor:void 0});return s.valid?{valid:!0,object:this.#a(r.object,s.object)}:{valid:!1,errors:s.errors}}async _validateAsync(e,t){let a=this.#r(await super.preValidateAsync(e,t));if(!a.needsValidation)return a.result;let{objToValidate:n,prevalidationContext:l}=a,r=await this.#e.validateAsync(n,{...l,currentPropertyDescriptor:void 0,rootPropertyDescriptor:void 0});if(!r.valid)return{valid:!1,errors:r.errors};let s=await this.#t.validateAsync(n,{...l,currentPropertyDescriptor:void 0,rootPropertyDescriptor:void 0});return s.valid?{valid:!0,object:this.#a(r.object,s.object)}:{valid:!1,errors:s.errors}}createFromProps(e){return i.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()}get leftSchema(){return this.#e}get rightSchema(){return this.#t}},p=(i,e)=>o.create({isRequired:!0,left:i,right:e});var d=class i extends u{#e;#t=null;static create(e){return new i({type:"lazy",...e})}constructor(e){if(super(e),typeof e.getter!="function")throw new Error("LazySchemaBuilder: getter must be a function");this.#e=e.getter}resolve(){return this.#t===null&&(this.#t=this.#e()),this.#t}introspect(){return{...super.introspect(),getter:this.#e}}#a(e,t){let{valid:a,transaction:n,errors:l}=e;if(!a)return{valid:a,errors:l};let{object:{validatedObject:r}}=n;return r==null?{valid:!0,object:r}:this.resolve().validate(r,t)}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){return this.#a(this.preValidateSync(e,t),t)}async _validateAsync(e,t){let a=await super.preValidateAsync(e,t),{valid:n,transaction:l,errors:r}=a;if(!n)return{valid:n,errors:r};let{object:{validatedObject:s}}=l;return s==null?{valid:!0,object:s}:this.resolve().validateAsync(s,t)}createFromProps(e){return i.create(e)}hasType(e){return this.derive({...this.introspect()},!0)}clearHasType(){return this.derive({...this.introspect()},!0)}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()}};function y(i){return d.create({type:"lazy",isRequired:!0,preprocessors:[],validators:[],getter:i})}var c=class i extends u{static create(e){return new i({type:"null",...e})}constructor(e){super(e)}hasType(e){return this.derive({...this.introspect()},!0)}clearHasType(){return this.derive({...this.introspect()},!0)}#e(e){return e===null?{valid:!0,object:null}:e===void 0&&this.hasDefault?this.resolveDefaultValue()===null?{valid:!0,object:null}:{valid:!1,errors:[{message:"must be null"}]}:e===void 0&&!this.isRequired?{valid:!0,object:void 0}:{valid:!1,errors:[{message:"must be null"}]}}validate(e,t){return super.validate(e,t)}async validateAsync(e,t){return super.validateAsync(e,t)}_validate(e,t){return this.#e(e)}async _validateAsync(e,t){return this.#e(e)}createFromProps(e){return i.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()}},h=()=>c.create({isRequired:!0});export{o as a,p as b,d as c,y as d,c as e,h as f};
+//# sourceMappingURL=chunk-ZYWDTLNL.js.map

package/dist/chunk-ZYWDTLNL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builders/IntersectionSchemaBuilder.ts","../src/builders/LazySchemaBuilder.ts","../src/builders/NullSchemaBuilder.ts"],"sourcesContent":["import {\n    type BRAND,\n    type InferType,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype IntersectionSchemaBuilderCreateProps<\n    TLeft extends SchemaBuilder<any, any, any, any, any>,\n    TRight extends SchemaBuilder<any, any, any, any, any>,\n    R extends boolean = true\n> = Partial<\n    ReturnType<IntersectionSchemaBuilder<TLeft, TRight, R>['introspect']>\n>;\n\ntype SchemaIntersection<\n    TLeft extends SchemaBuilder<any, any, any, any, any>,\n    TRight extends SchemaBuilder<any, any, any, any, any>\n> = InferType<TLeft> & InferType<TRight>;\n\nexport type IntersectionSchemaValidationResult<T> = ValidationResult<T>;\n\nexport class IntersectionSchemaBuilder<\n    TLeft extends SchemaBuilder<any, any, any, any, any>,\n    TRight extends SchemaBuilder<any, any, any, any, any>,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<\n    TExplicitType extends undefined\n        ? SchemaIntersection<TLeft, TRight>\n        : TExplicitType,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #left!: TLeft;\n    #right!: TRight;\n\n    /**\n     * @hidden\n     */\n    public static create(\n        props: IntersectionSchemaBuilderCreateProps<any, any>\n    ) {\n        return new IntersectionSchemaBuilder({\n            type: 'intersection',\n            ...props\n        });\n    }\n\n    protected constructor(\n        props: IntersectionSchemaBuilderCreateProps<TLeft, TRight, TRequired>\n    ) {\n        super(props as any);\n\n        if (props.left instanceof SchemaBuilder) {\n            this.#left = props.left;\n        }\n        if (props.right instanceof SchemaBuilder) {\n            this.#right = props.right;\n        }\n    }\n\n    public introspect() {\n        return {\n            ...super.introspect(),\n            left: this.#left,\n            right: this.#right\n        };\n    }\n\n    /**\n     * @override\n     */\n    protected override get isNullRequiredViolation(): boolean {\n        return false;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\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(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\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     * @inheritdoc\n     */\n    public validate(\n        object: TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType,\n        context?: ValidationContext\n    ): IntersectionSchemaValidationResult<\n        TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType\n    > {\n        return super.validate(object, context) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public async validateAsync(\n        object: TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType,\n        context?: ValidationContext\n    ): Promise<\n        IntersectionSchemaValidationResult<\n            TExplicitType extends undefined\n                ? SchemaIntersection<TLeft, TRight>\n                : TExplicitType\n        >\n    > {\n        return super.validateAsync(object, context) as any;\n    }\n\n    #mergeObjects(leftObj: any, rightObj: any): any {\n        if (\n            typeof leftObj === 'object' &&\n            leftObj !== null &&\n            typeof rightObj === 'object' &&\n            rightObj !== null &&\n            !Array.isArray(leftObj) &&\n            !Array.isArray(rightObj)\n        ) {\n            return { ...leftObj, ...rightObj };\n        }\n        return rightObj;\n    }\n\n    #createValidationSetup(\n        superResult: ReturnType<\n            IntersectionSchemaBuilder<any, any>['preValidateSync']\n        >\n    ) {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            context: prevalidationContext,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return {\n                needsValidation: false as const,\n                result: { valid, errors } as any\n            };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        if (\n            (typeof objToValidate === 'undefined' && !this.isRequired) ||\n            (objToValidate === null && (!this.isRequired || this.isNullable))\n        ) {\n            return {\n                needsValidation: false as const,\n                result: {\n                    valid: true,\n                    object: objToValidate\n                } as any\n            };\n        }\n\n        return {\n            needsValidation: true as const,\n            objToValidate,\n            prevalidationContext\n        };\n    }\n\n    /**\n     * Performs synchronous validation.\n     * Validates left schema first, then right schema.\n     * Both must pass for the intersection to be valid.\n     */\n    protected _validate(\n        object: TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType,\n        context?: ValidationContext\n    ): IntersectionSchemaValidationResult<\n        TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType\n    > {\n        if (\n            this.canSkipPreValidation &&\n            !context?.doNotStopOnFirstError &&\n            !context?.rootPropertyDescriptor\n        ) {\n            if (typeof object === 'undefined') {\n                if (this.hasDefault) {\n                    object = this.resolveDefaultValue();\n                } else if (!this.isRequired) {\n                    return { valid: true, object } as any;\n                } else {\n                    return {\n                        valid: false,\n                        errors: [\n                            {\n                                message: this.getValidationErrorMessageSync(\n                                    this.requiredErrorMessage,\n                                    object as any\n                                )\n                            }\n                        ]\n                    } as any;\n                }\n            } else if (\n                object === null &&\n                (!this.isRequired || this.isNullable)\n            ) {\n                return { valid: true, object } as any;\n            }\n\n            const leftResult = this.#left.validate(object as any);\n            if (!leftResult.valid) {\n                return {\n                    valid: false,\n                    errors: leftResult.errors\n                } as any;\n            }\n\n            const rightResult = this.#right.validate(object as any);\n            if (!rightResult.valid) {\n                return {\n                    valid: false,\n                    errors: rightResult.errors\n                } as any;\n            }\n\n            const mergedObject = this.#mergeObjects(\n                leftResult.object,\n                rightResult.object\n            );\n            return { valid: true, object: mergedObject } as any;\n        }\n\n        return this.#validateFull(object, context);\n    }\n\n    #validateFull(\n        object: any,\n        context?: ValidationContext\n    ): IntersectionSchemaValidationResult<any> {\n        const setup = this.#createValidationSetup(\n            this.preValidateSync(object, context)\n        );\n\n        if (!setup.needsValidation) return setup.result;\n\n        const { objToValidate, prevalidationContext } = setup;\n\n        const leftResult = this.#left.validate(objToValidate, {\n            ...prevalidationContext,\n            currentPropertyDescriptor: undefined,\n            rootPropertyDescriptor: undefined\n        } as any);\n\n        if (!leftResult.valid) {\n            return {\n                valid: false,\n                errors: leftResult.errors\n            };\n        }\n\n        const rightResult = this.#right.validate(objToValidate, {\n            ...prevalidationContext,\n            currentPropertyDescriptor: undefined,\n            rootPropertyDescriptor: undefined\n        } as any);\n\n        if (!rightResult.valid) {\n            return {\n                valid: false,\n                errors: rightResult.errors\n            };\n        }\n\n        const mergedObject = this.#mergeObjects(\n            leftResult.object,\n            rightResult.object\n        );\n\n        return {\n            valid: true,\n            object: mergedObject\n        };\n    }\n\n    /**\n     * Performs async validation.\n     */\n    protected async _validateAsync(\n        object: TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType,\n        context?: ValidationContext\n    ): Promise<\n        IntersectionSchemaValidationResult<\n            TExplicitType extends undefined\n                ? SchemaIntersection<TLeft, TRight>\n                : TExplicitType\n        >\n    > {\n        const setup = this.#createValidationSetup(\n            await super.preValidateAsync(object, context)\n        );\n\n        if (!setup.needsValidation) return setup.result;\n\n        const { objToValidate, prevalidationContext } = setup;\n\n        const leftResult = await this.#left.validateAsync(objToValidate, {\n            ...prevalidationContext,\n            currentPropertyDescriptor: undefined,\n            rootPropertyDescriptor: undefined\n        } as any);\n\n        if (!leftResult.valid) {\n            return {\n                valid: false,\n                errors: leftResult.errors\n            };\n        }\n\n        const rightResult = await this.#right.validateAsync(objToValidate, {\n            ...prevalidationContext,\n            currentPropertyDescriptor: undefined,\n            rootPropertyDescriptor: undefined\n        } as any);\n\n        if (!rightResult.valid) {\n            return {\n                valid: false,\n                errors: rightResult.errors\n            };\n        }\n\n        const mergedObject = this.#mergeObjects(\n            leftResult.object,\n            rightResult.object\n        );\n\n        return {\n            valid: true,\n            object: mergedObject\n        };\n    }\n\n    protected createFromProps<\n        TL extends SchemaBuilder<any, any, any, any, any>,\n        TR extends SchemaBuilder<any, any, any, any, any>,\n        TReq extends boolean\n    >(props: IntersectionSchemaBuilderCreateProps<TL, TR, TReq>): this {\n        return IntersectionSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: any\n    ): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\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(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\n        false,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value:\n            | (TExplicitType extends undefined\n                  ? SchemaIntersection<TLeft, TRight>\n                  : TExplicitType)\n            | (() => TExplicitType extends undefined\n                  ? SchemaIntersection<TLeft, TRight>\n                  : TExplicitType)\n    ): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\n        true,\n        TNullable,\n        TExplicitType,\n        true,\n        TExtensions\n    > &\n        TExtensions {\n        return super.default(value as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\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    ): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\n        TRequired,\n        TNullable,\n        (TExplicitType extends undefined\n            ? SchemaIntersection<TLeft, TRight>\n            : TExplicitType) & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * @hidden\n     */\n    public readonly(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\n        TRequired,\n        TNullable,\n        Readonly<\n            TExplicitType extends undefined\n                ? SchemaIntersection<TLeft, TRight>\n                : TExplicitType\n        >,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\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(): IntersectionSchemaBuilder<\n        TLeft,\n        TRight,\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n\n    /**\n     * Gets the left side of this intersection.\n     */\n    public get leftSchema(): TLeft {\n        return this.#left;\n    }\n\n    /**\n     * Gets the right side of this intersection.\n     */\n    public get rightSchema(): TRight {\n        return this.#right;\n    }\n}\n\n/**\n * Creates an intersection schema.\n * The resulting schema validates that the input satisfies both `left` and `right` schemas.\n *\n * @example\n * ```ts\n * const schema = intersection(\n *     object({ name: string() }),\n *     object({ age: number() })\n * );\n * // InferType<typeof schema> === { name: string } & { age: number }\n * ```\n *\n * @param left - first schema\n * @param right - second schema\n */\nexport const intersection = <\n    TLeft extends SchemaBuilder<any, any, any, any, any>,\n    TRight extends SchemaBuilder<any, any, any, any, any>\n>(\n    left: TLeft,\n    right: TRight\n) =>\n    IntersectionSchemaBuilder.create({\n        isRequired: true,\n        left,\n        right\n    }) as IntersectionSchemaBuilder<TLeft, TRight>;\n","import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype LazySchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<LazySchemaBuilder<any, R>['introspect']>\n>;\n\n/**\n * Lazy schema builder class. Allows defining recursive/self-referential schemas\n * by wrapping a getter function that returns the target schema. The getter is\n * called once on first validation and the result is cached.\n *\n * This is the primary mechanism for building recursive data structures such as\n * tree nodes, nested menus, and threaded comments.\n *\n * **NOTE** TypeScript cannot infer recursive types automatically, so you must\n * provide an explicit type annotation on the variable holding the schema:\n *\n * @example\n * ```ts\n * type TreeNode = { value: number; children: TreeNode[] };\n *\n * const treeNode: SchemaBuilder<TreeNode, true> = object({\n *     value: number(),\n *     children: array(lazy(() => treeNode))\n * });\n *\n * treeNode.validate({ value: 1, children: [{ value: 2, children: [] }] });\n * // { valid: true, object: { value: 1, children: [{ value: 2, children: [] }] } }\n * ```\n *\n * @example\n * ```ts\n * type Comment = { text: string; replies: Comment[] };\n *\n * const commentSchema: SchemaBuilder<Comment, true> = object({\n *     text: string(),\n *     replies: array(lazy(() => commentSchema))\n * });\n * ```\n */\nexport class LazySchemaBuilder<\n    TResult = any,\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<\n    TResult,\n    TRequired,\n    TNullable,\n    THasDefault,\n    TExtensions\n> {\n    #getter: () => SchemaBuilder<TResult, any, any>;\n    #resolvedSchema: SchemaBuilder<TResult, any, any> | null = null;\n\n    /**\n     * @hidden\n     */\n    public static create(props: LazySchemaBuilderCreateProps<any>) {\n        return new LazySchemaBuilder({\n            type: 'lazy',\n            ...props\n        });\n    }\n\n    protected constructor(props: LazySchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n        if (typeof (props as any).getter !== 'function') {\n            throw new Error('LazySchemaBuilder: getter must be a function');\n        }\n        this.#getter = (props as any).getter;\n    }\n\n    /**\n     * Resolves the lazy schema by calling the getter (once; result is cached).\n     * After the first call subsequent calls return the cached schema instance.\n     */\n    public resolve(): SchemaBuilder<TResult, any, any> {\n        if (this.#resolvedSchema === null) {\n            this.#resolvedSchema = this.#getter();\n        }\n        return this.#resolvedSchema;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public introspect() {\n        return {\n            ...super.introspect(),\n            /**\n             * The getter function that returns the lazily-resolved schema.\n             * Call {@link LazySchemaBuilder.resolve} to obtain the schema instance.\n             */\n            getter: this.#getter\n        };\n    }\n\n    #buildResult(\n        superResult: ReturnType<LazySchemaBuilder['preValidateSync']>,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { valid, errors };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        // Value is null/undefined and the schema is optional — skip delegation.\n        if (objToValidate == null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        return this.resolve().validate(\n            objToValidate,\n            context\n        ) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return super.validate(object, context) as ValidationResult<TResult>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of the schema over `object`.\n     * Throws if any preprocessor, validator, or error message provider returns a Promise.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected _validate(\n        object: TResult,\n        context?: ValidationContext\n    ): ValidationResult<TResult> {\n        return this.#buildResult(\n            this.preValidateSync(object, context),\n            context\n        );\n    }\n\n    /**\n     * Performs async validation of the schema over `object`.\n     * Supports async preprocessors, validators, and error message providers.\n     * @param context Optional `ValidationContext` settings.\n     */\n    protected async _validateAsync(\n        object: TResult,\n        context?: ValidationContext\n    ): Promise<ValidationResult<TResult>> {\n        const superResult = await super.preValidateAsync(object, context);\n\n        const {\n            valid,\n            transaction: preValidationTransaction,\n            errors\n        } = superResult;\n\n        if (!valid) {\n            return { valid, errors };\n        }\n\n        const {\n            object: { validatedObject: objToValidate }\n        } = preValidationTransaction!;\n\n        if (objToValidate == null) {\n            return { valid: true, object: objToValidate };\n        }\n\n        return this.resolve().validateAsync(objToValidate, context) as Promise<\n            ValidationResult<TResult>\n        >;\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: LazySchemaBuilderCreateProps<TReq>\n    ): this {\n        return LazySchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): LazySchemaBuilder<T, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    /**\n     * @inheritdoc\n     */\n    public clearHasType(): LazySchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): LazySchemaBuilder<TResult, true, TNullable, THasDefault, TExtensions> &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): LazySchemaBuilder<\n        TResult,\n        false,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value: TResult | (() => TResult)\n    ): LazySchemaBuilder<TResult, true, TNullable, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): LazySchemaBuilder<\n        TResult,\n        TRequired,\n        TNullable,\n        false,\n        TExtensions\n    > &\n        TExtensions {\n        return super.clearDefault() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public brand<TBrand extends string | symbol>(\n        _name?: TBrand\n    ): LazySchemaBuilder<\n        TResult & { readonly [K in BRAND]: TBrand },\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * @hidden\n     */\n    public readonly(): LazySchemaBuilder<\n        Readonly<TResult>,\n        TRequired,\n        TNullable,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): LazySchemaBuilder<\n        TResult,\n        TRequired,\n        true,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.nullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public notNullable(): LazySchemaBuilder<\n        TResult,\n        TRequired,\n        false,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n}\n\n/**\n * Creates a lazy schema that defers the schema definition until first validation.\n * Use this to define recursive/self-referential schemas.\n *\n * The getter function is called **once** on first use and the result is cached.\n * You **must** provide an explicit TypeScript type annotation on the variable\n * holding the outer schema — TypeScript cannot infer recursive types automatically.\n *\n * @param getter - A function that returns the schema to use for validation.\n *\n * @example\n * ```ts\n * // Tree structure\n * type TreeNode = { value: number; children: TreeNode[] };\n *\n * const treeNode: SchemaBuilder<TreeNode, true> = object({\n *     value: number(),\n *     children: array(lazy(() => treeNode))\n * });\n * ```\n *\n * @example\n * ```ts\n * // Optional recursive field (submenu)\n * type MenuItem = { label: string; submenu?: MenuItem[] };\n *\n * const menuItem: SchemaBuilder<MenuItem, true> = object({\n *     label: string(),\n *     submenu: array(lazy(() => menuItem)).optional()\n * });\n * ```\n */\nexport function lazy<TResult>(\n    getter: () => SchemaBuilder<TResult, any, any>\n): LazySchemaBuilder<TResult, true, false, false, {}> {\n    return LazySchemaBuilder.create({\n        type: 'lazy',\n        isRequired: true,\n        preprocessors: [],\n        validators: [],\n        getter\n    } as any);\n}\n","import {\n    type BRAND,\n    SchemaBuilder,\n    type ValidationContext,\n    type ValidationErrorMessageProvider,\n    type ValidationResult\n} from './SchemaBuilder.js';\n\ntype NullSchemaBuilderCreateProps<R extends boolean = true> = Partial<\n    ReturnType<NullSchemaBuilder<R>['introspect']>\n>;\n\n/**\n * Schema builder for `null` values. Validates that the input is exactly `null`.\n *\n * When required (the default), only `null` is accepted. When optional (via\n * `.optional()`), both `null` and `undefined` are accepted; any other value\n * is rejected.\n *\n * This builder is useful when you need to represent an explicitly-null field\n * in a typed schema, for example in discriminated-union branches or when\n * modelling a JSON payload that may carry a JSON `null` value.\n *\n * **NOTE** this class is exported for type annotations and advanced use.\n * Customize via extensions rather than subclassing. Avoid instantiating it\n * directly. Use {@link nul | nul()} function instead.\n *\n * @example\n * ```ts\n * import { nul } from '@cleverbrush/schema';\n *\n * const schema = nul();\n *\n * schema.validate(null);       // { valid: true,  object: null }\n * schema.validate(undefined);  // { valid: false }\n * schema.validate(0);          // { valid: false }\n * schema.validate('');         // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Optional — accepts null or undefined\n * const schema = nul().optional();\n *\n * schema.validate(null);       // { valid: true, object: null }\n * schema.validate(undefined);  // { valid: true, object: undefined }\n * schema.validate(false);      // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Use inside a union to model a nullable string field\n * import { union, string, nul, InferType } from '@cleverbrush/schema';\n *\n * const NullableString = union(string()).or(nul());\n * type NullableString = InferType<typeof NullableString>;\n * // string | null\n *\n * NullableString.validate('hello');  // valid\n * NullableString.validate(null);     // valid\n * NullableString.validate(42);       // invalid\n * ```\n *\n * @see {@link nul}\n */\nexport class NullSchemaBuilder<\n    TRequired extends boolean = true,\n    TNullable extends boolean = false,\n    TExplicitType = undefined,\n    THasDefault extends boolean = false,\n    TExtensions = {}\n> extends SchemaBuilder<null, TRequired, TNullable, THasDefault, TExtensions> {\n    /**\n     * @hidden\n     */\n    public static create(props: NullSchemaBuilderCreateProps<any>) {\n        return new NullSchemaBuilder({\n            type: 'null',\n            ...props\n        });\n    }\n\n    protected constructor(props: NullSchemaBuilderCreateProps<TRequired>) {\n        super(props as any);\n    }\n\n    /**\n     * @hidden\n     */\n    public hasType<T>(\n        _notUsed?: T\n    ): NullSchemaBuilder<true, TNullable, T, THasDefault, TExtensions> &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearHasType(): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        undefined,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return this.derive(\n            {\n                ...this.introspect()\n            } as any,\n            true\n        ) as any;\n    }\n\n    // The SchemaBuilder base-class preValidateSync/preValidateAsync treats\n    // null as an invalid value for required schemas, which would prevent null\n    // from ever passing validation here. We therefore bypass preValidateSync\n    // entirely and implement the full (and simple) validation inline.\n    #buildResult(object: any): ValidationResult<null> {\n        if (object === null) return { valid: true, object: null };\n\n        if (object === undefined && this.hasDefault) {\n            const defaultVal = this.resolveDefaultValue();\n            if (defaultVal === null) return { valid: true, object: null };\n            return { valid: false, errors: [{ message: 'must be null' }] };\n        }\n\n        if (object === undefined && !this.isRequired) {\n            return { valid: true, object: undefined as any };\n        }\n\n        return {\n            valid: false,\n            errors: [{ message: 'must be null' }]\n        };\n    }\n\n    /** {@inheritDoc SchemaBuilder.validate} */\n    public validate(\n        object: null,\n        context?: ValidationContext\n    ): ValidationResult<null> {\n        return super.validate(object, context) as ValidationResult<null>;\n    }\n\n    /** {@inheritDoc SchemaBuilder.validateAsync} */\n    public async validateAsync(\n        object: null,\n        context?: ValidationContext\n    ): Promise<ValidationResult<null>> {\n        return super.validateAsync(object, context) as Promise<\n            ValidationResult<null>\n        >;\n    }\n\n    /**\n     * Performs synchronous validation of the schema over `object`.\n     */\n    protected _validate(\n        object: null,\n        _context?: ValidationContext\n    ): ValidationResult<null> {\n        return this.#buildResult(object);\n    }\n\n    /**\n     * Performs async validation of the schema over `object`.\n     */\n    protected async _validateAsync(\n        object: null,\n        _context?: ValidationContext\n    ): Promise<ValidationResult<null>> {\n        return this.#buildResult(object);\n    }\n\n    protected createFromProps<TReq extends boolean>(\n        props: NullSchemaBuilderCreateProps<TReq>\n    ): this {\n        return NullSchemaBuilder.create(props as any) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public required(\n        errorMessage?: ValidationErrorMessageProvider\n    ): NullSchemaBuilder<\n        true,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.required(errorMessage);\n    }\n\n    /**\n     * @hidden\n     */\n    public optional(): NullSchemaBuilder<\n        false,\n        TNullable,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.optional();\n    }\n\n    /**\n     * @hidden\n     */\n    public default(\n        value: null | (() => null)\n    ): NullSchemaBuilder<true, TNullable, TExplicitType, true, TExtensions> &\n        TExtensions {\n        return super.default(value) as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public clearDefault(): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        TExplicitType,\n        false,\n        TExtensions\n    > &\n        TExtensions {\n        return super.clearDefault() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public brand<TBrand extends string | symbol>(\n        _name?: TBrand\n    ): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        null & { readonly [K in BRAND]: TBrand },\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.brand(_name);\n    }\n\n    /**\n     * Marks the inferred type as `Readonly<null>`. Since `null` is already\n     * immutable this is an identity operation, but it sets the `isReadonly`\n     * introspection flag for tooling consistency.\n     *\n     * @see {@link SchemaBuilder.readonly}\n     */\n    public readonly(): NullSchemaBuilder<\n        TRequired,\n        TNullable,\n        Readonly<null>,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.readonly();\n    }\n\n    /**\n     * @hidden\n     */\n    public nullable(): NullSchemaBuilder<\n        TRequired,\n        true,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.nullable() as any;\n    }\n\n    /**\n     * @hidden\n     */\n    public notNullable(): NullSchemaBuilder<\n        TRequired,\n        false,\n        TExplicitType,\n        THasDefault,\n        TExtensions\n    > &\n        TExtensions {\n        return super.notNullable() as any;\n    }\n}\n\n/**\n * Creates a schema that validates the value is exactly `null`.\n *\n * By default the schema is **required** — only `null` is accepted.\n * Call `.optional()` to also allow `undefined`.\n *\n * @example\n * ```ts\n * import { nul } from '@cleverbrush/schema';\n *\n * nul().validate(null);       // { valid: true,  object: null }\n * nul().validate(undefined);  // { valid: false }\n * nul().validate(0);          // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * nul().optional().validate(null);       // { valid: true, object: null }\n * nul().optional().validate(undefined);  // { valid: true, object: undefined }\n * nul().optional().validate(false);      // { valid: false }\n * ```\n *\n * @example\n * ```ts\n * // Nullable field in an object schema\n * import { object, string, nul, union, InferType } from '@cleverbrush/schema';\n *\n * const Schema = object({\n *   name:    string(),\n *   deleted: union(nul()).or(string()),   // null | string\n * });\n *\n * type T = InferType<typeof Schema>;\n * // { name: string; deleted: null | string }\n * ```\n */\nexport const nul = () =>\n    NullSchemaBuilder.create({\n        isRequired: true\n    }) as NullSchemaBuilder<true>;\n"],"mappings":"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","names":["IntersectionSchemaBuilder","_IntersectionSchemaBuilder","SchemaBuilder","#left","#right","props","_notUsed","object","context","#mergeObjects","leftObj","rightObj","#createValidationSetup","superResult","valid","preValidationTransaction","prevalidationContext","errors","objToValidate","leftResult","rightResult","#validateFull","setup","errorMessage","value","_name","intersection","left","right","LazySchemaBuilder","_LazySchemaBuilder","SchemaBuilder","#getter","#resolvedSchema","props","#buildResult","superResult","context","valid","preValidationTransaction","errors","objToValidate","object","_notUsed","errorMessage","value","_name","lazy","getter","NullSchemaBuilder","_NullSchemaBuilder","SchemaBuilder","props","_notUsed","#buildResult","object","context","_context","errorMessage","value","_name","nul"]}

package/dist/core.d.ts

@@ -19,12 +19,12 @@ export { ParseStringSchemaBuilder, parseString } from './builders/ParseStringSch
 export { PromiseSchemaBuilder, promise } from './builders/PromiseSchemaBuilder.js';
 export type { RecordSchemaValidationResult } from './builders/RecordSchemaBuilder.js';
 export { RecordSchemaBuilder, record } from './builders/RecordSchemaBuilder.js';
-export type { NestedValidationResult, PropertyDescriptor, PropertyDescriptorInner, PropertyDescriptorTree, PropertySetterOptions, ValidationErrorMessageProvider } from './builders/SchemaBuilder.js';
+export type { IndexedPropertyDescriptor, NestedValidationResult, PropertyDescriptor, PropertyDescriptorInner, PropertyDescriptorTree, PropertySetterOptions, ValidationErrorMessageProvider } from './builders/SchemaBuilder.js';
 export { BRAND, Brand, InferType, MakeOptional, SchemaBuilder, SchemaTypeBrand, SchemaValidationError, SYMBOL_HAS_PROPERTIES, SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR, ValidationError, ValidationResult } from './builders/SchemaBuilder.js';
 export { StringSchemaBuilder, string } from './builders/StringSchemaBuilder.js';
 export type { TupleElementValidationResults, TupleSchemaValidationResult } from './builders/TupleSchemaBuilder.js';
 export { TupleSchemaBuilder, tuple } from './builders/TupleSchemaBuilder.js';
 export type { OptionValidationResults, UnionSchemaValidationResult } from './builders/UnionSchemaBuilder.js';
 export { UnionSchemaBuilder, union } from './builders/UnionSchemaBuilder.js';
-export type { CleanExtended, ExtensionConfig, ExtensionDescriptor, ExtraTypeBrandSymbol, FixedMethods, HiddenExtensionMethods, MethodLiteralBrandSymbol } from './extension.js';
-export { defineExtension, EXTRA_TYPE_BRAND, METHOD_LITERAL_BRAND, withExtensions } from './extension.js';
+export type { CleanExtended, ExtensionConfig, ExtensionDescriptor, ExtraProperties, ExtraTypeBrandSymbol, FixedMethods, HiddenExtensionMethods, InferExtensionMetadata, MetadataExtended, MetadataMethod, MetadataMethodBuilder, MetadataMethods, MetadataState, MethodLiteralBrandSymbol } from './extension.js';
+export { defineExtension, defineMetadataMethod, EXTRA_TYPE_BRAND, METHOD_LITERAL_BRAND, withExtensions } from './extension.js';

package/dist/core.js

@@ -1,2 +1,2 @@
-import{a as s,b as t,c as u,d as v,e as w,f as x}from"./chunk-VSU5GILY.js";import{a as C,b as D}from"./chunk-XHSBY2QK.js";import{a as q,b as r,c as O,d as P,e as Q,f as R}from"./chunk-54RHS4F4.js";import{a as M,b as N}from"./chunk-C6YQOKWB.js";import{a as o,b as p}from"./chunk-K4ZLXLE2.js";import{a as y,b as z}from"./chunk-ELPPAHNO.js";import{a as A,b as B}from"./chunk-6LSN7NXQ.js";import{a as E,b as F}from"./chunk-JUFZ7PLO.js";import{a as G,b as H}from"./chunk-XL723XFL.js";import{a as I,b as J}from"./chunk-ORV2G6ZL.js";import{a as K,b as L}from"./chunk-G424M7GI.js";import{a as e,b as f}from"./chunk-XPLTW5DI.js";import{a as g,b as h}from"./chunk-KC45JEFL.js";import{a as i,b as j}from"./chunk-PQINUGZW.js";import{a as k,b as l}from"./chunk-NF4CRFMN.js";import{a as m,b as n}from"./chunk-YAOZEA2R.js";import{b as a,c as b,d as c,f as d}from"./chunk-REYZ7G7J.js";export{e as AnySchemaBuilder,g as ArraySchemaBuilder,i as BooleanSchemaBuilder,k as DateSchemaBuilder,P as EXTRA_TYPE_BRAND,m as ExternSchemaBuilder,o as FunctionSchemaBuilder,q as GenericSchemaBuilder,s as IntersectionSchemaBuilder,u as LazySchemaBuilder,O as METHOD_LITERAL_BRAND,w as NullSchemaBuilder,y as NumberSchemaBuilder,A as ObjectSchemaBuilder,C as ParseStringSchemaBuilder,E as PromiseSchemaBuilder,G as RecordSchemaBuilder,c as SYMBOL_HAS_PROPERTIES,b as SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR,d as SchemaBuilder,a as SchemaValidationError,I as StringSchemaBuilder,K as TupleSchemaBuilder,M as UnionSchemaBuilder,f as any,h as array,j as boolean,l as date,Q as defineExtension,n as extern,p as func,r as generic,t as intersection,v as lazy,x as nul,z as number,B as object,D as parseString,F as promise,H as record,J as string,L as tuple,N as union,R as withExtensions};
+import{a as s,b as t,c as u,d as v,e as w,f as x}from"./chunk-ZYWDTLNL.js";import{a as C,b as D}from"./chunk-W5LLKFM7.js";import{a as q,b as r,c as O,d as P,e as Q,f as R,g as S}from"./chunk-WNAU5MPQ.js";import{a as M,b as N}from"./chunk-3E5M6GRR.js";import{a as o,b as p}from"./chunk-BMA2X7LI.js";import{a as y,b as z}from"./chunk-BTR3ZGES.js";import{a as A,b as B}from"./chunk-Z4SFUZSP.js";import{a as E,b as F}from"./chunk-25KL2NBJ.js";import{a as G,b as H}from"./chunk-W5D22D4P.js";import{a as I,b as J}from"./chunk-JH7VLA6C.js";import{a as K,b as L}from"./chunk-VBPZRO7L.js";import{a as e,b as f}from"./chunk-NDESVCWI.js";import{a as g,b as h}from"./chunk-XASMTNON.js";import{a as i,b as j}from"./chunk-D7RXO2FA.js";import{a as k,b as l}from"./chunk-66U6MMJ2.js";import{a as m,b as n}from"./chunk-K7TDPKGQ.js";import{b as a,c as b,d as c,f as d}from"./chunk-2BKBVVZ3.js";export{e as AnySchemaBuilder,g as ArraySchemaBuilder,i as BooleanSchemaBuilder,k as DateSchemaBuilder,Q as EXTRA_TYPE_BRAND,m as ExternSchemaBuilder,o as FunctionSchemaBuilder,q as GenericSchemaBuilder,s as IntersectionSchemaBuilder,u as LazySchemaBuilder,P as METHOD_LITERAL_BRAND,w as NullSchemaBuilder,y as NumberSchemaBuilder,A as ObjectSchemaBuilder,C as ParseStringSchemaBuilder,E as PromiseSchemaBuilder,G as RecordSchemaBuilder,c as SYMBOL_HAS_PROPERTIES,b as SYMBOL_SCHEMA_PROPERTY_DESCRIPTOR,d as SchemaBuilder,a as SchemaValidationError,I as StringSchemaBuilder,K as TupleSchemaBuilder,M as UnionSchemaBuilder,f as any,h as array,j as boolean,l as date,R as defineExtension,O as defineMetadataMethod,n as extern,p as func,r as generic,t as intersection,v as lazy,x as nul,z as number,B as object,D as parseString,F as promise,H as record,J as string,L as tuple,N as union,S as withExtensions};
 //# sourceMappingURL=core.js.map

package/dist/extension.d.ts

@@ -76,6 +76,9 @@ import type { PropertyDescriptorTree, SchemaBuilder } from './builders/SchemaBui
 import { StringSchemaBuilder } from './builders/StringSchemaBuilder.js';
 import { TupleSchemaBuilder } from './builders/TupleSchemaBuilder.js';
 import { UnionSchemaBuilder } from './builders/UnionSchemaBuilder.js';
+import type { MetadataExtended } from './metadata-extension.js';
+export type { ExtraProperties, InferExtensionMetadata, MetadataExtended, MetadataMethod, MetadataMethodBuilder, MetadataMethods, MetadataState } from './metadata-extension.js';
+export { defineMetadataMethod } from './metadata-extension.js';
 /**
  * Maps each builder type name to the corresponding generic builder class.
  *
@@ -279,7 +282,7 @@ export type FixedMethods<TRawMethods, TBase, TAccum extends string = never, TExt
  * `withExtension` / `getExtension` overridden to `never` so they
  * don't appear as callable in consumer code.
  */
-export type CleanExtended<TBuilder, TExt> = TBuilder & FixedMethods<TExt, TBuilder> & HiddenExtensionMethods;
+export type CleanExtended<TBuilder, TExt> = MetadataExtended<TBuilder, TExt>;
 type ExtendedStringFactory<TExt> = {
     (): CleanExtended<StringSchemaBuilder<string, true, false, false, TExt>, TExt>;
     <T extends string>(equals: T): CleanExtended<StringSchemaBuilder<T, true, false, false, TExt>, TExt>;

package/dist/extension.js

@@ -1,2 +1,2 @@
-import{c as a,d as b,e as c,f as d}from"./chunk-54RHS4F4.js";import"./chunk-C6YQOKWB.js";import"./chunk-K4ZLXLE2.js";import"./chunk-ELPPAHNO.js";import"./chunk-6LSN7NXQ.js";import"./chunk-JUFZ7PLO.js";import"./chunk-XL723XFL.js";import"./chunk-ORV2G6ZL.js";import"./chunk-G424M7GI.js";import"./chunk-XPLTW5DI.js";import"./chunk-KC45JEFL.js";import"./chunk-PQINUGZW.js";import"./chunk-NF4CRFMN.js";import"./chunk-REYZ7G7J.js";export{b as EXTRA_TYPE_BRAND,a as METHOD_LITERAL_BRAND,c as defineExtension,d as withExtensions};
+import{c as a,d as b,e as c,f as d,g as e}from"./chunk-WNAU5MPQ.js";import"./chunk-3E5M6GRR.js";import"./chunk-BMA2X7LI.js";import"./chunk-BTR3ZGES.js";import"./chunk-Z4SFUZSP.js";import"./chunk-25KL2NBJ.js";import"./chunk-W5D22D4P.js";import"./chunk-JH7VLA6C.js";import"./chunk-VBPZRO7L.js";import"./chunk-NDESVCWI.js";import"./chunk-XASMTNON.js";import"./chunk-D7RXO2FA.js";import"./chunk-66U6MMJ2.js";import"./chunk-2BKBVVZ3.js";export{c as EXTRA_TYPE_BRAND,b as METHOD_LITERAL_BRAND,d as defineExtension,a as defineMetadataMethod,e as withExtensions};
 //# sourceMappingURL=extension.js.map

package/dist/extensions/string.d.ts

@@ -52,8 +52,7 @@ export interface StringBuiltinExtensions<T extends string = string> {
      * By default only `http` and `https` protocols are accepted.
      * Pass `opts.protocols` to restrict or expand the allowed set.
      *
-     * @param opts - optional configuration
-     * @param opts.protocols - allowed URL protocols (default: `['http', 'https']`)
+     * The options overload accepts a `protocols` array (default: http/https).
      * @param errorMessage - custom error message or function to generate one
      * @returns a new schema builder with the URL validator applied
      *
@@ -230,8 +229,7 @@ export declare const stringExtensions: import("../extension.js").ExtensionDescri
          * By default only `http` and `https` protocols are accepted.
          * Pass `opts.protocols` to restrict or expand the allowed set.
          *
-         * @param opts - optional configuration
-         * @param opts.protocols - allowed URL protocols (default: `['http', 'https']`)
+         * @param optsOrError - protocol options or a custom error message
          * @param errorMessage - custom error message or function to generate one
          * @returns a new schema builder with the URL validator applied
          *