@gitkraken/gitkraken-components 13.0.0-vnext.2 → 13.0.0-vnext.27

package/dist/components/graph/rowAdornment/RowAdornmentLayer.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import type { Sha } from '../../../domain/commit/CommitTypes';
+import type { ProcessedGraphRow } from '../../../domain/graph/GraphTypes';
+import type { RowAdornmentProvider } from '../../../domain/graph/rowAdornment/RowAdornmentTypes';
+interface RowAdornmentLayerProps {
+    /** The row adornment provider */
+    provider: RowAdornmentProvider;
+    /** Lazily get currently visible rows - only called when needed */
+    getVisibleRows: () => ProcessedGraphRow[];
+    /** All processed rows for index lookups */
+    allRows: ProcessedGraphRow[];
+    /** Set of selected SHAs */
+    selectedShas: Set<Sha>;
+    /** Currently hovered commit SHA */
+    hoveredSha?: Sha;
+    /** Currently focused commit SHA */
+    focusedSha?: Sha;
+    /** Whether vertical scrollbar is visible (to offset adornments) */
+    hasVerticalScrollbar?: boolean;
+}
+interface RowAdornmentLayerState {
+    /** Trigger re-render when cache changes */
+    cacheVersion: number;
+}
+/**
+ * Manages row adornment state and rendering.
+ * Encapsulates all adornment caching, provide/resolve flows, and overlay rendering.
+ */
+declare class RowAdornmentLayer extends React.Component<RowAdornmentLayerProps, RowAdornmentLayerState> {
+    /** Cached adornment info per SHA */
+    private adornments;
+    /** Tracks pending async resolve calls to cancel stale ones */
+    private pendingResolves;
+    /** Abort controller for canceling in-flight provide calls */
+    private provideAbortController?;
+    /** Counter for generating unique resolve IDs */
+    private resolveIdCounter;
+    state: RowAdornmentLayerState;
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: RowAdornmentLayerProps): void;
+    componentWillUnmount(): void;
+    private setupProvider;
+    private teardownProvider;
+    private onInvalidate;
+    private provideForVisibleRows;
+    private applyProvideResults;
+    private evictDistantAdornments;
+    private shouldShowAdornment;
+    private getOrResolveContent;
+    render(): React.ReactNode;
+}
+export default RowAdornmentLayer;

package/dist/components/graph/rowAdornment/RowAdornmentOverlay.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import * as React from 'react';
+import type { Sha } from '../../../domain/commit/CommitTypes';
+interface RowAdornmentOverlayProps {
+    /** The SHA of the row this adornment is for */
+    sha: Sha;
+    /** The content to render */
+    content: ReactNode;
+    /** Whether the row is hovered */
+    isHovered?: boolean;
+    /** Whether the row is selected */
+    isSelected?: boolean;
+}
+/**
+ * Renders a row adornment overlay positioned at the right edge of a row.
+ * Uses CSS anchor positioning to attach to the row element.
+ */
+declare function RowAdornmentOverlay({ sha, content, isHovered, isSelected, }: RowAdornmentOverlayProps): React.ReactElement | null;
+export default RowAdornmentOverlay;

package/dist/components/graph/rowRenderers/CommitsInfoRow.d.ts

@@ -1,5 +1,5 @@
 import type { ReactElement } from 'react';
-import React from 'react';
+import * as React from 'react';
 import type { Style } from '../../../domain/generic/GenericTypes';
 import type { GraphZoneType } from '../../../domain/graph/GraphConstants';
 import type { GetExternalIcon } from '../../../domain/graph/GraphTypes';

package/dist/components/graph/rowRenderers/RefZoneRow.d.ts

@@ -17,6 +17,7 @@ interface StateProps {
     hoveredRefZoneSha?: Sha;
     refIconsPosition: RefIconsPosition;
     refMetadataById?: RefMetadataById | null;
+    fallbackRefMetadataById?: RefMetadataById | null;
     shouldShowRefLine: boolean;
 }
 interface DispatchProps {

package/dist/components/graph/shared/Avatar.d.ts

@@ -1,5 +1,5 @@
 import type { CSSProperties, ReactElement, ReactNode } from 'react';
-import React from 'react';
+import * as React from 'react';
 import type { GraphItemContext } from '../../../domain/graph/GraphTypes';
 type DataURLBase64 = string;
 type Props = {

package/dist/components/graph/shared/FileDiffTypeIcon.d.ts

@@ -1,5 +1,5 @@
 import type { ReactElement } from 'react';
-import React from 'react';
+import * as React from 'react';
 import type { Style } from '../../../domain/generic/GenericTypes';
 import type { GetExternalIcon } from '../../../domain/graph/GraphTypes';
 import type { TranslationFn } from '../../../domain/language/LanguageTypes';
@@ -8,6 +8,7 @@ type Props = {
     fileDiffType: string;
     getExternalIcon: GetExternalIcon;
     translate: TranslationFn;
+    noMargin?: boolean;
 };
 declare class FileDiffTypeIcon extends React.Component<Props> {
     render(): ReactElement<'span'> | null;

package/dist/components/graph/shared/WipStatsPill.d.ts

@@ -0,0 +1,11 @@
+import type { ReactElement } from 'react';
+import type { GetExternalIcon } from '../../../domain/graph/GraphTypes';
+import type { TranslationFn } from '../../../domain/language/LanguageTypes';
+import type { WorkDirStats } from '../../../domain/workdir/WorkDirTypes';
+type Props = {
+    workDirStats: WorkDirStats;
+    getExternalIcon: GetExternalIcon;
+    translate: TranslationFn;
+};
+declare function WipStatsPill({ workDirStats, getExternalIcon, translate }: Props): ReactElement<'span'> | null;
+export default WipStatsPill;

package/dist/components/resizable/Resizable.d.ts

@@ -1,10 +1,9 @@
-/// <reference types="node" />
 import type { HandleStyles, ResizeCallback, ResizeStartCallback } from 're-resizable';
 import type { ReactElement, ReactNode } from 'react';
-import React from 'react';
+import * as React from 'react';
 import type { Style } from '../../domain/generic/GenericTypes';
 import type { TranslationFn } from '../../domain/language/LanguageTypes';
-import type { OnResize, OnResizeEnd, OnResizeFromPropChange, OnResizeStart, OnWheel } from '../../domain/ui/UiTypes';
+import type { OnResize, OnResizeEnd, OnResizeFromPropChange, OnResizeStart } from '../../domain/ui/UiTypes';
 declare const resizableEdges: {
     bottom: string;
     left: string;
@@ -61,19 +60,15 @@ interface State extends Dimensions {
     initialWidth: number;
     resizing: boolean;
     vertical: boolean;
-    isMouseWheeling: boolean;
 }
 export default class Resizable extends React.PureComponent<Props, State> {
     static defaultProps: DefaultProps;
-    onWheelTimeOut?: NodeJS.Timeout;
-    isMouseWheeling: boolean;
     constructor(props: Props);
     static getDerivedStateFromProps(props: Props, state: State): State;
     componentDidUpdate(nextProps: Props): void;
     _onResize: ResizeCallback;
     _onResizeStart: ResizeStartCallback;
     _onResizeEnd: ResizeCallback;
-    _onWheel: OnWheel;
     render(): ReactElement<'div'>;
 }
 export {};

package/dist/domain/generic/GenericTypes.d.ts

@@ -15,9 +15,15 @@ export type GitRemoteUrl = GitHttpsUrl | GitSshUrl;
 export type Platform = 'darwin' | 'linux' | 'win32';
 export declare enum NamedKeys {
     arrowDownKey = "ArrowDown",
+    arrowLeftKey = "ArrowLeft",
+    arrowRightKey = "ArrowRight",
     arrowUpKey = "ArrowUp",
     controlKey = "Control",
+    endKey = "End",
+    homeKey = "Home",
     metaKey = "Meta",
+    pageDownKey = "PageDown",
+    pageUpKey = "PageUp",
     shiftKey = "Shift"
 }
 export type MapWithCacheQueue<T, U> = {

package/dist/domain/graph/GraphConstants.d.ts

@@ -70,6 +70,20 @@ export declare const commitAuthorZone: CommitAuthorZoneType;
 export declare const commitDateTimeZone: CommitDateTimeZoneType;
 export declare const commitShaZone: CommitShaZoneType;
 export declare const changesZone: ChangesZoneType;
+/**
+ * A sentinel key used as a key in objects to indicate "empty set" state
+ * This distinguishes between:
+ * - `{}` (empty object) - no filtering applied or null/undefined
+ * - `{ [emptySetMarker]: true }` - filtering applied but yielded no results
+ *
+ * Example usage:
+ * ```typescript
+ * const highlightedShas = searchResults.count === 0
+ *   ? { [emptySetMarker]: true }  // No results found
+ *   : searchResults.ids;        // Results found
+ * ```
+ */
+export declare const emptySetMarker = "gk.empty-set-marker";
 export declare enum GraphColumnMode {
     Compact = "compact",
     Rich = "rich",
@@ -154,5 +168,5 @@ export declare enum graphCommitDescDisplayModes {
     NEVER = "NEVER"
 }
 export type GraphCommitDescDisplayMode = graphCommitDescDisplayModes.ALWAYS | graphCommitDescDisplayModes.ON_HOVER | graphCommitDescDisplayModes.NEVER;
-export type ShiftSelectMode = 'simple';
+export type ShiftSelectMode = 'simple' | 'topological';
 export type GraphSearchMode = 'normal' | 'filter';

package/dist/domain/graph/GraphHelpers.d.ts

@@ -4,9 +4,9 @@ import type { CssVariables } from '../generic/GenericTypes';
 import type { GetRealKeyForCellFunc } from '../reactvirtualized/ReactVirtualizedHelpers';
 import type { GraphRefType } from '../ref/RefTypes';
 import type { WorkDirStats } from '../workdir/WorkDirTypes';
-import type { GraphMarkerType, GraphZone, GraphZoneType, TimelineEntriesByPeriod } from './GraphConstants';
+import type { GraphMarkerType, GraphZone, GraphZoneType, TimelineEntry } from './GraphConstants';
 import { GraphColumnMode } from './GraphConstants';
-import type { BaseMetadata, GetMissingRefMetadata, GraphColumnWidthConstraints, GraphItemContext, GraphRef, GraphRefGroup, GraphRow, GraphZoneModeConstants, Head, HighlightedShas, ProcessedGraphRow, ProcessedGraphRowBySha, Ref, RefMetadata, RefMetadataById, RefMetadataType, RowStatsConstraints } from './GraphTypes';
+import type { BaseMetadata, ExternalIconKeys, GetMissingRefMetadata, GraphColumnWidthConstraints, GraphItemContext, GraphRef, GraphRefGroup, GraphRow, GraphZoneModeConstants, Head, HighlightedShas, ProcessedGraphRow, ProcessedGraphRowBySha, Ref, RefMetadata, RefMetadataById, RefMetadataType, RowStatsConstraints } from './GraphTypes';
 export type DebouncableFn = (...args: any) => void;
 export type DebouncedFn = (...args: any) => void;
 export declare const debounceFrame: (func: DebouncableFn) => DebouncedFn;
@@ -17,8 +17,23 @@ export declare function hasScrolledToBottom(htmlElement: HTMLElement): boolean;
 export declare function hasScrolledToRight(htmlElement: HTMLElement): boolean;
 export declare function parseContext(context?: GraphItemContext | null): string | null;
 export declare function getRowStatsConstraints(stats: number[]): RowStatsConstraints;
-export declare function getOrAskForRefMetadata(ref: GraphRef, refMetadata: RefMetadataById | undefined, onMissingRefMetadata: GetMissingRefMetadata, refMetadataType?: RefMetadataType): RefMetadata | BaseMetadata | BaseMetadata[] | null | undefined;
-export declare function getTimelineEntriesByPeriod(): TimelineEntriesByPeriod;
+export declare function getOrAskForRefMetadata(ref: GraphRef, refMetadata: RefMetadataById | undefined, onMissingRefMetadata: GetMissingRefMetadata, refMetadataType?: RefMetadataType, fallbackRefMetadata?: RefMetadataById | null): RefMetadata | BaseMetadata | BaseMetadata[] | null | undefined;
+export declare function getTimelineLabelAndValue(diffMs: number): {
+    label: string;
+    value: number;
+};
+export declare function getTimelineEntriesByPeriod(): TimelineEntry[];
+/**
+ * Assigns timeline entries to graph rows based on commit dates.
+ *
+ * Timeline markers act as boundaries between time periods:
+ * - All commits above a marker must be younger (more recent) than the marker time
+ * - All commits at and below a marker must be equal to or older than the marker time
+ *
+ * @param orderedRows - Array of graph rows ordered from newest to oldest
+ * @param entries - Array of timeline entries ordered from newest to oldest
+ */
+export declare function assignTimelineEntriesToRows(orderedRows: ProcessedGraphRow[], entries: TimelineEntry[]): void;
 export declare function getRefIdByBaseRef(refType: GraphRefType, ref: Ref): string;
 export declare function getRefIdByGraphRef(ref: GraphRef): string;
 export declare function getLastShrinkableGraphZone(activeGraphZones: GraphZone[], stoppingIndex?: number): GraphZone | undefined;
@@ -53,7 +68,7 @@ export declare function workDirStatsHaveChanges(workDirStats?: WorkDirStats): bo
 export declare function hasSingleSelectedSha(selectedShas: Set<Sha>): boolean;
 export declare function isSingleSelected(selectedShas: Set<Sha>, sha: Sha): boolean;
 export declare function getScrollToAlignment(rowHeight: number, clientHeight: number, scrollTop: number, scrollToIndex: number): Alignment;
-export declare function getGraphZoneIconByType(zoneType: GraphZoneType): string;
+export declare function getGraphZoneIconByType(zoneType: GraphZoneType): ExternalIconKeys | undefined;
 export declare function isHeadActive(head: Head): boolean;
 export declare function isGraphRefActive(ref: GraphRef): boolean;
 export interface GraphRowHelperProps {
@@ -70,6 +85,7 @@ export interface GraphRowHelperProps {
     selectedShas: Set<Sha>;
     processedRows: ProcessedGraphRow[];
     processedGraphRowBySha: ProcessedGraphRowBySha;
+    scrollTop: number;
     alwaysShowTimelines?: boolean;
 }
 export declare class GraphRowHelper {

package/dist/domain/graph/GraphTypes.d.ts

@@ -1,5 +1,5 @@
 import type { GridCellRenderer, ScrollParams } from 'react-virtualized';
-import type { ReactElement } from 'react';
+import type { ReactElement, ReactNode } from 'react';
 import type { CommitDateTimeSources } from '../commit/CommitConstants';
 import type { CommitType, Sha } from '../commit/CommitTypes';
 import type { CssVariables } from '../generic/GenericTypes';
@@ -147,7 +147,7 @@ export type ReserverInfoBySha = {
 };
 export type RefTargetFunc = () => Element | null | undefined;
 export type ColumnContentGenerator = () => ReactElement<any>;
-export type GraphItemContext = string | Object;
+export type GraphItemContext = string | object;
 export type RefGroupContexts = {
     [name: string]: GraphItemContext;
 };
@@ -313,16 +313,26 @@ export interface GraphRefsData {
     orderedRefGroups: GraphRefGroup[];
     refGroupsByName: GraphRefGroupsByName;
 }
+type ReadonlyDeep<T> = T extends Record<string, unknown> ? {
+    readonly [K in keyof T]: ReadonlyDeep<T[K]>;
+} : T extends Array<infer U> ? ReadonlyArray<ReadonlyDeep<U>> : T;
+export interface ReadonlyGraphRow extends ReadonlyDeep<GraphRow> {
+    rowIndex?: number;
+    readonly hasRefs?: boolean;
+    /** Whether the row is hidden from the graph (filtered out by type or other filters). Output only */
+    readonly hidden: boolean;
+}
 export interface ProcessedGraphRow extends GraphRow {
     rowIndex?: number;
     column: number;
     columnForColoring?: number;
-    displayMessage: string;
-    displaySummary: string;
-    displayBody?: string;
+    displaySummary: string | ReactNode;
+    displayBody?: string | ReactNode;
     edges: RowEdges;
     edgeColumnMaxes: number;
     hasRefs?: boolean;
+    /** Whether the row is hidden from the graph (filtered out by type or other filters). Output only */
+    hidden: boolean;
     summary: string;
     body?: string;
     timeLineEntry?: TimelineEntry;
@@ -396,7 +406,8 @@ export type DownstreamsByUpstream = {
     [upstreamName: string]: string[];
 };
 export type GraphPlatform = 'aix' | 'android' | 'darwin' | 'freebsd' | 'linux' | 'openbsd' | 'sunos' | 'win32' | 'cygwin';
-export type GetExternalIcon = (key: string) => ReactElement<any>;
+export type ExternalIconKeys = 'added' | 'author' | 'branch' | 'changes' | 'check' | 'commit' | 'datetime' | 'deleted' | 'files' | 'filter' | 'graph' | 'head' | 'hide' | `issue-${IssueTrackerType}` | 'loading' | 'message' | 'modified' | 'pull-request' | 'remote' | `remote-${HostingServiceType}` | 'renamed' | 'resolved' | 'settings' | 'show' | 'stash' | 'tag' | 'upstream-ahead' | 'upstream-behind' | 'warning' | 'worktree';
+export type GetExternalIcon = (key: ExternalIconKeys) => ReactElement<any>;
 export type GetMissingAvatar = (email: string, sha: string) => void;
 export type GetMissingRefMetadata = (id: string, types: RefMetadataType[]) => void;
 export type FormatRefShorthand = (shorthand: RefShorthand, sha: Sha, refType: GraphRefType, data?: any | null) => RefShorthand;
@@ -429,7 +440,10 @@ export type OnGraphMouseLeave = (event: React.MouseEvent<any>) => void;
 export type OnClearCurrentlyHoveredGraphCommit = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, sha: Sha, currentlyHoveredCommitSha?: Sha) => void;
 export type CommitDateTimeSource = CommitDateTimeSources;
 export type OnFormatCommitDateTime = (commitDateTime: number, source?: CommitDateTimeSource) => string;
-export type FormatCommitMessage = (commitMessage: string) => string;
+export type FormatCommitMessage = (commitMessage: string) => {
+    summary: string | ReactNode;
+    body?: string | ReactNode;
+};
 export type OnCurrentlyHoveredGraphCommit = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, sha: Sha, currentlyHoveredCommitSha?: Sha) => void;
 export type OnClickCommit = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, sha: Sha) => void;
 export type OnClickRef = (event: React.MouseEvent<any>, refGroup: GraphRefGroup, sha: Sha, metadataItem?: RefMetadataItem) => void;
@@ -462,7 +476,13 @@ export type OnDoubleClickGraphRef = (event: React.MouseEvent<any>, refGroup: Gra
 export type OnRowContextMenu = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, graphRow: GraphRow) => void;
 export type OnRefContextMenu = (event: React.MouseEvent<any>, refGroup: GraphRefGroup, graphRow: GraphRow) => void;
 export type OnToggleRefsVisibilityClick = (event: React.MouseEvent<any>, refs: GraphRefOptData[], visible: boolean, graphRow?: GraphRow) => void;
-export type OnSelectGraphRows = (selectedRows: GraphRow[]) => void;
+export interface GraphSelectionState {
+    /** Whether the selected rows form a topologically contiguous selection (connected via parent-child relationships) */
+    isContiguous: boolean;
+    /** Whether the selection was made topologically (via shift+click following graph topology) */
+    isTopological: boolean;
+}
+export type OnSelectGraphRows = (rows: ReadonlyGraphRow[], focusedRow: ReadonlyGraphRow | undefined, state: GraphSelectionState) => void;
 export type OnGraphRowHovered = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, graphRow: GraphRow) => void;
 export type OnGraphRowUnhovered = (event: React.MouseEvent<any>, graphZoneType: GraphZoneType, graphRow: GraphRow) => void;
 export type OnGraphRefNodeHovered = (event: React.MouseEvent<any>, refGroup: GraphRefGroup, graphRow: GraphRow) => void;
@@ -473,3 +493,4 @@ export type OnGraphColumnResized = (graphZoneType: GraphZoneType, columnSettings
 export type OnShowMoreCommits = () => void;
 export type OnEmailsMissingAvatarUrls = (emails: AvatarUrlByEmail) => void;
 export type OnRefsMissingMetadata = (refs: RefsMissingMetadata) => void;
+export {};

package/dist/domain/graph/row/ProcessedGraphRowObj.d.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import type { IGraphContainer } from '../../../components/graph/IGraphContainer';
 import type { CommitType, Sha } from '../../commit/CommitTypes';
 import type { TimelineEntry } from '../GraphConstants';
@@ -28,9 +29,8 @@ export declare class ProcessedGraphRowObj implements ProcessedGraphRow {
     timeLineEntry?: TimelineEntry;
     summary: string;
     body?: string;
-    displayMessage: string;
-    displaySummary: string;
-    displayBody?: string;
+    displaySummary: string | ReactNode;
+    displayBody?: string | ReactNode;
     set message(message: string);
     get message(): string;
     get heads(): Head[];
@@ -41,9 +41,9 @@ export declare class ProcessedGraphRowObj implements ProcessedGraphRow {
     get tags(): Tag[];
     get hasRefs(): boolean;
     get hasChildRefs(): boolean;
+    get hidden(): boolean;
     get refsData(): GraphRefsData | undefined;
     constructor(graphContainer: IGraphContainer, row: GraphRow, column?: number, edgeColumnMaxes?: number, edges?: RowEdges, childRefs?: ChildRefsByType, timeLineEntry?: TimelineEntry, columnForColoring?: number);
-    private updateSummaryAndBody;
     private initializeRefGroups;
     private addRefToRefGroup;
     private loadGraphRefGroupsData;

package/dist/domain/graph/rowAdornment/RowAdornmentTypes.d.ts

@@ -0,0 +1,97 @@
+import type { ReactNode } from 'react';
+import type { Sha } from '../../commit/CommitTypes';
+import type { ReadonlyGraphRow } from '../GraphTypes';
+/**
+ * When the adornment should be visible:
+ * - `true` = always visible
+ * - Array of triggers = visible when ANY of the specified triggers are active
+ */
+export type AdornmentVisibility = true | readonly ('hover' | 'focus' | 'selected')[];
+/**
+ * Adornment configuration returned from provideAdornments for each row.
+ * @template TContext - Type of context data passed from provide to resolve
+ */
+export interface RowAdornment<TContext = unknown> {
+    /** When the adornment is visible */
+    visibility?: AdornmentVisibility;
+    /**
+     * Optional context data to pass to resolveAdornment.
+     * Use for passing batch-fetched data (e.g., PR status) to the resolve phase.
+     */
+    context?: TContext;
+    /**
+     * If true, resolve() is called on every render (content not cached).
+     * Use for adornments whose content depends on external state.
+     * Default: false (content is cached until invalidated)
+     */
+    dynamic?: boolean;
+}
+/**
+ * Invalidation level
+ */
+export type InvalidationType = 'all' | 'content';
+/**
+ * Custom event dispatched when adornments need re-evaluation
+ */
+export declare class RowAdornmentInvalidateEvent extends CustomEvent<{
+    shas?: Set<Sha>;
+    type: InvalidationType;
+}> {
+    static readonly type = "invalidate";
+    constructor(type: InvalidationType, shas?: Iterable<Sha>);
+}
+/**
+ * Provider interface - consumer implements, graph consumes
+ * @template TContext - Type of context data passed from provide to resolve
+ */
+export interface RowAdornmentProvider<TContext = unknown> {
+    /**
+     * Batch evaluation: which rows should have adornments?
+     *
+     * Called for:
+     *   - Newly visible rows (scrolled into view)
+     *   - Rows with 'all' invalidation
+     *
+     * Can return sync or async:
+     *   - Sync: Result applied immediately
+     *   - Async: Rows render without adornments until resolved
+     *           (AbortSignal can be used to cancel in-flight requests)
+     *
+     * @param rows - Rows needing evaluation
+     * @param signal - Abort signal (check before applying async results)
+     * @returns Map of SHA → adornment config. Rows not in result have no adornment.
+     */
+    provideAdornments(rows: readonly ReadonlyGraphRow[], signal: AbortSignal): Record<Sha, RowAdornment<TContext>> | Promise<Record<Sha, RowAdornment<TContext>>>;
+    /**
+     * Render content for a specific row.
+     *
+     * Called when:
+     *   - Row becomes active (visible for 'always', hovered/focused for triggers)
+     *   - Row has 'content' invalidation and is active
+     *   - Row is dynamic (every render when active)
+     *
+     * Can return sync or async:
+     *   - Sync (ReactNode): Content rendered immediately
+     *   - Async (Promise<ReactNode>): Nothing shown until resolved
+     *
+     * @param row - The row to render adornment for
+     * @param context - Context data from provideAdornments (if any)
+     * @returns Content to render, or null/Promise for no/pending content
+     */
+    resolveAdornment(row: ReadonlyGraphRow, context?: TContext): ReactNode | null | Promise<ReactNode | null>;
+    /**
+     * EventTarget for invalidation.
+     * - Graph subscribes to 'invalidate' events
+     * - Consumer dispatches RowAdornmentInvalidateEvent to trigger re-evaluation
+     */
+    invalidate?: EventTarget;
+}
+/**
+ * Cached adornment state per row. Single map contains everything.
+ */
+export interface CachedAdornment {
+    visibility: AdornmentVisibility;
+    dynamic: boolean;
+    context?: unknown;
+    content?: ReactNode;
+}

package/dist/domain/hostingservice/HostingServiceTypes.d.ts

@@ -14,5 +14,7 @@ export type GitLabSelfHostedIssueTrackerType = GitLabSelfHostingServiceType;
 export type JiraCloudIssueTrackerType = 'jiraCloud';
 export type JiraServerIssueTrackerType = 'jiraServer';
 export type TrelloIssueTrackerType = 'trello';
-export type IssueTrackerType = GitHubIssueTrackerType | GithubEnterpriseIssueTrackerType | GitLabIssueTrackerType | GitLabSelfHostedIssueTrackerType | JiraCloudIssueTrackerType | JiraServerIssueTrackerType | TrelloIssueTrackerType | AzureDevopsIssueTrackerType;
+export type LinearIssueTrackerType = 'linear';
+export type BitbucketIssueTrackerType = 'bitbucket';
+export type IssueTrackerType = GitHubIssueTrackerType | GithubEnterpriseIssueTrackerType | GitLabIssueTrackerType | GitLabSelfHostedIssueTrackerType | JiraCloudIssueTrackerType | JiraServerIssueTrackerType | TrelloIssueTrackerType | LinearIssueTrackerType | AzureDevopsIssueTrackerType | BitbucketIssueTrackerType;
 export declare function getHostingServiceName(hostingServiceType: HostingServiceType): string;

package/dist/domain/reactvirtualized/ReactVirtualizedHelpers.d.ts

@@ -8,4 +8,4 @@ export type CustomCellCacheValue = {
 export type CustomCellCache = {
     [key: string]: CustomCellCacheValue;
 };
-export declare const makeSmartCellRangeRenderer: (getRealKeyForCell: GetRealKeyForCellFunc) => GridCellRangeRenderer;
+export declare const makeSmartCellRangeRenderer: (getRealKeyForCell: GetRealKeyForCellFunc, scrollLeft?: number, forceCache?: boolean) => GridCellRangeRenderer;

package/dist/domain/ref/RefConstants.d.ts

@@ -1,5 +1,8 @@
 export declare const refTypes: {
-    [key: string]: string;
+    readonly HEAD: "head";
+    readonly REMOTE: "remote";
+    readonly TAG: "tag";
+    readonly WORKTREE: "worktree";
 };
 export declare enum refIconsPositions {
     LEFT = "LEFT",

package/dist/domain/ref/RefTypes.d.ts

@@ -1,6 +1,6 @@
 import type { Sha } from '../commit/CommitTypes';
 import type * as RefConstants from './RefConstants';
-export type GraphRefType = keyof typeof RefConstants.refTypes;
+export type GraphRefType = (typeof RefConstants.refTypes)[keyof typeof RefConstants.refTypes];
 export type RefFullName = string;
 export type RefShorthand = string;
 export type CreateRefFormData = {

package/dist/index.d.ts

@@ -3,6 +3,21 @@ import ScrollbarContainer from './components/graph/common/ScrollbarContainer';
 import GraphContainer from './components/graph/GraphContainer';
 export * from './components/graph/GraphContainer';
 export * from './components/dnd/DndComponent';
-export * from './types';
+export * from './domain/commit/CommitConstants';
+export * from './domain/generic/GenericTypes';
+export * from './domain/commit/CommitTypes';
+export * from './domain/graph/GraphConstants';
+export * from './domain/graph/GraphTypes';
+export * from './domain/graph/rowAdornment/RowAdornmentTypes';
+export * from './domain/hostingservice/HostingServiceTypes';
+export * from './domain/ref/RefConstants';
+export * from './domain/ref/RefTypes';
+export * from './domain/workdir/WorkDirTypes';
+export * from './domain/ui/UiTypes';
+export * from './domain/language/LanguageTypes';
+export * from './domain/language/LanguageConstants';
+export * from './domain/cssvariable/CssVariableConstants';
+export * from './domain/diff/DiffTypes';
+export * from './domain/diff/DiffConstants';
 export { DndComponent, ScrollbarContainer };
 export default GraphContainer;