@zuccadev-labs/zuix-zui 0.1.0 → 0.2.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 (282) hide show
  1. package/AGENTS.md +96 -37
  2. package/CHANGELOG.md +215 -0
  3. package/README.md +73 -44
  4. package/THIRD_PARTY_NOTICES.md +71 -0
  5. package/dist/esm/components/actions/Button.d.ts +1 -1
  6. package/dist/esm/components/actions/Button.js +2 -2
  7. package/dist/esm/components/actions/Button.js.map +1 -1
  8. package/dist/esm/components/actions/IconButton.d.ts +1 -1
  9. package/dist/esm/components/actions/IconButton.js +2 -2
  10. package/dist/esm/components/actions/IconButton.js.map +1 -1
  11. package/dist/esm/components/actions/Link.d.ts +1 -1
  12. package/dist/esm/components/actions/Link.js +5 -3
  13. package/dist/esm/components/actions/Link.js.map +1 -1
  14. package/dist/esm/components/actions/SegmentedControl.d.ts +6 -3
  15. package/dist/esm/components/actions/SegmentedControl.js +29 -13
  16. package/dist/esm/components/actions/SegmentedControl.js.map +1 -1
  17. package/dist/esm/components/actions/Toggle.d.ts +5 -3
  18. package/dist/esm/components/actions/Toggle.js +8 -3
  19. package/dist/esm/components/actions/Toggle.js.map +1 -1
  20. package/dist/esm/components/carousel/Carousel.js +3 -8
  21. package/dist/esm/components/carousel/Carousel.js.map +1 -1
  22. package/dist/esm/components/carousel/engine.js +11 -10
  23. package/dist/esm/components/carousel/engine.js.map +1 -1
  24. package/dist/esm/components/carousel/lens.js +2 -2
  25. package/dist/esm/components/carousel/lens.js.map +1 -1
  26. package/dist/esm/components/carousel/lensRenderer.d.ts +6 -0
  27. package/dist/esm/components/carousel/lensRenderer.js +32 -4
  28. package/dist/esm/components/carousel/lensRenderer.js.map +1 -1
  29. package/dist/esm/components/carousel/useCarouselTrack.js +1 -0
  30. package/dist/esm/components/carousel/useCarouselTrack.js.map +1 -1
  31. package/dist/esm/components/content/Card.js.map +1 -1
  32. package/dist/esm/components/content/CodeBlock.js.map +1 -1
  33. package/dist/esm/components/content/Panel.js.map +1 -1
  34. package/dist/esm/components/data/Avatar.js +6 -1
  35. package/dist/esm/components/data/Avatar.js.map +1 -1
  36. package/dist/esm/components/data/AvatarGroup.js +1 -1
  37. package/dist/esm/components/data/AvatarGroup.js.map +1 -1
  38. package/dist/esm/components/data/Chip.js +1 -1
  39. package/dist/esm/components/data/Chip.js.map +1 -1
  40. package/dist/esm/components/data/DataTable.js +2 -17
  41. package/dist/esm/components/data/DataTable.js.map +1 -1
  42. package/dist/esm/components/data/Kbd.js +4 -1
  43. package/dist/esm/components/data/Kbd.js.map +1 -1
  44. package/dist/esm/components/data/Meter.js.map +1 -1
  45. package/dist/esm/components/data/Progress.js.map +1 -1
  46. package/dist/esm/components/data/Rating.d.ts +1 -1
  47. package/dist/esm/components/data/Rating.js +10 -6
  48. package/dist/esm/components/data/Rating.js.map +1 -1
  49. package/dist/esm/components/data/StatTile.js.map +1 -1
  50. package/dist/esm/components/data/Table.js.map +1 -1
  51. package/dist/esm/components/feedback/Alert.js.map +1 -1
  52. package/dist/esm/components/feedback/ErrorBoundary.js +1 -1
  53. package/dist/esm/components/feedback/ErrorBoundary.js.map +1 -1
  54. package/dist/esm/components/feedback/LoadingOverlay.js.map +1 -1
  55. package/dist/esm/components/feedback/Skeleton.js +1 -1
  56. package/dist/esm/components/feedback/Skeleton.js.map +1 -1
  57. package/dist/esm/components/feedback/Spinner.js +1 -1
  58. package/dist/esm/components/feedback/Spinner.js.map +1 -1
  59. package/dist/esm/components/forms/Calendar.d.ts +3 -8
  60. package/dist/esm/components/forms/Calendar.js +41 -44
  61. package/dist/esm/components/forms/Calendar.js.map +1 -1
  62. package/dist/esm/components/forms/Checkbox.d.ts +12 -4
  63. package/dist/esm/components/forms/Checkbox.js +17 -5
  64. package/dist/esm/components/forms/Checkbox.js.map +1 -1
  65. package/dist/esm/components/forms/Combobox.js +30 -26
  66. package/dist/esm/components/forms/Combobox.js.map +1 -1
  67. package/dist/esm/components/forms/DateInput.js +2 -7
  68. package/dist/esm/components/forms/DateInput.js.map +1 -1
  69. package/dist/esm/components/forms/DatePicker.js +54 -21
  70. package/dist/esm/components/forms/DatePicker.js.map +1 -1
  71. package/dist/esm/components/forms/Field.d.ts +6 -0
  72. package/dist/esm/components/forms/Field.js +11 -2
  73. package/dist/esm/components/forms/Field.js.map +1 -1
  74. package/dist/esm/components/forms/FileUpload.js +32 -13
  75. package/dist/esm/components/forms/FileUpload.js.map +1 -1
  76. package/dist/esm/components/forms/Input.js.map +1 -1
  77. package/dist/esm/components/forms/NativeSelect.js +1 -1
  78. package/dist/esm/components/forms/NativeSelect.js.map +1 -1
  79. package/dist/esm/components/forms/OTPInput.js +15 -4
  80. package/dist/esm/components/forms/OTPInput.js.map +1 -1
  81. package/dist/esm/components/forms/Radio.d.ts +5 -4
  82. package/dist/esm/components/forms/Radio.js +17 -3
  83. package/dist/esm/components/forms/Radio.js.map +1 -1
  84. package/dist/esm/components/forms/RadioGroup.d.ts +12 -5
  85. package/dist/esm/components/forms/RadioGroup.js +37 -6
  86. package/dist/esm/components/forms/RadioGroup.js.map +1 -1
  87. package/dist/esm/components/forms/SearchInput.js +2 -7
  88. package/dist/esm/components/forms/SearchInput.js.map +1 -1
  89. package/dist/esm/components/forms/Select.d.ts +5 -2
  90. package/dist/esm/components/forms/Select.js +131 -13
  91. package/dist/esm/components/forms/Select.js.map +1 -1
  92. package/dist/esm/components/forms/Slider.d.ts +23 -5
  93. package/dist/esm/components/forms/Slider.js +92 -5
  94. package/dist/esm/components/forms/Slider.js.map +1 -1
  95. package/dist/esm/components/forms/Switch.d.ts +10 -3
  96. package/dist/esm/components/forms/Switch.js +11 -4
  97. package/dist/esm/components/forms/Switch.js.map +1 -1
  98. package/dist/esm/components/forms/Textarea.d.ts +2 -2
  99. package/dist/esm/components/forms/Textarea.js +10 -3
  100. package/dist/esm/components/forms/Textarea.js.map +1 -1
  101. package/dist/esm/components/forms/index.d.ts +1 -1
  102. package/dist/esm/components/forms/index.js +1 -1
  103. package/dist/esm/components/forms/index.js.map +1 -1
  104. package/dist/esm/components/navigation/Accordion.d.ts +3 -2
  105. package/dist/esm/components/navigation/Accordion.js +57 -10
  106. package/dist/esm/components/navigation/Accordion.js.map +1 -1
  107. package/dist/esm/components/navigation/Breadcrumb.js +1 -1
  108. package/dist/esm/components/navigation/Breadcrumb.js.map +1 -1
  109. package/dist/esm/components/navigation/NavList.d.ts +4 -3
  110. package/dist/esm/components/navigation/NavList.js +10 -6
  111. package/dist/esm/components/navigation/NavList.js.map +1 -1
  112. package/dist/esm/components/navigation/Pagination.js +10 -19
  113. package/dist/esm/components/navigation/Pagination.js.map +1 -1
  114. package/dist/esm/components/navigation/Stepper.d.ts +1 -1
  115. package/dist/esm/components/navigation/Stepper.js +2 -2
  116. package/dist/esm/components/navigation/Stepper.js.map +1 -1
  117. package/dist/esm/components/navigation/Tabs.d.ts +4 -3
  118. package/dist/esm/components/navigation/Tabs.js +39 -5
  119. package/dist/esm/components/navigation/Tabs.js.map +1 -1
  120. package/dist/esm/components/navigation/Tree.d.ts +1 -1
  121. package/dist/esm/components/navigation/Tree.js +19 -3
  122. package/dist/esm/components/navigation/Tree.js.map +1 -1
  123. package/dist/esm/components/overlay/CommandPalette.js +34 -36
  124. package/dist/esm/components/overlay/CommandPalette.js.map +1 -1
  125. package/dist/esm/components/overlay/ConfirmDialog.d.ts +6 -2
  126. package/dist/esm/components/overlay/ConfirmDialog.js +23 -6
  127. package/dist/esm/components/overlay/ConfirmDialog.js.map +1 -1
  128. package/dist/esm/components/overlay/ContextMenu.d.ts +2 -1
  129. package/dist/esm/components/overlay/ContextMenu.js +50 -7
  130. package/dist/esm/components/overlay/ContextMenu.js.map +1 -1
  131. package/dist/esm/components/overlay/Drawer.d.ts +3 -2
  132. package/dist/esm/components/overlay/Drawer.js +11 -6
  133. package/dist/esm/components/overlay/Drawer.js.map +1 -1
  134. package/dist/esm/components/overlay/Menu.d.ts +3 -2
  135. package/dist/esm/components/overlay/Menu.js +27 -8
  136. package/dist/esm/components/overlay/Menu.js.map +1 -1
  137. package/dist/esm/components/overlay/Modal.d.ts +3 -2
  138. package/dist/esm/components/overlay/Modal.js +11 -10
  139. package/dist/esm/components/overlay/Modal.js.map +1 -1
  140. package/dist/esm/components/overlay/Popover.d.ts +20 -5
  141. package/dist/esm/components/overlay/Popover.js +53 -4
  142. package/dist/esm/components/overlay/Popover.js.map +1 -1
  143. package/dist/esm/components/overlay/Toast.d.ts +8 -4
  144. package/dist/esm/components/overlay/Toast.js +145 -50
  145. package/dist/esm/components/overlay/Toast.js.map +1 -1
  146. package/dist/esm/components/overlay/Tooltip.d.ts +2 -2
  147. package/dist/esm/components/overlay/Tooltip.js +64 -7
  148. package/dist/esm/components/overlay/Tooltip.js.map +1 -1
  149. package/dist/esm/components/overlay/internal.d.ts +18 -50
  150. package/dist/esm/components/overlay/internal.js +24 -48
  151. package/dist/esm/components/overlay/internal.js.map +1 -1
  152. package/dist/esm/core/accept.d.ts +5 -0
  153. package/dist/esm/core/accept.js +13 -0
  154. package/dist/esm/core/accept.js.map +1 -0
  155. package/dist/esm/core/compare.d.ts +5 -0
  156. package/dist/esm/core/compare.js +27 -0
  157. package/dist/esm/core/compare.js.map +1 -0
  158. package/dist/esm/core/date.d.ts +27 -0
  159. package/dist/esm/core/date.js +59 -0
  160. package/dist/esm/core/date.js.map +1 -0
  161. package/dist/esm/core/dir.d.ts +4 -0
  162. package/dist/esm/core/dir.js +10 -0
  163. package/dist/esm/core/dir.js.map +1 -0
  164. package/dist/esm/core/focus.d.ts +16 -0
  165. package/dist/esm/core/focus.js +50 -0
  166. package/dist/esm/core/focus.js.map +1 -0
  167. package/dist/esm/core/keys.d.ts +6 -0
  168. package/dist/esm/core/keys.js +14 -0
  169. package/dist/esm/core/keys.js.map +1 -0
  170. package/dist/esm/core/layers.d.ts +33 -0
  171. package/dist/esm/core/layers.js +75 -0
  172. package/dist/esm/core/layers.js.map +1 -0
  173. package/dist/esm/core/long-press.d.ts +13 -0
  174. package/dist/esm/core/long-press.js +33 -0
  175. package/dist/esm/core/long-press.js.map +1 -0
  176. package/dist/esm/core/menu-aim.d.ts +17 -0
  177. package/dist/esm/core/menu-aim.js +48 -0
  178. package/dist/esm/core/menu-aim.js.map +1 -0
  179. package/dist/esm/core/modal-host.d.ts +16 -0
  180. package/dist/esm/core/modal-host.js +59 -0
  181. package/dist/esm/core/modal-host.js.map +1 -0
  182. package/dist/esm/core/pagination.d.ts +6 -0
  183. package/dist/esm/core/pagination.js +32 -0
  184. package/dist/esm/core/pagination.js.map +1 -0
  185. package/dist/esm/core/place.d.ts +54 -0
  186. package/dist/esm/core/place.js +97 -0
  187. package/dist/esm/core/place.js.map +1 -0
  188. package/dist/esm/core/presence.d.ts +7 -0
  189. package/dist/esm/core/presence.js +43 -0
  190. package/dist/esm/core/presence.js.map +1 -0
  191. package/dist/esm/core/ref.d.ts +9 -0
  192. package/dist/esm/core/ref.js +25 -0
  193. package/dist/esm/core/ref.js.map +1 -0
  194. package/dist/esm/core/roving.d.ts +6 -0
  195. package/dist/esm/core/roving.js +27 -0
  196. package/dist/esm/core/roving.js.map +1 -0
  197. package/dist/esm/core/scroll-lock.d.ts +2 -0
  198. package/dist/esm/core/scroll-lock.js +33 -0
  199. package/dist/esm/core/scroll-lock.js.map +1 -0
  200. package/dist/esm/core/search.d.ts +4 -0
  201. package/dist/esm/core/search.js +20 -0
  202. package/dist/esm/core/search.js.map +1 -0
  203. package/dist/esm/core/slider.d.ts +20 -0
  204. package/dist/esm/core/slider.js +66 -0
  205. package/dist/esm/core/slider.js.map +1 -0
  206. package/dist/esm/core/swipe.d.ts +18 -0
  207. package/dist/esm/core/swipe.js +78 -0
  208. package/dist/esm/core/swipe.js.map +1 -0
  209. package/dist/esm/core/timer.d.ts +11 -0
  210. package/dist/esm/core/timer.js +38 -0
  211. package/dist/esm/core/timer.js.map +1 -0
  212. package/dist/esm/core/typeahead.d.ts +19 -0
  213. package/dist/esm/core/typeahead.js +33 -0
  214. package/dist/esm/core/typeahead.js.map +1 -0
  215. package/dist/esm/dom/carousel.d.ts +2 -1
  216. package/dist/esm/dom/carousel.js +18 -30
  217. package/dist/esm/dom/carousel.js.map +1 -1
  218. package/dist/esm/dom/collections.d.ts +2 -1
  219. package/dist/esm/dom/collections.js +67 -72
  220. package/dist/esm/dom/collections.js.map +1 -1
  221. package/dist/esm/dom/forms-calendar.d.ts +4 -5
  222. package/dist/esm/dom/forms-calendar.js +74 -72
  223. package/dist/esm/dom/forms-calendar.js.map +1 -1
  224. package/dist/esm/dom/forms-controls.d.ts +2 -1
  225. package/dist/esm/dom/forms-controls.js +84 -65
  226. package/dist/esm/dom/forms-controls.js.map +1 -1
  227. package/dist/esm/dom/forms-listbox.d.ts +2 -1
  228. package/dist/esm/dom/forms-listbox.js +66 -64
  229. package/dist/esm/dom/forms-listbox.js.map +1 -1
  230. package/dist/esm/dom/forms-popup.d.ts +3 -2
  231. package/dist/esm/dom/forms-popup.js +34 -44
  232. package/dist/esm/dom/forms-popup.js.map +1 -1
  233. package/dist/esm/dom/forms.d.ts +2 -1
  234. package/dist/esm/dom/forms.js +2 -2
  235. package/dist/esm/dom/forms.js.map +1 -1
  236. package/dist/esm/dom/index.d.ts +28 -10
  237. package/dist/esm/dom/index.js +500 -296
  238. package/dist/esm/dom/index.js.map +1 -1
  239. package/dist/esm/dom/shared.d.ts +22 -0
  240. package/dist/esm/dom/shared.js +45 -0
  241. package/dist/esm/dom/shared.js.map +1 -0
  242. package/dist/esm/primitives/dialog.d.ts +17 -0
  243. package/dist/esm/primitives/dialog.js +78 -0
  244. package/dist/esm/primitives/dialog.js.map +1 -0
  245. package/dist/esm/primitives/hooks.d.ts +15 -0
  246. package/dist/esm/primitives/hooks.js +65 -0
  247. package/dist/esm/primitives/hooks.js.map +1 -0
  248. package/dist/esm/primitives/menu.d.ts +26 -0
  249. package/dist/esm/primitives/menu.js +249 -0
  250. package/dist/esm/primitives/menu.js.map +1 -0
  251. package/dist/esm/primitives/native-input.d.ts +13 -0
  252. package/dist/esm/primitives/native-input.js +26 -0
  253. package/dist/esm/primitives/native-input.js.map +1 -0
  254. package/dist/esm/primitives/popup.d.ts +51 -0
  255. package/dist/esm/primitives/popup.js +137 -0
  256. package/dist/esm/primitives/popup.js.map +1 -0
  257. package/dist/esm/primitives/radio-context.d.ts +11 -0
  258. package/dist/esm/primitives/radio-context.js +5 -0
  259. package/dist/esm/primitives/radio-context.js.map +1 -0
  260. package/dist/esm/primitives/slot.d.ts +13 -0
  261. package/dist/esm/primitives/slot.js +39 -0
  262. package/dist/esm/primitives/slot.js.map +1 -0
  263. package/dist/esm/refs.d.ts +8 -0
  264. package/dist/esm/refs.js +32 -0
  265. package/dist/esm/refs.js.map +1 -0
  266. package/dist/styles/actions.css +22 -12
  267. package/dist/styles/base.css +216 -9
  268. package/dist/styles/carousel.css +132 -35
  269. package/dist/styles/content.css +13 -7
  270. package/dist/styles/data.css +61 -35
  271. package/dist/styles/feedback.css +17 -6
  272. package/dist/styles/forms.css +75 -20
  273. package/dist/styles/material.css +9 -4
  274. package/dist/styles/native.css +120 -23
  275. package/dist/styles/navigation.css +630 -154
  276. package/dist/styles/overlay.css +625 -188
  277. package/dist/zui.css +315 -150
  278. package/dist/zui.dom.carousel-gl.js +3 -3
  279. package/dist/zui.dom.js +1 -1
  280. package/html.json +19 -23
  281. package/manifest.json +121 -64
  282. package/package.json +9 -10
@@ -13,6 +13,8 @@
13
13
  // data-z-tooltip="texto" tooltip al pasar el puntero o enfocar
14
14
  // data-z-placement bottom-start (por defecto) | bottom | bottom-end | top-start | top | top-end | right | left
15
15
  // data-z-static en un <dialog>: Escape y clic fuera no lo cierran
16
+ // Los atributos de referencia (`#id`) se resuelven con getElementById: valen ids con cualquier carácter y un valor
17
+ // que no sea un selector válido no lanza. Seguridad (CSP, Trusted Types, texto de la aplicación): ver ./shared.
16
18
  // Tabs, Accordion, Switch, Checkbox, Radio, Toggle y SegmentedControl se activan solos dentro de un contenedor
17
19
  // [data-z-dom]. Tras insertar marcado nuevo: hydrate(contenedor). Eventos: z:open, z:close, z:change, z:select.
18
20
  import { iconSvg, registerIcons } from "@zuccadev-labs/zuix-zicon/dom";
@@ -22,40 +24,32 @@ import { xMark } from "@zuccadev-labs/zuix-zicon/icons/x-mark";
22
24
  import * as carousel from "./carousel.js";
23
25
  import * as collections from "./collections.js";
24
26
  import * as forms from "./forms.js";
27
+ import { trapTab } from "../core/focus.js";
28
+ import { escapeTop } from "../core/layers.js";
29
+ import { lockScroll } from "../core/scroll-lock.js";
30
+ import { createLongPress } from "../core/long-press.js";
31
+ import { followModalHost, modalHost, moveToHost, settleShown } from "../core/modal-host.js";
32
+ import { createMenuAim } from "../core/menu-aim.js";
33
+ import { isRtl } from "../core/dir.js";
34
+ import { place, submenuAnchor, topInset } from "../core/place.js";
35
+ import { afterExit } from "../core/presence.js";
36
+ import { move, moveBoth } from "../core/roving.js";
37
+ import { swipeDirection, swipeToDismiss } from "../core/swipe.js";
38
+ import { createTimer } from "../core/timer.js";
39
+ import { createTypeahead } from "../core/typeahead.js";
40
+ import { byRef, listener, logicalKey, notePress, pressedOnBackdrop, setMarkup } from "./shared.js";
25
41
  // Módulos por grupo: cada uno aporta setup() (listeners, una vez) y hydrate(root) (marcado nuevo).
26
42
  const modules = [forms, collections, carousel];
27
43
  export { carousel } from "./carousel.js";
28
44
  export { openPalette, selectTreeItem, toggleTreeItem, sortTable, setPage } from "./collections.js";
29
- export { setSelectValue, setComboboxOptions, setComboboxLoading, setComboboxValue, setCalendarValue, setDatePickerValue, setSliderValue, setOtpValue } from "./forms.js";
45
+ export { setSelectValue, setComboboxOptions, setComboboxLoading, setComboboxValue, setCalendarValue, setDatePickerValue, setSliderValue, setOtpValue, } from "./forms.js";
30
46
  // Los tres iconos que este módulo dibuja por su cuenta (cierre de aviso, confirmación).
31
47
  registerIcons([xMark, exclamationTriangle, informationCircle]);
32
- const EXIT_MS = 220;
48
+ export { place };
33
49
  const isBrowser = typeof document !== "undefined";
34
50
  function emit(el, name, detail) {
35
51
  return el.dispatchEvent(new CustomEvent(`z:${name}`, { bubbles: true, cancelable: true, detail }));
36
52
  }
37
- function reducedMotion() {
38
- return typeof matchMedia === "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
39
- }
40
- /** Espera la animación de salida (data-state="closed") antes de retirar el elemento. */
41
- function afterExit(el, done) {
42
- if (reducedMotion())
43
- return done();
44
- let finished = false;
45
- const finish = () => {
46
- if (finished)
47
- return;
48
- finished = true;
49
- el.removeEventListener("animationend", onEnd);
50
- done();
51
- };
52
- const onEnd = (event) => {
53
- if (event.target === el)
54
- finish();
55
- };
56
- el.addEventListener("animationend", onEnd);
57
- setTimeout(finish, EXIT_MS);
58
- }
59
53
  /* ---------- Diálogos: <dialog class="z-liquid z-modal"> y <dialog class="z-liquid z-drawer"> ---------- */
60
54
  /** Abre un `<dialog>` como modal: capa superior, foco atrapado y Escape nativos. */
61
55
  export function openDialog(dialog) {
@@ -63,6 +57,8 @@ export function openDialog(dialog) {
63
57
  return;
64
58
  dialog.dataset.state = "open";
65
59
  dialog.showModal();
60
+ // La página no se desplaza bajo un diálogo modal; se libera cuando el diálogo se cierra, por la vía que sea.
61
+ dialog.addEventListener("close", lockScroll(), { once: true });
66
62
  emit(dialog, "open");
67
63
  }
68
64
  /** Cierra con animación de salida. `value` llega a `dialog.returnValue`. */
@@ -71,41 +67,47 @@ export function closeDialog(dialog, value) {
71
67
  return;
72
68
  dialog.dataset.state = "closed";
73
69
  afterExit(dialog, () => {
70
+ // Ya cerrado por otra vía (dialog.close() de la aplicación durante la animación): no se cierra dos veces.
71
+ if (!dialog.open)
72
+ return;
73
+ announced.add(dialog);
74
74
  dialog.close(value);
75
75
  emit(dialog, "close", { value });
76
76
  });
77
77
  }
78
+ // Diálogos cuyo z:close ya se emitió desde closeDialog(): el `close` nativo que llega después no lo repite.
79
+ const announced = new WeakSet();
80
+ /**
81
+ * Cierre que no pasó por closeDialog(): `dialog.close()` de la aplicación, `<form method="dialog">` o el segundo
82
+ * Escape que el navegador no deja cancelar. El estado y el evento z:close quedan igual que en un cierre normal.
83
+ */
84
+ function onNativeClose(event) {
85
+ const dialog = event.target;
86
+ if (!(dialog instanceof HTMLDialogElement) || !dialog.matches(".z-modal, .z-drawer, .z-palette"))
87
+ return;
88
+ if (announced.delete(dialog))
89
+ return;
90
+ dialog.dataset.state = "closed";
91
+ emit(dialog, "close", { value: dialog.returnValue || undefined });
92
+ }
78
93
  /* ---------- Popover, menú y tooltip: elementos con atributo `popover` ---------- */
79
94
  const anchors = new WeakMap();
80
- export function place(el, rect, placement, gap = 6) {
81
- const { width, height } = el.getBoundingClientRect();
82
- const vw = document.documentElement.clientWidth;
83
- const vh = document.documentElement.clientHeight;
84
- let [side, align = "center"] = placement.split("-");
85
- // Voltea al lado opuesto si no cabe.
86
- if (side === "bottom" && rect.bottom + gap + height > vh && rect.top - gap - height >= 0)
87
- side = "top";
88
- else if (side === "top" && rect.top - gap - height < 0)
89
- side = "bottom";
90
- else if (side === "right" && rect.right + gap + width > vw)
91
- side = "left";
92
- else if (side === "left" && rect.left - gap - width < 0)
93
- side = "right";
94
- let x;
95
- let y;
96
- if (side === "top" || side === "bottom") {
97
- y = side === "bottom" ? rect.bottom + gap : rect.top - gap - height;
98
- x = align === "start" ? rect.left : align === "end" ? rect.right - width : rect.left + rect.width / 2 - width / 2;
99
- }
100
- else {
101
- x = side === "right" ? rect.right + gap : rect.left - gap - width;
102
- y = align === "start" ? rect.top : align === "end" ? rect.bottom - height : rect.top + rect.height / 2 - height / 2;
103
- }
104
- el.style.left = `${Math.round(Math.min(Math.max(8, x), Math.max(8, vw - width - 8)))}px`;
105
- el.style.top = `${Math.round(Math.min(Math.max(8, y), Math.max(8, vh - height - 8)))}px`;
106
- el.dataset.side = side;
107
- }
108
- const isDisabled = (item) => item.hasAttribute("data-disabled") || item.disabled === true;
95
+ // Popovers abiertos junto a un elemento: se recolocan si la página se desplaza o cambia de tamaño.
96
+ const followers = new Map();
97
+ function follow(event) {
98
+ if (!followers.size)
99
+ return;
100
+ // El desplazamiento dentro del propio popover (una lista larga) no lo mueve.
101
+ if (event.target instanceof Element && event.target.closest("[popover]"))
102
+ return;
103
+ for (const [el, reposition] of [...followers]) {
104
+ if (!el.isConnected || !el.matches(":popover-open"))
105
+ followers.delete(el);
106
+ else
107
+ reposition();
108
+ }
109
+ }
110
+ const isDisabled = (item) => item.hasAttribute("data-disabled") || item.getAttribute("aria-disabled") === "true" || item.disabled === true;
109
111
  // Un submenú puede ir anidado en el marcado de su menú padre: cada menú solo cuenta sus propias entradas.
110
112
  function menuItems(menu) {
111
113
  return [...menu.querySelectorAll(".z-menu__item")].filter((item) => item.closest(".z-menu") === menu && !isDisabled(item));
@@ -119,18 +121,26 @@ function highlight(menu, item) {
119
121
  item.setAttribute("data-highlighted", "");
120
122
  item.focus({ preventScroll: true });
121
123
  }
122
- /** Abre un elemento `[popover]` anclado a `anchor` (un elemento o un punto de la ventana). */
123
- export function openPopover(el, anchor, placement = "bottom-start") {
124
+ /**
125
+ * Abre un elemento `[popover]` anclado a `anchor` (un elemento o un punto de la ventana). Anclado a un elemento, lo
126
+ * sigue cuando la página se desplaza o cambia de tamaño; `follow: false` lo deja donde se abrió.
127
+ */
128
+ export function openPopover(el, anchor, placement = "bottom-start", options = {}) {
124
129
  if (!el.hasAttribute("popover"))
125
130
  el.setAttribute("popover", "auto");
126
131
  el.dataset.state = "open";
127
132
  if (!el.matches(":popover-open"))
128
133
  el.showPopover();
129
- const rect = anchor instanceof Element ? anchor.getBoundingClientRect() : new DOMRect(anchor.x, anchor.y, 0, 0);
130
- place(el, rect, placement, anchor instanceof Element ? 6 : 0);
134
+ const position = () => {
135
+ const rect = anchor instanceof Element ? anchor.getBoundingClientRect() : new DOMRect(anchor.x, anchor.y, 0, 0);
136
+ place(el, rect, placement, anchor instanceof Element ? 6 : 0);
137
+ };
138
+ position();
131
139
  if (anchor instanceof Element) {
132
140
  anchors.set(el, anchor);
133
141
  anchor.setAttribute("aria-expanded", "true");
142
+ if (options.follow !== false)
143
+ followers.set(el, position);
134
144
  }
135
145
  if (el.classList.contains("z-menu"))
136
146
  highlight(el, menuItems(el)[0]);
@@ -167,15 +177,7 @@ function detectSourceNesting() {
167
177
  inner.remove();
168
178
  }
169
179
  function submenuOf(trigger) {
170
- const selector = trigger.getAttribute("data-z-submenu");
171
- if (!selector)
172
- return null;
173
- try {
174
- return document.querySelector(selector);
175
- }
176
- catch {
177
- return null;
178
- }
180
+ return byRef(trigger.getAttribute("data-z-submenu"));
179
181
  }
180
182
  function describeSubmenu(trigger, sub = submenuOf(trigger)) {
181
183
  trigger.setAttribute("aria-haspopup", "menu");
@@ -232,24 +234,30 @@ export function openSubmenu(trigger, focusFirst = false) {
232
234
  anchors.set(sub, trigger);
233
235
  trigger.setAttribute("aria-expanded", "true");
234
236
  trigger.dataset.state = "open";
235
- // Pegado al borde del menú padre y con la primera entrada a la altura del disparador.
236
- const menuRect = parent.getBoundingClientRect();
237
- const itemRect = trigger.getBoundingClientRect();
238
- const style = getComputedStyle(sub);
239
- const inset = (parseFloat(style.paddingTop) || 0) + (parseFloat(style.borderTopWidth) || 0);
240
- place(sub, new DOMRect(menuRect.left, itemRect.top - inset, menuRect.width, itemRect.height + inset * 2), "right-start", 4);
237
+ // Pegado al borde del menú padre y con la primera entrada a la altura del disparador. En RTL abre hacia la izquierda.
238
+ const position = () => {
239
+ place(sub, submenuAnchor(parent.getBoundingClientRect(), trigger.getBoundingClientRect(), topInset(sub)), isRtl(sub) ? "left-start" : "right-start", 4);
240
+ };
241
+ position();
242
+ followers.set(sub, position);
241
243
  emit(sub, "open");
242
244
  }
243
245
  if (focusFirst)
244
246
  highlight(sub, menuItems(sub)[0]);
245
247
  }
246
248
  let subTimer;
247
- /** Puntero sobre una entrada: la resalta y, con un pequeño retardo, abre su submenú o cierra el de otra entrada. */
248
- function onMenuPointer(item) {
249
+ const aim = createMenuAim();
250
+ /**
251
+ * Puntero sobre una entrada: la resalta y, con un pequeño retardo, abre su submenú o cierra el de otra entrada.
252
+ * Mientras el puntero va camino del submenú abierto (zona de gracia), las entradas que cruza no cuentan.
253
+ */
254
+ function onMenuPointer(item, event) {
249
255
  const menu = item.closest(".z-menu");
256
+ const open = openChild(menu);
257
+ if (open && submenuOf(item) !== open && aim.blocks({ x: event.clientX, y: event.clientY }))
258
+ return;
250
259
  highlight(menu, item);
251
260
  clearTimeout(subTimer);
252
- const open = openChild(menu);
253
261
  if (item.hasAttribute("data-z-submenu")) {
254
262
  if (submenuOf(item) !== open)
255
263
  subTimer = setTimeout(() => openSubmenu(item), 100);
@@ -257,21 +265,12 @@ function onMenuPointer(item) {
257
265
  else if (open)
258
266
  subTimer = setTimeout(() => closePopover(open), 200);
259
267
  }
260
- let typed = "";
261
- let typedAt = 0;
262
- /** Búsqueda por letra: enfoca la siguiente entrada cuyo texto empieza por lo tecleado. */
268
+ // Búsqueda por letra: enfoca la siguiente entrada cuyo texto empieza por lo tecleado.
269
+ const menuSearch = createTypeahead(600);
263
270
  function typeahead(menu, key) {
264
- const now = Date.now();
265
- typed = now - typedAt > 600 ? key : typed + key;
266
- typedAt = now;
267
- const query = typed.toLowerCase();
268
- const repeated = [...query].every((char) => char === query[0]);
269
271
  const items = menuItems(menu);
270
- const at = Math.max(0, items.indexOf(document.activeElement));
271
- // Una letra (o la misma repetida) avanza desde la entrada siguiente; una palabra busca desde la actual.
272
- const order = repeated ? [...items.slice(at + 1), ...items.slice(0, at + 1)] : [...items.slice(at), ...items.slice(0, at)];
273
- const text = (item) => (item.querySelector(".z-menu__text") ?? item).textContent.trim().toLowerCase();
274
- const hit = order.find((item) => text(item).startsWith(repeated ? query[0] : query));
272
+ const text = (item) => (item.querySelector(".z-menu__text") ?? item).textContent ?? "";
273
+ const hit = items[menuSearch(items.map(text), key, items.indexOf(document.activeElement))];
275
274
  if (hit)
276
275
  highlight(menu, hit);
277
276
  return hit !== undefined;
@@ -280,6 +279,7 @@ function onPopoverToggle(event) {
280
279
  const el = event.target;
281
280
  if (event.newState !== "closed" || !el.hasAttribute?.("popover"))
282
281
  return;
282
+ followers.delete(el);
283
283
  const anchor = anchors.get(el);
284
284
  if (anchor) {
285
285
  anchor.setAttribute("aria-expanded", "false");
@@ -293,129 +293,106 @@ function onPopoverToggle(event) {
293
293
  emit(el, "close");
294
294
  }
295
295
  /* ---------- Tooltip ---------- */
296
+ // WCAG 1.4.13: la burbuja se puede descartar sin mover el puntero (Escape), el puntero puede pasar a ella sin que
297
+ // se cierre (hoverable) y sigue visible mientras el puntero o el foco estén en el disparador o en la burbuja.
298
+ const TIP_OPEN_MS = 350;
299
+ const TIP_CLOSE_MS = 120;
296
300
  let tip;
301
+ let tipHost;
297
302
  let tipTimer;
298
303
  let tipId = 0;
304
+ const describedBy = (el) => (el.getAttribute("aria-describedby") ?? "").split(/\s+/).filter(Boolean);
299
305
  function showTooltip(target) {
300
306
  const text = target.getAttribute("data-z-tooltip");
301
307
  if (!text)
302
308
  return;
309
+ clearTimeout(tipTimer);
310
+ if (tipHost === target)
311
+ return;
303
312
  hideTooltip();
304
313
  tipTimer = setTimeout(() => {
314
+ if (!target.isConnected)
315
+ return;
305
316
  tip = document.createElement("div");
306
317
  tip.className = "z-liquid z-tooltip";
307
318
  tip.setAttribute("role", "tooltip");
308
319
  tip.setAttribute("popover", "manual");
309
320
  tip.id = `z-tip-${++tipId}`;
310
321
  tip.textContent = text;
311
- document.body.append(tip);
322
+ // Dentro del diálogo modal que contiene al disparador: fuera de él la burbuja quedaría inerte.
323
+ (target.closest("dialog[open]") ?? document.body).append(tip);
312
324
  tip.showPopover();
313
325
  place(tip, target.getBoundingClientRect(), target.getAttribute("data-z-placement") ?? "top");
314
- target.setAttribute("aria-describedby", tip.id);
315
- }, 350);
326
+ // Se añade a la descripción que el control ya tuviera (la ayuda de un Field), sin sustituirla.
327
+ target.setAttribute("aria-describedby", [...describedBy(target), tip.id].join(" "));
328
+ tipHost = target;
329
+ }, TIP_OPEN_MS);
316
330
  }
317
331
  function hideTooltip() {
318
332
  clearTimeout(tipTimer);
319
333
  if (!tip)
320
334
  return;
321
- document.querySelector(`[aria-describedby="${tip.id}"]`)?.removeAttribute("aria-describedby");
335
+ if (tipHost) {
336
+ const rest = describedBy(tipHost).filter((id) => id !== tip.id);
337
+ if (rest.length)
338
+ tipHost.setAttribute("aria-describedby", rest.join(" "));
339
+ else
340
+ tipHost.removeAttribute("aria-describedby");
341
+ }
322
342
  tip.remove();
323
343
  tip = undefined;
344
+ tipHost = undefined;
324
345
  }
325
- function viewport(position) {
346
+ /** Cierre diferido: da tiempo a que el puntero cruce del disparador a la burbuja. */
347
+ function scheduleHideTooltip() {
348
+ clearTimeout(tipTimer);
349
+ tipTimer = setTimeout(hideTooltip, TIP_CLOSE_MS);
350
+ }
351
+ // Avisos que ya hicieron su entrada: al mudar o volver a mostrar la región no la repiten.
352
+ const toastShown = new WeakSet();
353
+ let unfollowToasts;
354
+ /**
355
+ * Lleva la región de avisos al diálogo modal de arriba (fuera de él sería inerte) o a `<body>`, y la vuelve a mostrar
356
+ * para que quede por encima de todo en la capa superior.
357
+ */
358
+ function raiseToasts(host, to = modalHost()) {
359
+ moveToHost(host, to);
360
+ if (host.matches(":popover-open"))
361
+ host.hidePopover();
362
+ host.showPopover();
363
+ settleShown(host, '.z-toast[data-state="open"]', toastShown);
364
+ }
365
+ function viewport(position, label) {
326
366
  let host = document.querySelector(".z-toast-viewport");
327
367
  if (!host) {
328
- host = document.createElement("ol");
368
+ host = document.createElement("div");
329
369
  host.className = "z-toast-viewport";
330
370
  host.setAttribute("popover", "manual");
371
+ // Región con nombre (landmark); cada aviso lleva role status o alert.
372
+ host.setAttribute("role", "region");
331
373
  host.tabIndex = -1;
332
- document.body.append(host);
333
374
  }
375
+ host.setAttribute("aria-label", label);
334
376
  host.dataset.position = position;
335
- // Capa superior: los avisos quedan por encima de un <dialog> abierto.
336
- if (host.matches(":popover-open"))
337
- host.hidePopover();
338
- host.showPopover();
339
- return host;
340
- }
341
- const SWIPE_THRESHOLD = 50;
342
- /**
343
- * Deslizar para descartar, con ratón, lápiz o dedo, igual que el Toast de React: hacia la derecha, o hacia el borde
344
- * (arriba o abajo) en las posiciones centradas. El CSS lee `data-swipe` y las mismas variables que escribe Radix.
345
- */
346
- function swipeToDismiss(item, position, dismiss, pause, resume) {
347
- const vertical = position.endsWith("center");
348
- const sign = position === "top-center" ? -1 : 1;
349
- const axis = vertical ? "y" : "x";
350
- let swipe;
351
- // Solo cuenta el avance en la dirección de descarte.
352
- const delta = (event, from) => Math.max(0, (vertical ? event.clientY - from.y : event.clientX - from.x) * sign) * sign;
353
- item.addEventListener("pointerdown", (event) => {
354
- if (event.button !== 0 || item.dataset.state === "closed")
355
- return;
356
- swipe = { id: event.pointerId, x: event.clientX, y: event.clientY, active: false };
357
- });
358
- item.addEventListener("pointermove", (event) => {
359
- if (!swipe || event.pointerId !== swipe.id)
360
- return;
361
- const moved = delta(event, swipe);
362
- if (!swipe.active) {
363
- // Un dedo tiembla más que un ratón: margen mayor antes de dar el gesto por empezado.
364
- const buffer = event.pointerType === "touch" ? 10 : 2;
365
- const cross = Math.abs(vertical ? event.clientX - swipe.x : event.clientY - swipe.y);
366
- if (Math.abs(moved) > buffer) {
367
- swipe.active = true;
368
- pause();
369
- item.dataset.swipe = "move";
370
- try {
371
- item.setPointerCapture(event.pointerId);
372
- }
373
- catch { /* puntero sintético o ya liberado */ }
374
- }
375
- else if (cross > buffer) {
376
- swipe = undefined;
377
- return;
378
- }
379
- else
380
- return;
381
- }
382
- item.style.setProperty(`--radix-toast-swipe-move-${axis}`, `${moved}px`);
377
+ raiseToasts(host);
378
+ // Mientras haya avisos, la región sigue al diálogo modal que se abra o se cierre.
379
+ const region = host;
380
+ unfollowToasts ??= followModalHost((to) => {
381
+ if (region.isConnected || region.children.length)
382
+ raiseToasts(region, to);
383
383
  });
384
- const end = (event, cancelled) => {
385
- if (!swipe || event.pointerId !== swipe.id)
386
- return;
387
- const { active } = swipe;
388
- const moved = delta(event, swipe);
389
- swipe = undefined;
390
- if (!active)
391
- return;
392
- item.style.removeProperty(`--radix-toast-swipe-move-${axis}`);
393
- // El clic que sigue al gesto no debe activar la acción ni el cierre que quedaran bajo el dedo.
394
- const swallow = (click) => { click.preventDefault(); click.stopPropagation(); };
395
- item.addEventListener("click", swallow, { capture: true, once: true });
396
- setTimeout(() => item.removeEventListener("click", swallow, { capture: true }));
397
- if (!cancelled && Math.abs(moved) > SWIPE_THRESHOLD) {
398
- item.style.setProperty(`--radix-toast-swipe-end-${axis}`, `${moved}px`);
399
- item.dataset.swipe = "end";
400
- dismiss();
401
- }
402
- else {
403
- item.dataset.swipe = "cancel";
404
- resume();
405
- }
406
- };
407
- item.addEventListener("pointerup", (event) => end(event, false));
408
- item.addEventListener("pointercancel", (event) => end(event, true));
384
+ return host;
409
385
  }
410
386
  /** Muestra un aviso con el mismo marcado que el Toast de React. Devuelve una función para descartarlo. */
411
- export function toast({ title, description, intent = "info", duration = 5000, action, position = "bottom-right", closeLabel = "Close" }) {
412
- const host = viewport(position);
413
- const item = document.createElement("li");
387
+ export function toast({ title, description, intent = "info", duration = 5000, action, position = "bottom-right", closeLabel = "Close", regionLabel = "Notifications (F8)", }) {
388
+ const host = viewport(position, regionLabel);
389
+ const item = document.createElement("div");
414
390
  item.className = "z-liquid z-toast";
415
391
  item.dataset.intent = intent;
416
392
  item.dataset.state = "open";
417
393
  item.setAttribute("role", intent === "danger" || intent === "warning" ? "alert" : "status");
418
- item.innerHTML = `<span class="z-toast__dot" aria-hidden="true"></span><div class="z-toast__content"><div class="z-toast__title"></div></div><button type="button" class="z-overlay-close z-toast__close">${iconSvg("x-mark", { size: 16 })}</button>`;
394
+ item.tabIndex = 0;
395
+ setMarkup(item, `<span class="z-toast__dot" aria-hidden="true"></span><div class="z-toast__content"><div class="z-toast__title"></div></div><button type="button" class="z-overlay-close z-toast__close">${iconSvg("x-mark", { size: 16 })}</button>`);
419
396
  const content = item.querySelector(".z-toast__content");
420
397
  content.querySelector(".z-toast__title").textContent = title;
421
398
  item.querySelector(".z-toast__close").setAttribute("aria-label", closeLabel);
@@ -425,16 +402,30 @@ export function toast({ title, description, intent = "info", duration = 5000, ac
425
402
  text.textContent = description;
426
403
  content.append(text);
427
404
  }
428
- let timer;
405
+ // Cierre automático con pausa (WCAG 2.2.1): el tiempo no corre mientras el puntero o el foco están en el aviso,
406
+ // ni durante un gesto de descarte; al salir continúa con lo que quedaba.
407
+ const timer = createTimer(duration, () => dismiss());
408
+ const hold = (reason) => timer.hold(reason);
409
+ const release = (reason) => timer.release(reason);
410
+ const whileOpen = new AbortController();
429
411
  const dismiss = () => {
430
- clearTimeout(timer);
412
+ timer.stop();
413
+ whileOpen.abort();
431
414
  if (item.dataset.state === "closed")
432
415
  return;
433
416
  item.dataset.state = "closed";
417
+ // El foco no se queda en un aviso que desaparece: vuelve a donde estaba antes de entrar en la región.
418
+ const hadFocus = item.contains(document.activeElement);
434
419
  afterExit(item, () => {
435
420
  item.remove();
436
- if (!host.children.length && host.matches(":popover-open"))
437
- host.hidePopover();
421
+ if (!host.children.length) {
422
+ if (host.matches(":popover-open"))
423
+ host.hidePopover();
424
+ unfollowToasts?.();
425
+ unfollowToasts = undefined;
426
+ }
427
+ if (hadFocus)
428
+ (toastReturn?.isConnected ? toastReturn : null)?.focus({ preventScroll: true });
438
429
  });
439
430
  };
440
431
  if (action) {
@@ -449,27 +440,66 @@ export function toast({ title, description, intent = "info", duration = 5000, ac
449
440
  content.append(button);
450
441
  }
451
442
  item.querySelector(".z-toast__close").addEventListener("click", dismiss);
452
- swipeToDismiss(item, position, dismiss, () => clearTimeout(timer), () => { if (duration > 0)
453
- timer = setTimeout(dismiss, duration); });
443
+ item.addEventListener("pointerenter", () => hold("pointer"));
444
+ item.addEventListener("pointerleave", () => release("pointer"));
445
+ item.addEventListener("focusin", () => hold("focus"));
446
+ item.addEventListener("focusout", (event) => {
447
+ if (!item.contains(event.relatedTarget))
448
+ release("focus");
449
+ });
450
+ item.addEventListener("keydown", (event) => {
451
+ if (event.key === "Escape")
452
+ dismiss();
453
+ });
454
+ // Con la ventana sin foco nadie está leyendo el aviso: el tiempo se detiene hasta que vuelve.
455
+ window.addEventListener("blur", () => hold("window"), { signal: whileOpen.signal });
456
+ window.addEventListener("focus", () => release("window"), { signal: whileOpen.signal });
457
+ swipeToDismiss(item, {
458
+ direction: swipeDirection(position),
459
+ onStart: () => hold("swipe"),
460
+ onCancel: () => release("swipe"),
461
+ onDismiss: dismiss,
462
+ });
454
463
  host.append(item);
455
- if (duration > 0)
456
- timer = setTimeout(dismiss, duration);
464
+ toastShown.add(item);
465
+ timer.start();
457
466
  return dismiss;
458
467
  }
459
- /** Diálogo de confirmación; resuelve `true` si se confirma. Mismo marcado que ConfirmDialog. */
460
- export function confirm({ title, description, intent = "default", confirmLabel = "Confirm", cancelLabel = "Cancel" }) {
468
+ // Elemento que tenía el foco antes de entrar en la región de avisos con F8.
469
+ let toastReturn = null;
470
+ /** F8 lleva el foco al aviso más reciente, como el Toast de React. */
471
+ function focusToasts() {
472
+ const host = document.querySelector(".z-toast-viewport");
473
+ const last = host?.querySelector('.z-toast[data-state="open"]:last-of-type');
474
+ if (!host || !last)
475
+ return false;
476
+ if (!host.contains(document.activeElement))
477
+ toastReturn = document.activeElement instanceof HTMLElement ? document.activeElement : null;
478
+ last.focus();
479
+ return true;
480
+ }
481
+ let confirmId = 0;
482
+ /**
483
+ * Diálogo de confirmación; resuelve `true` si se confirma. Mismo marcado que ConfirmDialog: `role="alertdialog"`
484
+ * con nombre (aria-labelledby) y descripción (aria-describedby). Escape cancela; el clic en el velo no cierra.
485
+ */
486
+ export function confirm({ title, description, intent = "default", confirmLabel = "Confirm", cancelLabel = "Cancel", }) {
461
487
  const dialog = document.createElement("dialog");
488
+ const id = `z-confirm-${++confirmId}`;
462
489
  dialog.className = "z-liquid z-modal z-confirm";
463
490
  dialog.dataset.intent = intent;
464
491
  dialog.setAttribute("role", "alertdialog");
492
+ dialog.setAttribute("aria-labelledby", `${id}-title`);
465
493
  dialog.setAttribute("data-z-static", "");
466
- dialog.innerHTML = `<header class="z-modal__header"><span class="z-confirm__icon">${iconSvg(intent === "danger" ? "exclamation-triangle" : "information-circle", { size: 16 })}</span><div class="z-modal__heading"><h2 class="z-modal__title"></h2></div></header><footer class="z-modal__footer"><button type="button" class="z-dialog-btn" data-variant="secondary" value="cancel"></button><button type="button" class="z-dialog-btn" data-variant="${intent === "danger" ? "danger" : "primary"}" value="confirm"></button></footer>`;
494
+ setMarkup(dialog, `<header class="z-modal__header"><span class="z-confirm__icon">${iconSvg(intent === "danger" ? "exclamation-triangle" : "information-circle", { size: 16 })}</span><div class="z-modal__heading"><h2 class="z-modal__title" id="${id}-title"></h2></div></header><footer class="z-modal__footer"><button type="button" class="z-dialog-btn" data-variant="secondary" value="cancel"></button><button type="button" class="z-dialog-btn" data-variant="${intent === "danger" ? "danger" : "primary"}" value="confirm"></button></footer>`);
467
495
  dialog.querySelector(".z-modal__title").textContent = title;
468
496
  if (description) {
469
497
  const text = document.createElement("p");
470
498
  text.className = "z-modal__description";
499
+ text.id = `${id}-description`;
471
500
  text.textContent = description;
472
501
  dialog.querySelector(".z-modal__heading").append(text);
502
+ dialog.setAttribute("aria-describedby", text.id);
473
503
  }
474
504
  const [cancel, ok] = dialog.querySelectorAll(".z-dialog-btn");
475
505
  cancel.textContent = cancelLabel;
@@ -478,6 +508,17 @@ export function confirm({ title, description, intent = "default", confirmLabel =
478
508
  return new Promise((resolve) => {
479
509
  cancel.addEventListener("click", () => closeDialog(dialog, "cancel"));
480
510
  ok.addEventListener("click", () => closeDialog(dialog, "confirm"));
511
+ // Escape (y el gesto atrás del sistema) cancelan, como el ConfirmDialog de React. El velo sigue sin cerrar.
512
+ dialog.addEventListener("keydown", (event) => {
513
+ if (event.key !== "Escape" || event.defaultPrevented)
514
+ return;
515
+ event.preventDefault();
516
+ closeDialog(dialog, "cancel");
517
+ });
518
+ dialog.addEventListener("cancel", (event) => {
519
+ event.preventDefault();
520
+ closeDialog(dialog, "cancel");
521
+ });
481
522
  dialog.addEventListener("close", () => {
482
523
  resolve(dialog.returnValue === "confirm");
483
524
  dialog.remove();
@@ -518,9 +559,19 @@ function selectTabQuiet(tabs, value) {
518
559
  }
519
560
  }
520
561
  /* ---------- Acordeón ---------- */
521
- function setSection(item, open) {
522
- const trigger = item.querySelector(".z-accordion__trigger");
523
- const content = item.querySelector(".z-accordion__content");
562
+ // Un acordeón puede llevar otro dentro de una sección: cada uno solo cuenta sus propias piezas.
563
+ const ownPart = (item, selector) => [...item.querySelectorAll(selector)].find((el) => el.closest(".z-accordion__item") === item);
564
+ const accordionItems = (root) => [...root.querySelectorAll(".z-accordion__item")].filter((item) => item.closest(".z-accordion") === root);
565
+ const sectionValue = (item) => item.dataset.value ?? ownPart(item, ".z-accordion__content")?.id ?? "";
566
+ // Secciones que están terminando su animación de cierre: función que cancela la espera.
567
+ const closing = new WeakMap();
568
+ /**
569
+ * Abre o cierra una sección. Con `animate`, la altura se anima entre 0 y `--z-accordion-content-height` (medida
570
+ * aquí) y, al cerrar, el contenido se oculta cuando termina la animación. Sin él (marcado inicial) no hay animación.
571
+ */
572
+ function setSection(item, open, animate = false) {
573
+ const trigger = ownPart(item, ".z-accordion__trigger");
574
+ const content = ownPart(item, ".z-accordion__content");
524
575
  const state = open ? "open" : "closed";
525
576
  item.dataset.state = state;
526
577
  if (trigger) {
@@ -528,8 +579,22 @@ function setSection(item, open) {
528
579
  trigger.setAttribute("aria-expanded", String(open));
529
580
  }
530
581
  if (content) {
582
+ const changed = content.dataset.state !== state || content.hidden === open;
531
583
  content.dataset.state = state;
532
- content.hidden = !open;
584
+ closing.get(content)?.();
585
+ closing.delete(content);
586
+ if (!animate || !changed) {
587
+ content.style.animation = "none";
588
+ content.hidden = !open;
589
+ return;
590
+ }
591
+ content.style.removeProperty("animation");
592
+ content.hidden = false;
593
+ content.style.setProperty("--z-accordion-content-height", `${content.scrollHeight}px`);
594
+ if (!open)
595
+ closing.set(content, afterExit(content, () => {
596
+ content.hidden = true;
597
+ }));
533
598
  }
534
599
  }
535
600
  /* ---------- Delegación de eventos ---------- */
@@ -563,12 +628,52 @@ function setChecked(el, checked) {
563
628
  }
564
629
  const isChecked = (el) => el.getAttribute("aria-checked") === "true" || el.dataset.state === "checked" || el.dataset.state === "on";
565
630
  function toggleChecked(el) {
566
- if (el.hasAttribute("data-disabled") || el.disabled)
631
+ if (isDisabled(el))
567
632
  return;
568
633
  const next = !isChecked(el);
569
634
  setChecked(el, next);
570
635
  emit(el, "change", { checked: next });
571
636
  }
637
+ /* ---------- Rating: .z-rating[data-interactive] > .z-rating__stars[role="radiogroup"] ---------- */
638
+ const ratingStars = (group) => [...group.querySelectorAll(".z-rating__star")];
639
+ const starValue = (star, index) => Number(star.dataset.star) || index + 1;
640
+ /** Dibuja la valoración: estrellas rellenas hasta `value`, radio marcado y parada de tabulación. */
641
+ function paintRating(group, value, shown = value) {
642
+ const stars = ratingStars(group);
643
+ stars.forEach((star, index) => {
644
+ const n = starValue(star, index);
645
+ const checked = n === value;
646
+ star.setAttribute("aria-checked", String(checked));
647
+ star.tabIndex = checked || ((value < 1 || value > stars.length) && index === 0) ? 0 : -1;
648
+ star.toggleAttribute("data-filled", n <= shown);
649
+ const variant = n <= shown ? "solid" : "outline";
650
+ const glyph = star.querySelector("z-icon");
651
+ const svg = star.querySelector("svg.z-icon");
652
+ if (glyph) {
653
+ if ((glyph.getAttribute("variant") ?? "outline") !== variant)
654
+ glyph.setAttribute("variant", variant);
655
+ }
656
+ else if (svg && svg.getAttribute("data-variant") !== variant) {
657
+ const holder = document.createElement("span");
658
+ setMarkup(holder, iconSvg(svg.getAttribute("data-icon") ?? "star", { variant, size: svg.getAttribute("width") ?? 18 }));
659
+ svg.replaceWith(...holder.childNodes);
660
+ }
661
+ });
662
+ }
663
+ const ratingValue = (group) => {
664
+ const stars = ratingStars(group);
665
+ const at = stars.findIndex((star) => star.getAttribute("aria-checked") === "true");
666
+ return at < 0 ? 0 : starValue(stars[at], at);
667
+ };
668
+ /** Elige una estrella: z:change { value } en `.z-rating`, igual que `onChange` del Rating de React. */
669
+ function rate(group, star) {
670
+ const stars = ratingStars(group);
671
+ const value = starValue(star, stars.indexOf(star));
672
+ const before = ratingValue(group);
673
+ paintRating(group, value);
674
+ if (value !== before)
675
+ emit(group.closest(".z-rating") ?? group, "change", { value });
676
+ }
572
677
  /** Prepara el marcado estático dentro de `[data-z-dom]`: orden de tabulación de pestañas y grupos de radio. */
573
678
  export function hydrate(root = document) {
574
679
  for (const tabs of root.querySelectorAll("[data-z-dom] .z-tabs, .z-tabs[data-z-dom]")) {
@@ -581,8 +686,12 @@ export function hydrate(root = document) {
581
686
  el.setAttribute("aria-checked", el.dataset.state === "indeterminate" ? "mixed" : String(isChecked(el)));
582
687
  }
583
688
  for (const group of root.querySelectorAll('[data-z-dom] [role="radiogroup"]')) {
689
+ if (group.matches(".z-rating__stars")) {
690
+ paintRating(group, ratingValue(group));
691
+ continue;
692
+ }
584
693
  const radios = [...group.querySelectorAll('[role="radio"]')];
585
- const current = radios.find(isChecked) ?? radios.find((r) => !r.disabled);
694
+ const current = radios.find(isChecked) ?? radios.find((r) => !isDisabled(r));
586
695
  for (const radio of radios)
587
696
  radio.tabIndex = radio === current ? 0 : -1;
588
697
  }
@@ -599,7 +708,9 @@ function onClick(event) {
599
708
  return;
600
709
  const opener = target.closest("[data-z-open]");
601
710
  if (opener) {
602
- const el = document.querySelector(opener.getAttribute("data-z-open"));
711
+ if (isDisabled(opener))
712
+ return;
713
+ const el = byRef(opener.getAttribute("data-z-open"));
603
714
  if (el instanceof HTMLDialogElement)
604
715
  openDialog(el);
605
716
  else if (el) {
@@ -620,10 +731,10 @@ function onClick(event) {
620
731
  closeDialog(dialog, closer.getAttribute("value") ?? undefined);
621
732
  return;
622
733
  }
623
- // Clic en el velo de un <dialog>: el objetivo es el propio diálogo.
734
+ // Clic en el velo de un <dialog>: el objetivo es el propio diálogo. Solo cuenta si la pulsación también empezó
735
+ // en el velo: soltar fuera tras seleccionar texto dentro del diálogo no lo cierra.
624
736
  if (target instanceof HTMLDialogElement && target.matches(".z-modal, .z-drawer") && !target.hasAttribute("data-z-static")) {
625
- const r = target.getBoundingClientRect();
626
- if (event.clientX < r.left || event.clientX > r.right || event.clientY < r.top || event.clientY > r.bottom)
737
+ if (pressedOnBackdrop(target, event))
627
738
  closeDialog(target);
628
739
  return;
629
740
  }
@@ -644,26 +755,43 @@ function onClick(event) {
644
755
  if (!inDom(target))
645
756
  return;
646
757
  const tab = target.closest(".z-tabs__tab");
647
- if (tab && !tab.hasAttribute("data-disabled"))
648
- return selectTab(tab.closest(".z-tabs"), tabKey(tab));
758
+ if (tab && !isDisabled(tab)) {
759
+ selectTab(tab.closest(".z-tabs"), tabKey(tab));
760
+ return;
761
+ }
649
762
  const trigger = target.closest(".z-accordion__trigger");
650
- if (trigger && !trigger.hasAttribute("data-disabled")) {
763
+ if (trigger) {
651
764
  const section = trigger.closest(".z-accordion__item");
765
+ if (!section || isDisabled(trigger) || section.hasAttribute("data-disabled"))
766
+ return;
652
767
  const root = section.closest(".z-accordion");
653
768
  const open = trigger.dataset.state !== "open";
654
- if (open && root?.dataset.type !== "multiple")
655
- for (const other of root?.querySelectorAll(".z-accordion__item") ?? [])
769
+ if (open && root && root.dataset.type !== "multiple")
770
+ for (const other of accordionItems(root))
656
771
  if (other !== section)
657
- setSection(other, false);
658
- setSection(section, open);
772
+ setSection(other, false, true);
773
+ setSection(section, open, true);
774
+ // Secciones abiertas, como `onValueChange` del Accordion de React.
775
+ if (root)
776
+ emit(root, "change", {
777
+ value: accordionItems(root)
778
+ .filter((item) => item.dataset.state === "open")
779
+ .map(sectionValue),
780
+ });
659
781
  return;
660
782
  }
661
783
  const check = target.closest('[role="switch"], [role="checkbox"]');
662
- if (check)
663
- return toggleChecked(check);
784
+ if (check) {
785
+ toggleChecked(check);
786
+ return;
787
+ }
664
788
  const radio = target.closest('[role="radio"]');
665
- if (radio && !radio.hasAttribute("data-disabled") && !radio.disabled) {
789
+ if (radio && !isDisabled(radio)) {
666
790
  const group = radio.closest('[role="radiogroup"]');
791
+ if (group?.matches(".z-rating__stars")) {
792
+ rate(group, radio);
793
+ return;
794
+ }
667
795
  for (const other of group?.querySelectorAll('[role="radio"]') ?? [radio]) {
668
796
  setChecked(other, other === radio);
669
797
  other.tabIndex = other === radio ? 0 : -1;
@@ -680,23 +808,18 @@ function onClick(event) {
680
808
  emit(pressed, "change", { pressed: next });
681
809
  }
682
810
  }
683
- function move(list, current, key, vertical) {
684
- const i = list.indexOf(current);
685
- const next = vertical ? "ArrowDown" : "ArrowRight";
686
- const prev = vertical ? "ArrowUp" : "ArrowLeft";
687
- if (key === next)
688
- return list[(i + 1) % list.length];
689
- if (key === prev)
690
- return list[(i - 1 + list.length) % list.length];
691
- if (key === "Home")
692
- return list[0];
693
- if (key === "End")
694
- return list[list.length - 1];
695
- return undefined;
696
- }
697
811
  function onKeydown(event) {
698
812
  const target = event.target;
699
- if (!(target instanceof Element))
813
+ // El autocompletado del navegador emite `keydown` sin `key`.
814
+ if (!(target instanceof Element) || typeof event.key !== "string")
815
+ return;
816
+ if (event.key === "F8" && !event.ctrlKey && !event.metaKey && !event.altKey && focusToasts()) {
817
+ event.preventDefault();
818
+ return;
819
+ }
820
+ // Escape es de la capa de arriba (la lista de un Select o un Combobox, el panel de un DatePicker) antes que del
821
+ // menú o del diálogo que la contenga. Un evento ya cancelado no cierra nada.
822
+ if (event.key === "Escape" && (event.defaultPrevented || escapeTop(event)))
700
823
  return;
701
824
  const menu = target.closest(".z-menu[popover]");
702
825
  if (menu) {
@@ -715,12 +838,13 @@ function onKeydown(event) {
715
838
  }
716
839
  else if (event.key === "Tab")
717
840
  closeChain(menu);
718
- else if ((event.key === "ArrowRight" || event.key === "Enter" || event.key === " ") && own?.hasAttribute("data-z-submenu")) {
841
+ else if ((logicalKey(event.key, menu) === "ArrowRight" || event.key === "Enter" || event.key === " ") &&
842
+ own?.hasAttribute("data-z-submenu")) {
719
843
  event.preventDefault();
720
844
  clearTimeout(subTimer);
721
845
  openSubmenu(own, true);
722
846
  }
723
- else if (event.key === "ArrowLeft" && parentTrigger?.hasAttribute("data-z-submenu")) {
847
+ else if (logicalKey(event.key, menu) === "ArrowLeft" && parentTrigger?.hasAttribute("data-z-submenu")) {
724
848
  // Cierra solo este submenú; el foco vuelve a la entrada que lo abrió.
725
849
  event.preventDefault();
726
850
  closePopover(menu);
@@ -734,6 +858,13 @@ function onKeydown(event) {
734
858
  }
735
859
  return;
736
860
  }
861
+ // Tab en un diálogo modal da la vuelta dentro de él: el navegador dejaría salir el foco hacia su propia interfaz.
862
+ if (event.key === "Tab" && !event.defaultPrevented) {
863
+ const dialog = target.closest("dialog.z-modal, dialog.z-drawer, dialog.z-palette");
864
+ if (dialog?.open && dialog.matches(":modal") && trapTab(dialog, event))
865
+ event.preventDefault();
866
+ return;
867
+ }
737
868
  // Escape en un diálogo: se cierra con animación, o no se cierra si es estático.
738
869
  if (event.key === "Escape") {
739
870
  const dialog = target.closest("dialog.z-modal, dialog.z-drawer");
@@ -746,10 +877,29 @@ function onKeydown(event) {
746
877
  }
747
878
  if (!inDom(target))
748
879
  return;
880
+ // Una casilla se marca con Espacio; Intro no la cambia (APG checkbox; igual que en React).
881
+ if (event.key === "Enter" && target.matches('button[role="checkbox"]')) {
882
+ event.preventDefault();
883
+ return;
884
+ }
885
+ // Acordeón (APG): las flechas, Inicio y Fin llevan el foco de una cabecera a otra.
886
+ const header = target.closest(".z-accordion__trigger");
887
+ if (header) {
888
+ const root = header.closest(".z-accordion");
889
+ const next = root
890
+ ? move([...root.querySelectorAll(".z-accordion__trigger")].filter((t) => t.closest(".z-accordion") === root && !isDisabled(t)), header, event.key, true)
891
+ : undefined;
892
+ if (next) {
893
+ event.preventDefault();
894
+ next.focus();
895
+ }
896
+ return;
897
+ }
749
898
  const radio = target.closest('[role="radio"]');
750
899
  if (radio) {
751
- const list = [...(radio.closest('[role="radiogroup"]')?.querySelectorAll('[role="radio"]') ?? [])].filter((r) => !r.disabled);
752
- const next = move(list, radio, event.key, true) ?? move(list, radio, event.key, false);
900
+ const list = [...(radio.closest('[role="radiogroup"]')?.querySelectorAll('[role="radio"]') ?? [])].filter((r) => !isDisabled(r));
901
+ // En RTL la flecha izquierda avanza.
902
+ const next = moveBoth(list, radio, logicalKey(event.key, radio));
753
903
  if (next) {
754
904
  event.preventDefault();
755
905
  next.focus();
@@ -760,8 +910,9 @@ function onKeydown(event) {
760
910
  const tab = target.closest(".z-tabs__tab");
761
911
  if (tab) {
762
912
  const tabs = tab.closest(".z-tabs");
763
- const list = [...tabs.querySelectorAll(".z-tabs__tab")].filter((t) => t.closest(".z-tabs") === tabs && !t.hasAttribute("data-disabled"));
764
- const next = move(list, tab, event.key, tabs.dataset.orientation === "vertical");
913
+ const list = [...tabs.querySelectorAll(".z-tabs__tab")].filter((t) => t.closest(".z-tabs") === tabs && !isDisabled(t));
914
+ const vertical = tabs.dataset.orientation === "vertical";
915
+ const next = move(list, tab, vertical ? event.key : logicalKey(event.key, tab), vertical);
765
916
  if (next) {
766
917
  event.preventDefault();
767
918
  next.focus();
@@ -769,36 +920,76 @@ function onKeydown(event) {
769
920
  }
770
921
  }
771
922
  }
772
- const LONG_PRESS_MS = 600;
773
- let longPress;
774
- let longPressOpened = 0;
775
- function cancelLongPress() {
776
- if (longPress)
777
- clearTimeout(longPress.timer);
778
- longPress = undefined;
923
+ // Pulsación larga con dedo o lápiz: iOS no emite `contextmenu`, y un Chromium de escritorio con pantalla táctil tampoco.
924
+ const contextPress = createLongPress((point, event) => {
925
+ const menu = contextMenuAt(event.target);
926
+ if (!menu)
927
+ return;
928
+ openPopover(menu, point, "bottom-start");
929
+ // Al levantar el dedo, el cierre ligero de los popovers `auto` lo trataría como un clic fuera. Con el puntero
930
+ // capturado por el menú, ese `pointerup` cae dentro y no lo cierra; si aun así se cerró, se vuelve a abrir.
931
+ try {
932
+ menu.setPointerCapture(event.pointerId);
933
+ }
934
+ catch {
935
+ // Puntero sintético o ya liberado.
936
+ }
937
+ const lift = new AbortController();
938
+ const onLift = () => {
939
+ lift.abort();
940
+ setTimeout(() => {
941
+ if (!menu.matches(":popover-open"))
942
+ openPopover(menu, point, "bottom-start");
943
+ });
944
+ };
945
+ window.addEventListener("pointerup", onLift, { capture: true, signal: lift.signal });
946
+ window.addEventListener("pointercancel", onLift, { capture: true, signal: lift.signal });
947
+ });
948
+ function contextMenuAt(target) {
949
+ const zone = target instanceof Element ? target.closest("[data-z-context]") : null;
950
+ return zone ? byRef(zone.getAttribute("data-z-context")) : null;
779
951
  }
780
- let wired = false;
781
- /** Conecta el comportamiento. Idempotente; llamar una vez al cargar. */
952
+ let wiring;
953
+ /**
954
+ * Conecta el comportamiento. Idempotente; llamar una vez al cargar. Devuelve `destroy`, que retira todos los
955
+ * listeners del documento (pruebas, microfrontends, navegación con sustitución de página).
956
+ */
782
957
  export function init() {
783
- if (!isBrowser || wired)
784
- return;
785
- wired = true;
786
- document.addEventListener("click", onClick);
787
- document.addEventListener("keydown", onKeydown);
788
- document.addEventListener("toggle", onPopoverToggle, true);
789
- document.addEventListener("cancel", (event) => {
790
- // Evita el cierre nativo sin animación; onKeydown ya lo gestiona.
791
- if (event.target.matches?.("dialog.z-modal, dialog.z-drawer"))
792
- event.preventDefault();
958
+ if (!isBrowser)
959
+ return () => { };
960
+ if (wiring)
961
+ return destroy;
962
+ wiring = new AbortController();
963
+ const on = listener(wiring.signal);
964
+ on(document, "click", onClick);
965
+ on(document, "keydown", onKeydown);
966
+ // Escape cierra la burbuja sin mover el puntero ni el foco (WCAG 1.4.13); no consume la tecla.
967
+ on(document, "keydown", (event) => {
968
+ if (event.key === "Escape")
969
+ hideTooltip();
793
970
  }, true);
794
- document.addEventListener("contextmenu", (event) => {
795
- const zone = event.target.closest?.("[data-z-context]");
796
- const menu = zone && document.querySelector(zone.getAttribute("data-z-context"));
971
+ on(document, "pointerdown", notePress, true);
972
+ on(document, "toggle", onPopoverToggle, true);
973
+ on(document, "close", onNativeClose, true);
974
+ on(document, "scroll", follow, { capture: true, passive: true });
975
+ on(window, "resize", follow);
976
+ on(document, "cancel", (event) => {
977
+ // Cierre pedido por el navegador (Escape, gesto atrás del sistema): pasa por la animación de salida, o no
978
+ // ocurre si el diálogo es estático. Con Escape ya lo hizo onKeydown; closeDialog() no repite.
979
+ const dialog = event.target;
980
+ if (!(dialog instanceof HTMLDialogElement) || !dialog.matches("dialog.z-modal, dialog.z-drawer"))
981
+ return;
982
+ event.preventDefault();
983
+ if (!dialog.hasAttribute("data-z-static"))
984
+ closeDialog(dialog);
985
+ }, true);
986
+ on(document, "contextmenu", (event) => {
987
+ const menu = contextMenuAt(event.target);
797
988
  if (!menu)
798
989
  return;
799
990
  event.preventDefault();
800
- // Con el dedo ya lo abre (o lo va a abrir) la pulsación larga de más abajo: Android emite además `contextmenu`.
801
- if (longPress || Date.now() - longPressOpened < 1000)
991
+ // Con el dedo ya lo abre (o lo va a abrir) la pulsación larga: Android emite además `contextmenu`.
992
+ if (contextPress.pending() || contextPress.sinceFired() < 1000)
802
993
  return;
803
994
  const point = { x: event.clientX, y: event.clientY };
804
995
  const open = () => openPopover(menu, point, "bottom-start");
@@ -806,78 +997,91 @@ export function init() {
806
997
  // clic fuera y cerraría el menú recién abierto (Firefox y WebKit). Con el botón aún pulsado se abre al soltar.
807
998
  if (event.buttons & 2) {
808
999
  const release = new AbortController();
809
- const onRelease = () => { release.abort(); setTimeout(open); };
1000
+ const onRelease = () => {
1001
+ release.abort();
1002
+ setTimeout(open);
1003
+ };
810
1004
  window.addEventListener("pointerup", onRelease, { capture: true, signal: release.signal });
811
1005
  window.addEventListener("pointercancel", onRelease, { capture: true, signal: release.signal });
812
1006
  }
813
1007
  else
814
1008
  open();
815
1009
  });
816
- // Pulsación larga con dedo o lápiz: iOS no emite `contextmenu`, y un Chromium de escritorio con pantalla táctil tampoco.
817
- document.addEventListener("pointerdown", (event) => {
818
- cancelLongPress();
819
- if (event.pointerType === "mouse")
820
- return;
821
- const zone = event.target.closest?.("[data-z-context]");
822
- const menu = zone && document.querySelector(zone.getAttribute("data-z-context"));
823
- if (!menu)
824
- return;
825
- const point = { x: event.clientX, y: event.clientY };
826
- const timer = setTimeout(() => {
827
- longPress = undefined;
828
- longPressOpened = Date.now();
829
- openPopover(menu, point, "bottom-start");
830
- // Al levantar el dedo, el cierre ligero de los popovers `auto` lo trataría como un clic fuera. Con el puntero
831
- // capturado por el menú, ese `pointerup` cae dentro y no lo cierra; si aun así se cerró, se vuelve a abrir.
832
- try {
833
- menu.setPointerCapture(event.pointerId);
834
- }
835
- catch { /* puntero sintético o ya liberado */ }
836
- const lift = new AbortController();
837
- const onLift = () => {
838
- lift.abort();
839
- setTimeout(() => { if (!menu.matches(":popover-open"))
840
- openPopover(menu, point, "bottom-start"); });
841
- };
842
- window.addEventListener("pointerup", onLift, { capture: true, signal: lift.signal });
843
- window.addEventListener("pointercancel", onLift, { capture: true, signal: lift.signal });
844
- }, LONG_PRESS_MS);
845
- longPress = { id: event.pointerId, x: point.x, y: point.y, timer };
846
- }, true);
847
- document.addEventListener("pointermove", (event) => {
848
- if (longPress && event.pointerId === longPress.id && Math.hypot(event.clientX - longPress.x, event.clientY - longPress.y) > 10)
849
- cancelLongPress();
1010
+ on(document, "pointerdown", (event) => {
1011
+ contextPress.cancel();
1012
+ if (contextMenuAt(event.target))
1013
+ contextPress.down(event);
850
1014
  }, true);
851
- document.addEventListener("pointerup", cancelLongPress, true);
852
- document.addEventListener("pointercancel", cancelLongPress, true);
853
- document.addEventListener("pointerover", (event) => {
1015
+ on(document, "pointermove", (event) => contextPress.move(event), true);
1016
+ on(document, "pointerup", () => contextPress.cancel(), true);
1017
+ on(document, "pointercancel", () => contextPress.cancel(), true);
1018
+ on(document, "pointerover", (event) => {
854
1019
  const item = event.target.closest?.(".z-menu[popover] .z-menu__item");
855
1020
  if (item && !isDisabled(item))
856
- onMenuPointer(item);
1021
+ onMenuPointer(item, event);
857
1022
  const host = event.target.closest?.("[data-z-tooltip]");
858
- if (host && !host.hasAttribute("aria-describedby"))
1023
+ if (host)
859
1024
  showTooltip(host);
1025
+ // El puntero llegó a la burbuja: sigue abierta.
1026
+ else if (tip?.contains(event.target))
1027
+ clearTimeout(tipTimer);
860
1028
  });
861
- document.addEventListener("pointerout", (event) => {
862
- const host = event.target.closest?.("[data-z-tooltip]");
863
- if (host && !host.contains(event.relatedTarget))
864
- hideTooltip();
1029
+ on(document, "pointerout", (event) => {
1030
+ const from = event.target;
1031
+ const to = event.relatedTarget;
1032
+ // El puntero sale de una entrada con el submenú abierto: empieza la zona de gracia hacia él.
1033
+ const trigger = from.closest?.('.z-menu__item[data-z-submenu][aria-expanded="true"]');
1034
+ const sub = trigger && !trigger.contains(to) ? submenuOf(trigger) : null;
1035
+ if (sub?.matches(":popover-open"))
1036
+ aim.start({ x: event.clientX, y: event.clientY }, sub.getBoundingClientRect(), sub.dataset.side === "left" ? "left" : "right");
1037
+ const host = from.closest?.("[data-z-tooltip]");
1038
+ if (host && !host.contains(to)) {
1039
+ // Con el foco en el disparador la burbuja se queda: se cierra al perder el foco o con Escape.
1040
+ if (tipHost === host && host.matches(":focus-visible"))
1041
+ return;
1042
+ if (tip?.contains(to))
1043
+ return;
1044
+ if (tipHost === host)
1045
+ scheduleHideTooltip();
1046
+ else
1047
+ hideTooltip();
1048
+ }
1049
+ else if (tip?.contains(from) && !tip.contains(to) && !(tipHost?.contains(to) ?? false))
1050
+ scheduleHideTooltip();
865
1051
  });
866
- document.addEventListener("focusin", (event) => {
1052
+ on(document, "focusin", (event) => {
867
1053
  const host = event.target.closest?.("[data-z-tooltip]");
868
1054
  if (host?.matches(":focus-visible"))
869
1055
  showTooltip(host);
870
1056
  });
871
- document.addEventListener("focusout", hideTooltip);
1057
+ on(document, "focusout", (event) => {
1058
+ if (!tipHost || tipHost.contains(event.target))
1059
+ hideTooltip();
1060
+ });
872
1061
  for (const mod of modules)
873
- mod.setup();
1062
+ mod.setup(on);
874
1063
  const ready = () => {
875
1064
  detectSourceNesting();
876
1065
  hydrate();
877
1066
  };
878
1067
  if (document.readyState === "loading")
879
- document.addEventListener("DOMContentLoaded", ready);
1068
+ on(document, "DOMContentLoaded", ready);
880
1069
  else
881
1070
  ready();
1071
+ return destroy;
1072
+ }
1073
+ /**
1074
+ * Deshace `init()`: retira los listeners del documento y de la ventana y cierra la burbuja de ayuda. El marcado
1075
+ * queda como está (los diálogos y popovers abiertos siguen abiertos). `init()` se puede volver a llamar.
1076
+ */
1077
+ export function destroy() {
1078
+ wiring?.abort();
1079
+ wiring = undefined;
1080
+ contextPress.cancel();
1081
+ clearTimeout(subTimer);
1082
+ aim.clear();
1083
+ hideTooltip();
1084
+ unfollowToasts?.();
1085
+ unfollowToasts = undefined;
882
1086
  }
883
1087
  //# sourceMappingURL=index.js.map