@pierre/diffs 1.2.0-beta.2 → 1.2.0-beta.4

package/dist/components/CodeView.d.ts

@@ -1,5 +1,5 @@
-import { CodeViewDiffItem, CodeViewFileItem, CodeViewItem, CodeViewItemVersion, CodeViewMetrics, CodeViewScrollTarget, HunkSeparators, SmoothScrollSettings, VirtualFileMetrics, VirtualWindowSpecs } from "../types.js";
-import { SelectedLineRange, SelectionWriteOptions } from "../managers/InteractionManager.js";
+import { CodeViewDiffItem, CodeViewFileItem, CodeViewItem, CodeViewItemVersion, CodeViewLayout, CodeViewScrollTarget, HunkSeparators, SelectedLineRange, SmoothScrollSettings, VirtualFileMetrics, VirtualWindowSpecs } from "../types.js";
+import { SelectionWriteOptions } from "../managers/InteractionManager.js";
 import { WorkerPoolManager } from "../worker/WorkerPoolManager.js";
 import "../worker/index.js";
 import { FileOptions } from "./File.js";
@@ -89,7 +89,11 @@ interface CodeViewOptions<LAnnotation> extends CodeViewPassThroughOptions<LAnnot
   stickyHeaders?: boolean;
   controlledSelection?: boolean;
   onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;
-  viewerMetrics?: CodeViewMetrics;
+  layout?: CodeViewLayout;
+  /** Internal dev-only check to ensure your `itemMetrics` are correct.  Its
+   * automatically disabled in a production build because it will hurt
+   * performance fairly significantly */
+  __devOnlyValidateItemHeights?: boolean;
 }
 declare class CodeView<LAnnotation = undefined> {
   static __STOP: boolean;
@@ -127,14 +131,16 @@ declare class CodeView<LAnnotation = undefined> {
   private workerManager;
   private isContainerManaged;
   constructor(options?: CodeViewOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);
-  private getViewerMetrics;
+  private getLayout;
   private getItemMetrics;
   private getSmoothScrollSettings;
   private shouldDisablePointerEvents;
+  private shouldValidateItemHeights;
+  private validateRenderedItemHeight;
   private clearPointerEventsTimer;
   private suspendPointerEvents;
   private restorePointerEvents;
-  private syncViewerMetrics;
+  private syncLayout;
   setup(root: HTMLElement): void;
   reset(): void;
   cleanUp(): void;
@@ -144,6 +150,8 @@ declare class CodeView<LAnnotation = undefined> {
   setSelectedLines(selection: CodeViewLineSelection | null, options?: SelectionWriteOptions): void;
   getSelectedLines(): CodeViewLineSelection | null;
   clearSelectedLines(options?: SelectionWriteOptions): void;
+  getItem(itemId: string): CodeViewItem<LAnnotation> | undefined;
+  updateItem(input: CodeViewItem<LAnnotation>): boolean;
   addItem(input: CodeViewItem<LAnnotation>): void;
   addItems(inputs: readonly CodeViewItem<LAnnotation>[]): void;
   setItems(items: readonly CodeViewItem<LAnnotation>[]): void;
@@ -154,6 +162,7 @@ declare class CodeView<LAnnotation = undefined> {
    * once at the end.
    */
   private appendItemsInternal;
+  private canSkipRenderForAppend;
   setOptions(options: CodeViewOptions<LAnnotation> | undefined): void;
   private capturePendingLayoutAnchor;
   render(immediate?: boolean): void;
@@ -164,7 +173,7 @@ declare class CodeView<LAnnotation = undefined> {
   setSlotCoordinator(coordinator?: CodeViewCoordinator<LAnnotation>): boolean;
   getSlotSnapshot(coordinator: CodeViewCoordinator<LAnnotation>): CodeViewRenderedItem<LAnnotation>[] | undefined;
   subscribeToScroll(listener: CodeViewScrollListener<LAnnotation>): () => void;
-  getTopForInstance(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>): number;
+  getLocalTopForInstance(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>): number;
   getTopForItem(id: string): number | undefined;
   private createItem;
   private getItemById;
@@ -244,6 +253,7 @@ declare class CodeView<LAnnotation = undefined> {
    */
   private resolveAlignedScrollPosition;
   private getLineScrollPosition;
+  private getRangeScrollPosition;
   /**
    * Determine target scroll position for current frame.
    *

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

@@ -1 +1 @@
-{"version":3,"file":"CodeView.d.ts","names":["SelectedLineRange","SelectionWriteOptions","CodeViewDiffItem","CodeViewFileItem","CodeViewItem","CodeViewItemVersion","CodeViewMetrics","CodeViewScrollTarget","HunkSeparators","SmoothScrollSettings","VirtualFileMetrics","VirtualWindowSpecs","WorkerPoolManager","FileOptions","FileDiffOptions","VirtualizedFile","VirtualizedFileDiff","VirtualizerConfig","AdvancedVirtualizedBaseItem","HTMLElement","CodeViewDiffItemContext","LAnnotation","CodeViewFileItemContext","CodeViewRenderedDiffItem","CodeViewRenderedFileItem","CodeViewRenderedItem","CodeViewLineSelection","CodeViewCoordinator","CodeViewScrollListener","CodeView","OverloadCallbackArgs","TCallback","TArgs","CallbackReturn","TReturn","OverloadFileCallbackArgs","TKey","NonNullable","OverloadDiffCallbackArgs","CodeViewOptionCallback","CODE_VIEW_DIFF_OPTION_KEYS","CodeViewDiffOptionKeys","CodeViewPassThroughOptions","Pick","CODE_VIEW_SHARED_CALLBACK_KEYS","CODE_VIEW_SELECTION_CALLBACK_KEYS","CodeViewSharedCallbackKeys","CodeViewSelectionCallbackKeys","CodeViewSharedCallbackOptions","CodeViewSelectionCallbackOptions","CodeViewOptions","Exclude"],"sources":["../../src/components/CodeView.d.ts"],"sourcesContent":["import type { SelectedLineRange, SelectionWriteOptions } from '../managers/InteractionManager';\nimport type { CodeViewDiffItem, CodeViewFileItem, CodeViewItem, CodeViewItemVersion, CodeViewMetrics, CodeViewScrollTarget, HunkSeparators, SmoothScrollSettings, VirtualFileMetrics, VirtualWindowSpecs } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nimport type { FileOptions } from './File';\nimport type { FileDiffOptions } from './FileDiff';\nimport { VirtualizedFile } from './VirtualizedFile';\nimport { VirtualizedFileDiff } from './VirtualizedFileDiff';\nimport type { VirtualizerConfig } from './Virtualizer';\ninterface AdvancedVirtualizedBaseItem {\n    /** Current index of this record in the ordered items array. */\n    index: number;\n    /** Absolute top offset of this item inside the scroll content. */\n    top: number;\n    /** Total measured height reserved for this item. */\n    height: number;\n    /** Root <diffs-container> node currently mounted for this item, only exists\n     * when rendered. */\n    element: HTMLElement | undefined;\n    /** Last controlled version observed for this record. */\n    version: CodeViewItemVersion | undefined;\n}\ninterface CodeViewDiffItemContext<LAnnotation> extends AdvancedVirtualizedBaseItem {\n    type: 'diff';\n    /** Latest item snapshot for this record. Controlled updates can replace it. */\n    item: CodeViewDiffItem<LAnnotation>;\n    /** Virtualized diff instance responsible for rendering this item. */\n    instance: VirtualizedFileDiff<LAnnotation>;\n}\ninterface CodeViewFileItemContext<LAnnotation> extends AdvancedVirtualizedBaseItem {\n    type: 'file';\n    /** Latest item snapshot for this record. Controlled updates can replace it. */\n    item: CodeViewFileItem<LAnnotation>;\n    /** Virtualized file instance responsible for rendering this item. */\n    instance: VirtualizedFile<LAnnotation>;\n}\nexport interface CodeViewRenderedDiffItem<LAnnotation> {\n    id: string;\n    type: 'diff';\n    item: CodeViewDiffItem<LAnnotation>;\n    version: CodeViewItemVersion | undefined;\n    element: HTMLElement;\n    instance: VirtualizedFileDiff<LAnnotation>;\n}\nexport interface CodeViewRenderedFileItem<LAnnotation> {\n    id: string;\n    type: 'file';\n    item: CodeViewFileItem<LAnnotation>;\n    version: CodeViewItemVersion | undefined;\n    element: HTMLElement;\n    instance: VirtualizedFile<LAnnotation>;\n}\nexport type CodeViewRenderedItem<LAnnotation> = CodeViewRenderedDiffItem<LAnnotation> | CodeViewRenderedFileItem<LAnnotation>;\nexport interface CodeViewLineSelection {\n    id: string;\n    range: SelectedLineRange;\n}\nexport interface CodeViewCoordinator<LAnnotation> {\n    hasHeaderRenderers: boolean;\n    hasAnnotationRenderer: boolean;\n    hasGutterRenderer: boolean;\n    onSnapshotChange(snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined): void;\n}\nexport type CodeViewScrollListener<LAnnotation> = (scrollTop: number, viewer: CodeView<LAnnotation>) => void;\ntype OverloadCallbackArgs<TCallback> = TCallback extends (...args: infer TArgs) => unknown ? TArgs : never;\ntype CallbackReturn<TCallback> = TCallback extends (...args: never[]) => infer TReturn ? TReturn : never;\ntype OverloadFileCallbackArgs<LAnnotation, TKey extends keyof FileOptions<LAnnotation>> = OverloadCallbackArgs<NonNullable<FileOptions<LAnnotation>[TKey]>>;\ntype OverloadDiffCallbackArgs<LAnnotation, TKey extends keyof FileDiffOptions<LAnnotation>> = OverloadCallbackArgs<NonNullable<FileDiffOptions<LAnnotation>[TKey]>>;\ntype CodeViewOptionCallback<LAnnotation, TKey extends keyof FileOptions<LAnnotation> & keyof FileDiffOptions<LAnnotation>> = {\n    (...args: [\n        ...OverloadFileCallbackArgs<LAnnotation, TKey>,\n        context: CodeViewFileItemContext<LAnnotation>\n    ]): CallbackReturn<NonNullable<FileOptions<LAnnotation>[TKey]>>;\n    (...args: [\n        ...OverloadDiffCallbackArgs<LAnnotation, TKey>,\n        context: CodeViewDiffItemContext<LAnnotation>\n    ]): CallbackReturn<NonNullable<FileDiffOptions<LAnnotation>[TKey]>>;\n};\ndeclare const CODE_VIEW_DIFF_OPTION_KEYS: readonly [\"theme\", \"disableLineNumbers\", \"overflow\", \"themeType\", \"disableFileHeader\", \"disableVirtualizationBuffers\", \"preferredHighlighter\", \"useCSSClasses\", \"useTokenTransformer\", \"tokenizeMaxLineLength\", \"tokenizeMaxLength\", \"unsafeCSS\", \"diffStyle\", \"diffIndicators\", \"disableBackground\", \"expandUnchanged\", \"collapsedContextThreshold\", \"lineDiffType\", \"maxLineDiffLength\", \"expansionLineCount\", \"lineHoverHighlight\", \"enableTokenInteractionsOnWhitespace\", \"enableGutterUtility\", \"__debugPointerEvents\", \"enableLineSelection\", \"controlledSelection\", \"disableErrorHandling\"];\ntype CodeViewDiffOptionKeys = (typeof CODE_VIEW_DIFF_OPTION_KEYS)[number];\ntype CodeViewPassThroughOptions<LAnnotation> = Pick<FileDiffOptions<LAnnotation>, CodeViewDiffOptionKeys>;\ndeclare const CODE_VIEW_SHARED_CALLBACK_KEYS: readonly [\"renderCustomHeader\", \"renderHeaderPrefix\", \"renderHeaderMetadata\", \"renderAnnotation\", \"renderGutterUtility\", \"onPostRender\", \"onGutterUtilityClick\", \"onLineClick\", \"onLineNumberClick\", \"onLineEnter\", \"onLineLeave\", \"onTokenClick\", \"onTokenEnter\", \"onTokenLeave\"];\ndeclare const CODE_VIEW_SELECTION_CALLBACK_KEYS: readonly [\"onLineSelected\", \"onLineSelectionStart\", \"onLineSelectionChange\", \"onLineSelectionEnd\"];\ntype CodeViewSharedCallbackKeys = (typeof CODE_VIEW_SHARED_CALLBACK_KEYS)[number];\ntype CodeViewSelectionCallbackKeys = (typeof CODE_VIEW_SELECTION_CALLBACK_KEYS)[number];\ntype CodeViewSharedCallbackOptions<LAnnotation> = {\n    [TKey in CodeViewSharedCallbackKeys]?: CodeViewOptionCallback<LAnnotation, TKey>;\n};\ntype CodeViewSelectionCallbackOptions<LAnnotation> = {\n    [TKey in CodeViewSelectionCallbackKeys]?: CodeViewOptionCallback<LAnnotation, TKey>;\n};\nexport interface CodeViewOptions<LAnnotation> extends CodeViewPassThroughOptions<LAnnotation>, CodeViewSharedCallbackOptions<LAnnotation>, CodeViewSelectionCallbackOptions<LAnnotation> {\n    hunkSeparators?: Exclude<HunkSeparators, 'custom'>;\n    itemMetrics?: VirtualFileMetrics;\n    pointerEventsOnScroll?: boolean;\n    smoothScrollSettings?: SmoothScrollSettings;\n    stickyHeaders?: boolean;\n    controlledSelection?: boolean;\n    onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n    viewerMetrics?: CodeViewMetrics;\n}\nexport declare class CodeView<LAnnotation = undefined> {\n    static __STOP: boolean;\n    static __lastScrollPosition: number;\n    type: \"advanced\";\n    readonly config: VirtualizerConfig;\n    private items;\n    private idToItem;\n    private selectedLines;\n    private instanceToItem;\n    private layoutDirtyIndex;\n    private slotCoordinator;\n    private slotSnapshot;\n    private scrollListeners;\n    private scrollHeight;\n    private containerHeight;\n    private scrollTop;\n    private scrollPageOffset;\n    private scrollDirty;\n    private pointerEventsRestoreTimer;\n    private pointerEventsDisabled;\n    private height;\n    private heightDirty;\n    private windowSpecs;\n    private renderState;\n    private pendingScrollTarget;\n    private pendingLayoutAnchor;\n    private scrollAnimation;\n    private root;\n    private resizeObserver;\n    private container;\n    private stickyContainer;\n    private stickyOffset;\n    private options;\n    private workerManager;\n    private isContainerManaged;\n    constructor(options?: CodeViewOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private getViewerMetrics;\n    private getItemMetrics;\n    private getSmoothScrollSettings;\n    private shouldDisablePointerEvents;\n    private clearPointerEventsTimer;\n    private suspendPointerEvents;\n    private restorePointerEvents;\n    private syncViewerMetrics;\n    setup(root: HTMLElement): void;\n    reset(): void;\n    cleanUp(): void;\n    private cleanAllRenderedItems;\n    private resolveEffectiveScrollBehavior;\n    scrollTo(target: CodeViewScrollTarget): void;\n    setSelectedLines(selection: CodeViewLineSelection | null, options?: SelectionWriteOptions): void;\n    getSelectedLines(): CodeViewLineSelection | null;\n    clearSelectedLines(options?: SelectionWriteOptions): void;\n    addItem(input: CodeViewItem<LAnnotation>): void;\n    addItems(inputs: readonly CodeViewItem<LAnnotation>[]): void;\n    setItems(items: readonly CodeViewItem<LAnnotation>[]): void;\n    /**\n     * Append new records to the viewer while preserving existing layout state.\n     * This is the shared path for imperative adds and the append-only reconcile\n     * fast path, so it measures new items immediately and only triggers render\n     * once at the end.\n     */\n    private appendItemsInternal;\n    setOptions(options: CodeViewOptions<LAnnotation> | undefined): void;\n    private capturePendingLayoutAnchor;\n    render(immediate?: boolean): void;\n    instanceChanged(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>, layoutDirty: boolean): void;\n    getWindowSpecs(): VirtualWindowSpecs;\n    getContainerElement(): HTMLElement | undefined;\n    getRenderedItems(): CodeViewRenderedItem<LAnnotation>[];\n    setSlotCoordinator(coordinator?: CodeViewCoordinator<LAnnotation>): boolean;\n    getSlotSnapshot(coordinator: CodeViewCoordinator<LAnnotation>): CodeViewRenderedItem<LAnnotation>[] | undefined;\n    subscribeToScroll(listener: CodeViewScrollListener<LAnnotation>): () => void;\n    getTopForInstance(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>): number;\n    getTopForItem(id: string): number | undefined;\n    private createItem;\n    private getItemById;\n    private getItemByMode;\n    private applySelectedLines;\n    private syncSelection;\n    private wrapCallbackWithContext;\n    private getWrappedOptionCallback;\n    private getWrappedSelectionOptionCallback;\n    private createOptions;\n    /**\n     * Track the earliest index whose measured layout may now be stale. Later\n     * render passes relayout from this point forward so we do not have to rebuild\n     * positions for the whole list after every change.\n     */\n    private markLayoutDirtyFromIndex;\n    /**\n     * Mark the earliest affected item as layout-dirty after an imperative change.\n     * Each record carries its current array index so this stays O(1) even when\n     * the viewer holds a very large number of items.\n     */\n    private markItemLayoutDirty;\n    /**\n     * Detect the common controlled-update case where the new list simply extends\n     * the existing ordered prefix. When that happens we can reuse every current\n     * record in place, sync any versioned payload changes, and append only the new\n     * tail instead of rebuilding the whole list.\n     */\n    private tryAppendItems;\n    /**\n     * Reconcile a new controlled item list against the existing records by id.\n     * This reuses records and instances when type matches, cleans up removed\n     * records, rebuilds the lookup maps, and marks layout dirty whenever order,\n     * membership, or versioned item data changes.\n     */\n    private reconcileItems;\n    /**\n     * Update a reused record from the latest controlled item only when its item\n     * version changes. Matching versions mean CodeView keeps the current record\n     * snapshot, which lets imperative updates remain in place until the caller\n     * intentionally publishes a newer version.\n     */\n    private syncItemRecord;\n    private getMaxScrollTopForHeight;\n    private getMaxScrollTop;\n    private shouldRebaseScroll;\n    private getPagedScrollHeight;\n    private getMaxPagedScrollTop;\n    private clampPagedScrollTop;\n    /**\n     * Clamps a logical scroll position to the min/max allowable scroll range\n     * based on the full computed content height.\n     */\n    private clampScrollTop;\n    private getMaxScrollPageOffset;\n    private clampScrollPageOffset;\n    private resolveScrollPageWindow;\n    /**\n     * Resolve how a logical scrollTop maps onto the reusable paged scroll window\n     * without mutating the current page offset.\n     */\n    private resolvePagedScrollPosition;\n    private needsScrollPageUpdate;\n    private getPagedLayoutTop;\n    private getStickyHeaderOffset;\n    private getScrollTargetRect;\n    private normalizeScrollTarget;\n    /**\n     * Resolve a target's scroll position\n  \n     * Returns `undefined` when we can't resolve a target for whatever reason\n     */\n    private resolveScrollTargetTop;\n    /**\n     * Given an existing scroll target (scroll top and height), figure out the\n     * correct scroll position to target based on the desired alignment, offset\n     * and stickyOffset if necessary\n     */\n    private resolveAlignedScrollPosition;\n    private getLineScrollPosition;\n    /**\n     * Determine target scroll position for current frame.\n     *\n     * If there's no pendingScrollTarget then we just return the current scroll\n     * position\n     *\n     * If there's a pendingScrollTarget then we depend on whether there's a\n     * smooth scroll animation or not. If not just return the destination, or\n     * compute next position given the smooth scroll spring physics\n     */\n    private computeTargetScrollTopForFrame;\n    /**\n     * Closed-form critical-damped ODE step.\n     *\n     * Stable at any dt (Euler would blow up once ω·dt ≳ 1), so this survives\n     * big RAF gaps (tab-wake, offscreen frames) and resize-driven ticks that\n     * fire outside the normal RAF cadence.\n     */\n    private computeSpringStep;\n    /**\n     * For any given pendingScrollTarget, updates any in flight smooth scroll\n     * animations and returns the target scrollTop to move towards\n     *\n     * Resolves the animation based on frame time and adopts any necessary scroll\n     * anchoring corrections if necessary\n     */\n    private advanceScrollAnimation;\n    private computeRenderRangeAndEmit;\n    private flushManagers;\n    private syncContainerHeight;\n    private getStickyBounds;\n    private applyStickyPositioning;\n    private syncPagedScrollScaffolding;\n    private reconcileRenderedItems;\n    private updateStickyPositioning;\n    private handleScroll;\n    private clearPendingScroll;\n    private handleResize;\n    /**\n     * Figure out scrollTop accounting for sticky header if enabled and\n     * necessary\n     */\n    private getScrollAnchorViewportTop;\n    /**\n     * Attempt to find a scroll anchor based on build in metrics of the existing\n     * rendered files/diff.\n     *\n     * A scroll anchor represents the first fully visible element (in other\n     * words, the first file or first line who's top is fully in the viewport).\n     */\n    private getScrollAnchor;\n    /**\n     * Given a scroll anchor, attempt to resolve a newly updated (and clamped)\n     * scroll position to keep the anchored element in place.\n     *\n     * If we can't resolve a position for whatever reason, we'll return\n     * undefined.\n     */\n    private resolveAnchoredScrollTop;\n    /**\n     * Apply a device-pixel-rounded scroll position if it differs from the last\n     * logical scrollTop synchronized into the paged scroll scaffold.\n     */\n    private applyScrollFix;\n    /**\n     * Decide whether a pending programmatic scroll has reached its\n     * destination and should be cleared.\n     */\n    private isPendingTargetSettled;\n    getScrollTop(): number;\n    getHeight(): number;\n    getScrollHeight(): number;\n    private flushSlotCoordinator;\n    private notifyScroll;\n    /**\n     * Find the first item whose bottom edge crosses into the viewport window.\n     * This lets scroll-time rendering jump directly near the visible range instead\n     * of linearly scanning from the start of very large item lists.\n     */\n    private findFirstVisibleIndex;\n    /**\n     * Find the last item whose top edge is still within the viewport window.\n     * Paired with findFirstVisibleIndex, this bounds the render loop to only the\n     * slice of items that can actually intersect the current scroll range.\n     */\n    private findLastVisibleIndex;\n    /**\n     * Recompute measured tops and heights starting from the earliest dirty item.\n     * Earlier items keep their existing layout, while everything from startIndex\n     * onward is remeasured so downstream positions and total scroll height stay\n     * consistent after inserts, removals, or versioned item updates.\n     */\n    private recomputeLayout;\n    private resetRenderState;\n    private getFitPerfectlyOverscroll;\n}\nexport {};\n//# sourceMappingURL=CodeView.d.ts.map"],"mappings":"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"}
+{"version":3,"file":"CodeView.d.ts","names":["SelectionWriteOptions","CodeViewDiffItem","CodeViewFileItem","CodeViewItem","CodeViewItemVersion","CodeViewLayout","CodeViewScrollTarget","HunkSeparators","SelectedLineRange","SmoothScrollSettings","VirtualFileMetrics","VirtualWindowSpecs","WorkerPoolManager","FileOptions","FileDiffOptions","VirtualizedFile","VirtualizedFileDiff","VirtualizerConfig","AdvancedVirtualizedBaseItem","HTMLElement","CodeViewDiffItemContext","LAnnotation","CodeViewFileItemContext","CodeViewRenderedDiffItem","CodeViewRenderedFileItem","CodeViewRenderedItem","CodeViewLineSelection","CodeViewCoordinator","CodeViewScrollListener","CodeView","OverloadCallbackArgs","TCallback","TArgs","CallbackReturn","TReturn","OverloadFileCallbackArgs","TKey","NonNullable","OverloadDiffCallbackArgs","CodeViewOptionCallback","CODE_VIEW_DIFF_OPTION_KEYS","CodeViewDiffOptionKeys","CodeViewPassThroughOptions","Pick","CODE_VIEW_SHARED_CALLBACK_KEYS","CODE_VIEW_SELECTION_CALLBACK_KEYS","CodeViewSharedCallbackKeys","CodeViewSelectionCallbackKeys","CodeViewSharedCallbackOptions","CodeViewSelectionCallbackOptions","CodeViewOptions","Exclude"],"sources":["../../src/components/CodeView.d.ts"],"sourcesContent":["import type { SelectionWriteOptions } from '../managers/InteractionManager';\nimport type { CodeViewDiffItem, CodeViewFileItem, CodeViewItem, CodeViewItemVersion, CodeViewLayout, CodeViewScrollTarget, HunkSeparators, SelectedLineRange, SmoothScrollSettings, VirtualFileMetrics, VirtualWindowSpecs } from '../types';\nimport type { WorkerPoolManager } from '../worker';\nimport type { FileOptions } from './File';\nimport type { FileDiffOptions } from './FileDiff';\nimport { VirtualizedFile } from './VirtualizedFile';\nimport { VirtualizedFileDiff } from './VirtualizedFileDiff';\nimport type { VirtualizerConfig } from './Virtualizer';\ninterface AdvancedVirtualizedBaseItem {\n    /** Current index of this record in the ordered items array. */\n    index: number;\n    /** Absolute top offset of this item inside the scroll content. */\n    top: number;\n    /** Total measured height reserved for this item. */\n    height: number;\n    /** Root <diffs-container> node currently mounted for this item, only exists\n     * when rendered. */\n    element: HTMLElement | undefined;\n    /** Last controlled version observed for this record. */\n    version: CodeViewItemVersion | undefined;\n}\ninterface CodeViewDiffItemContext<LAnnotation> extends AdvancedVirtualizedBaseItem {\n    type: 'diff';\n    /** Latest item snapshot for this record. Controlled updates can replace it. */\n    item: CodeViewDiffItem<LAnnotation>;\n    /** Virtualized diff instance responsible for rendering this item. */\n    instance: VirtualizedFileDiff<LAnnotation>;\n}\ninterface CodeViewFileItemContext<LAnnotation> extends AdvancedVirtualizedBaseItem {\n    type: 'file';\n    /** Latest item snapshot for this record. Controlled updates can replace it. */\n    item: CodeViewFileItem<LAnnotation>;\n    /** Virtualized file instance responsible for rendering this item. */\n    instance: VirtualizedFile<LAnnotation>;\n}\nexport interface CodeViewRenderedDiffItem<LAnnotation> {\n    id: string;\n    type: 'diff';\n    item: CodeViewDiffItem<LAnnotation>;\n    version: CodeViewItemVersion | undefined;\n    element: HTMLElement;\n    instance: VirtualizedFileDiff<LAnnotation>;\n}\nexport interface CodeViewRenderedFileItem<LAnnotation> {\n    id: string;\n    type: 'file';\n    item: CodeViewFileItem<LAnnotation>;\n    version: CodeViewItemVersion | undefined;\n    element: HTMLElement;\n    instance: VirtualizedFile<LAnnotation>;\n}\nexport type CodeViewRenderedItem<LAnnotation> = CodeViewRenderedDiffItem<LAnnotation> | CodeViewRenderedFileItem<LAnnotation>;\nexport interface CodeViewLineSelection {\n    id: string;\n    range: SelectedLineRange;\n}\nexport interface CodeViewCoordinator<LAnnotation> {\n    hasHeaderRenderers: boolean;\n    hasAnnotationRenderer: boolean;\n    hasGutterRenderer: boolean;\n    onSnapshotChange(snapshot: CodeViewRenderedItem<LAnnotation>[] | undefined): void;\n}\nexport type CodeViewScrollListener<LAnnotation> = (scrollTop: number, viewer: CodeView<LAnnotation>) => void;\ntype OverloadCallbackArgs<TCallback> = TCallback extends (...args: infer TArgs) => unknown ? TArgs : never;\ntype CallbackReturn<TCallback> = TCallback extends (...args: never[]) => infer TReturn ? TReturn : never;\ntype OverloadFileCallbackArgs<LAnnotation, TKey extends keyof FileOptions<LAnnotation>> = OverloadCallbackArgs<NonNullable<FileOptions<LAnnotation>[TKey]>>;\ntype OverloadDiffCallbackArgs<LAnnotation, TKey extends keyof FileDiffOptions<LAnnotation>> = OverloadCallbackArgs<NonNullable<FileDiffOptions<LAnnotation>[TKey]>>;\ntype CodeViewOptionCallback<LAnnotation, TKey extends keyof FileOptions<LAnnotation> & keyof FileDiffOptions<LAnnotation>> = {\n    (...args: [\n        ...OverloadFileCallbackArgs<LAnnotation, TKey>,\n        context: CodeViewFileItemContext<LAnnotation>\n    ]): CallbackReturn<NonNullable<FileOptions<LAnnotation>[TKey]>>;\n    (...args: [\n        ...OverloadDiffCallbackArgs<LAnnotation, TKey>,\n        context: CodeViewDiffItemContext<LAnnotation>\n    ]): CallbackReturn<NonNullable<FileDiffOptions<LAnnotation>[TKey]>>;\n};\ndeclare const CODE_VIEW_DIFF_OPTION_KEYS: readonly [\"theme\", \"disableLineNumbers\", \"overflow\", \"themeType\", \"disableFileHeader\", \"disableVirtualizationBuffers\", \"preferredHighlighter\", \"useCSSClasses\", \"useTokenTransformer\", \"tokenizeMaxLineLength\", \"tokenizeMaxLength\", \"unsafeCSS\", \"diffStyle\", \"diffIndicators\", \"disableBackground\", \"expandUnchanged\", \"collapsedContextThreshold\", \"lineDiffType\", \"maxLineDiffLength\", \"expansionLineCount\", \"lineHoverHighlight\", \"enableTokenInteractionsOnWhitespace\", \"enableGutterUtility\", \"__debugPointerEvents\", \"enableLineSelection\", \"controlledSelection\", \"disableErrorHandling\"];\ntype CodeViewDiffOptionKeys = (typeof CODE_VIEW_DIFF_OPTION_KEYS)[number];\ntype CodeViewPassThroughOptions<LAnnotation> = Pick<FileDiffOptions<LAnnotation>, CodeViewDiffOptionKeys>;\ndeclare const CODE_VIEW_SHARED_CALLBACK_KEYS: readonly [\"renderCustomHeader\", \"renderHeaderPrefix\", \"renderHeaderMetadata\", \"renderAnnotation\", \"renderGutterUtility\", \"onPostRender\", \"onGutterUtilityClick\", \"onLineClick\", \"onLineNumberClick\", \"onLineEnter\", \"onLineLeave\", \"onTokenClick\", \"onTokenEnter\", \"onTokenLeave\"];\ndeclare const CODE_VIEW_SELECTION_CALLBACK_KEYS: readonly [\"onLineSelected\", \"onLineSelectionStart\", \"onLineSelectionChange\", \"onLineSelectionEnd\"];\ntype CodeViewSharedCallbackKeys = (typeof CODE_VIEW_SHARED_CALLBACK_KEYS)[number];\ntype CodeViewSelectionCallbackKeys = (typeof CODE_VIEW_SELECTION_CALLBACK_KEYS)[number];\ntype CodeViewSharedCallbackOptions<LAnnotation> = {\n    [TKey in CodeViewSharedCallbackKeys]?: CodeViewOptionCallback<LAnnotation, TKey>;\n};\ntype CodeViewSelectionCallbackOptions<LAnnotation> = {\n    [TKey in CodeViewSelectionCallbackKeys]?: CodeViewOptionCallback<LAnnotation, TKey>;\n};\nexport interface CodeViewOptions<LAnnotation> extends CodeViewPassThroughOptions<LAnnotation>, CodeViewSharedCallbackOptions<LAnnotation>, CodeViewSelectionCallbackOptions<LAnnotation> {\n    hunkSeparators?: Exclude<HunkSeparators, 'custom'>;\n    itemMetrics?: VirtualFileMetrics;\n    pointerEventsOnScroll?: boolean;\n    smoothScrollSettings?: SmoothScrollSettings;\n    stickyHeaders?: boolean;\n    controlledSelection?: boolean;\n    onSelectedLinesChange?(selection: CodeViewLineSelection | null): void;\n    layout?: CodeViewLayout;\n    /** Internal dev-only check to ensure your `itemMetrics` are correct.  Its\n     * automatically disabled in a production build because it will hurt\n     * performance fairly significantly */\n    __devOnlyValidateItemHeights?: boolean;\n}\nexport declare class CodeView<LAnnotation = undefined> {\n    static __STOP: boolean;\n    static __lastScrollPosition: number;\n    type: \"advanced\";\n    readonly config: VirtualizerConfig;\n    private items;\n    private idToItem;\n    private selectedLines;\n    private instanceToItem;\n    private layoutDirtyIndex;\n    private slotCoordinator;\n    private slotSnapshot;\n    private scrollListeners;\n    private scrollHeight;\n    private containerHeight;\n    private scrollTop;\n    private scrollPageOffset;\n    private scrollDirty;\n    private pointerEventsRestoreTimer;\n    private pointerEventsDisabled;\n    private height;\n    private heightDirty;\n    private windowSpecs;\n    private renderState;\n    private pendingScrollTarget;\n    private pendingLayoutAnchor;\n    private scrollAnimation;\n    private root;\n    private resizeObserver;\n    private container;\n    private stickyContainer;\n    private stickyOffset;\n    private options;\n    private workerManager;\n    private isContainerManaged;\n    constructor(options?: CodeViewOptions<LAnnotation>, workerManager?: WorkerPoolManager | undefined, isContainerManaged?: boolean);\n    private getLayout;\n    private getItemMetrics;\n    private getSmoothScrollSettings;\n    private shouldDisablePointerEvents;\n    private shouldValidateItemHeights;\n    private validateRenderedItemHeight;\n    private clearPointerEventsTimer;\n    private suspendPointerEvents;\n    private restorePointerEvents;\n    private syncLayout;\n    setup(root: HTMLElement): void;\n    reset(): void;\n    cleanUp(): void;\n    private cleanAllRenderedItems;\n    private resolveEffectiveScrollBehavior;\n    scrollTo(target: CodeViewScrollTarget): void;\n    setSelectedLines(selection: CodeViewLineSelection | null, options?: SelectionWriteOptions): void;\n    getSelectedLines(): CodeViewLineSelection | null;\n    clearSelectedLines(options?: SelectionWriteOptions): void;\n    getItem(itemId: string): CodeViewItem<LAnnotation> | undefined;\n    updateItem(input: CodeViewItem<LAnnotation>): boolean;\n    addItem(input: CodeViewItem<LAnnotation>): void;\n    addItems(inputs: readonly CodeViewItem<LAnnotation>[]): void;\n    setItems(items: readonly CodeViewItem<LAnnotation>[]): void;\n    /**\n     * Append new records to the viewer while preserving existing layout state.\n     * This is the shared path for imperative adds and the append-only reconcile\n     * fast path, so it measures new items immediately and only triggers render\n     * once at the end.\n     */\n    private appendItemsInternal;\n    private canSkipRenderForAppend;\n    setOptions(options: CodeViewOptions<LAnnotation> | undefined): void;\n    private capturePendingLayoutAnchor;\n    render(immediate?: boolean): void;\n    instanceChanged(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>, layoutDirty: boolean): void;\n    getWindowSpecs(): VirtualWindowSpecs;\n    getContainerElement(): HTMLElement | undefined;\n    getRenderedItems(): CodeViewRenderedItem<LAnnotation>[];\n    setSlotCoordinator(coordinator?: CodeViewCoordinator<LAnnotation>): boolean;\n    getSlotSnapshot(coordinator: CodeViewCoordinator<LAnnotation>): CodeViewRenderedItem<LAnnotation>[] | undefined;\n    subscribeToScroll(listener: CodeViewScrollListener<LAnnotation>): () => void;\n    getLocalTopForInstance(instance: VirtualizedFile<LAnnotation> | VirtualizedFileDiff<LAnnotation>): number;\n    getTopForItem(id: string): number | undefined;\n    private createItem;\n    private getItemById;\n    private getItemByMode;\n    private applySelectedLines;\n    private syncSelection;\n    private wrapCallbackWithContext;\n    private getWrappedOptionCallback;\n    private getWrappedSelectionOptionCallback;\n    private createOptions;\n    /**\n     * Track the earliest index whose measured layout may now be stale. Later\n     * render passes relayout from this point forward so we do not have to rebuild\n     * positions for the whole list after every change.\n     */\n    private markLayoutDirtyFromIndex;\n    /**\n     * Mark the earliest affected item as layout-dirty after an imperative change.\n     * Each record carries its current array index so this stays O(1) even when\n     * the viewer holds a very large number of items.\n     */\n    private markItemLayoutDirty;\n    /**\n     * Detect the common controlled-update case where the new list simply extends\n     * the existing ordered prefix. When that happens we can reuse every current\n     * record in place, sync any versioned payload changes, and append only the new\n     * tail instead of rebuilding the whole list.\n     */\n    private tryAppendItems;\n    /**\n     * Reconcile a new controlled item list against the existing records by id.\n     * This reuses records and instances when type matches, cleans up removed\n     * records, rebuilds the lookup maps, and marks layout dirty whenever order,\n     * membership, or versioned item data changes.\n     */\n    private reconcileItems;\n    /**\n     * Update a reused record from the latest controlled item only when its item\n     * version changes. Matching versions mean CodeView keeps the current record\n     * snapshot, which lets imperative updates remain in place until the caller\n     * intentionally publishes a newer version.\n     */\n    private syncItemRecord;\n    private getMaxScrollTopForHeight;\n    private getMaxScrollTop;\n    private shouldRebaseScroll;\n    private getPagedScrollHeight;\n    private getMaxPagedScrollTop;\n    private clampPagedScrollTop;\n    /**\n     * Clamps a logical scroll position to the min/max allowable scroll range\n     * based on the full computed content height.\n     */\n    private clampScrollTop;\n    private getMaxScrollPageOffset;\n    private clampScrollPageOffset;\n    private resolveScrollPageWindow;\n    /**\n     * Resolve how a logical scrollTop maps onto the reusable paged scroll window\n     * without mutating the current page offset.\n     */\n    private resolvePagedScrollPosition;\n    private needsScrollPageUpdate;\n    private getPagedLayoutTop;\n    private getStickyHeaderOffset;\n    private getScrollTargetRect;\n    private normalizeScrollTarget;\n    /**\n     * Resolve a target's scroll position\n  \n     * Returns `undefined` when we can't resolve a target for whatever reason\n     */\n    private resolveScrollTargetTop;\n    /**\n     * Given an existing scroll target (scroll top and height), figure out the\n     * correct scroll position to target based on the desired alignment, offset\n     * and stickyOffset if necessary\n     */\n    private resolveAlignedScrollPosition;\n    private getLineScrollPosition;\n    private getRangeScrollPosition;\n    /**\n     * Determine target scroll position for current frame.\n     *\n     * If there's no pendingScrollTarget then we just return the current scroll\n     * position\n     *\n     * If there's a pendingScrollTarget then we depend on whether there's a\n     * smooth scroll animation or not. If not just return the destination, or\n     * compute next position given the smooth scroll spring physics\n     */\n    private computeTargetScrollTopForFrame;\n    /**\n     * Closed-form critical-damped ODE step.\n     *\n     * Stable at any dt (Euler would blow up once ω·dt ≳ 1), so this survives\n     * big RAF gaps (tab-wake, offscreen frames) and resize-driven ticks that\n     * fire outside the normal RAF cadence.\n     */\n    private computeSpringStep;\n    /**\n     * For any given pendingScrollTarget, updates any in flight smooth scroll\n     * animations and returns the target scrollTop to move towards\n     *\n     * Resolves the animation based on frame time and adopts any necessary scroll\n     * anchoring corrections if necessary\n     */\n    private advanceScrollAnimation;\n    private computeRenderRangeAndEmit;\n    private flushManagers;\n    private syncContainerHeight;\n    private getStickyBounds;\n    private applyStickyPositioning;\n    private syncPagedScrollScaffolding;\n    private reconcileRenderedItems;\n    private updateStickyPositioning;\n    private handleScroll;\n    private clearPendingScroll;\n    private handleResize;\n    /**\n     * Figure out scrollTop accounting for sticky header if enabled and\n     * necessary\n     */\n    private getScrollAnchorViewportTop;\n    /**\n     * Attempt to find a scroll anchor based on build in metrics of the existing\n     * rendered files/diff.\n     *\n     * A scroll anchor represents the first fully visible element (in other\n     * words, the first file or first line who's top is fully in the viewport).\n     */\n    private getScrollAnchor;\n    /**\n     * Given a scroll anchor, attempt to resolve a newly updated (and clamped)\n     * scroll position to keep the anchored element in place.\n     *\n     * If we can't resolve a position for whatever reason, we'll return\n     * undefined.\n     */\n    private resolveAnchoredScrollTop;\n    /**\n     * Apply a device-pixel-rounded scroll position if it differs from the last\n     * logical scrollTop synchronized into the paged scroll scaffold.\n     */\n    private applyScrollFix;\n    /**\n     * Decide whether a pending programmatic scroll has reached its\n     * destination and should be cleared.\n     */\n    private isPendingTargetSettled;\n    getScrollTop(): number;\n    getHeight(): number;\n    getScrollHeight(): number;\n    private flushSlotCoordinator;\n    private notifyScroll;\n    /**\n     * Find the first item whose bottom edge crosses into the viewport window.\n     * This lets scroll-time rendering jump directly near the visible range instead\n     * of linearly scanning from the start of very large item lists.\n     */\n    private findFirstVisibleIndex;\n    /**\n     * Find the last item whose top edge is still within the viewport window.\n     * Paired with findFirstVisibleIndex, this bounds the render loop to only the\n     * slice of items that can actually intersect the current scroll range.\n     */\n    private findLastVisibleIndex;\n    /**\n     * Recompute measured tops and heights starting from the earliest dirty item.\n     * Earlier items keep their existing layout, while everything from startIndex\n     * onward is remeasured so downstream positions and total scroll height stay\n     * consistent after inserts, removals, or versioned item updates.\n     */\n    private recomputeLayout;\n    private resetRenderState;\n    private getFitPerfectlyOverscroll;\n}\nexport {};\n//# sourceMappingURL=CodeView.d.ts.map"],"mappings":"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"}

package/dist/components/CodeView.js

@@ -1,4 +1,4 @@
-import { DEFAULT_CODE_VIEW_FILE_METRICS, DEFAULT_CODE_VIEW_METRICS, DEFAULT_SMOOTH_SCROLL_SETTINGS, DEFAULT_THEMES, DIFFS_TAG_NAME } from "../constants.js";
+import { DEFAULT_CODE_VIEW_FILE_METRICS, DEFAULT_CODE_VIEW_LAYOUT, DEFAULT_SMOOTH_SCROLL_SETTINGS, DEFAULT_THEMES, DIFFS_DEVELOPMENT_BUILD, DIFFS_TAG_NAME } from "../constants.js";
 import { dequeueRender, queueRender } from "../managers/UniversalRenderingManager.js";
 import { areObjectsEqual } from "../utils/areObjectsEqual.js";
 import { areSelectionsEqual } from "../utils/areSelectionsEqual.js";
@@ -147,8 +147,8 @@ var CodeView = class CodeView {
 		this.stickyContainer.style.display = "flex";
 		this.stickyContainer.style.flexDirection = "column";
 	}
-	getViewerMetrics() {
-		return this.options.viewerMetrics ?? DEFAULT_CODE_VIEW_METRICS;
+	getLayout() {
+		return this.options.layout ?? DEFAULT_CODE_VIEW_LAYOUT;
 	}
 	getItemMetrics() {
 		return this.options.itemMetrics ?? DEFAULT_CODE_VIEW_FILE_METRICS;
@@ -159,6 +159,33 @@ var CodeView = class CodeView {
 	shouldDisablePointerEvents() {
 		return this.options.pointerEventsOnScroll !== true;
 	}
+	shouldValidateItemHeights() {
+		return DIFFS_DEVELOPMENT_BUILD && this.options.__devOnlyValidateItemHeights === true;
+	}
+	validateRenderedItemHeight(item) {
+		if (!this.shouldValidateItemHeights() || item.element == null) return;
+		const stickySpecs = item.instance.getAdvancedStickySpecs();
+		if (stickySpecs == null) return;
+		const expectedHeight = stickySpecs.height;
+		const actualHeight = item.element.getBoundingClientRect().height;
+		if (expectedHeight === actualHeight) return;
+		console.error("CodeView: reconciled item height does not match DOM height", {
+			id: item.item.id,
+			type: item.type,
+			index: item.index,
+			version: item.version,
+			expectedHeight,
+			actualHeight,
+			delta: actualHeight - expectedHeight,
+			stickyTopOffset: stickySpecs.topOffset,
+			virtualizedHeight: item.instance.getVirtualizedHeight(),
+			top: item.top,
+			scrollTop: this.getScrollTop(),
+			windowSpecs: { ...this.windowSpecs },
+			element: item.element,
+			instance: item.instance
+		});
+	}
 	clearPointerEventsTimer() {
 		if (this.pointerEventsRestoreTimer != null) {
 			clearTimeout(this.pointerEventsRestoreTimer);
@@ -180,8 +207,8 @@ var CodeView = class CodeView {
 		this.stickyContainer.style.removeProperty("pointer-events");
 		this.pointerEventsDisabled = false;
 	};
-	syncViewerMetrics() {
-		const { gap, paddingBottom, paddingTop } = this.getViewerMetrics();
+	syncLayout() {
+		const { gap, paddingBottom, paddingTop } = this.getLayout();
 		this.stickyContainer.style.gap = `${gap}px`;
 		this.container?.style.setProperty("margin-top", `${paddingTop}px`);
 		this.container?.style.setProperty("margin-bottom", `${paddingBottom}px`);
@@ -192,7 +219,7 @@ var CodeView = class CodeView {
 		this.root.style.overflowAnchor = "none";
 		this.container ??= document.createElement("div");
 		this.container.style.contain = "layout style";
-		this.syncViewerMetrics();
+		this.syncLayout();
 		this.container.appendChild(this.stickyOffset);
 		this.container.appendChild(this.stickyContainer);
 		this.root.appendChild(this.container);
@@ -304,6 +331,22 @@ var CodeView = class CodeView {
 	clearSelectedLines(options) {
 		this.applySelectedLines(null, options);
 	}
+	getItem(itemId) {
+		return this.idToItem.get(itemId)?.item;
+	}
+	updateItem(input) {
+		const item = this.idToItem.get(input.id);
+		if (item == null) {
+			console.error(`CodeView.updateItem: unknown item id "${input.id}"`);
+			return false;
+		}
+		if (!this.syncItemRecord(item, input)) return false;
+		this.markItemLayoutDirty(item);
+		this.scrollDirty = true;
+		this.render();
+		this.syncSelection();
+		return true;
+	}
 	addItem(input) {
 		this.addItems([input]);
 		this.syncSelection();
@@ -326,8 +369,9 @@ var CodeView = class CodeView {
 	*/
 	appendItemsInternal(inputs, render = true) {
 		if (inputs.length === 0) return;
-		const viewerMetrics = this.getViewerMetrics();
-		let nextTop = this.items.length === 0 ? 0 : this.scrollHeight + viewerMetrics.gap;
+		const layout = this.getLayout();
+		let nextTop = this.items.length === 0 ? 0 : this.scrollHeight + layout.gap;
+		const appendedTop = nextTop;
 		for (let index = 0; index < inputs.length; index++) {
 			const input = inputs[index];
 			if (input == null) throw new Error("CodeView.appendItemsInternal: missing input item");
@@ -337,21 +381,25 @@ var CodeView = class CodeView {
 			this.idToItem.set(item.item.id, item);
 			this.instanceToItem.set(item.instance, item);
 			item.height = prepareItemInstance(item);
-			nextTop += item.height + viewerMetrics.gap;
+			nextTop += item.height + layout.gap;
 		}
-		this.scrollHeight = nextTop - viewerMetrics.gap;
+		this.scrollHeight = nextTop - layout.gap;
 		this.scrollDirty = true;
-		if (render) this.render();
+		if (render) if (this.canSkipRenderForAppend(appendedTop)) this.syncContainerHeight();
+		else this.render();
+	}
+	canSkipRenderForAppend(appendedTop) {
+		return this.container != null && this.renderState.firstIndex !== -1 && this.pendingScrollTarget == null && this.scrollAnimation == null && this.layoutDirtyIndex == null && appendedTop > this.windowSpecs.bottom;
 	}
 	setOptions(options) {
 		if (options == null) return;
 		this.capturePendingLayoutAnchor();
-		const previousViewerMetrics = this.getViewerMetrics();
+		const previousLayout = this.getLayout();
 		const previousItemMetrics = this.getItemMetrics();
 		this.options = options;
 		const nextItemMetrics = this.getItemMetrics();
 		const itemMetricsChanged = !areObjectsEqual(previousItemMetrics, nextItemMetrics);
-		if (!areObjectsEqual(previousViewerMetrics, this.getViewerMetrics())) this.syncViewerMetrics();
+		if (!areObjectsEqual(previousLayout, this.getLayout())) this.syncLayout();
 		for (let index = 0; index < this.items.length; index++) {
 			const item = this.items[index];
 			if (item == null) throw new Error("CodeView.setOptions: invalid item index");
@@ -427,15 +475,15 @@ var CodeView = class CodeView {
 			this.scrollListeners.delete(listener);
 		};
 	}
-	getTopForInstance(instance) {
+	getLocalTopForInstance(instance) {
 		const item = this.instanceToItem.get(instance);
-		if (item == null) throw new Error("CodeView.getTopForInstance: unknown virtualized instance");
+		if (item == null) throw new Error("CodeView.getLocalTopForInstance: unknown virtualized instance");
 		return item.top;
 	}
 	getTopForItem(id) {
 		const item = this.idToItem.get(id);
 		if (item == null) return;
-		return item.top;
+		return item.top + this.getLayout().paddingTop;
 	}
 	createItem(input, index, top) {
 		const itemMetrics = this.getItemMetrics();
@@ -647,7 +695,7 @@ var CodeView = class CodeView {
 		return true;
 	}
 	getMaxScrollTopForHeight(scrollHeight) {
-		const { paddingBottom, paddingTop } = this.getViewerMetrics();
+		const { paddingBottom, paddingTop } = this.getLayout();
 		return Math.max(paddingTop + scrollHeight + paddingBottom - this.getHeight(), 0);
 	}
 	getMaxScrollTop() {
@@ -734,6 +782,17 @@ var CodeView = class CodeView {
 			top: item.top,
 			height: item.height
 		};
+		if (target.type === "range") {
+			const rangePosition = this.getRangeScrollPosition(item, target);
+			if (rangePosition == null) {
+				console.warn(`CodeView.scrollTo: unable to resolve range ${formatSelectedLineRange(target.range)} for item "${target.id}"`);
+				return;
+			}
+			return {
+				top: item.top + rangePosition.top,
+				height: rangePosition.height
+			};
+		}
 		const linePosition = this.getLineScrollPosition(item, target);
 		if (linePosition == null) {
 			console.warn(`CodeView.scrollTo: unable to resolve line ${target.lineNumber} for item "${target.id}"`);
@@ -749,10 +808,10 @@ var CodeView = class CodeView {
 		const rect = this.getScrollTargetRect(target);
 		if (rect == null) return;
 		const offset = target.offset ?? 0;
-		const targetTop = this.getViewerMetrics().paddingTop + rect.top;
+		const targetTop = this.getLayout().paddingTop + rect.top;
 		const targetBottom = targetTop + rect.height;
 		const currentTop = this.getScrollTop();
-		const visibleTop = currentTop + (target.type === "line" ? this.getStickyHeaderOffset() : 0);
+		const visibleTop = currentTop + (target.type === "line" || target.type === "range" ? this.getStickyHeaderOffset() : 0);
 		const visibleBottom = currentTop + this.getHeight();
 		if (targetTop - offset <= visibleTop && targetBottom + offset >= visibleBottom) return;
 		if (targetTop - offset < visibleTop) return {
@@ -780,6 +839,14 @@ var CodeView = class CodeView {
 			return;
 		}
 		if (target.type === "item") return this.clampScrollTop(this.resolveAlignedScrollPosition(item.top, item.height, target.align, target.offset));
+		if (target.type === "range") {
+			const rangePosition = this.getRangeScrollPosition(item, target);
+			if (rangePosition == null) {
+				console.warn(`CodeView.scrollTo: unable to resolve range ${formatSelectedLineRange(target.range)} for item "${target.id}"`);
+				return;
+			}
+			return this.clampScrollTop(this.resolveAlignedScrollPosition(item.top + rangePosition.top, rangePosition.height, target.align, target.offset, this.getStickyHeaderOffset()));
+		}
 		const linePosition = this.getLineScrollPosition(item, target);
 		if (linePosition == null) {
 			console.warn(`CodeView.scrollTo: unable to resolve line ${target.lineNumber} for item "${target.id}"`);
@@ -793,7 +860,7 @@ var CodeView = class CodeView {
 	* and stickyOffset if necessary
 	*/
 	resolveAlignedScrollPosition(targetTop, targetHeight, align, offset = 0, stickyOffset = 0) {
-		targetTop += this.getViewerMetrics().paddingTop;
+		targetTop += this.getLayout().paddingTop;
 		const viewportHeight = this.getHeight();
 		if (align === "center" && targetHeight + offset < viewportHeight) return targetTop - (viewportHeight - targetHeight) / 2 + offset;
 		if (align === "end") return targetTop - (viewportHeight - targetHeight) + offset;
@@ -803,6 +870,31 @@ var CodeView = class CodeView {
 		if (item.type === "diff") return item.instance.getLinePosition(target.lineNumber, target.side);
 		return item.instance.getLinePosition(target.lineNumber);
 	}
+	getRangeScrollPosition(item, target) {
+		const { range } = target;
+		const startPosition = this.getLineScrollPosition(item, {
+			type: "line",
+			id: target.id,
+			lineNumber: range.start,
+			side: range.side
+		});
+		const endPosition = this.getLineScrollPosition(item, {
+			type: "line",
+			id: target.id,
+			lineNumber: range.end,
+			side: range.endSide ?? range.side
+		});
+		if (startPosition == null || endPosition == null) return;
+		const startTop = startPosition.top;
+		const startBottom = startTop + startPosition.height;
+		const endTop = endPosition.top;
+		const endBottom = endTop + endPosition.height;
+		const top = Math.min(startTop, endTop);
+		return {
+			top,
+			height: Math.max(startBottom, endBottom) - top
+		};
+	}
 	/**
 	* Determine target scroll position for current frame.
 	*
@@ -1029,9 +1121,10 @@ var CodeView = class CodeView {
 					heightChanged = true;
 					item.height = item.instance.getVirtualizedHeight();
 				}
+				this.validateRenderedItemHeight(item);
 			}
 			currentTop += item.instance.getVirtualizedHeight();
-			if (index < this.items.length - 1) currentTop += this.getViewerMetrics().gap;
+			if (index < this.items.length - 1) currentTop += this.getLayout().gap;
 		}
 		if (heightChanged && currentTop != null) {
 			this.scrollDirty = true;
@@ -1104,7 +1197,7 @@ var CodeView = class CodeView {
 		for (let index = firstIndex; index <= lastIndex; index++) {
 			const item = this.items[index];
 			if (item == null) continue;
-			const absoluteItemTop = this.getViewerMetrics().paddingTop + item.top;
+			const absoluteItemTop = this.getLayout().paddingTop + item.top;
 			if (absoluteItemTop + item.height <= scrollTop) continue;
 			if (absoluteItemTop >= scrollTop + viewportHeight) break;
 			if (absoluteItemTop >= scrollTop) return {
@@ -1136,7 +1229,7 @@ var CodeView = class CodeView {
 	resolveAnchoredScrollTop(anchor) {
 		const item = this.idToItem.get(anchor.id);
 		if (item == null) return;
-		const { paddingTop } = this.getViewerMetrics();
+		const { paddingTop } = this.getLayout();
 		if (anchor.type === "item") {
 			const absoluteItemTop = paddingTop + item.top;
 			return this.clampScrollTop(absoluteItemTop - anchor.viewportOffset);
@@ -1262,12 +1355,12 @@ var CodeView = class CodeView {
 			this.scrollHeight = 0;
 			return;
 		}
-		const viewerMetrics = this.getViewerMetrics();
+		const layout = this.getLayout();
 		let runningTop = 0;
 		if (startIndex > 0) {
 			const previousItem = this.items[startIndex - 1];
 			if (previousItem == null) throw new Error("CodeView.recomputeLayout: invalid dirty index");
-			runningTop = previousItem.top + previousItem.height + viewerMetrics.gap;
+			runningTop = previousItem.top + previousItem.height + layout.gap;
 		}
 		for (let index = startIndex; index < this.items.length; index++) {
 			const item = this.items[index];
@@ -1276,7 +1369,7 @@ var CodeView = class CodeView {
 			if (item.type === "diff") item.height = item.instance.prepareVirtualizedItem(item.item.fileDiff);
 			else item.height = item.instance.prepareVirtualizedItem(item.item.file);
 			runningTop += item.height;
-			if (index < this.items.length - 1) runningTop += viewerMetrics.gap;
+			if (index < this.items.length - 1) runningTop += layout.gap;
 		}
 		if (runningTop !== this.scrollHeight) this.scrollDirty = true;
 		this.scrollHeight = runningTop;
@@ -1290,7 +1383,7 @@ var CodeView = class CodeView {
 		this.renderState.stickyBottom = -1;
 	}
 	getFitPerfectlyOverscroll() {
-		return this.getViewerMetrics().gap + this.getItemMetrics().diffHeaderHeight;
+		return this.getLayout().gap + this.getItemMetrics().diffHeaderHeight;
 	}
 };
 function cleanRenderedItem(item) {
@@ -1303,6 +1396,15 @@ function prepareItemInstance(item) {
 	if (item.type === "diff") return item.instance.prepareVirtualizedItem(item.item.fileDiff);
 	else return item.instance.prepareVirtualizedItem(item.item.file);
 }
+function formatSelectedLineRange(range) {
+	const start = formatSelectedLinePoint(range.start, range.side);
+	const end = formatSelectedLinePoint(range.end, range.endSide ?? range.side);
+	return start === end ? start : `${start}-${end}`;
+}
+function formatSelectedLinePoint(lineNumber, side) {
+	if (side == null) return `${lineNumber}`;
+	return `${side === "deletions" ? "D" : "A"}${lineNumber}`;
+}
 function renderItem(item, fileContainer) {
 	if (item.type === "diff") return item.instance.render({
 		deferManagers: true,