@tsingroc/tsingroc-components 5.0.0-alpha.11 → 5.0.0-alpha.13

package/dist/echarts/tooltip.js

@@ -0,0 +1,22 @@
+import { TooltipComponent } from "echarts/components";
+import * as echarts from "echarts/core";
+/**
+ * 添加悬停提示。这只是对官方 tooltip 组件的简单包装，设置参见 [ECharts 文档][1]。
+ *
+ * **注意**：ECharts 尚不支持多个 tooltip，在含有多个图表的
+ * ECharts 实例中 tooltip 的 `trigger` 值必须支持所有图表。
+ * 因此，若需要对每个图表使用不同的 tooltip 设置，请将其拆分成多个
+ * ECharts 实例。
+ *
+ * [1]: https://echarts.apache.org/zh/option.html#tooltip
+ */
+export function tooltip(option) {
+  echarts.use(TooltipComponent);
+  return {
+    tooltip: [{
+      trigger: "axis",
+      transitionDuration: 0,
+      ...option
+    }]
+  };
+}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { AuthProvider, type AuthProviderProps, AuthCheck, type AuthCheckProps, AuthCallback, type AuthCallbackProps, useAuth, type Auth, type CasdoorAuth, type LocalAuth, } from "./components/Auth";
+export { default as AutoResizedECharts, withAutoResize, } from "./components/AutoResizedECharts";
+export { default as Calendar, type CalendarProps } from "./components/Calendar";
+export { default as CircularProgress, type CircularProgressProps, } from "./components/CircularProgress";
+export { default as ConnectedECharts, EChartsConnector, withConnector, } from "./components/ConnectedECharts";
+export { default as ECharts, type EChartsProps, type EChartsRef, type EChartsComponentType, type EChartsHOCType, } from "./components/ECharts";
+export { default as Header, type HeaderProps } from "./components/Header";
+export { default as ImageBackground, type ImageBackgroundProps, } from "./components/ImageBackground";
+export { default as IndicatorLight, type IndicatorLightProps, } from "./components/IndicatorLight";
+export { default as LeftAlignedECharts, EChartsLeftAligner, withLeftAlign, } from "./components/LeftAlignedECharts";
+export { default as LineChartEditor, type LineChartEditorProps, } from "./components/LineChartEditor";
+export { default as LineChartTable, type LineChartTableProps, } from "./components/LineChartTable";
+export { default as LinkedLineChart, LineChartLinkProvider, type LinkedLineChartProps, type LineChartLinkProviderProps, } from "./components/LinkedLineChart";
+export { default as QuickDateRangePicker, type QuickDateRangePickerProps, } from "./components/QuickDateRangePicker";
+export { default as SegmentedButtons, TimeUnitSwitcher, type TimeUnitSwitcherProps, } from "./components/SegmentedButtons";
+export { withSelectable, type SelectableEChartsProps, } from "./components/SelectableECharts";
+export { default as Sidebar, type SidebarProps } from "./components/Sidebar";
+export { default as TsingrocDatePicker, type DatePickerProps, } from "./components/TsingrocDatePicker";
+export { default as TsingrocTheme, type TsingrocThemeProps, } from "./components/TsingrocTheme";
+export { default as UserButton, type UserButtonProps, } from "./components/UserButton";
+export { default as WeatherMap, type WeatherMapProps, type WeatherData, } from "./components/WeatherMap";

package/dist/index.js

@@ -0,0 +1,21 @@
+export { AuthProvider, AuthCheck, AuthCallback, useAuth } from "./components/Auth";
+export { default as AutoResizedECharts, withAutoResize } from "./components/AutoResizedECharts";
+export { default as Calendar } from "./components/Calendar";
+export { default as CircularProgress } from "./components/CircularProgress";
+export { default as ConnectedECharts, EChartsConnector, withConnector } from "./components/ConnectedECharts";
+export { default as ECharts } from "./components/ECharts";
+export { default as Header } from "./components/Header";
+export { default as ImageBackground } from "./components/ImageBackground";
+export { default as IndicatorLight } from "./components/IndicatorLight";
+export { default as LeftAlignedECharts, EChartsLeftAligner, withLeftAlign } from "./components/LeftAlignedECharts";
+export { default as LineChartEditor } from "./components/LineChartEditor";
+export { default as LineChartTable } from "./components/LineChartTable";
+export { default as LinkedLineChart, LineChartLinkProvider } from "./components/LinkedLineChart";
+export { default as QuickDateRangePicker } from "./components/QuickDateRangePicker";
+export { default as SegmentedButtons, TimeUnitSwitcher } from "./components/SegmentedButtons";
+export { withSelectable } from "./components/SelectableECharts";
+export { default as Sidebar } from "./components/Sidebar";
+export { default as TsingrocDatePicker } from "./components/TsingrocDatePicker";
+export { default as TsingrocTheme } from "./components/TsingrocTheme";
+export { default as UserButton } from "./components/UserButton";
+export { default as WeatherMap } from "./components/WeatherMap";

package/dist/utils/debug.d.ts

@@ -0,0 +1 @@
+export declare const debugAssert: (cond: any, ...msg: any[]) => asserts cond;

package/dist/utils/debug.js

@@ -0,0 +1,25 @@
+export const debugAssert = process.env.NODE_ENV !== "production" ? (cond, ...msg) => {
+  if (!cond) {
+    throw new AssertionError(...msg);
+  }
+} : () => {};
+class AssertionError extends Error {
+  constructor(...msg) {
+    super();
+    this.originalMessage = msg;
+  }
+}
+if (process.env.NODE_ENV !== "production") {
+  const consoleError = console.error;
+  console.error = (...msg) => {
+    if (msg.length === 4 && msg[1] instanceof AssertionError) {
+      const error = msg[1];
+      const originalMessage = error.originalMessage;
+      console.groupCollapsed("%c❌ Assertion failed:" + " %c%o".repeat(originalMessage.length), "color: orange; font-weight: normal;", ...originalMessage.flatMap(item => ["color: unset; font-weight: normal;", item]));
+      console.log(error);
+      console.groupEnd();
+    } else {
+      consoleError(...msg);
+    }
+  };
+}

package/dist/utils/destructureLineDataItem.d.ts

@@ -0,0 +1,6 @@
+import type { LineSeriesOption } from "echarts";
+import type { OptionDataValue } from "echarts/types/src/util/types.js";
+export type LineDataItem = LineSeriesOption["data"] extends (infer T)[] | undefined ? T : never;
+export type LineDataValue = OptionDataValue | OptionDataValue[];
+export type LineDataItemOption = LineDataItem extends LineDataValue | infer T ? T : never;
+export declare function destructureLineDataItem(value: LineDataItem, i: number): [OptionDataValue[], LineDataItemOption | undefined] | null | undefined;

package/dist/utils/destructureLineDataItem.js

@@ -0,0 +1,17 @@
+export function destructureLineDataItem(value, i) {
+  if (value == null) return value;
+  let rawValue,
+    option = undefined;
+  if (typeof value === "object" && !(value instanceof Date) && !Array.isArray(value)) {
+    ({
+      value: rawValue,
+      ...option
+    } = value);
+  } else {
+    rawValue = value;
+  }
+  if (!Array.isArray(rawValue)) {
+    rawValue = [i, rawValue];
+  }
+  return [rawValue, option];
+}

package/dist/utils/filterMap.d.ts

@@ -0,0 +1 @@
+export declare function filterMap<T, R>(array: T[], func: (elem: T, index: number, array: T[]) => R): NonNullable<R>[];

package/dist/utils/filterMap.js

@@ -0,0 +1,11 @@
+export function filterMap(array, func) {
+  const result = [];
+  for (let i = 0; i < array.length; i++) {
+    const elem = array[i];
+    const resultElem = func(elem, i, array);
+    if (resultElem != null) {
+      result.push(resultElem);
+    }
+  }
+  return result;
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./debug";
+export * from "./destructureLineDataItem";
+export * from "./filterMap";
+export * from "./math";
+export * from "./mock";
+export * from "./normalizeIntoArray";
+export * from "./startOfQuarter";
+export * from "./timeAxisLabel";

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export * from "./debug";
+export * from "./destructureLineDataItem";
+export * from "./filterMap";
+export * from "./math";
+export * from "./mock";
+export * from "./normalizeIntoArray";
+export * from "./startOfQuarter";
+export * from "./timeAxisLabel";

package/dist/utils/math.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 将一个数值限制在 `min` 和 `max` 之间。
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * 生成一个标准正态分布的随机变量
+ * @see [Box-Muller transform](https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform)
+ */
+export declare function normal(): number;

package/{src/utils/math.ts → dist/utils/math.js}

@@ -1,7 +1,7 @@
 /**
  * 将一个数值限制在 `min` 和 `max` 之间。
  */
-export function clamp(value: number, min: number, max: number) {
+export function clamp(value, min, max) {
   return Math.min(Math.max(value, min), max);
 }
 
@@ -13,4 +13,4 @@ export function normal() {
   const u = 1 - Math.random();
   const v = Math.random();
   return Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
-}
+}

package/dist/utils/mock.d.ts

@@ -0,0 +1,8 @@
+import type { Dayjs } from "dayjs";
+export declare function mockData(length: number, mean: number, sd: number, sdDelta: number, min?: number, max?: number): number[];
+export declare function mockPrediction(length: number, mean: number, sd: number, sdDelta: number, sdError: number, pManual: number, min?: number, max?: number): {
+    prediction: number[];
+    manual: number[];
+    real: number[];
+};
+export declare function mockTimeSeries(length: number, start: Dayjs): Dayjs[];

package/dist/utils/mock.js

@@ -0,0 +1,40 @@
+import { clamp, normal } from "./math";
+export function mockData(length, mean, sd, sdDelta, min = -Infinity, max = Infinity) {
+  if (sd === 0) {
+    return Array(length).fill(mean);
+  }
+  const result = [];
+  if (length <= 0) {
+    return result;
+  }
+  result.push(clamp(mean + normal() * sd, min, max));
+  for (let i = 0; i < length - 1; i++) {
+    const diffMean = result[i] - mean;
+    const delta = normal() * sdDelta;
+    result.push(clamp(result[i] + delta * (Math.sign(diffMean * delta) > 0 ? Math.exp(-Math.abs(diffMean / sd)) : Math.log(Math.E + Math.abs(diffMean / sd))), min, max));
+  }
+  return result;
+}
+export function mockPrediction(length, mean, sd, sdDelta, sdError, pManual, min = -Infinity, max = Infinity) {
+  const real = mockData(length, mean, sd, sdDelta, min, max);
+  const error = mockData(length, 0, sdError, sdDelta);
+  const prediction = real.map((x, i) => clamp(x + error[i], min, max));
+  const manualAdjust = mockData(length, 0, sdError, sdDelta);
+  const manual = prediction.map((x, i) => Math.random() < pManual ? clamp(x + manualAdjust[i], min, max) : x);
+  return {
+    prediction,
+    manual,
+    real
+  };
+}
+export function mockTimeSeries(length, start) {
+  const result = [];
+  if (length <= 0) {
+    return result;
+  }
+  result.push(start);
+  for (let i = 1; i < length; i++) {
+    result.push(start.add(15 * i, "minutes"));
+  }
+  return result;
+}

package/dist/utils/normalizeIntoArray.d.ts

@@ -0,0 +1 @@
+export declare function normalizeIntoArray<T extends object>(value: T | T[] | undefined): T[];

package/dist/utils/normalizeIntoArray.js

@@ -0,0 +1,3 @@
+export function normalizeIntoArray(value) {
+  return value === undefined ? [] : Array.isArray(value) ? value : [value];
+}

package/dist/utils/startOfQuarter.d.ts

@@ -0,0 +1,2 @@
+import type { Dayjs } from "dayjs";
+export declare function startOfQuarter(date: Dayjs): Dayjs;

package/dist/utils/startOfQuarter.js

@@ -0,0 +1,4 @@
+export function startOfQuarter(date) {
+  date = date.startOf("minute");
+  return date.subtract(date.minute() % 15, "minutes");
+}

package/dist/utils/timeAxisLabel.d.ts

@@ -0,0 +1,5 @@
+import { type Dayjs } from "dayjs";
+import type { XAXisComponentOption } from "echarts";
+export default function timeAxisLabel(startTime: Dayjs, endTime: Dayjs): (XAXisComponentOption & {
+    type: "time";
+})["axisLabel"];

package/dist/utils/timeAxisLabel.js

@@ -0,0 +1,18 @@
+import dayjs from "dayjs";
+export default function timeAxisLabel(startTime, endTime) {
+  return {
+    formatter: endTime.diff(startTime, "day", true) <= 1 ? value => dayjs(value).isSame(endTime) && endTime.hour() === 0 ? "24:00" : "{HH}:{mm}" : value => {
+      const time = dayjs(value);
+      if (time.hour() === 0 && time.minute() === 0) {
+        return "{date|{MM}-{dd}}";
+      } else {
+        return "{HH}:{mm}";
+      }
+    },
+    rich: {
+      date: {
+        fontWeight: "bold"
+      }
+    }
+  };
+}

package/package.json

@@ -1,31 +1,39 @@
 {
   "name": "@tsingroc/tsingroc-components",
-  "version": "5.0.0-alpha.11",
+  "version": "5.0.0-alpha.13",
   "author": "",
   "license": "ISC",
   "description": "",
   "keywords": [],
   "type": "module",
-  "main": "src/index.ts",
+  "main": "./dist/index.js",
   "sideEffects": [
     "**/*.css"
   ],
   "exports": {
-    ".": "./src/index.ts",
-    "./echarts": "./src/echarts/index.ts",
-    "./echarts/gl": "./src/echarts/gl.ts",
-    "./utils/*": "./src/utils/*.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./echarts": {
+      "types": "./dist/echarts/index.d.ts",
+      "default": "./dist/echarts/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "default": "./dist/utils/index.js"
+    }
   },
   "files": [
-    "src"
+    "dist"
   ],
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "dev": "rspress",
     "lint": "eslint .",
     "format": "prettier . -w && eslint . --fix",
-    "build": "tsc -b --force && copyfiles -u 1 src/**/*.d.ts dist",
-    "prepublishOnly": "tsc -b --force",
+    "build": "rm -rf dist && (npx babel src --out-dir dist --extensions .ts,.tsx & tsc -p tsconfig.lib.json & copyfiles src/**/*.css dist --up 1 & wait)",
+    "prepublishOnly": "npm run build",
     "docs:build": "rspress build",
     "docs:preview": "rspress preview"
   },
@@ -41,10 +49,10 @@
   },
   "peerDependencies": {
     "@ant-design/icons": "^6.0.0",
+    "@ant-design/v5-patch-for-react-19": "^1.0.3",
     "antd": "^5.27.5",
     "antd-style": "^3.7.1",
     "echarts": "^5.6.0 || ^6.0.0",
-    "echarts-for-react": "^3.0.2",
     "echarts-gl": "^2.0.9",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"
@@ -52,18 +60,22 @@
   "devDependencies": {
     "@ant-design/icons": "^6.1.0",
     "@ant-design/v5-patch-for-react-19": "^1.0.3",
+    "@babel/cli": "^7.28.3",
+    "@babel/core": "^7.28.4",
+    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-typescript": "^7.27.1",
     "@eslint/js": "^9.38.0",
     "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
     "@rspress/core": "^2.0.0-beta.34",
     "@rspress/plugin-preview": "^2.0.0-beta.34",
-    "@types/node": "^22.18.11",
+    "@types/node": "^22.18.12",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
-    "antd": "^5.27.5",
+    "antd": "^5.27.6",
     "antd-style": "^3.7.1",
+    "babel-plugin-react-compiler": "^1.0.0",
     "copyfiles": "^2.4.1",
     "echarts": "^6.0.0",
-    "echarts-for-react": "^3.0.4",
     "echarts-gl": "^2.0.9",
     "eslint": "^9.38.0",
     "eslint-plugin-react-hooks": "^7.0.0",
@@ -75,7 +87,7 @@
     "remark-gfm": "^4.0.1",
     "typedoc": "^0.28.14",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.1"
+    "typescript-eslint": "^8.46.2"
   },
   "overrides": {
     "echarts-gl": {