@tsingroc/tsingroc-components 5.0.1 → 5.1.0

package/dist/pages/DayAheadReviewPage/layout/RightSummaryContainer.js

@@ -0,0 +1,199 @@
+import { c as _c } from "react/compiler-runtime";
+import Card from "antd/es/card";
+import { useMemo } from "react";
+import { LoadingSkeleton } from "#src/components/LoadingSkeleton";
+import RevenueSummaryCard from "../components/RevenueSummaryCard";
+import SummaryTable from "../components/SummaryTable";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+const RightSummaryContainer = t0 => {
+  const $ = _c(30);
+  const {
+    data,
+    date,
+    hasManualData,
+    filterValue,
+    loading: t1,
+    profitAgentData,
+    profitManualData,
+    onExport
+  } = t0;
+  const loading = t1 === undefined ? false : t1;
+  let t2;
+  if ($[0] !== profitAgentData) {
+    t2 = profitAgentData ?? [];
+    $[0] = profitAgentData;
+    $[1] = t2;
+  } else {
+    t2 = $[1];
+  }
+  const agentProfits = t2;
+  let t3;
+  if ($[2] !== profitManualData) {
+    t3 = profitManualData ?? [];
+    $[2] = profitManualData;
+    $[3] = t3;
+  } else {
+    t3 = $[3];
+  }
+  const manualProfits = t3;
+  let t4;
+  if ($[4] !== agentProfits) {
+    t4 = agentProfits.reduce(_temp, 0);
+    $[4] = agentProfits;
+    $[5] = t4;
+  } else {
+    t4 = $[5];
+  }
+  let t5;
+  if ($[6] !== agentProfits) {
+    t5 = agentProfits.reduce(_temp2, 0);
+    $[6] = agentProfits;
+    $[7] = t5;
+  } else {
+    t5 = $[7];
+  }
+  let t6;
+  if ($[8] !== agentProfits) {
+    t6 = agentProfits.reduce(_temp3, 0);
+    $[8] = agentProfits;
+    $[9] = t6;
+  } else {
+    t6 = $[9];
+  }
+  let t7;
+  if ($[10] !== manualProfits) {
+    t7 = manualProfits.reduce(_temp4, 0);
+    $[10] = manualProfits;
+    $[11] = t7;
+  } else {
+    t7 = $[11];
+  }
+  let t8;
+  if ($[12] !== t4 || $[13] !== t5 || $[14] !== t6 || $[15] !== t7) {
+    t8 = {
+      agentProfitTotal: t4,
+      agentStrategyAddTotal: t5,
+      agentPredictBaselineTotal: t6,
+      manualProfitTotal: t7
+    };
+    $[12] = t4;
+    $[13] = t5;
+    $[14] = t6;
+    $[15] = t7;
+    $[16] = t8;
+  } else {
+    t8 = $[16];
+  }
+  const {
+    agentProfitTotal,
+    agentStrategyAddTotal,
+    agentPredictBaselineTotal,
+    manualProfitTotal
+  } = t8;
+  let t10;
+  let t9;
+  if ($[17] === Symbol.for("react.memo_cache_sentinel")) {
+    t9 = {
+      flex: 1,
+      minHeight: 0,
+      display: "flex",
+      flexDirection: "column",
+      border: 0
+    };
+    t10 = {
+      body: {
+        padding: 16,
+        display: "flex",
+        flexDirection: "column",
+        gap: 12,
+        flex: 1,
+        minHeight: 0
+      }
+    };
+    $[17] = t10;
+    $[18] = t9;
+  } else {
+    t10 = $[17];
+    t9 = $[18];
+  }
+  let t11;
+  if ($[19] !== agentPredictBaselineTotal || $[20] !== agentProfitTotal || $[21] !== agentStrategyAddTotal || $[22] !== data || $[23] !== date || $[24] !== filterValue || $[25] !== hasManualData || $[26] !== loading || $[27] !== manualProfitTotal || $[28] !== onExport) {
+    t11 = /*#__PURE__*/_jsx(Card, {
+      style: t9,
+      styles: t10,
+      children: loading ? /*#__PURE__*/_jsxs(_Fragment, {
+        children: [/*#__PURE__*/_jsx("div", {
+          style: {
+            flexShrink: 0
+          },
+          children: /*#__PURE__*/_jsx(LoadingSkeleton, {
+            type: "summary",
+            rows: 2
+          })
+        }), /*#__PURE__*/_jsx("div", {
+          style: {
+            flex: 1,
+            minHeight: 0
+          },
+          children: /*#__PURE__*/_jsx(LoadingSkeleton, {
+            type: "table",
+            rows: 8
+          })
+        })]
+      }) : /*#__PURE__*/_jsxs(_Fragment, {
+        children: [/*#__PURE__*/_jsx("div", {
+          style: {
+            flexShrink: 0
+          },
+          children: /*#__PURE__*/_jsx(RevenueSummaryCard, {
+            hasManualData: hasManualData,
+            filterValue: filterValue,
+            agent_profit: agentProfitTotal,
+            agent_strategy_add: agentStrategyAddTotal,
+            agent_predict_baseline: agentPredictBaselineTotal,
+            manual_profit: manualProfitTotal
+          })
+        }), /*#__PURE__*/_jsx("div", {
+          style: {
+            flex: 1,
+            minHeight: 0,
+            display: "flex"
+          },
+          children: /*#__PURE__*/_jsx(SummaryTable, {
+            data: data,
+            tradingDay: date.format("YYYY-MM-DD"),
+            filterValue: filterValue,
+            onExport: onExport
+          })
+        })]
+      })
+    });
+    $[19] = agentPredictBaselineTotal;
+    $[20] = agentProfitTotal;
+    $[21] = agentStrategyAddTotal;
+    $[22] = data;
+    $[23] = date;
+    $[24] = filterValue;
+    $[25] = hasManualData;
+    $[26] = loading;
+    $[27] = manualProfitTotal;
+    $[28] = onExport;
+    $[29] = t11;
+  } else {
+    t11 = $[29];
+  }
+  return t11;
+};
+export default RightSummaryContainer;
+function _temp(sum, item) {
+  return sum + (item.agentProfit ?? 0);
+}
+function _temp2(sum_0, item_0) {
+  return sum_0 + (item_0.agentStrategyAdd ?? 0);
+}
+function _temp3(sum_1, item_1) {
+  return sum_1 + (item_1.agentPredictBaseline ?? 0);
+}
+function _temp4(sum_2, item_2) {
+  return sum_2 + (item_2.manualProfit ?? 0);
+}

package/dist/pages/DayAheadReviewPage/layout/TopDayReviewHeader.d.ts

@@ -0,0 +1,9 @@
+import { type Dayjs } from "dayjs";
+interface TopHeaderProps {
+    date: Dayjs;
+    setDate: (date: Dayjs) => void;
+    /** Optional disabled date function - if not provided, uses useDayAheadTradingDays hook */
+    disabledDate?: (current: Dayjs | null) => boolean;
+}
+declare const TopHeader: ({ date, setDate, disabledDate: disabledDateProp }: TopHeaderProps) => import("react/jsx-runtime").JSX.Element;
+export default TopHeader;

package/dist/pages/DayAheadReviewPage/layout/TopDayReviewHeader.js

@@ -0,0 +1,115 @@
+import { c as _c } from "react/compiler-runtime";
+import { DatePicker } from "antd";
+import dayjs from "dayjs";
+import { useDayAheadTradingDays } from "#src/utils/presenters";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const TopHeader = t0 => {
+  const $ = _c(12);
+  const {
+    date,
+    setDate,
+    disabledDate: disabledDateProp
+  } = t0;
+  const {
+    disabledDate: disabledDateFromHook
+  } = useDayAheadTradingDays();
+  const disabledDate = disabledDateProp ?? disabledDateFromHook;
+  let t1;
+  let t2;
+  let t3;
+  if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+    t1 = {
+      display: "flex",
+      justifyContent: "space-between",
+      alignItems: "center"
+    };
+    t2 = {
+      display: "flex",
+      alignItems: "center",
+      gap: 24
+    };
+    t3 = /*#__PURE__*/_jsx("h2", {
+      style: {
+        margin: 0,
+        color: "#333",
+        fontStyle: "italic"
+      },
+      children: "\u65E5\u524D\u4EA4\u6613\u590D\u76D8"
+    });
+    $[0] = t1;
+    $[1] = t2;
+    $[2] = t3;
+  } else {
+    t1 = $[0];
+    t2 = $[1];
+    t3 = $[2];
+  }
+  let t4;
+  if ($[3] !== setDate) {
+    t4 = value => setDate(value ?? dayjs());
+    $[3] = setDate;
+    $[4] = t4;
+  } else {
+    t4 = $[4];
+  }
+  let t5;
+  if ($[5] !== date || $[6] !== disabledDate || $[7] !== t4) {
+    t5 = /*#__PURE__*/_jsxs("div", {
+      style: t2,
+      children: [t3, /*#__PURE__*/_jsx(DatePicker, {
+        value: date,
+        onChange: t4,
+        allowClear: false,
+        disabledDate: disabledDate
+      })]
+    });
+    $[5] = date;
+    $[6] = disabledDate;
+    $[7] = t4;
+    $[8] = t5;
+  } else {
+    t5 = $[8];
+  }
+  let t6;
+  if ($[9] === Symbol.for("react.memo_cache_sentinel")) {
+    t6 = /*#__PURE__*/_jsxs("div", {
+      style: {
+        display: "flex",
+        alignItems: "baseline",
+        gap: 12
+      },
+      children: [/*#__PURE__*/_jsx("span", {
+        style: {
+          color: "var(--ant-color-text-label)"
+        },
+        children: "\u7535\u91CF\u5355\u4F4D:MWh"
+      }), /*#__PURE__*/_jsx("span", {
+        style: {
+          color: "var(--ant-color-text-label)"
+        },
+        children: "\u7535\u4EF7\u5355\u4F4D:\u5143/MWh"
+      }), /*#__PURE__*/_jsx("span", {
+        style: {
+          color: "var(--ant-color-text-label)"
+        },
+        children: "\u4EF7\u683C\u5355\u4F4D:\u5143"
+      })]
+    });
+    $[9] = t6;
+  } else {
+    t6 = $[9];
+  }
+  let t7;
+  if ($[10] !== t5) {
+    t7 = /*#__PURE__*/_jsxs("div", {
+      style: t1,
+      children: [t5, t6]
+    });
+    $[10] = t5;
+    $[11] = t7;
+  } else {
+    t7 = $[11];
+  }
+  return t7;
+};
+export default TopHeader;

package/dist/pages/DayAheadReviewPage/types/dayahead.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Application/presentation types for Day-Ahead Review.
+ * Consumed by the presentation layer; mapped from API DTOs in useDayAheadReviewData.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Power/Volume data for the strategy comparison chart.
+ *
+ * Displays forecasted vs actual volumes alongside agent and manual
+ * declared and cleared volumes for performance comparison.
+ *
+ * @example
+ * ```ts
+ * const powerData: StrategyPlotValue = {
+ *   time: "2024-01-01T00:00",
+ *   forecastVolume: 120.5,  // MW
+ *   actualVolume: 118.2,    // MW
+ *   agentDeclaredVolume: 115.0,  // MW
+ *   manualDeclaredVolume: 110.0,  // MW (optional)
+ *   agentClearanceVolume: 100.0,  // MW
+ *   manualClearanceVolume: 95.0,  // MW (optional)
+ * };
+ * ```
+ */
+export interface StrategyPlotValue {
+    /** ISO 8601 timestamp in format `YYYY-MM-DDTHH:mm` (e.g., "2024-01-01T00:00") */
+    time: string;
+    /** Forecasted load volume in MW (兆瓦) - predicted load for the period */
+    forecastVolume?: number | null;
+    /** Actual metered volume in MW (兆瓦) - real-time measured consumption */
+    actualVolume?: number | null;
+    /** Agent-declared bid volume in MW (兆瓦) - AI/algorithmic bid volume submitted to market */
+    agentDeclaredVolume?: number | null;
+    /** Manually-declared bid volume in MW (兆瓦) - human-adjusted bid volume (optional if manual mode not enabled) */
+    manualDeclaredVolume?: number | null;
+    /** Agent-cleared volume in MW (兆瓦) - volume matched in market clearing for agent bids */
+    agentClearanceVolume?: number | null;
+    /** Manually-cleared volume in MW (兆瓦) - volume matched in market clearing for manual bids (optional) */
+    manualClearanceVolume?: number | null;
+}
+/**
+ * Price data for the price trend chart.
+ *
+ * Compares day-ahead market prices with real-time prices and
+ * declared bid prices from both agent and manual strategies.
+ *
+ * @example
+ * ```ts
+ * const priceData: PricePlotValue = {
+ *   time: "2024-01-01T00:00",
+ *   dayAheadPrice: 350.5,     // RMB/MWh
+ *   realTimePrice: 380.2,     // RMB/MWh
+ *   agentDeclaredPrice: 360.0,  // RMB/MWh
+ *   manualDeclaredPrice: 355.0, // RMB/MWh (optional)
+ * };
+ * ```
+ */
+export interface PricePlotValue {
+    /** ISO 8601 timestamp in format `YYYY-MM-DDTHH:mm` (e.g., "2024-01-01T00:00") */
+    time: string;
+    /** Day-ahead market clearing price in RMB/MWh (元/兆瓦时) - official DAM clearing price */
+    dayAheadPrice?: number | null;
+    /** Real-time market price in RMB/MWh (元/兆瓦时) - actual real-time settlement price */
+    realTimePrice?: number | null;
+    /** Agent-declared bid price in RMB/MWh (元/兆瓦时) - price submitted in agent bids */
+    agentDeclaredPrice?: number | null;
+    /** Manually-declared bid price in RMB/MWh (元/兆瓦时) - price submitted in manual bids (optional) */
+    manualDeclaredPrice?: number | null;
+}
+/**
+ * Profit breakdown data for the profit distribution chart.
+ *
+ * Shows total profit with baseline prediction and strategy additive
+ * value for agent, plus optional manual profit for comparison.
+ *
+ * Profit Calculation Formula:
+ * - `agentProfit = (realTimePrice - agentDeclaredPrice) × agentClearanceVolume`
+ * - `agentPredictBaseline = (realTimePrice - dayAheadPrice) × clearanceVolume`
+ * - `agentStrategyAdd = agentProfit - agentPredictBaseline`
+ *
+ * @example
+ * ```ts
+ * const profitData: ProfitPlotValue = {
+ *   time: "2024-01-01T00:00",
+ *   agentProfit: 2015.0,        // RMB
+ *   agentPredictBaseline: 2970.0, // RMB
+ *   agentStrategyAdd: -955.0,   // RMB (negative = strategy underperformed baseline)
+ *   manualProfit: 2375.5,       // RMB (optional)
+ * };
+ * ```
+ */
+export interface ProfitPlotValue {
+    /** ISO 8601 timestamp in format `YYYY-MM-DDTHH:mm` (e.g., "2024-01-01T00:00") */
+    time: string;
+    /** Total agent profit in RMB (元) - final realized profit from agent trading */
+    agentProfit?: number | null;
+    /** Agent baseline profit in RMB (元) - theoretical profit using passive day-ahead price strategy */
+    agentPredictBaseline?: number | null;
+    /** Agent strategy additive value in RMB (元) - marginal contribution of active strategy over baseline (can be negative) */
+    agentStrategyAdd?: number | null;
+    /** Total manual profit in RMB (元) - realized profit from manual trading (optional if manual mode not enabled) */
+    manualProfit?: number | null;
+}
+export interface RevenueSummaryCardProps {
+    agent_profit: number;
+    manual_profit: number;
+}
+export type ReviewSection = "standard" | "thermalQuote";
+/**
+ * Combined data structure for the detail table and profit calculation.
+ *
+ * Extends both {@link StrategyPlotValue} and {@link PricePlotValue} to provide
+ * a comprehensive view of all trading data per time period, including
+ * profit metrics and optional thermal quotation data.
+ *
+ * This is the primary data type used in the detail table and serves as
+ * the source for profit chart data extraction.
+ *
+ * @example
+ * ```ts
+ * const tableRow: ExtendedReviewValue = {
+ *   // From StrategyPlotValue
+ *   time: "2024-01-01T00:00",
+ *   forecastVolume: 120.5,
+ *   actualVolume: 118.2,
+ *   agentDeclaredVolume: 115.0,
+ *   agentClearanceVolume: 100.0,
+ *
+ *   // From PricePlotValue
+ *   dayAheadPrice: 350.5,
+ *   realTimePrice: 380.2,
+ *   agentDeclaredPrice: 360.0,
+ *
+ *   // Extended fields
+ *   clearanceVolume: 100.0,        // MW
+ *   agentProfit: 2015.0,           // RMB
+ *   agentPredictBaseline: 2970.0,  // RMB
+ *   agentStrategyAdd: -955.0,      // RMB
+ *   manualProfit: 2375.5,          // RMB (optional)
+ *   quotation: 385.0,              // RMB/MWh (optional)
+ * };
+ * ```
+ */
+export interface ExtendedReviewValue extends PricePlotValue, StrategyPlotValue {
+    /**
+     * Clearance volume used in profit calculation in MW (兆瓦).
+     * This represents the volume actually settled in the market.
+     */
+    clearanceVolume?: number;
+    /** Total agent profit in RMB (元) - final realized profit from agent trading */
+    agentProfit?: number | null;
+    /** Agent baseline profit in RMB (元) - theoretical profit using passive day-ahead price strategy */
+    agentPredictBaseline?: number | null;
+    /** Agent strategy additive value in RMB (元) - marginal contribution of active strategy (can be negative) */
+    agentStrategyAdd?: number | null;
+    /** Total manual profit in RMB (元) - realized profit from manual trading (optional if manual mode not enabled) */
+    manualProfit?: number | null;
+    /** Thermal power quotation price in RMB/MWh (元/兆瓦时) - reference price for thermal bidding (optional) */
+    quotation?: number;
+}
+export interface TableProps {
+    data: ExtendedReviewValue[];
+    section?: ReviewSection;
+    tradingDay?: string;
+    onExport?: (data: ExtendedReviewValue[], date: string, filename: string) => void;
+}
+export type ProfitDataEndpointResponse = ProfitPlotValue[];
+export type PriceDataEndpointResponse = PricePlotValue[];
+export type PowerDataEndpointResponse = StrategyPlotValue[];
+export type ReviewTableDataEndpointResponse = ExtendedReviewValue[];
+export type FilterOption = "all" | "agent" | "manual";

package/dist/pages/DayAheadReviewPage/types/dayahead.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/accessibility.d.ts

@@ -0,0 +1,114 @@
+import type { ButtonProps, InputProps } from "antd";
+import type { ReactNode } from "react";
+/**
+ * Accessibility utility functions and helpers
+ */
+/**
+ * Generate a unique ID for accessibility attributes
+ */
+export declare function generateAriaId(prefix: string): string;
+/**
+ * Common ARIA labels for UI elements
+ */
+export declare const ARIA_LABELS: {
+    readonly CLOSE: "关闭";
+    readonly OPEN: "打开";
+    readonly MENU: "菜单";
+    readonly SEARCH: "搜索";
+    readonly FILTER: "筛选";
+    readonly EXPORT: "导出";
+    readonly IMPORT: "导入";
+    readonly SAVE: "保存";
+    readonly CANCEL: "取消";
+    readonly CONFIRM: "确认";
+    readonly DELETE: "删除";
+    readonly EDIT: "编辑";
+    readonly ADD: "添加";
+    readonly REMOVE: "移除";
+    readonly REFRESH: "刷新";
+    readonly LOAD_MORE: "加载更多";
+    readonly PREVIOUS_PAGE: "上一页";
+    readonly NEXT_PAGE: "下一页";
+    readonly FIRST_PAGE: "首页";
+    readonly LAST_PAGE: "末页";
+    readonly LOADING: "加载中";
+    readonly SUCCESS: "成功";
+    readonly ERROR: "错误";
+    readonly WARNING: "警告";
+    readonly INFO: "信息";
+};
+/**
+ * ARIA roles for common UI patterns
+ */
+export declare const ARIA_ROLES: {
+    readonly BUTTON: "button";
+    readonly LINK: "link";
+    readonly MENU: "menu";
+    readonly MENUITEM: "menuitem";
+    readonly TAB: "tab";
+    readonly TABPANEL: "tabpanel";
+    readonly TABLIST: "tablist";
+    readonly DIALOG: "dialog";
+    readonly ALERT: "alert";
+    readonly ALERTDIALOG: "alertdialog";
+    readonly STATUS: "status";
+    readonly PROGRESSBAR: "progressbar";
+    readonly SPINBUTTON: "spinbutton";
+    readonly COMBOBOX: "combobox";
+    readonly LISTBOX: "listbox";
+    readonly OPTION: "option";
+    readonly SEARCH: "search";
+    readonly NAVIGATION: "navigation";
+    readonly BANNER: "banner";
+    readonly MAIN: "main";
+    readonly COMPLEMENTARY: "complementary";
+    readonly CONTENTINFO: "contentinfo";
+};
+/**
+ * Accessible button props generator
+ */
+export declare function getAccessibleButtonProps(label: string, props?: Partial<ButtonProps>): ButtonProps & {
+    "aria-label": string;
+};
+/**
+ * Accessible input props generator
+ */
+export declare function getAccessibleInputProps(label: string, props?: Partial<InputProps>): InputProps & {
+    "aria-label": string;
+};
+/**
+ * Generate screen reader only text
+ */
+export declare function ScreenReaderOnly({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Keyboard event handler helpers
+ */
+export declare const keyboard: {
+    /** Check if Enter or Space key was pressed */
+    isActivationKey: (event: KeyboardEvent) => boolean;
+    /** Check if Escape key was pressed */
+    isEscapeKey: (event: KeyboardEvent) => boolean;
+    /** Check if Arrow keys were pressed */
+    isArrowKey: (event: KeyboardEvent) => boolean;
+    /** Check if Tab key was pressed */
+    isTabKey: (event: KeyboardEvent) => boolean;
+};
+/**
+ * Focus management utilities
+ */
+export declare const focus: {
+    /** Trap focus within an element */
+    trapFocus: (element: HTMLElement) => () => void;
+    /** Restore focus to previous element */
+    restoreFocus: (previousElement?: HTMLElement | null) => void;
+};
+/**
+ * Live region announcer for screen readers
+ */
+export declare function announceToScreenReader(message: string, priority?: "polite" | "assertive"): void;
+/**
+ * Get accessible color contrast (WCAG compliance)
+ */
+export declare function getAccessibleColor(_bg: string, _fg: string, _level?: "AA" | "AAA"): boolean;