@gitkraken/gitkraken-components 13.0.0-vnext.26 → 13.0.0-vnext.28

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, ReadonlyGraphRow, 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, 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, RowEdges, RowStats, RowStatsConstraints, 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';
@@ -65,6 +65,12 @@ export interface StateProps {
     isInUnsupportedRebase?: boolean;
     isLoadingRows?: boolean;
     pendingCommitMessageSummary?: string;
+    /**
+     * Full name of the branch to pin to the left-most column (column 0).
+     * Example: "refs/heads/main" or "refs/remotes/origin/main"
+     * If null or undefined, no branch is pinned.
+     */
+    pinnedBranchFullName?: string | null;
     shiftSelectMode?: ShiftSelectMode;
     suppressNonRefRowTooltips?: boolean;
     refMetadataById?: RefMetadataById | null;
@@ -109,6 +115,12 @@ export interface DispatchProps {
     onGraphColumnsReOrdered?: OnGraphColumnsReOrdered;
     onFilterColumnClick?: OnFilterColumnClick;
     onColumnResized?: OnGraphColumnResized;
+    /**
+     * Callback invoked when column numbers are calculated for each commit.
+     * Receives a map of SHA → column number.
+     * Used to sync column layout data back to the parent application.
+     */
+    onColumnsCalculated?: OnColumnsCalculated;
     onFocusWipNodeInput?: OnWipMessageFocus;
     onMessageChange?: OnCommitMessageChange;
     onPopupGraphHeaderContextMenu?: OnPopupGraphHeaderContextMenu;
@@ -210,6 +222,7 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     private _autoLoadTimer?;
     reserverInfoBySha: ReserverInfoBySha;
     columnsUsed: ColumnsUsed;
+    private pinnedBranchShas;
     rowsStats?: Record<string, RowStats>;
     workDirStats: WorkDirStats;
     private _markerColorsCache;
@@ -453,7 +466,7 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     getEndingAndPassThroughEdgesByColumnFromPrevRow(graphRow: ProcessedGraphRow, prevRowEdges: RowEdges): RowEdges;
     getFinalEdgeStateForGraphAndRow(graphRow: ProcessedGraphRow, prevRowEdges: RowEdges): RowEdges;
     loadEdgesBySha(): void;
-    processRows(graphRows?: GraphRow[]): void;
+    processRows(graphRows?: GraphRow[], pinnedBranchFullName?: string | null): void;
     getStartingEdgesByColumn(currentRow: ProcessedGraphRow): EdgeByColumn;
     formatCommitDateTimeCallback: OnFormatCommitDateTime;
     formatCommitMessageCallback: FormatCommitMessage;
@@ -517,12 +530,11 @@ declare class GraphContainer extends React.Component<Props, ComponentState> impl
     selectLast(shiftKey?: boolean, shiftSelectMode?: ShiftSelectMode): void;
     selectPageUp(shiftKey?: boolean, shiftSelectMode?: ShiftSelectMode): void;
     selectPageDown(shiftKey?: boolean, shiftSelectMode?: ShiftSelectMode): void;
-    getAvailableColumnAndUseIt(): number;
     getColumns(graphRow: GraphRow): number;
     getFilteredHeadsForGraphRow(row: GraphRow, hasIncludes: boolean): Head[];
     getFilteredRemotesForGraphRow(row: GraphRow, hasIncludes: boolean): Remote[];
     getFilteredTagsForGraphRow(row: GraphRow, hasIncludes: boolean, rowHasVisibleChild: boolean): Tag[];
-    loadRowsbySha(graphRows: GraphRow[]): void;
+    loadRowsbySha(graphRows: GraphRow[], pinnedBranchFullName?: string | null): void;
     updateRowStatsConstraints(): void;
     updateTimelines(): void;
     clearTimelines(): void;

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

@@ -6,6 +6,7 @@ import type { TranslationFn } from '../../../domain/language/LanguageTypes';
 import type { RefIconsPosition } from '../../../domain/ref/RefTypes';
 import type { OnClick, OnContextMenu, OnDoubleClick } from '../../../domain/ui/UiTypes';
 export type RefNodeProps = {
+    className?: string;
     enableShowHideRefsOptions: boolean;
     getExternalIcon: GetExternalIcon;
     groupIsHovered: boolean;
@@ -13,7 +14,9 @@ export type RefNodeProps = {
     hasRefs: boolean;
     isActive: boolean;
     isGhostRef: boolean;
+    isHidden?: boolean;
     isInUnsupportedRebase: boolean;
+    isPinned: boolean;
     isRefGroupIncluded: boolean;
     key?: string;
     onClick: OnClickRef;
@@ -30,9 +33,9 @@ export type RefNodeProps = {
     onMissingRefMetadata: GetMissingRefMetadata;
     onHideRefClick: OnHideRefClick;
     refGroup: GraphRefGroup;
-    refGroupContext: GraphItemContext | null;
+    refGroupContext: GraphItemContext | null | undefined;
     refIconsPosition: RefIconsPosition;
-    refMetadata: RefMetadataById | null;
+    refMetadata: RefMetadataById | null | undefined;
     fallbackRefMetadata?: RefMetadataById | null;
     sha: Sha;
     showRemoteNamesOnRefs: boolean;
@@ -43,11 +46,11 @@ export type RefNodeProps = {
 };
 export declare function getRefIconAndTooltipForRef(getExternalIcon: GetExternalIcon, ref: GraphRef, translate: TranslationFn, index?: number): ReactElement<any>;
 export default class RefNode extends React.PureComponent<RefNodeProps> {
-    getContextForRefGroupIfExists(refGroup: GraphRefGroup, groupContext: GraphItemContext | null, useGroupContext?: boolean): GraphItemContext | undefined;
+    getContextForRefGroupIfExists(refGroup: GraphRefGroup, groupContext: GraphItemContext | null | undefined, useGroupContext?: boolean): GraphItemContext | null | undefined;
     getDecoratedRefIcon(key: string, icon: ReactElement<any>, metadataItem: RefMetadataItem, context?: GraphItemContext, className?: string): ReactElement<any>;
-    getPullRequestIconsAndTooltipsForRef(refMetadata: RefMetadataById | null, ref: GraphRef, existingPullRequestIds: Set<number>): ReactElement<any>[] | null;
-    getUpstreamIndicatorIconsAndTooltipsForRef(refMetadata: RefMetadataById | null, ref: GraphRef): ReactElement<any> | null;
-    getIssueIconsAndTooltipsForRef(refMetadata: RefMetadataById | null, ref: GraphRef, existingIssuesIds: Set<string>): ReactElement<any>[] | null;
+    getPullRequestIconsAndTooltipsForRef(refMetadata: RefMetadataById | null | undefined, ref: GraphRef, existingPullRequestIds: Set<number>): ReactElement<any>[] | null;
+    getUpstreamIndicatorIconsAndTooltipsForRef(refMetadata: RefMetadataById | null | undefined, ref: GraphRef): ReactElement<any> | null;
+    getIssueIconsAndTooltipsForRef(refMetadata: RefMetadataById | null | undefined, ref: GraphRef, existingIssuesIds: Set<string>): ReactElement<any>[] | null;
     onContextMenu: OnContextMenu;
     onClick: OnClick;
     onClickMetadata: OnClickRefMetadata;

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

@@ -0,0 +1,10 @@
+import React from 'react';
+type Props = React.ComponentProps<'div'> & {
+    className?: string;
+    isRefGhost: boolean;
+    isRefHidden: boolean;
+    isRefActive: boolean;
+    isRefPinned: boolean;
+};
+declare const RefNodeAnnotationTarget: React.ForwardRefExoticComponent<Omit<Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export default RefNodeAnnotationTarget;

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

@@ -22,10 +22,11 @@ type RefNodesProps = {
     numGraphColumns: number;
     onClickRef: OnClickRef;
     onMissingRefMetadata: GetMissingRefMetadata;
+    pinnedBranchFullName?: string | null;
     refGroupContexts: RefGroupContexts | null;
     refGroupsByName: RefGroup[];
     refIconsPosition: RefIconsPosition;
-    refMetadata: RefMetadataById | null;
+    refMetadata: RefMetadataById | null | undefined;
     fallbackRefMetadata?: RefMetadataById | null;
     refNodeHovered: OnRefNodeHovered;
     onToggleRefNodesShown: OnToggleRefNodesShown;
@@ -43,5 +44,5 @@ type RefNodesProps = {
     type: CommitType;
     useColumnHeaderIcons: boolean;
 };
-declare function RefNodes({ enabledRefMetadataTypes, column, columnForColoring, context, enableShowHideRefsOptions, targetRef, hasActive, hasRefs, getExternalIcon, includeOnlyRefsById, includeOnlyRemotesByName, isGhostRef, isHovered, isInUnsupportedRebase, numGraphColumns, onMissingRefMetadata, refGroupContexts, refGroupsByName, refIconsPosition, refMetadata, fallbackRefMetadata, refNodeHovered, sha, showRemoteNamesOnRefs, showContextMenuForGroupedRef, onClickRef, onDoubleClickRef, onToggleRefNodesShown, onRefBeginDrag, onRefCanDrag, onRefCanDrop, onRefDragEnter, onRefDragLeave, onRefDrop, onRefEndDrag, translate, type, useColumnHeaderIcons, }: RefNodesProps): ReactElement<'span' | 'div'>;
+declare function RefNodes({ enabledRefMetadataTypes, column, columnForColoring, context, enableShowHideRefsOptions, targetRef, hasActive, hasRefs, getExternalIcon, includeOnlyRefsById, includeOnlyRemotesByName, isGhostRef, isHovered, isInUnsupportedRebase, numGraphColumns, onMissingRefMetadata, pinnedBranchFullName, refGroupContexts, refGroupsByName, refIconsPosition, refMetadata, fallbackRefMetadata, refNodeHovered, sha, showRemoteNamesOnRefs, showContextMenuForGroupedRef, onClickRef, onDoubleClickRef, onToggleRefNodesShown, onRefBeginDrag, onRefCanDrag, onRefCanDrop, onRefDragEnter, onRefDragLeave, onRefDrop, onRefEndDrag, translate, type, useColumnHeaderIcons, }: RefNodesProps): ReactElement<'span' | 'div'>;
 export default RefNodes;

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

@@ -36,10 +36,11 @@ type RefZoneProps = {
     onRefDragLeave: OnRefDragLeave;
     onRefDrop: OnRefDrop;
     onRefEndDrag: OnRefEndDrag;
+    pinnedBranchFullName?: string | null;
     refGroupContexts: RefGroupContexts | null;
     refGroupsByName: GraphRefGroup[];
     refIconsPosition: RefIconsPosition;
-    refMetadata: RefMetadataById | null;
+    refMetadata: RefMetadataById | null | undefined;
     fallbackRefMetadata?: RefMetadataById | null;
     refNodeHovered: OnRefNodeHovered;
     refNodeUnhovered: OnRefNodeUnhovered;
@@ -60,7 +61,7 @@ type RefZoneProps = {
     currentlyHoveredCommitSha: Sha | null;
 };
 export default class RefZone extends React.PureComponent<RefZoneProps> {
-    popoverTargetRef: React.RefObject<HTMLDivElement>;
+    popoverTargetRef: React.RefObject<HTMLDivElement | null>;
     static defaultProps: RefZoneDefaultProps;
     componentDidUpdate(nextProps: RefZoneProps): void;
     onCustomToggleRefNodesShown: OnToggleRefNodesShown;

package/dist/components/graph/rowRenderers/RefZoneRow.d.ts

@@ -15,6 +15,7 @@ interface StateProps {
     isInUnsupportedRebase: boolean;
     isRefShorthandValid: IsRefShorthandValid;
     hoveredRefZoneSha?: Sha;
+    pinnedBranchFullName?: string | null;
     refIconsPosition: RefIconsPosition;
     refMetadataById?: RefMetadataById | null;
     fallbackRefMetadataById?: RefMetadataById | null;

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

@@ -31,6 +31,8 @@ export declare const REF_ZONE_MARGIN_LEFT = 2;
 export declare const REF_ZONE_MARGIN_RIGHT = 6;
 export declare const REF_NODE_ICON_WIDTH = 14;
 export declare const REF_NODE_ICON_MARGIN = 5;
+export declare const REF_NODE_ACTIVE_ANNOTATION_ID = "gk-graph-ref-active";
+export declare const REF_NODE_PINNED_ANNOTATION_ID = "gk-graph-ref-pinned";
 export declare const REF_NODE_ICON_SPACING: number;
 export declare const REF_NODE_OUTER_SPACING = 10;
 export declare const REF_ZONE_SHOW_ICON_WIDTH = 55;

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

@@ -17,7 +17,7 @@ export declare function hasScrolledToBottom(htmlElement: HTMLElement): boolean;
 export declare function hasScrolledToRight(htmlElement: HTMLElement): boolean;
 export declare function parseContext(context?: GraphItemContext | null): string | null;
 export declare function getRowStatsConstraints(stats: number[]): RowStatsConstraints;
-export declare function getOrAskForRefMetadata(ref: GraphRef, refMetadata: RefMetadataById | undefined, onMissingRefMetadata: GetMissingRefMetadata, refMetadataType?: RefMetadataType, fallbackRefMetadata?: RefMetadataById | null): RefMetadata | BaseMetadata | BaseMetadata[] | null | undefined;
+export declare function getOrAskForRefMetadata(ref: GraphRef, refMetadata: RefMetadataById | undefined | null, onMissingRefMetadata: GetMissingRefMetadata, refMetadataType?: RefMetadataType, fallbackRefMetadata?: RefMetadataById | null): RefMetadata | BaseMetadata | BaseMetadata[] | null | undefined;
 export declare function getTimelineLabelAndValue(diffMs: number): {
     label: string;
     value: number;

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

@@ -145,6 +145,9 @@ export type HasSpecialChildBySha = {
 export type ReserverInfoBySha = {
     [id: Sha]: ReserverInfo;
 };
+export type ColumnNumberBySha = {
+    [sha: Sha]: number;
+};
 export type RefTargetFunc = () => Element | null | undefined;
 export type ColumnContentGenerator = () => ReactElement<any>;
 export type GraphItemContext = string | object;
@@ -406,7 +409,7 @@ export type DownstreamsByUpstream = {
     [upstreamName: string]: string[];
 };
 export type GraphPlatform = 'aix' | 'android' | 'darwin' | 'freebsd' | 'linux' | 'openbsd' | 'sunos' | 'win32' | 'cygwin';
-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 ExternalIconKeys = 'added' | 'author' | 'branch' | 'changes' | 'check' | 'commit' | 'datetime' | 'deleted' | 'files' | 'filter' | 'graph' | 'head' | 'hide' | `issue-${IssueTrackerType}` | 'loading' | 'message' | 'modified' | 'pin' | '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;
@@ -479,7 +482,7 @@ export type OnToggleRefsVisibilityClick = (event: React.MouseEvent<any>, refs: G
 export interface GraphSelectionState {
     /** Whether the selected rows form a topologically contiguous selection (connected via parent-child relationships) */
     isContiguous: boolean;
-    /** Whether the selection was made topologically (via shift+click following graph topology) */
+    /** Whether the selection was made topologically (via ctrl/shift+click following graph topology) */
     isTopological: boolean;
 }
 export type OnSelectGraphRows = (rows: ReadonlyGraphRow[], focusedRow: ReadonlyGraphRow | undefined, state: GraphSelectionState) => void;
@@ -493,4 +496,10 @@ export type OnGraphColumnResized = (graphZoneType: GraphZoneType, columnSettings
 export type OnShowMoreCommits = () => void;
 export type OnEmailsMissingAvatarUrls = (emails: AvatarUrlByEmail) => void;
 export type OnRefsMissingMetadata = (refs: RefsMissingMetadata) => void;
+/**
+ * Callback invoked when column numbers are calculated for each commit.
+ * Receives a map of SHA → column number.
+ * Used to sync column layout data back to the parent application.
+ */
+export type OnColumnsCalculated = (columnsBySha: ColumnNumberBySha) => void;
 export {};

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

@@ -0,0 +1,21 @@
+import type { Sha } from '../commit/CommitTypes';
+import type { GraphRow } from './GraphTypes';
+/**
+ * Identifies commits that belong to the pinned branch by following the first-parent chain.
+ * Returns a Set of SHAs that are part of the pinned branch.
+ */
+export declare function identifyPinnedBranchCommits(graphRows: GraphRow[], pinnedBranchFullName?: string | null): Set<Sha>;
+/**
+ * Gets the next available column number, marking it as used.
+ * When reserveColumn0ForPinned is true, starts searching from column 1.
+ */
+export declare function getAvailableColumnAndUseIt(columnsUsed: {
+    [column: number]: boolean;
+}, reserveColumn0ForPinned?: boolean): number;
+/**
+ * Determines the column number for a parent commit based on pinning status and parent index.
+ * For pinned parents, always reserve column 0; for non-pinned, use normal logic.
+ */
+export declare function getParentColumn(columnsUsed: {
+    [column: number]: boolean;
+}, isParentPinned: boolean, parentIndex: number, currentColumn: number, hasPinnedBranch: boolean): number;