@svadmin/ui 0.136.0 → 0.137.1

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 (191) hide show
  1. package/dist/app.css +107 -2
  2. package/dist/app.theme.css +107 -2
  3. package/dist/components/AboutSettings.svelte +1 -1
  4. package/dist/components/Affix.svelte +17 -2
  5. package/dist/components/Affix.svelte.d.ts +2 -0
  6. package/dist/components/Anchor.svelte +33 -8
  7. package/dist/components/Anchor.svelte.d.ts +6 -2
  8. package/dist/components/AutoComplete.svelte +27 -3
  9. package/dist/components/AutoComplete.svelte.d.ts +3 -0
  10. package/dist/components/BackTop.svelte +18 -7
  11. package/dist/components/BackTop.svelte.d.ts +4 -0
  12. package/dist/components/Barcode.svelte +9 -2
  13. package/dist/components/Barcode.svelte.d.ts +2 -0
  14. package/dist/components/Breadcrumbs.svelte +21 -8
  15. package/dist/components/Breadcrumbs.svelte.d.ts +6 -2
  16. package/dist/components/Calendar.svelte +26 -4
  17. package/dist/components/Calendar.svelte.d.ts +4 -1
  18. package/dist/components/Carousel.svelte +30 -4
  19. package/dist/components/Carousel.svelte.d.ts +4 -0
  20. package/dist/components/Cascader.svelte +79 -17
  21. package/dist/components/Cascader.svelte.d.ts +9 -2
  22. package/dist/components/CheckCard.svelte +14 -4
  23. package/dist/components/CheckCard.svelte.d.ts +4 -2
  24. package/dist/components/Col.svelte +14 -10
  25. package/dist/components/Col.svelte.d.ts +2 -0
  26. package/dist/components/Collapse.svelte +67 -9
  27. package/dist/components/Collapse.svelte.d.ts +12 -4
  28. package/dist/components/ColorPicker.svelte +76 -14
  29. package/dist/components/ColorPicker.svelte.d.ts +6 -0
  30. package/dist/components/ConfigProvider.svelte +1 -0
  31. package/dist/components/ConfigProvider.svelte.d.ts +1 -0
  32. package/dist/components/ConfirmDialog.svelte +33 -8
  33. package/dist/components/ConfirmDialog.svelte.d.ts +5 -0
  34. package/dist/components/Countdown.svelte +49 -15
  35. package/dist/components/Countdown.svelte.d.ts +6 -2
  36. package/dist/components/DatePicker.svelte +36 -8
  37. package/dist/components/DatePicker.svelte.d.ts +8 -0
  38. package/dist/components/DateRangeInput.svelte +67 -4
  39. package/dist/components/DateRangeInput.svelte.d.ts +7 -0
  40. package/dist/components/DateTimeInput.svelte +19 -1
  41. package/dist/components/DateTimeInput.svelte.d.ts +4 -0
  42. package/dist/components/Divider.svelte +27 -4
  43. package/dist/components/Divider.svelte.d.ts +6 -0
  44. package/dist/components/DrawerForm.svelte +131 -43
  45. package/dist/components/DrawerForm.svelte.d.ts +14 -1
  46. package/dist/components/EditableTabs.svelte +1 -1
  47. package/dist/components/EllipsisText.svelte +31 -8
  48. package/dist/components/EllipsisText.svelte.d.ts +8 -0
  49. package/dist/components/EmptyState.svelte +25 -5
  50. package/dist/components/EmptyState.svelte.d.ts +6 -1
  51. package/dist/components/FileUpload.svelte +15 -5
  52. package/dist/components/FileUpload.svelte.d.ts +3 -0
  53. package/dist/components/FloatButton.svelte +4 -1
  54. package/dist/components/FloatButton.svelte.d.ts +1 -0
  55. package/dist/components/HighlightText.svelte +15 -3
  56. package/dist/components/HighlightText.svelte.d.ts +6 -0
  57. package/dist/components/Image.svelte +10 -4
  58. package/dist/components/Image.svelte.d.ts +1 -0
  59. package/dist/components/LightFilter.svelte +37 -17
  60. package/dist/components/LightFilter.svelte.d.ts +8 -2
  61. package/dist/components/Link.svelte +19 -8
  62. package/dist/components/Link.svelte.d.ts +3 -2
  63. package/dist/components/ListPagination.svelte +165 -27
  64. package/dist/components/ListPagination.svelte.d.ts +10 -3
  65. package/dist/components/MentionsInput.svelte +33 -3
  66. package/dist/components/MentionsInput.svelte.d.ts +5 -0
  67. package/dist/components/ModalForm.svelte +116 -48
  68. package/dist/components/ModalForm.svelte.d.ts +14 -1
  69. package/dist/components/OtpInput.svelte +40 -12
  70. package/dist/components/OtpInput.svelte.d.ts +4 -1
  71. package/dist/components/PageContainer.svelte +74 -22
  72. package/dist/components/PageContainer.svelte.d.ts +20 -4
  73. package/dist/components/PageHeader.svelte +47 -8
  74. package/dist/components/PageHeader.svelte.d.ts +7 -2
  75. package/dist/components/PasswordInput.svelte +42 -11
  76. package/dist/components/PasswordInput.svelte.d.ts +10 -3
  77. package/dist/components/Popconfirm.svelte +96 -17
  78. package/dist/components/Popconfirm.svelte.d.ts +13 -1
  79. package/dist/components/PresenceAvatarGroup.svelte +12 -4
  80. package/dist/components/PresenceAvatarGroup.svelte.d.ts +1 -1
  81. package/dist/components/ProCard.svelte +17 -0
  82. package/dist/components/ProCard.svelte.d.ts +6 -0
  83. package/dist/components/ProDescriptions.svelte +28 -12
  84. package/dist/components/ProDescriptions.svelte.d.ts +7 -3
  85. package/dist/components/ProSkeleton.svelte +17 -2
  86. package/dist/components/ProSkeleton.svelte.d.ts +7 -0
  87. package/dist/components/QRCode.svelte +51 -14
  88. package/dist/components/QRCode.svelte.d.ts +10 -0
  89. package/dist/components/QueryFilter.svelte +48 -9
  90. package/dist/components/QueryFilter.svelte.d.ts +16 -0
  91. package/dist/components/RadioGroup.svelte +86 -8
  92. package/dist/components/RadioGroup.svelte.d.ts +2 -0
  93. package/dist/components/RangeSlider.svelte +34 -7
  94. package/dist/components/RangeSlider.svelte.d.ts +4 -0
  95. package/dist/components/Rate.svelte +178 -15
  96. package/dist/components/Rate.svelte.d.ts +16 -0
  97. package/dist/components/ResizeBox.svelte +39 -9
  98. package/dist/components/ResizeBox.svelte.d.ts +3 -0
  99. package/dist/components/Result.svelte +34 -5
  100. package/dist/components/Result.svelte.d.ts +4 -2
  101. package/dist/components/Ribbon.svelte +8 -4
  102. package/dist/components/Ribbon.svelte.d.ts +1 -1
  103. package/dist/components/Row.svelte +21 -5
  104. package/dist/components/Row.svelte.d.ts +2 -2
  105. package/dist/components/RowActions.svelte +4 -0
  106. package/dist/components/SegmentedControl.svelte +70 -8
  107. package/dist/components/SegmentedControl.svelte.d.ts +6 -1
  108. package/dist/components/Slider.svelte +35 -8
  109. package/dist/components/Slider.svelte.d.ts +4 -0
  110. package/dist/components/Space.svelte +34 -7
  111. package/dist/components/Space.svelte.d.ts +3 -3
  112. package/dist/components/Spin.svelte +142 -9
  113. package/dist/components/Spin.svelte.d.ts +7 -2
  114. package/dist/components/Statistic.svelte +29 -6
  115. package/dist/components/Statistic.svelte.d.ts +5 -1
  116. package/dist/components/StatisticCard.svelte +20 -4
  117. package/dist/components/StatisticCard.svelte.d.ts +5 -1
  118. package/dist/components/Steps.svelte +28 -7
  119. package/dist/components/Steps.svelte.d.ts +8 -2
  120. package/dist/components/Tag.svelte +63 -6
  121. package/dist/components/Tag.svelte.d.ts +12 -3
  122. package/dist/components/TagsInput.svelte +42 -21
  123. package/dist/components/TagsInput.svelte.d.ts +4 -0
  124. package/dist/components/Timeline.svelte +54 -3
  125. package/dist/components/Timeline.svelte.d.ts +13 -1
  126. package/dist/components/TooltipButton.svelte +7 -3
  127. package/dist/components/TooltipButton.svelte.d.ts +4 -1
  128. package/dist/components/Tour.svelte +56 -6
  129. package/dist/components/Tour.svelte.d.ts +7 -0
  130. package/dist/components/Transfer.svelte +77 -20
  131. package/dist/components/Transfer.svelte.d.ts +11 -2
  132. package/dist/components/Tree.svelte +109 -26
  133. package/dist/components/Tree.svelte.d.ts +15 -2
  134. package/dist/components/TreeSelect.svelte +168 -97
  135. package/dist/components/TreeSelect.svelte.d.ts +11 -2
  136. package/dist/components/Typography.svelte +18 -2
  137. package/dist/components/Typography.svelte.d.ts +4 -1
  138. package/dist/components/TypographyText.svelte +10 -3
  139. package/dist/components/TypographyText.svelte.d.ts +3 -1
  140. package/dist/components/Watermark.svelte +15 -2
  141. package/dist/components/Watermark.svelte.d.ts +3 -0
  142. package/dist/components/content/DescriptionList.svelte +21 -8
  143. package/dist/components/content/DescriptionList.svelte.d.ts +3 -0
  144. package/dist/components/content/FilterToolbar.svelte +1 -0
  145. package/dist/components/ui/alert/alert.svelte +51 -7
  146. package/dist/components/ui/alert/alert.svelte.d.ts +8 -2
  147. package/dist/components/ui/avatar/avatar-variants.d.ts +1 -1
  148. package/dist/components/ui/avatar/avatar-variants.js +19 -7
  149. package/dist/components/ui/avatar/avatar.svelte +50 -3
  150. package/dist/components/ui/avatar/avatar.svelte.d.ts +5 -0
  151. package/dist/components/ui/badge/badge.svelte +27 -12
  152. package/dist/components/ui/badge/badge.svelte.d.ts +5 -2
  153. package/dist/components/ui/breadcrumb/breadcrumb-separator.svelte +4 -2
  154. package/dist/components/ui/breadcrumb/breadcrumb-separator.svelte.d.ts +1 -1
  155. package/dist/components/ui/button/button.svelte +100 -11
  156. package/dist/components/ui/button/button.svelte.d.ts +15 -2
  157. package/dist/components/ui/card/card.svelte +40 -4
  158. package/dist/components/ui/card/card.svelte.d.ts +5 -1
  159. package/dist/components/ui/checkbox/checkbox.svelte +71 -23
  160. package/dist/components/ui/checkbox/checkbox.svelte.d.ts +8 -1
  161. package/dist/components/ui/input/input.svelte +7 -4
  162. package/dist/components/ui/input/input.svelte.d.ts +2 -2
  163. package/dist/components/ui/progress/progress.svelte +122 -22
  164. package/dist/components/ui/progress/progress.svelte.d.ts +9 -1
  165. package/dist/components/ui/skeleton/index.d.ts +1 -1
  166. package/dist/components/ui/skeleton/skeleton.svelte +124 -6
  167. package/dist/components/ui/skeleton/skeleton.svelte.d.ts +19 -3
  168. package/dist/components/ui/switch/switch.svelte +44 -6
  169. package/dist/components/ui/switch/switch.svelte.d.ts +10 -3
  170. package/dist/components/ui/tabs/tabs-content.svelte +6 -1
  171. package/dist/components/ui/tabs/tabs-content.svelte.d.ts +1 -0
  172. package/dist/components/ui/tabs/tabs-context.svelte.d.ts +4 -1
  173. package/dist/components/ui/tabs/tabs-list.svelte +12 -3
  174. package/dist/components/ui/tabs/tabs-list.svelte.d.ts +4 -2
  175. package/dist/components/ui/tabs/tabs-trigger.svelte +11 -1
  176. package/dist/components/ui/tabs/tabs-trigger.svelte.d.ts +3 -0
  177. package/dist/components/ui/tabs/tabs.svelte +49 -5
  178. package/dist/components/ui/tabs/tabs.svelte.d.ts +10 -2
  179. package/dist/components/ui/textarea/textarea.svelte +17 -2
  180. package/dist/components/ui/textarea/textarea.svelte.d.ts +3 -1
  181. package/dist/components/ui/tooltip/tooltip-content.svelte +4 -1
  182. package/dist/components/ui/tooltip/tooltip-content.svelte.d.ts +1 -0
  183. package/dist/components/ui/tooltip/tooltip.svelte +14 -1
  184. package/dist/components.css +7 -2
  185. package/dist/index.d.ts +2 -2
  186. package/dist/index.js +1 -1
  187. package/dist/notifications.svelte.d.ts +6 -1
  188. package/dist/notifications.svelte.js +20 -4
  189. package/dist/page-chrome.css +5 -0
  190. package/package.json +1 -1
  191. package/dist/components/ui/tooltip/tooltip.svelte.d.ts +0 -25
@@ -9,16 +9,24 @@
9
9
  import { useTranslation } from '@svadmin/core/i18n';
10
10
 
11
11
  export interface CascaderOption {
12
- value: string | number;
13
- label: string;
12
+ value?: string | number;
13
+ key?: string | number;
14
+ label?: string;
15
+ title?: string;
14
16
  children?: CascaderOption[];
15
17
  hasChildren?: boolean;
16
18
  disabled?: boolean;
17
19
  isLeaf?: boolean;
20
+ [key: string]: unknown;
18
21
  }
19
22
 
20
23
  export type CascaderPath = (string | number)[];
21
24
 
25
+ /** 归一化后的节点值:宿主可以用 value 或 key,缺省时退化为空串。 */
26
+ function nodeValue(option: CascaderOption): string | number {
27
+ return option.value ?? option.key ?? '';
28
+ }
29
+
22
30
  const i18n = useTranslation();
23
31
 
24
32
  interface Props {
@@ -27,6 +35,7 @@
27
35
  describedby?: string | undefined;
28
36
  invalid?: boolean | undefined;
29
37
  options?: CascaderOption[] | undefined;
38
+ data?: CascaderOption[] | undefined;
30
39
  value?: CascaderPath | CascaderPath[] | undefined;
31
40
  separator?: string | undefined;
32
41
  placeholder?: string | undefined;
@@ -43,8 +52,11 @@
43
52
  maxTagCount?: number | undefined;
44
53
  displayRender?: ((labels: string[], selectedOptions: CascaderOption[][]) => string) | undefined;
45
54
  loadChildren?: ((node: CascaderOption) => Promise<CascaderOption[]>) | undefined;
55
+ size?: 'mini' | 'small' | 'default' | 'large' | undefined;
46
56
  class?: string | undefined;
57
+ defaultValue?: CascaderPath | CascaderPath[] | undefined;
47
58
  onchange?: (value: CascaderPath | CascaderPath[] | undefined, selectedOptions: CascaderOption[] | CascaderOption[][]) => void;
59
+ onChange?: (value: CascaderPath | CascaderPath[] | undefined, selectedOptions: CascaderOption[] | CascaderOption[][]) => void;
48
60
  }
49
61
 
50
62
  let {
@@ -53,11 +65,14 @@
53
65
  describedby,
54
66
  invalid = false,
55
67
  options = $bindable([]),
68
+ data,
56
69
  value = $bindable(undefined),
70
+ defaultValue,
57
71
  separator = ' / ',
58
72
  placeholder,
59
73
  changeOnSelect = false,
60
74
  disabled = false,
75
+ size = 'default',
61
76
  allowClear = true,
62
77
  multiple = false,
63
78
  checkable = false,
@@ -68,8 +83,19 @@
68
83
  loadChildren,
69
84
  class: className,
70
85
  onchange,
86
+ onChange,
71
87
  }: Props = $props();
72
88
 
89
+ let initialCascaderSync = false;
90
+ $effect.pre(() => {
91
+ if (!initialCascaderSync) {
92
+ initialCascaderSync = true;
93
+ if (defaultValue !== undefined && value === undefined) {
94
+ value = defaultValue;
95
+ }
96
+ }
97
+ });
98
+
73
99
  const instanceId = $props.id();
74
100
  const triggerId = $derived(id ?? `${instanceId}-trigger`);
75
101
  const panelId = $derived(`${triggerId}-panel`);
@@ -131,7 +157,7 @@
131
157
  function mergeLoadedChildren(nodes: CascaderOption[], prefix: (string | number)[]): CascaderOption[] {
132
158
  let changed = false;
133
159
  const next = nodes.map((node) => {
134
- const path = [...prefix, node.value];
160
+ const path = [...prefix, nodeValue(node)];
135
161
  const entry = loadedChildren.get(pathId(path));
136
162
  const applyLoaded = node.children === undefined && node.isLeaf !== true
137
163
  && !!entry && entry.node === node;
@@ -149,14 +175,38 @@
149
175
  return changed ? next : nodes;
150
176
  }
151
177
 
178
+ function normalizeCascaderNodes(nodes: CascaderOption[]): CascaderOption[] {
179
+ let changed = false;
180
+ const next = nodes.map((node) => {
181
+ const needsVal = node.value === undefined && node.key !== undefined;
182
+ const needsLab = node.label === undefined && node.title !== undefined;
183
+ const children = node.children ? normalizeCascaderNodes(node.children) : undefined;
184
+ if (needsVal || needsLab || (children !== undefined && children !== node.children)) {
185
+ changed = true;
186
+ const nextChildren = children ?? node.children;
187
+ return {
188
+ ...node,
189
+ value: nodeValue(node),
190
+ label: node.label ?? node.title ?? String(nodeValue(node)),
191
+ ...(nextChildren === undefined ? {} : { children: nextChildren }),
192
+ };
193
+ }
194
+ return node;
195
+ });
196
+ return changed ? next : nodes;
197
+ }
198
+
199
+ const rawInputOptions = $derived(data ?? options);
200
+ const normalizedRawOptions = $derived(normalizeCascaderNodes(rawInputOptions));
201
+
152
202
  // 每次读取都从宿主当前对象重建,避免克隆祖先形成旧快照。
153
- const effectiveOptions = $derived(mergeLoadedChildren(options, []));
203
+ const effectiveOptions = $derived(mergeLoadedChildren(normalizedRawOptions, []));
154
204
 
155
205
  // 外部替换选项或加载器、禁用字段时,旧请求不得再写入或提交。
156
206
  $effect.pre(() => {
157
- if (options !== observedOptions) {
207
+ if (normalizedRawOptions !== observedOptions) {
158
208
  // 宿主替换 options 一定推进树版本;内部子级缓存随之失效。
159
- observedOptions = options;
209
+ observedOptions = normalizedRawOptions;
160
210
  loadedChildren.clear();
161
211
  treeEpoch += 1;
162
212
  }
@@ -240,7 +290,7 @@
240
290
 
241
291
  async function activateOption(colIndex: number, option: CascaderOption, commitSelection: boolean): Promise<{ loaded: boolean; path: (string | number)[] }> {
242
292
  if (isOptionDisabled(colIndex, option)) return { loaded: false, path: activePath };
243
- const nextPath = [...activePath.slice(0, colIndex), option.value];
293
+ const nextPath = [...activePath.slice(0, colIndex), nodeValue(option)];
244
294
  activePath = nextPath;
245
295
  const loaded = await ensureChildren(option, nextPath);
246
296
  if (!loaded || !open || !samePath(activePath, nextPath)) return { loaded: false, path: nextPath };
@@ -251,7 +301,9 @@
251
301
  // 同一异步分支在请求期间被重复激活时,只有第一次可以提交。
252
302
  if (!multi && (!value || !samePath(value as CascaderPath, nextPath))) {
253
303
  value = nextPath;
254
- onchange?.(nextPath, getOptionsForPath(nextPath));
304
+ const opts = getOptionsForPath(nextPath);
305
+ onchange?.(nextPath, opts);
306
+ onChange?.(nextPath, opts);
255
307
  }
256
308
  }
257
309
  if (commitSelection && !currentHasChildren) open = false;
@@ -323,11 +375,11 @@
323
375
  }
324
376
 
325
377
  function treeNode(path: CascaderPath, option: CascaderOption): UiTreeNode {
326
- const nodePath = [...path, option.value];
378
+ const nodePath = [...path, nodeValue(option)];
327
379
  const children = option.children?.map((child) => treeNode(nodePath, child));
328
380
  return {
329
381
  id: pathNodeId(nodePath),
330
- label: option.label,
382
+ label: option.label ?? String(nodeValue(option)),
331
383
  ...(children === undefined ? {} : { children }),
332
384
  ...(option.disabled === true ? { disabled: true } : {}),
333
385
  ...(option.isLeaf === true ? { isLeaf: true } : {}),
@@ -342,7 +394,7 @@
342
394
  const lowered = term.toLowerCase();
343
395
  return items.flatMap((node) => {
344
396
  const children = node.children ? searchTreeNodes(node.children, term) : undefined;
345
- const matched = node.label.toLowerCase().includes(lowered);
397
+ const matched = (node.label ?? '').toLowerCase().includes(lowered);
346
398
  if (!matched && (!children || children.length === 0)) return [];
347
399
  return [{ ...node, ...(children === undefined ? {} : { children }) }];
348
400
  });
@@ -355,7 +407,7 @@
355
407
  const ids: string[] = [];
356
408
  const walk = (items: UiTreeNode[]) => {
357
409
  for (const node of items) {
358
- if (node.children?.length) { ids.push(node.id); walk(node.children); }
410
+ if (node.children?.length && node.id !== undefined) { ids.push(node.id); walk(node.children); }
359
411
  }
360
412
  };
361
413
  walk(filteredTreeNodes);
@@ -367,6 +419,7 @@
367
419
  }
368
420
 
369
421
  async function treeLoadChildren(node: UiTreeNode): Promise<UiTreeNode[]> {
422
+ if (node.id === undefined) return [];
370
423
  const path = JSON.parse(node.id) as CascaderPath;
371
424
  const current = getOptionsForPath(path).at(-1);
372
425
  if (!current) return [];
@@ -376,7 +429,9 @@
376
429
 
377
430
  function emitMulti(paths: CascaderPath[]): void {
378
431
  value = paths;
379
- onchange?.(paths, paths.map((path) => getOptionsForPath(path)));
432
+ const opts = paths.map((path) => getOptionsForPath(path));
433
+ onchange?.(paths, opts);
434
+ onChange?.(paths, opts);
380
435
  }
381
436
 
382
437
  function emitChecked(paths: CascaderPath[]): void {
@@ -393,7 +448,9 @@
393
448
  function selectSinglePath(path: CascaderPath): void {
394
449
  activePath = path;
395
450
  value = path;
396
- onchange?.(path, getOptionsForPath(path));
451
+ const opts = getOptionsForPath(path);
452
+ onchange?.(path, opts);
453
+ onChange?.(path, opts);
397
454
  open = false;
398
455
  }
399
456
 
@@ -402,8 +459,8 @@
402
459
  const leaves: SearchLeaf[] = [];
403
460
  const walk = (items: CascaderOption[], prefix: CascaderPath, labels: string[]) => {
404
461
  for (const item of items) {
405
- const path = [...prefix, item.value];
406
- const nextLabels = [...labels, item.label];
462
+ const path = [...prefix, nodeValue(item)];
463
+ const nextLabels = [...labels, item.label ?? String(nodeValue(item))];
407
464
  if (!hasChildren(item)) leaves.push({ path, labels: nextLabels, disabled: item.disabled === true });
408
465
  else if (item.children) walk(item.children, path, nextLabels);
409
466
  }
@@ -468,10 +525,12 @@
468
525
  if (multi) {
469
526
  value = [];
470
527
  onchange?.([], []);
528
+ onChange?.([], []);
471
529
  } else {
472
530
  value = undefined;
473
531
  activePath = [];
474
532
  onchange?.(undefined, []);
533
+ onChange?.(undefined, []);
475
534
  }
476
535
  searchTerm = '';
477
536
  }
@@ -577,7 +636,7 @@
577
636
  });
578
637
  </script>
579
638
 
580
- <div class={cn('relative w-full', className)} data-testid="cascader">
639
+ <div class={cn('relative w-full', className)} data-size={size} data-testid="cascader">
581
640
  <Popover.Root bind:open>
582
641
  <div class="cascader-control">
583
642
  <Popover.Trigger id={triggerId} {disabled} class="w-full">
@@ -593,6 +652,9 @@
593
652
  {disabled}
594
653
  class={cn(
595
654
  'flex min-h-9 w-full items-center justify-between rounded-md border border-input bg-background px-3 py-1.5 text-xs ring-offset-background placeholder:text-muted-foreground focus:outline-hidden focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 text-left',
655
+ size === 'mini' && 'min-h-6 h-6 px-2 text-[11px]',
656
+ size === 'small' && 'min-h-7 h-7 px-2.5 text-xs',
657
+ size === 'large' && 'min-h-10 h-10 px-3.5 text-sm',
596
658
  open && 'ring-2 ring-ring ring-offset-2'
597
659
  )}
598
660
  >
@@ -1,10 +1,13 @@
1
1
  export interface CascaderOption {
2
- value: string | number;
3
- label: string;
2
+ value?: string | number;
3
+ key?: string | number;
4
+ label?: string;
5
+ title?: string;
4
6
  children?: CascaderOption[];
5
7
  hasChildren?: boolean;
6
8
  disabled?: boolean;
7
9
  isLeaf?: boolean;
10
+ [key: string]: unknown;
8
11
  }
9
12
  export type CascaderPath = (string | number)[];
10
13
  interface Props {
@@ -13,6 +16,7 @@ interface Props {
13
16
  describedby?: string | undefined;
14
17
  invalid?: boolean | undefined;
15
18
  options?: CascaderOption[] | undefined;
19
+ data?: CascaderOption[] | undefined;
16
20
  value?: CascaderPath | CascaderPath[] | undefined;
17
21
  separator?: string | undefined;
18
22
  placeholder?: string | undefined;
@@ -29,8 +33,11 @@ interface Props {
29
33
  maxTagCount?: number | undefined;
30
34
  displayRender?: ((labels: string[], selectedOptions: CascaderOption[][]) => string) | undefined;
31
35
  loadChildren?: ((node: CascaderOption) => Promise<CascaderOption[]>) | undefined;
36
+ size?: 'mini' | 'small' | 'default' | 'large' | undefined;
32
37
  class?: string | undefined;
38
+ defaultValue?: CascaderPath | CascaderPath[] | undefined;
33
39
  onchange?: (value: CascaderPath | CascaderPath[] | undefined, selectedOptions: CascaderOption[] | CascaderOption[][]) => void;
40
+ onChange?: (value: CascaderPath | CascaderPath[] | undefined, selectedOptions: CascaderOption[] | CascaderOption[][]) => void;
34
41
  }
35
42
  declare const Cascader: import("svelte").Component<Props, {}, "value" | "options">;
36
43
  type Cascader = ReturnType<typeof Cascader>;
@@ -8,10 +8,12 @@
8
8
  checked?: boolean;
9
9
  /** Default checked state for uncontrolled usage */
10
10
  defaultChecked?: boolean;
11
+ /** Value for form/group association */
12
+ value?: unknown;
11
13
  /** Title of the card */
12
- title?: string;
14
+ title?: string | Snippet;
13
15
  /** Description or secondary text */
14
- description?: string;
16
+ description?: string | Snippet;
15
17
  /** Disabled state */
16
18
  disabled?: boolean;
17
19
  /** Loading state */
@@ -34,6 +36,7 @@
34
36
  let {
35
37
  checked,
36
38
  defaultChecked = false,
39
+ value,
37
40
  title,
38
41
  description,
39
42
  disabled = false,
@@ -77,6 +80,7 @@
77
80
  onclick={handleClick}
78
81
  onkeydown={handleKeyDown}
79
82
  data-svadmin-component="CheckCard"
83
+ data-value={value !== undefined ? String(value) : undefined}
80
84
  class={cn(
81
85
  'svadmin-check-card relative flex flex-col justify-between border transition-all select-none cursor-pointer rounded-[4px] bg-card text-card-foreground',
82
86
  size === 'small' ? 'p-3 text-xs min-w-[140px]' : 'p-4 text-sm min-w-[180px]',
@@ -119,7 +123,9 @@
119
123
  {@render avatar()}
120
124
  </div>
121
125
  {/if}
122
- {#if title}
126
+ {#if typeof title === 'function'}
127
+ {@render title()}
128
+ {:else if title}
123
129
  <span class="font-semibold text-foreground truncate leading-snug">
124
130
  {title}
125
131
  </span>
@@ -134,7 +140,11 @@
134
140
  {/if}
135
141
 
136
142
  <!-- Description -->
137
- {#if description}
143
+ {#if typeof description === 'function'}
144
+ <div class="text-xs text-muted-foreground leading-relaxed line-clamp-2 mt-0.5">
145
+ {@render description()}
146
+ </div>
147
+ {:else if description}
138
148
  <p class="text-xs text-muted-foreground leading-relaxed line-clamp-2 mt-0.5">
139
149
  {description}
140
150
  </p>
@@ -4,10 +4,12 @@ export interface CheckCardProps {
4
4
  checked?: boolean;
5
5
  /** Default checked state for uncontrolled usage */
6
6
  defaultChecked?: boolean;
7
+ /** Value for form/group association */
8
+ value?: unknown;
7
9
  /** Title of the card */
8
- title?: string;
10
+ title?: string | Snippet;
9
11
  /** Description or secondary text */
10
- description?: string;
12
+ description?: string | Snippet;
11
13
  /** Disabled state */
12
14
  disabled?: boolean;
13
15
  /** Loading state */
@@ -5,6 +5,8 @@
5
5
  interface Props {
6
6
  span?: number;
7
7
  offset?: number;
8
+ xs?: number;
9
+ xsOffset?: number;
8
10
  sm?: number;
9
11
  smOffset?: number;
10
12
  md?: number;
@@ -21,6 +23,8 @@
21
23
  let {
22
24
  span = 24,
23
25
  offset = 0,
26
+ xs,
27
+ xsOffset,
24
28
  sm,
25
29
  smOffset,
26
30
  md,
@@ -37,16 +41,16 @@
37
41
  const safeSpan = (value: number): number => Math.max(1, Math.min(24, value));
38
42
  const safeStart = (value: number | undefined): string => value === undefined || value <= 0 ? 'auto' : `${Math.min(24, value + 1)}`;
39
43
  const style = $derived([
40
- `--svadmin-col-span:${safeSpan(span)}`,
41
- `--svadmin-col-start:${safeStart(offset)}`,
42
- `--svadmin-col-sm:${safeSpan(sm ?? span)}`,
43
- `--svadmin-col-sm-start:${safeStart(smOffset ?? offset)}`,
44
- `--svadmin-col-md:${safeSpan(md ?? sm ?? span)}`,
45
- `--svadmin-col-md-start:${safeStart(mdOffset ?? smOffset ?? offset)}`,
46
- `--svadmin-col-lg:${safeSpan(lg ?? md ?? sm ?? span)}`,
47
- `--svadmin-col-lg-start:${safeStart(lgOffset ?? mdOffset ?? smOffset ?? offset)}`,
48
- `--svadmin-col-xl:${safeSpan(xl ?? lg ?? md ?? sm ?? span)}`,
49
- `--svadmin-col-xl-start:${safeStart(xlOffset ?? lgOffset ?? mdOffset ?? smOffset ?? offset)}`,
44
+ `--svadmin-col-span:${safeSpan(xs ?? span)}`,
45
+ `--svadmin-col-start:${safeStart(xsOffset ?? offset)}`,
46
+ `--svadmin-col-sm:${safeSpan(sm ?? xs ?? span)}`,
47
+ `--svadmin-col-sm-start:${safeStart(smOffset ?? xsOffset ?? offset)}`,
48
+ `--svadmin-col-md:${safeSpan(md ?? sm ?? xs ?? span)}`,
49
+ `--svadmin-col-md-start:${safeStart(mdOffset ?? smOffset ?? xsOffset ?? offset)}`,
50
+ `--svadmin-col-lg:${safeSpan(lg ?? md ?? sm ?? xs ?? span)}`,
51
+ `--svadmin-col-lg-start:${safeStart(lgOffset ?? mdOffset ?? smOffset ?? xsOffset ?? offset)}`,
52
+ `--svadmin-col-xl:${safeSpan(xl ?? lg ?? md ?? sm ?? xs ?? span)}`,
53
+ `--svadmin-col-xl-start:${safeStart(xlOffset ?? lgOffset ?? mdOffset ?? smOffset ?? xsOffset ?? offset)}`,
50
54
  ].filter(Boolean).join(';'));
51
55
  </script>
52
56
 
@@ -2,6 +2,8 @@ import type { Snippet } from 'svelte';
2
2
  interface Props {
3
3
  span?: number;
4
4
  offset?: number;
5
+ xs?: number;
6
+ xsOffset?: number;
5
7
  sm?: number;
6
8
  smOffset?: number;
7
9
  md?: number;
@@ -4,16 +4,23 @@
4
4
  import { cn } from '../utils.js';
5
5
 
6
6
  export interface CollapseItem {
7
- id: string;
8
- title: string;
7
+ id?: string | number;
8
+ key?: string | number;
9
+ name?: string | number;
10
+ title?: string;
11
+ header?: string;
9
12
  description?: string;
13
+ extra?: Snippet;
10
14
  content: Snippet;
11
15
  disabled?: boolean;
16
+ [key: string]: unknown;
12
17
  }
13
18
 
14
19
  interface Props {
15
20
  items: CollapseItem[];
16
- openIds?: string[];
21
+ openIds?: (string | number)[];
22
+ activeKey?: string | number | (string | number)[];
23
+ defaultActiveKey?: string | number | (string | number)[];
17
24
  /** 是否允许多个面板同时展开;accordion 仍优先。 */
18
25
  multiple?: boolean;
19
26
  accordion?: boolean;
@@ -32,12 +39,18 @@
32
39
  /** 自定义展开图标,替代默认 ChevronDown。 */
33
40
  expandIcon?: Snippet;
34
41
  class?: string;
35
- onchange?: (openIds: string[]) => void;
42
+ onchange?: (openIds: (string | number)[]) => void;
43
+ onChange?: (openIds: (string | number)[]) => void;
36
44
  }
37
45
 
46
+ const toArray = (v: unknown): (string | number)[] =>
47
+ Array.isArray(v) ? v : (v !== undefined && v !== null ? [v as string | number] : []);
48
+
38
49
  let {
39
50
  items,
40
51
  openIds = $bindable([]),
52
+ activeKey,
53
+ defaultActiveKey,
41
54
  multiple = true,
42
55
  accordion = false,
43
56
  bordered = true,
@@ -49,31 +62,59 @@
49
62
  expandIcon,
50
63
  class: className = '',
51
64
  onchange,
65
+ onChange,
52
66
  }: Props = $props();
53
67
 
68
+ let initialized = false;
69
+ $effect.pre(() => {
70
+ if (!initialized) {
71
+ initialized = true;
72
+ if (activeKey !== undefined) {
73
+ openIds = toArray(activeKey);
74
+ } else if (defaultActiveKey !== undefined && openIds.length === 0) {
75
+ openIds = toArray(defaultActiveKey);
76
+ }
77
+ } else if (activeKey !== undefined) {
78
+ openIds = toArray(activeKey);
79
+ }
80
+ });
81
+
82
+ const normalizedItems = $derived(
83
+ items.map((item, index) => {
84
+ const id = String(item.id ?? item.key ?? item.name ?? index);
85
+ const title = item.title ?? item.header ?? '';
86
+ return {
87
+ ...item,
88
+ id,
89
+ title,
90
+ };
91
+ })
92
+ );
93
+
54
94
  // 记录已经展开过的面板,供 lazyload 判断“首次展开后才挂载”。
55
- let openedIds = $state<string[]>([]);
95
+ let openedIds = $state<(string | number)[]>([]);
56
96
  $effect(() => {
57
97
  const unseen = openIds.filter((id) => !openedIds.includes(id));
58
98
  if (unseen.length) openedIds = [...openedIds, ...unseen];
59
99
  });
60
100
 
61
- function shouldMount(item: CollapseItem, open: boolean): boolean {
101
+ function shouldMount(item: { id: string | number }, open: boolean): boolean {
62
102
  if (open) return true;
63
103
  if (destroyOnHide) return false;
64
104
  if (lazyload && !openedIds.includes(item.id)) return false;
65
105
  return true;
66
106
  }
67
107
 
68
- function toggle(id: string, disabled = false): void {
108
+ function toggle(id: string | number, disabled = false): void {
69
109
  if (disabled) return;
70
110
  const isOpen = openIds.includes(id);
71
- let next: string[];
111
+ let next: (string | number)[];
72
112
  if (isOpen) next = openIds.filter((value) => value !== id);
73
113
  else if (!multiple || accordion) next = [id];
74
114
  else next = [...openIds, id];
75
115
  openIds = next;
76
116
  onchange?.(next);
117
+ onChange?.(next);
77
118
  }
78
119
  </script>
79
120
 
@@ -83,7 +124,7 @@
83
124
  data-expand-icon-position={expandIconPosition}
84
125
  data-size={size}
85
126
  >
86
- {#each items as item (item.id)}
127
+ {#each normalizedItems as item (item.id)}
87
128
  {@const open = openIds.includes(item.id)}
88
129
  <section class="svadmin-collapse__item" data-state={open ? 'open' : 'closed'}>
89
130
  <button
@@ -103,6 +144,16 @@
103
144
  <strong>{item.title}</strong>
104
145
  {#if item.description}<small>{item.description}</small>{/if}
105
146
  </span>
147
+ {#if item.extra}
148
+ <span
149
+ class="svadmin-collapse__extra"
150
+ role="presentation"
151
+ onclick={(e) => e.stopPropagation()}
152
+ onkeydown={(e) => e.stopPropagation()}
153
+ >
154
+ {@render item.extra()}
155
+ </span>
156
+ {/if}
106
157
  {#if showExpandIcon && expandIconPosition === 'right'}
107
158
  <span class="svadmin-collapse__icon" aria-hidden="true">
108
159
  {#if expandIcon}{@render expandIcon()}{:else}<ChevronDown class="svadmin-collapse__chevron" size={16} />{/if}
@@ -159,6 +210,13 @@
159
210
  .svadmin-collapse__label strong { font-size: var(--svadmin-text-body); font-weight: 400; }
160
211
  .svadmin-collapse__trigger[aria-expanded='true'] .svadmin-collapse__label strong { font-weight: 500; }
161
212
  .svadmin-collapse__label small { color: var(--muted-foreground); font-size: var(--svadmin-text-caption); }
213
+ .svadmin-collapse__extra {
214
+ display: inline-flex;
215
+ align-items: center;
216
+ margin-inline-end: var(--svadmin-space-2, 0.5rem);
217
+ color: var(--muted-foreground);
218
+ font-size: var(--svadmin-text-caption, 0.75rem);
219
+ }
162
220
  .svadmin-collapse__icon { display: inline-flex; flex: 0 0 auto; color: var(--muted-foreground); transition: transform var(--svadmin-motion-fast) var(--svadmin-motion-easing); }
163
221
  .svadmin-collapse__trigger.is-open .svadmin-collapse__icon { transform: rotate(180deg); }
164
222
  .svadmin-collapse__trigger:disabled { cursor: not-allowed; opacity: 1; color: var(--svadmin-text-4); }
@@ -1,14 +1,21 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  export interface CollapseItem {
3
- id: string;
4
- title: string;
3
+ id?: string | number;
4
+ key?: string | number;
5
+ name?: string | number;
6
+ title?: string;
7
+ header?: string;
5
8
  description?: string;
9
+ extra?: Snippet;
6
10
  content: Snippet;
7
11
  disabled?: boolean;
12
+ [key: string]: unknown;
8
13
  }
9
14
  interface Props {
10
15
  items: CollapseItem[];
11
- openIds?: string[];
16
+ openIds?: (string | number)[];
17
+ activeKey?: string | number | (string | number)[];
18
+ defaultActiveKey?: string | number | (string | number)[];
12
19
  /** 是否允许多个面板同时展开;accordion 仍优先。 */
13
20
  multiple?: boolean;
14
21
  accordion?: boolean;
@@ -27,7 +34,8 @@ interface Props {
27
34
  /** 自定义展开图标,替代默认 ChevronDown。 */
28
35
  expandIcon?: Snippet;
29
36
  class?: string;
30
- onchange?: (openIds: string[]) => void;
37
+ onchange?: (openIds: (string | number)[]) => void;
38
+ onChange?: (openIds: (string | number)[]) => void;
31
39
  }
32
40
  declare const Collapse: import("svelte").Component<Props, {}, "openIds">;
33
41
  type Collapse = ReturnType<typeof Collapse>;