import { HsonNode } from "../../../core/types.js";
import { type ParseTokensOptions } from "./parse-tokens.js";
import type { HsonSourceProvenanceBuilder } from "../../../internal/hson-source-provenance/hson-source-provenance.js";
/**
 * Parse a Hson source string into a validated `HsonNode` tree.
 *
 * Pipeline:
 * 1. Tokenize the input via `tokenize_hson`.
 * 2. Build a node tree from the tokens via `parse_tokens`.
 * 3. Validate canonical QUID placement, values, and graph-wide uniqueness.
 * 4. Run `assert_invariants` to ensure the resulting tree satisfies all
 *    structural invariants for Hson.
 *
 * If invariants fail, a transform error is thrown.
 *
 * @param str - Raw Hson source text.
 * @returns A fully-parsed and validated `HsonNode` root.
 * @see tokenize_hson
 * @see parse_tokens
 * @see assert_invariants
 */
export declare function parse_hson(str: string, options?: ParseTokensOptions): HsonNode;
/** Shared private pipeline used by authored parsing and provenance capture. */
export declare function parse_hson_attached(str: string, options?: ParseTokensOptions, provenance?: HsonSourceProvenanceBuilder): HsonNode;
//# sourceMappingURL=parse-hson.d.ts.map