import { HsonNode } from "../../../core/types.js";
/**
 * Link one node to one element, cleaning up any stale prior pairings on either side.
 */
export declare function link_node_to_el(node: HsonNode, el: Element): void;
/**
 * Remove both directions for a node, if present.
 */
export declare function unlinkNode(node: HsonNode): void;
/**
 * Remove both directions for an element, if present.
 */
export declare function unlinkElement(el: Element): void;
/**
 * Check whether an `HsonNode` currently has an associated live DOM `Element`.
 *
 * This is a convenience wrapper around the underlying `WeakMap.has`.
 *
 * @param node - The node to test.
 * @returns `true` if a mapping exists, otherwise `false`.
 */
export declare function hasElementForNode(node: HsonNode): boolean;
export declare function hasNodeForEl(el: Element): boolean;
/**
 * Policy for `element_for_node_checked` when an unexpected element is found.
 */
export type ElementLookupPolicy = "throw" | "warn" | "silent";
/**
 * Resolve the DOM element mapped to a given Hson node.
 *
 * @param node - Hson node to resolve.
 * @returns The mapped DOM element, or `undefined` if none exists.
 */
export declare function get_el_for_node(node: HsonNode): Element | undefined;
export declare function get_node_for_el(el: Element): HsonNode | undefined;
/**
 * Resolve the mapped DOM element and optionally assert tag invariants.
 *
 * @param node - Hson node to resolve.
 * @param purpose - Short label included in error/warn output.
 * @param policy - Action to take when an unexpected element is found.
 * @returns The mapped DOM element, or `undefined` if none exists.
 */
export declare function element_for_node_checked(node: HsonNode, purpose: string, policy?: ElementLookupPolicy): Element | undefined;
export declare function assert_node_element_link(node: HsonNode): void;
//# sourceMappingURL=node-map-helpers.d.ts.map