Skip to content

Write HTML. Render video. Built for agents.

12.7 KB
Raw Blame
/**
 * Bounded RFC 6902 patch applier — handles only the path patterns emitted by mutate.ts.
 *
 * Not a general-purpose JSON Patch implementation. Translates the well-defined path
 * grammar back into DOM mutations. Used by applyPatches() for host undo (T3 mode).
 *
 * Supports only the emit subset (add/remove/replace) — move/copy/test ops and
 * unknown paths are silently ignored, matching the JsonPatchOp contract.
 */

import type { JsonPatchOp, OverrideSet } from "../types.js";
import type { ParsedDocument } from "./model.js";
import {
  findById,
  findRoot,
  declarationElement,
  setElementStyles,
  setOwnText,
  setGsapScript,
  setStyleSheet,
} from "./model.js";
import { keyToPath, stylePath } from "./patches.js";
import {
  writeVariableDefault,
  clearVariableDefault,
  writeVariableDeclaration,
  removeVariableDeclarationEntry,
} from "./variableModel.js";

function isRawDeclarationEntry(value: unknown): value is { id: string } & Record<string, unknown> {
  return (
    typeof value === "object" &&
    value !== null &&
    !Array.isArray(value) &&
    typeof (value as { id?: unknown }).id === "string"
  );
}

// ─── Path parser ────────────────────────────────────────────────────────────

interface ParsedPath {
  type:
    | "style"
    | "text"
    | "attribute"
    | "timing"
    | "hold"
    | "element"
    | "variable"
    | "variableDeclaration"
    | "metadata"
    | "script"
    | "stylesheet";
  id?: string;
  prop?: string;
  field?: string;
}

// fallow-ignore-next-line complexity
function parsePath(path: string): ParsedPath | null {
  const styleM = /^\/elements\/([^/]+)\/inlineStyles\/(.+)$/.exec(path);
  if (styleM) return { type: "style", id: styleM[1], prop: styleM[2] };

  const textM = /^\/elements\/([^/]+)\/text$/.exec(path);
  if (textM) return { type: "text", id: textM[1] };

  const attrM = /^\/elements\/([^/]+)\/attributes\/(.+)$/.exec(path);
  if (attrM)
    return {
      type: "attribute",
      id: attrM[1],
      prop: attrM[2]?.replace(/~1/g, "/").replace(/~0/g, "~"),
    };

  const timingM = /^\/elements\/([^/]+)\/timing\/(.+)$/.exec(path);
  if (timingM) return { type: "timing", id: timingM[1], field: timingM[2] };

  const holdM = /^\/elements\/([^/]+)\/hold\/(.+)$/.exec(path);
  if (holdM) return { type: "hold", id: holdM[1], field: holdM[2] };

  const elemM = /^\/elements\/([^/]+)$/.exec(path);
  if (elemM) return { type: "element", id: elemM[1] };

  const varDeclM = /^\/variableDeclarations\/(.+)$/.exec(path);
  if (varDeclM) return { type: "variableDeclaration", id: varDeclM[1] };

  const varM = /^\/variables\/(.+)$/.exec(path);
  if (varM) return { type: "variable", id: varM[1] };

  const metaM = /^\/metadata\/(.+)$/.exec(path);
  if (metaM) return { type: "metadata", field: metaM[1] };

  if (path === "/script/gsap") return { type: "script" };
  if (path === "/style/css") return { type: "stylesheet" };

  return null;
}

// ─── Variable JSON model helper ───────────────────────────────────────────────

/**
 * Apply a variable patch to `data-composition-variables`. A remove op (null)
 * deletes the declaration's `default` key, restoring its "no authored default"
 * state — the exact inverse of a first-set that added a default to a
 * default-less variable, so undo of such a set round-trips. A value op upserts
 * the matching declaration's `default`. No-ops when the attr/decl is absent.
 * Shares the model logic with mutate.ts via ./variableModel.ts.
 */
function applyVariableDefault(declEl: Element | null, id: string, newDefault: unknown): void {
  if (newDefault === null) {
    clearVariableDefault(declEl, id);
  } else {
    writeVariableDefault(declEl, id, newDefault);
  }
}

// ─── Patch application ───────────────────────────────────────────────────────

/**
 * Replay a stored override-set onto a freshly-parsed base document (T3 init).
 * A null value means the property was explicitly deleted — emit a remove patch
 * so the base document matches the session state. (Removing a non-existent
 * property is a no-op in applyOne, so this is safe against fresh-base misses.)
 */
export function applyOverrideSet(parsed: ParsedDocument, overrides: OverrideSet): void {
  const patches: JsonPatchOp[] = [];
  const rootId = findRoot(parsed.document)?.getAttribute("data-hf-id") ?? null;
  // Whole-declaration snapshots (varDecl.{id}) must replay BEFORE value keys
  // (var.{id}): a declaration snapshot embeds the default at fold time, while
  // var.{id} always carries the latest value — insertion order alone would let
  // an older snapshot clobber a newer value.
  const entries = Object.entries(overrides).sort(([a], [b]) => {
    const aVar = a.startsWith("var.");
    const bVar = b.startsWith("var.");
    const aDecl = a.startsWith("varDecl.");
    const bDecl = b.startsWith("varDecl.");
    if (aVar && bDecl) return 1;
    if (aDecl && bVar) return -1;
    return 0; // stable — every other key keeps its insertion order
  });
  for (const [key, value] of entries) {
    const path = keyToPath(key);
    if (!path) continue;
    if (value === null) {
      patches.push({ op: "remove", path });
    } else {
      patches.push({ op: "replace", path, value });
    }
    // A scalar `var.{id}` override must also restore the `--{id}` CSS custom
    // prop on the root. Current sessions persist a paired style override, but
    // sets written before the model/CSS split only carry `var.{id}`; derive the
    // CSS here so `var(--{id})` bindings rehydrate. Object (font/image) values
    // are never CSS, so they are skipped.
    if (rootId && key.startsWith("var.") && value !== null && typeof value !== "object") {
      const cssPath = stylePath(rootId, `--${key.slice("var.".length)}`);
      patches.push({ op: "replace", path: cssPath, value: String(value) });
    } else if (rootId && key.startsWith("var.") && value === null) {
      patches.push({ op: "remove", path: stylePath(rootId, `--${key.slice("var.".length)}`) });
    }
  }
  applyPatchesToDocument(parsed, patches);
}

export function applyPatchesToDocument(
  parsed: ParsedDocument,
  patches: readonly JsonPatchOp[],
): void {
  for (const patch of patches) {
    const p = parsePath(patch.path);
    if (!p) continue;
    if (p.id && patch.path.startsWith("/elements/")) {
      p.id = p.id.replace(/~1/g, "/").replace(/~0/g, "~");
    }
    applyOne(parsed, patch, p);
  }
}

// fallow-ignore-next-line complexity
function applyOne(parsed: ParsedDocument, patch: JsonPatchOp, p: ParsedPath): void {
  switch (p.type) {
    case "style": {
      const el = p.id ? findById(parsed.document, p.id) : null;
      if (!el || !p.prop) return;
      if (patch.op === "remove") {
        setElementStyles(el, { [p.prop]: null });
      } else {
        setElementStyles(el, { [p.prop]: String(patch.value) });
      }
      break;
    }

    case "text": {
      const el = p.id ? findById(parsed.document, p.id) : null;
      if (!el) return;
      if (patch.op === "remove") {
        setOwnText(el, "");
      } else {
        setOwnText(el, String(patch.value ?? ""));
      }
      break;
    }

    case "attribute": {
      const el = p.id ? findById(parsed.document, p.id) : null;
      if (!el || !p.prop) return;
      if (patch.op === "remove") {
        el.removeAttribute(p.prop);
      } else {
        el.setAttribute(p.prop, String(patch.value ?? ""));
      }
      break;
    }

    case "timing": {
      const el = p.id ? findById(parsed.document, p.id) : null;
      if (!el || !p.field) return;
      if (p.field === "start") {
        if (patch.op === "remove") el.removeAttribute("data-start");
        else el.setAttribute("data-start", String(patch.value));
      } else if (p.field === "duration") {
        // Patch value is the data-duration value — set directly.
        if (patch.op === "remove") el.removeAttribute("data-duration");
        else el.setAttribute("data-duration", String(patch.value));
      } else if (p.field === "end") {
        // Patch value is the absolute data-end time — set directly, no re-derivation.
        if (patch.op === "remove") el.removeAttribute("data-end");
        else el.setAttribute("data-end", String(patch.value));
      } else if (p.field === "trackIndex") {
        if (patch.op === "remove") el.removeAttribute("data-track-index");
        else el.setAttribute("data-track-index", String(patch.value));
      }
      break;
    }

    case "hold": {
      const el = p.id ? findById(parsed.document, p.id) : null;
      if (!el || !p.field) return;
      const attrName = `data-hold-${p.field}`;
      if (patch.op === "remove") el.removeAttribute(attrName);
      else el.setAttribute(attrName, String(patch.value));
      break;
    }

    case "element": {
      if (!p.id) return;
      if (patch.op === "remove") {
        const el = findById(parsed.document, p.id);
        el?.remove();
      } else if (patch.op === "add" && patch.value) {
        const v = patch.value as { html: string; parentId: string | null; siblingIndex: number };
        const parent = v.parentId
          ? findById(parsed.document, v.parentId)
          : ((parsed.document as unknown as { body: Element }).body as unknown as Element);
        if (!parent) return;
        // Parse within the target document to avoid cross-document node issues.
        const tmp = parsed.document.createElement("div");
        tmp.innerHTML = v.html;
        const node = tmp.firstElementChild;
        if (!node) return;
        const children = Array.from(parent.children);
        const ref = children[v.siblingIndex] ?? null;
        parent.insertBefore(node, ref);
      }
      break;
    }

    case "variableDeclaration": {
      if (!p.id) return;
      if (patch.op === "remove") {
        removeVariableDeclarationEntry(
          declarationElement(parsed.document, parsed.wrapped, p.id),
          p.id,
        );
      } else if (isRawDeclarationEntry(patch.value)) {
        // Replay is faithful, not strict: inverse patches capture raw entries
        // (loose hand-authored declarations included) and undo must restore
        // them verbatim — gating on isCompositionVariable here would make
        // undo of a remove/update on a loose entry silently no-op.
        writeVariableDeclaration(
          declarationElement(parsed.document, parsed.wrapped, p.id),
          patch.value,
        );
      }
      break;
    }

    case "variable": {
      if (!p.id) return;
      // B1: update the JSON model (data-composition-variables) so
      // getVariables() returns the correct value in both preview and render.
      // CSS compat is handled by explicit style-path patches emitted by mutate.ts,
      // so we do NOT write CSS here — the style case above handles those patches.
      applyVariableDefault(
        declarationElement(parsed.document, parsed.wrapped, p.id),
        p.id,
        patch.op === "remove" ? null : patch.value,
      );
      break;
    }

    case "script": {
      if (patch.op === "remove") {
        setGsapScript(parsed.document, "");
      } else {
        setGsapScript(parsed.document, String(patch.value ?? ""));
      }
      break;
    }

    case "stylesheet": {
      if (patch.op === "remove") {
        setStyleSheet(parsed.document, "");
      } else {
        setStyleSheet(parsed.document, String(patch.value ?? ""));
      }
      break;
    }

    case "metadata": {
      const root = findRoot(parsed.document);
      if (!root || !p.field) return;
      // Mirror mutate.ts: style always written; the data-* forced-override
      // attribute is updated only when the composition already carries it.
      if (p.field === "width") {
        if (patch.op === "remove") {
          setElementStyles(root, { width: null });
          root.removeAttribute("data-width");
        } else {
          setElementStyles(root, { width: `${patch.value}px` });
          if (root.hasAttribute("data-width")) root.setAttribute("data-width", String(patch.value));
        }
      } else if (p.field === "height") {
        if (patch.op === "remove") {
          setElementStyles(root, { height: null });
          root.removeAttribute("data-height");
        } else {
          setElementStyles(root, { height: `${patch.value}px` });
          if (root.hasAttribute("data-height")) {
            root.setAttribute("data-height", String(patch.value));
          }
        }
      } else if (p.field === "duration") {
        if (patch.op === "remove") root.removeAttribute("data-duration");
        else root.setAttribute("data-duration", String(patch.value));
      }
      break;
    }
  }
}