@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/table/Table.svelte.d.ts

@@ -87,15 +87,22 @@ declare function $$render<T extends Record<string, unknown>>(): {
         /** 筛选浮层挂载容器，默认跟随触发按钮 */
         getPopupContainer?: () => HTMLElement;
         /** 行级事件与属性（返回 onClick/onDoubleClick/className/style） */
-        onRow?: (record: T, index: number) => {
+        onRow?: (record: T, index: number, rowStatus?: {
+            disabled?: boolean;
+            selected?: boolean;
+        }) => {
             onClick?: (e: MouseEvent) => void;
             onDoubleClick?: (e: MouseEvent) => void;
+            onMouseEnter?: (e: MouseEvent) => void;
+            onMouseLeave?: (e: MouseEvent) => void;
             className?: string;
             style?: string;
         };
         /** 表头行级事件与属性 */
         onHeaderRow?: (columns: ColumnDef<T>[], index: number) => {
             onClick?: (e: MouseEvent) => void;
+            onMouseEnter?: (e: MouseEvent) => void;
+            onMouseLeave?: (e: MouseEvent) => void;
             className?: string;
             style?: string;
         };
@@ -114,12 +121,99 @@ declare function $$render<T extends Record<string, unknown>>(): {
             groupKey: string;
             group: T[];
         }]>;
+        /** 点击分组标题行时折叠/展开该组内的数据行，默认 false（groupBy 时生效） */
+        clickGroupedRowToExpand?: boolean;
+        /** 非受控：初始默认展开全部分组。缺省（未配置任一分组展开 props）时向后兼容为全展开；
+         *  显式传 false 则初始全部折叠。动态加载数据时不生效。 */
+        defaultExpandAllGroupRows?: boolean;
+        /** 受控：为 true 展开全部分组、false 折叠全部分组。受控时不回写，仅经 onGroupExpandChange 通知（红线 #1） */
+        expandAllGroupRows?: boolean;
+        /** 分组展开/收起变化回调（点击分组标题行触发），回传当前展开的分组 key 集合 */
+        onGroupExpandChange?: (info: {
+            groupKey: string;
+            expanded: boolean;
+            expandedGroupKeys: string[];
+        }) => void;
+        /** 分组标题行的自定义属性回调（类似 onRow，仅作用于分组头行），返回值合并进分组头行 tr。groupBy 时生效 */
+        onGroupedRow?: (group: T[], index: number) => {
+            onClick?: (e: MouseEvent) => void;
+            onDoubleClick?: (e: MouseEvent) => void;
+            onMouseEnter?: (e: MouseEvent) => void;
+            onMouseLeave?: (e: MouseEvent) => void;
+            className?: string;
+            style?: string;
+        };
         /** 表格顶部标题区域 */
         titleSnippet?: Snippet;
         /** 表格底部内容区域（接收 currentData） */
         footerSnippet?: Snippet<[{
             currentData: T[];
         }]>;
+        /**
+         * 自定义分页器渲染，替换内置 Pagination UI。入参含分页状态与翻页回调（调用 onChange(page) 触发内部翻页，
+         * 受控 current 仍不回写，红线 #1）。仅在 paginationEnabled 且有数据时消费。
+         */
+        renderPagination?: Snippet<[{
+            total: number;
+            currentPage: number;
+            pageSize: number;
+            onChange: (page: number) => void;
+        }]>;
+        /**
+         * 自定义展开行的展开/收起图标（替换默认三角）。入参 { expanded, record }。
+         * 仅在 expandable 展开列生效（树形行的展开三角另有渲染，不受此影响）。
+         */
+        expandIcon?: Snippet<[{
+            expanded: boolean;
+            record: T;
+        }]>;
+        /**
+         * 展开按钮是否与首列文案渲染在同一单元格。默认 true（并入首列，对齐 Semi）；
+         * 传 false 时展开按钮单独作为一列渲染（首列前的独立 expand 列）。仅 expandable 时生效。
+         */
+        hideExpandedColumn?: boolean;
+        /** 合并单元格（column.render 返回 rowSpan）时 hover 是否高亮整个合并区。默认 false */
+        rowSpanHover?: boolean;
+        /** 表头单元格（所有 th，含 fixed 表头）的自定义内联样式。字符串或键值对象 */
+        headerStyle?: string | Record<string, string>;
+        /** RTL/LTR 方向，默认 ltr（对齐 Semi direction） */
+        direction?: "ltr" | "rtl";
+        /** 表格标题（字符串；富内容用 titleSnippet） */
+        title?: string;
+        /** 表格尾部（字符串；富内容用 footerSnippet） */
+        footer?: string;
+        /** 树形 dataSource 中子级字段名，默认 'children'（对齐 Semi childrenRecordName；tree.childrenColumnName 优先） */
+        childrenRecordName?: string;
+        /** 最外层 .cd-table-wrapper 自定义样式名（对齐 Semi className） */
+        class?: string;
+        /** 最外层 .cd-table-wrapper 内联样式（对齐 Semi style） */
+        style?: string;
+        /**
+         * 覆盖组成元素的 tag 名（对齐 Semi components）。Svelte 侧以标签名字符串生效，
+         * 经 <svelte:element> 渲染，内部 class/role/事件仍注入。缺省用原生
+         * table/thead/tbody/tr/th/td。常见用法：body.row='div' 配合拖拽库。
+         */
+        components?: {
+            table?: string;
+            header?: {
+                wrapper?: string;
+                row?: string;
+                cell?: string;
+            };
+            body?: {
+                wrapper?: string;
+                row?: string;
+                cell?: string;
+            };
+        };
+        /**
+         * 返回虚拟化滚动控制句柄（对齐 Semi getVirtualizedListRef）。仅 virtualized 时有效。
+         * 句柄含 scrollTo(offset) 与 scrollToItem(index)，命令式驱动表体滚动。
+         */
+        getVirtualizedListRef?: (ref: {
+            scrollTo: (offset: number) => void;
+            scrollToItem: (index: number) => void;
+        }) => void;
     };
     exports: {};
     bindings: "";

package/dist/table/Table.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Table.svelte.d.ts","sourceRoot":"","sources":["../../src/table/Table.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Table.svelte.d.ts","sourceRoot":"","sources":["../../src/table/Table.svelte.ts"],"names":[],"mappings":"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"}

package/dist/table/meta.d.ts

@@ -11,7 +11,7 @@ export declare const meta: {
         readonly name: "columns";
         readonly type: "ColumnDef<T>[]";
         readonly default: "[]";
-        readonly desc: "列定义：key/dataIndex/title/width/fixed/resizable/align/ellipsis/sorter/filters/onFilter/render";
+        readonly desc: "列定义：key/dataIndex/title/width/fixed/resizable/align/className/ellipsis/sorter/filters/onFilter/filterConfirmMode/render；children 表头合并（子列，父列 title 横跨叶子列）；onCell 返回 colSpan/rowSpan 行列合并（值 0 跳过渲染）；useFullRender 完全自定义（render 额外收到 expandIcon/indentText 物料自行摆放）";
     }, {
         readonly name: "dataSource";
         readonly type: "T[]";
@@ -108,10 +108,214 @@ export declare const meta: {
         readonly type: "number";
         readonly default: "48";
         readonly desc: "虚拟滚动行高(px)，virtualized 时生效";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(info: TableChangeInfo) => void";
+        readonly default: "undefined";
+        readonly desc: "聚合事件：排序/筛选/分页任一变化的主入口（受控数据回流）";
+    }, {
+        readonly name: "onFilterChange";
+        readonly type: "(info: { dataIndex: string; values: (string|number)[] }) => void";
+        readonly default: "undefined";
+        readonly desc: "筛选状态变化（含重置）";
+    }, {
+        readonly name: "onPaginationChange";
+        readonly type: "(info: { current: number; pageSize: number }) => void";
+        readonly default: "undefined";
+        readonly desc: "分页变化";
+    }, {
+        readonly name: "onSelectChange";
+        readonly type: "(info: { selectedRowKeys: RowKey[]; selectedRows: T[] }) => void";
+        readonly default: "undefined";
+        readonly desc: "选择集变化（与 rowSelection.onChange 同时触发）";
+    }, {
+        readonly name: "onExpandChange";
+        readonly type: "(info: { expanded: boolean; record: T; expandedRowKeys: RowKey[] }) => void";
+        readonly default: "undefined";
+        readonly desc: "行展开/收起（展开行与树形行均触发）";
+    }, {
+        readonly name: "onScroll";
+        readonly type: "(info: TableScrollInfo) => void";
+        readonly default: "undefined";
+        readonly desc: "滚动位置（含触底，用于无限加载）";
+    }, {
+        readonly name: "onReachBottom";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "纵向触底（懒加载触发），距底 reachBottomThreshold 像素内触发一次";
+    }, {
+        readonly name: "reachBottomThreshold";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "onReachBottom 触发阈值（距底像素），默认 0（精确触底）";
+    }, {
+        readonly name: "gridNav";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "交互态 WAI-ARIA Grid Pattern 开关；缺省时按是否有交互能力自动启用，显式 true/false 强制";
+    }, {
+        readonly name: "scroll";
+        readonly type: "ScrollConfig";
+        readonly default: "undefined";
+        readonly desc: "横/纵向滚动配置：x 设最小宽度横向溢出，y 设最大高度纵向溢出；scrollToFirstRowOnChange 分页/排序/筛选变化后滚回顶部";
+    }, {
+        readonly name: "components";
+        readonly type: "{ table?; header?; body? }（tag 名）";
+        readonly default: "undefined";
+        readonly desc: "覆盖组成元素 tag（对齐 Semi）：thead/tbody/行经 svelte:element 换标签，内部 class/role/事件仍注入";
+    }, {
+        readonly name: "getVirtualizedListRef";
+        readonly type: "(ref: { scrollTo; scrollToItem }) => void";
+        readonly default: "undefined";
+        readonly desc: "返回虚拟化滚动控制句柄，仅 virtualized 有效（对齐 Semi）";
+    }, {
+        readonly name: "sticky";
+        readonly type: "boolean | { offsetHeader?: number }";
+        readonly default: "false";
+        readonly desc: "表头吸顶：true 时 sticky 定位；对象可指定 offsetHeader（px）";
+    }, {
+        readonly name: "showHeader";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示表头";
+    }, {
+        readonly name: "defaultExpandAllRows";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "默认展开全部行（含树形行）";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement";
+        readonly default: "undefined";
+        readonly desc: "筛选浮层挂载容器，默认跟随触发按钮";
+    }, {
+        readonly name: "onRow";
+        readonly type: "(record: T, index: number, rowStatus?: { disabled?; selected? }) => { onClick?; onDoubleClick?; onMouseEnter?; onMouseLeave?; className?; style? }";
+        readonly default: "undefined";
+        readonly desc: "行级事件与属性（返回值合并到 tr；第三参 rowStatus 含 disabled/selected）";
+    }, {
+        readonly name: "onHeaderRow";
+        readonly type: "(columns: ColumnDef<T>[], index: number) => { onClick?; className?; style? }";
+        readonly default: "undefined";
+        readonly desc: "表头行级事件与属性";
+    }, {
+        readonly name: "expandRowByClick";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "点击行体触发展开/收起";
+    }, {
+        readonly name: "expandCellFixed";
+        readonly type: "boolean | 'left' | 'right'";
+        readonly default: "undefined";
+        readonly desc: "展开图标列固定方向";
+    }, {
+        readonly name: "keepDOM";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "true 时保留已展开行 DOM 但隐藏（display:none）";
+    }, {
+        readonly name: "indentSize";
+        readonly type: "number";
+        readonly default: "20";
+        readonly desc: "树形缩进像素（tree.indentSize 优先）";
+    }, {
+        readonly name: "groupBy";
+        readonly type: "string | ((record: T) => string)";
+        readonly default: "undefined";
+        readonly desc: "按字段名或函数对数据行分组，插入分组标题行";
+    }, {
+        readonly name: "renderGroupSection";
+        readonly type: "Snippet<[{ groupKey: string; group: T[] }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义分组标题渲染";
+    }, {
+        readonly name: "clickGroupedRowToExpand";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "点击分组标题行折叠/展开该组内数据行（groupBy 时生效，disclosure 模式 role=button+aria-expanded+Enter/Space 可达）";
+    }, {
+        readonly name: "defaultExpandAllGroupRows";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "非受控：初始默认展开全部分组。缺省(未配置)时向后兼容为全展开；显式 false 初始全折。动态加载数据不生效";
+    }, {
+        readonly name: "expandAllGroupRows";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "受控：true 展开全部分组、false 折叠全部分组；受控时不回写，仅经 onGroupExpandChange 通知";
+    }, {
+        readonly name: "onGroupExpandChange";
+        readonly type: "(info: { groupKey: string; expanded: boolean; expandedGroupKeys: string[] }) => void";
+        readonly default: "undefined";
+        readonly desc: "分组展开/收起变化回调（点击分组标题行触发）";
+    }, {
+        readonly name: "onGroupedRow";
+        readonly type: "(group: T[], index: number) => { onClick?; onDoubleClick?; className?; style? }";
+        readonly default: "undefined";
+        readonly desc: "分组标题行自定义属性回调（类似 onRow，仅作用于分组头行），返回值合并进分组头 tr";
+    }, {
+        readonly name: "titleSnippet";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "表格顶部标题区域";
+    }, {
+        readonly name: "footerSnippet";
+        readonly type: "Snippet<[{ currentData: T[] }]>";
+        readonly default: "undefined";
+        readonly desc: "表格底部内容区域（接收 currentData）";
+    }, {
+        readonly name: "renderPagination";
+        readonly type: "Snippet<[{ total: number; currentPage: number; pageSize: number; onChange: (page: number) => void }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义分页器渲染，替换内置 Pagination UI；调用 onChange(page) 触发内部翻页（受控 current 不回写）";
+    }, {
+        readonly name: "expandIcon";
+        readonly type: "Snippet<[{ expanded: boolean; record: T }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义展开行的展开/收起图标（替换默认三角），仅 expandable 展开列生效";
+    }, {
+        readonly name: "hideExpandedColumn";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "展开按钮是否并入首列。默认 true（并入首列，对齐 Semi）；false 时展开按钮单独成列";
+    }, {
+        readonly name: "rowSpanHover";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "合并单元格（rowSpan）时 hover 高亮整个合并区（渐进能力，依赖单元格合并）";
+    }, {
+        readonly name: "headerStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "表头单元格（所有 th，含 fixed 表头）自定义内联样式";
     }];
     readonly events: readonly [{
+        readonly name: "onChange";
+        readonly desc: "排序/筛选/分页任一变化的聚合主入口（受控数据回流）";
+    }, {
         readonly name: "onSortChange";
         readonly desc: "表头排序切换(三态循环)";
+    }, {
+        readonly name: "onFilterChange";
+        readonly desc: "列筛选状态变化（含重置）";
+    }, {
+        readonly name: "onPaginationChange";
+        readonly desc: "分页变化";
+    }, {
+        readonly name: "onSelectChange";
+        readonly desc: "选择集变化（与 rowSelection.onChange 同时触发）";
+    }, {
+        readonly name: "onExpandChange";
+        readonly desc: "行展开/收起（展开行与树形行均触发）";
+    }, {
+        readonly name: "onGroupExpandChange";
+        readonly desc: "分组展开/收起（点击分组标题行触发）";
+    }, {
+        readonly name: "onScroll";
+        readonly desc: "滚动位置（含触底）";
+    }, {
+        readonly name: "onReachBottom";
+        readonly desc: "纵向触底（懒加载触发）";
     }, {
         readonly name: "rowSelection.onChange";
         readonly desc: "行选择变更，回传 keys 与对应 rows";
@@ -125,6 +329,21 @@ export declare const meta: {
     readonly slots: readonly [{
         readonly name: "column.render";
         readonly desc: "单元格自定义渲染 Snippet<[{ value, record, index }]>";
+    }, {
+        readonly name: "titleSnippet";
+        readonly desc: "表格顶部标题区域 Snippet";
+    }, {
+        readonly name: "footerSnippet";
+        readonly desc: "表格底部内容区域 Snippet<[{ currentData: T[] }]>";
+    }, {
+        readonly name: "renderGroupSection";
+        readonly desc: "分组标题渲染 Snippet<[{ groupKey, group }]>";
+    }, {
+        readonly name: "renderPagination";
+        readonly desc: "自定义分页器渲染 Snippet<[{ total, currentPage, pageSize, onChange }]>";
+    }, {
+        readonly name: "expandIcon";
+        readonly desc: "自定义展开图标 Snippet<[{ expanded, record }]>";
     }, {
         readonly name: "empty";
         readonly desc: "空态文案经 empty prop 配置(字符串)";
@@ -136,7 +355,7 @@ export declare const meta: {
         readonly keyboard: "↑↓ 行 / ←→ 列 / Home·End 行内首末 / Ctrl·Cmd+Home·End 表首末 / PageUp·PageDown 翻屏 / Enter·F2 进入单元格交互、Esc 退出";
         readonly note: "交互态(排序/筛选/行选择/展开/树形/行点击任一)遵循 WAI-ARIA APG Grid Pattern：role=grid + aria-rowcount/colcount(虚拟化为逻辑总数) + role=row(aria-rowindex 真实序) + role=columnheader/rowheader/gridcell + aria-colindex；单元格 roving tabindex(整 grid 单一 Tab 停靠点，纯派生)，二维方向键漫游(纯函数 nextGridCoord)，命令式 focusCell 聚焦；虚拟化下方向键移到未渲染行先滚动进视口再 tick 后聚焦，焦点行被回收时回退到 grid 容器并 announce(不掉 body)；Enter/F2 进入单元格内控件交互模式、Esc 退出回导航(导航模式下单元格内控件 tabindex=-1 不破坏 roving)。纯展示表(无交互)降级为 role=table 省漫游。可排序列 aria-sort(ascending/descending/none)；行选择原生 checkbox，全选 aria-label「全选」、行选「选择此行」，半选经 attachment 命令式设 input.indeterminate(只写属性、不读几何、无响应式循环)；焦点环 --cd-focus-ring；reduced-motion 关闭 spinner 与图标过渡。";
     };
-    readonly tokens: readonly ["--cd-table-bg", "--cd-table-header-bg", "--cd-table-header-text", "--cd-table-cell-text", "--cd-table-border-color", "--cd-table-row-hover-bg", "--cd-table-row-selected-bg", "--cd-table-row-stripe-bg", "--cd-table-cell-padding-y", "--cd-table-cell-padding-x", "--cd-table-cell-padding-y-small", "--cd-table-cell-padding-y-large", "--cd-table-sort-active-color", "--cd-table-sort-icon-color", "--cd-table-loading-mask", "--cd-table-empty-color", "--cd-table-radius"];
+    readonly tokens: readonly ["--cd-spacing-table-paddingy", "--cd-spacing-table-paddingx", "--cd-spacing-table-middle-paddingy", "--cd-spacing-table-small-paddingy", "--cd-spacing-table-title-paddingy", "--cd-spacing-table-title-paddingx", "--cd-spacing-table-footer-padding", "--cd-spacing-table-expand-row-paddingleft", "--cd-spacing-table-expand-row-paddingright", "--cd-spacing-table-expand-row-paddingtop", "--cd-spacing-table-expand-row-paddingbottom", "--cd-spacing-table-resizable-offset-y", "--cd-spacing-table-resizable-bottom", "--cd-spacing-table-row-head-paddingy", "--cd-spacing-table-row-head-paddingx", "--cd-spacing-table-react-resizable-handle-right", "--cd-spacing-table-tbody-rowcell-padding", "--cd-spacing-table-tbody-rowselection-rowcell-notselection-paddingx", "--cd-spacing-table-tbody-rowselection-rowcell-notselection-paddingy", "--cd-spacing-table-column-sorter-marginleft", "--cd-spacing-table-column-filter-marginleft", "--cd-spacing-table-expand-icon-marginright", "--cd-width-table-base-border", "--cd-width-table-header-border", "--cd-width-table-resizer-border", "--cd-width-table-column-selection", "--cd-width-table-column-sorter-icon", "--cd-height-table-column-sorter-icon", "--cd-width-table-column-filter-icon", "--cd-height-table-column-filter-icon", "--cd-width-table-cell-fixed-left-last", "--cd-width-table-cell-fixed-right-first", "--cd-width-table-react-resizable-handle", "--cd-height-table-pagination-outer-min", "--cd-height-table-column-filter-dropdown", "--cd-color-table-bg-default", "--cd-color-table-text-default", "--cd-color-table-border-default", "--cd-color-table-shadow-border-default", "--cd-color-table-th-bg-default", "--cd-color-table-th-border-default", "--cd-color-table-th-text-default", "--cd-color-table-th-clicksort-bg-hover", "--cd-color-table-pl-bg-default", "--cd-color-table-body-bg-default", "--cd-color-table-body-bg-hover", "--cd-color-table-footer-bg-default", "--cd-color-table-row-expanded-bg-default", "--cd-color-table-expanded-icon-default", "--cd-color-table-expanded-bg-default", "--cd-color-table-filter-on-text-default", "--cd-color-table-filter-text-default", "--cd-color-table-sorter-on-text-default", "--cd-color-table-sorter-text-default", "--cd-color-table-page-text-default", "--cd-color-table-resizer-bg-default", "--cd-color-table-selection-bg-default", "--cd-color-table-placeholder-text-default", "--cd-color-table-cell-bg-hover", "--cd-font-table-base-fontsize", "--cd-border-table-base-borderstyle", "--cd-shadow-table-left", "--cd-shadow-table-right", "--cd-z-table-fixed-column"];
     readonly responsive: false;
     readonly examples: readonly [{
         readonly title: "基础";

package/dist/table/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/table/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoHP,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/table/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyNP,CAAC"}

package/dist/table/meta.js

@@ -8,7 +8,7 @@ export const meta = {
     description: '表格：列定义驱动渲染，三态排序(升/降/无)、客户端分页、行选择(含半选 indeterminate)；sortState / rowSelection.selectedRowKeys / pagination.current 受控不回写，仅经 onSortChange / onChange 通知。复用 @chenzy-design/core 纯函数算法与 Pagination 组件。支持行展开 expandable（受控/非受控）。固定列 fixed、列筛选 filters/onFilter、列宽拖拽 resizable（本地覆盖宽度不写回 columns）。树形数据 tree（行含 children 自动嵌套，第一列展开三角+缩进，排序/分页作用于顶层行，扁平化用 core flattenTreeRows 纯函数，受控展开 keys 不回写）。树形行选择父子联动 rowSelection.checkStrictly（默认 false 勾父连带后代+半选，true 父子独立；联动用 core conductRows/toggleRowCheck 纯函数）。行虚拟滚动 virtualized：仅渲染视口内行切片（复用 core fixedRange），首尾 padding spacer tr 撑总高，保持原生 table 语义；thead sticky 固定顶部；与 pagination 互斥（虚拟时忽略分页）。',
     exports: ['Table'],
     props: [
-        { name: 'columns', type: 'ColumnDef<T>[]', default: '[]', desc: '列定义：key/dataIndex/title/width/fixed/resizable/align/ellipsis/sorter/filters/onFilter/render' },
+        { name: 'columns', type: 'ColumnDef<T>[]', default: '[]', desc: '列定义：key/dataIndex/title/width/fixed/resizable/align/className/ellipsis/sorter/filters/onFilter/filterConfirmMode/render；children 表头合并（子列，父列 title 横跨叶子列）；onCell 返回 colSpan/rowSpan 行列合并（值 0 跳过渲染）；useFullRender 完全自定义（render 额外收到 expandIcon/indentText 物料自行摆放）' },
         { name: 'dataSource', type: 'T[]', default: '[]', desc: '数据行' },
         { name: 'rowKey', type: "string | ((record: T) => RowKey)", default: "'key'", desc: '行唯一键解析' },
         { name: 'size', type: "'small'|'default'|'large'", default: "'default'" },
@@ -49,15 +49,64 @@ export const meta = {
         { name: 'virtualized', type: 'boolean', default: 'false', desc: '行虚拟滚动：仅渲染视口内行，适合大数据(1000+)。启用时忽略 pagination(全量滚动)、表头 sticky 固定顶部；假定行等高，不建议与 expandable 混用' },
         { name: 'height', type: 'number', default: '400', desc: '虚拟滚动视口高度(px)，virtualized 时生效' },
         { name: 'rowHeight', type: 'number', default: '48', desc: '虚拟滚动行高(px)，virtualized 时生效' },
+        { name: 'onChange', type: '(info: TableChangeInfo) => void', default: 'undefined', desc: '聚合事件：排序/筛选/分页任一变化的主入口（受控数据回流）' },
+        { name: 'onFilterChange', type: '(info: { dataIndex: string; values: (string|number)[] }) => void', default: 'undefined', desc: '筛选状态变化（含重置）' },
+        { name: 'onPaginationChange', type: '(info: { current: number; pageSize: number }) => void', default: 'undefined', desc: '分页变化' },
+        { name: 'onSelectChange', type: '(info: { selectedRowKeys: RowKey[]; selectedRows: T[] }) => void', default: 'undefined', desc: '选择集变化（与 rowSelection.onChange 同时触发）' },
+        { name: 'onExpandChange', type: '(info: { expanded: boolean; record: T; expandedRowKeys: RowKey[] }) => void', default: 'undefined', desc: '行展开/收起（展开行与树形行均触发）' },
+        { name: 'onScroll', type: '(info: TableScrollInfo) => void', default: 'undefined', desc: '滚动位置（含触底，用于无限加载）' },
+        { name: 'onReachBottom', type: '() => void', default: 'undefined', desc: '纵向触底（懒加载触发），距底 reachBottomThreshold 像素内触发一次' },
+        { name: 'reachBottomThreshold', type: 'number', default: '0', desc: 'onReachBottom 触发阈值（距底像素），默认 0（精确触底）' },
+        { name: 'gridNav', type: 'boolean', default: 'undefined', desc: '交互态 WAI-ARIA Grid Pattern 开关；缺省时按是否有交互能力自动启用，显式 true/false 强制' },
+        { name: 'scroll', type: 'ScrollConfig', default: 'undefined', desc: '横/纵向滚动配置：x 设最小宽度横向溢出，y 设最大高度纵向溢出；scrollToFirstRowOnChange 分页/排序/筛选变化后滚回顶部' },
+        { name: 'components', type: '{ table?; header?; body? }（tag 名）', default: 'undefined', desc: '覆盖组成元素 tag（对齐 Semi）：thead/tbody/行经 svelte:element 换标签，内部 class/role/事件仍注入' },
+        { name: 'getVirtualizedListRef', type: '(ref: { scrollTo; scrollToItem }) => void', default: 'undefined', desc: '返回虚拟化滚动控制句柄，仅 virtualized 有效（对齐 Semi）' },
+        { name: 'sticky', type: 'boolean | { offsetHeader?: number }', default: 'false', desc: '表头吸顶：true 时 sticky 定位；对象可指定 offsetHeader（px）' },
+        { name: 'showHeader', type: 'boolean', default: 'true', desc: '是否显示表头' },
+        { name: 'defaultExpandAllRows', type: 'boolean', default: 'false', desc: '默认展开全部行（含树形行）' },
+        { name: 'getPopupContainer', type: '() => HTMLElement', default: 'undefined', desc: '筛选浮层挂载容器，默认跟随触发按钮' },
+        { name: 'onRow', type: '(record: T, index: number, rowStatus?: { disabled?; selected? }) => { onClick?; onDoubleClick?; onMouseEnter?; onMouseLeave?; className?; style? }', default: 'undefined', desc: '行级事件与属性（返回值合并到 tr；第三参 rowStatus 含 disabled/selected）' },
+        { name: 'onHeaderRow', type: '(columns: ColumnDef<T>[], index: number) => { onClick?; className?; style? }', default: 'undefined', desc: '表头行级事件与属性' },
+        { name: 'expandRowByClick', type: 'boolean', default: 'false', desc: '点击行体触发展开/收起' },
+        { name: 'expandCellFixed', type: "boolean | 'left' | 'right'", default: 'undefined', desc: '展开图标列固定方向' },
+        { name: 'keepDOM', type: 'boolean', default: 'false', desc: 'true 时保留已展开行 DOM 但隐藏（display:none）' },
+        { name: 'indentSize', type: 'number', default: '20', desc: '树形缩进像素（tree.indentSize 优先）' },
+        { name: 'groupBy', type: 'string | ((record: T) => string)', default: 'undefined', desc: '按字段名或函数对数据行分组，插入分组标题行' },
+        { name: 'renderGroupSection', type: 'Snippet<[{ groupKey: string; group: T[] }]>', default: 'undefined', desc: '自定义分组标题渲染' },
+        { name: 'clickGroupedRowToExpand', type: 'boolean', default: 'false', desc: '点击分组标题行折叠/展开该组内数据行（groupBy 时生效，disclosure 模式 role=button+aria-expanded+Enter/Space 可达）' },
+        { name: 'defaultExpandAllGroupRows', type: 'boolean', default: 'undefined', desc: '非受控：初始默认展开全部分组。缺省(未配置)时向后兼容为全展开；显式 false 初始全折。动态加载数据不生效' },
+        { name: 'expandAllGroupRows', type: 'boolean', default: 'undefined', desc: '受控：true 展开全部分组、false 折叠全部分组；受控时不回写，仅经 onGroupExpandChange 通知' },
+        { name: 'onGroupExpandChange', type: '(info: { groupKey: string; expanded: boolean; expandedGroupKeys: string[] }) => void', default: 'undefined', desc: '分组展开/收起变化回调（点击分组标题行触发）' },
+        { name: 'onGroupedRow', type: '(group: T[], index: number) => { onClick?; onDoubleClick?; className?; style? }', default: 'undefined', desc: '分组标题行自定义属性回调（类似 onRow，仅作用于分组头行），返回值合并进分组头 tr' },
+        { name: 'titleSnippet', type: 'Snippet', default: 'undefined', desc: '表格顶部标题区域' },
+        { name: 'footerSnippet', type: 'Snippet<[{ currentData: T[] }]>', default: 'undefined', desc: '表格底部内容区域（接收 currentData）' },
+        { name: 'renderPagination', type: 'Snippet<[{ total: number; currentPage: number; pageSize: number; onChange: (page: number) => void }]>', default: 'undefined', desc: '自定义分页器渲染，替换内置 Pagination UI；调用 onChange(page) 触发内部翻页（受控 current 不回写）' },
+        { name: 'expandIcon', type: 'Snippet<[{ expanded: boolean; record: T }]>', default: 'undefined', desc: '自定义展开行的展开/收起图标（替换默认三角），仅 expandable 展开列生效' },
+        { name: 'hideExpandedColumn', type: 'boolean', default: 'true', desc: '展开按钮是否并入首列。默认 true（并入首列，对齐 Semi）；false 时展开按钮单独成列' },
+        { name: 'rowSpanHover', type: 'boolean', default: 'false', desc: '合并单元格（rowSpan）时 hover 高亮整个合并区（渐进能力，依赖单元格合并）' },
+        { name: 'headerStyle', type: 'string | Record<string, string>', default: 'undefined', desc: '表头单元格（所有 th，含 fixed 表头）自定义内联样式' },
     ],
     events: [
+        { name: 'onChange', desc: '排序/筛选/分页任一变化的聚合主入口（受控数据回流）' },
         { name: 'onSortChange', desc: '表头排序切换(三态循环)' },
+        { name: 'onFilterChange', desc: '列筛选状态变化（含重置）' },
+        { name: 'onPaginationChange', desc: '分页变化' },
+        { name: 'onSelectChange', desc: '选择集变化（与 rowSelection.onChange 同时触发）' },
+        { name: 'onExpandChange', desc: '行展开/收起（展开行与树形行均触发）' },
+        { name: 'onGroupExpandChange', desc: '分组展开/收起（点击分组标题行触发）' },
+        { name: 'onScroll', desc: '滚动位置（含触底）' },
+        { name: 'onReachBottom', desc: '纵向触底（懒加载触发）' },
         { name: 'rowSelection.onChange', desc: '行选择变更，回传 keys 与对应 rows' },
         { name: 'pagination.onChange', desc: '页码变更' },
         { name: 'onRowClick', desc: '行点击(复选框/排序按钮已阻止冒泡)' },
     ],
     slots: [
         { name: 'column.render', desc: '单元格自定义渲染 Snippet<[{ value, record, index }]>' },
+        { name: 'titleSnippet', desc: '表格顶部标题区域 Snippet' },
+        { name: 'footerSnippet', desc: '表格底部内容区域 Snippet<[{ currentData: T[] }]>' },
+        { name: 'renderGroupSection', desc: '分组标题渲染 Snippet<[{ groupKey, group }]>' },
+        { name: 'renderPagination', desc: '自定义分页器渲染 Snippet<[{ total, currentPage, pageSize, onChange }]>' },
+        { name: 'expandIcon', desc: '自定义展开图标 Snippet<[{ expanded, record }]>' },
         { name: 'empty', desc: '空态文案经 empty prop 配置(字符串)' },
     ],
     a11y: {
@@ -68,23 +117,75 @@ export const meta = {
         note: '交互态(排序/筛选/行选择/展开/树形/行点击任一)遵循 WAI-ARIA APG Grid Pattern：role=grid + aria-rowcount/colcount(虚拟化为逻辑总数) + role=row(aria-rowindex 真实序) + role=columnheader/rowheader/gridcell + aria-colindex；单元格 roving tabindex(整 grid 单一 Tab 停靠点，纯派生)，二维方向键漫游(纯函数 nextGridCoord)，命令式 focusCell 聚焦；虚拟化下方向键移到未渲染行先滚动进视口再 tick 后聚焦，焦点行被回收时回退到 grid 容器并 announce(不掉 body)；Enter/F2 进入单元格内控件交互模式、Esc 退出回导航(导航模式下单元格内控件 tabindex=-1 不破坏 roving)。纯展示表(无交互)降级为 role=table 省漫游。可排序列 aria-sort(ascending/descending/none)；行选择原生 checkbox，全选 aria-label「全选」、行选「选择此行」，半选经 attachment 命令式设 input.indeterminate(只写属性、不读几何、无响应式循环)；焦点环 --cd-focus-ring；reduced-motion 关闭 spinner 与图标过渡。',
     },
     tokens: [
-        '--cd-table-bg',
-        '--cd-table-header-bg',
-        '--cd-table-header-text',
-        '--cd-table-cell-text',
-        '--cd-table-border-color',
-        '--cd-table-row-hover-bg',
-        '--cd-table-row-selected-bg',
-        '--cd-table-row-stripe-bg',
-        '--cd-table-cell-padding-y',
-        '--cd-table-cell-padding-x',
-        '--cd-table-cell-padding-y-small',
-        '--cd-table-cell-padding-y-large',
-        '--cd-table-sort-active-color',
-        '--cd-table-sort-icon-color',
-        '--cd-table-loading-mask',
-        '--cd-table-empty-color',
-        '--cd-table-radius',
+        // 全量对齐 Semi table/variables.scss —— 组件直接消费 Semi 全名 token（无自造中间短名）
+        // 间距
+        '--cd-spacing-table-paddingy',
+        '--cd-spacing-table-paddingx',
+        '--cd-spacing-table-middle-paddingy',
+        '--cd-spacing-table-small-paddingy',
+        '--cd-spacing-table-title-paddingy',
+        '--cd-spacing-table-title-paddingx',
+        '--cd-spacing-table-footer-padding',
+        '--cd-spacing-table-expand-row-paddingleft',
+        '--cd-spacing-table-expand-row-paddingright',
+        '--cd-spacing-table-expand-row-paddingtop',
+        '--cd-spacing-table-expand-row-paddingbottom',
+        '--cd-spacing-table-resizable-offset-y',
+        '--cd-spacing-table-resizable-bottom',
+        '--cd-spacing-table-row-head-paddingy',
+        '--cd-spacing-table-row-head-paddingx',
+        '--cd-spacing-table-react-resizable-handle-right',
+        '--cd-spacing-table-tbody-rowcell-padding',
+        '--cd-spacing-table-tbody-rowselection-rowcell-notselection-paddingx',
+        '--cd-spacing-table-tbody-rowselection-rowcell-notselection-paddingy',
+        '--cd-spacing-table-column-sorter-marginleft',
+        '--cd-spacing-table-column-filter-marginleft',
+        '--cd-spacing-table-expand-icon-marginright',
+        // 尺寸
+        '--cd-width-table-base-border',
+        '--cd-width-table-header-border',
+        '--cd-width-table-resizer-border',
+        '--cd-width-table-column-selection',
+        '--cd-width-table-column-sorter-icon',
+        '--cd-height-table-column-sorter-icon',
+        '--cd-width-table-column-filter-icon',
+        '--cd-height-table-column-filter-icon',
+        '--cd-width-table-cell-fixed-left-last',
+        '--cd-width-table-cell-fixed-right-first',
+        '--cd-width-table-react-resizable-handle',
+        '--cd-height-table-pagination-outer-min',
+        '--cd-height-table-column-filter-dropdown',
+        // 颜色
+        '--cd-color-table-bg-default',
+        '--cd-color-table-text-default',
+        '--cd-color-table-border-default',
+        '--cd-color-table-shadow-border-default',
+        '--cd-color-table-th-bg-default',
+        '--cd-color-table-th-border-default',
+        '--cd-color-table-th-text-default',
+        '--cd-color-table-th-clicksort-bg-hover',
+        '--cd-color-table-pl-bg-default',
+        '--cd-color-table-body-bg-default',
+        '--cd-color-table-body-bg-hover',
+        '--cd-color-table-footer-bg-default',
+        '--cd-color-table-row-expanded-bg-default',
+        '--cd-color-table-expanded-icon-default',
+        '--cd-color-table-expanded-bg-default',
+        '--cd-color-table-filter-on-text-default',
+        '--cd-color-table-filter-text-default',
+        '--cd-color-table-sorter-on-text-default',
+        '--cd-color-table-sorter-text-default',
+        '--cd-color-table-page-text-default',
+        '--cd-color-table-resizer-bg-default',
+        '--cd-color-table-selection-bg-default',
+        '--cd-color-table-placeholder-text-default',
+        '--cd-color-table-cell-bg-hover',
+        // 其他
+        '--cd-font-table-base-fontsize',
+        '--cd-border-table-base-borderstyle',
+        '--cd-shadow-table-left',
+        '--cd-shadow-table-right',
+        '--cd-z-table-fixed-column',
     ],
     responsive: false,
     examples: [