import { type Result } from '@forgeax/engine-types';
export type { DistanceFieldPolicy, FieldBounds, FieldVec3, MeshDistanceField, } from '@forgeax/engine-types';
import type { DistanceFieldPolicy, FieldVec3, MeshDistanceField } from '@forgeax/engine-types';
export declare const MAX_VISIBILITY_DISTANCE_FIELD_AXIS = 514;
/** Advance when the builder policy changes, independently of artifact encoding. */
export declare const MESH_DISTANCE_FIELD_GENERATION_VERSION = 5;
export type GeometricDistanceField = MeshDistanceField & {
    readonly policy: Extract<DistanceFieldPolicy, {
        readonly errorBound: number;
    }>;
};
export interface DistanceFieldError {
    readonly code: 'distance-field-invalid' | 'distance-field-unsupported' | 'distance-field-limit';
    readonly expected: string;
    readonly hint: string;
    readonly detail: {
        readonly reason: string;
    };
}
export declare function distanceFieldFailure(reason: string, code?: DistanceFieldError['code']): Result<never, DistanceFieldError>;
/** Canonical derived-data identity; source validation belongs to buildMeshDistanceField. */
export declare function distanceFieldMeshDigest(positions: ArrayLike<number>, indices: ArrayLike<number>): Promise<string>;
/** Explicit preparation work. Never invoked by Renderer or on an ordinary frame path. */
export declare function buildMeshDistanceField(positions: ArrayLike<number>, indices: ArrayLike<number>, options?: {
    readonly resolution?: number;
    readonly twoSided?: boolean;
}): Promise<Result<GeometricDistanceField, DistanceFieldError>>;
/** Trilinear local-space distance under the published sign policy; null means outside the volume. */
export declare function sampleMeshDistanceField(field: MeshDistanceField, p: FieldVec3): number | null;
//# sourceMappingURL=distance-field.d.ts.map