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
@@ -25,6 +25,191 @@ export interface RsDateRangeValue {
25
25
  end?: string
26
26
  }
27
27
 
28
+ /** valueFormat 预设:string 墙钟、timestamp 毫秒、iso 本地偏移 RFC3339 */
29
+ export const RS_DATE_PICKER_VALUE_FORMAT_PRESETS = ['string', 'timestamp', 'iso'] as const
30
+
31
+ /**
32
+ * valueFormat 预设名。
33
+ * string 为默认墙钟字符串;timestamp 为毫秒;iso 为带本地偏移的 RFC3339。
34
+ */
35
+ export type RsDatePickerValueFormatPreset = (typeof RS_DATE_PICKER_VALUE_FORMAT_PRESETS)[number]
36
+
37
+ /**
38
+ * v-model 取值格式,对齐 Element Plus `value-format` / Ant Design Vue `valueFormat`:
39
+ * 展示格式与绑定格式分离。预设之外可传入任意 dayjs 模板,如 `YYYY-MM-DDTHH:mm:ssZ`。
40
+ */
41
+ export type RsDatePickerValueFormat = RsDatePickerValueFormatPreset | (string & {})
42
+
43
+ /**
44
+ * 内部墙钟字符串与对外 valueFormat 互转时的选项。
45
+ */
46
+ export interface RsDatePickerValueConvertOptions {
47
+ valueFormat: string
48
+ withTime: boolean
49
+ }
50
+
51
+ /** 时间戳范围(毫秒),用于 valueFormat=timestamp 的 range 模式 */
52
+ export type RsDatePickerTimestampRange = [number, number]
53
+
54
+ /** 组件对外 v-model 联合类型 */
55
+ export type RsDatePickerModelValue =
56
+ | string
57
+ | number
58
+ | null
59
+ | RsDateRangeValue
60
+ | RsDatePickerTimestampRange
61
+
62
+ /** 快捷项可返回字符串、时间戳或范围 */
63
+ export type RsDatePickerShortcutValue =
64
+ | string
65
+ | number
66
+ | RsDateRangeValue
67
+ | RsDatePickerTimestampRange
68
+
69
+ /** 日期/时间范围面板快捷项 */
70
+ export interface RsDatePickerShortcut {
71
+ label: string
72
+ value: () => RsDatePickerShortcutValue
73
+ }
74
+
75
+ /** 将毫秒时间戳格式化为组件内部日期时间字符串 */
76
+ export function formatTimestampValue(ms: number, withTime = true): string {
77
+ const parsed = dayjs(ms)
78
+ return withTime ? parsed.format(RS_DATETIME_FORMAT) : parsed.format(RS_DATE_FORMAT)
79
+ }
80
+
81
+ /** 将组件内部日期/日期时间字符串解析为毫秒时间戳 */
82
+ export function parseTimestampValue(value?: string): number | null {
83
+ if (!value) return null
84
+ const parsed = parseRsDateTimeDayjs(value) ?? parseRsDayjs(value)
85
+ return parsed ? parsed.valueOf() : null
86
+ }
87
+
88
+ function parsePickerDayjs(value: string) {
89
+ return parseRsDateTimeDayjs(value) ?? parseRsDayjs(value)
90
+ }
91
+
92
+ function isTimestampFormat(valueFormat: string): boolean {
93
+ return valueFormat === 'timestamp'
94
+ }
95
+
96
+ function isIsoFormat(valueFormat: string): boolean {
97
+ return valueFormat === 'iso'
98
+ }
99
+
100
+ function isStringFormat(valueFormat: string): boolean {
101
+ return valueFormat === 'string' || valueFormat === ''
102
+ }
103
+
104
+ /**
105
+ * 将对外 v-model 规范为控件内部墙钟字符串(`YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`)。
106
+ * 解析 ISO 时去掉 Z/偏移,按墙钟分量展示,不按浏览器时区换算。
107
+ * @param value - 对外绑定值(字符串、毫秒时间戳或空)
108
+ * @param options - valueFormat 与是否含时分秒
109
+ * @returns 内部墙钟字符串;无法解析时尽量原样返回
110
+ */
111
+ export function toInternalPickerValue(
112
+ value: unknown,
113
+ options: RsDatePickerValueConvertOptions,
114
+ ): string {
115
+ if (value == null || value === '') return ''
116
+ if (typeof value === 'number') {
117
+ return formatTimestampValue(value, options.withTime)
118
+ }
119
+ if (typeof value !== 'string') return ''
120
+
121
+ const format = options.valueFormat || 'string'
122
+ if (!isStringFormat(format) && !isTimestampFormat(format) && !isIsoFormat(format)) {
123
+ const strict = dayjs(value, format, true)
124
+ if (strict.isValid()) {
125
+ return options.withTime ? strict.format(RS_DATETIME_FORMAT) : strict.format(RS_DATE_FORMAT)
126
+ }
127
+ }
128
+
129
+ const parsed = parsePickerDayjs(value)
130
+ if (!parsed) return value
131
+ return options.withTime ? parsed.format(RS_DATETIME_FORMAT) : parsed.format(RS_DATE_FORMAT)
132
+ }
133
+
134
+ /**
135
+ * 将控件内部墙钟字符串转为对外 valueFormat。
136
+ * iso 空值返回 null,避免 JSON `""` 无法绑定到 Go `time.Time`。
137
+ * @param internal - 内部墙钟字符串
138
+ * @param options - valueFormat 与是否含时分秒
139
+ * @returns 字符串、毫秒时间戳或 null
140
+ */
141
+ export function fromInternalPickerValue(
142
+ internal: string,
143
+ options: RsDatePickerValueConvertOptions,
144
+ ): string | number | null {
145
+ const format = options.valueFormat || 'string'
146
+ if (!internal) {
147
+ return isTimestampFormat(format) || isIsoFormat(format) ? null : ''
148
+ }
149
+ if (isTimestampFormat(format)) {
150
+ return parseTimestampValue(internal)
151
+ }
152
+ if (isStringFormat(format)) {
153
+ return internal
154
+ }
155
+
156
+ const parsed = parsePickerDayjs(internal)
157
+ if (!parsed) return internal
158
+
159
+ if (isIsoFormat(format)) {
160
+ const body = options.withTime
161
+ ? parsed.format('YYYY-MM-DDTHH:mm:ss')
162
+ : parsed.format('YYYY-MM-DDT00:00:00')
163
+ return `${body}${parsed.format('Z')}`
164
+ }
165
+
166
+ return parsed.format(format)
167
+ }
168
+
169
+ /**
170
+ * 将 fromInternalPickerValue 的结果写入 range.start/end(范围端点始终为字符串)。
171
+ * @param value - 转换后的端点
172
+ * @returns 范围对象可用的字符串;空为 `''`
173
+ */
174
+ export function toRangeEndpointString(value: string | number | null): string {
175
+ if (value == null) return ''
176
+ return typeof value === 'number' ? String(value) : value
177
+ }
178
+
179
+ /** 判断是否为时间戳范围元组 */
180
+ export function isTimestampRange(value: unknown): value is RsDatePickerTimestampRange {
181
+ return (
182
+ Array.isArray(value)
183
+ && value.length === 2
184
+ && typeof value[0] === 'number'
185
+ && typeof value[1] === 'number'
186
+ )
187
+ }
188
+
189
+ /** 将快捷项返回值规范为内部 string / RsDateRangeValue */
190
+ export function normalizeShortcutValue(
191
+ next: RsDatePickerShortcutValue,
192
+ options?: { withTime?: boolean },
193
+ ): string | RsDateRangeValue | null {
194
+ const withTime = options?.withTime ?? true
195
+ if (typeof next === 'number') {
196
+ return formatTimestampValue(next, withTime)
197
+ }
198
+ if (isTimestampRange(next)) {
199
+ return {
200
+ start: formatTimestampValue(next[0], withTime),
201
+ end: formatTimestampValue(next[1], withTime),
202
+ }
203
+ }
204
+ if (typeof next === 'string') {
205
+ return next || null
206
+ }
207
+ if (next && typeof next === 'object') {
208
+ return { ...next }
209
+ }
210
+ return null
211
+ }
212
+
28
213
  export interface RsCalendarCell extends RsParsedDate {
29
214
  inCurrentMonth: boolean
30
215
  }
@@ -78,10 +263,16 @@ export function formatDateTimeParts(
78
263
  withSeconds = true,
79
264
  ): string | null {
80
265
  const dateText = formatDateParts(date)
81
- const timeFormat = withSeconds ? RS_TIME_SECONDS_FORMAT : RS_TIME_MINUTE_FORMAT
82
- const parsed = dayjs(`${dateText} ${time}`, `${RS_DATE_FORMAT} ${timeFormat}`, true)
83
- if (!parsed.isValid()) return null
84
- return parsed.format(RS_DATETIME_FORMAT)
266
+ const formats = withSeconds
267
+ ? [`${RS_DATE_FORMAT} ${RS_TIME_SECONDS_FORMAT}`, `${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`]
268
+ : [`${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`]
269
+ for (const format of formats) {
270
+ const parsed = dayjs(`${dateText} ${time}`, format, true)
271
+ if (parsed.isValid()) {
272
+ return parsed.format(withSeconds ? RS_DATETIME_FORMAT : `${RS_DATE_FORMAT} ${RS_TIME_MINUTE_FORMAT}`)
273
+ }
274
+ }
275
+ return null
85
276
  }
86
277
 
87
278
  export function extractTimeFromDateTime(value?: string, withSeconds = true): string {
@@ -0,0 +1,24 @@
1
+ import type { InjectionKey } from 'vue'
2
+ import type { RsComponentSize } from '../theme/types'
3
+
4
+ /** Descriptions 尺寸与全局控件尺寸对齐:ssm / sm / md / lg */
5
+ export type RsDescriptionsSize = RsComponentSize
6
+
7
+ export type RsDescriptionsLabelPlacement = 'left' | 'top'
8
+
9
+ export type RsDescriptionsItem = {
10
+ label: string
11
+ value?: string | number | null
12
+ span?: number
13
+ key?: string | number
14
+ }
15
+
16
+ export type RsDescriptionsContext = {
17
+ labelPlacement: RsDescriptionsLabelPlacement
18
+ bordered: boolean
19
+ size: RsDescriptionsSize
20
+ columns: number
21
+ }
22
+
23
+ export const RS_DESCRIPTIONS_KEY: InjectionKey<RsDescriptionsContext> =
24
+ Symbol('rs-descriptions')
@@ -0,0 +1,182 @@
1
+ import type { Component } from 'vue'
2
+ import type { RsLocale } from '../locale/types'
3
+ import type { RsThemeMode } from '../theme/types'
4
+ import { dialogViewportSize } from './dialog-viewport'
5
+ import type { RsFeedbackTone } from './overlay-utils'
6
+
7
+ /** 宽度预设(与历史 sm/md/lg 一致) */
8
+ export type RsDialogWidthPreset = 'sm' | 'md' | 'lg'
9
+
10
+ /**
11
+ * 对话框宽度:预设或自定义(number 按 px;string 为 CSS 长度,如 `40rem` / `60%`)。
12
+ * window 布局会在打开时把 px / rem / % 折成像素再居中(% 相对视口扣除 inset);
13
+ * confirm 布局仍把自定义宽度当作 CSS 写入。
14
+ */
15
+ export type RsDialogWidth = RsDialogWidthPreset | number | string
16
+
17
+ export type RsDialogLayout = 'window' | 'confirm'
18
+
19
+ /** 关闭来源,供 beforeClose / afterClose 区分 */
20
+ export type RsDialogCloseReason =
21
+ | 'close'
22
+ | 'overlay'
23
+ | 'escape'
24
+ | 'cancel'
25
+ | 'confirm'
26
+ | 'programmatic'
27
+
28
+ /**
29
+ * 关闭前钩子:返回 false 阻止关闭;支持异步。
30
+ * 未提供或返回 void/true 时允许关闭。
31
+ */
32
+ export type RsDialogBeforeClose = (
33
+ reason: RsDialogCloseReason,
34
+ ) => boolean | void | Promise<boolean | void>
35
+
36
+ export function isRsDialogWidthPreset(width: RsDialogWidth): width is RsDialogWidthPreset {
37
+ return width === 'sm' || width === 'md' || width === 'lg'
38
+ }
39
+
40
+ /** 将自定义宽度规范为 CSS 长度 */
41
+ export function resolveRsDialogCssWidth(width: RsDialogWidth): string | undefined {
42
+ if (isRsDialogWidthPreset(width)) return undefined
43
+ if (typeof width === 'number') {
44
+ if (!Number.isFinite(width) || width <= 0) return undefined
45
+ return `${width}px`
46
+ }
47
+ const trimmed = String(width).trim()
48
+ return trimmed || undefined
49
+ }
50
+
51
+ function rootFontSizePx(): number {
52
+ if (typeof document === 'undefined') return 16
53
+ return Number.parseFloat(getComputedStyle(document.documentElement).fontSize) || 16
54
+ }
55
+
56
+ /**
57
+ * 将自定义宽度折成 px,供 window 布局计算 bounds / 居中。
58
+ * 支持 number、`px`、`rem`、`%`(相对视口可用宽度);预设与无法解析的单位返回 undefined。
59
+ */
60
+ export function resolveRsDialogWidthPx(
61
+ width: RsDialogWidth,
62
+ viewportWidth = dialogViewportSize().width,
63
+ ): number | undefined {
64
+ if (isRsDialogWidthPreset(width)) return undefined
65
+ if (typeof width === 'number') {
66
+ if (!Number.isFinite(width) || width <= 0) return undefined
67
+ return Math.round(width)
68
+ }
69
+ const trimmed = String(width).trim()
70
+ if (!trimmed) return undefined
71
+ if (/^\d+(\.\d+)?px$/i.test(trimmed)) {
72
+ return Math.round(Number.parseFloat(trimmed))
73
+ }
74
+ if (/^\d+(\.\d+)?rem$/i.test(trimmed)) {
75
+ return Math.round(Number.parseFloat(trimmed) * rootFontSizePx())
76
+ }
77
+ if (/^\d+(\.\d+)?%$/.test(trimmed)) {
78
+ if (!Number.isFinite(viewportWidth) || viewportWidth <= 0) return undefined
79
+ return Math.round((Number.parseFloat(trimmed) / 100) * viewportWidth)
80
+ }
81
+ return undefined
82
+ }
83
+
84
+ export async function runRsDialogBeforeClose(
85
+ beforeClose: RsDialogBeforeClose | undefined,
86
+ reason: RsDialogCloseReason,
87
+ ): Promise<boolean> {
88
+ if (!beforeClose) return true
89
+ const result = await beforeClose(reason)
90
+ return result !== false
91
+ }
92
+
93
+ /** 确认框关闭来源,供 beforeClose 区分 */
94
+ export type RsConfirmCloseReason = 'confirm' | 'cancel' | 'escape' | 'programmatic'
95
+
96
+ /**
97
+ * 确认框关闭前钩子:返回 false 阻止关闭;支持异步。
98
+ * 未提供或返回 void/true 时允许关闭。
99
+ */
100
+ export type RsConfirmBeforeClose = (
101
+ reason: RsConfirmCloseReason,
102
+ ) => boolean | void | Promise<boolean | void>
103
+
104
+ export interface RsConfirmOptions {
105
+ title?: string
106
+ /** 次要说明(标题与正文之间,对应业务侧常见 subtitle) */
107
+ subtitle?: string
108
+ description?: string
109
+ tone?: RsFeedbackTone
110
+ /** 自定义图标组件;不传则使用默认 "!" */
111
+ icon?: Component
112
+ /** 宽度:预设 sm/md/lg,或 number(px) / CSS 长度;默认保持 28rem */
113
+ width?: RsDialogWidth
114
+ confirmText?: string
115
+ cancelText?: string
116
+ confirmVariant?: 'primary' | 'danger'
117
+ /** 是否显示取消按钮;false 时为单按钮提示(info/success/error) */
118
+ showCancel?: boolean
119
+ /** 受控加载态;若同时提供 onConfirm,命令式 API 会在执行期间自动置 true */
120
+ confirmLoading?: boolean
121
+ /**
122
+ * 确认回调。返回 Promise 时对话框保持打开并进入 loading,
123
+ * resolve 后关闭并 resolve(true);reject 则取消 loading 并保持打开。
124
+ */
125
+ onConfirm?: () => void | Promise<void>
126
+ /** 取消/关闭时回调(不区分来源) */
127
+ onCancel?: () => void
128
+ /** 关闭前钩子;返回 false 可阻止关闭 */
129
+ beforeClose?: RsConfirmBeforeClose
130
+ /**
131
+ * 正文与按钮之间的额外内容(渲染函数)。
132
+ * 声明式请用 RsConfirmDialog 的 #extra 插槽。
133
+ */
134
+ extra?: () => unknown
135
+ showOverlay?: boolean
136
+ /**
137
+ * 遮罩不透明度 0–1;覆盖 CSS 变量 --rs-dialog-overlay-bg。
138
+ * 未传时使用主题默认(最浅)。
139
+ */
140
+ overlayOpacity?: number
141
+ /**
142
+ * 遮罩模糊半径;number 按 px。覆盖 --rs-dialog-overlay-blur。
143
+ * 未传时使用主题默认(0)。
144
+ */
145
+ overlayBlur?: number | string
146
+ /** false 表示禁用 Teleport,就地渲染 */
147
+ teleportTo?: string | HTMLElement | false
148
+ /** 命令式挂载时覆盖主题;默认读 document data-rs-theme */
149
+ theme?: RsThemeMode
150
+ /** 命令式挂载时覆盖语言;默认读 document data-rs-locale */
151
+ locale?: RsLocale
152
+ }
153
+
154
+ /** 运行确认框 beforeClose;未提供或非 false 视为允许关闭 */
155
+ export async function runRsConfirmBeforeClose(
156
+ beforeClose: RsConfirmBeforeClose | undefined,
157
+ reason: RsConfirmCloseReason,
158
+ ): Promise<boolean> {
159
+ if (!beforeClose) return true
160
+ const result = await beforeClose(reason)
161
+ return result !== false
162
+ }
163
+
164
+ /**
165
+ * 将 overlayOpacity / overlayBlur 转为遮罩 CSS 变量(可挂到 overlay 节点 style)。
166
+ */
167
+ export function resolveDialogOverlayStyle(options?: {
168
+ overlayOpacity?: number
169
+ overlayBlur?: number | string
170
+ }): Record<string, string> | undefined {
171
+ if (!options) return undefined
172
+ const style: Record<string, string> = {}
173
+ if (options.overlayOpacity != null && Number.isFinite(options.overlayOpacity)) {
174
+ const opacity = Math.min(1, Math.max(0, options.overlayOpacity))
175
+ style['--rs-dialog-overlay-bg'] = `rgb(0 0 0 / ${opacity})`
176
+ }
177
+ if (options.overlayBlur != null && options.overlayBlur !== '') {
178
+ style['--rs-dialog-overlay-blur'] =
179
+ typeof options.overlayBlur === 'number' ? `${options.overlayBlur}px` : String(options.overlayBlur)
180
+ }
181
+ return Object.keys(style).length ? style : undefined
182
+ }
@@ -1,7 +1,9 @@
1
1
  import { computed, onBeforeUnmount, ref, watch, type Ref } from 'vue'
2
+ import type { RsDialogWidthPreset } from './dialog-utils'
2
3
  import { dialogViewportSize, readDialogViewportInsets } from './dialog-viewport'
3
4
 
4
- export type RsDialogWidth = 'sm' | 'md' | 'lg'
5
+ /** @deprecated 使用 RsDialogWidthPreset;保留别名避免外部类型断裂 */
6
+ export type RsDialogWidth = RsDialogWidthPreset
5
7
  export type RsDialogResizeHandle = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw'
6
8
 
7
9
  export interface RsDialogBounds {
@@ -11,7 +13,7 @@ export interface RsDialogBounds {
11
13
  height: number
12
14
  }
13
15
 
14
- const widthMap: Record<RsDialogWidth, number> = {
16
+ const widthMap: Record<RsDialogWidthPreset, number> = {
15
17
  sm: 384,
16
18
  md: 448,
17
19
  lg: 512,
@@ -24,7 +26,9 @@ const minHeight = 240
24
26
 
25
27
  export function useRsDialogWindow(options: {
26
28
  open: Ref<boolean>
27
- widthPreset: Ref<RsDialogWidth>
29
+ widthPreset: Ref<RsDialogWidthPreset>
30
+ /** 自定义初始宽度(px);有值时优先于预设/比例 */
31
+ initialWidth?: Ref<number | undefined>
28
32
  draggable: Ref<boolean>
29
33
  resizable: Ref<boolean>
30
34
  compact?: Ref<boolean>
@@ -39,6 +43,9 @@ export function useRsDialogWindow(options: {
39
43
 
40
44
  let boundsTransitionTimer: ReturnType<typeof setTimeout> | null = null
41
45
  let cachedInsets = readDialogViewportInsets()
46
+ /** 交互中的目标面板;有值时 pointermove 只改 DOM,pointerup 再写回 bounds */
47
+ let panelEl: HTMLElement | null = null
48
+ let liveBounds: RsDialogBounds | null = null
42
49
 
43
50
  let dragState: { startX: number; startY: number; origin: RsDialogBounds } | null = null
44
51
  let resizeState: {
@@ -48,10 +55,41 @@ export function useRsDialogWindow(options: {
48
55
  origin: RsDialogBounds
49
56
  } | null = null
50
57
 
58
+ function writePanelBox(next: RsDialogBounds): void {
59
+ if (!panelEl) return
60
+ panelEl.style.left = `${next.x}px`
61
+ panelEl.style.top = `${next.y}px`
62
+ panelEl.style.width = `${next.width}px`
63
+ panelEl.style.height = `${next.height}px`
64
+ panelEl.style.transform = 'none'
65
+ }
66
+
67
+ /** 绑定可定位的对话框根节点(DialogContent 的 DOM) */
68
+ function setPanelEl(el: HTMLElement | null): void {
69
+ panelEl = el
70
+ }
71
+
72
+ /** 优先用已绑定节点;否则从事件目标向上找面板(Reka DialogContent ref 不一定有 $el) */
73
+ function ensurePanelEl(from?: EventTarget | null): HTMLElement | null {
74
+ if (panelEl?.isConnected) return panelEl
75
+ const node = from instanceof Element ? from : null
76
+ const found = node?.closest('.rs-dialog__content')
77
+ if (found instanceof HTMLElement) {
78
+ panelEl = found
79
+ return found
80
+ }
81
+ return null
82
+ }
83
+
51
84
  function defaultWindowSize(): Pick<RsDialogBounds, 'width' | 'height'> {
52
85
  const { width: maxW, height: maxH } = dialogViewportSize()
86
+ const customW = options.initialWidth?.value
87
+ const width =
88
+ customW != null && Number.isFinite(customW) && customW > 0
89
+ ? Math.min(maxW, Math.max(minWidth, Math.round(customW)))
90
+ : Math.min(maxW, Math.max(minWidth, Math.round(maxW * defaultWidthRatio)))
53
91
  return {
54
- width: Math.min(maxW, Math.max(minWidth, Math.round(maxW * defaultWidthRatio))),
92
+ width,
55
93
  height: Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio))),
56
94
  }
57
95
  }
@@ -97,7 +135,12 @@ export function useRsDialogWindow(options: {
97
135
  options.open,
98
136
  (value) => {
99
137
  if (value) resetOnOpen()
100
- else stopInteractions()
138
+ else {
139
+ stopInteractions()
140
+ // 关闭时清全屏态,避免 KeepAlive 缓存残留 --fullscreen 类导致 Presence 补丁异常
141
+ isFullscreen.value = false
142
+ restoreBounds.value = null
143
+ }
101
144
  },
102
145
  // 弹出等场景:组件挂载时 open 已为 true,需立即居中,不能只等 false→true
103
146
  { immediate: true },
@@ -115,7 +158,11 @@ export function useRsDialogWindow(options: {
115
158
  }
116
159
  }
117
160
  if (options.compact?.value) {
118
- const width = widthMap[options.widthPreset.value]
161
+ const customW = options.initialWidth?.value
162
+ const width =
163
+ customW != null && Number.isFinite(customW) && customW > 0
164
+ ? customW
165
+ : widthMap[options.widthPreset.value]
119
166
  return {
120
167
  left: '50%',
121
168
  top: `calc(${insets.top}px + (100vh - ${insets.top + insets.bottom}px) / 2)`,
@@ -169,7 +216,14 @@ export function useRsDialogWindow(options: {
169
216
  if (dragState) {
170
217
  const dx = event.clientX - dragState.startX
171
218
  const dy = event.clientY - dragState.startY
172
- bounds.value = clampBounds({ ...dragState.origin, x: dragState.origin.x + dx, y: dragState.origin.y + dy })
219
+ const next = clampBounds({
220
+ ...dragState.origin,
221
+ x: dragState.origin.x + dx,
222
+ y: dragState.origin.y + dy,
223
+ })
224
+ // 拖拽中只改 DOM,避免触发 Vue 对对话框子树(如虚拟滚动树)的高频 patch
225
+ liveBounds = next
226
+ writePanelBox(next)
173
227
  return
174
228
  }
175
229
 
@@ -187,10 +241,16 @@ export function useRsDialogWindow(options: {
187
241
  next.height = resizeState.origin.height - dy
188
242
  next.y = resizeState.origin.y + dy
189
243
  }
190
- bounds.value = clampBounds(next)
244
+ const clamped = clampBounds(next)
245
+ liveBounds = clamped
246
+ writePanelBox(clamped)
191
247
  }
192
248
 
193
249
  function stopInteractions(): void {
250
+ if (liveBounds) {
251
+ bounds.value = liveBounds
252
+ liveBounds = null
253
+ }
194
254
  dragState = null
195
255
  resizeState = null
196
256
  window.removeEventListener('pointermove', onPointerMove)
@@ -203,6 +263,7 @@ export function useRsDialogWindow(options: {
203
263
  boundsTransitionEnabled.value = false
204
264
  clearBoundsTransitionTimer()
205
265
  refreshCachedInsets()
266
+ liveBounds = { ...bounds.value }
206
267
  window.addEventListener('pointermove', onPointerMove)
207
268
  window.addEventListener('pointerup', stopInteractions)
208
269
  document.body.style.userSelect = 'none'
@@ -214,8 +275,10 @@ export function useRsDialogWindow(options: {
214
275
  const target = event.target as HTMLElement
215
276
  if (target.closest('button,a,input,textarea,select')) return
216
277
  event.preventDefault()
278
+ ensurePanelEl(event.target)
217
279
  dragState = { startX: event.clientX, startY: event.clientY, origin: { ...bounds.value } }
218
- startInteraction('grabbing')
280
+ // move:四向十字箭头,表示可自由拖移窗口
281
+ startInteraction('move')
219
282
  }
220
283
 
221
284
  const resizeCursor: Record<RsDialogResizeHandle, string> = {
@@ -232,6 +295,7 @@ export function useRsDialogWindow(options: {
232
295
  function onResizePointerDown(handle: RsDialogResizeHandle, event: PointerEvent): void {
233
296
  if (!options.resizable.value || isFullscreen.value) return
234
297
  event.preventDefault()
298
+ ensurePanelEl(event.target)
235
299
  resizeState = { handle, startX: event.clientX, startY: event.clientY, origin: { ...bounds.value } }
236
300
  startInteraction(resizeCursor[handle])
237
301
  }
@@ -246,6 +310,7 @@ export function useRsDialogWindow(options: {
246
310
  boundsTransitionEnabled,
247
311
  dialogStyle,
248
312
  resizeHandles,
313
+ setPanelEl,
249
314
  toggleFullscreen,
250
315
  onHeaderPointerDown,
251
316
  onResizePointerDown,
@@ -0,0 +1,73 @@
1
+ import {
2
+ resolveDialogOverlayStyle,
3
+ runRsDialogBeforeClose,
4
+ type RsDialogBeforeClose,
5
+ type RsDialogCloseReason,
6
+ } from './dialog-utils'
7
+
8
+ /** 抽屉滑出方向 */
9
+ export type RsDrawerSide = 'left' | 'right' | 'top' | 'bottom'
10
+
11
+ /** 抽屉尺寸预设(左右为宽度,上下为高度) */
12
+ export type RsDrawerSize = 'sm' | 'md' | 'lg' | 'full'
13
+
14
+ /**
15
+ * 自定义面板尺寸:number 按 px;string 原样写入 CSS(如 `24rem` / `40%`)。
16
+ * 与 size 同时传入时,自定义尺寸优先。
17
+ */
18
+ export type RsDrawerDimension = number | string
19
+
20
+ /** 关闭来源,与 Dialog 共用语义,便于业务统一 beforeClose */
21
+ export type RsDrawerCloseReason = RsDialogCloseReason
22
+
23
+ /** 关闭前钩子:返回 false 阻止关闭;支持异步 */
24
+ export type RsDrawerBeforeClose = RsDialogBeforeClose
25
+
26
+ const SIZE_INLINE: Record<Exclude<RsDrawerSize, 'full'>, string> = {
27
+ sm: '20rem',
28
+ md: '28rem',
29
+ lg: '36rem',
30
+ }
31
+
32
+ /** 将 size 预设解析为 CSS 长度(full 由样式类处理) */
33
+ export function resolveRsDrawerSizeCss(size: RsDrawerSize): string | undefined {
34
+ if (size === 'full') return undefined
35
+ return SIZE_INLINE[size]
36
+ }
37
+
38
+ /** 将自定义 width/height 规范为 CSS 长度 */
39
+ export function resolveRsDrawerDimensionCss(value: RsDrawerDimension | undefined): string | undefined {
40
+ if (value == null) return undefined
41
+ if (typeof value === 'number') {
42
+ if (!Number.isFinite(value) || value <= 0) return undefined
43
+ return `${value}px`
44
+ }
45
+ const trimmed = String(value).trim()
46
+ return trimmed || undefined
47
+ }
48
+
49
+ export function runRsDrawerBeforeClose(
50
+ beforeClose: RsDrawerBeforeClose | undefined,
51
+ reason: RsDrawerCloseReason,
52
+ ): Promise<boolean> {
53
+ return runRsDialogBeforeClose(beforeClose, reason)
54
+ }
55
+
56
+ /**
57
+ * 遮罩样式:复用 Dialog 的 opacity/blur 解析,写入抽屉专用 CSS 变量。
58
+ */
59
+ export function resolveDrawerOverlayStyle(options?: {
60
+ overlayOpacity?: number
61
+ overlayBlur?: number | string
62
+ }): Record<string, string> | undefined {
63
+ const dialogStyle = resolveDialogOverlayStyle(options)
64
+ if (!dialogStyle) return undefined
65
+ const style: Record<string, string> = {}
66
+ if (dialogStyle['--rs-dialog-overlay-bg']) {
67
+ style['--rs-drawer-overlay-bg'] = dialogStyle['--rs-dialog-overlay-bg']
68
+ }
69
+ if (dialogStyle['--rs-dialog-overlay-blur']) {
70
+ style['--rs-drawer-overlay-blur'] = dialogStyle['--rs-dialog-overlay-blur']
71
+ }
72
+ return Object.keys(style).length ? style : undefined
73
+ }