@gitkraken/gitkraken-components 13.0.0-vnext.35 → 13.0.0-vnext.38

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, ExcludeByType, ExcludeRefsById, ExcludeRemotesByName, FormatCommitMessage, FormatRefShorthand, GetExternalIcon, GetMissingAvatar, GetMissingRefMetadata, GraphColumnSetting, GraphColumnsSettings, GraphContexts, GraphMarkerColors, GraphMarkerRowIndices, GraphPlatform, GraphRefGroup, GraphRow, GraphScope, GraphZoneModeConstants, GraphZonesByType, Head, HighlightedShas, IncludeOnlyRefsById, IncludeOnlyRemotesByName, InteractiveScrollMarker, IsRefShorthandValid, IsSelectedBySha, NodeOffsetByColumn, NodeOpacityByColumn, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnClickGraphRef, OnClickGraphRow, OnClickRef, OnColumnsCalculated, 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, RowStats, RowStatsConstraints, ShaByRefId, Tag, TopAndBottomVisibleRowIndex } from '../../domain/graph/GraphTypes';
+import type { AbsoluteNodeLeftByColumn, AvatarUrlByEmail, AvatarUrlRequestedByEmail, ChildrenBySha, ColumnColorByColumn, DownstreamsByUpstream, ExcludeByType, ExcludeRefsById, ExcludeRemotesByName, FormatCommitMessage, FormatRefShorthand, GetExternalIcon, GetMissingAvatar, GetMissingRefMetadata, GraphColumnSetting, GraphColumnsSettings, GraphContexts, GraphMarkerColors, GraphMarkerRowIndices, GraphPlatform, GraphRefGroup, GraphRow, GraphScope, GraphZoneModeConstants, GraphZonesByType, Head, HighlightedShas, IncludeOnlyRefsById, IncludeOnlyRemotesByName, InteractiveScrollMarker, IsRefShorthandValid, IsSelectedBySha, NodeOffsetByColumn, NodeOpacityByColumn, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnClickGraphRef, OnClickGraphRow, OnClickRef, OnColumnsCalculated, 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, RowStats, RowStatsConstraints, ShaByEmail, ShaByRefId, Tag, TopAndBottomVisibleRowIndex } from '../../domain/graph/GraphTypes';
 import type { RowAdornmentProvider } from '../../domain/graph/rowAdornment/RowAdornmentTypes';
 import type { TranslationFn } from '../../domain/language/LanguageTypes';
 import type { CreateRefFormData, RefIconsPosition } from '../../domain/ref/RefTypes';
@@ -292,7 +292,7 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     graphZoneOrdering: GraphZoneType[];
     clientHeight: number;
     missingAvatarsTimer?: ReturnType<typeof setTimeout>;
-    pendingMissingAvatars: AvatarUrlByEmail;
+    pendingMissingAvatars: ShaByEmail;
     requestedMissingAvatars: AvatarUrlRequestedByEmail;
     missingRefsMetadataTimer?: ReturnType<typeof setTimeout>;
     pendingMissingRefsMetadata: RefsMissingMetadata;

package/dist/components/graph/commitzone/CommitNode.d.ts

@@ -2,13 +2,13 @@ import type { ReactElement } from 'react';
 import * as React from 'react';
 import type { CommitType } from '../../../domain/commit/CommitTypes';
 import type { CssVariables } from '../../../domain/generic/GenericTypes';
-import type { GetExternalIcon, GraphItemContext, GraphZoneModeConstants } from '../../../domain/graph/GraphTypes';
+import type { AvatarUrlSpec, GetExternalIcon, GraphItemContext, GraphZoneModeConstants } from '../../../domain/graph/GraphTypes';
 import type { TranslationFn } from '../../../domain/language/LanguageTypes';
 type Props = {
     authorEmail: string;
     authorInitials: string;
     authorName: string;
-    avatarUrl?: string | null;
+    avatarUrl?: AvatarUrlSpec | null;
     column: number;
     context?: GraphItemContext | null;
     cssVariables: CssVariables;

package/dist/components/graph/commitzone/CommitZone.d.ts

@@ -2,13 +2,13 @@ import type { ReactElement } from 'react';
 import * as React from 'react';
 import type { CommitType, Sha } from '../../../domain/commit/CommitTypes';
 import type { CssVariables, Style } from '../../../domain/generic/GenericTypes';
-import type { ColumnColorByColumn, GetExternalIcon, GraphItemContext, GraphZoneModeConstants, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnCommitContextMenu, OnCurrentlyHoveredGraphCommit, OnDoubleClickCommit, RowEdges, ScopeBoundaryKind } from '../../../domain/graph/GraphTypes';
+import type { AvatarUrlSpec, ColumnColorByColumn, GetExternalIcon, GraphItemContext, GraphZoneModeConstants, OnClearCurrentlyHoveredGraphCommit, OnClickCommit, OnCommitContextMenu, OnCurrentlyHoveredGraphCommit, OnDoubleClickCommit, RowEdges, ScopeBoundaryKind } from '../../../domain/graph/GraphTypes';
 import type { TranslationFn } from '../../../domain/language/LanguageTypes';
 type Props = {
     authorEmail: string;
     authorName: string;
     avatarContext?: GraphItemContext;
-    avatarUrl?: string;
+    avatarUrl?: AvatarUrlSpec;
     clearCurrentlyHoveredGraphCommit: OnClearCurrentlyHoveredGraphCommit;
     column: number;
     columnColorByColumn: ColumnColorByColumn;

package/dist/components/graph/commitzone/GraphAvatar.d.ts

@@ -1,11 +1,11 @@
 import type { ReactElement } from 'react';
 import * as React from 'react';
 import type { CssVariables, Style } from '../../../domain/generic/GenericTypes';
-import type { GraphItemContext } from '../../../domain/graph/GraphTypes';
+import type { AvatarUrlSpec, GraphItemContext } from '../../../domain/graph/GraphTypes';
 import type { ComponentTooltip } from '../../../domain/ui/UiTypes';
 type Props = {
     authorInitials?: string;
-    avatarUrl?: string | null;
+    avatarUrl?: AvatarUrlSpec | null;
     className?: string;
     column?: number;
     context?: GraphItemContext | null;

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

@@ -46,6 +46,7 @@ declare class RowAdornmentLayer extends React.Component<RowAdornmentLayerProps,
     private applyProvideResults;
     private evictDistantAdornments;
     private shouldShowAdornment;
+    private stateKey;
     private getOrResolveContent;
     render(): React.ReactNode;
 }

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

@@ -1,6 +1,6 @@
 import type { CSSProperties, ReactElement, ReactNode } from 'react';
 import * as React from 'react';
-import type { GraphItemContext } from '../../../domain/graph/GraphTypes';
+import type { AvatarUrlSpec, GraphItemContext } from '../../../domain/graph/GraphTypes';
 type DataURLBase64 = string;
 type Props = {
     avatarClassName?: string;
@@ -13,7 +13,7 @@ type Props = {
     height?: number;
     hint?: string;
     size: number;
-    url?: string;
+    url?: AvatarUrlSpec;
     width?: number;
 };
 type State = {
@@ -22,11 +22,13 @@ type State = {
 declare class Avatar extends React.Component<Props, State> {
     private image;
     constructor(props: Props);
+    static resolveUrl(spec: AvatarUrlSpec | undefined): string | undefined;
     static getDerivedStateFromProps(props: Props, state: State): State;
     componentDidMount(): void;
     componentDidUpdate(prevProps: Props): void;
     componentWillUnmount(): void;
     private refreshImage;
+    private onImageError;
     startImgLoading(url: string): void;
     render(): ReactElement<any>;
 }

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

@@ -460,12 +460,20 @@ export interface InteractiveScrollMarker {
     label: string;
 }
 export type OnScrollMarkerClicked = (sha: Sha, rowIndex: number, type: GraphMarkerType) => void;
+export type OnAvatarUrlError = (url: string, error: unknown) => void;
+export type AvatarUrlSpec = string | {
+    url: string;
+    onError?: OnAvatarUrlError;
+};
 export type AvatarUrlByEmail = {
-    [email: string]: string;
+    [email: string]: AvatarUrlSpec;
 };
 export type AvatarUrlRequestedByEmail = {
     [email: string]: boolean;
 };
+export type ShaByEmail = {
+    [email: string]: string;
+};
 export type DownstreamsByUpstream = {
     [upstreamName: string]: string[];
 };
@@ -555,7 +563,7 @@ export type OnGraphRefNodeUnhovered = (event: React.MouseEvent<any> | React.Focu
 export type OnGraphColumnsReOrdered = (columnsSettings: GraphColumnsSettings) => void;
 export type OnGraphColumnResized = (graphZoneType: GraphZoneType, columnSettings: GraphColumnSetting) => void;
 export type OnShowMoreCommits = () => void;
-export type OnEmailsMissingAvatarUrls = (emails: AvatarUrlByEmail) => void;
+export type OnEmailsMissingAvatarUrls = (emails: ShaByEmail) => void;
 export type OnRefsMissingMetadata = (refs: RefsMissingMetadata) => void;
 /**
  * Callback invoked when column numbers are calculated for each commit.

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

@@ -7,6 +7,15 @@ import type { ReadonlyGraphRow } from '../GraphTypes';
  * - Array of triggers = visible when ANY of the specified triggers are active
  */
 export type AdornmentVisibility = true | readonly ('hover' | 'focus' | 'selected')[];
+/**
+ * Live interaction state for a row, passed to resolveAdornment so the adornment
+ * content can vary by state (e.g. compact at rest, expanded on hover).
+ */
+export interface AdornmentState {
+    isHovered: boolean;
+    isFocused: boolean;
+    isSelected: boolean;
+}
 /**
  * Adornment configuration returned from provideAdornments for each row.
  * @template TContext - Type of context data passed from provide to resolve
@@ -20,11 +29,13 @@ export interface RowAdornment<TContext = unknown> {
      */
     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)
+     * Controls when resolve() is re-called:
+     * - false (default): content is cached until invalidated
+     * - true: resolve() is called on every render (content not cached)
+     * - 'interaction': resolve() is re-called when the row's hover/focus/selected state changes
+     *   (content cached per interaction state). Use for adornments whose UI varies by state.
      */
-    dynamic?: boolean;
+    dynamic?: boolean | 'interaction';
 }
 /**
  * Invalidation level
@@ -76,9 +87,10 @@ export interface RowAdornmentProvider<TContext = unknown> {
      *
      * @param row - The row to render adornment for
      * @param context - Context data from provideAdornments (if any)
+     * @param state - Current interaction state (hover/focus/selected) of the row, when available
      * @returns Content to render, or null/Promise for no/pending content
      */
-    resolveAdornment(row: ReadonlyGraphRow, context?: TContext): ReactNode | null | Promise<ReactNode | null>;
+    resolveAdornment(row: ReadonlyGraphRow, context?: TContext, state?: AdornmentState): ReactNode | null | Promise<ReactNode | null>;
     /**
      * EventTarget for invalidation.
      * - Graph subscribes to 'invalidate' events
@@ -91,7 +103,8 @@ export interface RowAdornmentProvider<TContext = unknown> {
  */
 export interface CachedAdornment {
     visibility: AdornmentVisibility;
-    dynamic: boolean;
+    dynamic: boolean | 'interaction';
     context?: unknown;
     content?: ReactNode;
+    contentStateKey?: string;
 }