@zuccadev-labs/zuix-zui 0.0.0-stage → 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.
- package/AGENTS.md +199 -0
- package/CHANGELOG.md +269 -0
- package/LICENSE +21 -0
- package/README.md +137 -2
- package/THIRD_PARTY_NOTICES.md +71 -0
- package/dist/esm/components/actions/Button.d.ts +16 -0
- package/dist/esm/components/actions/Button.js +8 -0
- package/dist/esm/components/actions/Button.js.map +1 -0
- package/dist/esm/components/actions/IconButton.d.ts +16 -0
- package/dist/esm/components/actions/IconButton.js +8 -0
- package/dist/esm/components/actions/IconButton.js.map +1 -0
- package/dist/esm/components/actions/Link.d.ts +15 -0
- package/dist/esm/components/actions/Link.js +12 -0
- package/dist/esm/components/actions/Link.js.map +1 -0
- package/dist/esm/components/actions/SegmentedControl.d.ts +29 -0
- package/dist/esm/components/actions/SegmentedControl.js +36 -0
- package/dist/esm/components/actions/SegmentedControl.js.map +1 -0
- package/dist/esm/components/actions/Toggle.d.ts +15 -0
- package/dist/esm/components/actions/Toggle.js +16 -0
- package/dist/esm/components/actions/Toggle.js.map +1 -0
- package/dist/esm/components/actions/index.d.ts +6 -0
- package/dist/esm/components/actions/index.js +6 -0
- package/dist/esm/components/actions/index.js.map +1 -0
- package/dist/esm/components/actions/types.d.ts +5 -0
- package/dist/esm/components/actions/types.js +3 -0
- package/dist/esm/components/actions/types.js.map +1 -0
- package/dist/esm/components/carousel/Carousel.d.ts +44 -0
- package/dist/esm/components/carousel/Carousel.js +80 -0
- package/dist/esm/components/carousel/Carousel.js.map +1 -0
- package/dist/esm/components/carousel/engine.d.ts +52 -0
- package/dist/esm/components/carousel/engine.js +694 -0
- package/dist/esm/components/carousel/engine.js.map +1 -0
- package/dist/esm/components/carousel/index.d.ts +3 -0
- package/dist/esm/components/carousel/index.js +2 -0
- package/dist/esm/components/carousel/index.js.map +1 -0
- package/dist/esm/components/carousel/lens.d.ts +46 -0
- package/dist/esm/components/carousel/lens.js +117 -0
- package/dist/esm/components/carousel/lens.js.map +1 -0
- package/dist/esm/components/carousel/lensRenderer.d.ts +67 -0
- package/dist/esm/components/carousel/lensRenderer.js +383 -0
- package/dist/esm/components/carousel/lensRenderer.js.map +1 -0
- package/dist/esm/components/carousel/slideTexture.d.ts +17 -0
- package/dist/esm/components/carousel/slideTexture.js +44 -0
- package/dist/esm/components/carousel/slideTexture.js.map +1 -0
- package/dist/esm/components/carousel/useCarouselTrack.d.ts +31 -0
- package/dist/esm/components/carousel/useCarouselTrack.js +67 -0
- package/dist/esm/components/carousel/useCarouselTrack.js.map +1 -0
- package/dist/esm/components/content/Callout.d.ts +12 -0
- package/dist/esm/components/content/Callout.js +17 -0
- package/dist/esm/components/content/Callout.js.map +1 -0
- package/dist/esm/components/content/Card.d.ts +11 -0
- package/dist/esm/components/content/Card.js +7 -0
- package/dist/esm/components/content/Card.js.map +1 -0
- package/dist/esm/components/content/CardFooter.d.ts +7 -0
- package/dist/esm/components/content/CardFooter.js +7 -0
- package/dist/esm/components/content/CardFooter.js.map +1 -0
- package/dist/esm/components/content/CardHeader.d.ts +10 -0
- package/dist/esm/components/content/CardHeader.js +8 -0
- package/dist/esm/components/content/CardHeader.js.map +1 -0
- package/dist/esm/components/content/CodeBlock.d.ts +22 -0
- package/dist/esm/components/content/CodeBlock.js +32 -0
- package/dist/esm/components/content/CodeBlock.js.map +1 -0
- package/dist/esm/components/content/Divider.d.ts +12 -0
- package/dist/esm/components/content/Divider.js +7 -0
- package/dist/esm/components/content/Divider.js.map +1 -0
- package/dist/esm/components/content/Panel.d.ts +15 -0
- package/dist/esm/components/content/Panel.js +8 -0
- package/dist/esm/components/content/Panel.js.map +1 -0
- package/dist/esm/components/content/index.d.ts +7 -0
- package/dist/esm/components/content/index.js +8 -0
- package/dist/esm/components/content/index.js.map +1 -0
- package/dist/esm/components/data/Avatar.d.ts +17 -0
- package/dist/esm/components/data/Avatar.js +26 -0
- package/dist/esm/components/data/Avatar.js.map +1 -0
- package/dist/esm/components/data/AvatarGroup.d.ts +14 -0
- package/dist/esm/components/data/AvatarGroup.js +11 -0
- package/dist/esm/components/data/AvatarGroup.js.map +1 -0
- package/dist/esm/components/data/Badge.d.ts +15 -0
- package/dist/esm/components/data/Badge.js +8 -0
- package/dist/esm/components/data/Badge.js.map +1 -0
- package/dist/esm/components/data/Chip.d.ts +19 -0
- package/dist/esm/components/data/Chip.js +10 -0
- package/dist/esm/components/data/Chip.js.map +1 -0
- package/dist/esm/components/data/DataTable.d.ts +41 -0
- package/dist/esm/components/data/DataTable.js +56 -0
- package/dist/esm/components/data/DataTable.js.map +1 -0
- package/dist/esm/components/data/Kbd.d.ts +9 -0
- package/dist/esm/components/data/Kbd.js +13 -0
- package/dist/esm/components/data/Kbd.js.map +1 -0
- package/dist/esm/components/data/Meter.d.ts +23 -0
- package/dist/esm/components/data/Meter.js +10 -0
- package/dist/esm/components/data/Meter.js.map +1 -0
- package/dist/esm/components/data/Progress.d.ts +15 -0
- package/dist/esm/components/data/Progress.js +9 -0
- package/dist/esm/components/data/Progress.js.map +1 -0
- package/dist/esm/components/data/Rating.d.ts +20 -0
- package/dist/esm/components/data/Rating.js +37 -0
- package/dist/esm/components/data/Rating.js.map +1 -0
- package/dist/esm/components/data/StatTile.d.ts +20 -0
- package/dist/esm/components/data/StatTile.js +10 -0
- package/dist/esm/components/data/StatTile.js.map +1 -0
- package/dist/esm/components/data/Table.d.ts +22 -0
- package/dist/esm/components/data/Table.js +7 -0
- package/dist/esm/components/data/Table.js.map +1 -0
- package/dist/esm/components/data/index.d.ts +11 -0
- package/dist/esm/components/data/index.js +12 -0
- package/dist/esm/components/data/index.js.map +1 -0
- package/dist/esm/components/feedback/Alert.d.ts +17 -0
- package/dist/esm/components/feedback/Alert.js +17 -0
- package/dist/esm/components/feedback/Alert.js.map +1 -0
- package/dist/esm/components/feedback/EmptyState.d.ts +14 -0
- package/dist/esm/components/feedback/EmptyState.js +9 -0
- package/dist/esm/components/feedback/EmptyState.js.map +1 -0
- package/dist/esm/components/feedback/ErrorBoundary.d.ts +26 -0
- package/dist/esm/components/feedback/ErrorBoundary.js +31 -0
- package/dist/esm/components/feedback/ErrorBoundary.js.map +1 -0
- package/dist/esm/components/feedback/ErrorState.d.ts +17 -0
- package/dist/esm/components/feedback/ErrorState.js +11 -0
- package/dist/esm/components/feedback/ErrorState.js.map +1 -0
- package/dist/esm/components/feedback/LoadingOverlay.d.ts +15 -0
- package/dist/esm/components/feedback/LoadingOverlay.js +10 -0
- package/dist/esm/components/feedback/LoadingOverlay.js.map +1 -0
- package/dist/esm/components/feedback/Skeleton.d.ts +12 -0
- package/dist/esm/components/feedback/Skeleton.js +11 -0
- package/dist/esm/components/feedback/Skeleton.js.map +1 -0
- package/dist/esm/components/feedback/Spinner.d.ts +10 -0
- package/dist/esm/components/feedback/Spinner.js +7 -0
- package/dist/esm/components/feedback/Spinner.js.map +1 -0
- package/dist/esm/components/feedback/index.d.ts +7 -0
- package/dist/esm/components/feedback/index.js +8 -0
- package/dist/esm/components/feedback/index.js.map +1 -0
- package/dist/esm/components/forms/Calendar.d.ts +42 -0
- package/dist/esm/components/forms/Calendar.js +205 -0
- package/dist/esm/components/forms/Calendar.js.map +1 -0
- package/dist/esm/components/forms/Checkbox.d.ts +19 -0
- package/dist/esm/components/forms/Checkbox.js +23 -0
- package/dist/esm/components/forms/Checkbox.js.map +1 -0
- package/dist/esm/components/forms/Combobox.d.ts +51 -0
- package/dist/esm/components/forms/Combobox.js +174 -0
- package/dist/esm/components/forms/Combobox.js.map +1 -0
- package/dist/esm/components/forms/DateInput.d.ts +13 -0
- package/dist/esm/components/forms/DateInput.js +29 -0
- package/dist/esm/components/forms/DateInput.js.map +1 -0
- package/dist/esm/components/forms/DatePicker.d.ts +58 -0
- package/dist/esm/components/forms/DatePicker.js +91 -0
- package/dist/esm/components/forms/DatePicker.js.map +1 -0
- package/dist/esm/components/forms/Field.d.ts +40 -0
- package/dist/esm/components/forms/Field.js +41 -0
- package/dist/esm/components/forms/Field.js.map +1 -0
- package/dist/esm/components/forms/FileUpload.d.ts +28 -0
- package/dist/esm/components/forms/FileUpload.js +67 -0
- package/dist/esm/components/forms/FileUpload.js.map +1 -0
- package/dist/esm/components/forms/Input.d.ts +17 -0
- package/dist/esm/components/forms/Input.js +11 -0
- package/dist/esm/components/forms/Input.js.map +1 -0
- package/dist/esm/components/forms/NativeSelect.d.ts +21 -0
- package/dist/esm/components/forms/NativeSelect.js +12 -0
- package/dist/esm/components/forms/NativeSelect.js.map +1 -0
- package/dist/esm/components/forms/OTPInput.d.ts +26 -0
- package/dist/esm/components/forms/OTPInput.js +76 -0
- package/dist/esm/components/forms/OTPInput.js.map +1 -0
- package/dist/esm/components/forms/Radio.d.ts +9 -0
- package/dist/esm/components/forms/Radio.js +23 -0
- package/dist/esm/components/forms/Radio.js.map +1 -0
- package/dist/esm/components/forms/RadioGroup.d.ts +14 -0
- package/dist/esm/components/forms/RadioGroup.js +42 -0
- package/dist/esm/components/forms/RadioGroup.js.map +1 -0
- package/dist/esm/components/forms/SearchInput.d.ts +19 -0
- package/dist/esm/components/forms/SearchInput.js +42 -0
- package/dist/esm/components/forms/SearchInput.js.map +1 -0
- package/dist/esm/components/forms/Select.d.ts +50 -0
- package/dist/esm/components/forms/Select.js +144 -0
- package/dist/esm/components/forms/Select.js.map +1 -0
- package/dist/esm/components/forms/Slider.d.ts +27 -0
- package/dist/esm/components/forms/Slider.js +97 -0
- package/dist/esm/components/forms/Slider.js.map +1 -0
- package/dist/esm/components/forms/Switch.d.ts +18 -0
- package/dist/esm/components/forms/Switch.js +18 -0
- package/dist/esm/components/forms/Switch.js.map +1 -0
- package/dist/esm/components/forms/Textarea.d.ts +13 -0
- package/dist/esm/components/forms/Textarea.js +19 -0
- package/dist/esm/components/forms/Textarea.js.map +1 -0
- package/dist/esm/components/forms/index.d.ts +17 -0
- package/dist/esm/components/forms/index.js +18 -0
- package/dist/esm/components/forms/index.js.map +1 -0
- package/dist/esm/components/navigation/Accordion.d.ts +23 -0
- package/dist/esm/components/navigation/Accordion.js +63 -0
- package/dist/esm/components/navigation/Accordion.js.map +1 -0
- package/dist/esm/components/navigation/Breadcrumb.d.ts +16 -0
- package/dist/esm/components/navigation/Breadcrumb.js +13 -0
- package/dist/esm/components/navigation/Breadcrumb.js.map +1 -0
- package/dist/esm/components/navigation/NavList.d.ts +31 -0
- package/dist/esm/components/navigation/NavList.js +33 -0
- package/dist/esm/components/navigation/NavList.js.map +1 -0
- package/dist/esm/components/navigation/Pagination.d.ts +16 -0
- package/dist/esm/components/navigation/Pagination.js +21 -0
- package/dist/esm/components/navigation/Pagination.js.map +1 -0
- package/dist/esm/components/navigation/Stepper.d.ts +23 -0
- package/dist/esm/components/navigation/Stepper.js +13 -0
- package/dist/esm/components/navigation/Stepper.js.map +1 -0
- package/dist/esm/components/navigation/Tabs.d.ts +37 -0
- package/dist/esm/components/navigation/Tabs.js +48 -0
- package/dist/esm/components/navigation/Tabs.js.map +1 -0
- package/dist/esm/components/navigation/Tree.d.ts +24 -0
- package/dist/esm/components/navigation/Tree.js +137 -0
- package/dist/esm/components/navigation/Tree.js.map +1 -0
- package/dist/esm/components/navigation/index.d.ts +7 -0
- package/dist/esm/components/navigation/index.js +9 -0
- package/dist/esm/components/navigation/index.js.map +1 -0
- package/dist/esm/components/overlay/CommandPalette.d.ts +35 -0
- package/dist/esm/components/overlay/CommandPalette.js +102 -0
- package/dist/esm/components/overlay/CommandPalette.js.map +1 -0
- package/dist/esm/components/overlay/ConfirmDialog.d.ts +26 -0
- package/dist/esm/components/overlay/ConfirmDialog.js +29 -0
- package/dist/esm/components/overlay/ConfirmDialog.js.map +1 -0
- package/dist/esm/components/overlay/ContextMenu.d.ts +15 -0
- package/dist/esm/components/overlay/ContextMenu.js +54 -0
- package/dist/esm/components/overlay/ContextMenu.js.map +1 -0
- package/dist/esm/components/overlay/Drawer.d.ts +21 -0
- package/dist/esm/components/overlay/Drawer.js +15 -0
- package/dist/esm/components/overlay/Drawer.js.map +1 -0
- package/dist/esm/components/overlay/Menu.d.ts +18 -0
- package/dist/esm/components/overlay/Menu.js +30 -0
- package/dist/esm/components/overlay/Menu.js.map +1 -0
- package/dist/esm/components/overlay/Modal.d.ts +22 -0
- package/dist/esm/components/overlay/Modal.js +15 -0
- package/dist/esm/components/overlay/Modal.js.map +1 -0
- package/dist/esm/components/overlay/Popover.d.ts +34 -0
- package/dist/esm/components/overlay/Popover.js +58 -0
- package/dist/esm/components/overlay/Popover.js.map +1 -0
- package/dist/esm/components/overlay/Toast.d.ts +38 -0
- package/dist/esm/components/overlay/Toast.js +173 -0
- package/dist/esm/components/overlay/Toast.js.map +1 -0
- package/dist/esm/components/overlay/Tooltip.d.ts +16 -0
- package/dist/esm/components/overlay/Tooltip.js +69 -0
- package/dist/esm/components/overlay/Tooltip.js.map +1 -0
- package/dist/esm/components/overlay/index.d.ts +10 -0
- package/dist/esm/components/overlay/index.js +11 -0
- package/dist/esm/components/overlay/index.js.map +1 -0
- package/dist/esm/components/overlay/internal.d.ts +50 -0
- package/dist/esm/components/overlay/internal.js +37 -0
- package/dist/esm/components/overlay/internal.js.map +1 -0
- package/dist/esm/core/accept.d.ts +5 -0
- package/dist/esm/core/accept.js +13 -0
- package/dist/esm/core/accept.js.map +1 -0
- package/dist/esm/core/compare.d.ts +5 -0
- package/dist/esm/core/compare.js +27 -0
- package/dist/esm/core/compare.js.map +1 -0
- package/dist/esm/core/date.d.ts +27 -0
- package/dist/esm/core/date.js +59 -0
- package/dist/esm/core/date.js.map +1 -0
- package/dist/esm/core/dir.d.ts +4 -0
- package/dist/esm/core/dir.js +10 -0
- package/dist/esm/core/dir.js.map +1 -0
- package/dist/esm/core/focus.d.ts +16 -0
- package/dist/esm/core/focus.js +50 -0
- package/dist/esm/core/focus.js.map +1 -0
- package/dist/esm/core/keys.d.ts +6 -0
- package/dist/esm/core/keys.js +14 -0
- package/dist/esm/core/keys.js.map +1 -0
- package/dist/esm/core/layers.d.ts +33 -0
- package/dist/esm/core/layers.js +75 -0
- package/dist/esm/core/layers.js.map +1 -0
- package/dist/esm/core/long-press.d.ts +13 -0
- package/dist/esm/core/long-press.js +33 -0
- package/dist/esm/core/long-press.js.map +1 -0
- package/dist/esm/core/menu-aim.d.ts +17 -0
- package/dist/esm/core/menu-aim.js +48 -0
- package/dist/esm/core/menu-aim.js.map +1 -0
- package/dist/esm/core/modal-host.d.ts +16 -0
- package/dist/esm/core/modal-host.js +59 -0
- package/dist/esm/core/modal-host.js.map +1 -0
- package/dist/esm/core/pagination.d.ts +6 -0
- package/dist/esm/core/pagination.js +32 -0
- package/dist/esm/core/pagination.js.map +1 -0
- package/dist/esm/core/place.d.ts +54 -0
- package/dist/esm/core/place.js +97 -0
- package/dist/esm/core/place.js.map +1 -0
- package/dist/esm/core/presence.d.ts +7 -0
- package/dist/esm/core/presence.js +43 -0
- package/dist/esm/core/presence.js.map +1 -0
- package/dist/esm/core/ref.d.ts +9 -0
- package/dist/esm/core/ref.js +25 -0
- package/dist/esm/core/ref.js.map +1 -0
- package/dist/esm/core/roving.d.ts +6 -0
- package/dist/esm/core/roving.js +27 -0
- package/dist/esm/core/roving.js.map +1 -0
- package/dist/esm/core/scroll-lock.d.ts +2 -0
- package/dist/esm/core/scroll-lock.js +33 -0
- package/dist/esm/core/scroll-lock.js.map +1 -0
- package/dist/esm/core/search.d.ts +4 -0
- package/dist/esm/core/search.js +20 -0
- package/dist/esm/core/search.js.map +1 -0
- package/dist/esm/core/slider.d.ts +20 -0
- package/dist/esm/core/slider.js +66 -0
- package/dist/esm/core/slider.js.map +1 -0
- package/dist/esm/core/swipe.d.ts +18 -0
- package/dist/esm/core/swipe.js +78 -0
- package/dist/esm/core/swipe.js.map +1 -0
- package/dist/esm/core/timer.d.ts +11 -0
- package/dist/esm/core/timer.js +38 -0
- package/dist/esm/core/timer.js.map +1 -0
- package/dist/esm/core/typeahead.d.ts +19 -0
- package/dist/esm/core/typeahead.js +33 -0
- package/dist/esm/core/typeahead.js.map +1 -0
- package/dist/esm/cx.d.ts +2 -0
- package/dist/esm/cx.js +5 -0
- package/dist/esm/cx.js.map +1 -0
- package/dist/esm/dom/carousel-gl.d.ts +4 -0
- package/dist/esm/dom/carousel-gl.js +9 -0
- package/dist/esm/dom/carousel-gl.js.map +1 -0
- package/dist/esm/dom/carousel.d.ts +28 -0
- package/dist/esm/dom/carousel.js +334 -0
- package/dist/esm/dom/carousel.js.map +1 -0
- package/dist/esm/dom/collections.d.ts +14 -0
- package/dist/esm/dom/collections.js +567 -0
- package/dist/esm/dom/collections.js.map +1 -0
- package/dist/esm/dom/forms-calendar.d.ts +9 -0
- package/dist/esm/dom/forms-calendar.js +421 -0
- package/dist/esm/dom/forms-calendar.js.map +1 -0
- package/dist/esm/dom/forms-controls.d.ts +7 -0
- package/dist/esm/dom/forms-controls.js +355 -0
- package/dist/esm/dom/forms-controls.js.map +1 -0
- package/dist/esm/dom/forms-listbox.d.ts +18 -0
- package/dist/esm/dom/forms-listbox.js +585 -0
- package/dist/esm/dom/forms-listbox.js.map +1 -0
- package/dist/esm/dom/forms-popup.d.ts +22 -0
- package/dist/esm/dom/forms-popup.js +111 -0
- package/dist/esm/dom/forms-popup.js.map +1 -0
- package/dist/esm/dom/forms.d.ts +6 -0
- package/dist/esm/dom/forms.js +37 -0
- package/dist/esm/dom/forms.js.map +1 -0
- package/dist/esm/dom/index.d.ts +67 -0
- package/dist/esm/dom/index.js +1087 -0
- package/dist/esm/dom/index.js.map +1 -0
- package/dist/esm/dom/shared.d.ts +22 -0
- package/dist/esm/dom/shared.js +45 -0
- package/dist/esm/dom/shared.js.map +1 -0
- package/dist/esm/index.d.ts +9 -0
- package/dist/esm/index.js +11 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/primitives/dialog.d.ts +17 -0
- package/dist/esm/primitives/dialog.js +78 -0
- package/dist/esm/primitives/dialog.js.map +1 -0
- package/dist/esm/primitives/hooks.d.ts +15 -0
- package/dist/esm/primitives/hooks.js +65 -0
- package/dist/esm/primitives/hooks.js.map +1 -0
- package/dist/esm/primitives/menu.d.ts +26 -0
- package/dist/esm/primitives/menu.js +249 -0
- package/dist/esm/primitives/menu.js.map +1 -0
- package/dist/esm/primitives/native-input.d.ts +13 -0
- package/dist/esm/primitives/native-input.js +26 -0
- package/dist/esm/primitives/native-input.js.map +1 -0
- package/dist/esm/primitives/popup.d.ts +51 -0
- package/dist/esm/primitives/popup.js +137 -0
- package/dist/esm/primitives/popup.js.map +1 -0
- package/dist/esm/primitives/radio-context.d.ts +11 -0
- package/dist/esm/primitives/radio-context.js +5 -0
- package/dist/esm/primitives/radio-context.js.map +1 -0
- package/dist/esm/primitives/slot.d.ts +13 -0
- package/dist/esm/primitives/slot.js +39 -0
- package/dist/esm/primitives/slot.js.map +1 -0
- package/dist/esm/refs.d.ts +8 -0
- package/dist/esm/refs.js +32 -0
- package/dist/esm/refs.js.map +1 -0
- package/dist/styles/actions.css +326 -0
- package/dist/styles/base.css +232 -0
- package/dist/styles/carousel.css +179 -0
- package/dist/styles/content.css +352 -0
- package/dist/styles/data.css +737 -0
- package/dist/styles/feedback.css +282 -0
- package/dist/styles/forms.css +1118 -0
- package/dist/styles/index.css +12 -0
- package/dist/styles/material.css +56 -0
- package/dist/styles/native.css +140 -0
- package/dist/styles/navigation.css +698 -0
- package/dist/styles/overlay.css +758 -0
- package/dist/zui.css +4555 -0
- package/dist/zui.dom.carousel-gl.js +147 -0
- package/dist/zui.dom.js +2 -0
- package/html.json +1275 -0
- package/manifest.json +7088 -0
- package/package.json +103 -3
package/AGENTS.md
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
# Zui · guía para agentes
|
|
2
|
+
|
|
3
|
+
Guía para los agentes de IA que usan o extienden `@zuccadev-labs/zuix-zui`. Formato: reglas → patrones →
|
|
4
|
+
verificación. Un cambio está terminado cuando la verificación pasa.
|
|
5
|
+
|
|
6
|
+
## Reglas
|
|
7
|
+
|
|
8
|
+
0. **El contrato es el marcado, no React.** Un componente es HTML con clases `z-*` y atributos de estado,
|
|
9
|
+
más su CSS. El `.tsx` es el binding de React que produce ese marcado. Toda la apariencia tiene que
|
|
10
|
+
funcionar copiando el HTML a una página sin React (`html.json`).
|
|
11
|
+
1. **Solo tokens.** El CSS lee `var(--z-*)`. Nunca un color literal (`#hex`, `rgb()`, `hsl()`), nunca un
|
|
12
|
+
primitivo de marca (`--zp-*`). La lista de tokens está en `tokens.json`, en `@zuccadev-labs/zuix-tokens`.
|
|
13
|
+
2. **Un token por uso del color.** Texto de color: `--z-accent-text`, `--z-danger-text`… Fondo con texto
|
|
14
|
+
encima: `--z-accent-solid`, `--z-danger-solid`… con `--z-fg-on-accent`. `--z-accent`, `--z-success`,
|
|
15
|
+
`--z-warning`, `--z-danger` e `--z-info` son para rellenos, bordes e iconos. `pnpm tokens` lee las hojas,
|
|
16
|
+
mide cada par y falla si el texto no llega a 4.5:1 o un indicador a 3:1.
|
|
17
|
+
3. **Sin apariencia en línea.** `style={{…}}` solo admite maquetación calculada (posición, tamaño,
|
|
18
|
+
transformaciones) y variables locales (`"--z-algo": valor`). Color, fondo, borde, sombra, radio y
|
|
19
|
+
fuente van en la hoja de estilos.
|
|
20
|
+
4. **Iconos de `@zuccadev-labs/zuix-zicon`.** `<Icon name="…" />`. Sin emojis, sin SVG incrustado a mano. Si
|
|
21
|
+
no existe un icono para el concepto, se informa; no se inventa.
|
|
22
|
+
5. **Clases con prefijo `z-`**, estilo BEM: `.z-btn`, `.z-btn__spinner`, `.z-btn--primary`. Estado por atributo:
|
|
23
|
+
`[data-state]`, `[data-size]`, `[aria-selected]`, `[disabled]`.
|
|
24
|
+
6. **Propiedades lógicas.** `margin-inline-start`, `inset-inline-end`, `padding-block`. Nunca `left`, `right`,
|
|
25
|
+
`margin-left`. Un icono direccional se refleja en `[dir="rtl"]`.
|
|
26
|
+
7. **Cristal solo en el cromo.** `.z-liquid` para paneles, barras, menús y diálogos. Texto denso sobre
|
|
27
|
+
`.z-solid`.
|
|
28
|
+
8. **Accesibilidad no opcional.** Lo interactivo complejo (diálogos, menús, pestañas, popovers) usa las
|
|
29
|
+
primitivas de `src/primitives/` sobre la lógica de `src/core/`, según el patrón de
|
|
30
|
+
[APG](https://www.w3.org/WAI/ARIA/apg/) de cada widget. Todo control tiene nombre accesible, foco visible
|
|
31
|
+
(también con `forced-colors`) y uso con teclado.
|
|
32
|
+
9. **Sin dependencias.** El paquete solo depende de `@zuccadev-labs/zuix-tokens`. No se añade una biblioteca
|
|
33
|
+
de UI; el linter rechaza su importación. Cualquier otra dependencia nueva necesita mi aprobación.
|
|
34
|
+
10. **Sin dominio.** Pagos, reservas, mapas o clima viven en la aplicación, no aquí.
|
|
35
|
+
11. **Texto visible por props.** Los componentes no fijan idioma: las etiquetas llegan por props, con valor
|
|
36
|
+
por defecto en inglés.
|
|
37
|
+
12. **`"use client"`** en la primera línea de un módulo con hooks, contexto o manejadores de eventos propios.
|
|
38
|
+
Un componente de solo marcado no lo lleva: así se renderiza en un Server Component.
|
|
39
|
+
|
|
40
|
+
## Estructura
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
src/components/<grupo>/<Componente>.tsx implementación
|
|
44
|
+
src/components/<grupo>/<Componente>.manifest.json contrato legible por máquina
|
|
45
|
+
src/components/<grupo>/index.ts exportaciones del grupo
|
|
46
|
+
src/styles/<grupo>.css estilos del grupo, dentro de @layer zui.<grupo>
|
|
47
|
+
src/styles/native.css neutraliza <dialog>, [popover] y <button> para el contrato HTML
|
|
48
|
+
src/core/*.ts lógica compartida, sin React ni efectos al importar: colocación,
|
|
49
|
+
foco itinerante, búsqueda por letra, capas, foco, presencia, fechas…
|
|
50
|
+
src/primitives/* primitivas de React sobre core: diálogo (<dialog>), capa
|
|
51
|
+
(popover), menú, slot, hooks, campo nativo oculto
|
|
52
|
+
src/dom/*.ts comportamiento sin framework (@zuccadev-labs/zuix-zui/dom), sobre core
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Grupos: `actions`, `forms`, `data`, `feedback`, `content`, `overlay`, `navigation`, `carousel`.
|
|
56
|
+
|
|
57
|
+
## Patrones
|
|
58
|
+
|
|
59
|
+
### Componente de solo marcado
|
|
60
|
+
|
|
61
|
+
```tsx
|
|
62
|
+
import type { ButtonHTMLAttributes, ReactNode, Ref } from "react";
|
|
63
|
+
import { Icon, type IconName } from "@zuccadev-labs/zuix-zicon/core";
|
|
64
|
+
import { cx } from "../../cx";
|
|
65
|
+
|
|
66
|
+
export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
|
|
67
|
+
variant?: "primary" | "secondary" | "ghost" | "danger";
|
|
68
|
+
size?: "sm" | "md" | "lg";
|
|
69
|
+
icon?: IconName;
|
|
70
|
+
loading?: boolean;
|
|
71
|
+
ref?: Ref<HTMLButtonElement>;
|
|
72
|
+
children?: ReactNode;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function Button({ variant = "secondary", size = "md", icon, loading, className, children, disabled, onClick, ...rest }: ButtonProps) {
|
|
76
|
+
return (
|
|
77
|
+
<button
|
|
78
|
+
type="button"
|
|
79
|
+
{...rest}
|
|
80
|
+
className={cx("z-btn", `z-btn--${variant}`, className)}
|
|
81
|
+
data-size={size}
|
|
82
|
+
data-loading={loading || undefined}
|
|
83
|
+
aria-busy={loading || undefined}
|
|
84
|
+
aria-disabled={loading || undefined}
|
|
85
|
+
disabled={disabled}
|
|
86
|
+
{...(loading ? { type: "button" as const, onClick: undefined } : { onClick })}
|
|
87
|
+
>
|
|
88
|
+
{icon ? <Icon name={icon} size={16} /> : null}
|
|
89
|
+
{children}
|
|
90
|
+
</button>
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
- `ref` es una prop más: React 19, sin `forwardRef`.
|
|
96
|
+
- En carga el botón lleva `aria-disabled`, no `disabled`: conserva el foco. No hay manejador propio, así que
|
|
97
|
+
el módulo no necesita `"use client"`.
|
|
98
|
+
|
|
99
|
+
```css
|
|
100
|
+
@layer zui.actions {
|
|
101
|
+
.z-btn {
|
|
102
|
+
display: inline-flex; align-items: center; justify-content: center; gap: var(--z-space-2);
|
|
103
|
+
height: var(--z-control-height-md); padding-inline: var(--z-space-4);
|
|
104
|
+
border-radius: var(--z-button-radius); border: 1px solid var(--z-line);
|
|
105
|
+
background: var(--z-surface-2); color: var(--z-fg);
|
|
106
|
+
font-weight: var(--z-weight-semibold); font-size: var(--z-text-body);
|
|
107
|
+
transition: background var(--z-duration-fast) var(--z-ease-standard);
|
|
108
|
+
}
|
|
109
|
+
@media (hover: hover) { .z-btn:hover:not(:disabled) { background: var(--z-surface-3); } }
|
|
110
|
+
.z-btn:focus-visible { outline: none; box-shadow: var(--z-focus-ring); }
|
|
111
|
+
.z-btn--primary { background: var(--z-button-primary-bg); color: var(--z-button-primary-fg); border-color: transparent; }
|
|
112
|
+
.z-btn--danger { background: var(--z-danger-soft); color: var(--z-danger-text); }
|
|
113
|
+
.z-btn[data-size="sm"] { height: var(--z-control-height-sm); }
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
- `:hover` va dentro de `@media (hover: hover)`.
|
|
118
|
+
- El foco se dibuja con `box-shadow: var(--z-focus-ring)`. Con colores forzados el navegador quita las
|
|
119
|
+
sombras: `base.css` devuelve entonces un contorno del sistema a todo lo enfocable dentro de `.z-root`. Un
|
|
120
|
+
estado que solo cambia el fondo necesita además su regla en `@media (forced-colors: active)`.
|
|
121
|
+
- Texto de peligro con `--z-danger-text` sobre `--z-danger-soft`.
|
|
122
|
+
|
|
123
|
+
### Lógica compartida
|
|
124
|
+
|
|
125
|
+
- Una sola lógica para React y para el modo DOM: lo que no depende de React vive en `src/core/` y lo consumen
|
|
126
|
+
`src/primitives/`, `src/components/` y `src/dom/`. No se duplica un cálculo en los dos lados.
|
|
127
|
+
- `src/core/` no importa React ni toca el documento al cargarse. Un módulo nuevo lleva su prueba en
|
|
128
|
+
`tests/unit/` y su entrada en la lista `COVERED` de `tests/unit/run.mjs`.
|
|
129
|
+
- Plataforma primero: `<dialog>` + `showModal()` para lo modal, `popover="manual"` para lo flotante, `useId`.
|
|
130
|
+
El marcado que emite React es el del contrato (`html.json`).
|
|
131
|
+
- La dirección (RTL) se lee del DOM (`core/dir`), no de una prop ni de un proveedor.
|
|
132
|
+
- El modo DOM escribe el texto de la aplicación con `textContent` y su marcado propio con `setMarkup`
|
|
133
|
+
(`src/dom/shared.ts`). Un atributo que nombra otro elemento se resuelve con `byRef`.
|
|
134
|
+
|
|
135
|
+
### Manifiesto
|
|
136
|
+
|
|
137
|
+
```json
|
|
138
|
+
{
|
|
139
|
+
"name": "Button",
|
|
140
|
+
"group": "actions",
|
|
141
|
+
"description": "Acción principal o secundaria.",
|
|
142
|
+
"import": "import { Button } from \"@zuccadev-labs/zuix-zui\"",
|
|
143
|
+
"props": [
|
|
144
|
+
{ "name": "variant", "type": "enum", "values": ["primary", "secondary", "ghost", "danger"], "default": "secondary", "description": "Intención." },
|
|
145
|
+
{ "name": "size", "type": "enum", "values": ["sm", "md", "lg"], "default": "md" },
|
|
146
|
+
{ "name": "icon", "type": "IconName", "description": "Icono a la izquierda del texto." },
|
|
147
|
+
{ "name": "loading", "type": "boolean", "default": false }
|
|
148
|
+
],
|
|
149
|
+
"states": ["rest", "hover", "focus", "active", "disabled", "loading"],
|
|
150
|
+
"tokens": ["button-radius", "button-primary-bg", "button-primary-fg", "surface-2", "surface-3", "line", "fg", "focus-ring", "control-height-md"],
|
|
151
|
+
"classes": ["z-btn"],
|
|
152
|
+
"a11y": "Elemento button nativo. Con `loading` expone aria-busy y aria-disabled: no actúa, pero conserva el foco.",
|
|
153
|
+
"examples": [
|
|
154
|
+
{ "title": "Primario con icono", "code": "<Button variant=\"primary\" icon=\"plus\">New project</Button>" }
|
|
155
|
+
]
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Campos obligatorios: `name`, `group`, `description`, `import`, `props`, `tokens`, `classes`, `examples`.
|
|
160
|
+
|
|
161
|
+
Campos del contrato HTML: `behavior` (`none` | `dom` | `react`; se deduce si falta) y `html` (lista de
|
|
162
|
+
`{ title, code, script? }`) cuando el marcado no sale del render estático.
|
|
163
|
+
|
|
164
|
+
## No hacer
|
|
165
|
+
|
|
166
|
+
| En lugar de | Usa |
|
|
167
|
+
|---|---|
|
|
168
|
+
| `color: var(--z-accent)` en un texto | `var(--z-accent-text)` |
|
|
169
|
+
| `background: var(--z-success)` con texto encima | `var(--z-success-solid)` y `var(--z-fg-on-accent)` |
|
|
170
|
+
| `margin-left`, `right: 0`, `text-align: left` | `margin-inline-start`, `inset-inline-end: 0`, `text-align: start` |
|
|
171
|
+
| Un foco sin indicador | `box-shadow: var(--z-focus-ring)` en `:focus-visible` |
|
|
172
|
+
| Un `div` flotante con `z-index` | Un elemento `popover` con las primitivas de `src/primitives/` |
|
|
173
|
+
| `disabled` para un botón en carga | `aria-disabled` |
|
|
174
|
+
| `forwardRef` | `ref` como prop |
|
|
175
|
+
| Una clase suelta en la pantalla | Una variante en el componente y en su manifiesto |
|
|
176
|
+
|
|
177
|
+
## Cuando falta algo
|
|
178
|
+
|
|
179
|
+
- **Falta una variante:** se añade al componente y a su manifiesto.
|
|
180
|
+
- **Falta un token:** se propone en `tokens/src/base.json` (nivel `component`), referenciando un semántico.
|
|
181
|
+
No se escribe el valor literal.
|
|
182
|
+
- **Falta un icono:** se informa.
|
|
183
|
+
|
|
184
|
+
## Verificación
|
|
185
|
+
|
|
186
|
+
Desde la raíz de zuix:
|
|
187
|
+
|
|
188
|
+
```
|
|
189
|
+
pnpm tokens # el contraste de los pares que usan las hojas
|
|
190
|
+
pnpm style-audit # color, prim, token, emoji, inline: todo en 0
|
|
191
|
+
pnpm lint # Biome y la regla de "use client"
|
|
192
|
+
pnpm typecheck # sin errores
|
|
193
|
+
pnpm manifest # todo componente exportado tiene manifiesto válido
|
|
194
|
+
pnpm barrels # todo componente con manifiesto se exporta desde la raíz del paquete
|
|
195
|
+
pnpm html # el contrato HTML se regenera
|
|
196
|
+
pnpm test:unit # si tocaste src/core o lógica cubierta
|
|
197
|
+
pnpm test:html # si tocaste src/dom, native.css o un componente con behavior "dom"
|
|
198
|
+
pnpm test:browser # si tocaste el binding de un componente interactivo
|
|
199
|
+
```
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
# Cambios de @zuccadev-labs/zuix-zui
|
|
2
|
+
|
|
3
|
+
Formato: [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/). Versionado: semver, con la misma
|
|
4
|
+
versión en toda la suite ([Versionado](https://github.com/zuccadev-labs/zuix/blob/main/docs/package/01-versionado.md)).
|
|
5
|
+
|
|
6
|
+
## [Sin publicar]
|
|
7
|
+
|
|
8
|
+
## [0.2.0] - 2026-11-18
|
|
9
|
+
|
|
10
|
+
Esta versión trae cambios incompatibles. Qué hay que tocar en una aplicación está en la
|
|
11
|
+
[guía de actualización](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/08-actualizar-de-0-1-a-0-2.md).
|
|
12
|
+
|
|
13
|
+
El paquete ya no depende de ninguna biblioteca de UI: `radix-ui` se retira y el binding de React usa
|
|
14
|
+
primitivas propias sobre la plataforma (`<dialog>`, Popover API), con la misma lógica que
|
|
15
|
+
`@zuccadev-labs/zuix-zui/dom`. En ejecución solo necesita `@zuccadev-labs/zuix-tokens`;
|
|
16
|
+
`@zuccadev-labs/zuix-zicon` es un peer obligatorio y React y React DOM 19, peers opcionales. Un proyecto que
|
|
17
|
+
solo usa el contrato HTML y `zui/dom` deja de instalar los más de setenta paquetes que llegaban por esa
|
|
18
|
+
dependencia.
|
|
19
|
+
|
|
20
|
+
### Cambios incompatibles
|
|
21
|
+
|
|
22
|
+
Entorno:
|
|
23
|
+
|
|
24
|
+
- Node 22.12 o posterior (antes, 20). Node 20 terminó su soporte el 2026-04-30.
|
|
25
|
+
- Navegadores admitidos: Chrome y Edge 116, Firefox 125, Safari 17 y Safari de iOS 18.3. Lo marca la Popover
|
|
26
|
+
API.
|
|
27
|
+
|
|
28
|
+
Marcado y CSS:
|
|
29
|
+
|
|
30
|
+
- `Modal`, `Drawer`, `ConfirmDialog` y `CommandPalette` de React pintan un `<dialog>` abierto con
|
|
31
|
+
`showModal()` (antes un `div[role=dialog]` y un `div.z-overlay-scrim` aparte). **La clase `z-overlay-scrim`
|
|
32
|
+
y sus modificadores desaparecen**: el velo es `dialog::backdrop`. Un selector `.z-modal[role=dialog]` pasa
|
|
33
|
+
a `dialog.z-modal`. Sin `title`, el nombre va en `aria-label` (antes un `h2.z-sr-only`).
|
|
34
|
+
- Variables CSS renombradas: `--radix-select-trigger-width` → `--z-anchor-width`;
|
|
35
|
+
`--radix-*-content-available-height` → `--z-available-height`; `--radix-*-content-available-width` →
|
|
36
|
+
`--z-available-width`; `--radix-toast-swipe-move-x|y` y `--radix-toast-swipe-end-x|y` →
|
|
37
|
+
`--z-toast-swipe-…`; `--radix-accordion-content-height` → `--z-accordion-content-height`. No queda ningún
|
|
38
|
+
`--radix-*`, `data-radix-*` ni id `radix-…`.
|
|
39
|
+
- Toast de React: la región es `div.z-toast-viewport[role=region]` con nombre y cada aviso un
|
|
40
|
+
`div.z-toast[role=status|alert]` (antes `ol` y `li`). `toast()` del modo DOM genera el mismo `div`. La
|
|
41
|
+
región solo existe mientras hay avisos.
|
|
42
|
+
- Menús de React: cada entrada es un `button[role=menuitem]` (antes `div`), el separador lleva
|
|
43
|
+
`role="separator"` y el atributo `data-elevated` desaparece: todo va en la capa superior.
|
|
44
|
+
- `Popover modal` de React es un `<dialog>` abierto con `showModal()` (antes un `div[role=dialog]`). Un
|
|
45
|
+
selector `.z-popover[role=dialog]` pasa a `dialog.z-popover` para el modal; el no modal sigue siendo un
|
|
46
|
+
`div`.
|
|
47
|
+
- `Select` de React: `role="listbox"` va en `.z-listbox__viewport`, dentro de `.z-listbox`, y las opciones
|
|
48
|
+
llevan `data-value`. Con `name` o `required`, el campo de formulario es un `<select>` nativo oculto
|
|
49
|
+
(`.z-native-input`), no un `input[type=hidden]`.
|
|
50
|
+
- `Checkbox`, `Switch` y `Radio`: el campo nativo oculto lleva la clase `z-native-input` (antes estilos en
|
|
51
|
+
línea) y está siempre en el marcado. `RadioGroup` y `SegmentedControl` ya no llevan `dir` ni `tabindex` en
|
|
52
|
+
el grupo.
|
|
53
|
+
- `Tabs`: los ids son `…-tab-<valor>` y `…-panel-<valor>`; cada pestaña lleva `data-value`.
|
|
54
|
+
- `Accordion`: la cabecera es un `h2`…`h6` real según `headingLevel` (antes `h3` con `aria-level`); el
|
|
55
|
+
contenido de una sección cerrada sigue montado, oculto con `hidden`; `.z-accordion` lleva `data-type`.
|
|
56
|
+
- `Slider` de React: los tiradores son hijos directos de `.z-slider` y la pista se sitúa con
|
|
57
|
+
`inset-inline-start` y `-end`; el contenedor lleva `data-min`, `data-max`, `data-step` y `data-value`.
|
|
58
|
+
|
|
59
|
+
Props y tipos:
|
|
60
|
+
|
|
61
|
+
- `Popover`: el nombre accesible es obligatorio en los tipos: `label`, o `aria-labelledby` con el id de un
|
|
62
|
+
encabezado del panel.
|
|
63
|
+
- `ToastProvider`: `label` se sustituye por `regionLabel` (nombre de la región, por defecto
|
|
64
|
+
`Notifications (F8)`).
|
|
65
|
+
- `CheckboxProps`, `SwitchProps`, `RadioProps`, `RadioGroupProps`, `SliderProps` y `ToggleProps` son los
|
|
66
|
+
atributos del elemento más las props propias (`checked`, `defaultChecked`, `onCheckedChange`, `value`,
|
|
67
|
+
`onValueChange`, `pressed`, `onPressedChange`…). Desaparecen `asChild`, `dir`, `loop` y `forceMount`, y
|
|
68
|
+
con ellas tres props que la suite no usaba: `form` en `RadioGroup`, `checked` y `required` en `Radio` (los
|
|
69
|
+
decide el grupo) y `preserveThumbOrder` en `Slider`. `RadioGroup value` ya no admite `null`.
|
|
70
|
+
- `Slider` con varios tiradores envía un campo por tirador con el mismo `name` (antes `name[]`).
|
|
71
|
+
|
|
72
|
+
Comportamiento:
|
|
73
|
+
|
|
74
|
+
- `Button` e `IconButton` con `loading`: `aria-disabled="true"` en lugar de `disabled`. El botón no ejecuta
|
|
75
|
+
`onClick` ni envía el formulario (pasa a `type="button"` mientras carga), pero conserva el foco del
|
|
76
|
+
teclado.
|
|
77
|
+
- `confirm()` de `zui/dom`: **Escape cancela** (resuelve `false`), igual que `ConfirmDialog` en React y que
|
|
78
|
+
el patrón de diálogo modal de APG. Antes Escape no hacía nada. El clic en el velo sigue sin cerrar.
|
|
79
|
+
- `ConfirmDialog`: cerrar con Escape llama a `onCancel`, además de a `onOpenChange(false)`.
|
|
80
|
+
- La dirección se lee del DOM: dentro de `dir="rtl"`, `Tabs`, `Menu`, `Slider`, `RadioGroup` y
|
|
81
|
+
`SegmentedControl` de React reflejan las flechas sin proveedor ni prop.
|
|
82
|
+
- Escape cierra solo la capa de arriba y respeta un evento ya cancelado: en un `SearchInput` con texto dentro
|
|
83
|
+
de un `Modal`, la primera pulsación limpia el campo y la segunda cierra el diálogo. En un submenú cierra
|
|
84
|
+
ese nivel.
|
|
85
|
+
- `SegmentedControl` y `RadioGroup`: las flechas mueven el foco y la selección, con vuelta al otro extremo.
|
|
86
|
+
- `Menu` y `ContextMenu` de React: al abrir, el foco va a la primera entrada, también con el puntero (antes,
|
|
87
|
+
con el puntero, lo recibía el menú sin resaltar ninguna). Es el patrón de botón de menú de APG y lo que ya
|
|
88
|
+
hacía `zui/dom`. Las flechas dan la vuelta del último al primero.
|
|
89
|
+
- `Popover` no modal: salir con Tab por un extremo lo cierra y devuelve el foco al disparador. `Popover
|
|
90
|
+
modal`: retiene el foco (Tab da la vuelta), bloquea el desplazamiento de la página y el resto queda inerte
|
|
91
|
+
para el puntero, el teclado y los lectores de pantalla; una pulsación fuera solo lo cierra, sin llegar a
|
|
92
|
+
lo que hay debajo.
|
|
93
|
+
- `DatePicker required`: el botón ya no lleva `aria-required` (su rol no lo admite); la obligatoriedad la
|
|
94
|
+
valida un campo nativo oculto, que impide enviar el formulario vacío.
|
|
95
|
+
- Tooltip (React y `data-z-tooltip`): la burbuja recibe el puntero. Se puede pasar del disparador a ella sin
|
|
96
|
+
que se cierre, y Escape la cierra (WCAG 1.4.13). Antes llevaba `pointer-events: none`.
|
|
97
|
+
- `Link disabled` ya no ejecuta `onClick`.
|
|
98
|
+
- `z:close` se emite también cuando un `<dialog>` de zui se cierra con `dialog.close()` o con
|
|
99
|
+
`<form method="dialog">`, y `data-state` pasa a `closed`. Antes solo al cerrar con `closeDialog()`.
|
|
100
|
+
- Casilla (`role="checkbox"`) en modo DOM: Intro ya no la cambia; se marca con Espacio, como en React.
|
|
101
|
+
- Clic en el velo de un `<dialog>`: solo cierra si la pulsación empezó también en el velo.
|
|
102
|
+
- Los diálogos bloquean el desplazamiento de la página también en el modo DOM, y Tab da la vuelta dentro del
|
|
103
|
+
diálogo en lugar de salir a la interfaz del navegador.
|
|
104
|
+
- `Pagination`: `page` se redondea y un `pageCount` no numérico cuenta como una página. `DataTable`: los
|
|
105
|
+
`NaN` se ordenan al final.
|
|
106
|
+
|
|
107
|
+
Color:
|
|
108
|
+
|
|
109
|
+
- Los pares de color de las hojas que no llegaban al mínimo de WCAG 2.2 AA usan los tokens nuevos de
|
|
110
|
+
`@zuccadev-labs/zuix-tokens`: `--z-*-text` para texto y `--z-*-solid` para fondos con texto encima.
|
|
111
|
+
`--z-accent`, `--z-success`, `--z-warning`, `--z-danger` e `--z-info` quedan para rellenos, bordes e
|
|
112
|
+
iconos. Cambia el tono de:
|
|
113
|
+
- el texto con acento: `.z-link` (el hover se distingue por el subrayado pleno), `.z-table__sort[data-active]`,
|
|
114
|
+
`.z-chip[data-selected]`, las iniciales de `Avatar`, `.z-toggle[data-state="on"]`, `IconButton active`,
|
|
115
|
+
el día de hoy del calendario y los iconos de `FileUpload` y `ConfirmDialog`;
|
|
116
|
+
- el texto de peligro: `Button variant="danger"`, `.z-field__required`, `.z-field__error`,
|
|
117
|
+
`.z-menu__item[data-danger]` y el icono de `ErrorState` y de `ConfirmDialog intent="danger"`;
|
|
118
|
+
- `Badge`: la variante suave y `outline` usan `--z-*-text`; la sólida, `--z-*-solid` de fondo. `StatTile`:
|
|
119
|
+
el delta usa `--z-*-text`, y los textos secundarios de la variante sólida dejan de atenuarse;
|
|
120
|
+
- `Rating`: las estrellas vacías usan `--z-control-border`;
|
|
121
|
+
- `LoadingOverlay`: el velo es del color del lienzo, con el texto normal encima;
|
|
122
|
+
- el botón de peligro de los diálogos usa `--z-danger-solid` de fondo.
|
|
123
|
+
|
|
124
|
+
### Añadido
|
|
125
|
+
|
|
126
|
+
- Una sola lógica para React y para `zui/dom`: colocación, foco itinerante, búsqueda por letra, dirección,
|
|
127
|
+
capas y cierre al interactuar fuera, foco, bloqueo de desplazamiento, presencia, deslizar para descartar,
|
|
128
|
+
fechas, paginación, orden de tabla, búsqueda sin acentos y aritmética del Slider. El HTML que emite React
|
|
129
|
+
es el del contrato (`html.json`): se puede copiar a una página sin React.
|
|
130
|
+
- `init()` de `zui/dom` devuelve `destroy`, y `destroy()` se exporta: retira todos los listeners del
|
|
131
|
+
documento y de la ventana. `init()` se puede volver a llamar.
|
|
132
|
+
- `zui/dom`: Rating de entrada (`.z-rating[data-interactive]`). Clic y flechas rellenan las estrellas y
|
|
133
|
+
emiten `z:change { value }`. `Rating` de React: Inicio y Fin.
|
|
134
|
+
- `zui/dom`: el acordeón emite `z:change { value }` con las secciones abiertas, como `onValueChange` en
|
|
135
|
+
React. En React y en DOM: flechas, Inicio y Fin entre cabeceras; la altura se anima con
|
|
136
|
+
`--z-accordion-content-height`.
|
|
137
|
+
- `toast()` y Toast de React: el cierre automático se detiene mientras el puntero o el foco están en el
|
|
138
|
+
aviso, y con la ventana sin foco (WCAG 2.2.1); F8 lleva el foco al aviso más reciente y Escape lo descarta.
|
|
139
|
+
La región tiene `role="region"` y nombre (`regionLabel`).
|
|
140
|
+
- `openPopover(el, ancla, placement, { follow })`: un popover anclado a un elemento lo sigue al desplazar o
|
|
141
|
+
redimensionar la página. `follow: false` lo deja donde se abrió. `place()` escribe `data-align`,
|
|
142
|
+
`--z-available-width` y `--z-available-height`.
|
|
143
|
+
- RTL: propiedades lógicas en todas las hojas, iconos direccionales reflejados y teclado reflejado en Tabs,
|
|
144
|
+
RadioGroup, Calendar, Tree, Rating, Slider y submenús, en React y en el modo DOM. El submenú abre hacia la
|
|
145
|
+
izquierda y los popovers alinean `start` con el borde derecho del ancla.
|
|
146
|
+
- `forced-colors: active` (contraste alto de Windows): foco siempre visible y estados seleccionado, marcado,
|
|
147
|
+
resaltado y deshabilitado con colores del sistema. `prefers-contrast: more`: cristal a superficie sólida,
|
|
148
|
+
bordes fuertes y foco más grueso.
|
|
149
|
+
- `Field` nombra también los controles que `<label for>` no puede etiquetar (`RadioGroup`, `OTPInput`,
|
|
150
|
+
`Slider`) con `aria-labelledby`. `useFieldLabel()` lo expone para controles propios.
|
|
151
|
+
- `Select required` participa en la validación nativa del formulario; `Select`, `Checkbox`, `Switch`,
|
|
152
|
+
`RadioGroup` y `DatePicker` vuelven a su valor inicial con `form.reset()`.
|
|
153
|
+
- `Slider`: `inverted` en los dos ejes (`data-inverted` en el modo DOM).
|
|
154
|
+
- Submenús (React y DOM): zona de gracia del puntero al ir en diagonal hacia el submenú.
|
|
155
|
+
- `Tree` de React: búsqueda por letra, como en el modo DOM. `Calendar`: atributo `data-month="YYYY-MM"`.
|
|
156
|
+
OTPInput (React y DOM): Supr borra el carácter de la casilla.
|
|
157
|
+
- `CommandPalette` (React y DOM): la búsqueda ignora acentos.
|
|
158
|
+
- Trusted Types: `zui/dom` escribe su marcado a través de la política `zuix-zui` (`trusted-types zuix-zui` en
|
|
159
|
+
la política de seguridad de contenido).
|
|
160
|
+
- `Popover modal`: la inercia del resto de la página la pone el navegador (`<dialog>`), no atributos
|
|
161
|
+
`aria-hidden` repartidos por el documento.
|
|
162
|
+
- Las hojas usan los tokens nuevos `--z-layer-raised`, `--z-layer-below`, `--z-space-1-5` y `--z-space-2-5`
|
|
163
|
+
de `@zuccadev-labs/zuix-tokens` donde antes había un `z-index` o un espacio literal.
|
|
164
|
+
- `THIRD_PARTY_NOTICES.md` en el paquete.
|
|
165
|
+
|
|
166
|
+
### Corregido
|
|
167
|
+
|
|
168
|
+
- `Slider`: con un `max` que no es un paso desde `min` (`min` 0, `max` 10, `step` 3), el tope es el último
|
|
169
|
+
paso que cabe (9), como en `<input type="range">`. Antes se podía arrastrar hasta 10 y el valor volvía a 9
|
|
170
|
+
al redibujarse.
|
|
171
|
+
- `CommandPalette`: la coincidencia por subsecuencia cuenta caracteres, no unidades UTF-16. Una búsqueda con
|
|
172
|
+
un emoji o una letra fuera del plano básico ya encuentra la entrada que los contiene.
|
|
173
|
+
|
|
174
|
+
Seguridad del modo DOM:
|
|
175
|
+
|
|
176
|
+
- `data-z-open`, `data-z-context`, `data-z-submenu` y `data-raster` se resuelven por id. Un valor que no es
|
|
177
|
+
un selector válido ya no lanza una excepción en cada clic, y funcionan los ids con caracteres especiales,
|
|
178
|
+
como los de `useId` de React.
|
|
179
|
+
- El icono de la opción elegida en Select y Combobox se copia nodo a nodo, sin volver a interpretar marcado;
|
|
180
|
+
todo el marcado propio pasa por un único punto.
|
|
181
|
+
- Un disparador `data-z-open` deshabilitado (`disabled`, `aria-disabled`, `data-disabled`) no abre.
|
|
182
|
+
- Los eventos `keydown` sin `key` (autocompletado del navegador) ya no lanzan.
|
|
183
|
+
|
|
184
|
+
Accesibilidad:
|
|
185
|
+
|
|
186
|
+
- `confirm()`: el diálogo tiene nombre y descripción accesibles.
|
|
187
|
+
- Tooltip en modo DOM: aparece también en controles que ya tenían `aria-describedby` y la conserva; dentro de
|
|
188
|
+
un diálogo modal se inserta en el diálogo, donde no queda inerte.
|
|
189
|
+
- `Rating` de entrada: cada estrella mide al menos 24 × 24 px (WCAG 2.5.8); en `sm` y `md` medía 18 y 22 px.
|
|
190
|
+
Con `value` mayor que `max` sigue siendo alcanzable con el teclado.
|
|
191
|
+
- `NavLink disabled` con `href` lleva `role="link"`, y `NavLink` admite atributos HTML (`data-*`, `aria-*`,
|
|
192
|
+
`id`). `Slider` dentro de un `Field` queda descrito por su ayuda y su error.
|
|
193
|
+
|
|
194
|
+
Comportamiento:
|
|
195
|
+
|
|
196
|
+
- Avisos con un diálogo modal abierto (React y `toast()`): la región se muda al diálogo de arriba y vuelve a
|
|
197
|
+
`<body>` cuando se cierra, sin repetir la animación de entrada ni reiniciar el temporizador. Fuera del
|
|
198
|
+
diálogo el navegador la deja inerte: el aviso se veía, pero no se podía pulsar, enfocar ni leer. En React
|
|
199
|
+
la región vive en un contenedor `div[data-z-toast-root]` (`display: contents`), que es lo que se mueve.
|
|
200
|
+
- Carousel: un clic en un slide lateral cuando la tira está terminando de asentarse cuenta como clic. Antes
|
|
201
|
+
se tomaba por «parar la tira» y se perdía, sobre todo con pocos fotogramas por segundo.
|
|
202
|
+
- Carousel en `zui/dom`: un `.z-carousel__viewport` escrito a mano sin `.z-carousel__stage` o sin
|
|
203
|
+
`.z-carousel__track` lanza un error que lo dice, en lugar de un `TypeError` más adelante.
|
|
204
|
+
- Modo DOM: el cierre pedido por el sistema (gesto atrás) cierra el diálogo con su animación. Un acordeón
|
|
205
|
+
anidado ya no cierra las secciones del exterior.
|
|
206
|
+
- `Calendar` sin `value`, `month` ni `defaultMonth`: sin desajuste de hidratación cuando el reloj del
|
|
207
|
+
servidor y el del navegador caen en meses distintos. Fechas con año menor que 100 en `Calendar` y
|
|
208
|
+
`DatePicker`.
|
|
209
|
+
- `NativeSelect`: el `placeholder` se muestra sin tener que pasar `defaultValue=""`.
|
|
210
|
+
- `FileUpload` con `name`: el campo conserva los archivos aceptados y el formulario los envía. Pasar el
|
|
211
|
+
arrastre sobre un hijo de la zona ya no apaga `data-dragging`.
|
|
212
|
+
- `CommandPalette`: si los grupos cambian con la paleta abierta, el comando activo se acota a la lista; al
|
|
213
|
+
reabrirla no se llega a pintar la búsqueda anterior.
|
|
214
|
+
- `Textarea autoRows` crece también sin controlar. `Avatar` detecta una imagen que falló antes de hidratar.
|
|
215
|
+
- Refs fusionadas (`SearchInput`, `DateInput`, `Combobox`, `Carousel`): respetan la función de limpieza de
|
|
216
|
+
las refs de React 19 y no se reconectan en cada render.
|
|
217
|
+
- `DataTable`: reconoce fechas creadas en otro realm (un iframe), y una celda sin cifras en una columna
|
|
218
|
+
numérica se ordena al final en lugar de contar como cero.
|
|
219
|
+
- `setPage(nav, NaN)` deja la página actual; `setSliderValue(el, NaN)` no mueve el tirador.
|
|
220
|
+
- Carousel en modo `gl`: si el navegador no ofrece WebGL2, se pregunta una sola vez por página.
|
|
221
|
+
- Contrato: el ejemplo «Activable» de Card y el «En línea» de Field producen marcado utilizable sin React.
|
|
222
|
+
|
|
223
|
+
## [0.1.0] - 2026-11-14
|
|
224
|
+
|
|
225
|
+
Primera versión publicada.
|
|
226
|
+
|
|
227
|
+
### Añadido
|
|
228
|
+
|
|
229
|
+
- 64 componentes en 8 grupos: acciones (5), formularios (17), datos (11), estado (7), contenido (7),
|
|
230
|
+
capas (9), navegación (7) y Carousel. La lista con props, tokens y clases está en `manifest.json`.
|
|
231
|
+
- Contrato HTML: clases `z-*`, atributos de estado (`data-state`, `data-size`, `aria-*`) y el marcado de cada
|
|
232
|
+
ejemplo en `html.json`, generado desde el binding de React.
|
|
233
|
+
- Estilos sobre tokens `--z-*`: `@zuccadev-labs/zuix-zui/styles.css` (todo) y `@zuccadev-labs/zuix-zui/styles/<grupo>.css`. Material
|
|
234
|
+
liquid glass (`.z-liquid`, `.z-solid`).
|
|
235
|
+
- `@zuccadev-labs/zuix-zui/dom`: comportamiento sin framework. Diálogos, popovers, menús, menú contextual, tooltips,
|
|
236
|
+
avisos, confirmación, pestañas, acordeón, controles de formulario, Select, Combobox, Calendar,
|
|
237
|
+
DatePicker, Slider, OTPInput, FileUpload, CommandPalette, Tree, orden de DataTable, Pagination y
|
|
238
|
+
Carousel. Eventos `z:open`, `z:close`, `z:change`, `z:select` y `z:sort`.
|
|
239
|
+
- `@zuccadev-labs/zuix-zui`: binding de React 19 sobre Radix. React es un peer opcional: el contrato y `dom` no lo usan.
|
|
240
|
+
- `@zuccadev-labs/zuix-zicon` es `peerDependency`: la aplicación lo instala junto a este paquete y hay una sola copia
|
|
241
|
+
del registro de iconos.
|
|
242
|
+
- `dist/zui.css` y `dist/zui.dom.js`: listos para enlazar sin bundler.
|
|
243
|
+
- Salida de publicación: ESM compilado módulo a módulo con declaraciones en `dist/esm/`, y `"use client"`
|
|
244
|
+
en los módulos con estado, eventos o Radix.
|
|
245
|
+
- Carousel sin React en modo `gl`: las zonas curvas se dibujan en WebGL2 cuando cada slide declara su imagen
|
|
246
|
+
(`data-raster`, `data-raster="#selector"`, `data-raster-src`) o con `carousel(el, { rasterize })`. Cae a
|
|
247
|
+
`css` sin WebGL2 o si falta una imagen. `carousel(el).refresh()` rehace réplicas y texturas.
|
|
248
|
+
- `@zuccadev-labs/zuix-zui/dom/carousel-gl` y `dist/zui.dom.carousel-gl.js`: los shaders, que `@zuccadev-labs/zuix-zui/dom` carga bajo
|
|
249
|
+
demanda. `zui.dom.js` no los incluye.
|
|
250
|
+
- `README.md` en el paquete publicado.
|
|
251
|
+
|
|
252
|
+
### Táctil
|
|
253
|
+
|
|
254
|
+
- **Objetivo táctil de 40 px.** Con puntero principal grueso (`@media (pointer: coarse)`) los controles `sm` y `md`
|
|
255
|
+
crecen hasta `--z-touch-target` (40 px; token de `@zuccadev-labs/zuix-tokens`): botones, campos, Select, pestañas,
|
|
256
|
+
filas de árbol y de menú, opciones de lista. Checkbox, Radio y Switch ganan aire vertical, el Slider crece en
|
|
257
|
+
su eje corto, y los botones de cierre (`.z-overlay-close`, `.z-alert__dismiss`), el botón del campo y las
|
|
258
|
+
opciones de SegmentedControl amplían su zona de pulsación sin cambiar el dibujo. Con ratón nada cambia.
|
|
259
|
+
`--z-touch-target: 0px` lo desactiva.
|
|
260
|
+
- **Sin hover pegajoso.** Todas las reglas `:hover` van dentro de `@media (hover: hover)`: en una pantalla táctil
|
|
261
|
+
el último control tocado no se queda con el estilo de hover.
|
|
262
|
+
- `@zuccadev-labs/zuix-zui/dom`: los avisos (`toast()`) se descartan deslizando, con dedo, lápiz o ratón, igual que el Toast de
|
|
263
|
+
React (a la derecha, o hacia el borde en las posiciones centradas). `.z-toast` declara `touch-action`. Al
|
|
264
|
+
descartarlo, el aviso conserva el desplazamiento mientras se desvanece.
|
|
265
|
+
- `@zuccadev-labs/zuix-zui/dom`: el menú contextual (`data-z-context`) se abre con una pulsación larga de 600 ms con dedo o
|
|
266
|
+
lápiz. iOS no emite `contextmenu`, y un Chromium de escritorio con pantalla táctil tampoco. El menú sigue
|
|
267
|
+
abierto al levantar el dedo.
|
|
268
|
+
- ContextMenu de React en ventanas estrechas: si el menú no cabe a ningún lado del puntero, se estrecha hasta
|
|
269
|
+
el hueco disponible en lugar de salirse de la ventana.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 David Euclides Zuccarini Barrueta (devzucca / zuccadev)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,138 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @zuccadev-labs/zuix-zui
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The component system of the zuix suite: 64 accessible components in 8 groups. Each component is an HTML and
|
|
4
|
+
CSS contract on top of tokens; the framework-free behavior lives in `@zuccadev-labs/zuix-zui/dom` and the
|
|
5
|
+
React binding in the main entry.
|
|
6
|
+
|
|
7
|
+
| Layer | Entry | Depends on |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Contract | `@zuccadev-labs/zuix-zui/styles.css`, `@zuccadev-labs/zuix-zui/html.json` | `@zuccadev-labs/zuix-tokens` |
|
|
10
|
+
| Behavior | `@zuccadev-labs/zuix-zui/dom` | The browser (`<dialog>`, Popover API) |
|
|
11
|
+
| React binding | `@zuccadev-labs/zuix-zui` | React 19 |
|
|
12
|
+
|
|
13
|
+
There is no third-party UI library underneath. Dialogs are a native `<dialog>` opened with `showModal()`,
|
|
14
|
+
floating layers are `popover` elements, and the keyboard and focus logic follows the
|
|
15
|
+
[WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/). React and the framework-free mode share
|
|
16
|
+
one implementation of that logic, and React emits exactly the markup of the contract.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
pnpm add @zuccadev-labs/zuix-zui @zuccadev-labs/zuix-tokens @zuccadev-labs/zuix-zicon
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
`@zuccadev-labs/zuix-zicon` is a required peer (components draw their icons with the application's copy).
|
|
25
|
+
`react` and `react-dom` 19 are optional peers: only the binding needs them (`pnpm add react react-dom`).
|
|
26
|
+
React 18 is not supported. The only runtime dependency is `@zuccadev-labs/zuix-tokens`. The suite packages
|
|
27
|
+
are installed and upgraded together, at the same version. Requires Node 22.12 or later.
|
|
28
|
+
|
|
29
|
+
To install everything with a single dependency: [`@zuccadev-labs/zuix`](https://www.npmjs.com/package/@zuccadev-labs/zuix).
|
|
30
|
+
|
|
31
|
+
## Without React
|
|
32
|
+
|
|
33
|
+
With a bundler:
|
|
34
|
+
|
|
35
|
+
```js
|
|
36
|
+
import "@zuccadev-labs/zuix-tokens/tokens.css";
|
|
37
|
+
import "@zuccadev-labs/zuix-zui/styles.css";
|
|
38
|
+
import "@zuccadev-labs/zuix-zicon/element"; // <z-icon>
|
|
39
|
+
import { init, toast } from "@zuccadev-labs/zuix-zui/dom";
|
|
40
|
+
|
|
41
|
+
init();
|
|
42
|
+
toast({ title: "Ready", intent: "success" });
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
```html
|
|
46
|
+
<body class="z-root z-canvas" data-z-dom>
|
|
47
|
+
<button type="button" class="z-btn z-btn--secondary" data-size="md" data-z-open="#edit">Edit profile</button>
|
|
48
|
+
|
|
49
|
+
<dialog id="edit" class="z-liquid z-modal" data-size="md" aria-labelledby="edit-title">
|
|
50
|
+
<header class="z-modal__header">
|
|
51
|
+
<div class="z-modal__heading"><h2 id="edit-title" class="z-modal__title">Edit profile</h2></div>
|
|
52
|
+
</header>
|
|
53
|
+
<div class="z-modal__body">…</div>
|
|
54
|
+
<footer class="z-modal__footer">
|
|
55
|
+
<button class="z-dialog-btn" data-variant="primary" data-z-close value="save">Save</button>
|
|
56
|
+
</footer>
|
|
57
|
+
</dialog>
|
|
58
|
+
</body>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
- `z-root` applies typography and focus; `z-canvas` paints the background.
|
|
62
|
+
- `data-z-dom` enables tabs, accordion and form controls inside that container.
|
|
63
|
+
- The markup of every component is in `@zuccadev-labs/zuix-zui/html.json`. Each component declares its
|
|
64
|
+
`behavior`: `none` (CSS only) or `dom` (needs `@zuccadev-labs/zuix-zui/dom`).
|
|
65
|
+
- `init()` returns a `destroy` function that removes every listener.
|
|
66
|
+
|
|
67
|
+
Without a bundler, link `dist/zui.css` and `dist/zui.dom.js`, both included in the package.
|
|
68
|
+
|
|
69
|
+
## With React
|
|
70
|
+
|
|
71
|
+
```tsx
|
|
72
|
+
import "@zuccadev-labs/zuix-tokens/tokens.css";
|
|
73
|
+
import "@zuccadev-labs/zuix-zui/styles.css";
|
|
74
|
+
import "@zuccadev-labs/zuix-zicon/all"; // registers the icons
|
|
75
|
+
|
|
76
|
+
import { Button } from "@zuccadev-labs/zuix-zui";
|
|
77
|
+
|
|
78
|
+
export function NewProject() {
|
|
79
|
+
return <Button variant="primary" icon="plus">New project</Button>;
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Put `data-theme="dark"` or `"light"` on `<html>`, and `class="z-root z-canvas"` on the application
|
|
84
|
+
container.
|
|
85
|
+
|
|
86
|
+
Modules with hooks, context or their own event handlers declare `"use client"`. Those that only produce
|
|
87
|
+
markup (`Button`, `Badge`, `Card`…) do not, so they render as Server Components.
|
|
88
|
+
|
|
89
|
+
## Accessibility and security
|
|
90
|
+
|
|
91
|
+
- WCAG 2.2 AA contrast is measured on every change: the token build reads the color pairs these stylesheets
|
|
92
|
+
use and fails below 4.5:1 for text or 3:1 for non-text.
|
|
93
|
+
- Right-to-left works through logical properties and a mirrored keyboard, with the direction read from the
|
|
94
|
+
DOM. `forced-colors`, `prefers-contrast`, `prefers-reduced-motion` and `prefers-reduced-transparency`
|
|
95
|
+
are handled. Controls grow to 40 px with a coarse pointer.
|
|
96
|
+
- The framework-free mode writes application text with `textContent`, and works under a strict Content
|
|
97
|
+
Security Policy with Trusted Types (policy name: `zuix-zui`).
|
|
98
|
+
- Browsers: Chrome and Edge 116, Firefox 125, Safari 17, iOS Safari 18.3.
|
|
99
|
+
|
|
100
|
+
## Entry points
|
|
101
|
+
|
|
102
|
+
| Entry | Contents |
|
|
103
|
+
|---|---|
|
|
104
|
+
| `@zuccadev-labs/zuix-zui` | React components and their `*Props` types |
|
|
105
|
+
| `@zuccadev-labs/zuix-zui/dom` | Framework-free behavior: `init`, `destroy`, `hydrate`, `toast`, `confirm`… |
|
|
106
|
+
| `@zuccadev-labs/zuix-zui/dom/carousel-gl` | WebGL mode of the carousel, loaded on demand |
|
|
107
|
+
| `@zuccadev-labs/zuix-zui/styles.css` | All the styles |
|
|
108
|
+
| `@zuccadev-labs/zuix-zui/styles/*` | Single stylesheets per group |
|
|
109
|
+
| `@zuccadev-labs/zuix-zui/manifest.json` | Components, props, classes and examples, for tools and agents |
|
|
110
|
+
| `@zuccadev-labs/zuix-zui/html.json` | The markup of every example |
|
|
111
|
+
| `@zuccadev-labs/zuix-zui/dist/zui.css`, `@zuccadev-labs/zuix-zui/dist/zui.dom.js` | Bundles to link without a bundler |
|
|
112
|
+
|
|
113
|
+
## Rules
|
|
114
|
+
|
|
115
|
+
1. Components only read tokens: no literal colors, radii or shadows.
|
|
116
|
+
2. Icons are requested by name; emojis are not used as icons.
|
|
117
|
+
3. If a variant, a token or an icon is missing, it is added to the system.
|
|
118
|
+
|
|
119
|
+
## Documentation
|
|
120
|
+
|
|
121
|
+
The guides are written in Spanish.
|
|
122
|
+
|
|
123
|
+
- [Components guide](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/03-zui.md)
|
|
124
|
+
- [Using zuix with other frameworks, or with none](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/06-frameworks.md)
|
|
125
|
+
- [Upgrading from 0.1 to 0.2](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/08-actualizar-de-0-1-a-0-2.md)
|
|
126
|
+
- [Accessibility](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/09-accesibilidad.md) and [CSP and Trusted Types](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/11-csp-y-trusted-types.md)
|
|
127
|
+
- [Public contract](https://github.com/zuccadev-labs/zuix/blob/main/docs/package/03-contrato-publico.md): what counts as public surface
|
|
128
|
+
- [Changelog](https://github.com/zuccadev-labs/zuix/blob/main/zui/CHANGELOG.md)
|
|
129
|
+
- Rules for AI agents: `AGENTS.md`, included in the package. Third-party notices: `THIRD_PARTY_NOTICES.md`.
|
|
130
|
+
|
|
131
|
+
## Español
|
|
132
|
+
|
|
133
|
+
Sistema de componentes de la suite zuix: 64 componentes sobre un contrato de HTML y CSS, sin bibliotecas de
|
|
134
|
+
UI de terceros. La guía está en español en [`docs/users/03-zui.md`](https://github.com/zuccadev-labs/zuix/blob/main/docs/users/03-zui.md).
|
|
135
|
+
|
|
136
|
+
## License
|
|
137
|
+
|
|
138
|
+
[MIT](https://github.com/zuccadev-labs/zuix/blob/main/LICENSE).
|