@gitkraken/gitkraken-components 13.0.0-vnext.15 → 13.0.0-vnext.17

package/dist/components/graph/GraphColumn.d.ts

@@ -1,7 +1,7 @@
 import type { Alignment, GridCellRangeRenderer } from 'react-virtualized';
 import type { ReactElement } from 'react';
 import type { GraphMarkerType, GraphZone, GraphZoneType } from '../../domain/graph/GraphConstants';
-import type { ColumnContentGenerator, GetExternalIcon, GraphMarkerColors, GraphMarkerRowIndices, OnGraphZoneResize, OnGraphZoneResizeEnd, OnGraphZoneResizeFromPropChange, OnScrollForZone, RowRenderersByIds } from '../../domain/graph/GraphTypes';
+import type { ColumnContentGenerator, GetExternalIcon, GraphMarkerColors, GraphMarkerRowIndices, OnGraphZoneResize, OnGraphZoneResizeEnd, OnGraphZoneResizeFromPropChange, OnScrollForZone, ProcessedGraphRow, RowRenderersByIds } from '../../domain/graph/GraphTypes';
 import type { TranslationFn } from '../../domain/language/LanguageTypes';
 import type { GetRealKeyForCellFunc } from '../../domain/reactvirtualized/ReactVirtualizedHelpers';
 import type { OnMouseEnter } from '../../domain/ui/UiTypes';
@@ -32,13 +32,15 @@ type GraphColumnProps = {
     onScrollToRowCausedUpdate?: OnScrollForZone;
     onZoneEnter: OnMouseEnter;
     cellRenderersByIds: RowRenderersByIds;
+    processedRows?: ProcessedGraphRow[];
     scrollToAlignment?: Alignment;
     scrollToIndex?: number;
     scrollLeft: number;
     scrollTop: number;
     smartCellRangeRenderer: GridCellRangeRenderer;
+    stickyTimeline?: boolean;
     translate: TranslationFn;
     verticalScrollWidth: number;
 };
-export declare function GraphColumn({ branchUpstreamRowIndices, rowCount, cellRenderersByIds, columnIndex, customFooterRow, enabledScrollMarkerTypes, enableResizer, getExternalIcon, getKeyForCell, graphHeight, graphWidth, graphZoneType, graphZones, hasMoreCommits, horizontalScrollHeight, isCommitListFiltered, isLoadingRows, markerColors, markerRowIndices, onResize, onResizeEnd, onResizeFromPropChange, onScroll, onScrollToRowCausedUpdate, onZoneEnter, scrollLeft, scrollToAlignment, scrollToIndex, scrollTop, smartCellRangeRenderer, translate, verticalScrollWidth, }: GraphColumnProps): ReactElement<any> | null;
+export declare function GraphColumn({ branchUpstreamRowIndices, rowCount, cellRenderersByIds, columnIndex, customFooterRow, enabledScrollMarkerTypes, enableResizer, getExternalIcon, getKeyForCell, graphHeight, graphWidth, graphZoneType, graphZones, hasMoreCommits, horizontalScrollHeight, isCommitListFiltered, isLoadingRows, markerColors, markerRowIndices, onResize, onResizeEnd, onResizeFromPropChange, onScroll, onScrollToRowCausedUpdate, onZoneEnter, processedRows, scrollLeft, scrollToAlignment, scrollToIndex, scrollTop, smartCellRangeRenderer, stickyTimeline, translate, verticalScrollWidth, }: GraphColumnProps): ReactElement<any> | null;
 export {};

package/dist/components/graph/GraphContainer.d.ts

@@ -5,7 +5,7 @@ import type { Sha } from '../../domain/commit/CommitTypes';
 import type { CssVariables } from '../../domain/generic/GenericTypes';
 import type { GraphCommitDescDisplayMode, GraphMarkerType, GraphSearchMode, GraphZone, GraphZoneType, ShiftSelectMode } from '../../domain/graph/GraphConstants';
 import type { ThrottledFn } from '../../domain/graph/GraphHelpers';
-import type { AbsoluteNodeLeftByColumn, AvatarUrlByEmail, AvatarUrlRequestedByEmail, ChildrenBySha, ColumnColorByColumn, DownstreamsByUpstream, EdgeByColumn, ExcludeByType, ExcludeRefsById, ExcludeRemotesByName, FormatCommitMessage, FormatRefShorthand, GetExternalIcon, GetMissingAvatar, GetMissingRefMetadata, GraphColumnSetting, GraphColumnsSettings, GraphContexts, GraphMarkerColors, GraphMarkerRowIndices, GraphPlatform, GraphRefGroup, GraphRow, GraphZoneModeConstants, GraphZonesByType, Head, HighlightedShas, IncludeOnlyRefsById, IncludeOnlyRemotesByName, IsRefShorthandValid, IsSelectedBySha, NodeOffsetByColumn, NodeOpacityByColumn, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnClickGraphRef, OnClickGraphRow, OnClickRef, OnCommitContextMenu, OnCommitMessageChange, OnCurrentlyHoveredGraphCommit, OnDoubleClickCommit, OnDoubleClickGraphRef, OnDoubleClickGraphRow, OnDoubleClickRef, OnEmailsMissingAvatarUrls, OnFilterColumnClick, OnFormatCommitDateTime, OnGraphColumnReOrdered, OnGraphColumnResized, OnGraphColumnsReOrdered, OnGraphMouseEnter, OnGraphMouseLeave, OnGraphRefNodeHovered, OnGraphRefNodeUnhovered, OnGraphResized, OnGraphRowHovered, OnGraphRowUnhovered, OnGraphScrollForZone, OnGraphVisibleRowsChanged, OnGraphZoneResize, OnGraphZoneResizeEnd, OnLoadSelectedGraphRow, OnPopupGraphHeaderContextMenu, OnRefBeginDrag, OnRefCanDrag, OnRefCanDrop, OnRefContextMenu, OnRefCreate, OnRefCreateCancel, OnRefCreateContextMenu, OnRefDragEnter, OnRefDragLeave, OnRefDrop, OnRefEndDrag, OnRefNodeHovered, OnRefNodeUnhovered, OnRefShorthandChange, OnRefsMissingMetadata, OnRefZoneContextMenu, OnRefZoneHovered, OnRefZoneUnhovered, OnRowContextMenu, OnScrollForZone, OnSelectGraphRows, OnSettingsClick, OnShowMoreCommits, OnToggleRefNodesShown, OnToggleRefsVisibilityClick, OnWipMessageBlur, OnWipMessageFocus, ProcessedGraphRow, ProcessedGraphRowBySha, RefMetadataById, RefMetadataRequestedById, RefMetadataType, RefsMissingMetadata, Remote, ReserverInfoBySha, RowEdges, RowStats, RowStatsConstraints, ShaByRefId, Tag, TopAndBottomVisibleRowIndex } from '../../domain/graph/GraphTypes';
+import type { AbsoluteNodeLeftByColumn, AvatarUrlByEmail, AvatarUrlRequestedByEmail, ChildrenBySha, ColumnColorByColumn, DownstreamsByUpstream, EdgeByColumn, ExcludeByType, ExcludeRefsById, ExcludeRemotesByName, FormatCommitMessage, FormatRefShorthand, GetExternalIcon, GetMissingAvatar, GetMissingRefMetadata, GraphColumnSetting, GraphColumnsSettings, GraphContexts, GraphMarkerColors, GraphMarkerRowIndices, GraphPlatform, GraphRefGroup, GraphRow, GraphZoneModeConstants, GraphZonesByType, Head, HighlightedShas, IncludeOnlyRefsById, IncludeOnlyRemotesByName, IsRefShorthandValid, IsSelectedBySha, NodeOffsetByColumn, NodeOpacityByColumn, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnClickGraphRef, OnClickGraphRow, OnClickRef, OnCommitContextMenu, OnCommitMessageChange, OnCurrentlyHoveredGraphCommit, OnDoubleClickCommit, OnDoubleClickGraphRef, OnDoubleClickGraphRow, OnDoubleClickRef, OnEmailsMissingAvatarUrls, OnFilterColumnClick, OnFormatCommitDateTime, OnGraphColumnReOrdered, OnGraphColumnResized, OnGraphColumnsReOrdered, OnGraphMouseEnter, OnGraphMouseLeave, OnGraphRefNodeHovered, OnGraphRefNodeUnhovered, OnGraphResized, OnGraphRowHovered, OnGraphRowUnhovered, OnGraphScrollForZone, OnGraphVisibleRowsChanged, OnGraphZoneResize, OnGraphZoneResizeEnd, OnLoadSelectedGraphRow, OnPopupGraphHeaderContextMenu, OnRefBeginDrag, OnRefCanDrag, OnRefCanDrop, OnRefContextMenu, OnRefCreate, OnRefCreateCancel, OnRefCreateContextMenu, OnRefDragEnter, OnRefDragLeave, OnRefDrop, OnRefEndDrag, OnRefNodeHovered, OnRefNodeUnhovered, OnRefShorthandChange, OnRefsMissingMetadata, OnRefZoneContextMenu, OnRefZoneHovered, OnRefZoneUnhovered, OnRowContextMenu, OnScrollForZone, OnSelectGraphRows, OnSettingsClick, OnShowMoreCommits, OnToggleRefNodesShown, OnToggleRefsVisibilityClick, OnWipMessageBlur, OnWipMessageFocus, ProcessedGraphRow, ProcessedGraphRowBySha, ReadonlyGraphRow, RefMetadataById, RefMetadataRequestedById, RefMetadataType, RefsMissingMetadata, Remote, ReserverInfoBySha, RowEdges, RowStats, RowStatsConstraints, ShaByRefId, Tag, TopAndBottomVisibleRowIndex } from '../../domain/graph/GraphTypes';
 import type { TranslationFn } from '../../domain/language/LanguageTypes';
 import type { CreateRefFormData, RefIconsPosition } from '../../domain/ref/RefTypes';
 import type { OnBlur, OnKeyDown, OnKeyUp, OnMouseDown, OnResizeParams } from '../../domain/ui/UiTypes';
@@ -41,9 +41,11 @@ export interface StateProps {
     enabledScrollMarkerTypes?: GraphMarkerType[];
     scrollRowPadding?: number;
     enableMultiSelection?: boolean;
+    stickyTimeline?: boolean;
     graphCommitDescDisplayMode?: GraphCommitDescDisplayMode;
     graphRows: GraphRow[];
     hasMoreCommits?: boolean;
+    hasMoreSearchResults?: boolean;
     highlightedShas?: HighlightedShas;
     excludeByType?: ExcludeByType;
     excludeRefsById?: ExcludeRefsById;
@@ -282,6 +284,13 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     onRefZoneUnhovered: OnRefZoneUnhovered;
     onShowMoreCommits: OnShowMoreCommits;
     onScrollForZone: OnScrollForZone;
+    /**
+     * Checks if there are still highlighted commits that haven't been found yet,
+     * OR if there are more search results available to load.
+     * Used in filter mode to determine if we should continue loading more commits.
+     * @returns true if there are unfound highlighted commits or more search results available, false otherwise
+     */
+    private hasUnfoundHighlightedCommits;
     loadMoreCommitsIfNecessary(graphHeight: number, hasMoreCommits: boolean): void;
     private shouldAutoLoadToFillViewport;
     private autoLoadToFillViewport;
@@ -295,7 +304,22 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     private isSelectedByShaEqual;
     private _pendingRowsUpdate;
     private _selectionVersion;
-    selectCommits(shas: Sha[], includeToPrevSel: boolean, isAutoOrKeyScroll: boolean): void;
+    /**
+     * Gets commits rows by SHA
+     *
+     * @param shas - Array of commit SHAs to get
+     * @returns Array of ReadonlyGraphRow objects
+     */
+    getCommits(shas: Sha[]): ReadonlyGraphRow[];
+    /**
+     * Selects commits in the graph
+     *
+     * @param shas - Array of commit SHAs to select
+     * @param includeToPrevSel - If true, toggle selection; if false, replace selection
+     * @param isAutoOrKeyScroll - Whether this is an auto-scroll or keyboard navigation
+     * @returns Array of selected ReadonlyGraphRow objects
+     */
+    selectCommits(shas: Sha[], includeToPrevSel: boolean, isAutoOrKeyScroll: boolean): ReadonlyGraphRow[];
     getCommitZoneContentWidthBetweenGutters(): number;
     getExcludeRemotesByName(): ExcludeRemotesByName;
     getIncludeOnlyRemotesByName(): IncludeOnlyRemotesByName;

package/dist/components/graph/common/StickyTimeline.d.ts

@@ -0,0 +1,10 @@
+import type { ReactElement } from 'react';
+import type { ProcessedGraphRow } from '../../../domain/graph/GraphTypes';
+import type { TranslationFn } from '../../../domain/language/LanguageTypes';
+interface StickyTimelineProps {
+    processedRows: ProcessedGraphRow[];
+    scrollTop: number;
+    translate: TranslationFn;
+}
+export declare function StickyTimeline({ processedRows, scrollTop, translate }: StickyTimelineProps): ReactElement | null;
+export {};

package/dist/components/graph/common/TimelineMessage.d.ts

@@ -0,0 +1,6 @@
+import type { ReactElement } from 'react';
+interface TimelineMessageProps {
+    message: string;
+}
+export declare function TimelineMessage({ message }: TimelineMessageProps): ReactElement;
+export {};

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

@@ -70,8 +70,20 @@ export declare const commitAuthorZone: CommitAuthorZoneType;
 export declare const commitDateTimeZone: CommitDateTimeZoneType;
 export declare const commitShaZone: CommitShaZoneType;
 export declare const changesZone: ChangesZoneType;
-/** A special sha used to indicate that the graph should be highlighted but there are no rows to highlight */
-export declare const noShaHighlightedSha = "no-sha-highlighted";
+/**
+ * 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",

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

@@ -4,7 +4,7 @@ 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, 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;
@@ -18,7 +18,22 @@ 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 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;
@@ -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

@@ -313,6 +313,14 @@ 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> {
+    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;
@@ -322,6 +330,8 @@ export interface ProcessedGraphRow extends GraphRow {
     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;
@@ -465,7 +475,7 @@ 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 type OnSelectGraphRows = (selectedRows: ReadonlyGraphRow[]) => 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;
@@ -476,3 +486,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

@@ -41,6 +41,7 @@ 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 initializeRefGroups;