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



/**
 * The materialized output of one segmentation run: every build (in the
 * pipeline's deterministic stable-id order) plus the aggregate
 * {@link RunStats}(crate::world_segment::runner::RunStats).
 */
export class WsRunResult {
    /** @internal */
    get ffiValue(): pointer;
    /** @internal */
    constructor();


    /**
     * Run the full pipeline (source -> segment -> stitch -> score ->
     * identity -> materialize) over a world directory. No prior-snapshot
     * builds are supplied, so every build seeds a fresh stable id (see
     * `StableBuildId::seed`).
     *
     * See the module docs for why this catches a panic instead of
     * propagating it.
     */
    static runDir(job: WsSegmentJob, hints: WsPartitionHints, profile: WsProfile, worldDir: string): WsRunResult;

    /**
     * Total builds materialized (same as `build_count`, from `RunStats`).
     */
    builds(): bigint;

    tierConfident(): bigint;

    tierProbable(): bigint;

    tierDebris(): bigint;

    crossTile(): bigint;

    largestBlockCount(): bigint;

    /**
     * Number of builds held in this result (indices `0..build_count()`
     * are valid for every per-index accessor below).
     */
    buildCount(): number;

    /**
     * The build's stable id (hex), stable across re-runs against the
     * same source under the same config, absent a prior-snapshot match.
     */
    stableIdHex(index: number): string;

    /**
     * The build's content fingerprint, as 32 lowercase hex digits (u128,
     * big-endian).
     */
    fingerprintHex(index: number): string;

    /**
     * `0` = Confident, `1` = Probable, `2` = Debris.
     */
    tierOf(index: number): number;

    blockCountOf(index: number): bigint;

    /**
     * The build's world-space bounding box minimum (inclusive).
     */
    bboxMinOf(index: number): BlockPos;

    /**
     * The build's world-space bounding box maximum (inclusive).
     */
    bboxMaxOf(index: number): BlockPos;
}