chore: import upstream snapshot with attribution

2026-07-13 13:32:57 +08:00
commit cd420f9332
4811 changed files with 884702 additions and 0 deletions
@@ -0,0 +1,63 @@
+/**
+ * X-axis tick + tooltip label formatters for the task/agent activity charts.
+ * ClickHouse buckets are UTC-aligned, so labels are formatted in UTC (local time
+ * causes off-by-one day labels). Tick selection itself lives in useXAxisTicks.
+ */
+
+const ONE_MINUTE = 60 * 1000;
+const ONE_DAY = 24 * 60 * 60 * 1000;
+
+type ActivityPoint = { bucket: number };
+
+export function buildActivityTimeAxis(data: ActivityPoint[]) {
+  const range = data.length >= 2 ? data[data.length - 1].bucket - data[0].bucket : 0;
+  const bucketMs = data.length >= 2 ? data[1].bucket - data[0].bucket : 0;
+
+  // ≤ 1 day range → clock time, otherwise date.
+  const showTime = range <= ONE_DAY;
+  // Sub-minute buckets need seconds, or adjacent ticks collapse to the same "HH:MM".
+  const showSeconds = bucketMs > 0 && bucketMs < ONE_MINUTE;
+  const isSubDayBucket = bucketMs > 0 && bucketMs < ONE_DAY;
+
+  const tickFormatter = (value: number) => {
+    const date = new Date(value);
+    if (showTime) {
+      return date.toLocaleTimeString("en-US", {
+        hour: "2-digit",
+        minute: "2-digit",
+        ...(showSeconds ? { second: "2-digit" } : {}),
+        hour12: false,
+        timeZone: "UTC",
+      });
+    }
+    return date.toLocaleDateString("en-US", {
+      month: "short",
+      day: "numeric",
+      timeZone: "UTC",
+    });
+  };
+
+  const tooltipLabelFormatter = (_label: string, payload: { payload?: { bucket?: number } }[]) => {
+    const ts = payload?.[0]?.payload?.bucket;
+    if (typeof ts !== "number" || !Number.isFinite(ts)) return _label;
+    const date = new Date(ts);
+    return isSubDayBucket
+      ? date.toLocaleString("en-US", {
+          month: "short",
+          day: "numeric",
+          hour: "2-digit",
+          minute: "2-digit",
+          ...(showSeconds ? { second: "2-digit" } : {}),
+          hour12: false,
+          timeZone: "UTC",
+        })
+      : date.toLocaleDateString("en-US", {
+          month: "short",
+          day: "numeric",
+          year: "numeric",
+          timeZone: "UTC",
+        });
+  };
+
+  return { tickFormatter, tooltipLabelFormatter };
+}