import type { HsonNode, Primitive } from "./types.js";
export type HsonArrayIndexAnalysis = Readonly<{
    valid: true;
    canonical: readonly HsonNode[];
    reordered: boolean;
}> | Readonly<{
    valid: false;
    reason: string;
}>;
/**
 * Validate one explicit `_hson_arr` wrapper sequence and derive its canonical
 * physical order.
 *
 * Index strings are matched only against the exact expected spellings for the
 * sibling count. This deliberately avoids numeric coercion while rejecting
 * gaps, duplicates, non-canonical spellings, and out-of-range values.
 */
export declare function analyze_hson_array_indexes(content: readonly (HsonNode | Primitive)[]): HsonArrayIndexAnalysis;
/**
 * Canonicalize only explicit array-wrapper order across a graph.
 *
 * This leaves every non-index field byte-for-byte equivalent, returns the
 * original root when no array changes, and copies only ancestor nodes whose
 * content order changed. Caller-owned input is never mutated.
 */
export declare function normalize_hson_array_index_order(input: HsonNode, where: string): HsonNode;
//# sourceMappingURL=hson-array-indexes.d.ts.map