@ascribed/review 0.2.0 → 0.2.1-next.11

package/README.md

@@ -32,11 +32,11 @@ Each changed block gets a label (Added, Changed, Removed, Moved) and a bar in th
 
 The blocks are found by their anchors: the element with exactly a change's anchor, or, when there's none (a paragraph in a tight list item has no element of its own), the smallest anchored element with the same file and includes whose lines contain it.
 
-The colors are the `--ascribe-review-*` custom properties at the top of `marks.css`, with light and dark values.
+The colors are the `--ascribe-review-*` custom properties at the top of `marks.css`, with light and dark values. Their names don't change; their defaults are Ascribe's design tokens, shared with `@ascribed/elements`, and a release may change them, noting it in the changelog.
 
 ## The static report
 
-`src/report/` is the script of `ascribe diff --format html`'s report, which draws the list of changed pages and each page with its marks. It isn't an entry point: `pnpm --filter @ascribed/review embed` bundles it with the marks and `@ascribed/elements` into `crates/tessera-diff/src/html/`, where the binary embeds it, along with one stylesheet made of the element library's, `marks.css`, and `src/report/report.css`. It also writes the script's SHA-256 beside it, which the report's content security policy names as the one script allowed to run. Run it after changing any of them; `test/embedded.test.ts` fails until you do.
+`src/report/` is the script of `ascribe diff --format html`'s report, which draws the list of changed pages and each page with its marks. It isn't an entry point: `pnpm --filter @ascribed/review embed` bundles it with the marks and `@ascribed/elements` into `crates/ascribe-diff/src/html/`, where the binary embeds it, along with one stylesheet made of the element library's, `marks.css`, and `src/report/report.css`. It also writes the script's SHA-256 beside it, which the report's content security policy names as the one script allowed to run. Run it after changing any of them; `test/embedded.test.ts` fails until you do.
 
 ## `@ascribed/review/overlay`
 

package/dist/github/requests.d.ts

@@ -1,4 +1,5 @@
 import type { PageRef } from "../place/place.js";
+import type { FormattedPiece } from "../shapes.js";
 import type { PullRequestInfo, ReviewSession } from "./session.js";
 /** The overlay's requests, one per `OverlayHost` method that reads or writes threads. */
 export type OverlayMethod = "load" | "commentTarget" | "comment" | "reply" | "allThreads" | "resolve" | "submit" | "discard";
@@ -9,6 +10,8 @@ export interface ChangedPageRef {
     status: "added" | "removed" | "changed";
     because: readonly string[];
     title?: string | null;
+    /** The title formatted, when its field sets `inline = "code"`. */
+    formatted_title?: readonly FormattedPiece[] | null;
 }
 /** What answering a request needs. */
 export interface RequestContext {
@@ -48,6 +51,7 @@ export declare function answerRequest(context: RequestContext, method: OverlayMe
 export declare function pagesShowing(file: string, pages: readonly ChangedPageRef[]): {
     path: string;
     title: string | null;
+    formatted_title: FormattedPiece[] | null;
 }[];
 /**
  * The git revision to compare with for a pull request's base: the remote

package/dist/github/requests.js

@@ -211,7 +211,11 @@ export function pagesShowing(file, pages) {
         .filter((page) => page.status !== "removed")
         .filter((page) => page.path === file || page.because.includes(file))
         .sort((a, b) => Number(b.path === file) - Number(a.path === file))
-        .map((page) => ({ path: page.path, title: page.title ?? null }));
+        .map((page) => ({
+        path: page.path,
+        title: page.title ?? null,
+        formatted_title: page.formatted_title ? [...page.formatted_title] : null,
+    }));
 }
 /**
  * The git revision to compare with for a pull request's base: the remote

package/dist/github/requests.js.map

@@ -1 +1 @@
-{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/github/requests.ts"],"names":[],"mappings":"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","sourcesContent":["// Answering the overlay's requests (`OverlayHost`) from a review session, for\n// a host that keeps GitHub to itself and passes the overlay's requests on as\n// messages: the page preview's extension, or the site preview's dev server.\n// The parameters arrive as untyped messages, so each is checked here.\nimport { anchorKey, parseSource, type Anchor } from \"../place/anchor.js\";\nimport { lineHunks, shiftLine, type Hunk, type Sides } from \"../place/lines.js\";\nimport type { PageRef, PlacedThreads } from \"../place/place.js\";\nimport { ReviewError } from \"../shared/errors.js\";\nimport { gitMaybe } from \"../shared/git.js\";\nimport { parseRemote } from \"./repository.js\";\nimport type { PullRequestInfo, ReviewEvent, ReviewSession } from \"./session.js\";\n\n/** The overlay's requests, one per `OverlayHost` method that reads or writes threads. */\nexport type OverlayMethod =\n  \"load\" | \"commentTarget\" | \"comment\" | \"reply\" | \"allThreads\" | \"resolve\" | \"submit\" | \"discard\";\n\nexport const OVERLAY_METHODS: readonly OverlayMethod[] = [\n  \"load\",\n  \"commentTarget\",\n  \"comment\",\n  \"reply\",\n  \"allThreads\",\n  \"resolve\",\n  \"submit\",\n  \"discard\",\n];\n\n/** A changed page as `ascribe diff` lists it, with its title when the host knows it. */\nexport interface ChangedPageRef {\n  path: string;\n  status: \"added\" | \"removed\" | \"changed\";\n  because: readonly string[];\n  title?: string | null;\n}\n\n/** What answering a request needs. */\nexport interface RequestContext {\n  session: ReviewSession;\n  /** The page the overlay is on: its build and content path. */\n  page: { build: string; path: string } | undefined;\n  /** The page as the overlay last read it, with its anchors: comments are made on it. */\n  lastPage: PageRef | undefined;\n  /** The changed pages, for which pages show a thread. */\n  changedPages(): Promise<readonly ChangedPageRef[]>;\n  /**\n   * For a host whose pages are rendered from an editor's unsaved text: a\n   * file's text on disk (`saved`) and in the editor (`current`), by content\n   * path, or `undefined` when they're the same. The session counts lines on\n   * disk, so the page's blocks are moved to their lines there, and back.\n   */\n  unsaved?(path: string): Promise<{ saved: string; current: string } | undefined>;\n}\n\n/** An answer: the result, the page read (for `load`), and whether the request changed the threads. */\nexport interface Answer {\n  result: unknown;\n  page?: PageRef;\n  changed: boolean;\n}\n\n/** Answers one of the overlay's requests. Rejects with a `ReviewError`. */\nexport async function answerRequest(\n  context: RequestContext,\n  method: OverlayMethod,\n  params: Record<string, unknown>,\n): Promise<Answer> {\n  const { session } = context;\n  switch (method) {\n    case \"load\": {\n      const page = context.page;\n      if (!page) throw new ReviewError(\"not-found\", \"There's no page to review here.\");\n      const shown = anchors(params[\"anchors\"]);\n      const edits = await unsavedEdits(context, shown);\n      // The page's blocks at their lines on disk, and the way back.\n      const back = new Map<string, Anchor>();\n      for (const block of shown) {\n        const saved = toSaved(edits, block, false);\n        if (saved !== undefined && !back.has(anchorKey(saved))) back.set(anchorKey(saved), block);\n      }\n      const ref: PageRef = {\n        build: page.build,\n        path: page.path,\n        anchors: edits.size === 0 ? shown : [...back.keys()].map((key) => fromKey(key)),\n        removed: anchors(params[\"removed\"]),\n      };\n      const [placed, pending, viewer] = await Promise.all([\n        session.threads(ref),\n        session.pending(),\n        session.viewer(),\n      ]);\n      const threads: PlacedThreads =\n        edits.size === 0\n          ? placed\n          : {\n              ...placed,\n              blocks: placed.blocks.map((block) => ({\n                ...block,\n                anchor: back.get(anchorKey(block.anchor)) ?? block.anchor,\n              })),\n            };\n      const pr = session.pullRequest;\n      return {\n        result: { pullRequest: { number: pr.number, url: pr.url }, threads, pending, viewer },\n        page: ref,\n        changed: false,\n      };\n    }\n    case \"commentTarget\": {\n      const shown = anchor(params[\"anchor\"]);\n      const saved = toSaved(await unsavedEdits(context, [shown]), shown, true);\n      if (saved === undefined)\n        return { result: { kind: \"push-first\", message: UNSAVED }, changed: false };\n      return { result: await session.commentTarget(saved), changed: false };\n    }\n    case \"allThreads\": {\n      const [threads, pages] = await Promise.all([\n        session.allThreads(),\n        context.changedPages().catch(() => []),\n      ]);\n      return {\n        result: threads.map((thread) => ({ thread, pages: pagesShowing(thread.path, pages) })),\n        changed: false,\n      };\n    }\n    case \"comment\": {\n      const shown = anchor(params[\"anchor\"]);\n      const target = toSaved(await unsavedEdits(context, [shown]), shown, true);\n      if (target === undefined) throw new ReviewError(\"push-first\", UNSAVED);\n      const page = context.lastPage ?? {\n        build: context.page?.build ?? \"\",\n        path: context.page?.path ?? \"\",\n        anchors: [target],\n      };\n      const quote = typeof params[\"quote\"] === \"string\" ? params[\"quote\"] : undefined;\n      return {\n        result: await session.comment(target, text(params[\"body\"]), page, quote),\n        changed: true,\n      };\n    }\n    case \"reply\":\n      return {\n        result: await session.reply(\n          text(params[\"threadId\"]),\n          text(params[\"body\"]),\n          params[\"when\"] === \"now\" ? \"now\" : \"withReview\",\n        ),\n        changed: true,\n      };\n    case \"resolve\":\n      await session.resolve(text(params[\"threadId\"]), params[\"resolved\"] === true);\n      return { result: null, changed: true };\n    case \"submit\": {\n      const body = typeof params[\"body\"] === \"string\" ? params[\"body\"] : undefined;\n      await session.submit(event(params[\"event\"]), body);\n      return { result: null, changed: true };\n    }\n    case \"discard\":\n      await session.discard();\n      return { result: null, changed: true };\n  }\n}\n\n/** A file's unsaved edits: the line changes from the editor's text to the text on disk. */\ninterface Edit {\n  hunks: Hunk[];\n  sides: Sides;\n}\n\nconst UNSAVED = \"This block has changes that aren't saved. Save the file, then comment.\";\n\n/** The line changes from each shown file's text in the editor to its text on disk, where they differ. */\nasync function unsavedEdits(\n  context: RequestContext,\n  shown: readonly Anchor[],\n): Promise<Map<string, Edit>> {\n  const edits = new Map<string, Edit>();\n  if (!context.unsaved) return edits;\n  const files = new Set<string>();\n  for (const block of shown) {\n    const range = parseSource(block.source);\n    if (range) files.add(range.path);\n    for (const include of block.via) {\n      const at = parseInclude(include);\n      if (at) files.add(at.path);\n    }\n  }\n  for (const file of files) {\n    const text = await context.unsaved(file);\n    if (text === undefined) continue;\n    const hunks = lineHunks(text.current, text.saved);\n    if (hunks.length > 0) {\n      edits.set(file, {\n        hunks,\n        sides: { old: text.current.split(/\\r?\\n/), new: text.saved.split(/\\r?\\n/) },\n      });\n    }\n  }\n  return edits;\n}\n\n/**\n * A block's anchor with its lines on disk. `strict` (for commenting) wants\n * every line of the block saved as it is; otherwise an edited block takes\n * the lines its text has on disk. `undefined` when nothing of it is saved.\n */\nfunction toSaved(\n  edits: ReadonlyMap<string, Edit>,\n  block: Anchor,\n  strict: boolean,\n): Anchor | undefined {\n  if (edits.size === 0) return block;\n  const range = parseSource(block.source);\n  if (range === undefined) return block;\n  const edit = edits.get(range.path);\n  let source = block.source;\n  if (edit !== undefined) {\n    const lines: number[] = [];\n    for (let line = range.first; line <= range.last; line++) {\n      const moved = shiftLine(edit.hunks, line, edit.sides);\n      if (moved === undefined || moved.replaced) {\n        if (strict) return undefined;\n        if (moved === undefined) continue;\n      }\n      lines.push(moved.line);\n    }\n    if (lines.length === 0) return undefined;\n    const colon = block.source.lastIndexOf(\":\");\n    source = `${block.source.slice(0, colon)}:${Math.min(...lines)}-${Math.max(...lines)}`;\n  }\n  const via: string[] = [];\n  for (const include of block.via) {\n    const at = parseInclude(include);\n    const includeEdit = at && edits.get(at.path);\n    if (!at || !includeEdit) {\n      via.push(include);\n      continue;\n    }\n    const moved = shiftLine(includeEdit.hunks, at.line, includeEdit.sides);\n    if (moved === undefined || (strict && moved.replaced)) return undefined;\n    via.push(`${include.slice(0, include.lastIndexOf(\":\"))}:${moved.line}`);\n  }\n  return { source, via };\n}\n\n/** An include, `<path>:<line>`, parsed, with its path decoded. */\nfunction parseInclude(include: string): { path: string; line: number } | undefined {\n  const colon = include.lastIndexOf(\":\");\n  const line = Number(include.slice(colon + 1));\n  if (colon <= 0 || !Number.isInteger(line) || line < 1) return undefined;\n  const range = parseSource(`${include.slice(0, colon)}:1-1`);\n  return range && { path: range.path, line };\n}\n\n/** The anchor `anchorKey` wrote. */\nfunction fromKey(key: string): Anchor {\n  const [source = \"\", ...via] = key.split(\" \");\n  return { source, via };\n}\n\n/**\n * The changed pages that show a file (a content path): the file's own page,\n * and the pages that changed through it (an include). `[]` when none does.\n */\nexport function pagesShowing(\n  file: string,\n  pages: readonly ChangedPageRef[],\n): { path: string; title: string | null }[] {\n  return pages\n    .filter((page) => page.status !== \"removed\")\n    .filter((page) => page.path === file || page.because.includes(file))\n    .sort((a, b) => Number(b.path === file) - Number(a.path === file))\n    .map((page) => ({ path: page.path, title: page.title ?? null }));\n}\n\n/**\n * The git revision to compare with for a pull request's base: the remote\n * branch, from the remote whose URL is the pull request's repository, when\n * there is one; else the branch's name.\n */\nexport function pullRequestBase(\n  remotes: readonly { name: string; repository: string | undefined }[],\n  repository: string,\n  baseRefName: string,\n): string {\n  const remote =\n    remotes.find((r) => r.repository === repository && r.name === \"upstream\") ??\n    remotes.find((r) => r.repository === repository && r.name === \"origin\") ??\n    remotes.find((r) => r.repository === repository);\n  return remote ? `${remote.name}/${baseRefName}` : baseRefName;\n}\n\n/**\n * The git revision for the pull request's base in the checkout at `root`:\n * `origin/main` when that remote branch exists, else the branch's name.\n */\nexport async function baseRevision(root: string, pr: PullRequestInfo): Promise<string> {\n  const out = (await gitMaybe(root, [\"remote\", \"-v\"]).catch(() => undefined)) ?? \"\";\n  const remotes = out\n    .split(\"\\n\")\n    .map((line) => /^(\\S+)\\s+(\\S+)\\s+\\(fetch\\)$/.exec(line))\n    .filter((match) => match !== null)\n    .map((match) => {\n      const repository = parseRemote(match[2] ?? \"\");\n      return { name: match[1] ?? \"\", repository: repository && repoKey(repository) };\n    });\n  const revision = pullRequestBase(remotes, repoKey(pr.repository), pr.baseRefName);\n  if (revision !== pr.baseRefName) {\n    const exists = await gitMaybe(root, [\"rev-parse\", \"--verify\", \"--quiet\", revision]).catch(\n      () => undefined,\n    );\n    if (exists !== undefined) return revision;\n  }\n  return pr.baseRefName;\n}\n\nfunction repoKey(repository: { host: string; owner: string; name: string }): string {\n  return `${repository.host}/${repository.owner}/${repository.name}`.toLowerCase();\n}\n\nconst EVENTS: readonly ReviewEvent[] = [\"COMMENT\", \"APPROVE\", \"REQUEST_CHANGES\"];\n\nfunction event(value: unknown): ReviewEvent {\n  if (EVENTS.includes(value as ReviewEvent)) return value as ReviewEvent;\n  throw new ReviewError(\"refused\", `A review can't be submitted as ${String(value)}.`);\n}\n\nfunction text(value: unknown): string {\n  if (typeof value !== \"string\") throw new ReviewError(\"refused\", \"The request is missing text.\");\n  return value;\n}\n\nfunction anchor(value: unknown): Anchor {\n  const record = value as Partial<Anchor> | null;\n  if (typeof record?.source !== \"string\") {\n    throw new ReviewError(\"refused\", \"The request is missing a block.\");\n  }\n  const via = Array.isArray(record.via) ? record.via.filter((v) => typeof v === \"string\") : [];\n  return { source: record.source, via };\n}\n\nfunction anchors(value: unknown): Anchor[] {\n  return Array.isArray(value) ? value.map(anchor) : [];\n}\n"]}
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/github/requests.ts"],"names":[],"mappings":"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","sourcesContent":["// Answering the overlay's requests (`OverlayHost`) from a review session, for\n// a host that keeps GitHub to itself and passes the overlay's requests on as\n// messages: the page preview's extension, or the site preview's dev server.\n// The parameters arrive as untyped messages, so each is checked here.\nimport { anchorKey, parseSource, type Anchor } from \"../place/anchor.js\";\nimport { lineHunks, shiftLine, type Hunk, type Sides } from \"../place/lines.js\";\nimport type { PageRef, PlacedThreads } from \"../place/place.js\";\nimport type { FormattedPiece } from \"../shapes.js\";\nimport { ReviewError } from \"../shared/errors.js\";\nimport { gitMaybe } from \"../shared/git.js\";\nimport { parseRemote } from \"./repository.js\";\nimport type { PullRequestInfo, ReviewEvent, ReviewSession } from \"./session.js\";\n\n/** The overlay's requests, one per `OverlayHost` method that reads or writes threads. */\nexport type OverlayMethod =\n  \"load\" | \"commentTarget\" | \"comment\" | \"reply\" | \"allThreads\" | \"resolve\" | \"submit\" | \"discard\";\n\nexport const OVERLAY_METHODS: readonly OverlayMethod[] = [\n  \"load\",\n  \"commentTarget\",\n  \"comment\",\n  \"reply\",\n  \"allThreads\",\n  \"resolve\",\n  \"submit\",\n  \"discard\",\n];\n\n/** A changed page as `ascribe diff` lists it, with its title when the host knows it. */\nexport interface ChangedPageRef {\n  path: string;\n  status: \"added\" | \"removed\" | \"changed\";\n  because: readonly string[];\n  title?: string | null;\n  /** The title formatted, when its field sets `inline = \"code\"`. */\n  formatted_title?: readonly FormattedPiece[] | null;\n}\n\n/** What answering a request needs. */\nexport interface RequestContext {\n  session: ReviewSession;\n  /** The page the overlay is on: its build and content path. */\n  page: { build: string; path: string } | undefined;\n  /** The page as the overlay last read it, with its anchors: comments are made on it. */\n  lastPage: PageRef | undefined;\n  /** The changed pages, for which pages show a thread. */\n  changedPages(): Promise<readonly ChangedPageRef[]>;\n  /**\n   * For a host whose pages are rendered from an editor's unsaved text: a\n   * file's text on disk (`saved`) and in the editor (`current`), by content\n   * path, or `undefined` when they're the same. The session counts lines on\n   * disk, so the page's blocks are moved to their lines there, and back.\n   */\n  unsaved?(path: string): Promise<{ saved: string; current: string } | undefined>;\n}\n\n/** An answer: the result, the page read (for `load`), and whether the request changed the threads. */\nexport interface Answer {\n  result: unknown;\n  page?: PageRef;\n  changed: boolean;\n}\n\n/** Answers one of the overlay's requests. Rejects with a `ReviewError`. */\nexport async function answerRequest(\n  context: RequestContext,\n  method: OverlayMethod,\n  params: Record<string, unknown>,\n): Promise<Answer> {\n  const { session } = context;\n  switch (method) {\n    case \"load\": {\n      const page = context.page;\n      if (!page) throw new ReviewError(\"not-found\", \"There's no page to review here.\");\n      const shown = anchors(params[\"anchors\"]);\n      const edits = await unsavedEdits(context, shown);\n      // The page's blocks at their lines on disk, and the way back.\n      const back = new Map<string, Anchor>();\n      for (const block of shown) {\n        const saved = toSaved(edits, block, false);\n        if (saved !== undefined && !back.has(anchorKey(saved))) back.set(anchorKey(saved), block);\n      }\n      const ref: PageRef = {\n        build: page.build,\n        path: page.path,\n        anchors: edits.size === 0 ? shown : [...back.keys()].map((key) => fromKey(key)),\n        removed: anchors(params[\"removed\"]),\n      };\n      const [placed, pending, viewer] = await Promise.all([\n        session.threads(ref),\n        session.pending(),\n        session.viewer(),\n      ]);\n      const threads: PlacedThreads =\n        edits.size === 0\n          ? placed\n          : {\n              ...placed,\n              blocks: placed.blocks.map((block) => ({\n                ...block,\n                anchor: back.get(anchorKey(block.anchor)) ?? block.anchor,\n              })),\n            };\n      const pr = session.pullRequest;\n      return {\n        result: { pullRequest: { number: pr.number, url: pr.url }, threads, pending, viewer },\n        page: ref,\n        changed: false,\n      };\n    }\n    case \"commentTarget\": {\n      const shown = anchor(params[\"anchor\"]);\n      const saved = toSaved(await unsavedEdits(context, [shown]), shown, true);\n      if (saved === undefined)\n        return { result: { kind: \"push-first\", message: UNSAVED }, changed: false };\n      return { result: await session.commentTarget(saved), changed: false };\n    }\n    case \"allThreads\": {\n      const [threads, pages] = await Promise.all([\n        session.allThreads(),\n        context.changedPages().catch(() => []),\n      ]);\n      return {\n        result: threads.map((thread) => ({ thread, pages: pagesShowing(thread.path, pages) })),\n        changed: false,\n      };\n    }\n    case \"comment\": {\n      const shown = anchor(params[\"anchor\"]);\n      const target = toSaved(await unsavedEdits(context, [shown]), shown, true);\n      if (target === undefined) throw new ReviewError(\"push-first\", UNSAVED);\n      const page = context.lastPage ?? {\n        build: context.page?.build ?? \"\",\n        path: context.page?.path ?? \"\",\n        anchors: [target],\n      };\n      const quote = typeof params[\"quote\"] === \"string\" ? params[\"quote\"] : undefined;\n      return {\n        result: await session.comment(target, text(params[\"body\"]), page, quote),\n        changed: true,\n      };\n    }\n    case \"reply\":\n      return {\n        result: await session.reply(\n          text(params[\"threadId\"]),\n          text(params[\"body\"]),\n          params[\"when\"] === \"now\" ? \"now\" : \"withReview\",\n        ),\n        changed: true,\n      };\n    case \"resolve\":\n      await session.resolve(text(params[\"threadId\"]), params[\"resolved\"] === true);\n      return { result: null, changed: true };\n    case \"submit\": {\n      const body = typeof params[\"body\"] === \"string\" ? params[\"body\"] : undefined;\n      await session.submit(event(params[\"event\"]), body);\n      return { result: null, changed: true };\n    }\n    case \"discard\":\n      await session.discard();\n      return { result: null, changed: true };\n  }\n}\n\n/** A file's unsaved edits: the line changes from the editor's text to the text on disk. */\ninterface Edit {\n  hunks: Hunk[];\n  sides: Sides;\n}\n\nconst UNSAVED = \"This block has changes that aren't saved. Save the file, then comment.\";\n\n/** The line changes from each shown file's text in the editor to its text on disk, where they differ. */\nasync function unsavedEdits(\n  context: RequestContext,\n  shown: readonly Anchor[],\n): Promise<Map<string, Edit>> {\n  const edits = new Map<string, Edit>();\n  if (!context.unsaved) return edits;\n  const files = new Set<string>();\n  for (const block of shown) {\n    const range = parseSource(block.source);\n    if (range) files.add(range.path);\n    for (const include of block.via) {\n      const at = parseInclude(include);\n      if (at) files.add(at.path);\n    }\n  }\n  for (const file of files) {\n    const text = await context.unsaved(file);\n    if (text === undefined) continue;\n    const hunks = lineHunks(text.current, text.saved);\n    if (hunks.length > 0) {\n      edits.set(file, {\n        hunks,\n        sides: { old: text.current.split(/\\r?\\n/), new: text.saved.split(/\\r?\\n/) },\n      });\n    }\n  }\n  return edits;\n}\n\n/**\n * A block's anchor with its lines on disk. `strict` (for commenting) wants\n * every line of the block saved as it is; otherwise an edited block takes\n * the lines its text has on disk. `undefined` when nothing of it is saved.\n */\nfunction toSaved(\n  edits: ReadonlyMap<string, Edit>,\n  block: Anchor,\n  strict: boolean,\n): Anchor | undefined {\n  if (edits.size === 0) return block;\n  const range = parseSource(block.source);\n  if (range === undefined) return block;\n  const edit = edits.get(range.path);\n  let source = block.source;\n  if (edit !== undefined) {\n    const lines: number[] = [];\n    for (let line = range.first; line <= range.last; line++) {\n      const moved = shiftLine(edit.hunks, line, edit.sides);\n      if (moved === undefined || moved.replaced) {\n        if (strict) return undefined;\n        if (moved === undefined) continue;\n      }\n      lines.push(moved.line);\n    }\n    if (lines.length === 0) return undefined;\n    const colon = block.source.lastIndexOf(\":\");\n    source = `${block.source.slice(0, colon)}:${Math.min(...lines)}-${Math.max(...lines)}`;\n  }\n  const via: string[] = [];\n  for (const include of block.via) {\n    const at = parseInclude(include);\n    const includeEdit = at && edits.get(at.path);\n    if (!at || !includeEdit) {\n      via.push(include);\n      continue;\n    }\n    const moved = shiftLine(includeEdit.hunks, at.line, includeEdit.sides);\n    if (moved === undefined || (strict && moved.replaced)) return undefined;\n    via.push(`${include.slice(0, include.lastIndexOf(\":\"))}:${moved.line}`);\n  }\n  return { source, via };\n}\n\n/** An include, `<path>:<line>`, parsed, with its path decoded. */\nfunction parseInclude(include: string): { path: string; line: number } | undefined {\n  const colon = include.lastIndexOf(\":\");\n  const line = Number(include.slice(colon + 1));\n  if (colon <= 0 || !Number.isInteger(line) || line < 1) return undefined;\n  const range = parseSource(`${include.slice(0, colon)}:1-1`);\n  return range && { path: range.path, line };\n}\n\n/** The anchor `anchorKey` wrote. */\nfunction fromKey(key: string): Anchor {\n  const [source = \"\", ...via] = key.split(\" \");\n  return { source, via };\n}\n\n/**\n * The changed pages that show a file (a content path): the file's own page,\n * and the pages that changed through it (an include). `[]` when none does.\n */\nexport function pagesShowing(\n  file: string,\n  pages: readonly ChangedPageRef[],\n): { path: string; title: string | null; formatted_title: FormattedPiece[] | null }[] {\n  return pages\n    .filter((page) => page.status !== \"removed\")\n    .filter((page) => page.path === file || page.because.includes(file))\n    .sort((a, b) => Number(b.path === file) - Number(a.path === file))\n    .map((page) => ({\n      path: page.path,\n      title: page.title ?? null,\n      formatted_title: page.formatted_title ? [...page.formatted_title] : null,\n    }));\n}\n\n/**\n * The git revision to compare with for a pull request's base: the remote\n * branch, from the remote whose URL is the pull request's repository, when\n * there is one; else the branch's name.\n */\nexport function pullRequestBase(\n  remotes: readonly { name: string; repository: string | undefined }[],\n  repository: string,\n  baseRefName: string,\n): string {\n  const remote =\n    remotes.find((r) => r.repository === repository && r.name === \"upstream\") ??\n    remotes.find((r) => r.repository === repository && r.name === \"origin\") ??\n    remotes.find((r) => r.repository === repository);\n  return remote ? `${remote.name}/${baseRefName}` : baseRefName;\n}\n\n/**\n * The git revision for the pull request's base in the checkout at `root`:\n * `origin/main` when that remote branch exists, else the branch's name.\n */\nexport async function baseRevision(root: string, pr: PullRequestInfo): Promise<string> {\n  const out = (await gitMaybe(root, [\"remote\", \"-v\"]).catch(() => undefined)) ?? \"\";\n  const remotes = out\n    .split(\"\\n\")\n    .map((line) => /^(\\S+)\\s+(\\S+)\\s+\\(fetch\\)$/.exec(line))\n    .filter((match) => match !== null)\n    .map((match) => {\n      const repository = parseRemote(match[2] ?? \"\");\n      return { name: match[1] ?? \"\", repository: repository && repoKey(repository) };\n    });\n  const revision = pullRequestBase(remotes, repoKey(pr.repository), pr.baseRefName);\n  if (revision !== pr.baseRefName) {\n    const exists = await gitMaybe(root, [\"rev-parse\", \"--verify\", \"--quiet\", revision]).catch(\n      () => undefined,\n    );\n    if (exists !== undefined) return revision;\n  }\n  return pr.baseRefName;\n}\n\nfunction repoKey(repository: { host: string; owner: string; name: string }): string {\n  return `${repository.host}/${repository.owner}/${repository.name}`.toLowerCase();\n}\n\nconst EVENTS: readonly ReviewEvent[] = [\"COMMENT\", \"APPROVE\", \"REQUEST_CHANGES\"];\n\nfunction event(value: unknown): ReviewEvent {\n  if (EVENTS.includes(value as ReviewEvent)) return value as ReviewEvent;\n  throw new ReviewError(\"refused\", `A review can't be submitted as ${String(value)}.`);\n}\n\nfunction text(value: unknown): string {\n  if (typeof value !== \"string\") throw new ReviewError(\"refused\", \"The request is missing text.\");\n  return value;\n}\n\nfunction anchor(value: unknown): Anchor {\n  const record = value as Partial<Anchor> | null;\n  if (typeof record?.source !== \"string\") {\n    throw new ReviewError(\"refused\", \"The request is missing a block.\");\n  }\n  const via = Array.isArray(record.via) ? record.via.filter((v) => typeof v === \"string\") : [];\n  return { source: record.source, via };\n}\n\nfunction anchors(value: unknown): Anchor[] {\n  return Array.isArray(value) ? value.map(anchor) : [];\n}\n"]}

package/dist/marks/index.d.ts

@@ -1,27 +1,7 @@
-/** Where a block is written: the anchor grammar's `source` and `via`. */
-export interface Anchor {
-    source: string;
-    via: string[];
-}
-/** The words that differ inside a changed block of prose. */
-export interface Words {
-    /** `[start, end)` ranges, in characters, of `now_text`. */
-    now: [number, number][];
-    /** `[start, end)` ranges, in characters, of `was_text`. */
-    was: [number, number][];
-    now_text: string;
-    was_text: string;
-}
-/** One block's change, as `ascribe diff --format json` writes it. */
-export interface Change {
-    kind: "changed" | "added" | "removed" | "moved";
-    now?: Anchor;
-    was?: Anchor;
-    words?: Words;
-    after?: Anchor;
-    parent?: Anchor;
-    text?: string;
-}
+import type { Anchor, Change } from "../shapes.js";
+/** A block's change, where it's written, and its words, as `ascribe diff --format json` writes them. */
+export type { Anchor, Change, Words } from "../shapes.js";
+export { titleNodes, type FormattedPiece, type PieceKind } from "./title.js";
 /** What the page shows: its changes, the page as it will be, or as it was. */
 export type Show = "changes" | "will" | "was";
 export interface MarkOptions {

package/dist/marks/index.js

@@ -1,17 +1,5 @@
-// @ascribed/review/marks: marks what changed on a rendered page, in the
-// browser.
-//
-// The page is Ascribe's site output rendered with source anchors (the
-// site-render contract, §7): every block's element carries
-// `data-ascribe-source`, and `data-ascribe-via` when it came through
-// includes. The changes are `ascribe diff --format json`'s, for that page.
-// `markChanges` applies them to the page's elements; `marks.css` (exported
-// as `@ascribed/review/marks.css`) draws them, and `setShow` switches between
-// the changes, the page as it will be, and the page as it was.
-//
-// Everything the marks add is an element with `data-ascribe-ui`, and every
-// element they change gets `data-ascribe-change`, so `clearMarks` can put the
-// page back as it was rendered.
+import { CLASS_DEL, CLASS_FLASH, CLASS_HINT, CLASS_INS, CLASS_LABEL, CLASS_LABEL_BEFORE, CLASS_MARKS, CLASS_MOVED_FROM, CLASS_MOVE_AFTER, CLASS_MOVE_LINK, CLASS_MOVE_NOTE, CLASS_OPEN, CLASS_REMOVED, CLASS_REMOVED_BODY, CLASS_TOGGLE, CLASS_WAS_COPY, CLASS_WHERE, DATA_CHANGE, DATA_HAS_WAS, DATA_HINT, DATA_LABEL, DATA_MOVE, DATA_SHOW, DATA_SOURCE, DATA_UI, DATA_VIA, DATA_WAS_ONLY, DATA_WAS_SOURCE, ELEMENT_TAB, } from "../names.js";
+export { titleNodes } from "./title.js";
 const LABELS = {
     added: "Added",
     changed: "Changed",
@@ -34,7 +22,7 @@ const LABEL_INSIDE = new Set([
     "td",
     "th",
     // A tab's panel: before it would put the label among the tab list's panels.
-    "ascribe-tab",
+    ELEMENT_TAB,
 ]);
 /** Parses `<path>:<first>-<last>`, splitting at the last `:`. */
 export function parseSource(source) {
@@ -78,7 +66,7 @@ export function describeSource(source, via) {
     return text;
 }
 function viaOf(element) {
-    return element.getAttribute("data-ascribe-via") ?? "";
+    return element.getAttribute(DATA_VIA) ?? "";
 }
 /**
  * The element of a block: the one with exactly its anchor, or, when there's
@@ -88,8 +76,8 @@ function viaOf(element) {
  */
 export function findBlock(root, anchor) {
     const via = anchor.via.join(" ");
-    const anchored = Array.from(root.querySelectorAll("[data-ascribe-source]"));
-    const exact = anchored.find((el) => el.getAttribute("data-ascribe-source") === anchor.source && viaOf(el) === via);
+    const anchored = Array.from(root.querySelectorAll(`[${DATA_SOURCE}]`));
+    const exact = anchored.find((el) => el.getAttribute(DATA_SOURCE) === anchor.source && viaOf(el) === via);
     if (exact)
         return exact;
     const want = parseSource(anchor.source);
@@ -100,7 +88,7 @@ export function findBlock(root, anchor) {
     for (const el of anchored) {
         if (viaOf(el) !== via)
             continue;
-        const has = parseSource(el.getAttribute("data-ascribe-source") ?? "");
+        const has = parseSource(el.getAttribute(DATA_SOURCE) ?? "");
         if (!has || has.path !== want.path)
             continue;
         if (has.first > want.first || has.last < want.last)
@@ -116,7 +104,7 @@ export function findBlock(root, anchor) {
 function ui(doc, tag, className, text) {
     const el = doc.createElement(tag);
     el.className = className;
-    el.setAttribute("data-ascribe-ui", "");
+    el.setAttribute(DATA_UI, "");
     if (text !== undefined)
         el.textContent = text;
     return el;
@@ -124,13 +112,13 @@ function ui(doc, tag, className, text) {
 /** A label, inside the block at its start, or just before it. */
 function addLabel(element, kind) {
     const doc = element.ownerDocument;
-    const label = ui(doc, "span", "ascribe-label", LABELS[kind]);
-    label.setAttribute("data-ascribe-label", kind);
+    const label = ui(doc, "span", CLASS_LABEL, LABELS[kind]);
+    label.setAttribute(DATA_LABEL, kind);
     if (LABEL_INSIDE.has(element.localName)) {
         element.prepend(label);
     }
     else {
-        label.classList.add("ascribe-label-before");
+        label.classList.add(CLASS_LABEL_BEFORE);
         element.before(label);
     }
 }
@@ -148,8 +136,8 @@ function contentOf(holder, before) {
 function copyOf(element) {
     const copy = element.cloneNode(true);
     for (const el of [copy, ...Array.from(copy.querySelectorAll("*"))]) {
-        el.removeAttribute("data-ascribe-source");
-        el.removeAttribute("data-ascribe-via");
+        el.removeAttribute(DATA_SOURCE);
+        el.removeAttribute(DATA_VIA);
         el.removeAttribute("id");
     }
     return copy;
@@ -181,7 +169,7 @@ function ownText(element) {
         for (const child of Array.from(node.childNodes)) {
             if (child.nodeType === Node.TEXT_NODE)
                 text += child.nodeValue ?? "";
-            else if (child instanceof Element && !child.hasAttribute("data-ascribe-ui"))
+            else if (child instanceof Element && !child.hasAttribute(DATA_UI))
                 walk(child);
         }
     };
@@ -205,9 +193,7 @@ class Placer {
             let previous = this.#last.get(after) ?? after;
             // Past what the marks put after the block itself: its copy as it
             // was, or its "moved from" link.
-            for (let next = previous.nextElementSibling; next &&
-                (next.hasAttribute("data-ascribe-was-only") ||
-                    next.classList.contains("ascribe-move-after")); next = next.nextElementSibling) {
+            for (let next = previous.nextElementSibling; next && (next.hasAttribute(DATA_WAS_ONLY) || next.classList.contains(CLASS_MOVE_AFTER)); next = next.nextElementSibling) {
                 previous = next;
             }
             const el = make(after.parentElement);
@@ -226,7 +212,7 @@ class Placer {
         else {
             // First among the container's blocks: before its first anchored
             // child, or its first label, or at its end.
-            const first = Array.from(container.children).find((c) => c.hasAttribute("data-ascribe-source") || c.hasAttribute("data-ascribe-ui"));
+            const first = Array.from(container.children).find((c) => c.hasAttribute(DATA_SOURCE) || c.hasAttribute(DATA_UI));
             if (first)
                 first.before(el);
             else
@@ -270,8 +256,8 @@ function textMap(element) {
                 }
             }
             else if (child instanceof Element &&
-                !child.hasAttribute("data-ascribe-ui") &&
-                !child.hasAttribute("data-ascribe-source")) {
+                !child.hasAttribute(DATA_UI) &&
+                !child.hasAttribute(DATA_SOURCE)) {
                 walk(child);
             }
         }
@@ -342,10 +328,10 @@ function markWords(element, words) {
     edits.sort((a, b) => b.at - a.at || (a.kind === "del" ? -1 : 1));
     for (const edit of edits) {
         if (edit.kind === "ins") {
-            wrapRange(map, offset + edit.at, offset + edit.end, () => ui(doc, "ins", "ascribe-ins"));
+            wrapRange(map, offset + edit.at, offset + edit.end, () => ui(doc, "ins", CLASS_INS));
         }
         else {
-            const del = ui(doc, "del", "ascribe-del", edit.text);
+            const del = ui(doc, "del", CLASS_DEL, edit.text);
             insertAt(map, offset + edit.at, del, element);
         }
     }
@@ -407,33 +393,33 @@ export function markChanges(root, changes, options = {}) {
     const was = options.was ?? null;
     const placer = new Placer(root);
     const marks = [];
-    root.classList.add("ascribe-marks");
-    if (!root.hasAttribute("data-ascribe-show"))
-        root.setAttribute("data-ascribe-show", "changes");
+    root.classList.add(CLASS_MARKS);
+    if (!root.hasAttribute(DATA_SHOW))
+        root.setAttribute(DATA_SHOW, "changes");
     let moveCount = 0;
     for (const change of changes) {
         switch (change.kind) {
             case "added":
             case "changed": {
                 const element = change.now ? findBlock(root, change.now) : null;
-                if (!element || element.hasAttribute("data-ascribe-change"))
+                if (!element || element.hasAttribute(DATA_CHANGE))
                     break;
-                element.setAttribute("data-ascribe-change", change.kind);
+                element.setAttribute(DATA_CHANGE, change.kind);
                 addLabel(element, change.kind);
                 if (change.kind === "changed") {
                     // Where it was, for threads on its old text.
                     if (change.was)
-                        element.setAttribute("data-ascribe-was-source", change.was.source);
+                        element.setAttribute(DATA_WAS_SOURCE, change.was.source);
                     const before = was && change.was ? findBlock(was, change.was) : null;
                     if (change.words)
                         markWords(element, change.words);
                     if (before) {
                         // As it was, the block as the old page rendered it.
                         const copy = copyOf(before);
-                        copy.setAttribute("data-ascribe-ui", "");
-                        copy.setAttribute("data-ascribe-was-only", "");
+                        copy.setAttribute(DATA_UI, "");
+                        copy.setAttribute(DATA_WAS_ONLY, "");
                         element.after(copy);
-                        element.setAttribute("data-ascribe-has-was", "");
+                        element.setAttribute(DATA_HAS_WAS, "");
                     }
                 }
                 marks.push({ change, element });
@@ -442,23 +428,23 @@ export function markChanges(root, changes, options = {}) {
             case "removed": {
                 const before = was && change.was ? findBlock(was, change.was) : null;
                 const element = placer.place(change, (container) => {
-                    const holder = ui(doc, holderFor(container), "ascribe-removed");
-                    holder.setAttribute("data-ascribe-change", "removed");
+                    const holder = ui(doc, holderFor(container), CLASS_REMOVED);
+                    holder.setAttribute(DATA_CHANGE, "removed");
                     if (change.was)
-                        holder.setAttribute("data-ascribe-was-source", change.was.source);
-                    const label = ui(doc, "span", "ascribe-label", LABELS.removed);
-                    label.setAttribute("data-ascribe-label", "removed");
-                    const body = ui(doc, "div", "ascribe-removed-body");
+                        holder.setAttribute(DATA_WAS_SOURCE, change.was.source);
+                    const label = ui(doc, "span", CLASS_LABEL, LABELS.removed);
+                    label.setAttribute(DATA_LABEL, "removed");
+                    const body = ui(doc, "div", CLASS_REMOVED_BODY);
                     if (before)
                         body.append(...contentOf(holder, before));
                     else
                         body.textContent = change.text ?? "";
-                    const toggle = ui(doc, "button", "ascribe-toggle", "Show");
+                    const toggle = ui(doc, "button", CLASS_TOGGLE, "Show");
                     toggle.type = "button";
                     toggle.setAttribute("aria-expanded", "false");
                     toggle.addEventListener("click", (event) => {
                         event.stopPropagation();
-                        const open = holder.classList.toggle("ascribe-open");
+                        const open = holder.classList.toggle(CLASS_OPEN);
                         toggle.textContent = open ? "Collapse" : "Show";
                         toggle.setAttribute("aria-expanded", String(open));
                     });
@@ -470,25 +456,25 @@ export function markChanges(root, changes, options = {}) {
             }
             case "moved": {
                 const element = change.now ? findBlock(root, change.now) : null;
-                if (!element || element.hasAttribute("data-ascribe-change"))
+                if (!element || element.hasAttribute(DATA_CHANGE))
                     break;
                 const id = `ascribe-move-${++moveCount}`;
                 const before = was && change.was ? findBlock(was, change.was) : null;
                 const stub = placer.place(change, (container) => {
-                    const holder = ui(doc, holderFor(container), "ascribe-moved-from");
+                    const holder = ui(doc, holderFor(container), CLASS_MOVED_FROM);
                     holder.id = `${id}-from`;
-                    holder.setAttribute("data-ascribe-change", "moved-from");
+                    holder.setAttribute(DATA_CHANGE, "moved-from");
                     if (change.was)
-                        holder.setAttribute("data-ascribe-was-source", change.was.source);
-                    const note = ui(doc, "span", "ascribe-move-note");
+                        holder.setAttribute(DATA_WAS_SOURCE, change.was.source);
+                    const note = ui(doc, "span", CLASS_MOVE_NOTE);
                     note.append(doc.createTextNode(`A ${blockWord(element)} moved from here `));
-                    const link = ui(doc, "a", "ascribe-move-link");
+                    const link = ui(doc, "a", CLASS_MOVE_LINK);
                     link.href = `#${id}`;
                     note.append(link);
                     holder.append(note);
                     // As it was, the block itself.
-                    const copy = ui(doc, "div", "ascribe-was-copy");
-                    copy.setAttribute("data-ascribe-was-only", "");
+                    const copy = ui(doc, "div", CLASS_WAS_COPY);
+                    copy.setAttribute(DATA_WAS_ONLY, "");
                     if (before)
                         copy.append(...contentOf(holder, before));
                     else
@@ -496,26 +482,26 @@ export function markChanges(root, changes, options = {}) {
                     holder.append(copy);
                     return holder;
                 });
-                element.setAttribute("data-ascribe-change", "moved");
-                element.setAttribute("data-ascribe-move", id);
+                element.setAttribute(DATA_CHANGE, "moved");
+                element.setAttribute(DATA_MOVE, id);
                 if (!element.id)
                     element.id = id;
                 addLabel(element, "moved");
-                const back = ui(doc, "a", "ascribe-move-link");
+                const back = ui(doc, "a", CLASS_MOVE_LINK);
                 back.href = `#${stub.id}`;
                 back.textContent = `from “${headingBefore(root, stub) ?? "the top of the page"}” ↑`;
-                const forward = stub.querySelector(".ascribe-move-link");
+                const forward = stub.querySelector(`.${CLASS_MOVE_LINK}`);
                 if (forward) {
                     forward.href = `#${element.id}`;
                     forward.textContent = `to “${headingBefore(root, element) ?? "the top of the page"}” ↓`;
                 }
                 if (LABEL_INSIDE.has(element.localName)) {
-                    const note = ui(doc, "span", "ascribe-move-note");
+                    const note = ui(doc, "span", CLASS_MOVE_NOTE);
                     note.append(" ", back);
                     element.append(note);
                 }
                 else {
-                    const holder = ui(doc, "div", "ascribe-move-note ascribe-move-after");
+                    const holder = ui(doc, "div", `${CLASS_MOVE_NOTE} ${CLASS_MOVE_AFTER}`);
                     holder.append(back);
                     element.after(holder);
                 }
@@ -552,7 +538,7 @@ function hintHidden(root, marks) {
     const summaries = new Map();
     for (const { change, element } of marks) {
         for (let el = element; el && el !== root; el = el.parentElement) {
-            if (el.localName === "ascribe-tab") {
+            if (el.localName === ELEMENT_TAB) {
                 const tab = tabs.get(el) ?? { added: false, count: 0 };
                 if (el === element && change.kind === "added")
                     tab.added = true;
@@ -570,8 +556,8 @@ function hintHidden(root, marks) {
     const hint = (kind, text) => {
         // A space before it, not only a margin, so the label reads "Linux 1
         // change" to a screen reader, not "Linux1 change".
-        const el = ui(doc, "span", "ascribe-hint", ` ${text}`);
-        el.setAttribute("data-ascribe-hint", kind);
+        const el = ui(doc, "span", CLASS_HINT, ` ${text}`);
+        el.setAttribute(DATA_HINT, kind);
         return el;
     };
     const watching = [];
@@ -615,9 +601,9 @@ function summaryOf(element) {
  */
 export function tabButton(tab) {
     const group = tab.parentElement;
-    if (tab.localName !== "ascribe-tab" || !group)
+    if (tab.localName !== ELEMENT_TAB || !group)
         return null;
-    const tabs = Array.from(group.children).filter((c) => c.localName === "ascribe-tab");
+    const tabs = Array.from(group.children).filter((c) => c.localName === ELEMENT_TAB);
     const buttons = group.querySelectorAll(':scope > [role="tablist"] > [role="tab"]');
     return buttons[tabs.indexOf(tab)] ?? null;
 }
@@ -643,27 +629,27 @@ export function clearMarks(root) {
     for (const observer of tabWatchers.get(root) ?? [])
         observer.disconnect();
     tabWatchers.delete(root);
-    for (const el of Array.from(root.querySelectorAll("[data-ascribe-ui]"))) {
+    for (const el of Array.from(root.querySelectorAll(`[${DATA_UI}]`))) {
         if (el.localName === "ins")
             el.replaceWith(...Array.from(el.childNodes));
         else
             el.remove();
     }
-    for (const el of Array.from(root.querySelectorAll("[data-ascribe-change]"))) {
-        el.removeAttribute("data-ascribe-change");
-        el.removeAttribute("data-ascribe-has-was");
-        el.removeAttribute("data-ascribe-was-source");
-        if (el.hasAttribute("data-ascribe-move")) {
-            if (el.id === el.getAttribute("data-ascribe-move"))
+    for (const el of Array.from(root.querySelectorAll(`[${DATA_CHANGE}]`))) {
+        el.removeAttribute(DATA_CHANGE);
+        el.removeAttribute(DATA_HAS_WAS);
+        el.removeAttribute(DATA_WAS_SOURCE);
+        if (el.hasAttribute(DATA_MOVE)) {
+            if (el.id === el.getAttribute(DATA_MOVE))
                 el.removeAttribute("id");
-            el.removeAttribute("data-ascribe-move");
+            el.removeAttribute(DATA_MOVE);
         }
     }
     root.normalize();
 }
 /** Shows the changes, the page as it will be, or the page as it was. */
 export function setShow(root, show) {
-    root.setAttribute("data-ascribe-show", show);
+    root.setAttribute(DATA_SHOW, show);
 }
 /**
  * Makes `element` visible: opens the `<details>` and selects the tabs it's
@@ -673,7 +659,7 @@ export function reveal(element) {
     for (let el = element; el; el = el.parentElement) {
         if (el instanceof HTMLDetailsElement && !el.open)
             el.open = true;
-        if (el.localName === "ascribe-tab" && el.hidden)
+        if (el.localName === ELEMENT_TAB && el.hidden)
             tabButton(el)?.click();
     }
 }
@@ -684,10 +670,10 @@ export function goTo(element) {
     if (typeof element.scrollIntoView === "function") {
         element.scrollIntoView({ block: "center", behavior: "smooth" });
     }
-    element.classList.remove("ascribe-flash");
+    element.classList.remove(CLASS_FLASH);
     // Restart the animation.
     void element.offsetWidth;
-    element.classList.add("ascribe-flash");
+    element.classList.add(CLASS_FLASH);
     if (!element.hasAttribute("tabindex"))
         element.setAttribute("tabindex", "-1");
     element.focus({ preventScroll: true });
@@ -698,13 +684,11 @@ export function goTo(element) {
  */
 export function showSources(root) {
     const doc = root.ownerDocument;
-    const tip = ui(doc, "span", "ascribe-where");
+    const tip = ui(doc, "span", CLASS_WHERE);
     tip.setAttribute("role", "status");
     let current = null;
     const show = (target) => {
-        const el = target instanceof Element
-            ? target.closest("[data-ascribe-source], [data-ascribe-was-source]")
-            : null;
+        const el = target instanceof Element ? target.closest(`[${DATA_SOURCE}], [${DATA_WAS_SOURCE}]`) : null;
         if (el === current)
             return;
         current = el;
@@ -713,10 +697,10 @@ export function showSources(root) {
             current = null;
             return;
         }
-        const source = el.getAttribute("data-ascribe-source");
+        const source = el.getAttribute(DATA_SOURCE);
         tip.textContent = source
-            ? describeSource(source, el.getAttribute("data-ascribe-via"))
-            : `was ${describeSource(el.getAttribute("data-ascribe-was-source") ?? "")}`;
+            ? describeSource(source, el.getAttribute(DATA_VIA))
+            : `was ${describeSource(el.getAttribute(DATA_WAS_SOURCE) ?? "")}`;
         const box = el.getBoundingClientRect();
         const host = root.getBoundingClientRect();
         tip.style.top = `${box.top - host.top}px`;