render-dom

type RenderDomErrorCode =
/** `mountSlide` was handed something that is not an element. */
'RENDER_DOM_NO_HOST' |
/** The host is detached and no `document` was passed. */
'RENDER_DOM_NO_DOCUMENT';

const RENDER_DOM_ERROR_CODES: readonly RenderDomErrorCode[];

class RenderDomError extends Error {
  readonly code: RenderDomErrorCode;
  constructor(code: RenderDomErrorCode, message: string);
}

function isRenderDomError(value: unknown): value is RenderDomError;

function createNode(document: Document, node: SvgNode): Node;

interface MountOptions extends RenderOptions {
  /**
   * The `document` to build in.
   *
   * Passed rather than reached for, because this package must work in a Web
   * Worker with an `OffscreenCanvas` and no global `document` - and because a
   * test that has to stub a global is a test that can pass for the wrong reason.
   */
  readonly document?: Document;
}

interface MountedSlide {
  readonly root: SVGSVGElement;
  readonly placed: readonly Placed[];
  /** The element drawing a given `p:cNvPr/@id`, for hit-testing and selection. */
  element(cNvPrId: number): SVGElement | null;
  /** Detach from the host. The nodes stay valid, so a caller may re-attach. */
  unmount(): void;
}

function mountSlide(host: Element, sheet: Sheet, size: SlideSize, options?: MountOptions): MountedSlide;

function renderSlideMarkup(sheet: Sheet, size: SlideSize, options?: RenderOptions): string;

interface HandleEdit {
  /** Which `a:ahLst` entry was dragged. */
  readonly handle: number;
  /** The adjust values this handle controls, rounded as the file will hold them. */
  readonly adjust: Readonly<Record<string, number>>;
  /** The shape's whole `a:avLst` after the edit, ready to write back. */
  readonly avLst: readonly PresetGuide[];
}

interface OverlayMountOptions extends OverlayOptions {
  readonly document?: Document;
  /** Called on every pointer move during a drag, and once more on release. */
  onChange?: (edit: HandleEdit) => void;
  /** Called once on release. */
  onCommit?: (edit: HandleEdit) => void;
}

interface MountedOverlay {
  readonly root: SVGGElement;
  readonly overlay: ShapeOverlay;
  /** Redraw against a new placement - after a drag, or a resize. */
  update(placed: Placed): void;
  /** True while a handle is being dragged. */
  dragging(): boolean;
  unmount(): void;
}

function slidePoint(root: SVGSVGElement, clientX: number, clientY: number): Point | null;

function mergeAdjust(avLst: readonly PresetGuide[], adjust: Readonly<Record<string, number>>): readonly PresetGuide[];

function mountOverlay(root: SVGSVGElement, placed: Placed, options?: OverlayMountOptions): MountedOverlay;

interface LayerSize {
  readonly widthPt: number;
  readonly heightPt: number;
}

interface LayerBlock {
  readonly block: TextBlock;
  /** The shape's frame, in points on the slide. */
  readonly leftPt: number;
  readonly topPt: number;
  readonly widthPt: number;
  readonly heightPt: number;
  /** `p:cNvPr/@id`, so a caller can find the element for a shape. */
  readonly cNvPrId: number;
  readonly name?: string | undefined;
}

interface TextLayerOptions {
  readonly document?: Document | undefined;
  /** CSS pixels per point. One transform, never a re-layout. */
  readonly scale?: number | undefined;
  /** Let the layer take pointer events. Off by default: the SVG hit-tests. */
  readonly interactive?: boolean | undefined;
}

interface MountedTextLayer {
  readonly root: HTMLElement;
  /** The element holding one shape's text. */
  element(cNvPrId: number): HTMLElement | null;
  /** Rescale without re-laying anything out. */
  resize(scale: number): void;
  unmount(): void;
}

function mountTextLayer(host: Element, blocks: readonly LayerBlock[], size: LayerSize, options?: TextLayerOptions): MountedTextLayer;