@svadmin/ui 0.120.0 → 0.122.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 (125) hide show
  1. package/dist/app.css +336 -7
  2. package/dist/app.theme.css +336 -7
  3. package/dist/components/AboutSettings.svelte +1 -1
  4. package/dist/components/AnnouncementBanner.svelte +314 -0
  5. package/dist/components/AnnouncementBanner.svelte.d.ts +45 -0
  6. package/dist/components/AsyncExportModal.svelte +551 -0
  7. package/dist/components/AsyncExportModal.svelte.d.ts +50 -0
  8. package/dist/components/AudioFeedbackProvider.svelte +131 -0
  9. package/dist/components/AudioFeedbackProvider.svelte.d.ts +11 -0
  10. package/dist/components/AuditLogViewer.svelte +1 -1
  11. package/dist/components/CanvasAnnotation.svelte +1 -1
  12. package/dist/components/ColumnFilterBuilder.svelte +135 -0
  13. package/dist/components/ColumnFilterBuilder.svelte.d.ts +20 -0
  14. package/dist/components/ColumnSettings.svelte +1 -1
  15. package/dist/components/ColumnVisibilityDrawer.svelte +541 -0
  16. package/dist/components/ColumnVisibilityDrawer.svelte.d.ts +16 -0
  17. package/dist/components/ConcurrentConflictModal.svelte +7 -7
  18. package/dist/components/ContextMenu.svelte +268 -0
  19. package/dist/components/ContextMenu.svelte.d.ts +22 -0
  20. package/dist/components/ConversionFunnel.svelte +154 -0
  21. package/dist/components/ConversionFunnel.svelte.d.ts +22 -0
  22. package/dist/components/CronExpressionBuilder.svelte +1 -1
  23. package/dist/components/DecisionTable.svelte +1 -1
  24. package/dist/components/DevTools.svelte +1 -1
  25. package/dist/components/DraggableRowTable.svelte +1 -1
  26. package/dist/components/DualApprovalGate.svelte +418 -0
  27. package/dist/components/DualApprovalGate.svelte.d.ts +39 -0
  28. package/dist/components/EditableTable.svelte +1 -1
  29. package/dist/components/ExcelImportWizard.svelte +2 -2
  30. package/dist/components/GlobalShortcuts.svelte +1 -1
  31. package/dist/components/ImageCropper.svelte +1 -1
  32. package/dist/components/ImportWizard.svelte +1 -1
  33. package/dist/components/JsonSchemaForm.svelte +1 -1
  34. package/dist/components/JsonViewer.svelte +323 -0
  35. package/dist/components/JsonViewer.svelte.d.ts +20 -0
  36. package/dist/components/KeyboardShortcutsModal.svelte +362 -0
  37. package/dist/components/KeyboardShortcutsModal.svelte.d.ts +22 -0
  38. package/dist/components/KpiCard.svelte +250 -0
  39. package/dist/components/KpiCard.svelte.d.ts +44 -0
  40. package/dist/components/MasterDetailView.svelte +1 -1
  41. package/dist/components/MetricGrid.svelte +2 -2
  42. package/dist/components/MicroAppBridge.svelte +59 -0
  43. package/dist/components/MicroAppBridge.svelte.d.ts +11 -0
  44. package/dist/components/OfflineSyncBanner.svelte +1 -1
  45. package/dist/components/OrgChart.svelte +1 -1
  46. package/dist/components/OrgTreePicker.svelte +1 -1
  47. package/dist/components/OtpInput.svelte +209 -0
  48. package/dist/components/OtpInput.svelte.d.ts +17 -0
  49. package/dist/components/PdfDocumentViewer.svelte +2 -2
  50. package/dist/components/PivotDrilldownModal.svelte +6 -6
  51. package/dist/components/PivotTable.svelte +1 -1
  52. package/dist/components/PricingCard.svelte +1 -1
  53. package/dist/components/PricingTable.svelte +1 -1
  54. package/dist/components/PrintableBill.svelte +2 -2
  55. package/dist/components/PrintableReportLayout.svelte +259 -0
  56. package/dist/components/PrintableReportLayout.svelte.d.ts +32 -0
  57. package/dist/components/ProSkeleton.svelte +6 -6
  58. package/dist/components/RecordCompareModal.svelte +428 -0
  59. package/dist/components/RecordCompareModal.svelte.d.ts +42 -0
  60. package/dist/components/ResultPage.svelte +166 -0
  61. package/dist/components/ResultPage.svelte.d.ts +28 -0
  62. package/dist/components/SafeDeleteConfirm.svelte +5 -5
  63. package/dist/components/SankeyChart.svelte +111 -0
  64. package/dist/components/SankeyChart.svelte.d.ts +22 -0
  65. package/dist/components/SchemaVisualModeler.svelte +336 -0
  66. package/dist/components/SchemaVisualModeler.svelte.d.ts +17 -0
  67. package/dist/components/SensitiveDataMask.svelte +81 -22
  68. package/dist/components/SensitiveDataMask.svelte.d.ts +15 -10
  69. package/dist/components/SessionTimeoutGuard.svelte +154 -0
  70. package/dist/components/SessionTimeoutGuard.svelte.d.ts +25 -0
  71. package/dist/components/SignaturePad.svelte +231 -67
  72. package/dist/components/SignaturePad.svelte.d.ts +6 -5
  73. package/dist/components/SliderCaptcha.svelte +1 -1
  74. package/dist/components/SplitPaneLayout.svelte +1 -1
  75. package/dist/components/SpreadsheetView.svelte +1 -1
  76. package/dist/components/StepForm.svelte +1 -1
  77. package/dist/components/StepWizard.svelte +513 -0
  78. package/dist/components/StepWizard.svelte.d.ts +49 -0
  79. package/dist/components/TableClipboardManager.svelte +307 -0
  80. package/dist/components/TableClipboardManager.svelte.d.ts +13 -0
  81. package/dist/components/TaskCenter.svelte +9 -9
  82. package/dist/components/TextDiffViewer.svelte +613 -0
  83. package/dist/components/TextDiffViewer.svelte.d.ts +39 -0
  84. package/dist/components/Tour.svelte +71 -13
  85. package/dist/components/Tour.svelte.d.ts +1 -1
  86. package/dist/components/TreeTransfer.svelte +1 -1
  87. package/dist/components/TrendIndicator.svelte +21 -13
  88. package/dist/components/TrendIndicator.svelte.d.ts +4 -2
  89. package/dist/components/UnsavedChangesGuard.svelte +138 -0
  90. package/dist/components/UnsavedChangesGuard.svelte.d.ts +32 -0
  91. package/dist/components/UsageCard.svelte +1 -1
  92. package/dist/components/VersionDiffViewer.svelte +1 -1
  93. package/dist/components/VirtualTable.svelte +1 -1
  94. package/dist/components/VirtualTreeSelect.svelte +1 -1
  95. package/dist/components/WatermarkContainer.svelte +196 -0
  96. package/dist/components/WatermarkContainer.svelte.d.ts +20 -0
  97. package/dist/components/WorkflowDesigner.svelte +3 -3
  98. package/dist/components/WorkflowProcessCard.svelte +1 -1
  99. package/dist/components/WorkflowStepper.svelte +250 -0
  100. package/dist/components/WorkflowStepper.svelte.d.ts +27 -0
  101. package/dist/components/charts/GaugeChart.svelte +1 -1
  102. package/dist/components/useAudioAlert.d.svelte.ts +1 -0
  103. package/dist/components/useAudioAlert.svelte.d.ts +13 -0
  104. package/dist/components/useAudioAlert.svelte.js +90 -0
  105. package/dist/components/useHotkeys.d.svelte.ts +1 -0
  106. package/dist/components/useHotkeys.svelte.d.ts +44 -0
  107. package/dist/components/useHotkeys.svelte.js +190 -0
  108. package/dist/components/useMicroAppEvent.d.svelte.ts +1 -0
  109. package/dist/components/useMicroAppEvent.svelte.d.ts +16 -0
  110. package/dist/components/useMicroAppEvent.svelte.js +61 -0
  111. package/dist/components/usePrintExport.d.svelte.ts +1 -0
  112. package/dist/components/usePrintExport.svelte.d.ts +11 -0
  113. package/dist/components/usePrintExport.svelte.js +45 -0
  114. package/dist/components/useSessionTimeout.d.svelte.ts +1 -0
  115. package/dist/components/useSessionTimeout.svelte.d.ts +28 -0
  116. package/dist/components/useSessionTimeout.svelte.js +182 -0
  117. package/dist/components/useTableClipboard.d.svelte.ts +1 -0
  118. package/dist/components/useTableClipboard.svelte.d.ts +28 -0
  119. package/dist/components/useTableClipboard.svelte.js +116 -0
  120. package/dist/components/useUnsavedChanges.d.svelte.ts +1 -0
  121. package/dist/components/useUnsavedChanges.svelte.d.ts +22 -0
  122. package/dist/components/useUnsavedChanges.svelte.js +105 -0
  123. package/dist/index.d.ts +47 -28
  124. package/dist/index.js +49 -2
  125. package/package.json +1 -1
@@ -0,0 +1,513 @@
1
+ <script lang="ts">
2
+ import { untrack, type Component, type Snippet } from 'svelte';
3
+ import {
4
+ AlertCircle,
5
+ Check,
6
+ ChevronLeft,
7
+ ChevronRight,
8
+ Loader2,
9
+ RotateCcw,
10
+ Save,
11
+ X,
12
+ } from '@lucide/svelte';
13
+ import { useTranslation } from '@svadmin/core/i18n';
14
+ import { cn } from '../utils.js';
15
+ import { Button } from './ui/button/index.js';
16
+ import { Progress } from './ui/progress/index.js';
17
+
18
+ export type StepWizardStatus = 'wait' | 'process' | 'finish' | 'error';
19
+
20
+ export interface StepWizardItem {
21
+ id: string;
22
+ title: string;
23
+ description?: string | undefined;
24
+ icon?: Component | undefined;
25
+ status?: StepWizardStatus | undefined;
26
+ disabled?: boolean | undefined;
27
+ /** Dynamic branch predicate: return false to hide this branch step */
28
+ condition?: ((draft: Record<string, unknown>) => boolean) | undefined;
29
+ }
30
+
31
+ export interface StepWizardProps {
32
+ steps: StepWizardItem[];
33
+ currentStep?: number | undefined;
34
+ draft?: Record<string, unknown> | undefined;
35
+ direction?: 'horizontal' | 'vertical' | undefined;
36
+ status?: StepWizardStatus | undefined;
37
+ clickable?: boolean | undefined;
38
+ storageKey?: string | undefined;
39
+ showProgress?: boolean | undefined;
40
+ beforeNext?:
41
+ | ((stepIndex: number, step: StepWizardItem, draft: Record<string, unknown>) => Promise<boolean> | boolean)
42
+ | undefined;
43
+ onStepChange?: ((newStep: number, prevStep: number) => void) | undefined;
44
+ onFinish?: ((draft: Record<string, unknown>) => Promise<void> | void) | undefined;
45
+ onCancel?: (() => void) | undefined;
46
+ onDraftRestore?: ((restored: { currentStep: number; draft: Record<string, unknown> }) => void) | undefined;
47
+ submitText?: string | undefined;
48
+ nextText?: string | undefined;
49
+ prevText?: string | undefined;
50
+ cancelText?: string | undefined;
51
+ isSubmitting?: boolean | undefined;
52
+ class?: string | undefined;
53
+ stepContent?: Snippet<[{ step: StepWizardItem; index: number; draft: Record<string, unknown>; setDraft: (patch: Record<string, unknown>) => void }]> | undefined;
54
+ children?: Snippet | undefined;
55
+ }
56
+
57
+ let {
58
+ steps,
59
+ currentStep = $bindable(0),
60
+ draft = $bindable<Record<string, unknown>>({}),
61
+ direction = 'horizontal',
62
+ status = 'process',
63
+ clickable = true,
64
+ storageKey,
65
+ showProgress = true,
66
+ beforeNext,
67
+ onStepChange,
68
+ onFinish,
69
+ onCancel,
70
+ onDraftRestore,
71
+ submitText,
72
+ nextText,
73
+ prevText,
74
+ cancelText,
75
+ isSubmitting = false,
76
+ class: className = '',
77
+ stepContent,
78
+ children,
79
+ }: StepWizardProps = $props();
80
+
81
+ const i18n = useTranslation();
82
+ const chinese = $derived(i18n.locale.startsWith('zh'));
83
+
84
+ // Filter active steps dynamically based on condition predicates (branching)
85
+ const activeSteps = $derived(
86
+ steps.filter((step) => (step.condition ? step.condition(draft) : true)),
87
+ );
88
+
89
+ let isValidating = $state(false);
90
+ let stepErrorMessage = $state<string | null>(null);
91
+ let erroredStepIndex = $state<number | null>(null);
92
+ let draftRestored = $state(false);
93
+ let hydrated = false;
94
+
95
+ // Clamp currentStep if dynamic branches collapse
96
+ $effect(() => {
97
+ if (activeSteps.length > 0 && currentStep >= activeSteps.length) {
98
+ currentStep = activeSteps.length - 1;
99
+ }
100
+ });
101
+
102
+ // Restore draft from localStorage on mount when storageKey is set
103
+ $effect(() => {
104
+ const key = storageKey;
105
+ if (hydrated || !key || typeof window === 'undefined') return;
106
+ hydrated = true;
107
+ try {
108
+ const raw = window.localStorage.getItem(key);
109
+ if (!raw) return;
110
+ const parsed: unknown = JSON.parse(raw);
111
+ if (!parsed || typeof parsed !== 'object') return;
112
+ const record = parsed as Record<string, unknown>;
113
+ const savedDraft = record['draft'];
114
+ const savedStep = record['currentStep'];
115
+ if (savedDraft && typeof savedDraft === 'object' && !Array.isArray(savedDraft)) {
116
+ draft = { ...untrack(() => draft), ...(savedDraft as Record<string, unknown>) };
117
+ }
118
+ if (typeof savedStep === 'number' && Number.isFinite(savedStep) && savedStep >= 0) {
119
+ currentStep = savedStep;
120
+ }
121
+ draftRestored = true;
122
+ onDraftRestore?.({ currentStep, draft });
123
+ } catch {
124
+ // Ignore malformed draft payload
125
+ }
126
+ });
127
+
128
+ // Persist draft and step automatically when storageKey is configured
129
+ function persistDraft(nextStep: number, nextDraft: Record<string, unknown>) {
130
+ if (!storageKey || typeof window === 'undefined') return;
131
+ try {
132
+ window.localStorage.setItem(
133
+ storageKey,
134
+ JSON.stringify({
135
+ currentStep: nextStep,
136
+ draft: nextDraft,
137
+ updatedAt: new Date().toISOString(),
138
+ }),
139
+ );
140
+ } catch {
141
+ // Storage quota or availability failure
142
+ }
143
+ }
144
+
145
+ $effect(() => {
146
+ const stepSnapshot = currentStep;
147
+ const draftSnapshot = draft;
148
+ if (!storageKey || !hydrated) return;
149
+ persistDraft(stepSnapshot, draftSnapshot);
150
+ });
151
+
152
+ export function clearDraft(): void {
153
+ if (storageKey && typeof window !== 'undefined') {
154
+ try {
155
+ window.localStorage.removeItem(storageKey);
156
+ } catch {
157
+ // Ignore
158
+ }
159
+ }
160
+ draftRestored = false;
161
+ }
162
+
163
+ export function setDraft(patch: Record<string, unknown>): void {
164
+ draft = { ...draft, ...patch };
165
+ }
166
+
167
+ function resolveStepStatus(index: number, item: StepWizardItem): StepWizardStatus {
168
+ if (erroredStepIndex === index) return 'error';
169
+ if (item.status) return item.status;
170
+ if (index < currentStep) return 'finish';
171
+ if (index === currentStep) return status;
172
+ return 'wait';
173
+ }
174
+
175
+ async function goToStep(targetIndex: number) {
176
+ if (isValidating || isSubmitting) return;
177
+ if (targetIndex < 0 || targetIndex >= activeSteps.length) return;
178
+ if (targetIndex === currentStep) return;
179
+
180
+ const targetStep = activeSteps[targetIndex];
181
+ if (!targetStep || targetStep.disabled) return;
182
+
183
+ if (targetIndex > currentStep && beforeNext) {
184
+ const current = activeSteps[currentStep];
185
+ if (current) {
186
+ isValidating = true;
187
+ stepErrorMessage = null;
188
+ erroredStepIndex = null;
189
+ try {
190
+ const ok = await beforeNext(currentStep, current, draft);
191
+ if (!ok) {
192
+ erroredStepIndex = currentStep;
193
+ stepErrorMessage = chinese
194
+ ? `步骤「${current.title}」校验未通过,请检查填写内容`
195
+ : `Validation failed on step "${current.title}"`;
196
+ return;
197
+ }
198
+ } catch (err) {
199
+ erroredStepIndex = currentStep;
200
+ stepErrorMessage =
201
+ err instanceof Error
202
+ ? err.message
203
+ : chinese
204
+ ? '步骤校验异常'
205
+ : 'Step validation error';
206
+ return;
207
+ } finally {
208
+ isValidating = false;
209
+ }
210
+ }
211
+ } else {
212
+ stepErrorMessage = null;
213
+ erroredStepIndex = null;
214
+ }
215
+
216
+ const prev = currentStep;
217
+ currentStep = targetIndex;
218
+ persistDraft(currentStep, draft);
219
+ onStepChange?.(currentStep, prev);
220
+ }
221
+
222
+ async function handleNext() {
223
+ if (isValidating || isSubmitting) return;
224
+ const isLast = currentStep >= activeSteps.length - 1;
225
+ const current = activeSteps[currentStep];
226
+ if (!current) return;
227
+
228
+ if (beforeNext) {
229
+ isValidating = true;
230
+ stepErrorMessage = null;
231
+ erroredStepIndex = null;
232
+ try {
233
+ const ok = await beforeNext(currentStep, current, draft);
234
+ if (!ok) {
235
+ erroredStepIndex = currentStep;
236
+ stepErrorMessage = chinese
237
+ ? `步骤「${current.title}」校验未通过,请完善必填信息`
238
+ : `Step "${current.title}" validation did not pass`;
239
+ return;
240
+ }
241
+ } catch (err) {
242
+ erroredStepIndex = currentStep;
243
+ stepErrorMessage =
244
+ err instanceof Error
245
+ ? err.message
246
+ : chinese
247
+ ? '步骤校验失败'
248
+ : 'Step validation failed';
249
+ return;
250
+ } finally {
251
+ isValidating = false;
252
+ }
253
+ } else {
254
+ stepErrorMessage = null;
255
+ erroredStepIndex = null;
256
+ }
257
+
258
+ if (!isLast) {
259
+ const prev = currentStep;
260
+ currentStep = currentStep + 1;
261
+ persistDraft(currentStep, draft);
262
+ onStepChange?.(currentStep, prev);
263
+ } else {
264
+ await onFinish?.(draft);
265
+ clearDraft();
266
+ }
267
+ }
268
+
269
+ function handlePrev() {
270
+ if (currentStep > 0) {
271
+ void goToStep(currentStep - 1);
272
+ }
273
+ }
274
+
275
+ function handleResetWizard() {
276
+ clearDraft();
277
+ draft = {};
278
+ currentStep = 0;
279
+ stepErrorMessage = null;
280
+ erroredStepIndex = null;
281
+ }
282
+
283
+ const currentItem = $derived(activeSteps[currentStep]);
284
+ const isLastStep = $derived(activeSteps.length > 0 && currentStep >= activeSteps.length - 1);
285
+ const progressPercentage = $derived(
286
+ activeSteps.length > 0 ? Math.round(((currentStep + 1) / activeSteps.length) * 100) : 0,
287
+ );
288
+
289
+ const resolvedSubmitText = $derived(submitText ?? (chinese ? '提交完成' : 'Finish'));
290
+ const resolvedNextText = $derived(nextText ?? (chinese ? '下一步' : 'Next'));
291
+ const resolvedPrevText = $derived(prevText ?? (chinese ? '上一步' : 'Previous'));
292
+ const resolvedCancelText = $derived(cancelText ?? (chinese ? '取消' : 'Cancel'));
293
+ </script>
294
+
295
+ <div
296
+ data-svadmin-component="StepWizard"
297
+ data-direction={direction}
298
+ class={cn(
299
+ 'rounded-xl border border-border bg-card text-card-foreground shadow-xs overflow-hidden',
300
+ className,
301
+ )}
302
+ >
303
+ {#if showProgress || (storageKey && draftRestored)}
304
+ <div class="border-b border-border/60 bg-muted/20 px-6 py-3 space-y-2">
305
+ <div class="flex items-center justify-between gap-3 text-xs">
306
+ <span class="font-medium text-muted-foreground">
307
+ {chinese
308
+ ? `第 ${currentStep + 1} 步 / 共 ${activeSteps.length} 步`
309
+ : `Step ${currentStep + 1} of ${activeSteps.length}`}
310
+ </span>
311
+ <div class="flex items-center gap-3">
312
+ {#if storageKey && draftRestored}
313
+ <span class="inline-flex items-center gap-1 rounded-full bg-info/10 px-2 py-0.5 text-[11px] font-medium text-info">
314
+ <Save class="h-3 w-3" />
315
+ {chinese ? '已自动恢复上次草稿' : 'Draft restored'}
316
+ </span>
317
+ {/if}
318
+ {#if storageKey}
319
+ <button
320
+ type="button"
321
+ onclick={handleResetWizard}
322
+ class="inline-flex items-center gap-1 text-[11px] text-muted-foreground hover:text-foreground transition-colors"
323
+ >
324
+ <RotateCcw class="h-3 w-3" />
325
+ {chinese ? '清除草稿' : 'Reset Draft'}
326
+ </button>
327
+ {/if}
328
+ </div>
329
+ </div>
330
+ {#if showProgress}
331
+ <Progress value={progressPercentage} class="h-1.5" />
332
+ {/if}
333
+ </div>
334
+ {/if}
335
+
336
+ <div class={cn(direction === 'vertical' ? 'grid grid-cols-1 md:grid-cols-[260px_minmax(0,1fr)]' : 'flex flex-col')}>
337
+ <nav
338
+ aria-label="Wizard steps"
339
+ class={cn(
340
+ 'bg-muted/10 p-6',
341
+ direction === 'vertical'
342
+ ? 'border-b md:border-b-0 md:border-r border-border/60'
343
+ : 'border-b border-border/60',
344
+ )}
345
+ >
346
+ <ol
347
+ class={cn(
348
+ 'flex gap-3 list-none m-0 p-0',
349
+ direction === 'vertical' ? 'flex-col' : 'flex-row items-center overflow-x-auto',
350
+ )}
351
+ >
352
+ {#each activeSteps as step, index (step.id)}
353
+ {@const stepState = resolveStepStatus(index, step)}
354
+ {@const canClick = clickable && !step.disabled && !isValidating && !isSubmitting && index !== currentStep}
355
+ <li
356
+ class={cn(
357
+ 'relative flex',
358
+ direction === 'vertical' ? 'flex-col' : 'flex-1 min-w-0 items-center gap-2',
359
+ step.disabled && 'opacity-50',
360
+ )}
361
+ data-step-id={step.id}
362
+ data-step-status={stepState}
363
+ >
364
+ <button
365
+ type="button"
366
+ disabled={!canClick}
367
+ onclick={() => goToStep(index)}
368
+ aria-current={index === currentStep ? 'step' : undefined}
369
+ class={cn(
370
+ 'flex items-start gap-3 text-left rounded-lg p-1.5 -m-1.5 transition-colors bg-transparent border-0',
371
+ canClick ? 'cursor-pointer hover:bg-accent/50' : 'cursor-default',
372
+ direction === 'vertical' && 'w-full',
373
+ )}
374
+ >
375
+ <span
376
+ class={cn(
377
+ 'flex h-8 w-8 shrink-0 items-center justify-center rounded-full border text-xs font-semibold transition-all',
378
+ stepState === 'finish' && 'border-success bg-success text-success-foreground',
379
+ stepState === 'process' && 'border-primary bg-primary text-primary-foreground ring-4 ring-primary/15',
380
+ stepState === 'error' && 'border-destructive bg-destructive text-destructive-foreground',
381
+ stepState === 'wait' && 'border-border bg-card text-muted-foreground',
382
+ )}
383
+ >
384
+ {#if stepState === 'finish'}
385
+ <Check class="h-4 w-4" />
386
+ {:else if stepState === 'error'}
387
+ <X class="h-4 w-4" />
388
+ {:else if step.icon}
389
+ {@const IconComp = step.icon}
390
+ <IconComp class="h-4 w-4" />
391
+ {:else}
392
+ {index + 1}
393
+ {/if}
394
+ </span>
395
+
396
+ <span class="min-w-0 flex-1 pt-0.5">
397
+ <span
398
+ class={cn(
399
+ 'block text-xs font-semibold truncate',
400
+ stepState === 'process' ? 'text-foreground' : stepState === 'error' ? 'text-destructive' : 'text-muted-foreground',
401
+ )}
402
+ >
403
+ {step.title}
404
+ </span>
405
+ {#if step.description}
406
+ <span class="block text-[11px] text-muted-foreground/80 truncate mt-0.5">
407
+ {step.description}
408
+ </span>
409
+ {/if}
410
+ </span>
411
+ </button>
412
+
413
+ {#if index < activeSteps.length - 1}
414
+ {#if direction === 'horizontal'}
415
+ <div class="hidden sm:flex flex-1 items-center px-1">
416
+ <div
417
+ class={cn(
418
+ 'h-0.5 w-full rounded-full transition-colors',
419
+ stepState === 'finish' ? 'bg-success' : 'bg-border',
420
+ )}
421
+ ></div>
422
+ </div>
423
+ {:else}
424
+ <div
425
+ class={cn(
426
+ 'ml-4 my-1 w-0.5 h-5 rounded-full transition-colors',
427
+ stepState === 'finish' ? 'bg-success' : 'bg-border',
428
+ )}
429
+ aria-hidden="true"
430
+ ></div>
431
+ {/if}
432
+ {/if}
433
+ </li>
434
+ {/each}
435
+ </ol>
436
+ </nav>
437
+
438
+ <div class="flex flex-col justify-between p-6 min-h-64">
439
+ <div class="space-y-4">
440
+ {#if stepErrorMessage}
441
+ <div
442
+ role="alert"
443
+ class="flex items-center gap-2 rounded-lg border border-destructive/30 bg-destructive/10 px-3.5 py-2.5 text-xs text-destructive"
444
+ >
445
+ <AlertCircle class="h-4 w-4 shrink-0" />
446
+ <span>{stepErrorMessage}</span>
447
+ </div>
448
+ {/if}
449
+
450
+ {#if currentItem}
451
+ <div>
452
+ {#if stepContent}
453
+ {@render stepContent({ step: currentItem, index: currentStep, draft, setDraft })}
454
+ {:else if children}
455
+ {@render children()}
456
+ {/if}
457
+ </div>
458
+ {/if}
459
+ </div>
460
+
461
+ <div class="mt-8 flex items-center justify-between pt-4 border-t border-border/60">
462
+ <div>
463
+ {#if onCancel}
464
+ <Button
465
+ type="button"
466
+ variant="ghost"
467
+ size="sm"
468
+ onclick={onCancel}
469
+ disabled={isValidating || isSubmitting}
470
+ >
471
+ {resolvedCancelText}
472
+ </Button>
473
+ {/if}
474
+ </div>
475
+
476
+ <div class="flex items-center gap-2.5">
477
+ {#if currentStep > 0}
478
+ <Button
479
+ type="button"
480
+ variant="outline"
481
+ size="sm"
482
+ onclick={handlePrev}
483
+ disabled={isValidating || isSubmitting}
484
+ class="gap-1"
485
+ >
486
+ <ChevronLeft class="h-4 w-4" />
487
+ {resolvedPrevText}
488
+ </Button>
489
+ {/if}
490
+
491
+ <Button
492
+ type="button"
493
+ size="sm"
494
+ onclick={handleNext}
495
+ disabled={isValidating || isSubmitting || activeSteps.length === 0}
496
+ class="gap-1 min-w-24"
497
+ >
498
+ {#if isValidating || isSubmitting}
499
+ <Loader2 class="h-4 w-4 animate-spin" />
500
+ <span>{chinese ? '校验处理中...' : 'Processing...'}</span>
501
+ {:else if isLastStep}
502
+ <Check class="h-4 w-4" />
503
+ <span>{resolvedSubmitText}</span>
504
+ {:else}
505
+ <span>{resolvedNextText}</span>
506
+ <ChevronRight class="h-4 w-4" />
507
+ {/if}
508
+ </Button>
509
+ </div>
510
+ </div>
511
+ </div>
512
+ </div>
513
+ </div>
@@ -0,0 +1,49 @@
1
+ import { type Component, type Snippet } from 'svelte';
2
+ export type StepWizardStatus = 'wait' | 'process' | 'finish' | 'error';
3
+ export interface StepWizardItem {
4
+ id: string;
5
+ title: string;
6
+ description?: string | undefined;
7
+ icon?: Component | undefined;
8
+ status?: StepWizardStatus | undefined;
9
+ disabled?: boolean | undefined;
10
+ /** Dynamic branch predicate: return false to hide this branch step */
11
+ condition?: ((draft: Record<string, unknown>) => boolean) | undefined;
12
+ }
13
+ export interface StepWizardProps {
14
+ steps: StepWizardItem[];
15
+ currentStep?: number | undefined;
16
+ draft?: Record<string, unknown> | undefined;
17
+ direction?: 'horizontal' | 'vertical' | undefined;
18
+ status?: StepWizardStatus | undefined;
19
+ clickable?: boolean | undefined;
20
+ storageKey?: string | undefined;
21
+ showProgress?: boolean | undefined;
22
+ beforeNext?: ((stepIndex: number, step: StepWizardItem, draft: Record<string, unknown>) => Promise<boolean> | boolean) | undefined;
23
+ onStepChange?: ((newStep: number, prevStep: number) => void) | undefined;
24
+ onFinish?: ((draft: Record<string, unknown>) => Promise<void> | void) | undefined;
25
+ onCancel?: (() => void) | undefined;
26
+ onDraftRestore?: ((restored: {
27
+ currentStep: number;
28
+ draft: Record<string, unknown>;
29
+ }) => void) | undefined;
30
+ submitText?: string | undefined;
31
+ nextText?: string | undefined;
32
+ prevText?: string | undefined;
33
+ cancelText?: string | undefined;
34
+ isSubmitting?: boolean | undefined;
35
+ class?: string | undefined;
36
+ stepContent?: Snippet<[{
37
+ step: StepWizardItem;
38
+ index: number;
39
+ draft: Record<string, unknown>;
40
+ setDraft: (patch: Record<string, unknown>) => void;
41
+ }]> | undefined;
42
+ children?: Snippet | undefined;
43
+ }
44
+ declare const StepWizard: Component<StepWizardProps, {
45
+ clearDraft: () => void;
46
+ setDraft: (patch: Record<string, unknown>) => void;
47
+ }, "draft" | "currentStep">;
48
+ type StepWizard = ReturnType<typeof StepWizard>;
49
+ export default StepWizard;