@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
@@ -1,9 +1,11 @@
1
1
  <script lang="ts">
2
+ import { untrack } from 'svelte';
2
3
  import { X, CircleX } from '@lucide/svelte';
3
4
  import { cn } from '../utils.js';
4
5
 
5
6
  interface Props {
6
7
  value?: string[] | undefined;
8
+ defaultValue?: string[] | undefined;
7
9
  name?: string | undefined;
8
10
  placeholder?: string | undefined;
9
11
  separator?: string | undefined;
@@ -11,6 +13,9 @@
11
13
  maxTagCount?: number | undefined;
12
14
  allowClear?: boolean | undefined;
13
15
  disabled?: boolean | undefined;
16
+ readonly?: boolean | undefined;
17
+ size?: 'mini' | 'small' | 'default' | 'large' | undefined;
18
+ status?: 'error' | 'warning' | 'normal' | undefined;
14
19
  required?: boolean | undefined;
15
20
  invalid?: boolean | undefined;
16
21
  describedby?: string | undefined;
@@ -20,7 +25,8 @@
20
25
  }
21
26
 
22
27
  let {
23
- value = $bindable([]),
28
+ value = $bindable(),
29
+ defaultValue = [],
24
30
  name,
25
31
  placeholder = 'Add a tag',
26
32
  separator = ',',
@@ -28,6 +34,9 @@
28
34
  maxTagCount,
29
35
  allowClear = false,
30
36
  disabled = false,
37
+ readonly = false,
38
+ size = 'default',
39
+ status = 'normal',
31
40
  required = false,
32
41
  invalid = false,
33
42
  describedby,
@@ -36,10 +45,14 @@
36
45
  onchange,
37
46
  }: Props = $props();
38
47
 
48
+ let internalValue = $state(untrack(() => defaultValue));
49
+ const effectiveValue = $derived(value !== undefined ? value : internalValue);
50
+ const isInteractiveDisabled = $derived(disabled || readonly);
51
+
39
52
  let draft = $state('');
40
53
  let composing = $state(false);
41
- const displayedTags = $derived(maxTagCount !== undefined && maxTagCount >= 0 ? value.slice(0, maxTagCount) : value);
42
- const overflowCount = $derived(maxTagCount !== undefined && maxTagCount >= 0 ? Math.max(0, value.length - maxTagCount) : 0);
54
+ const displayedTags = $derived(maxTagCount !== undefined && maxTagCount >= 0 ? effectiveValue.slice(0, maxTagCount) : effectiveValue);
55
+ const overflowCount = $derived(maxTagCount !== undefined && maxTagCount >= 0 ? Math.max(0, effectiveValue.length - maxTagCount) : 0);
43
56
 
44
57
  function normalized(values: readonly string[]): string[] {
45
58
  return [...new Set(values.map(item => item.trim()).filter(Boolean))];
@@ -47,48 +60,55 @@
47
60
 
48
61
  function update(next: string[]): void {
49
62
  const result = normalized(next);
50
- value = result;
63
+ if (value !== undefined) {
64
+ value = result;
65
+ } else {
66
+ internalValue = result;
67
+ }
51
68
  onchange?.(result);
52
69
  }
53
70
 
54
71
  function add(raw: string): void {
55
- if (disabled) return;
72
+ if (isInteractiveDisabled) return;
56
73
  const candidates = raw.split(separator).map(item => item.trim()).filter(Boolean);
57
74
  if (candidates.length === 0) return;
58
- const available = maxItems === undefined ? candidates : candidates.slice(0, Math.max(0, maxItems - value.length));
59
- update([...value, ...available]);
75
+ const available = maxItems === undefined ? candidates : candidates.slice(0, Math.max(0, maxItems - effectiveValue.length));
76
+ update([...effectiveValue, ...available]);
60
77
  draft = '';
61
78
  }
62
79
 
63
80
  function clearAll(): void {
64
- if (disabled) return;
81
+ if (isInteractiveDisabled) return;
65
82
  update([]);
66
83
  }
67
84
 
68
85
  function remove(index: number): void {
69
- if (disabled) return;
70
- update(value.filter((_, itemIndex) => itemIndex !== index));
86
+ if (isInteractiveDisabled) return;
87
+ update(effectiveValue.filter((_, itemIndex) => itemIndex !== index));
71
88
  }
72
89
 
73
90
  function handleKeydown(event: KeyboardEvent): void {
74
- if (disabled || composing) return;
91
+ if (isInteractiveDisabled || composing) return;
75
92
  if (event.key === 'Enter' || event.key === separator) {
76
93
  event.preventDefault();
77
94
  add(draft);
78
- } else if (event.key === 'Backspace' && draft === '' && value.length > 0) {
95
+ } else if (event.key === 'Backspace' && draft === '' && effectiveValue.length > 0) {
79
96
  event.preventDefault();
80
- remove(value.length - 1);
97
+ remove(effectiveValue.length - 1);
81
98
  }
82
99
  }
83
100
  </script>
84
101
 
85
102
  <div
86
103
  class={cn('svadmin-tags-input', className)}
87
- data-invalid={invalid ? 'true' : undefined}
104
+ data-invalid={invalid || status === 'error' ? 'true' : undefined}
105
+ data-status={status !== 'normal' ? status : undefined}
106
+ data-size={size !== 'default' ? size : undefined}
88
107
  data-disabled={disabled ? 'true' : undefined}
108
+ data-readonly={readonly ? 'true' : undefined}
89
109
  >
90
110
  {#if name}
91
- {#each value as tag (tag)}
111
+ {#each effectiveValue as tag (tag)}
92
112
  <input type="hidden" {name} value={tag} {disabled} />
93
113
  {/each}
94
114
  {/if}
@@ -98,7 +118,7 @@
98
118
  <button
99
119
  type="button"
100
120
  aria-label={`Remove ${tag}`}
101
- disabled={disabled}
121
+ disabled={isInteractiveDisabled}
102
122
  onclick={() => remove(index)}
103
123
  >
104
124
  <X size={12} aria-hidden="true" />
@@ -106,24 +126,25 @@
106
126
  </span>
107
127
  {/each}
108
128
  {#if overflowCount > 0}
109
- <span class="svadmin-tags-input__tag svadmin-tags-input__tag--overflow" title={value.slice(maxTagCount).join(", ")}>
129
+ <span class="svadmin-tags-input__tag svadmin-tags-input__tag--overflow" title={effectiveValue.slice(maxTagCount).join(", ")}>
110
130
  <span>+{overflowCount}</span>
111
131
  </span>
112
132
  {/if}
113
133
  <input
114
134
  value={draft}
115
135
  {placeholder}
116
- disabled={disabled || (maxItems !== undefined && value.length >= maxItems)}
117
- required={required && value.length === 0}
136
+ disabled={disabled || (maxItems !== undefined && effectiveValue.length >= maxItems)}
137
+ readonly={readonly}
138
+ required={required && effectiveValue.length === 0}
118
139
  aria-label={ariaLabel}
119
- aria-invalid={invalid || undefined}
140
+ aria-invalid={invalid || status === 'error' || undefined}
120
141
  aria-describedby={describedby}
121
142
  oninput={(event) => { draft = (event.currentTarget as HTMLInputElement).value; }}
122
143
  onkeydown={handleKeydown}
123
144
  oncompositionstart={() => { composing = true; }}
124
145
  oncompositionend={(event) => { composing = false; draft = (event.currentTarget as HTMLInputElement).value; }}
125
146
  />
126
- {#if allowClear && value.length > 0 && !disabled}
147
+ {#if allowClear && effectiveValue.length > 0 && !isInteractiveDisabled}
127
148
  <button
128
149
  type="button"
129
150
  class="svadmin-tags-input__clear"
@@ -1,5 +1,6 @@
1
1
  interface Props {
2
2
  value?: string[] | undefined;
3
+ defaultValue?: string[] | undefined;
3
4
  name?: string | undefined;
4
5
  placeholder?: string | undefined;
5
6
  separator?: string | undefined;
@@ -7,6 +8,9 @@ interface Props {
7
8
  maxTagCount?: number | undefined;
8
9
  allowClear?: boolean | undefined;
9
10
  disabled?: boolean | undefined;
11
+ readonly?: boolean | undefined;
12
+ size?: 'mini' | 'small' | 'default' | 'large' | undefined;
13
+ status?: 'error' | 'warning' | 'normal' | undefined;
10
14
  required?: boolean | undefined;
11
15
  invalid?: boolean | undefined;
12
16
  describedby?: string | undefined;
@@ -1,5 +1,6 @@
1
1
  <script lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
+ import { Loader2 } from '@lucide/svelte';
3
4
  import { cn } from '../utils.js';
4
5
 
5
6
  export interface TimelineEntry {
@@ -7,16 +8,28 @@
7
8
  title: string;
8
9
  description?: string;
9
10
  time?: string;
11
+ /** `time` 的别名,便于宿主沿用列表式字段名。 */
12
+ label?: string;
10
13
  tone?: 'neutral' | 'info' | 'success' | 'warning' | 'danger';
11
14
  active?: boolean;
12
15
  dot?: Snippet;
16
+ /** 单个节点自定义颜色,写入 `--timeline-dot-color`。 */
17
+ dotColor?: string;
18
+ /** 单个节点连线样式与颜色;未设置时回落到列表级设置。 */
19
+ lineType?: 'solid' | 'dashed' | 'dotted';
20
+ lineColor?: string;
13
21
  }
14
22
 
15
23
  interface Props {
16
24
  items: TimelineEntry[];
17
- mode?: 'vertical' | 'horizontal' | 'alternate';
25
+ mode?: 'vertical' | 'horizontal' | 'alternate' | 'right';
26
+ direction?: 'horizontal' | 'vertical';
18
27
  reverse?: boolean;
28
+ pending?: boolean | string | Snippet;
29
+ pendingDot?: Snippet;
19
30
  label?: string;
31
+ /** 列表级连线样式,节点可用 `lineType` 覆盖。 */
32
+ lineType?: 'solid' | 'dashed' | 'dotted';
20
33
  class?: string;
21
34
  dot?: Snippet<[TimelineEntry]>;
22
35
  children?: Snippet<[TimelineEntry]>;
@@ -25,17 +38,34 @@
25
38
  let {
26
39
  items,
27
40
  mode = 'vertical',
41
+ direction,
28
42
  reverse = false,
43
+ pending,
44
+ pendingDot,
29
45
  label = 'Timeline',
46
+ lineType = 'solid',
30
47
  class: className = '',
31
48
  dot,
32
49
  children,
33
50
  }: Props = $props();
34
51
 
52
+ const effectiveMode = $derived(
53
+ direction === 'horizontal' ? 'horizontal' : mode
54
+ );
35
55
  const displayItems = $derived(reverse ? [...items].reverse() : items);
56
+ const LINE_STYLES = new Set(['solid', 'dashed', 'dotted']);
57
+
58
+ function itemStyle(item: TimelineEntry): string | undefined {
59
+ const declarations: string[] = [];
60
+ if (item.dotColor) declarations.push(`--timeline-dot-color: ${item.dotColor}`);
61
+ const style = item.lineType && LINE_STYLES.has(item.lineType) ? item.lineType : lineType;
62
+ declarations.push(`--timeline-item-line-style: ${style}`);
63
+ if (item.lineColor) declarations.push(`--timeline-item-line-color: ${item.lineColor}`);
64
+ return declarations.join('; ');
65
+ }
36
66
  </script>
37
67
 
38
- <ol class={cn('svadmin-timeline', className)} data-mode={mode} aria-label={label}>
68
+ <ol class={cn('svadmin-timeline', className)} data-mode={effectiveMode} aria-label={label}>
39
69
  {#each displayItems as item, index (item.id)}
40
70
  {@const side = mode === 'alternate' ? (index % 2 === 0 ? 'left' : 'right') : undefined}
41
71
  <li
@@ -43,6 +73,7 @@
43
73
  data-tone={item.tone ?? 'neutral'}
44
74
  data-active={item.active ? 'true' : undefined}
45
75
  data-side={side}
76
+ style={itemStyle(item)}
46
77
  >
47
78
  {#if item.dot}
48
79
  <span class="svadmin-timeline__custom-dot" aria-hidden="true">{@render item.dot()}</span>
@@ -55,13 +86,33 @@
55
86
  {#if children}
56
87
  {@render children(item)}
57
88
  {:else}
58
- {#if item.time}<time class="svadmin-timeline__time">{item.time}</time>{/if}
89
+ {#if item.time ?? item.label}<time class="svadmin-timeline__time">{item.time ?? item.label}</time>{/if}
59
90
  <p class="svadmin-timeline__title">{item.title}</p>
60
91
  {#if item.description}<p class="svadmin-timeline__description">{item.description}</p>{/if}
61
92
  {/if}
62
93
  </div>
63
94
  </li>
64
95
  {/each}
96
+ {#if pending}
97
+ <li class="svadmin-timeline__item" data-pending="true">
98
+ <span class="svadmin-timeline__custom-dot" aria-hidden="true">
99
+ {#if pendingDot}
100
+ {@render pendingDot()}
101
+ {:else}
102
+ <Loader2 class="size-3.5 animate-spin text-primary" />
103
+ {/if}
104
+ </span>
105
+ <div class="svadmin-timeline__content">
106
+ {#if typeof pending === 'string'}
107
+ <p class="svadmin-timeline__title">{pending}</p>
108
+ {:else if typeof pending === 'boolean'}
109
+ <p class="svadmin-timeline__title text-muted-foreground">...</p>
110
+ {:else}
111
+ {@render (pending as Snippet)()}
112
+ {/if}
113
+ </div>
114
+ </li>
115
+ {/if}
65
116
  </ol>
66
117
 
67
118
  <style>
@@ -4,15 +4,27 @@ export interface TimelineEntry {
4
4
  title: string;
5
5
  description?: string;
6
6
  time?: string;
7
+ /** `time` 的别名,便于宿主沿用列表式字段名。 */
8
+ label?: string;
7
9
  tone?: 'neutral' | 'info' | 'success' | 'warning' | 'danger';
8
10
  active?: boolean;
9
11
  dot?: Snippet;
12
+ /** 单个节点自定义颜色,写入 `--timeline-dot-color`。 */
13
+ dotColor?: string;
14
+ /** 单个节点连线样式与颜色;未设置时回落到列表级设置。 */
15
+ lineType?: 'solid' | 'dashed' | 'dotted';
16
+ lineColor?: string;
10
17
  }
11
18
  interface Props {
12
19
  items: TimelineEntry[];
13
- mode?: 'vertical' | 'horizontal' | 'alternate';
20
+ mode?: 'vertical' | 'horizontal' | 'alternate' | 'right';
21
+ direction?: 'horizontal' | 'vertical';
14
22
  reverse?: boolean;
23
+ pending?: boolean | string | Snippet;
24
+ pendingDot?: Snippet;
15
25
  label?: string;
26
+ /** 列表级连线样式,节点可用 `lineType` 覆盖。 */
27
+ lineType?: 'solid' | 'dashed' | 'dotted';
16
28
  class?: string;
17
29
  dot?: Snippet<[TimelineEntry]>;
18
30
  children?: Snippet<[TimelineEntry]>;
@@ -1,10 +1,11 @@
1
1
  <script lang="ts">
2
2
  import * as Tooltip from './ui/tooltip/index.js';
3
3
  import { Button } from './ui/button/index.js';
4
+ import type { ButtonProps } from './ui/button/index.js';
4
5
  import type { Snippet } from 'svelte';
5
6
  import type { HTMLButtonAttributes } from 'svelte/elements';
6
7
 
7
- interface Props extends Omit<HTMLButtonAttributes, 'class' | 'children'> {
8
+ interface Props extends Omit<HTMLButtonAttributes, 'class' | 'children' | 'type'> {
8
9
  tooltip: string;
9
10
  href?: string;
10
11
  target?: string;
@@ -12,8 +13,10 @@
12
13
  variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
13
14
  size?: 'default' | 'sm' | 'lg' | 'icon' | 'icon-sm';
14
15
  side?: 'top' | 'right' | 'bottom' | 'left';
16
+ color?: string;
15
17
  class?: string;
16
18
  onclick?: (e: MouseEvent) => void;
19
+ type?: ButtonProps['type'];
17
20
  children: Snippet;
18
21
  }
19
22
 
@@ -22,6 +25,7 @@
22
25
  variant = 'ghost',
23
26
  size = 'icon',
24
27
  side = 'top',
28
+ color,
25
29
  class: className = '',
26
30
  onclick,
27
31
  disabled = false,
@@ -60,11 +64,11 @@
60
64
  <Tooltip.Trigger aria-describedby={restProps['aria-describedby']}>
61
65
  {#snippet child({ props })}
62
66
  {@const primitiveOnclick = props['onclick'] as ((event: MouseEvent) => void) | undefined}
63
- {@const buttonProps = { ...mergeButtonProps(props), href, target, rel, variant, size, type, class: className, 'aria-label': typeof restProps['aria-label'] === 'string' ? restProps['aria-label'] : tooltip, 'aria-describedby': typeof props['aria-describedby'] === 'string' ? props['aria-describedby'] : undefined, onclick: (event: MouseEvent) => handleClick(event, primitiveOnclick), disabled, tabindex }}
67
+ {@const buttonProps = { ...mergeButtonProps(props), href, target, rel, variant, size, type: type ?? 'button', class: className, 'aria-label': typeof restProps['aria-label'] === 'string' ? restProps['aria-label'] : tooltip, 'aria-describedby': typeof props['aria-describedby'] === 'string' ? props['aria-describedby'] : undefined, onclick: (event: MouseEvent) => handleClick(event, primitiveOnclick), disabled, tabindex }}
64
68
  <Button {...buttonProps}>
65
69
  {@render children()}
66
70
  </Button>
67
71
  {/snippet}
68
72
  </Tooltip.Trigger>
69
- <Tooltip.Content {side}>{tooltip}</Tooltip.Content>
73
+ <Tooltip.Content {side} {...(color === undefined ? {} : { color })}>{tooltip}</Tooltip.Content>
70
74
  </Tooltip.Root>
@@ -1,6 +1,7 @@
1
+ import type { ButtonProps } from './ui/button/index.js';
1
2
  import type { Snippet } from 'svelte';
2
3
  import type { HTMLButtonAttributes } from 'svelte/elements';
3
- interface Props extends Omit<HTMLButtonAttributes, 'class' | 'children'> {
4
+ interface Props extends Omit<HTMLButtonAttributes, 'class' | 'children' | 'type'> {
4
5
  tooltip: string;
5
6
  href?: string;
6
7
  target?: string;
@@ -8,8 +9,10 @@ interface Props extends Omit<HTMLButtonAttributes, 'class' | 'children'> {
8
9
  variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
9
10
  size?: 'default' | 'sm' | 'lg' | 'icon' | 'icon-sm';
10
11
  side?: 'top' | 'right' | 'bottom' | 'left';
12
+ color?: string;
11
13
  class?: string;
12
14
  onclick?: (e: MouseEvent) => void;
15
+ type?: ButtonProps['type'];
13
16
  children: Snippet;
14
17
  }
15
18
  declare const TooltipButton: import("svelte").Component<Props, {}, "">;
@@ -13,14 +13,21 @@
13
13
  interface Props {
14
14
  steps: TourStep[];
15
15
  open?: boolean;
16
+ visible?: boolean;
17
+ defaultVisible?: boolean;
16
18
  current?: number;
19
+ defaultCurrent?: number;
20
+ mask?: boolean;
17
21
  title?: string;
18
22
  nextText?: string;
19
23
  previousText?: string;
20
24
  finishText?: string;
21
25
  skipText?: string;
26
+ onFinish?: () => void;
22
27
  onfinish?: () => void;
28
+ onClose?: () => void;
23
29
  onclose?: () => void;
30
+ onChange?: (index: number) => void;
24
31
  onstepchange?: (index: number) => void;
25
32
  storageKey?: string;
26
33
  class?: string;
@@ -30,20 +37,61 @@
30
37
  let {
31
38
  steps,
32
39
  open = $bindable(false),
40
+ visible,
41
+ defaultVisible,
33
42
  current = $bindable(0),
43
+ defaultCurrent,
44
+ mask = true,
34
45
  title = 'Guided tour',
35
46
  nextText = 'Next',
36
47
  previousText = 'Back',
37
48
  finishText = 'Done',
38
49
  skipText = 'Skip',
39
50
  storageKey,
51
+ onFinish,
40
52
  onfinish,
53
+ onClose,
41
54
  onclose,
55
+ onChange,
42
56
  onstepchange,
43
57
  class: className = '',
44
58
  children,
45
59
  }: Props = $props();
46
60
 
61
+ const emitStepChange = (index: number): void => {
62
+ onstepchange?.(index);
63
+ onChange?.(index);
64
+ };
65
+ const emitClose = (): void => {
66
+ onclose?.();
67
+ onClose?.();
68
+ };
69
+ const emitFinish = (): void => {
70
+ onfinish?.();
71
+ onFinish?.();
72
+ };
73
+
74
+ let initialized = false;
75
+ $effect.pre(() => {
76
+ if (!initialized) {
77
+ initialized = true;
78
+ if (visible !== undefined) {
79
+ open = visible;
80
+ } else if (defaultVisible !== undefined) {
81
+ open = defaultVisible;
82
+ }
83
+ if (defaultCurrent !== undefined && current === 0) {
84
+ current = defaultCurrent;
85
+ }
86
+ }
87
+ });
88
+
89
+ $effect(() => {
90
+ if (visible !== undefined && open !== visible) {
91
+ open = visible;
92
+ }
93
+ });
94
+
47
95
  let panel = $state<HTMLElement | null>(null);
48
96
  let rect = $state<{ top: number; left: number; width: number; height: number } | null>(null);
49
97
  const maskId = `svadmin-tour-mask-${Math.random().toString(36).slice(2, 8)}`;
@@ -95,14 +143,14 @@
95
143
  try { localStorage.setItem(storageKey, 'true'); } catch { /* ignore */ }
96
144
  }
97
145
  open = false;
98
- onclose?.();
146
+ emitClose();
99
147
  }
100
148
 
101
149
  function move(delta: number): void {
102
150
  const next = Math.max(0, Math.min(current + delta, steps.length - 1));
103
151
  if (next === current) return;
104
152
  current = next;
105
- onstepchange?.(next);
153
+ emitStepChange(next);
106
154
  }
107
155
 
108
156
  function finish(): void {
@@ -110,7 +158,7 @@
110
158
  try { localStorage.setItem(storageKey, 'true'); } catch { /* ignore */ }
111
159
  }
112
160
  open = false;
113
- onfinish?.();
161
+ emitFinish();
114
162
  }
115
163
 
116
164
  function onKeydown(event: KeyboardEvent): void {
@@ -179,12 +227,14 @@
179
227
  </script>
180
228
 
181
229
  {#if open}
182
- <div data-svadmin-component="TourGuide" data-targeted={rect ? 'true' : 'false'} class={cn('svadmin-tour', className)}>
230
+ <div data-svadmin-component="TourGuide" data-targeted={rect ? 'true' : 'false'} data-mask={mask} class={cn('svadmin-tour', className)}>
183
231
  <!-- Background dismissal trigger to block click-through -->
184
- <button type="button" tabindex="-1" class="svadmin-tour__dismiss" aria-label={skipText} onclick={close}></button>
232
+ {#if mask}
233
+ <button type="button" tabindex="-1" class="svadmin-tour__dismiss" aria-label={skipText} onclick={close}></button>
234
+ {/if}
185
235
 
186
236
  <!-- Pure SVG Viewport Cutout Mask for Target Element Spotlight -->
187
- {#if rect}
237
+ {#if mask && rect}
188
238
  <svg class="svadmin-tour__svg-mask fixed inset-0 w-full h-full pointer-events-none z-[61]" aria-hidden="true">
189
239
  <defs>
190
240
  <mask id={maskId}>
@@ -8,14 +8,21 @@ export interface TourStep {
8
8
  interface Props {
9
9
  steps: TourStep[];
10
10
  open?: boolean;
11
+ visible?: boolean;
12
+ defaultVisible?: boolean;
11
13
  current?: number;
14
+ defaultCurrent?: number;
15
+ mask?: boolean;
12
16
  title?: string;
13
17
  nextText?: string;
14
18
  previousText?: string;
15
19
  finishText?: string;
16
20
  skipText?: string;
21
+ onFinish?: () => void;
17
22
  onfinish?: () => void;
23
+ onClose?: () => void;
18
24
  onclose?: () => void;
25
+ onChange?: (index: number) => void;
19
26
  onstepchange?: (index: number) => void;
20
27
  storageKey?: string;
21
28
  class?: string;