niuma-ui 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (190) hide show
  1. package/CHANGELOG.md +65 -1
  2. package/package.json +10 -2
  3. package/src/__tests__/RsButton.spec.ts +47 -0
  4. package/src/__tests__/RsCard.spec.ts +160 -1
  5. package/src/__tests__/RsConfirmDialog.spec.ts +127 -0
  6. package/src/__tests__/RsContextMenu.spec.ts +12 -0
  7. package/src/__tests__/RsDatePicker.spec.ts +21 -0
  8. package/src/__tests__/RsDateTimePicker.spec.ts +11 -0
  9. package/src/__tests__/RsDescriptions.spec.ts +50 -0
  10. package/src/__tests__/RsDialog.spec.ts +178 -0
  11. package/src/__tests__/RsDrawer.spec.ts +96 -3
  12. package/src/__tests__/RsDynamicTags.spec.ts +52 -0
  13. package/src/__tests__/RsForm.spec.ts +250 -6
  14. package/src/__tests__/RsFormItem.spec.ts +478 -0
  15. package/src/__tests__/RsFormList.spec.ts +109 -0
  16. package/src/__tests__/RsInput.spec.ts +108 -1
  17. package/src/__tests__/RsInputNumber.spec.ts +33 -0
  18. package/src/__tests__/RsMenu.spec.ts +406 -14
  19. package/src/__tests__/RsPagination.spec.ts +67 -2
  20. package/src/__tests__/RsSelect.spec.ts +465 -2
  21. package/src/__tests__/RsSwitch.spec.ts +74 -0
  22. package/src/__tests__/RsTable.a11y.spec.ts +83 -0
  23. package/src/__tests__/RsTable.dom-baseline.spec.ts +87 -0
  24. package/src/__tests__/RsTable.perf.spec.ts +23 -4
  25. package/src/__tests__/RsTable.spec.ts +63 -8
  26. package/src/__tests__/RsTable.ssr.spec.ts +71 -0
  27. package/src/__tests__/RsTable.summary.spec.ts +45 -0
  28. package/src/__tests__/RsTabs.spec.ts +102 -4
  29. package/src/__tests__/RsTimePicker.spec.ts +20 -0
  30. package/src/__tests__/RsTooltip.spec.ts +43 -0
  31. package/src/__tests__/RsUpload.spec.ts +62 -6
  32. package/src/__tests__/createRsDialog.spec.ts +145 -0
  33. package/src/__tests__/css-token.spec.ts +51 -0
  34. package/src/__tests__/date-picker-utils.spec.ts +49 -0
  35. package/src/__tests__/dialog-utils.spec.ts +43 -0
  36. package/src/__tests__/form-path.spec.ts +46 -0
  37. package/src/__tests__/form-rules.spec.ts +139 -0
  38. package/src/__tests__/perf-budgets.ts +32 -0
  39. package/src/__tests__/rs-table-api.spec.ts +206 -0
  40. package/src/__tests__/rs-table-compat-matrix.spec.ts +108 -0
  41. package/src/__tests__/rs-table-echarts-adapter.spec.ts +43 -0
  42. package/src/__tests__/rs-table-grid-nav.spec.ts +63 -0
  43. package/src/__tests__/rs-table-isolation.spec.ts +158 -0
  44. package/src/__tests__/split-pane-utils.spec.ts +21 -0
  45. package/src/__tests__/table-chart-utils.spec.ts +88 -0
  46. package/src/__tests__/table-summary-utils.spec.ts +62 -0
  47. package/src/__tests__/table-utils.spec.ts +124 -0
  48. package/src/__tests__/theme.spec.ts +27 -0
  49. package/src/__tests__/useRsTableColumnResize.spec.ts +25 -0
  50. package/src/__tests__/useRsTableCore.perf.spec.ts +170 -0
  51. package/src/components/RsAlert.vue +212 -0
  52. package/src/components/RsAvatar.vue +1 -1
  53. package/src/components/RsBadge.vue +1 -1
  54. package/src/components/RsBreadcrumb.vue +1 -1
  55. package/src/components/RsButton.vue +147 -23
  56. package/src/components/RsCalendarGrid.vue +3 -3
  57. package/src/components/RsCard.vue +204 -20
  58. package/src/components/RsCodeBlock.vue +4 -4
  59. package/src/components/RsCodeEditor.vue +8 -8
  60. package/src/components/RsConfirmDialog.vue +217 -30
  61. package/src/components/RsContextMenu.vue +57 -17
  62. package/src/components/RsDatePicker.vue +316 -39
  63. package/src/components/RsDateTimePicker.vue +27 -2
  64. package/src/components/RsDescriptions.vue +186 -0
  65. package/src/components/RsDescriptionsItem.vue +32 -0
  66. package/src/components/RsDialog.vue +374 -52
  67. package/src/components/RsDivider.vue +89 -0
  68. package/src/components/RsDrawer.vue +559 -34
  69. package/src/components/RsDropdown.vue +34 -3
  70. package/src/components/RsDynamicTags.vue +531 -0
  71. package/src/components/RsEmpty.vue +1 -1
  72. package/src/components/RsForm.vue +164 -8
  73. package/src/components/RsFormItem.vue +423 -0
  74. package/src/components/RsFormItemControl.vue +21 -0
  75. package/src/components/RsFormList.vue +117 -0
  76. package/src/components/RsInput.vue +491 -100
  77. package/src/components/RsInputNumber.vue +77 -27
  78. package/src/components/RsLabel.vue +20 -5
  79. package/src/components/RsLink.vue +1 -1
  80. package/src/components/RsLoadingBar.vue +151 -0
  81. package/src/components/RsMarkdown.vue +5 -5
  82. package/src/components/RsMenu.vue +74 -16
  83. package/src/components/RsMenuItems.vue +147 -9
  84. package/src/components/RsMonacoEditor.vue +9 -3
  85. package/src/components/RsPagination.vue +93 -14
  86. package/src/components/RsProseEditor.vue +3 -3
  87. package/src/components/RsRadio.vue +81 -0
  88. package/src/components/RsRadioItem.vue +156 -0
  89. package/src/components/RsSelect.vue +372 -642
  90. package/src/components/RsSidebarGroup.vue +1 -1
  91. package/src/components/RsSplitPane.vue +90 -1
  92. package/src/components/RsStatCard.vue +2 -2
  93. package/src/components/RsSteps.vue +2 -2
  94. package/src/components/RsSwitch.vue +192 -0
  95. package/src/components/RsTable.vue +653 -2555
  96. package/src/components/RsTabs.vue +422 -90
  97. package/src/components/RsTag.vue +191 -0
  98. package/src/components/RsTerminal.vue +58 -19
  99. package/src/components/RsTimePicker.vue +72 -9
  100. package/src/components/RsTimePickerColumns.vue +137 -78
  101. package/src/components/RsToaster.vue +64 -24
  102. package/src/components/RsTooltip.vue +10 -1
  103. package/src/components/RsTooltipProvider.vue +11 -1
  104. package/src/components/RsTree.vue +45 -27
  105. package/src/components/RsUpload.vue +147 -14
  106. package/src/components/RsVNodeHost.vue +20 -0
  107. package/src/components/button-utils.ts +39 -0
  108. package/src/components/context-menu-utils.ts +6 -0
  109. package/src/components/date-picker-utils.ts +195 -4
  110. package/src/components/descriptions-utils.ts +24 -0
  111. package/src/components/dialog-utils.ts +182 -0
  112. package/src/components/dialog-window.ts +74 -9
  113. package/src/components/drawer-utils.ts +73 -0
  114. package/src/components/form-item-control.ts +55 -0
  115. package/src/components/form-path.ts +92 -0
  116. package/src/components/form-rules.ts +311 -0
  117. package/src/components/form-utils.ts +145 -3
  118. package/src/components/menu-utils.ts +11 -0
  119. package/src/components/overlay-utils.ts +3 -0
  120. package/src/components/radio-utils.ts +12 -0
  121. package/src/components/reka.ts +5 -0
  122. package/src/components/select-utils.ts +285 -6
  123. package/src/components/split-pane-utils.ts +65 -12
  124. package/src/components/table/RsTableBody.vue +217 -0
  125. package/src/components/table/RsTableBodyRow.vue +90 -1
  126. package/src/components/table/RsTableColGroup.vue +41 -0
  127. package/src/components/table/RsTableHeader.vue +158 -0
  128. package/src/components/table/RsTableHeaderFilter.vue +1 -1
  129. package/src/components/table/RsTableSummaryRow.vue +52 -0
  130. package/src/components/table/rs-table-api.ts +99 -0
  131. package/src/components/table/rs-table-compat-matrix.ts +71 -0
  132. package/src/components/table/rs-table-echarts-adapter.ts +81 -0
  133. package/src/components/table/rs-table-feature-host.ts +178 -0
  134. package/src/components/table/rs-table-grid-nav.ts +122 -0
  135. package/src/components/table/rs-table-header-types.ts +47 -0
  136. package/src/components/table/rs-table-module-registry.ts +72 -0
  137. package/src/components/table/rs-table-props.ts +274 -0
  138. package/src/components/table/rs-table-view-context.ts +258 -0
  139. package/src/components/table/rs-table.css +85 -7
  140. package/src/components/table/table-chart-utils.ts +165 -0
  141. package/src/components/table/table-features.ts +284 -0
  142. package/src/components/table/table-summary-utils.ts +194 -0
  143. package/src/components/table-utils.ts +452 -2
  144. package/src/components/tabs-utils.ts +142 -2
  145. package/src/components/time-picker-utils.ts +76 -3
  146. package/src/components/upload-utils.ts +122 -0
  147. package/src/components/use-rs-select.ts +436 -0
  148. package/src/components/virtual-list-utils.ts +15 -2
  149. package/src/composables/assembleRsTableApi.ts +79 -0
  150. package/src/composables/bindRsTableViewContext.ts +269 -0
  151. package/src/composables/createRsDialog.ts +357 -0
  152. package/src/composables/createRsTableEditEmitBridge.ts +38 -0
  153. package/src/composables/useRsConfig.ts +10 -3
  154. package/src/composables/useRsI18n.ts +16 -5
  155. package/src/composables/useRsLoadingBar.ts +36 -0
  156. package/src/composables/useRsTable.ts +134 -0
  157. package/src/composables/useRsTableA11y.ts +52 -0
  158. package/src/composables/useRsTableChartBridge.ts +79 -0
  159. package/src/composables/useRsTableColumnLayout.ts +320 -0
  160. package/src/composables/useRsTableColumnResize.ts +244 -0
  161. package/src/composables/useRsTableColumnVirtual.ts +180 -0
  162. package/src/composables/useRsTableColumns.ts +200 -0
  163. package/src/composables/useRsTableContextMenu.ts +257 -0
  164. package/src/composables/useRsTableCore.ts +256 -0
  165. package/src/composables/useRsTableEditActions.ts +606 -0
  166. package/src/composables/useRsTableEditLayer.ts +251 -0
  167. package/src/composables/useRsTableEngine.ts +357 -0
  168. package/src/composables/useRsTableGridKeyboard.ts +123 -0
  169. package/src/composables/useRsTableHeadless.ts +137 -0
  170. package/src/composables/useRsTableInteraction.ts +433 -0
  171. package/src/composables/useRsTableScrollHost.ts +75 -0
  172. package/src/composables/useRsTableScrollLayout.ts +255 -0
  173. package/src/composables/useRsTableSelectionSource.ts +89 -0
  174. package/src/composables/useRsTableShell.ts +416 -0
  175. package/src/composables/useRsTableShellChrome.ts +170 -0
  176. package/src/composables/useRsTableSummary.ts +113 -0
  177. package/src/composables/useRsTableViewProvide.ts +263 -0
  178. package/src/composables/useRsTableVirtual.ts +154 -0
  179. package/src/composables/useRsTabsNav.ts +4 -0
  180. package/src/composables/useTableEdit.ts +1 -1
  181. package/src/index.ts +378 -10
  182. package/src/locale/interpolate.ts +32 -0
  183. package/src/locale/messages.ts +40 -0
  184. package/src/styles.css +365 -56
  185. package/src/theme/brand.example.css +24 -2
  186. package/src/theme/css-token.ts +107 -0
  187. package/src/theme/presets.ts +4 -0
  188. package/src/theme/types.ts +68 -0
  189. package/src/components/RsTableColgroup.vue +0 -17
  190. package/src/components/RsTableHeaderRow.vue +0 -30
@@ -0,0 +1,178 @@
1
+ /**
2
+ * Feature 运行时宿主:贡献袋 + 生命周期(对标可插拔中间件总线)。
3
+ *
4
+ * 贡献点(实例级,多表互不串扰):
5
+ * - contextMenu:右键菜单
6
+ * - toolbar:表头工具条项
7
+ * - overlay:浮层/旁路 UI 标记(图表容器挂载点等)
8
+ *
9
+ * 每个 RsTable 各自 createRsTableFeatureHost();不要跨实例复用 host。
10
+ */
11
+
12
+ import type { RsContextMenuItem } from '../context-menu-utils'
13
+ import type { RsTableRowData } from '../table-utils'
14
+ import type { RsTableAnalyticsSnapshot } from '../../composables/useRsTableSelectionSource'
15
+ import type { RsTableFeature, RsTableFeatureContext } from './table-features'
16
+ import { setupTableFeatures } from './table-features'
17
+
18
+ /** 动态右键菜单贡献函数 */
19
+ export type RsTableContextMenuContributor<T extends RsTableRowData> = (
20
+ items: RsContextMenuItem[],
21
+ ctx: { row: T | null; selectedRows: T[] },
22
+ ) => void
23
+
24
+ /** 工具条贡献项 */
25
+ export interface RsTableToolbarItem {
26
+ key: string
27
+ label: string
28
+ icon?: string
29
+ disabled?: boolean
30
+ onClick?: () => void
31
+ }
32
+
33
+ export type RsTableToolbarContributor = (
34
+ items: RsTableToolbarItem[],
35
+ ) => void
36
+
37
+ /** Overlay 贡献(旁路挂载描述,不直接操作 DOM) */
38
+ export interface RsTableOverlayContribution {
39
+ key: string
40
+ /** 业务自定义渲染/挂载标识 */
41
+ slot?: string
42
+ meta?: Record<string, unknown>
43
+ }
44
+
45
+ export type RsTableOverlayContributor = (
46
+ items: RsTableOverlayContribution[],
47
+ ) => void
48
+
49
+ /**
50
+ * 单次 setup 周期内的贡献收集器(实例私有)。
51
+ */
52
+ export interface RsTableFeatureHost<T extends RsTableRowData = RsTableRowData> {
53
+ createContext: (base: {
54
+ getViewRows: () => T[]
55
+ getSelectedRows: () => T[]
56
+ getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
57
+ subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
58
+ }) => RsTableFeatureContext<T>
59
+ setup: (features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>) => () => void
60
+ mergeContextMenuItems: (
61
+ baseItems: RsContextMenuItem[],
62
+ menuCtx: { row: T | null; selectedRows: T[] },
63
+ ) => RsContextMenuItem[]
64
+ /** 合并 toolbar 贡献 */
65
+ getToolbarItems: () => RsTableToolbarItem[]
66
+ /** 合并 overlay 贡献 */
67
+ getOverlayContributions: () => RsTableOverlayContribution[]
68
+ getActiveFeatureIds: () => string[]
69
+ }
70
+
71
+ /**
72
+ * 创建 Feature 宿主(每个 RsTable 实例一个 —— 多表请各建各的)。
73
+ */
74
+ export function createRsTableFeatureHost<T extends RsTableRowData>(): RsTableFeatureHost<T> {
75
+ let menuContributors: Array<RsTableContextMenuContributor<T>> = []
76
+ let toolbarContributors: RsTableToolbarContributor[] = []
77
+ let overlayContributors: RsTableOverlayContributor[] = []
78
+ let activeIds: string[] = []
79
+
80
+ function createContext(base: {
81
+ getViewRows: () => T[]
82
+ getSelectedRows: () => T[]
83
+ getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
84
+ subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
85
+ }): RsTableFeatureContext<T> {
86
+ return {
87
+ getViewRows: base.getViewRows,
88
+ getSelectedRows: base.getSelectedRows,
89
+ getAnalyticsSnapshot: base.getAnalyticsSnapshot,
90
+ subscribeAnalytics: base.subscribeAnalytics,
91
+ contributeContextMenuItems(contributor) {
92
+ if (typeof contributor === 'function') {
93
+ menuContributors.push(contributor)
94
+ return
95
+ }
96
+ const staticItems = contributor
97
+ menuContributors.push((items) => {
98
+ items.push(...staticItems)
99
+ })
100
+ },
101
+ contributeToolbarItems(contributor) {
102
+ if (typeof contributor === 'function') {
103
+ toolbarContributors.push(contributor)
104
+ return
105
+ }
106
+ const staticItems = contributor
107
+ toolbarContributors.push((items) => {
108
+ items.push(...staticItems)
109
+ })
110
+ },
111
+ contributeOverlay(contributor) {
112
+ if (typeof contributor === 'function') {
113
+ overlayContributors.push(contributor)
114
+ return
115
+ }
116
+ const staticItems = contributor
117
+ overlayContributors.push((items) => {
118
+ items.push(...staticItems)
119
+ })
120
+ },
121
+ }
122
+ }
123
+
124
+ function setup(features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>): () => void {
125
+ menuContributors = []
126
+ toolbarContributors = []
127
+ overlayContributors = []
128
+ activeIds = features.map((f) => f.id)
129
+ const dispose = setupTableFeatures(features, ctx)
130
+ return () => {
131
+ dispose()
132
+ menuContributors = []
133
+ toolbarContributors = []
134
+ overlayContributors = []
135
+ activeIds = []
136
+ }
137
+ }
138
+
139
+ function mergeContextMenuItems(
140
+ baseItems: RsContextMenuItem[],
141
+ menuCtx: { row: T | null; selectedRows: T[] },
142
+ ): RsContextMenuItem[] {
143
+ const items = [...baseItems]
144
+ const before = items.length
145
+ for (const contribute of menuContributors) {
146
+ contribute(items, menuCtx)
147
+ }
148
+ if (before > 0 && items.length > before && !items[before]?.separator) {
149
+ items.splice(before, 0, { key: '__ctx-feature-sep', label: '', separator: true })
150
+ }
151
+ return items
152
+ }
153
+
154
+ function getToolbarItems(): RsTableToolbarItem[] {
155
+ const items: RsTableToolbarItem[] = []
156
+ for (const contribute of toolbarContributors) contribute(items)
157
+ return items
158
+ }
159
+
160
+ function getOverlayContributions(): RsTableOverlayContribution[] {
161
+ const items: RsTableOverlayContribution[] = []
162
+ for (const contribute of overlayContributors) contribute(items)
163
+ return items
164
+ }
165
+
166
+ function getActiveFeatureIds(): string[] {
167
+ return [...activeIds]
168
+ }
169
+
170
+ return {
171
+ createContext,
172
+ setup,
173
+ mergeContextMenuItems,
174
+ getToolbarItems,
175
+ getOverlayContributions,
176
+ getActiveFeatureIds,
177
+ }
178
+ }
@@ -0,0 +1,122 @@
1
+ /**
2
+ * ARIA Grid 单元格导航(矩形行列模型,不限于可编辑格)。
3
+ * 对标 Excel / AG Grid 漫游:箭头、Home/End、Ctrl+Home/End、PageUp/PageDown。
4
+ */
5
+
6
+ export type RsTableGridNavDirection =
7
+ | 'left'
8
+ | 'right'
9
+ | 'up'
10
+ | 'down'
11
+ | 'home'
12
+ | 'end'
13
+ | 'first'
14
+ | 'last'
15
+ | 'pageUp'
16
+ | 'pageDown'
17
+
18
+ export interface RsTableGridCellRef {
19
+ rowKey: string
20
+ colKey: string
21
+ rowIndex: number
22
+ }
23
+
24
+ /**
25
+ * 在「行列表 × 列 key」矩形上移动焦点。
26
+ * rows 按视觉顺序;colKeys 为可见数据列顺序。
27
+ */
28
+ export function navigateGridCell(
29
+ rows: Array<{ rowKey: string; rowIndex: number }>,
30
+ colKeys: string[],
31
+ current: RsTableGridCellRef | null,
32
+ direction: RsTableGridNavDirection,
33
+ pageSize = 10,
34
+ ): RsTableGridCellRef | null {
35
+ if (!rows.length || !colKeys.length) return null
36
+
37
+ const seed = current ?? {
38
+ rowKey: rows[0]!.rowKey,
39
+ colKey: colKeys[0]!,
40
+ rowIndex: rows[0]!.rowIndex,
41
+ }
42
+
43
+ let rowPos = rows.findIndex((r) => r.rowKey === seed.rowKey)
44
+ if (rowPos < 0) rowPos = 0
45
+ let colPos = colKeys.indexOf(seed.colKey)
46
+ if (colPos < 0) colPos = 0
47
+
48
+ const lastRow = rows.length - 1
49
+ const lastCol = colKeys.length - 1
50
+ const step = Math.max(1, pageSize)
51
+
52
+ switch (direction) {
53
+ case 'left':
54
+ colPos = Math.max(0, colPos - 1)
55
+ break
56
+ case 'right':
57
+ colPos = Math.min(lastCol, colPos + 1)
58
+ break
59
+ case 'up':
60
+ rowPos = Math.max(0, rowPos - 1)
61
+ break
62
+ case 'down':
63
+ rowPos = Math.min(lastRow, rowPos + 1)
64
+ break
65
+ case 'home':
66
+ colPos = 0
67
+ break
68
+ case 'end':
69
+ colPos = lastCol
70
+ break
71
+ case 'first':
72
+ rowPos = 0
73
+ colPos = 0
74
+ break
75
+ case 'last':
76
+ rowPos = lastRow
77
+ colPos = lastCol
78
+ break
79
+ case 'pageUp':
80
+ rowPos = Math.max(0, rowPos - step)
81
+ break
82
+ case 'pageDown':
83
+ rowPos = Math.min(lastRow, rowPos + step)
84
+ break
85
+ default:
86
+ break
87
+ }
88
+
89
+ const row = rows[rowPos]!
90
+ return {
91
+ rowKey: row.rowKey,
92
+ colKey: colKeys[colPos]!,
93
+ rowIndex: row.rowIndex,
94
+ }
95
+ }
96
+
97
+ /**
98
+ * 将 KeyboardEvent 映射为网格导航方向;无法识别则返回 null。
99
+ */
100
+ export function resolveGridNavDirection(event: KeyboardEvent): RsTableGridNavDirection | null {
101
+ const mod = event.ctrlKey || event.metaKey
102
+ switch (event.key) {
103
+ case 'ArrowLeft':
104
+ return 'left'
105
+ case 'ArrowRight':
106
+ return 'right'
107
+ case 'ArrowUp':
108
+ return 'up'
109
+ case 'ArrowDown':
110
+ return 'down'
111
+ case 'Home':
112
+ return mod ? 'first' : 'home'
113
+ case 'End':
114
+ return mod ? 'last' : 'end'
115
+ case 'PageUp':
116
+ return 'pageUp'
117
+ case 'PageDown':
118
+ return 'pageDown'
119
+ default:
120
+ return null
121
+ }
122
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * RsTableHeader 视图契约(对标列头渲染层,与 Engine 解耦)。
3
+ */
4
+
5
+ import type { CSSProperties } from 'vue'
6
+ import type { RsTableColumn, RsTableRowData } from '../table-utils'
7
+
8
+ export interface RsTableHeaderProps<T extends RsTableRowData = RsTableRowData> {
9
+ showRowDragHandle: boolean
10
+ detailExpandable: boolean
11
+ showSelectColumn: boolean
12
+ isRadioSelection: boolean
13
+ selectAllState: 'checked' | 'indeterminate' | 'unchecked'
14
+ showEditGutterColumn: boolean
15
+ showIndexColumn: boolean
16
+ showRowStatusColumn: boolean
17
+ columnPadLeft: number
18
+ columnPadRight: number
19
+ visibleDataColumns: RsTableColumn<T>[]
20
+ columnDraggable: boolean
21
+ resizable: boolean
22
+ multiSort: boolean
23
+ columnFiltersState: Record<string, string>
24
+ dragColumnKey: string | null
25
+ dropColumnKey: string | null
26
+ dragLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
27
+ expandLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
28
+ selectLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
29
+ gutterLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
30
+ indexLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
31
+ columnHeaderStyleMap: Map<string, Record<string, string> | undefined>
32
+ columnFilterValue: (key: string) => string
33
+ isColumnFilterActive: (filters: Record<string, string>, key: string) => boolean
34
+ sortOrderFor: (key: string) => string | null | undefined
35
+ sortPriorityFor: (key: string) => number
36
+ sortIconName: (key: string) => string
37
+ labels: {
38
+ selectAll: string
39
+ index: string
40
+ rowStatus: string
41
+ dragColumn: string
42
+ filterColumn: string
43
+ filterPlaceholder: string
44
+ filterClear: string
45
+ filterApply: string
46
+ }
47
+ }
@@ -0,0 +1,72 @@
1
+ /**
2
+ * RsTable 模块注册表(对标 AG Grid ModuleRegistry)。
3
+ *
4
+ * - 全局 register:所有表格实例默认挂载(同页多表会共享这些模块)
5
+ * - 实例 props.features:仅该实例;同 id 覆盖全局
6
+ * - 不改内核渲染;模块通过 Feature.setup 订阅/贡献
7
+ * - 多表隔离要点:选中/编辑/ViewContext 仍是实例私有;仅 Registry 是全局点
8
+ */
9
+
10
+ import type { RsTableFeature } from './table-features'
11
+ import type { RsTableRowData } from '../table-utils'
12
+
13
+ const globalModules: RsTableFeature<RsTableRowData>[] = []
14
+
15
+ /**
16
+ * 全局模块注册表。
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * RsTableModuleRegistry.register(
21
+ * createAnalyticsTableFeature({ onSnapshot: (s) => syncCharts(s) }),
22
+ * )
23
+ * ```
24
+ */
25
+ export const RsTableModuleRegistry = {
26
+ /**
27
+ * 注册全局 feature(幂等:同 id 覆盖)。
28
+ */
29
+ register<T extends RsTableRowData>(feature: RsTableFeature<T>): void {
30
+ const id = feature.id
31
+ const idx = globalModules.findIndex((item) => item.id === id)
32
+ const next = feature as RsTableFeature<RsTableRowData>
33
+ if (idx >= 0) globalModules[idx] = next
34
+ else globalModules.push(next)
35
+ },
36
+
37
+ /** 按 id 注销全局模块 */
38
+ unregister(id: string): void {
39
+ const idx = globalModules.findIndex((item) => item.id === id)
40
+ if (idx >= 0) globalModules.splice(idx, 1)
41
+ },
42
+
43
+ /** 清空(测试用) */
44
+ clear(): void {
45
+ globalModules.length = 0
46
+ },
47
+
48
+ /** 当前全局模块快照(浅拷贝) */
49
+ getModules<T extends RsTableRowData = RsTableRowData>(): RsTableFeature<T>[] {
50
+ return [...globalModules] as RsTableFeature<T>[]
51
+ },
52
+
53
+ listIds(): string[] {
54
+ return globalModules.map((item) => item.id)
55
+ },
56
+ }
57
+
58
+ /**
59
+ * 合并全局模块 + 实例 features(实例同 id 覆盖全局)。
60
+ */
61
+ export function resolveInstanceFeatures<T extends RsTableRowData>(
62
+ instanceFeatures?: RsTableFeature<T>[] | null,
63
+ ): RsTableFeature<T>[] {
64
+ const map = new Map<string, RsTableFeature<T>>()
65
+ for (const feature of RsTableModuleRegistry.getModules<T>()) {
66
+ map.set(feature.id, feature)
67
+ }
68
+ for (const feature of instanceFeatures ?? []) {
69
+ map.set(feature.id, feature)
70
+ }
71
+ return [...map.values()]
72
+ }
@@ -0,0 +1,274 @@
1
+ /**
2
+ * RsTable 公开 props / emits / 默认值(从 SFC 抽出,削薄编排层)。
3
+ */
4
+
5
+ import type { RsContextMenuItem } from '../context-menu-utils'
6
+ import type {
7
+ RsTableColumn,
8
+ RsTableGroupBy,
9
+ RsTableRowData,
10
+ RsTableRowDropPosition,
11
+ RsTableRowKey,
12
+ RsTableSelectionType,
13
+ RsTableSize,
14
+ RsTableSortState,
15
+ RsTableTreeConfig,
16
+ } from '../table-utils'
17
+ import type { RsTableRowDragTrigger, RsTableRowDropMode } from '../table-drag'
18
+ import type { RsTableCellEditFocusMode } from './table-edit-utils'
19
+ import type { RsTableFeature } from './table-features'
20
+ import type { RsTableSummaryData, RsTableSummaryMode } from './table-summary-utils'
21
+
22
+ /** RsTable 组件 props */
23
+ export interface RsTableProps<T extends RsTableRowData = RsTableRowData> {
24
+ columns: RsTableColumn<T>[]
25
+ data: T[]
26
+ rowKey?: RsTableRowKey<T>
27
+ loading?: boolean
28
+ bordered?: boolean
29
+ columnBordered?: boolean
30
+ /** 外容器圆角;嵌套在已有圆角/直角父级时可设为 false */
31
+ rounded?: boolean
32
+ /** 填充父级高度:表格自身成为受限滚动容器 */
33
+ fill?: boolean
34
+ compact?: boolean
35
+ size?: RsTableSize
36
+ scrollX?: number | string
37
+ selectable?: boolean
38
+ selectionType?: RsTableSelectionType
39
+ selectedRowKeys?: string[]
40
+ defaultSelectedRowKeys?: string[]
41
+ rowSelectable?: (row: T, index: number) => boolean
42
+ expandable?: boolean
43
+ expandedRowKeys?: string[]
44
+ defaultExpandedRowKeys?: string[]
45
+ rowExpandable?: (row: T, index: number) => boolean
46
+ expandRowHeight?: number
47
+ /**
48
+ * 树形表格:按 children 展平可见行,在指定列缩进展开。
49
+ * 与 `expandable`(明细行)/ `groupBy` 互斥。
50
+ */
51
+ treeConfig?: RsTableTreeConfig<T>
52
+ striped?: boolean
53
+ showIndex?: boolean
54
+ /** 行号列宽度(px,showIndex 且未显示 edit gutter 时生效) */
55
+ indexWidth?: number
56
+ showHeader?: boolean
57
+ remoteSort?: boolean
58
+ filterText?: string
59
+ filterKeys?: string[]
60
+ columnFilters?: Record<string, string>
61
+ defaultColumnFilters?: Record<string, string>
62
+ groupBy?: RsTableGroupBy<T>
63
+ groupLabel?: (key: string) => string
64
+ sort?: RsTableSortState | null
65
+ defaultSort?: RsTableSortState | null
66
+ multiSort?: boolean
67
+ maxSort?: number
68
+ sorts?: RsTableSortState[]
69
+ defaultSorts?: RsTableSortState[]
70
+ columnDraggable?: boolean
71
+ columnOrder?: string[]
72
+ defaultColumnOrder?: string[]
73
+ rowDraggable?: boolean
74
+ rowDragTrigger?: RsTableRowDragTrigger
75
+ rowDropMode?: RsTableRowDropMode
76
+ rowDraggableWhen?: (row: T, index: number) => boolean
77
+ rowDropTargetWhen?: (row: T, index: number) => boolean
78
+ canRowDrop?: (dragKeys: string[], dropKey: string) => boolean
79
+ virtual?: boolean
80
+ /** fill 模式下数据行数达到该阈值时自动启用虚拟滚动;0 表示禁用自动启用 */
81
+ virtualAutoThreshold?: number
82
+ /**
83
+ * 列虚拟化:仅渲染横向可视区附近的数据列。
84
+ * true 强制开;false 强制关;默认 `'auto'` 由 virtualColumnsAutoThreshold 判定。
85
+ */
86
+ virtualColumns?: boolean | 'auto'
87
+ /** 数据列数达到该阈值时自动列虚拟化;0 表示禁用自动。默认 40 */
88
+ virtualColumnsAutoThreshold?: number
89
+ virtualColumnOverscan?: number
90
+ height?: number | string
91
+ rowHeight?: number
92
+ overscan?: number
93
+ infinite?: boolean
94
+ hasMore?: boolean
95
+ loadingMore?: boolean
96
+ infiniteDistance?: number
97
+ virtualOnInfinite?: boolean
98
+ resizable?: boolean
99
+ columnLayout?: 'auto' | 'fixed'
100
+ initialColumnWidths?: Record<string, number>
101
+ minColumnWidth?: number
102
+ maxColumnWidth?: number
103
+ selectOnContextmenu?: boolean
104
+ contextMenuItems?: (row: T | null, selectedRows: T[]) => RsContextMenuItem[]
105
+ contextMenu?: boolean
106
+ cellTooltip?: boolean
107
+ cellTooltipDelay?: number
108
+ headerTooltip?: boolean
109
+ editable?: boolean
110
+ editTrigger?: 'click' | 'dblclick'
111
+ editGutter?: boolean
112
+ editGutterWidth?: number
113
+ highlightRow?: boolean
114
+ highlightedRowKey?: string
115
+ defaultHighlightedRowKey?: string
116
+ highlightRowOnClick?: boolean
117
+ rowCommit?: boolean
118
+ rowPending?: (row: T, index: number) => boolean
119
+ showRowStatus?: boolean
120
+ allowNull?: boolean
121
+ nullLabel?: string
122
+ editFocusMode?: RsTableCellEditFocusMode
123
+ editKeyboard?: boolean
124
+ editUndo?: boolean
125
+ editUndoLimit?: number
126
+ editPaste?: boolean
127
+ editBatch?: boolean
128
+ summaryMode?: RsTableSummaryMode
129
+ summaryData?: RsTableSummaryData | null
130
+ showSummary?: boolean
131
+ features?: RsTableFeature<T>[]
132
+ viewKey?: string | number
133
+ layoutActive?: boolean
134
+ /** 无障碍名称;未传时回退 i18n `table.a11yLabel` */
135
+ ariaLabel?: string
136
+ }
137
+
138
+ /** RsTable 组件 emits(defineEmits 类型) */
139
+ export type RsTableEmits<T extends RsTableRowData = RsTableRowData> = {
140
+ rowClick: [row: T, index: number]
141
+ rowDblclick: [row: T, index: number]
142
+ cellView: [row: T, column: RsTableColumn<T>, index: number]
143
+ rowContextmenu: [row: T, index: number, event: MouseEvent]
144
+ contextMenuSelect: [key: string, row: T | null, selectedRows: T[]]
145
+ 'update:sort': [value: RsTableSortState | null]
146
+ 'update:sorts': [value: RsTableSortState[]]
147
+ sortsChange: [value: RsTableSortState[]]
148
+ 'update:columnOrder': [value: string[]]
149
+ columnOrderChange: [value: string[]]
150
+ 'update:columnFilters': [value: Record<string, string>]
151
+ columnFiltersChange: [value: Record<string, string>]
152
+ rowDrop: [dragKeys: string[], dropKey: string, position: RsTableRowDropPosition]
153
+ rowDragStart: [dragKeys: string[], event: DragEvent]
154
+ 'update:selectedRowKeys': [keys: string[]]
155
+ 'update:expandedRowKeys': [keys: string[]]
156
+ selectionChange: [keys: string[]]
157
+ expandChange: [keys: string[]]
158
+ loadMore: []
159
+ columnResize: [key: string, width: number]
160
+ 'update:highlightedRowKey': [key: string | undefined]
161
+ highlightChange: [key: string | undefined]
162
+ cellEditStart: [row: T, column: RsTableColumn<T>, index: number]
163
+ cellEditDialog: [row: T, column: RsTableColumn<T>, index: number, draft: string]
164
+ cellEditCommit: [
165
+ row: T,
166
+ column: RsTableColumn<T>,
167
+ index: number,
168
+ value: unknown,
169
+ previous: unknown,
170
+ ]
171
+ cellEditCancel: [row: T, column: RsTableColumn<T>, index: number]
172
+ cellEditInvalid: [
173
+ row: T,
174
+ column: RsTableColumn<T>,
175
+ index: number,
176
+ message: string,
177
+ value: unknown,
178
+ ]
179
+ cellEditBatchCommit: [
180
+ column: RsTableColumn<T>,
181
+ changes: Array<{ row: T; index: number; value: unknown; previous: unknown }>,
182
+ ]
183
+ cellEditUndo: [
184
+ entry: {
185
+ items: Array<{
186
+ rowKey: string
187
+ colKey: string
188
+ rowIndex: number
189
+ previous: unknown
190
+ next: unknown
191
+ }>
192
+ },
193
+ ]
194
+ cellEditRedo: [
195
+ entry: {
196
+ items: Array<{
197
+ rowKey: string
198
+ colKey: string
199
+ rowIndex: number
200
+ previous: unknown
201
+ next: unknown
202
+ }>
203
+ },
204
+ ]
205
+ cellEditReject: [row: T, index: number, reason?: string]
206
+ rowEditCommit: [
207
+ row: T,
208
+ index: number,
209
+ changes: Array<{ colKey: string; value: unknown; previous: unknown }>,
210
+ ]
211
+ rowEditRollback: [row: T, index: number]
212
+ }
213
+
214
+ /** withDefaults 第二参(工厂默认用函数) */
215
+ export const RS_TABLE_PROP_DEFAULTS = {
216
+ loading: false,
217
+ bordered: true,
218
+ columnBordered: false,
219
+ rounded: false,
220
+ fill: false,
221
+ compact: false,
222
+ size: 'md' as const,
223
+ selectable: false,
224
+ selectionType: 'checkbox' as const,
225
+ expandable: false,
226
+ defaultExpandedRowKeys: () => [] as string[],
227
+ striped: false,
228
+ showIndex: false,
229
+ indexWidth: 48,
230
+ showHeader: true,
231
+ remoteSort: false,
232
+ defaultSelectedRowKeys: () => [] as string[],
233
+ defaultSorts: () => [] as RsTableSortState[],
234
+ defaultColumnOrder: () => [] as string[],
235
+ multiSort: false,
236
+ maxSort: 3,
237
+ columnDraggable: false,
238
+ rowDraggable: false,
239
+ rowDragTrigger: 'handle' as const,
240
+ rowDropMode: 'reorder' as const,
241
+ overscan: 4,
242
+ virtualColumnOverscan: 2,
243
+ infiniteDistance: 80,
244
+ virtualOnInfinite: true,
245
+ virtualAutoThreshold: 50,
246
+ virtualColumns: 'auto' as const,
247
+ virtualColumnsAutoThreshold: 40,
248
+ resizable: false,
249
+ columnLayout: 'auto' as const,
250
+ minColumnWidth: 48,
251
+ maxColumnWidth: 640,
252
+ cellTooltip: true,
253
+ cellTooltipDelay: 300,
254
+ headerTooltip: true,
255
+ editable: false,
256
+ editTrigger: 'dblclick' as const,
257
+ editGutter: true,
258
+ editGutterWidth: 32,
259
+ highlightRow: false,
260
+ highlightRowOnClick: true,
261
+ rowCommit: false,
262
+ showRowStatus: true,
263
+ allowNull: true,
264
+ nullLabel: '(NULL)',
265
+ editFocusMode: 'end' as const,
266
+ editKeyboard: true,
267
+ editUndo: true,
268
+ editUndoLimit: 50,
269
+ editPaste: true,
270
+ editBatch: true,
271
+ contextMenu: true,
272
+ summaryMode: 'client' as const,
273
+ showSummary: false,
274
+ }