@pierre/diffs 1.1.0-beta.15 → 1.1.0-beta.17

package/dist/components/FileDiff.d.ts

@@ -1,4 +1,4 @@
-import { AnnotationSide, BaseDiffOptions, DiffLineAnnotation, ExpansionDirections, FileContents, FileDiffMetadata, HunkData, HunkSeparators, PrePropertiesConfig, RenderHeaderMetadataCallback, RenderRange, ThemeTypes } from "../types.js";
+import { AnnotationSide, BaseDiffOptions, DiffLineAnnotation, ExpansionDirections, FileContents, FileDiffMetadata, HunkData, HunkSeparators, PrePropertiesConfig, RenderHeaderMetadataCallback, RenderHeaderPrefixCallback, RenderRange, ThemeTypes } from "../types.js";
 import { WorkerPoolManager } from "../worker/WorkerPoolManager.js";
 import "../worker/index.js";
 import { GetLineIndexUtility, LineSelectionManager, LineSelectionOptions, SelectedLineRange } from "../managers/LineSelectionManager.js";
@@ -29,6 +29,11 @@ interface FileDiffOptions<LAnnotation> extends Omit<BaseDiffOptions, 'hunkSepara
                                                      * removed in a future version.
                                                      */ | ((hunk: HunkData, instance: FileDiff<LAnnotation>) => HTMLElement | DocumentFragment);
   disableFileHeader?: boolean;
+  /**
+   * @deprecated Use `enableGutterUtility` instead.
+   */
+  enableHoverUtility?: boolean;
+  renderHeaderPrefix?: RenderHeaderPrefixCallback;
   renderHeaderMetadata?: RenderHeaderMetadataCallback;
   /**
    * When true, errors during rendering are rethrown instead of being caught
@@ -37,6 +42,10 @@ interface FileDiffOptions<LAnnotation> extends Omit<BaseDiffOptions, 'hunkSepara
    */
   disableErrorHandling?: boolean;
   renderAnnotation?(annotation: DiffLineAnnotation<LAnnotation>): HTMLElement | undefined;
+  renderGutterUtility?(getHoveredRow: () => GetHoveredLineResult<'diff'> | undefined): HTMLElement | null;
+  /**
+   * @deprecated Use `renderGutterUtility` instead.
+   */
   renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'diff'> | undefined): HTMLElement | null;
 }
 interface AnnotationElementCache<LAnnotation> {
@@ -62,8 +71,9 @@ declare class FileDiff<LAnnotation = undefined> {
   protected bufferBefore: HTMLElement | undefined;
   protected bufferAfter: HTMLElement | undefined;
   protected unsafeCSSStyle: HTMLStyleElement | undefined;
-  protected hoverContent: HTMLElement | undefined;
+  protected gutterUtilityContent: HTMLElement | undefined;
   protected headerElement: HTMLElement | undefined;
+  protected headerPrefix: HTMLElement | undefined;
   protected headerMetadata: HTMLElement | undefined;
   protected separatorCache: Map<string, CustomHunkElementCache>;
   protected errorWrapper: HTMLElement | undefined;
@@ -112,11 +122,13 @@ declare class FileDiff<LAnnotation = undefined> {
     containerWrapper,
     renderRange
   }: FileDiffRenderProps<LAnnotation>): boolean;
+  private removeRenderedCode;
+  private clearAuxiliaryNodes;
   renderPlaceholder(height: number): boolean;
   private cleanChildNodes;
   private renderSeparators;
   private renderAnnotations;
-  private renderHoverUtility;
+  private renderGutterUtility;
   protected getOrCreateFileContainer(fileContainer?: HTMLElement, parentNode?: HTMLElement): HTMLElement;
   protected getFileContainer(): HTMLElement | undefined;
   private getOrCreatePreNode;

package/dist/components/FileDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileDiff.d.ts","names":["GetLineIndexUtility","LineSelectionManager","LineSelectionOptions","SelectedLineRange","GetHoveredLineResult","MouseEventManager","MouseEventManagerBaseOptions","ResizeManager","ScrollSyncManager","DiffHunksRenderer","BaseDiffOptions","DiffLineAnnotation","ExpansionDirections","FileContents","FileDiffMetadata","HunkData","HunkSeparators","PrePropertiesConfig","RenderHeaderMetadataCallback","RenderRange","ThemeTypes","WorkerPoolManager","FileDiffRenderProps","LAnnotation","HTMLElement","FileDiffHydrationProps","Omit","FileDiffOptions","Exclude","FileDiff","DocumentFragment","AnnotationElementCache","CustomHunkElementCache","SVGElement","HTMLPreElement","HTMLStyleElement","Map","__0","AnnotationSide","oldFile","newFile","fileDiff","forceRender","lineAnnotations","fileContainer","containerWrapper","renderRange"],"sources":["../../src/components/FileDiff.d.ts"],"sourcesContent":["import { type GetLineIndexUtility, LineSelectionManager, type LineSelectionOptions, type SelectedLineRange } from '../managers/LineSelectionManager';\nimport { type GetHoveredLineResult, MouseEventManager, type MouseEventManagerBaseOptions } from '../managers/MouseEventManager';\nimport { ResizeManager } from '../managers/ResizeManager';\nimport { ScrollSyncManager } from '../managers/ScrollSyncManager';\nimport { DiffHunksRenderer } from '../renderers/DiffHunksRenderer';\nimport type { BaseDiffOptions, DiffLineAnnotation, ExpansionDirections, FileContents, FileDiffMetadata, HunkData, HunkSeparators, PrePropertiesConfig, RenderHeaderMetadataCallback, RenderRange, ThemeTypes } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nexport interface FileDiffRenderProps<LAnnotation> {\n    fileDiff?: FileDiffMetadata;\n    oldFile?: FileContents;\n    newFile?: FileContents;\n    forceRender?: boolean;\n    fileContainer?: HTMLElement;\n    containerWrapper?: HTMLElement;\n    lineAnnotations?: DiffLineAnnotation<LAnnotation>[];\n    renderRange?: RenderRange;\n}\nexport interface FileDiffHydrationProps<LAnnotation> extends Omit<FileDiffRenderProps<LAnnotation>, 'fileContainer'> {\n    fileContainer: HTMLElement;\n    prerenderedHTML?: string;\n}\nexport interface FileDiffOptions<LAnnotation> extends Omit<BaseDiffOptions, 'hunkSeparators'>, MouseEventManagerBaseOptions<'diff'>, LineSelectionOptions {\n    hunkSeparators?: Exclude<HunkSeparators, 'custom'> /**\n       * @deprecated Custom hunk separator functions are deprecated and will be\n       * removed in a future version.\n       */ | ((hunk: HunkData, instance: FileDiff<LAnnotation>) => HTMLElement | DocumentFragment);\n    disableFileHeader?: boolean;\n    renderHeaderMetadata?: RenderHeaderMetadataCallback;\n    /**\n     * When true, errors during rendering are rethrown instead of being caught\n     * and displayed in the DOM. Useful for testing or when you want to handle\n     * errors yourself.\n     */\n    disableErrorHandling?: boolean;\n    renderAnnotation?(annotation: DiffLineAnnotation<LAnnotation>): HTMLElement | undefined;\n    renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'diff'> | undefined): HTMLElement | null;\n}\ninterface AnnotationElementCache<LAnnotation> {\n    element: HTMLElement;\n    annotation: DiffLineAnnotation<LAnnotation>;\n}\ninterface CustomHunkElementCache {\n    element: HTMLElement;\n    hunkData: HunkData;\n}\nexport declare class FileDiff<LAnnotation = undefined> {\n    options: FileDiffOptions<LAnnotation>;\n    protected workerManager?: WorkerPoolManager | undefined;\n    protected isContainerManaged: boolean;\n    static LoadedCustomComponent: boolean;\n    readonly __id: string;\n    protected fileContainer: HTMLElement | undefined;\n    protected spriteSVG: SVGElement | undefined;\n    protected pre: HTMLPreElement | undefined;\n    protected codeUnified: HTMLElement | undefined;\n    protected codeDeletions: HTMLElement | undefined;\n    protected codeAdditions: HTMLElement | undefined;\n    protected bufferBefore: HTMLElement | undefined;\n    protected bufferAfter: HTMLElement | undefined;\n    protected unsafeCSSStyle: HTMLStyleElement | undefined;\n    protected hoverContent: HTMLElement | undefined;\n    protected headerElement: HTMLElement | undefined;\n    protected headerMetadata: HTMLElement | undefined;\n    protected separatorCache: Map<string, CustomHunkElementCache>;\n    protected errorWrapper: HTMLElement | undefined;\n    protected placeHolder: HTMLElement | undefined;\n    protected hunksRenderer: DiffHunksRenderer<LAnnotation>;\n    protected resizeManager: ResizeManager;\n    protected scrollSyncManager: ScrollSyncManager;\n    protected mouseEventManager: MouseEventManager<'diff'>;\n    protected lineSelectionManager: LineSelectionManager;\n    protected annotationCache: Map<string, AnnotationElementCache<LAnnotation>>;\n    protected lineAnnotations: DiffLineAnnotation<LAnnotation>[];\n    protected deletionFile: FileContents | undefined;\n    protected additionFile: FileContents | undefined;\n    protected fileDiff: FileDiffMetadata | undefined;\n    protected renderRange: RenderRange | undefined;\n    protected appliedPreAttributes: PrePropertiesConfig | undefined;\n    protected lastRenderedHeaderHTML: string | undefined;\n    protected lastRowCount: number | undefined;\n    protected enabled: boolean;\n    constructor(options?: FileDiffOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private handleHighlightRender;\n    getLineIndex: GetLineIndexUtility;\n    setOptions(options: FileDiffOptions<LAnnotation> | undefined): void;\n    private mergeOptions;\n    setThemeType(themeType: ThemeTypes): void;\n    getHoveredLine: () => {\n        lineNumber: number;\n        side: import(\"..\").AnnotationSide;\n    } | undefined;\n    setLineAnnotations(lineAnnotations: DiffLineAnnotation<LAnnotation>[]): void;\n    private canPartiallyRender;\n    setSelectedLines(range: SelectedLineRange | null): void;\n    cleanUp(recycle?: boolean): void;\n    virtualizedSetup(): void;\n    hydrate(props: FileDiffHydrationProps<LAnnotation>): void;\n    rerender(): void;\n    handleExpandHunk: (hunkIndex: number, direction: ExpansionDirections) => void;\n    expandHunk(hunkIndex: number, direction: ExpansionDirections): void;\n    render({ oldFile, newFile, fileDiff, forceRender, lineAnnotations, fileContainer, containerWrapper, renderRange }: FileDiffRenderProps<LAnnotation>): boolean;\n    renderPlaceholder(height: number): boolean;\n    private cleanChildNodes;\n    private renderSeparators;\n    private renderAnnotations;\n    private renderHoverUtility;\n    protected getOrCreateFileContainer(fileContainer?: HTMLElement, parentNode?: HTMLElement): HTMLElement;\n    protected getFileContainer(): HTMLElement | undefined;\n    private getOrCreatePreNode;\n    private syncCodeNodesFromPre;\n    private applyHeaderToDOM;\n    private injectUnsafeCSS;\n    private applyHunksToDOM;\n    private applyPartialRender;\n    private insertPartialHTML;\n    private renderPartialColumn;\n    private mergeBuffersIfNecessary;\n    private applyRowSpan;\n    private trimColumnRows;\n    private trimColumns;\n    private getBufferSize;\n    private updateBufferSize;\n    private getCodeColumns;\n    private applyBuffers;\n    private applyPreNodeAttributes;\n    private applyErrorToDOM;\n    private cleanupErrorWrapper;\n}\nexport {};\n//# sourceMappingURL=FileDiff.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"FileDiff.d.ts","names":["GetLineIndexUtility","LineSelectionManager","LineSelectionOptions","SelectedLineRange","GetHoveredLineResult","MouseEventManager","MouseEventManagerBaseOptions","ResizeManager","ScrollSyncManager","DiffHunksRenderer","BaseDiffOptions","DiffLineAnnotation","ExpansionDirections","FileContents","FileDiffMetadata","HunkData","HunkSeparators","PrePropertiesConfig","RenderHeaderMetadataCallback","RenderHeaderPrefixCallback","RenderRange","ThemeTypes","WorkerPoolManager","FileDiffRenderProps","LAnnotation","HTMLElement","FileDiffHydrationProps","Omit","FileDiffOptions","Exclude","FileDiff","DocumentFragment","AnnotationElementCache","CustomHunkElementCache","SVGElement","HTMLPreElement","HTMLStyleElement","Map","__0","AnnotationSide","oldFile","newFile","fileDiff","forceRender","lineAnnotations","fileContainer","containerWrapper","renderRange"],"sources":["../../src/components/FileDiff.d.ts"],"sourcesContent":["import { type GetLineIndexUtility, LineSelectionManager, type LineSelectionOptions, type SelectedLineRange } from '../managers/LineSelectionManager';\nimport { type GetHoveredLineResult, MouseEventManager, type MouseEventManagerBaseOptions } from '../managers/MouseEventManager';\nimport { ResizeManager } from '../managers/ResizeManager';\nimport { ScrollSyncManager } from '../managers/ScrollSyncManager';\nimport { DiffHunksRenderer } from '../renderers/DiffHunksRenderer';\nimport type { BaseDiffOptions, DiffLineAnnotation, ExpansionDirections, FileContents, FileDiffMetadata, HunkData, HunkSeparators, PrePropertiesConfig, RenderHeaderMetadataCallback, RenderHeaderPrefixCallback, RenderRange, ThemeTypes } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nexport interface FileDiffRenderProps<LAnnotation> {\n    fileDiff?: FileDiffMetadata;\n    oldFile?: FileContents;\n    newFile?: FileContents;\n    forceRender?: boolean;\n    fileContainer?: HTMLElement;\n    containerWrapper?: HTMLElement;\n    lineAnnotations?: DiffLineAnnotation<LAnnotation>[];\n    renderRange?: RenderRange;\n}\nexport interface FileDiffHydrationProps<LAnnotation> extends Omit<FileDiffRenderProps<LAnnotation>, 'fileContainer'> {\n    fileContainer: HTMLElement;\n    prerenderedHTML?: string;\n}\nexport interface FileDiffOptions<LAnnotation> extends Omit<BaseDiffOptions, 'hunkSeparators'>, MouseEventManagerBaseOptions<'diff'>, LineSelectionOptions {\n    hunkSeparators?: Exclude<HunkSeparators, 'custom'> /**\n       * @deprecated Custom hunk separator functions are deprecated and will be\n       * removed in a future version.\n       */ | ((hunk: HunkData, instance: FileDiff<LAnnotation>) => HTMLElement | DocumentFragment);\n    disableFileHeader?: boolean;\n    /**\n     * @deprecated Use `enableGutterUtility` instead.\n     */\n    enableHoverUtility?: boolean;\n    renderHeaderPrefix?: RenderHeaderPrefixCallback;\n    renderHeaderMetadata?: RenderHeaderMetadataCallback;\n    /**\n     * When true, errors during rendering are rethrown instead of being caught\n     * and displayed in the DOM. Useful for testing or when you want to handle\n     * errors yourself.\n     */\n    disableErrorHandling?: boolean;\n    renderAnnotation?(annotation: DiffLineAnnotation<LAnnotation>): HTMLElement | undefined;\n    renderGutterUtility?(getHoveredRow: () => GetHoveredLineResult<'diff'> | undefined): HTMLElement | null;\n    /**\n     * @deprecated Use `renderGutterUtility` instead.\n     */\n    renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'diff'> | undefined): HTMLElement | null;\n}\ninterface AnnotationElementCache<LAnnotation> {\n    element: HTMLElement;\n    annotation: DiffLineAnnotation<LAnnotation>;\n}\ninterface CustomHunkElementCache {\n    element: HTMLElement;\n    hunkData: HunkData;\n}\nexport declare class FileDiff<LAnnotation = undefined> {\n    options: FileDiffOptions<LAnnotation>;\n    protected workerManager?: WorkerPoolManager | undefined;\n    protected isContainerManaged: boolean;\n    static LoadedCustomComponent: boolean;\n    readonly __id: string;\n    protected fileContainer: HTMLElement | undefined;\n    protected spriteSVG: SVGElement | undefined;\n    protected pre: HTMLPreElement | undefined;\n    protected codeUnified: HTMLElement | undefined;\n    protected codeDeletions: HTMLElement | undefined;\n    protected codeAdditions: HTMLElement | undefined;\n    protected bufferBefore: HTMLElement | undefined;\n    protected bufferAfter: HTMLElement | undefined;\n    protected unsafeCSSStyle: HTMLStyleElement | undefined;\n    protected gutterUtilityContent: HTMLElement | undefined;\n    protected headerElement: HTMLElement | undefined;\n    protected headerPrefix: HTMLElement | undefined;\n    protected headerMetadata: HTMLElement | undefined;\n    protected separatorCache: Map<string, CustomHunkElementCache>;\n    protected errorWrapper: HTMLElement | undefined;\n    protected placeHolder: HTMLElement | undefined;\n    protected hunksRenderer: DiffHunksRenderer<LAnnotation>;\n    protected resizeManager: ResizeManager;\n    protected scrollSyncManager: ScrollSyncManager;\n    protected mouseEventManager: MouseEventManager<'diff'>;\n    protected lineSelectionManager: LineSelectionManager;\n    protected annotationCache: Map<string, AnnotationElementCache<LAnnotation>>;\n    protected lineAnnotations: DiffLineAnnotation<LAnnotation>[];\n    protected deletionFile: FileContents | undefined;\n    protected additionFile: FileContents | undefined;\n    protected fileDiff: FileDiffMetadata | undefined;\n    protected renderRange: RenderRange | undefined;\n    protected appliedPreAttributes: PrePropertiesConfig | undefined;\n    protected lastRenderedHeaderHTML: string | undefined;\n    protected lastRowCount: number | undefined;\n    protected enabled: boolean;\n    constructor(options?: FileDiffOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private handleHighlightRender;\n    getLineIndex: GetLineIndexUtility;\n    setOptions(options: FileDiffOptions<LAnnotation> | undefined): void;\n    private mergeOptions;\n    setThemeType(themeType: ThemeTypes): void;\n    getHoveredLine: () => {\n        lineNumber: number;\n        side: import(\"..\").AnnotationSide;\n    } | undefined;\n    setLineAnnotations(lineAnnotations: DiffLineAnnotation<LAnnotation>[]): void;\n    private canPartiallyRender;\n    setSelectedLines(range: SelectedLineRange | null): void;\n    cleanUp(recycle?: boolean): void;\n    virtualizedSetup(): void;\n    hydrate(props: FileDiffHydrationProps<LAnnotation>): void;\n    rerender(): void;\n    handleExpandHunk: (hunkIndex: number, direction: ExpansionDirections) => void;\n    expandHunk(hunkIndex: number, direction: ExpansionDirections): void;\n    render({ oldFile, newFile, fileDiff, forceRender, lineAnnotations, fileContainer, containerWrapper, renderRange }: FileDiffRenderProps<LAnnotation>): boolean;\n    private removeRenderedCode;\n    private clearAuxiliaryNodes;\n    renderPlaceholder(height: number): boolean;\n    private cleanChildNodes;\n    private renderSeparators;\n    private renderAnnotations;\n    private renderGutterUtility;\n    protected getOrCreateFileContainer(fileContainer?: HTMLElement, parentNode?: HTMLElement): HTMLElement;\n    protected getFileContainer(): HTMLElement | undefined;\n    private getOrCreatePreNode;\n    private syncCodeNodesFromPre;\n    private applyHeaderToDOM;\n    private injectUnsafeCSS;\n    private applyHunksToDOM;\n    private applyPartialRender;\n    private insertPartialHTML;\n    private renderPartialColumn;\n    private mergeBuffersIfNecessary;\n    private applyRowSpan;\n    private trimColumnRows;\n    private trimColumns;\n    private getBufferSize;\n    private updateBufferSize;\n    private getCodeColumns;\n    private applyBuffers;\n    private applyPreNodeAttributes;\n    private applyErrorToDOM;\n    private cleanupErrorWrapper;\n}\nexport {};\n//# sourceMappingURL=FileDiff.d.ts.map"],"mappings":"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"}

package/dist/components/FileDiff.js

@@ -1,4 +1,4 @@
-import { DEFAULT_THEMES, DIFFS_TAG_NAME, HEADER_METADATA_SLOT_ID, UNSAFE_CSS_ATTRIBUTE } from "../constants.js";
+import { DEFAULT_THEMES, DIFFS_TAG_NAME, EMPTY_RENDER_RANGE, HEADER_METADATA_SLOT_ID, HEADER_PREFIX_SLOT_ID, UNSAFE_CSS_ATTRIBUTE } from "../constants.js";
 import { LineSelectionManager, pluckLineSelectionOptions } from "../managers/LineSelectionManager.js";
 import { MouseEventManager, pluckMouseEventOptions } from "../managers/MouseEventManager.js";
 import { ResizeManager } from "../managers/ResizeManager.js";
@@ -8,7 +8,7 @@ import { SVGSpriteSheet } from "../sprite.js";
 import { areFilesEqual } from "../utils/areFilesEqual.js";
 import { arePrePropertiesEqual } from "../utils/arePrePropertiesEqual.js";
 import { createAnnotationWrapperNode } from "../utils/createAnnotationWrapperNode.js";
-import { createHoverContentNode } from "../utils/createHoverContentNode.js";
+import { createGutterUtilityContentNode } from "../utils/createGutterUtilityContentNode.js";
 import { createUnsafeCSSStyleNode } from "../utils/createUnsafeCSSStyleNode.js";
 import { wrapUnsafeCSS } from "../utils/cssWrappers.js";
 import { getOrCreateCodeNode } from "../utils/getOrCreateCodeNode.js";
@@ -36,8 +36,9 @@ var FileDiff = class {
 	bufferBefore;
 	bufferAfter;
 	unsafeCSSStyle;
-	hoverContent;
+	gutterUtilityContent;
 	headerElement;
+	headerPrefix;
 	headerMetadata;
 	separatorCache = /* @__PURE__ */ new Map();
 	errorWrapper;
@@ -194,6 +195,8 @@ var FileDiff = class {
 		this.bufferAfter = void 0;
 		this.appliedPreAttributes = void 0;
 		this.headerElement = void 0;
+		this.headerPrefix = void 0;
+		this.headerMetadata = void 0;
 		this.lastRenderedHeaderHTML = void 0;
 		this.errorWrapper = void 0;
 		this.spriteSVG = void 0;
@@ -253,7 +256,7 @@ var FileDiff = class {
 			this.fileDiff = fileDiff ?? (oldFile != null && newFile != null ? parseDiffFromFile(oldFile, newFile) : void 0);
 			this.hunksRenderer.hydrate(this.fileDiff);
 			this.renderAnnotations();
-			this.renderHoverUtility();
+			this.renderGutterUtility();
 			this.injectUnsafeCSS();
 			this.mouseEventManager.setup(this.pre);
 			this.lineSelectionManager.setup(this.pre);
@@ -280,12 +283,14 @@ var FileDiff = class {
 	}
 	render({ oldFile, newFile, fileDiff, forceRender = false, lineAnnotations, fileContainer, containerWrapper, renderRange }) {
 		if (!this.enabled) throw new Error("FileDiff.render: attempting to call render after cleaned up");
+		const { collapsed = false } = this.options;
+		const nextRenderRange = collapsed ? void 0 : renderRange;
 		const filesDidChange = oldFile != null && newFile != null && (!areFilesEqual(oldFile, this.deletionFile) || !areFilesEqual(newFile, this.additionFile));
 		let diffDidChange = fileDiff != null && fileDiff !== this.fileDiff;
 		const annotationsChanged = lineAnnotations != null && (lineAnnotations.length > 0 || this.lineAnnotations.length > 0) ? lineAnnotations !== this.lineAnnotations : false;
-		if (areRenderRangesEqual(renderRange, this.renderRange) && !forceRender && !annotationsChanged && (fileDiff != null && fileDiff === this.fileDiff || fileDiff == null && !filesDidChange)) return false;
+		if (!collapsed && areRenderRangesEqual(nextRenderRange, this.renderRange) && !forceRender && !annotationsChanged && (fileDiff != null && fileDiff === this.fileDiff || fileDiff == null && !filesDidChange)) return false;
 		const { renderRange: previousRenderRange } = this;
-		this.renderRange = renderRange;
+		this.renderRange = nextRenderRange;
 		this.deletionFile = oldFile;
 		this.additionFile = newFile;
 		if (fileDiff != null) this.fileDiff = fileDiff;
@@ -307,15 +312,38 @@ var FileDiff = class {
 				this.headerElement = void 0;
 				this.lastRenderedHeaderHTML = void 0;
 			}
+			if (this.headerPrefix != null) {
+				this.headerPrefix.parentNode?.removeChild(this.headerPrefix);
+				this.headerPrefix = void 0;
+			}
+			if (this.headerMetadata != null) {
+				this.headerMetadata.parentNode?.removeChild(this.headerMetadata);
+				this.headerMetadata = void 0;
+			}
 		}
 		fileContainer = this.getOrCreateFileContainer(fileContainer, containerWrapper);
+		if (collapsed) {
+			this.removeRenderedCode();
+			this.clearAuxiliaryNodes();
+			try {
+				const hunksResult = this.hunksRenderer.renderDiff(this.fileDiff, EMPTY_RENDER_RANGE);
+				if (hunksResult?.headerElement != null) this.applyHeaderToDOM(hunksResult.headerElement, fileContainer);
+				this.renderSeparators([]);
+				this.injectUnsafeCSS();
+			} catch (error) {
+				if (disableErrorHandling) throw error;
+				console.error(error);
+				if (error instanceof Error) this.applyErrorToDOM(error, fileContainer);
+			}
+			return true;
+		}
 		try {
 			const pre = this.getOrCreatePreNode(fileContainer);
 			if (!(this.canPartiallyRender(forceRender, annotationsChanged, filesDidChange || diffDidChange) && this.applyPartialRender({
 				previousRenderRange,
-				renderRange
+				renderRange: nextRenderRange
 			}))) {
-				const hunksResult = this.hunksRenderer.renderDiff(this.fileDiff, renderRange);
+				const hunksResult = this.hunksRenderer.renderDiff(this.fileDiff, nextRenderRange);
 				if (hunksResult == null) {
 					if (this.workerManager?.isInitialized() === false) this.workerManager.initialize().then(() => this.rerender());
 					return false;
@@ -328,10 +356,10 @@ var FileDiff = class {
 				}
 				this.renderSeparators(hunksResult.hunkData);
 			}
-			this.applyBuffers(pre, renderRange);
+			this.applyBuffers(pre, nextRenderRange);
 			this.injectUnsafeCSS();
 			this.renderAnnotations();
-			this.renderHoverUtility();
+			this.renderGutterUtility();
 			this.mouseEventManager.setup(pre);
 			this.lineSelectionManager.setup(pre);
 			this.resizeManager.setup(pre, overflow === "wrap");
@@ -344,6 +372,34 @@ var FileDiff = class {
 		}
 		return true;
 	}
+	removeRenderedCode() {
+		this.resizeManager.cleanUp();
+		this.scrollSyncManager.cleanUp();
+		this.mouseEventManager.cleanUp();
+		this.lineSelectionManager.cleanUp();
+		this.bufferBefore?.remove();
+		this.bufferBefore = void 0;
+		this.bufferAfter?.remove();
+		this.bufferAfter = void 0;
+		this.codeUnified?.remove();
+		this.codeUnified = void 0;
+		this.codeDeletions?.remove();
+		this.codeDeletions = void 0;
+		this.codeAdditions?.remove();
+		this.codeAdditions = void 0;
+		this.pre?.remove();
+		this.pre = void 0;
+		this.appliedPreAttributes = void 0;
+		this.lastRowCount = void 0;
+	}
+	clearAuxiliaryNodes() {
+		for (const { element } of this.separatorCache.values()) element.parentNode?.removeChild(element);
+		this.separatorCache.clear();
+		for (const { element } of this.annotationCache.values()) element.parentNode?.removeChild(element);
+		this.annotationCache.clear();
+		this.gutterUtilityContent?.remove();
+		this.gutterUtilityContent = void 0;
+	}
 	renderPlaceholder(height) {
 		if (this.fileContainer == null) return false;
 		this.cleanChildNodes();
@@ -368,7 +424,9 @@ var FileDiff = class {
 		this.codeUnified?.remove();
 		this.errorWrapper?.remove();
 		this.headerElement?.remove();
-		this.hoverContent?.remove();
+		this.gutterUtilityContent?.remove();
+		this.headerPrefix?.remove();
+		this.headerMetadata?.remove();
 		this.pre?.remove();
 		this.spriteSVG?.remove();
 		this.unsafeCSSStyle?.remove();
@@ -379,7 +437,9 @@ var FileDiff = class {
 		this.codeUnified = void 0;
 		this.errorWrapper = void 0;
 		this.headerElement = void 0;
-		this.hoverContent = void 0;
+		this.gutterUtilityContent = void 0;
+		this.headerPrefix = void 0;
+		this.headerMetadata = void 0;
 		this.pre = void 0;
 		this.spriteSVG = void 0;
 		this.unsafeCSSStyle = void 0;
@@ -447,19 +507,24 @@ var FileDiff = class {
 			element.parentNode?.removeChild(element);
 		}
 	}
-	renderHoverUtility() {
-		const { renderHoverUtility } = this.options;
-		if (this.fileContainer == null || renderHoverUtility == null) return;
-		const element = renderHoverUtility(this.mouseEventManager.getHoveredLine);
-		if (element != null && this.hoverContent != null) return;
+	renderGutterUtility() {
+		const renderGutterUtility = this.options.renderGutterUtility ?? this.options.renderHoverUtility;
+		if (this.fileContainer == null || renderGutterUtility == null) {
+			this.gutterUtilityContent?.remove();
+			this.gutterUtilityContent = void 0;
+			return;
+		}
+		const element = renderGutterUtility(this.mouseEventManager.getHoveredLine);
+		if (element != null && this.gutterUtilityContent != null) return;
 		else if (element == null) {
-			this.hoverContent?.parentNode?.removeChild(this.hoverContent);
-			this.hoverContent = void 0;
+			this.gutterUtilityContent?.parentNode?.removeChild(this.gutterUtilityContent);
+			this.gutterUtilityContent = void 0;
 			return;
 		}
-		this.hoverContent = createHoverContentNode();
-		this.hoverContent.appendChild(element);
-		this.fileContainer.appendChild(this.hoverContent);
+		const gutterUtilityContent = createGutterUtilityContentNode();
+		gutterUtilityContent.appendChild(element);
+		this.fileContainer.appendChild(gutterUtilityContent);
+		this.gutterUtilityContent = gutterUtilityContent;
 	}
 	getOrCreateFileContainer(fileContainer, parentNode) {
 		const previousContainer = this.fileContainer;
@@ -527,13 +592,26 @@ var FileDiff = class {
 			this.lastRenderedHeaderHTML = headerHTML;
 		}
 		if (this.isContainerManaged) return;
-		const { renderHeaderMetadata } = this.options;
+		const { renderHeaderPrefix, renderHeaderMetadata } = this.options;
+		if (this.headerPrefix != null) this.headerPrefix.parentNode?.removeChild(this.headerPrefix);
 		if (this.headerMetadata != null) this.headerMetadata.parentNode?.removeChild(this.headerMetadata);
+		const prefix = renderHeaderPrefix?.({
+			deletionFile: this.deletionFile,
+			additionFile: this.additionFile,
+			fileDiff: this.fileDiff
+		}) ?? void 0;
 		const content = renderHeaderMetadata?.({
 			deletionFile: this.deletionFile,
 			additionFile: this.additionFile,
 			fileDiff: this.fileDiff
 		}) ?? void 0;
+		if (prefix != null) {
+			this.headerPrefix = document.createElement("div");
+			this.headerPrefix.slot = HEADER_PREFIX_SLOT_ID;
+			if (prefix instanceof Element) this.headerPrefix.appendChild(prefix);
+			else this.headerPrefix.innerText = `${prefix}`;
+			container.appendChild(this.headerPrefix);
+		}
 		if (content != null) {
 			this.headerMetadata = document.createElement("div");
 			this.headerMetadata.slot = HEADER_METADATA_SLOT_ID;