@umituz/web-dashboard 8.10.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/README.md +54 -7
  2. package/package.json +6 -2
  3. package/src/config/DashboardConfig.ts +4 -8
  4. package/src/domains/analytics/components/AnalyticsLayout.test.tsx +85 -0
  5. package/src/domains/analytics/components/AnalyticsLayout.tsx +103 -105
  6. package/src/domains/analytics/components/index.ts +0 -3
  7. package/src/domains/analytics/hooks/index.ts +1 -1
  8. package/src/domains/analytics/hooks/useAnalytics.test.tsx +125 -0
  9. package/src/domains/analytics/hooks/useAnalytics.ts +37 -56
  10. package/src/domains/analytics/index.ts +9 -26
  11. package/src/domains/analytics/services/index.ts +0 -1
  12. package/src/domains/analytics/types/analytics.ts +32 -149
  13. package/src/domains/analytics/types/index.ts +3 -15
  14. package/src/domains/analytics/utils/analytics.test.ts +82 -13
  15. package/src/domains/analytics/utils/analytics.ts +52 -75
  16. package/src/domains/analytics/utils/index.ts +5 -8
  17. package/src/domains/charts/charts.css +455 -0
  18. package/src/domains/charts/components/ActivityHeatmap.test.tsx +48 -0
  19. package/src/domains/charts/components/ActivityHeatmap.tsx +58 -0
  20. package/src/domains/charts/components/BarChart.test.tsx +91 -0
  21. package/src/domains/charts/components/BarChart.tsx +143 -0
  22. package/src/domains/charts/components/ChartCard.tsx +39 -0
  23. package/src/domains/charts/components/ChartPrimitives.test.tsx +90 -0
  24. package/src/domains/charts/components/ChartTip.tsx +18 -0
  25. package/src/domains/charts/components/Donut.test.tsx +51 -0
  26. package/src/domains/charts/components/Donut.tsx +97 -0
  27. package/src/domains/charts/components/HBars.tsx +31 -0
  28. package/src/domains/charts/components/Legend.tsx +21 -0
  29. package/src/domains/charts/components/LineChart.test.tsx +81 -0
  30. package/src/domains/charts/components/LineChart.tsx +244 -0
  31. package/src/domains/charts/components/Sparkline.tsx +35 -0
  32. package/src/domains/charts/components/index.ts +16 -0
  33. package/src/domains/charts/index.ts +16 -2
  34. package/src/domains/charts/ssr.test.tsx +35 -0
  35. package/src/domains/charts/types/index.ts +8 -0
  36. package/src/domains/charts/utils.ts +15 -0
  37. package/src/domains/permissions/AccessDenied.tsx +10 -6
  38. package/src/domains/permissions/PermissionsContext.test.tsx +10 -3
  39. package/src/domains/permissions/PermissionsContext.tsx +5 -3
  40. package/src/domains/tour/tourEngine.ts +3 -3
  41. package/src/domains/tour/types.ts +1 -1
  42. package/src/index.ts +6 -23
  43. package/src/styles/chrome.css +10 -490
  44. package/src/styles/dashboard.contract.test.ts +20 -5
  45. package/src/styles/dashboard.css +1 -0
  46. package/src/domains/analytics/components/AnalyticsCard.tsx +0 -87
  47. package/src/domains/analytics/components/AnalyticsChart.tsx +0 -387
  48. package/src/domains/analytics/components/MetricCard.tsx +0 -42
  49. package/src/domains/analytics/services/AnalyticsEngineService.ts +0 -300
  50. package/src/domains/charts/components.test.tsx +0 -141
  51. package/src/domains/charts/components.tsx +0 -683
@@ -1,58 +1,39 @@
1
1
  import { useState, useCallback, useEffect, useMemo, useRef } from "react";
2
+ import { presetRange } from "@umituz/web-design-system/organisms";
3
+ import type { DateRange } from "@umituz/web-design-system/organisms";
2
4
  import type {
3
- KPIs,
4
- TimeSeriesData,
5
- DateRangeValue,
6
5
  AnalyticsExportOptions,
6
+ KpiDatum,
7
+ TimeSeriesDatum,
7
8
  } from "../types/analytics";
8
9
 
9
10
  export interface AnalyticsApiClient {
10
- loadAnalytics: (range: DateRangeValue) => Promise<AnalyticsDataPayload>;
11
- exportAnalytics: (payload: AnalyticsDataPayload, options: AnalyticsExportOptions) => Promise<Blob>;
11
+ loadAnalytics: (range: DateRange) => Promise<AnalyticsPayload>;
12
+ exportAnalytics?: (payload: AnalyticsPayload, options: AnalyticsExportOptions) => Promise<Blob>;
12
13
  }
13
14
 
14
- export interface AnalyticsDataPayload {
15
- kpis: KPIs;
16
- timeSeries: TimeSeriesData[];
15
+ export interface AnalyticsPayload {
16
+ kpis: KpiDatum[];
17
+ series: TimeSeriesDatum[];
17
18
  }
18
19
 
19
20
  export interface UseAnalyticsOptions {
20
- initialDateRange?: DateRangeValue;
21
- refreshInterval?: number;
21
+ initialRange?: DateRange;
22
+ refreshInterval?: number;
22
23
  apiClient: AnalyticsApiClient;
23
24
  }
24
25
 
25
26
  export interface UseAnalyticsReturn {
26
- kpis: KPIs;
27
- timeSeries: TimeSeriesData[];
27
+ kpis: KpiDatum[];
28
+ series: TimeSeriesDatum[];
28
29
  isLoading: boolean;
29
30
  error: string | null;
30
- dateRange: DateRangeValue;
31
- updateDateRange: (range: DateRangeValue) => void;
31
+ range: DateRange;
32
+ updateRange: (range: DateRange) => void;
32
33
  refresh: () => Promise<void>;
33
34
  exportData: (options: AnalyticsExportOptions) => Promise<void>;
34
35
  }
35
36
 
36
- const DEFAULT_RANGE_DAYS = 30;
37
- const MS_PER_DAY = 24 * 60 * 60 * 1000;
38
-
39
- const buildDefaultRange = (): DateRangeValue => {
40
- const today = new Date();
41
- const start = new Date(Date.now() - DEFAULT_RANGE_DAYS * MS_PER_DAY);
42
- return {
43
- from: start.toISOString().split("T")[0] as string,
44
- to: today.toISOString().split("T")[0] as string,
45
- };
46
- };
47
-
48
- const EMPTY_KPIS: KPIs = {
49
- downloads: { current: 0, previous: 0, growth: 0 },
50
- engagement: { current: 0, previous: 0, growth: 0 },
51
- users: { current: 0, previous: 0, growth: 0 },
52
- revenue: { current: 0, previous: 0, growth: 0 },
53
- retention: { current: 0, previous: 0, growth: 0 },
54
- };
55
-
56
37
  const toErrorMessage = (err: unknown, fallback: string): string =>
57
38
  err instanceof Error && err.message ? err.message : fallback;
58
39
 
@@ -60,27 +41,25 @@ const toError = (err: unknown, fallback: string): Error =>
60
41
  err instanceof Error ? err : new Error(fallback);
61
42
 
62
43
  export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
63
- const { initialDateRange, refreshInterval = 0, apiClient } = options;
44
+ const { initialRange, refreshInterval = 0, apiClient } = options;
64
45
 
65
- const [dateRange, setDateRange] = useState<DateRangeValue>(
66
- initialDateRange ?? buildDefaultRange(),
67
- );
68
- const [kpis, setKpis] = useState<KPIs>(EMPTY_KPIS);
69
- const [timeSeries, setTimeSeries] = useState<TimeSeriesData[]>([]);
46
+ const [range, setRange] = useState<DateRange>(initialRange ?? presetRange("30d"));
47
+ const [kpis, setKpis] = useState<KpiDatum[]>([]);
48
+ const [series, setSeries] = useState<TimeSeriesDatum[]>([]);
70
49
  const [isLoading, setIsLoading] = useState(false);
71
50
  const [error, setError] = useState<string | null>(null);
72
51
 
73
- const requestIdRef = useRef(0);
52
+ const requestIdRef = useRef(0);
74
53
 
75
54
  const refresh = useCallback(async () => {
76
55
  const requestId = ++requestIdRef.current;
77
56
  setIsLoading(true);
78
57
  setError(null);
79
58
  try {
80
- const payload = await apiClient.loadAnalytics(dateRange);
59
+ const payload = await apiClient.loadAnalytics(range);
81
60
  if (requestIdRef.current === requestId) {
82
61
  setKpis(payload.kpis);
83
- setTimeSeries(payload.timeSeries);
62
+ setSeries(payload.series);
84
63
  }
85
64
  } catch (err) {
86
65
  if (requestIdRef.current === requestId) {
@@ -91,34 +70,37 @@ export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
91
70
  setIsLoading(false);
92
71
  }
93
72
  }
94
- }, [apiClient, dateRange]);
73
+ }, [apiClient, range]);
95
74
 
96
- const updateDateRange = useCallback((range: DateRangeValue) => {
97
- setDateRange(range);
75
+ const updateRange = useCallback((nextRange: DateRange) => {
76
+ setRange(nextRange);
98
77
  }, []);
99
78
 
100
79
  const exportData = useCallback(
101
80
  async (exportOptions: AnalyticsExportOptions) => {
102
- const payload: AnalyticsDataPayload = { kpis, timeSeries };
81
+ const exportAnalytics = apiClient.exportAnalytics;
82
+ if (!exportAnalytics) {
83
+ throw new Error('AnalyticsApiClient.exportAnalytics not configured');
84
+ }
85
+ const payload: AnalyticsPayload = { kpis, series };
103
86
  try {
104
- const blob = await apiClient.exportAnalytics(payload, exportOptions);
87
+ const blob = await exportAnalytics(payload, exportOptions);
105
88
 
106
89
  const url = URL.createObjectURL(blob);
107
90
  const link = document.createElement("a");
108
91
  link.href = url;
109
92
  link.download =
110
- exportOptions.filename ?? `analytics-${dateRange.from}-${dateRange.to}.${exportOptions.format}`;
93
+ exportOptions.filename ?? `analytics-${range.from}-${range.to}.${exportOptions.format}`;
111
94
  document.body.appendChild(link);
112
95
  link.click();
113
96
  document.body.removeChild(link);
114
97
  URL.revokeObjectURL(url);
115
98
  } catch (err) {
116
-
117
99
  setError(toErrorMessage(err, 'Failed to export analytics'));
118
100
  throw toError(err, 'Failed to export analytics');
119
101
  }
120
102
  },
121
- [apiClient, dateRange.from, dateRange.to, kpis, timeSeries],
103
+ [apiClient, range.from, range.to, kpis, series],
122
104
  );
123
105
 
124
106
  useEffect(() => {
@@ -136,15 +118,15 @@ export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
136
118
  return useMemo(
137
119
  () => ({
138
120
  kpis,
139
- timeSeries,
121
+ series,
140
122
  isLoading,
141
123
  error,
142
- dateRange,
143
- updateDateRange,
124
+ range,
125
+ updateRange,
144
126
  refresh,
145
127
  exportData,
146
128
  }),
147
- [kpis, timeSeries, isLoading, error, dateRange, updateDateRange, refresh, exportData],
129
+ [kpis, series, isLoading, error, range, updateRange, refresh, exportData],
148
130
  );
149
131
  }
150
132
 
@@ -153,7 +135,6 @@ export const createStubAnalyticsApiClient = (
153
135
  ): AnalyticsApiClient => {
154
136
  const notConfigured: AnalyticsApiClient = {
155
137
  loadAnalytics: () => Promise.reject(new Error('AnalyticsApiClient not configured')),
156
- exportAnalytics: () => Promise.reject(new Error('AnalyticsApiClient not configured')),
157
138
  };
158
139
  return { ...notConfigured, ...overrides };
159
140
  };
@@ -1,7 +1,4 @@
1
1
  export {
2
- MetricCard,
3
- AnalyticsChart,
4
- AnalyticsCard,
5
2
  AnalyticsLayout,
6
3
  } from "./components";
7
4
 
@@ -11,7 +8,7 @@ export {
11
8
  } from "./hooks";
12
9
  export type {
13
10
  AnalyticsApiClient,
14
- AnalyticsDataPayload,
11
+ AnalyticsPayload,
15
12
  UseAnalyticsOptions,
16
13
  UseAnalyticsReturn,
17
14
  } from "./hooks";
@@ -22,39 +19,25 @@ export {
22
19
  formatCurrency,
23
20
  calculateGrowth,
24
21
  getTrend,
25
- createKPI,
26
- createMetric,
27
- formatMetricValue,
22
+ toKpiDelta,
23
+ toCsv,
24
+ downloadCsv,
25
+ exportCsv,
28
26
  calculateConversionRate,
29
27
  calculateDropOffRate,
30
- createDateRangePreset,
31
- getDateRangePresets,
32
28
  aggregateByPeriod,
33
29
  calculateMovingAverage,
34
30
  detectOutliers,
35
31
  roundTo,
36
- generateColor,
37
- generateChartColors,
38
32
  } from "./utils";
33
+ export type { KpiDeltaLike } from "./utils";
39
34
 
40
35
  export type {
41
- Metric,
36
+ KpiDatum,
37
+ TimeSeriesDatum,
42
38
  TimeSeriesData,
43
- ChartData,
44
- FunnelStep,
45
- FunnelData,
46
- CohortAnalysis,
47
- UserSegment,
48
- KPIData,
49
- KPIs,
50
- ChartType,
51
- ChartConfig,
52
- MetricCardProps,
53
- AnalyticsCardProps,
39
+ AnalyticsLayoutLabels,
54
40
  AnalyticsLayoutProps,
55
- AnalyticsPeriod,
56
- AnalyticsConfig,
57
- MetricConfig,
58
41
  DateRangePreset,
59
42
  DateRangeValue,
60
43
  ExportFormat,
@@ -1,2 +1 @@
1
- export * from './AnalyticsEngineService';
2
1
  export * from './PerformanceService';
@@ -1,151 +1,52 @@
1
- import type { ComponentType } from "react";
1
+ import type { ReactNode } from "react";
2
+ import type { DateRange, KpiIconTone, RangePreset } from "@umituz/web-design-system/organisms";
2
3
 
3
- export interface Metric {
4
+ export interface KpiDatum {
4
5
  id: string;
5
- name: string;
6
- value: number;
6
+ label: string;
7
+ value: number | string;
7
8
  previousValue?: number;
8
- unit?: string;
9
- trend?: "up" | "down" | "stable";
10
- icon?: ComponentType<{ className?: string }>;
9
+ format?: (value: number) => string;
10
+ goodWhen?: "up" | "down";
11
+ hint?: string;
12
+ icon?: ReactNode;
13
+ iconTone?: KpiIconTone;
14
+ spark?: readonly number[];
15
+ onClick?: () => void;
11
16
  }
12
17
 
13
- export interface TimeSeriesData {
18
+ export interface TimeSeriesDatum {
14
19
  date: string;
15
20
  [key: string]: string | number;
16
21
  }
17
22
 
18
- export interface ChartData {
19
- label: string;
20
- value: number;
21
- [key: string]: string | number | boolean;
22
- }
23
-
24
- export interface FunnelStep {
25
- name: string;
26
- count: number;
27
- conversionRate: number;
28
- dropOffRate: number;
29
- averageTime?: number;
30
- }
31
-
32
- export interface FunnelData {
33
- title: string;
34
- steps: FunnelStep[];
35
- totalUsers: number;
36
- finalConversion: number;
37
- }
38
-
39
- export interface CohortAnalysis {
40
- cohort: string;
41
- size: number;
42
- retention: number[];
43
- averageRetention: number;
44
- }
45
-
46
- export interface UserSegment {
47
- name: string;
48
- count: number;
49
- percentage: number;
50
- characteristics: string[];
51
- behavior: {
52
- avgSessionDuration: number;
53
- pagesPerSession: number;
54
- bounceRate: number;
55
- };
56
- }
57
-
58
- export interface KPIData {
59
- current: number;
60
- previous: number;
61
- growth: number;
62
- }
63
-
64
- export interface KPIs {
65
- downloads: KPIData;
66
- engagement: KPIData;
67
- users: KPIData;
68
- revenue: KPIData;
69
- retention: KPIData;
70
- }
71
-
72
- export type ChartType =
73
- | "line"
74
- | "bar"
75
- | "area"
76
- | "pie"
77
- | "donut"
78
- | "funnel"
79
- | "heatmap"
80
- | "metric"
81
- | "table";
82
-
83
- export interface ChartConfig {
84
- id: string;
85
- type: ChartType;
86
- title?: string;
87
- description?: string;
88
- data: TimeSeriesData[] | ChartData[] | Metric[];
89
- xAxisKey?: string;
90
- yAxisKeys?: string[];
91
- colors?: string[];
92
- showLegend?: boolean;
93
- showGrid?: boolean;
94
- showTooltip?: boolean;
95
- height?: number | string;
96
- aspectRatio?: string;
97
- }
98
-
99
- export type AnalyticsPeriod = '7d' | '30d' | '90d' | '1y' | (string & {});
100
-
101
- export interface MetricCardProps {
102
- metric: Metric;
103
- lastPeriodLabel?: string;
104
- size?: "sm" | "md" | "lg";
105
- showTrend?: boolean;
106
- showIcon?: boolean;
107
- className?: string;
108
- onClick?: () => void;
109
- }
110
-
111
- export interface AnalyticsCardProps {
112
- title?: string;
113
- description?: string;
114
- chart?: ChartConfig;
115
- metrics?: Metric[];
116
- size?: "sm" | "md" | "lg" | "full";
117
- loading?: boolean;
118
- error?: string;
119
- className?: string;
120
- children?: React.ReactNode;
121
- }
23
+ export type TimeSeriesData = TimeSeriesDatum;
122
24
 
123
25
  export interface AnalyticsLayoutLabels {
124
- title: string;
125
- periodSelector: string;
126
- periods: Record<AnalyticsPeriod, string>;
127
- refresh: string;
128
- export: string;
129
- loading: string;
26
+ refresh?: string;
27
+ export?: string;
28
+ retry?: string;
29
+ range?: string;
130
30
  }
131
31
 
132
32
  export interface AnalyticsLayoutProps {
133
- config?: AnalyticsConfig;
134
- labels: AnalyticsLayoutLabels;
135
- title?: string;
33
+ title: string;
136
34
  description?: string;
137
- metrics?: Metric[];
138
- loading?: boolean;
139
- period?: AnalyticsPeriod;
140
- onPeriodChange?: (period: AnalyticsPeriod) => void;
141
- showDateRange?: boolean;
142
- showRefresh?: boolean;
143
- showExport?: boolean;
144
- charts?: ChartConfig[];
35
+ range?: DateRange;
36
+ onRangeChange?: (range: DateRange) => void;
37
+ presets?: readonly RangePreset[];
145
38
  onRefresh?: () => void;
39
+ refreshing?: boolean;
146
40
  onExport?: () => void;
147
- headerContent?: React.ReactNode;
148
- children?: React.ReactNode;
41
+ kpis?: readonly KpiDatum[];
42
+ charts?: ReactNode;
43
+ filters?: ReactNode;
44
+ loading?: boolean;
45
+ error?: string | null;
46
+ onRetry?: () => void;
47
+ children?: ReactNode;
48
+ className?: string;
49
+ labels?: AnalyticsLayoutLabels;
149
50
  }
150
51
 
151
52
  export interface DateRangePreset {
@@ -171,21 +72,3 @@ export interface AnalyticsExportOptions {
171
72
  dateRange?: DateRangeValue;
172
73
  filename?: string;
173
74
  }
174
-
175
- export interface AnalyticsConfig {
176
- brandName: string;
177
- defaultPeriod?: string;
178
- availablePeriods?: string[];
179
- showExport?: boolean;
180
- showRefresh?: boolean;
181
- enableRealTime?: boolean;
182
- metrics?: MetricConfig[];
183
- }
184
-
185
- export interface MetricConfig {
186
- id: string;
187
- name: string;
188
- unit?: string;
189
- icon?: string;
190
- }
191
-
@@ -1,21 +1,9 @@
1
1
  export type {
2
- Metric,
2
+ KpiDatum,
3
+ TimeSeriesDatum,
3
4
  TimeSeriesData,
4
- ChartData,
5
- FunnelStep,
6
- FunnelData,
7
- CohortAnalysis,
8
- UserSegment,
9
- KPIData,
10
- KPIs,
11
- ChartType,
12
- ChartConfig,
13
- MetricCardProps,
14
- AnalyticsCardProps,
5
+ AnalyticsLayoutLabels,
15
6
  AnalyticsLayoutProps,
16
- AnalyticsPeriod,
17
- AnalyticsConfig,
18
- MetricConfig,
19
7
  DateRangePreset,
20
8
  DateRangeValue,
21
9
  ExportFormat,
@@ -1,17 +1,20 @@
1
- import { describe, it, expect } from "vitest";
1
+ import { afterEach, describe, it, expect, vi } from "vitest";
2
2
  import {
3
3
  formatNumber,
4
4
  formatPercentage,
5
5
  formatCurrency,
6
6
  calculateGrowth,
7
7
  getTrend,
8
+ toKpiDelta,
9
+ toCsv,
10
+ downloadCsv,
11
+ exportCsv,
8
12
  calculateConversionRate,
9
13
  calculateDropOffRate,
10
14
  calculateMovingAverage,
11
15
  detectOutliers,
12
16
  aggregateByPeriod,
13
17
  roundTo,
14
- createDateRangePreset,
15
18
  } from "./analytics";
16
19
 
17
20
  describe("formatNumber", () => {
@@ -82,6 +85,68 @@ describe("getTrend", () => {
82
85
  });
83
86
  });
84
87
 
88
+ describe("toKpiDelta", () => {
89
+ it("returns undefined without a usable previous value", () => {
90
+ expect(toKpiDelta(5)).toBeUndefined();
91
+ expect(toKpiDelta(5, 0)).toBeUndefined();
92
+ expect(toKpiDelta("not-a-number", 10)).toBeUndefined();
93
+ });
94
+
95
+ it("computes an up delta and marks it good by default", () => {
96
+ expect(toKpiDelta(120, 100)).toEqual({ value: "+20.0%", direction: "up", good: true });
97
+ });
98
+
99
+ it("marks a down delta bad by default and good when goodWhen is down", () => {
100
+ expect(toKpiDelta(80, 100)).toEqual({ value: "-20.0%", direction: "down", good: false });
101
+ expect(toKpiDelta(80, 100, "down")).toEqual({ value: "-20.0%", direction: "down", good: true });
102
+ });
103
+
104
+ it("goes flat under a 0.05% change", () => {
105
+ expect(toKpiDelta(100.01, 100)).toEqual({ value: "0.0%", direction: "flat", good: true });
106
+ });
107
+
108
+ it("accepts numeric strings", () => {
109
+ expect(toKpiDelta("110", 100)).toEqual({ value: "+10.0%", direction: "up", good: true });
110
+ });
111
+ });
112
+
113
+ describe("toCsv", () => {
114
+ it("joins headers and rows with a BOM and CRLF line endings", () => {
115
+ expect(toCsv(["a", "b"], [[1, 2], [3, 4]])).toBe("a,b\r\n1,2\r\n3,4");
116
+ });
117
+
118
+ it("quotes cells containing commas, quotes, newlines or semicolons", () => {
119
+ expect(toCsv(["Name", "Note"], [["A", "has, comma"]])).toBe(
120
+ 'Name,Note\r\nA,"has, comma"',
121
+ );
122
+ expect(toCsv(["q"], [['say "hi"']])).toBe('q\r\n"say ""hi"""');
123
+ expect(toCsv(["s"], [["a;b"]])).toBe('s\r\n"a;b"');
124
+ expect(toCsv(["n"], [["l1\nl2"]])).toBe('n\r\n"l1\nl2"');
125
+ });
126
+ });
127
+
128
+ describe("downloadCsv / exportCsv", () => {
129
+ afterEach(() => {
130
+ vi.restoreAllMocks();
131
+ });
132
+
133
+ it("triggers a browser download and revokes the object url", () => {
134
+ const createObjectURL = vi.fn(() => "blob:csv");
135
+ const revokeObjectURL = vi.fn();
136
+ Object.defineProperty(URL, "createObjectURL", { value: createObjectURL, configurable: true });
137
+ Object.defineProperty(URL, "revokeObjectURL", { value: revokeObjectURL, configurable: true });
138
+ const click = vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => {});
139
+
140
+ exportCsv({ filename: "report.csv", headers: ["a"], rows: [[1]] });
141
+
142
+ expect(click).toHaveBeenCalledTimes(1);
143
+ expect(revokeObjectURL).toHaveBeenCalledWith("blob:csv");
144
+
145
+ downloadCsv("x.csv", "a");
146
+ expect(click).toHaveBeenCalledTimes(2);
147
+ });
148
+ });
149
+
85
150
  describe("calculateConversionRate", () => {
86
151
  it("returns 0 for an empty total", () => {
87
152
  expect(calculateConversionRate(5, 0)).toBe(0);
@@ -146,6 +211,21 @@ describe("aggregateByPeriod", () => {
146
211
  ]);
147
212
  });
148
213
 
214
+ it("groups by the Sunday-starting week key", () => {
215
+ const result = aggregateByPeriod(
216
+ [
217
+ { date: "2026-01-01", value: 1 },
218
+ { date: "2026-01-02", value: 2 },
219
+ { date: "2026-01-04", value: 3 },
220
+ ],
221
+ "week",
222
+ );
223
+ expect(result).toEqual([
224
+ { date: "2025-12-28", value: 3 },
225
+ { date: "2026-01-04", value: 3 },
226
+ ]);
227
+ });
228
+
149
229
  it("groups by month key when period is month", () => {
150
230
  const result = aggregateByPeriod(
151
231
  [
@@ -163,14 +243,3 @@ describe("roundTo", () => {
163
243
  expect(roundTo(3.14159, 2)).toBe(3.14);
164
244
  });
165
245
  });
166
-
167
- describe("createDateRangePreset", () => {
168
- it("resolves from/to dates around today", () => {
169
- const preset = createDateRangePreset("Last 7 Days", 7);
170
- const today = new Date().toISOString().split("T")[0];
171
- expect(preset.value).toBe("last-7-days");
172
- expect(preset.to).toBe(today);
173
- expect(preset.from).toBeDefined();
174
- expect(preset.from).not.toBe(preset.to);
175
- });
176
- });