@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
package/manifest.json CHANGED
@@ -126,7 +126,7 @@
126
126
  "name": "loading",
127
127
  "type": "boolean",
128
128
  "default": false,
129
- "description": "Muestra un anillo, deshabilita el botón y expone aria-busy."
129
+ "description": "Muestra un anillo y expone aria-busy. El botón no se deshabilita: lleva aria-disabled, conserva el foco y no responde a la pulsación mientras carga."
130
130
  },
131
131
  {
132
132
  "name": "fullWidth",
@@ -183,7 +183,7 @@
183
183
  "classes": [
184
184
  "z-btn"
185
185
  ],
186
- "a11y": "Elemento button nativo, type=\"button\" por defecto. Con `loading` expone aria-busy y queda deshabilitado.",
186
+ "a11y": "Elemento button nativo, type=\"button\" por defecto. Con `loading` expone aria-busy y aria-disabled: no se activa, pero conserva el foco del teclado (un botón con `disabled` lo perdería).",
187
187
  "examples": [
188
188
  {
189
189
  "title": "Primario con icono",
@@ -261,7 +261,8 @@
261
261
  {
262
262
  "name": "loading",
263
263
  "type": "boolean",
264
- "default": false
264
+ "default": false,
265
+ "description": "Muestra un anillo y expone aria-busy. El botón no se deshabilita: lleva aria-disabled, conserva el foco y no responde a la pulsación mientras carga."
265
266
  },
266
267
  {
267
268
  "name": "...rest",
@@ -402,7 +403,7 @@
402
403
  "classes": [
403
404
  "z-link"
404
405
  ],
405
- "a11y": "Elemento a nativo. Los enlaces externos anuncian que abren otra pestaña.",
406
+ "a11y": "Elemento a nativo. Los enlaces externos anuncian que abren otra pestaña. Deshabilitado: sin href, role=link, aria-disabled y sin ejecutar onClick.",
406
407
  "examples": [
407
408
  {
408
409
  "title": "En un texto",
@@ -507,7 +508,7 @@
507
508
  "classes": [
508
509
  "z-segmented"
509
510
  ],
510
- "a11y": "Radix ToggleGroup de tipo single: role radiogroup, flechas para moverse. No permite quedar sin selección.",
511
+ "a11y": "Patrón APG «radiogroup»: una parada de tabulación; las flechas mueven el foco y la selección (reflejadas en RTL). No permite quedar sin selección.",
511
512
  "examples": [
512
513
  {
513
514
  "title": "Vista",
@@ -518,7 +519,7 @@
518
519
  "code": "<SegmentedControl label=\"Period\" defaultValue=\"week\" fullWidth items={[{ value: \"day\", label: \"Day\" }, { value: \"week\", label: \"Week\" }, { value: \"month\", label: \"Month\" }]} />"
519
520
  }
520
521
  ],
521
- "origin": "Tabs (control segmentado) de zutool, sobre ToggleGroup de radix-ui.",
522
+ "origin": "Tabs (control segmentado) de zutool, con primitiva propia (patrón APG).",
522
523
  "file": "zui/src/components/actions/SegmentedControl.manifest.json"
523
524
  },
524
525
  {
@@ -600,7 +601,7 @@
600
601
  "classes": [
601
602
  "z-toggle"
602
603
  ],
603
- "a11y": "Radix Toggle: button con aria-pressed y data-state on/off.",
604
+ "a11y": "Elemento button con aria-pressed y data-state on/off.",
604
605
  "examples": [
605
606
  {
606
607
  "title": "Solo icono",
@@ -611,7 +612,7 @@
611
612
  "code": "<Toggle pressed={muted} onPressedChange={setMuted} icon=\"speaker-x-mark\">Mute</Toggle>"
612
613
  }
613
614
  ],
614
- "origin": "Nuevo, sobre Toggle de radix-ui.",
615
+ "origin": "Nuevo, con primitiva propia (patrón APG).",
615
616
  "file": "zui/src/components/actions/Toggle.manifest.json"
616
617
  },
617
618
  {
@@ -958,7 +959,7 @@
958
959
  },
959
960
  {
960
961
  "title": "Activable",
961
- "code": "<Card interactive variant=\"outlined\" role=\"button\" tabIndex={0} onClick={() => openProject(project.id)}>\n <CardHeader title={project.name} subtitle={project.owner} />\n</Card>"
962
+ "code": "<Card interactive variant=\"outlined\" role=\"button\" tabIndex={0} onClick={() => openProject(\"atlas\")}>\n <CardHeader title=\"Atlas\" subtitle=\"Ana Ruiz\" />\n</Card>"
962
963
  }
963
964
  ],
964
965
  "origin": "Card del design system base con la superficie de tarjeta de zutool.",
@@ -1152,7 +1153,8 @@
1152
1153
  "surface-3",
1153
1154
  "line-strong",
1154
1155
  "focus-ring",
1155
- "success"
1156
+ "success",
1157
+ "layer-raised"
1156
1158
  ],
1157
1159
  "classes": [
1158
1160
  "z-code"
@@ -2232,7 +2234,7 @@
2232
2234
  "classes": [
2233
2235
  "z-rating"
2234
2236
  ],
2235
- "a11y": "Lectura: role=\"img\" con el valor en texto. Entrada: radiogroup con flechas.",
2237
+ "a11y": "Lectura: role=\"img\" con el valor en texto. Entrada: radiogroup con foco itinerante; flechas (reflejadas en RTL), Inicio y Fin mueven y eligen. Sin React (`@zuccadev-labs/zuix-zui/dom`): el mismo marcado dentro de `[data-z-dom]`; emite z:change { value } en `.z-rating`.",
2236
2238
  "examples": [
2237
2239
  {
2238
2240
  "title": "Lectura",
@@ -2465,7 +2467,8 @@
2465
2467
  "radius-xs",
2466
2468
  "surface-2",
2467
2469
  "focus-ring",
2468
- "accent"
2470
+ "accent",
2471
+ "layer-raised"
2469
2472
  ],
2470
2473
  "classes": [
2471
2474
  "z-table",
@@ -3169,7 +3172,7 @@
3169
3172
  "classes": [
3170
3173
  "z-calendar"
3171
3174
  ],
3172
- "a11y": "Tabla con role=grid etiquetada por el título del mes (aria-live). Foco itinerante: un solo día en el orden de tabulación. Flechas mueven por día y semana, Home/End al inicio/fin de la semana, PageUp/PageDown cambian de mes (con Mayús, de año), Enter/Espacio eligen. Cada día lleva la fecha completa como nombre accesible; hoy aria-current=date; no elegibles aria-disabled. Sin React (`@zuccadev-labs/zuix-zui/dom`): un `.z-calendar` vacío dentro de `[data-z-dom]` se dibuja con la misma tabla (role=grid, título con aria-live, aria-multiselectable en modo rango) y las mismas teclas; el módulo mantiene aria-selected, aria-current=date, aria-disabled y el foco itinerante. Los nombres de los botones de mes salen de `data-previous-label` y `data-next-label` (en inglés por defecto) y las fechas se formatean con `data-locale`.",
3175
+ "a11y": "Tabla con role=grid etiquetada por el título del mes (aria-live). Foco itinerante: un solo día en el orden de tabulación. Flechas mueven por día y semana (en RTL izquierda y derecha se invierten), Home/End al inicio/fin de la semana, PageUp/PageDown cambian de mes (con Mayús, de año), Enter/Espacio eligen. Cada día lleva la fecha completa como nombre accesible; hoy aria-current=date; no elegibles aria-disabled. Sin React (`@zuccadev-labs/zuix-zui/dom`): un `.z-calendar` vacío dentro de `[data-z-dom]` se dibuja con la misma tabla (role=grid, título con aria-live, aria-multiselectable en modo rango) y las mismas teclas; el módulo mantiene aria-selected, aria-current=date, aria-disabled y el foco itinerante. Los nombres de los botones de mes salen de `data-previous-label` y `data-next-label` (en inglés por defecto) y las fechas se formatean con `data-locale`.",
3173
3176
  "behavior": "dom",
3174
3177
  "examples": [
3175
3178
  {
@@ -3252,6 +3255,12 @@
3252
3255
  "name": "value",
3253
3256
  "type": "string",
3254
3257
  "default": "on"
3258
+ },
3259
+ {
3260
+ "name": "required",
3261
+ "type": "boolean",
3262
+ "default": false,
3263
+ "description": "El formulario no se envía si no está marcada."
3255
3264
  }
3256
3265
  ],
3257
3266
  "states": [
@@ -3287,7 +3296,7 @@
3287
3296
  "classes": [
3288
3297
  "z-check"
3289
3298
  ],
3290
- "a11y": "Radix Checkbox: role checkbox, Espacio para alternar, aria-checked mixed en indeterminado. La etiqueta envuelve al control.",
3299
+ "a11y": "Patrón APG «checkbox»: botón con role checkbox y un `input type=checkbox` oculto para formularios, Espacio para alternar, aria-checked mixed en indeterminado. La etiqueta envuelve al control.",
3291
3300
  "examples": [
3292
3301
  {
3293
3302
  "title": "Con descripción",
@@ -3298,7 +3307,7 @@
3298
3307
  "code": "<Checkbox checked=\"indeterminate\" onCheckedChange={toggleAll}>Select all</Checkbox>"
3299
3308
  }
3300
3309
  ],
3301
- "origin": "Nuevo, sobre Checkbox de radix-ui.",
3310
+ "origin": "Nuevo, con primitiva propia (patrón APG).",
3302
3311
  "file": "zui/src/components/forms/Checkbox.manifest.json"
3303
3312
  },
3304
3313
  {
@@ -3819,7 +3828,7 @@
3819
3828
  "z-popover",
3820
3829
  "z-calendar"
3821
3830
  ],
3822
- "a11y": "Botón que abre un diálogo no modal (Popover de Radix) con el calendario; al abrir, el foco va al día activo y al elegir vuelve al botón. Escape cierra. Dentro de un `Field` toma id, aria-describedby, aria-invalid y required. Sin React (`@zuccadev-labs/zuix-zui/dom`): el panel es un `[popover]` con role=dialog.",
3831
+ "a11y": "Botón que abre un diálogo no modal (capa `popover` propia) con el calendario; al abrir, el foco va al día activo y al elegir vuelve al botón. Escape cierra. Dentro de un `Field` toma id, aria-describedby, aria-invalid y required. Sin React (`@zuccadev-labs/zuix-zui/dom`): el panel es un `[popover]` con role=dialog.",
3823
3832
  "behavior": "dom",
3824
3833
  "examples": [
3825
3834
  {
@@ -3927,7 +3936,7 @@
3927
3936
  "classes": [
3928
3937
  "z-field"
3929
3938
  ],
3930
- "a11y": "label enlazado por htmlFor; ayuda y error por aria-describedby; el error usa role=\"alert\". `useFieldControl` permite conectar controles propios.",
3939
+ "a11y": "label enlazado por htmlFor; ayuda y error por aria-describedby; el error usa role=\"alert\". Los controles que `<label for>` no puede nombrar (RadioGroup, OTPInput, Slider) se enlazan con aria-labelledby a la etiqueta. `useFieldControl` y `useFieldLabel` permiten conectar controles propios.",
3931
3940
  "examples": [
3932
3941
  {
3933
3942
  "title": "Con ayuda",
@@ -3939,7 +3948,7 @@
3939
3948
  },
3940
3949
  {
3941
3950
  "title": "En línea",
3942
- "code": "<Field label=\"Region\" layout=\"inline\" optionalLabel=\"Optional\">\n <Select options={[{ value: \"eu\", label: \"Europe\" }, { value: \"us\", label: \"United States\" }]} />\n</Field>"
3951
+ "code": "<Field label=\"Region\" layout=\"inline\" optionalLabel=\"Optional\">\n <NativeSelect options={[{ value: \"eu\", label: \"Europe\" }, { value: \"us\", label: \"United States\" }]} />\n</Field>"
3943
3952
  }
3944
3953
  ],
3945
3954
  "origin": "Etiqueta, pista y error del Input del design system base, extraídos a una envoltura común.",
@@ -4352,7 +4361,7 @@
4352
4361
  "name": "label",
4353
4362
  "type": "string",
4354
4363
  "default": "Verification code",
4355
- "description": "Nombre accesible del grupo."
4364
+ "description": "Nombre accesible del grupo. Sin `label` y dentro de un `Field` con etiqueta, el grupo se nombra con ella."
4356
4365
  },
4357
4366
  {
4358
4367
  "name": "cellLabel",
@@ -4396,7 +4405,7 @@
4396
4405
  "classes": [
4397
4406
  "z-otp"
4398
4407
  ],
4399
- "a11y": "role group con nombre; cada casilla tiene su aria-label. Avance automático, Retroceso, flechas y pegado del código completo; autocomplete one-time-code. Sin React (`@zuccadev-labs/zuix-zui/dom`): el role=group con su nombre y el aria-label de cada casilla van en el marcado; el módulo aporta el avance automático, Retroceso, flechas y el pegado del código completo, y emite `z:change` con `detail.complete`.",
4408
+ "a11y": "role group con nombre; cada casilla tiene su aria-label. Avance automático, Retroceso, Supr, flechas y pegado del código completo; autocomplete one-time-code. Sin React (`@zuccadev-labs/zuix-zui/dom`): el role=group con su nombre y el aria-label de cada casilla van en el marcado; el módulo aporta el avance automático, Retroceso, flechas y el pegado del código completo, y emite `z:change` con `detail.complete`.",
4400
4409
  "behavior": "dom",
4401
4410
  "examples": [
4402
4411
  {
@@ -4477,14 +4486,14 @@
4477
4486
  "z-radio",
4478
4487
  "z-check__text"
4479
4488
  ],
4480
- "a11y": "Radix RadioGroup.Item: role radio. Solo funciona dentro de `RadioGroup`.",
4489
+ "a11y": "Botón con role radio y un `input type=radio` oculto para formularios. Solo funciona dentro de `RadioGroup`.",
4481
4490
  "examples": [
4482
4491
  {
4483
4492
  "title": "Dentro de un grupo",
4484
4493
  "code": "<RadioGroup aria-label=\"Theme\" defaultValue=\"dark\">\n <Radio value=\"light\">Light</Radio>\n <Radio value=\"dark\">Dark</Radio>\n</RadioGroup>"
4485
4494
  }
4486
4495
  ],
4487
- "origin": "Nuevo, sobre RadioGroup de radix-ui.",
4496
+ "origin": "Nuevo, con primitiva propia (patrón APG).",
4488
4497
  "file": "zui/src/components/forms/Radio.manifest.json"
4489
4498
  },
4490
4499
  {
@@ -4529,6 +4538,12 @@
4529
4538
  "name": "name",
4530
4539
  "type": "string"
4531
4540
  },
4541
+ {
4542
+ "name": "required",
4543
+ "type": "boolean",
4544
+ "default": false,
4545
+ "description": "El formulario no se envía sin una opción elegida; el grupo expone aria-required."
4546
+ },
4532
4547
  {
4533
4548
  "name": "aria-label",
4534
4549
  "type": "string",
@@ -4548,7 +4563,7 @@
4548
4563
  "classes": [
4549
4564
  "z-radio-group"
4550
4565
  ],
4551
- "a11y": "Radix RadioGroup: role radiogroup, foco itinerante con flechas.",
4566
+ "a11y": "Patrón APG «radiogroup»: foco itinerante con flechas (reflejadas en RTL), que también eligen.",
4552
4567
  "examples": [
4553
4568
  {
4554
4569
  "title": "Vertical",
@@ -4559,7 +4574,7 @@
4559
4574
  "code": "<Field label=\"Density\">\n <RadioGroup orientation=\"horizontal\" value={density} onValueChange={setDensity}>\n <Radio value=\"compact\">Compact</Radio>\n <Radio value=\"comfortable\">Comfortable</Radio>\n </RadioGroup>\n</Field>"
4560
4575
  }
4561
4576
  ],
4562
- "origin": "Nuevo, sobre RadioGroup de radix-ui.",
4577
+ "origin": "Nuevo, con primitiva propia (patrón APG).",
4563
4578
  "file": "zui/src/components/forms/RadioGroup.manifest.json"
4564
4579
  },
4565
4580
  {
@@ -4828,7 +4843,7 @@
4828
4843
  "z-select",
4829
4844
  "z-listbox"
4830
4845
  ],
4831
- "a11y": "Select de Radix: botón con role=combobox y lista role=listbox; flechas, Home/End, Enter/Espacio, Escape y búsqueda por letra. Dentro de un `Field` toma de él id, aria-describedby, aria-invalid y required. Sin React (`@zuccadev-labs/zuix-zui/dom`): el foco entra en la lista (foco itinerante) y vuelve al botón al cerrar.",
4846
+ "a11y": "Patrón APG «select-only combobox»: botón con role=combobox y lista role=listbox; flechas, Home/End, Enter/Espacio, Escape y búsqueda por letra. Dentro de un `Field` toma de él id, aria-describedby, aria-invalid y required. Sin React (`@zuccadev-labs/zuix-zui/dom`): el foco entra en la lista (foco itinerante) y vuelve al botón al cerrar.",
4832
4847
  "behavior": "dom",
4833
4848
  "examples": [
4834
4849
  {
@@ -4901,6 +4916,12 @@
4901
4916
  "type": "number",
4902
4917
  "default": 1
4903
4918
  },
4919
+ {
4920
+ "name": "minStepsBetweenThumbs",
4921
+ "type": "number",
4922
+ "default": 0,
4923
+ "description": "Pasos mínimos entre dos tiradores."
4924
+ },
4904
4925
  {
4905
4926
  "name": "orientation",
4906
4927
  "type": "enum",
@@ -4910,6 +4931,12 @@
4910
4931
  ],
4911
4932
  "default": "horizontal"
4912
4933
  },
4934
+ {
4935
+ "name": "inverted",
4936
+ "type": "boolean",
4937
+ "default": false,
4938
+ "description": "La pista crece en sentido contrario: de derecha a izquierda (o de arriba abajo)."
4939
+ },
4913
4940
  {
4914
4941
  "name": "size",
4915
4942
  "type": "enum",
@@ -4933,6 +4960,16 @@
4933
4960
  "name": "disabled",
4934
4961
  "type": "boolean",
4935
4962
  "default": false
4963
+ },
4964
+ {
4965
+ "name": "name",
4966
+ "type": "string",
4967
+ "description": "Nombre del campo al enviar un formulario; con varios tiradores envía un valor por tirador con el mismo nombre."
4968
+ },
4969
+ {
4970
+ "name": "form",
4971
+ "type": "string",
4972
+ "description": "Id del formulario al que pertenece, si no está dentro de él."
4936
4973
  }
4937
4974
  ],
4938
4975
  "states": [
@@ -4956,7 +4993,7 @@
4956
4993
  "classes": [
4957
4994
  "z-slider"
4958
4995
  ],
4959
- "a11y": "Radix Slider: role slider por tirador; flechas, Inicio, Fin y Re/Av Pág. Sin React (`@zuccadev-labs/zuix-zui/dom`): mismo teclado; con Mayús o Re/Av Pág el paso es diez veces mayor.",
4996
+ "a11y": "Patrón APG «slider»: role slider por tirador; flechas, Inicio, Fin y Re/Av Pág. Sin React (`@zuccadev-labs/zuix-zui/dom`): mismo teclado; con Mayús o Re/Av Pág el paso es diez veces mayor.",
4960
4997
  "behavior": "dom",
4961
4998
  "examples": [
4962
4999
  {
@@ -4979,7 +5016,7 @@
4979
5016
  "code": "<span class=\"z-slider\" id=\"price\" data-size=\"md\" data-orientation=\"horizontal\" data-min=\"0\" data-max=\"500\" data-step=\"10\" data-value=\"120,380\">\n <span class=\"z-slider__track\"><span class=\"z-slider__range\"></span></span>\n <span class=\"z-slider__thumb\" role=\"slider\" tabindex=\"0\" aria-label=\"Minimum\" aria-valuemin=\"0\" aria-valuemax=\"500\" aria-valuenow=\"120\" aria-orientation=\"horizontal\"></span>\n <span class=\"z-slider__thumb\" role=\"slider\" tabindex=\"0\" aria-label=\"Maximum\" aria-valuemin=\"0\" aria-valuemax=\"500\" aria-valuenow=\"380\" aria-orientation=\"horizontal\"></span>\n</span>"
4980
5017
  }
4981
5018
  ],
4982
- "origin": "Nuevo, sobre Slider de radix-ui.",
5019
+ "origin": "Nuevo, con primitiva propia (patrón APG).",
4983
5020
  "file": "zui/src/components/forms/Slider.manifest.json"
4984
5021
  },
4985
5022
  {
@@ -5033,6 +5070,18 @@
5033
5070
  {
5034
5071
  "name": "name",
5035
5072
  "type": "string"
5073
+ },
5074
+ {
5075
+ "name": "value",
5076
+ "type": "string",
5077
+ "default": "on",
5078
+ "description": "Valor que envía el formulario cuando está activado."
5079
+ },
5080
+ {
5081
+ "name": "required",
5082
+ "type": "boolean",
5083
+ "default": false,
5084
+ "description": "El formulario no se envía si está desactivado."
5036
5085
  }
5037
5086
  ],
5038
5087
  "states": [
@@ -5064,7 +5113,7 @@
5064
5113
  "classes": [
5065
5114
  "z-switch"
5066
5115
  ],
5067
- "a11y": "Radix Switch: role switch, Espacio o Enter para alternar.",
5116
+ "a11y": "Patrón APG «switch»: botón con role switch y un `input type=checkbox` oculto para formularios, Espacio o Enter para alternar.",
5068
5117
  "examples": [
5069
5118
  {
5070
5119
  "title": "Con etiqueta",
@@ -5075,7 +5124,7 @@
5075
5124
  "code": "<Switch size=\"sm\" aria-label=\"Enable rule\" defaultChecked />"
5076
5125
  }
5077
5126
  ],
5078
- "origin": "Switch de zutool, sobre Switch de radix-ui.",
5127
+ "origin": "Switch de zutool, con primitiva propia (patrón APG).",
5079
5128
  "file": "zui/src/components/forms/Switch.manifest.json"
5080
5129
  },
5081
5130
  {
@@ -5262,14 +5311,14 @@
5262
5311
  "z-accordion__content",
5263
5312
  "z-accordion__body"
5264
5313
  ],
5265
- "a11y": "Radix Accordion: cada cabecera es un botón dentro de un encabezado con aria-expanded y aria-controls; flechas, Inicio y Fin mueven entre cabeceras.",
5314
+ "a11y": "Patrón APG «accordion»: cada cabecera es un botón dentro de un encabezado con aria-expanded y aria-controls; flechas, Inicio y Fin mueven entre cabeceras.",
5266
5315
  "examples": [
5267
5316
  {
5268
5317
  "title": "Preguntas frecuentes",
5269
5318
  "code": "<Accordion\n defaultValue={[\"billing\"]}\n items={[\n { value: \"billing\", title: \"How does billing work?\", content: <p>You are charged monthly.</p> },\n { value: \"cancel\", title: \"Can I cancel anytime?\", content: <p>Yes, from your account settings.</p> },\n ]}\n/>"
5270
5319
  }
5271
5320
  ],
5272
- "origin": "Nuevo; accesibilidad de Radix Accordion.",
5321
+ "origin": "Nuevo; accesibilidad según el patrón APG, con primitivas propias.",
5273
5322
  "behavior": "dom",
5274
5323
  "html": [
5275
5324
  {
@@ -5718,6 +5767,12 @@
5718
5767
  "name": "children",
5719
5768
  "type": "ReactNode",
5720
5769
  "description": "Paneles `TabPanel` (props: value, keepMounted)."
5770
+ },
5771
+ {
5772
+ "name": "keepMounted",
5773
+ "type": "boolean",
5774
+ "default": false,
5775
+ "description": "TabPanel: mantiene el contenido montado aunque el panel esté oculto."
5721
5776
  }
5722
5777
  ],
5723
5778
  "states": [
@@ -5757,7 +5812,7 @@
5757
5812
  "z-tabs__label",
5758
5813
  "z-tabs__panel"
5759
5814
  ],
5760
- "a11y": "Radix Tabs: roles tablist, tab y tabpanel, flechas entre pestañas, Inicio/Fin y activación automática.",
5815
+ "a11y": "Patrón APG «tabs»: roles tablist, tab y tabpanel, flechas entre pestañas, Inicio/Fin y activación automática.",
5761
5816
  "examples": [
5762
5817
  {
5763
5818
  "title": "Segmentado con contenido",
@@ -5768,7 +5823,7 @@
5768
5823
  "code": "<Tabs variant=\"underline\" value={tab} onValueChange={setTab} items={[{ value: \"code\", label: \"Code\" }, { value: \"preview\", label: \"Preview\" }]}>\n <TabPanel value=\"code\">Code view</TabPanel>\n <TabPanel value=\"preview\">Preview view</TabPanel>\n</Tabs>"
5769
5824
  }
5770
5825
  ],
5771
- "origin": "Tabs (control segmentado) y `.tabstrip` de zutool; variante underline nueva; accesibilidad de Radix Tabs.",
5826
+ "origin": "Tabs (control segmentado) y `.tabstrip` de zutool; variante underline nueva; accesibilidad según el patrón APG, con primitivas propias.",
5772
5827
  "behavior": "dom",
5773
5828
  "html": [
5774
5829
  {
@@ -5855,7 +5910,7 @@
5855
5910
  "z-tree__label",
5856
5911
  "z-tree__group"
5857
5912
  ],
5858
- "a11y": "Roles tree, treeitem y group con aria-expanded, aria-selected, aria-level, aria-setsize y aria-posinset. Foco itinerante: arriba/abajo recorren, derecha expande o entra, izquierda pliega o sube al padre, Inicio/Fin, Intro o Espacio seleccionan.",
5913
+ "a11y": "Roles tree, treeitem y group con aria-expanded, aria-selected, aria-level, aria-setsize y aria-posinset. Foco itinerante: arriba/abajo recorren, derecha expande o entra, izquierda pliega o sube al padre, Inicio/Fin, Intro o Espacio seleccionan, y una letra salta al siguiente nodo que empieza por ella. En RTL izquierda y derecha se invierten.",
5859
5914
  "examples": [
5860
5915
  {
5861
5916
  "title": "Explorador de archivos",
@@ -5981,17 +6036,16 @@
5981
6036
  "z-palette__item",
5982
6037
  "z-palette__item-hint",
5983
6038
  "z-palette__kbd",
5984
- "z-palette__empty",
5985
- "z-overlay-scrim"
6039
+ "z-palette__empty"
5986
6040
  ],
5987
- "a11y": "Radix Dialog con un combobox (aria-activedescendant) sobre un listbox agrupado. Flechas arriba/abajo, Inicio/Fin, Intro ejecuta, Escape cierra y el foco vuelve a donde estaba.",
6041
+ "a11y": "`<dialog>` modal con un combobox (aria-activedescendant) sobre un listbox agrupado. Flechas arriba/abajo, Inicio/Fin, Intro ejecuta, Escape cierra y el foco vuelve a donde estaba.",
5988
6042
  "examples": [
5989
6043
  {
5990
6044
  "title": "Abrir con Ctrl/Cmd K",
5991
6045
  "code": "function Palette() {\n const [open, setOpen] = useState(false);\n useEffect(() => {\n const onKey = (e: KeyboardEvent) => {\n if ((e.metaKey || e.ctrlKey) && e.key === \"k\") {\n e.preventDefault();\n setOpen((v) => !v);\n }\n };\n window.addEventListener(\"keydown\", onKey);\n return () => window.removeEventListener(\"keydown\", onKey);\n }, []);\n return (\n <CommandPalette\n open={open}\n onOpenChange={setOpen}\n groups={[\n { heading: \"Navigation\", commands: [\n { id: \"home\", label: \"Go to home\", shortcut: \"G H\", onSelect: () => navigate(\"/\") },\n { id: \"settings\", label: \"Open settings\", hint: \"/settings\", onSelect: () => navigate(\"/settings\") },\n ] },\n { heading: \"Actions\", commands: [\n { id: \"new\", label: \"New project\", keywords: [\"create\"], onSelect: () => createProject() },\n ] },\n ]}\n />\n );\n}"
5992
6046
  }
5993
6047
  ],
5994
- "origin": "CommandPalette de zutool (puntuación difusa, medidas y aspecto); diálogo de Radix, sin dependencia cmdk.",
6048
+ "origin": "CommandPalette de zutool (puntuación difusa, medidas y aspecto); `<dialog>` nativo, sin dependencia cmdk.",
5995
6049
  "behavior": "dom",
5996
6050
  "html": [
5997
6051
  {
@@ -6128,17 +6182,16 @@
6128
6182
  "z-confirm",
6129
6183
  "z-confirm__icon",
6130
6184
  "z-modal",
6131
- "z-dialog-btn",
6132
- "z-overlay-scrim"
6185
+ "z-dialog-btn"
6133
6186
  ],
6134
- "a11y": "Radix AlertDialog: role=alertdialog, el foco entra en Cancelar, Escape cancela y un clic fuera no cierra.",
6187
+ "a11y": "`<dialog>` modal con role=alertdialog (patrón APG), el foco entra en Cancelar, Escape cancela y un clic fuera no cierra.",
6135
6188
  "examples": [
6136
6189
  {
6137
6190
  "title": "Borrado destructivo",
6138
6191
  "code": "<ConfirmDialog\n trigger={<button type=\"button\">Delete project</button>}\n intent=\"danger\"\n title=\"Delete project?\"\n description=\"This cannot be undone.\"\n confirmLabel=\"Delete\"\n onConfirm={() => removeProject()}\n/>"
6139
6192
  }
6140
6193
  ],
6141
- "origin": "ConfirmDialog y `.liquid.confirm` de zutool; accesibilidad de Radix AlertDialog.",
6194
+ "origin": "ConfirmDialog y `.liquid.confirm` de zutool; accesibilidad según el patrón APG, con primitivas propias.",
6142
6195
  "behavior": "dom",
6143
6196
  "html": [
6144
6197
  {
@@ -6236,14 +6289,14 @@
6236
6289
  "z-menu__label",
6237
6290
  "z-menu__chevron"
6238
6291
  ],
6239
- "a11y": "React: Radix ContextMenu, que se abre en el puntero dentro de la ventana, también con la tecla de menú o Mayús+F10; flechas, Escape, submenús y roles de menú. Sin React (`@zuccadev-labs/zuix-zui/dom`): `data-z-context=\"#id\"` abre el menú en el puntero con clic derecho y enfoca su primera entrada; flechas, Inicio/Fin, búsqueda por letra, Tab y Escape como en Menu. Los submenús se declaran con `data-z-submenu=\"#id\"` y se manejan igual: Flecha derecha o Intro abren, Flecha izquierda o Escape cierran solo el submenú. La apertura con la tecla de menú o Mayús+F10 depende del evento `contextmenu` del navegador.",
6292
+ "a11y": "React: menú propio (patrón APG «menu»), que se abre en el puntero dentro de la ventana, también con la tecla de menú o Mayús+F10, y enfoca su primera entrada; flechas, Escape, submenús y roles de menú. Sin React (`@zuccadev-labs/zuix-zui/dom`): `data-z-context=\"#id\"` abre el menú en el puntero con clic derecho y enfoca su primera entrada; flechas, Inicio/Fin, búsqueda por letra, Tab y Escape como en Menu. Los submenús se declaran con `data-z-submenu=\"#id\"` y se manejan igual: Flecha derecha o Intro abren, Flecha izquierda o Escape cierran solo el submenú. La apertura con la tecla de menú o Mayús+F10 depende del evento `contextmenu` del navegador.",
6240
6293
  "examples": [
6241
6294
  {
6242
6295
  "title": "Sobre una tarjeta",
6243
6296
  "code": "<ContextMenu\n label=\"File actions\"\n items={[\n { id: \"open\", label: \"Open\", onSelect: () => openFile() },\n { id: \"move\", label: \"Move to\", items: [\n { id: \"archive\", label: \"Archive\", onSelect: () => moveTo(\"archive\") },\n { id: \"inbox\", label: \"Inbox\", onSelect: () => moveTo(\"inbox\") },\n ] },\n { type: \"separator\" },\n { id: \"delete\", label: \"Delete\", danger: true, shortcut: \"Del\", onSelect: () => removeFile() },\n ]}\n>\n <div>Right-click this area</div>\n</ContextMenu>"
6244
6297
  }
6245
6298
  ],
6246
- "origin": "ContextMenu y `.ctx-menu` de zutool (las subpáginas pasan a submenús); accesibilidad de Radix ContextMenu.",
6299
+ "origin": "ContextMenu y `.ctx-menu` de zutool (las subpáginas pasan a submenús); accesibilidad según el patrón APG, con primitivas propias.",
6247
6300
  "behavior": "dom",
6248
6301
  "html": [
6249
6302
  {
@@ -6375,10 +6428,9 @@
6375
6428
  "z-drawer__description",
6376
6429
  "z-drawer__body",
6377
6430
  "z-drawer__footer",
6378
- "z-drawer__close",
6379
- "z-overlay-scrim"
6431
+ "z-drawer__close"
6380
6432
  ],
6381
- "a11y": "Radix Dialog modal: trampa de foco, Escape y clic en el velo cierran, el foco vuelve al disparador.",
6433
+ "a11y": "`<dialog>` abierto con `showModal()`: el resto de la página queda inerte, Tab da la vuelta dentro, Escape y clic en el velo cierran, el foco vuelve al disparador.",
6382
6434
  "examples": [
6383
6435
  {
6384
6436
  "title": "Filtros a la derecha",
@@ -6389,7 +6441,7 @@
6389
6441
  "code": "<Drawer open={open} onOpenChange={setOpen} side=\"bottom\" title=\"Details\">\n <p>Details go here.</p>\n</Drawer>"
6390
6442
  }
6391
6443
  ],
6392
- "origin": "Cajones con velo (`.shell-drawer`, `.shell-scrim`) de zutool; accesibilidad de Radix Dialog.",
6444
+ "origin": "Cajones con velo (`.shell-drawer`, `.shell-scrim`) de zutool; accesibilidad según el patrón APG, con primitivas propias.",
6393
6445
  "behavior": "dom",
6394
6446
  "html": [
6395
6447
  {
@@ -6512,14 +6564,14 @@
6512
6564
  "z-menu__label",
6513
6565
  "z-menu__chevron"
6514
6566
  ],
6515
- "a11y": "React: Radix DropdownMenu, con role=menu y menuitem, flechas, Inicio/Fin, búsqueda por letra, submenús y Escape, que cierra y devuelve el foco al disparador. Sin React (`@zuccadev-labs/zuix-zui/dom`): los roles, `aria-haspopup` y `aria-expanded` del disparador van en el marcado; el módulo mueve el foco con flechas, Inicio/Fin y búsqueda por letra, Tab cierra y Escape devuelve el foco al disparador. Una entrada con `data-z-submenu=\"#id\"` lleva `aria-haspopup=menu`, `aria-expanded` y `aria-controls`: Flecha derecha, Intro o Espacio abren el submenú y enfocan su primera entrada; Flecha izquierda o Escape cierran solo ese submenú y devuelven el foco a la entrada; elegir cierra toda la cadena.",
6567
+ "a11y": "Al abrirse, con el teclado o con el puntero, el foco va a la primera entrada (patrón APG «menu button»), igual en React y sin React. React: menú propio, con role=menu y menuitem, flechas, Inicio/Fin, búsqueda por letra, submenús y Escape, que cierra y devuelve el foco al disparador. Sin React (`@zuccadev-labs/zuix-zui/dom`): los roles, `aria-haspopup` y `aria-expanded` del disparador van en el marcado; el módulo mueve el foco con flechas, Inicio/Fin y búsqueda por letra, Tab cierra y Escape devuelve el foco al disparador. Una entrada con `data-z-submenu=\"#id\"` lleva `aria-haspopup=menu`, `aria-expanded` y `aria-controls`: Flecha derecha, Intro o Espacio abren el submenú y enfocan su primera entrada; Flecha izquierda o Escape cierran solo ese submenú y devuelven el foco a la entrada; elegir cierra toda la cadena.",
6516
6568
  "examples": [
6517
6569
  {
6518
6570
  "title": "Acciones de una fila",
6519
6571
  "code": "<Menu\n label=\"Project actions\"\n trigger={<button type=\"button\">Actions</button>}\n items={[\n { type: \"label\", label: \"Project\" },\n { id: \"rename\", label: \"Rename\", icon: \"pencil\", shortcut: \"F2\", onSelect: () => rename() },\n { id: \"duplicate\", label: \"Duplicate\", icon: \"copy\", onSelect: () => duplicate() },\n { type: \"separator\" },\n { id: \"delete\", label: \"Delete\", icon: \"trash\", danger: true, onSelect: () => remove() },\n ]}\n/>"
6520
6572
  }
6521
6573
  ],
6522
- "origin": "Menu y `.ctx-menu` de zutool; accesibilidad de Radix DropdownMenu.",
6574
+ "origin": "Menu y `.ctx-menu` de zutool; accesibilidad según el patrón APG, con primitivas propias.",
6523
6575
  "behavior": "dom",
6524
6576
  "html": [
6525
6577
  {
@@ -6653,10 +6705,9 @@
6653
6705
  "z-modal__body",
6654
6706
  "z-modal__footer",
6655
6707
  "z-modal__close",
6656
- "z-overlay-scrim",
6657
6708
  "z-overlay-close"
6658
6709
  ],
6659
- "a11y": "Radix Dialog: role=dialog, aria-modal, trampa de foco, Escape cierra y el foco vuelve al disparador. El título nombra el diálogo; sin título se usa `label` oculto visualmente.",
6710
+ "a11y": "`<dialog>` abierto con `showModal()`: el resto de la página queda inerte, Tab da la vuelta dentro, Escape cierra y el foco vuelve al disparador. El título nombra el diálogo; sin título se usa `label` como `aria-label`.",
6660
6711
  "examples": [
6661
6712
  {
6662
6713
  "title": "Con disparador y pie",
@@ -6667,7 +6718,7 @@
6667
6718
  "code": "<Modal open={open} onOpenChange={setOpen} size=\"lg\" title=\"Release notes\">\n <p>Version 2.4 brings a new command palette.</p>\n</Modal>"
6668
6719
  }
6669
6720
  ],
6670
- "origin": "Tamaños y API de Modal de design system base; material y animación de los diálogos de zutool; accesibilidad de Radix Dialog.",
6721
+ "origin": "Tamaños y API de Modal de design system base; material y animación de los diálogos de zutool; accesibilidad según el patrón APG, con primitivas propias.",
6671
6722
  "behavior": "dom",
6672
6723
  "html": [
6673
6724
  {
@@ -6735,12 +6786,18 @@
6735
6786
  {
6736
6787
  "name": "label",
6737
6788
  "type": "string",
6738
- "description": "Nombre accesible del panel."
6789
+ "description": "Nombre accesible del panel. Obligatorio salvo que se pase `aria-labelledby` con el id de un encabezado del panel."
6790
+ },
6791
+ {
6792
+ "name": "aria-labelledby",
6793
+ "type": "string",
6794
+ "description": "Id de un encabezado del panel que le da nombre. Alternativa a `label`."
6739
6795
  },
6740
6796
  {
6741
6797
  "name": "modal",
6742
6798
  "type": "boolean",
6743
- "default": false
6799
+ "default": false,
6800
+ "description": "Modal: el panel es un <dialog> abierto con showModal(). El resto de la página queda inerte (puntero, foco y lectores de pantalla), Tab da la vuelta dentro y una pulsación fuera solo lo cierra."
6744
6801
  },
6745
6802
  {
6746
6803
  "name": "children",
@@ -6774,14 +6831,14 @@
6774
6831
  "classes": [
6775
6832
  "z-popover"
6776
6833
  ],
6777
- "a11y": "Radix Popover: el disparador expone aria-expanded, el foco entra en el panel, Escape o un clic fuera cierran y el foco vuelve al disparador.",
6834
+ "a11y": "Capa `popover` propia: el disparador expone aria-expanded, el foco entra en el panel, Escape o un clic fuera cierran y el foco vuelve al disparador. El panel es role=dialog y su nombre es obligatorio: `label`, o `aria-labelledby` con el id de un encabezado suyo. Con `modal` el panel es un <dialog> abierto con showModal(): el resto de la página queda inerte, Tab da la vuelta dentro y una pulsación fuera solo lo cierra.",
6778
6835
  "examples": [
6779
6836
  {
6780
6837
  "title": "Panel de detalles",
6781
6838
  "code": "<Popover trigger={<button type=\"button\">Usage</button>} label=\"Usage details\" width={280}>\n <p>1,204 requests this month.</p>\n</Popover>"
6782
6839
  }
6783
6840
  ],
6784
- "origin": "Popover de zutool (alineado al final, separación de 4 px); posicionamiento de Radix Popover.",
6841
+ "origin": "Popover de zutool (alineado al final, separación de 4 px); colocación propia (`core/place`).",
6785
6842
  "behavior": "dom",
6786
6843
  "html": [
6787
6844
  {
@@ -6831,10 +6888,10 @@
6831
6888
  "default": "Close"
6832
6889
  },
6833
6890
  {
6834
- "name": "label",
6891
+ "name": "regionLabel",
6835
6892
  "type": "string",
6836
- "default": "Notification",
6837
- "description": "ToastProvider: nombre anunciado por lectores de pantalla."
6893
+ "default": "Notifications (F8)",
6894
+ "description": "ToastProvider: nombre accesible de la región de avisos."
6838
6895
  },
6839
6896
  {
6840
6897
  "name": "toast",
@@ -6902,7 +6959,7 @@
6902
6959
  "z-toast__close",
6903
6960
  "z-toast-viewport"
6904
6961
  ],
6905
- "a11y": "Radix Toast: región con aria-live (asertiva en warning y danger), F8 lleva el foco a los avisos, se pausan con hover o foco y se descartan deslizando.",
6962
+ "a11y": "Región con nombre (role=region) en la capa superior, que se muda al diálogo modal abierto (fuera de él sería inerte) y vuelve a la página al cerrarlo; cada aviso es role=status, o role=alert en warning y danger, F8 lleva el foco a los avisos, se pausan con el puntero o el foco encima y con la ventana sin foco, Escape descarta el aviso enfocado y se descartan deslizando.",
6906
6963
  "examples": [
6907
6964
  {
6908
6965
  "title": "Proveedor y uso",
@@ -6913,7 +6970,7 @@
6913
6970
  "code": "const { toast } = useToast();\ntoast({ title: \"Upload failed\", intent: \"danger\", action: { label: \"Retry\", onClick: () => upload() } });"
6914
6971
  }
6915
6972
  ],
6916
- "origin": "Aspecto de ToastViewport de zutool; API de proveedor y hook de design system base; accesibilidad de Radix Toast.",
6973
+ "origin": "Aspecto de ToastViewport de zutool; API de proveedor y hook de design system base; accesibilidad según el patrón APG, con primitivas propias.",
6917
6974
  "behavior": "dom",
6918
6975
  "html": [
6919
6976
  {
@@ -7010,14 +7067,14 @@
7010
7067
  "classes": [
7011
7068
  "z-tooltip"
7012
7069
  ],
7013
- "a11y": "Radix Tooltip: aparece con hover y con foco de teclado, describe al disparador con aria-describedby y Escape lo cierra. No sustituye al nombre accesible del control.",
7070
+ "a11y": "Aparece con hover y con foco de teclado, describe al disparador con aria-describedby y Escape lo cierra. La burbuja recibe el puntero: se puede pasar del disparador a ella sin que se cierre (WCAG 1.4.13). Sin React (`data-z-tooltip`): lo mismo, y se añade a la descripción que el control ya tuviera. No sustituye al nombre accesible del control.",
7014
7071
  "examples": [
7015
7072
  {
7016
7073
  "title": "Sobre un botón de icono",
7017
7074
  "code": "<Tooltip content=\"Copy link\">\n <button type=\"button\" aria-label=\"Copy link\">Copy</button>\n</Tooltip>"
7018
7075
  }
7019
7076
  ],
7020
- "origin": "Tooltip y `.tooltip` de zutool; accesibilidad de Radix Tooltip.",
7077
+ "origin": "Tooltip y `.tooltip` de zutool; accesibilidad según el patrón APG, con primitivas propias.",
7021
7078
  "behavior": "dom",
7022
7079
  "html": [
7023
7080
  {