@sveltia/ui 0.90.0 → 0.92.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 (284) hide show
  1. package/dist/components/bottom-navigation/bottom-navigation.svelte +3 -9
  2. package/dist/components/bottom-navigation/bottom-navigation.svelte.d.ts +4 -39
  3. package/dist/components/button/button-group.svelte +2 -4
  4. package/dist/components/button/button-group.svelte.d.ts +3 -19
  5. package/dist/components/button/select-button-group.svelte +2 -13
  6. package/dist/components/button/select-button-group.svelte.d.ts +5 -67
  7. package/dist/components/calendar/calendar.d.ts +9 -0
  8. package/dist/components/calendar/calendar.js +43 -0
  9. package/dist/components/calendar/calendar.svelte +26 -27
  10. package/dist/components/checkbox/checkbox-group.svelte +2 -8
  11. package/dist/components/checkbox/checkbox-group.svelte.d.ts +4 -39
  12. package/dist/components/dialog/alert-dialog.svelte.d.ts +2 -3
  13. package/dist/components/dialog/confirmation-dialog.svelte.d.ts +2 -3
  14. package/dist/components/dialog/dialog.svelte +6 -7
  15. package/dist/components/dialog/dialog.svelte.d.ts +2 -3
  16. package/dist/components/dialog/prompt-dialog.svelte +2 -2
  17. package/dist/components/dialog/prompt-dialog.svelte.d.ts +2 -3
  18. package/dist/components/disclosure/disclosure.svelte +14 -16
  19. package/dist/components/disclosure/disclosure.svelte.d.ts +4 -38
  20. package/dist/components/drawer/drawer.svelte +22 -39
  21. package/dist/components/drawer/drawer.svelte.d.ts +3 -24
  22. package/dist/components/grid/grid-body.svelte +2 -3
  23. package/dist/components/grid/grid-body.svelte.d.ts +3 -18
  24. package/dist/components/grid/grid-cell.svelte +2 -8
  25. package/dist/components/grid/grid-cell.svelte.d.ts +3 -22
  26. package/dist/components/grid/grid-col-header.svelte +2 -4
  27. package/dist/components/grid/grid-col-header.svelte.d.ts +3 -19
  28. package/dist/components/grid/grid-foot.svelte +4 -9
  29. package/dist/components/grid/grid-foot.svelte.d.ts +3 -22
  30. package/dist/components/grid/grid-head.svelte +4 -9
  31. package/dist/components/grid/grid-head.svelte.d.ts +3 -22
  32. package/dist/components/grid/grid-row-header.svelte +2 -8
  33. package/dist/components/grid/grid-row-header.svelte.d.ts +3 -22
  34. package/dist/components/grid/grid-row.svelte +4 -5
  35. package/dist/components/grid/grid-row.svelte.d.ts +3 -19
  36. package/dist/components/grid/grid.d.ts +10 -0
  37. package/dist/components/grid/grid.js +11 -0
  38. package/dist/components/grid/grid.svelte +6 -7
  39. package/dist/components/grid/grid.svelte.d.ts +5 -21
  40. package/dist/components/listbox/listbox.svelte +34 -15
  41. package/dist/components/listbox/listbox.svelte.d.ts +5 -69
  42. package/dist/components/listbox/option-group.svelte +2 -8
  43. package/dist/components/listbox/option-group.svelte.d.ts +4 -39
  44. package/dist/components/listbox/option.svelte +2 -1
  45. package/dist/components/menu/menu-item-group.svelte +2 -6
  46. package/dist/components/menu/menu-item-group.svelte.d.ts +3 -22
  47. package/dist/components/menu/menu-item.svelte +5 -1
  48. package/dist/components/menu/menu.svelte +2 -8
  49. package/dist/components/menu/menu.svelte.d.ts +4 -39
  50. package/dist/components/radio/radio-group.svelte +2 -17
  51. package/dist/components/radio/radio-group.svelte.d.ts +5 -67
  52. package/dist/components/radio/radio.svelte +19 -22
  53. package/dist/components/radio/radio.svelte.d.ts +10 -40
  54. package/dist/components/resizable-pane/resizable-handle.svelte +42 -49
  55. package/dist/components/resizable-pane/resizable-pane-group.svelte +44 -58
  56. package/dist/components/resizable-pane/resizable-pane-group.svelte.d.ts +3 -19
  57. package/dist/components/resizable-pane/resizable-pane.svelte +2 -5
  58. package/dist/components/resizable-pane/resizable-pane.svelte.d.ts +3 -19
  59. package/dist/components/resizable-pane/sizing.d.ts +24 -0
  60. package/dist/components/resizable-pane/sizing.js +83 -0
  61. package/dist/components/select/combobox.svelte +35 -39
  62. package/dist/components/select/select-tags.svelte +3 -13
  63. package/dist/components/select/select-tags.svelte.d.ts +5 -67
  64. package/dist/components/slider/slider.d.ts +5 -4
  65. package/dist/components/slider/slider.js +28 -23
  66. package/dist/components/slider/slider.svelte +64 -62
  67. package/dist/components/slider/slider.svelte.d.ts +4 -37
  68. package/dist/components/switch/switch.svelte +2 -13
  69. package/dist/components/switch/switch.svelte.d.ts +5 -67
  70. package/dist/components/table/table-body.svelte +2 -4
  71. package/dist/components/table/table-body.svelte.d.ts +3 -19
  72. package/dist/components/table/table-cell.svelte +2 -8
  73. package/dist/components/table/table-cell.svelte.d.ts +3 -22
  74. package/dist/components/table/table-col-header.svelte +2 -8
  75. package/dist/components/table/table-col-header.svelte.d.ts +3 -22
  76. package/dist/components/table/table-foot.svelte +2 -8
  77. package/dist/components/table/table-foot.svelte.d.ts +3 -22
  78. package/dist/components/table/table-head.svelte +2 -8
  79. package/dist/components/table/table-head.svelte.d.ts +3 -22
  80. package/dist/components/table/table-part.svelte +2 -4
  81. package/dist/components/table/table-part.svelte.d.ts +3 -19
  82. package/dist/components/table/table-row-header.svelte +2 -8
  83. package/dist/components/table/table-row-header.svelte.d.ts +3 -22
  84. package/dist/components/table/table-row.svelte +2 -8
  85. package/dist/components/table/table-row.svelte.d.ts +3 -22
  86. package/dist/components/table/table.svelte +2 -4
  87. package/dist/components/table/table.svelte.d.ts +3 -19
  88. package/dist/components/tabs/tab-box.svelte +2 -4
  89. package/dist/components/tabs/tab-box.svelte.d.ts +3 -19
  90. package/dist/components/tabs/tab-list.svelte +2 -7
  91. package/dist/components/tabs/tab-list.svelte.d.ts +4 -37
  92. package/dist/components/tabs/tab-panel.svelte +2 -8
  93. package/dist/components/tabs/tab-panel.svelte.d.ts +3 -22
  94. package/dist/components/tabs/tab-panels.svelte +2 -8
  95. package/dist/components/tabs/tab-panels.svelte.d.ts +3 -22
  96. package/dist/components/text-editor/code-editor.js +14 -7
  97. package/dist/components/text-editor/code-editor.svelte +14 -22
  98. package/dist/components/text-editor/code-editor.svelte.d.ts +5 -103
  99. package/dist/components/text-editor/config.d.ts +73 -0
  100. package/dist/components/text-editor/config.js +110 -0
  101. package/dist/components/text-editor/constants.d.ts +40 -6
  102. package/dist/components/text-editor/constants.js +81 -7
  103. package/dist/components/text-editor/conversion/editor-components.js +4 -4
  104. package/dist/components/text-editor/conversion/html/components.d.ts +16 -0
  105. package/dist/components/text-editor/conversion/html/components.js +87 -0
  106. package/dist/components/text-editor/conversion/html/export.d.ts +10 -0
  107. package/dist/components/text-editor/conversion/html/export.js +360 -0
  108. package/dist/components/text-editor/conversion/html/import-rules.d.ts +12 -0
  109. package/dist/components/text-editor/conversion/html/import-rules.js +234 -0
  110. package/dist/components/text-editor/conversion/html/index.d.ts +10 -0
  111. package/dist/components/text-editor/conversion/html/index.js +33 -0
  112. package/dist/components/text-editor/conversion/html/paragraph.d.ts +1 -0
  113. package/dist/components/text-editor/conversion/html/paragraph.js +123 -0
  114. package/dist/components/text-editor/conversion/html/task-list.d.ts +13 -0
  115. package/dist/components/text-editor/conversion/html/task-list.js +82 -0
  116. package/dist/components/text-editor/conversion/html/unsupported.d.ts +2 -0
  117. package/dist/components/text-editor/conversion/html/unsupported.js +122 -0
  118. package/dist/components/text-editor/conversion/html/utils.d.ts +6 -0
  119. package/dist/components/text-editor/conversion/html/utils.js +34 -0
  120. package/dist/components/text-editor/conversion/import.js +33 -27
  121. package/dist/components/text-editor/conversion/markdown/block-conversion.d.ts +4 -0
  122. package/dist/components/text-editor/conversion/markdown/block-conversion.js +154 -0
  123. package/dist/components/text-editor/conversion/markdown/block-structure.d.ts +16 -0
  124. package/dist/components/text-editor/conversion/markdown/block-structure.js +254 -0
  125. package/dist/components/text-editor/conversion/markdown/code-blocks.d.ts +57 -0
  126. package/dist/components/text-editor/conversion/markdown/code-blocks.js +279 -0
  127. package/dist/components/text-editor/conversion/markdown/code-spans.d.ts +19 -0
  128. package/dist/components/text-editor/conversion/markdown/code-spans.js +71 -0
  129. package/dist/components/text-editor/conversion/markdown/formatting.d.ts +22 -0
  130. package/dist/components/text-editor/conversion/markdown/formatting.js +451 -0
  131. package/dist/components/text-editor/conversion/markdown/index.d.ts +10 -0
  132. package/dist/components/text-editor/conversion/markdown/index.js +55 -0
  133. package/dist/components/text-editor/conversion/markdown/placeholders.d.ts +2 -0
  134. package/dist/components/text-editor/conversion/markdown/placeholders.js +229 -0
  135. package/dist/components/text-editor/conversion/markdown/syntax.d.ts +99 -0
  136. package/dist/components/text-editor/conversion/markdown/syntax.js +206 -0
  137. package/dist/components/text-editor/conversion/placeholder-chars.d.ts +43 -0
  138. package/dist/components/text-editor/conversion/placeholder-chars.js +51 -0
  139. package/dist/components/text-editor/conversion/transformers/block-escape.d.ts +1 -0
  140. package/dist/components/text-editor/conversion/transformers/block-escape.js +53 -26
  141. package/dist/components/text-editor/conversion/transformers/code.d.ts +3 -14
  142. package/dist/components/text-editor/conversion/transformers/code.js +78 -16
  143. package/dist/components/text-editor/conversion/transformers/formatted-code.js +3 -18
  144. package/dist/components/text-editor/conversion/transformers/inline-code.js +3 -1
  145. package/dist/components/text-editor/conversion/transformers/link.js +3 -1
  146. package/dist/components/text-editor/conversion/transformers/raw-syntax.d.ts +0 -19
  147. package/dist/components/text-editor/conversion/transformers/raw-syntax.js +22 -93
  148. package/dist/components/text-editor/conversion/transformers/table.js +57 -16
  149. package/dist/components/text-editor/conversion/transformers/task-list.d.ts +24 -0
  150. package/dist/components/text-editor/conversion/transformers/task-list.js +53 -0
  151. package/dist/components/text-editor/conversion/update.d.ts +19 -2
  152. package/dist/components/text-editor/conversion/update.js +64 -40
  153. package/dist/components/text-editor/core.d.ts +12 -51
  154. package/dist/components/text-editor/core.js +47 -77
  155. package/dist/components/text-editor/editing/commands.js +9 -18
  156. package/dist/components/text-editor/editing/guards.d.ts +7 -0
  157. package/dist/components/text-editor/editing/guards.js +123 -0
  158. package/dist/components/text-editor/editing/raw-markdown.d.ts +7 -2
  159. package/dist/components/text-editor/editing/raw-markdown.js +68 -8
  160. package/dist/components/text-editor/editing/selection.js +6 -2
  161. package/dist/components/text-editor/lexical-root.svelte +89 -47
  162. package/dist/components/text-editor/lexical-root.svelte.d.ts +4 -67
  163. package/dist/components/text-editor/shiki/{facade.d.ts → engine.d.ts} +8 -8
  164. package/dist/components/text-editor/shiki/{facade.js → engine.js} +53 -156
  165. package/dist/components/text-editor/shiki/highlighter.js +5 -5
  166. package/dist/components/text-editor/shiki/lexical.d.ts +6 -0
  167. package/dist/components/text-editor/shiki/lexical.js +165 -0
  168. package/dist/components/text-editor/shiki/preload.js +1 -1
  169. package/dist/components/text-editor/shiki/source-highlight.svelte.d.ts +15 -0
  170. package/dist/components/text-editor/shiki/source-highlight.svelte.js +120 -0
  171. package/dist/components/text-editor/shiki/version.d.ts +1 -1
  172. package/dist/components/text-editor/shiki/version.js +1 -1
  173. package/dist/components/text-editor/store.svelte.js +65 -16
  174. package/dist/components/text-editor/text-editor.svelte +57 -146
  175. package/dist/components/text-editor/text-editor.svelte.d.ts +9 -105
  176. package/dist/components/text-editor/toolbar/actions.d.ts +25 -0
  177. package/dist/components/text-editor/toolbar/actions.js +107 -0
  178. package/dist/components/text-editor/toolbar/align-menu-button.svelte +16 -14
  179. package/dist/components/text-editor/toolbar/format-text-button.svelte +27 -19
  180. package/dist/components/text-editor/toolbar/insert-horizontal-rule-button.svelte +23 -23
  181. package/dist/components/text-editor/toolbar/insert-item-button.svelte +1 -1
  182. package/dist/components/text-editor/toolbar/insert-link-button.svelte +47 -51
  183. package/dist/components/text-editor/toolbar/insert-menu-button.svelte +1 -1
  184. package/dist/components/text-editor/toolbar/insert-table-button.svelte +35 -52
  185. package/dist/components/text-editor/toolbar/table-action-menu.svelte +19 -17
  186. package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte +34 -11
  187. package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte.d.ts +0 -8
  188. package/dist/components/text-editor/toolbar/toggle-block-menu-item.svelte +35 -41
  189. package/dist/components/text-editor/widgets/emoji-autocomplete.svelte +7 -6
  190. package/dist/components/text-editor/widgets/floating-link-editor.svelte +19 -32
  191. package/dist/components/text-editor/widgets/table-cell-menu-button.svelte +28 -32
  192. package/dist/components/text-field/date-time-input.svelte +7 -8
  193. package/dist/components/text-field/date-time-input.svelte.d.ts +3 -32
  194. package/dist/components/text-field/number-input.d.ts +0 -2
  195. package/dist/components/text-field/number-input.js +25 -25
  196. package/dist/components/text-field/number-input.svelte +18 -9
  197. package/dist/components/text-field/number-input.svelte.d.ts +1 -1
  198. package/dist/components/text-field/text-area.d.ts +2 -0
  199. package/dist/components/text-field/text-area.js +31 -0
  200. package/dist/components/text-field/text-area.svelte +12 -25
  201. package/dist/components/text-field/text-area.svelte.d.ts +5 -67
  202. package/dist/components/toast/toast.svelte +31 -8
  203. package/dist/components/toast/toast.svelte.d.ts +6 -6
  204. package/dist/components/toolbar/toolbar.svelte +2 -7
  205. package/dist/components/toolbar/toolbar.svelte.d.ts +4 -37
  206. package/dist/components/tree/tree-item.svelte +2 -6
  207. package/dist/components/tree/tree-item.svelte.d.ts +3 -22
  208. package/dist/components/tree/tree.svelte +3 -10
  209. package/dist/components/tree/tree.svelte.d.ts +4 -39
  210. package/dist/components/util/group.svelte +2 -7
  211. package/dist/components/util/group.svelte.d.ts +4 -37
  212. package/dist/components/util/modal.d.ts +9 -0
  213. package/dist/components/util/modal.js +30 -0
  214. package/dist/components/util/modal.svelte +16 -12
  215. package/dist/index.d.ts +1 -1
  216. package/dist/index.js +1 -1
  217. package/dist/locales/ar.yaml +2 -0
  218. package/dist/locales/bg.yaml +2 -0
  219. package/dist/locales/ca.yaml +2 -0
  220. package/dist/locales/cs.yaml +2 -0
  221. package/dist/locales/da.yaml +2 -0
  222. package/dist/locales/de.yaml +2 -0
  223. package/dist/locales/el.yaml +2 -0
  224. package/dist/locales/en-CA.yaml +2 -0
  225. package/dist/locales/en-GB.yaml +2 -0
  226. package/dist/locales/en-US.yaml +2 -0
  227. package/dist/locales/en-ZA.yaml +2 -0
  228. package/dist/locales/es-CO.yaml +2 -0
  229. package/dist/locales/es-ES.yaml +2 -0
  230. package/dist/locales/fa.yaml +2 -0
  231. package/dist/locales/fi.yaml +2 -0
  232. package/dist/locales/fr.yaml +2 -0
  233. package/dist/locales/he.yaml +2 -0
  234. package/dist/locales/hr.yaml +2 -0
  235. package/dist/locales/hu.yaml +176 -0
  236. package/dist/locales/it.yaml +2 -0
  237. package/dist/locales/ja.yaml +2 -0
  238. package/dist/locales/ko.yaml +2 -0
  239. package/dist/locales/nl.yaml +2 -0
  240. package/dist/locales/pl.yaml +2 -0
  241. package/dist/locales/pt-BR.yaml +2 -0
  242. package/dist/locales/pt-PT.yaml +2 -0
  243. package/dist/locales/ru.yaml +2 -0
  244. package/dist/locales/sk.yaml +2 -0
  245. package/dist/locales/sv.yaml +2 -0
  246. package/dist/locales/tr.yaml +2 -0
  247. package/dist/locales/uk.yaml +2 -0
  248. package/dist/locales/vi.yaml +2 -0
  249. package/dist/locales/zh-CN.yaml +2 -0
  250. package/dist/locales/zh-TW.yaml +2 -0
  251. package/dist/services/composite-widget.svelte.d.ts +76 -0
  252. package/dist/services/composite-widget.svelte.js +157 -0
  253. package/dist/services/focus.d.ts +2 -0
  254. package/dist/services/focus.js +68 -0
  255. package/dist/services/group.svelte.d.ts +17 -69
  256. package/dist/services/group.svelte.js +128 -391
  257. package/dist/services/label.d.ts +9 -0
  258. package/dist/services/label.js +22 -0
  259. package/dist/services/menu.d.ts +8 -0
  260. package/dist/services/menu.js +237 -0
  261. package/dist/services/navigation.d.ts +9 -0
  262. package/dist/services/navigation.js +13 -0
  263. package/dist/services/number.d.ts +2 -0
  264. package/dist/services/number.js +27 -0
  265. package/dist/services/pointer-drag.d.ts +14 -0
  266. package/dist/services/pointer-drag.js +89 -0
  267. package/dist/services/popup.svelte.js +123 -103
  268. package/dist/services/text.d.ts +3 -0
  269. package/dist/services/text.js +17 -0
  270. package/dist/services/tree.svelte.d.ts +29 -43
  271. package/dist/services/tree.svelte.js +58 -105
  272. package/dist/services/type-ahead.d.ts +10 -1
  273. package/dist/services/type-ahead.js +56 -34
  274. package/dist/typedefs.d.ts +108 -6
  275. package/dist/typedefs.js +63 -6
  276. package/package.json +5 -5
  277. package/dist/components/text-editor/conversion/html.d.ts +0 -30
  278. package/dist/components/text-editor/conversion/html.js +0 -857
  279. package/dist/components/text-editor/conversion/markdown.d.ts +0 -56
  280. package/dist/components/text-editor/conversion/markdown.js +0 -949
  281. package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte +0 -28
  282. package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte.d.ts +0 -37
  283. package/dist/components/text-editor/toolbar/insert-component.d.ts +0 -3
  284. package/dist/components/text-editor/toolbar/insert-component.js +0 -37
@@ -2,6 +2,8 @@ import { isRTL } from '@sveltia/i18n';
2
2
  import { generateElementId } from '@sveltia/utils/element';
3
3
  import { sleep } from '@sveltia/utils/misc';
4
4
  import { on } from 'svelte/events';
5
+ import { restoreFocus } from './focus.js';
6
+ import { hasModifier } from './navigation.js';
5
7
  import { calculatePopupStyle, isShallowEqual, mirrorPosition } from './popup-position.js';
6
8
 
7
9
  /**
@@ -35,18 +37,7 @@ class Popup {
35
37
  } else if (this.anchorElement.getAttribute('aria-expanded') === 'true') {
36
38
  // Wait for the popup to close before focusing the anchor, otherwise the focus will be lost
37
39
  window.requestAnimationFrame(() => {
38
- const { activeElement } = document;
39
-
40
- // Only take focus back if it’s still inside the popup, or nowhere because the popup took it
41
- // down with itself. If it has already moved on — the user tabbed out of the menu, say —
42
- // pulling it back would undo what they just did.
43
- if (
44
- !activeElement ||
45
- activeElement === document.body ||
46
- this.popupElement?.contains(activeElement)
47
- ) {
48
- this.anchorElement.focus();
49
- }
40
+ restoreFocus(this.anchorElement, this.popupElement);
50
41
  });
51
42
  }
52
43
 
@@ -87,17 +78,24 @@ class Popup {
87
78
  nested = false;
88
79
 
89
80
  /**
90
- * Function that removes the event listeners added to the current {@link popupElement}.
91
- * @type {(() => void) | undefined}
81
+ * Controller whose signal removes the event listeners added to the current {@link popupElement}.
82
+ * @type {AbortController | undefined}
92
83
  */
93
- #removeEventListeners = undefined;
84
+ #popupListeners = undefined;
94
85
 
95
86
  /**
96
- * Functions that remove the event listeners added to the {@link anchorElement}, which may outlive
97
- * this instance.
98
- * @type {(() => void)[]}
87
+ * Controller whose signal removes the event listeners added to the {@link anchorElement}, which
88
+ * may outlive this instance.
89
+ * @type {AbortController}
99
90
  */
100
- #removeAnchorListeners = [];
91
+ #anchorListeners = new AbortController();
92
+
93
+ /**
94
+ * Whether the {@link anchorElement} is a text field, which keeps its clicks and its Enter and
95
+ * Space keys.
96
+ * @type {boolean}
97
+ */
98
+ #anchorIsTextField = false;
101
99
 
102
100
  /**
103
101
  * ID of the animation frame requested to recalculate the position after a resize.
@@ -124,61 +122,16 @@ class Popup {
124
122
 
125
123
  this.anchorElement.setAttribute('aria-expanded', 'false');
126
124
 
127
- const removeClickListener = on(anchorElement, 'click', (event) => {
128
- if (!this.isDisabled && !this.isReadOnly) {
129
- // A menu item’s submenu may already have been opened by hovering, which also happens right
130
- // before a tap on a touch screen, so a pointer click only opens it rather than toggling it
131
- // closed. A scripted click, which has no `detail`, still toggles it: that’s how the
132
- // keyboard navigation closes a submenu.
133
- this.open = event.detail && anchorElement.matches('[role="menuitem"]') ? true : !this.open;
134
- }
135
- });
136
-
137
- const removeKeyDownListener = on(anchorElement, 'keydown', (event) => {
138
- const { key, ctrlKey, metaKey, shiftKey, altKey } = event;
139
- const hasModifier = shiftKey || altKey || ctrlKey || metaKey;
140
-
141
- if (this.isDisabled || this.isReadOnly) {
142
- return;
143
- }
144
-
145
- if (['Enter', ' '].includes(key) && !hasModifier) {
146
- event.preventDefault();
147
- event.stopPropagation();
148
- this.open = !this.open;
149
-
150
- return;
151
- }
152
-
153
- // The arrow keys open a listbox or menu, the way they do a native `<select>`; Alt+Down is the
154
- // combobox convention (APG Select-Only Combobox, Menu Button). They never close one: inside
155
- // the popup they belong to the list. A menu item that opens a submenu is left alone: there
156
- // the arrows move through the parent menu, and the submenu opens with the inline arrow.
157
- if (
158
- ['ArrowDown', 'ArrowUp'].includes(key) &&
159
- !(shiftKey || ctrlKey || metaKey) &&
160
- (!altKey || key === 'ArrowDown') &&
161
- ['listbox', 'menu'].includes(anchorElement.getAttribute('aria-haspopup') ?? '') &&
162
- !anchorElement.matches('[role^="menuitem"]') &&
163
- !this.open
164
- ) {
165
- event.preventDefault();
166
- event.stopPropagation();
167
- this.open = true;
168
- }
169
- });
125
+ // A text field, such as the input of an editable combobox, needs its clicks to place the caret
126
+ // and its Enter and Space keys to type, so it’s not toggled by them. Its consumer provides a
127
+ // separate control, typically an expand button, while the arrow keys still open the popup.
128
+ this.#anchorIsTextField = anchorElement.matches('input, textarea, [contenteditable="true"]');
170
129
 
171
- const removeTransitionStartListener = on(anchorElement, 'transitionstart', () => {
172
- if (this.anchorElement.closest('.hiding, .hidden, [hidden]')) {
173
- this.hideImmediately();
174
- }
175
- });
130
+ const { signal } = this.#anchorListeners;
176
131
 
177
- this.#removeAnchorListeners = [
178
- removeClickListener,
179
- removeKeyDownListener,
180
- removeTransitionStartListener,
181
- ];
132
+ on(anchorElement, 'click', (event) => this.#onAnchorClick(event), { signal });
133
+ on(anchorElement, 'keydown', (event) => this.#onAnchorKeyDown(event), { signal });
134
+ on(anchorElement, 'transitionstart', () => this.#onAnchorTransitionStart(), { signal });
182
135
 
183
136
  // A busy browser can report several changes at once, oldest first, so only the last entry tells
184
137
  // whether the anchor is visible now
@@ -245,39 +198,107 @@ class Popup {
245
198
  identifiedElement.id = this.id;
246
199
  this.anchorElement.setAttribute('aria-controls', this.id);
247
200
 
248
- // Close the popup when the backdrop, a menu item or an option is clicked
249
- const removeClickListener = on(popupElement, 'click', (event) => {
201
+ this.#popupListeners = new AbortController();
202
+
203
+ const { signal } = this.#popupListeners;
204
+
205
+ on(popupElement, 'click', (event) => this.#onPopupClick(event), { signal });
206
+ on(popupElement, 'keydown', (event) => this.#onPopupKeyDown(event), { signal });
207
+ }
208
+
209
+ /**
210
+ * Handle the `click` event on the anchor: toggle the popup.
211
+ * @param {MouseEvent} event `click` event.
212
+ */
213
+ #onAnchorClick(event) {
214
+ if (!this.#anchorIsTextField && !this.isDisabled && !this.isReadOnly) {
215
+ // A menu item’s submenu may already have been opened by hovering, which also happens right
216
+ // before a tap on a touch screen, so a pointer click only opens it rather than toggling it
217
+ // closed. A scripted click, which has no `detail`, still toggles it: that’s how the keyboard
218
+ // navigation closes a submenu.
219
+ this.open =
220
+ event.detail && this.anchorElement.matches('[role="menuitem"]') ? true : !this.open;
221
+ }
222
+ }
223
+
224
+ /**
225
+ * Handle the `keydown` event on the anchor: toggle the popup with Enter or Space, and open it
226
+ * with the arrow keys.
227
+ * @param {KeyboardEvent} event `keydown` event.
228
+ */
229
+ #onAnchorKeyDown(event) {
230
+ const { key, ctrlKey, metaKey, shiftKey, altKey } = event;
231
+ const { anchorElement } = this;
232
+
233
+ if (this.isDisabled || this.isReadOnly) {
234
+ return;
235
+ }
236
+
237
+ if (!this.#anchorIsTextField && ['Enter', ' '].includes(key) && !hasModifier(event)) {
238
+ event.preventDefault();
250
239
  event.stopPropagation();
240
+ this.open = !this.open;
241
+
242
+ return;
243
+ }
251
244
 
252
- // eslint-disable-next-line prefer-destructuring
253
- const target = /** @type {HTMLElement} */ (event.target);
245
+ // The arrow keys open a listbox or menu, the way they do a native `<select>`; Alt+Down is the
246
+ // combobox convention (APG Select-Only Combobox, Menu Button). They never close one: inside the
247
+ // popup they belong to the list. A menu item that opens a submenu is left alone: there the
248
+ // arrows move through the parent menu, and the submenu opens with the inline arrow.
249
+ if (
250
+ ['ArrowDown', 'ArrowUp'].includes(key) &&
251
+ !(shiftKey || ctrlKey || metaKey) &&
252
+ (!altKey || key === 'ArrowDown') &&
253
+ ['listbox', 'menu'].includes(anchorElement.getAttribute('aria-haspopup') ?? '') &&
254
+ !anchorElement.matches('[role^="menuitem"]') &&
255
+ !this.open
256
+ ) {
257
+ event.preventDefault();
258
+ event.stopPropagation();
259
+ this.open = true;
260
+ }
261
+ }
254
262
 
255
- if (
256
- this.open &&
257
- (target === this.popupElement || target.matches('[role^="menuitem"], [role="option"]'))
258
- ) {
259
- this.open = false;
260
- }
261
- });
263
+ /**
264
+ * Handle the `transitionstart` event on the anchor: hide the popup right away when the anchor is
265
+ * being hidden.
266
+ */
267
+ #onAnchorTransitionStart() {
268
+ if (this.anchorElement.closest('.hiding, .hidden, [hidden]')) {
269
+ this.hideImmediately();
270
+ }
271
+ }
262
272
 
263
- const removeKeyDownListener = on(popupElement, 'keydown', (event) => {
264
- const { key, ctrlKey, metaKey, shiftKey, altKey } = event;
265
- const hasModifier = shiftKey || altKey || ctrlKey || metaKey;
273
+ /**
274
+ * Handle the `click` event on the popup: close it when the backdrop, a menu item or an option is
275
+ * clicked.
276
+ * @param {MouseEvent} event `click` event.
277
+ */
278
+ #onPopupClick(event) {
279
+ event.stopPropagation();
266
280
 
267
- if (key === 'Escape' && !hasModifier) {
268
- event.preventDefault();
269
- event.stopPropagation();
270
- this.open = false;
271
- }
272
- });
281
+ // eslint-disable-next-line prefer-destructuring
282
+ const target = /** @type {HTMLElement} */ (event.target);
273
283
 
274
- /**
275
- * Remove the listeners added above.
276
- */
277
- this.#removeEventListeners = () => {
278
- removeClickListener();
279
- removeKeyDownListener();
280
- };
284
+ if (
285
+ this.open &&
286
+ (target === this.popupElement || target.matches('[role^="menuitem"], [role="option"]'))
287
+ ) {
288
+ this.open = false;
289
+ }
290
+ }
291
+
292
+ /**
293
+ * Handle the `keydown` event on the popup: close it with Escape.
294
+ * @param {KeyboardEvent} event `keydown` event.
295
+ */
296
+ #onPopupKeyDown(event) {
297
+ if (event.key === 'Escape' && !hasModifier(event)) {
298
+ event.preventDefault();
299
+ event.stopPropagation();
300
+ this.open = false;
301
+ }
281
302
  }
282
303
 
283
304
  /**
@@ -285,8 +306,8 @@ class Popup {
285
306
  * `aria-controls` attribute is removed as well, since the content is leaving the DOM tree.
286
307
  */
287
308
  detachPopupElement() {
288
- this.#removeEventListeners?.();
289
- this.#removeEventListeners = undefined;
309
+ this.#popupListeners?.abort();
310
+ this.#popupListeners = undefined;
290
311
 
291
312
  if (this.popupElement) {
292
313
  this.viewportResizeObserver.unobserve(this.popupElement);
@@ -403,8 +424,7 @@ class Popup {
403
424
  */
404
425
  destroy() {
405
426
  this.detachPopupElement();
406
- this.#removeAnchorListeners.forEach((removeListener) => removeListener());
407
- this.#removeAnchorListeners = [];
427
+ this.#anchorListeners.abort();
408
428
  this.intersectionObserver?.disconnect();
409
429
  this.resizeObserver?.disconnect();
410
430
  this.viewportResizeObserver?.disconnect();
@@ -1,2 +1,5 @@
1
1
  export function fold(value: string): string;
2
2
  export function normalize(value: string): string;
3
+ export function getItemLabel(element: HTMLElement, { textFallback }?: {
4
+ textFallback?: boolean | undefined;
5
+ }): string;
@@ -26,3 +26,20 @@ export const fold = (value) => value.normalize('NFD').replace(DIACRITIC_RE, '').
26
26
  * @todo Move this to `@sveltia/utils`.
27
27
  */
28
28
  export const normalize = (value) => fold(value.trim());
29
+
30
+ /**
31
+ * Get the visible label of a member of a composite widget, as used for type-ahead: the `data-label`
32
+ * attribute, or else the text of its `.label` element rather than the whole text, which would take
33
+ * in icon ligature names.
34
+ * @internal
35
+ * @param {HTMLElement} element Member element.
36
+ * @param {object} [options] Options.
37
+ * @param {boolean} [options.textFallback] Whether to fall back to the element’s whole text when it
38
+ * has neither. A tree item holds its child items, whose text must not be taken for its own, so the
39
+ * tree turns this off.
40
+ * @returns {string} Label, which is empty if none is found.
41
+ */
42
+ export const getItemLabel = (element, { textFallback = true } = {}) =>
43
+ element.dataset.label ??
44
+ element.querySelector('.label')?.textContent ??
45
+ (textFallback ? (element.textContent ?? '') : '');
@@ -5,7 +5,7 @@
5
5
  * expanding and collapsing parent nodes.
6
6
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/treeview/
7
7
  */
8
- export class Tree {
8
+ export class Tree extends CompositeWidget {
9
9
  /**
10
10
  * Initialize a new `Tree` instance.
11
11
  * @param {HTMLElement} parent Parent element.
@@ -16,14 +16,21 @@ export class Tree {
16
16
  * @param {boolean} [options.expandOnSelect] Whether to expand or collapse a parent item when the
17
17
  * item itself, rather than its chevron, is clicked or activated.
18
18
  */
19
- constructor(parent: HTMLElement, { clickToSelect, selectionFollowsFocus, expandOnSelect }?: {
19
+ constructor(parent: HTMLElement, options?: {
20
20
  clickToSelect?: boolean | undefined;
21
21
  selectionFollowsFocus?: boolean | undefined;
22
22
  expandOnSelect?: boolean | undefined;
23
23
  });
24
- parent: HTMLElement;
25
24
  id: string;
25
+ /**
26
+ * Whether to select an item by clicking on it.
27
+ * @type {boolean}
28
+ */
26
29
  clickToSelect: boolean;
30
+ /**
31
+ * Whether to expand or collapse a parent item when the item itself is clicked or activated.
32
+ * @type {boolean}
33
+ */
27
34
  expandOnSelect: boolean;
28
35
  /**
29
36
  * Whether the selection follows the focus. `undefined` means auto detect.
@@ -35,27 +42,22 @@ export class Tree {
35
42
  * @type {HTMLElement | undefined}
36
43
  */
37
44
  anchor: HTMLElement | undefined;
38
- /**
39
- * Whether {@link activate} has run.
40
- * @type {boolean}
41
- */
42
- activated: boolean;
43
- /**
44
- * Whether {@link destroy} has run, so a pending {@link activate} must not set anything up.
45
- * @type {boolean}
46
- */
47
- destroyed: boolean;
48
- /** @type {(event: MouseEvent) => void} */
49
- _onClick: (event: MouseEvent) => void;
50
- /** @type {(event: KeyboardEvent) => void} */
51
- _onKeyDown: (event: KeyboardEvent) => void;
52
- /** @type {(event: FocusEvent) => void} */
53
- _onFocusIn: (event: FocusEvent) => void;
54
45
  observer: MutationObserver;
55
46
  /**
56
- * Activate the items, unless they already are.
47
+ * Called whenever the params are updated, as well as on creation. Apply the options.
48
+ * @override
49
+ * @param {object} params Updated params.
50
+ * @param {boolean} [params.clickToSelect] Whether to select an item by clicking on it.
51
+ * @param {boolean} [params.selectionFollowsFocus] Whether to select an item as soon as it
52
+ * receives focus. Default: `true` on a single-select tree, `false` on a multi-select tree.
53
+ * @param {boolean} [params.expandOnSelect] Whether to expand or collapse a parent item when the
54
+ * item itself, rather than its chevron, is clicked or activated.
57
55
  */
58
- activate(): void;
56
+ override onUpdate({ clickToSelect, selectionFollowsFocus, expandOnSelect }: {
57
+ clickToSelect?: boolean | undefined;
58
+ selectionFollowsFocus?: boolean | undefined;
59
+ expandOnSelect?: boolean | undefined;
60
+ }): void;
59
61
  /**
60
62
  * Whether more than one item can be selected.
61
63
  * @type {boolean}
@@ -66,16 +68,6 @@ export class Tree {
66
68
  * @type {boolean}
67
69
  */
68
70
  get selectionFollowsFocus(): boolean;
69
- /**
70
- * Whether the widget is disabled.
71
- * @type {boolean}
72
- */
73
- get isDisabled(): boolean;
74
- /**
75
- * Whether the widget is read-only.
76
- * @type {boolean}
77
- */
78
- get isReadOnly(): boolean;
79
71
  /**
80
72
  * List of all the items, including the ones within a collapsed parent, in document order.
81
73
  * @type {HTMLElement[]}
@@ -148,11 +140,6 @@ export class Tree {
148
140
  * whenever the items are added or removed.
149
141
  */
150
142
  update(): void;
151
- /**
152
- * Scroll the given element into view if needed.
153
- * @param {HTMLElement} element Element to be scrolled into view.
154
- */
155
- scrollIntoView(element: HTMLElement): void;
156
143
  /**
157
144
  * Put exactly one item in the tab order. Only the items actually in it are touched: writing a
158
145
  * `tabindex` to every item costs a pass over the whole widget on each arrow key, and all but one
@@ -229,11 +216,10 @@ export class Tree {
229
216
  * @param {KeyboardEvent} event `keydown` event.
230
217
  */
231
218
  onKeyDown(event: KeyboardEvent): void;
232
- /**
233
- * Clean up event listeners.
234
- */
235
- destroy(): void;
236
- #private;
237
219
  }
238
- export function activateTree(params?: object): Attachment;
239
- import type { Attachment } from 'svelte/attachments';
220
+ /**
221
+ * Activate a new tree. Takes the params to be passed to the `Tree` constructor, or a getter
222
+ * function for reactive params, and returns an attachment.
223
+ */
224
+ export const activateTree: (paramsOrGetter?: object | (() => object) | undefined) => import("svelte/attachments").Attachment;
225
+ import { CompositeWidget } from './composite-widget.svelte.js';