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,38 @@
1
+ /**
2
+ * 将 Vue emit 适配为 useRsTableEditActions 所需的 edit emit 袋。
3
+ */
4
+
5
+ import type { EmitFn } from 'vue'
6
+ import type { RsTableEmits } from '../components/table/rs-table-props'
7
+ import type { RsTableRowData } from '../components/table-utils'
8
+ import type { UseRsTableEditActionsOptions } from './useRsTableEditActions'
9
+
10
+ type EditEmitBag<T extends RsTableRowData> = UseRsTableEditActionsOptions<T>['emit']
11
+
12
+ /**
13
+ * 创建编辑 emit 桥(避免 RsTable 内联一长串箭头函数)。
14
+ *
15
+ * 入参用 Vue `EmitFn<RsTableEmits>`,与 `defineEmits` 产物对齐;
16
+ * 勿用手写 overload 接口承接(交叉重载在参数位逆变,会报 cellView ̸∈ update:columnOrder)。
17
+ */
18
+ export function createRsTableEditEmitBridge<T extends RsTableRowData>(
19
+ emit: EmitFn<RsTableEmits<T>>,
20
+ ): EditEmitBag<T> {
21
+ return {
22
+ cellView: (row, column, index) => emit('cellView', row, column, index),
23
+ cellEditStart: (row, column, index) => emit('cellEditStart', row, column, index),
24
+ cellEditDialog: (row, column, index, draft) =>
25
+ emit('cellEditDialog', row, column, index, draft),
26
+ cellEditCommit: (row, column, index, value, previous) =>
27
+ emit('cellEditCommit', row, column, index, value, previous),
28
+ cellEditCancel: (row, column, index) => emit('cellEditCancel', row, column, index),
29
+ cellEditInvalid: (row, column, index, message, value) =>
30
+ emit('cellEditInvalid', row, column, index, message, value),
31
+ cellEditBatchCommit: (column, changes) => emit('cellEditBatchCommit', column, changes),
32
+ cellEditUndo: (entry) => emit('cellEditUndo', entry),
33
+ cellEditRedo: (entry) => emit('cellEditRedo', entry),
34
+ cellEditReject: (row, index, reason) => emit('cellEditReject', row, index, reason),
35
+ rowEditCommit: (row, index, changes) => emit('rowEditCommit', row, index, changes),
36
+ rowEditRollback: (row, index) => emit('rowEditRollback', row, index),
37
+ }
38
+ }
@@ -1,4 +1,9 @@
1
1
  import { inject, provide, ref, type InjectionKey, type Ref } from 'vue'
2
+ import {
3
+ interpolateRsMessage,
4
+ resolveRsTranslateArgs,
5
+ type RsTranslateFn,
6
+ } from '../locale/interpolate'
2
7
  import { localeMap } from '../locale/messages'
3
8
  import { defaultLocale, type RsLocale } from '../locale/types'
4
9
  import type { RsComponentSize, RsRadius, RsThemeMode } from '../theme/types'
@@ -17,7 +22,7 @@ export interface RsConfigContext {
17
22
  setLocale: (locale: RsLocale) => void
18
23
  setControlSize: (size: RsComponentSize) => void
19
24
  setControlRadius: (radius: RsRadius | undefined) => void
20
- t: (key: string, fallback?: string) => string
25
+ t: RsTranslateFn
21
26
  }
22
27
 
23
28
  export const rsConfigKey: InjectionKey<RsConfigContext> = Symbol('rs-config')
@@ -65,8 +70,10 @@ export function createRsConfigState(
65
70
  controlRadius.value = radius
66
71
  }
67
72
 
68
- function t(key: string, fallback?: string) {
69
- return localeMap[locale.value][key] ?? fallback ?? key
73
+ const t: RsTranslateFn = (key, fallbackOrVars, vars) => {
74
+ const parsed = resolveRsTranslateArgs(fallbackOrVars, vars)
75
+ const raw = localeMap[locale.value][key] ?? parsed.fallback ?? key
76
+ return interpolateRsMessage(raw, parsed.vars)
70
77
  }
71
78
 
72
79
  if (typeof document !== 'undefined') {
@@ -1,22 +1,33 @@
1
1
  import { computed, inject } from 'vue'
2
+ import { interpolateRsMessage, resolveRsTranslateArgs, type RsI18nVars, type RsTranslateFn } from '../locale/interpolate'
2
3
  import { localeMap } from '../locale/messages'
3
4
  import { defaultLocale, type RsLocale } from '../locale/types'
4
5
  import { rsConfigKey } from './useRsConfig'
5
6
 
6
- export type RsTranslateFn = (key: string, fallback?: string) => string
7
+ export type { RsI18nVars, RsTranslateFn }
8
+
9
+ function translate(
10
+ locale: RsLocale,
11
+ key: string,
12
+ fallbackOrVars?: string | RsI18nVars,
13
+ vars?: RsI18nVars,
14
+ ): string {
15
+ const parsed = resolveRsTranslateArgs(fallbackOrVars, vars)
16
+ const raw = localeMap[locale][key] ?? parsed.fallback ?? key
17
+ return interpolateRsMessage(raw, parsed.vars)
18
+ }
7
19
 
8
20
  /** 组件内安全取文案:Provider 内跟随 locale,否则回退 defaultLocale */
9
21
  export function useRsI18n() {
10
22
  const ctx = inject(rsConfigKey, null)
11
23
  const locale = computed<RsLocale>(() => ctx?.locale.value ?? defaultLocale)
12
24
 
13
- function t(key: string, fallback?: string): string {
14
- return localeMap[locale.value][key] ?? fallback ?? key
15
- }
25
+ const t: RsTranslateFn = (key, fallbackOrVars, vars) =>
26
+ translate(locale.value, key, fallbackOrVars, vars)
16
27
 
17
28
  return { t, locale }
18
29
  }
19
30
 
20
31
  export function createTranslator(locale: RsLocale): RsTranslateFn {
21
- return (key, fallback) => localeMap[locale][key] ?? fallback ?? key
32
+ return (key, fallbackOrVars, vars) => translate(locale, key, fallbackOrVars, vars)
22
33
  }
@@ -0,0 +1,36 @@
1
+ import { inject, type InjectionKey, type ShallowRef } from 'vue'
2
+
3
+ export type RsLoadingBarApi = {
4
+ start: () => void
5
+ finish: () => void
6
+ error: () => void
7
+ }
8
+
9
+ export const RS_LOADING_BAR_KEY: InjectionKey<ShallowRef<RsLoadingBarApi | null>> =
10
+ Symbol('rs-loading-bar')
11
+
12
+ /**
13
+ * useRsLoadingBar 读取最近的 RsLoadingBar 实例 API。
14
+ * 调用方须位于 RsLoadingBar 默认插槽的后代树中;
15
+ * 未挂载或未包裹时返回空操作实现,避免调用方崩溃。
16
+ */
17
+ export function useRsLoadingBar(): RsLoadingBarApi {
18
+ const injected = inject(RS_LOADING_BAR_KEY, null)
19
+ const noop: RsLoadingBarApi = {
20
+ start() {},
21
+ finish() {},
22
+ error() {},
23
+ }
24
+ if (!injected) return noop
25
+ return {
26
+ start() {
27
+ injected.value?.start()
28
+ },
29
+ finish() {
30
+ injected.value?.finish()
31
+ },
32
+ error() {
33
+ injected.value?.error()
34
+ },
35
+ }
36
+ }
@@ -0,0 +1,134 @@
1
+ /**
2
+ * RsTable 公开面编排(对标 AG Grid api / TanStack table instance)。
3
+ *
4
+ * 职责:
5
+ * - FeatureHost:全局模块 + 实例 features 生命周期与贡献袋
6
+ * - RsTableApi:统一 create / provide,避免 expose 与 inject 漂移
7
+ *
8
+ * 内核装配(Columns / Engine / Virtual)见 useRsTableCore;本文件保持公开面轻量。
9
+ */
10
+
11
+ import { inject, provide, type InjectionKey } from 'vue'
12
+ import type { RsContextMenuItem } from '../components/context-menu-utils'
13
+ import type { RsTableRowData } from '../components/table-utils'
14
+ import {
15
+ createRsTableApi,
16
+ RS_TABLE_API_KEY,
17
+ type RsTableApi,
18
+ } from '../components/table/rs-table-api'
19
+ import {
20
+ createRsTableFeatureHost,
21
+ type RsTableFeatureHost,
22
+ type RsTableOverlayContribution,
23
+ type RsTableToolbarItem,
24
+ } from '../components/table/rs-table-feature-host'
25
+ import { resolveInstanceFeatures } from '../components/table/rs-table-module-registry'
26
+ import {
27
+ createBuiltinTableFeatures,
28
+ type RsTableBuiltinFeatureId,
29
+ type RsTableFeature,
30
+ } from '../components/table/table-features'
31
+ import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource'
32
+
33
+ export type { RsTableApi }
34
+ export { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, isRsTableApi } from '../components/table/rs-table-api'
35
+ export { RsTableModuleRegistry, resolveInstanceFeatures } from '../components/table/rs-table-module-registry'
36
+
37
+ /**
38
+ * useRsTable 返回的公开面:Feature 宿主 + API 工厂。
39
+ */
40
+ export interface UseRsTableSurface<T extends RsTableRowData = RsTableRowData> {
41
+ featureHost: RsTableFeatureHost<T>
42
+ /**
43
+ * 绑定内置 id + 实例/全局 features;返回 dispose。
44
+ * 应在 watch(immediate) 中调用,替换旧 dispose。
45
+ */
46
+ bindFeatures: (options: {
47
+ builtinIds: RsTableBuiltinFeatureId[]
48
+ instanceFeatures?: RsTableFeature<T>[] | null
49
+ getViewRows: () => T[]
50
+ getSelectedRows: () => T[]
51
+ getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
52
+ subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
53
+ }) => () => void
54
+ /** 合并 props 自定义菜单与 feature 贡献 */
55
+ mergeContextMenuItems: (
56
+ baseItems: RsContextMenuItem[],
57
+ menuCtx: { row: T | null; selectedRows: T[] },
58
+ ) => RsContextMenuItem[]
59
+ /** 由内部实现装配冻结 API,并可选 provide */
60
+ createApi: (
61
+ impl: Omit<RsTableApi<T>, 'apiVersion' | 'getActiveFeatureIds'> & {
62
+ getActiveFeatureIds?: () => string[]
63
+ },
64
+ options?: { provide?: boolean },
65
+ ) => RsTableApi<T>
66
+ getActiveFeatureIds: () => string[]
67
+ /** 实例级 toolbar 贡献(多表互不共享) */
68
+ getToolbarItems: () => RsTableToolbarItem[]
69
+ /** 实例级 overlay 贡献 */
70
+ getOverlayContributions: () => RsTableOverlayContribution[]
71
+ }
72
+
73
+ /**
74
+ * 创建表格公开面(每个 RsTable 实例调用一次)。
75
+ */
76
+ export function useRsTable<T extends RsTableRowData = RsTableRowData>(): UseRsTableSurface<T> {
77
+ const featureHost = createRsTableFeatureHost<T>()
78
+
79
+ function bindFeatures(options: {
80
+ builtinIds: RsTableBuiltinFeatureId[]
81
+ instanceFeatures?: RsTableFeature<T>[] | null
82
+ getViewRows: () => T[]
83
+ getSelectedRows: () => T[]
84
+ getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
85
+ subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
86
+ }): () => void {
87
+ // 合并顺序:全局模块 → 内置 → 实例 features(同 id 后者覆盖)
88
+ const features = resolveInstanceFeatures<T>([
89
+ ...createBuiltinTableFeatures<T>(options.builtinIds),
90
+ ...(options.instanceFeatures ?? []),
91
+ ])
92
+ const ctx = featureHost.createContext({
93
+ getViewRows: options.getViewRows,
94
+ getSelectedRows: options.getSelectedRows,
95
+ getAnalyticsSnapshot: options.getAnalyticsSnapshot,
96
+ subscribeAnalytics: options.subscribeAnalytics,
97
+ })
98
+ return featureHost.setup(features, ctx)
99
+ }
100
+
101
+ function createApi(
102
+ impl: Omit<RsTableApi<T>, 'apiVersion' | 'getActiveFeatureIds'> & {
103
+ getActiveFeatureIds?: () => string[]
104
+ },
105
+ options?: { provide?: boolean },
106
+ ): RsTableApi<T> {
107
+ const api = createRsTableApi<T>({
108
+ ...impl,
109
+ getActiveFeatureIds: impl.getActiveFeatureIds ?? (() => featureHost.getActiveFeatureIds()),
110
+ })
111
+ if (options?.provide !== false) {
112
+ provide(RS_TABLE_API_KEY as InjectionKey<RsTableApi<T>>, api)
113
+ }
114
+ return api
115
+ }
116
+
117
+ return {
118
+ featureHost,
119
+ bindFeatures,
120
+ mergeContextMenuItems: (base, menuCtx) => featureHost.mergeContextMenuItems(base, menuCtx),
121
+ createApi,
122
+ getActiveFeatureIds: () => featureHost.getActiveFeatureIds(),
123
+ getToolbarItems: () => featureHost.getToolbarItems(),
124
+ getOverlayContributions: () => featureHost.getOverlayContributions(),
125
+ }
126
+ }
127
+
128
+ /**
129
+ * 子树内注入表格 API(插槽/子组件用)。
130
+ * 未 provide 时返回 undefined。
131
+ */
132
+ export function useRsTableApi<T extends RsTableRowData = RsTableRowData>(): RsTableApi<T> | undefined {
133
+ return inject(RS_TABLE_API_KEY as InjectionKey<RsTableApi<T>>, undefined)
134
+ }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * RsTable 无障碍基线:region / grid 语义与 loading busy。
3
+ *
4
+ * 与 useRsTableGridKeyboard + 单元格 role=gridcell 配合,形成可漫游网格。
5
+ * tabindex 放在 role=grid 的 table 上(复合控件可聚焦),勿放在 region 壳层。
6
+ */
7
+
8
+ import { computed, type ComputedRef, type Ref } from 'vue'
9
+
10
+ export interface UseRsTableA11yOptions {
11
+ /** 显式无障碍名称;空则回退 defaultLabel */
12
+ ariaLabel: () => string | undefined
13
+ defaultLabel: () => string
14
+ loading: () => boolean
15
+ /** 业务行数(view / dataRows) */
16
+ rowCount: Ref<number> | ComputedRef<number> | (() => number)
17
+ /** 可见数据列数 */
18
+ colCount: Ref<number> | ComputedRef<number> | (() => number)
19
+ }
20
+
21
+ function read(source: Ref<number> | ComputedRef<number> | (() => number)): number {
22
+ return typeof source === 'function' ? source() : source.value
23
+ }
24
+
25
+ /**
26
+ * 壳层 / table 元素无障碍属性。
27
+ */
28
+ export function useRsTableA11y(options: UseRsTableA11yOptions) {
29
+ const resolvedLabel = computed(
30
+ () => options.ariaLabel()?.trim() || options.defaultLabel(),
31
+ )
32
+
33
+ const shellA11y = computed(() => ({
34
+ role: 'region' as const,
35
+ 'aria-label': resolvedLabel.value,
36
+ 'aria-busy': options.loading() ? true : undefined,
37
+ }))
38
+
39
+ const tableA11y = computed(() => ({
40
+ role: 'grid' as const,
41
+ tabindex: 0,
42
+ 'aria-rowcount': Math.max(0, read(options.rowCount)),
43
+ 'aria-colcount': Math.max(0, read(options.colCount)),
44
+ 'aria-label': resolvedLabel.value,
45
+ }))
46
+
47
+ return {
48
+ resolvedLabel,
49
+ shellA11y,
50
+ tableA11y,
51
+ }
52
+ }
@@ -0,0 +1,79 @@
1
+ /**
2
+ * 表格图表桥:订阅 SelectionSource,产出库无关 chart series。
3
+ *
4
+ * 业务页可:
5
+ * - 把 series 丢给 ECharts option 组装
6
+ * - 或在图表点击时用 point.key 反查行做联动筛选
7
+ *
8
+ * 性能:series 随 sourceRows 浅引用变化重算;defs 建议业务侧稳定引用。
9
+ */
10
+
11
+ import { computed, type ComputedRef, type Ref } from 'vue'
12
+ import type { RsTableRowData } from '../components/table-utils'
13
+ import {
14
+ buildTableChartSeriesList,
15
+ type RsTableChartSeries,
16
+ type RsTableChartSeriesDef,
17
+ } from '../components/table/table-chart-utils'
18
+ import {
19
+ useRsTableSelectionSource,
20
+ type RsTableAnalyticsSnapshot,
21
+ } from './useRsTableSelectionSource'
22
+
23
+ export interface UseRsTableChartBridgeOptions<T extends RsTableRowData> {
24
+ viewRows: Ref<T[]> | ComputedRef<T[]>
25
+ selectedRows?: Ref<T[]> | ComputedRef<T[]>
26
+ /** 系列定义列表;变化会触发重算 */
27
+ seriesDefs: Ref<RsTableChartSeriesDef[]> | ComputedRef<RsTableChartSeriesDef[]> | RsTableChartSeriesDef[]
28
+ }
29
+
30
+ function readDefs(
31
+ defs:
32
+ | Ref<RsTableChartSeriesDef[]>
33
+ | ComputedRef<RsTableChartSeriesDef[]>
34
+ | RsTableChartSeriesDef[],
35
+ ): RsTableChartSeriesDef[] {
36
+ if (Array.isArray(defs)) return defs
37
+ return defs.value ?? []
38
+ }
39
+
40
+ /**
41
+ * 选中联动图表桥。
42
+ *
43
+ * @returns selection 源 + series 列表 + getSnapshot
44
+ */
45
+ export function useRsTableChartBridge<T extends RsTableRowData>(
46
+ options: UseRsTableChartBridgeOptions<T>,
47
+ ) {
48
+ const selection = useRsTableSelectionSource<T>({
49
+ viewRows: options.viewRows,
50
+ selectedRows: options.selectedRows,
51
+ })
52
+
53
+ const series = computed<RsTableChartSeries[]>(() =>
54
+ buildTableChartSeriesList(selection.sourceRows.value, readDefs(options.seriesDefs)),
55
+ )
56
+
57
+ /** 按 id 取单系列,便于模板绑定 */
58
+ function getSeriesById(id: string): RsTableChartSeries | undefined {
59
+ return series.value.find((item) => item.id === id)
60
+ }
61
+
62
+ function getSnapshot(): RsTableAnalyticsSnapshot<T> & { series: RsTableChartSeries[] } {
63
+ return {
64
+ ...selection.getSnapshot(),
65
+ series: series.value,
66
+ }
67
+ }
68
+
69
+ return {
70
+ ...selection,
71
+ series,
72
+ getSeriesById,
73
+ getSnapshot,
74
+ }
75
+ }
76
+
77
+ export type RsTableChartBridgeApi<T extends RsTableRowData> = ReturnType<
78
+ typeof useRsTableChartBridge<T>
79
+ >