@pierre/diffs 1.3.0-beta.1 → 1.3.0-beta.11

package/dist/react/CodeView.d.ts

@@ -1,6 +1,5 @@
-import { CodeViewItem, CodeViewScrollTarget, DiffLineAnnotation, LineAnnotation } from "../types.js";
+import { CodeViewCreateEditorOptions, CodeViewItem, CodeViewScrollTarget, DiffLineAnnotation, DiffsEditor, FileContents, LineAnnotation } from "../types.js";
 import { GetHoveredLineResult } from "../managers/InteractionManager.js";
-import "../index.js";
 import { CodeView as CodeView$1, CodeViewLineSelection, CodeViewOptions } from "../components/CodeView.js";
 import { CSSProperties, ReactNode, Ref } from "react";
 
@@ -15,8 +14,32 @@ interface CodeViewBaseProps<LAnnotation> {
   selectedLines?: CodeViewLineSelection | null;
   onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;
   onScroll?(scrollTop: number, viewer: CodeView$1<LAnnotation>): void;
+  /** Render a non-virtualized node at the very start of the scroll content,
+   * before the first item. Always rendered; scrolls with the content. */
+  renderCodeViewHeader?(): ReactNode;
+  /** Render a non-virtualized node at the very end of the scroll content, after
+   * the last item. Always rendered; scrolls with the content. */
+  renderCodeViewFooter?(): ReactNode;
+  /**
+   * Enables editing for items with `edit: true`. Pass the given options into
+   * the editor constructor — `new Editor(options)` from `@pierre/diffs/editor`
+   * — so document changes route to `onItemEditChange` and
+   * `onItemEditComplete`. CodeView owns the returned editor's lifecycle.
+   */
+  createEditor?(options: CodeViewCreateEditorOptions<LAnnotation>): DiffsEditor<LAnnotation> | undefined;
+  /** Called with the owning item on every edited-document change. */
+  onItemEditChange?(item: CodeViewItem<LAnnotation>, file: FileContents, lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): void;
+  /**
+   * Called once with the final contents when an item's edit session ends
+   * (edit turned off, item removed or collapsed). Not called for sessions
+   * that produced no changes. Committing is user-space: make one combined
+   * item write carrying the new file/fileDiff (with a fresh `cacheKey`,
+   * since the contents changed) along with `edit: false`.
+   */
+  onItemEditComplete?(item: CodeViewItem<LAnnotation>, file: FileContents, lineAnnotations?: DiffLineAnnotation<LAnnotation>[]): void;
   renderCustomHeader?(item: CodeViewItem<LAnnotation>): ReactNode;
   renderHeaderPrefix?(item: CodeViewItem<LAnnotation>): ReactNode;
+  renderHeaderFilenameSuffix?(item: CodeViewItem<LAnnotation>): ReactNode;
   renderHeaderMetadata?(item: CodeViewItem<LAnnotation>): ReactNode;
   renderAnnotation?(annotation: LineAnnotation<LAnnotation> | DiffLineAnnotation<LAnnotation>, item: CodeViewItem<LAnnotation>): ReactNode;
   renderGutterUtility?(getHoveredLine: CodeViewGutterUtilityGetter, item: CodeViewItem<LAnnotation>): ReactNode;
@@ -39,6 +62,7 @@ interface CodeViewHandle<LAnnotation> {
   setSelectedLines(selection: CodeViewLineSelection | null): void;
   getSelectedLines(): CodeViewLineSelection | null;
   clearSelectedLines(): void;
+  getEditor(id: string): DiffsEditor<LAnnotation> | undefined;
   getInstance(): CodeView$1<LAnnotation> | undefined;
 }
 type CodeViewComponent = <LAnnotation = undefined>(props: CodeViewProps<LAnnotation> & {

package/dist/react/CodeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodeView.d.ts","names":["CSSProperties","ReactNode","Ref","CodeView","CodeViewClass","CodeViewItem","CodeViewLineSelection","CodeViewOptions","CodeViewScrollTarget","DiffLineAnnotation","GetHoveredLineResult","LineAnnotation","CodeViewGutterUtilityGetter","CodeViewBaseProps","LAnnotation","HTMLDivElement","ControlledCodeViewProps","UncontrolledCodeViewProps","CodeViewProps","CodeViewHandle","CodeViewComponent","React","JSX","Element"],"sources":["../../src/react/CodeView.d.ts"],"sourcesContent":["import { type CSSProperties, type ReactNode, type Ref } from 'react';\nimport { CodeView as CodeViewClass, type CodeViewItem, type CodeViewLineSelection, type CodeViewOptions, type CodeViewScrollTarget, type DiffLineAnnotation, type GetHoveredLineResult, type LineAnnotation } from '../index';\ntype CodeViewGutterUtilityGetter = (() => GetHoveredLineResult<'file'> | undefined) | (() => GetHoveredLineResult<'diff'> | undefined);\ninterface CodeViewBaseProps<LAnnotation> {\n    options?: CodeViewOptions<LAnnotation>;\n    className?: string;\n    style?: CSSProperties;\n    containerRef?: Ref<HTMLDivElement>;\n    disableWorkerPool?: boolean;\n    selectedLines?: CodeViewLineSelection | null;\n    onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n    onScroll?(scrollTop: number, viewer: CodeViewClass<LAnnotation>): void;\n    renderCustomHeader?(item: CodeViewItem<LAnnotation>): ReactNode;\n    renderHeaderPrefix?(item: CodeViewItem<LAnnotation>): ReactNode;\n    renderHeaderMetadata?(item: CodeViewItem<LAnnotation>): ReactNode;\n    renderAnnotation?(annotation: LineAnnotation<LAnnotation> | DiffLineAnnotation<LAnnotation>, item: CodeViewItem<LAnnotation>): ReactNode;\n    renderGutterUtility?(getHoveredLine: CodeViewGutterUtilityGetter, item: CodeViewItem<LAnnotation>): ReactNode;\n}\nexport interface ControlledCodeViewProps<LAnnotation> extends CodeViewBaseProps<LAnnotation> {\n    items: readonly CodeViewItem<LAnnotation>[];\n    initialItems?: never;\n}\nexport interface UncontrolledCodeViewProps<LAnnotation> extends CodeViewBaseProps<LAnnotation> {\n    initialItems?: readonly CodeViewItem<LAnnotation>[];\n    items?: never;\n}\nexport type CodeViewProps<LAnnotation = undefined> = ControlledCodeViewProps<LAnnotation> | UncontrolledCodeViewProps<LAnnotation>;\nexport interface CodeViewHandle<LAnnotation> {\n    addItems(items: readonly CodeViewItem<LAnnotation>[]): void;\n    getItem(id: string): CodeViewItem<LAnnotation> | undefined;\n    updateItem(item: CodeViewItem<LAnnotation>): boolean;\n    updateItemId(oldId: string, newId: string): boolean;\n    scrollTo(target: CodeViewScrollTarget): void;\n    setSelectedLines(selection: CodeViewLineSelection | null): void;\n    getSelectedLines(): CodeViewLineSelection | null;\n    clearSelectedLines(): void;\n    getInstance(): CodeViewClass<LAnnotation> | undefined;\n}\ntype CodeViewComponent = <LAnnotation = undefined>(props: CodeViewProps<LAnnotation> & {\n    ref?: React.Ref<CodeViewHandle<LAnnotation>>;\n}) => React.JSX.Element;\nexport declare const CodeView: CodeViewComponent;\nexport {};\n//# sourceMappingURL=CodeView.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"CodeView.d.ts","names":[],"sources":["../../src/react/CodeView.tsx"],"mappings":";;;;;;KA6CK,2BAAA,UACM,oBAAA,+BACA,oBAAoB;AAAA,UAErB,iBAAA;EACR,OAAA,GAAU,eAAA,CAAgB,WAAA;EAC1B,SAAA;EACA,KAAA,GAAQ,aAAA;EACR,YAAA,GAAe,GAAA,CAAI,cAAA;EACnB,iBAAA;EACA,aAAA,GAAgB,qBAAA;EAChB,qBAAA,EAAuB,SAAA,EAAW,qBAAA;EAClC,QAAA,EAAU,SAAA,UAAmB,MAAA,EAAQ,UAAA,CAAc,WAAA;EAR3C;;EAWR,oBAAA,KAAyB,SAAA;EAVC;;EAa1B,oBAAA,KAAyB,SAAA;EAVN;;;;;;EAiBnB,YAAA,EACE,OAAA,EAAS,2BAAA,CAA4B,WAAA,IACpC,WAAA,CAAY,WAAA;EATU;EAWzB,gBAAA,EACE,IAAA,EAAM,YAAA,CAAa,WAAA,GACnB,IAAA,EAAM,YAAA,EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EAN5B;;;;;;;EAeX,kBAAA,EACE,IAAA,EAAM,YAAA,CAAa,WAAA,GACnB,IAAA,EAAM,YAAA,EACN,eAAA,GAAkB,kBAAA,CAAmB,WAAA;EAEvC,kBAAA,EAAoB,IAAA,EAAM,YAAA,CAAa,WAAA,IAAe,SAAA;EACtD,kBAAA,EAAoB,IAAA,EAAM,YAAA,CAAa,WAAA,IAAe,SAAA;EACtD,0BAAA,EAA4B,IAAA,EAAM,YAAA,CAAa,WAAA,IAAe,SAAA;EAC9D,oBAAA,EAAsB,IAAA,EAAM,YAAA,CAAa,WAAA,IAAe,SAAA;EACxD,gBAAA,EACE,UAAA,EAAY,cAAA,CAAe,WAAA,IAAe,kBAAA,CAAmB,WAAA,GAC7D,IAAA,EAAM,YAAA,CAAa,WAAA,IAClB,SAAA;EACH,mBAAA,EACE,cAAA,EAAgB,2BAAA,EAChB,IAAA,EAAM,YAAA,CAAa,WAAA,IAClB,SAAA;AAAA;AAAA,UAGY,uBAAA,sBAEP,iBAAA,CAAkB,WAAA;EAC1B,KAAA,WAAgB,YAAA,CAAa,WAAA;EAC7B,YAAA;AAAA;AAAA,UAGe,yBAAA,sBAEP,iBAAA,CAAkB,WAAA;EAG1B,YAAA,YAAwB,YAAA,CAAa,WAAA;EACrC,KAAA;AAAA;AAAA,KAGU,aAAA,4BACR,uBAAA,CAAwB,WAAA,IACxB,yBAAA,CAA0B,WAAA;AAAA,UAEb,cAAA;EACf,QAAA,CAAS,KAAA,WAAgB,YAAA,CAAa,WAAA;EACtC,OAAA,CAAQ,EAAA,WAAa,YAAA,CAAa,WAAA;EAClC,UAAA,CAAW,IAAA,EAAM,YAAA,CAAa,WAAA;EAC9B,YAAA,CAAa,KAAA,UAAe,KAAA;EAC5B,QAAA,CAAS,MAAA,EAAQ,oBAAA;EACjB,gBAAA,CAAiB,SAAA,EAAW,qBAAA;EAC5B,gBAAA,IAAoB,qBAAA;EACpB,kBAAA;EACA,SAAA,CAAU,EAAA,WAAa,WAAA,CAAY,WAAA;EACnC,WAAA,IAAe,UAAA,CAAc,WAAA;AAAA;AAAA,KAG1B,iBAAA,6BACH,KAAA,EAAO,aAAA,CAAc,WAAA;EACnB,GAAA,GAAM,KAAA,CAAM,GAAA,CAAI,cAAA,CAAe,WAAA;AAAA,MAE9B,KAAA,CAAM,GAAA,CAAI,OAAA;AAAA,cAqcF,QAAA,EAAwC,iBAAiB"}

package/dist/react/CodeView.js

@@ -1,9 +1,7 @@
-'use client';
-
-
+"use client";
+import { areManagedSnapshotsEqual } from "../utils/areManagedSnapshotsEqual.js";
 import { areOptionsEqual } from "../utils/areOptionsEqual.js";
 import { CodeView as CodeView$1 } from "../components/CodeView.js";
-import { areManagedSnapshotsEqual } from "../utils/areManagedSnapshotsEqual.js";
 import { renderDiffChildren } from "./utils/renderDiffChildren.js";
 import { renderFileChildren } from "./utils/renderFileChildren.js";
 import { useStableCallback } from "./utils/useStableCallback.js";
@@ -11,7 +9,6 @@ import { WorkerPoolContext } from "./WorkerPoolContext.js";
 import { forwardRef, memo, useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal, flushSync } from "react-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-
 //#region src/react/CodeView.tsx
 const useIsometricEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
 function createDefaultCache(controlled) {
@@ -25,32 +22,54 @@ function createDefaultCache(controlled) {
 	};
 }
 function CodeViewInner(props, ref) {
-	const { className, containerRef, disableWorkerPool = false, initialItems, items: controlledItems, onScroll, onSelectedLinesChange, options, renderAnnotation, renderCustomHeader, renderGutterUtility, renderHeaderMetadata, renderHeaderPrefix, selectedLines, style } = props;
+	const { className, containerRef, createEditor, disableWorkerPool = false, initialItems, items: controlledItems, onItemEditChange, onItemEditComplete, onScroll, onSelectedLinesChange, options, renderAnnotation, renderCodeViewFooter, renderCodeViewHeader, renderCustomHeader, renderGutterUtility, renderHeaderFilenameSuffix, renderHeaderMetadata, renderHeaderPrefix, selectedLines, style } = props;
 	const controlled = controlledItems !== void 0;
 	const poolManager = useContext(WorkerPoolContext);
 	const cachedDataRef = useRef(createDefaultCache(controlled));
 	const hasCustomHeader = renderCustomHeader != null;
 	const hasAnnotationRenderer = renderAnnotation != null;
 	const hasGutterRenderer = renderGutterUtility != null;
-	const hasHeaderRenderers = hasCustomHeader || renderHeaderPrefix != null || renderHeaderMetadata != null;
+	const hasHeaderRenderers = hasCustomHeader || renderHeaderPrefix != null || renderHeaderFilenameSuffix != null || renderHeaderMetadata != null;
 	const hasRenderers = hasHeaderRenderers || hasAnnotationRenderer || hasGutterRenderer;
+	const hasCodeViewHeader = renderCodeViewHeader != null;
+	const hasCodeViewFooter = renderCodeViewFooter != null;
 	const emitSelectedLinesChange = useStableCallback((selection) => {
 		onSelectedLinesChange?.(selection);
 	});
 	const controlledSelection = selectedLines !== void 0;
+	const stableCreateEditor = useStableCallback((editorOptions) => createEditor?.(editorOptions));
+	const emitItemEditChange = useStableCallback((item, file, lineAnnotations) => {
+		onItemEditChange?.(item, file, lineAnnotations);
+	});
+	const emitItemEditComplete = useStableCallback((item, file, lineAnnotations) => {
+		onItemEditComplete?.(item, file, lineAnnotations);
+	});
 	const managedOptions = useMemo(() => createManagedCodeViewOptions({
 		options,
 		hasCustomHeader,
 		hasGutterRenderer,
+		hasCodeViewHeader,
+		hasCodeViewFooter,
 		onSelectedLinesChange: onSelectedLinesChange != null ? emitSelectedLinesChange : void 0,
-		controlledSelection
+		controlledSelection,
+		createEditor: createEditor != null ? stableCreateEditor : void 0,
+		onItemEditChange: onItemEditChange != null ? emitItemEditChange : void 0,
+		onItemEditComplete: onItemEditComplete != null ? emitItemEditComplete : void 0
 	}), [
 		options,
 		hasCustomHeader,
 		hasGutterRenderer,
+		hasCodeViewHeader,
+		hasCodeViewFooter,
 		onSelectedLinesChange,
 		emitSelectedLinesChange,
-		controlledSelection
+		controlledSelection,
+		createEditor,
+		stableCreateEditor,
+		onItemEditChange,
+		emitItemEditChange,
+		onItemEditComplete,
+		emitItemEditComplete
 	]);
 	const [slotContentStore] = useState(() => createSlotContentStore());
 	const [, forceUpdate] = useState({});
@@ -74,7 +93,7 @@ function CodeViewInner(props, ref) {
 		});
 	});
 	const slotCoordinator = useMemo(() => {
-		if (!hasHeaderRenderers && !hasAnnotationRenderer && !hasGutterRenderer) return;
+		if (!hasHeaderRenderers && !hasAnnotationRenderer && !hasGutterRenderer && !hasCodeViewHeader && !hasCodeViewFooter) return;
 		else return {
 			hasHeaderRenderers,
 			hasAnnotationRenderer,
@@ -85,7 +104,9 @@ function CodeViewInner(props, ref) {
 		onSnapshotChange,
 		hasAnnotationRenderer,
 		hasGutterRenderer,
-		hasHeaderRenderers
+		hasHeaderRenderers,
+		hasCodeViewHeader,
+		hasCodeViewFooter
 	]);
 	useIsometricEffect(() => {
 		return onScroll != null ? cachedDataRef.current.instance?.subscribeToScroll(onScroll) : void 0;
@@ -139,8 +160,8 @@ function CodeViewInner(props, ref) {
 	});
 	useImperativeHandle(ref, () => ({
 		addItems(items) {
-			const { controlled: controlled$1, instance } = cachedDataRef.current;
-			assertUncontrolledCodeViewAction(controlled$1, "addItems");
+			const { controlled, instance } = cachedDataRef.current;
+			assertUncontrolledCodeViewAction(controlled, "addItems");
 			if (instance == null) console.error("CodeView.addItems: no valid instance to append items with", items);
 			else instance.addItems(items);
 		},
@@ -152,8 +173,8 @@ function CodeViewInner(props, ref) {
 			} else return instance.getItem(id);
 		},
 		updateItem(item) {
-			const { controlled: controlled$1, instance } = cachedDataRef.current;
-			assertUncontrolledCodeViewAction(controlled$1, "updateItem");
+			const { controlled, instance } = cachedDataRef.current;
+			assertUncontrolledCodeViewAction(controlled, "updateItem");
 			if (instance == null) {
 				console.error("CodeView.updateItem: no valid instance to update item with", item);
 				return false;
@@ -161,8 +182,8 @@ function CodeViewInner(props, ref) {
 			return instance.updateItem(item);
 		},
 		updateItemId(oldId, newId) {
-			const { controlled: controlled$1, instance } = cachedDataRef.current;
-			assertUncontrolledCodeViewAction(controlled$1, "updateItemId");
+			const { controlled, instance } = cachedDataRef.current;
+			assertUncontrolledCodeViewAction(controlled, "updateItemId");
 			if (instance == null) {
 				console.error("CodeView.updateItemId: no valid instance to update item id with", oldId, newId);
 				return false;
@@ -197,6 +218,14 @@ function CodeViewInner(props, ref) {
 				emitSelectedLinesChange(null);
 			}
 		},
+		getEditor(id) {
+			const { instance } = cachedDataRef.current;
+			if (instance == null) {
+				console.error("CodeView.getEditor: no valid instance exists", id);
+				return;
+			}
+			return instance.getEditor(id);
+		},
 		getInstance() {
 			return cachedDataRef.current.instance;
 		}
@@ -205,13 +234,16 @@ function CodeViewInner(props, ref) {
 		ref: nodeRef,
 		className,
 		style
-	}), hasRenderers && /* @__PURE__ */ jsx(SlotPortals, {
+	}), (hasRenderers || hasCodeViewHeader || hasCodeViewFooter) && /* @__PURE__ */ jsx(SlotPortals, {
 		managedContentStore: slotContentStore,
 		renderCustomHeader,
 		renderHeaderPrefix,
+		renderHeaderFilenameSuffix,
 		renderHeaderMetadata,
 		renderAnnotation,
-		renderGutterUtility
+		renderGutterUtility,
+		renderCodeViewHeader,
+		renderCodeViewFooter
 	})] });
 }
 const CodeView = forwardRef(CodeViewInner);
@@ -250,38 +282,65 @@ function createSlotContentStore() {
 		}
 	};
 }
-function createManagedCodeViewOptions({ options, hasCustomHeader, hasGutterRenderer, onSelectedLinesChange, controlledSelection }) {
-	if (!hasCustomHeader && !hasGutterRenderer && onSelectedLinesChange == null && !controlledSelection) return options;
+function createManagedCodeViewOptions({ options, hasCustomHeader, hasGutterRenderer, hasCodeViewHeader, hasCodeViewFooter, onSelectedLinesChange, controlledSelection, createEditor, onItemEditChange, onItemEditComplete }) {
+	if (!hasCustomHeader && !hasGutterRenderer && !hasCodeViewHeader && !hasCodeViewFooter && onSelectedLinesChange == null && !controlledSelection && createEditor == null && onItemEditChange == null && onItemEditComplete == null) return options ?? {};
 	options = {
 		...options,
 		controlledSelection,
 		onSelectedLinesChange
 	};
+	if (createEditor != null) options.createEditor = createEditor;
+	if (onItemEditChange != null) options.onItemEditChange = onItemEditChange;
+	if (onItemEditComplete != null) options.onItemEditComplete = onItemEditComplete;
 	if (hasCustomHeader) options.renderCustomHeader = noopRender;
 	if (hasGutterRenderer) options.renderGutterUtility = noopRender;
+	if (hasCodeViewHeader) options.renderCodeViewHeader = noopRender;
+	if (hasCodeViewFooter) options.renderCodeViewFooter = noopRender;
 	return options;
 }
-const SlotPortals = memo(function SlotPortals$1({ managedContentStore, renderCustomHeader, renderHeaderPrefix, renderHeaderMetadata, renderAnnotation, renderGutterUtility }) {
+const SlotPortals = memo(function SlotPortals({ managedContentStore, renderCustomHeader, renderHeaderPrefix, renderHeaderFilenameSuffix, renderHeaderMetadata, renderAnnotation, renderGutterUtility, renderCodeViewHeader, renderCodeViewFooter }) {
+	"use no memo";
 	const subscribe = useStableCallback((listener) => managedContentStore.subscribe(listener));
 	const getSnapshot = useStableCallback(() => managedContentStore.getSnapshot());
-	return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)?.map((renderedItem) => {
-		return createPortal(renderCodeViewItemChildren({
-			renderedItem,
+	const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+	let itemKeys = "";
+	for (const item of snapshot?.items ?? []) itemKeys += `${item.id}:${item.version}:${item.type}`;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		useMemo(() => {
+			return snapshot?.items?.map((renderedItem) => createPortal(renderCodeViewItemChildren({
+				renderedItem,
+				renderCustomHeader,
+				renderHeaderPrefix,
+				renderHeaderFilenameSuffix,
+				renderHeaderMetadata,
+				renderAnnotation,
+				renderGutterUtility
+			}), renderedItem.element, renderedItem.id));
+		}, [
 			renderCustomHeader,
 			renderHeaderPrefix,
+			renderHeaderFilenameSuffix,
 			renderHeaderMetadata,
 			renderAnnotation,
-			renderGutterUtility
-		}), renderedItem.element, renderedItem.id);
-	});
+			renderGutterUtility,
+			itemKeys
+		]),
+		useMemo(() => {
+			return renderCodeViewHeader != null && snapshot?.header != null ? createPortal(renderCodeViewHeader(), snapshot.header) : null;
+		}, [renderCodeViewHeader, snapshot?.header]),
+		useMemo(() => {
+			return renderCodeViewFooter != null && snapshot?.footer != null ? createPortal(renderCodeViewFooter(), snapshot.footer) : null;
+		}, [renderCodeViewFooter, snapshot?.footer])
+	] });
 });
-function renderCodeViewItemChildren({ renderedItem, renderCustomHeader, renderHeaderPrefix, renderHeaderMetadata, renderAnnotation, renderGutterUtility }) {
+function renderCodeViewItemChildren({ renderedItem, renderCustomHeader, renderHeaderPrefix, renderHeaderFilenameSuffix, renderHeaderMetadata, renderAnnotation, renderGutterUtility }) {
 	if (renderedItem.type === "diff") {
 		const { item, instance } = renderedItem;
 		return renderDiffChildren({
 			fileDiff: item.fileDiff,
 			renderCustomHeader: renderCustomHeader != null ? () => renderCustomHeader(item) : void 0,
 			renderHeaderPrefix: renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : void 0,
+			renderHeaderFilenameSuffix: renderHeaderFilenameSuffix != null ? () => renderHeaderFilenameSuffix(item) : void 0,
 			renderHeaderMetadata: renderHeaderMetadata != null ? () => renderHeaderMetadata(item) : void 0,
 			renderAnnotation: renderAnnotation != null ? (annotation) => renderAnnotation(annotation, item) : void 0,
 			lineAnnotations: item.annotations,
@@ -294,6 +353,7 @@ function renderCodeViewItemChildren({ renderedItem, renderCustomHeader, renderHe
 			file: item.file,
 			renderCustomHeader: renderCustomHeader != null ? () => renderCustomHeader(item) : void 0,
 			renderHeaderPrefix: renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : void 0,
+			renderHeaderFilenameSuffix: renderHeaderFilenameSuffix != null ? () => renderHeaderFilenameSuffix(item) : void 0,
 			renderHeaderMetadata: renderHeaderMetadata != null ? () => renderHeaderMetadata(item) : void 0,
 			renderAnnotation: renderAnnotation != null ? (annotation) => renderAnnotation(annotation, item) : void 0,
 			lineAnnotations: item.annotations,
@@ -303,7 +363,7 @@ function renderCodeViewItemChildren({ renderedItem, renderCustomHeader, renderHe
 	}
 }
 function noopRender() {}
-
 //#endregion
 export { CodeView };
+
 //# sourceMappingURL=CodeView.js.map

package/dist/react/CodeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"CodeView.js","names":["CodeViewClass","slotCoordinator: CodeViewCoordinator<LAnnotation> | undefined","controlled","snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined","SlotPortals"],"sources":["../../src/react/CodeView.tsx"],"sourcesContent":["'use client';\n\nimport {\n  type CSSProperties,\n  forwardRef,\n  memo,\n  type ReactNode,\n  type Ref,\n  useContext,\n  useEffect,\n  useImperativeHandle,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { createPortal, flushSync } from 'react-dom';\n\nimport {\n  areOptionsEqual,\n  CodeView as CodeViewClass,\n  type CodeViewCoordinator,\n  type CodeViewItem,\n  type CodeViewLineSelection,\n  type CodeViewOptions,\n  type CodeViewRenderedItem,\n  type CodeViewScrollTarget,\n  type DiffLineAnnotation,\n  type GetHoveredLineResult,\n  type LineAnnotation,\n} from '../index';\nimport { areManagedSnapshotsEqual } from '../utils/areManagedSnapshotsEqual';\nimport { renderDiffChildren } from './utils/renderDiffChildren';\nimport { renderFileChildren } from './utils/renderFileChildren';\nimport { useStableCallback } from './utils/useStableCallback';\nimport { WorkerPoolContext } from './WorkerPoolContext';\n\nconst useIsometricEffect =\n  typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\ntype CodeViewGutterUtilityGetter =\n  | (() => GetHoveredLineResult<'file'> | undefined)\n  | (() => GetHoveredLineResult<'diff'> | undefined);\n\ninterface CodeViewBaseProps<LAnnotation> {\n  options?: CodeViewOptions<LAnnotation>;\n  className?: string;\n  style?: CSSProperties;\n  containerRef?: Ref<HTMLDivElement>;\n  disableWorkerPool?: boolean;\n  selectedLines?: CodeViewLineSelection | null;\n  onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n  onScroll?(scrollTop: number, viewer: CodeViewClass<LAnnotation>): void;\n  renderCustomHeader?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderHeaderPrefix?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderHeaderMetadata?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderAnnotation?(\n    annotation: LineAnnotation<LAnnotation> | DiffLineAnnotation<LAnnotation>,\n    item: CodeViewItem<LAnnotation>\n  ): ReactNode;\n  renderGutterUtility?(\n    getHoveredLine: CodeViewGutterUtilityGetter,\n    item: CodeViewItem<LAnnotation>\n  ): ReactNode;\n}\n\nexport interface ControlledCodeViewProps<\n  LAnnotation,\n> extends CodeViewBaseProps<LAnnotation> {\n  items: readonly CodeViewItem<LAnnotation>[];\n  initialItems?: never;\n}\n\nexport interface UncontrolledCodeViewProps<\n  LAnnotation,\n> extends CodeViewBaseProps<LAnnotation> {\n  // Seeds the imperative CodeView instance once. Later item changes should go\n  // through the ref API instead of being reconciled from React props.\n  initialItems?: readonly CodeViewItem<LAnnotation>[];\n  items?: never;\n}\n\nexport type CodeViewProps<LAnnotation = undefined> =\n  | ControlledCodeViewProps<LAnnotation>\n  | UncontrolledCodeViewProps<LAnnotation>;\n\nexport interface CodeViewHandle<LAnnotation> {\n  addItems(items: readonly CodeViewItem<LAnnotation>[]): void;\n  getItem(id: string): CodeViewItem<LAnnotation> | undefined;\n  updateItem(item: CodeViewItem<LAnnotation>): boolean;\n  updateItemId(oldId: string, newId: string): boolean;\n  scrollTo(target: CodeViewScrollTarget): void;\n  setSelectedLines(selection: CodeViewLineSelection | null): void;\n  getSelectedLines(): CodeViewLineSelection | null;\n  clearSelectedLines(): void;\n  getInstance(): CodeViewClass<LAnnotation> | undefined;\n}\n\ntype CodeViewComponent = <LAnnotation = undefined>(\n  props: CodeViewProps<LAnnotation> & {\n    ref?: React.Ref<CodeViewHandle<LAnnotation>>;\n  }\n) => React.JSX.Element;\n\ntype SlotPortalsComponent = <LAnnotation = undefined>(\n  props: SlotPortalsProps<LAnnotation>\n) => React.JSX.Element;\n\ninterface ManagedContentStore<LAnnotation> {\n  getSnapshot(): CodeViewRenderedItem<LAnnotation>[] | undefined;\n  publish(snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined): void;\n  subscribe(listener: () => void): () => void;\n}\n\ninterface CachedDataRef<LAnnotation> {\n  instance: CodeViewClass<LAnnotation> | undefined;\n  items: readonly CodeViewItem<LAnnotation>[] | undefined;\n  controlled: boolean;\n  managedOptions: CodeViewOptions<LAnnotation> | undefined;\n  disableFlushSync: boolean;\n  slotCoordinator: CodeViewCoordinator<LAnnotation> | undefined;\n}\n\nfunction createDefaultCache<LAnnotation>(\n  controlled: boolean\n): CachedDataRef<LAnnotation> {\n  return {\n    instance: undefined,\n    items: undefined,\n    controlled,\n    managedOptions: undefined,\n    disableFlushSync: false,\n    slotCoordinator: undefined,\n  };\n}\n\nfunction CodeViewInner<LAnnotation = undefined>(\n  props: CodeViewProps<LAnnotation>,\n  ref: React.ForwardedRef<CodeViewHandle<LAnnotation>>\n): React.JSX.Element {\n  const {\n    className,\n    containerRef,\n    disableWorkerPool = false,\n    initialItems,\n    items: controlledItems,\n    onScroll,\n    onSelectedLinesChange,\n    options,\n    renderAnnotation,\n    renderCustomHeader,\n    renderGutterUtility,\n    renderHeaderMetadata,\n    renderHeaderPrefix,\n    selectedLines,\n    style,\n  } = props;\n  const controlled = controlledItems !== undefined;\n  const poolManager = useContext(WorkerPoolContext);\n  const cachedDataRef = useRef<CachedDataRef<LAnnotation>>(\n    createDefaultCache<LAnnotation>(controlled)\n  );\n  const hasCustomHeader = renderCustomHeader != null;\n  const hasAnnotationRenderer = renderAnnotation != null;\n  const hasGutterRenderer = renderGutterUtility != null;\n  const hasHeaderRenderers =\n    hasCustomHeader ||\n    renderHeaderPrefix != null ||\n    renderHeaderMetadata != null;\n  const hasRenderers =\n    hasHeaderRenderers || hasAnnotationRenderer || hasGutterRenderer;\n  const emitSelectedLinesChange = useStableCallback(\n    (selection: CodeViewLineSelection | null) => {\n      onSelectedLinesChange?.(selection);\n    }\n  );\n  const controlledSelection = selectedLines !== undefined;\n\n  const managedOptions = useMemo(\n    () =>\n      createManagedCodeViewOptions({\n        options,\n        hasCustomHeader,\n        hasGutterRenderer,\n        onSelectedLinesChange:\n          onSelectedLinesChange != null ? emitSelectedLinesChange : undefined,\n        controlledSelection,\n      }),\n    [\n      options,\n      hasCustomHeader,\n      hasGutterRenderer,\n      onSelectedLinesChange,\n      emitSelectedLinesChange,\n      controlledSelection,\n    ]\n  );\n\n  const [slotContentStore] = useState<ManagedContentStore<LAnnotation>>(() =>\n    createSlotContentStore()\n  );\n  const [, forceUpdate] = useState<unknown>({});\n\n  const nodeRef = useStableCallback((node: HTMLDivElement | null) => {\n    // If we have a pre-existing instance and there's no node or the node being\n    // passed in is NOT the same as before, then we need to clean up and\n    // garbage collect the old instance\n    if (\n      cachedDataRef.current.instance != null &&\n      (node == null ||\n        node !== cachedDataRef.current.instance.getContainerElement())\n    ) {\n      cachedDataRef.current.instance.cleanUp();\n      slotContentStore.publish(undefined);\n      cachedDataRef.current = createDefaultCache<LAnnotation>(controlled);\n    }\n\n    // If our node matches the existing node then we should not attempt to\n    // setup.  This is a case that should never be possible to hit, but just in\n    // case, lets make sure we don't re-setup an instance that is already setup\n    // properly\n    if (\n      node != null &&\n      node !== cachedDataRef.current.instance?.getContainerElement()\n    ) {\n      cachedDataRef.current.instance = new CodeViewClass<LAnnotation>(\n        managedOptions,\n        !disableWorkerPool ? poolManager : undefined,\n        true\n      );\n      cachedDataRef.current.instance.setup(node);\n    }\n\n    if (typeof containerRef === 'function') {\n      containerRef(node);\n    } else if (containerRef != null) {\n      containerRef.current = node;\n    }\n  });\n\n  const onSnapshotChange = useStableCallback(\n    (snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined) => {\n      if (cachedDataRef.current.disableFlushSync) {\n        slotContentStore.publish(snapshot);\n      } else {\n        flushSync(() => {\n          slotContentStore.publish(snapshot);\n        });\n      }\n    }\n  );\n\n  const slotCoordinator: CodeViewCoordinator<LAnnotation> | undefined =\n    useMemo(() => {\n      if (!hasHeaderRenderers && !hasAnnotationRenderer && !hasGutterRenderer) {\n        return undefined;\n      } else {\n        return {\n          hasHeaderRenderers,\n          hasAnnotationRenderer,\n          hasGutterRenderer,\n          onSnapshotChange,\n        };\n      }\n    }, [\n      onSnapshotChange,\n      hasAnnotationRenderer,\n      hasGutterRenderer,\n      hasHeaderRenderers,\n    ]);\n\n  useIsometricEffect(() => {\n    return onScroll != null\n      ? cachedDataRef.current.instance?.subscribeToScroll(onScroll)\n      : undefined;\n  });\n\n  useIsometricEffect(() => {\n    const {\n      instance,\n      controlled: prevControlled,\n      items: prevItems,\n      managedOptions: prevManagedOptions,\n      slotCoordinator: prevSlotCoordinator,\n    } = cachedDataRef.current;\n    if (instance == null) {\n      return;\n    }\n\n    try {\n      cachedDataRef.current.disableFlushSync = true;\n      let shouldRender = false;\n\n      if (!areOptionsEqual(managedOptions, prevManagedOptions)) {\n        cachedDataRef.current.managedOptions = managedOptions;\n        instance.setOptions(managedOptions);\n        shouldRender = true;\n      }\n\n      if (prevControlled !== controlled) {\n        console.error(\n          'CodeView: cannot switch between controlled and uncontrolled modes. Remount with a new key instead.'\n        );\n        return;\n      }\n\n      if (controlled) {\n        if (controlledItems !== prevItems) {\n          if (areItemListsEqual(prevItems, controlledItems)) {\n            cachedDataRef.current.items = controlledItems;\n          } else if (isAppendOnlyItemUpdate(prevItems, controlledItems)) {\n            cachedDataRef.current.items = controlledItems;\n            instance.addItems(controlledItems.slice(prevItems.length));\n          } else {\n            cachedDataRef.current.items = controlledItems;\n            instance.setItems(controlledItems);\n            shouldRender = true;\n          }\n        }\n      }\n      // If uncontrolled, we should only ever set items once, and just depend\n      // on imperative instance changes going forward\n      else if (prevItems == null) {\n        const seedItems = initialItems ?? [];\n        cachedDataRef.current.items = seedItems;\n        if (seedItems.length > 0) {\n          instance.setItems(seedItems);\n          shouldRender = true;\n        }\n      }\n\n      if (selectedLines !== undefined) {\n        instance.setSelectedLines(selectedLines, { notify: false });\n      }\n\n      const slotPublish = instance.setSlotCoordinator(slotCoordinator);\n      let forceInlinePublish = false;\n      if (slotCoordinator !== prevSlotCoordinator) {\n        if (slotCoordinator == null || prevSlotCoordinator == null) {\n          forceInlinePublish = true;\n        }\n        cachedDataRef.current.slotCoordinator = slotCoordinator;\n      }\n\n      if (shouldRender || slotPublish) {\n        instance.render(true);\n      }\n\n      // FIXME(amadeus): This feels kinda bad and flakey with regards to how\n      // other things are working... it makes me think that we should\n      // re-architect the slotCoordinator a bit, and maybe DON'T make it an\n      // undefineable thing...\n      if (slotPublish && slotCoordinator == null) {\n        slotContentStore.publish(undefined);\n      }\n\n      if (forceInlinePublish) {\n        forceUpdate({});\n      }\n    } finally {\n      cachedDataRef.current.disableFlushSync = false;\n    }\n  });\n\n  // Setup the ref handler\n  useImperativeHandle(\n    ref,\n    (): CodeViewHandle<LAnnotation> => ({\n      addItems(items) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'addItems');\n        if (instance == null) {\n          console.error(\n            'CodeView.addItems: no valid instance to append items with',\n            items\n          );\n        } else {\n          instance.addItems(items);\n        }\n      },\n      getItem(id) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error('CodeView.getItem: no valid instance exists', id);\n          return undefined;\n        } else {\n          return instance.getItem(id);\n        }\n      },\n      updateItem(item) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'updateItem');\n        if (instance == null) {\n          console.error(\n            'CodeView.updateItem: no valid instance to update item with',\n            item\n          );\n          return false;\n        }\n\n        return instance.updateItem(item);\n      },\n      updateItemId(oldId, newId) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'updateItemId');\n        if (instance == null) {\n          console.error(\n            'CodeView.updateItemId: no valid instance to update item id with',\n            oldId,\n            newId\n          );\n          return false;\n        }\n\n        return instance.updateItemId(oldId, newId);\n      },\n      scrollTo(target) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.scrollTo: no valid instance to scroll with',\n            target\n          );\n        } else {\n          instance.scrollTo(target);\n        }\n      },\n      setSelectedLines(selection) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.setSelectedLines: no valid instance to update selection with',\n            selection\n          );\n        } else {\n          instance.setSelectedLines(selection, { notify: false });\n          emitSelectedLinesChange(selection);\n        }\n      },\n      getSelectedLines() {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error('CodeView.getSelectedLines: no valid instance exists');\n          return null;\n        } else {\n          return instance.getSelectedLines();\n        }\n      },\n      clearSelectedLines() {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.clearSelectedLines: no valid instance to update selection with'\n          );\n        } else {\n          instance.clearSelectedLines({ notify: false });\n          emitSelectedLinesChange(null);\n        }\n      },\n      getInstance() {\n        return cachedDataRef.current.instance;\n      },\n    }),\n    [emitSelectedLinesChange]\n  );\n\n  return (\n    <>\n      <div ref={nodeRef} className={className} style={style} />\n      {hasRenderers && (\n        <SlotPortals<LAnnotation>\n          managedContentStore={slotContentStore}\n          renderCustomHeader={renderCustomHeader}\n          renderHeaderPrefix={renderHeaderPrefix}\n          renderHeaderMetadata={renderHeaderMetadata}\n          renderAnnotation={renderAnnotation}\n          renderGutterUtility={renderGutterUtility}\n        />\n      )}\n    </>\n  );\n}\n\n// React was a mistake\nexport const CodeView = forwardRef(CodeViewInner) as CodeViewComponent;\n\nfunction isAppendOnlyItemUpdate<LAnnotation>(\n  previousItems: readonly CodeViewItem<LAnnotation>[] | undefined,\n  nextItems: readonly CodeViewItem<LAnnotation>[]\n): previousItems is readonly CodeViewItem<LAnnotation>[] {\n  if (previousItems == null || nextItems.length <= previousItems.length) {\n    return false;\n  }\n\n  if (previousItems.length === 0) {\n    return true;\n  }\n\n  for (let index = 0; index < previousItems.length; index++) {\n    if (nextItems[index] !== previousItems[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction areItemListsEqual<LAnnotation>(\n  previousItems: readonly CodeViewItem<LAnnotation>[] | undefined,\n  nextItems: readonly CodeViewItem<LAnnotation>[]\n): boolean {\n  if (previousItems == null || previousItems.length !== nextItems.length) {\n    return false;\n  }\n\n  for (let index = 0; index < previousItems.length; index++) {\n    if (previousItems[index] !== nextItems[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction assertUncontrolledCodeViewAction(\n  controlled: boolean,\n  action: string\n): void {\n  if (!controlled) {\n    return;\n  }\n\n  throw new Error(\n    `CodeView.${action} cannot be used when CodeView is controlled. Use initialItems for imperative item updates.`\n  );\n}\n\nfunction createSlotContentStore<\n  LAnnotation,\n>(): ManagedContentStore<LAnnotation> {\n  let snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined;\n  const listeners = new Set<() => void>();\n\n  return {\n    getSnapshot() {\n      return snapshot;\n    },\n    publish(nextSnapshot) {\n      if (areManagedSnapshotsEqual(snapshot, nextSnapshot)) {\n        return;\n      }\n\n      snapshot = nextSnapshot;\n      for (const listener of listeners) {\n        listener();\n      }\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\ninterface CreateManagedCodeViewOptionsProps<LAnnotation> {\n  options: CodeViewOptions<LAnnotation> | undefined;\n  hasCustomHeader: boolean;\n  hasGutterRenderer: boolean;\n  onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n  controlledSelection: boolean;\n}\n\nfunction createManagedCodeViewOptions<LAnnotation>({\n  options,\n  hasCustomHeader,\n  hasGutterRenderer,\n  onSelectedLinesChange,\n  controlledSelection,\n}: CreateManagedCodeViewOptionsProps<LAnnotation>):\n  | CodeViewOptions<LAnnotation>\n  | undefined {\n  if (\n    !hasCustomHeader &&\n    !hasGutterRenderer &&\n    onSelectedLinesChange == null &&\n    !controlledSelection\n  ) {\n    return options;\n  }\n  options = { ...options, controlledSelection, onSelectedLinesChange };\n\n  // The imperative CodeView adapters use this callback's presence to\n  // switch file and diff headers into custom-slot mode. React portals\n  // provide the actual header content, so this placeholder\n  // intentionally returns nothing.\n  if (hasCustomHeader) {\n    options.renderCustomHeader = noopRender;\n  }\n\n  // The imperative CodeView adapters use this callback's presence to\n  // create the custom gutter utility slot. React portals provide the\n  // actual content, so this placeholder intentionally returns nothing.\n  if (hasGutterRenderer) {\n    options.renderGutterUtility = noopRender;\n  }\n\n  return options;\n}\n\ninterface RenderCodeViewItemChildrenProps<LAnnotation> {\n  renderedItem: CodeViewRenderedItem<LAnnotation>;\n  renderCustomHeader: CodeViewBaseProps<LAnnotation>['renderCustomHeader'];\n  renderHeaderPrefix: CodeViewBaseProps<LAnnotation>['renderHeaderPrefix'];\n  renderHeaderMetadata: CodeViewBaseProps<LAnnotation>['renderHeaderMetadata'];\n  renderAnnotation: CodeViewBaseProps<LAnnotation>['renderAnnotation'];\n  renderGutterUtility: CodeViewBaseProps<LAnnotation>['renderGutterUtility'];\n}\n\ninterface SlotPortalsProps<LAnnotation> {\n  managedContentStore: ManagedContentStore<LAnnotation>;\n  renderCustomHeader: CodeViewBaseProps<LAnnotation>['renderCustomHeader'];\n  renderHeaderPrefix: CodeViewBaseProps<LAnnotation>['renderHeaderPrefix'];\n  renderHeaderMetadata: CodeViewBaseProps<LAnnotation>['renderHeaderMetadata'];\n  renderAnnotation: CodeViewBaseProps<LAnnotation>['renderAnnotation'];\n  renderGutterUtility: CodeViewBaseProps<LAnnotation>['renderGutterUtility'];\n}\n\nconst SlotPortals = memo(function SlotPortals<LAnnotation>({\n  managedContentStore,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderMetadata,\n  renderAnnotation,\n  renderGutterUtility,\n}: SlotPortalsProps<LAnnotation>) {\n  const subscribe = useStableCallback((listener: () => void) =>\n    managedContentStore.subscribe(listener)\n  );\n  const getSnapshot = useStableCallback(() =>\n    managedContentStore.getSnapshot()\n  );\n  const renderedItems = useSyncExternalStore<\n    CodeViewRenderedItem<LAnnotation>[] | undefined\n  >(subscribe, getSnapshot, getSnapshot);\n  return renderedItems?.map((renderedItem) => {\n    return createPortal(\n      renderCodeViewItemChildren({\n        renderedItem,\n        renderCustomHeader,\n        renderHeaderPrefix,\n        renderHeaderMetadata,\n        renderAnnotation,\n        renderGutterUtility,\n      }),\n      renderedItem.element,\n      renderedItem.id\n    );\n  });\n}) as SlotPortalsComponent;\n\nfunction renderCodeViewItemChildren<LAnnotation>({\n  renderedItem,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderMetadata,\n  renderAnnotation,\n  renderGutterUtility,\n}: RenderCodeViewItemChildrenProps<LAnnotation>): ReactNode {\n  if (renderedItem.type === 'diff') {\n    const { item, instance } = renderedItem;\n    return renderDiffChildren({\n      fileDiff: item.fileDiff,\n      renderCustomHeader:\n        renderCustomHeader != null ? () => renderCustomHeader(item) : undefined,\n      renderHeaderPrefix:\n        renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : undefined,\n      renderHeaderMetadata:\n        renderHeaderMetadata != null\n          ? () => renderHeaderMetadata(item)\n          : undefined,\n      renderAnnotation:\n        renderAnnotation != null\n          ? (annotation) => renderAnnotation(annotation, item)\n          : undefined,\n      lineAnnotations: item.annotations,\n      renderGutterUtility:\n        renderGutterUtility != null\n          ? (getHoveredLine) => renderGutterUtility(getHoveredLine, item)\n          : undefined,\n      getHoveredLine: instance.getHoveredLine,\n    });\n  } else {\n    const { item, instance } = renderedItem;\n    return renderFileChildren({\n      file: item.file,\n      renderCustomHeader:\n        renderCustomHeader != null ? () => renderCustomHeader(item) : undefined,\n      renderHeaderPrefix:\n        renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : undefined,\n      renderHeaderMetadata:\n        renderHeaderMetadata != null\n          ? () => renderHeaderMetadata(item)\n          : undefined,\n      renderAnnotation:\n        renderAnnotation != null\n          ? (annotation) => renderAnnotation(annotation, item)\n          : undefined,\n      lineAnnotations: item.annotations,\n      renderGutterUtility:\n        renderGutterUtility != null\n          ? (getHoveredLine) => renderGutterUtility(getHoveredLine, item)\n          : undefined,\n      getHoveredLine: instance.getHoveredLine,\n    });\n  }\n}\n\nfunction noopRender() {\n  return undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"CodeView.js","names":["CodeViewClass"],"sources":["../../src/react/CodeView.tsx"],"sourcesContent":["'use client';\n\nimport {\n  type CSSProperties,\n  forwardRef,\n  memo,\n  type ReactNode,\n  type Ref,\n  useContext,\n  useEffect,\n  useImperativeHandle,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { createPortal, flushSync } from 'react-dom';\n\nimport {\n  areOptionsEqual,\n  CodeView as CodeViewClass,\n  type CodeViewCoordinator,\n  type CodeViewCreateEditorOptions,\n  type CodeViewItem,\n  type CodeViewLineSelection,\n  type CodeViewOptions,\n  type CodeViewRenderedItem,\n  type CodeViewScrollTarget,\n  type CodeViewSlotSnapshot,\n  type DiffLineAnnotation,\n  type DiffsEditor,\n  type FileContents,\n  type GetHoveredLineResult,\n  type LineAnnotation,\n} from '../index';\nimport { areManagedSnapshotsEqual } from '../utils/areManagedSnapshotsEqual';\nimport { renderDiffChildren } from './utils/renderDiffChildren';\nimport { renderFileChildren } from './utils/renderFileChildren';\nimport { useStableCallback } from './utils/useStableCallback';\nimport { WorkerPoolContext } from './WorkerPoolContext';\n\nconst useIsometricEffect =\n  typeof window === 'undefined' ? useEffect : useLayoutEffect;\n\ntype CodeViewGutterUtilityGetter =\n  | (() => GetHoveredLineResult<'file'> | undefined)\n  | (() => GetHoveredLineResult<'diff'> | undefined);\n\ninterface CodeViewBaseProps<LAnnotation> {\n  options?: CodeViewOptions<LAnnotation>;\n  className?: string;\n  style?: CSSProperties;\n  containerRef?: Ref<HTMLDivElement>;\n  disableWorkerPool?: boolean;\n  selectedLines?: CodeViewLineSelection | null;\n  onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n  onScroll?(scrollTop: number, viewer: CodeViewClass<LAnnotation>): void;\n  /** Render a non-virtualized node at the very start of the scroll content,\n   * before the first item. Always rendered; scrolls with the content. */\n  renderCodeViewHeader?(): ReactNode;\n  /** Render a non-virtualized node at the very end of the scroll content, after\n   * the last item. Always rendered; scrolls with the content. */\n  renderCodeViewFooter?(): ReactNode;\n  /**\n   * Enables editing for items with `edit: true`. Pass the given options into\n   * the editor constructor — `new Editor(options)` from `@pierre/diffs/editor`\n   * — so document changes route to `onItemEditChange` and\n   * `onItemEditComplete`. CodeView owns the returned editor's lifecycle.\n   */\n  createEditor?(\n    options: CodeViewCreateEditorOptions<LAnnotation>\n  ): DiffsEditor<LAnnotation> | undefined;\n  /** Called with the owning item on every edited-document change. */\n  onItemEditChange?(\n    item: CodeViewItem<LAnnotation>,\n    file: FileContents,\n    lineAnnotations?: DiffLineAnnotation<LAnnotation>[]\n  ): void;\n  /**\n   * Called once with the final contents when an item's edit session ends\n   * (edit turned off, item removed or collapsed). Not called for sessions\n   * that produced no changes. Committing is user-space: make one combined\n   * item write carrying the new file/fileDiff (with a fresh `cacheKey`,\n   * since the contents changed) along with `edit: false`.\n   */\n  onItemEditComplete?(\n    item: CodeViewItem<LAnnotation>,\n    file: FileContents,\n    lineAnnotations?: DiffLineAnnotation<LAnnotation>[]\n  ): void;\n  renderCustomHeader?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderHeaderPrefix?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderHeaderFilenameSuffix?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderHeaderMetadata?(item: CodeViewItem<LAnnotation>): ReactNode;\n  renderAnnotation?(\n    annotation: LineAnnotation<LAnnotation> | DiffLineAnnotation<LAnnotation>,\n    item: CodeViewItem<LAnnotation>\n  ): ReactNode;\n  renderGutterUtility?(\n    getHoveredLine: CodeViewGutterUtilityGetter,\n    item: CodeViewItem<LAnnotation>\n  ): ReactNode;\n}\n\nexport interface ControlledCodeViewProps<\n  LAnnotation,\n> extends CodeViewBaseProps<LAnnotation> {\n  items: readonly CodeViewItem<LAnnotation>[];\n  initialItems?: never;\n}\n\nexport interface UncontrolledCodeViewProps<\n  LAnnotation,\n> extends CodeViewBaseProps<LAnnotation> {\n  // Seeds the imperative CodeView instance once. Later item changes should go\n  // through the ref API instead of being reconciled from React props.\n  initialItems?: readonly CodeViewItem<LAnnotation>[];\n  items?: never;\n}\n\nexport type CodeViewProps<LAnnotation = undefined> =\n  | ControlledCodeViewProps<LAnnotation>\n  | UncontrolledCodeViewProps<LAnnotation>;\n\nexport interface CodeViewHandle<LAnnotation> {\n  addItems(items: readonly CodeViewItem<LAnnotation>[]): void;\n  getItem(id: string): CodeViewItem<LAnnotation> | undefined;\n  updateItem(item: CodeViewItem<LAnnotation>): boolean;\n  updateItemId(oldId: string, newId: string): boolean;\n  scrollTo(target: CodeViewScrollTarget): void;\n  setSelectedLines(selection: CodeViewLineSelection | null): void;\n  getSelectedLines(): CodeViewLineSelection | null;\n  clearSelectedLines(): void;\n  getEditor(id: string): DiffsEditor<LAnnotation> | undefined;\n  getInstance(): CodeViewClass<LAnnotation> | undefined;\n}\n\ntype CodeViewComponent = <LAnnotation = undefined>(\n  props: CodeViewProps<LAnnotation> & {\n    ref?: React.Ref<CodeViewHandle<LAnnotation>>;\n  }\n) => React.JSX.Element;\n\ntype SlotPortalsComponent = <LAnnotation = undefined>(\n  props: SlotPortalsProps<LAnnotation>\n) => React.JSX.Element;\n\ninterface ManagedContentStore<LAnnotation> {\n  getSnapshot(): CodeViewSlotSnapshot<LAnnotation> | undefined;\n  publish(snapshot: CodeViewSlotSnapshot<LAnnotation> | undefined): void;\n  subscribe(listener: () => void): () => void;\n}\n\ninterface CachedDataRef<LAnnotation> {\n  instance: CodeViewClass<LAnnotation> | undefined;\n  items: readonly CodeViewItem<LAnnotation>[] | undefined;\n  controlled: boolean;\n  managedOptions: CodeViewOptions<LAnnotation> | undefined;\n  disableFlushSync: boolean;\n  slotCoordinator: CodeViewCoordinator<LAnnotation> | undefined;\n}\n\nfunction createDefaultCache<LAnnotation>(\n  controlled: boolean\n): CachedDataRef<LAnnotation> {\n  return {\n    instance: undefined,\n    items: undefined,\n    controlled,\n    managedOptions: undefined,\n    disableFlushSync: false,\n    slotCoordinator: undefined,\n  };\n}\n\nfunction CodeViewInner<LAnnotation = undefined>(\n  props: CodeViewProps<LAnnotation>,\n  ref: React.ForwardedRef<CodeViewHandle<LAnnotation>>\n): React.JSX.Element {\n  const {\n    className,\n    containerRef,\n    createEditor,\n    disableWorkerPool = false,\n    initialItems,\n    items: controlledItems,\n    onItemEditChange,\n    onItemEditComplete,\n    onScroll,\n    onSelectedLinesChange,\n    options,\n    renderAnnotation,\n    renderCodeViewFooter,\n    renderCodeViewHeader,\n    renderCustomHeader,\n    renderGutterUtility,\n    renderHeaderFilenameSuffix,\n    renderHeaderMetadata,\n    renderHeaderPrefix,\n    selectedLines,\n    style,\n  } = props;\n  const controlled = controlledItems !== undefined;\n  const poolManager = useContext(WorkerPoolContext);\n  const cachedDataRef = useRef<CachedDataRef<LAnnotation>>(\n    createDefaultCache<LAnnotation>(controlled)\n  );\n  const hasCustomHeader = renderCustomHeader != null;\n  const hasAnnotationRenderer = renderAnnotation != null;\n  const hasGutterRenderer = renderGutterUtility != null;\n  const hasHeaderRenderers =\n    hasCustomHeader ||\n    renderHeaderPrefix != null ||\n    renderHeaderFilenameSuffix != null ||\n    renderHeaderMetadata != null;\n  const hasRenderers =\n    hasHeaderRenderers || hasAnnotationRenderer || hasGutterRenderer;\n  const hasCodeViewHeader = renderCodeViewHeader != null;\n  const hasCodeViewFooter = renderCodeViewFooter != null;\n  const emitSelectedLinesChange = useStableCallback(\n    (selection: CodeViewLineSelection | null) => {\n      onSelectedLinesChange?.(selection);\n    }\n  );\n  const controlledSelection = selectedLines !== undefined;\n\n  // Stable identities for the editor callbacks so inline props don't churn\n  // managedOptions (a changed options object forces a full item re-render).\n  const stableCreateEditor = useStableCallback(\n    (editorOptions: CodeViewCreateEditorOptions<LAnnotation>) =>\n      createEditor?.(editorOptions)\n  );\n  const emitItemEditChange = useStableCallback(\n    (\n      item: CodeViewItem<LAnnotation>,\n      file: FileContents,\n      lineAnnotations?: DiffLineAnnotation<LAnnotation>[]\n    ) => {\n      onItemEditChange?.(item, file, lineAnnotations);\n    }\n  );\n  const emitItemEditComplete = useStableCallback(\n    (\n      item: CodeViewItem<LAnnotation>,\n      file: FileContents,\n      lineAnnotations?: DiffLineAnnotation<LAnnotation>[]\n    ) => {\n      onItemEditComplete?.(item, file, lineAnnotations);\n    }\n  );\n\n  const managedOptions = useMemo(\n    () =>\n      createManagedCodeViewOptions({\n        options,\n        hasCustomHeader,\n        hasGutterRenderer,\n        hasCodeViewHeader,\n        hasCodeViewFooter,\n        onSelectedLinesChange:\n          onSelectedLinesChange != null ? emitSelectedLinesChange : undefined,\n        controlledSelection,\n        createEditor: createEditor != null ? stableCreateEditor : undefined,\n        onItemEditChange:\n          onItemEditChange != null ? emitItemEditChange : undefined,\n        onItemEditComplete:\n          onItemEditComplete != null ? emitItemEditComplete : undefined,\n      }),\n    [\n      options,\n      hasCustomHeader,\n      hasGutterRenderer,\n      hasCodeViewHeader,\n      hasCodeViewFooter,\n      onSelectedLinesChange,\n      emitSelectedLinesChange,\n      controlledSelection,\n      createEditor,\n      stableCreateEditor,\n      onItemEditChange,\n      emitItemEditChange,\n      onItemEditComplete,\n      emitItemEditComplete,\n    ]\n  );\n\n  const [slotContentStore] = useState<ManagedContentStore<LAnnotation>>(() =>\n    createSlotContentStore()\n  );\n  const [, forceUpdate] = useState<unknown>({});\n\n  const nodeRef = useStableCallback((node: HTMLDivElement | null) => {\n    // If we have a pre-existing instance and there's no node or the node being\n    // passed in is NOT the same as before, then we need to clean up and\n    // garbage collect the old instance\n    if (\n      cachedDataRef.current.instance != null &&\n      (node == null ||\n        node !== cachedDataRef.current.instance.getContainerElement())\n    ) {\n      cachedDataRef.current.instance.cleanUp();\n      slotContentStore.publish(undefined);\n      cachedDataRef.current = createDefaultCache<LAnnotation>(controlled);\n    }\n\n    // If our node matches the existing node then we should not attempt to\n    // setup.  This is a case that should never be possible to hit, but just in\n    // case, lets make sure we don't re-setup an instance that is already setup\n    // properly\n    if (\n      node != null &&\n      node !== cachedDataRef.current.instance?.getContainerElement()\n    ) {\n      cachedDataRef.current.instance = new CodeViewClass<LAnnotation>(\n        managedOptions,\n        !disableWorkerPool ? poolManager : undefined,\n        true\n      );\n      cachedDataRef.current.instance.setup(node);\n    }\n\n    if (typeof containerRef === 'function') {\n      containerRef(node);\n    } else if (containerRef != null) {\n      containerRef.current = node;\n    }\n  });\n\n  const onSnapshotChange = useStableCallback(\n    (snapshot: CodeViewSlotSnapshot<LAnnotation> | undefined) => {\n      if (cachedDataRef.current.disableFlushSync) {\n        slotContentStore.publish(snapshot);\n      } else {\n        flushSync(() => {\n          slotContentStore.publish(snapshot);\n        });\n      }\n    }\n  );\n\n  const slotCoordinator: CodeViewCoordinator<LAnnotation> | undefined =\n    useMemo(() => {\n      // A coordinator is needed whenever React portals anything — per-item\n      // slots and codeview header and footer\n      if (\n        !hasHeaderRenderers &&\n        !hasAnnotationRenderer &&\n        !hasGutterRenderer &&\n        !hasCodeViewHeader &&\n        !hasCodeViewFooter\n      ) {\n        return undefined;\n      } else {\n        return {\n          hasHeaderRenderers,\n          hasAnnotationRenderer,\n          hasGutterRenderer,\n          onSnapshotChange,\n        };\n      }\n    }, [\n      onSnapshotChange,\n      hasAnnotationRenderer,\n      hasGutterRenderer,\n      hasHeaderRenderers,\n      hasCodeViewHeader,\n      hasCodeViewFooter,\n    ]);\n\n  useIsometricEffect(() => {\n    return onScroll != null\n      ? cachedDataRef.current.instance?.subscribeToScroll(onScroll)\n      : undefined;\n  });\n\n  useIsometricEffect(() => {\n    const {\n      instance,\n      controlled: prevControlled,\n      items: prevItems,\n      managedOptions: prevManagedOptions,\n      slotCoordinator: prevSlotCoordinator,\n    } = cachedDataRef.current;\n    if (instance == null) {\n      return;\n    }\n\n    try {\n      cachedDataRef.current.disableFlushSync = true;\n      let shouldRender = false;\n\n      if (!areOptionsEqual(managedOptions, prevManagedOptions)) {\n        cachedDataRef.current.managedOptions = managedOptions;\n        instance.setOptions(managedOptions);\n        shouldRender = true;\n      }\n\n      if (prevControlled !== controlled) {\n        console.error(\n          'CodeView: cannot switch between controlled and uncontrolled modes. Remount with a new key instead.'\n        );\n        return;\n      }\n\n      if (controlled) {\n        if (controlledItems !== prevItems) {\n          if (areItemListsEqual(prevItems, controlledItems)) {\n            cachedDataRef.current.items = controlledItems;\n          } else if (isAppendOnlyItemUpdate(prevItems, controlledItems)) {\n            cachedDataRef.current.items = controlledItems;\n            instance.addItems(controlledItems.slice(prevItems.length));\n          } else {\n            cachedDataRef.current.items = controlledItems;\n            instance.setItems(controlledItems);\n            shouldRender = true;\n          }\n        }\n      }\n      // If uncontrolled, we should only ever set items once, and just depend\n      // on imperative instance changes going forward\n      else if (prevItems == null) {\n        const seedItems = initialItems ?? [];\n        cachedDataRef.current.items = seedItems;\n        if (seedItems.length > 0) {\n          instance.setItems(seedItems);\n          shouldRender = true;\n        }\n      }\n\n      if (selectedLines !== undefined) {\n        instance.setSelectedLines(selectedLines, { notify: false });\n      }\n\n      const slotPublish = instance.setSlotCoordinator(slotCoordinator);\n      let forceInlinePublish = false;\n      if (slotCoordinator !== prevSlotCoordinator) {\n        if (slotCoordinator == null || prevSlotCoordinator == null) {\n          forceInlinePublish = true;\n        }\n        cachedDataRef.current.slotCoordinator = slotCoordinator;\n      }\n\n      if (shouldRender || slotPublish) {\n        instance.render(true);\n      }\n\n      // FIXME(amadeus): This feels kinda bad and flakey with regards to how\n      // other things are working... it makes me think that we should\n      // re-architect the slotCoordinator a bit, and maybe DON'T make it an\n      // undefineable thing...\n      if (slotPublish && slotCoordinator == null) {\n        slotContentStore.publish(undefined);\n      }\n\n      if (forceInlinePublish) {\n        forceUpdate({});\n      }\n    } finally {\n      cachedDataRef.current.disableFlushSync = false;\n    }\n  });\n\n  // Setup the ref handler\n  useImperativeHandle(\n    ref,\n    (): CodeViewHandle<LAnnotation> => ({\n      addItems(items) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'addItems');\n        if (instance == null) {\n          console.error(\n            'CodeView.addItems: no valid instance to append items with',\n            items\n          );\n        } else {\n          instance.addItems(items);\n        }\n      },\n      getItem(id) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error('CodeView.getItem: no valid instance exists', id);\n          return undefined;\n        } else {\n          return instance.getItem(id);\n        }\n      },\n      updateItem(item) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'updateItem');\n        if (instance == null) {\n          console.error(\n            'CodeView.updateItem: no valid instance to update item with',\n            item\n          );\n          return false;\n        }\n\n        return instance.updateItem(item);\n      },\n      updateItemId(oldId, newId) {\n        const { controlled, instance } = cachedDataRef.current;\n        assertUncontrolledCodeViewAction(controlled, 'updateItemId');\n        if (instance == null) {\n          console.error(\n            'CodeView.updateItemId: no valid instance to update item id with',\n            oldId,\n            newId\n          );\n          return false;\n        }\n\n        return instance.updateItemId(oldId, newId);\n      },\n      scrollTo(target) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.scrollTo: no valid instance to scroll with',\n            target\n          );\n        } else {\n          instance.scrollTo(target);\n        }\n      },\n      setSelectedLines(selection) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.setSelectedLines: no valid instance to update selection with',\n            selection\n          );\n        } else {\n          instance.setSelectedLines(selection, { notify: false });\n          emitSelectedLinesChange(selection);\n        }\n      },\n      getSelectedLines() {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error('CodeView.getSelectedLines: no valid instance exists');\n          return null;\n        } else {\n          return instance.getSelectedLines();\n        }\n      },\n      clearSelectedLines() {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error(\n            'CodeView.clearSelectedLines: no valid instance to update selection with'\n          );\n        } else {\n          instance.clearSelectedLines({ notify: false });\n          emitSelectedLinesChange(null);\n        }\n      },\n      getEditor(id) {\n        const { instance } = cachedDataRef.current;\n        if (instance == null) {\n          console.error('CodeView.getEditor: no valid instance exists', id);\n          return undefined;\n        }\n\n        return instance.getEditor(id);\n      },\n      getInstance() {\n        return cachedDataRef.current.instance;\n      },\n    }),\n    [emitSelectedLinesChange]\n  );\n\n  return (\n    <>\n      <div ref={nodeRef} className={className} style={style} />\n      {(hasRenderers || hasCodeViewHeader || hasCodeViewFooter) && (\n        <SlotPortals<LAnnotation>\n          managedContentStore={slotContentStore}\n          renderCustomHeader={renderCustomHeader}\n          renderHeaderPrefix={renderHeaderPrefix}\n          renderHeaderFilenameSuffix={renderHeaderFilenameSuffix}\n          renderHeaderMetadata={renderHeaderMetadata}\n          renderAnnotation={renderAnnotation}\n          renderGutterUtility={renderGutterUtility}\n          renderCodeViewHeader={renderCodeViewHeader}\n          renderCodeViewFooter={renderCodeViewFooter}\n        />\n      )}\n    </>\n  );\n}\n\n// React was a mistake\nexport const CodeView = forwardRef(CodeViewInner) as CodeViewComponent;\n\nfunction isAppendOnlyItemUpdate<LAnnotation>(\n  previousItems: readonly CodeViewItem<LAnnotation>[] | undefined,\n  nextItems: readonly CodeViewItem<LAnnotation>[]\n): previousItems is readonly CodeViewItem<LAnnotation>[] {\n  if (previousItems == null || nextItems.length <= previousItems.length) {\n    return false;\n  }\n\n  if (previousItems.length === 0) {\n    return true;\n  }\n\n  for (let index = 0; index < previousItems.length; index++) {\n    if (nextItems[index] !== previousItems[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction areItemListsEqual<LAnnotation>(\n  previousItems: readonly CodeViewItem<LAnnotation>[] | undefined,\n  nextItems: readonly CodeViewItem<LAnnotation>[]\n): boolean {\n  if (previousItems == null || previousItems.length !== nextItems.length) {\n    return false;\n  }\n\n  for (let index = 0; index < previousItems.length; index++) {\n    if (previousItems[index] !== nextItems[index]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction assertUncontrolledCodeViewAction(\n  controlled: boolean,\n  action: string\n): void {\n  if (!controlled) {\n    return;\n  }\n\n  throw new Error(\n    `CodeView.${action} cannot be used when CodeView is controlled. Use initialItems for imperative item updates.`\n  );\n}\n\nfunction createSlotContentStore<\n  LAnnotation,\n>(): ManagedContentStore<LAnnotation> {\n  let snapshot: CodeViewSlotSnapshot<LAnnotation> | undefined;\n  const listeners = new Set<() => void>();\n\n  return {\n    getSnapshot() {\n      return snapshot;\n    },\n    publish(nextSnapshot) {\n      if (areManagedSnapshotsEqual(snapshot, nextSnapshot)) {\n        return;\n      }\n\n      snapshot = nextSnapshot;\n      for (const listener of listeners) {\n        listener();\n      }\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\ninterface CreateManagedCodeViewOptionsProps<LAnnotation> {\n  options: CodeViewOptions<LAnnotation> | undefined;\n  hasCustomHeader: boolean;\n  hasGutterRenderer: boolean;\n  hasCodeViewHeader: boolean;\n  hasCodeViewFooter: boolean;\n  onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n  controlledSelection: boolean;\n  createEditor: CodeViewOptions<LAnnotation>['createEditor'];\n  onItemEditChange: CodeViewOptions<LAnnotation>['onItemEditChange'];\n  onItemEditComplete: CodeViewOptions<LAnnotation>['onItemEditComplete'];\n}\n\nfunction createManagedCodeViewOptions<LAnnotation>({\n  options,\n  hasCustomHeader,\n  hasGutterRenderer,\n  hasCodeViewHeader,\n  hasCodeViewFooter,\n  onSelectedLinesChange,\n  controlledSelection,\n  createEditor,\n  onItemEditChange,\n  onItemEditComplete,\n}: CreateManagedCodeViewOptionsProps<LAnnotation>):\n  | CodeViewOptions<LAnnotation>\n  | undefined {\n  if (\n    !hasCustomHeader &&\n    !hasGutterRenderer &&\n    !hasCodeViewHeader &&\n    !hasCodeViewFooter &&\n    onSelectedLinesChange == null &&\n    !controlledSelection &&\n    createEditor == null &&\n    onItemEditChange == null &&\n    onItemEditComplete == null\n  ) {\n    return options ?? {};\n  }\n  options = { ...options, controlledSelection, onSelectedLinesChange };\n\n  // Prop-level editor callbacks win over their options-object counterparts,\n  // but an absent prop must not clobber a value provided via `options`.\n  if (createEditor != null) {\n    options.createEditor = createEditor;\n  }\n  if (onItemEditChange != null) {\n    options.onItemEditChange = onItemEditChange;\n  }\n  if (onItemEditComplete != null) {\n    options.onItemEditComplete = onItemEditComplete;\n  }\n\n  // The imperative CodeView adapters use this callback's presence to\n  // switch file and diff headers into custom-slot mode. React portals\n  // provide the actual header content, so this placeholder\n  // intentionally returns nothing.\n  if (hasCustomHeader) {\n    options.renderCustomHeader = noopRender;\n  }\n\n  // The imperative CodeView adapters use this callback's presence to\n  // create the custom gutter utility slot. React portals provide the\n  // actual content, so this placeholder intentionally returns nothing.\n  if (hasGutterRenderer) {\n    options.renderGutterUtility = noopRender;\n  }\n\n  // The imperative CodeView adapters use these callbacks' presence to create the\n  // header/footer host elements. React portals the actual content into them (via\n  // the slot snapshot), so these placeholders intentionally return nothing.\n  if (hasCodeViewHeader) {\n    options.renderCodeViewHeader = noopRender;\n  }\n  if (hasCodeViewFooter) {\n    options.renderCodeViewFooter = noopRender;\n  }\n\n  return options;\n}\n\ninterface RenderCodeViewItemChildrenProps<LAnnotation> {\n  renderedItem: CodeViewRenderedItem<LAnnotation>;\n  renderCustomHeader: CodeViewBaseProps<LAnnotation>['renderCustomHeader'];\n  renderHeaderPrefix: CodeViewBaseProps<LAnnotation>['renderHeaderPrefix'];\n  renderHeaderFilenameSuffix: CodeViewBaseProps<LAnnotation>['renderHeaderFilenameSuffix'];\n  renderHeaderMetadata: CodeViewBaseProps<LAnnotation>['renderHeaderMetadata'];\n  renderAnnotation: CodeViewBaseProps<LAnnotation>['renderAnnotation'];\n  renderGutterUtility: CodeViewBaseProps<LAnnotation>['renderGutterUtility'];\n}\n\ninterface SlotPortalsProps<LAnnotation> {\n  managedContentStore: ManagedContentStore<LAnnotation>;\n  renderCustomHeader: CodeViewBaseProps<LAnnotation>['renderCustomHeader'];\n  renderHeaderPrefix: CodeViewBaseProps<LAnnotation>['renderHeaderPrefix'];\n  renderHeaderFilenameSuffix: CodeViewBaseProps<LAnnotation>['renderHeaderFilenameSuffix'];\n  renderHeaderMetadata: CodeViewBaseProps<LAnnotation>['renderHeaderMetadata'];\n  renderAnnotation: CodeViewBaseProps<LAnnotation>['renderAnnotation'];\n  renderGutterUtility: CodeViewBaseProps<LAnnotation>['renderGutterUtility'];\n  renderCodeViewHeader: CodeViewBaseProps<LAnnotation>['renderCodeViewHeader'];\n  renderCodeViewFooter: CodeViewBaseProps<LAnnotation>['renderCodeViewFooter'];\n}\n\nconst SlotPortals = memo(function SlotPortals<LAnnotation>({\n  managedContentStore,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderFilenameSuffix,\n  renderHeaderMetadata,\n  renderAnnotation,\n  renderGutterUtility,\n  renderCodeViewHeader,\n  renderCodeViewFooter,\n}: SlotPortalsProps<LAnnotation>) {\n  'use no memo';\n  const subscribe = useStableCallback((listener: () => void) =>\n    managedContentStore.subscribe(listener)\n  );\n  const getSnapshot = useStableCallback(() =>\n    managedContentStore.getSnapshot()\n  );\n  const snapshot = useSyncExternalStore<\n    CodeViewSlotSnapshot<LAnnotation> | undefined\n  >(subscribe, getSnapshot, getSnapshot);\n  let itemKeys = '';\n  for (const item of snapshot?.items ?? []) {\n    itemKeys += `${item.id}:${item.version}:${item.type}`;\n  }\n  // NOTE(amadeus): And just like that, the react compiler do be failing us\n  // lol... we need to pre-render everything for items, headers and footers to\n  // not trigger needless renders while scrolling\n  const renderedItems = useMemo(\n    () => {\n      return snapshot?.items?.map((renderedItem) =>\n        createPortal(\n          renderCodeViewItemChildren({\n            renderedItem,\n            renderCustomHeader,\n            renderHeaderPrefix,\n            renderHeaderFilenameSuffix,\n            renderHeaderMetadata,\n            renderAnnotation,\n            renderGutterUtility,\n          }),\n          renderedItem.element,\n          renderedItem.id\n        )\n      );\n    },\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n    [\n      renderCustomHeader,\n      renderHeaderPrefix,\n      renderHeaderFilenameSuffix,\n      renderHeaderMetadata,\n      renderAnnotation,\n      renderGutterUtility,\n      itemKeys,\n    ]\n  );\n  const renderedHeader = useMemo(() => {\n    return renderCodeViewHeader != null && snapshot?.header != null\n      ? createPortal(renderCodeViewHeader(), snapshot.header)\n      : null;\n  }, [renderCodeViewHeader, snapshot?.header]);\n  const renderedFooter = useMemo(() => {\n    return renderCodeViewFooter != null && snapshot?.footer != null\n      ? createPortal(renderCodeViewFooter(), snapshot.footer)\n      : null;\n  }, [renderCodeViewFooter, snapshot?.footer]);\n  return (\n    <>\n      {renderedItems}\n      {renderedHeader}\n      {renderedFooter}\n    </>\n  );\n}) as SlotPortalsComponent;\n\nfunction renderCodeViewItemChildren<LAnnotation>({\n  renderedItem,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderFilenameSuffix,\n  renderHeaderMetadata,\n  renderAnnotation,\n  renderGutterUtility,\n}: RenderCodeViewItemChildrenProps<LAnnotation>): ReactNode {\n  if (renderedItem.type === 'diff') {\n    const { item, instance } = renderedItem;\n    return renderDiffChildren({\n      fileDiff: item.fileDiff,\n      renderCustomHeader:\n        renderCustomHeader != null ? () => renderCustomHeader(item) : undefined,\n      renderHeaderPrefix:\n        renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : undefined,\n      renderHeaderFilenameSuffix:\n        renderHeaderFilenameSuffix != null\n          ? () => renderHeaderFilenameSuffix(item)\n          : undefined,\n      renderHeaderMetadata:\n        renderHeaderMetadata != null\n          ? () => renderHeaderMetadata(item)\n          : undefined,\n      renderAnnotation:\n        renderAnnotation != null\n          ? (annotation) => renderAnnotation(annotation, item)\n          : undefined,\n      lineAnnotations: item.annotations,\n      renderGutterUtility:\n        renderGutterUtility != null\n          ? (getHoveredLine) => renderGutterUtility(getHoveredLine, item)\n          : undefined,\n      getHoveredLine: instance.getHoveredLine,\n    });\n  } else {\n    const { item, instance } = renderedItem;\n    return renderFileChildren({\n      file: item.file,\n      renderCustomHeader:\n        renderCustomHeader != null ? () => renderCustomHeader(item) : undefined,\n      renderHeaderPrefix:\n        renderHeaderPrefix != null ? () => renderHeaderPrefix(item) : undefined,\n      renderHeaderFilenameSuffix:\n        renderHeaderFilenameSuffix != null\n          ? () => renderHeaderFilenameSuffix(item)\n          : undefined,\n      renderHeaderMetadata:\n        renderHeaderMetadata != null\n          ? () => renderHeaderMetadata(item)\n          : undefined,\n      renderAnnotation:\n        renderAnnotation != null\n          ? (annotation) => renderAnnotation(annotation, item)\n          : undefined,\n      lineAnnotations: item.annotations,\n      renderGutterUtility:\n        renderGutterUtility != null\n          ? (getHoveredLine) => renderGutterUtility(getHoveredLine, item)\n          : undefined,\n      getHoveredLine: instance.getHoveredLine,\n    });\n  }\n}\n\nfunction noopRender() {\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/react/EditContext.d.ts

@@ -0,0 +1,15 @@
+import { Editor } from "../editor/editor.js";
+import { Context, PropsWithChildren } from "react";
+
+//#region src/react/EditContext.d.ts
+declare const EditContext: Context<Editor<any> | undefined>;
+declare function EditProvider({
+  children,
+  editor
+}: PropsWithChildren<{
+  editor: Editor<any>;
+}>): React.JSX.Element;
+declare function useEditor<LAnnotation>(): Editor<LAnnotation> | undefined;
+//#endregion
+export { EditContext, EditProvider, useEditor };
+//# sourceMappingURL=EditContext.d.ts.map

package/dist/react/EditContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditContext.d.ts","names":[],"sources":["../../src/react/EditContext.tsx"],"mappings":";;;;cAQa,WAAA,EAAa,OAAO,CAAC,MAAA;AAAA,iBAIlB,YAAA;EACd,QAAA;EACA;AAAA,GACC,iBAAA;EAAoB,MAAA,EAAQ,MAAA;AAAA,KAAiB,KAAA,CAAM,GAAA,CAAI,OAAA;AAAA,iBAS1C,SAAA,iBAA0B,MAAM,CAAC,WAAA"}

package/dist/react/EditContext.js

@@ -0,0 +1,23 @@
+"use client";
+import { createContext, useContext, useEffect } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/EditContext.tsx
+const EditContext = createContext(void 0);
+function EditProvider({ children, editor }) {
+	useEffect(() => {
+		return () => {
+			editor.cleanUp();
+		};
+	}, [editor]);
+	return /* @__PURE__ */ jsx(EditContext.Provider, {
+		value: editor,
+		children
+	});
+}
+function useEditor() {
+	return useContext(EditContext);
+}
+//#endregion
+export { EditContext, EditProvider, useEditor };
+
+//# sourceMappingURL=EditContext.js.map

package/dist/react/EditContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditContext.js","names":[],"sources":["../../src/react/EditContext.tsx"],"sourcesContent":["// oxlint-disable typescript/no-explicit-any\n'use client';\n\nimport type { Context, PropsWithChildren } from 'react';\nimport { createContext, useContext, useEffect } from 'react';\n\nimport type { Editor } from '../editor';\n\nexport const EditContext: Context<Editor<any> | undefined> = createContext<\n  Editor<any> | undefined\n>(undefined);\n\nexport function EditProvider({\n  children,\n  editor,\n}: PropsWithChildren<{ editor: Editor<any> }>): React.JSX.Element {\n  useEffect(() => {\n    return () => {\n      editor.cleanUp();\n    };\n  }, [editor]);\n  return <EditContext.Provider value={editor}>{children}</EditContext.Provider>;\n}\n\nexport function useEditor<LAnnotation>(): Editor<LAnnotation> | undefined {\n  return useContext(EditContext);\n}\n"],"mappings":";;;;AAQA,MAAa,cAAgD,cAE3D,KAAA,CAAS;AAEX,SAAgB,aAAa,EAC3B,UACA,UACgE;CAChE,gBAAgB;EACd,aAAa;GACX,OAAO,QAAQ;EACjB;CACF,GAAG,CAAC,MAAM,CAAC;CACX,OAAO,oBAAC,YAAY,UAAb;EAAsB,OAAO;EAAS;CAA+B,CAAA;AAC9E;AAEA,SAAgB,YAA0D;CACxE,OAAO,WAAW,WAAW;AAC/B"}

package/dist/react/File.d.ts

@@ -13,6 +13,7 @@ declare function File<LAnnotation = undefined>({
   renderAnnotation,
   renderCustomHeader,
   renderHeaderPrefix,
+  renderHeaderFilenameSuffix,
   renderHeaderMetadata,
   prerenderedHTML,
   renderGutterUtility,

package/dist/react/File.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"File.d.ts","names":["FileOptions","FileProps","File","LAnnotation","file","lineAnnotations","selectedLines","options","metrics","className","style","renderAnnotation","renderCustomHeader","renderHeaderPrefix","renderHeaderMetadata","prerenderedHTML","renderGutterUtility","disableWorkerPool","contentEditable","React","JSX","Element"],"sources":["../../src/react/File.d.ts"],"sourcesContent":["import { type FileOptions } from '../components/File';\nimport type { FileProps } from './types';\nexport type { FileOptions };\nexport declare function File<LAnnotation = undefined>({ file, lineAnnotations, selectedLines, options, metrics, className, style, renderAnnotation, renderCustomHeader, renderHeaderPrefix, renderHeaderMetadata, prerenderedHTML, renderGutterUtility, disableWorkerPool, contentEditable }: FileProps<LAnnotation>): React.JSX.Element;\n//# sourceMappingURL=File.d.ts.map"],"mappings":";;;;iBAGwBE;;;;;;;;;;;;;;;;GAAsQD,UAAUE,eAAegB,KAAAA,CAAMC,GAAAA,CAAIC"}
+{"version":3,"file":"File.d.ts","names":[],"sources":["../../src/react/File.tsx"],"mappings":";;;;iBAWgB,IAAA;EACd,IAAA;EACA,eAAA;EACA,aAAA;EACA,OAAA;EACA,OAAA;EACA,SAAA;EACA,KAAA;EACA,gBAAA;EACA,kBAAA;EACA,kBAAA;EACA,0BAAA;EACA,oBAAA;EACA,eAAA;EACA,mBAAA;EACA,iBAAA;EACA;AAAA,GACC,SAAA,CAAU,WAAA,IAAe,KAAA,CAAM,GAAA,CAAI,OAAA"}

package/dist/react/File.js

@@ -1,14 +1,11 @@
-'use client';
-
-
+"use client";
 import { DIFFS_TAG_NAME } from "../constants.js";
 import { renderFileChildren } from "./utils/renderFileChildren.js";
 import { templateRender } from "./utils/templateRender.js";
 import { useFileInstance } from "./utils/useFileInstance.js";
 import { jsx } from "react/jsx-runtime";
-
 //#region src/react/File.tsx
-function File({ file, lineAnnotations, selectedLines, options, metrics, className, style, renderAnnotation, renderCustomHeader, renderHeaderPrefix, renderHeaderMetadata, prerenderedHTML, renderGutterUtility, disableWorkerPool = false, contentEditable = false }) {
+function File({ file, lineAnnotations, selectedLines, options, metrics, className, style, renderAnnotation, renderCustomHeader, renderHeaderPrefix, renderHeaderFilenameSuffix, renderHeaderMetadata, prerenderedHTML, renderGutterUtility, disableWorkerPool = false, contentEditable = false }) {
 	const { ref, getHoveredLine } = useFileInstance({
 		file,
 		options,
@@ -30,6 +27,7 @@ function File({ file, lineAnnotations, selectedLines, options, metrics, classNam
 			renderAnnotation,
 			renderCustomHeader,
 			renderHeaderPrefix,
+			renderHeaderFilenameSuffix,
 			renderHeaderMetadata,
 			renderGutterUtility,
 			lineAnnotations,
@@ -37,7 +35,7 @@ function File({ file, lineAnnotations, selectedLines, options, metrics, classNam
 		}), prerenderedHTML)
 	});
 }
-
 //#endregion
 export { File };
+
 //# sourceMappingURL=File.js.map

package/dist/react/File.js.map

@@ -1 +1 @@
-{"version":3,"file":"File.js","names":[],"sources":["../../src/react/File.tsx"],"sourcesContent":["'use client';\n\nimport { type FileOptions } from '../components/File';\nimport { DIFFS_TAG_NAME } from '../constants';\nimport type { FileProps } from './types';\nimport { renderFileChildren } from './utils/renderFileChildren';\nimport { templateRender } from './utils/templateRender';\nimport { useFileInstance } from './utils/useFileInstance';\n\nexport type { FileOptions };\n\nexport function File<LAnnotation = undefined>({\n  file,\n  lineAnnotations,\n  selectedLines,\n  options,\n  metrics,\n  className,\n  style,\n  renderAnnotation,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderMetadata,\n  prerenderedHTML,\n  renderGutterUtility,\n  disableWorkerPool = false,\n  contentEditable = false,\n}: FileProps<LAnnotation>): React.JSX.Element {\n  const { ref, getHoveredLine } = useFileInstance({\n    file,\n    options,\n    metrics,\n    lineAnnotations,\n    selectedLines,\n    prerenderedHTML,\n    hasGutterRenderUtility: renderGutterUtility != null,\n    hasCustomHeader: renderCustomHeader != null,\n    disableWorkerPool,\n    contentEditable,\n  });\n  const children = renderFileChildren({\n    file,\n    renderAnnotation,\n    renderCustomHeader,\n    renderHeaderPrefix,\n    renderHeaderMetadata,\n    renderGutterUtility,\n    lineAnnotations,\n    getHoveredLine,\n  });\n  return (\n    <DIFFS_TAG_NAME ref={ref} className={className} style={style}>\n      {templateRender(children, prerenderedHTML)}\n    </DIFFS_TAG_NAME>\n  );\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,KAA8B,EAC5C,MACA,iBACA,eACA,SACA,SACA,WACA,OACA,kBACA,oBACA,oBACA,sBACA,iBACA,qBACA,oBAAoB,OACpB,kBAAkB,SAC0B;CAC5C,MAAM,EAAE,KAAK,mBAAmB,gBAAgB;EAC9C;EACA;EACA;EACA;EACA;EACA;EACA,wBAAwB,uBAAuB;EAC/C,iBAAiB,sBAAsB;EACvC;EACA;EACD,CAAC;AAWF,QACE,oBAAC;EAAoB;EAAgB;EAAkB;YACpD,eAZY,mBAAmB;GAClC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC,EAG4B,gBAAgB;GAC3B"}
+{"version":3,"file":"File.js","names":[],"sources":["../../src/react/File.tsx"],"sourcesContent":["'use client';\n\nimport { type FileOptions } from '../components/File';\nimport { DIFFS_TAG_NAME } from '../constants';\nimport type { FileProps } from './types';\nimport { renderFileChildren } from './utils/renderFileChildren';\nimport { templateRender } from './utils/templateRender';\nimport { useFileInstance } from './utils/useFileInstance';\n\nexport type { FileOptions };\n\nexport function File<LAnnotation = undefined>({\n  file,\n  lineAnnotations,\n  selectedLines,\n  options,\n  metrics,\n  className,\n  style,\n  renderAnnotation,\n  renderCustomHeader,\n  renderHeaderPrefix,\n  renderHeaderFilenameSuffix,\n  renderHeaderMetadata,\n  prerenderedHTML,\n  renderGutterUtility,\n  disableWorkerPool = false,\n  contentEditable = false,\n}: FileProps<LAnnotation>): React.JSX.Element {\n  const { ref, getHoveredLine } = useFileInstance({\n    file,\n    options,\n    metrics,\n    lineAnnotations,\n    selectedLines,\n    prerenderedHTML,\n    hasGutterRenderUtility: renderGutterUtility != null,\n    hasCustomHeader: renderCustomHeader != null,\n    disableWorkerPool,\n    contentEditable,\n  });\n  const children = renderFileChildren({\n    file,\n    renderAnnotation,\n    renderCustomHeader,\n    renderHeaderPrefix,\n    renderHeaderFilenameSuffix,\n    renderHeaderMetadata,\n    renderGutterUtility,\n    lineAnnotations,\n    getHoveredLine,\n  });\n  return (\n    <DIFFS_TAG_NAME ref={ref} className={className} style={style}>\n      {templateRender(children, prerenderedHTML)}\n    </DIFFS_TAG_NAME>\n  );\n}\n"],"mappings":";;;;;;;AAWA,SAAgB,KAA8B,EAC5C,MACA,iBACA,eACA,SACA,SACA,WACA,OACA,kBACA,oBACA,oBACA,4BACA,sBACA,iBACA,qBACA,oBAAoB,OACpB,kBAAkB,SAC0B;CAC5C,MAAM,EAAE,KAAK,mBAAmB,gBAAgB;EAC9C;EACA;EACA;EACA;EACA;EACA;EACA,wBAAwB,uBAAuB;EAC/C,iBAAiB,sBAAsB;EACvC;EACA;CACF,CAAC;CAYD,OACE,oBAAC,gBAAD;EAAqB;EAAgB;EAAkB;YACpD,eAbY,mBAAmB;GAClC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACF,CAG2B,GAAG,eAAe;CAC3B,CAAA;AAEpB"}