@svadmin/ui 0.117.0 → 0.119.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 (144) hide show
  1. package/dist/app.css +351 -52
  2. package/dist/app.theme.css +351 -52
  3. package/dist/components/AboutSettings.svelte +1 -1
  4. package/dist/components/ApprovalTimeline.svelte +170 -0
  5. package/dist/components/ApprovalTimeline.svelte.d.ts +26 -0
  6. package/dist/components/AuditLogDrawer.svelte +165 -55
  7. package/dist/components/AuditLogDrawer.svelte.d.ts +4 -2
  8. package/dist/components/Authenticated.svelte +2 -2
  9. package/dist/components/AutoSaveIndicator.svelte +2 -2
  10. package/dist/components/AutoTable.svelte +1 -1
  11. package/dist/components/Breadcrumbs.svelte +1 -1
  12. package/dist/components/Breadcrumbs.svelte.d.ts +1 -1
  13. package/dist/components/CanAccess.svelte +2 -2
  14. package/dist/components/CancelTaskButton.svelte +2 -2
  15. package/dist/components/Cascader.svelte +19 -19
  16. package/dist/components/Cascader.svelte.d.ts +19 -19
  17. package/dist/components/ColorPicker.svelte +9 -9
  18. package/dist/components/ColorPicker.svelte.d.ts +9 -9
  19. package/dist/components/ComboboxField.svelte +15 -15
  20. package/dist/components/ComboboxField.svelte.d.ts +15 -15
  21. package/dist/components/ConcurrentConflictModal.svelte +292 -0
  22. package/dist/components/ConcurrentConflictModal.svelte.d.ts +24 -0
  23. package/dist/components/ConfigErrorScreen.svelte +2 -2
  24. package/dist/components/ConfirmDialog.svelte +6 -4
  25. package/dist/components/ConfirmDialog.svelte.d.ts +2 -2
  26. package/dist/components/CronExpressionBuilder.svelte +389 -0
  27. package/dist/components/CronExpressionBuilder.svelte.d.ts +20 -0
  28. package/dist/components/DateRangeInput.svelte +22 -22
  29. package/dist/components/DateRangeInput.svelte.d.ts +22 -22
  30. package/dist/components/DateTimeInput.svelte +2 -2
  31. package/dist/components/DateTimeInput.svelte.d.ts +2 -2
  32. package/dist/components/EmptyState.svelte +2 -2
  33. package/dist/components/ErrorComponent.svelte +2 -2
  34. package/dist/components/ErrorSummary.svelte +2 -2
  35. package/dist/components/ExcelExportButton.svelte +142 -0
  36. package/dist/components/ExcelExportButton.svelte.d.ts +21 -0
  37. package/dist/components/ExcelImportWizard.svelte +571 -0
  38. package/dist/components/ExcelImportWizard.svelte.d.ts +26 -0
  39. package/dist/components/FieldRenderer.svelte +3 -3
  40. package/dist/components/FileUpload.svelte +16 -16
  41. package/dist/components/FileUpload.svelte.d.ts +16 -16
  42. package/dist/components/FileUploadField.svelte +7 -7
  43. package/dist/components/FileUploadField.svelte.d.ts +7 -7
  44. package/dist/components/FilterDropdown.svelte.d.ts +1 -1
  45. package/dist/components/FloatButtonGroup.svelte +162 -0
  46. package/dist/components/FloatButtonGroup.svelte.d.ts +34 -0
  47. package/dist/components/ForgotPasswordPage.svelte +2 -2
  48. package/dist/components/Header.svelte +2 -2
  49. package/dist/components/LiveIndicator.svelte +2 -2
  50. package/dist/components/LoginPage.svelte +2 -2
  51. package/dist/components/MetricGrid.svelte +163 -0
  52. package/dist/components/MetricGrid.svelte.d.ts +39 -0
  53. package/dist/components/MicroAppFrame.svelte +290 -0
  54. package/dist/components/MicroAppFrame.svelte.d.ts +36 -0
  55. package/dist/components/MoneyInput.svelte +15 -15
  56. package/dist/components/MoneyInput.svelte.d.ts +15 -15
  57. package/dist/components/NotificationCenter.svelte +16 -16
  58. package/dist/components/NotificationCenter.svelte.d.ts +16 -16
  59. package/dist/components/NumberInput.svelte +13 -13
  60. package/dist/components/NumberInput.svelte.d.ts +13 -13
  61. package/dist/components/NumericInput.svelte +16 -16
  62. package/dist/components/NumericInput.svelte.d.ts +16 -16
  63. package/dist/components/OfflineGuard.svelte +65 -0
  64. package/dist/components/OfflineGuard.svelte.d.ts +15 -0
  65. package/dist/components/OrgChart.svelte +171 -0
  66. package/dist/components/OrgChart.svelte.d.ts +26 -0
  67. package/dist/components/OrgTreePicker.svelte +325 -0
  68. package/dist/components/OrgTreePicker.svelte.d.ts +32 -0
  69. package/dist/components/PageSkeleton.svelte +2 -2
  70. package/dist/components/PercentInput.svelte +14 -14
  71. package/dist/components/PercentInput.svelte.d.ts +14 -14
  72. package/dist/components/PivotDrilldownModal.svelte +228 -0
  73. package/dist/components/PivotDrilldownModal.svelte.d.ts +22 -0
  74. package/dist/components/PresenceAvatarGroup.svelte +78 -29
  75. package/dist/components/PresenceAvatarGroup.svelte.d.ts +14 -8
  76. package/dist/components/ProSkeleton.svelte +186 -0
  77. package/dist/components/ProSkeleton.svelte.d.ts +20 -0
  78. package/dist/components/Rate.svelte +9 -9
  79. package/dist/components/Rate.svelte.d.ts +9 -9
  80. package/dist/components/RegisterPage.svelte +2 -2
  81. package/dist/components/ResizeBox.svelte.d.ts +1 -1
  82. package/dist/components/RetryTaskButton.svelte +2 -2
  83. package/dist/components/Ribbon.svelte +97 -0
  84. package/dist/components/Ribbon.svelte.d.ts +19 -0
  85. package/dist/components/SafeDeleteConfirm.svelte +301 -0
  86. package/dist/components/SafeDeleteConfirm.svelte.d.ts +24 -0
  87. package/dist/components/SignaturePad.svelte +19 -3
  88. package/dist/components/SignaturePad.svelte.d.ts +3 -0
  89. package/dist/components/SliderCaptcha.svelte +448 -0
  90. package/dist/components/SliderCaptcha.svelte.d.ts +26 -0
  91. package/dist/components/TagsInput.svelte +10 -10
  92. package/dist/components/TagsInput.svelte.d.ts +10 -10
  93. package/dist/components/TaskCenter.svelte +450 -0
  94. package/dist/components/TaskCenter.svelte.d.ts +37 -0
  95. package/dist/components/TaskDetails.svelte +2 -2
  96. package/dist/components/TaskList.svelte +2 -2
  97. package/dist/components/TaskProgressBar.svelte +2 -2
  98. package/dist/components/TaskStatusBadge.svelte +2 -2
  99. package/dist/components/ThemedTitle.svelte +2 -2
  100. package/dist/components/Tour.svelte +9 -1
  101. package/dist/components/Tour.svelte.d.ts +2 -1
  102. package/dist/components/Transfer.svelte +11 -11
  103. package/dist/components/Transfer.svelte.d.ts +11 -11
  104. package/dist/components/TreeSelect.svelte +17 -17
  105. package/dist/components/TreeSelect.svelte.d.ts +17 -17
  106. package/dist/components/TreeTable.svelte.d.ts +1 -1
  107. package/dist/components/TreeTransfer.svelte +288 -0
  108. package/dist/components/TreeTransfer.svelte.d.ts +25 -0
  109. package/dist/components/TrendIndicator.svelte +177 -0
  110. package/dist/components/TrendIndicator.svelte.d.ts +27 -0
  111. package/dist/components/UndoableNotification.svelte +2 -2
  112. package/dist/components/UpdatePasswordPage.svelte +2 -2
  113. package/dist/components/VirtualTreeSelect.svelte +431 -0
  114. package/dist/components/VirtualTreeSelect.svelte.d.ts +34 -0
  115. package/dist/components/WorkflowProcessCard.svelte +93 -0
  116. package/dist/components/WorkflowProcessCard.svelte.d.ts +21 -0
  117. package/dist/components/buttons/CreateButton.svelte +2 -2
  118. package/dist/components/buttons/ExportButton.svelte +2 -2
  119. package/dist/components/buttons/ListButton.svelte +2 -2
  120. package/dist/components/buttons/RefreshButton.svelte +2 -2
  121. package/dist/components/buttons/SaveButton.svelte +2 -2
  122. package/dist/components/charts/GaugeChart.svelte +452 -57
  123. package/dist/components/charts/GaugeChart.svelte.d.ts +61 -10
  124. package/dist/components/content/AuditTimeline.svelte +125 -28
  125. package/dist/components/content/AuditTimeline.svelte.d.ts +30 -16
  126. package/dist/components/fields/JsonField.svelte +2 -2
  127. package/dist/components/fields/MultiSelectField.svelte +2 -2
  128. package/dist/components/fields/RelationField.svelte +2 -2
  129. package/dist/components/fields/RichTextField.svelte +2 -2
  130. package/dist/components/fields/SelectField.svelte +2 -2
  131. package/dist/components/list-state.svelte.d.ts +1 -1
  132. package/dist/components/ui/checkbox/checkbox.svelte.d.ts +1 -1
  133. package/dist/components/ui/command/command-dialog.svelte.d.ts +1 -1
  134. package/dist/components/ui/command/index.d.ts +1 -1
  135. package/dist/components/ui/input/input.svelte.d.ts +1 -1
  136. package/dist/components/ui/switch/switch.svelte.d.ts +1 -1
  137. package/dist/components/useNetworkStatus.d.svelte.ts +1 -0
  138. package/dist/components/useNetworkStatus.svelte.d.ts +30 -0
  139. package/dist/components/useNetworkStatus.svelte.js +74 -0
  140. package/dist/design-system.d.ts +4 -4
  141. package/dist/index.d.ts +51 -5
  142. package/dist/index.js +36 -3
  143. package/dist/recipes.d.ts +91 -619
  144. package/package.json +30 -30
@@ -1,22 +1,22 @@
1
1
  export type { UploadItemStatus, UploadItem, UploadSession, UploadCancellation, UploadHandler, UploadCancelHandler, } from './file-upload-types.js';
2
2
  import type { UploadItem, UploadHandler, UploadCancelHandler } from './file-upload-types.js';
3
3
  interface Props {
4
- id?: string;
5
- name?: string;
6
- accept?: string;
7
- multiple?: boolean;
8
- maxFiles?: number;
9
- maxSize?: number;
10
- disabled?: boolean;
11
- required?: boolean;
12
- ariaLabel?: string;
13
- invalid?: boolean;
14
- describedby?: string;
15
- upload?: UploadHandler;
16
- cancelUpload?: UploadCancelHandler;
17
- onChange?: (items: UploadItem[]) => void;
18
- onReject?: (file: File, reason: string) => void;
19
- class?: string;
4
+ id?: string | undefined;
5
+ name?: string | undefined;
6
+ accept?: string | undefined;
7
+ multiple?: boolean | undefined;
8
+ maxFiles?: number | undefined;
9
+ maxSize?: number | undefined;
10
+ disabled?: boolean | undefined;
11
+ required?: boolean | undefined;
12
+ ariaLabel?: string | undefined;
13
+ invalid?: boolean | undefined;
14
+ describedby?: string | undefined;
15
+ upload?: UploadHandler | undefined;
16
+ cancelUpload?: UploadCancelHandler | undefined;
17
+ onChange?: ((items: UploadItem[]) => void) | undefined;
18
+ onReject?: ((file: File, reason: string) => void) | undefined;
19
+ class?: string | undefined;
20
20
  }
21
21
  declare const FileUpload: import("svelte").Component<Props, {}, "">;
22
22
  type FileUpload = ReturnType<typeof FileUpload>;
@@ -20,16 +20,16 @@
20
20
  }
21
21
 
22
22
  interface Props {
23
- id?: string;
23
+ id?: string | undefined;
24
24
  field: FieldDefinition;
25
25
  value: unknown;
26
26
  onchange: (value: unknown) => void;
27
- disabled?: boolean;
28
- invalid?: boolean;
29
- describedby?: string;
30
- upload?: UploadHandler;
31
- cancelUpload?: UploadCancelHandler;
32
- onUploadStateChange?: (state: UploadState) => void;
27
+ disabled?: boolean | undefined;
28
+ invalid?: boolean | undefined;
29
+ describedby?: string | undefined;
30
+ upload?: UploadHandler | undefined;
31
+ cancelUpload?: UploadCancelHandler | undefined;
32
+ onUploadStateChange?: ((state: UploadState) => void) | undefined;
33
33
  }
34
34
 
35
35
  let {
@@ -5,16 +5,16 @@ interface UploadState {
5
5
  unresolved: boolean;
6
6
  }
7
7
  interface Props {
8
- id?: string;
8
+ id?: string | undefined;
9
9
  field: FieldDefinition;
10
10
  value: unknown;
11
11
  onchange: (value: unknown) => void;
12
- disabled?: boolean;
13
- invalid?: boolean;
14
- describedby?: string;
15
- upload?: UploadHandler;
16
- cancelUpload?: UploadCancelHandler;
17
- onUploadStateChange?: (state: UploadState) => void;
12
+ disabled?: boolean | undefined;
13
+ invalid?: boolean | undefined;
14
+ describedby?: string | undefined;
15
+ upload?: UploadHandler | undefined;
16
+ cancelUpload?: UploadCancelHandler | undefined;
17
+ onUploadStateChange?: ((state: UploadState) => void) | undefined;
18
18
  }
19
19
  declare const FileUploadField: import("svelte").Component<Props, {}, "">;
20
20
  type FileUploadField = ReturnType<typeof FileUploadField>;
@@ -19,6 +19,6 @@ interface Props {
19
19
  trigger?: Snippet;
20
20
  class?: string;
21
21
  }
22
- declare const FilterDropdown: import("svelte").Component<Props, {}, "open" | "value">;
22
+ declare const FilterDropdown: import("svelte").Component<Props, {}, "value" | "open">;
23
23
  type FilterDropdown = ReturnType<typeof FilterDropdown>;
24
24
  export default FilterDropdown;
@@ -0,0 +1,162 @@
1
+ <script lang="ts">
2
+ import { onMount, type Snippet } from 'svelte';
3
+ import { Plus, X } from '@lucide/svelte';
4
+ import { cn } from '../utils.js';
5
+
6
+ export type FloatButtonPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
7
+ export type FloatButtonShape = 'circle' | 'square';
8
+
9
+ export interface FloatButtonGroupProps {
10
+ /** Trigger mode to open the button group */
11
+ trigger?: 'click' | 'hover';
12
+ /** Two-way bindable open state */
13
+ open?: boolean;
14
+ /** Default open state */
15
+ defaultOpen?: boolean;
16
+ /** Shape of the main button */
17
+ shape?: FloatButtonShape;
18
+ /** Screen corner position */
19
+ position?: FloatButtonPosition;
20
+ /** Primary button style */
21
+ type?: 'default' | 'primary';
22
+ /** Custom main icon snippet */
23
+ icon?: Snippet;
24
+ /** Custom close icon snippet */
25
+ closeIcon?: Snippet;
26
+ /** Tooltip hint */
27
+ tooltip?: string;
28
+ /** Accessible label */
29
+ ariaLabel?: string;
30
+ /** Additional CSS classes */
31
+ class?: string;
32
+ /** Child buttons slot */
33
+ children?: Snippet;
34
+ /** Callback when open state changes */
35
+ onopenchange?: (open: boolean) => void;
36
+ }
37
+
38
+ let {
39
+ trigger = 'click',
40
+ defaultOpen = false,
41
+ open = $bindable(defaultOpen),
42
+ shape = 'circle',
43
+ position = 'bottom-right',
44
+ type = 'primary',
45
+ icon,
46
+ closeIcon,
47
+ tooltip,
48
+ ariaLabel = 'Floating Action Menu',
49
+ class: className = '',
50
+ children,
51
+ onopenchange,
52
+ }: FloatButtonGroupProps = $props();
53
+
54
+ let containerEl: HTMLElement | null = $state(null);
55
+
56
+ function setOpen(next: boolean) {
57
+ if (open === next) return;
58
+ open = next;
59
+ onopenchange?.(next);
60
+ }
61
+
62
+ function toggle() {
63
+ setOpen(!open);
64
+ }
65
+
66
+ function handleMouseEnter() {
67
+ if (trigger === 'hover') {
68
+ setOpen(true);
69
+ }
70
+ }
71
+
72
+ function handleMouseLeave() {
73
+ if (trigger === 'hover') {
74
+ setOpen(false);
75
+ }
76
+ }
77
+
78
+ onMount(() => {
79
+ function handleClickOutside(event: MouseEvent) {
80
+ if (trigger === 'click' && open && containerEl && !containerEl.contains(event.target as Node)) {
81
+ setOpen(false);
82
+ }
83
+ }
84
+
85
+ document.addEventListener('mousedown', handleClickOutside);
86
+ return () => {
87
+ document.removeEventListener('mousedown', handleClickOutside);
88
+ };
89
+ });
90
+
91
+ const positionClasses: Record<FloatButtonPosition, string> = {
92
+ 'bottom-right': 'bottom-6 right-6 flex-col-reverse',
93
+ 'bottom-left': 'bottom-6 left-6 flex-col-reverse',
94
+ 'top-right': 'top-6 right-6 flex-col',
95
+ 'top-left': 'top-6 left-6 flex-col',
96
+ };
97
+ </script>
98
+
99
+ <div
100
+ bind:this={containerEl}
101
+ data-svadmin-component="FloatButtonGroup"
102
+ data-position={position}
103
+ data-open={open}
104
+ class={cn(
105
+ 'fixed z-60 inline-flex items-center gap-2.5 transition-all select-none',
106
+ positionClasses[position],
107
+ className,
108
+ )}
109
+ onmouseenter={handleMouseEnter}
110
+ onmouseleave={handleMouseLeave}
111
+ role="region"
112
+ aria-label={ariaLabel}
113
+ >
114
+ <!-- Main Trigger Button -->
115
+ <button
116
+ type="button"
117
+ onclick={trigger === 'click' ? toggle : undefined}
118
+ aria-expanded={open}
119
+ aria-label={ariaLabel}
120
+ title={tooltip}
121
+ class={cn(
122
+ 'relative flex h-11 w-11 items-center justify-center border shadow-md transition-all duration-200 outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',
123
+ shape === 'circle' ? 'rounded-full' : 'rounded-lg',
124
+ type === 'primary'
125
+ ? 'border-primary bg-primary text-primary-foreground hover:bg-primary/90'
126
+ : 'border-border bg-card text-foreground hover:bg-accent hover:text-accent-foreground',
127
+ )}
128
+ >
129
+ <div
130
+ class={cn(
131
+ 'flex items-center justify-center transition-transform duration-200',
132
+ open && 'rotate-90',
133
+ )}
134
+ >
135
+ {#if open}
136
+ {#if closeIcon}
137
+ {@render closeIcon()}
138
+ {:else}
139
+ <X size={20} />
140
+ {/if}
141
+ {:else}
142
+ {#if icon}
143
+ {@render icon()}
144
+ {:else}
145
+ <Plus size={20} />
146
+ {/if}
147
+ {/if}
148
+ </div>
149
+ </button>
150
+
151
+ <!-- Child Buttons List -->
152
+ {#if open && children}
153
+ <div
154
+ class={cn(
155
+ 'flex items-center gap-2 transition-all animate-in fade-in-0 zoom-in-95 duration-150',
156
+ position.startsWith('bottom') ? 'flex-col-reverse' : 'flex-col',
157
+ )}
158
+ >
159
+ {@render children()}
160
+ </div>
161
+ {/if}
162
+ </div>
@@ -0,0 +1,34 @@
1
+ import { type Snippet } from 'svelte';
2
+ export type FloatButtonPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
3
+ export type FloatButtonShape = 'circle' | 'square';
4
+ export interface FloatButtonGroupProps {
5
+ /** Trigger mode to open the button group */
6
+ trigger?: 'click' | 'hover';
7
+ /** Two-way bindable open state */
8
+ open?: boolean;
9
+ /** Default open state */
10
+ defaultOpen?: boolean;
11
+ /** Shape of the main button */
12
+ shape?: FloatButtonShape;
13
+ /** Screen corner position */
14
+ position?: FloatButtonPosition;
15
+ /** Primary button style */
16
+ type?: 'default' | 'primary';
17
+ /** Custom main icon snippet */
18
+ icon?: Snippet;
19
+ /** Custom close icon snippet */
20
+ closeIcon?: Snippet;
21
+ /** Tooltip hint */
22
+ tooltip?: string;
23
+ /** Accessible label */
24
+ ariaLabel?: string;
25
+ /** Additional CSS classes */
26
+ class?: string;
27
+ /** Child buttons slot */
28
+ children?: Snippet;
29
+ /** Callback when open state changes */
30
+ onopenchange?: (open: boolean) => void;
31
+ }
32
+ declare const FloatButtonGroup: import("svelte").Component<FloatButtonGroupProps, {}, "open">;
33
+ type FloatButtonGroup = ReturnType<typeof FloatButtonGroup>;
34
+ export default FloatButtonGroup;
@@ -11,9 +11,9 @@
11
11
 
12
12
  const i18n = useTranslation();
13
13
 
14
- let { title = 'Admin' } = $props<{
14
+ let { title = 'Admin' }: {
15
15
  title?: string;
16
- }>();
16
+ } = $props();
17
17
 
18
18
  const adminContext = captureAdminContext();
19
19
  const forgot = useForgotPassword({ successNotification: false });
@@ -33,7 +33,7 @@
33
33
  menu,
34
34
  showLock = false,
35
35
  onlock,
36
- } = $props<{
36
+ }: {
37
37
  showThemeToggle?: boolean;
38
38
  showThemeSettings?: boolean;
39
39
  showFullscreen?: boolean;
@@ -52,7 +52,7 @@
52
52
  menu?: MenuItem[];
53
53
  showLock?: boolean;
54
54
  onlock?: () => void;
55
- }>();
55
+ } = $props();
56
56
 
57
57
  // Retrieve optional component overrides from registry
58
58
  const registry = getComponentRegistry();
@@ -8,12 +8,12 @@
8
8
  resource = '',
9
9
  lastEvent = null,
10
10
  showDetails = false,
11
- } = $props<{
11
+ }: {
12
12
  status: 'connecting' | 'connected' | 'disconnected';
13
13
  resource?: string;
14
14
  lastEvent?: { type: string; timestamp?: number } | null;
15
15
  showDetails?: boolean;
16
- }>();
16
+ } = $props();
17
17
 
18
18
  const statusConfigs = {
19
19
  connected: { variant: 'default' as const, dotClass: 'bg-success', label: 'Live', icon: Wifi },
@@ -29,7 +29,7 @@
29
29
  identifierPlaceholder,
30
30
  passwordLabel,
31
31
  loginButtonLabel,
32
- } = $props<{
32
+ }: {
33
33
  title?: string;
34
34
  onSuccess?: () => void;
35
35
  socialProviders?: SocialProvider[];
@@ -40,7 +40,7 @@
40
40
  identifierPlaceholder?: string;
41
41
  passwordLabel?: string;
42
42
  loginButtonLabel?: string;
43
- }>();
43
+ } = $props();
44
44
 
45
45
  const adminContext = captureAdminContext();
46
46
  const login = useLogin({ successNotification: false, errorMessage: false });
@@ -0,0 +1,163 @@
1
+ <script lang="ts">
2
+ import { Skeleton } from './ui/skeleton/index.js';
3
+ import { cn } from '../utils.js';
4
+ import type { Snippet } from 'svelte';
5
+
6
+ export interface MetricGridProps {
7
+ /**
8
+ * Column count preset or 'auto' for responsive dashboard layout:
9
+ * - 1: 1 col
10
+ * - 2: 1 -> 2 cols
11
+ * - 3: 1 -> 2 -> 3 cols
12
+ * - 4: 1 -> 2 -> 4 cols
13
+ * - 5: 1 -> 2 -> 3 -> 5 cols
14
+ * - 6: 1 -> 2 -> 3 -> 6 cols
15
+ * - 'auto': 1 -> 2 -> 3 -> 4 cols (default)
16
+ */
17
+ cols?: 1 | 2 | 3 | 4 | 5 | 6 | 'auto' | undefined;
18
+ /** Grid gap size: 'sm' (gap-3), 'md' (gap-4), 'lg' (gap-6) (default: 'md') */
19
+ gap?: 'sm' | 'md' | 'lg' | undefined;
20
+ /** Optional section title */
21
+ title?: string | undefined;
22
+ /** Optional section description / subtitle */
23
+ description?: string | undefined;
24
+ /** Whether metrics data is currently loading */
25
+ loading?: boolean | undefined;
26
+ /** Number of skeleton cards to render during loading (default: 4) */
27
+ skeletonCount?: number | undefined;
28
+ /** Whether the metric dataset is empty */
29
+ empty?: boolean | undefined;
30
+ /** Empty message to display (default: 'No metrics available') */
31
+ emptyMessage?: string | undefined;
32
+ /** Additional CSS classes for outer container */
33
+ class?: string | undefined;
34
+ /** Custom slot for top-right actions (filters, refresh, timer) */
35
+ actions?: Snippet | undefined;
36
+ /** Custom slot for grid contents (GaugeCharts, StatisticCards, etc.) */
37
+ children?: Snippet | undefined;
38
+ /** Custom slot for empty state presentation */
39
+ emptyContent?: Snippet | undefined;
40
+ }
41
+
42
+ let {
43
+ cols = 'auto',
44
+ gap = 'md',
45
+ title,
46
+ description,
47
+ loading = false,
48
+ skeletonCount = 4,
49
+ empty = false,
50
+ emptyMessage = 'No metrics available',
51
+ class: className = '',
52
+ actions,
53
+ children,
54
+ emptyContent,
55
+ }: MetricGridProps = $props();
56
+
57
+ const colsClass = $derived.by(() => {
58
+ switch (cols) {
59
+ case 1:
60
+ return 'grid-cols-1';
61
+ case 2:
62
+ return 'grid-cols-1 sm:grid-cols-2';
63
+ case 3:
64
+ return 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3';
65
+ case 4:
66
+ return 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-4';
67
+ case 5:
68
+ return 'grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-5';
69
+ case 6:
70
+ return 'grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-6';
71
+ case 'auto':
72
+ default:
73
+ return 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4';
74
+ }
75
+ });
76
+
77
+ const gapClass = $derived.by(() => {
78
+ switch (gap) {
79
+ case 'sm':
80
+ return 'gap-3';
81
+ case 'lg':
82
+ return 'gap-6';
83
+ case 'md':
84
+ default:
85
+ return 'gap-4';
86
+ }
87
+ });
88
+ </script>
89
+
90
+ <section
91
+ aria-label={title ?? 'Dashboard metrics'}
92
+ data-svadmin-component="MetricGrid"
93
+ data-columns={cols}
94
+ class={cn('w-full flex flex-col space-y-4', className)}
95
+ >
96
+ {#if title || description || actions}
97
+ <div class="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between">
98
+ <div>
99
+ {#if title}
100
+ <h3 class="text-base font-semibold tracking-tight text-foreground md:text-lg">
101
+ {title}
102
+ </h3>
103
+ {/if}
104
+ {#if description}
105
+ <p class="text-xs text-muted-foreground md:text-sm">
106
+ {description}
107
+ </p>
108
+ {/if}
109
+ </div>
110
+
111
+ {#if actions}
112
+ <div class="flex items-center gap-2 self-start sm:self-auto">
113
+ {@render actions()}
114
+ </div>
115
+ {/if}
116
+ </div>
117
+ {/if}
118
+
119
+ {#if loading}
120
+ <div
121
+ role="status"
122
+ aria-label="Loading metrics"
123
+ data-slot="metric-grid-loading"
124
+ class={cn('grid w-full', colsClass, gapClass)}
125
+ >
126
+ {#each Array(skeletonCount) as _, i (i)}
127
+ <div
128
+ class="flex flex-col justify-between rounded-xl border border-border bg-card p-5 shadow-sm space-y-3"
129
+ >
130
+ <div class="flex items-center justify-between">
131
+ <Skeleton class="h-4 w-28" />
132
+ <Skeleton class="h-4 w-6 rounded-full" />
133
+ </div>
134
+ <div class="space-y-1.5">
135
+ <Skeleton class="h-8 w-24" />
136
+ <Skeleton class="h-3 w-36" />
137
+ </div>
138
+ <div class="pt-2">
139
+ <Skeleton class="h-2 w-full rounded-full" />
140
+ </div>
141
+ </div>
142
+ {/each}
143
+ </div>
144
+ {:else if empty}
145
+ {#if emptyContent}
146
+ {@render emptyContent()}
147
+ {:else}
148
+ <div
149
+ data-slot="metric-grid-empty"
150
+ class="flex flex-col items-center justify-center rounded-xl border border-dashed border-border bg-card/50 p-8 text-center text-muted-foreground"
151
+ >
152
+ <p class="text-sm font-medium">{emptyMessage}</p>
153
+ </div>
154
+ {/if}
155
+ {:else if children}
156
+ <div
157
+ data-slot="metric-grid-content"
158
+ class={cn('grid w-full items-stretch', colsClass, gapClass)}
159
+ >
160
+ {@render children()}
161
+ </div>
162
+ {/if}
163
+ </section>
@@ -0,0 +1,39 @@
1
+ import type { Snippet } from 'svelte';
2
+ export interface MetricGridProps {
3
+ /**
4
+ * Column count preset or 'auto' for responsive dashboard layout:
5
+ * - 1: 1 col
6
+ * - 2: 1 -> 2 cols
7
+ * - 3: 1 -> 2 -> 3 cols
8
+ * - 4: 1 -> 2 -> 4 cols
9
+ * - 5: 1 -> 2 -> 3 -> 5 cols
10
+ * - 6: 1 -> 2 -> 3 -> 6 cols
11
+ * - 'auto': 1 -> 2 -> 3 -> 4 cols (default)
12
+ */
13
+ cols?: 1 | 2 | 3 | 4 | 5 | 6 | 'auto' | undefined;
14
+ /** Grid gap size: 'sm' (gap-3), 'md' (gap-4), 'lg' (gap-6) (default: 'md') */
15
+ gap?: 'sm' | 'md' | 'lg' | undefined;
16
+ /** Optional section title */
17
+ title?: string | undefined;
18
+ /** Optional section description / subtitle */
19
+ description?: string | undefined;
20
+ /** Whether metrics data is currently loading */
21
+ loading?: boolean | undefined;
22
+ /** Number of skeleton cards to render during loading (default: 4) */
23
+ skeletonCount?: number | undefined;
24
+ /** Whether the metric dataset is empty */
25
+ empty?: boolean | undefined;
26
+ /** Empty message to display (default: 'No metrics available') */
27
+ emptyMessage?: string | undefined;
28
+ /** Additional CSS classes for outer container */
29
+ class?: string | undefined;
30
+ /** Custom slot for top-right actions (filters, refresh, timer) */
31
+ actions?: Snippet | undefined;
32
+ /** Custom slot for grid contents (GaugeCharts, StatisticCards, etc.) */
33
+ children?: Snippet | undefined;
34
+ /** Custom slot for empty state presentation */
35
+ emptyContent?: Snippet | undefined;
36
+ }
37
+ declare const MetricGrid: import("svelte").Component<MetricGridProps, {}, "">;
38
+ type MetricGrid = ReturnType<typeof MetricGrid>;
39
+ export default MetricGrid;