@gitkraken/gitkraken-components 13.0.0-vnext.34 → 13.0.0-vnext.36

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/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;
 }