Contribution Metrics Glass

1// ========================================
2// CONTRIBUTION METRICS GLASS - COMPOSITE COMPONENT
3// Repository contribution metrics grid
4// Level 3: Composite (extracted from RepositoryCardGlass)
5// ========================================
6 
7import { forwardRef, type HTMLAttributes, type CSSProperties } from 'react';
8import { cn } from '@/lib/utils';
9import '@/glass-theme.css';
10 
11/**
12 * Props for ContributionMetricsGlass component.
13 *
14 * Extends standard div attributes for maximum flexibility.
15 * All props are readonly to ensure immutability.
16 *
17 * @example
18 * ```tsx
19 * const props: ContributionMetricsGlassProps = {
20 *   userCommits: 1234,
21 *   userContribution: 45,
22 *   totalProjectCommits: 2744,
23 *   estimatedLines: 14808,
24 *   columns: 2,
25 * };
26 * ```
27 */
28export interface ContributionMetricsGlassProps extends HTMLAttributes<HTMLDivElement> {
29  /**
30   * Number of commits made by the user.
31   *
32   * Displayed in the first card as "Your Contribution" with thousand separators.
33   *
34   * @example
35   * ```tsx
36   * <ContributionMetricsGlass userCommits={1234} /> // Shows "1,234 commits"
37   * ```
38   */
39  readonly userCommits: number;
40 
41  /**
42   * User's contribution percentage (0-100).
43   *
44   * Used to calculate total project commits if not provided.
45   * Displayed below user commits.
46   *
47   * @example
48   * ```tsx
49   * <ContributionMetricsGlass userContribution={45} /> // Shows "45%"
50   * ```
51   */
52  readonly userContribution: number;
53 
54  /**
55   * Total project commits across all contributors.
56   *
57   * If not provided, automatically calculated from userCommits and userContribution.
58   * Calculation: `userCommits / (userContribution / 100)`
59   *
60   * @default Calculated from userCommits and userContribution
61   *
62   * @example
63   * ```tsx
64   * // Manual total
65   * <ContributionMetricsGlass totalProjectCommits={5000} />
66   *
67   * // Auto-calculated: 1000 / (50 / 100) = 2000
68   * <ContributionMetricsGlass userCommits={1000} userContribution={50} />
69   * ```
70   */
71  readonly totalProjectCommits?: number;
72 
73  /**
74   * Estimated lines of code in the project.
75   *
76   * If not provided, automatically calculated as `userCommits * 12`.
77   * Displayed with thousand separators (e.g., "14,808 lines").
78   *
79   * @default userCommits * 12
80   *
81   * @example
82   * ```tsx
83   * // Manual lines
84   * <ContributionMetricsGlass estimatedLines={25000} />
85   *
86   * // Auto-calculated: 1000 * 12 = 12000
87   * <ContributionMetricsGlass userCommits={1000} />
88   * ```
89   */
90// … truncated