@agent-native/core-corpus 0.213.1 → 0.216.0

package/corpus/templates/slides-2/scripts/edit-fidelity/lib/in-page.ts

@@ -0,0 +1,1975 @@
+/// <reference lib="dom" />
+/**
+ * Code that runs inside the Slides editor page. `installInPageHelpers` is
+ * serialized by Playwright's addInitScript, so everything it uses must live
+ * inside its body — it cannot close over module scope.
+ */
+
+/** Editor chrome that legitimately differs between view and edit. */
+export const CHROME_SELECTOR = [
+  "[data-slide-selection-chrome]",
+  "[data-slide-selection-outline]",
+  "[data-slide-resize-handle]",
+  "[data-slide-resize-handle-bar]",
+  "[data-slide-move-handle]",
+  "[data-slide-rotate-handle]",
+  "[data-slide-layer-hover-outline]",
+  "[data-slide-container-outline]",
+  "[data-slide-group-move-handle]",
+  "[data-selection-overlay-left]",
+  "[data-block-bubble-menu]",
+].join(",");
+
+export const MASK_CSS = `${CHROME_SELECTOR}{visibility:hidden!important}
+*,*::before,*::after{caret-color:transparent!important;transition:none!important;animation:none!important}
+::selection{background:transparent!important}`;
+
+export const EDITOR_SELECTOR = ".slide-rich-editor-host .ProseMirror";
+
+export interface Rect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export interface TextTarget {
+  index: number;
+  builderId: string | null;
+  slideObjectId: string | null;
+  pptxParagraph: string | null;
+  tag: string;
+  className: string;
+  text: string;
+  /** Which same-tag, same-text element this is, in document order. */
+  occurrence: number;
+  /** Viewport point on the first non-space glyph. */
+  point: { x: number; y: number };
+  /** Relative to the slide canvas. */
+  rect: Rect;
+  /** Viewport point is covered by something other than the target. */
+  covered: boolean;
+}
+
+export interface SnapRecord {
+  key: string;
+  stableKey?: string;
+  pptxRecordKey?: string;
+  slideObjectId?: string | null;
+  pptxParagraph?: string | null;
+  kind: "text" | "box";
+  inside: boolean;
+  /** Its appearance is preserved even when it shares the edited visual row. */
+  protectedStyle?: boolean;
+  /** Its marker box relative to the edited row, for measuring aligned reflow. */
+  protectedRect?: Rect;
+  /** Its presence is preserved when the authoring operation should keep the row. */
+  protectedStructure?: boolean;
+  /** A leading span that supplies the marker for a styled bullet row. */
+  styledBulletMarker?: boolean;
+  styledBulletMarkerText?: string;
+  downstreamFlow?: boolean;
+  flexCrossAlignment?: {
+    context: string;
+    axis: "x" | "y";
+    containerPosition: number;
+    containerSize: number;
+    itemSize: number;
+    editedItemSize: number;
+  };
+  layoutPath?: string[];
+  tag?: string;
+  className?: string;
+  inlineStyle?: string;
+  props: Record<string, string>;
+  rect: Rect;
+}
+
+export interface Inventory {
+  elements: number;
+  visible: number;
+  hidden: number;
+  svg: number;
+  img: number;
+  style: number;
+}
+
+export interface Snapshot {
+  records: SnapRecord[];
+  inventory: Inventory;
+  text: string;
+  editedRect: Rect | null;
+  /** Border box of the edited element, without overflowing descendants. */
+  editedBoxRect: Rect | null;
+  editedObjectId?: string | null;
+  editedParagraphId?: string | null;
+  editedObjectRect?: Rect | null;
+  editedTargetRect?: Rect | null;
+  editedFlowAnchorRect?: Rect | null;
+  editedAuthoringFragmentRects?: Rect[];
+  editedObjectPosition?: string | null;
+  /** The edited target moves siblings through normal document flow. */
+  editedInFlow?: boolean;
+  /** Rendered lines of the element the edit is matched to, in full. */
+  editedText: string | null;
+  editedLayoutPath?: string[];
+}
+
+export type OutsideSnapshot = Pick<
+  Snapshot,
+  | "records"
+  | "editedRect"
+  | "editedInFlow"
+  | "editedObjectId"
+  | "editedParagraphId"
+  | "editedObjectRect"
+  | "editedTargetRect"
+  | "editedFlowAnchorRect"
+  | "editedAuthoringFragmentRects"
+  | "editedObjectPosition"
+>;
+
+export interface EditorState {
+  editing: boolean;
+  focusInEditor: boolean;
+  blocks: number;
+  editorRect: Rect | null;
+  sourceRect: Rect | null;
+  /** Top of the edited element's content, which moves with anchored text. */
+  contentTop: number | null;
+  /** The caret's box, or null unless the selection is a caret in the edited element. */
+  caretRect: Rect | null;
+  /**
+   * Position among the edited element's descendants of the block box holding
+   * the caret, -1 for the element itself; null with no caret in it.
+   */
+  caretBlock: number | null;
+  caretConvertibleTag: string | null;
+  sourceTag: string | null;
+  sourceText: string | null;
+  sourceOccurrence: number;
+  editorHtml: string;
+  /** The editor's rendered lines, which the element shows once saved. */
+  editorText: string;
+}
+
+export interface CanonicalPair {
+  stored: string[];
+  saved: string[];
+  found: boolean;
+}
+
+export interface InPageHelpers {
+  listTargets(canvasSel: string): TextTarget[];
+  targetSourceHtml(canvasSel: string, targetIndex: number): string;
+  snapshot(
+    canvasSel: string,
+    edited: { targetIndex?: number; text?: string; marker?: string },
+  ): Snapshot;
+  outsideSnapshot(canvasSel: string): OutsideSnapshot;
+  editorState(canvasSel: string): EditorState;
+  /** Why the selection entering edit left is not at the gesture's point, or null. */
+  entryCaretProblem(
+    point: { x: number; y: number },
+    gesture: string,
+  ): Promise<string | null>;
+  backgroundPoint(canvasSel: string): { x: number; y: number } | null;
+  customStyleProperties(element: Element): string[];
+  canonical(html: string): string[];
+  canonicalOutside(
+    stored: string,
+    saved: string,
+    target: { tag: string; text: string; occurrence: number },
+  ): CanonicalPair;
+  /** Call stacks of content writes sent since the last call, oldest first. */
+  takeWriteStacks(): string[];
+  /** Keepalive content writes sent since the last call, in this tab. */
+  takeKeepaliveWrites(): KeepaliveWrite[];
+}
+
+export interface KeepaliveWrite {
+  action: string;
+  /** The JSON body; null when it was not a string and could not be read. */
+  body: string | null;
+}
+
+declare global {
+  interface Window {
+    __editFidelity: InPageHelpers;
+  }
+}
+
+export function installInPageHelpers(chromeSelector: string) {
+  const snapEpoch = crypto.randomUUID();
+  const snapIds = new WeakMap<Element, number>();
+  let nextSnapId = 0;
+  const snapId = (element: Element) => {
+    let id = snapIds.get(element);
+    if (id === undefined) {
+      id = ++nextSnapId;
+      snapIds.set(element, id);
+    }
+    return id;
+  };
+  const TEXT_PROPS = [
+    "font-family",
+    "font-size",
+    "font-weight",
+    "font-style",
+    "line-height",
+    "letter-spacing",
+    "word-spacing",
+    "text-transform",
+    "color",
+    "-webkit-text-fill-color",
+    "text-shadow",
+    "text-decoration-line",
+    "font-feature-settings",
+    "font-variation-settings",
+    "text-align",
+    "white-space",
+    "opacity",
+    "visibility",
+  ];
+  const customStylePropertiesByDocument = new WeakMap<
+    Document,
+    {
+      version: number;
+      propertiesVersion: number;
+      properties: string[] | null;
+      observer: MutationObserver;
+    }
+  >();
+  const SIDES = ["top", "right", "bottom", "left"];
+  const BOX_PROPS = [
+    "display",
+    "opacity",
+    "visibility",
+    "position",
+    ...SIDES,
+    "transform",
+    "transform-origin",
+    "translate",
+    "rotate",
+    "scale",
+    ...SIDES.map((s) => `margin-${s}`),
+    ...SIDES.map((s) => `padding-${s}`),
+    ...SIDES.flatMap((s) => [
+      `border-${s}-width`,
+      `border-${s}-style`,
+      `border-${s}-color`,
+    ]),
+    "border-top-left-radius",
+    "border-top-right-radius",
+    "border-bottom-right-radius",
+    "border-bottom-left-radius",
+    "background-color",
+    "background-image",
+    "box-shadow",
+  ];
+  const OUTSIDE_EXTRA_STYLE_PROPS = [
+    "filter",
+    "backdrop-filter",
+    "clip-path",
+    "mask-image",
+    "mix-blend-mode",
+    "isolation",
+    "z-index",
+    "overflow-x",
+    "overflow-y",
+    "contain",
+    "content-visibility",
+    "object-fit",
+    "object-position",
+    "align-content",
+    "align-items",
+    "align-self",
+    "justify-content",
+    "justify-items",
+    "justify-self",
+    "flex-basis",
+    "flex-direction",
+    "flex-grow",
+    "flex-shrink",
+    "flex-wrap",
+    "gap",
+    "row-gap",
+    "column-gap",
+    "grid-area",
+    "grid-auto-flow",
+    "grid-column-end",
+    "grid-column-start",
+    "grid-row-end",
+    "grid-row-start",
+    "grid-template-areas",
+    "grid-template-columns",
+    "grid-template-rows",
+  ];
+  const PAINTED_TAGS = new Set([
+    "SVG",
+    "IMG",
+    "HR",
+    "CANVAS",
+    "VIDEO",
+    "PICTURE",
+    "IFRAME",
+  ]);
+  const INLINE_TAGS = new Set([
+    "a",
+    "abbr",
+    "b",
+    "br",
+    "code",
+    "em",
+    "font",
+    "i",
+    "img",
+    "mark",
+    "s",
+    "small",
+    "span",
+    "strong",
+    "sub",
+    "sup",
+    "u",
+  ]);
+  const TRANSIENT_ATTRS = new Set([
+    "data-src-i",
+    "data-builder-id",
+    "data-slide-text-block",
+    "data-editing-block",
+    "data-slide-content-scope",
+    "contenteditable",
+    "spellcheck",
+    "aria-expanded",
+    "aria-controls",
+    "aria-activedescendant",
+    "aria-haspopup",
+  ]);
+
+  const norm = (s: string | null | undefined) =>
+    (s ?? "").replace(/[\s\u200b\ufeff]+/g, " ").trim();
+  const strip = (s: string | null | undefined) =>
+    (s ?? "").replace(/[\s\u200b\ufeff]+/g, "");
+  /**
+   * The element's text, one line per <br> or block, placeholders and blank
+   * lines dropped: textContent gives a <br> nothing, so it cannot tell a kept
+   * break from a lost one, and innerText applies text-transform.
+   */
+  const lines = (el: Element) => {
+    let out = "";
+    const walk = (n: Node) => {
+      // Source indentation is not a line break.
+      if (n.nodeType === Node.TEXT_NODE)
+        out += (n as Text).data.replace(/\s+/g, " ");
+      else if (n.nodeName === "BR") out += "\n";
+      else if (n instanceof Element && !/^(STYLE|SCRIPT)$/.test(n.tagName)) {
+        const block =
+          n !== el && !getComputedStyle(n).display.startsWith("inline");
+        if (block) out += "\n";
+        n.childNodes.forEach(walk);
+        if (block) out += "\n";
+      }
+    };
+    walk(el);
+    return out
+      .replace(/[\u200b\ufeff]/g, "")
+      .split("\n")
+      .map(norm)
+      .filter(Boolean)
+      .join("\n");
+  };
+  const rectOf = (r: DOMRect, origin: DOMRect): Rect => ({
+    x: Math.round(r.left - origin.left),
+    y: Math.round(r.top - origin.top),
+    width: Math.round(r.width),
+    height: Math.round(r.height),
+  });
+  const isChrome = (el: Element) => !!el.closest(chromeSelector);
+  const directText = (el: Element) =>
+    Array.from(el.childNodes)
+      .filter((n) => n.nodeType === Node.TEXT_NODE)
+      .map((n) => n.nodeValue ?? "")
+      .join("");
+  const alpha = (color: string) => {
+    if (!color || color === "transparent") return 0;
+    const m = color.match(/rgba?\(([^)]+)\)/);
+    if (!m) return 1;
+    const parts = m[1].split(/[\s,/]+/).filter(Boolean);
+    return parts.length > 3 ? Number(parts[3]) : 1;
+  };
+  const paints = (el: Element, cs: CSSStyleDeclaration) =>
+    PAINTED_TAGS.has(el.tagName.toUpperCase()) ||
+    alpha(cs.backgroundColor) > 0 ||
+    cs.backgroundImage !== "none" ||
+    cs.boxShadow !== "none" ||
+    SIDES.some(
+      (s) =>
+        parseFloat(cs.getPropertyValue(`border-${s}-width`)) > 0 &&
+        cs.getPropertyValue(`border-${s}-style`) !== "none" &&
+        alpha(cs.getPropertyValue(`border-${s}-color`)) > 0,
+    );
+  const pick = (cs: CSSStyleDeclaration, props: string[]) => {
+    const out: Record<string, string> = {};
+    for (const p of props) out[p] = cs.getPropertyValue(p).trim();
+    return out;
+  };
+  const computedStyleProps = (
+    cs: CSSStyleDeclaration,
+    customProperties: string[],
+  ) => {
+    const out = pick(cs, OUTSIDE_EXTRA_STYLE_PROPS);
+    for (const property of customProperties) {
+      out[property] = cs.getPropertyValue(property).trim();
+    }
+    return out;
+  };
+  const customPropertiesFor = (root: Element) => {
+    const document = root.ownerDocument;
+    let cache = customStylePropertiesByDocument.get(document);
+    if (!cache) {
+      cache = {
+        version: 0,
+        propertiesVersion: -1,
+        properties: null,
+        observer: new MutationObserver((records) => {
+          const isStyleSheet = (node: Node) => {
+            const element = node instanceof Element ? node : node.parentElement;
+            return !!element?.closest('style,link[rel~="stylesheet"]');
+          };
+          if (
+            records.some(
+              (record) =>
+                isStyleSheet(record.target) ||
+                Array.from(record.addedNodes).some(
+                  (node) =>
+                    node instanceof Element &&
+                    (node.matches('style,link[rel~="stylesheet"]') ||
+                      node.querySelector('style,link[rel~="stylesheet"]')),
+                ) ||
+                Array.from(record.removedNodes).some(
+                  (node) =>
+                    node instanceof Element &&
+                    (node.matches('style,link[rel~="stylesheet"]') ||
+                      node.querySelector('style,link[rel~="stylesheet"]')),
+                ),
+            )
+          ) {
+            cache!.version += 1;
+          }
+        }),
+      };
+      cache.observer.observe(document.documentElement, {
+        attributes: true,
+        attributeFilter: ["disabled", "href", "media", "rel", "type"],
+        characterData: true,
+        childList: true,
+        subtree: true,
+      });
+      customStylePropertiesByDocument.set(document, cache);
+    }
+
+    const collectRuleProperties = () => {
+      const names = new Set<string>();
+      const visit = (rules: CSSRuleList) => {
+        for (const rule of Array.from(rules)) {
+          const style = (rule as CSSStyleRule).style;
+          if (style) {
+            for (let index = 0; index < style.length; index += 1) {
+              const property = style[index];
+              if (property?.startsWith("--")) names.add(property);
+            }
+          }
+          if (
+            "name" in rule &&
+            typeof rule.name === "string" &&
+            rule.name.startsWith("--") &&
+            "syntax" in rule
+          ) {
+            names.add(rule.name);
+          }
+          if ("cssRules" in rule) visit((rule as CSSGroupingRule).cssRules);
+          if ("styleSheet" in rule) {
+            const imported = (rule as CSSImportRule).styleSheet;
+            if (imported) visit(imported.cssRules);
+          }
+        }
+      };
+
+      try {
+        for (const stylesheet of Array.from(document.styleSheets)) {
+          // Slides only uses this remote sheet for @font-face declarations.
+          if (
+            stylesheet.href &&
+            new URL(stylesheet.href).hostname === "fonts.googleapis.com"
+          ) {
+            continue;
+          }
+          visit(stylesheet.cssRules);
+        }
+      } catch (error) {
+        if (error instanceof DOMException && error.name === "SecurityError") {
+          return null;
+        }
+        throw error;
+      }
+      return [...names].sort();
+    };
+
+    if (cache.propertiesVersion !== cache.version) {
+      cache.properties = collectRuleProperties();
+      cache.propertiesVersion = cache.version;
+    }
+
+    const names = new Set(cache.properties ?? []);
+    if (cache.properties === null) {
+      for (const element of [root, ...root.querySelectorAll("*")]) {
+        const style = getComputedStyle(element);
+        for (let index = 0; index < style.length; index += 1) {
+          const property = style[index];
+          if (property?.startsWith("--")) names.add(property);
+        }
+      }
+    }
+
+    const addInlineProperties = (element: Element) => {
+      const style = (element as HTMLElement | SVGElement).style;
+      if (!style) return;
+      for (let index = 0; index < style.length; index += 1) {
+        const property = style[index];
+        if (property?.startsWith("--")) names.add(property);
+      }
+    };
+    for (
+      let ancestor: Element | null = root;
+      ancestor;
+      ancestor = ancestor.parentElement
+    ) {
+      addInlineProperties(ancestor);
+    }
+    for (const element of root.querySelectorAll<HTMLElement | SVGElement>(
+      "[style]",
+    )) {
+      addInlineProperties(element);
+    }
+    return [...names].sort();
+  };
+  // getComputedStyle resolves an `auto` margin to its used length, which
+  // moves whenever a flex sibling grows; the computed value stays `auto`.
+  const boxProps = (el: Element, cs: CSSStyleDeclaration) => {
+    const out = pick(cs, BOX_PROPS);
+    if (el.hasAttribute("data-fmd-autofit-content")) {
+      out["--fmd-fit-scale"] = cs.getPropertyValue("--fmd-fit-scale").trim();
+      out["--fmd-fit-x"] = cs.getPropertyValue("--fmd-fit-x").trim();
+      out["--fmd-fit-y"] = cs.getPropertyValue("--fmd-fit-y").trim();
+      out["data-fmd-autofit-active"] = String(
+        el.hasAttribute("data-fmd-autofit-active"),
+      );
+    }
+    const map =
+      typeof el.computedStyleMap === "function" ? el.computedStyleMap() : null;
+    const inline = (el as HTMLElement).style;
+    for (const s of SIDES) {
+      if (
+        String(map?.get(`margin-${s}`)) === "auto" ||
+        (!map && inline?.getPropertyValue(`margin-${s}`) === "auto")
+      )
+        out[`margin-${s}`] = "auto";
+    }
+    return out;
+  };
+  const visible = (el: Element) => {
+    const r = el.getBoundingClientRect();
+    return (
+      r.width > 0 &&
+      r.height > 0 &&
+      el.checkVisibility({ opacityProperty: true, visibilityProperty: true })
+    );
+  };
+
+  function textTargets(root: Element): HTMLElement[] {
+    return Array.from(
+      root.querySelectorAll<HTMLElement>('[data-slide-text-block="true"]'),
+    ).filter((el) => {
+      if (el.tagName === "STYLE" || el.tagName === "SCRIPT") return false;
+      if (isChrome(el)) return false;
+      const r = el.getBoundingClientRect();
+      return r.width > 0 && r.height > 0 && norm(el.textContent) !== "";
+    });
+  }
+
+  function firstGlyphRect(el: Element): DOMRect {
+    const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+      const value = n.nodeValue ?? "";
+      const offset = value.search(/\S/);
+      if (offset < 0) continue;
+      const range = document.createRange();
+      range.setStart(n, offset);
+      range.setEnd(n, offset + 1);
+      const r = range.getBoundingClientRect();
+      if (r.width > 0 && r.height > 0) return r;
+    }
+    return el.getBoundingClientRect();
+  }
+
+  function occurrenceOf(el: Element, root: ParentNode): number {
+    const tag = el.tagName;
+    const text = strip(el.textContent);
+    let n = 0;
+    for (const other of Array.from(root.querySelectorAll(tag))) {
+      if (other === el) return n;
+      if (strip(other.textContent) === text) n++;
+    }
+    return n;
+  }
+
+  /** Deepest match also covers a source split across sibling text targets. */
+  function findByText(root: Element, text: string): Element | null {
+    const want = strip(text);
+    if (!want) return null;
+    const prefix = want.slice(0, 40);
+    let best: Element | null = null;
+    let bestScore = Infinity;
+    let bestDepth = -1;
+    let bestCount = 0;
+    const candidates = new Set<Element>();
+    for (const target of textTargets(root)) {
+      for (
+        let el: Element | null = target;
+        el && el !== root;
+        el = el.parentElement
+      ) {
+        candidates.add(el);
+      }
+    }
+    for (const el of candidates) {
+      if (!visible(el)) continue;
+      const have = strip(el.textContent);
+      if (!have.includes(prefix)) continue;
+      const score = Math.abs(have.length - want.length);
+      let depth = 0;
+      for (
+        let parent = el.parentElement;
+        parent && parent !== root;
+        parent = parent.parentElement
+      ) {
+        depth++;
+      }
+      if (score < bestScore || (score === bestScore && depth > bestDepth)) {
+        best = el;
+        bestScore = score;
+        bestDepth = depth;
+        bestCount = 1;
+      } else if (score === bestScore && depth === bestDepth) {
+        bestCount += 1;
+      }
+    }
+    return bestCount === 1 ? best : null;
+  }
+
+  /**
+   * The element's box grown to its content: text that overflows a fixed-size
+   * box (a freeform object) paints outside the box but is still the edit.
+   */
+  function paintedRect(el: Element): DOMRect {
+    const box = el.getBoundingClientRect();
+    const range = document.createRange();
+    range.selectNodeContents(el);
+    const content = range.getBoundingClientRect();
+    if (!content.width && !content.height) return box;
+    const left = Math.min(box.left, content.left);
+    const top = Math.min(box.top, content.top);
+    return new DOMRect(
+      left,
+      top,
+      Math.max(box.right, content.right) - left,
+      Math.max(box.bottom, content.bottom) - top,
+    );
+  }
+
+  function listTargets(canvasSel: string): TextTarget[] {
+    const root = document.querySelector(canvasSel);
+    if (!root) throw new Error(`canvas not found: ${canvasSel}`);
+    const origin = root.getBoundingClientRect();
+    const slideRoot = root.querySelector(".slide-content") ?? root;
+    return textTargets(root).map((el, index) => {
+      const glyph = firstGlyphRect(el);
+      const point = {
+        x: glyph.left + glyph.width / 2,
+        y: glyph.top + glyph.height / 2,
+      };
+      const hit = document.elementFromPoint(point.x, point.y);
+      return {
+        index,
+        builderId: el.getAttribute("data-builder-id"),
+        slideObjectId:
+          el
+            .closest<HTMLElement>("[data-slide-object-id]")
+            ?.getAttribute("data-slide-object-id") ?? null,
+        pptxParagraph:
+          el
+            .closest<HTMLElement>("[data-pptx-paragraph]")
+            ?.getAttribute("data-pptx-paragraph") ?? null,
+        tag: el.tagName,
+        className: el.getAttribute("class") ?? "",
+        text: norm(el.textContent),
+        occurrence: occurrenceOf(el, slideRoot),
+        point,
+        rect: rectOf(el.getBoundingClientRect(), origin),
+        covered: !hit || !(el === hit || el.contains(hit)),
+      };
+    });
+  }
+
+  function targetSourceHtml(canvasSel: string, targetIndex: number) {
+    const root = document.querySelector(canvasSel);
+    if (!root) throw new Error(`canvas not found: ${canvasSel}`);
+    const target = textTargets(root)[targetIndex];
+    if (!target) throw new Error(`text target not found: ${targetIndex}`);
+    return target.innerHTML;
+  }
+
+  /** The focused editor root, in place or floating; a fix may move it. */
+  function activeEditor(): HTMLElement | null {
+    const a = document.activeElement as HTMLElement | null;
+    if (a && a.isContentEditable) {
+      let top: HTMLElement = a;
+      while (top.parentElement?.isContentEditable) top = top.parentElement;
+      return top;
+    }
+    return document.querySelector<HTMLElement>(
+      ".slide-rich-editor-host .ProseMirror",
+    );
+  }
+
+  /** Editor surface living outside the slide canvas (the floating host). */
+  function floatingHost(root: Element, editor: HTMLElement | null) {
+    if (!editor || root.contains(editor)) return null;
+    return editor.closest(".slide-rich-editor-host") ?? editor;
+  }
+
+  function editedSource(root: Element, editor: HTMLElement | null) {
+    return (
+      root.querySelector<HTMLElement>('[data-editing-block="true"]') ??
+      (editor && root.contains(editor)
+        ? (editor.closest<HTMLElement>("[data-slide-text-block]") ?? editor)
+        : null)
+    );
+  }
+
+  function caretRect(origin: DOMRect, source: HTMLElement | null): Rect | null {
+    const selection = getSelection();
+    if (!source || !selection?.rangeCount) return null;
+    const caret = selection.getRangeAt(0);
+    if (!caret.collapsed || !source.contains(caret.endContainer)) return null;
+    let box: DOMRect | undefined = caret.getClientRects()[0];
+    // A caret in an empty or collapsed-whitespace text node, or on an empty
+    // line, draws no box of its own; the next <br> or rendered character
+    // after it in document order sits on the caret's line.
+    if (!box?.height) {
+      box = undefined;
+      const walker = document.createTreeWalker(
+        source,
+        NodeFilter.SHOW_TEXT | NodeFilter.SHOW_ELEMENT,
+      );
+      const char = document.createRange();
+      for (let n = walker.nextNode(); n && !box; n = walker.nextNode()) {
+        if (n.nodeName === "BR") {
+          const at = Array.from(n.parentNode!.childNodes).indexOf(
+            n as ChildNode,
+          );
+          const r = (n as Element).getBoundingClientRect();
+          if (caret.comparePoint(n.parentNode!, at) >= 0 && r.height) box = r;
+        } else if (n.nodeType === Node.TEXT_NODE) {
+          const from =
+            caret.comparePoint(n, 0) >= 0
+              ? 0
+              : n === caret.startContainer
+                ? caret.startOffset
+                : null;
+          if (from === null) continue;
+          for (let i = from; i < (n as Text).length && !box; i++) {
+            char.setStart(n, i);
+            char.setEnd(n, i + 1);
+            const r = char.getClientRects()[0];
+            if (r?.height) box = r;
+          }
+        }
+      }
+    }
+    return box?.height ? rectOf(box, origin) : null;
+  }
+
+  function caretBlock(source: HTMLElement | null): number | null {
+    const selection = getSelection();
+    const at = selection?.rangeCount
+      ? selection.getRangeAt(0).endContainer
+      : null;
+    if (!source || !at || !source.contains(at)) return null;
+    let el = at instanceof Element ? at : at.parentElement;
+    // A flex item computes to display: block, yet the items along a flex row
+    // share its line, so a flex item never counts as a block of its own.
+    while (
+      el &&
+      el !== source &&
+      (/^inline|^contents/.test(getComputedStyle(el).display) ||
+        /flex$/.test(getComputedStyle(el.parentElement!).display))
+    )
+      el = el.parentElement;
+    return !el || el === source
+      ? -1
+      : Array.from(source.querySelectorAll("*")).indexOf(el);
+  }
+
+  function caretConvertibleTag(editor: HTMLElement | null): string | null {
+    const focus = getSelection()?.focusNode;
+    if (!editor || !focus || !editor.contains(focus)) return null;
+    let el = focus instanceof Element ? focus : focus.parentElement;
+    while (el) {
+      const tag = el.tagName.toLowerCase();
+      if (/^h[1-6]$/.test(tag) || tag === "li") return tag;
+      if (el === editor) break;
+      el = el.parentElement;
+    }
+    return null;
+  }
+
+  /**
+   * Top of the element's rendered text and line breaks. A range over the
+   * whole element would also take in the border box of every child, so a
+   * taller icon or shape beside the text would pin it.
+   */
+  function contentTop(source: HTMLElement, origin: DOMRect): number {
+    let top = Infinity;
+    const walker = document.createTreeWalker(
+      source,
+      NodeFilter.SHOW_TEXT | NodeFilter.SHOW_ELEMENT,
+    );
+    const range = document.createRange();
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+      let rects: ArrayLike<DOMRect> = [];
+      if (n.nodeName === "BR") rects = (n as Element).getClientRects();
+      else if (n.nodeType === Node.TEXT_NODE) {
+        range.selectNodeContents(n);
+        rects = range.getClientRects();
+      }
+      for (const r of Array.from(rects))
+        if (r.height) top = Math.min(top, r.top);
+    }
+    if (top === Infinity) top = source.getBoundingClientRect().top;
+    return Math.round(top - origin.top);
+  }
+
+  function editorState(canvasSel: string): EditorState {
+    const root = document.querySelector(canvasSel);
+    if (!root) throw new Error(`canvas not found: ${canvasSel}`);
+    const origin = root.getBoundingClientRect();
+    const pm = activeEditor();
+    const source = editedSource(root, pm);
+    const slideRoot = root.querySelector(".slide-content") ?? root;
+    return {
+      editing: !!pm,
+      focusInEditor: !!pm && pm.contains(document.activeElement),
+      blocks: pm ? pm.children.length : 0,
+      editorRect: pm ? rectOf(pm.getBoundingClientRect(), origin) : null,
+      sourceRect: source
+        ? rectOf(source.getBoundingClientRect(), origin)
+        : null,
+      contentTop: source ? contentTop(source, origin) : null,
+      caretRect: caretRect(origin, source),
+      caretBlock: caretBlock(source),
+      caretConvertibleTag: caretConvertibleTag(pm),
+      sourceTag: source?.tagName ?? null,
+      sourceText: source ? norm(source.textContent) : null,
+      sourceOccurrence: source ? occurrenceOf(source, slideRoot) : 0,
+      editorHtml: pm?.innerHTML.slice(0, 4000) ?? "",
+      editorText: pm ? lines(pm) : "",
+    };
+  }
+
+  /**
+   * Compares in rendered characters from the editor's start, so equivalent
+   * DOM positions agree. That count makes a row's end equal the next row's
+   * start, so the selection must also lie in the point's row. A click on a
+   * glyph's middle may put the caret on either side of it, so the point spans
+   * one grapheme each way, but never a space, which would reach the next
+   * word; a double-click spans the word and a space after it; a point on a
+   * short leading element of a row (a bullet marker) spans that element up
+   * to the row's text. Every offset indexes one collapsed text of the whole
+   * editor, since collapsing a row alone can merge a space with its
+   * neighbor's differently.
+   */
+  async function entryCaretProblem(
+    point: { x: number; y: number },
+    gesture: string,
+  ): Promise<string | null> {
+    await new Promise((r) =>
+      requestAnimationFrame(() => requestAnimationFrame(r)),
+    );
+    const editor = activeEditor();
+    const selection = getSelection();
+    if (!editor || !selection?.rangeCount) return "no selection";
+    const sel = selection.getRangeAt(0);
+    if (
+      !editor.contains(sel.startContainer) ||
+      !editor.contains(sel.endContainer)
+    )
+      return "the selection is outside the editor";
+    const renderedText = (text: string | null | undefined) =>
+      (text ?? "").replace(/[\s\u200b\ufeff]+/g, " ");
+    const offsetOf = (node: Node, offset: number) => {
+      const r = document.createRange();
+      r.setStart(editor, 0);
+      r.setEnd(node, offset);
+      return renderedText(r.toString()).length;
+    };
+    const start = offsetOf(sel.startContainer, sel.startOffset);
+    const end = offsetOf(sel.endContainer, sel.endOffset);
+    // caretRangeFromPoint rounds the point to whole pixels, which can move it
+    // across a narrow glyph; the click itself used the fractional point.
+    const pos = document.caretPositionFromPoint?.(point.x, point.y);
+    const range = pos ? null : document.caretRangeFromPoint(point.x, point.y);
+    const node = pos?.offsetNode ?? range?.startContainer;
+    const offset = pos?.offset ?? range?.startOffset ?? 0;
+    if (!node || !editor.contains(node))
+      return "the click point is outside the editor";
+    const pointHitsPunctuation = () => {
+      if (!(node instanceof Text)) return false;
+      let at = 0;
+      for (const character of node.data) {
+        const from = at;
+        at += character.length;
+        if (
+          (from !== offset && at !== offset) ||
+          !/[\p{P}\p{S}]/u.test(character)
+        ) {
+          continue;
+        }
+        const glyph = document.createRange();
+        glyph.setStart(node, from);
+        glyph.setEnd(node, at);
+        if (
+          Array.from(glyph.getClientRects()).some(
+            (r) =>
+              point.x >= r.left &&
+              point.x <= r.right &&
+              point.y >= r.top &&
+              point.y <= r.bottom,
+          )
+        ) {
+          return true;
+        }
+      }
+      return false;
+    };
+    let row: Element = editor;
+    let marker: Element | null = null;
+    for (
+      let el = node instanceof Element ? node : node.parentElement;
+      el && el !== editor && editor.contains(el);
+      el = el.parentElement
+    ) {
+      const parent = el.parentElement;
+      const own = renderedText(el.textContent).length;
+      if (
+        parent &&
+        parent.firstElementChild === el &&
+        own >= 1 &&
+        own <= 3 &&
+        // A number label like "01" is text a double-click selects; only a
+        // glyph like "●" is a marker, as the editor itself treats it.
+        !/[\p{L}\p{N}]/u.test(el.textContent ?? "") &&
+        renderedText(parent.textContent).length > own &&
+        offsetOf(parent, 0) === offsetOf(el, 0)
+      ) {
+        row = parent;
+        marker = el;
+        break;
+      }
+      if (!getComputedStyle(el).display.startsWith("inline")) {
+        row = el;
+        break;
+      }
+    }
+    // A bullet marker is not text, so even a double-click on one only
+    // places the caret at the row's text.
+    if ((marker || gesture !== "dblclick") && !sel.collapsed)
+      return `a ${gesture} selected characters ${start}-${end} instead of placing a caret`;
+    const rowStart = offsetOf(row, 0);
+    const editorTextRange = document.createRange();
+    editorTextRange.selectNodeContents(editor);
+    const editorText = renderedText(editorTextRange.toString());
+    let from: number;
+    let to: number;
+    if (marker) {
+      from = offsetOf(marker, 0);
+      to = offsetOf(marker, marker.childNodes.length);
+      if (editorText[to] === " ") to++;
+    } else {
+      const rowText = editorText.slice(
+        rowStart,
+        offsetOf(row, row.childNodes.length),
+      );
+      const pointOffset = offsetOf(node, offset) - rowStart;
+      const segments = Array.from(
+        new Intl.Segmenter(undefined, {
+          granularity: gesture === "dblclick" ? "word" : "grapheme",
+        }).segment(rowText),
+      );
+      let localFrom = pointOffset;
+      let localTo = pointOffset;
+      let wordEnd: number | undefined;
+      if (gesture === "dblclick") {
+        const wordIndex = segments.findIndex(
+          ({ index, segment, isWordLike }) =>
+            isWordLike &&
+            ((index <= pointOffset && pointOffset < index + segment.length) ||
+              (!sel.collapsed &&
+                start - rowStart < index + segment.length &&
+                end - rowStart > index)),
+        );
+        if (wordIndex >= 0) {
+          const word = segments[wordIndex]!;
+          localFrom = word.index;
+          wordEnd = word.index + word.segment.length;
+          localTo = wordEnd;
+          const next = segments[wordIndex + 1]?.segment;
+          if (next && !next.trim()) localTo += next.length;
+          const collapsedOnPunctuation =
+            sel.collapsed &&
+            Math.abs(start - rowStart - word.index) <= 1 &&
+            pointHitsPunctuation();
+          if (
+            !collapsedOnPunctuation &&
+            (start - rowStart > localFrom || end - rowStart < wordEnd)
+          )
+            return `double-click did not select the complete word (selection ${start - rowStart}-${end - rowStart}, click ${pointOffset}, word ${localFrom}-${wordEnd})`;
+          if (collapsedOnPunctuation) {
+            localFrom = start - rowStart;
+            localTo = end - rowStart;
+          }
+        }
+      }
+      if (wordEnd === undefined) {
+        segments.forEach(({ index, segment }, i) => {
+          if (gesture !== "dblclick" && !segment.trim()) return;
+          if (index < pointOffset && index + segment.length >= pointOffset)
+            localFrom = index;
+          if (index <= pointOffset && index + segment.length > pointOffset) {
+            localTo = index + segment.length;
+            const next = segments[i + 1]?.segment;
+            if (gesture === "dblclick" && next && !next.trim())
+              localTo += next.length;
+          }
+        });
+      }
+      from = rowStart + localFrom;
+      to = rowStart + localTo;
+    }
+    const rowRange = document.createRange();
+    rowRange.selectNode(row);
+    const inRow =
+      rowRange.comparePoint(sel.startContainer, sel.startOffset) === 0 &&
+      rowRange.comparePoint(sel.endContainer, sel.endOffset) === 0;
+    if (inRow && start >= from && end <= to) return null;
+    return `selection at character ${start}${end !== start ? `-${end}` : ""} of ${editorText.length}${inRow ? "" : " in another row"}, click at ${from}${to !== from ? `-${to}` : ""}`;
+  }
+
+  function captureSnapshot(
+    canvasSel: string,
+    edited: {
+      targetIndex?: number;
+      text?: string;
+      marker?: string;
+      targetBuilderId?: string;
+      targetSlideObjectId?: string;
+      targetPptxParagraph?: string;
+      targetTextIncludes?: string;
+      authoringFragmentTexts?: string[];
+      preserveStyledBulletMarker?: boolean;
+    },
+    outsideOnly = false,
+  ): Snapshot | OutsideSnapshot {
+    const root = document.querySelector(canvasSel);
+    if (!root) throw new Error(`canvas not found: ${canvasSel}`);
+    const customProperties = outsideOnly ? customPropertiesFor(root) : [];
+    const origin = root.getBoundingClientRect();
+    const editor = activeEditor();
+    const host = floatingHost(root, editor);
+    const editingBlock = editedSource(root, editor);
+    let editedEl: Element | null = null;
+    if (edited.marker) {
+      const marker = strip(edited.marker);
+      const matches = textTargets(root).filter((el) =>
+        strip(el.textContent).includes(marker),
+      );
+      editedEl = matches.length === 1 ? matches[0]! : null;
+    } else if (edited.targetIndex !== undefined) {
+      editedEl = textTargets(root)[edited.targetIndex] ?? null;
+    } else if (edited.text) {
+      editedEl = findByText(root, edited.text);
+    }
+    let stableEditedTarget: Element | null = null;
+    if (
+      edited.targetSlideObjectId !== undefined &&
+      edited.targetPptxParagraph !== undefined
+    ) {
+      const matches = Array.from(
+        root.querySelectorAll<HTMLElement>("[data-pptx-paragraph]"),
+      ).filter(
+        (el) =>
+          el.getAttribute("data-pptx-paragraph") ===
+            edited.targetPptxParagraph &&
+          el
+            .closest("[data-slide-object-id]")
+            ?.getAttribute("data-slide-object-id") ===
+            edited.targetSlideObjectId,
+      );
+      const paragraphTextMatches = edited.targetTextIncludes
+        ? matches.filter((el) =>
+            norm(el.textContent).includes(norm(edited.targetTextIncludes)),
+          )
+        : matches;
+      const targetObject = Array.from(
+        root.querySelectorAll<HTMLElement>("[data-slide-object-id]"),
+      ).find(
+        (el) =>
+          el.getAttribute("data-slide-object-id") ===
+          edited.targetSlideObjectId,
+      );
+      const fallbackTextMatches =
+        edited.targetTextIncludes && targetObject
+          ? Array.from(
+              targetObject.querySelectorAll<HTMLElement>(
+                "p,li,blockquote,h1,h2,h3,h4,h5,h6,div",
+              ),
+            ).filter((el) =>
+              norm(el.textContent).includes(norm(edited.targetTextIncludes)),
+            )
+          : [];
+      const fallbackTargets = fallbackTextMatches.filter(
+        (el) =>
+          !fallbackTextMatches.some(
+            (other) => other !== el && el.contains(other),
+          ),
+      );
+      const textMatches =
+        paragraphTextMatches.length > 0
+          ? paragraphTextMatches
+          : fallbackTargets;
+      const builderMatches = edited.targetBuilderId
+        ? textMatches.filter(
+            (el) =>
+              el
+                .closest<HTMLElement>("[data-builder-id]")
+                ?.getAttribute("data-builder-id") === edited.targetBuilderId,
+          )
+        : [];
+      const resolvedTargets =
+        builderMatches.length === 1 ? builderMatches : textMatches;
+      if (resolvedTargets.length !== 1) {
+        const candidates = textMatches.map((el) => {
+          const object = el.closest<HTMLElement>("[data-slide-object-id]");
+          const builder = el.closest<HTMLElement>("[data-builder-id]");
+          const rect = el.getBoundingClientRect();
+          const style = getComputedStyle(el);
+          return {
+            objectId: object?.getAttribute("data-slide-object-id") ?? null,
+            builderId: builder?.getAttribute("data-builder-id") ?? null,
+            editing: el.getAttribute("data-editing-block"),
+            rect: [rect.x, rect.y, rect.width, rect.height],
+            display: style.display,
+            visibility: style.visibility,
+            opacity: style.opacity,
+          };
+        });
+        throw new Error(
+          `expected one imported paragraph ${edited.targetPptxParagraph} in slide object ${edited.targetSlideObjectId}${edited.targetTextIncludes ? ` containing ${JSON.stringify(edited.targetTextIncludes)} for builder ${edited.targetBuilderId ?? "any"}` : ""}, found ${resolvedTargets.length}: ${JSON.stringify(candidates)}`,
+        );
+      }
+      stableEditedTarget = resolvedTargets[0]!;
+    } else if (edited.targetBuilderId) {
+      stableEditedTarget =
+        Array.from(
+          root.querySelectorAll<HTMLElement>("[data-builder-id]"),
+        ).find(
+          (el) => el.getAttribute("data-builder-id") === edited.targetBuilderId,
+        ) ?? null;
+    }
+    const editedOwner =
+      stableEditedTarget ??
+      (editedEl
+        ? (editedEl.closest("[data-slide-object-id]") ??
+          editedEl.closest('[data-slide-text-block="true"]') ??
+          editedEl.closest("ul, ol") ??
+          editedEl)
+        : null);
+    const targetBlock = editingBlock ?? editedOwner;
+    const editedBox = editingBlock ?? targetBlock;
+    const editedObject =
+      stableEditedTarget?.closest<HTMLElement>("[data-slide-object-id]") ??
+      editedBox?.closest<HTMLElement>("[data-slide-object-id]") ??
+      null;
+    const logicalObjectId =
+      edited.targetSlideObjectId ??
+      editedObject?.getAttribute("data-slide-object-id") ??
+      null;
+    const targetObjectIds = new Set(
+      [logicalObjectId].filter((id): id is string => !!id),
+    );
+    const targetParagraph =
+      edited.targetSlideObjectId !== undefined &&
+      edited.targetPptxParagraph !== undefined
+        ? Array.from(
+            root.querySelectorAll<HTMLElement>("[data-pptx-paragraph]"),
+          ).find(
+            (el) =>
+              el.getAttribute("data-pptx-paragraph") ===
+                edited.targetPptxParagraph &&
+              el
+                .closest("[data-slide-object-id]")
+                ?.getAttribute("data-slide-object-id") ===
+                edited.targetSlideObjectId,
+          )
+        : null;
+    const fragmentTexts = [
+      ...(edited.authoringFragmentTexts ?? []),
+      ...(edited.targetTextIncludes ? [edited.targetTextIncludes] : []),
+    ];
+    const authoringFragmentBlocks = new Set<HTMLElement>();
+    if (fragmentTexts.length > 0 && editedObject) {
+      for (const text of new Set(fragmentTexts)) {
+        const candidates = Array.from(
+          editedObject.querySelectorAll<HTMLElement>(
+            "p,li,blockquote,h1,h2,h3,h4,h5,h6,div",
+          ),
+        ).filter((el) => norm(el.textContent).includes(norm(text)));
+        const blocks = candidates.filter(
+          (el) =>
+            !candidates.some((other) => other !== el && el.contains(other)),
+        );
+        if (blocks.length !== 1) {
+          throw new Error(
+            `expected one authoring fragment block in slide object ${logicalObjectId} for marker ${JSON.stringify(text)}, found ${blocks.length}`,
+          );
+        }
+        const block = blocks[0]!;
+        authoringFragmentBlocks.add(block);
+        if (block.parentElement?.matches("ul,ol")) {
+          authoringFragmentBlocks.add(block.parentElement);
+        }
+      }
+    }
+    const isStyledBulletRow = (el: Element) => {
+      if (!/^(DIV|LI|P)$/.test(el.tagName)) return false;
+      const marker = el.firstElementChild;
+      if (!marker || marker.tagName !== "SPAN") return false;
+      const text = norm(marker.textContent);
+      if (/^[-*•●◦▪‣·⁃–—]+$/u.test(text)) return true;
+      const style = getComputedStyle(marker);
+      const width = Number.parseFloat(style.width);
+      const height = Number.parseFloat(style.height);
+      const background = style.backgroundColor;
+      const alpha = background.match(/[,/]\s*([\d.]+)%?\s*\)$/)?.[1];
+      const hasVisibleBackground =
+        background !== "transparent" &&
+        (alpha === undefined || Number(alpha) !== 0);
+      return (
+        !text &&
+        width > 0 &&
+        width <= 48 &&
+        height > 0 &&
+        height <= 48 &&
+        (Number.parseFloat(style.borderTopWidth) > 0 ||
+          Number.parseFloat(style.borderLeftWidth) > 0 ||
+          hasVisibleBackground ||
+          Number.parseFloat(style.borderRadius) > 0)
+      );
+    };
+    let visualEditBlock = targetBlock;
+    let protectedMarker: Element | null = null;
+    for (
+      let ancestor = targetBlock;
+      ancestor && ancestor !== root;
+      ancestor = ancestor.parentElement
+    ) {
+      if (isStyledBulletRow(ancestor)) {
+        visualEditBlock = ancestor;
+        if (edited.preserveStyledBulletMarker) {
+          protectedMarker = ancestor.firstElementChild;
+        }
+        break;
+      }
+    }
+    const isInNormalFlow = (el: Element | null) => {
+      if (!el) return false;
+      for (
+        let ancestor: Element | null = el;
+        ancestor && ancestor !== root;
+        ancestor = ancestor.parentElement
+      ) {
+        const style = getComputedStyle(ancestor);
+        if (
+          style.position === "absolute" ||
+          style.position === "fixed" ||
+          style.position === "sticky" ||
+          style.cssFloat !== "none" ||
+          style.transform !== "none" ||
+          (style.position === "relative" &&
+            [style.top, style.right, style.bottom, style.left].some(
+              (offset) => offset !== "auto" && Number.parseFloat(offset) !== 0,
+            ))
+        ) {
+          return false;
+        }
+      }
+      return true;
+    };
+    const followsEditedFlow = (el: Element) => {
+      if (
+        !editedBox ||
+        editedBox === el ||
+        editedBox.contains(el) ||
+        el.contains(editedBox)
+      ) {
+        return false;
+      }
+      let editedBranch: Element = editedBox;
+      while (
+        editedBranch.parentElement &&
+        !editedBranch.parentElement.contains(el)
+      ) {
+        editedBranch = editedBranch.parentElement;
+      }
+      let followingBranch: Element = el;
+      while (
+        followingBranch.parentElement &&
+        !followingBranch.parentElement.contains(editedBranch)
+      ) {
+        followingBranch = followingBranch.parentElement;
+      }
+      const parent = editedBranch.parentElement;
+      if (!parent || followingBranch.parentElement !== parent) return false;
+      const parentStyle = getComputedStyle(parent);
+      const flexDirection = parentStyle.flexDirection;
+      const isRow = flexDirection.startsWith("row");
+      const isColumn = flexDirection.startsWith("column");
+      const itemStyle = getComputedStyle(followingBranch);
+      const align =
+        itemStyle.alignSelf === "auto"
+          ? parentStyle.alignItems
+          : itemStyle.alignSelf;
+      if (
+        parentStyle.display.includes("flex") &&
+        parentStyle.flexWrap === "nowrap" &&
+        (isRow || isColumn) &&
+        align === "center"
+      ) {
+        const axis: "x" | "y" = isRow ? "y" : "x";
+        const parentRect = parent.getBoundingClientRect();
+        const itemRect = followingBranch.getBoundingClientRect();
+        const editedRect = editedBranch.getBoundingClientRect();
+        const editedItemStyle = getComputedStyle(editedBranch);
+        const isFlexItem = (style: CSSStyleDeclaration) =>
+          style.position !== "absolute" &&
+          style.position !== "fixed" &&
+          style.position !== "sticky" &&
+          style.cssFloat === "none";
+        if (!isFlexItem(editedItemStyle) || !isFlexItem(itemStyle)) {
+          return false;
+        }
+        const size = axis === "x" ? "width" : "height";
+        const path: number[] = [];
+        for (
+          let node: Element | null = parent;
+          node && node !== root && node.parentElement;
+          node = node.parentElement
+        ) {
+          path.unshift(
+            Array.prototype.indexOf.call(node.parentElement!.children, node),
+          );
+        }
+        return {
+          flexCrossAlignment: {
+            context: path.join(".") || "root",
+            axis,
+            containerPosition: parentRect[axis] - origin[axis],
+            containerSize: parentRect[size],
+            itemSize: itemRect[size],
+            editedItemSize: editedRect[size],
+          },
+        };
+      }
+      if (!isInNormalFlow(editedBox) || !isInNormalFlow(el)) return false;
+      const editedOrder = Number.parseInt(
+        getComputedStyle(editedBranch).order,
+        10,
+      );
+      const followingOrder = Number.parseInt(
+        getComputedStyle(followingBranch).order,
+        10,
+      );
+      if (
+        parentStyle.display.includes("flex") &&
+        Number.isFinite(editedOrder) &&
+        Number.isFinite(followingOrder) &&
+        followingOrder < editedOrder
+      ) {
+        return false;
+      }
+      if (
+        editedBranch.compareDocumentPosition(followingBranch) &
+        Node.DOCUMENT_POSITION_FOLLOWING
+      ) {
+        return {};
+      }
+      return false;
+    };
+    const insideEdited = (el: Element) =>
+      (!!host && host.contains(el)) ||
+      (!!visualEditBlock &&
+        (visualEditBlock === el || visualEditBlock.contains(el))) ||
+      Array.from(authoringFragmentBlocks).some(
+        (block) => block === el || block.contains(el),
+      );
+
+    const records: SnapRecord[] = [];
+    const seen = new Map<string, number>();
+    const layoutPathOf = (el: Element) => {
+      const path: string[] = [];
+      const editedObject = editedBox?.closest("[data-slide-object-id]");
+      for (
+        let node: Element | null = el;
+        node && node !== root;
+        node = node.parentElement
+      ) {
+        const style = getComputedStyle(node);
+        const rect = node.getBoundingClientRect();
+        const object = node.closest("[data-slide-object-id]");
+        const paragraph = node.closest("[data-pptx-paragraph]");
+        path.push(
+          `${node.tagName.toLowerCase()}[sameObject=${Boolean(object && object === editedObject)};object=${object?.getAttribute("data-slide-object-id") ?? ""};paragraph=${paragraph?.getAttribute("data-pptx-paragraph") ?? ""};block=${node.hasAttribute("data-slide-text-block")};editing=${node.hasAttribute("data-editing-block")};${style.display};${style.position};${style.top},${style.right},${style.bottom},${style.left};${style.transform};${style.alignSelf};${style.alignItems};${style.alignContent};${style.flexDirection};${style.justifyContent};${style.gridTemplateRows};${style.gridTemplateColumns};${style.gridRowStart},${style.gridRowEnd};${rect.x},${rect.y},${rect.width},${rect.height}]`,
+        );
+      }
+      return path;
+    };
+    const push = (
+      base: string,
+      kind: SnapRecord["kind"],
+      inside: boolean,
+      props: Record<string, string>,
+      rect: Rect,
+      flow: ReturnType<typeof followsEditedFlow> = false,
+      textElement?: Pick<SnapRecord, "tag" | "inlineStyle">,
+      layoutPath?: string[],
+      element?: Element,
+    ) => {
+      const n = seen.get(base) ?? 0;
+      seen.set(base, n + 1);
+      const recordKind = base.endsWith("::before")
+        ? "before"
+        : base.endsWith("::after")
+          ? "after"
+          : kind;
+      const recordObject = element?.closest("[data-slide-object-id]");
+      const recordParagraph = element?.closest("[data-pptx-paragraph]");
+      const objectId =
+        recordObject?.getAttribute("data-slide-object-id") ?? null;
+      const paragraphId =
+        recordParagraph?.getAttribute("data-pptx-paragraph") ?? null;
+      const path: string[] = [];
+      for (
+        let node: Element | null | undefined = element;
+        node && recordParagraph && node !== recordParagraph;
+        node = node.parentElement
+      ) {
+        const parent = node.parentElement;
+        path.unshift(
+          `${node.tagName.toLowerCase()}:${parent ? Array.from(parent.children).indexOf(node) : 0}`,
+        );
+      }
+      const logicalRecordObjectId =
+        objectId && targetObjectIds.has(objectId) ? logicalObjectId : objectId;
+      const protectedElement = Boolean(
+        element &&
+        protectedMarker &&
+        (protectedMarker === element || protectedMarker.contains(element)),
+      );
+      const markerParent = element?.parentElement;
+      const styledBulletMarker = Boolean(
+        element &&
+        markerParent &&
+        markerParent.firstElementChild === element &&
+        isStyledBulletRow(markerParent),
+      );
+      const visualBlockRect =
+        protectedElement && visualEditBlock
+          ? rectOf(visualEditBlock.getBoundingClientRect(), origin)
+          : null;
+      records.push({
+        key: `${base}#${n}`,
+        ...(element
+          ? {
+              stableKey: `${snapEpoch}:${snapId(element)}:${recordKind}`,
+              slideObjectId: logicalRecordObjectId,
+              pptxParagraph: paragraphId,
+              ...(logicalRecordObjectId && paragraphId
+                ? {
+                    pptxRecordKey: `${logicalRecordObjectId}:${paragraphId}:${path.join("/")}:${recordKind}`,
+                  }
+                : {}),
+            }
+          : {}),
+        kind,
+        inside,
+        ...(protectedElement
+          ? {
+              protectedStyle: true,
+              protectedStructure: true,
+              ...(visualBlockRect
+                ? {
+                    protectedRect: {
+                      x: rect.x - visualBlockRect.x,
+                      y: rect.y - visualBlockRect.y,
+                      width: rect.width,
+                      height: rect.height,
+                    },
+                  }
+                : {}),
+            }
+          : {}),
+        ...(styledBulletMarker
+          ? {
+              styledBulletMarker: true,
+              styledBulletMarkerText: norm(element?.textContent),
+            }
+          : {}),
+        downstreamFlow: !!flow,
+        ...(flow && flow.flexCrossAlignment
+          ? { flexCrossAlignment: flow.flexCrossAlignment }
+          : {}),
+        ...(layoutPath ? { layoutPath } : {}),
+        ...(element
+          ? {
+              className: element.getAttribute("class") ?? "",
+              inlineStyle: element.getAttribute("style") ?? "",
+            }
+          : {}),
+        props,
+        rect,
+        ...textElement,
+      });
+    };
+    const boxKey = (el: Element) => {
+      const cls = (el.getAttribute("class") ?? "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .sort()
+        .join(".");
+      return `box:${el.tagName.toLowerCase()}${cls ? `.${cls}` : ""}`;
+    };
+
+    const visit = (el: Element) => {
+      if (outsideOnly && insideEdited(el)) return;
+      if (el.tagName === "STYLE" || el.tagName === "SCRIPT") return;
+      if (isChrome(el)) return;
+      // The hidden source of a floating editor is represented by the
+      // editor's own copy; counting both would double every edited run.
+      if (host && editingBlock && el === editingBlock) return;
+      const cs = getComputedStyle(el);
+      const inside = insideEdited(el);
+      const flow = followsEditedFlow(el);
+      const text = norm(directText(el));
+      if (text) {
+        const range = document.createRange();
+        range.selectNodeContents(el);
+        const textRect = rectOf(range.getBoundingClientRect(), origin);
+        push(
+          `text:${text.slice(0, 80)}`,
+          "text",
+          inside,
+          {
+            ...pick(cs, TEXT_PROPS),
+            ...(outsideOnly ? computedStyleProps(cs, customProperties) : {}),
+            visible: String(visible(el)),
+          },
+          textRect,
+          flow,
+          {
+            tag: el.tagName.toLowerCase(),
+            inlineStyle: el.getAttribute("style") ?? "",
+          },
+          layoutPathOf(el),
+          el,
+        );
+      }
+      if (
+        paints(el, cs) ||
+        cs.transform !== "none" ||
+        el.hasAttribute("data-fmd-autofit-content")
+      ) {
+        push(
+          boxKey(el),
+          "box",
+          inside,
+          {
+            ...boxProps(el, cs),
+            ...(outsideOnly ? computedStyleProps(cs, customProperties) : {}),
+          },
+          rectOf(el.getBoundingClientRect(), origin),
+          flow,
+          undefined,
+          layoutPathOf(el),
+          el,
+        );
+      }
+      for (const pseudo of ["::before", "::after"]) {
+        const ps = getComputedStyle(el, pseudo);
+        if (ps.content === "none" || ps.content === "normal") continue;
+        if (!paints(el, ps) && norm(ps.content.replace(/^"|"$/g, "")) === "")
+          continue;
+        push(
+          `${boxKey(el)}${pseudo}`,
+          "box",
+          inside,
+          {
+            ...pick(ps, BOX_PROPS),
+            ...(outsideOnly ? computedStyleProps(ps, customProperties) : {}),
+            content: ps.content,
+          },
+          { x: 0, y: 0, width: 0, height: 0 },
+          false,
+          undefined,
+          layoutPathOf(el),
+          el,
+        );
+      }
+      if (el.tagName.toUpperCase() === "SVG") return;
+      for (const child of Array.from(el.children)) visit(child);
+    };
+    visit(root);
+    if (host) visit(host);
+
+    const editedRect = editedBox
+      ? rectOf(paintedRect(editedBox), origin)
+      : null;
+    const editedBoxRect = editedBox
+      ? rectOf(editedBox.getBoundingClientRect(), origin)
+      : null;
+    const editedParagraph = stableEditedTarget?.closest<HTMLElement>(
+      "[data-pptx-paragraph]",
+    );
+    const editedTargetRect = stableEditedTarget
+      ? rectOf(stableEditedTarget.getBoundingClientRect(), origin)
+      : null;
+    const editedFlowAnchor =
+      targetParagraph ?? editedParagraph ?? stableEditedTarget;
+    const editedFlowAnchorRect = editedFlowAnchor
+      ? rectOf(editedFlowAnchor.getBoundingClientRect(), origin)
+      : null;
+    const editedAuthoringFragmentRects = Array.from(authoringFragmentBlocks)
+      .filter((block) => !block.matches("ul,ol"))
+      .map((block) => rectOf(block.getBoundingClientRect(), origin));
+    const editedInFlow = isInNormalFlow(editedBox);
+    if (outsideOnly) {
+      return {
+        records,
+        editedRect,
+        editedInFlow,
+        editedObjectId: logicalObjectId,
+        editedParagraphId:
+          edited.targetPptxParagraph ??
+          editedParagraph?.getAttribute("data-pptx-paragraph") ??
+          null,
+        editedObjectRect: editedObject
+          ? rectOf(editedObject.getBoundingClientRect(), origin)
+          : null,
+        editedTargetRect,
+        editedFlowAnchorRect,
+        editedAuthoringFragmentRects,
+        editedObjectPosition: editedObject
+          ? getComputedStyle(editedObject).position
+          : null,
+      };
+    }
+
+    const all = Array.from(root.querySelectorAll("*")).filter(
+      (el) => el.tagName !== "STYLE" && !isChrome(el),
+    );
+    const meaningful = all.filter(
+      (el) =>
+        norm(directText(el)) !== "" ||
+        paints(el, getComputedStyle(el)) ||
+        PAINTED_TAGS.has(el.tagName.toUpperCase()),
+    );
+    const inventory: Inventory = {
+      elements: all.length,
+      visible: meaningful.filter(visible).length,
+      hidden: meaningful.filter((el) => !visible(el)).length,
+      svg: root.querySelectorAll("svg").length,
+      img: root.querySelectorAll("img").length,
+      style: root.querySelectorAll("style").length,
+    };
+    return {
+      records,
+      inventory,
+      text: norm((root as HTMLElement).innerText),
+      editedRect,
+      editedBoxRect,
+      editedObjectId: logicalObjectId,
+      editedParagraphId:
+        edited.targetPptxParagraph ??
+        editedParagraph?.getAttribute("data-pptx-paragraph") ??
+        null,
+      editedObjectRect: editedObject
+        ? rectOf(editedObject.getBoundingClientRect(), origin)
+        : null,
+      editedTargetRect,
+      editedFlowAnchorRect,
+      editedAuthoringFragmentRects,
+      editedObjectPosition: editedObject
+        ? getComputedStyle(editedObject).position
+        : null,
+      editedInFlow,
+      editedText: editedEl ? lines(editedEl) : null,
+      editedLayoutPath: editedBox ? layoutPathOf(editedBox) : undefined,
+    };
+  }
+
+  function snapshot(
+    canvasSel: string,
+    edited: {
+      targetIndex?: number;
+      text?: string;
+      marker?: string;
+      targetBuilderId?: string;
+      targetSlideObjectId?: string;
+      targetPptxParagraph?: string;
+      targetTextIncludes?: string;
+      authoringFragmentTexts?: string[];
+      preserveStyledBulletMarker?: boolean;
+    },
+  ): Snapshot {
+    return captureSnapshot(canvasSel, edited) as Snapshot;
+  }
+
+  function outsideSnapshot(canvasSel: string): OutsideSnapshot {
+    return captureSnapshot(canvasSel, {}, true) as OutsideSnapshot;
+  }
+
+  function backgroundPoint(canvasSel: string) {
+    const canvas = document.querySelector(canvasSel);
+    const track = document.querySelector(
+      '[data-main-slide-canvas="true"]',
+    )?.parentElement;
+    if (!canvas || !track) return null;
+    const c = canvas.getBoundingClientRect();
+    const t = track.getBoundingClientRect();
+    const candidates = [
+      { x: c.left - 12, y: c.top + c.height / 2 },
+      { x: c.right + 12, y: c.top + c.height / 2 },
+      { x: c.left + c.width / 2, y: c.bottom + 12 },
+      { x: c.left + c.width / 2, y: c.top - 12 },
+    ];
+    for (const p of candidates) {
+      if (p.x <= t.left || p.x >= t.right || p.y <= t.top || p.y >= t.bottom)
+        continue;
+      const hit = document.elementFromPoint(p.x, p.y);
+      if (hit && track.contains(hit) && !canvas.contains(hit)) return p;
+    }
+    return null;
+  }
+
+  function canonicalNode(node: Node, depth: number, out: string[]) {
+    const pad = "  ".repeat(depth);
+    if (node.nodeType === Node.TEXT_NODE) {
+      const raw = node.nodeValue ?? "";
+      const text = raw.replace(/[\s\u200b\ufeff]+/g, " ");
+      if (text.trim() === "") {
+        const inline = (n: Node | null) =>
+          !!n &&
+          (n.nodeType === Node.TEXT_NODE ||
+            (n.nodeType === Node.ELEMENT_NODE &&
+              INLINE_TAGS.has((n as Element).tagName.toLowerCase())));
+        if (!(inline(node.previousSibling) && inline(node.nextSibling))) return;
+      }
+      out.push(`${pad}"${text}"`);
+      return;
+    }
+    if (node.nodeType !== Node.ELEMENT_NODE) return;
+    const el = node as Element;
+    if (el.hasAttribute("data-fmd-autofit-content")) {
+      for (const child of Array.from(el.childNodes)) {
+        canonicalNode(child, depth, out);
+      }
+      return;
+    }
+    const tag = el.tagName.toLowerCase();
+    const attrs = Array.from(el.attributes)
+      .filter((attribute) => !TRANSIENT_ATTRS.has(attribute.name))
+      .map((a) => {
+        if (a.name === "style") {
+          const scratch = document.createElement("div").style;
+          scratch.cssText = a.value;
+          const decls: string[] = [];
+          for (let i = 0; i < scratch.length; i++) {
+            const name = scratch[i];
+            const prio = scratch.getPropertyPriority(name);
+            decls.push(
+              `${name}:${scratch.getPropertyValue(name).trim()}${prio ? ` !${prio}` : ""}`,
+            );
+          }
+          return `style="${decls.sort().join("; ")}"`;
+        }
+        if (a.name === "class") {
+          return `class="${a.value.split(/\s+/).filter(Boolean).sort().join(" ")}"`;
+        }
+        return `${a.name}="${a.value}"`;
+      })
+      .sort();
+    out.push(`${pad}<${tag}${attrs.length ? ` ${attrs.join(" ")}` : ""}>`);
+    if (tag === "style") {
+      out.push(`${pad}  ${norm(el.textContent)}`);
+      return;
+    }
+    const kids =
+      tag === "template"
+        ? Array.from((el as HTMLTemplateElement).content.childNodes)
+        : Array.from(el.childNodes);
+    for (const child of kids) canonicalNode(child, depth + 1, out);
+  }
+
+  function parse(html: string): DocumentFragment {
+    const tpl = document.createElement("template");
+    tpl.innerHTML = html;
+    return tpl.content;
+  }
+
+  function canonicalFragment(frag: ParentNode): string[] {
+    const out: string[] = [];
+    for (const child of Array.from(frag.childNodes))
+      canonicalNode(child, 0, out);
+    return out;
+  }
+
+  function canonical(html: string): string[] {
+    return canonicalFragment(parse(html));
+  }
+
+  function pathOf(el: Element, root: ParentNode): number[] {
+    const path: number[] = [];
+    let cur: Element | null = el;
+    while (cur && cur.parentNode && cur !== root) {
+      path.unshift(Array.from(cur.parentNode.children).indexOf(cur));
+      if (cur.parentNode === root) break;
+      cur = cur.parentElement;
+    }
+    return path;
+  }
+
+  function atPath(root: ParentNode, path: number[]): Element | null {
+    let cur: ParentNode | null = root;
+    for (const i of path) {
+      cur = (cur?.children[i] as Element | undefined) ?? null;
+      if (!cur) return null;
+    }
+    return cur as Element | null;
+  }
+
+  function canonicalOutside(
+    stored: string,
+    saved: string,
+    target: { tag: string; text: string; occurrence: number },
+  ): CanonicalPair {
+    const a = parse(stored);
+    const b = parse(saved);
+    const want = strip(target.text);
+    const matches = Array.from(a.querySelectorAll(target.tag)).filter(
+      (el) => strip(el.textContent) === want,
+    );
+    const el = matches[target.occurrence] ?? matches[0];
+    if (!el)
+      return {
+        stored: canonical(stored),
+        saved: canonical(saved),
+        found: false,
+      };
+    const path = pathOf(el, a);
+    const other = atPath(b, path);
+    // Enter in a list item adds sibling items right after the edited one;
+    // they belong to the edit, not to "everything else".
+    const extra =
+      other && other.parentNode && el.parentNode
+        ? Math.max(
+            0,
+            other.parentNode.children.length - el.parentNode.children.length,
+          )
+        : 0;
+    const placeholder = () => document.createElement("edited-element");
+    el.replaceWith(placeholder());
+    if (other) {
+      for (let i = 0; i < extra; i++) other.nextElementSibling?.remove();
+      other.replaceWith(placeholder());
+    }
+    return {
+      stored: canonicalFragment(a),
+      saved: canonicalFragment(b),
+      found: !!other,
+    };
+  }
+
+  const writeStacks: string[] = [];
+  const KEEPALIVE_WRITES = "edit-fidelity:keepalive-writes";
+  const nativeFetch = window.fetch;
+  window.fetch = function (input: RequestInfo | URL, init?: RequestInit) {
+    const url =
+      input instanceof Request ? input.url : new URL(input, location.href).href;
+    const method = (
+      init?.method ?? (input instanceof Request ? input.method : "GET")
+    ).toUpperCase();
+    const action =
+      method === "POST" || method === "PUT"
+        ? /\/_agent-native\/actions\/(patch-deck|save-deck|update-slide)\b/.exec(
+            url,
+          )?.[1]
+        : undefined;
+    if (action) {
+      writeStacks.push(new Error().stack ?? "");
+      // Slides sends these on pagehide, and Playwright's request events never
+      // report them; the bodies survive the reload in sessionStorage.
+      if (init?.keepalive || (input instanceof Request && input.keepalive)) {
+        const sent: KeepaliveWrite[] = JSON.parse(
+          sessionStorage.getItem(KEEPALIVE_WRITES) ?? "[]",
+        );
+        sent.push({
+          action,
+          body: typeof init?.body === "string" ? init.body : null,
+        });
+        sessionStorage.setItem(KEEPALIVE_WRITES, JSON.stringify(sent));
+      }
+    }
+    return nativeFetch.call(this, input, init);
+  };
+  const takeWriteStacks = () => writeStacks.splice(0);
+  const takeKeepaliveWrites = (): KeepaliveWrite[] => {
+    const sent = JSON.parse(sessionStorage.getItem(KEEPALIVE_WRITES) ?? "[]");
+    sessionStorage.removeItem(KEEPALIVE_WRITES);
+    return sent;
+  };
+
+  window.__editFidelity = {
+    listTargets,
+    targetSourceHtml,
+    takeWriteStacks,
+    takeKeepaliveWrites,
+    snapshot,
+    outsideSnapshot,
+    editorState,
+    entryCaretProblem,
+    backgroundPoint,
+    customStyleProperties: customPropertiesFor,
+    canonical,
+    canonicalOutside,
+  };
+}