import type { ManifestDefaultsDocument } from './defaults.js';
import { type ValidationError as SharedValidationError, type ValidationResult as SharedValidationResult } from '@wp-typia/api-client/runtime-primitives';
export type TypiaValidationError = SharedValidationError;
export type ValidationResult<T> = SharedValidationResult<T>;
export interface ValidationState<T> extends ValidationResult<T> {
    errorMessages: string[];
}
export interface ValidationHookBindings {
    useMemo: <S>(factory: () => S, deps: readonly unknown[]) => S;
}
export interface ScaffoldValidatorToolkitOptions<T extends object> {
    assert: (value: unknown) => T;
    clone: (value: T) => T;
    finalize?: (value: Partial<T>) => unknown;
    is: (value: unknown) => value is T;
    manifest: ManifestDefaultsDocument;
    onValidationError?: (result: ValidationResult<T>, key: keyof T) => void;
    prune: (value: T) => unknown;
    random: (...args: unknown[]) => T;
    validate: (value: unknown) => unknown;
}
export declare function normalizeValidationError(error: unknown): TypiaValidationError;
export declare function toValidationResult<T>(result: unknown): ValidationResult<T>;
export declare function formatValidationError(error: TypiaValidationError): string;
export declare function formatValidationErrors(errors: readonly TypiaValidationError[]): string[];
export declare function toValidationState<T>(result: ValidationResult<T>): ValidationState<T>;
/**
 * Create a React-style hook that memoizes Typia validation results.
 *
 * @param bindings - Hook bindings supplied by the host runtime.
 * @returns A hook that validates one value and returns formatted error state.
 * @example
 * ```ts
 * const useTypiaValidation = createUseTypiaValidationHook({ useMemo });
 * ```
 * @category Scaffolding
 */
export declare function createUseTypiaValidationHook(bindings: ValidationHookBindings): <T>(value: T, validator: (value: T) => ValidationResult<T>) => ValidationState<T>;
/**
 * Create the validator toolkit used by generated scaffold runtimes.
 *
 * @remarks
 * The toolkit applies manifest defaults before validation and exposes safe
 * attribute updater helpers for editor integrations.
 *
 * @param options - Typia validators plus manifest-default metadata.
 * @returns Sanitizers, validators, and updater factories for scaffold attributes.
 * @example
 * ```ts
 * const toolkit = createScaffoldValidatorToolkit({
 *   assert,
 *   clone,
 *   is,
 *   manifest,
 *   prune,
 *   random,
 *   validate,
 * });
 * ```
 * @category Scaffolding
 */
export declare function createScaffoldValidatorToolkit<T extends object>(options: ScaffoldValidatorToolkitOptions<T>): {
    createAttributeUpdater: (attributes: T, setAttributes: (attrs: Partial<T>) => void, validator?: (value: T) => ValidationResult<T>) => <K extends keyof T>(key: K, value: T[K]) => boolean;
    sanitizeAttributes: (value: Partial<T>) => T;
    validateAttributes: (value: unknown) => ValidationResult<T>;
    validators: {
        assert: (value: unknown) => T;
        clone: (value: T) => T;
        is: (value: unknown) => value is T;
        prune: (value: T) => unknown;
        random: (...args: unknown[]) => T;
        validate: (value: unknown) => ValidationResult<T>;
    };
};
/**
 * Create a shallow attribute updater that validates before committing changes.
 *
 * @param attributes - Current attribute snapshot.
 * @param setAttributes - Setter used to apply validated patches.
 * @param validate - Validator used to check the next attribute state.
 * @param onValidationError - Optional callback for rejected updates.
 * @returns A keyed updater that returns `true` when the patch is accepted.
 * @example
 * ```ts
 * const update = createAttributeUpdater(attributes, setAttributes, validate);
 * ```
 * @category Scaffolding
 */
export declare function createAttributeUpdater<T extends object>(attributes: T, setAttributes: (attrs: Partial<T>) => void, validate: (value: T) => ValidationResult<T>, onValidationError?: (result: ValidationResult<T>, key: keyof T) => void): <K extends keyof T>(key: K, value: T[K]) => boolean;
export declare function mergeNestedAttributeUpdate<T extends object>(attributes: T, path: string, value: unknown): T;
export declare function toAttributePatch<T, K extends keyof T>(key: K, value: T[K]): Pick<T, K>;
export declare function toNestedAttributePatch<T extends object>(attributes: T, path: string, value: unknown): Partial<T>;
/**
 * Create a nested attribute updater that validates dotted-path updates.
 *
 * @param attributes - Current attribute snapshot.
 * @param setAttributes - Setter used to apply validated patches.
 * @param validate - Validator used to check the next attribute state.
 * @param onValidationError - Optional callback for rejected nested updates.
 * @returns A path-based updater that returns `true` when the patch is accepted.
 * @example
 * ```ts
 * const updatePath = createNestedAttributeUpdater(attributes, setAttributes, validate);
 * ```
 * @category Scaffolding
 */
export declare function createNestedAttributeUpdater<T extends object>(attributes: T, setAttributes: (attrs: Partial<T>) => void, validate: (value: T) => ValidationResult<T>, onValidationError?: (result: ValidationResult<T>, path: string) => void): (path: string, value: unknown) => boolean;