@svgrid/grid 2.2.27 → 2.2.28

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 (212) hide show
  1. package/README.md +199 -199
  2. package/dist/FlexRender.svelte +96 -96
  3. package/dist/GridFooter.svelte +179 -179
  4. package/dist/GridMenus.svelte +734 -734
  5. package/dist/SvAutoComplete.svelte +165 -165
  6. package/dist/SvCalendar.svelte +503 -503
  7. package/dist/SvCarousel.svelte +141 -141
  8. package/dist/SvCheckBox.svelte +101 -101
  9. package/dist/SvColorInput.svelte +181 -181
  10. package/dist/SvComboBox.svelte +275 -275
  11. package/dist/SvContextMenu.svelte +116 -116
  12. package/dist/SvCountryInput.svelte +160 -160
  13. package/dist/SvDrawer.svelte +254 -250
  14. package/dist/SvDropDownList.svelte +374 -374
  15. package/dist/SvDurationInput.svelte +126 -126
  16. package/dist/SvField.svelte +293 -293
  17. package/dist/SvForm.svelte +437 -437
  18. package/dist/SvGrid.css +2723 -2723
  19. package/dist/SvGrid.svelte +3333 -3333
  20. package/dist/SvGridChart.svelte +1724 -1724
  21. package/dist/SvGridChartPanel.svelte +485 -485
  22. package/dist/SvGridChartView.svelte +70 -70
  23. package/dist/SvGridDropdown.svelte +696 -696
  24. package/dist/SvGridSelect.svelte +259 -259
  25. package/dist/SvGroupCell.svelte +109 -109
  26. package/dist/SvListBox.svelte +287 -287
  27. package/dist/SvMaskedInput.svelte +122 -122
  28. package/dist/SvMenu.svelte +124 -124
  29. package/dist/SvMenuList.svelte +146 -146
  30. package/dist/SvMultiSelect.svelte +281 -281
  31. package/dist/SvNumberInput.svelte +168 -168
  32. package/dist/SvOtpInput.svelte +158 -158
  33. package/dist/SvPasswordInput.svelte +151 -151
  34. package/dist/SvPhoneInput.svelte +133 -131
  35. package/dist/SvPopover.svelte +197 -197
  36. package/dist/SvRadioGroup.svelte +107 -107
  37. package/dist/SvRowGroupPanel.svelte +170 -170
  38. package/dist/SvScrollArea.svelte +61 -61
  39. package/dist/SvSlider.svelte +200 -200
  40. package/dist/SvSwitchButton.svelte +107 -107
  41. package/dist/SvTagsInput.svelte +112 -112
  42. package/dist/SvTextInput.svelte +147 -147
  43. package/dist/SvTimePicker.svelte +245 -245
  44. package/dist/SvToaster.svelte +159 -159
  45. package/dist/SvToggleButton.svelte +85 -85
  46. package/dist/SvTooltip.svelte +161 -161
  47. package/dist/SvTour.svelte +204 -204
  48. package/dist/SvTree.svelte +437 -437
  49. package/dist/SvTreeSelect.svelte +233 -233
  50. package/dist/cdn/{GridMenus-BzxEYNtW.js → GridMenus-BbzEvTYO.js} +2 -2
  51. package/dist/cdn/{GridMenus-Dr-nGEXn.js → GridMenus-E220X2kM.js} +2 -2
  52. package/dist/cdn/{SvDateTimePicker-B1sDc9Pz.js → SvDateTimePicker-B8GopjhC.js} +2 -2
  53. package/dist/cdn/{SvDateTimePicker-Bh0FTs1E.js → SvDateTimePicker-DB0aIEk8.js} +2 -2
  54. package/dist/cdn/{SvGridChart-Bgk4hDs8.js → SvGridChart-BcLCYvw9.js} +1 -1
  55. package/dist/cdn/{SvGridChart-BKQsO5fZ.js → SvGridChart-BhnFdLd0.js} +1 -1
  56. package/dist/cdn/{SvGridChartPanel-DkCc2Z7b.js → SvGridChartPanel-Cmx9DHAS.js} +1 -1
  57. package/dist/cdn/{SvGridChartPanel-DSkHIQDd.js → SvGridChartPanel-DvjwxLvK.js} +1 -1
  58. package/dist/cdn/{SvGridChartView-BrbVaELm.js → SvGridChartView-B40DTJSX.js} +1 -1
  59. package/dist/cdn/{SvGridChartView-i9rWvSKg.js → SvGridChartView-PwqI4s02.js} +1 -1
  60. package/dist/cdn/{SvGridDropdown-D08sVmAy.js → SvGridDropdown-DjALc_4f.js} +1 -1
  61. package/dist/cdn/{SvGridDropdown-CGxxopQ4.js → SvGridDropdown-hpnHvOGt.js} +1 -1
  62. package/dist/cdn/{src-cgs1wcUS.js → src-BxNEslEo.js} +25 -25
  63. package/dist/cdn/{src-Cw8d9U8j.js → src-C4yKQZ5t.js} +26 -26
  64. package/dist/cdn/svgrid.js +5 -5
  65. package/dist/cdn/svgrid.svelte-external.js +5 -5
  66. package/dist/chart-export.js +8 -8
  67. package/package.json +10 -10
  68. package/src/FlexRender.svelte +96 -96
  69. package/src/GridFooter.svelte +179 -179
  70. package/src/GridMenus.svelte +734 -734
  71. package/src/SvAutoComplete.svelte +165 -165
  72. package/src/SvCalendar.svelte +503 -503
  73. package/src/SvCalendar.test.ts +226 -226
  74. package/src/SvCarousel.svelte +141 -141
  75. package/src/SvCheckBox.svelte +101 -101
  76. package/src/SvColorInput.svelte +181 -181
  77. package/src/SvComboBox.svelte +275 -275
  78. package/src/SvContextMenu.svelte +116 -116
  79. package/src/SvCountryInput.svelte +160 -160
  80. package/src/SvDrawer.svelte +254 -250
  81. package/src/SvDrawer.test.ts +18 -1
  82. package/src/SvDropDownList.svelte +374 -374
  83. package/src/SvDurationInput.svelte +126 -126
  84. package/src/SvField.svelte +293 -293
  85. package/src/SvForm.svelte +437 -437
  86. package/src/SvForm.test.ts +411 -411
  87. package/src/SvGrid.controller.svelte.ts +3239 -3239
  88. package/src/SvGrid.css +2723 -2723
  89. package/src/SvGrid.svelte +3333 -3333
  90. package/src/SvGrid.types.ts +1613 -1613
  91. package/src/SvGridChart.svelte +1724 -1724
  92. package/src/SvGridChartPanel.svelte +485 -485
  93. package/src/SvGridChartView.svelte +70 -70
  94. package/src/SvGridDropdown.svelte +696 -696
  95. package/src/SvGridSelect.svelte +259 -259
  96. package/src/SvGroupCell.svelte +109 -109
  97. package/src/SvListBox.svelte +287 -287
  98. package/src/SvMaskedInput.svelte +122 -122
  99. package/src/SvMenu.svelte +124 -124
  100. package/src/SvMenu.test.ts +97 -97
  101. package/src/SvMenuList.svelte +146 -146
  102. package/src/SvMultiSelect.svelte +281 -281
  103. package/src/SvNavPane.test.ts +15 -4
  104. package/src/SvNumberInput.svelte +168 -168
  105. package/src/SvOtpInput.svelte +158 -158
  106. package/src/SvPasswordInput.svelte +151 -151
  107. package/src/SvPhoneInput.svelte +133 -131
  108. package/src/SvPopover.svelte +197 -197
  109. package/src/SvRadioGroup.svelte +107 -107
  110. package/src/SvRowGroupPanel.svelte +170 -170
  111. package/src/SvScrollArea.svelte +61 -61
  112. package/src/SvSlider.svelte +200 -200
  113. package/src/SvSwitchButton.svelte +107 -107
  114. package/src/SvTagsInput.svelte +112 -112
  115. package/src/SvTextInput.svelte +147 -147
  116. package/src/SvTimePicker.svelte +245 -245
  117. package/src/SvToaster.svelte +159 -159
  118. package/src/SvToaster.test.ts +95 -95
  119. package/src/SvToggleButton.svelte +85 -85
  120. package/src/SvTooltip.svelte +161 -161
  121. package/src/SvTour.svelte +204 -204
  122. package/src/SvTree.svelte +437 -437
  123. package/src/SvTreeSelect.svelte +233 -233
  124. package/src/a11y/dismissable.test.ts +119 -119
  125. package/src/a11y/dismissable.ts +114 -114
  126. package/src/a11y.contract.test.ts +49 -49
  127. package/src/a11y.test.ts +59 -59
  128. package/src/a11y.ts +61 -61
  129. package/src/ai.test.ts +502 -502
  130. package/src/ai.ts +1391 -1391
  131. package/src/build-api.coverage.test.ts +633 -633
  132. package/src/build-api.ts +895 -895
  133. package/src/builtin-editors.grid.test.ts +85 -85
  134. package/src/cell-formatting.ts +169 -169
  135. package/src/cell-render.ts +469 -469
  136. package/src/chart-export.ts +201 -201
  137. package/src/chart-view.svelte.ts +36 -36
  138. package/src/chart.ts +2296 -2296
  139. package/src/collaboration.test.ts +104 -104
  140. package/src/collaboration.ts +167 -167
  141. package/src/core.performance.test.ts +30 -30
  142. package/src/core.ts +1111 -1111
  143. package/src/createAutocomplete.svelte.ts +132 -132
  144. package/src/createCombobox.svelte.ts +191 -191
  145. package/src/createCountryInput.svelte.ts +157 -157
  146. package/src/createDropdownList.svelte.ts +168 -168
  147. package/src/createForm.svelte.ts +386 -386
  148. package/src/createGrid.svelte.ts +42 -42
  149. package/src/createGrid.test.ts +10 -10
  150. package/src/createGridState.svelte.ts +17 -17
  151. package/src/createMenu.svelte.ts +225 -225
  152. package/src/createPopoverSelect.svelte.ts +213 -213
  153. package/src/createSlider.svelte.ts +191 -191
  154. package/src/createTooltip.svelte.ts +144 -144
  155. package/src/createTree.svelte.ts +319 -319
  156. package/src/editing.test.ts +859 -859
  157. package/src/editing.ts +675 -675
  158. package/src/editor-contract.ts +157 -157
  159. package/src/export-data-api.test.ts +126 -126
  160. package/src/export-format.test.ts +107 -107
  161. package/src/export-format.ts +598 -598
  162. package/src/filter-operators.ts +157 -157
  163. package/src/flex-render.ts +3 -3
  164. package/src/form-field.ts +127 -127
  165. package/src/index.ts +713 -713
  166. package/src/js-scroller.svelte.ts +173 -173
  167. package/src/keyboard.test.ts +59 -59
  168. package/src/keyboard.ts +97 -97
  169. package/src/list-nav.test.ts +49 -49
  170. package/src/list-nav.ts +29 -29
  171. package/src/list-option.test.ts +56 -56
  172. package/src/list-option.ts +172 -172
  173. package/src/menus.test.ts +700 -700
  174. package/src/menus.ts +652 -652
  175. package/src/merge-objects.ts +48 -48
  176. package/src/overlays.test.ts +90 -90
  177. package/src/render-component.ts +28 -28
  178. package/src/scheduler-model.test.ts +562 -562
  179. package/src/scheduler-model.ts +872 -872
  180. package/src/selection.test.ts +754 -754
  181. package/src/selection.ts +600 -600
  182. package/src/server-data-source.test.ts +289 -289
  183. package/src/server-data-source.ts +413 -413
  184. package/src/sparkline.test.ts +68 -68
  185. package/src/sparkline.ts +169 -169
  186. package/src/spreadsheet.test.ts +489 -489
  187. package/src/spreadsheet.ts +312 -312
  188. package/src/static-functions.ts +11 -11
  189. package/src/subscribe.ts +38 -38
  190. package/src/svgrid-wrapper.types.ts +524 -524
  191. package/src/svgrid.behavior.test.ts +706 -706
  192. package/src/svgrid.charting.test.ts +534 -534
  193. package/src/svgrid.features.test.ts +157 -157
  194. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  195. package/src/svgrid.wrapper.test.ts +40 -40
  196. package/src/test-setup.ts +62 -62
  197. package/src/themes/index.ts +215 -215
  198. package/src/toast-store.svelte.ts +246 -246
  199. package/src/toast-store.test.ts +147 -147
  200. package/src/ui-buttons.test.ts +144 -144
  201. package/src/ui-inputs.test.ts +118 -118
  202. package/src/ui-range.test.ts +70 -70
  203. package/src/ui-selection.test.ts +155 -155
  204. package/src/ui-tier1.test.ts +142 -142
  205. package/src/virtual.test.ts +88 -88
  206. package/src/virtualization/column-virtualizer.test.ts +27 -27
  207. package/src/virtualization/column-virtualizer.ts +30 -30
  208. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  209. package/src/virtualization/types.ts +30 -30
  210. package/src/virtualization/virtualizer.test.ts +47 -47
  211. package/src/virtualization/virtualizer.ts +296 -296
  212. package/themes/ember.css +71 -71
@@ -1,122 +1,122 @@
1
- <script lang="ts">
2
- /**
3
- * SvMaskedInput - a pattern-masked text input (#=digit, A=letter, *=alnum;
4
- * other chars are literals). Parity: Smart `smart-masked-text-box`. Emits both
5
- * the masked display value and the raw (unmasked) value.
6
- *
7
- * The styled renderer over the headless `createMaskedInput` core; the mask
8
- * formatting + state live in the core, spread here via prop-getters. The box,
9
- * size, invalid state, clear button and adornments are owned by SvField's
10
- * `frame` chrome.
11
- */
12
- import type { Snippet } from 'svelte'
13
- import { unmask } from './datetime/mask'
14
- import SvField from './SvField.svelte'
15
- import { nextEditorId, type SvEditorProps } from './editor-contract'
16
- import { createMaskedInput } from './createMaskedInput.svelte'
17
-
18
- type Props = SvEditorProps & {
19
- value?: string
20
- /** Called with (masked, raw, complete). */
21
- onChange?: (masked: string, raw: string, complete: boolean) => void
22
- mask?: string
23
- placeholder?: string
24
- /** Show a clear (x) button when there is a value. */
25
- clearable?: boolean
26
- /** Leading adornment (icon/button) inside the field. */
27
- leading?: Snippet
28
- /** Trailing adornment (icon/button) inside the field. */
29
- trailing?: Snippet
30
- /** Plain-text affix at the start. */
31
- prefix?: string
32
- /** Plain-text affix at the end. */
33
- suffix?: string
34
- /** @deprecated Use `leading`. */
35
- prefixIcon?: Snippet
36
- /** @deprecated Use `trailing`. */
37
- suffixIcon?: Snippet
38
- /** Stretch to the container width. */
39
- block?: boolean
40
- /** Control width in px (ignored when `block`). Default 200. */
41
- width?: number
42
- }
43
-
44
- let {
45
- value = $bindable(''),
46
- onChange,
47
- mask = '',
48
- placeholder,
49
- disabled = false,
50
- readonly = false,
51
- name,
52
- size = 'md',
53
- ariaLabel,
54
- invalid = false,
55
- required = false,
56
- error,
57
- label,
58
- hint,
59
- dir,
60
- id,
61
- loading = false,
62
- clearable = false,
63
- leading,
64
- trailing,
65
- prefix,
66
- suffix,
67
- prefixIcon,
68
- suffixIcon,
69
- block = false,
70
- width = 200,
71
- }: Props = $props()
72
-
73
- const autoId = nextEditorId('sv-mask')
74
- const uid = $derived(id ?? autoId)
75
-
76
- const mi = createMaskedInput({
77
- value: () => value,
78
- // Write the masked `value` (so `bind:value` works) AND fire `onChange`.
79
- onChange: (m, r, c) => { value = m; onChange?.(m, r, c) },
80
- mask: () => mask,
81
- placeholder: () => placeholder,
82
- disabled: () => disabled,
83
- readonly: () => readonly,
84
- id: () => uid,
85
- invalid: () => invalid,
86
- required: () => required,
87
- error: () => error,
88
- hint: () => hint,
89
- ariaLabel: () => ariaLabel,
90
- })
91
- </script>
92
-
93
- <SvField
94
- frame
95
- id={uid}
96
- {label}
97
- {hint}
98
- {error}
99
- {required}
100
- {dir}
101
- {size}
102
- {invalid}
103
- {disabled}
104
- {readonly}
105
- {loading}
106
- {block}
107
- {width}
108
- leading={leading ?? prefixIcon}
109
- trailing={trailing ?? suffixIcon}
110
- {prefix}
111
- {suffix}
112
- clearable={clearable}
113
- showClear={!!mi.masked}
114
- onclear={() => { value = ''; onChange?.('', '', false) }}
115
- >
116
- <input class="sv-masked__input" {...mi.inputProps()} />
117
- {#if name}<input type="hidden" {name} value={mask ? unmask(mi.masked, mask) : mi.masked} />{/if}
118
- </SvField>
119
-
120
- <style>
121
- .sv-masked__input { font-variant-numeric: tabular-nums; letter-spacing: 0.02em; }
122
- </style>
1
+ <script lang="ts">
2
+ /**
3
+ * SvMaskedInput - a pattern-masked text input (#=digit, A=letter, *=alnum;
4
+ * other chars are literals). Parity: Smart `smart-masked-text-box`. Emits both
5
+ * the masked display value and the raw (unmasked) value.
6
+ *
7
+ * The styled renderer over the headless `createMaskedInput` core; the mask
8
+ * formatting + state live in the core, spread here via prop-getters. The box,
9
+ * size, invalid state, clear button and adornments are owned by SvField's
10
+ * `frame` chrome.
11
+ */
12
+ import type { Snippet } from 'svelte'
13
+ import { unmask } from './datetime/mask'
14
+ import SvField from './SvField.svelte'
15
+ import { nextEditorId, type SvEditorProps } from './editor-contract'
16
+ import { createMaskedInput } from './createMaskedInput.svelte'
17
+
18
+ type Props = SvEditorProps & {
19
+ value?: string
20
+ /** Called with (masked, raw, complete). */
21
+ onChange?: (masked: string, raw: string, complete: boolean) => void
22
+ mask?: string
23
+ placeholder?: string
24
+ /** Show a clear (x) button when there is a value. */
25
+ clearable?: boolean
26
+ /** Leading adornment (icon/button) inside the field. */
27
+ leading?: Snippet
28
+ /** Trailing adornment (icon/button) inside the field. */
29
+ trailing?: Snippet
30
+ /** Plain-text affix at the start. */
31
+ prefix?: string
32
+ /** Plain-text affix at the end. */
33
+ suffix?: string
34
+ /** @deprecated Use `leading`. */
35
+ prefixIcon?: Snippet
36
+ /** @deprecated Use `trailing`. */
37
+ suffixIcon?: Snippet
38
+ /** Stretch to the container width. */
39
+ block?: boolean
40
+ /** Control width in px (ignored when `block`). Default 200. */
41
+ width?: number
42
+ }
43
+
44
+ let {
45
+ value = $bindable(''),
46
+ onChange,
47
+ mask = '',
48
+ placeholder,
49
+ disabled = false,
50
+ readonly = false,
51
+ name,
52
+ size = 'md',
53
+ ariaLabel,
54
+ invalid = false,
55
+ required = false,
56
+ error,
57
+ label,
58
+ hint,
59
+ dir,
60
+ id,
61
+ loading = false,
62
+ clearable = false,
63
+ leading,
64
+ trailing,
65
+ prefix,
66
+ suffix,
67
+ prefixIcon,
68
+ suffixIcon,
69
+ block = false,
70
+ width = 200,
71
+ }: Props = $props()
72
+
73
+ const autoId = nextEditorId('sv-mask')
74
+ const uid = $derived(id ?? autoId)
75
+
76
+ const mi = createMaskedInput({
77
+ value: () => value,
78
+ // Write the masked `value` (so `bind:value` works) AND fire `onChange`.
79
+ onChange: (m, r, c) => { value = m; onChange?.(m, r, c) },
80
+ mask: () => mask,
81
+ placeholder: () => placeholder,
82
+ disabled: () => disabled,
83
+ readonly: () => readonly,
84
+ id: () => uid,
85
+ invalid: () => invalid,
86
+ required: () => required,
87
+ error: () => error,
88
+ hint: () => hint,
89
+ ariaLabel: () => ariaLabel,
90
+ })
91
+ </script>
92
+
93
+ <SvField
94
+ frame
95
+ id={uid}
96
+ {label}
97
+ {hint}
98
+ {error}
99
+ {required}
100
+ {dir}
101
+ {size}
102
+ {invalid}
103
+ {disabled}
104
+ {readonly}
105
+ {loading}
106
+ {block}
107
+ {width}
108
+ leading={leading ?? prefixIcon}
109
+ trailing={trailing ?? suffixIcon}
110
+ {prefix}
111
+ {suffix}
112
+ clearable={clearable}
113
+ showClear={!!mi.masked}
114
+ onclear={() => { value = ''; onChange?.('', '', false) }}
115
+ >
116
+ <input class="sv-masked__input" {...mi.inputProps()} />
117
+ {#if name}<input type="hidden" {name} value={mask ? unmask(mi.masked, mask) : mi.masked} />{/if}
118
+ </SvField>
119
+
120
+ <style>
121
+ .sv-masked__input { font-variant-numeric: tabular-nums; letter-spacing: 0.02em; }
122
+ </style>
package/src/SvMenu.svelte CHANGED
@@ -1,124 +1,124 @@
1
- <script lang="ts" module>
2
- export type { MenuItem } from './SvMenuList.svelte'
3
- </script>
4
-
5
- <script lang="ts">
6
- /**
7
- * SvMenu - a dropdown / context menu: a trigger opens a portalled, animated
8
- * menu surface with submenus, separators, icons, shortcuts and full keyboard
9
- * (arrows, Enter, Escape, ArrowRight/Left for submenus). Portals to <body> so it
10
- * escapes any clipping. Parity: Smart menu / context-menu.
11
- *
12
- * ```svelte
13
- * <SvMenu items={items} onSelect={(i) => run(i)}>
14
- * {#snippet anchor()}<button>Actions</button>{/snippet}
15
- * </SvMenu>
16
- * ```
17
- */
18
- import type { Snippet } from 'svelte'
19
- import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
20
- import { createDismissableLayer } from './a11y/dismissable'
21
- import { getFocusable } from './a11y/focus-trap'
22
- import { type EditorDir } from './editor-contract'
23
- import SvMenuList, { type MenuItem } from './SvMenuList.svelte'
24
-
25
- let {
26
- items,
27
- open = $bindable(false),
28
- onOpenChange,
29
- onSelect,
30
- ariaLabel,
31
- anchor,
32
- dir,
33
- }: {
34
- items: ReadonlyArray<MenuItem>
35
- open?: boolean
36
- onOpenChange?: (open: boolean) => void
37
- onSelect?: (item: MenuItem) => void
38
- ariaLabel?: string
39
- anchor?: Snippet
40
- /** Text direction (rtl mirrors the submenu chevron + flips ArrowLeft/Right). */
41
- dir?: EditorDir
42
- } = $props()
43
-
44
- const resolvedDir = $derived(dir === 'ltr' || dir === 'rtl' ? dir : undefined)
45
-
46
- let anchorEl = $state<HTMLSpanElement | null>(null)
47
- let panelEl = $state<HTMLDivElement | null>(null)
48
- let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
49
-
50
- function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
51
- function toggle() { setOpen(!open) }
52
- function updatePos() {
53
- if (!anchorEl) return
54
- rect = anchoredRect(anchorEl.getBoundingClientRect(), { estimatedHeight: Math.min(items.length, 10) * 34 + 8, minWidth: 180 })
55
- }
56
- /** Return focus to the trigger. Every dismissal path (Escape, item selection,
57
- * outside-click, Tab) funnels through the effect cleanup below, so this
58
- * fires uniformly instead of dropping focus to <body> on close. */
59
- function focusTrigger() {
60
- if (!anchorEl) return
61
- ;(getFocusable(anchorEl)[0] ?? anchorEl)?.focus?.()
62
- }
63
-
64
- $effect(() => {
65
- if (!open) return
66
- updatePos()
67
- queueMicrotask(() => panelEl?.querySelector<HTMLElement>('[role="menuitem"]:not([disabled])')?.focus())
68
- const rp = () => updatePos()
69
- window.addEventListener('scroll', rp, true)
70
- window.addEventListener('resize', rp)
71
- // Outside-click dismissal via the shared layer stack (Escape stays owned by
72
- // SvMenuList's keyboard handling, so closeOnEscape is off here).
73
- const layer = createDismissableLayer({
74
- element: () => [anchorEl, panelEl],
75
- onDismiss: () => setOpen(false),
76
- closeOnEscape: false,
77
- })
78
- layer.activate()
79
- return () => {
80
- window.removeEventListener('scroll', rp, true)
81
- window.removeEventListener('resize', rp)
82
- layer.release()
83
- // Only on an actual close (not a mid-open rerun from e.g. `items` changing).
84
- if (!open) focusTrigger()
85
- }
86
- })
87
- </script>
88
-
89
- <!-- svelte-ignore a11y_no_static_element_interactions a11y_click_events_have_key_events -->
90
- <span
91
- bind:this={anchorEl}
92
- class="sv-menu__anchor"
93
- aria-haspopup="menu"
94
- aria-expanded={open}
95
- onclick={toggle}
96
- >
97
- {@render anchor?.()}
98
- </span>
99
-
100
- {#if open}
101
- <div
102
- bind:this={panelEl}
103
- class="sv-menu"
104
- use:portalToBody
105
- use:popIn={{ up: rect.openUpward }}
106
- style:position="fixed"
107
- style:top={`${rect.top}px`}
108
- style:left={`${rect.left}px`}
109
- dir={resolvedDir}
110
- aria-label={ariaLabel}
111
- >
112
- <SvMenuList {items} onclose={() => setOpen(false)} onselect={(i) => onSelect?.(i)} dir={resolvedDir} />
113
- </div>
114
- {/if}
115
-
116
- <style>
117
- .sv-menu__anchor { display: inline-flex; }
118
- :global(.sv-menu) {
119
- z-index: 2147483646; min-width: 180px;
120
- background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
121
- border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
122
- box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px;
123
- }
124
- </style>
1
+ <script lang="ts" module>
2
+ export type { MenuItem } from './SvMenuList.svelte'
3
+ </script>
4
+
5
+ <script lang="ts">
6
+ /**
7
+ * SvMenu - a dropdown / context menu: a trigger opens a portalled, animated
8
+ * menu surface with submenus, separators, icons, shortcuts and full keyboard
9
+ * (arrows, Enter, Escape, ArrowRight/Left for submenus). Portals to <body> so it
10
+ * escapes any clipping. Parity: Smart menu / context-menu.
11
+ *
12
+ * ```svelte
13
+ * <SvMenu items={items} onSelect={(i) => run(i)}>
14
+ * {#snippet anchor()}<button>Actions</button>{/snippet}
15
+ * </SvMenu>
16
+ * ```
17
+ */
18
+ import type { Snippet } from 'svelte'
19
+ import { anchoredRect, portalToBody, popIn, type AnchoredRect } from './popover'
20
+ import { createDismissableLayer } from './a11y/dismissable'
21
+ import { getFocusable } from './a11y/focus-trap'
22
+ import { type EditorDir } from './editor-contract'
23
+ import SvMenuList, { type MenuItem } from './SvMenuList.svelte'
24
+
25
+ let {
26
+ items,
27
+ open = $bindable(false),
28
+ onOpenChange,
29
+ onSelect,
30
+ ariaLabel,
31
+ anchor,
32
+ dir,
33
+ }: {
34
+ items: ReadonlyArray<MenuItem>
35
+ open?: boolean
36
+ onOpenChange?: (open: boolean) => void
37
+ onSelect?: (item: MenuItem) => void
38
+ ariaLabel?: string
39
+ anchor?: Snippet
40
+ /** Text direction (rtl mirrors the submenu chevron + flips ArrowLeft/Right). */
41
+ dir?: EditorDir
42
+ } = $props()
43
+
44
+ const resolvedDir = $derived(dir === 'ltr' || dir === 'rtl' ? dir : undefined)
45
+
46
+ let anchorEl = $state<HTMLSpanElement | null>(null)
47
+ let panelEl = $state<HTMLDivElement | null>(null)
48
+ let rect = $state<AnchoredRect>({ top: 0, left: 0, width: 0, openUpward: false, maxHeight: 0, availHeight: 0 })
49
+
50
+ function setOpen(v: boolean) { if (v !== open) { open = v; onOpenChange?.(v) } }
51
+ function toggle() { setOpen(!open) }
52
+ function updatePos() {
53
+ if (!anchorEl) return
54
+ rect = anchoredRect(anchorEl.getBoundingClientRect(), { estimatedHeight: Math.min(items.length, 10) * 34 + 8, minWidth: 180 })
55
+ }
56
+ /** Return focus to the trigger. Every dismissal path (Escape, item selection,
57
+ * outside-click, Tab) funnels through the effect cleanup below, so this
58
+ * fires uniformly instead of dropping focus to <body> on close. */
59
+ function focusTrigger() {
60
+ if (!anchorEl) return
61
+ ;(getFocusable(anchorEl)[0] ?? anchorEl)?.focus?.()
62
+ }
63
+
64
+ $effect(() => {
65
+ if (!open) return
66
+ updatePos()
67
+ queueMicrotask(() => panelEl?.querySelector<HTMLElement>('[role="menuitem"]:not([disabled])')?.focus())
68
+ const rp = () => updatePos()
69
+ window.addEventListener('scroll', rp, true)
70
+ window.addEventListener('resize', rp)
71
+ // Outside-click dismissal via the shared layer stack (Escape stays owned by
72
+ // SvMenuList's keyboard handling, so closeOnEscape is off here).
73
+ const layer = createDismissableLayer({
74
+ element: () => [anchorEl, panelEl],
75
+ onDismiss: () => setOpen(false),
76
+ closeOnEscape: false,
77
+ })
78
+ layer.activate()
79
+ return () => {
80
+ window.removeEventListener('scroll', rp, true)
81
+ window.removeEventListener('resize', rp)
82
+ layer.release()
83
+ // Only on an actual close (not a mid-open rerun from e.g. `items` changing).
84
+ if (!open) focusTrigger()
85
+ }
86
+ })
87
+ </script>
88
+
89
+ <!-- svelte-ignore a11y_no_static_element_interactions a11y_click_events_have_key_events -->
90
+ <span
91
+ bind:this={anchorEl}
92
+ class="sv-menu__anchor"
93
+ aria-haspopup="menu"
94
+ aria-expanded={open}
95
+ onclick={toggle}
96
+ >
97
+ {@render anchor?.()}
98
+ </span>
99
+
100
+ {#if open}
101
+ <div
102
+ bind:this={panelEl}
103
+ class="sv-menu"
104
+ use:portalToBody
105
+ use:popIn={{ up: rect.openUpward }}
106
+ style:position="fixed"
107
+ style:top={`${rect.top}px`}
108
+ style:left={`${rect.left}px`}
109
+ dir={resolvedDir}
110
+ aria-label={ariaLabel}
111
+ >
112
+ <SvMenuList {items} onclose={() => setOpen(false)} onselect={(i) => onSelect?.(i)} dir={resolvedDir} />
113
+ </div>
114
+ {/if}
115
+
116
+ <style>
117
+ .sv-menu__anchor { display: inline-flex; }
118
+ :global(.sv-menu) {
119
+ z-index: 2147483646; min-width: 180px;
120
+ background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
121
+ border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
122
+ box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px;
123
+ }
124
+ </style>