@singapore-editor/diff 0.2.0

package/dist/editorDiffPlugin.js

@@ -0,0 +1,546 @@
+import { registerDiffColors } from "./theme.js";
+import { diffGutterDigits } from "./gutters.js";
+import { createDiffGutterContribution } from "./diffGutter.js";
+import { diffInlineHighlightRanges, diffRowDecorations } from "./diffRows.js";
+import { DiffSyntaxController } from "./diffSyntax.js";
+import { createLiveDiffProjection } from "./liveProjection.js";
+import { createTextDiff } from "./model.js";
+import { createSplitProjection, createStackedProjection } from "./projection.js";
+import { createDiffRegionStore } from "./regions.js";
+import { EDITOR_SNIPPET_TOKENS_FEATURE } from "@singapore-editor/core/extensions";
+//#region src/editorDiffPlugin.ts
+var viewsByScrollElement = /* @__PURE__ */ new WeakMap();
+/** `null` outside a `document`-mode diff pane, or over something that is not a diff row. */
+function diffRowAtEvent(event) {
+	const target = event.target;
+	if (!(target instanceof Element)) return null;
+	const scrollElement = target.closest("[data-editor-diff-side]");
+	if (!scrollElement) return null;
+	return viewsByScrollElement.get(scrollElement)?.rowHitAt(event) ?? null;
+}
+var EMPTY_PROJECTION = {
+	injectedRows: [],
+	rowDecorations: /* @__PURE__ */ new Map(),
+	rows: [],
+	rowsByBufferRow: /* @__PURE__ */ new Map()
+};
+var ROW_DECORATION_SOURCE = "editor.diff";
+var INLINE_HIGHLIGHT_STYLE = { backgroundColor: "rgba(255, 255, 255, 0.18)" };
+var nextDiffPluginId = 0;
+/**
+* The one diff plugin (§C1), carrying two internal row-delivery modes.
+*
+* `document` — the editor holds a synthetic buffer of the projected rows and the plugin publishes
+* them for the host to push in. Everything works because the rows are real document lines.
+*
+* `overlay` — the editor holds the host's live, editable buffer and deletions arrive as injected
+* rows. Non-parity by construction; see §C2 and test/overlayModeLimits.test.ts before reaching for
+* it.
+*/
+function createDiffPlugin(options) {
+	registerDiffColors();
+	const runtime = new DiffPluginRuntime(options);
+	return {
+		name: `editor-diff-${options.mode}`,
+		activate(context) {
+			return runtime.activate(context);
+		},
+		setFile: (file, prepared) => runtime.setFile(file, prepared),
+		releasePreparedSyntax: () => runtime.releasePreparedSyntax(),
+		getRows: () => runtime.getRows(),
+		getStackedRows: () => runtime.getStackedRows(),
+		getTokens: () => runtime.getTokens(),
+		isSyntaxReady: () => runtime.isSyntaxReady(),
+		onDidChangeRows: (listener) => runtime.onDidChangeRows(listener),
+		onDidChangeTokens: (listener) => runtime.onDidChangeTokens(listener),
+		getExpandedRegions: () => runtime.getExpandedRegions(),
+		toggleRegion: (key) => runtime.toggleRegion(key),
+		setBaseFile: (file) => runtime.setBaseFile(file),
+		setEnabled: (enabled) => runtime.setEnabled(enabled)
+	};
+}
+var DiffPluginRuntime = class {
+	options;
+	id = nextDiffPluginId++;
+	mode;
+	side;
+	syntax;
+	rowListeners = /* @__PURE__ */ new Set();
+	tokenListeners = /* @__PURE__ */ new Set();
+	regions;
+	file = null;
+	rows = [];
+	stackedRows = null;
+	digits = {
+		old: 0,
+		new: 0
+	};
+	hunkRows = false;
+	expandableRows = false;
+	baseFile = null;
+	enabled;
+	liveProjection = EMPTY_PROJECTION;
+	decoration = null;
+	view = null;
+	injectedRowsListener = null;
+	lastGutterLayout = null;
+	regionSubscription;
+	constructor(options) {
+		this.options = options;
+		this.mode = options.mode;
+		this.side = options.side ?? "stacked";
+		this.regions = options.regions ?? createDiffRegionStore();
+		this.regionSubscription = this.regions.onDidChange(() => this.handleRegionsChanged());
+		this.enabled = this.mode === "document";
+		this.syntax = this.createSyntaxController();
+	}
+	activate(context) {
+		if (this.syntax.isDisposed()) {
+			this.syntax = this.createSyntaxController();
+			if (this.file) this.syntax.setFile(this.file, this.rows);
+		}
+		const disposables = [
+			context.registerGutterContribution(createDiffGutterContribution({
+				side: this.side,
+				tint: this.mode === "document" ? "row" : "cell",
+				getDigits: () => this.gutterDigits(),
+				resolveRow: (row) => this.resolveGutterRow(row),
+				isEnabled: () => this.enabled,
+				onLayout: (layout) => this.publishGutterLayout(layout)
+			})),
+			context.registerDecorationContribution({ createContribution: (featureContext) => this.createDecorationContribution(featureContext) }),
+			context.registerViewContribution({ createContribution: (viewContext) => this.createViewContribution(viewContext) }),
+			{ dispose: () => this.syntax.dispose() }
+		];
+		if (this.mode === "overlay") disposables.push(context.registerInjectedTextRowProvider({
+			getInjectedTextRows: () => this.injectedRows(),
+			onDidChangeInjectedTextRows: (listener) => this.setInjectedRowsListener(listener)
+		}));
+		return disposables;
+	}
+	setFile(file, prepared = []) {
+		if (this.mode !== "document") {
+			Promise.resolve(prepared).then((sources) => {
+				for (const source of sources) source.dispose();
+			}, () => void 0);
+			return;
+		}
+		this.file = file;
+		this.regions.setFile(file);
+		this.rebuildRows();
+		this.syntax.setFile(file, this.rows, prepared);
+		this.notifyRows();
+	}
+	releasePreparedSyntax() {
+		return this.syntax.release();
+	}
+	getRows() {
+		if (this.mode === "overlay") return this.liveProjection.rows;
+		return this.rows;
+	}
+	getStackedRows() {
+		if (this.mode === "overlay") return this.liveProjection.rows;
+		if (this.side === "stacked") return this.rows;
+		this.stackedRows ??= projectRows(this.file, "stacked", this.regions.getExpandedRegions());
+		return this.stackedRows;
+	}
+	isSyntaxReady() {
+		return this.syntax.isReady();
+	}
+	getTokens() {
+		return this.syntax.getTokens();
+	}
+	getExpandedRegions() {
+		return this.regions.getExpandedRegions();
+	}
+	toggleRegion(key) {
+		if (this.mode !== "document") return;
+		if (!this.file) return;
+		this.regions.toggleRegion(key);
+	}
+	handleRegionsChanged() {
+		if (this.mode !== "document") return;
+		if (!this.file) return;
+		this.rebuildRows();
+		this.syntax.setRows(this.rows);
+		this.notifyRows();
+	}
+	onDidChangeRows(listener) {
+		this.rowListeners.add(listener);
+		return { dispose: () => this.rowListeners.delete(listener) };
+	}
+	onDidChangeTokens(listener) {
+		this.tokenListeners.add(listener);
+		return { dispose: () => this.tokenListeners.delete(listener) };
+	}
+	rebuildRows() {
+		this.stackedRows = null;
+		this.rows = projectRows(this.file, this.side, this.regions.getExpandedRegions());
+		this.digits = diffGutterDigits(this.rows);
+		this.hunkRows = this.rows.some((row) => row.type === "hunk");
+		this.expandableRows = this.rows.some((row) => row.type === "hunk" && row.expandable === true);
+	}
+	notifyRows() {
+		for (const listener of this.rowListeners) listener();
+		this.decoration?.refresh();
+		this.view?.refreshRows();
+	}
+	notifyTokens() {
+		for (const listener of this.tokenListeners) listener();
+	}
+	setBaseFile(file) {
+		if (this.mode !== "overlay") return;
+		this.baseFile = file;
+		this.decoration?.refresh();
+	}
+	setEnabled(enabled) {
+		if (this.mode !== "overlay") return;
+		this.enabled = enabled;
+		this.decoration?.refresh();
+	}
+	injectedRows() {
+		if (!this.enabled) return [];
+		return this.liveProjection.injectedRows;
+	}
+	setInjectedRowsListener(listener) {
+		this.injectedRowsListener = listener;
+		return { dispose: () => {
+			if (this.injectedRowsListener === listener) this.injectedRowsListener = null;
+		} };
+	}
+	gutterDigits() {
+		if (this.mode === "overlay") return diffGutterDigits(this.liveProjection.rows);
+		return this.digits;
+	}
+	/**
+	* Which diff row a rendered gutter row is showing. The two modes cannot share an answer.
+	*
+	* `document` — §C4 holds, so the projection index is the buffer row and a positional lookup is
+	* correct.
+	*
+	* `overlay` — the projection array interleaves injected deletion rows, so position and buffer
+	* row diverge from the first deletion onwards; the mapping the projection publishes for exactly
+	* this purpose is `rowsByBufferRow`, keyed `newLineNumber - 1`. An injected row is not in that
+	* map at all and carries its own row as metadata instead.
+	*/
+	resolveGutterRow(row) {
+		if (this.mode === "overlay") {
+			if (row.source === "injected") return injectedDiffRow(row);
+			if (row.source !== "document") return null;
+			return this.liveProjection.rowsByBufferRow.get(row.bufferRow) ?? null;
+		}
+		if (row.source !== "document") return null;
+		return this.rows[row.bufferRow] ?? null;
+	}
+	createDecorationContribution(context) {
+		const contribution = new DiffDecorationContribution(context, {
+			mode: this.mode,
+			getRows: () => this.rows,
+			buildLiveProjection: () => this.buildLiveProjection(context),
+			setLiveProjection: (projection) => {
+				this.liveProjection = projection;
+			},
+			notifyInjectedRowsChanged: () => this.injectedRowsListener?.()
+		});
+		this.decoration = contribution;
+		contribution.refresh();
+		return {
+			handleEditorChange: (change) => contribution.handleEditorChange(change),
+			dispose: () => {
+				if (this.decoration === contribution) this.decoration = null;
+				contribution.dispose();
+			}
+		};
+	}
+	buildLiveProjection(context) {
+		if (!this.enabled) return EMPTY_PROJECTION;
+		if (!this.baseFile) return EMPTY_PROJECTION;
+		if (!context.hasDocument()) return EMPTY_PROJECTION;
+		const file = createTextDiff({
+			oldFile: this.baseFile,
+			newFile: {
+				path: this.baseFile.path,
+				text: liveDiffDocumentText(context),
+				languageId: this.baseFile.languageId
+			}
+		});
+		return createLiveDiffProjection(file);
+	}
+	createViewContribution(context) {
+		const contribution = new DiffViewContribution(context, {
+			highlightName: `editor-diff-${this.id}-${this.side}-inline`,
+			mode: this.mode,
+			side: this.side,
+			getRows: () => this.getRows(),
+			hasHunkRows: () => this.hunkRows,
+			hasExpandableRows: () => this.expandableRows,
+			toggleRegion: (key) => this.toggleRegion(key),
+			detach: (disposed) => {
+				lentSyntax?.dispose();
+				if (this.view === disposed) this.view = null;
+			}
+		});
+		const lentSyntax = context.getFeature(EDITOR_SNIPPET_TOKENS_FEATURE)?.addSource(snippetTokenSource(this.options.syntaxBackend));
+		this.view = contribution;
+		if (this.lastGutterLayout) contribution.applyGutterLayout(this.lastGutterLayout);
+		return contribution;
+	}
+	publishGutterLayout(layout) {
+		this.lastGutterLayout = layout;
+		this.view?.applyGutterLayout(layout);
+	}
+	createSyntaxController() {
+		return new DiffSyntaxController({
+			side: this.side,
+			backend: this.options.syntaxBackend,
+			enabled: this.options.syntaxHighlight !== false,
+			onDidChangeTokens: () => this.notifyTokens()
+		});
+	}
+};
+function liveDiffDocumentText(context) {
+	return context.materializeFullText();
+}
+function projectRows(file, side, expandedRegions) {
+	if (!file) return [];
+	if (side === "stacked") return createStackedProjection(file, { expandedRegions }).rows;
+	const projection = createSplitProjection(file, { expandedRegions });
+	return side === "old" ? projection.leftRows : projection.rightRows;
+}
+var DiffDecorationContribution = class {
+	context;
+	options;
+	lastTextSnapshot = void 0;
+	constructor(context, options) {
+		this.context = context;
+		this.options = options;
+	}
+	/**
+	* The editor's notification, which is not the same thing as "the text changed".
+	*
+	* Rebuilding an overlay projection materializes the whole document and runs `structuredPatch`
+	* over it, synchronously. `handleEditorChange` also fires for selection-only changes —
+	* `EditorContributionChange.kind` is one of edit/selection/undo/redo/none — and a caret move cannot
+	* alter the diff, so paying for one is pure waste on the typing path. Text-snapshot identity is
+	* the second guard, for the notification paths that carry no change object at all.
+	*
+	* Plugin-state changes (`setBaseFile`, `setEnabled`) call `refresh()` directly and are never
+	* skipped: the text is the same but the diff it produces is not.
+	*/
+	handleEditorChange(change) {
+		if (this.options.mode === "overlay") {
+			if (change?.kind === "selection") return;
+			const snapshot = this.context.getTextSnapshot();
+			if (snapshot !== null && snapshot === this.lastTextSnapshot) return;
+		}
+		this.refresh();
+	}
+	refresh() {
+		this.lastTextSnapshot = this.context.getTextSnapshot();
+		if (this.options.mode === "document") {
+			this.context.setRowDecorations(ROW_DECORATION_SOURCE, diffRowDecorations(this.options.getRows()));
+			return;
+		}
+		this.applyLiveProjection(this.options.buildLiveProjection());
+	}
+	dispose() {
+		if (this.options.mode === "overlay") this.applyLiveProjection(EMPTY_PROJECTION);
+		this.context.clearRowDecorations(ROW_DECORATION_SOURCE);
+	}
+	/**
+	* These three steps are ordered, and the order is load-bearing.
+	*
+	* Announcing the injected-row change first would rebuild the row set before the cells are
+	* repainted, and a row that the rebuild unmounts keeps whatever its cell last rendered — a
+	* disabled live diff would leave a stale `4+` behind on a detached cell. Repainting first, while
+	* that row is still mounted, is what clears it.
+	*
+	* The stored projection has to be current before the repaint, because the gutter reads its rows
+	* from it.
+	*/
+	applyLiveProjection(projection) {
+		this.options.setLiveProjection(projection);
+		this.context.setRowDecorations(ROW_DECORATION_SOURCE, projection.rowDecorations);
+		this.options.notifyInjectedRowsChanged();
+	}
+};
+/** Pointer handling and inline word-diff highlights. */
+var DiffViewContribution = class {
+	context;
+	options;
+	snapshotKey = "diff-inline-v1";
+	pressParticipant;
+	separatorRows;
+	snapshot = null;
+	lastHighlightRows = null;
+	lastHighlightTextVersion = -1;
+	constructor(context, options) {
+		this.context = context;
+		this.options = options;
+		this.context.scrollElement.dataset.editorDiffSide = options.side;
+		viewsByScrollElement.set(this.context.scrollElement, this);
+		this.pressParticipant = this.context.registerPressParticipant(this.claimSeparatorPress);
+		this.separatorRows = this.context.registerNonCaretRows(this.isSeparatorRow);
+		this.context.scrollElement.addEventListener("click", this.handleClick);
+		this.context.scrollElement.addEventListener("mousemove", this.handleMouseMove);
+		this.context.scrollElement.addEventListener("mouseleave", this.handleMouseLeave);
+	}
+	/**
+	* The snapshot is kept for every update kind — the pointer hit-test reads it — but the two
+	* derived jobs below are not per-frame work.
+	*
+	* `update` is called for `'viewport'` too, which `Editor.handleViewportChange` fires on every
+	* scroll frame, and the highlights can only change when the rows or the text do.
+	*/
+	update(snapshot, kind) {
+		this.snapshot = snapshot;
+		if (this.options.mode !== "document") return;
+		if (kind === "viewport" || kind === "selection") return;
+		this.applyInlineHighlights();
+	}
+	captureVisiblePaint(snapshot) {
+		const viewport = this.context.scrollElement.getBoundingClientRect();
+		const rows = this.options.getRows();
+		const ranges = snapshot.visibleRows.flatMap((visible) => {
+			const row = rows[visible.bufferRow];
+			if (!row) return [];
+			const start = snapshot.lineStartsView.at(visible.bufferRow) ?? visible.startOffset;
+			return diffInlineHighlightRanges([row]).map((range) => ({
+				start: range.start + start,
+				end: range.end + start
+			}));
+		});
+		const rectangles = [];
+		for (const range of ranges) {
+			const rect = this.context.getRangeClientRect(range.start, range.end);
+			if (!rect || rect.width <= 0 || rect.height <= 0) continue;
+			rectangles.push({
+				left: rect.left - viewport.left + snapshot.viewport.scrollLeft,
+				top: rect.top - viewport.top + snapshot.viewport.scrollTop,
+				width: rect.width,
+				height: rect.height,
+				backgroundColor: INLINE_HIGHLIGHT_STYLE.backgroundColor
+			});
+		}
+		return {
+			id: `diff-inline-${this.options.side}`,
+			status: "ready",
+			rectangles
+		};
+	}
+	refreshRows() {
+		this.lastHighlightRows = null;
+		this.applyInlineHighlights();
+	}
+	applyGutterLayout(layout) {
+		const style = this.context.scrollElement.style;
+		const columns = layout.lanes.map((lane) => `${lane.width}px`).join(" ");
+		style.setProperty("--editor-diff-gutter-columns", columns);
+		style.setProperty("--editor-diff-gutter-total-width", `${layout.width}px`);
+	}
+	dispose() {
+		this.pressParticipant.dispose();
+		this.separatorRows.dispose();
+		this.context.scrollElement.removeEventListener("click", this.handleClick);
+		this.context.scrollElement.removeEventListener("mousemove", this.handleMouseMove);
+		this.context.scrollElement.removeEventListener("mouseleave", this.handleMouseLeave);
+		this.context.scrollElement.style.cursor = "";
+		if (viewsByScrollElement.get(this.context.scrollElement) === this) viewsByScrollElement.delete(this.context.scrollElement);
+		this.context.clearRangeHighlight(this.options.highlightName);
+		this.options.detach(this);
+	}
+	applyInlineHighlights() {
+		const rows = this.options.getRows();
+		const textVersion = this.snapshot?.textVersion ?? -1;
+		if (rows === this.lastHighlightRows && textVersion === this.lastHighlightTextVersion) return;
+		this.lastHighlightRows = rows;
+		this.lastHighlightTextVersion = textVersion;
+		try {
+			this.context.setRangeHighlight(this.options.highlightName, diffInlineHighlightRanges(rows), INLINE_HIGHLIGHT_STYLE);
+		} catch (error) {
+			this.context.log({
+				action: "editor.diff.inline_highlight_failed",
+				level: "warn",
+				error: { message: error instanceof Error ? error.message : String(error) }
+			});
+		}
+	}
+	/**
+	* Keeps the caret off a separator row, expandable or not.
+	*
+	* A separator is chrome, not content — but its label is real buffer text, because the host's
+	* document is `joinRenderLines(rows)` and there is nowhere else for the label to live. So the
+	* editor will happily rest a caret in the middle of `Show 12 unmodified lines`, and a collapsed
+	* caret copies its own line: Cmd+C would put that sentence on the clipboard. The mousedown is
+	* refused here, and arrow keys step over the row (`isSeparatorRow`). A drag that *crosses* a separator still
+	* covers it, and always will while the label occupies offsets — giving these rows an offset
+	* space of their own is the parallel coordinate system §C2 rules out.
+	*
+	* Every click count, not just the first: a second press would select a word of the label, a
+	* third its line and a fourth the whole document.
+	*/
+	claimSeparatorPress = (event) => event.button === 0 && this.hunkRowAt(event) !== null;
+	/** The keyboard half of the same rule: arrow keys step over a separator. */
+	isSeparatorRow = (bufferRow) => {
+		if (this.options.mode !== "document" || !this.options.hasHunkRows()) return false;
+		return this.options.getRows()[bufferRow]?.type === "hunk";
+	};
+	handleClick = (event) => {
+		if (event.button !== 0) return;
+		const row = this.expandableRowAt(event);
+		if (!row?.expandKey) return;
+		event.preventDefault();
+		this.options.toggleRegion(row.expandKey);
+	};
+	handleMouseMove = (event) => {
+		const cursor = this.expandableRowAt(event) ? "pointer" : "";
+		if (this.context.scrollElement.style.cursor === cursor) return;
+		this.context.scrollElement.style.cursor = cursor;
+	};
+	handleMouseLeave = () => {
+		if (!this.context.scrollElement.style.cursor) return;
+		this.context.scrollElement.style.cursor = "";
+	};
+	expandableRowAt(event) {
+		if (!this.options.hasExpandableRows()) return null;
+		const row = this.hunkRowAt(event);
+		return row?.expandable ? row : null;
+	}
+	/**
+	* The separator under the pointer, whether or not it can be expanded. A partial diff — a plain
+	* patch with no file text behind it — has separators that say how much was skipped and cannot
+	* open them, and those are still not somewhere a caret belongs.
+	*/
+	hunkRowAt(event) {
+		if (!this.options.hasHunkRows()) return null;
+		const hit = this.rowHitAt(event);
+		const row = hit?.rows[hit.rowIndex];
+		return row?.type === "hunk" ? row : null;
+	}
+	/** Only `document` mode has an answer: there a buffer row is an index into `getRows()`. */
+	rowHitAt(event) {
+		if (this.options.mode !== "document") return null;
+		const hit = this.context.rowAtPoint(event.clientX, event.clientY);
+		if (hit?.source !== "document") return null;
+		const rowIndex = hit.bufferRow;
+		const rows = this.options.getRows();
+		return rows[rowIndex] ? {
+			side: this.options.side,
+			rowIndex,
+			rows
+		} : null;
+	}
+};
+function injectedDiffRow(row) {
+	const metadata = row.metadata;
+	if (!metadata || typeof metadata !== "object") return null;
+	return "type" in metadata && "text" in metadata ? metadata : null;
+}
+function snippetTokenSource(backend) {
+	if (backend?.kind === "highlighter") return { highlighter: backend.provider };
+	return { syntax: backend?.provider };
+}
+//#endregion
+export { createDiffPlugin, diffRowAtEvent };
+
+//# sourceMappingURL=editorDiffPlugin.js.map

package/dist/editorDiffPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorDiffPlugin.js","names":[],"sources":["../src/editorDiffPlugin.ts"],"sourcesContent":["import { registerDiffColors } from './theme'\nimport type {\n  EditorContributionChange,\n  EditorDecorationContribution,\n  EditorDecorationContributionContext,\n  EditorDisposable,\n  EditorGutterRowContext,\n  EditorInjectedTextRow,\n  EditorPlugin,\n  EditorPluginContext,\n  EditorSnippetTokenSource,\n  EditorViewContribution,\n  EditorViewContributionContext,\n  EditorViewContributionUpdateKind,\n  EditorViewSnapshot,\n} from '@singapore-editor/core/extensions'\nimport { EDITOR_SNIPPET_TOKENS_FEATURE } from '@singapore-editor/core/extensions'\nimport type { EditorToken } from '@singapore-editor/core/syntax'\nimport { createDiffGutterContribution } from './diffGutter'\nimport { diffInlineHighlightRanges, diffRowDecorations } from './diffRows'\nimport {\n  DiffSyntaxController,\n  type PreparedDiffSyntaxInput,\n  type PreparedDiffSyntaxSource,\n} from './diffSyntax'\nimport {\n  diffGutterDigits,\n  type DiffGutterDigits,\n  type DiffGutterLayout,\n  type DiffGutterSide,\n} from './gutters'\nimport { createLiveDiffProjection, type LiveDiffProjection } from './liveProjection'\nimport { createTextDiff } from './model'\nimport { createSplitProjection, createStackedProjection } from './projection'\nimport { createDiffRegionStore, type DiffRegionStore } from './regions'\nimport type { DiffFile, DiffRenderRow, DiffSyntaxBackend, DiffTextFile } from './types'\n\nexport type DiffPluginMode = 'document' | 'overlay'\n\nexport type DiffPluginOptions = {\n  /**\n   * §C1. `document` is the parity path; `overlay` is explicitly non-parity — see §C2.\n   *\n   * Required, with no default. The factory this replaced took no arguments and was always overlay,\n   * so the natural migration — rename the call, keep the empty argument list — would otherwise\n   * produce a plugin that mounts, registers everything, renders nothing and reports no error,\n   * because `setBaseFile` and `setEnabled` both early-return outside overlay mode.\n   */\n  readonly mode: DiffPluginMode\n  readonly side?: DiffGutterSide\n  /**\n   * Expansion state, shared when a host drives two sides of one diff. Omit it and the plugin keeps\n   * a private store; pass one store to both split plugins and a toggle on either side moves both.\n   * See regions.ts — this is what holds §C7 together.\n   */\n  readonly regions?: DiffRegionStore\n  readonly syntaxBackend?: DiffSyntaxBackend\n  readonly syntaxHighlight?: boolean\n}\n\nexport type DiffPlugin = EditorPlugin & {\n  /**\n   * `document` mode: the file to project. The host owns the editor's text — §C3. `prepared`\n   * streams from `prepareDiffSyntax` for this file paint with the first rows, and a preparation\n   * still running is awaited in place of a second parse; the plugin owns them.\n   */\n  setFile(file: DiffFile | null, prepared?: PreparedDiffSyntaxInput): void\n  /** The current file's parsed streams, handed to the caller; empty while a parse is running. */\n  releasePreparedSyntax(): readonly PreparedDiffSyntaxSource[]\n  getRows(): readonly DiffRenderRow[]\n  /** Both sides in row order. Cached until the file or expansion state changes. */\n  getStackedRows(): readonly DiffRenderRow[]\n  /**\n   * Projected syntax tokens for the current rows. The host passes them with the rows' text,\n   * `setText(text, { tokens })`, or an expansion toggle repaints uncoloured (§C10).\n   */\n  isSyntaxReady(): boolean\n  getTokens(): readonly EditorToken[]\n  onDidChangeRows(listener: () => void): EditorDisposable\n  onDidChangeTokens(listener: () => void): EditorDisposable\n  /** §C5. Hosts must not mirror this. */\n  getExpandedRegions(): ReadonlySet<string>\n  toggleRegion(key: string): void\n\n  /** `overlay` mode: the buffer the live editor text is diffed against. */\n  setBaseFile(file: DiffTextFile | null): void\n  setEnabled(enabled: boolean): void\n}\n\n/** The diff row under a pointer: which pane, that pane's rows, and the index into them. */\nexport type DiffRowHit = {\n  readonly side: DiffGutterSide\n  readonly rowIndex: number\n  readonly rows: readonly DiffRenderRow[]\n}\n\n// How a pointer event finds the plugin that owns the pane under it, so a host never reads row\n// attributes or pane classes to work out where a press landed.\nconst viewsByScrollElement = new WeakMap<Element, DiffViewContribution>()\n\n/** `null` outside a `document`-mode diff pane, or over something that is not a diff row. */\nexport function diffRowAtEvent(event: MouseEvent): DiffRowHit | null {\n  const target = event.target\n  if (!(target instanceof Element)) return null\n\n  const scrollElement = target.closest('[data-editor-diff-side]')\n  if (!scrollElement) return null\n\n  return viewsByScrollElement.get(scrollElement)?.rowHitAt(event) ?? null\n}\n\nconst EMPTY_PROJECTION: LiveDiffProjection = {\n  injectedRows: [],\n  rowDecorations: new Map(),\n  rows: [],\n  rowsByBufferRow: new Map(),\n}\nconst ROW_DECORATION_SOURCE = 'editor.diff'\nconst INLINE_HIGHLIGHT_STYLE = { backgroundColor: 'rgba(255, 255, 255, 0.18)' } as const\n\nlet nextDiffPluginId = 0\n\n/**\n * The one diff plugin (§C1), carrying two internal row-delivery modes.\n *\n * `document` — the editor holds a synthetic buffer of the projected rows and the plugin publishes\n * them for the host to push in. Everything works because the rows are real document lines.\n *\n * `overlay` — the editor holds the host's live, editable buffer and deletions arrive as injected\n * rows. Non-parity by construction; see §C2 and test/overlayModeLimits.test.ts before reaching for\n * it.\n */\nexport function createDiffPlugin(options: DiffPluginOptions): DiffPlugin {\n  registerDiffColors()\n  const runtime = new DiffPluginRuntime(options)\n\n  return {\n    name: `editor-diff-${options.mode}`,\n    activate(context) {\n      return runtime.activate(context)\n    },\n    setFile: (file, prepared) => runtime.setFile(file, prepared),\n    releasePreparedSyntax: () => runtime.releasePreparedSyntax(),\n    getRows: () => runtime.getRows(),\n    getStackedRows: () => runtime.getStackedRows(),\n    getTokens: () => runtime.getTokens(),\n    isSyntaxReady: () => runtime.isSyntaxReady(),\n    onDidChangeRows: (listener) => runtime.onDidChangeRows(listener),\n    onDidChangeTokens: (listener) => runtime.onDidChangeTokens(listener),\n    getExpandedRegions: () => runtime.getExpandedRegions(),\n    toggleRegion: (key) => runtime.toggleRegion(key),\n    setBaseFile: (file) => runtime.setBaseFile(file),\n    setEnabled: (enabled) => runtime.setEnabled(enabled),\n  }\n}\n\nclass DiffPluginRuntime {\n  private readonly id = nextDiffPluginId++\n  private readonly mode: DiffPluginMode\n  private readonly side: DiffGutterSide\n  private syntax: DiffSyntaxController\n  private readonly rowListeners = new Set<() => void>()\n  private readonly tokenListeners = new Set<() => void>()\n\n  private readonly regions: DiffRegionStore\n  private file: DiffFile | null = null\n  private rows: readonly DiffRenderRow[] = []\n  private stackedRows: readonly DiffRenderRow[] | null = null\n  private digits: DiffGutterDigits = { old: 0, new: 0 }\n  private hunkRows = false\n  private expandableRows = false\n\n  private baseFile: DiffTextFile | null = null\n  private enabled: boolean\n  private liveProjection: LiveDiffProjection = EMPTY_PROJECTION\n\n  private decoration: DiffDecorationContribution | null = null\n  private view: DiffViewContribution | null = null\n  private injectedRowsListener: (() => void) | null = null\n  private lastGutterLayout: DiffGutterLayout | null = null\n  private readonly regionSubscription: EditorDisposable\n\n  constructor(private readonly options: DiffPluginOptions) {\n    this.mode = options.mode\n    this.side = options.side ?? 'stacked'\n    this.regions = options.regions ?? createDiffRegionStore()\n    // A shared store means the sibling side's toggle lands here too.\n    //\n    // Held for the plugin's whole life, and never released. Every narrower lifetime is wrong:\n    //\n    // - torn down with the ACTIVATION, next to the syntax controller, which is the obvious place:\n    //   the first deactivation is then terminal. The plugin is re-activated against a fresh editor,\n    //   renders correctly, and is silently deaf to every expansion toggle after that. React\n    //   StrictMode makes mount -> unmount -> mount the normal development path, so a host that gets\n    //   this wrong sees gutter clicks do nothing at all.\n    // - created only on activation: a plugin driven headlessly as a projection source, with no\n    //   editor behind it, never sees its own `toggleRegion`.\n    // - released from `EditorPlugin.dispose`: that fires when an editor tears down, and a React\n    //   host reuses the same plugin instance across the next editor — so this is the first case\n    //   again with an extra step.\n    //\n    // Nothing leaks by holding it. The listener lives in the store, the store is the host's, and a\n    // host drops both together; a plugin the host builds and never mounts — StrictMode\n    // double-invokes the `useMemo` that builds one — is collected with it.\n    this.regionSubscription = this.regions.onDidChange(() => this.handleRegionsChanged())\n    // Overlay mode is switched on by the host once it has a base file; document mode is live from\n    // the moment it has one.\n    this.enabled = this.mode === 'document'\n    this.syntax = this.createSyntaxController()\n  }\n\n  activate(context: EditorPluginContext): EditorDisposable[] {\n    // A controller disposed by a previous deactivation is dead for good — its scheduler is\n    // terminal, so `schedule()` returns an inactive handle forever and the diff would render\n    // permanently uncoloured after a remove-then-re-add. The core supports that cycle\n    // (`Editor.setPlugins`), so the controller's lifetime is the activation's, not the plugin's.\n    //\n    // Only a *replacement* controller needs the file pushed into it. Doing it unconditionally\n    // re-parses a file the surviving controller is already holding — and when the host sets the\n    // file before constructing the editor, which is the natural order, that means cancelling an\n    // in-flight parse to start an identical one. Under shiki that is two worker owners for one\n    // file.\n    if (this.syntax.isDisposed()) {\n      this.syntax = this.createSyntaxController()\n      if (this.file) this.syntax.setFile(this.file, this.rows)\n    }\n\n    const disposables: EditorDisposable[] = [\n      context.registerGutterContribution(\n        createDiffGutterContribution({\n          side: this.side,\n          tint: this.mode === 'document' ? 'row' : 'cell',\n          getDigits: () => this.gutterDigits(),\n          resolveRow: (row) => this.resolveGutterRow(row),\n          isEnabled: () => this.enabled,\n          onLayout: (layout) => this.publishGutterLayout(layout),\n        }),\n      ),\n      context.registerDecorationContribution({\n        createContribution: (featureContext) => this.createDecorationContribution(featureContext),\n      }),\n      context.registerViewContribution({\n        createContribution: (viewContext) => this.createViewContribution(viewContext),\n      }),\n      { dispose: () => this.syntax.dispose() },\n    ]\n\n    if (this.mode === 'overlay') {\n      disposables.push(\n        context.registerInjectedTextRowProvider({\n          getInjectedTextRows: () => this.injectedRows(),\n          onDidChangeInjectedTextRows: (listener) => this.setInjectedRowsListener(listener),\n        }),\n      )\n    }\n\n    return disposables\n  }\n\n  // ---------------------------------------------------------------- document mode (§C3, §C5)\n\n  setFile(file: DiffFile | null, prepared: PreparedDiffSyntaxInput = []): void {\n    if (this.mode !== 'document') {\n      void Promise.resolve(prepared).then(\n        (sources) => {\n          for (const source of sources) source.dispose()\n        },\n        () => undefined,\n      )\n      return\n    }\n\n    this.file = file\n    // The store decides whether this counts as the same diff, and drops expansion if not. Both\n    // sides of a split share it, so both are told once.\n    this.regions.setFile(file)\n    this.rebuildRows()\n    this.syntax.setFile(file, this.rows, prepared)\n    this.notifyRows()\n  }\n\n  releasePreparedSyntax(): readonly PreparedDiffSyntaxSource[] {\n    return this.syntax.release()\n  }\n\n  getRows(): readonly DiffRenderRow[] {\n    if (this.mode === 'overlay') return this.liveProjection.rows\n    return this.rows\n  }\n\n  getStackedRows(): readonly DiffRenderRow[] {\n    if (this.mode === 'overlay') return this.liveProjection.rows\n    if (this.side === 'stacked') return this.rows\n    this.stackedRows ??= projectRows(this.file, 'stacked', this.regions.getExpandedRegions())\n    return this.stackedRows\n  }\n\n  isSyntaxReady(): boolean {\n    return this.syntax.isReady()\n  }\n\n  getTokens(): readonly EditorToken[] {\n    return this.syntax.getTokens()\n  }\n\n  getExpandedRegions(): ReadonlySet<string> {\n    return this.regions.getExpandedRegions()\n  }\n\n  toggleRegion(key: string): void {\n    if (this.mode !== 'document') return\n    if (!this.file) return\n\n    // The store fans the change back to every plugin reading it, this one included, so the rebuild\n    // happens in `handleRegionsChanged` rather than here.\n    this.regions.toggleRegion(key)\n  }\n\n  private handleRegionsChanged(): void {\n    if (this.mode !== 'document') return\n    if (!this.file) return\n\n    this.rebuildRows()\n    // Same file, different rows: the parsed token streams still apply, so this re-projects\n    // synchronously and `getTokens()` is correct before the host's `setText` returns (§C10).\n    this.syntax.setRows(this.rows)\n    this.notifyRows()\n  }\n\n  onDidChangeRows(listener: () => void): EditorDisposable {\n    this.rowListeners.add(listener)\n    return { dispose: () => this.rowListeners.delete(listener) }\n  }\n\n  onDidChangeTokens(listener: () => void): EditorDisposable {\n    this.tokenListeners.add(listener)\n    return { dispose: () => this.tokenListeners.delete(listener) }\n  }\n\n  private rebuildRows(): void {\n    this.stackedRows = null\n    this.rows = projectRows(this.file, this.side, this.regions.getExpandedRegions())\n    // Both derived once here rather than per gutter-width recompute and per mousemove.\n    this.digits = diffGutterDigits(this.rows)\n    this.hunkRows = this.rows.some((row) => row.type === 'hunk')\n    this.expandableRows = this.rows.some((row) => row.type === 'hunk' && row.expandable === true)\n  }\n\n  private notifyRows(): void {\n    for (const listener of this.rowListeners) listener()\n    this.decoration?.refresh()\n    this.view?.refreshRows()\n  }\n\n  private notifyTokens(): void {\n    for (const listener of this.tokenListeners) listener()\n  }\n\n  // ---------------------------------------------------------------- overlay mode\n\n  setBaseFile(file: DiffTextFile | null): void {\n    if (this.mode !== 'overlay') return\n\n    this.baseFile = file\n    this.decoration?.refresh()\n  }\n\n  setEnabled(enabled: boolean): void {\n    if (this.mode !== 'overlay') return\n\n    this.enabled = enabled\n    this.decoration?.refresh()\n  }\n\n  private injectedRows(): readonly EditorInjectedTextRow[] {\n    if (!this.enabled) return []\n    return this.liveProjection.injectedRows\n  }\n\n  private setInjectedRowsListener(listener: () => void): EditorDisposable {\n    this.injectedRowsListener = listener\n    return {\n      dispose: () => {\n        if (this.injectedRowsListener === listener) this.injectedRowsListener = null\n      },\n    }\n  }\n\n  private gutterDigits(): DiffGutterDigits {\n    if (this.mode === 'overlay') return diffGutterDigits(this.liveProjection.rows)\n    return this.digits\n  }\n\n  /**\n   * Which diff row a rendered gutter row is showing. The two modes cannot share an answer.\n   *\n   * `document` — §C4 holds, so the projection index is the buffer row and a positional lookup is\n   * correct.\n   *\n   * `overlay` — the projection array interleaves injected deletion rows, so position and buffer\n   * row diverge from the first deletion onwards; the mapping the projection publishes for exactly\n   * this purpose is `rowsByBufferRow`, keyed `newLineNumber - 1`. An injected row is not in that\n   * map at all and carries its own row as metadata instead.\n   */\n  private resolveGutterRow(row: EditorGutterRowContext): DiffRenderRow | null {\n    if (this.mode === 'overlay') {\n      if (row.source === 'injected') return injectedDiffRow(row)\n      if (row.source !== 'document') return null\n      return this.liveProjection.rowsByBufferRow.get(row.bufferRow) ?? null\n    }\n\n    if (row.source !== 'document') return null\n    return this.rows[row.bufferRow] ?? null\n  }\n\n  // ---------------------------------------------------------------- contributions\n\n  private createDecorationContribution(\n    context: EditorDecorationContributionContext,\n  ): EditorDecorationContribution {\n    const contribution = new DiffDecorationContribution(context, {\n      mode: this.mode,\n      getRows: () => this.rows,\n      buildLiveProjection: () => this.buildLiveProjection(context),\n      setLiveProjection: (projection) => {\n        this.liveProjection = projection\n      },\n      notifyInjectedRowsChanged: () => this.injectedRowsListener?.(),\n    })\n    this.decoration = contribution\n    contribution.refresh()\n    return {\n      handleEditorChange: (change) => contribution.handleEditorChange(change),\n      dispose: () => {\n        if (this.decoration === contribution) this.decoration = null\n        contribution.dispose()\n      },\n    }\n  }\n\n  private buildLiveProjection(context: EditorDecorationContributionContext): LiveDiffProjection {\n    if (!this.enabled) return EMPTY_PROJECTION\n    if (!this.baseFile) return EMPTY_PROJECTION\n    if (!context.hasDocument()) return EMPTY_PROJECTION\n\n    const file = createTextDiff({\n      oldFile: this.baseFile,\n      newFile: {\n        path: this.baseFile.path,\n        text: liveDiffDocumentText(context),\n        languageId: this.baseFile.languageId,\n      },\n    })\n    return createLiveDiffProjection(file)\n  }\n\n  private createViewContribution(\n    context: EditorViewContributionContext,\n  ): EditorViewContribution | null {\n    const contribution = new DiffViewContribution(context, {\n      highlightName: `editor-diff-${this.id}-${this.side}-inline`,\n      mode: this.mode,\n      side: this.side,\n      getRows: () => this.getRows(),\n      hasHunkRows: () => this.hunkRows,\n      hasExpandableRows: () => this.expandableRows,\n      toggleRegion: (key) => this.toggleRegion(key),\n      detach: (disposed) => {\n        lentSyntax?.dispose()\n        if (this.view === disposed) this.view = null\n      },\n    })\n    const lentSyntax = context\n      .getFeature(EDITOR_SNIPPET_TOKENS_FEATURE)\n      ?.addSource(snippetTokenSource(this.options.syntaxBackend))\n    this.view = contribution\n    if (this.lastGutterLayout) contribution.applyGutterLayout(this.lastGutterLayout)\n    return contribution\n  }\n\n  private publishGutterLayout(layout: DiffGutterLayout): void {\n    // Retained, never consumed. `width()` can run before a view contribution exists, and a\n    // contribution can be torn down and rebuilt later on a fresh scroll element carrying none of\n    // these custom properties. The gutter memoizes on the layout, so it will not republish an\n    // unchanged one — leaving a replacement contribution with no other way to learn the geometry,\n    // and `.editor-diff-gutter` falling back to `1fr 1fr 12px`, which is the drift the whole\n    // custom-property dance exists to avoid.\n    this.lastGutterLayout = layout\n    this.view?.applyGutterLayout(layout)\n  }\n\n  private createSyntaxController(): DiffSyntaxController {\n    return new DiffSyntaxController({\n      side: this.side,\n      backend: this.options.syntaxBackend,\n      enabled: this.options.syntaxHighlight !== false,\n      onDidChangeTokens: () => this.notifyTokens(),\n    })\n  }\n}\n\n// A live diff compares whole documents, and the diff library takes strings: an explicit extraction.\nfunction liveDiffDocumentText(context: EditorDecorationContributionContext): string {\n  return context.materializeFullText()\n}\n\nfunction projectRows(\n  file: DiffFile | null,\n  side: DiffGutterSide,\n  expandedRegions: ReadonlySet<string>,\n): readonly DiffRenderRow[] {\n  if (!file) return []\n  if (side === 'stacked') return createStackedProjection(file, { expandedRegions }).rows\n\n  const projection = createSplitProjection(file, { expandedRegions })\n  return side === 'old' ? projection.leftRows : projection.rightRows\n}\n\ntype DiffDecorationOptions = {\n  readonly mode: DiffPluginMode\n  readonly getRows: () => readonly DiffRenderRow[]\n  readonly buildLiveProjection: () => LiveDiffProjection\n  readonly setLiveProjection: (projection: LiveDiffProjection) => void\n  readonly notifyInjectedRowsChanged: () => void\n}\n\nclass DiffDecorationContribution {\n  private lastTextSnapshot: unknown = undefined\n\n  constructor(\n    private readonly context: EditorDecorationContributionContext,\n    private readonly options: DiffDecorationOptions,\n  ) {}\n\n  /**\n   * The editor's notification, which is not the same thing as \"the text changed\".\n   *\n   * Rebuilding an overlay projection materializes the whole document and runs `structuredPatch`\n   * over it, synchronously. `handleEditorChange` also fires for selection-only changes —\n   * `EditorContributionChange.kind` is one of edit/selection/undo/redo/none — and a caret move cannot\n   * alter the diff, so paying for one is pure waste on the typing path. Text-snapshot identity is\n   * the second guard, for the notification paths that carry no change object at all.\n   *\n   * Plugin-state changes (`setBaseFile`, `setEnabled`) call `refresh()` directly and are never\n   * skipped: the text is the same but the diff it produces is not.\n   */\n  handleEditorChange(change: EditorContributionChange | null): void {\n    if (this.options.mode === 'overlay') {\n      if (change?.kind === 'selection') return\n\n      const snapshot = this.context.getTextSnapshot()\n      if (snapshot !== null && snapshot === this.lastTextSnapshot) return\n    }\n\n    this.refresh()\n  }\n\n  refresh(): void {\n    this.lastTextSnapshot = this.context.getTextSnapshot()\n    if (this.options.mode === 'document') {\n      this.context.setRowDecorations(\n        ROW_DECORATION_SOURCE,\n        diffRowDecorations(this.options.getRows()),\n      )\n      return\n    }\n\n    this.applyLiveProjection(this.options.buildLiveProjection())\n  }\n\n  dispose(): void {\n    if (this.options.mode === 'overlay') this.applyLiveProjection(EMPTY_PROJECTION)\n    this.context.clearRowDecorations(ROW_DECORATION_SOURCE)\n  }\n\n  /**\n   * These three steps are ordered, and the order is load-bearing.\n   *\n   * Announcing the injected-row change first would rebuild the row set before the cells are\n   * repainted, and a row that the rebuild unmounts keeps whatever its cell last rendered — a\n   * disabled live diff would leave a stale `4+` behind on a detached cell. Repainting first, while\n   * that row is still mounted, is what clears it.\n   *\n   * The stored projection has to be current before the repaint, because the gutter reads its rows\n   * from it.\n   */\n  private applyLiveProjection(projection: LiveDiffProjection): void {\n    this.options.setLiveProjection(projection)\n    this.context.setRowDecorations(ROW_DECORATION_SOURCE, projection.rowDecorations)\n    this.options.notifyInjectedRowsChanged()\n  }\n}\n\ntype DiffViewOptions = {\n  readonly highlightName: string\n  readonly mode: DiffPluginMode\n  readonly side: DiffGutterSide\n  readonly getRows: () => readonly DiffRenderRow[]\n  readonly hasHunkRows: () => boolean\n  readonly hasExpandableRows: () => boolean\n  readonly toggleRegion: (key: string) => void\n  readonly detach: (contribution: DiffViewContribution) => void\n}\n\n/** Pointer handling and inline word-diff highlights. */\nclass DiffViewContribution implements EditorViewContribution {\n  readonly snapshotKey = 'diff-inline-v1'\n  private readonly pressParticipant: EditorDisposable\n  private readonly separatorRows: EditorDisposable\n  private snapshot: EditorViewSnapshot | null = null\n  private lastHighlightRows: readonly DiffRenderRow[] | null = null\n  private lastHighlightTextVersion = -1\n\n  constructor(\n    private readonly context: EditorViewContributionContext,\n    private readonly options: DiffViewOptions,\n  ) {\n    this.context.scrollElement.dataset.editorDiffSide = options.side\n    viewsByScrollElement.set(this.context.scrollElement, this)\n    this.pressParticipant = this.context.registerPressParticipant(this.claimSeparatorPress)\n    this.separatorRows = this.context.registerNonCaretRows(this.isSeparatorRow)\n    this.context.scrollElement.addEventListener('click', this.handleClick)\n    this.context.scrollElement.addEventListener('mousemove', this.handleMouseMove)\n    this.context.scrollElement.addEventListener('mouseleave', this.handleMouseLeave)\n  }\n\n  /**\n   * The snapshot is kept for every update kind — the pointer hit-test reads it — but the two\n   * derived jobs below are not per-frame work.\n   *\n   * `update` is called for `'viewport'` too, which `Editor.handleViewportChange` fires on every\n   * scroll frame, and the highlights can only change when the rows or the text do.\n   */\n  update(snapshot: EditorViewSnapshot, kind: EditorViewContributionUpdateKind): void {\n    this.snapshot = snapshot\n    if (this.options.mode !== 'document') return\n    if (kind === 'viewport' || kind === 'selection') return\n\n    this.applyInlineHighlights()\n  }\n\n  captureVisiblePaint(snapshot: EditorViewSnapshot) {\n    const viewport = this.context.scrollElement.getBoundingClientRect()\n    const rows = this.options.getRows()\n    const ranges = snapshot.visibleRows.flatMap((visible) => {\n      const row = rows[visible.bufferRow]\n      if (!row) return []\n      const start = snapshot.lineStartsView.at(visible.bufferRow) ?? visible.startOffset\n      return diffInlineHighlightRanges([row]).map((range) => ({\n        start: range.start + start,\n        end: range.end + start,\n      }))\n    })\n    const rectangles = []\n    for (const range of ranges) {\n      const rect = this.context.getRangeClientRect(range.start, range.end)\n      if (!rect || rect.width <= 0 || rect.height <= 0) continue\n      rectangles.push({\n        left: rect.left - viewport.left + snapshot.viewport.scrollLeft,\n        top: rect.top - viewport.top + snapshot.viewport.scrollTop,\n        width: rect.width,\n        height: rect.height,\n        backgroundColor: INLINE_HIGHLIGHT_STYLE.backgroundColor,\n      })\n    }\n    return { id: `diff-inline-${this.options.side}`, status: 'ready' as const, rectangles }\n  }\n\n  refreshRows(): void {\n    this.lastHighlightRows = null\n    this.applyInlineHighlights()\n  }\n\n  applyGutterLayout(layout: DiffGutterLayout): void {\n    // §3.3 trap 1: the canvas derived lane geometry arithmetically, so a DOM gutter has to hand CSS\n    // the same numbers rather than approximate them with `1fr 1fr 12px`.\n    const style = this.context.scrollElement.style\n    const columns = layout.lanes.map((lane) => `${lane.width}px`).join(' ')\n    style.setProperty('--editor-diff-gutter-columns', columns)\n    style.setProperty('--editor-diff-gutter-total-width', `${layout.width}px`)\n  }\n\n  dispose(): void {\n    this.pressParticipant.dispose()\n    this.separatorRows.dispose()\n    this.context.scrollElement.removeEventListener('click', this.handleClick)\n    this.context.scrollElement.removeEventListener('mousemove', this.handleMouseMove)\n    this.context.scrollElement.removeEventListener('mouseleave', this.handleMouseLeave)\n    this.context.scrollElement.style.cursor = ''\n    // A replacement view on the same element may already have registered itself.\n    if (viewsByScrollElement.get(this.context.scrollElement) === this) {\n      viewsByScrollElement.delete(this.context.scrollElement)\n    }\n    this.context.clearRangeHighlight(this.options.highlightName)\n    // Or the runtime keeps writing highlights and gutter geometry through a torn-down context,\n    // and holds its scroll element alive for the plugin's lifetime.\n    this.options.detach(this)\n  }\n\n  // A highlight failure must not dispose the contribution and disable gutter expansion.\n  private applyInlineHighlights(): void {\n    const rows = this.options.getRows()\n    const textVersion = this.snapshot?.textVersion ?? -1\n    // Rows alone cannot key this: the view clamps ranges to the text it holds when they are set,\n    // and the host pushes the new text only after the rows notification that first lands here.\n    if (rows === this.lastHighlightRows && textVersion === this.lastHighlightTextVersion) return\n\n    this.lastHighlightRows = rows\n    this.lastHighlightTextVersion = textVersion\n    try {\n      this.context.setRangeHighlight(\n        this.options.highlightName,\n        diffInlineHighlightRanges(rows),\n        INLINE_HIGHLIGHT_STYLE,\n      )\n    } catch (error) {\n      this.context.log({\n        action: 'editor.diff.inline_highlight_failed',\n        level: 'warn',\n        error: { message: error instanceof Error ? error.message : String(error) },\n      })\n    }\n  }\n\n  /**\n   * Keeps the caret off a separator row, expandable or not.\n   *\n   * A separator is chrome, not content — but its label is real buffer text, because the host's\n   * document is `joinRenderLines(rows)` and there is nowhere else for the label to live. So the\n   * editor will happily rest a caret in the middle of `Show 12 unmodified lines`, and a collapsed\n   * caret copies its own line: Cmd+C would put that sentence on the clipboard. The mousedown is\n   * refused here, and arrow keys step over the row (`isSeparatorRow`). A drag that *crosses* a separator still\n   * covers it, and always will while the label occupies offsets — giving these rows an offset\n   * space of their own is the parallel coordinate system §C2 rules out.\n   *\n   * Every click count, not just the first: a second press would select a word of the label, a\n   * third its line and a fourth the whole document.\n   */\n  private readonly claimSeparatorPress = (event: MouseEvent): boolean =>\n    event.button === 0 && this.hunkRowAt(event) !== null\n\n  /** The keyboard half of the same rule: arrow keys step over a separator. */\n  private readonly isSeparatorRow = (bufferRow: number): boolean => {\n    if (this.options.mode !== 'document' || !this.options.hasHunkRows()) return false\n    return this.options.getRows()[bufferRow]?.type === 'hunk'\n  }\n\n  private readonly handleClick = (event: MouseEvent): void => {\n    if (event.button !== 0) return\n\n    const row = this.expandableRowAt(event)\n    if (!row?.expandKey) return\n\n    event.preventDefault()\n    this.options.toggleRegion(row.expandKey)\n  }\n\n  private readonly handleMouseMove = (event: MouseEvent): void => {\n    const cursor = this.expandableRowAt(event) ? 'pointer' : ''\n    if (this.context.scrollElement.style.cursor === cursor) return\n\n    this.context.scrollElement.style.cursor = cursor\n  }\n\n  private readonly handleMouseLeave = (): void => {\n    if (!this.context.scrollElement.style.cursor) return\n\n    this.context.scrollElement.style.cursor = ''\n  }\n\n  private expandableRowAt(event: MouseEvent): DiffRenderRow | null {\n    // Avoid a point query on every mousemove when no separator can expand.\n    if (!this.options.hasExpandableRows()) return null\n\n    const row = this.hunkRowAt(event)\n    return row?.expandable ? row : null\n  }\n\n  /**\n   * The separator under the pointer, whether or not it can be expanded. A partial diff — a plain\n   * patch with no file text behind it — has separators that say how much was skipped and cannot\n   * open them, and those are still not somewhere a caret belongs.\n   */\n  private hunkRowAt(event: MouseEvent): DiffRenderRow | null {\n    if (!this.options.hasHunkRows()) return null\n\n    const hit = this.rowHitAt(event)\n    const row = hit?.rows[hit.rowIndex]\n    return row?.type === 'hunk' ? row : null\n  }\n\n  /** Only `document` mode has an answer: there a buffer row is an index into `getRows()`. */\n  rowHitAt(event: MouseEvent): DiffRowHit | null {\n    if (this.options.mode !== 'document') return null\n\n    const hit = this.context.rowAtPoint(event.clientX, event.clientY)\n    if (hit?.source !== 'document') return null\n    const rowIndex = hit.bufferRow\n\n    const rows = this.options.getRows()\n    return rows[rowIndex] ? { side: this.options.side, rowIndex, rows } : null\n  }\n}\n\nfunction injectedDiffRow(row: EditorGutterRowContext): DiffRenderRow | null {\n  const metadata = row.metadata\n  if (!metadata || typeof metadata !== 'object') return null\n  return 'type' in metadata && 'text' in metadata ? (metadata as DiffRenderRow) : null\n}\n\nfunction snippetTokenSource(backend: DiffSyntaxBackend | undefined): EditorSnippetTokenSource {\n  if (backend?.kind === 'highlighter') return { highlighter: backend.provider }\n  return { syntax: backend?.provider }\n}\n"],"mappings":"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"}

package/dist/editorOptions.d.ts

@@ -0,0 +1,15 @@
+import type { EditorOptions } from '@singapore-editor/core/editor';
+import { type EditorKeymapOptions } from '@singapore-editor/core/keymap';
+import type { EditorCursorLineHighlightOptions } from '@singapore-editor/core/rendering';
+export type DiffEditorOptions = Required<Pick<EditorOptions, 'detectIndentation' | 'documentMode' | 'editability' | 'folding'>> & {
+    readonly cursorLineHighlight: Required<EditorCursorLineHighlightOptions>;
+    readonly keymap: DiffKeymap;
+};
+type DiffKeymap = Readonly<Required<Pick<EditorKeymapOptions, 'defaultBindings' | 'layers'>>>;
+/**
+ * The options an editor holding a `mode: 'document'` diff needs; an overlay diff keeps its host's
+ * editable options. Spread them and add the host's own, such as plugins, typography and theme.
+ */
+export declare function createDiffEditorOptions(): DiffEditorOptions;
+export {};
+//# sourceMappingURL=editorOptions.d.ts.map

package/dist/editorOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorOptions.d.ts","sourceRoot":"","sources":["../src/editorOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAA;AACtC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAA;AAGxF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CACtC,IAAI,CAAC,aAAa,EAAE,mBAAmB,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC,CACtF,GAAG;IACF,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,gCAAgC,CAAC,CAAA;IACxE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B,CAAA;AAED,KAAK,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAY7F;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAc3D"}