@gitkraken/gitkraken-components 13.0.0-vnext.0 → 13.0.0-vnext.10

package/CHANGELOG.md

@@ -1,15 +1,18 @@
 # CHANGELOG
 
 ## 11.0.2
- - Fixed an issue with ref labels sometimes not rendering properly when hovered/unhovered. ([#367](https://github.com/gitkraken/GitKrakenComponents/pull/367))
- - Added some data-test-classes for automated UI tests to find DOM nodes. ([#369](https://github.com/gitkraken/GitKrakenComponents/pull/369))
+
+- Fixed an issue with ref labels sometimes not rendering properly when hovered/unhovered. ([#367](https://github.com/gitkraken/GitKrakenComponents/pull/367))
+- Added some data-test-classes for automated UI tests to find DOM nodes. ([#369](https://github.com/gitkraken/GitKrakenComponents/pull/369))
 
 ## 11.0.1
- - Fixed tooltip css so that tooltips on the commit notes and ref label icons are no longer 0 opacity. (CSS classes were modified by previous `react-bootstrap` bump.) ([#366](https://github.com/gitkraken/GitKrakenComponents/pull/366))
+
+- Fixed tooltip css so that tooltips on the commit notes and ref label icons are no longer 0 opacity. (CSS classes were modified by previous `react-bootstrap` bump.) ([#366](https://github.com/gitkraken/GitKrakenComponents/pull/366))
 
 ## 11.0.0
- - **BREAKING CHANGE:** Upgraded from `react`/`react-dom` 16 to 17. ([#365](https://github.com/gitkraken/GitKrakenComponents/pull/365))
- - **BREAKING CHANGE:** Upgraded `react-bootstrap` from 0.32.4 to 2.10.7 ([#365](https://github.com/gitkraken/GitKrakenComponents/pull/365))
-   - The full consequences of this on your project's CSS cannot be fully predicted, so you should test thoroughly. Known concerns which affected at least one project are listed below.
-   - The DIV wrapping the ref-creation text input no longer receives the `has-error` class, and the input no longer receives the `is-valid` class. Instead, the input receives the `is-invalid` class.
- - Added `AzureDevopsIssueTrackerType` (in addition to the existing `AzureDevopsIssueTrackerType`) ([262cbf8e](https://github.com/gitkraken/GitKrakenComponents/commit/262cbf8e81c8497676e93fde0d32fdf537fec706))
+
+- **BREAKING CHANGE:** Upgraded from `react`/`react-dom` 16 to 17. ([#365](https://github.com/gitkraken/GitKrakenComponents/pull/365))
+- **BREAKING CHANGE:** Upgraded `react-bootstrap` from 0.32.4 to 2.10.7 ([#365](https://github.com/gitkraken/GitKrakenComponents/pull/365))
+  - The full consequences of this on your project's CSS cannot be fully predicted, so you should test thoroughly. Known concerns which affected at least one project are listed below.
+  - The DIV wrapping the ref-creation text input no longer receives the `has-error` class, and the input no longer receives the `is-valid` class. Instead, the input receives the `is-invalid` class.
+- Added `AzureDevopsIssueTrackerType` (in addition to the existing `AzureDevopsIssueTrackerType`) ([262cbf8e](https://github.com/gitkraken/GitKrakenComponents/commit/262cbf8e81c8497676e93fde0d32fdf537fec706))

package/README.md

@@ -3,10 +3,12 @@
 This is a shared module between the GitKraken app and GitLens to share React components.
 
 ## Requires resolution to React 17
+
 > [!WARNING]
 > In order for this package to work properly, you must resolve React to version 17 in your own project.
 > The reason for this is because this library's react-bootstrap dependency lists React 16 as a dependency, and npm/yarn 1 do not provide a way for dependencies to lock sub-dependencies. Therefore it is up to your project to force this library's react-bootstrap to use react 17.
 > The following is an example of what to put into your package.json:
+
 ```
   "resolutions": {
     "react": "17.0.2",

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { Alignment, ScrollParams } from 'react-virtualized';
 import type { ReactElement } from 'react';
 import React from 'react';
@@ -173,7 +172,8 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     isRefContextMenuShown: boolean;
     isMounted: boolean;
     selectedShas: Set<Sha>;
-    lastFocusedSha?: Sha;
+    selectionAnchorSha?: Sha;
+    selectionFocusSha?: Sha;
     processedGraphRowBySha: ProcessedGraphRowBySha;
     shaByRefId: ShaByRefId;
     childrenBySha: ChildrenBySha;
@@ -247,7 +247,21 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     onRefDrop: OnRefDrop;
     onRefEndDrag: OnRefEndDrag;
     onZoneRowClick(event: React.MouseEvent<any>, graphZoneType: GraphZoneType, sha: Sha): void;
-    getShiftSelectRange(currentSha: Sha): Sha[];
+    getShiftSelectRange(currentSha: Sha, shiftSelectMode: ShiftSelectMode): Sha[] | undefined;
+    private getTopologicalPathBetween;
+    private getDirectTopologicalPathBetween;
+    /**
+     * Finds the nearest commit that is topologically reachable from the anchor commit.
+     * Searches in the appropriate direction based on whether the anchor is ahead or behind the target.
+     * This is used as a fallback when the clicked commit is not directly topologically reachable.
+     */
+    private findNearestTopologicallyReachableCommit;
+    /**
+     * Validates that a path has only 2 endpoints - the start and end commits.
+     * An endpoint is a commit that has no children or parents within the selected path
+     * (excluding the explicit start and end points).
+     */
+    private hasOnlyTwoEndpoints;
     onClickRef: OnClickRef;
     onClickCommit: OnClickCommit;
     onDoubleClickCommit: OnDoubleClickCommit;
@@ -269,6 +283,15 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     onScrollToRowCausedUpdateForFirstColumn: OnScrollForZone;
     onCommitContextMenu: OnCommitContextMenu;
     onRefContextMenu: OnRefZoneContextMenu;
+    /**
+     * Check if an object has any keys (more efficient than Object.keys().length > 0)
+     */
+    private hasAnyKey;
+    /**
+     * Deep equality check for isSelectedBySha objects to avoid unnecessary scroll-to-selection
+     * when object reference changes but content is the same (e.g., after postMessage serialization)
+     */
+    private isSelectedByShaEqual;
     selectCommits(shas: Sha[], includeToPrevSel: boolean, isAutoOrKeyScroll: boolean): void;
     getCommitZoneContentWidthBetweenGutters(): number;
     getSelectedShas(): Sha[];
@@ -367,7 +390,7 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     isMacOSPlatform(): boolean;
     isCommitListFiltered(): boolean;
     getGraphColumnSettingFromZoneType(graphZone: GraphZone): GraphColumnSetting;
-    decorateWithHelmet: (container: ReactElement<'div'>, cssVariables: CssVariables, nonce?: string) => React.JSX.Element;
+    decorateWithHelmet: (container: ReactElement<"div">, cssVariables: CssVariables, nonce?: string) => React.JSX.Element;
     render(): React.JSX.Element;
 }
 export default GraphContainer;

package/dist/components/graph/refzone/RefPopover.d.ts

@@ -1,4 +1,4 @@
-import type { ReactElement, ReactNode } from 'react';
+import type { ReactElement, ReactNode, RefObject } from 'react';
 import type { OnMouseEnter, OnMouseLeave } from '../../../domain/ui/UiTypes';
 type RefPopoverStyle = {
     top: number;
@@ -10,6 +10,7 @@ type Props = {
     onMouseEnter?: OnMouseEnter;
     onMouseLeave?: OnMouseLeave;
     style?: RefPopoverStyle;
+    ref?: RefObject<HTMLDivElement>;
 };
-declare function RefPopover({ style, children, column, numGraphColumns, onMouseEnter, onMouseLeave, ...props }: Props): ReactElement<'div'>;
+declare function RefPopover({ style, children, column, numGraphColumns, onMouseEnter, onMouseLeave, ref, ...props }: Props): ReactElement<'div'>;
 export default RefPopover;

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { HandleStyles, ResizeCallback, ResizeStartCallback } from 're-resizable';
 import type { ReactElement, ReactNode } from 'react';
 import React from 'react';

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

@@ -154,5 +154,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

@@ -6,7 +6,7 @@ import type { GraphRefType } from '../ref/RefTypes';
 import type { WorkDirStats } from '../workdir/WorkDirTypes';
 import type { GraphMarkerType, GraphZone, GraphZoneType, TimelineEntriesByPeriod } 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;
@@ -53,7 +53,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 {

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

@@ -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;
 };
@@ -396,7 +396,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;

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/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,20 @@ 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/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;