@singapore-editor/diff 0.2.0

package/README.md

@@ -0,0 +1,158 @@
+# @singapore-editor/diff
+
+Diff rendering and editor-diff helpers for Singapore.
+
+## Install
+
+```sh
+npm install @singapore-editor/core @singapore-editor/diff
+```
+
+## Usage
+
+A diff is a real `Editor` with one plugin. The plugin owns the diff model, the projected rows, the
+expansion state and the gutter; the **host owns the editor's document**, because no plugin context
+can mutate document text. So the host pushes the plugin's rows in and re-applies its tokens:
+
+```ts
+import {
+  createDiffEditorOptions,
+  createDiffPlugin,
+  joinRenderLines,
+  parseGitPatch,
+} from '@singapore-editor/diff'
+import { Editor } from '@singapore-editor/core/editor'
+import '@singapore-editor/core/style.css'
+import '@singapore-editor/diff/style.css'
+
+const plugin = createDiffPlugin({ mode: 'document', side: 'stacked' })
+const editor = new Editor(host, {
+  ...createDiffEditorOptions(),
+  plugins: [plugin],
+  tabSize: 4,
+})
+
+const push = () => {
+  // The tokens travel with the text: `setText` replaces the document, and a toggle without them
+  // would repaint uncoloured until the next parse.
+  //
+  // `Editor.syncText` is the cheaper alternative — it computes the minimal prefix/suffix edit
+  // rather than tearing the document down, and for an expansion that edit is exactly the inserted
+  // lines. It is not the default here because it also preserves caret and selection across rows
+  // that have moved, and an expansion moves every row below the region: a reader holding a
+  // selection would find it pointing at different text. Worth taking if your host has no selection
+  // to lose.
+  editor.setText(joinRenderLines(plugin.getRows()), { tokens: plugin.getTokens() })
+}
+plugin.onDidChangeRows(push)
+plugin.onDidChangeTokens(() => editor.setTokens(plugin.getTokens()))
+
+plugin.setFile(parseGitPatch(patchText)[0])
+```
+
+`createDiffEditorOptions()` returns what the diff's editor needs: a static read-only document, the
+configured `tabSize` with no indentation guess, no cursor-line paint over the row tint, `folding:
+false` so no fold command can hide projected rows, and the navigation, selection and find keys.
+Spread it and add your own options: plugins, typography, theme. The pushed text carries no
+`languageId`, because the language belongs to the plugin's per-side syntax documents.
+
+`keymap` and `cursorLineHighlight` are whole objects, and a field an override leaves out takes the
+editor default: every key pack and a painted cursor line. Extend them:
+
+```ts
+const preset = createDiffEditorOptions()
+const editor = new Editor(host, {
+  ...preset,
+  cursorLineHighlight: { ...preset.cursorLineHighlight, gutterNumber: true },
+  keymap: { ...preset.keymap, layers: [...preset.keymap.layers, hostLayer] },
+  plugins: [plugin],
+})
+```
+
+Split mode is two editors, `side: 'old'` and `side: 'new'`, laid out and scroll-synced by the host.
+**Give both plugins the same region store**, or expanding a collapsed region on one side leaves the
+other where it was and every row below it misaligns:
+
+```ts
+const regions = createDiffRegionStore()
+const left = createDiffPlugin({ mode: 'document', side: 'old', regions })
+const right = createDiffPlugin({ mode: 'document', side: 'new', regions })
+```
+
+This is not the mirroring the design forbids — there is one store, and both sides read it, rather
+than two sets kept in step. The panes stay aligned only while word wrap is off and no fold map is
+set.
+
+A host that needs the diff row under a pointer calls `diffRowAtEvent(event)`. It answers with the
+pane's side, its rows and the index into them, resolved through the editor's own row geometry,
+so a host never reads `data-editor-virtual-row` or a pane class to find out where a press landed.
+
+Expansion is per _diff_, not per path: pushing the same path with different content resets it,
+because region keys are absolute line numbers and any edit above a region renumbers it. Pushing an
+identical file again keeps it.
+
+## Theme
+
+Pass an `EditorTheme` to each diff editor. Base colors use the same fields as a plain editor:
+
+| Removed CSS hook                  | EditorTheme field       |
+| --------------------------------- | ----------------------- |
+| `--editor-diff-background`        | `backgroundColor`       |
+| `--editor-diff-foreground`        | `foregroundColor`       |
+| `--editor-diff-gutter-background` | `gutterBackgroundColor` |
+
+The removed hooks have no aliases. Set these fields on the diff editor itself. Its rows and gutter
+inherit the values, and `editor.setTheme(theme)` updates them without remounting.
+
+```ts
+editor.setTheme({
+  type: 'light',
+  backgroundColor: '#ffffff',
+  foregroundColor: '#18181b',
+  gutterBackgroundColor: '#f4f4f5',
+  colors: { 'diff.added.bg': '#dcfce7' },
+})
+```
+
+`createDiffPlugin` registers the following `EditorTheme.colors` ids. Defaults follow the theme's
+`type`; explicit colors override those defaults. A light theme should also supply its base colors.
+
+| Color id                               | Paint                                           |
+| -------------------------------------- | ----------------------------------------------- |
+| `diff.added`, `diff.deleted`           | Added and deleted gutter numbers and indicators |
+| `diff.modified`                        | Input to the default hunk background mix        |
+| `diff.added.bg`, `diff.deleted.bg`     | Changed rows and their gutter rows              |
+| `diff.hunk.bg`, `diff.hunk.foreground` | Hunk separators and their gutter rows           |
+| `diff.placeholder.bg`                  | Empty cells on one side of a split diff         |
+| `diff.muted`                           | Empty diff message                              |
+| `diff.border`, `diff.split.handle`     | Host diff borders and split handles             |
+
+## Stacked rows
+
+`plugin.getStackedRows()` returns both sides in row order, including the plugin's current region
+expansions. For a stacked plugin it returns the same readonly array as `getRows()`. For a split
+plugin the result is cached until its file or expansion state changes. Private region stores keep
+views independent; plugins given the same store observe each other's toggles. Overlay mode returns
+its live projection rows, as `getRows()` does.
+
+## Modes
+
+- **`document`** (default) — the editor holds a synthetic buffer of the projected rows. Deletion rows
+  are real document lines, so they highlight, select and copy like any other text. This is the
+  parity path.
+- **`overlay`** — the editor holds the host's live, editable buffer and deletions arrive as injected
+  rows. Injected rows have no offset space (`startOffset === endOffset`), which means no selection,
+  no copy, no inline word-diff, and syntax colouring borrowed from whatever document text sits at
+  the anchor offset. Non-parity by construction — see `test/overlayModeLimits.test.ts`. Use it for a
+  live dirty-diff against an editable document, not for a diff view.
+
+## Exports
+
+- `createDiffPlugin` — the one plugin factory, carrying both modes. `mode` is required.
+- `createDiffEditorOptions` — the editor options a document-mode diff needs.
+- `createDiffRegionStore` — shared expansion state for the two sides of a split view.
+- `parseGitPatch` and `createTextDiff` build diff models.
+- `createSplitProjection`, `createStackedProjection`, and `createLiveDiffProjection` expose render
+  projections.
+- `joinRenderLines` turns projected rows into the buffer text the host pushes in.
+- `projectDiffSyntaxTokens` maps full-file token streams onto projected rows.

package/dist/diffGutter.d.ts

@@ -0,0 +1,37 @@
+import type { EditorGutterContribution, EditorGutterRowContext } from '@singapore-editor/core/extensions';
+import { type DiffGutterDigits, type DiffGutterLayout, type DiffGutterSide } from './gutters';
+import type { DiffRenderRow } from './types';
+export type DiffGutterOptions = {
+    readonly side: DiffGutterSide;
+    /**
+     * Where a changed row's gutter tint is painted. `row`: this gutter is the pane's whole gutter
+     * (document mode), so the row decoration tints the gutter row, leading inset included, and the
+     * cell stays clear. `cell`: the gutter is shared with the host's lanes (overlay mode), so only
+     * this cell is tinted.
+     */
+    readonly tint: 'cell' | 'row';
+    /**
+     * The widest line number each lane must fit, computed once when the projection is built. Passing
+     * rows here instead would make `width()` re-scan every projected row on every width
+     * invalidation — which in overlay mode is every line of the file.
+     */
+    readonly getDigits: () => DiffGutterDigits;
+    /**
+     * Which diff row a rendered gutter row is showing. The two modes answer this differently and the
+     * gutter must not guess: in `document` mode the projection array index *is* the buffer row (§C4),
+     * but in `overlay` mode the array interleaves injected deletion rows, so position and buffer row
+     * diverge after the first deletion and the lookup has to go through `rowsByBufferRow`.
+     *
+     * Indexing a projection array positionally here is what broke overlay numbering once already.
+     */
+    readonly resolveRow: (row: EditorGutterRowContext) => DiffRenderRow | null;
+    readonly isEnabled?: () => boolean;
+    /**
+     * Called whenever the lane geometry is recomputed, so the host can publish it as CSS custom
+     * properties. The canvas gutter derived lane widths arithmetically; a DOM gutter has to hand the
+     * same numbers to CSS or the columns drift (§3.3, trap 1).
+     */
+    readonly onLayout?: (layout: DiffGutterLayout) => void;
+};
+export declare function createDiffGutterContribution(options: DiffGutterOptions): EditorGutterContribution;
+//# sourceMappingURL=diffGutter.d.ts.map

package/dist/diffGutter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffGutter.d.ts","sourceRoot":"","sources":["../src/diffGutter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAML,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,gBAAgB,CAAA;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,aAAa,GAAG,IAAI,CAAA;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAA;IAClC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;CACvD,CAAA;AAoBD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,wBAAwB,CAgDjG"}

package/dist/diffGutter.js

@@ -0,0 +1,189 @@
+import { diffGutterIndicatorText, diffGutterLaneTone, diffGutterLayout, diffGutterNumberText, diffGutterRowTone } from "./gutters.js";
+//#region src/diffGutter.ts
+/**
+* Lane elements are resolved once, when the cell is created, and never looked up again.
+*
+* The previous live-diff gutter ran three `querySelector` calls per row per update
+* (editorDiffPlugin.ts:246-255 before this change) — ~132 lookups per repaint at 44 mounted rows,
+* on the exact path the Aug-2026 scroll work fixed. Cells are created once and recycled by the
+* core (virtualizedTextViewRows.ts:308-330), so caching here costs one WeakMap entry per mounted
+* row and removes the lookups entirely (§3.3, trap 3).
+*/
+var lanesByCell = /* @__PURE__ */ new WeakMap();
+var NUMBER_LANES = ["old", "new"];
+function createDiffGutterContribution(options) {
+	const laneKinds = gutterLaneKinds(options.side);
+	let lastLayoutKey = null;
+	let laneWidths = [];
+	return {
+		id: `editor-diff-gutter-${options.side}`,
+		className: "editor-diff-gutter-cell",
+		snapshotRenderer: {
+			key: `diff-gutter-v1:${options.side}`,
+			capture: (cell) => captureGutter(cell, laneKinds, laneWidths),
+			restore: (cell, paint) => restoreGutter(cell, paint, laneKinds)
+		},
+		createCell(document) {
+			const cell = createDiffGutterCell(document, laneKinds);
+			if (options.tint === "cell") cell.classList.add("editor-diff-gutter-tinted");
+			return cell;
+		},
+		width(context) {
+			if (options.isEnabled && !options.isEnabled()) return 0;
+			const layout = diffGutterLayout(options.side, options.getDigits(), context.lineCount, context.metrics.characterWidth);
+			laneWidths = layout.lanes.map((lane) => lane.width);
+			const layoutKey = gutterLayoutKey(layout);
+			if (layoutKey !== lastLayoutKey) {
+				lastLayoutKey = layoutKey;
+				options.onLayout?.(layout);
+			}
+			return layout.width;
+		},
+		updateCell(element, row) {
+			updateDiffGutterCell(element, row, options);
+		}
+	};
+}
+function gutterLaneKinds(side) {
+	if (side === "stacked") return [...NUMBER_LANES, "indicator"];
+	return [side, "indicator"];
+}
+/** Everything `onLayout` publishes, so the memo cannot miss a change the payload carries. */
+function gutterLayoutKey(layout) {
+	return `${layout.width}:${layout.lanes.map((lane) => `${lane.kind}=${lane.width}`).join(",")}`;
+}
+function createDiffGutterCell(document, laneKinds) {
+	const cell = document.createElement("span");
+	cell.className = "editor-diff-gutter";
+	cell.setAttribute("aria-hidden", "true");
+	const lanes = /* @__PURE__ */ new Map();
+	for (const kind of laneKinds) {
+		const lane = document.createElement("span");
+		lane.className = `editor-diff-gutter-lane editor-diff-gutter-lane-${kind}`;
+		cell.appendChild(lane);
+		lanes.set(kind, lane);
+	}
+	lanesByCell.set(cell, {
+		cell,
+		lanes
+	});
+	return cell;
+}
+function updateDiffGutterCell(element, row, options) {
+	const cached = lanesByCell.get(element);
+	if (!cached) return;
+	element.style.removeProperty("grid-template-columns");
+	const diffRow = diffRowForGutterRow(row, options);
+	element.hidden = !diffRow;
+	if (!diffRow) {
+		for (const lane of cached.lanes.values()) clearLane(lane);
+		if (element.dataset.diffRowType !== void 0) delete element.dataset.diffRowType;
+		if (element.dataset.diffRowTone !== void 0) delete element.dataset.diffRowTone;
+		return;
+	}
+	for (const [kind, lane] of cached.lanes) {
+		setLaneText(lane, laneText(diffRow, kind));
+		setLaneTone(lane, diffGutterLaneTone(diffRow, kind));
+	}
+	setDataset(element, "diffRowType", diffRow.type);
+	setDataset(element, "diffRowTone", diffGutterRowTone(diffRow, options.side));
+}
+function diffRowForGutterRow(row, options) {
+	if (options.isEnabled && !options.isEnabled()) return null;
+	return options.resolveRow(row);
+}
+function laneText(row, kind) {
+	if (kind === "indicator") return diffGutterIndicatorText(row);
+	return diffGutterNumberText(row, kind);
+}
+function clearLane(lane) {
+	setLaneText(lane, "");
+	setLaneTone(lane, "default");
+}
+function setLaneText(lane, text) {
+	if (lane.textContent === text) return;
+	lane.textContent = text;
+}
+function setLaneTone(lane, tone) {
+	setDataset(lane, "diffTone", tone);
+}
+function setDataset(element, key, value) {
+	if (element.dataset[key] === value) return;
+	element.dataset[key] = value;
+}
+function captureGutter(cell, kinds, widths) {
+	const cached = lanesByCell.get(cell);
+	if (!cached || widths.length !== kinds.length) return null;
+	const lanes = kinds.map((kind, index) => {
+		const lane = cached.lanes.get(kind);
+		return {
+			text: lane?.textContent ?? "",
+			tone: lane?.dataset.diffTone ?? "default",
+			width: widths[index]
+		};
+	});
+	return JSON.stringify({
+		hidden: cell.hidden,
+		type: cell.dataset.diffRowType ?? "",
+		tone: cell.dataset.diffRowTone ?? "default",
+		lanes
+	});
+}
+function restoreGutter(cell, paint, kinds) {
+	if (paint.length > 4096) return false;
+	let value;
+	try {
+		value = JSON.parse(paint);
+	} catch {
+		return false;
+	}
+	if (!validGutterPaint(value, kinds.length)) return false;
+	const cached = lanesByCell.get(cell);
+	if (!cached) return false;
+	cell.hidden = value.hidden;
+	setDataset(cell, "diffRowType", value.type);
+	setDataset(cell, "diffRowTone", value.tone);
+	cell.style.gridTemplateColumns = value.lanes.map((lane) => `${lane.width}px`).join(" ");
+	for (let index = 0; index < kinds.length; index += 1) {
+		const lane = cached.lanes.get(kinds[index]);
+		const saved = value.lanes[index];
+		if (!lane || !saved) return false;
+		setLaneText(lane, saved.text);
+		setLaneTone(lane, saved.tone);
+	}
+	return true;
+}
+function validGutterPaint(value, length) {
+	if (!value || typeof value !== "object") return false;
+	if (!("hidden" in value) || typeof value.hidden !== "boolean") return false;
+	if (!("type" in value) || typeof value.type !== "string" || ![
+		"",
+		"context",
+		"addition",
+		"deletion",
+		"placeholder",
+		"hunk",
+		"empty"
+	].includes(value.type)) return false;
+	if (!("tone" in value) || !validTone(value.tone)) return false;
+	if (!("lanes" in value) || !Array.isArray(value.lanes) || value.lanes.length !== length) return false;
+	return value.lanes.every(validLane);
+}
+function validTone(value) {
+	return typeof value === "string" && [
+		"default",
+		"added",
+		"deleted",
+		"hunk"
+	].includes(value);
+}
+function validLane(value) {
+	if (!value || typeof value !== "object") return false;
+	if (!("text" in value) || typeof value.text !== "string" || value.text.length > 24) return false;
+	if (!("tone" in value) || !validTone(value.tone)) return false;
+	return "width" in value && typeof value.width === "number" && Number.isFinite(value.width) && value.width >= 0 && value.width <= 1e4;
+}
+//#endregion
+export { createDiffGutterContribution };
+
+//# sourceMappingURL=diffGutter.js.map

package/dist/diffGutter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffGutter.js","names":[],"sources":["../src/diffGutter.ts"],"sourcesContent":["import type {\n  EditorGutterContribution,\n  EditorGutterRowContext,\n} from '@singapore-editor/core/extensions'\nimport {\n  diffGutterIndicatorText,\n  diffGutterLaneTone,\n  diffGutterLayout,\n  diffGutterNumberText,\n  diffGutterRowTone,\n  type DiffGutterDigits,\n  type DiffGutterLaneKind,\n  type DiffGutterLayout,\n  type DiffGutterSide,\n} from './gutters'\nimport type { DiffRenderRow } from './types'\n\nexport type DiffGutterOptions = {\n  readonly side: DiffGutterSide\n  /**\n   * Where a changed row's gutter tint is painted. `row`: this gutter is the pane's whole gutter\n   * (document mode), so the row decoration tints the gutter row, leading inset included, and the\n   * cell stays clear. `cell`: the gutter is shared with the host's lanes (overlay mode), so only\n   * this cell is tinted.\n   */\n  readonly tint: 'cell' | 'row'\n  /**\n   * The widest line number each lane must fit, computed once when the projection is built. Passing\n   * rows here instead would make `width()` re-scan every projected row on every width\n   * invalidation — which in overlay mode is every line of the file.\n   */\n  readonly getDigits: () => DiffGutterDigits\n  /**\n   * Which diff row a rendered gutter row is showing. The two modes answer this differently and the\n   * gutter must not guess: in `document` mode the projection array index *is* the buffer row (§C4),\n   * but in `overlay` mode the array interleaves injected deletion rows, so position and buffer row\n   * diverge after the first deletion and the lookup has to go through `rowsByBufferRow`.\n   *\n   * Indexing a projection array positionally here is what broke overlay numbering once already.\n   */\n  readonly resolveRow: (row: EditorGutterRowContext) => DiffRenderRow | null\n  readonly isEnabled?: () => boolean\n  /**\n   * Called whenever the lane geometry is recomputed, so the host can publish it as CSS custom\n   * properties. The canvas gutter derived lane widths arithmetically; a DOM gutter has to hand the\n   * same numbers to CSS or the columns drift (§3.3, trap 1).\n   */\n  readonly onLayout?: (layout: DiffGutterLayout) => void\n}\n\ntype DiffGutterLanes = {\n  readonly cell: HTMLElement\n  readonly lanes: ReadonlyMap<DiffGutterLaneKind, HTMLElement>\n}\n\n/**\n * Lane elements are resolved once, when the cell is created, and never looked up again.\n *\n * The previous live-diff gutter ran three `querySelector` calls per row per update\n * (editorDiffPlugin.ts:246-255 before this change) — ~132 lookups per repaint at 44 mounted rows,\n * on the exact path the Aug-2026 scroll work fixed. Cells are created once and recycled by the\n * core (virtualizedTextViewRows.ts:308-330), so caching here costs one WeakMap entry per mounted\n * row and removes the lookups entirely (§3.3, trap 3).\n */\nconst lanesByCell = new WeakMap<HTMLElement, DiffGutterLanes>()\n\nconst NUMBER_LANES: readonly DiffGutterLaneKind[] = ['old', 'new']\n\nexport function createDiffGutterContribution(options: DiffGutterOptions): EditorGutterContribution {\n  const laneKinds = gutterLaneKinds(options.side)\n  let lastLayoutKey: string | null = null\n  let laneWidths: readonly number[] = []\n\n  return {\n    id: `editor-diff-gutter-${options.side}`,\n    className: 'editor-diff-gutter-cell',\n    snapshotRenderer: {\n      key: `diff-gutter-v1:${options.side}`,\n      capture: (cell) => captureGutter(cell, laneKinds, laneWidths),\n      restore: (cell, paint) => restoreGutter(cell, paint, laneKinds),\n    },\n    createCell(document) {\n      const cell = createDiffGutterCell(document, laneKinds)\n      if (options.tint === 'cell') cell.classList.add('editor-diff-gutter-tinted')\n      return cell\n    },\n    width(context) {\n      if (options.isEnabled && !options.isEnabled()) return 0\n\n      const layout = diffGutterLayout(\n        options.side,\n        options.getDigits(),\n        context.lineCount,\n        context.metrics.characterWidth,\n      )\n      // Only on an actual change: `width` runs inside the core's layout pass, and writing custom\n      // properties unconditionally would dirty style for the whole subtree on every recompute.\n      //\n      // Keyed on the whole lane split, not on the total. The stacked total is\n      // `ceil(old*cw + 6) + ceil(new*cw + 6) + 12`, which is symmetric in the two lane character\n      // counts — so swapping to a file whose old/new digit widths are transposed leaves the total\n      // identical while the split needs to change, and a total-keyed memo would silently keep\n      // publishing the previous columns. Lanes are `overflow: hidden`, so the under-sized one\n      // clips its leading digit.\n      laneWidths = layout.lanes.map((lane) => lane.width)\n      const layoutKey = gutterLayoutKey(layout)\n      if (layoutKey !== lastLayoutKey) {\n        lastLayoutKey = layoutKey\n        options.onLayout?.(layout)\n      }\n      return layout.width\n    },\n    updateCell(element, row) {\n      updateDiffGutterCell(element, row, options)\n    },\n  }\n}\n\nfunction gutterLaneKinds(side: DiffGutterSide): readonly DiffGutterLaneKind[] {\n  if (side === 'stacked') return [...NUMBER_LANES, 'indicator']\n  return [side, 'indicator']\n}\n\n/** Everything `onLayout` publishes, so the memo cannot miss a change the payload carries. */\nfunction gutterLayoutKey(layout: DiffGutterLayout): string {\n  return `${layout.width}:${layout.lanes.map((lane) => `${lane.kind}=${lane.width}`).join(',')}`\n}\n\nfunction createDiffGutterCell(\n  document: Document,\n  laneKinds: readonly DiffGutterLaneKind[],\n): HTMLElement {\n  const cell = document.createElement('span')\n  cell.className = 'editor-diff-gutter'\n  cell.setAttribute('aria-hidden', 'true')\n\n  const lanes = new Map<DiffGutterLaneKind, HTMLElement>()\n  for (const kind of laneKinds) {\n    const lane = document.createElement('span')\n    lane.className = `editor-diff-gutter-lane editor-diff-gutter-lane-${kind}`\n    cell.appendChild(lane)\n    lanes.set(kind, lane)\n  }\n\n  lanesByCell.set(cell, { cell, lanes })\n  return cell\n}\n\nfunction updateDiffGutterCell(\n  element: HTMLElement,\n  row: EditorGutterRowContext,\n  options: DiffGutterOptions,\n): void {\n  const cached = lanesByCell.get(element)\n  if (!cached) return\n  element.style.removeProperty('grid-template-columns')\n\n  const diffRow = diffRowForGutterRow(row, options)\n  element.hidden = !diffRow\n  if (!diffRow) {\n    for (const lane of cached.lanes.values()) clearLane(lane)\n    if (element.dataset.diffRowType !== undefined) delete element.dataset.diffRowType\n    if (element.dataset.diffRowTone !== undefined) delete element.dataset.diffRowTone\n    return\n  }\n\n  for (const [kind, lane] of cached.lanes) {\n    setLaneText(lane, laneText(diffRow, kind))\n    setLaneTone(lane, diffGutterLaneTone(diffRow, kind))\n  }\n  setDataset(element, 'diffRowType', diffRow.type)\n  setDataset(element, 'diffRowTone', diffGutterRowTone(diffRow, options.side))\n}\n\nfunction diffRowForGutterRow(\n  row: EditorGutterRowContext,\n  options: DiffGutterOptions,\n): DiffRenderRow | null {\n  if (options.isEnabled && !options.isEnabled()) return null\n  return options.resolveRow(row)\n}\n\nfunction laneText(row: DiffRenderRow, kind: DiffGutterLaneKind): string {\n  if (kind === 'indicator') return diffGutterIndicatorText(row)\n  return diffGutterNumberText(row, kind)\n}\n\nfunction clearLane(lane: HTMLElement): void {\n  setLaneText(lane, '')\n  setLaneTone(lane, 'default')\n}\n\nfunction setLaneText(lane: HTMLElement, text: string): void {\n  if (lane.textContent === text) return\n  lane.textContent = text\n}\n\nfunction setLaneTone(lane: HTMLElement, tone: string): void {\n  setDataset(lane, 'diffTone', tone)\n}\n\nfunction setDataset(element: HTMLElement, key: string, value: string): void {\n  if (element.dataset[key] === value) return\n  element.dataset[key] = value\n}\n\ntype GutterPaint = {\n  hidden: boolean\n  type: string\n  tone: string\n  lanes: { text: string; tone: string; width: number }[]\n}\n\nfunction captureGutter(\n  cell: HTMLElement,\n  kinds: readonly DiffGutterLaneKind[],\n  widths: readonly number[],\n): string | null {\n  const cached = lanesByCell.get(cell)\n  if (!cached || widths.length !== kinds.length) return null\n  const lanes = kinds.map((kind, index) => {\n    const lane = cached.lanes.get(kind)\n    return {\n      text: lane?.textContent ?? '',\n      tone: lane?.dataset.diffTone ?? 'default',\n      width: widths[index]!,\n    }\n  })\n  return JSON.stringify({\n    hidden: cell.hidden,\n    type: cell.dataset.diffRowType ?? '',\n    tone: cell.dataset.diffRowTone ?? 'default',\n    lanes,\n  })\n}\n\nfunction restoreGutter(\n  cell: HTMLElement,\n  paint: string,\n  kinds: readonly DiffGutterLaneKind[],\n): boolean {\n  if (paint.length > 4096) return false\n  let value: unknown\n  try {\n    value = JSON.parse(paint)\n  } catch {\n    return false\n  }\n  if (!validGutterPaint(value, kinds.length)) return false\n  const cached = lanesByCell.get(cell)\n  if (!cached) return false\n  cell.hidden = value.hidden\n  setDataset(cell, 'diffRowType', value.type)\n  setDataset(cell, 'diffRowTone', value.tone)\n  cell.style.gridTemplateColumns = value.lanes.map((lane) => `${lane.width}px`).join(' ')\n  for (let index = 0; index < kinds.length; index += 1) {\n    const lane = cached.lanes.get(kinds[index]!)\n    const saved = value.lanes[index]\n    if (!lane || !saved) return false\n    setLaneText(lane, saved.text)\n    setLaneTone(lane, saved.tone)\n  }\n  return true\n}\n\nfunction validGutterPaint(value: unknown, length: number): value is GutterPaint {\n  if (!value || typeof value !== 'object') return false\n  if (!('hidden' in value) || typeof value.hidden !== 'boolean') return false\n  if (\n    !('type' in value) ||\n    typeof value.type !== 'string' ||\n    !['', 'context', 'addition', 'deletion', 'placeholder', 'hunk', 'empty'].includes(value.type)\n  )\n    return false\n  if (!('tone' in value) || !validTone(value.tone)) return false\n  if (!('lanes' in value) || !Array.isArray(value.lanes) || value.lanes.length !== length)\n    return false\n  return value.lanes.every(validLane)\n}\n\nfunction validTone(value: unknown): value is string {\n  return typeof value === 'string' && ['default', 'added', 'deleted', 'hunk'].includes(value)\n}\n\nfunction validLane(value: unknown): boolean {\n  if (!value || typeof value !== 'object') return false\n  if (!('text' in value) || typeof value.text !== 'string' || value.text.length > 24) return false\n  if (!('tone' in value) || !validTone(value.tone)) return false\n  return (\n    'width' in value &&\n    typeof value.width === 'number' &&\n    Number.isFinite(value.width) &&\n    value.width >= 0 &&\n    value.width <= 10_000\n  )\n}\n"],"mappings":"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"}

package/dist/diffRows.d.ts

@@ -0,0 +1,5 @@
+import type { VirtualizedTextHighlightRange, VirtualizedTextRowDecoration } from '@singapore-editor/core/rendering';
+import type { DiffRenderRow } from './types';
+export declare function diffRowDecorations(rows: readonly DiffRenderRow[]): ReadonlyMap<number, VirtualizedTextRowDecoration>;
+export declare function diffInlineHighlightRanges(rows: readonly DiffRenderRow[]): readonly VirtualizedTextHighlightRange[];
+//# sourceMappingURL=diffRows.d.ts.map

package/dist/diffRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffRows.d.ts","sourceRoot":"","sources":["../src/diffRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,WAAW,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAOnD;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,SAAS,6BAA6B,EAAE,CAU1C"}

package/dist/diffRows.js

@@ -0,0 +1,40 @@
+//#region src/diffRows.ts
+function diffRowDecorations(rows) {
+	const decorations = /* @__PURE__ */ new Map();
+	for (const [index, row] of rows.entries()) {
+		const decoration = decorationForRow(row);
+		if (decoration) decorations.set(index, decoration);
+	}
+	return decorations;
+}
+function diffInlineHighlightRanges(rows) {
+	const ranges = [];
+	let offset = 0;
+	for (const row of rows) {
+		appendInlineRanges(ranges, row, offset);
+		offset += row.text.length + 1;
+	}
+	return ranges;
+}
+function appendInlineRanges(ranges, row, rowOffset) {
+	for (const range of row.inlineRanges ?? []) {
+		if (range.end <= range.start) continue;
+		ranges.push({
+			start: rowOffset + range.start,
+			end: rowOffset + range.end
+		});
+	}
+}
+function decorationForRow(row) {
+	if (row.type === "context") return null;
+	const expandable = row.expandable ? " editor-diff-row-expandable" : "";
+	return {
+		snapshotStyle: "colors",
+		className: `editor-diff-row editor-diff-row-${row.type}${expandable}`,
+		gutterClassName: `editor-diff-gutter-row editor-diff-gutter-band-${row.type}`
+	};
+}
+//#endregion
+export { diffInlineHighlightRanges, diffRowDecorations };
+
+//# sourceMappingURL=diffRows.js.map

package/dist/diffRows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffRows.js","names":[],"sources":["../src/diffRows.ts"],"sourcesContent":["import type {\n  VirtualizedTextHighlightRange,\n  VirtualizedTextRowDecoration,\n} from '@singapore-editor/core/rendering'\nimport type { DiffRenderRow } from './types'\n\nexport function diffRowDecorations(\n  rows: readonly DiffRenderRow[],\n): ReadonlyMap<number, VirtualizedTextRowDecoration> {\n  const decorations = new Map<number, VirtualizedTextRowDecoration>()\n  for (const [index, row] of rows.entries()) {\n    const decoration = decorationForRow(row)\n    if (decoration) decorations.set(index, decoration)\n  }\n  return decorations\n}\n\nexport function diffInlineHighlightRanges(\n  rows: readonly DiffRenderRow[],\n): readonly VirtualizedTextHighlightRange[] {\n  const ranges: VirtualizedTextHighlightRange[] = []\n  let offset = 0\n\n  for (const row of rows) {\n    appendInlineRanges(ranges, row, offset)\n    offset += row.text.length + 1\n  }\n\n  return ranges\n}\n\nfunction appendInlineRanges(\n  ranges: VirtualizedTextHighlightRange[],\n  row: DiffRenderRow,\n  rowOffset: number,\n): void {\n  for (const range of row.inlineRanges ?? []) {\n    if (range.end <= range.start) continue\n    ranges.push({ start: rowOffset + range.start, end: rowOffset + range.end })\n  }\n}\n\nfunction decorationForRow(row: DiffRenderRow): VirtualizedTextRowDecoration | null {\n  if (row.type === 'context') return null\n\n  const expandable = row.expandable ? ' editor-diff-row-expandable' : ''\n  return {\n    snapshotStyle: 'colors',\n    className: `editor-diff-row editor-diff-row-${row.type}${expandable}`,\n    // The whole gutter row, so the tint also covers the gutter's leading inset.\n    gutterClassName: `editor-diff-gutter-row editor-diff-gutter-band-${row.type}`,\n  }\n}\n"],"mappings":";AAMA,SAAgB,mBACd,MACmD;CACnD,MAAM,8BAAc,IAAI,IAA0C;CAClE,KAAK,MAAM,CAAC,OAAO,QAAQ,KAAK,QAAQ,GAAG;EACzC,MAAM,aAAa,iBAAiB,GAAG;EACvC,IAAI,YAAY,YAAY,IAAI,OAAO,UAAU;CACnD;CACA,OAAO;AACT;AAEA,SAAgB,0BACd,MAC0C;CAC1C,MAAM,SAA0C,CAAC;CACjD,IAAI,SAAS;CAEb,KAAK,MAAM,OAAO,MAAM;EACtB,mBAAmB,QAAQ,KAAK,MAAM;EACtC,UAAU,IAAI,KAAK,SAAS;CAC9B;CAEA,OAAO;AACT;AAEA,SAAS,mBACP,QACA,KACA,WACM;CACN,KAAK,MAAM,SAAS,IAAI,gBAAgB,CAAC,GAAG;EAC1C,IAAI,MAAM,OAAO,MAAM,OAAO;EAC9B,OAAO,KAAK;GAAE,OAAO,YAAY,MAAM;GAAO,KAAK,YAAY,MAAM;EAAI,CAAC;CAC5E;AACF;AAEA,SAAS,iBAAiB,KAAyD;CACjF,IAAI,IAAI,SAAS,WAAW,OAAO;CAEnC,MAAM,aAAa,IAAI,aAAa,gCAAgC;CACpE,OAAO;EACL,eAAe;EACf,WAAW,mCAAmC,IAAI,OAAO;EAEzD,iBAAiB,kDAAkD,IAAI;CACzE;AACF"}

package/dist/diffSyntax.d.ts

@@ -0,0 +1,124 @@
+import type { EditorHighlighterSession } from '@singapore-editor/core/extensions';
+import { type EditorSyntaxResult, type EditorToken, type EditorTokenInput, type EditorTokenStore } from '@singapore-editor/core/syntax';
+import type { DiffFile, DiffRenderRow, DiffSyntaxBackend } from './types';
+type DiffSyntaxSide = 'old' | 'new' | 'stacked';
+type DiffSyntaxSourceSide = 'old' | 'new';
+export type DiffSyntaxTokenSource = {
+    readonly lineStarts: readonly number[];
+    readonly side: DiffSyntaxSourceSide;
+    readonly tokens: EditorTokenInput;
+};
+export type ProjectDiffSyntaxTokensOptions = {
+    readonly rows: readonly DiffRenderRow[];
+    readonly side: DiffSyntaxSide;
+    readonly sources: readonly DiffSyntaxTokenSource[];
+};
+export type DiffSyntaxControllerOptions = {
+    readonly side: DiffSyntaxSide;
+    readonly backend?: DiffSyntaxBackend;
+    readonly enabled?: boolean;
+    /** Fires when a *newly parsed* token stream lands; row-driven re-projection is synchronous. */
+    readonly onDidChangeTokens: () => void;
+};
+/** Streams from `prepareDiffSyntax`, or a preparation of them still running. */
+export type PreparedDiffSyntaxInput = readonly PreparedDiffSyntaxSource[] | Promise<readonly PreparedDiffSyntaxSource[]>;
+export type PrepareDiffSyntaxOptions = {
+    readonly backend?: DiffSyntaxBackend;
+    /** Which pane the sources are for. `stacked` prepares both source sides. */
+    readonly side?: DiffSyntaxSide;
+    readonly signal?: AbortSignal;
+};
+/**
+ * One source side's parsed token stream and the session that recolours it on a theme change.
+ * Exactly one holder owns it at a time — a host's store, or the controller that adopted it — and
+ * that holder disposes it.
+ */
+export declare class PreparedDiffSyntaxSource {
+    readonly side: DiffSyntaxSourceSide;
+    readonly lineStarts: readonly number[];
+    private readonly listeners;
+    private readonly disposables;
+    private current;
+    private disposed;
+    constructor(side: DiffSyntaxSourceSide, lineStarts: readonly number[]);
+    get tokens(): EditorTokenStore;
+    /** Fires when a theme change recolours the stream. */
+    onDidChangeTokens(listener: () => void): () => void;
+    dispose(): void;
+    /** @internal */
+    own(disposable: {
+        dispose(): void;
+    }): void;
+    /** @internal */
+    setTokens(tokens: EditorTokenInput): void;
+    /** @internal */
+    recolor(session: DiffSyntaxServiceSession): Promise<void>;
+}
+/**
+ * Parses a diff's sources ahead of the view that will show them, so `setFile(file, rows, prepared)`
+ * paints coloured on its first frame. The caller owns the result; an aborted preparation resolves
+ * empty.
+ */
+export declare function prepareDiffSyntax(file: DiffFile, options?: PrepareDiffSyntaxOptions): Promise<readonly PreparedDiffSyntaxSource[]>;
+/**
+ * The syntax half of the old `DiffView`, with one behavioural change.
+ *
+ * `DiffView` re-ran the whole pipeline — new sessions, new parse — on every row change, including
+ * every expansion toggle (`updatePaneRows` → `refreshSyntaxHighlighting`, DiffView.ts:564). The
+ * parse result does not depend on which regions are expanded: the sources are the two *full files*,
+ * and expansion only changes which of their lines the projection shows. So the per-side token
+ * streams are cached against the file and re-projected synchronously when rows change, which is
+ * what lets a toggle repaint without an uncoloured frame (§C10).
+ */
+export declare class DiffSyntaxController {
+    private readonly options;
+    private readonly scheduler;
+    private readonly key;
+    private sources;
+    private sourceSubscriptions;
+    private indexed;
+    private sourcesFile;
+    private file;
+    private rows;
+    private tokens;
+    private disposed;
+    private ready;
+    constructor(options: DiffSyntaxControllerOptions);
+    /** A disposed controller is terminal — its scheduler never runs another task. */
+    isDisposed(): boolean;
+    isReady(): boolean;
+    getTokens(): readonly EditorToken[];
+    /**
+     * New file: drop the cached streams, then adopt `prepared` when it covers this side, or reparse.
+     * A preparation still running is awaited instead of parsing the same file twice. Takes ownership
+     * of `prepared` either way.
+     */
+    setFile(file: DiffFile | null, rows: readonly DiffRenderRow[], prepared?: PreparedDiffSyntaxInput): void;
+    /** Whether `prepared` was adopted; otherwise it is disposed, and a current file reparses. */
+    private settlePrepared;
+    /** Same file, different rows — an expansion toggle. Re-project what is already parsed. */
+    setRows(rows: readonly DiffRenderRow[]): void;
+    /**
+     * Hands the parsed streams of the current file to the caller, which then owns them; empty while
+     * a parse is still running. The controller keeps projecting their current tokens, and stops
+     * following their recolouring.
+     */
+    release(): readonly PreparedDiffSyntaxSource[];
+    dispose(): void;
+    private reproject;
+    private load;
+    private applySources;
+    private adoptSources;
+    private recolor;
+    private unsubscribeSources;
+    private disposeSources;
+}
+export declare function diffSyntaxBackend(backend: DiffSyntaxBackend | undefined): DiffSyntaxBackend;
+export declare function projectDiffSyntaxTokens({ rows, side, sources, }: ProjectDiffSyntaxTokensOptions): readonly EditorToken[];
+type DiffSyntaxServiceSession = {
+    onDidChangeTheme?: EditorHighlighterSession['onDidChangeTheme'];
+    refresh(): Promise<EditorSyntaxResult>;
+    dispose(): void;
+};
+export {};
+//# sourceMappingURL=diffSyntax.d.ts.map

package/dist/diffSyntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffSyntax.d.ts","sourceRoot":"","sources":["../src/diffSyntax.ts"],"names":[],"mappings":"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"}