// generated by diplomat-tool
import type { FieldRange } from "./FieldRange.mjs"
import type { NucleationError } from "./NucleationError.mjs"
import type { pointer, codepoint } from "./diplomat-runtime.d.ts";



/**
 * Immutable scalar field evaluated over world-space `(x, y, z)`.
 *
 * A `Field3` has scalar semantics only. It may be shared by geometry and
 * material consumers without being reinterpreted as a signed-distance field.
 */
export class Field3 {
    /** @internal */
    get ffiValue(): pointer;
    /** @internal */
    constructor();


    /**
     * Deterministic value-noise FBM normalized to `[-1, 1]`.
     */
    static valueNoiseFbm(frequency: number, seed: number, octaves: number): Field3;

    evalAt(x: number, y: number, z: number): number;

    /**
     * The field's analytically proven output range.
     *
     * Returns `NotFound` when no range can be proven — callers mapping a
     * field onto a gradient must handle that rather than silently
     * propagating a sentinel into their `lo`/`hi` bounds.
     */
    outputRange(): FieldRange;

    static fromJsonString(json: string): Field3;

    toJson(): string;
}