@gitkraken/gitkraken-components 1.0.0-rc.2 → 1.0.0-rc.20

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

@@ -13,11 +13,20 @@ import {
 export type Sha = string;
 export type CssVariables = {[variable: string]: string};
 export type IsSelectedBySha = {[sha: Sha]: boolean};
+export type HighlightedShas = {[sha: Sha]: boolean};
 
 export type WorkDirType = typeof mergeConflictNodeType
   | typeof unsupportedRebaseWarningNodeType
   | typeof workDirType;
 
+export type WorkDirStats = {
+  added: number,
+  deleted: number,
+  modified: number
+  // TODO: Add renamed once available in GitLens from provider
+  // renamed: number
+};
+
 export type CommitType = typeof commitNodeType
   | typeof mergeNodeType
   | typeof mergeConflictNodeType
@@ -34,20 +43,43 @@ export type GraphPlatform = 'aix'
   | 'win32'
   | 'cygwin';
 
+export type RowContexts = {
+  row?: string;
+  ref?: string;
+  graph?: string;
+  avatar?: string;
+  message?: string;
+  author?: string;
+  date?: string;
+  sha?: string;
+};
+
+export type GraphContexts = {
+  graph?: string;
+  header?: string;
+};
+
 export type Head = {
+  id?: string,
   name: string;
   isCurrentHead?: boolean;
+  context?: string;
 };
 
 export type Remote = {
+  id?: string,
   name: string;
+  owner?: string;
   avatarUrl?: string;
   url?: string;
+  context?: string;
 };
 
 export type Tag = {
+  id?: string,
   name: string;
   annotated?: boolean;
+  context?: string;
 };
 
 export type GraphRow = {
@@ -61,20 +93,22 @@ export type GraphRow = {
   heads?: Head[];
   remotes?: Remote[];
   tags?: Tag[];
-  avatarUrl?: string;
+  contexts?: RowContexts;
 };
 
 export type GraphColumnSetting = {
   width: number,
-  preferredWidth?: number
+  isHidden: boolean
 };
 
-export const REF_ZONE_TYPE = 'refZone';
-export const GRAPH_ZONE_TYPE = 'commitZone';
-export const MESSAGE_ZONE_TYPE = 'commitMessageZone';
-export const AUTHOR_ZONE_TYPE = 'commitAuthorZone';
-export const DATE_TIME_ZONE_TYPE = 'commitDateTimeZone';
-export const SHA_ZONE_TYPE = 'commitShaZone';
+export type AvatarUrlByEmail = { [email: string]: string };
+
+export const REF_ZONE_TYPE = 'ref';
+export const GRAPH_ZONE_TYPE = 'graph';
+export const MESSAGE_ZONE_TYPE = 'message';
+export const AUTHOR_ZONE_TYPE = 'author';
+export const DATE_TIME_ZONE_TYPE = 'datetime';
+export const SHA_ZONE_TYPE = 'sha';
 
 export type GraphZoneType = typeof REF_ZONE_TYPE
   | typeof GRAPH_ZONE_TYPE
@@ -94,8 +128,48 @@ export type GraphRef = Head
 
 export type GraphRefGroup = Array<GraphRef>;
 
+export type RefMetadataById = { [id: string]: RefMetadata | null | undefined };
+export type RefMetadata = {
+  pullRequests?: PullRequestMetadata[];
+};
+
+export type PullRequestMetadata = {
+  hostingServiceType: HostingServiceType;
+  id: number;
+  title: string;
+  author?: string;
+  date?: number;
+  state?: string;
+  url?: string;
+  context?: string;
+};
+
+// Hosting service types for pull request metadata
+export const gitHubDotComHostingServiceType = 'github';
+export const githubEnterpriseHostingServiceType = 'githubEnterprise';
+export const gitLabHostingServiceType = 'gitlab';
+export const gitLabSelfHostingServiceType = 'gitlabSelfHosted';
+export const azureDevopsHostingServiceType = 'azureDevops';
+export const bitBucketHostingServiceType = 'bitbucket';
+export const bitBucketServerHostingServiceType = 'bitbucketServer';
+export type HostingServiceType =
+  typeof GitHubDotComHostingServiceType |
+  typeof GithubEnterpriseHostingServiceType |
+  typeof BitBucketHostingServiceType |
+  typeof BitBucketServerHostingServiceType |
+  typeof GitLabHostingServiceType |
+  typeof GitLabSelfHostingServiceType |
+  typeof AzureDevopsHostingServiceType;
+
+export type RefsMissingMetadata = {
+  [refId: string]: MissingRefMetadataType[]
+}
+export const missingPullRequestMetadataType = 'pullRequests';
+// Expand this as we add more types to RefMetadata
+export type MissingRefMetadataType = typeof missingPullRequestMetadataType;
+
 // Callbacks
-export type GetExternalIcon = (key: string) => ReactElement<*>;
+export type GetExternalIcon = (key: string) => React.ReactElement<any>;
 export type TranslationFn = (key: string, ...formatArgs: any) => string;
 export type OnFormatCommitDateTime = (commitDateTime: number) => string;
 
@@ -113,17 +187,24 @@ export type OnGraphRefNodeHovered = (event: any, refGroup: GraphRefGroup, graphR
 export type OnGraphRefNodeUnhovered = (event: any, refGroup: GraphRefGroup, graphRow: GraphRow) => void;
 export type OnGraphColumnResized = (graphZoneType: GraphZoneType, columnSettings: GraphColumnSetting) => void;
 export type OnShowMoreCommits = () => void;
+export type OnEmailsMissingAvatarUrls = (emails: { [email: string]: string }) => void;
+export type OnRefsMissingMetadata = (refs: RefsMissingMetadata) => void;
 
 // Main graph component
 export interface GraphContainerProps {
+  avatarUrlByEmail?: AvatarUrlByEmail;
+  contexts?: GraphContexts;
   height?: number;
   width?: number;
   platform?: GraphPlatform;
   cssVariables?: CssVariables;
   getExternalIcon: GetExternalIcon;
+  highlightRowsOnRefHover?: boolean,
+  showGhostRefsOnRowHover?: boolean,
   enableMultiSelection?: boolean,
   graphRows: GraphRow[];
   hasMoreCommits?: boolean;
+  highlightedShas?: HighlightedShas;
   // isCommitting: boolean;
   isSelectedBySha?: IsSelectedBySha;
   // isInUnsupportedRebase: boolean;
@@ -132,10 +213,11 @@ export interface GraphContainerProps {
   // pendingCommitMessageSummary: string;
   // repoPath: string;
   columnsSettings?: GraphColumnsSettings;
+  refMetadataById?: RefMetadataById;
   themeOpacityFactor?: number;
   translate?: TranslationFn;
   useAuthorInitialsForAvatars?: boolean;
-  // workDirStats: WorkDirStats;
+  workDirStats?: WorkDirStats;
   onRowContextMenu?: OnRowContextMenu;
   onRefContextMenu?: OnRefContextMenu;
   onGraphRowHovered?: OnGraphRowHovered;
@@ -154,6 +236,8 @@ export interface GraphContainerProps {
   onShowMoreCommits?: OnShowMoreCommits;
   // onWipNodeInputWillUnmount: OnComponentWillUnmount;
   // onUpdateGraphWidth: OnUpdateGraphWidth;
+  onEmailsMissingAvatarUrls?: OnEmailsMissingAvatarUrls;
+  onRefsMissingMetadata?: OnRefsMissingMetadata;
   formatCommitDateTime?: OnFormatCommitDateTime;
   shaLength?: number;
   nonce?: string;
@@ -173,6 +257,7 @@ declare class GraphContainer extends React.PureComponent<GraphContainerProps, an
   ): void;
   forceUpdate(callback?: () => void): void;
   render(): JSX.Element;
+  selectCommits(shas: Sha[], includeToPrevSel: boolean): void;
 }
 
 export default GraphContainer;