@go-wind/admin-react 0.1.0 → 0.2.0

package/dist/components/ListTable/ResizableHeaderCell.d.ts

@@ -0,0 +1,31 @@
+import type { ThHTMLAttributes } from 'react';
+/** 拖拽调整列宽的下限（px），防止把一列拖没 */
+export declare const MIN_COLUMN_WIDTH = 60;
+/**
+ * ListTable 经 column.onHeaderCell 注入、随 rc-table 的 additionalProps 铺到表头 th 上的
+ * 拖拽参数。只有这些键会被本组件摘走，其余属性原样透传给 <th>（含排序注入的 onClick）。
+ */
+export interface ResizableCellProps {
+    'data-resize-key'?: string;
+    onResizeStart?: (info: {
+        key: string;
+        width: number;
+        allWidths: Record<string, number>;
+        containerWidth: number;
+    }) => void;
+    onResize?: (key: string, width: number) => void;
+    onResizeEnd?: () => void;
+    onResizeReset?: () => void;
+    resizing?: boolean;
+    resizeTitle?: string;
+}
+type HeaderCellProps = ResizableCellProps & ThHTMLAttributes<HTMLTableCellElement>;
+/**
+ * 表头单元格的列宽拖拽把手。热区是列右缘的隐形 span：pointerdown 起 pointer capture 全程
+ * 接管指针（移出表头也不丢事件），按下时把当前表头行所有列的渲染宽度上报给 ListTable 做
+ * 「首拖锁定」，移动中持续回报新宽度，双击把手恢复自适应。
+ *
+ * 不引第三方库：react-resizable 年久失修不兼容 React 19，指针事件自持足够。
+ */
+export declare function ResizableHeaderCell(props: HeaderCellProps): import("react").JSX.Element;
+export default ResizableHeaderCell;

package/dist/components/ListTable/TableSkeleton.d.ts

@@ -0,0 +1,25 @@
+import type { TableProps } from 'antd';
+import type { ProColumns } from '@ant-design/pro-components';
+export interface TableSkeletonProps<RecordType extends Record<string, any>> {
+    columns?: ProColumns<RecordType>[];
+    rows: number;
+    size?: TableProps<RecordType>['size'];
+    bordered?: boolean;
+    /**
+     * 横向 scroll：决定骨架的列宽能否与真实表格逐列对齐。
+     * 纵向 scroll：真实表格有它就必须一起接——那层限高 `.ant-table-body` 是分页器落点的决定者，
+     * 骨架少了它就只能按 rows 撑高，首屏→数据到位会让分页器整段跳动。
+     */
+    scrollX?: number | string | true;
+    scrollY?: number | string;
+    pagination?: TableProps<RecordType>['pagination'];
+}
+/**
+ * 列表首屏骨架。
+ *
+ * 直接用 antd Table 当量具：表头底色、列宽、边框、字号、暗色 token 全部由页面自己的
+ * columns 与组件主题供给，占位条只替换单元格 render——自画一份灰块会跟真实表格对不齐，
+ * 尤其在有 fixed 列 / scroll.x / bordered 的页面上。
+ */
+export declare function TableSkeleton<RecordType extends Record<string, any>>({ columns, rows, size, bordered, scrollX, scrollY, pagination, }: TableSkeletonProps<RecordType>): import("react").JSX.Element;
+export default TableSkeleton;

package/dist/components/ListTable/index.d.ts

@@ -0,0 +1,20 @@
+import type { ProTableProps } from '@ant-design/pro-components';
+import './list-table.css';
+type ListTableProps<RecordType extends Record<string, any>, Params extends Record<string, any> = Record<string, any>> = ProTableProps<RecordType, Params>;
+/**
+ * 列表页统一表格：在 ProTable 之上补四件页面各自都没有的事——首屏骨架屏（按页面 columns 生成，
+ * 受偏好设置 transition.loading 控制）、快响应不闪的 Spin（delay）、请求失败的错误态与重试、
+ * 以及**高度自动撑满**。
+ *
+ * 高度契约（2026-10-22 起）：页面不传 scroll.y 时，本组件自动接管撑满——内部测量容器
+ * （.listtable-fill）+ useProTableScrollY 把分页器钉在容器底，要求外层是 ContentContainer
+ * 这类 flex 列容器（非 flex 父级时自动退回自然高度，Drawer 内嵌表等场景不误伤）。
+ * 页面显式传了 scroll.y 则完全尊重（历史页面的手写样板照常工作，新页面不要再写）。
+ * 页面只需：<ContentContainer><ListTable …/></ContentContainer>。
+ *
+ * 页面把 `<ProTable>` 换成 `<ListTable>` 即可，request / columns / actionRef 用法不变。
+ */
+export declare function ListTable<RecordType extends Record<string, any>, Params extends Record<string, any> = Record<string, any>>(props: ListTableProps<RecordType, Params> & {
+    striped?: boolean;
+}): import("react").JSX.Element;
+export default ListTable;

package/dist/constants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 表格通用默认配置（自 go-wind-admin 的 config/constants.TABLE 迁入——
+ * ListTable 的默认分页/高度/滚动参数，宿主可在组件 props 层覆盖具体值）。
+ */
+export declare const TABLE: {
+    /** 默认每页条数 */
+    readonly DEFAULT_PAGE_SIZE: 20;
+    /** 每页条数选项 */
+    readonly PAGE_SIZE_OPTIONS: readonly ["10", "20", "50", "100"];
+    /** 最大每页条数 */
+    readonly MAX_PAGE_SIZE: 100;
+    /** 表格组件内部高度 */
+    readonly COMPONENT_HEIGHTS: {
+        /** 工具栏高度 */
+        readonly TOOLBAR: 50;
+        /** 分页器高度 */
+        readonly PAGINATION: 50;
+        /** 表头高度 */
+        readonly HEADER: 50;
+        /** 搜索表单高度（展开时） */
+        readonly SEARCH_FORM: 80;
+    };
+    /** 表格滚动配置 */
+    readonly SCROLL_CONFIG: {
+        /** 默认最小高度 */
+        readonly MIN_HEIGHT: 300;
+        /** 额外边距 */
+        readonly OFFSET: 16;
+    };
+};

package/dist/hooks/useClipboard.d.ts

@@ -0,0 +1,3 @@
+type CopyHandler = (text: string) => Promise<boolean>;
+export declare function useClipboard(): [boolean, string, CopyHandler];
+export {};

package/dist/hooks/useEcharts.d.ts

@@ -0,0 +1,10 @@
+import * as echarts from 'echarts/core';
+import type { BarSeriesOption, GaugeSeriesOption, LineSeriesOption, PictorialBarSeriesOption, PieSeriesOption, RadarSeriesOption, ScatterSeriesOption } from 'echarts/charts';
+import type { DatasetComponentOption, GridComponentOption, LegendComponentOption, TitleComponentOption, ToolboxComponentOption, TooltipComponentOption } from 'echarts/components';
+export type ECOption = echarts.ComposeOption<BarSeriesOption | LineSeriesOption | PieSeriesOption | ScatterSeriesOption | PictorialBarSeriesOption | RadarSeriesOption | GaugeSeriesOption | TitleComponentOption | LegendComponentOption | TooltipComponentOption | GridComponentOption | ToolboxComponentOption | DatasetComponentOption>;
+/**
+ * 使用Echarts
+ * @param options -  绘制echarts的参数
+ * @param data -  数据
+ */
+export declare const useEcharts: (options: echarts.EChartsCoreOption, data?: unknown) => readonly [import("react").RefObject<HTMLDivElement | null>, import("react").RefObject<echarts.ECharts | null>];

package/dist/hooks/useKeyStroke.d.ts

@@ -0,0 +1,13 @@
+interface Options {
+    ArrowUp?: () => void;
+    ArrowDown?: () => void;
+    ArrowLeft?: () => void;
+    ArrowRight?: () => void;
+    Enter?: () => void;
+}
+/**
+ * 键盘按键事件
+ * @param options
+ */
+export declare function useKeyStroke(options: Options): readonly [(even: KeyboardEvent) => void];
+export {};

package/dist/hooks/usePageFullscreen.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 页面级全屏：元素 fullscreen + 进入时补页面底色（fullscreen 元素默认透出 UA 黑底）。
+ * 退出（含 ESC）由 fullscreenchange 事件驱动清理内联底色。
+ */
+export declare function usePageFullscreen<T extends HTMLElement>(): {
+    rootRef: import("react").RefObject<T | null>;
+    isFullscreen: boolean;
+    toggle: () => void;
+};

package/dist/hooks/useWatermark.d.ts

@@ -0,0 +1,20 @@
+interface Option {
+    content: string;
+    height: number;
+    width: number;
+    rotate: number;
+    color: string;
+    fontSize: number;
+    opacity: number;
+}
+/**
+ * 水印
+ *
+ * @deprecated 此 hook 当前在全项目内无任何调用方，且实现存在隐患：
+ * 1) 未监听 window resize，窗口尺寸变化后水印不会重绘；
+ * 2) 尺寸基于 document.body 计算，body 高度为 0 时（如路由切换瞬间）覆盖不全；
+ * 3) 作为普通函数而非 React hook，调用方需自行管理生命周期。
+ * 启用前请先补全上述问题，否则按需删除。
+ */
+export declare function useWatermark(): readonly [(options: Option) => void, () => void];
+export {};

package/dist/i18n/config/i18n.d.ts

@@ -4,8 +4,8 @@ import { type SupportedLocale } from '../../locales';
  * 文案 = 包内置框架命名空间（coreResources）+ 宿主业务命名空间合并后传入。
  */
 export interface InitI18nOptions {
-    /** 合并后的完整语言资源（语言 -> 命名空间 -> 文案） */
-    resources: Record<string, Record<string, Record<string, unknown>>>;
+    /** 合并后的完整语言资源（语言 -> 命名空间 -> 文案；i18next Resource 兼容形状） */
+    resources: Record<string, unknown>;
     /** 全部命名空间列表（一般取 merged['zh-CN'] 的键） */
     namespaces: string[];
     /** 支持的语言列表（默认 zh-CN/en-US） */

package/dist/index.d.ts

@@ -30,5 +30,12 @@ export * from './hooks/useTokenRefresh';
 export * from './hooks/useTitle';
 export * from './hooks/useTime';
 export * from './hooks/useProTableScrollY';
+export * from './hooks/useClipboard';
+export * from './hooks/useKeyStroke';
+export * from './hooks/usePageFullscreen';
+export * from './hooks/useEcharts';
+export * from './hooks/useWatermark';
 export * from './utils';
+export * from './constants';
+export * from './components/ListTable';
 export { default as ThemeLoading } from './components/Loading';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-wind/admin-react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React 19 admin shell mechanisms extracted from go-wind-admin: axios transport (token rotation/captcha headers), SSE client, auth store with injectable AuthGateway, route factory (frontend/backend access modes), access control, i18n engine, theme/preferences, query client, generic hooks & utils.",
   "type": "module",
   "license": "MIT",
@@ -41,18 +41,23 @@
     "@microsoft/fetch-event-source": "^2.0.1",
     "axios": "^1.16.1",
     "dayjs": "^1.11.20",
+    "echarts": "^6.1.0",
+    "lodash": "^4.17.21",
     "nprogress": "^0.2.0"
   },
   "devDependencies": {
     "@ant-design/icons": "^5.6.1",
     "@ant-design/pro-components": "^2.8.10",
     "@tanstack/react-query": "^5.100.11",
+    "@testing-library/react": "^16.3.2",
+    "@types/lodash": "^4.17.21",
     "@types/nprogress": "^0.2.3",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
     "antd": "^6.4.3",
     "i18next": "^26.2.0",
+    "jsdom": "^29.1.1",
     "less": "^4.6.4",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
@@ -60,6 +65,7 @@
     "react-router-dom": "^6.26.0",
     "typescript": "^5.9.3",
     "vite": "^8.0.0",
+    "vitest": "^4.1.6",
     "zustand": "^5.0.13"
   },
   "publishConfig": {
@@ -68,6 +74,7 @@
   },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/flatten-dts.mjs",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   }
 }