@pnt-team/pnt-component-frontend 0.0.132 → 0.0.134

package/lib/cjs/components/PntTable/useTableCore.js

@@ -0,0 +1,509 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PntTable/useTableCore.ts
+var useTableCore_exports = {};
+__export(useTableCore_exports, {
+  clampPage: () => clampPage,
+  cycleSort: () => cycleSort,
+  useTableCore: () => useTableCore,
+  validateColumnConflicts: () => validateColumnConflicts,
+  validateJumpPage: () => validateJumpPage
+});
+module.exports = __toCommonJS(useTableCore_exports);
+var import_react = require("react");
+var RequestManager = class {
+  constructor() {
+    this.requestIdCounter = 0;
+    this.abortController = null;
+  }
+  nextId() {
+    if (this.abortController) {
+      try {
+        this.abortController.abort();
+      } catch {
+      }
+    }
+    this.abortController = new AbortController();
+    return ++this.requestIdCounter;
+  }
+  isLatest(id) {
+    return id === this.requestIdCounter;
+  }
+  abortCurrent() {
+    if (this.abortController) {
+      try {
+        this.abortController.abort();
+      } catch {
+      }
+      this.abortController = null;
+    }
+  }
+};
+function cycleSort(currentField, currentDir, targetField) {
+  if (currentField !== targetField) {
+    return { field: targetField, direction: "asc" };
+  }
+  if (currentDir === void 0 || currentDir === null)
+    return { field: targetField, direction: "asc" };
+  if (currentDir === "asc")
+    return { field: targetField, direction: "desc" };
+  return null;
+}
+function clampPage(page, total, pageSize) {
+  const maxPage = Math.max(1, Math.ceil(total / pageSize));
+  if (page < 1)
+    return 1;
+  if (page > maxPage)
+    return maxPage;
+  return page;
+}
+function validateJumpPage(page, total, pageSize) {
+  const maxPage = Math.max(1, Math.ceil(total / pageSize));
+  if (!Number.isInteger(page) || page < 1 || page > maxPage) {
+    return `请输入 1–${maxPage} 的整数页码`;
+  }
+  return null;
+}
+function validateColumnConflicts(columns) {
+  const errors = [];
+  columns.forEach((col) => {
+    if (col.sort && col.headerFilter) {
+      errors.push(
+        `[PntTable] 列 "${col.key}" 同时配置了 sort 和 headerFilter，违反 TBL-01.03 互斥规则。 如需该字段同时排序+筛选，表头保留 sort，筛选移至 externalFilter（独立查询区）。`
+      );
+    }
+  });
+  return errors;
+}
+function useTableCore(props) {
+  const {
+    tableId,
+    rowKey,
+    columns,
+    dataMode,
+    fetcher,
+    data: clientData,
+    total: clientTotal,
+    initialPage = 1,
+    pageSize: initialPageSize = 10,
+    businessId,
+    env,
+    timezone,
+    onQueryChange,
+    onSelectionChange,
+    selectable = false,
+    currentPageOnly = true
+  } = props;
+  const reqMgrRef = (0, import_react.useRef)(new RequestManager());
+  const [requestId, setRequestId] = (0, import_react.useState)(0);
+  const [state, setState] = (0, import_react.useState)(() => {
+    var _a;
+    const initialRows = dataMode === "client" ? clientData != null ? clientData : [] : [];
+    return {
+      data: initialRows,
+      total: dataMode === "client" ? (_a = clientTotal != null ? clientTotal : clientData == null ? void 0 : clientData.length) != null ? _a : 0 : 0,
+      status: dataMode === "client" ? initialRows.length === 0 ? "empty" : "normal" : "loading",
+      error: null,
+      sort: null,
+      appliedFilters: {},
+      page: initialPage,
+      pageSize: initialPageSize,
+      selection: /* @__PURE__ */ new Set()
+    };
+  });
+  (0, import_react.useEffect)(() => {
+    if (dataMode !== "client")
+      return;
+    const rows = clientData != null ? clientData : [];
+    setState((prev) => {
+      const hasAppliedFilter = Object.values(prev.appliedFilters).some(
+        (v) => v !== void 0 && v !== null && v !== ""
+      );
+      return {
+        ...prev,
+        data: rows,
+        total: clientTotal != null ? clientTotal : rows.length,
+        status: rows.length === 0 ? hasAppliedFilter ? "empty-with-filter" : "empty" : "normal",
+        error: null
+      };
+    });
+  }, [dataMode, clientData, clientTotal]);
+  const setStatePartial = (0, import_react.useCallback)((patch) => {
+    setState((prev) => ({ ...prev, ...patch }));
+  }, []);
+  const triggerFetch = (0, import_react.useCallback)(
+    async (trigger, snapshot) => {
+      var _a, _b;
+      if (dataMode !== "server" || !fetcher)
+        return;
+      const thisReqId = reqMgrRef.current.nextId();
+      const query = {
+        query: {},
+        // 独立查询区（组件不维护，由业务项目维护并透传）
+        filters: snapshot.appliedFilters,
+        sort: snapshot.sort,
+        page: snapshot.page,
+        pageSize: snapshot.pageSize,
+        businessId,
+        env,
+        timezone
+      };
+      onQueryChange == null ? void 0 : onQueryChange(query, { tableId, trigger, requestId: thisReqId });
+      setStatePartial({
+        status: snapshot.page > 1 || requestId > 0 ? "refreshing" : "loading"
+      });
+      try {
+        const res = await fetcher(query);
+        if (!reqMgrRef.current.isLatest(thisReqId))
+          return;
+        if (res.noPermission) {
+          setStatePartial({
+            status: "no-permission",
+            error: null,
+            data: [],
+            total: 0
+          });
+          setRequestId(thisReqId);
+          return;
+        }
+        if (res.code !== void 0 && res.code !== 0) {
+          setStatePartial({ status: "error", error: res.msg || "" });
+          setRequestId(thisReqId);
+          return;
+        }
+        const rows = (_a = res.rows) != null ? _a : [];
+        setStatePartial({
+          data: rows,
+          total: (_b = res.total) != null ? _b : rows.length,
+          status: rows.length === 0 ? Object.values(snapshot.appliedFilters).some(
+            (v) => v !== void 0 && v !== null && v !== ""
+          ) ? "empty-with-filter" : "empty" : "normal",
+          error: null
+        });
+        setRequestId(thisReqId);
+      } catch (err) {
+        if (!reqMgrRef.current.isLatest(thisReqId))
+          return;
+        if ((err == null ? void 0 : err.name) === "AbortError")
+          return;
+        setStatePartial({ status: "error", error: (err == null ? void 0 : err.message) || "" });
+        setRequestId(thisReqId);
+      }
+    },
+    [
+      dataMode,
+      fetcher,
+      tableId,
+      businessId,
+      env,
+      timezone,
+      onQueryChange,
+      requestId,
+      setStatePartial
+    ]
+  );
+  (0, import_react.useEffect)(() => {
+    if (dataMode === "server" && fetcher) {
+      const page = initialPage;
+      const pageSize = state.pageSize;
+      setStatePartial({ page, pageSize });
+      triggerFetch("initial", {
+        sort: null,
+        appliedFilters: {},
+        page,
+        pageSize
+      });
+    }
+  }, [tableId, dataMode]);
+  const toggleSort = (0, import_react.useCallback)(
+    (field) => {
+      if (dataMode !== "server")
+        return;
+      const col = columns.find((c) => c.key === field);
+      if (!col || col.sort === false)
+        return;
+      setState((prev) => {
+        var _a, _b, _c, _d;
+        const newSort = cycleSort(
+          (_b = (_a = prev.sort) == null ? void 0 : _a.field) != null ? _b : null,
+          (_c = prev.sort) == null ? void 0 : _c.direction,
+          field
+        );
+        const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+        const clearedPage = ((_d = prev.sort) == null ? void 0 : _d.field) !== field ? prev.page : prev.page;
+        const newPage = newSort ? 1 : clearedPage;
+        const next = {
+          ...prev,
+          sort: newSort,
+          page: newPage,
+          selection: clearedSelection
+        };
+        if (newSort) {
+          triggerFetch("sort", {
+            sort: newSort,
+            appliedFilters: next.appliedFilters,
+            page: newPage,
+            pageSize: next.pageSize
+          });
+        } else if (prev.sort) {
+          triggerFetch("sort", {
+            sort: null,
+            appliedFilters: next.appliedFilters,
+            page: newPage,
+            pageSize: next.pageSize
+          });
+        }
+        return next;
+      });
+    },
+    [dataMode, columns, triggerFetch, currentPageOnly]
+  );
+  const applyFilters = (0, import_react.useCallback)(
+    (filters) => {
+      const normalized = {};
+      Object.entries(filters).forEach(([k, v]) => {
+        if (Array.isArray(v) && v.length === 0)
+          return;
+        if (v === void 0 || v === null || v === "")
+          return;
+        normalized[k] = v;
+      });
+      setState((prev) => {
+        const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+        const next = {
+          ...prev,
+          appliedFilters: normalized,
+          page: 1,
+          // 筛选变更回 1 页（TBL-04.05）
+          selection: clearedSelection
+        };
+        triggerFetch("filter", {
+          sort: next.sort,
+          appliedFilters: normalized,
+          page: 1,
+          pageSize: next.pageSize
+        });
+        return next;
+      });
+    },
+    [triggerFetch, currentPageOnly]
+  );
+  const resetFilters = (0, import_react.useCallback)(() => {
+    setState((prev) => {
+      const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+      const next = {
+        ...prev,
+        appliedFilters: {},
+        page: 1,
+        selection: clearedSelection
+      };
+      triggerFetch("reset", {
+        sort: next.sort,
+        appliedFilters: {},
+        page: 1,
+        pageSize: next.pageSize
+      });
+      return next;
+    });
+  }, [triggerFetch, currentPageOnly]);
+  const setPage = (0, import_react.useCallback)(
+    (page) => {
+      if (dataMode !== "server")
+        return;
+      setState((prev) => {
+        const validated = clampPage(page, prev.total, prev.pageSize);
+        if (validated === prev.page)
+          return prev;
+        const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+        const next = { ...prev, page: validated, selection: clearedSelection };
+        triggerFetch("pagination", {
+          sort: next.sort,
+          appliedFilters: next.appliedFilters,
+          page: validated,
+          pageSize: next.pageSize
+        });
+        return next;
+      });
+    },
+    [dataMode, triggerFetch, currentPageOnly]
+  );
+  const setPageSize = (0, import_react.useCallback)(
+    (size) => {
+      if (dataMode !== "server")
+        return;
+      setState((prev) => {
+        if (size === prev.pageSize)
+          return prev;
+        const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+        const next = {
+          ...prev,
+          pageSize: size,
+          page: 1,
+          selection: clearedSelection
+        };
+        triggerFetch("page-size", {
+          sort: next.sort,
+          appliedFilters: next.appliedFilters,
+          page: 1,
+          pageSize: size
+        });
+        return next;
+      });
+    },
+    [dataMode, triggerFetch, currentPageOnly]
+  );
+  const toggleRow = (0, import_react.useCallback)(
+    (key, selected) => {
+      if (!selectable)
+        return;
+      setState((prev) => {
+        const next = new Set(prev.selection);
+        if (selected)
+          next.add(key);
+        else
+          next.delete(key);
+        const selArr = Array.from(next);
+        onSelectionChange == null ? void 0 : onSelectionChange(selArr, {
+          tableId,
+          pageKeys: prev.data.map((r) => String(r[rowKey])),
+          disabledKeys: [],
+          trigger: "select"
+        });
+        return { ...prev, selection: next };
+      });
+    },
+    [selectable, onSelectionChange, tableId, rowKey]
+  );
+  const selectAllOnPage = (0, import_react.useCallback)(
+    (rowKeys, disabledKeys) => {
+      if (!selectable)
+        return;
+      const selectableKeys = rowKeys.filter((k) => !disabledKeys.includes(k));
+      setState((prev) => {
+        const allSelected = selectableKeys.every((k) => prev.selection.has(k));
+        const next = new Set(prev.selection);
+        if (allSelected) {
+          selectableKeys.forEach((k) => next.delete(k));
+        } else {
+          selectableKeys.forEach((k) => next.add(k));
+        }
+        const selArr = Array.from(next);
+        onSelectionChange == null ? void 0 : onSelectionChange(selArr, {
+          tableId,
+          pageKeys: rowKeys,
+          disabledKeys,
+          trigger: allSelected ? "select-all" : "select-all"
+        });
+        return { ...prev, selection: next };
+      });
+    },
+    [selectable, onSelectionChange, tableId]
+  );
+  const clearSelection = (0, import_react.useCallback)(() => {
+    setState((prev) => ({ ...prev, selection: /* @__PURE__ */ new Set() }));
+    onSelectionChange == null ? void 0 : onSelectionChange([], {
+      tableId,
+      pageKeys: [],
+      disabledKeys: [],
+      trigger: "reset"
+    });
+  }, [onSelectionChange, tableId]);
+  const isAllSelectedOnPage = (0, import_react.useCallback)(
+    (rowKeys, disabledKeys) => {
+      const selectableKeys = rowKeys.filter((k) => !disabledKeys.includes(k));
+      if (selectableKeys.length === 0)
+        return false;
+      return selectableKeys.every((k) => state.selection.has(k));
+    },
+    [state.selection]
+  );
+  const isIndeterminateOnPage = (0, import_react.useCallback)(
+    (rowKeys, disabledKeys) => {
+      const selectableKeys = rowKeys.filter((k) => !disabledKeys.includes(k));
+      if (selectableKeys.length === 0)
+        return false;
+      const selectedCount = selectableKeys.filter(
+        (k) => state.selection.has(k)
+      ).length;
+      return selectedCount > 0 && selectedCount < selectableKeys.length;
+    },
+    [state.selection]
+  );
+  const refresh = (0, import_react.useCallback)(() => {
+    setState((prev) => {
+      const clearedSelection = currentPageOnly ? /* @__PURE__ */ new Set() : prev.selection;
+      const next = { ...prev, selection: clearedSelection };
+      triggerFetch("reset", {
+        sort: next.sort,
+        appliedFilters: next.appliedFilters,
+        page: next.page,
+        pageSize: next.pageSize
+      });
+      return next;
+    });
+  }, [triggerFetch, currentPageOnly]);
+  return (0, import_react.useMemo)(
+    () => ({
+      data: state.data,
+      total: state.total,
+      status: state.status,
+      error: state.error,
+      sort: state.sort,
+      appliedFilters: state.appliedFilters,
+      page: state.page,
+      pageSize: state.pageSize,
+      selection: Array.from(state.selection),
+      requestId,
+      toggleSort,
+      applyFilters,
+      resetFilters,
+      setPage,
+      setPageSize,
+      toggleRow,
+      selectAllOnPage,
+      clearSelection,
+      refresh,
+      isAllSelectedOnPage,
+      isIndeterminateOnPage
+    }),
+    [
+      state,
+      requestId,
+      toggleSort,
+      applyFilters,
+      resetFilters,
+      setPage,
+      setPageSize,
+      toggleRow,
+      selectAllOnPage,
+      clearSelection,
+      refresh,
+      isAllSelectedOnPage,
+      isIndeterminateOnPage
+    ]
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clampPage,
+  cycleSort,
+  useTableCore,
+  validateColumnConflicts,
+  validateJumpPage
+});

package/lib/cjs/index.d.ts

@@ -1,5 +1,8 @@
 export { PntProvider, usePntConfig, type PntConfig, type PntHighSecurityConfig, type PntHttpLike, type PntRegionQueryConfig, type commonEesType, } from './config';
 export { default as PntImage } from './components/PntImage';
+export { default as PntTable } from './components/PntTable';
+export type { PntSortDirection, PntSortInfo, PntTableColumn, PntTableDataMode, PntTableFetcher, PntTableFilterConfig as PntTableFilterConfigItem, PntTableLocale, PntTableProps, PntTableQuery, PntTableQueryMeta, PntTableQueryTrigger, PntTableRef, PntTableResponse, PntTableSelectConfig, PntTableSelectionMeta, PntTableStatus, PntTableTexts, PntTableTheme, PntFilterOption, } from './components/PntTable/types';
+export { PNT_TABLE_DEFAULT_TEXTS, PNT_TABLE_EN_TEXTS, getPntTableTextsByLocale, } from './components/PntTable/types';
 export { default as PntBusinessSelect } from './components/PntBusinessSelect';
 export { default as PntRegionSelect, normalizeRegionCode, } from './components/PntRegionSelect';
 export { DEFAULT_TEXTS, EN_TEXTS, getTextsByLocale, } from './components/PntRegionSelect/types';

package/lib/cjs/index.js

@@ -29,18 +29,22 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  DEFAULT_TEXTS: () => import_types.DEFAULT_TEXTS,
-  EN_TEXTS: () => import_types.EN_TEXTS,
+  DEFAULT_TEXTS: () => import_types2.DEFAULT_TEXTS,
+  EN_TEXTS: () => import_types2.EN_TEXTS,
+  PNT_TABLE_DEFAULT_TEXTS: () => import_types.PNT_TABLE_DEFAULT_TEXTS,
+  PNT_TABLE_EN_TEXTS: () => import_types.PNT_TABLE_EN_TEXTS,
   PntBusinessSelect: () => import_PntBusinessSelect.default,
   PntGeneralLayout: () => import_PntGeneralLayout.default,
   PntImage: () => import_PntImage.default,
   PntProvider: () => import_config.PntProvider,
   PntRegionSelect: () => import_PntRegionSelect.default,
   PntSecureBox: () => import_PntSecureBox.default,
+  PntTable: () => import_PntTable.default,
   businessGameInfoHighSecurityDecrypt: () => import_api.businessGameInfoHighSecurityDecrypt,
   businessRegionQuery: () => import_api.businessRegionQuery,
   businessSelectList: () => import_api.businessSelectList,
-  getTextsByLocale: () => import_types.getTextsByLocale,
+  getPntTableTextsByLocale: () => import_types.getPntTableTextsByLocale,
+  getTextsByLocale: () => import_types2.getTextsByLocale,
   isSecurityData: () => import_utils.isSecurityData,
   normalizeRegionCode: () => import_PntRegionSelect.normalizeRegionCode,
   useHighSecurity: () => import_useHighSecurity.useHighSecurity,
@@ -49,9 +53,11 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 var import_config = require("./config");
 var import_PntImage = __toESM(require("./components/PntImage"));
+var import_PntTable = __toESM(require("./components/PntTable"));
+var import_types = require("./components/PntTable/types");
 var import_PntBusinessSelect = __toESM(require("./components/PntBusinessSelect"));
 var import_PntRegionSelect = __toESM(require("./components/PntRegionSelect"));
-var import_types = require("./components/PntRegionSelect/types");
+var import_types2 = require("./components/PntRegionSelect/types");
 var import_PntSecureBox = __toESM(require("./components/PntSecureBox"));
 var import_useHighSecurity = require("./hooks/useHighSecurity");
 var import_utils = require("./utils");
@@ -61,15 +67,19 @@ var import_PntGeneralLayout = __toESM(require("./components/PntGeneralLayout"));
 0 && (module.exports = {
   DEFAULT_TEXTS,
   EN_TEXTS,
+  PNT_TABLE_DEFAULT_TEXTS,
+  PNT_TABLE_EN_TEXTS,
   PntBusinessSelect,
   PntGeneralLayout,
   PntImage,
   PntProvider,
   PntRegionSelect,
   PntSecureBox,
+  PntTable,
   businessGameInfoHighSecurityDecrypt,
   businessRegionQuery,
   businessSelectList,
+  getPntTableTextsByLocale,
   getTextsByLocale,
   isSecurityData,
   normalizeRegionCode,

package/lib/esm/components/PntTable/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PntTable — 统一表格组件
+ *
+ * 封装 tdesign-react Table，落地产品规范 12 章 47 条规则：
+ *   排序三态循环、筛选草稿/生效分离、多选三态+翻页清空、分页越界校验、
+ *   请求顺序控制、7 种状态管理、蓝紫双主题、同字段 sort+headerFilter 互斥。
+ *
+ * 零业务侵入：业务项目通过 fetcher 注入数据源，不依赖组件库内部 API。
+ */
+/// <reference types="react" />
+import './index.scss';
+import type { PntTableProps, PntTableRef } from './types';
+export declare const PntTable: import("react").ForwardRefExoticComponent<PntTableProps & import("react").RefAttributes<PntTableRef>>;
+export default PntTable;