@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
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Claves de React para una lista sin identificadores propios: cada elemento se identifica por su contenido y, si se
3
+ * repite, por el número de repetición (`"Ctrl"`, `"Ctrl#1"`). A diferencia del índice, la clave sigue al elemento
4
+ * cuando la lista se reordena o pierde entradas por delante.
5
+ */
6
+ export declare function occurrenceKeys(ids: readonly string[]): string[];
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Claves de React para una lista sin identificadores propios: cada elemento se identifica por su contenido y, si se
3
+ * repite, por el número de repetición (`"Ctrl"`, `"Ctrl#1"`). A diferencia del índice, la clave sigue al elemento
4
+ * cuando la lista se reordena o pierde entradas por delante.
5
+ */
6
+ export function occurrenceKeys(ids) {
7
+ const seen = new Map();
8
+ return ids.map((id) => {
9
+ const count = seen.get(id) ?? 0;
10
+ seen.set(id, count + 1);
11
+ return count === 0 ? id : `${id}#${count}`;
12
+ });
13
+ }
14
+ //# sourceMappingURL=keys.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/core/keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACxB,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Claves de React para una lista sin identificadores propios: cada elemento se identifica por su contenido y, si se\n * repite, por el número de repetición (`\"Ctrl\"`, `\"Ctrl#1\"`). A diferencia del índice, la clave sigue al elemento\n * cuando la lista se reordena o pierde entradas por delante.\n */\nexport function occurrenceKeys(ids: readonly string[]): string[] {\n const seen = new Map<string, number>();\n return ids.map((id) => {\n const count = seen.get(id) ?? 0;\n seen.set(id, count + 1);\n return count === 0 ? id : `${id}#${count}`;\n });\n}\n"]}
@@ -0,0 +1,33 @@
1
+ export interface Layer {
2
+ /** Verdadero si el nodo pertenece a la capa: su contenido, su disparador o un submenú suyo. */
3
+ contains(target: Node): boolean;
4
+ /** Diálogo modal: lo que queda debajo es inerte y no se evalúa. */
5
+ modal?: boolean;
6
+ /** Escape con esta capa arriba del todo. Sin manejador, la tecla sigue su curso. */
7
+ onEscape?(event: KeyboardEvent): void;
8
+ onPointerOutside?(event: PointerEvent): void;
9
+ onFocusOutside?(event: FocusEvent): void;
10
+ }
11
+ /**
12
+ * Escape para la capa de arriba. Devuelve true si la capa lo atendió (y el evento queda con `preventDefault`).
13
+ * Un evento ya cancelado no cierra nada: un campo que usa Escape para limpiarse no cierra además el diálogo.
14
+ */
15
+ export declare function escapeTop(event: KeyboardEvent): boolean;
16
+ /** Añade una capa encima de la pila. Devuelve la función que la retira. */
17
+ export declare function pushLayer(layer: Layer, doc?: Document): () => void;
18
+ /** Verdadero si `layer` es la capa de arriba. */
19
+ export declare const isTopLayer: (layer: Layer) => boolean;
20
+ /** Capa modal más alta, si hay alguna. */
21
+ export declare const topModal: () => Layer | undefined;
22
+ /** Listener de `pointerdown` (captura): recuerda dónde empezó la pulsación. */
23
+ export declare function notePress(event: {
24
+ target: EventTarget | null;
25
+ clientX: number;
26
+ clientY: number;
27
+ }): void;
28
+ /** Verdadero si el clic recae en el velo de `dialog` (`::backdrop`) y la pulsación empezó también en el velo. */
29
+ export declare function pressedOnBackdrop(dialog: HTMLDialogElement, event: {
30
+ target: EventTarget | null;
31
+ clientX: number;
32
+ clientY: number;
33
+ }): boolean;
@@ -0,0 +1,75 @@
1
+ // Pila de capas descartables (popover, menú, lista, diálogo): Escape cierra solo la de arriba y una pulsación o
2
+ // un foco fuera cierran, de arriba abajo, las capas que no contienen el destino. Los listeners del documento
3
+ // existen solo mientras hay alguna capa abierta: importar el módulo no tiene efectos.
4
+ const stack = [];
5
+ let wired;
6
+ function outside(event, notify) {
7
+ const target = event.target;
8
+ if (!(target instanceof Node))
9
+ return;
10
+ for (const layer of [...stack].reverse()) {
11
+ if (layer.contains(target))
12
+ return;
13
+ notify(layer, event);
14
+ if (layer.modal)
15
+ return;
16
+ }
17
+ }
18
+ /**
19
+ * Escape para la capa de arriba. Devuelve true si la capa lo atendió (y el evento queda con `preventDefault`).
20
+ * Un evento ya cancelado no cierra nada: un campo que usa Escape para limpiarse no cierra además el diálogo.
21
+ */
22
+ export function escapeTop(event) {
23
+ if (event.key !== "Escape" || event.defaultPrevented)
24
+ return false;
25
+ const top = stack[stack.length - 1];
26
+ if (!top?.onEscape)
27
+ return false;
28
+ event.preventDefault();
29
+ top.onEscape(event);
30
+ return true;
31
+ }
32
+ function wire(doc) {
33
+ wired = new AbortController();
34
+ const { signal } = wired;
35
+ doc.addEventListener("keydown", escapeTop, { signal });
36
+ doc.addEventListener("pointerdown", (event) => outside(event, (layer, e) => layer.onPointerOutside?.(e)), { capture: true, signal });
37
+ doc.addEventListener("focusin", (event) => outside(event, (layer, e) => layer.onFocusOutside?.(e)), { capture: true, signal });
38
+ }
39
+ /** Añade una capa encima de la pila. Devuelve la función que la retira. */
40
+ export function pushLayer(layer, doc = document) {
41
+ if (!wired)
42
+ wire(doc);
43
+ stack.push(layer);
44
+ return () => {
45
+ const at = stack.indexOf(layer);
46
+ if (at >= 0)
47
+ stack.splice(at, 1);
48
+ if (!stack.length) {
49
+ wired?.abort();
50
+ wired = undefined;
51
+ }
52
+ };
53
+ }
54
+ /** Verdadero si `layer` es la capa de arriba. */
55
+ export const isTopLayer = (layer) => stack[stack.length - 1] === layer;
56
+ /** Capa modal más alta, si hay alguna. */
57
+ export const topModal = () => [...stack].reverse().find((layer) => layer.modal);
58
+ const outsideBox = (el, x, y) => {
59
+ const r = el.getBoundingClientRect();
60
+ return x < r.left || x > r.right || y < r.top || y > r.bottom;
61
+ };
62
+ // Dónde empezó la última pulsación del puntero: un clic en el velo exige que empiece y termine en él.
63
+ let pressed;
64
+ /** Listener de `pointerdown` (captura): recuerda dónde empezó la pulsación. */
65
+ export function notePress(event) {
66
+ pressed = { target: event.target, x: event.clientX, y: event.clientY };
67
+ }
68
+ /** Verdadero si el clic recae en el velo de `dialog` (`::backdrop`) y la pulsación empezó también en el velo. */
69
+ export function pressedOnBackdrop(dialog, event) {
70
+ if (event.target !== dialog || !outsideBox(dialog, event.clientX, event.clientY))
71
+ return false;
72
+ // Sin pulsación registrada (clic sintético, init() tardío) basta con la posición del clic.
73
+ return !pressed || (pressed.target === dialog && outsideBox(dialog, pressed.x, pressed.y));
74
+ }
75
+ //# sourceMappingURL=layers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"layers.js","sourceRoot":"","sources":["../../../src/core/layers.ts"],"names":[],"mappings":"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","sourcesContent":["// Pila de capas descartables (popover, menú, lista, diálogo): Escape cierra solo la de arriba y una pulsación o\n// un foco fuera cierran, de arriba abajo, las capas que no contienen el destino. Los listeners del documento\n// existen solo mientras hay alguna capa abierta: importar el módulo no tiene efectos.\n\nexport interface Layer {\n /** Verdadero si el nodo pertenece a la capa: su contenido, su disparador o un submenú suyo. */\n contains(target: Node): boolean;\n /** Diálogo modal: lo que queda debajo es inerte y no se evalúa. */\n modal?: boolean;\n /** Escape con esta capa arriba del todo. Sin manejador, la tecla sigue su curso. */\n onEscape?(event: KeyboardEvent): void;\n onPointerOutside?(event: PointerEvent): void;\n onFocusOutside?(event: FocusEvent): void;\n}\n\nconst stack: Layer[] = [];\nlet wired: AbortController | undefined;\n\nfunction outside<E extends Event>(event: E, notify: (layer: Layer, event: E) => void): void {\n const target = event.target;\n if (!(target instanceof Node)) return;\n for (const layer of [...stack].reverse()) {\n if (layer.contains(target)) return;\n notify(layer, event);\n if (layer.modal) return;\n }\n}\n\n/**\n * Escape para la capa de arriba. Devuelve true si la capa lo atendió (y el evento queda con `preventDefault`).\n * Un evento ya cancelado no cierra nada: un campo que usa Escape para limpiarse no cierra además el diálogo.\n */\nexport function escapeTop(event: KeyboardEvent): boolean {\n if (event.key !== \"Escape\" || event.defaultPrevented) return false;\n const top = stack[stack.length - 1];\n if (!top?.onEscape) return false;\n event.preventDefault();\n top.onEscape(event);\n return true;\n}\n\nfunction wire(doc: Document): void {\n wired = new AbortController();\n const { signal } = wired;\n doc.addEventListener(\"keydown\", escapeTop, { signal });\n doc.addEventListener(\"pointerdown\", (event) => outside(event, (layer, e) => layer.onPointerOutside?.(e)), { capture: true, signal });\n doc.addEventListener(\"focusin\", (event) => outside(event, (layer, e) => layer.onFocusOutside?.(e)), { capture: true, signal });\n}\n\n/** Añade una capa encima de la pila. Devuelve la función que la retira. */\nexport function pushLayer(layer: Layer, doc: Document = document): () => void {\n if (!wired) wire(doc);\n stack.push(layer);\n return () => {\n const at = stack.indexOf(layer);\n if (at >= 0) stack.splice(at, 1);\n if (!stack.length) {\n wired?.abort();\n wired = undefined;\n }\n };\n}\n\n/** Verdadero si `layer` es la capa de arriba. */\nexport const isTopLayer = (layer: Layer) => stack[stack.length - 1] === layer;\n\n/** Capa modal más alta, si hay alguna. */\nexport const topModal = () => [...stack].reverse().find((layer) => layer.modal);\n\nconst outsideBox = (el: Element, x: number, y: number) => {\n const r = el.getBoundingClientRect();\n return x < r.left || x > r.right || y < r.top || y > r.bottom;\n};\n\n// Dónde empezó la última pulsación del puntero: un clic en el velo exige que empiece y termine en él.\nlet pressed: { target: EventTarget | null; x: number; y: number } | undefined;\n\n/** Listener de `pointerdown` (captura): recuerda dónde empezó la pulsación. */\nexport function notePress(event: { target: EventTarget | null; clientX: number; clientY: number }): void {\n pressed = { target: event.target, x: event.clientX, y: event.clientY };\n}\n\n/** Verdadero si el clic recae en el velo de `dialog` (`::backdrop`) y la pulsación empezó también en el velo. */\nexport function pressedOnBackdrop(\n dialog: HTMLDialogElement,\n event: { target: EventTarget | null; clientX: number; clientY: number },\n): boolean {\n if (event.target !== dialog || !outsideBox(dialog, event.clientX, event.clientY)) return false;\n // Sin pulsación registrada (clic sintético, init() tardío) basta con la posición del clic.\n return !pressed || (pressed.target === dialog && outsideBox(dialog, pressed.x, pressed.y));\n}\n"]}
@@ -0,0 +1,13 @@
1
+ import type { Point } from "./menu-aim.js";
2
+ export declare const LONG_PRESS_MS = 600;
3
+ export interface LongPress {
4
+ /** `pointerdown` sobre la zona. El ratón no cuenta: tiene botón derecho. */
5
+ down(event: PointerEvent): void;
6
+ move(event: PointerEvent): void;
7
+ cancel(): void;
8
+ /** Hay una pulsación en curso que aún no ha vencido. */
9
+ pending(): boolean;
10
+ /** Milisegundos desde la última pulsación larga cumplida (Infinity si no hubo). */
11
+ sinceFired(): number;
12
+ }
13
+ export declare function createLongPress(fire: (point: Point, event: PointerEvent) => void, ms?: number): LongPress;
@@ -0,0 +1,33 @@
1
+ export const LONG_PRESS_MS = 600;
2
+ const SLOP = 10;
3
+ export function createLongPress(fire, ms = LONG_PRESS_MS) {
4
+ let press;
5
+ let firedAt = Number.NEGATIVE_INFINITY;
6
+ const cancel = () => {
7
+ if (press)
8
+ clearTimeout(press.timer);
9
+ press = undefined;
10
+ };
11
+ return {
12
+ down(event) {
13
+ cancel();
14
+ if (event.pointerType === "mouse")
15
+ return;
16
+ const point = { x: event.clientX, y: event.clientY };
17
+ const timer = setTimeout(() => {
18
+ press = undefined;
19
+ firedAt = Date.now();
20
+ fire(point, event);
21
+ }, ms);
22
+ press = { id: event.pointerId, ...point, timer };
23
+ },
24
+ move(event) {
25
+ if (press && event.pointerId === press.id && Math.hypot(event.clientX - press.x, event.clientY - press.y) > SLOP)
26
+ cancel();
27
+ },
28
+ cancel,
29
+ pending: () => press !== undefined,
30
+ sinceFired: () => Date.now() - firedAt,
31
+ };
32
+ }
33
+ //# sourceMappingURL=long-press.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"long-press.js","sourceRoot":"","sources":["../../../src/core/long-press.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,IAAI,GAAG,EAAE,CAAC;AAahB,MAAM,UAAU,eAAe,CAAC,IAAiD,EAAE,EAAE,GAAG,aAAa;IACnG,IAAI,KAA6F,CAAC;IAClG,IAAI,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACvC,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC,CAAC;IACF,OAAO;QACL,IAAI,CAAC,KAAK;YACR,MAAM,EAAE,CAAC;YACT,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO;gBAAE,OAAO;YAC1C,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,KAAK,GAAG,SAAS,CAAC;gBAClB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACrB,CAAC,EAAE,EAAE,CAAC,CAAC;YACP,KAAK,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,KAAK;YACR,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;gBAAE,MAAM,EAAE,CAAC;QAC7H,CAAC;QACD,MAAM;QACN,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,SAAS;QAClC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;KACvC,CAAC;AACJ,CAAC","sourcesContent":["// Pulsación larga con dedo o lápiz (abre el menú contextual donde el navegador no emite `contextmenu`).\nimport type { Point } from \"./menu-aim\";\n\nexport const LONG_PRESS_MS = 600;\nconst SLOP = 10;\n\nexport interface LongPress {\n /** `pointerdown` sobre la zona. El ratón no cuenta: tiene botón derecho. */\n down(event: PointerEvent): void;\n move(event: PointerEvent): void;\n cancel(): void;\n /** Hay una pulsación en curso que aún no ha vencido. */\n pending(): boolean;\n /** Milisegundos desde la última pulsación larga cumplida (Infinity si no hubo). */\n sinceFired(): number;\n}\n\nexport function createLongPress(fire: (point: Point, event: PointerEvent) => void, ms = LONG_PRESS_MS): LongPress {\n let press: { id: number; x: number; y: number; timer: ReturnType<typeof setTimeout> } | undefined;\n let firedAt = Number.NEGATIVE_INFINITY;\n const cancel = () => {\n if (press) clearTimeout(press.timer);\n press = undefined;\n };\n return {\n down(event) {\n cancel();\n if (event.pointerType === \"mouse\") return;\n const point = { x: event.clientX, y: event.clientY };\n const timer = setTimeout(() => {\n press = undefined;\n firedAt = Date.now();\n fire(point, event);\n }, ms);\n press = { id: event.pointerId, ...point, timer };\n },\n move(event) {\n if (press && event.pointerId === press.id && Math.hypot(event.clientX - press.x, event.clientY - press.y) > SLOP) cancel();\n },\n cancel,\n pending: () => press !== undefined,\n sinceFired: () => Date.now() - firedAt,\n };\n}\n"]}
@@ -0,0 +1,17 @@
1
+ import type { Box } from "./place.js";
2
+ export interface Point {
3
+ x: number;
4
+ y: number;
5
+ }
6
+ /** Punto dentro de un polígono (regla par-impar, trazando un rayo horizontal). */
7
+ export declare function inPolygon(point: Point, polygon: ReadonlyArray<Point>): boolean;
8
+ /** Polígono de gracia: el punto de salida (retrasado `bleed` px) y las cuatro esquinas del submenú. */
9
+ export declare function graceArea(exit: Point, sub: Box, side: "left" | "right", bleed?: number): Point[];
10
+ export interface MenuAim {
11
+ /** El puntero sale de la entrada con el submenú `sub` abierto hacia `side`. */
12
+ start(exit: Point, sub: Box, side: "left" | "right"): void;
13
+ /** Verdadero si el puntero, en `point`, sigue camino del submenú: no se toca lo que hay debajo. */
14
+ blocks(point: Point): boolean;
15
+ clear(): void;
16
+ }
17
+ export declare function createMenuAim(timeout?: number, now?: () => number): MenuAim;
@@ -0,0 +1,48 @@
1
+ /** Punto dentro de un polígono (regla par-impar, trazando un rayo horizontal). */
2
+ export function inPolygon(point, polygon) {
3
+ let inside = false;
4
+ for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
5
+ const a = polygon[i];
6
+ const b = polygon[j];
7
+ if (a.y > point.y !== b.y > point.y && point.x < ((b.x - a.x) * (point.y - a.y)) / (b.y - a.y) + a.x)
8
+ inside = !inside;
9
+ }
10
+ return inside;
11
+ }
12
+ /** Polígono de gracia: el punto de salida (retrasado `bleed` px) y las cuatro esquinas del submenú. */
13
+ export function graceArea(exit, sub, side, bleed = 5) {
14
+ const near = side === "right" ? sub.left : sub.left + sub.width;
15
+ const far = side === "right" ? sub.left + sub.width : sub.left;
16
+ const from = { x: exit.x + (side === "right" ? -bleed : bleed), y: exit.y };
17
+ return [from, { x: near, y: sub.top }, { x: far, y: sub.top }, { x: far, y: sub.top + sub.height }, { x: near, y: sub.top + sub.height }];
18
+ }
19
+ export function createMenuAim(timeout = 300, now = Date.now) {
20
+ let area;
21
+ let side = "right";
22
+ let since = 0;
23
+ let last = 0;
24
+ return {
25
+ start(exit, sub, toward) {
26
+ area = graceArea(exit, sub, toward);
27
+ side = toward;
28
+ since = now();
29
+ last = exit.x;
30
+ },
31
+ blocks(point) {
32
+ if (!area)
33
+ return false;
34
+ // Caducada, fuera del polígono o alejándose del submenú: deja de proteger.
35
+ const away = side === "right" ? point.x < last : point.x > last;
36
+ if (now() - since > timeout || away || !inPolygon(point, area)) {
37
+ area = undefined;
38
+ return false;
39
+ }
40
+ last = point.x;
41
+ return true;
42
+ },
43
+ clear() {
44
+ area = undefined;
45
+ },
46
+ };
47
+ }
48
+ //# sourceMappingURL=menu-aim.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"menu-aim.js","sourceRoot":"","sources":["../../../src/core/menu-aim.ts"],"names":[],"mappings":"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","sourcesContent":["// Zona de gracia del puntero entre una entrada de menú y su submenú: mientras el puntero viaja en diagonal hacia\n// el submenú, pasar por encima de otras entradas no lo cierra. La zona es el polígono entre el punto por el que el\n// puntero salió de la entrada y el borde cercano del submenú, y caduca a los `timeout` ms.\n// Técnica de «pointer grace area» de Radix UI Primitives (MIT) y prueba de punto en polígono al modo de PNPOLY\n// (W. R. Franklin); código propio. Avisos en zui/THIRD_PARTY_NOTICES.md.\nimport type { Box } from \"./place\";\n\nexport interface Point {\n x: number;\n y: number;\n}\n\n/** Punto dentro de un polígono (regla par-impar, trazando un rayo horizontal). */\nexport function inPolygon(point: Point, polygon: ReadonlyArray<Point>): boolean {\n let inside = false;\n for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n const a = polygon[i]!;\n const b = polygon[j]!;\n if (a.y > point.y !== b.y > point.y && point.x < ((b.x - a.x) * (point.y - a.y)) / (b.y - a.y) + a.x) inside = !inside;\n }\n return inside;\n}\n\n/** Polígono de gracia: el punto de salida (retrasado `bleed` px) y las cuatro esquinas del submenú. */\nexport function graceArea(exit: Point, sub: Box, side: \"left\" | \"right\", bleed = 5): Point[] {\n const near = side === \"right\" ? sub.left : sub.left + sub.width;\n const far = side === \"right\" ? sub.left + sub.width : sub.left;\n const from = { x: exit.x + (side === \"right\" ? -bleed : bleed), y: exit.y };\n return [from, { x: near, y: sub.top }, { x: far, y: sub.top }, { x: far, y: sub.top + sub.height }, { x: near, y: sub.top + sub.height }];\n}\n\nexport interface MenuAim {\n /** El puntero sale de la entrada con el submenú `sub` abierto hacia `side`. */\n start(exit: Point, sub: Box, side: \"left\" | \"right\"): void;\n /** Verdadero si el puntero, en `point`, sigue camino del submenú: no se toca lo que hay debajo. */\n blocks(point: Point): boolean;\n clear(): void;\n}\n\nexport function createMenuAim(timeout = 300, now: () => number = Date.now): MenuAim {\n let area: Point[] | undefined;\n let side: \"left\" | \"right\" = \"right\";\n let since = 0;\n let last = 0;\n return {\n start(exit, sub, toward) {\n area = graceArea(exit, sub, toward);\n side = toward;\n since = now();\n last = exit.x;\n },\n blocks(point) {\n if (!area) return false;\n // Caducada, fuera del polígono o alejándose del submenú: deja de proteger.\n const away = side === \"right\" ? point.x < last : point.x > last;\n if (now() - since > timeout || away || !inPolygon(point, area)) {\n area = undefined;\n return false;\n }\n last = point.x;\n return true;\n },\n clear() {\n area = undefined;\n },\n };\n}\n"]}
@@ -0,0 +1,16 @@
1
+ /** Diálogo modal abierto más reciente según el orden del documento, o `<body>` si no hay ninguno. */
2
+ export declare const modalHost: (doc?: Document) => HTMLElement;
3
+ /**
4
+ * Avisa con el anfitrión vigente cada vez que cambia: se abre un diálogo modal (pasa a ser el anfitrión), se cierra
5
+ * o se retira del documento (lo es el anterior, o `<body>`). Lleva la cuenta del orden de apertura, que es el orden
6
+ * de la capa superior. No llama al empezar. Devuelve la función que deja de vigilar.
7
+ */
8
+ export declare function followModalHost(onChange: (host: HTMLElement) => void, doc?: Document): () => void;
9
+ /** Lleva `el` a `host` si no está ya en él. */
10
+ export declare function moveToHost(el: HTMLElement, host: HTMLElement): void;
11
+ /**
12
+ * Tras reinsertar o volver a mostrar `root`: un nodo que reaparece repite sus animaciones CSS. Las de los elementos
13
+ * `selector` que ya se habían mostrado (`seen`) se dan por terminadas, para que no vuelvan a «entrar»; los nuevos
14
+ * se anotan y animan con normalidad.
15
+ */
16
+ export declare function settleShown(root: Element, selector: string, seen: WeakSet<Element>): void;
@@ -0,0 +1,59 @@
1
+ // Dónde debe vivir una capa que tiene que seguir activa con un diálogo modal abierto (la región de avisos).
2
+ // Con un `<dialog>` abierto con `showModal()`, el navegador deja inerte todo lo que queda fuera de él, también lo
3
+ // que está en la capa superior: un aviso montado en `<body>` se vería pero no se podría enfocar, pulsar ni leer.
4
+ // La región se muda al diálogo modal de arriba y vuelve a `<body>` cuando no queda ninguno.
5
+ const modals = (doc) => [...doc.querySelectorAll("dialog:modal")];
6
+ /** Diálogo modal abierto más reciente según el orden del documento, o `<body>` si no hay ninguno. */
7
+ export const modalHost = (doc = document) => modals(doc).pop() ?? doc.body;
8
+ /**
9
+ * Avisa con el anfitrión vigente cada vez que cambia: se abre un diálogo modal (pasa a ser el anfitrión), se cierra
10
+ * o se retira del documento (lo es el anterior, o `<body>`). Lleva la cuenta del orden de apertura, que es el orden
11
+ * de la capa superior. No llama al empezar. Devuelve la función que deja de vigilar.
12
+ */
13
+ export function followModalHost(onChange, doc = document) {
14
+ let order = modals(doc);
15
+ let current = order[order.length - 1] ?? doc.body;
16
+ const check = () => {
17
+ const open = modals(doc);
18
+ order = order.filter((dialog) => open.includes(dialog));
19
+ for (const dialog of open)
20
+ if (!order.includes(dialog))
21
+ order.push(dialog);
22
+ const next = order[order.length - 1] ?? doc.body;
23
+ if (next === current)
24
+ return;
25
+ current = next;
26
+ onChange(next);
27
+ };
28
+ // `showModal()` y `close()` cambian el atributo `open`; un diálogo que se desmonta abierto sale por `childList`.
29
+ const observer = new MutationObserver(check);
30
+ observer.observe(doc.documentElement, { subtree: true, childList: true, attributes: true, attributeFilter: ["open"] });
31
+ return () => observer.disconnect();
32
+ }
33
+ /** Lleva `el` a `host` si no está ya en él. */
34
+ export function moveToHost(el, host) {
35
+ if (el.parentElement !== host || !el.isConnected)
36
+ host.append(el);
37
+ }
38
+ /**
39
+ * Tras reinsertar o volver a mostrar `root`: un nodo que reaparece repite sus animaciones CSS. Las de los elementos
40
+ * `selector` que ya se habían mostrado (`seen`) se dan por terminadas, para que no vuelvan a «entrar»; los nuevos
41
+ * se anotan y animan con normalidad.
42
+ */
43
+ export function settleShown(root, selector, seen) {
44
+ for (const el of root.querySelectorAll(selector)) {
45
+ if (!seen.has(el)) {
46
+ seen.add(el);
47
+ continue;
48
+ }
49
+ for (const animation of el.getAnimations?.({ subtree: true }) ?? []) {
50
+ try {
51
+ animation.finish();
52
+ }
53
+ catch {
54
+ // Animación infinita: no tiene final al que saltar.
55
+ }
56
+ }
57
+ }
58
+ }
59
+ //# sourceMappingURL=modal-host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"modal-host.js","sourceRoot":"","sources":["../../../src/core/modal-host.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,kHAAkH;AAClH,iHAAiH;AACjH,4FAA4F;AAE5F,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAc,cAAc,CAAC,CAAC,CAAC;AAEzF,qGAAqG;AACrG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,GAAa,QAAQ,EAAe,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC;AAElG;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAqC,EAAE,GAAG,GAAa,QAAQ;IAC7F,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,GAAgB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;IAC/D,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO;QAC7B,OAAO,GAAG,IAAI,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,iHAAiH;IACjH,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvH,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;AACrC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,EAAe,EAAE,IAAiB;IAC3D,IAAI,EAAE,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW;QAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,QAAgB,EAAE,IAAsB;IACjF,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACpE,IAAI,CAAC;gBACH,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["// Dónde debe vivir una capa que tiene que seguir activa con un diálogo modal abierto (la región de avisos).\n// Con un `<dialog>` abierto con `showModal()`, el navegador deja inerte todo lo que queda fuera de él, también lo\n// que está en la capa superior: un aviso montado en `<body>` se vería pero no se podría enfocar, pulsar ni leer.\n// La región se muda al diálogo modal de arriba y vuelve a `<body>` cuando no queda ninguno.\n\nconst modals = (doc: Document) => [...doc.querySelectorAll<HTMLElement>(\"dialog:modal\")];\n\n/** Diálogo modal abierto más reciente según el orden del documento, o `<body>` si no hay ninguno. */\nexport const modalHost = (doc: Document = document): HTMLElement => modals(doc).pop() ?? doc.body;\n\n/**\n * Avisa con el anfitrión vigente cada vez que cambia: se abre un diálogo modal (pasa a ser el anfitrión), se cierra\n * o se retira del documento (lo es el anterior, o `<body>`). Lleva la cuenta del orden de apertura, que es el orden\n * de la capa superior. No llama al empezar. Devuelve la función que deja de vigilar.\n */\nexport function followModalHost(onChange: (host: HTMLElement) => void, doc: Document = document): () => void {\n let order = modals(doc);\n let current: HTMLElement = order[order.length - 1] ?? doc.body;\n const check = () => {\n const open = modals(doc);\n order = order.filter((dialog) => open.includes(dialog));\n for (const dialog of open) if (!order.includes(dialog)) order.push(dialog);\n const next = order[order.length - 1] ?? doc.body;\n if (next === current) return;\n current = next;\n onChange(next);\n };\n // `showModal()` y `close()` cambian el atributo `open`; un diálogo que se desmonta abierto sale por `childList`.\n const observer = new MutationObserver(check);\n observer.observe(doc.documentElement, { subtree: true, childList: true, attributes: true, attributeFilter: [\"open\"] });\n return () => observer.disconnect();\n}\n\n/** Lleva `el` a `host` si no está ya en él. */\nexport function moveToHost(el: HTMLElement, host: HTMLElement): void {\n if (el.parentElement !== host || !el.isConnected) host.append(el);\n}\n\n/**\n * Tras reinsertar o volver a mostrar `root`: un nodo que reaparece repite sus animaciones CSS. Las de los elementos\n * `selector` que ya se habían mostrado (`seen`) se dan por terminadas, para que no vuelvan a «entrar»; los nuevos\n * se anotan y animan con normalidad.\n */\nexport function settleShown(root: Element, selector: string, seen: WeakSet<Element>): void {\n for (const el of root.querySelectorAll(selector)) {\n if (!seen.has(el)) {\n seen.add(el);\n continue;\n }\n for (const animation of el.getAnimations?.({ subtree: true }) ?? []) {\n try {\n animation.finish();\n } catch {\n // Animación infinita: no tiene final al que saltar.\n }\n }\n }\n}\n"]}
@@ -0,0 +1,6 @@
1
+ /** Total de páginas válido: entero ≥ 1 (un valor no numérico cuenta como una sola página). */
2
+ export declare function pageTotal(count: number): number;
3
+ /** Página dentro de [1, count], redondeada; un valor no numérico devuelve `fallback` (acotado). */
4
+ export declare function clampPage(page: number, count: number, fallback?: number): number;
5
+ /** Rango con huecos: 1 … 4 5 6 … 20. Un hueco se representa con 0. */
6
+ export declare function pageRange(page: number, count: number, siblings: number): number[];
@@ -0,0 +1,32 @@
1
+ // Paginación: página acotada y rango con huecos. La misma aritmética para React y para el modo DOM.
2
+ /** Total de páginas válido: entero ≥ 1 (un valor no numérico cuenta como una sola página). */
3
+ export function pageTotal(count) {
4
+ return Number.isFinite(count) ? Math.max(1, Math.floor(count)) : 1;
5
+ }
6
+ /** Página dentro de [1, count], redondeada; un valor no numérico devuelve `fallback` (acotado). */
7
+ export function clampPage(page, count, fallback = 1) {
8
+ const total = pageTotal(count);
9
+ const wanted = Number.isFinite(page)
10
+ ? Math.round(page)
11
+ : page === Number.POSITIVE_INFINITY
12
+ ? total
13
+ : Number.isFinite(fallback)
14
+ ? Math.round(fallback)
15
+ : 1;
16
+ return Math.min(Math.max(1, wanted), total);
17
+ }
18
+ /** Rango con huecos: 1 … 4 5 6 … 20. Un hueco se representa con 0. */
19
+ export function pageRange(page, count, siblings) {
20
+ const slots = siblings * 2 + 5;
21
+ if (count <= slots)
22
+ return Array.from({ length: count }, (_, i) => i + 1);
23
+ const left = Math.max(page - siblings, 1);
24
+ const right = Math.min(page + siblings, count);
25
+ const edge = siblings * 2 + 3;
26
+ if (!(left > 2))
27
+ return [...Array.from({ length: edge }, (_, i) => i + 1), 0, count];
28
+ if (!(right < count - 1))
29
+ return [1, 0, ...Array.from({ length: edge }, (_, i) => count - edge + 1 + i)];
30
+ return [1, 0, ...Array.from({ length: right - left + 1 }, (_, i) => left + i), 0, count];
31
+ }
32
+ //# sourceMappingURL=pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/core/pagination.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAEpG,8FAA8F;AAC9F,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,QAAQ,GAAG,CAAC;IACjE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,iBAAiB;YACjC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACtB,CAAC,CAAC,CAAC,CAAC;IACV,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,QAAgB;IACrE,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACrF,IAAI,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3F,CAAC","sourcesContent":["// Paginación: página acotada y rango con huecos. La misma aritmética para React y para el modo DOM.\n\n/** Total de páginas válido: entero ≥ 1 (un valor no numérico cuenta como una sola página). */\nexport function pageTotal(count: number): number {\n return Number.isFinite(count) ? Math.max(1, Math.floor(count)) : 1;\n}\n\n/** Página dentro de [1, count], redondeada; un valor no numérico devuelve `fallback` (acotado). */\nexport function clampPage(page: number, count: number, fallback = 1): number {\n const total = pageTotal(count);\n const wanted = Number.isFinite(page)\n ? Math.round(page)\n : page === Number.POSITIVE_INFINITY\n ? total\n : Number.isFinite(fallback)\n ? Math.round(fallback)\n : 1;\n return Math.min(Math.max(1, wanted), total);\n}\n\n/** Rango con huecos: 1 … 4 5 6 … 20. Un hueco se representa con 0. */\nexport function pageRange(page: number, count: number, siblings: number): number[] {\n const slots = siblings * 2 + 5;\n if (count <= slots) return Array.from({ length: count }, (_, i) => i + 1);\n const left = Math.max(page - siblings, 1);\n const right = Math.min(page + siblings, count);\n const edge = siblings * 2 + 3;\n if (!(left > 2)) return [...Array.from({ length: edge }, (_, i) => i + 1), 0, count];\n if (!(right < count - 1)) return [1, 0, ...Array.from({ length: edge }, (_, i) => count - edge + 1 + i)];\n return [1, 0, ...Array.from({ length: right - left + 1 }, (_, i) => left + i), 0, count];\n}\n"]}
@@ -0,0 +1,54 @@
1
+ export type Side = "top" | "right" | "bottom" | "left";
2
+ export type Align = "start" | "center" | "end";
3
+ export type Placement = Side | `${Side}-start` | `${Side}-end`;
4
+ export interface Box {
5
+ left: number;
6
+ top: number;
7
+ width: number;
8
+ height: number;
9
+ }
10
+ export interface PlaceInput {
11
+ anchor: Box;
12
+ /** Tamaño de la capa. */
13
+ size: {
14
+ width: number;
15
+ height: number;
16
+ };
17
+ viewport: {
18
+ width: number;
19
+ height: number;
20
+ };
21
+ placement: Placement;
22
+ /** Separación entre el ancla y la capa. */
23
+ gap?: number;
24
+ /** Margen mínimo con el borde de la ventana. */
25
+ padding?: number;
26
+ /** En RTL `start` es el borde derecho del ancla. */
27
+ rtl?: boolean;
28
+ /** Lado ya decidido: no se vuelve a voltear (segunda pasada, tras aplicar el tamaño disponible). */
29
+ lockSide?: Side;
30
+ }
31
+ export interface PlaceResult {
32
+ x: number;
33
+ y: number;
34
+ side: Side;
35
+ align: Align;
36
+ /** Hueco entre el ancla y el borde de la ventana en el lado elegido (y el ancho o alto útil en el otro eje). */
37
+ availableWidth: number;
38
+ availableHeight: number;
39
+ }
40
+ export declare const PLACE_PADDING = 8;
41
+ export declare function computePlace({ anchor, size, viewport, placement, gap, padding, rtl, lockSide, }: PlaceInput): PlaceResult;
42
+ /**
43
+ * Coloca `el` (posición fija) junto a `rect`. Escribe `left`/`top`, `data-side`, `data-align` y las variables
44
+ * `--z-available-width`/`--z-available-height` (hueco hasta el borde de la ventana), que el CSS usa como tope
45
+ * de tamaño. Si ese tope cambia el tamaño de la capa, se recoloca con el tamaño nuevo sin volver a voltear.
46
+ */
47
+ export declare function place(el: HTMLElement, rect: Box, placement: Placement, gap?: number): PlaceResult;
48
+ /**
49
+ * Ancla de un submenú: el borde del menú padre a la altura de la entrada que lo abre, con `inset` (relleno y borde
50
+ * del submenú) para que su primera entrada quede alineada con ella.
51
+ */
52
+ export declare function submenuAnchor(menu: Box, item: Box, inset: number): Box;
53
+ /** Relleno más borde superior de un elemento: lo que separa su primera entrada de su borde. */
54
+ export declare function topInset(el: Element): number;
@@ -0,0 +1,97 @@
1
+ // Colocación de una capa junto a su ancla: lado y alineación pedidos, volteo al lado opuesto si no cabe,
2
+ // desplazamiento para no salir de la ventana y tamaño disponible. `computePlace` es aritmética pura;
3
+ // `place` la aplica a un elemento.
4
+ import { isRtl } from "./dir.js";
5
+ export const PLACE_PADDING = 8;
6
+ export function computePlace({ anchor, size, viewport, placement, gap = 6, padding = PLACE_PADDING, rtl = false, lockSide, }) {
7
+ const [wanted, align = "center"] = placement.split("-");
8
+ const { width, height } = size;
9
+ const right = anchor.left + anchor.width;
10
+ const bottom = anchor.top + anchor.height;
11
+ let side = lockSide ?? wanted;
12
+ // Voltea al lado opuesto si no cabe.
13
+ if (!lockSide) {
14
+ if (side === "bottom" && bottom + gap + height > viewport.height && anchor.top - gap - height >= 0)
15
+ side = "top";
16
+ else if (side === "top" && anchor.top - gap - height < 0)
17
+ side = "bottom";
18
+ else if (side === "right" && right + gap + width > viewport.width)
19
+ side = "left";
20
+ else if (side === "left" && anchor.left - gap - width < 0)
21
+ side = "right";
22
+ }
23
+ const start = rtl ? "end" : "start";
24
+ let x;
25
+ let y;
26
+ if (side === "top" || side === "bottom") {
27
+ y = side === "bottom" ? bottom + gap : anchor.top - gap - height;
28
+ x = align === "center" ? anchor.left + anchor.width / 2 - width / 2 : align === start ? anchor.left : right - width;
29
+ }
30
+ else {
31
+ x = side === "right" ? right + gap : anchor.left - gap - width;
32
+ y = align === "start" ? anchor.top : align === "end" ? bottom - height : anchor.top + anchor.height / 2 - height / 2;
33
+ }
34
+ const room = {
35
+ top: anchor.top - gap,
36
+ bottom: viewport.height - bottom - gap,
37
+ left: anchor.left - gap,
38
+ right: viewport.width - right - gap,
39
+ };
40
+ const vertical = side === "top" || side === "bottom";
41
+ return {
42
+ x: Math.round(Math.min(Math.max(padding, x), Math.max(padding, viewport.width - width - padding))),
43
+ y: Math.round(Math.min(Math.max(padding, y), Math.max(padding, viewport.height - height - padding))),
44
+ side,
45
+ align,
46
+ availableWidth: Math.max(0, Math.floor((vertical ? viewport.width - padding : room[side]) - padding)),
47
+ availableHeight: Math.max(0, Math.floor((vertical ? room[side] : viewport.height - padding) - padding)),
48
+ };
49
+ }
50
+ /**
51
+ * Coloca `el` (posición fija) junto a `rect`. Escribe `left`/`top`, `data-side`, `data-align` y las variables
52
+ * `--z-available-width`/`--z-available-height` (hueco hasta el borde de la ventana), que el CSS usa como tope
53
+ * de tamaño. Si ese tope cambia el tamaño de la capa, se recoloca con el tamaño nuevo sin volver a voltear.
54
+ */
55
+ export function place(el, rect, placement, gap = 6) {
56
+ const root = el.ownerDocument.documentElement;
57
+ const viewport = { width: root.clientWidth, height: root.clientHeight };
58
+ const rtl = isRtl(el);
59
+ const measure = () => {
60
+ const box = el.getBoundingClientRect();
61
+ return { width: box.width, height: box.height };
62
+ };
63
+ const apply = (result) => {
64
+ el.style.setProperty("--z-available-width", `${result.availableWidth}px`);
65
+ el.style.setProperty("--z-available-height", `${result.availableHeight}px`);
66
+ };
67
+ const input = { anchor: rect, viewport, placement, gap, rtl };
68
+ // El lado se decide con el tamaño natural, sin el tope de la colocación anterior.
69
+ el.style.removeProperty("--z-available-width");
70
+ el.style.removeProperty("--z-available-height");
71
+ const size = measure();
72
+ let result = computePlace({ ...input, size });
73
+ apply(result);
74
+ const fitted = measure();
75
+ if (fitted.width !== size.width || fitted.height !== size.height) {
76
+ result = computePlace({ ...input, size: fitted, lockSide: result.side });
77
+ apply(result);
78
+ }
79
+ el.style.left = `${result.x}px`;
80
+ el.style.top = `${result.y}px`;
81
+ el.dataset.side = result.side;
82
+ el.dataset.align = result.align;
83
+ return result;
84
+ }
85
+ /**
86
+ * Ancla de un submenú: el borde del menú padre a la altura de la entrada que lo abre, con `inset` (relleno y borde
87
+ * del submenú) para que su primera entrada quede alineada con ella.
88
+ */
89
+ export function submenuAnchor(menu, item, inset) {
90
+ return { left: menu.left, top: item.top - inset, width: menu.width, height: item.height + inset * 2 };
91
+ }
92
+ /** Relleno más borde superior de un elemento: lo que separa su primera entrada de su borde. */
93
+ export function topInset(el) {
94
+ const style = getComputedStyle(el);
95
+ return (parseFloat(style.paddingTop) || 0) + (parseFloat(style.borderTopWidth) || 0);
96
+ }
97
+ //# sourceMappingURL=place.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"place.js","sourceRoot":"","sources":["../../../src/core/place.ts"],"names":[],"mappings":"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","sourcesContent":["// Colocación de una capa junto a su ancla: lado y alineación pedidos, volteo al lado opuesto si no cabe,\n// desplazamiento para no salir de la ventana y tamaño disponible. `computePlace` es aritmética pura;\n// `place` la aplica a un elemento.\nimport { isRtl } from \"./dir\";\n\nexport type Side = \"top\" | \"right\" | \"bottom\" | \"left\";\nexport type Align = \"start\" | \"center\" | \"end\";\nexport type Placement = Side | `${Side}-start` | `${Side}-end`;\n\nexport interface Box {\n left: number;\n top: number;\n width: number;\n height: number;\n}\n\nexport interface PlaceInput {\n anchor: Box;\n /** Tamaño de la capa. */\n size: { width: number; height: number };\n viewport: { width: number; height: number };\n placement: Placement;\n /** Separación entre el ancla y la capa. */\n gap?: number;\n /** Margen mínimo con el borde de la ventana. */\n padding?: number;\n /** En RTL `start` es el borde derecho del ancla. */\n rtl?: boolean;\n /** Lado ya decidido: no se vuelve a voltear (segunda pasada, tras aplicar el tamaño disponible). */\n lockSide?: Side;\n}\n\nexport interface PlaceResult {\n x: number;\n y: number;\n side: Side;\n align: Align;\n /** Hueco entre el ancla y el borde de la ventana en el lado elegido (y el ancho o alto útil en el otro eje). */\n availableWidth: number;\n availableHeight: number;\n}\n\nexport const PLACE_PADDING = 8;\n\nexport function computePlace({\n anchor,\n size,\n viewport,\n placement,\n gap = 6,\n padding = PLACE_PADDING,\n rtl = false,\n lockSide,\n}: PlaceInput): PlaceResult {\n const [wanted, align = \"center\"] = placement.split(\"-\") as [Side, Align?];\n const { width, height } = size;\n const right = anchor.left + anchor.width;\n const bottom = anchor.top + anchor.height;\n let side = lockSide ?? wanted;\n // Voltea al lado opuesto si no cabe.\n if (!lockSide) {\n if (side === \"bottom\" && bottom + gap + height > viewport.height && anchor.top - gap - height >= 0) side = \"top\";\n else if (side === \"top\" && anchor.top - gap - height < 0) side = \"bottom\";\n else if (side === \"right\" && right + gap + width > viewport.width) side = \"left\";\n else if (side === \"left\" && anchor.left - gap - width < 0) side = \"right\";\n }\n const start = rtl ? \"end\" : \"start\";\n let x: number;\n let y: number;\n if (side === \"top\" || side === \"bottom\") {\n y = side === \"bottom\" ? bottom + gap : anchor.top - gap - height;\n x = align === \"center\" ? anchor.left + anchor.width / 2 - width / 2 : align === start ? anchor.left : right - width;\n } else {\n x = side === \"right\" ? right + gap : anchor.left - gap - width;\n y = align === \"start\" ? anchor.top : align === \"end\" ? bottom - height : anchor.top + anchor.height / 2 - height / 2;\n }\n const room = {\n top: anchor.top - gap,\n bottom: viewport.height - bottom - gap,\n left: anchor.left - gap,\n right: viewport.width - right - gap,\n };\n const vertical = side === \"top\" || side === \"bottom\";\n return {\n x: Math.round(Math.min(Math.max(padding, x), Math.max(padding, viewport.width - width - padding))),\n y: Math.round(Math.min(Math.max(padding, y), Math.max(padding, viewport.height - height - padding))),\n side,\n align,\n availableWidth: Math.max(0, Math.floor((vertical ? viewport.width - padding : room[side]) - padding)),\n availableHeight: Math.max(0, Math.floor((vertical ? room[side] : viewport.height - padding) - padding)),\n };\n}\n\n/**\n * Coloca `el` (posición fija) junto a `rect`. Escribe `left`/`top`, `data-side`, `data-align` y las variables\n * `--z-available-width`/`--z-available-height` (hueco hasta el borde de la ventana), que el CSS usa como tope\n * de tamaño. Si ese tope cambia el tamaño de la capa, se recoloca con el tamaño nuevo sin volver a voltear.\n */\nexport function place(el: HTMLElement, rect: Box, placement: Placement, gap = 6): PlaceResult {\n const root = el.ownerDocument.documentElement;\n const viewport = { width: root.clientWidth, height: root.clientHeight };\n const rtl = isRtl(el);\n const measure = () => {\n const box = el.getBoundingClientRect();\n return { width: box.width, height: box.height };\n };\n const apply = (result: PlaceResult) => {\n el.style.setProperty(\"--z-available-width\", `${result.availableWidth}px`);\n el.style.setProperty(\"--z-available-height\", `${result.availableHeight}px`);\n };\n const input = { anchor: rect, viewport, placement, gap, rtl };\n // El lado se decide con el tamaño natural, sin el tope de la colocación anterior.\n el.style.removeProperty(\"--z-available-width\");\n el.style.removeProperty(\"--z-available-height\");\n const size = measure();\n let result = computePlace({ ...input, size });\n apply(result);\n const fitted = measure();\n if (fitted.width !== size.width || fitted.height !== size.height) {\n result = computePlace({ ...input, size: fitted, lockSide: result.side });\n apply(result);\n }\n el.style.left = `${result.x}px`;\n el.style.top = `${result.y}px`;\n el.dataset.side = result.side;\n el.dataset.align = result.align;\n return result;\n}\n\n/**\n * Ancla de un submenú: el borde del menú padre a la altura de la entrada que lo abre, con `inset` (relleno y borde\n * del submenú) para que su primera entrada quede alineada con ella.\n */\nexport function submenuAnchor(menu: Box, item: Box, inset: number): Box {\n return { left: menu.left, top: item.top - inset, width: menu.width, height: item.height + inset * 2 };\n}\n\n/** Relleno más borde superior de un elemento: lo que separa su primera entrada de su borde. */\nexport function topInset(el: Element): number {\n const style = getComputedStyle(el);\n return (parseFloat(style.paddingTop) || 0) + (parseFloat(style.borderTopWidth) || 0);\n}\n"]}
@@ -0,0 +1,7 @@
1
+ export declare const EXIT_MS = 220;
2
+ export declare function reducedMotion(): boolean;
3
+ /**
4
+ * Llama a `done` cuando termina la animación de salida de `el`, o tras `timeout` ms si no hay animación (o no
5
+ * avisa). Con movimiento reducido, de inmediato. Devuelve una función que cancela la espera.
6
+ */
7
+ export declare function afterExit(el: HTMLElement, done: () => void, timeout?: number): () => void;