@chenzy-design/svelte 0.1.0

package/dist/table/meta.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Table — see specs/components/show/Table.spec.md
+ */
+export declare const meta: {
+    readonly name: "Table";
+    readonly category: "show";
+    readonly 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 互斥（虚拟时忽略分页）。";
+    readonly exports: readonly ["Table"];
+    readonly props: readonly [{
+        readonly name: "columns";
+        readonly type: "ColumnDef<T>[]";
+        readonly default: "[]";
+        readonly desc: "列定义：key/dataIndex/title/width/fixed/resizable/align/ellipsis/sorter/filters/onFilter/render";
+    }, {
+        readonly name: "dataSource";
+        readonly type: "T[]";
+        readonly default: "[]";
+        readonly desc: "数据行";
+    }, {
+        readonly name: "rowKey";
+        readonly type: "string | ((record: T) => RowKey)";
+        readonly default: "'key'";
+        readonly desc: "行唯一键解析";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+    }, {
+        readonly name: "bordered";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "单元格边框";
+    }, {
+        readonly name: "stripe";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "斑马纹";
+    }, {
+        readonly name: "loading";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "半透明遮罩 + spinner";
+    }, {
+        readonly name: "sortState";
+        readonly type: "SortState";
+        readonly default: "undefined";
+        readonly desc: "受控排序态；受控时不回写，仅 onSortChange";
+    }, {
+        readonly name: "defaultSortState";
+        readonly type: "SortState";
+        readonly default: "{ key: null, order: null }";
+        readonly desc: "非受控初始排序";
+    }, {
+        readonly name: "onSortChange";
+        readonly type: "(state: SortState) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "pagination";
+        readonly type: "false | { pageSize?: number; current?: number; defaultCurrent?: number; onChange?: (page: number) => void }";
+        readonly default: "undefined";
+        readonly desc: "false 关闭；对象/缺省启用内置分页(pageSize 默认 10)。current 受控不回写";
+    }, {
+        readonly name: "rowSelection";
+        readonly type: "RowSelection<T>";
+        readonly default: "undefined";
+        readonly desc: "selectedRowKeys 受控不回写；defaultSelectedRowKeys / onChange / getCheckboxProps；checkStrictly(默认 false) 树形父子联动开关：false 勾父连带勾后代+后代部分选中父行半选，true 父子独立";
+    }, {
+        readonly name: "expandable";
+        readonly type: "Expandable<T>";
+        readonly default: "undefined";
+        readonly desc: "expandedRowRender / rowExpandable / expandedRowKeys 受控不回写 / defaultExpandedRowKeys / onExpand";
+    }, {
+        readonly name: "tree";
+        readonly type: "boolean | TreeTable";
+        readonly default: "undefined";
+        readonly desc: "树形数据：true 或 { childrenColumnName(默认 children) / indentSize(默认 16) / expandedRowKeys 受控不回写 / defaultExpandedRowKeys / onExpand }。第一列内展开三角+逐级缩进；排序/分页/筛选作用于顶层行";
+    }, {
+        readonly name: "rowClassName";
+        readonly type: "(record: T, index: number) => string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "empty";
+        readonly type: "string";
+        readonly default: "'暂无数据'";
+        readonly desc: "空数据占位文案";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "table aria-label";
+    }, {
+        readonly name: "onRowClick";
+        readonly type: "(info: { record: T; index: number }) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "virtualized";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "行虚拟滚动：仅渲染视口内行，适合大数据(1000+)。启用时忽略 pagination(全量滚动)、表头 sticky 固定顶部；假定行等高，不建议与 expandable 混用";
+    }, {
+        readonly name: "height";
+        readonly type: "number";
+        readonly default: "400";
+        readonly desc: "虚拟滚动视口高度(px)，virtualized 时生效";
+    }, {
+        readonly name: "rowHeight";
+        readonly type: "number";
+        readonly default: "48";
+        readonly desc: "虚拟滚动行高(px)，virtualized 时生效";
+    }];
+    readonly events: readonly [{
+        readonly name: "onSortChange";
+        readonly desc: "表头排序切换(三态循环)";
+    }, {
+        readonly name: "rowSelection.onChange";
+        readonly desc: "行选择变更，回传 keys 与对应 rows";
+    }, {
+        readonly name: "pagination.onChange";
+        readonly desc: "页码变更";
+    }, {
+        readonly name: "onRowClick";
+        readonly desc: "行点击(复选框/排序按钮已阻止冒泡)";
+    }];
+    readonly slots: readonly [{
+        readonly name: "column.render";
+        readonly desc: "单元格自定义渲染 Snippet<[{ value, record, index }]>";
+    }, {
+        readonly name: "empty";
+        readonly desc: "空态文案经 empty prop 配置(字符串)";
+    }];
+    readonly a11y: {
+        readonly hasRole: true;
+        readonly focusable: true;
+        readonly pattern: "grid|table";
+        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 responsive: false;
+    readonly examples: readonly [{
+        readonly title: "基础";
+        readonly code: "<Table {columns} dataSource={data} rowKey=\"id\" />";
+    }, {
+        readonly title: "可排序";
+        readonly code: "<Table columns={[{ dataIndex: \"age\", title: \"年龄\", sorter: true }]} dataSource={data} />";
+    }, {
+        readonly title: "行选择 + 分页";
+        readonly code: "<Table {columns} dataSource={data} rowSelection={{ onChange: (keys) => (selected = keys) }} pagination={{ pageSize: 10 }} />";
+    }, {
+        readonly title: "列宽拖拽";
+        readonly code: "<Table columns={[{ dataIndex: \"name\", title: \"姓名\", width: 160, resizable: true }]} dataSource={data} />";
+    }, {
+        readonly title: "树形数据";
+        readonly code: "<Table {columns} dataSource={treeRows} rowKey=\"key\" tree={{ defaultExpandedRowKeys: [1] }} />";
+    }, {
+        readonly title: "树形行选择父子联动";
+        readonly code: "<Table {columns} dataSource={treeRows} rowKey=\"key\" tree rowSelection={{ onChange: (keys) => (selected = keys) }} />";
+    }, {
+        readonly title: "行虚拟滚动（大数据）";
+        readonly code: "<Table {columns} dataSource={bigData} rowKey=\"id\" virtualized height={400} rowHeight={48} />";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/table/meta.js

@@ -0,0 +1,120 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Table — see specs/components/show/Table.spec.md
+ */
+export const meta = {
+    name: 'Table',
+    category: 'show',
+    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: 'dataSource', type: 'T[]', default: '[]', desc: '数据行' },
+        { name: 'rowKey', type: "string | ((record: T) => RowKey)", default: "'key'", desc: '行唯一键解析' },
+        { name: 'size', type: "'small'|'default'|'large'", default: "'default'" },
+        { name: 'bordered', type: 'boolean', default: 'false', desc: '单元格边框' },
+        { name: 'stripe', type: 'boolean', default: 'false', desc: '斑马纹' },
+        { name: 'loading', type: 'boolean', default: 'false', desc: '半透明遮罩 + spinner' },
+        { name: 'sortState', type: 'SortState', default: 'undefined', desc: '受控排序态；受控时不回写，仅 onSortChange' },
+        { name: 'defaultSortState', type: 'SortState', default: '{ key: null, order: null }', desc: '非受控初始排序' },
+        { name: 'onSortChange', type: '(state: SortState) => void', default: 'undefined' },
+        {
+            name: 'pagination',
+            type: "false | { pageSize?: number; current?: number; defaultCurrent?: number; onChange?: (page: number) => void }",
+            default: 'undefined',
+            desc: 'false 关闭；对象/缺省启用内置分页(pageSize 默认 10)。current 受控不回写',
+        },
+        {
+            name: 'rowSelection',
+            type: 'RowSelection<T>',
+            default: 'undefined',
+            desc: 'selectedRowKeys 受控不回写；defaultSelectedRowKeys / onChange / getCheckboxProps；checkStrictly(默认 false) 树形父子联动开关：false 勾父连带勾后代+后代部分选中父行半选，true 父子独立',
+        },
+        {
+            name: 'expandable',
+            type: 'Expandable<T>',
+            default: 'undefined',
+            desc: 'expandedRowRender / rowExpandable / expandedRowKeys 受控不回写 / defaultExpandedRowKeys / onExpand',
+        },
+        {
+            name: 'tree',
+            type: 'boolean | TreeTable',
+            default: 'undefined',
+            desc: '树形数据：true 或 { childrenColumnName(默认 children) / indentSize(默认 16) / expandedRowKeys 受控不回写 / defaultExpandedRowKeys / onExpand }。第一列内展开三角+逐级缩进；排序/分页/筛选作用于顶层行',
+        },
+        { name: 'rowClassName', type: '(record: T, index: number) => string', default: 'undefined' },
+        { name: 'empty', type: 'string', default: "'暂无数据'", desc: '空数据占位文案' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: 'table aria-label' },
+        { name: 'onRowClick', type: '(info: { record: T; index: number }) => void', default: 'undefined' },
+        { 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 时生效' },
+    ],
+    events: [
+        { name: 'onSortChange', desc: '表头排序切换(三态循环)' },
+        { name: 'rowSelection.onChange', desc: '行选择变更，回传 keys 与对应 rows' },
+        { name: 'pagination.onChange', desc: '页码变更' },
+        { name: 'onRowClick', desc: '行点击(复选框/排序按钮已阻止冒泡)' },
+    ],
+    slots: [
+        { name: 'column.render', desc: '单元格自定义渲染 Snippet<[{ value, record, index }]>' },
+        { name: 'empty', desc: '空态文案经 empty prop 配置(字符串)' },
+    ],
+    a11y: {
+        hasRole: true,
+        focusable: true,
+        pattern: 'grid|table',
+        keyboard: '↑↓ 行 / ←→ 列 / Home·End 行内首末 / Ctrl·Cmd+Home·End 表首末 / PageUp·PageDown 翻屏 / Enter·F2 进入单元格交互、Esc 退出',
+        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',
+    ],
+    responsive: false,
+    examples: [
+        {
+            title: '基础',
+            code: '<Table {columns} dataSource={data} rowKey="id" />',
+        },
+        {
+            title: '可排序',
+            code: '<Table columns={[{ dataIndex: "age", title: "年龄", sorter: true }]} dataSource={data} />',
+        },
+        {
+            title: '行选择 + 分页',
+            code: '<Table {columns} dataSource={data} rowSelection={{ onChange: (keys) => (selected = keys) }} pagination={{ pageSize: 10 }} />',
+        },
+        {
+            title: '列宽拖拽',
+            code: '<Table columns={[{ dataIndex: "name", title: "姓名", width: 160, resizable: true }]} dataSource={data} />',
+        },
+        {
+            title: '树形数据',
+            code: '<Table {columns} dataSource={treeRows} rowKey="key" tree={{ defaultExpandedRowKeys: [1] }} />',
+        },
+        {
+            title: '树形行选择父子联动',
+            code: '<Table {columns} dataSource={treeRows} rowKey="key" tree rowSelection={{ onChange: (keys) => (selected = keys) }} />',
+        },
+        {
+            title: '行虚拟滚动（大数据）',
+            code: '<Table {columns} dataSource={bigData} rowKey="id" virtualized height={400} rowHeight={48} />',
+        },
+    ],
+};

package/dist/table/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Table 公共类型 — 由 Table.svelte 消费、index.ts 对外 re-export。
+ * 拆成独立模块以避免 .svelte 组件无法导出类型声明的限制。
+ * See specs/components/show/Table.spec.md
+ */
+import type { Snippet } from 'svelte';
+import type { RowKey } from '@chenzy-design/core';
+export type Align = 'left' | 'center' | 'right';
+export type TableSize = 'small' | 'default' | 'large';
+export interface ColumnDef<T> {
+    /** 列唯一键，缺省回退 dataIndex / 列索引 */
+    key?: string;
+    /** 取值字段 */
+    dataIndex?: keyof T & string;
+    /** 表头文案 */
+    title: string;
+    /** 列宽 */
+    width?: number | string;
+    /** 固定列：横向滚动时左/右侧 sticky 锁定（需配合 width 数值） */
+    fixed?: 'left' | 'right';
+    /** 列宽可拖拽调整：列头右侧出现拖拽手柄，指针拖拽实时改列宽 */
+    resizable?: boolean;
+    /** 对齐方式，默认 left */
+    align?: Align;
+    /** 单元格溢出省略 */
+    ellipsis?: boolean;
+    /** true 按 dataIndex 默认比较；或自定义比较器 */
+    sorter?: boolean | ((a: T, b: T) => number);
+    /** 受控排序状态（当前列）*/
+    sortOrder?: 'ascend' | 'descend' | null;
+    /** 默认排序状态 */
+    defaultSortOrder?: 'ascend' | 'descend' | null;
+    /** 列头筛选项（下拉多选）；配合 onFilter 过滤数据 */
+    filters?: {
+        text: string;
+        value: string | number;
+    }[];
+    /** 受控列筛选值 */
+    filteredValue?: (string | number)[] | null;
+    /** 是否多选筛选，默认 true */
+    filterMultiple?: boolean;
+    /** 行是否匹配某筛选值；缺省时按 dataIndex 全等比较 */
+    onFilter?: (value: string | number, record: T) => boolean;
+    /** 单元格自定义渲染 */
+    render?: Snippet<[{
+        value: unknown;
+        record: T;
+        index: number;
+    }]>;
+}
+export interface Expandable<T> {
+    /** 展开行内容渲染 */
+    expandedRowRender: Snippet<[{
+        record: T;
+        index: number;
+    }]>;
+    /** 该行是否可展开，默认全部可展开 */
+    rowExpandable?: (record: T) => boolean;
+    /** 受控展开行 key 列表 */
+    expandedRowKeys?: RowKey[];
+    /** 非受控初始展开 */
+    defaultExpandedRowKeys?: RowKey[];
+    /** 展开/收起回调 */
+    onExpand?: (expanded: boolean, record: T) => void;
+}
+export interface TreeTable {
+    /** 子行字段名，默认 'children' */
+    childrenColumnName?: string;
+    /** 每层缩进像素，默认 16 */
+    indentSize?: number;
+    /** 非受控初始展开行 key 列表 */
+    defaultExpandedRowKeys?: RowKey[];
+    /** 受控展开行 key 列表；受控时不回写，仅 onExpand 通知 */
+    expandedRowKeys?: RowKey[];
+    /** 展开/收起回调 */
+    onExpand?: (expanded: boolean, key: RowKey) => void;
+}
+export interface RowSelection<T> {
+    /** 受控选中行 key 列表 */
+    selectedRowKeys?: RowKey[];
+    /** 非受控初始选中 */
+    defaultSelectedRowKeys?: RowKey[];
+    /** 选择变更回调 */
+    onChange?: (keys: RowKey[], rows: T[]) => void;
+    /** 逐行定制复选框属性（如 disabled） */
+    getCheckboxProps?: (record: T) => {
+        disabled?: boolean;
+    };
+    /**
+     * 树形表父子选择是否独立。默认 false：勾选父行连带勾选所有后代，
+     * 后代部分选中时父行显示半选(indeterminate)。true 时父子互不联动
+     * （等同非树形表逐行选择，向后兼容）。仅在 tree 启用时生效。
+     */
+    checkStrictly?: boolean;
+    /** 选择方式: checkbox（多选）或 radio（单选），默认 checkbox */
+    type?: 'checkbox' | 'radio';
+    /** 单行选择回调 */
+    onSelect?: (record: T, selected: boolean, selectedRows: T[]) => void;
+    /** 全选回调 */
+    onSelectAll?: (selected: boolean, selectedRows: T[], changedRows: T[]) => void;
+    /** 选择列固定 */
+    fixed?: boolean | 'left';
+    /** 选择列宽度 */
+    columnWidth?: number | string;
+    /** 隐藏全选框 */
+    hideSelectAll?: boolean;
+}
+export interface ScrollConfig {
+    x?: number | string;
+    y?: number | string;
+    scrollToFirstRowOnChange?: boolean;
+}
+/** 聚合 onChange 的 extra.action 取值 */
+export type TableChangeAction = 'paginate' | 'sort' | 'filter';
+/** 聚合 onChange 载荷（排序/筛选/分页任一变化的主入口，spec §4） */
+export interface TableChangeInfo {
+    pagination: {
+        current: number;
+        pageSize: number;
+    };
+    filters: Record<string, (string | number)[]>;
+    sorter: SortStateLike;
+    extra: {
+        action: TableChangeAction;
+    };
+}
+/** onScroll 载荷（spec §4，含触底用于无限加载） */
+export interface TableScrollInfo {
+    scrollLeft: number;
+    scrollTop: number;
+    atLeft: boolean;
+    atRight: boolean;
+    atTop: boolean;
+    atBottom: boolean;
+}
+type SortStateLike = import('@chenzy-design/core').SortState;
+export type { RowKey } from '@chenzy-design/core';
+export type { SortState, SortOrder } from '@chenzy-design/core';
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/table/types.js

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

package/dist/tabs/TabPane.svelte

@@ -0,0 +1,92 @@
+<!--
+  TabPane — 声明式内容面板，配合 Tabs 使用。
+  两种用法：
+  1) 父传 tabList（数据驱动标签栏）：TabPane 仅提供「内容」，按 context 的 activeKey getter 显隐，
+     itemKey 需与对应 tabList 项一致。
+  2) 父不传 tabList（纯声明式自动收集）：TabPane 额外把 tab/itemKey/disabled/closable 注册给父，
+     父据此推导标签栏。注册/注销/同步均在 $effect（mount/unmount/元数据变化），向父写普通数组 +
+     bump version（红线 #2：副作用写、render 读分离，绝不在注册 effect 读父快照 → 无自循环）。
+-->
+<script lang="ts">
+  import { untrack, type Snippet } from 'svelte';
+  import { getTabsContext, type TabPaneRegistration } from './context.js';
+
+  type TabKey = string | number;
+
+  interface Props {
+    itemKey: TabKey;
+    tab?: string;
+    disabled?: boolean;
+    closable?: boolean;
+    children?: Snippet;
+  }
+
+  let { itemKey, tab, disabled, closable, children }: Props = $props();
+
+  const ctx = getTabsContext();
+  const active = $derived(ctx?.getActiveKey() === itemKey);
+  const lazy = $derived(ctx?.getLazy() ?? false);
+  const keepDOM = $derived(ctx?.getKeepDOM() ?? false);
+  // 与 tab 按钮双向关联的稳定 id（aria-controls ↔ id / aria-labelledby）。
+  const panelId = $derived(ctx?.getPanelId(itemKey));
+  const labelledBy = $derived(ctx?.getTabId(itemKey));
+
+  // 纯声明式自动收集：mount 注册自身标签元数据、unmount 注销；元数据变化时 update 同步。
+  // 红线 #2：注册 $effect 只向父写（普通数组 + version bump），绝不读父收集快照 → 无自循环。
+  // 注册不依赖挂载与否（lazy 模式面板未挂载也要在标签栏出现），故独立于 shouldMount。
+  // exactOptionalPropertyTypes：仅在有值时带 disabled/closable 键（不写 undefined）。
+  function buildReg(): TabPaneRegistration {
+    return {
+      itemKey,
+      tab: tab ?? String(itemKey),
+      ...(disabled !== undefined ? { disabled } : {}),
+      ...(closable !== undefined ? { closable } : {}),
+    };
+  }
+
+  let paneId = $state(-1);
+  $effect(() => {
+    const reg = ctx?.registerPane;
+    if (!reg) return;
+    // 注册仅在 mount/unmount 跑一次：untrack 读初值，避免 itemKey 等变化触发重注册（保序）。
+    const id = untrack(() => reg(buildReg()));
+    paneId = id;
+    return () => ctx?.unregisterPane?.(id);
+  });
+  // 元数据变化（tab/itemKey/disabled/closable）→ 同步给父（独立 effect，读响应值并写父）。
+  $effect(() => {
+    if (paneId === -1) return;
+    ctx?.updatePane?.(paneId, buildReg());
+  });
+
+  // 记录是否曾激活过（红线 #2：本地 $state 在 effect 内写，不在 render 期写）。
+  let everActive = $state(false);
+  $effect(() => {
+    if (active) everActive = true;
+  });
+
+  // 渲染策略：
+  // - 非 keepDOM：仅渲染当前激活面板（切走即卸载）——天然懒挂。
+  // - keepDOM + lazy：首次激活才挂，之后保留 DOM（display:none 隐藏）。
+  // - keepDOM 非 lazy：预挂全部面板并保留（无懒加载）。
+  const shouldMount = $derived(keepDOM ? (lazy ? everActive : true) : active);
+</script>
+
+{#if shouldMount}
+  <div
+    class="cd-tabs__panel"
+    role="tabpanel"
+    id={panelId}
+    aria-labelledby={labelledBy}
+    tabindex="0"
+    hidden={!active}
+  >
+    {@render children?.()}
+  </div>
+{/if}
+
+<style>
+  .cd-tabs__panel {
+    outline: none;
+  }
+</style>

package/dist/tabs/TabPane.svelte.d.ts

@@ -0,0 +1,13 @@
+import { type Snippet } from 'svelte';
+type TabKey = string | number;
+interface Props {
+    itemKey: TabKey;
+    tab?: string;
+    disabled?: boolean;
+    closable?: boolean;
+    children?: Snippet;
+}
+declare const TabPane: import("svelte").Component<Props, {}, "">;
+type TabPane = ReturnType<typeof TabPane>;
+export default TabPane;
+//# sourceMappingURL=TabPane.svelte.d.ts.map

package/dist/tabs/TabPane.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabPane.svelte.d.ts","sourceRoot":"","sources":["../../src/tabs/TabPane.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAI7C,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9B,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAqEH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/tabs/Tabs.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Tabs.a11y.test.d.ts.map

package/dist/tabs/Tabs.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.a11y.test.d.ts","sourceRoot":"","sources":["../../src/tabs/Tabs.a11y.test.ts"],"names":[],"mappings":""}

package/dist/tabs/Tabs.a11y.test.js

@@ -0,0 +1,43 @@
+// Tabs a11y：标签页。
+// 容器 role=tablist，每个标签 role=tab + aria-selected，激活标签 aria-selected=true，
+// 面板 role=tabpanel（aria-controls ↔ id 关联）。
+// 用声明式 <Tabs.Pane> 夹具（TabsA11yFixture）渲染真实面板，使 aria-controls 不悬空。
+import { describe, it, expect, beforeAll } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import TabsFixture from './TabsA11yFixture.svelte';
+// jsdom 无 ResizeObserver（Tabs 用其检测标签栏溢出）。仅在本测试内补一个 no-op 桩，
+// 不改基建/组件源码——溢出滚动行为不在静态 a11y 测试范围（留给 Playwright）。
+beforeAll(() => {
+    if (!('ResizeObserver' in globalThis)) {
+        globalThis.ResizeObserver = class {
+            observe() { }
+            unobserve() { }
+            disconnect() { }
+        };
+    }
+});
+describe('Tabs a11y', () => {
+    it('默认渲染：role=tablist + tab + tabpanel，无 axe violations', async () => {
+        const { container } = renderWithLocale(TabsFixture, {});
+        expect(container.querySelector('[role="tablist"]')).not.toBeNull();
+        expect(container.querySelectorAll('[role="tab"]').length).toBe(3);
+        expect(container.querySelector('[role="tabpanel"]')).not.toBeNull();
+        await expectNoAxeViolations(container);
+    });
+    it('选中态：defaultValue 标签 aria-selected=true，其余 false', async () => {
+        const { container } = renderWithLocale(TabsFixture, {
+            props: { defaultValue: 'details' },
+        });
+        const selected = container.querySelectorAll('[role="tab"][aria-selected="true"]');
+        expect(selected.length).toBe(1);
+        expect(selected[0]?.textContent).toContain('Details');
+        await expectNoAxeViolations(container);
+    });
+    it('card 类型：role 语义不变，无 axe violations', async () => {
+        const { container } = renderWithLocale(TabsFixture, {
+            props: { type: 'card' },
+        });
+        expect(container.querySelectorAll('[role="tab"]').length).toBe(3);
+        await expectNoAxeViolations(container);
+    });
+});

package/dist/tabs/Tabs.kbd.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Tabs.kbd.test.d.ts.map

package/dist/tabs/Tabs.kbd.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.kbd.test.d.ts","sourceRoot":"","sources":["../../src/tabs/Tabs.kbd.test.ts"],"names":[],"mappings":""}