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

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';
@@ -44,6 +44,7 @@ export interface StateProps {
     graphCommitDescDisplayMode?: GraphCommitDescDisplayMode;
     graphRows: GraphRow[];
     hasMoreCommits?: boolean;
+    hasMoreSearchResults?: boolean;
     highlightedShas?: HighlightedShas;
     excludeByType?: ExcludeByType;
     excludeRefsById?: ExcludeRefsById;
@@ -282,6 +283,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 +303,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/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/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;