import { ReaderObject } from "../adapters/reader/lisio-reader-adapter";
import { BlockTreeNode } from "./block-tree";

/**
 * Shared context threaded through every kind-specific renderer in
 * `renderers/`. Only the TYPE lives here — the implementation is built as a
 * closure inside `render-block-tree.ts`'s `renderBlockTree()`, which avoids
 * a circular import between the per-kind renderers and the block-tree
 * walker that dispatches to them.
 */
export interface RenderContext {
  calendarLang: "fr" | "en";
  /** Resolves this block's OWN direct leaf ReaderObjects, in position order. */
  leavesOf(block: BlockTreeNode): ReaderObject[];
  /**
   * Renders this block's own leaves AND its children into `parent`,
   * interleaved by position so reading order is preserved as closely as
   * the block tree allows. This is what a container-shaped renderer
   * (header/footer/aside/section/list/main) calls once it has created its
   * wrapper element.
   */
  renderInto(block: BlockTreeNode, parent: HTMLElement): void;
}
