@sia.soul/sia-react-ui 0.1.82 → 0.1.83

package/dist/index.cjs

@@ -12583,6 +12583,22 @@ function TableCanvasLayer({ viewport, rows, columns, widths, rowHeight, headerHe
   return /* @__PURE__ */ (0, import_jsx_runtime50.jsx)("canvas", { ref: canvasRef, "aria-hidden": "true", className: "sia-table__canvas-layer" });
 }
 
+// src/components/Table/rowIdentity.ts
+function createRowIdentity() {
+  const keys = /* @__PURE__ */ new WeakMap();
+  let sequence = 0;
+  return (record, index, rowKey) => {
+    const explicit = typeof rowKey === "function" ? rowKey(record, index) : rowKey == null ? void 0 : record[rowKey];
+    if (typeof explicit === "string" || typeof explicit === "bigint" || typeof explicit === "number" && Number.isFinite(explicit)) return explicit;
+    let key = keys.get(record);
+    if (key === void 0) {
+      key = `__sia_internal_row_${++sequence}`;
+      keys.set(record, key);
+    }
+    return key;
+  };
+}
+
 // src/components/Table/Table.tsx
 var import_react53 = require("react");
 
@@ -15269,7 +15285,7 @@ function TableInner(props, ref) {
   const {
     dataSource = EMPTY_DATA,
     columns: baseColumns = EMPTY_COLUMNS,
-    rowKey = "id",
+    rowKey,
     plugins: providedPlugins = EMPTY_PLUGINS,
     loading = false,
     emptyText = "\u6682\u65E0\u6570\u636E",
@@ -15312,7 +15328,8 @@ function TableInner(props, ref) {
   const [viewportHeight, setViewportHeight] = (0, import_react53.useState)(420);
   const [viewportWidth, setViewportWidth] = (0, import_react53.useState)(0);
   const [autoColumnWidths, setAutoColumnWidths] = (0, import_react53.useState)({});
-  const getRowKey = (0, import_react53.useCallback)((record, index) => typeof rowKey === "function" ? rowKey(record, index) : record[String(rowKey)] ?? index, [rowKey]);
+  const [resolveRowIdentity] = (0, import_react53.useState)(createRowIdentity);
+  const getRowKey = (0, import_react53.useCallback)((record, index) => resolveRowIdentity(record, index, typeof rowKey === "function" ? rowKey : rowKey == null ? void 0 : String(rowKey)), [rowKey, resolveRowIdentity]);
   const builtInResizePlugin = (0, import_react53.useMemo)(() => createResizePlugin(), []);
   const builtInHighlightPlugin = (0, import_react53.useMemo)(() => createHighlightPlugin(), []);
   const builtInCellSelectionPlugin = (0, import_react53.useMemo)(() => createCellSelectionPlugin(), []);

package/dist/index.d.cts

@@ -2109,7 +2109,7 @@ interface TableProps<T extends Record<string, unknown> = Record<string, unknown>
     dataSource?: readonly T[];
     /** 表格列定义；支持 children 构建分组表头。 */
     columns?: readonly TableColumn<T>[];
-    /** 行唯一键字段或计算函数 */
+    /** 行唯一键字段或计算函数，显式提供的值应唯一。未设置、字段不存在或值为 null/undefined 时按数据对象生成内部唯一键，不读取首列或默认 id。同一对象在排序、筛选后保留内部键；重新请求得到的新对象会生成新键，跨请求保留选择须显式设置业务主键。 */
     rowKey?: keyof T | string | ((record: T, index: number) => TableKey);
     /** 默认启用行悬停高亮；传入 createHighlightPlugin({ row: false }) 可关闭。 */
     plugins?: readonly AnyTablePlugin<T>[];

package/dist/index.d.ts

@@ -2109,7 +2109,7 @@ interface TableProps<T extends Record<string, unknown> = Record<string, unknown>
     dataSource?: readonly T[];
     /** 表格列定义；支持 children 构建分组表头。 */
     columns?: readonly TableColumn<T>[];
-    /** 行唯一键字段或计算函数 */
+    /** 行唯一键字段或计算函数，显式提供的值应唯一。未设置、字段不存在或值为 null/undefined 时按数据对象生成内部唯一键，不读取首列或默认 id。同一对象在排序、筛选后保留内部键；重新请求得到的新对象会生成新键，跨请求保留选择须显式设置业务主键。 */
     rowKey?: keyof T | string | ((record: T, index: number) => TableKey);
     /** 默认启用行悬停高亮；传入 createHighlightPlugin({ row: false }) 可关闭。 */
     plugins?: readonly AnyTablePlugin<T>[];

package/dist/index.js

@@ -5097,6 +5097,22 @@ function TableCanvasLayer({ viewport, rows, columns, widths, rowHeight, headerHe
   return /* @__PURE__ */ jsx21("canvas", { ref: canvasRef, "aria-hidden": "true", className: "sia-table__canvas-layer" });
 }
 
+// src/components/Table/rowIdentity.ts
+function createRowIdentity() {
+  const keys = /* @__PURE__ */ new WeakMap();
+  let sequence = 0;
+  return (record, index, rowKey) => {
+    const explicit = typeof rowKey === "function" ? rowKey(record, index) : rowKey == null ? void 0 : record[rowKey];
+    if (typeof explicit === "string" || typeof explicit === "bigint" || typeof explicit === "number" && Number.isFinite(explicit)) return explicit;
+    let key = keys.get(record);
+    if (key === void 0) {
+      key = `__sia_internal_row_${++sequence}`;
+      keys.set(record, key);
+    }
+    return key;
+  };
+}
+
 // src/components/Table/Table.tsx
 import { Fragment as Fragment8, forwardRef as forwardRef5, isValidElement as isValidElement4, memo, useCallback as useCallback2, useEffect as useEffect12, useImperativeHandle, useMemo as useMemo9, useRef as useRef16, useState as useState19 } from "react";
 
@@ -7783,7 +7799,7 @@ function TableInner(props, ref) {
   const {
     dataSource = EMPTY_DATA,
     columns: baseColumns = EMPTY_COLUMNS,
-    rowKey = "id",
+    rowKey,
     plugins: providedPlugins = EMPTY_PLUGINS,
     loading = false,
     emptyText = "\u6682\u65E0\u6570\u636E",
@@ -7826,7 +7842,8 @@ function TableInner(props, ref) {
   const [viewportHeight, setViewportHeight] = useState19(420);
   const [viewportWidth, setViewportWidth] = useState19(0);
   const [autoColumnWidths, setAutoColumnWidths] = useState19({});
-  const getRowKey = useCallback2((record, index) => typeof rowKey === "function" ? rowKey(record, index) : record[String(rowKey)] ?? index, [rowKey]);
+  const [resolveRowIdentity] = useState19(createRowIdentity);
+  const getRowKey = useCallback2((record, index) => resolveRowIdentity(record, index, typeof rowKey === "function" ? rowKey : rowKey == null ? void 0 : String(rowKey)), [rowKey, resolveRowIdentity]);
   const builtInResizePlugin = useMemo9(() => createResizePlugin(), []);
   const builtInHighlightPlugin = useMemo9(() => createHighlightPlugin(), []);
   const builtInCellSelectionPlugin = useMemo9(() => createCellSelectionPlugin(), []);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sia.soul/sia-react-ui",
-  "version": "0.1.82",
+  "version": "0.1.83",
   "description": "Sia Design components and tokens for React",
   "publishConfig": {
     "access": "public",