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

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

@@ -1 +1 @@
-{"version":3,"file":"AdvancedVirtualizedFileDiff.d.ts","names":["FileDiffMetadata","RenderRange","RenderWindow","VirtualFileMetrics","WorkerPoolManager","FileDiff","FileDiffOptions","RenderProps","HTMLElement","PositionProps","AdvancedVirtualizedFileDiff","LAnnotation","unifiedTop","splitTop","fileDiff","Partial","renderWindow","fileContainer"],"sources":["../../src/components/AdvancedVirtualizedFileDiff.d.ts"],"sourcesContent":["import type { FileDiffMetadata, RenderRange, RenderWindow, VirtualFileMetrics } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nimport { FileDiff, type FileDiffOptions } from './FileDiff';\nexport type { FileDiffOptions };\ninterface RenderProps {\n    fileContainer?: HTMLElement;\n    renderWindow: RenderWindow;\n}\ninterface PositionProps {\n    unifiedTop: number;\n    splitTop: number;\n    fileDiff: FileDiffMetadata;\n}\nexport declare class AdvancedVirtualizedFileDiff<LAnnotation = undefined> extends FileDiff<LAnnotation> {\n    readonly __id: string;\n    unifiedTop: number;\n    splitTop: number;\n    unifiedHeight: number;\n    splitHeight: number;\n    private metrics;\n    fileDiff: FileDiffMetadata;\n    renderedRange: RenderRange | undefined;\n    constructor({ unifiedTop, splitTop, fileDiff }: PositionProps, options?: FileDiffOptions<LAnnotation>, metrics?: Partial<VirtualFileMetrics>, workerManager?: WorkerPoolManager | undefined);\n    cleanUp(recycle?: boolean): void;\n    private computeSize;\n    virtualizedRender({ renderWindow, fileContainer }: RenderProps): void;\n    private computeRenderRangeFromWindow;\n}\n//# sourceMappingURL=AdvancedVirtualizedFileDiff.d.ts.map"],"mappings":";;;;;;UAIUO,WAAAA;kBACUC;EADVD,YAAAA,EAEQL,YADEM;AACU;AAO9B,UALUC,aAAAA,CAKWC;EAAsEC,UAAAA,EAAAA,MAAAA;EAO7EX,QAAAA,EAAAA,MAAAA;EACKC,QAAAA,EAVLD,gBAUKC;;AACWY,cATTH,2BASSG,CAAAA,cAAAA,SAAAA,CAAAA,SAToDR,QASpDQ,CAT6DF,WAS7DE,CAAAA,CAAAA;EAAUC,SAAAA,IAAAA,EAAAA,MAAAA;EAAYL,UAAAA,EAAAA,MAAAA;EAAyCE,QAAAA,EAAAA,MAAAA;EAAhBL,aAAAA,EAAAA,MAAAA;EAAgDH,WAAAA,EAAAA,MAAAA;EAARY,QAAAA,OAAAA;EAA6CX,QAAAA,EAFpJJ,gBAEoJI;EAG1IY,aAAAA,EAJLf,WAIKe,GAAAA,SAAAA;EAAcC,WAAAA,CAAAA;IAAAA,UAAAA;IAAAA,QAAAA;IAAAA;EAAAA,CAAAA,EAHcR,aAGdQ,EAAAA,OAAAA,CAAAA,EAHuCX,eAGvCW,CAHuDN,WAGvDM,CAAAA,EAAAA,OAAAA,CAAAA,EAH+EF,OAG/EE,CAHuFd,kBAGvFc,CAAAA,EAAAA,aAAAA,CAAAA,EAH4Hb,iBAG5Ha,GAAAA,SAAAA;EAAiBV,OAAAA,CAAAA,OAAAA,CAAAA,EAAAA,OAAAA,CAAAA,EAAAA,IAAAA;EAZ2BF,QAAAA,WAAAA;EAAQ,iBAAA,CAAA;IAAA,YAAA;IAAA;EAAA,CAAA,EAYnCE,WAZmC,CAAA,EAAA,IAAA"}
+{"version":3,"file":"AdvancedVirtualizedFileDiff.d.ts","names":["FileDiffMetadata","RenderRange","RenderWindow","VirtualFileMetrics","WorkerPoolManager","FileDiff","FileDiffOptions","RenderProps","HTMLElement","PositionProps","AdvancedVirtualizedFileDiff","LAnnotation","unifiedTop","splitTop","fileDiff","Partial","renderWindow","fileContainer"],"sources":["../../src/components/AdvancedVirtualizedFileDiff.d.ts"],"sourcesContent":["import type { FileDiffMetadata, RenderRange, RenderWindow, VirtualFileMetrics } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nimport { FileDiff, type FileDiffOptions } from './FileDiff';\nexport type { FileDiffOptions };\ninterface RenderProps {\n    fileContainer?: HTMLElement;\n    renderWindow: RenderWindow;\n}\ninterface PositionProps {\n    unifiedTop: number;\n    splitTop: number;\n    fileDiff: FileDiffMetadata;\n}\nexport declare class AdvancedVirtualizedFileDiff<LAnnotation = undefined> extends FileDiff<LAnnotation> {\n    readonly __id: string;\n    unifiedTop: number;\n    splitTop: number;\n    unifiedHeight: number;\n    splitHeight: number;\n    private metrics;\n    fileDiff: FileDiffMetadata;\n    renderedRange: RenderRange | undefined;\n    constructor({ unifiedTop, splitTop, fileDiff }: PositionProps, options?: FileDiffOptions<LAnnotation>, metrics?: Partial<VirtualFileMetrics>, workerManager?: WorkerPoolManager | undefined);\n    cleanUp(recycle?: boolean): void;\n    private computeSize;\n    virtualizedRender({ renderWindow, fileContainer }: RenderProps): void;\n    private computeRenderRangeFromWindow;\n}\n//# sourceMappingURL=AdvancedVirtualizedFileDiff.d.ts.map"],"mappings":";;;;;;UAIUO,WAAAA;kBACUC;EADVD,YAAAA,EAEQL,YAFG;AAES;AAO9B,UALUO,aAAAA,CAKWC;EAAsEC,UAAAA,EAAAA,MAAAA;EAO7EX,QAAAA,EAAAA,MAAAA;EACKC,QAAAA,EAVLD,gBAUKC;;AACWY,cATTH,2BASSG,CAAAA,cAAAA,SAAAA,CAAAA,SAToDR,QASpDQ,CAT6DF,WAS7DE,CAAAA,CAAAA;EAAUC,SAAAA,IAAAA,EAAAA,MAAAA;EAAYL,UAAAA,EAAAA,MAAAA;EAAyCE,QAAAA,EAAAA,MAAAA;EAAhBL,aAAAA,EAAAA,MAAAA;EAAgDH,WAAAA,EAAAA,MAAAA;EAARY,QAAAA,OAAAA;EAA6CX,QAAAA,EAFpJJ,gBAEoJI;EAG1IY,aAAAA,EAJLf,WAIKe,GAAAA,SAAAA;EAAcC,WAAAA,CAAAA;IAAAA,UAAAA;IAAAA,QAAAA;IAAAA;EAAAA,CAAAA,EAHcR,aAGdQ,EAAAA,OAAAA,CAAAA,EAHuCX,eAGvCW,CAHuDN,WAGvDM,CAAAA,EAAAA,OAAAA,CAAAA,EAH+EF,OAG/EE,CAHuFd,kBAGvFc,CAAAA,EAAAA,aAAAA,CAAAA,EAH4Hb,iBAG5Ha,GAAAA,SAAAA;EAAiBV,OAAAA,CAAAA,OAAAA,CAAAA,EAAAA,OAAAA,CAAAA,EAAAA,IAAAA;EAZ2BF,QAAAA,WAAAA;EAAQ,iBAAA,CAAA;IAAA,YAAA;IAAA;EAAA,CAAA,EAYnCE,WAZmC,CAAA,EAAA,IAAA"}

package/dist/components/AdvancedVirtualizedFileDiff.js

@@ -1,4 +1,4 @@
-import { DEFAULT_THEMES } from "../constants.js";
+import { DEFAULT_THEMES, EMPTY_RENDER_RANGE } from "../constants.js";
 import { areRenderRangesEqual } from "../utils/areRenderRangesEqual.js";
 import { FileDiff } from "./FileDiff.js";
 import { resolveVirtualFileMetrics } from "../utils/resolveVirtualFileMetrics.js";
@@ -71,12 +71,7 @@ var AdvancedVirtualizedFileDiff = class extends FileDiff {
 		const { lineCount, fileTop, fileHeight } = getSpecs(this, diffStyle);
 		if (fileTop < top - fileHeight || fileTop > bottom) {
 			console.error("VirtulizedFileDiff.computeRenderRangeFromWindow: invalid render", this.fileDiff.name);
-			return {
-				startingLine: 0,
-				totalLines: 0,
-				bufferBefore: 0,
-				bufferAfter: 0
-			};
+			return EMPTY_RENDER_RANGE;
 		}
 		if (lineCount <= hunkLineCount) return {
 			startingLine: 0,

package/dist/components/AdvancedVirtualizedFileDiff.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedVirtualizedFileDiff.js","names":["hunkOffsets: number[]","startingLine: number | undefined","hunkLineCount"],"sources":["../../src/components/AdvancedVirtualizedFileDiff.ts"],"sourcesContent":["import { DEFAULT_THEMES } from '../constants';\nimport type {\n  FileDiffMetadata,\n  RenderRange,\n  RenderWindow,\n  VirtualFileMetrics,\n} from '../types';\nimport { areRenderRangesEqual } from '../utils/areRenderRangesEqual';\nimport { resolveVirtualFileMetrics } from '../utils/resolveVirtualFileMetrics';\nimport type { WorkerPoolManager } from '../worker';\nimport { FileDiff, type FileDiffOptions } from './FileDiff';\n\nexport type { FileDiffOptions };\n\ninterface RenderProps {\n  fileContainer?: HTMLElement;\n  renderWindow: RenderWindow;\n}\n\ninterface PositionProps {\n  unifiedTop: number;\n  splitTop: number;\n  fileDiff: FileDiffMetadata;\n}\n\nlet instanceId = -1;\n\nexport class AdvancedVirtualizedFileDiff<\n  LAnnotation = undefined,\n> extends FileDiff<LAnnotation> {\n  override readonly __id: string = `virtualized-file-diff:${++instanceId}`;\n\n  public unifiedTop: number;\n  public splitTop: number;\n  public unifiedHeight: number = 0;\n  public splitHeight: number = 0;\n  private metrics: VirtualFileMetrics;\n\n  override fileDiff: FileDiffMetadata;\n  public renderedRange: RenderRange | undefined;\n\n  constructor(\n    { unifiedTop, splitTop, fileDiff }: PositionProps,\n    options: FileDiffOptions<LAnnotation> = { theme: DEFAULT_THEMES },\n    metrics?: Partial<VirtualFileMetrics>,\n    workerManager?: WorkerPoolManager | undefined\n  ) {\n    super(options, workerManager, true);\n    this.fileDiff = fileDiff;\n    this.unifiedTop = unifiedTop;\n    this.splitTop = splitTop;\n    const { hunkSeparators = 'line-info' } = this.options;\n    this.metrics = resolveVirtualFileMetrics(\n      typeof hunkSeparators === 'function' ? 'custom' : hunkSeparators,\n      metrics\n    );\n    this.computeSize();\n  }\n\n  override cleanUp(recycle = false): void {\n    super.cleanUp(recycle);\n    this.renderedRange = undefined;\n  }\n\n  private computeSize() {\n    const {\n      options: { disableFileHeader = false },\n      fileDiff,\n      metrics: { diffHeaderHeight, fileGap, hunkSeparatorHeight, lineHeight },\n    } = this;\n\n    // Add header height\n    if (!disableFileHeader) {\n      this.unifiedHeight += diffHeaderHeight;\n      this.splitHeight += diffHeaderHeight;\n    } else {\n      this.unifiedHeight += fileGap;\n      this.splitHeight += fileGap;\n    }\n\n    // NOTE(amadeus): I wonder if it's worth shortcutting this? It might help\n    // to measure these values though and see if it's at all an issue on the\n    // big bois\n    for (const hunk of fileDiff.hunks) {\n      this.unifiedHeight += hunk.unifiedLineCount * lineHeight;\n      this.splitHeight += hunk.splitLineCount * lineHeight;\n    }\n\n    // Add hunk separators height\n    const hunkCount = fileDiff.hunks.length;\n    const [firstHunk] = fileDiff.hunks;\n    if (firstHunk != null) {\n      let hunkSize = (hunkSeparatorHeight + fileGap * 2) * (hunkCount - 1);\n      if (firstHunk.additionStart > 1 || firstHunk.deletionStart > 1) {\n        hunkSize += hunkSeparatorHeight + fileGap;\n      }\n      this.unifiedHeight += hunkSize;\n      this.splitHeight += hunkSize;\n    }\n\n    // If there are hunks of code, then we gotta render some bottom padding\n    if (hunkCount > 0) {\n      this.unifiedHeight += fileGap;\n      this.splitHeight += fileGap;\n    }\n  }\n\n  virtualizedRender({ renderWindow, fileContainer }: RenderProps): void {\n    const { fileDiff } = this;\n    const renderRange = this.computeRenderRangeFromWindow(renderWindow);\n    if (\n      this.fileContainer != null &&\n      areRenderRangesEqual(renderRange, this.renderedRange)\n    ) {\n      return;\n    }\n    this.renderedRange = renderRange;\n    fileContainer = this.getOrCreateFileContainer(fileContainer);\n    this.render({ fileDiff, fileContainer, renderRange });\n  }\n\n  private computeRenderRangeFromWindow({\n    top,\n    bottom,\n  }: RenderWindow): RenderRange {\n    const { diffStyle = 'split', disableFileHeader = false } = this.options;\n    const {\n      diffHeaderHeight,\n      fileGap,\n      hunkLineCount,\n      hunkSeparatorHeight,\n      lineHeight,\n    } = this.metrics;\n    const { lineCount, fileTop, fileHeight } = getSpecs(this, diffStyle);\n\n    // We should never hit this theoretically, but if so, gtfo and yell loudly,\n    // so we can fix\n    if (fileTop < top - fileHeight || fileTop > bottom) {\n      console.error(\n        'VirtulizedFileDiff.computeRenderRangeFromWindow: invalid render',\n        this.fileDiff.name\n      );\n      return {\n        startingLine: 0,\n        totalLines: 0,\n        bufferBefore: 0,\n        bufferAfter: 0,\n      };\n    }\n\n    // Whole file is under HUNK_LINE_COUNT, just render it all\n    if (lineCount <= hunkLineCount) {\n      return {\n        startingLine: 0,\n        totalLines: Infinity,\n        bufferBefore: 0,\n        bufferAfter: 0,\n      };\n    }\n\n    const headerRegion = disableFileHeader ? fileGap : diffHeaderHeight;\n    let absoluteLineTop = fileTop + headerRegion;\n    let currentLine = 0;\n    const hunkOffsets: number[] = [];\n    let startingLine: number | undefined;\n    let endingLine = 0;\n    for (const hunk of this.fileDiff.hunks) {\n      let hunkGap = 0;\n      if (hunk.additionStart > 1 || hunk.deletionStart > 1) {\n        hunkGap = hunkSeparatorHeight + fileGap;\n        if (hunk !== this.fileDiff.hunks[0]) {\n          hunkGap += fileGap;\n        }\n        absoluteLineTop += hunkGap;\n      }\n      const hunkLineCount =\n        diffStyle === 'split' ? hunk.splitLineCount : hunk.unifiedLineCount;\n      for (let l = 0; l < hunkLineCount; l++) {\n        if (currentLine % hunkLineCount === 0) {\n          hunkOffsets.push(\n            absoluteLineTop - (fileTop + headerRegion + (l === 0 ? hunkGap : 0))\n          );\n        }\n        if (\n          startingLine == null &&\n          absoluteLineTop > top - lineHeight &&\n          absoluteLineTop < bottom\n        ) {\n          startingLine = currentLine;\n          endingLine = startingLine + 1;\n        } else if (startingLine != null && absoluteLineTop < bottom) {\n          endingLine++;\n        }\n        currentLine++;\n        absoluteLineTop += lineHeight;\n      }\n    }\n\n    if (startingLine == null) {\n      return {\n        startingLine: 0,\n        totalLines: 0,\n        bufferBefore: fileHeight - headerRegion,\n        bufferAfter: 0,\n      };\n    }\n\n    startingLine = Math.floor(startingLine / hunkLineCount) * hunkLineCount;\n    const totalLines =\n      Math.ceil((endingLine - startingLine) / hunkLineCount) * hunkLineCount;\n\n    const finalHunkBufferOffset = (startingLine + totalLines) / hunkLineCount;\n    const bufferBefore = hunkOffsets[startingLine / hunkLineCount] ?? 0;\n    const bufferAfter =\n      finalHunkBufferOffset < hunkOffsets.length\n        ? fileHeight -\n          headerRegion -\n          hunkOffsets[finalHunkBufferOffset] -\n          fileGap // this is to account for bottom padding of the code container\n        : 0;\n    return { startingLine, totalLines, bufferBefore, bufferAfter };\n  }\n}\n\nfunction getSpecs<LAnnotation>(\n  instance: AdvancedVirtualizedFileDiff<LAnnotation>,\n  type: 'split' | 'unified' = 'split'\n) {\n  if (type === 'split') {\n    return {\n      lineCount: instance.fileDiff.splitLineCount,\n      fileTop: instance.splitTop,\n      fileHeight: instance.splitHeight,\n    };\n  }\n  return {\n    lineCount: instance.fileDiff.unifiedLineCount,\n    fileTop: instance.unifiedTop,\n    fileHeight: instance.unifiedHeight,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"AdvancedVirtualizedFileDiff.js","names":["hunkOffsets: number[]","startingLine: number | undefined","hunkLineCount"],"sources":["../../src/components/AdvancedVirtualizedFileDiff.ts"],"sourcesContent":["import { DEFAULT_THEMES, EMPTY_RENDER_RANGE } from '../constants';\nimport type {\n  FileDiffMetadata,\n  RenderRange,\n  RenderWindow,\n  VirtualFileMetrics,\n} from '../types';\nimport { areRenderRangesEqual } from '../utils/areRenderRangesEqual';\nimport { resolveVirtualFileMetrics } from '../utils/resolveVirtualFileMetrics';\nimport type { WorkerPoolManager } from '../worker';\nimport { FileDiff, type FileDiffOptions } from './FileDiff';\n\nexport type { FileDiffOptions };\n\ninterface RenderProps {\n  fileContainer?: HTMLElement;\n  renderWindow: RenderWindow;\n}\n\ninterface PositionProps {\n  unifiedTop: number;\n  splitTop: number;\n  fileDiff: FileDiffMetadata;\n}\n\nlet instanceId = -1;\n\nexport class AdvancedVirtualizedFileDiff<\n  LAnnotation = undefined,\n> extends FileDiff<LAnnotation> {\n  override readonly __id: string = `virtualized-file-diff:${++instanceId}`;\n\n  public unifiedTop: number;\n  public splitTop: number;\n  public unifiedHeight: number = 0;\n  public splitHeight: number = 0;\n  private metrics: VirtualFileMetrics;\n\n  override fileDiff: FileDiffMetadata;\n  public renderedRange: RenderRange | undefined;\n\n  constructor(\n    { unifiedTop, splitTop, fileDiff }: PositionProps,\n    options: FileDiffOptions<LAnnotation> = { theme: DEFAULT_THEMES },\n    metrics?: Partial<VirtualFileMetrics>,\n    workerManager?: WorkerPoolManager | undefined\n  ) {\n    super(options, workerManager, true);\n    this.fileDiff = fileDiff;\n    this.unifiedTop = unifiedTop;\n    this.splitTop = splitTop;\n    const { hunkSeparators = 'line-info' } = this.options;\n    this.metrics = resolveVirtualFileMetrics(\n      typeof hunkSeparators === 'function' ? 'custom' : hunkSeparators,\n      metrics\n    );\n    this.computeSize();\n  }\n\n  override cleanUp(recycle = false): void {\n    super.cleanUp(recycle);\n    this.renderedRange = undefined;\n  }\n\n  private computeSize() {\n    const {\n      options: { disableFileHeader = false },\n      fileDiff,\n      metrics: { diffHeaderHeight, fileGap, hunkSeparatorHeight, lineHeight },\n    } = this;\n\n    // Add header height\n    if (!disableFileHeader) {\n      this.unifiedHeight += diffHeaderHeight;\n      this.splitHeight += diffHeaderHeight;\n    } else {\n      this.unifiedHeight += fileGap;\n      this.splitHeight += fileGap;\n    }\n\n    // NOTE(amadeus): I wonder if it's worth shortcutting this? It might help\n    // to measure these values though and see if it's at all an issue on the\n    // big bois\n    for (const hunk of fileDiff.hunks) {\n      this.unifiedHeight += hunk.unifiedLineCount * lineHeight;\n      this.splitHeight += hunk.splitLineCount * lineHeight;\n    }\n\n    // Add hunk separators height\n    const hunkCount = fileDiff.hunks.length;\n    const [firstHunk] = fileDiff.hunks;\n    if (firstHunk != null) {\n      let hunkSize = (hunkSeparatorHeight + fileGap * 2) * (hunkCount - 1);\n      if (firstHunk.additionStart > 1 || firstHunk.deletionStart > 1) {\n        hunkSize += hunkSeparatorHeight + fileGap;\n      }\n      this.unifiedHeight += hunkSize;\n      this.splitHeight += hunkSize;\n    }\n\n    // If there are hunks of code, then we gotta render some bottom padding\n    if (hunkCount > 0) {\n      this.unifiedHeight += fileGap;\n      this.splitHeight += fileGap;\n    }\n  }\n\n  virtualizedRender({ renderWindow, fileContainer }: RenderProps): void {\n    const { fileDiff } = this;\n    const renderRange = this.computeRenderRangeFromWindow(renderWindow);\n    if (\n      this.fileContainer != null &&\n      areRenderRangesEqual(renderRange, this.renderedRange)\n    ) {\n      return;\n    }\n    this.renderedRange = renderRange;\n    fileContainer = this.getOrCreateFileContainer(fileContainer);\n    this.render({ fileDiff, fileContainer, renderRange });\n  }\n\n  private computeRenderRangeFromWindow({\n    top,\n    bottom,\n  }: RenderWindow): RenderRange {\n    const { diffStyle = 'split', disableFileHeader = false } = this.options;\n    const {\n      diffHeaderHeight,\n      fileGap,\n      hunkLineCount,\n      hunkSeparatorHeight,\n      lineHeight,\n    } = this.metrics;\n    const { lineCount, fileTop, fileHeight } = getSpecs(this, diffStyle);\n\n    // We should never hit this theoretically, but if so, gtfo and yell loudly,\n    // so we can fix\n    if (fileTop < top - fileHeight || fileTop > bottom) {\n      console.error(\n        'VirtulizedFileDiff.computeRenderRangeFromWindow: invalid render',\n        this.fileDiff.name\n      );\n      return EMPTY_RENDER_RANGE;\n    }\n\n    // Whole file is under HUNK_LINE_COUNT, just render it all\n    if (lineCount <= hunkLineCount) {\n      return {\n        startingLine: 0,\n        totalLines: Infinity,\n        bufferBefore: 0,\n        bufferAfter: 0,\n      };\n    }\n\n    const headerRegion = disableFileHeader ? fileGap : diffHeaderHeight;\n    let absoluteLineTop = fileTop + headerRegion;\n    let currentLine = 0;\n    const hunkOffsets: number[] = [];\n    let startingLine: number | undefined;\n    let endingLine = 0;\n    for (const hunk of this.fileDiff.hunks) {\n      let hunkGap = 0;\n      if (hunk.additionStart > 1 || hunk.deletionStart > 1) {\n        hunkGap = hunkSeparatorHeight + fileGap;\n        if (hunk !== this.fileDiff.hunks[0]) {\n          hunkGap += fileGap;\n        }\n        absoluteLineTop += hunkGap;\n      }\n      const hunkLineCount =\n        diffStyle === 'split' ? hunk.splitLineCount : hunk.unifiedLineCount;\n      for (let l = 0; l < hunkLineCount; l++) {\n        if (currentLine % hunkLineCount === 0) {\n          hunkOffsets.push(\n            absoluteLineTop - (fileTop + headerRegion + (l === 0 ? hunkGap : 0))\n          );\n        }\n        if (\n          startingLine == null &&\n          absoluteLineTop > top - lineHeight &&\n          absoluteLineTop < bottom\n        ) {\n          startingLine = currentLine;\n          endingLine = startingLine + 1;\n        } else if (startingLine != null && absoluteLineTop < bottom) {\n          endingLine++;\n        }\n        currentLine++;\n        absoluteLineTop += lineHeight;\n      }\n    }\n\n    if (startingLine == null) {\n      return {\n        startingLine: 0,\n        totalLines: 0,\n        bufferBefore: fileHeight - headerRegion,\n        bufferAfter: 0,\n      };\n    }\n\n    startingLine = Math.floor(startingLine / hunkLineCount) * hunkLineCount;\n    const totalLines =\n      Math.ceil((endingLine - startingLine) / hunkLineCount) * hunkLineCount;\n\n    const finalHunkBufferOffset = (startingLine + totalLines) / hunkLineCount;\n    const bufferBefore = hunkOffsets[startingLine / hunkLineCount] ?? 0;\n    const bufferAfter =\n      finalHunkBufferOffset < hunkOffsets.length\n        ? fileHeight -\n          headerRegion -\n          hunkOffsets[finalHunkBufferOffset] -\n          fileGap // this is to account for bottom padding of the code container\n        : 0;\n    return { startingLine, totalLines, bufferBefore, bufferAfter };\n  }\n}\n\nfunction getSpecs<LAnnotation>(\n  instance: AdvancedVirtualizedFileDiff<LAnnotation>,\n  type: 'split' | 'unified' = 'split'\n) {\n  if (type === 'split') {\n    return {\n      lineCount: instance.fileDiff.splitLineCount,\n      fileTop: instance.splitTop,\n      fileHeight: instance.splitHeight,\n    };\n  }\n  return {\n    lineCount: instance.fileDiff.unifiedLineCount,\n    fileTop: instance.unifiedTop,\n    fileHeight: instance.unifiedHeight,\n  };\n}\n"],"mappings":";;;;;;AAyBA,IAAI,aAAa;AAEjB,IAAa,8BAAb,cAEU,SAAsB;CAC9B,AAAkB,OAAe,yBAAyB,EAAE;CAE5D,AAAO;CACP,AAAO;CACP,AAAO,gBAAwB;CAC/B,AAAO,cAAsB;CAC7B,AAAQ;CAER,AAAS;CACT,AAAO;CAEP,YACE,EAAE,YAAY,UAAU,YACxB,UAAwC,EAAE,OAAO,gBAAgB,EACjE,SACA,eACA;AACA,QAAM,SAAS,eAAe,KAAK;AACnC,OAAK,WAAW;AAChB,OAAK,aAAa;AAClB,OAAK,WAAW;EAChB,MAAM,EAAE,iBAAiB,gBAAgB,KAAK;AAC9C,OAAK,UAAU,0BACb,OAAO,mBAAmB,aAAa,WAAW,gBAClD,QACD;AACD,OAAK,aAAa;;CAGpB,AAAS,QAAQ,UAAU,OAAa;AACtC,QAAM,QAAQ,QAAQ;AACtB,OAAK,gBAAgB;;CAGvB,AAAQ,cAAc;EACpB,MAAM,EACJ,SAAS,EAAE,oBAAoB,SAC/B,UACA,SAAS,EAAE,kBAAkB,SAAS,qBAAqB,iBACzD;AAGJ,MAAI,CAAC,mBAAmB;AACtB,QAAK,iBAAiB;AACtB,QAAK,eAAe;SACf;AACL,QAAK,iBAAiB;AACtB,QAAK,eAAe;;AAMtB,OAAK,MAAM,QAAQ,SAAS,OAAO;AACjC,QAAK,iBAAiB,KAAK,mBAAmB;AAC9C,QAAK,eAAe,KAAK,iBAAiB;;EAI5C,MAAM,YAAY,SAAS,MAAM;EACjC,MAAM,CAAC,aAAa,SAAS;AAC7B,MAAI,aAAa,MAAM;GACrB,IAAI,YAAY,sBAAsB,UAAU,MAAM,YAAY;AAClE,OAAI,UAAU,gBAAgB,KAAK,UAAU,gBAAgB,EAC3D,aAAY,sBAAsB;AAEpC,QAAK,iBAAiB;AACtB,QAAK,eAAe;;AAItB,MAAI,YAAY,GAAG;AACjB,QAAK,iBAAiB;AACtB,QAAK,eAAe;;;CAIxB,kBAAkB,EAAE,cAAc,iBAAoC;EACpE,MAAM,EAAE,aAAa;EACrB,MAAM,cAAc,KAAK,6BAA6B,aAAa;AACnE,MACE,KAAK,iBAAiB,QACtB,qBAAqB,aAAa,KAAK,cAAc,CAErD;AAEF,OAAK,gBAAgB;AACrB,kBAAgB,KAAK,yBAAyB,cAAc;AAC5D,OAAK,OAAO;GAAE;GAAU;GAAe;GAAa,CAAC;;CAGvD,AAAQ,6BAA6B,EACnC,KACA,UAC4B;EAC5B,MAAM,EAAE,YAAY,SAAS,oBAAoB,UAAU,KAAK;EAChE,MAAM,EACJ,kBACA,SACA,eACA,qBACA,eACE,KAAK;EACT,MAAM,EAAE,WAAW,SAAS,eAAe,SAAS,MAAM,UAAU;AAIpE,MAAI,UAAU,MAAM,cAAc,UAAU,QAAQ;AAClD,WAAQ,MACN,mEACA,KAAK,SAAS,KACf;AACD,UAAO;;AAIT,MAAI,aAAa,cACf,QAAO;GACL,cAAc;GACd,YAAY;GACZ,cAAc;GACd,aAAa;GACd;EAGH,MAAM,eAAe,oBAAoB,UAAU;EACnD,IAAI,kBAAkB,UAAU;EAChC,IAAI,cAAc;EAClB,MAAMA,cAAwB,EAAE;EAChC,IAAIC;EACJ,IAAI,aAAa;AACjB,OAAK,MAAM,QAAQ,KAAK,SAAS,OAAO;GACtC,IAAI,UAAU;AACd,OAAI,KAAK,gBAAgB,KAAK,KAAK,gBAAgB,GAAG;AACpD,cAAU,sBAAsB;AAChC,QAAI,SAAS,KAAK,SAAS,MAAM,GAC/B,YAAW;AAEb,uBAAmB;;GAErB,MAAMC,kBACJ,cAAc,UAAU,KAAK,iBAAiB,KAAK;AACrD,QAAK,IAAI,IAAI,GAAG,IAAIA,iBAAe,KAAK;AACtC,QAAI,cAAcA,oBAAkB,EAClC,aAAY,KACV,mBAAmB,UAAU,gBAAgB,MAAM,IAAI,UAAU,IAClE;AAEH,QACE,gBAAgB,QAChB,kBAAkB,MAAM,cACxB,kBAAkB,QAClB;AACA,oBAAe;AACf,kBAAa,eAAe;eACnB,gBAAgB,QAAQ,kBAAkB,OACnD;AAEF;AACA,uBAAmB;;;AAIvB,MAAI,gBAAgB,KAClB,QAAO;GACL,cAAc;GACd,YAAY;GACZ,cAAc,aAAa;GAC3B,aAAa;GACd;AAGH,iBAAe,KAAK,MAAM,eAAe,cAAc,GAAG;EAC1D,MAAM,aACJ,KAAK,MAAM,aAAa,gBAAgB,cAAc,GAAG;EAE3D,MAAM,yBAAyB,eAAe,cAAc;EAC5D,MAAM,eAAe,YAAY,eAAe,kBAAkB;EAClE,MAAM,cACJ,wBAAwB,YAAY,SAChC,aACA,eACA,YAAY,yBACZ,UACA;AACN,SAAO;GAAE;GAAc;GAAY;GAAc;GAAa;;;AAIlE,SAAS,SACP,UACA,OAA4B,SAC5B;AACA,KAAI,SAAS,QACX,QAAO;EACL,WAAW,SAAS,SAAS;EAC7B,SAAS,SAAS;EAClB,YAAY,SAAS;EACtB;AAEH,QAAO;EACL,WAAW,SAAS,SAAS;EAC7B,SAAS,SAAS;EAClB,YAAY,SAAS;EACtB"}

package/dist/components/File.d.ts

@@ -21,6 +21,11 @@ interface FileHyrdateProps<LAnnotation> extends Omit<FileRenderProps<LAnnotation
 }
 interface FileOptions<LAnnotation> extends BaseCodeOptions, MouseEventManagerBaseOptions<'file'>, LineSelectionOptions {
   disableFileHeader?: boolean;
+  /**
+   * @deprecated Use `enableGutterUtility` instead.
+   */
+  enableHoverUtility?: boolean;
+  renderHeaderPrefix?: RenderFileMetadata;
   renderCustomMetadata?: RenderFileMetadata;
   /**
    * When true, errors during rendering are rethrown instead of being caught
@@ -29,6 +34,10 @@ interface FileOptions<LAnnotation> extends BaseCodeOptions, MouseEventManagerBas
    */
   disableErrorHandling?: boolean;
   renderAnnotation?(annotation: LineAnnotation<LAnnotation>): HTMLElement | undefined;
+  renderGutterUtility?(getHoveredRow: () => GetHoveredLineResult<'file'> | undefined): HTMLElement | null;
+  /**
+   * @deprecated Use `renderGutterUtility` instead.
+   */
   renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'file'> | undefined): HTMLElement | null;
 }
 interface AnnotationElementCache<LAnnotation> {
@@ -48,13 +57,14 @@ declare class File<LAnnotation = undefined> {
   protected bufferBefore: HTMLElement | undefined;
   protected bufferAfter: HTMLElement | undefined;
   protected unsafeCSSStyle: HTMLStyleElement | undefined;
-  protected hoverContent: HTMLElement | undefined;
+  protected gutterUtilityContent: HTMLElement | undefined;
   protected errorWrapper: HTMLElement | undefined;
   protected placeHolder: HTMLElement | undefined;
   protected lastRenderedHeaderHTML: string | undefined;
   protected appliedPreAttributes: PrePropertiesConfig | undefined;
   protected lastRowCount: number | undefined;
   protected headerElement: HTMLElement | undefined;
+  protected headerPrefix: HTMLElement | undefined;
   protected headerMetadata: HTMLElement | undefined;
   protected fileRenderer: FileRenderer<LAnnotation>;
   protected resizeManager: ResizeManager;
@@ -86,11 +96,13 @@ declare class File<LAnnotation = undefined> {
     lineAnnotations,
     renderRange
   }: FileRenderProps<LAnnotation>): boolean;
+  private removeRenderedCode;
+  private clearAuxiliaryNodes;
   private canPartiallyRender;
   renderPlaceholder(height: number): boolean;
   private cleanChildNodes;
   private renderAnnotations;
-  private renderHoverUtility;
+  private renderGutterUtility;
   private injectUnsafeCSS;
   private applyFullRender;
   private applyPartialRender;

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

@@ -1 +1 @@
-{"version":3,"file":"File.d.ts","names":["LineSelectionManager","LineSelectionOptions","SelectedLineRange","GetHoveredLineResult","MouseEventManager","MouseEventManagerBaseOptions","ResizeManager","FileRenderer","BaseCodeOptions","FileContents","LineAnnotation","PrePropertiesConfig","RenderFileMetadata","RenderRange","ThemeTypes","WorkerPoolManager","FileRenderProps","LAnnotation","HTMLElement","FileHyrdateProps","Omit","FileOptions","AnnotationElementCache","File","SVGElement","HTMLPreElement","HTMLStyleElement","Map","file","fileContainer","forceRender","containerWrapper","lineAnnotations","renderRange"],"sources":["../../src/components/File.d.ts"],"sourcesContent":["import { LineSelectionManager, type LineSelectionOptions, type SelectedLineRange } from '../managers/LineSelectionManager';\nimport { type GetHoveredLineResult, MouseEventManager, type MouseEventManagerBaseOptions } from '../managers/MouseEventManager';\nimport { ResizeManager } from '../managers/ResizeManager';\nimport { FileRenderer } from '../renderers/FileRenderer';\nimport type { BaseCodeOptions, FileContents, LineAnnotation, PrePropertiesConfig, RenderFileMetadata, RenderRange, ThemeTypes } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nexport interface FileRenderProps<LAnnotation> {\n    file: FileContents;\n    fileContainer?: HTMLElement;\n    containerWrapper?: HTMLElement;\n    forceRender?: boolean;\n    lineAnnotations?: LineAnnotation<LAnnotation>[];\n    renderRange?: RenderRange;\n}\nexport interface FileHyrdateProps<LAnnotation> extends Omit<FileRenderProps<LAnnotation>, 'fileContainer'> {\n    fileContainer: HTMLElement;\n    prerenderedHTML?: string;\n}\nexport interface FileOptions<LAnnotation> extends BaseCodeOptions, MouseEventManagerBaseOptions<'file'>, LineSelectionOptions {\n    disableFileHeader?: boolean;\n    renderCustomMetadata?: RenderFileMetadata;\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: LineAnnotation<LAnnotation>): HTMLElement | undefined;\n    renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'file'> | undefined): HTMLElement | null;\n}\ninterface AnnotationElementCache<LAnnotation> {\n    element: HTMLElement;\n    annotation: LineAnnotation<LAnnotation>;\n}\nexport declare class File<LAnnotation = undefined> {\n    options: FileOptions<LAnnotation>;\n    private workerManager?;\n    private isContainerManaged;\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 code: HTMLElement | undefined;\n    protected bufferBefore: HTMLElement | undefined;\n    protected bufferAfter: HTMLElement | undefined;\n    protected unsafeCSSStyle: HTMLStyleElement | undefined;\n    protected hoverContent: HTMLElement | undefined;\n    protected errorWrapper: HTMLElement | undefined;\n    protected placeHolder: HTMLElement | undefined;\n    protected lastRenderedHeaderHTML: string | undefined;\n    protected appliedPreAttributes: PrePropertiesConfig | undefined;\n    protected lastRowCount: number | undefined;\n    protected headerElement: HTMLElement | undefined;\n    protected headerMetadata: HTMLElement | undefined;\n    protected fileRenderer: FileRenderer<LAnnotation>;\n    protected resizeManager: ResizeManager;\n    protected mouseEventManager: MouseEventManager<'file'>;\n    protected lineSelectionManager: LineSelectionManager;\n    protected annotationCache: Map<string, AnnotationElementCache<LAnnotation>>;\n    protected lineAnnotations: LineAnnotation<LAnnotation>[];\n    protected file: FileContents | undefined;\n    protected renderRange: RenderRange | undefined;\n    constructor(options?: FileOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private handleHighlightRender;\n    rerender(): void;\n    setOptions(options: FileOptions<LAnnotation> | undefined): void;\n    private mergeOptions;\n    setThemeType(themeType: ThemeTypes): void;\n    getHoveredLine: () => {\n        lineNumber: number;\n    } | undefined;\n    setLineAnnotations(lineAnnotations: LineAnnotation<LAnnotation>[]): void;\n    setSelectedLines(range: SelectedLineRange | null): void;\n    cleanUp(): void;\n    hydrate(props: FileHyrdateProps<LAnnotation>): void;\n    getOrCreateLineCache(file?: FileContents | undefined): string[];\n    render({ file, fileContainer, forceRender, containerWrapper, lineAnnotations, renderRange }: FileRenderProps<LAnnotation>): boolean;\n    private canPartiallyRender;\n    renderPlaceholder(height: number): boolean;\n    private cleanChildNodes;\n    private renderAnnotations;\n    private renderHoverUtility;\n    private injectUnsafeCSS;\n    private applyFullRender;\n    private applyPartialRender;\n    private getColumns;\n    private trimDOMToOverlap;\n    private getDOMBoundaryIndices;\n    private getLineIndexFromDOMNode;\n    private applyBuffers;\n    private applyHeaderToDOM;\n    protected getOrCreateFileContainerNode(fileContainer?: HTMLElement, parentNode?: HTMLElement): HTMLElement;\n    private getOrCreatePreNode;\n    private applyPreNodeAttributes;\n    private applyErrorToDOM;\n    private cleanupErrorWrapper;\n}\nexport {};\n//# sourceMappingURL=File.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"File.d.ts","names":["LineSelectionManager","LineSelectionOptions","SelectedLineRange","GetHoveredLineResult","MouseEventManager","MouseEventManagerBaseOptions","ResizeManager","FileRenderer","BaseCodeOptions","FileContents","LineAnnotation","PrePropertiesConfig","RenderFileMetadata","RenderRange","ThemeTypes","WorkerPoolManager","FileRenderProps","LAnnotation","HTMLElement","FileHyrdateProps","Omit","FileOptions","AnnotationElementCache","File","SVGElement","HTMLPreElement","HTMLStyleElement","Map","file","fileContainer","forceRender","containerWrapper","lineAnnotations","renderRange"],"sources":["../../src/components/File.d.ts"],"sourcesContent":["import { LineSelectionManager, type LineSelectionOptions, type SelectedLineRange } from '../managers/LineSelectionManager';\nimport { type GetHoveredLineResult, MouseEventManager, type MouseEventManagerBaseOptions } from '../managers/MouseEventManager';\nimport { ResizeManager } from '../managers/ResizeManager';\nimport { FileRenderer } from '../renderers/FileRenderer';\nimport type { BaseCodeOptions, FileContents, LineAnnotation, PrePropertiesConfig, RenderFileMetadata, RenderRange, ThemeTypes } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nexport interface FileRenderProps<LAnnotation> {\n    file: FileContents;\n    fileContainer?: HTMLElement;\n    containerWrapper?: HTMLElement;\n    forceRender?: boolean;\n    lineAnnotations?: LineAnnotation<LAnnotation>[];\n    renderRange?: RenderRange;\n}\nexport interface FileHyrdateProps<LAnnotation> extends Omit<FileRenderProps<LAnnotation>, 'fileContainer'> {\n    fileContainer: HTMLElement;\n    prerenderedHTML?: string;\n}\nexport interface FileOptions<LAnnotation> extends BaseCodeOptions, MouseEventManagerBaseOptions<'file'>, LineSelectionOptions {\n    disableFileHeader?: boolean;\n    /**\n     * @deprecated Use `enableGutterUtility` instead.\n     */\n    enableHoverUtility?: boolean;\n    renderHeaderPrefix?: RenderFileMetadata;\n    renderCustomMetadata?: RenderFileMetadata;\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: LineAnnotation<LAnnotation>): HTMLElement | undefined;\n    renderGutterUtility?(getHoveredRow: () => GetHoveredLineResult<'file'> | undefined): HTMLElement | null;\n    /**\n     * @deprecated Use `renderGutterUtility` instead.\n     */\n    renderHoverUtility?(getHoveredRow: () => GetHoveredLineResult<'file'> | undefined): HTMLElement | null;\n}\ninterface AnnotationElementCache<LAnnotation> {\n    element: HTMLElement;\n    annotation: LineAnnotation<LAnnotation>;\n}\nexport declare class File<LAnnotation = undefined> {\n    options: FileOptions<LAnnotation>;\n    private workerManager?;\n    private isContainerManaged;\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 code: HTMLElement | undefined;\n    protected bufferBefore: HTMLElement | undefined;\n    protected bufferAfter: HTMLElement | undefined;\n    protected unsafeCSSStyle: HTMLStyleElement | undefined;\n    protected gutterUtilityContent: HTMLElement | undefined;\n    protected errorWrapper: HTMLElement | undefined;\n    protected placeHolder: HTMLElement | undefined;\n    protected lastRenderedHeaderHTML: string | undefined;\n    protected appliedPreAttributes: PrePropertiesConfig | undefined;\n    protected lastRowCount: number | undefined;\n    protected headerElement: HTMLElement | undefined;\n    protected headerPrefix: HTMLElement | undefined;\n    protected headerMetadata: HTMLElement | undefined;\n    protected fileRenderer: FileRenderer<LAnnotation>;\n    protected resizeManager: ResizeManager;\n    protected mouseEventManager: MouseEventManager<'file'>;\n    protected lineSelectionManager: LineSelectionManager;\n    protected annotationCache: Map<string, AnnotationElementCache<LAnnotation>>;\n    protected lineAnnotations: LineAnnotation<LAnnotation>[];\n    protected file: FileContents | undefined;\n    protected renderRange: RenderRange | undefined;\n    constructor(options?: FileOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private handleHighlightRender;\n    rerender(): void;\n    setOptions(options: FileOptions<LAnnotation> | undefined): void;\n    private mergeOptions;\n    setThemeType(themeType: ThemeTypes): void;\n    getHoveredLine: () => {\n        lineNumber: number;\n    } | undefined;\n    setLineAnnotations(lineAnnotations: LineAnnotation<LAnnotation>[]): void;\n    setSelectedLines(range: SelectedLineRange | null): void;\n    cleanUp(): void;\n    hydrate(props: FileHyrdateProps<LAnnotation>): void;\n    getOrCreateLineCache(file?: FileContents | undefined): string[];\n    render({ file, fileContainer, forceRender, containerWrapper, lineAnnotations, renderRange }: FileRenderProps<LAnnotation>): boolean;\n    private removeRenderedCode;\n    private clearAuxiliaryNodes;\n    private canPartiallyRender;\n    renderPlaceholder(height: number): boolean;\n    private cleanChildNodes;\n    private renderAnnotations;\n    private renderGutterUtility;\n    private injectUnsafeCSS;\n    private applyFullRender;\n    private applyPartialRender;\n    private getColumns;\n    private trimDOMToOverlap;\n    private getDOMBoundaryIndices;\n    private getLineIndexFromDOMNode;\n    private applyBuffers;\n    private applyHeaderToDOM;\n    protected getOrCreateFileContainerNode(fileContainer?: HTMLElement, parentNode?: HTMLElement): HTMLElement;\n    private getOrCreatePreNode;\n    private applyPreNodeAttributes;\n    private applyErrorToDOM;\n    private cleanupErrorWrapper;\n}\nexport {};\n//# sourceMappingURL=File.d.ts.map"],"mappings":"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"}

package/dist/components/File.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";
@@ -10,7 +10,7 @@ import { areFilesEqual } from "../utils/areFilesEqual.js";
 import { areLineAnnotationsEqual } from "../utils/areLineAnnotationsEqual.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";
@@ -32,13 +32,14 @@ var File = class {
 	bufferBefore;
 	bufferAfter;
 	unsafeCSSStyle;
-	hoverContent;
+	gutterUtilityContent;
 	errorWrapper;
 	placeHolder;
 	lastRenderedHeaderHTML;
 	appliedPreAttributes;
 	lastRowCount;
 	headerElement;
+	headerPrefix;
 	headerMetadata;
 	fileRenderer;
 	resizeManager;
@@ -124,6 +125,8 @@ var File = class {
 		this.appliedPreAttributes = void 0;
 		this.lastRowCount = void 0;
 		this.headerElement = void 0;
+		this.headerPrefix = void 0;
+		this.headerMetadata = void 0;
 		this.lastRenderedHeaderHTML = void 0;
 		this.errorWrapper = void 0;
 		this.unsafeCSSStyle = void 0;
@@ -163,7 +166,7 @@ var File = class {
 			this.file = file;
 			this.fileRenderer.hydrate(file);
 			this.renderAnnotations();
-			this.renderHoverUtility();
+			this.renderGutterUtility();
 			this.injectUnsafeCSS();
 			this.mouseEventManager.setup(this.pre);
 			this.lineSelectionManager.setup(this.pre);
@@ -174,11 +177,13 @@ var File = class {
 		return file != null ? this.fileRenderer.getOrCreateLineCache(file) : EMPTY_STRINGS;
 	}
 	render({ file, fileContainer, forceRender = false, containerWrapper, lineAnnotations, renderRange }) {
+		const { collapsed = false } = this.options;
+		const nextRenderRange = collapsed ? void 0 : renderRange;
 		const previousRenderRange = this.renderRange;
 		const annotationsChanged = lineAnnotations != null && (lineAnnotations.length > 0 || this.lineAnnotations.length > 0) ? lineAnnotations !== this.lineAnnotations : false;
 		const didFileChange = !areFilesEqual(this.file, file);
-		if (!forceRender && areRenderRangesEqual(renderRange, this.renderRange) && !didFileChange && !annotationsChanged) return false;
-		this.renderRange = renderRange;
+		if (!collapsed && !forceRender && areRenderRangesEqual(nextRenderRange, this.renderRange) && !didFileChange && !annotationsChanged) return false;
+		this.renderRange = nextRenderRange;
 		this.file = file;
 		this.fileRenderer.setOptions(this.options);
 		if (lineAnnotations != null) this.setLineAnnotations(lineAnnotations);
@@ -190,12 +195,34 @@ var File = 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.getOrCreateFileContainerNode(fileContainer, containerWrapper);
+		if (collapsed) {
+			this.removeRenderedCode();
+			this.clearAuxiliaryNodes();
+			try {
+				const fileResult = this.fileRenderer.renderFile(file, EMPTY_RENDER_RANGE);
+				if (fileResult?.headerAST != null) this.applyHeaderToDOM(fileResult.headerAST, fileContainer);
+				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, didFileChange) || !this.applyPartialRender(previousRenderRange, renderRange)) {
-				const fileResult = this.fileRenderer.renderFile(file, renderRange);
+			if (!this.canPartiallyRender(forceRender, annotationsChanged, didFileChange) || !this.applyPartialRender(previousRenderRange, nextRenderRange)) {
+				const fileResult = this.fileRenderer.renderFile(file, nextRenderRange);
 				if (fileResult == null) {
 					if (this.workerManager?.isInitialized() === false) this.workerManager.initialize().then(() => this.rerender());
 					return false;
@@ -203,13 +230,13 @@ var File = class {
 				if (fileResult.headerAST != null) this.applyHeaderToDOM(fileResult.headerAST, fileContainer);
 				this.applyFullRender(fileResult, pre);
 			}
-			this.applyBuffers(pre, renderRange);
+			this.applyBuffers(pre, nextRenderRange);
 			this.injectUnsafeCSS();
 			this.mouseEventManager.setup(pre);
 			this.lineSelectionManager.setup(pre);
 			this.resizeManager.setup(pre, overflow === "wrap");
 			this.renderAnnotations();
-			this.renderHoverUtility();
+			this.renderGutterUtility();
 		} catch (error) {
 			if (disableErrorHandling) throw error;
 			console.error(error);
@@ -217,6 +244,27 @@ var File = class {
 		}
 		return true;
 	}
+	removeRenderedCode() {
+		this.resizeManager.cleanUp();
+		this.mouseEventManager.cleanUp();
+		this.lineSelectionManager.cleanUp();
+		this.bufferBefore?.remove();
+		this.bufferBefore = void 0;
+		this.bufferAfter?.remove();
+		this.bufferAfter = void 0;
+		this.code?.remove();
+		this.code = void 0;
+		this.pre?.remove();
+		this.pre = void 0;
+		this.appliedPreAttributes = void 0;
+		this.lastRowCount = void 0;
+	}
+	clearAuxiliaryNodes() {
+		for (const { element } of this.annotationCache.values()) element.parentNode?.removeChild(element);
+		this.annotationCache.clear();
+		this.gutterUtilityContent?.remove();
+		this.gutterUtilityContent = void 0;
+	}
 	canPartiallyRender(forceRender, annotationsChanged, didContentChange) {
 		if (forceRender || annotationsChanged || didContentChange) return false;
 		return true;
@@ -242,7 +290,9 @@ var File = class {
 		this.code?.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();
@@ -251,7 +301,9 @@ var File = class {
 		this.code = 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;
@@ -288,19 +340,24 @@ var File = 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;
 	}
 	injectUnsafeCSS() {
 		if (this.fileContainer?.shadowRoot == null) return;
@@ -474,9 +531,18 @@ var File = class {
 			this.lastRenderedHeaderHTML = headerHTML;
 		}
 		if (this.isContainerManaged) return;
-		const { renderCustomMetadata } = this.options;
+		const { renderHeaderPrefix, renderCustomMetadata } = 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?.(file) ?? void 0;
 		const content = renderCustomMetadata?.(file) ?? 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;