import { type MetaRoot } from "@metaobjectsdev/metadata";
import type { AnnotatePayloadField } from "./template-source-annotate.js";
/**
 * Walk the payload VO `voName` into an enriched `AnnotatePayloadField[]`. Each
 * node carries `owner` (the short name of the VO that DECLARES the field — the
 * link target), `type` (the neutral logical type), and `required`. Object-ref
 * fields recurse into their referenced VO with `owner` switched to that nested
 * VO; a `seen` set guards a (pathological) reference cycle (returns `[]` rather
 * than recursing forever).
 *
 * Returns `[]` when the VO can't be resolved — the annotator then leaves the
 * referencing variables unresolved (flagged "not on payload"), never throws.
 */
export declare function buildEnrichedPayloadTree(root: MetaRoot, voName: string, referrerPkg?: string, seen?: ReadonlySet<string>): AnnotatePayloadField[];
//# sourceMappingURL=template-payload-tree.d.ts.map