import { type MetaData, type MetaRoot } from "@metaobjectsdev/metadata";
import type { Provider } from "@metaobjectsdev/render";
import type { OutputLayout } from "../import-path.js";
import type { TemplateDocData } from "./template-doc-data.js";
export interface BuildTemplateDocDataOpts {
    /** Page-placement layout. Defaults to "flat" (back-compat: same-dir links). */
    layout?: OutputLayout;
    /** Root used to resolve the @payloadRef target's package for a correct
     *  cross-link in package layout. Optional: flat layout never needs it. */
    loadedRoot?: MetaRoot;
    /** The page provider — the SAME one the render-helper drift gate / page
     *  rendering use (e.g. `projectProvider(projectRoot)`). Used to resolve each
     *  referenced mustache's SOURCE TEXT for the "## Template source" section.
     *  Optional: when absent (or a ref doesn't resolve) the section is omitted. */
    provider?: Provider;
}
/** Build the TemplateDocData for one `template.output` node. */
export declare function buildTemplateDocData(template: MetaData, opts?: BuildTemplateDocDataOpts): TemplateDocData;
//# sourceMappingURL=template-doc-builder.d.ts.map