@sveltia/ui 0.91.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 (226) 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/conversion/editor-components.js +4 -4
  102. package/dist/components/text-editor/conversion/html/export.js +1 -1
  103. package/dist/components/text-editor/conversion/import.js +32 -26
  104. package/dist/components/text-editor/conversion/markdown/block-conversion.d.ts +4 -0
  105. package/dist/components/text-editor/conversion/markdown/block-conversion.js +154 -0
  106. package/dist/components/text-editor/conversion/markdown/block-structure.d.ts +16 -0
  107. package/dist/components/text-editor/conversion/markdown/block-structure.js +254 -0
  108. package/dist/components/text-editor/conversion/markdown/code-blocks.d.ts +57 -0
  109. package/dist/components/text-editor/conversion/markdown/code-blocks.js +279 -0
  110. package/dist/components/text-editor/conversion/markdown/code-spans.d.ts +19 -0
  111. package/dist/components/text-editor/conversion/markdown/code-spans.js +71 -0
  112. package/dist/components/text-editor/conversion/markdown/formatting.d.ts +22 -0
  113. package/dist/components/text-editor/conversion/markdown/formatting.js +451 -0
  114. package/dist/components/text-editor/conversion/markdown/index.d.ts +10 -0
  115. package/dist/components/text-editor/conversion/markdown/index.js +55 -0
  116. package/dist/components/text-editor/conversion/markdown/placeholders.d.ts +2 -0
  117. package/dist/components/text-editor/conversion/markdown/placeholders.js +229 -0
  118. package/dist/components/text-editor/conversion/markdown/syntax.d.ts +99 -0
  119. package/dist/components/text-editor/conversion/markdown/syntax.js +206 -0
  120. package/dist/components/text-editor/conversion/placeholder-chars.d.ts +43 -0
  121. package/dist/components/text-editor/conversion/placeholder-chars.js +51 -0
  122. package/dist/components/text-editor/conversion/transformers/block-escape.d.ts +1 -0
  123. package/dist/components/text-editor/conversion/transformers/block-escape.js +53 -26
  124. package/dist/components/text-editor/conversion/transformers/code.d.ts +3 -14
  125. package/dist/components/text-editor/conversion/transformers/code.js +78 -16
  126. package/dist/components/text-editor/conversion/transformers/formatted-code.js +3 -18
  127. package/dist/components/text-editor/conversion/transformers/inline-code.js +3 -1
  128. package/dist/components/text-editor/conversion/transformers/link.js +3 -1
  129. package/dist/components/text-editor/conversion/transformers/raw-syntax.d.ts +0 -19
  130. package/dist/components/text-editor/conversion/transformers/raw-syntax.js +22 -93
  131. package/dist/components/text-editor/conversion/transformers/table.js +57 -16
  132. package/dist/components/text-editor/conversion/update.d.ts +19 -2
  133. package/dist/components/text-editor/conversion/update.js +63 -39
  134. package/dist/components/text-editor/core.d.ts +12 -51
  135. package/dist/components/text-editor/core.js +44 -66
  136. package/dist/components/text-editor/editing/raw-markdown.d.ts +3 -0
  137. package/dist/components/text-editor/editing/raw-markdown.js +46 -2
  138. package/dist/components/text-editor/lexical-root.svelte +49 -47
  139. package/dist/components/text-editor/lexical-root.svelte.d.ts +4 -67
  140. package/dist/components/text-editor/shiki/{facade.d.ts → engine.d.ts} +8 -8
  141. package/dist/components/text-editor/shiki/{facade.js → engine.js} +53 -156
  142. package/dist/components/text-editor/shiki/highlighter.js +5 -5
  143. package/dist/components/text-editor/shiki/lexical.d.ts +6 -0
  144. package/dist/components/text-editor/shiki/lexical.js +165 -0
  145. package/dist/components/text-editor/shiki/preload.js +1 -1
  146. package/dist/components/text-editor/shiki/source-highlight.svelte.d.ts +15 -0
  147. package/dist/components/text-editor/shiki/source-highlight.svelte.js +120 -0
  148. package/dist/components/text-editor/shiki/version.d.ts +1 -1
  149. package/dist/components/text-editor/shiki/version.js +1 -1
  150. package/dist/components/text-editor/store.svelte.js +65 -16
  151. package/dist/components/text-editor/text-editor.svelte +53 -145
  152. package/dist/components/text-editor/text-editor.svelte.d.ts +5 -103
  153. package/dist/components/text-editor/toolbar/actions.d.ts +25 -0
  154. package/dist/components/text-editor/toolbar/actions.js +107 -0
  155. package/dist/components/text-editor/toolbar/align-menu-button.svelte +16 -14
  156. package/dist/components/text-editor/toolbar/format-text-button.svelte +26 -24
  157. package/dist/components/text-editor/toolbar/insert-horizontal-rule-button.svelte +23 -23
  158. package/dist/components/text-editor/toolbar/insert-item-button.svelte +1 -1
  159. package/dist/components/text-editor/toolbar/insert-link-button.svelte +47 -51
  160. package/dist/components/text-editor/toolbar/insert-menu-button.svelte +1 -1
  161. package/dist/components/text-editor/toolbar/insert-table-button.svelte +35 -52
  162. package/dist/components/text-editor/toolbar/table-action-menu.svelte +19 -17
  163. package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte +16 -4
  164. package/dist/components/text-editor/toolbar/text-editor-toolbar.svelte.d.ts +0 -8
  165. package/dist/components/text-editor/toolbar/toggle-block-menu-item.svelte +34 -33
  166. package/dist/components/text-editor/widgets/emoji-autocomplete.svelte +7 -6
  167. package/dist/components/text-editor/widgets/floating-link-editor.svelte +19 -32
  168. package/dist/components/text-editor/widgets/table-cell-menu-button.svelte +28 -32
  169. package/dist/components/text-field/date-time-input.svelte +7 -8
  170. package/dist/components/text-field/date-time-input.svelte.d.ts +3 -32
  171. package/dist/components/text-field/number-input.d.ts +0 -2
  172. package/dist/components/text-field/number-input.js +25 -25
  173. package/dist/components/text-field/number-input.svelte +18 -9
  174. package/dist/components/text-field/number-input.svelte.d.ts +1 -1
  175. package/dist/components/text-field/text-area.d.ts +2 -0
  176. package/dist/components/text-field/text-area.js +31 -0
  177. package/dist/components/text-field/text-area.svelte +12 -25
  178. package/dist/components/text-field/text-area.svelte.d.ts +5 -67
  179. package/dist/components/toast/toast.svelte +31 -8
  180. package/dist/components/toast/toast.svelte.d.ts +6 -6
  181. package/dist/components/toolbar/toolbar.svelte +2 -7
  182. package/dist/components/toolbar/toolbar.svelte.d.ts +4 -37
  183. package/dist/components/tree/tree-item.svelte +2 -6
  184. package/dist/components/tree/tree-item.svelte.d.ts +3 -22
  185. package/dist/components/tree/tree.svelte +3 -10
  186. package/dist/components/tree/tree.svelte.d.ts +4 -39
  187. package/dist/components/util/group.svelte +2 -7
  188. package/dist/components/util/group.svelte.d.ts +4 -37
  189. package/dist/components/util/modal.d.ts +9 -0
  190. package/dist/components/util/modal.js +30 -0
  191. package/dist/components/util/modal.svelte +16 -12
  192. package/dist/index.d.ts +1 -1
  193. package/dist/index.js +1 -1
  194. package/dist/locales/hu.yaml +176 -0
  195. package/dist/services/composite-widget.svelte.d.ts +76 -0
  196. package/dist/services/composite-widget.svelte.js +157 -0
  197. package/dist/services/focus.d.ts +2 -0
  198. package/dist/services/focus.js +68 -0
  199. package/dist/services/group.svelte.d.ts +17 -69
  200. package/dist/services/group.svelte.js +128 -391
  201. package/dist/services/label.d.ts +9 -0
  202. package/dist/services/label.js +22 -0
  203. package/dist/services/menu.d.ts +8 -0
  204. package/dist/services/menu.js +237 -0
  205. package/dist/services/navigation.d.ts +9 -0
  206. package/dist/services/navigation.js +13 -0
  207. package/dist/services/number.d.ts +2 -0
  208. package/dist/services/number.js +27 -0
  209. package/dist/services/pointer-drag.d.ts +14 -0
  210. package/dist/services/pointer-drag.js +89 -0
  211. package/dist/services/popup.svelte.js +123 -103
  212. package/dist/services/text.d.ts +3 -0
  213. package/dist/services/text.js +17 -0
  214. package/dist/services/tree.svelte.d.ts +29 -43
  215. package/dist/services/tree.svelte.js +58 -105
  216. package/dist/services/type-ahead.d.ts +10 -1
  217. package/dist/services/type-ahead.js +56 -34
  218. package/dist/typedefs.d.ts +103 -4
  219. package/dist/typedefs.js +60 -4
  220. package/package.json +1 -1
  221. package/dist/components/text-editor/conversion/markdown.d.ts +0 -56
  222. package/dist/components/text-editor/conversion/markdown.js +0 -949
  223. package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte +0 -28
  224. package/dist/components/text-editor/toolbar/code-editor-toolbar.svelte.d.ts +0 -37
  225. package/dist/components/text-editor/toolbar/insert-component.d.ts +0 -3
  226. package/dist/components/text-editor/toolbar/insert-component.js +0 -37
@@ -6,3 +6,12 @@ export function getToggleLabelAttrs({ id, ariaLabel, hasVisibleLabel }: {
6
6
  "aria-label": string | undefined;
7
7
  "aria-labelledby": string | undefined;
8
8
  };
9
+ export function getModalLabelAttrs({ id, title, ariaLabelledby, hasCustomHeader }: {
10
+ id: string;
11
+ title: string | undefined;
12
+ ariaLabelledby: string | undefined;
13
+ hasCustomHeader: boolean;
14
+ }): {
15
+ "aria-label": string | undefined;
16
+ "aria-labelledby": string | undefined;
17
+ };
@@ -13,3 +13,25 @@ export const getToggleLabelAttrs = ({ id, ariaLabel, hasVisibleLabel }) => ({
13
13
  'aria-label': ariaLabel || undefined,
14
14
  'aria-labelledby': !ariaLabel && hasVisibleLabel ? `${id}-label` : undefined,
15
15
  });
16
+
17
+ /**
18
+ * Get the labelling attributes of the `<dialog>` in a `<Dialog>` or `<Drawer>`. The built-in header
19
+ * renders the title in an element the dialog can point at; with a custom header the title is only
20
+ * text, so it becomes `aria-label` unless the consumer names the labelling element.
21
+ * @param {object} args Arguments.
22
+ * @param {string} args.id Component ID. The title has the `${id}-title` ID.
23
+ * @param {string | undefined} args.title Title, if any.
24
+ * @param {string | undefined} args.ariaLabelledby ID of the labelling element named by the
25
+ * consumer, if any.
26
+ * @param {boolean} args.hasCustomHeader Whether the component has a custom header.
27
+ * @returns {{ 'aria-label': string | undefined, 'aria-labelledby': string | undefined }}
28
+ * Attributes.
29
+ */
30
+ export const getModalLabelAttrs = ({ id, title, ariaLabelledby, hasCustomHeader }) => {
31
+ const labelledby = ariaLabelledby ?? (!hasCustomHeader && title ? `${id}-title` : undefined);
32
+
33
+ return {
34
+ 'aria-label': labelledby ? undefined : title || undefined,
35
+ 'aria-labelledby': labelledby,
36
+ };
37
+ };
@@ -0,0 +1,8 @@
1
+ export function getMenuOpener(element: HTMLElement): HTMLElement | null;
2
+ export function getParentMenuItem(menu: HTMLElement): HTMLElement | null;
3
+ export function closeMenuChain(menu: HTMLElement): HTMLElement | null;
4
+ export function leaveMenu(menu: HTMLElement, backwards: boolean): Promise<void>;
5
+ export function enterSubmenu(item: HTMLElement, selector: string): Promise<void>;
6
+ export function leaveSubmenu(item: HTMLElement): void;
7
+ export function handleMenuKey(group: Group, event: KeyboardEvent, currentTarget: HTMLElement | undefined): boolean;
8
+ import type { Group } from './group.svelte.js';
@@ -0,0 +1,237 @@
1
+ /**
2
+ * Menu behavior on top of the `Group` composite widget: leaving a menu with Tab, and stepping into
3
+ * and out of submenus with the inline arrows and Escape, per the ARIA Menu pattern.
4
+ * @see https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
5
+ */
6
+
7
+ import { isRTL } from '@sveltia/i18n';
8
+ import { sleep } from '@sveltia/utils/misc';
9
+ import { focusAdjacentTabStop } from './focus.js';
10
+ import { getArrowKeys, hasModifier, INACTIVE_MEMBER_SELECTOR } from './navigation.js';
11
+
12
+ /**
13
+ * @import { Group } from './group.svelte.js';
14
+ */
15
+
16
+ /**
17
+ * Find the element that opens the menu the given element belongs to. A menu lives outside its
18
+ * opener in the DOM tree, so the link runs the other way: the opener points at the menu’s container
19
+ * with `aria-controls`.
20
+ * @internal
21
+ * @param {HTMLElement} element Element within the menu.
22
+ * @returns {HTMLElement | null} Menu button or parent menu item, if any.
23
+ */
24
+ export const getMenuOpener = (element) => {
25
+ /** @type {HTMLElement | null} */
26
+ let current = element;
27
+
28
+ while (current) {
29
+ if (current.id) {
30
+ const opener = /** @type {HTMLElement | null} */ (
31
+ document.querySelector(`[aria-haspopup="menu"][aria-controls="${CSS.escape(current.id)}"]`)
32
+ );
33
+
34
+ if (opener) {
35
+ return opener;
36
+ }
37
+ }
38
+
39
+ current = current.parentElement;
40
+ }
41
+
42
+ return null;
43
+ };
44
+
45
+ /**
46
+ * Find the menu item that opens the given menu, when it’s a submenu. A menu button is deliberately
47
+ * excluded, because closing a top-level menu is not what “back to the parent item” means.
48
+ * @internal
49
+ * @param {HTMLElement} menu Menu element.
50
+ * @returns {HTMLElement | null} Parent menu item, if any.
51
+ */
52
+ export const getParentMenuItem = (menu) => {
53
+ const opener = getMenuOpener(menu);
54
+
55
+ return opener?.matches('[role^="menuitem"]') ? opener : null;
56
+ };
57
+
58
+ /**
59
+ * Close the given menu along with every menu above it.
60
+ * @internal
61
+ * @param {HTMLElement} menu Menu element.
62
+ * @returns {HTMLElement | null} The element that opens the outermost menu, so the caller can hand
63
+ * focus back to it.
64
+ */
65
+ export const closeMenuChain = (menu) => {
66
+ /** @type {HTMLElement | null} */
67
+ let opener = getMenuOpener(menu);
68
+ /** @type {HTMLElement | null} */
69
+ let outermost = null;
70
+
71
+ // Bounded, so a malformed `aria-controls` cycle can’t hang the page
72
+ for (let i = 0; i < 10 && opener; i += 1) {
73
+ outermost = opener;
74
+
75
+ if (opener.getAttribute('aria-expanded') === 'true') {
76
+ opener.click();
77
+ }
78
+
79
+ const parentMenu = /** @type {HTMLElement | null} */ (
80
+ opener.closest('[role="menu"], [role="menubar"]')
81
+ );
82
+
83
+ opener = parentMenu ? getMenuOpener(parentMenu) : null;
84
+ }
85
+
86
+ return outermost;
87
+ };
88
+
89
+ /**
90
+ * Leave the menu the way Tab should: close it along with every menu above it, then carry focus on
91
+ * to whatever follows the outermost opener. The browser can’t be left to do this itself, because a
92
+ * modal `<dialog>` confines Tab to its own contents.
93
+ * @internal
94
+ * @param {HTMLElement} menu Menu element.
95
+ * @param {boolean} backwards Whether to move to the previous tab stop instead, as Shift+Tab.
96
+ */
97
+ export const leaveMenu = async (menu, backwards) => {
98
+ const opener = closeMenuChain(menu);
99
+
100
+ if (!opener) {
101
+ return;
102
+ }
103
+
104
+ // Somewhere to stand while the menu is torn down, and the fallback if there’s nothing beyond
105
+ opener.focus();
106
+ await sleep(50);
107
+ focusAdjacentTabStop(opener, backwards);
108
+ };
109
+
110
+ /**
111
+ * Open the submenu of the given menu item if needed, and move focus onto its first item.
112
+ * @internal
113
+ * @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
114
+ * @param {string} selector CSS selector matching the menu items.
115
+ */
116
+ export const enterSubmenu = async (item, selector) => {
117
+ const submenuId = item.getAttribute('aria-controls');
118
+
119
+ if (!submenuId) {
120
+ return;
121
+ }
122
+
123
+ if (item.getAttribute('aria-expanded') !== 'true') {
124
+ item.click();
125
+ }
126
+
127
+ const submenu = document.getElementById(submenuId);
128
+
129
+ // The submenu is revealed and positioned asynchronously, and an element that is still hidden or
130
+ // invisible cannot take focus, so keep trying for a few frames
131
+ for (let i = 0; i < 20; i += 1) {
132
+ const first = /** @type {HTMLElement | undefined} */ (
133
+ [...(submenu?.querySelectorAll(selector) ?? [])].find(
134
+ (element) => !element.matches(INACTIVE_MEMBER_SELECTOR),
135
+ )
136
+ );
137
+
138
+ first?.focus();
139
+
140
+ if (first && document.activeElement === first) {
141
+ return;
142
+ }
143
+
144
+ // eslint-disable-next-line no-await-in-loop
145
+ await sleep(20);
146
+ }
147
+ };
148
+
149
+ /**
150
+ * Close a submenu and move focus back onto the menu item that opens it.
151
+ * @internal
152
+ * @param {HTMLElement} item Menu item with `aria-haspopup="menu"`.
153
+ */
154
+ export const leaveSubmenu = (item) => {
155
+ if (item.getAttribute('aria-expanded') === 'true') {
156
+ item.click();
157
+ }
158
+
159
+ item.focus();
160
+ };
161
+
162
+ /**
163
+ * Handle the keys that only a menu responds to: Tab, which leaves the menu entirely rather than
164
+ * stepping through it, Escape, which dismisses just a submenu, and the inline arrows, which step
165
+ * into a submenu and back out again. Called by the group before its own handling, once it has left
166
+ * the keys pressed in a text field to that field.
167
+ * @internal
168
+ * @param {Group} group Menu or menubar group.
169
+ * @param {KeyboardEvent} event `keydown` event.
170
+ * @param {HTMLElement | undefined} currentTarget Member the key was pressed on, if any.
171
+ * @returns {boolean} Whether the key has been dealt with, so the group must leave it alone.
172
+ */
173
+ export const handleMenuKey = (group, event, currentTarget) => {
174
+ const { key, ctrlKey, metaKey, shiftKey, altKey } = event;
175
+ const { parent } = group;
176
+
177
+ // Shift is allowed through here, unlike the keys below, because Shift+Tab leaves the menu just
178
+ // the same. A menu rendered inline, with no opener to return to, leaves Tab to the browser to
179
+ // move focus on as usual.
180
+ if (key === 'Tab' && !ctrlKey && !metaKey && !altKey) {
181
+ if (getMenuOpener(parent)) {
182
+ event.preventDefault();
183
+ leaveMenu(parent, shiftKey);
184
+ }
185
+
186
+ return true;
187
+ }
188
+
189
+ if (hasModifier(event)) {
190
+ return false;
191
+ }
192
+
193
+ // Escape in a submenu dismisses just that submenu. Propagation is stopped so the popup, whose own
194
+ // Escape handler sits on the `<dialog>` this submenu shares with its parent, doesn’t go on to
195
+ // close the whole stack.
196
+ if (key === 'Escape') {
197
+ const parentMenuItem = getParentMenuItem(parent);
198
+
199
+ if (parentMenuItem) {
200
+ event.preventDefault();
201
+ event.stopPropagation();
202
+ leaveSubmenu(parentMenuItem);
203
+
204
+ return true;
205
+ }
206
+
207
+ return false;
208
+ }
209
+
210
+ // Submenu traversal. In a vertical menu the inline arrows are free, so they step into a submenu
211
+ // and back out again, as the Menu pattern expects. Mirrored for RTL.
212
+ if (group.orientation !== 'vertical') {
213
+ return false;
214
+ }
215
+
216
+ const { prevKey: outOfSubmenuKey, nextKey: intoSubmenuKey } = getArrowKeys('horizontal', isRTL());
217
+
218
+ if (key === intoSubmenuKey && currentTarget?.getAttribute('aria-haspopup') === 'menu') {
219
+ event.preventDefault();
220
+ enterSubmenu(currentTarget, group.selector);
221
+
222
+ return true;
223
+ }
224
+
225
+ if (key === outOfSubmenuKey) {
226
+ const parentMenuItem = getParentMenuItem(parent);
227
+
228
+ if (parentMenuItem) {
229
+ event.preventDefault();
230
+ leaveSubmenu(parentMenuItem);
231
+
232
+ return true;
233
+ }
234
+ }
235
+
236
+ return false;
237
+ };
@@ -1,3 +1,12 @@
1
+ /**
2
+ * Arrow key navigation shared by the composite widgets. These functions only map a key and the
3
+ * current position to a new position; finding the members and moving focus is up to the caller.
4
+ */
5
+ /**
6
+ * CSS selector matching the members that are disabled or hidden, which are left out of navigation.
7
+ */
8
+ export const INACTIVE_MEMBER_SELECTOR: "[aria-disabled=\"true\"], [aria-hidden=\"true\"]";
9
+ export function hasModifier({ shiftKey, altKey, ctrlKey, metaKey }: KeyboardEvent): boolean;
1
10
  export function getArrowKeys(orientation: string, rtl: boolean): {
2
11
  prevKey: string;
3
12
  nextKey: string;
@@ -3,6 +3,19 @@
3
3
  * current position to a new position; finding the members and moving focus is up to the caller.
4
4
  */
5
5
 
6
+ /**
7
+ * CSS selector matching the members that are disabled or hidden, which are left out of navigation.
8
+ */
9
+ export const INACTIVE_MEMBER_SELECTOR = '[aria-disabled="true"], [aria-hidden="true"]';
10
+
11
+ /**
12
+ * Check whether any modifier key — Shift, Alt, Control or Meta — is held down with a key press.
13
+ * @param {KeyboardEvent} event `keydown` event.
14
+ * @returns {boolean} Result.
15
+ */
16
+ export const hasModifier = ({ shiftKey, altKey, ctrlKey, metaKey }) =>
17
+ shiftKey || altKey || ctrlKey || metaKey;
18
+
6
19
  /**
7
20
  * Get the arrow keys that move to the previous and next member along the given orientation. In a
8
21
  * right-to-left layout, the inline arrows are mirrored: ArrowLeft moves forward, ArrowRight back.
@@ -0,0 +1,2 @@
1
+ export function normalizeStep(step: number | null | undefined): number;
2
+ export function getMaximumFractionDigits(num: number): number;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Number helpers shared by the components that step through a range of numbers, like
3
+ * `<NumberInput>` and `<Slider>`.
4
+ */
5
+
6
+ /**
7
+ * Get the step to use, falling back to `1` for a value that isn’t a positive number, like `0`,
8
+ * `null` or `NaN`, which would leave the spin buttons and the arrow keys with nowhere to go.
9
+ * @param {number | null | undefined} step Step value.
10
+ * @returns {number} Positive step.
11
+ */
12
+ export const normalizeStep = (step) =>
13
+ typeof step === 'number' && Number.isFinite(step) && step > 0 ? step : 1;
14
+
15
+ /**
16
+ * Count the fraction digits of a number, including one written in exponent notation, such as
17
+ * `1e-7`, so a value stepped by `0.1` can be rounded to `0.3` rather than `0.30000000000000004`.
18
+ * @param {number} num Number.
19
+ * @returns {number} Number of fraction digits, `0` for an integer.
20
+ */
21
+ export const getMaximumFractionDigits = (num) => {
22
+ // A small number like `0.0000001` is stringified in exponent notation as `1e-7`
23
+ const [mantissa, exponent = '0'] = String(num).toLowerCase().split('e');
24
+ const digits = (mantissa.split('.')[1]?.length ?? 0) - Number(exponent);
25
+
26
+ return Math.max(digits, 0);
27
+ };
@@ -0,0 +1,14 @@
1
+ export function startPointerDrag(element: HTMLElement, { pointerId }: PointerEvent, { onMove, onEnd }: PointerDragHandlers): () => void;
2
+ export type PointerDragHandlers = {
3
+ /**
4
+ * Called with each `pointermove` event of the
5
+ * dragging pointer while the drag goes on.
6
+ */
7
+ onMove?: ((event: PointerEvent) => void) | undefined;
8
+ /**
9
+ * Called once when the drag ends, with the
10
+ * `pointerup` or `pointercancel` event, or with the `pointermove` event of a mouse that no longer
11
+ * has the primary button held down.
12
+ */
13
+ onEnd?: ((event: PointerEvent) => void) | undefined;
14
+ };
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Pointer drag lifecycle shared by the widgets that can be dragged, such as `<ResizableHandle>` and
3
+ * `<Slider>`.
4
+ */
5
+
6
+ /**
7
+ * @typedef {object} PointerDragHandlers
8
+ * @property {(event: PointerEvent) => void} [onMove] Called with each `pointermove` event of the
9
+ * dragging pointer while the drag goes on.
10
+ * @property {(event: PointerEvent) => void} [onEnd] Called once when the drag ends, with the
11
+ * `pointerup` or `pointercancel` event, or with the `pointermove` event of a mouse that no longer
12
+ * has the primary button held down.
13
+ */
14
+
15
+ /**
16
+ * Start dragging with the pointer that has just been pressed. The pointer is captured by the given
17
+ * element, and its moves and release are followed on the `document` until the drag ends. Events of
18
+ * other pointers are ignored.
19
+ * @internal
20
+ * @param {HTMLElement} element Element to capture the pointer.
21
+ * @param {PointerEvent} event `pointerdown` event that starts the drag.
22
+ * @param {PointerDragHandlers} handlers Event handlers.
23
+ * @returns {() => void} Function to stop following the pointer without calling `onEnd`, for example
24
+ * when the element is removed in the middle of a drag. It does nothing once the drag has ended.
25
+ */
26
+ export const startPointerDrag = (element, { pointerId }, { onMove, onEnd }) => {
27
+ /**
28
+ * Stop following the pointer, and release it.
29
+ */
30
+ const stop = () => {
31
+ // eslint-disable-next-line no-use-before-define
32
+ document.removeEventListener('pointermove', onPointerMove);
33
+ // eslint-disable-next-line no-use-before-define
34
+ document.removeEventListener('pointerup', onPointerUp);
35
+ // eslint-disable-next-line no-use-before-define
36
+ document.removeEventListener('pointercancel', onPointerUp);
37
+
38
+ if (element.hasPointerCapture(pointerId)) {
39
+ element.releasePointerCapture(pointerId);
40
+ }
41
+ };
42
+
43
+ /**
44
+ * End the drag.
45
+ * @param {PointerEvent} event Event that ends the drag.
46
+ */
47
+ const end = (event) => {
48
+ stop();
49
+ onEnd?.(event);
50
+ };
51
+
52
+ /**
53
+ * Handle the `pointermove` event fired anywhere on the page.
54
+ * @param {PointerEvent} event `pointermove` event.
55
+ */
56
+ const onPointerMove = (event) => {
57
+ if (event.pointerId !== pointerId) {
58
+ return;
59
+ }
60
+
61
+ // The `pointerup` event may never come, for example when a context menu opened during the drag
62
+ // swallowed it, so a mouse moved without the primary button held down ends the drag instead of
63
+ // carrying on. The primary button is the lowest bit of `buttons`.
64
+ if (event.pointerType === 'mouse' && event.buttons % 2 === 0) {
65
+ end(event);
66
+
67
+ return;
68
+ }
69
+
70
+ onMove?.(event);
71
+ };
72
+
73
+ /**
74
+ * Handle the `pointerup` and `pointercancel` events fired anywhere on the page.
75
+ * @param {PointerEvent} event `pointerup` or `pointercancel` event.
76
+ */
77
+ const onPointerUp = (event) => {
78
+ if (event.pointerId === pointerId) {
79
+ end(event);
80
+ }
81
+ };
82
+
83
+ element.setPointerCapture(pointerId);
84
+ document.addEventListener('pointermove', onPointerMove);
85
+ document.addEventListener('pointerup', onPointerUp);
86
+ document.addEventListener('pointercancel', onPointerUp);
87
+
88
+ return stop;
89
+ };