@jcsoftdev/ui 0.2.3 → 0.4.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/CHANGELOG.md +390 -7
- package/README.md +57 -3
- package/bin/ui-theme.mjs +1162 -25
- package/dist/ai/attachment/attachment.js +1 -1
- package/dist/ai/chat-list/group.js +3 -1
- package/dist/ai/conversation/conversation.js +1 -1
- package/dist/ai/internal/use-copy.d.ts +1 -5
- package/dist/ai/internal/use-copy.js +1 -32
- package/dist/ai/markdown/parse.js +59 -17
- package/dist/ai/source/source.js +1 -1
- package/dist/atoms/avatar/avatar.d.ts +13 -3
- package/dist/atoms/avatar/avatar.js +40 -2
- package/dist/atoms/avatar/index.d.ts +1 -1
- package/dist/atoms/avatar/index.js +3 -1
- package/dist/atoms/button/button.d.ts +4 -1
- package/dist/atoms/button/button.js +4 -2
- package/dist/atoms/checkbox/checkbox.d.ts +8 -3
- package/dist/atoms/checkbox/checkbox.js +26 -3
- package/dist/atoms/chip/chip.d.ts +19 -5
- package/dist/atoms/chip/chip.js +34 -5
- package/dist/atoms/chip/index.d.ts +1 -1
- package/dist/atoms/chip/index.js +6 -1
- package/dist/atoms/due-chip/due-chip.d.ts +31 -0
- package/dist/atoms/due-chip/due-chip.js +41 -0
- package/dist/atoms/due-chip/index.d.ts +2 -0
- package/dist/atoms/due-chip/index.js +6 -0
- package/dist/atoms/due-chip/model.d.ts +25 -0
- package/dist/atoms/due-chip/model.js +44 -0
- package/dist/atoms/icon-button/icon-button.d.ts +22 -0
- package/dist/atoms/icon-button/icon-button.js +38 -0
- package/dist/atoms/icon-button/index.d.ts +1 -0
- package/dist/atoms/icon-button/index.js +8 -0
- package/dist/atoms/index.d.ts +5 -0
- package/dist/atoms/index.js +5 -0
- package/dist/atoms/internal/hit-area.d.ts +6 -0
- package/dist/atoms/internal/hit-area.js +4 -0
- package/dist/atoms/kbd/index.d.ts +1 -0
- package/dist/atoms/kbd/index.js +4 -0
- package/dist/atoms/kbd/kbd.d.ts +7 -0
- package/dist/atoms/kbd/kbd.js +17 -0
- package/dist/atoms/radio-group/radio-group.js +6 -2
- package/dist/atoms/seal/index.d.ts +1 -0
- package/dist/atoms/seal/index.js +4 -0
- package/dist/atoms/seal/seal.d.ts +30 -0
- package/dist/atoms/seal/seal.js +71 -0
- package/dist/atoms/spinner/index.d.ts +1 -0
- package/dist/atoms/spinner/index.js +5 -0
- package/dist/atoms/spinner/spinner.d.ts +19 -0
- package/dist/atoms/spinner/spinner.js +31 -0
- package/dist/atoms/status-dot/index.d.ts +1 -1
- package/dist/atoms/status-dot/status-dot.d.ts +4 -2
- package/dist/atoms/status-dot/status-dot.js +5 -1
- package/dist/atoms/switch/switch.js +3 -1
- package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
- package/dist/calendar/date-calendar/date-calendar.js +189 -0
- package/dist/calendar/date-calendar/index.d.ts +1 -0
- package/dist/calendar/date-calendar/index.js +6 -0
- package/dist/calendar/index.d.ts +1 -0
- package/dist/calendar/index.js +1 -0
- package/dist/calendar/internal/date-utils.d.ts +26 -0
- package/dist/calendar/internal/date-utils.js +95 -1
- package/dist/charts/bar-chart/bar-race-chart.js +1 -0
- package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
- package/dist/charts/chord-chart/chord-chart.js +13 -5
- package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
- package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
- package/dist/charts/core/cartesian/layout.d.ts +6 -1
- package/dist/charts/core/cartesian/layout.js +14 -5
- package/dist/charts/core/cartesian/marks.d.ts +2 -2
- package/dist/charts/core/cartesian/marks.js +1 -1
- package/dist/charts/core/cartesian/types.d.ts +28 -2
- package/dist/charts/core/category-explorer.d.ts +2 -2
- package/dist/charts/core/category-explorer.js +8 -4
- package/dist/charts/core/chart-dock.d.ts +26 -0
- package/dist/charts/core/chart-dock.js +45 -0
- package/dist/charts/core/chart-frame.d.ts +9 -2
- package/dist/charts/core/chart-frame.js +105 -25
- package/dist/charts/core/distribution/explorer.d.ts +5 -2
- package/dist/charts/core/distribution/explorer.js +12 -5
- package/dist/charts/core/distribution/xy-points.js +1 -1
- package/dist/charts/core/index.d.ts +3 -0
- package/dist/charts/core/index.js +3 -0
- package/dist/charts/core/leave-grace.d.ts +11 -0
- package/dist/charts/core/leave-grace.js +26 -0
- package/dist/charts/core/nearest.d.ts +14 -0
- package/dist/charts/core/nearest.js +22 -0
- package/dist/charts/core/plot-overlay.js +9 -3
- package/dist/charts/core/pointer.test-utils.d.ts +38 -0
- package/dist/charts/core/pointer.test-utils.js +123 -0
- package/dist/charts/core/tooltip.d.ts +25 -2
- package/dist/charts/core/tooltip.js +115 -40
- package/dist/charts/core/touch-select.d.ts +20 -0
- package/dist/charts/core/touch-select.js +184 -0
- package/dist/charts/core/types.d.ts +8 -4
- package/dist/charts/core/types.js +5 -0
- package/dist/charts/core/use-index-navigation.d.ts +17 -6
- package/dist/charts/core/use-index-navigation.js +47 -10
- package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
- package/dist/charts/donut-chart/donut-chart.js +40 -1
- package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
- package/dist/charts/donut-chart/slice-labels.js +20 -0
- package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
- package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
- package/dist/charts/funnel-chart/funnel-chart.js +2 -1
- package/dist/charts/gauge-chart/gauge-chart.js +2 -1
- package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
- package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
- package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
- package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
- package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
- package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
- package/dist/charts/icicle-chart/icicle-chart.js +7 -9
- package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
- package/dist/charts/maps/geo/map-viewport.js +1 -1
- package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
- package/dist/charts/progress-units/progress-units.js +1 -0
- package/dist/charts/radar-chart/radar-chart.js +1 -1
- package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
- package/dist/charts/range-area-chart/range-area-chart.js +3 -2
- package/dist/charts/sankey-chart/sankey-chart.js +12 -4
- package/dist/charts/tree-chart/tree-chart.js +1 -0
- package/dist/charts/treemap-chart/treemap-chart.js +2 -7
- package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
- package/dist/containers/action-bar/action-bar.d.ts +11 -2
- package/dist/containers/action-bar/action-bar.js +4 -1
- package/dist/containers/aside/aside.d.ts +14 -0
- package/dist/containers/aside/aside.js +25 -0
- package/dist/containers/aside/index.d.ts +1 -0
- package/dist/containers/aside/index.js +5 -0
- package/dist/containers/banner/banner.d.ts +4 -1
- package/dist/containers/banner/banner.js +9 -1
- package/dist/containers/card/card.d.ts +21 -3
- package/dist/containers/card/card.js +20 -5
- package/dist/containers/description-list/description-list.d.ts +29 -6
- package/dist/containers/description-list/description-list.js +47 -6
- package/dist/containers/feed/feed.d.ts +23 -0
- package/dist/containers/feed/feed.js +77 -0
- package/dist/containers/feed/index.d.ts +2 -0
- package/dist/containers/feed/index.js +10 -0
- package/dist/containers/feed/model.d.ts +19 -0
- package/dist/containers/feed/model.js +38 -0
- package/dist/containers/grid/grid.d.ts +15 -0
- package/dist/containers/grid/grid.js +24 -0
- package/dist/containers/grid/index.d.ts +1 -0
- package/dist/containers/grid/index.js +4 -0
- package/dist/containers/index.d.ts +9 -0
- package/dist/containers/index.js +9 -0
- package/dist/containers/kpi/kpi.d.ts +60 -7
- package/dist/containers/kpi/kpi.js +142 -28
- package/dist/containers/kpi-group/index.d.ts +1 -1
- package/dist/containers/kpi-group/index.js +3 -1
- package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
- package/dist/containers/kpi-group/kpi-group.js +11 -1
- package/dist/containers/list-detail/index.d.ts +1 -0
- package/dist/containers/list-detail/index.js +20 -0
- package/dist/containers/list-detail/list-detail.d.ts +55 -0
- package/dist/containers/list-detail/list-detail.js +221 -0
- package/dist/containers/note/index.d.ts +1 -0
- package/dist/containers/note/index.js +4 -0
- package/dist/containers/note/note.d.ts +13 -0
- package/dist/containers/note/note.js +27 -0
- package/dist/containers/page/index.d.ts +1 -0
- package/dist/containers/page/index.js +4 -0
- package/dist/containers/page/page.d.ts +7 -0
- package/dist/containers/page/page.js +14 -0
- package/dist/containers/page-header/page-header.d.ts +8 -3
- package/dist/containers/page-header/page-header.js +35 -8
- package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
- package/dist/containers/responsive-list/responsive-list.js +6 -3
- package/dist/containers/section/index.d.ts +1 -0
- package/dist/containers/section/index.js +6 -0
- package/dist/containers/section/section.d.ts +68 -0
- package/dist/containers/section/section.js +198 -0
- package/dist/containers/shortcuts/index.d.ts +1 -0
- package/dist/containers/shortcuts/index.js +8 -0
- package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
- package/dist/containers/shortcuts/shortcuts.js +50 -0
- package/dist/containers/stack/index.d.ts +1 -0
- package/dist/containers/stack/index.js +6 -0
- package/dist/containers/stack/stack.d.ts +15 -0
- package/dist/containers/stack/stack.js +43 -0
- package/dist/containers/table/selection.d.ts +9 -0
- package/dist/containers/table/selection.js +20 -0
- package/dist/containers/table/table.d.ts +66 -4
- package/dist/containers/table/table.js +128 -7
- package/dist/containers/timeline/index.d.ts +1 -1
- package/dist/containers/timeline/index.js +4 -2
- package/dist/containers/timeline/timeline.d.ts +32 -5
- package/dist/containers/timeline/timeline.js +154 -90
- package/dist/forms/chip-group/chip-group.d.ts +54 -0
- package/dist/forms/chip-group/chip-group.js +114 -0
- package/dist/forms/chip-group/index.d.ts +1 -0
- package/dist/forms/chip-group/index.js +6 -0
- package/dist/forms/combobox/combobox.d.ts +60 -0
- package/dist/forms/combobox/combobox.js +281 -0
- package/dist/forms/combobox/index.d.ts +1 -0
- package/dist/forms/combobox/index.js +6 -0
- package/dist/forms/copy-field/copy-field.d.ts +17 -0
- package/dist/forms/copy-field/copy-field.js +72 -0
- package/dist/forms/copy-field/index.d.ts +1 -0
- package/dist/forms/copy-field/index.js +4 -0
- package/dist/forms/date-picker/date-picker.d.ts +40 -0
- package/dist/forms/date-picker/date-picker.js +183 -0
- package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
- package/dist/forms/date-picker/date-time-picker.js +121 -0
- package/dist/forms/date-picker/index.d.ts +2 -0
- package/dist/forms/date-picker/index.js +10 -0
- package/dist/forms/date-picker/model.d.ts +35 -0
- package/dist/forms/date-picker/model.js +83 -0
- package/dist/forms/dropzone/dropzone.d.ts +30 -2
- package/dist/forms/dropzone/dropzone.js +153 -23
- package/dist/forms/emoji-picker/emoji-picker.js +1 -1
- package/dist/forms/field/field.d.ts +16 -10
- package/dist/forms/field/field.js +41 -5
- package/dist/forms/form/form.d.ts +15 -0
- package/dist/forms/form/form.js +29 -0
- package/dist/forms/form/index.d.ts +1 -0
- package/dist/forms/form/index.js +10 -0
- package/dist/forms/index.d.ts +6 -0
- package/dist/forms/index.js +6 -0
- package/dist/forms/input/index.d.ts +1 -1
- package/dist/forms/input/index.js +6 -2
- package/dist/forms/input/input.d.ts +23 -3
- package/dist/forms/input/input.js +78 -7
- package/dist/forms/input-icon/input-icon.d.ts +1 -1
- package/dist/forms/internal/listbox-items.d.ts +18 -0
- package/dist/forms/internal/listbox-items.js +88 -0
- package/dist/forms/internal/listbox.d.ts +44 -0
- package/dist/forms/internal/listbox.js +74 -0
- package/dist/forms/number-stepper/model.d.ts +16 -0
- package/dist/forms/number-stepper/model.js +23 -0
- package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
- package/dist/forms/number-stepper/number-stepper.js +86 -37
- package/dist/forms/select-menu/index.d.ts +1 -0
- package/dist/forms/select-menu/index.js +6 -0
- package/dist/forms/select-menu/select-menu.d.ts +35 -0
- package/dist/forms/select-menu/select-menu.js +230 -0
- package/dist/glass/crystal-map.d.ts +70 -0
- package/dist/glass/crystal-map.js +88 -0
- package/dist/glass/displacement-map.d.ts +117 -0
- package/dist/glass/displacement-map.js +201 -0
- package/dist/glass/index.d.ts +8 -0
- package/dist/glass/index.js +63 -0
- package/dist/glass/lens-crystal.d.ts +29 -0
- package/dist/glass/lens-crystal.js +161 -0
- package/dist/glass/lens-dispersion.d.ts +11 -0
- package/dist/glass/lens-dispersion.js +19 -0
- package/dist/glass/liquid-glass.d.ts +41 -0
- package/dist/glass/liquid-glass.js +256 -0
- package/dist/glass/liquid-motion.d.ts +53 -0
- package/dist/glass/liquid-motion.js +302 -0
- package/dist/glass/liquid-options.d.ts +162 -0
- package/dist/glass/liquid-options.js +179 -0
- package/dist/glass/refraction.d.ts +100 -0
- package/dist/glass/refraction.js +714 -0
- package/dist/glass/specular-map.d.ts +26 -0
- package/dist/glass/specular-map.js +75 -0
- package/dist/glass/spring.d.ts +79 -0
- package/dist/glass/spring.js +58 -0
- package/dist/glass/support.d.ts +13 -0
- package/dist/glass/support.js +14 -0
- package/dist/glass/use-glass-refraction.d.ts +8 -0
- package/dist/glass/use-glass-refraction.js +16 -0
- package/dist/i18n/strings.d.ts +113 -0
- package/dist/i18n/strings.js +70 -2
- package/dist/i18n/ui-strings-provider.d.ts +1 -1
- package/dist/i18n/ui-strings-provider.js +6 -2
- package/dist/icons/index.d.ts +2 -0
- package/dist/icons/index.js +4 -0
- package/dist/icons/key.d.ts +2 -0
- package/dist/icons/key.js +12 -0
- package/dist/icons/webhook.d.ts +2 -0
- package/dist/icons/webhook.js +12 -0
- package/dist/liquid/index.d.ts +3 -0
- package/dist/liquid/index.js +29 -0
- package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
- package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
- package/dist/navigation/breadcrumbs/index.d.ts +1 -0
- package/dist/navigation/breadcrumbs/index.js +6 -0
- package/dist/navigation/index.d.ts +2 -0
- package/dist/navigation/index.js +2 -0
- package/dist/navigation/segmented/index.d.ts +1 -1
- package/dist/navigation/segmented/model.d.ts +5 -0
- package/dist/navigation/segmented/model.js +6 -0
- package/dist/navigation/segmented/segmented.d.ts +17 -3
- package/dist/navigation/segmented/segmented.js +20 -4
- package/dist/navigation/stepper/index.d.ts +1 -1
- package/dist/navigation/stepper/index.js +3 -1
- package/dist/navigation/stepper/stepper.d.ts +8 -0
- package/dist/navigation/stepper/stepper.js +68 -45
- package/dist/navigation/tabs/index.d.ts +1 -0
- package/dist/navigation/tabs/index.js +6 -0
- package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
- package/dist/navigation/tabs/tabs-nav.js +57 -0
- package/dist/navigation/wizard/index.d.ts +1 -0
- package/dist/navigation/wizard/index.js +6 -0
- package/dist/navigation/wizard/model.d.ts +33 -0
- package/dist/navigation/wizard/model.js +34 -0
- package/dist/navigation/wizard/wizard.d.ts +45 -0
- package/dist/navigation/wizard/wizard.js +169 -0
- package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
- package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
- package/dist/overlays/alert-dialog/index.d.ts +1 -0
- package/dist/overlays/alert-dialog/index.js +26 -0
- package/dist/overlays/context-menu/context-menu.d.ts +9 -1
- package/dist/overlays/context-menu/context-menu.js +4 -1
- package/dist/overlays/dialog/dialog.d.ts +9 -1
- package/dist/overlays/dialog/dialog.js +3 -0
- package/dist/overlays/drawer/drawer.d.ts +9 -1
- package/dist/overlays/drawer/drawer.js +3 -0
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
- package/dist/overlays/dropdown-menu/index.d.ts +1 -1
- package/dist/overlays/dropdown-menu/index.js +8 -2
- package/dist/overlays/hover-card/hover-card.d.ts +10 -1
- package/dist/overlays/hover-card/hover-card.js +4 -1
- package/dist/overlays/index.d.ts +2 -0
- package/dist/overlays/index.js +2 -0
- package/dist/overlays/popover/popover.d.ts +9 -1
- package/dist/overlays/popover/popover.js +3 -0
- package/dist/overlays/testing/index.d.ts +5 -0
- package/dist/overlays/testing/index.js +4 -0
- package/dist/overlays/toaster/index.d.ts +2 -1
- package/dist/overlays/toaster/index.js +4 -2
- package/dist/overlays/toaster/toast-store.d.ts +6 -2
- package/dist/overlays/toaster/toast.d.ts +3 -0
- package/dist/overlays/toaster/toast.js +3 -0
- package/dist/overlays/toaster/toaster.d.ts +3 -0
- package/dist/overlays/toaster/toaster.js +36 -3
- package/dist/overlays/tooltip/index.d.ts +1 -0
- package/dist/overlays/tooltip/index.js +4 -0
- package/dist/overlays/tooltip/model.d.ts +10 -0
- package/dist/overlays/tooltip/model.js +13 -0
- package/dist/overlays/tooltip/tooltip.d.ts +41 -0
- package/dist/overlays/tooltip/tooltip.js +116 -0
- package/dist/palette/command-palette/command-palette.d.ts +12 -2
- package/dist/palette/command-palette/command-palette.js +5 -0
- package/dist/primitives/command/command.d.ts +3 -2
- package/dist/primitives/command/command.js +2 -0
- package/dist/primitives/menu/menu.js +1 -1
- package/dist/primitives/popper/popper.js +5 -0
- package/dist/primitives/use-dismissable-layer.js +1 -1
- package/dist/rich-text/rich-text-editor.js +94 -8
- package/dist/rich-text/sanitize.js +70 -20
- package/dist/shell/app-shell/app-shell.d.ts +17 -0
- package/dist/shell/app-shell/app-shell.js +44 -4
- package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
- package/dist/shell/bottom-nav/bottom-nav.js +124 -0
- package/dist/shell/bottom-nav/index.d.ts +2 -0
- package/dist/shell/bottom-nav/index.js +9 -0
- package/dist/shell/bottom-nav/split.d.ts +11 -0
- package/dist/shell/bottom-nav/split.js +10 -0
- package/dist/shell/sidebar/sidebar.d.ts +16 -2
- package/dist/shell/sidebar/sidebar.js +46 -4
- package/dist/shell/topbar/topbar.d.ts +20 -9
- package/dist/shell/topbar/topbar.js +16 -9
- package/dist/states/empty-state/empty-state.d.ts +3 -1
- package/dist/states/empty-state/empty-state.js +9 -1
- package/dist/states/error-state/error-state.d.ts +8 -1
- package/dist/states/error-state/error-state.js +15 -9
- package/dist/states/index.d.ts +1 -0
- package/dist/states/index.js +1 -0
- package/dist/states/live-status-bar/index.d.ts +1 -0
- package/dist/states/live-status-bar/index.js +6 -0
- package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
- package/dist/states/live-status-bar/live-status-bar.js +49 -0
- package/dist/states/offline-banner/offline-banner.d.ts +3 -1
- package/dist/states/offline-banner/offline-banner.js +8 -4
- package/dist/states/skeleton/skeleton.d.ts +8 -2
- package/dist/states/skeleton/skeleton.js +44 -2
- package/dist/utils/class-groups.js +17 -0
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +2 -0
- package/dist/utils/material.d.ts +13 -0
- package/dist/utils/material.js +6 -0
- package/dist/utils/tone.d.ts +8 -0
- package/dist/utils/tone.js +17 -0
- package/dist/utils/use-copy.d.ts +5 -0
- package/dist/utils/use-copy.js +35 -0
- package/icons/svg/key.svg +5 -0
- package/icons/svg/webhook.svg +5 -0
- package/package.json +31 -21
- package/scripts/build-theme.d.mts +22 -0
- package/scripts/build-theme.mjs +248 -5
- package/src/ai/attachment/attachment.tsx +1 -1
- package/src/ai/chat-list/group.ts +3 -1
- package/src/ai/conversation/conversation.tsx +1 -1
- package/src/ai/internal/use-copy.ts +1 -38
- package/src/ai/markdown/parse.ts +74 -17
- package/src/ai/source/source.tsx +1 -1
- package/src/atoms/avatar/avatar.tsx +57 -4
- package/src/atoms/avatar/index.ts +8 -1
- package/src/atoms/button/button.tsx +8 -3
- package/src/atoms/checkbox/checkbox.tsx +33 -4
- package/src/atoms/chip/chip.tsx +55 -8
- package/src/atoms/chip/index.ts +9 -1
- package/src/atoms/due-chip/due-chip.tsx +75 -0
- package/src/atoms/due-chip/index.ts +2 -0
- package/src/atoms/due-chip/model.ts +67 -0
- package/src/atoms/icon-button/icon-button.tsx +58 -0
- package/src/atoms/icon-button/index.ts +6 -0
- package/src/atoms/index.ts +5 -0
- package/src/atoms/internal/hit-area.ts +7 -0
- package/src/atoms/kbd/index.ts +1 -0
- package/src/atoms/kbd/kbd.tsx +20 -0
- package/src/atoms/radio-group/radio-group.tsx +8 -2
- package/src/atoms/seal/index.ts +1 -0
- package/src/atoms/seal/seal.tsx +107 -0
- package/src/atoms/spinner/index.ts +1 -0
- package/src/atoms/spinner/spinner.tsx +49 -0
- package/src/atoms/status-dot/index.ts +1 -0
- package/src/atoms/status-dot/status-dot.tsx +15 -3
- package/src/atoms/switch/switch.tsx +3 -1
- package/src/calendar/date-calendar/date-calendar.tsx +230 -0
- package/src/calendar/date-calendar/index.ts +5 -0
- package/src/calendar/index.ts +1 -0
- package/src/calendar/internal/date-utils.ts +115 -0
- package/src/charts/README.md +21 -0
- package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
- package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
- package/src/charts/chord-chart/chord-chart.tsx +13 -5
- package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
- package/src/charts/core/cartesian/layout.ts +29 -10
- package/src/charts/core/cartesian/marks.tsx +3 -3
- package/src/charts/core/cartesian/types.ts +30 -2
- package/src/charts/core/category-explorer.tsx +12 -6
- package/src/charts/core/chart-dock.tsx +68 -0
- package/src/charts/core/chart-frame.tsx +116 -27
- package/src/charts/core/distribution/explorer.tsx +17 -7
- package/src/charts/core/distribution/xy-points.tsx +1 -1
- package/src/charts/core/index.ts +3 -0
- package/src/charts/core/leave-grace.ts +35 -0
- package/src/charts/core/nearest.ts +38 -0
- package/src/charts/core/plot-overlay.tsx +9 -3
- package/src/charts/core/pointer.test-utils.ts +146 -0
- package/src/charts/core/tooltip.tsx +129 -15
- package/src/charts/core/touch-select.ts +250 -0
- package/src/charts/core/types.ts +13 -4
- package/src/charts/core/use-index-navigation.ts +70 -11
- package/src/charts/donut-chart/donut-chart.tsx +53 -3
- package/src/charts/donut-chart/slice-labels.ts +39 -0
- package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
- package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
- package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
- package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
- package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
- package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
- package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
- package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
- package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
- package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
- package/src/charts/maps/geo/map-viewport.tsx +1 -1
- package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
- package/src/charts/progress-units/progress-units.tsx +1 -0
- package/src/charts/radar-chart/radar-chart.tsx +1 -1
- package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
- package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
- package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
- package/src/charts/tree-chart/tree-chart.tsx +1 -0
- package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
- package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
- package/src/containers/action-bar/action-bar.tsx +13 -2
- package/src/containers/aside/aside.tsx +40 -0
- package/src/containers/aside/index.ts +1 -0
- package/src/containers/banner/banner.tsx +18 -1
- package/src/containers/card/card.tsx +43 -4
- package/src/containers/description-list/description-list.tsx +85 -9
- package/src/containers/feed/feed.tsx +99 -0
- package/src/containers/feed/index.ts +8 -0
- package/src/containers/feed/model.ts +54 -0
- package/src/containers/grid/grid.tsx +37 -0
- package/src/containers/grid/index.ts +1 -0
- package/src/containers/index.ts +9 -0
- package/src/containers/kpi/kpi.tsx +231 -38
- package/src/containers/kpi-group/index.ts +7 -1
- package/src/containers/kpi-group/kpi-group.tsx +26 -1
- package/src/containers/list-detail/index.ts +15 -0
- package/src/containers/list-detail/list-detail.tsx +293 -0
- package/src/containers/note/index.ts +1 -0
- package/src/containers/note/note.tsx +38 -0
- package/src/containers/page/index.ts +1 -0
- package/src/containers/page/page.tsx +17 -0
- package/src/containers/page-header/page-header.tsx +38 -8
- package/src/containers/responsive-list/responsive-list.tsx +7 -4
- package/src/containers/section/index.ts +11 -0
- package/src/containers/section/section.tsx +281 -0
- package/src/containers/shortcuts/index.ts +6 -0
- package/src/containers/shortcuts/shortcuts.tsx +92 -0
- package/src/containers/stack/index.ts +7 -0
- package/src/containers/stack/stack.tsx +55 -0
- package/src/containers/table/selection.ts +26 -0
- package/src/containers/table/table.tsx +215 -13
- package/src/containers/timeline/index.ts +3 -0
- package/src/containers/timeline/timeline.tsx +204 -93
- package/src/forms/chip-group/chip-group.tsx +184 -0
- package/src/forms/chip-group/index.ts +8 -0
- package/src/forms/combobox/combobox.tsx +359 -0
- package/src/forms/combobox/index.ts +7 -0
- package/src/forms/copy-field/copy-field.tsx +88 -0
- package/src/forms/copy-field/index.ts +1 -0
- package/src/forms/date-picker/date-picker.tsx +239 -0
- package/src/forms/date-picker/date-time-picker.tsx +178 -0
- package/src/forms/date-picker/index.ts +10 -0
- package/src/forms/date-picker/model.ts +108 -0
- package/src/forms/dropzone/dropzone.tsx +217 -35
- package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
- package/src/forms/field/field.tsx +72 -7
- package/src/forms/form/form.tsx +46 -0
- package/src/forms/form/index.ts +8 -0
- package/src/forms/index.ts +6 -0
- package/src/forms/input/index.ts +8 -1
- package/src/forms/input/input.tsx +103 -7
- package/src/forms/input-icon/input-icon.tsx +1 -1
- package/src/forms/internal/listbox-items.tsx +103 -0
- package/src/forms/internal/listbox.ts +124 -0
- package/src/forms/number-stepper/model.ts +35 -0
- package/src/forms/number-stepper/number-stepper.tsx +132 -42
- package/src/forms/select-menu/index.ts +7 -0
- package/src/forms/select-menu/select-menu.tsx +280 -0
- package/src/glass/crystal-map.ts +150 -0
- package/src/glass/displacement-map.ts +317 -0
- package/src/glass/index.ts +43 -0
- package/src/glass/lens-crystal.ts +226 -0
- package/src/glass/lens-dispersion.ts +34 -0
- package/src/glass/liquid-glass.tsx +371 -0
- package/src/glass/liquid-motion.ts +395 -0
- package/src/glass/liquid-options.ts +306 -0
- package/src/glass/refraction.ts +1010 -0
- package/src/glass/specular-map.ts +95 -0
- package/src/glass/spring.ts +98 -0
- package/src/glass/support.ts +27 -0
- package/src/glass/use-glass-refraction.ts +21 -0
- package/src/i18n/strings.ts +113 -0
- package/src/i18n/ui-strings-provider.tsx +15 -4
- package/src/icons/index.ts +2 -0
- package/src/icons/key.tsx +13 -0
- package/src/icons/webhook.tsx +13 -0
- package/src/liquid/index.ts +24 -0
- package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
- package/src/navigation/breadcrumbs/index.ts +8 -0
- package/src/navigation/index.ts +2 -0
- package/src/navigation/segmented/index.ts +1 -0
- package/src/navigation/segmented/model.ts +11 -0
- package/src/navigation/segmented/segmented.tsx +45 -6
- package/src/navigation/stepper/index.ts +7 -1
- package/src/navigation/stepper/stepper.tsx +41 -5
- package/src/navigation/tabs/index.ts +7 -0
- package/src/navigation/tabs/tabs-nav.tsx +131 -0
- package/src/navigation/wizard/index.ts +7 -0
- package/src/navigation/wizard/model.ts +61 -0
- package/src/navigation/wizard/wizard.tsx +222 -0
- package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
- package/src/overlays/alert-dialog/index.ts +19 -0
- package/src/overlays/context-menu/context-menu.tsx +11 -1
- package/src/overlays/dialog/dialog.tsx +10 -0
- package/src/overlays/drawer/drawer.tsx +10 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
- package/src/overlays/dropdown-menu/index.ts +3 -0
- package/src/overlays/hover-card/hover-card.tsx +12 -1
- package/src/overlays/index.ts +2 -0
- package/src/overlays/popover/popover.tsx +10 -0
- package/src/overlays/testing/index.ts +5 -0
- package/src/overlays/toaster/index.ts +2 -0
- package/src/overlays/toaster/toast-store.ts +6 -2
- package/src/overlays/toaster/toast.ts +6 -0
- package/src/overlays/toaster/toaster.tsx +44 -2
- package/src/overlays/tooltip/index.ts +1 -0
- package/src/overlays/tooltip/model.ts +18 -0
- package/src/overlays/tooltip/tooltip.tsx +166 -0
- package/src/palette/command-palette/command-palette.tsx +15 -1
- package/src/primitives/command/command.tsx +4 -0
- package/src/primitives/menu/menu.tsx +1 -1
- package/src/primitives/popper/popper.tsx +10 -0
- package/src/primitives/use-dismissable-layer.ts +7 -2
- package/src/rich-text/rich-text-editor.tsx +116 -13
- package/src/rich-text/sanitize.ts +94 -23
- package/src/shell/app-shell/app-shell.tsx +60 -4
- package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
- package/src/shell/bottom-nav/index.ts +8 -0
- package/src/shell/bottom-nav/split.ts +20 -0
- package/src/shell/sidebar/sidebar.tsx +51 -5
- package/src/shell/topbar/topbar.tsx +81 -58
- package/src/states/empty-state/empty-state.tsx +11 -1
- package/src/states/error-state/error-state.tsx +23 -8
- package/src/states/index.ts +1 -0
- package/src/states/live-status-bar/index.ts +6 -0
- package/src/states/live-status-bar/live-status-bar.tsx +62 -0
- package/src/states/offline-banner/offline-banner.tsx +13 -5
- package/src/states/skeleton/skeleton.tsx +68 -2
- package/src/utils/class-groups.ts +17 -0
- package/src/utils/index.ts +1 -0
- package/src/utils/material.ts +16 -0
- package/src/utils/tone.ts +29 -0
- package/src/utils/use-copy.ts +38 -0
- package/styles/Theme.kt +64 -3
- package/styles/base.css +51 -0
- package/styles/tailwind.css +836 -0
- package/styles/theme.css +579 -34
- package/styles/tokens.css +788 -15
- package/tokens/default.json +918 -29
- package/scripts/build-theme.d.ts +0 -18
package/CHANGELOG.md
CHANGED
|
@@ -1,25 +1,383 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 0.
|
|
3
|
+
## 0.4.0 (2026-10-21)
|
|
4
|
+
|
|
5
|
+
### Blocks for application screens
|
|
6
|
+
|
|
7
|
+
New components, all additive and source compatible, with no new runtime dependency. Defaults come
|
|
8
|
+
from `UiStringsProvider` (en/es), layout follows container queries, and hit areas follow
|
|
9
|
+
`data-density="touch"`. Guide with examples: `/docs/blocks/`.
|
|
10
|
+
|
|
11
|
+
#### Added
|
|
12
|
+
|
|
13
|
+
- **Atoms.** `Spinner` (`size`, `label`, decorative `label={false}`), `Kbd`, `IconButton`
|
|
14
|
+
(required `label`, `variant`, `size`, `loading`, `asChild`, `iconButtonSizeClasses`), `DueChip`
|
|
15
|
+
(`date`, `today`, `soonDays`, `done`, `locale`) and `Seal` (`title`, `icon`, `tone`, `label`).
|
|
16
|
+
- **Overlays.** `Tooltip` (`content`, `shortcut`, `side`, `align`, `openDelay`, `closeDelay`,
|
|
17
|
+
controlled `open`) and `AlertDialog` (`role="alertdialog"`, `tone`, async `onConfirm` with a
|
|
18
|
+
pending state and inline failure message, focus on Cancel).
|
|
19
|
+
- **Forms.** `SelectMenu` (custom listbox select over `options`), `Combobox` (filter, async
|
|
20
|
+
`onSearchChange`, `loading`, `clearable`, `valueLabel`), `DatePicker` and `DateTimePicker` (ISO
|
|
21
|
+
values, `min`, `max`, `isDateDisabled`, locale-derived format and week start, time-zone safe) and
|
|
22
|
+
`ChipGroup` (multiple or single toggle chips with roving focus).
|
|
23
|
+
- **Calendar.** `DateCalendar`, the standalone keyboard date grid behind the pickers.
|
|
24
|
+
- **Navigation.** `Wizard` (`steps`, async `canAdvance`, `onBeforeNext`, `onComplete`) and
|
|
25
|
+
`TabsNav` / `TabsNavLink` (link strip with `aria-current="page"`, `renderLink`, `asChild`).
|
|
26
|
+
- **Containers.** `Section`, `Note`, `Aside` / `AsideHeader`, `ListDetail` (with its parts and
|
|
27
|
+
`useListDetail`), `Feed` / `FeedEvent` and `Shortcuts` / `ShortcutsItem`.
|
|
28
|
+
- **Banner `appearance="outline"`.** Page surface where only the border carries the tone (default
|
|
29
|
+
`soft`).
|
|
30
|
+
- **`DescriptionList`** `layout` (`auto`, `inline`, `stacked`), `columns` (1 to 3), `valueAlign` and
|
|
31
|
+
`DescriptionListItem` (dash placeholder for `null`, `undefined`, `false` and `""`).
|
|
32
|
+
- **`Chip` `size="sm"`** and `chipSizeClasses`; `ref` is a regular prop.
|
|
33
|
+
- **`Skeleton` variants** `list`, `kpis`, `key-value` and `bar`, with `count`.
|
|
34
|
+
- **`ErrorState` `actions`.**
|
|
35
|
+
- **Toast tones.** `toast.info`, `toast.warning`, `toast.danger` and `toastToneClasses`.
|
|
36
|
+
- **`resetToasts()`** in the new `@jcsoftdev/ui/overlays/testing` entry, for resetting the toast
|
|
37
|
+
store between tests.
|
|
38
|
+
- **Form gaps found while migrating an app.** `Input` takes `start` / `end` adornments, a
|
|
39
|
+
30px `size="xs"` and `variant="bare"`; `Dropzone` has `mode="field"` (a real labelled
|
|
40
|
+
`<input type="file">` with `accept`, `multiple`, `onChange` and removable selections);
|
|
41
|
+
`NumberStepper` has a string mode (`mode="string"`: empty state, caller-owned text, change event);
|
|
42
|
+
`Field` accepts a node `label` and several children.
|
|
43
|
+
- **Table.** `flush` (`true`, `"start"`, `"end"`) drops the outer cell padding so the first and last
|
|
44
|
+
column sit on the container edge; `stickyHeader`; `maxHeight` (the capped wrapper is focusable);
|
|
45
|
+
row selection with `selectedKeys`, `defaultSelectedKeys`, `onSelectedKeysChange`, `rowKey` on
|
|
46
|
+
`TableRow` / `TableLinkRow` (`aria-selected`), `TableSelectCell` and `TableSelectAllCell` (checked,
|
|
47
|
+
mixed, unchecked); `TableActionsCell`, which wraps inline actions under a narrow table container
|
|
48
|
+
(a named container query) or swaps them for an overflow `menu` you pass.
|
|
49
|
+
- **Section parts.** `Section.Header`, `.Title`, `.Count`, `.Description`, `.Actions` and `.Body`
|
|
50
|
+
next to the props API; a part as a direct child switches to composed rendering.
|
|
51
|
+
- **Kpi parts and chrome.** `Kpi.Label`, `.Value` (`mono`, `suffix`, `trend`) and `.Description`;
|
|
52
|
+
`card` (border and radius); `trailing` (content at the end of the label row that stays exposed to
|
|
53
|
+
assistive tech, unlike the decorative `icon`).
|
|
54
|
+
- **Timeline** `status` per item (`done`, `current`, `error`, `pending`) with a glyph, a spoken state
|
|
55
|
+
and `aria-current="step"`, and `Timeline.Item` children next to `items`.
|
|
56
|
+
- **Stepper** `status` per step (`done`, `current`, `error`, `pending`) with a check or cross and a
|
|
57
|
+
spoken state; the default stays `current` for `currentStepId` and `pending` otherwise.
|
|
58
|
+
- **AlertDialog** `confirmDisabled` and `cancelDisabled`, and a compound API: `AlertDialog.Root`,
|
|
59
|
+
`.Trigger`, `.Content`, `.Header`, `.Title`, `.Description`, `.Body`, `.Footer`, `.Cancel` and
|
|
60
|
+
`.Action`. Cancel and Action close the dialog after their `onClick` unless it calls
|
|
61
|
+
`preventDefault()`; use the props API for an async confirm with a pending state.
|
|
62
|
+
- **ListDetail** `onBack`.
|
|
63
|
+
- **DueChip** `state` forces `overdue`, `soon`, `ok` or `done` whatever the date says.
|
|
64
|
+
- **Seal** `tone="institutional"` (strong neutral, ink frame) and any tone declared in
|
|
65
|
+
`tonePalettes`, by name, as `Kpi` does.
|
|
66
|
+
- **DropdownMenu** `bare` content (layering and size limits only, so a custom menu draws its own
|
|
67
|
+
surface), `DropdownMenuAnchor`, and `dropdownMenuItemClasses` / `dropdownMenuSurfaceClasses`.
|
|
68
|
+
- **UI strings** (en/es) for the new components: `noResults`, `clear`, `selectPlaceholder`,
|
|
69
|
+
`calendar`, `openCalendar`, `previousMonth`, `nextMonth`, `time`, `locale`, the day, month and
|
|
70
|
+
year placeholders, `back`, `next`, `finish`, `stepOf`, `steps`, `aside`, `backToList`, `overdue`,
|
|
71
|
+
`dueSoon`, `stepDone`, `stepError`, `selectRow`, `selectAll` and `rowActions`.
|
|
72
|
+
|
|
73
|
+
#### Changed (behavior to check when upgrading)
|
|
74
|
+
|
|
75
|
+
- **`ErrorState` markup.** The retry button now sits inside a wrapper `div` that also holds
|
|
76
|
+
`actions`. Selectors or tests that expect the button as a direct child need updating.
|
|
77
|
+
- **Toast tint.** Success and error toasts are tinted with their tone (`*-soft` surface, tone
|
|
78
|
+
border, status glyph) instead of the inverted neutral look. `default` is unchanged and roles are
|
|
79
|
+
unchanged (only error is an alert).
|
|
80
|
+
- **`Checkbox` and `Switch` touch target.** The 44px target is an invisible `::after` of the control
|
|
81
|
+
instead of a larger root, so under touch density the layout box is 40px (it was 44px) and the hit
|
|
82
|
+
target can overlap a neighbour by 2px per side. Default density is unchanged.
|
|
83
|
+
- **`Section` `divider` is off by default.** A kit whose section header always drew a hairline
|
|
84
|
+
needs `divider`.
|
|
85
|
+
- **`RadioGroup`** radios now carry `aria-labelledby` and `aria-describedby`, so they have
|
|
86
|
+
accessible names without relying on `<label for>`.
|
|
87
|
+
- **`theme.css` no longer emits self-referencing variables.** Entries such as
|
|
88
|
+
`--radius-input: var(--radius-input)` (radii, shadows, `--font-sans`) now sit in an
|
|
89
|
+
`@theme reference inline` block, so the utilities resolve to the raw token and nothing is declared
|
|
90
|
+
in Tailwind's theme layer. Consumers no longer need to reorder layers; verified on Tailwind 4.3.3.
|
|
91
|
+
- **Locale reaches the date pickers.** `UiStringsProvider` ignores `undefined` and empty entries
|
|
92
|
+
instead of letting them overwrite the preset, so `strings={{ locale: undefined }}` no longer sends
|
|
93
|
+
Intl to the system locale; its context is shared across duplicate module copies.
|
|
94
|
+
- **`Combobox` `required`** sets `aria-required` only and no longer blocks native submit before your
|
|
95
|
+
own validation; `nativeRequired` opts back in.
|
|
96
|
+
- **`Section` and titleless wrappers.** A `Section` with no title no longer takes a heading level or
|
|
97
|
+
tightens the spacing of what it wraps, so a titled section inside a wrapper keeps the level it
|
|
98
|
+
would have had without it (it moves up one level compared with the earlier 0.3.0 previews).
|
|
99
|
+
- **`ListDetail` back action.** It calls `onBack` and never `onValueChange(null)`; `onValueChange`
|
|
100
|
+
is typed `(value: string) => void`. Both only affect the earlier 0.3.0 previews, since `ListDetail`
|
|
101
|
+
is new in 0.3.0.
|
|
102
|
+
- **`Table` selected rows.** A row with a `rowKey` in a table with selection props reports
|
|
103
|
+
`aria-selected` and highlights; tables without selection props render as before.
|
|
104
|
+
- **Escape inside the library's own comboboxes.** The dismissable-layer primitive no longer treats
|
|
105
|
+
the library's own open `role="combobox"` widgets as a foreign layer, so Escape closes them.
|
|
106
|
+
|
|
107
|
+
### Components for app shells
|
|
108
|
+
|
|
109
|
+
- **`Sidebar` rail.** `collapsed` turns the sidebar into an icons-only rail (labels as `title` tooltips and screen-reader text, badges as dots). It is ignored while the sidebar is a drawer, so the default behavior is unchanged.
|
|
110
|
+
- **`Chip` `onRemove`.** Appends a remove button named from the new `remove` UI string ("Remove" / "Quitar", or `removeLabel`), keyboard operable, with a 44px hit area under touch density.
|
|
111
|
+
- **`ResponsiveList` follows its own width.** It is a container (`@container/responsive-list`) and swaps cards for the table at 42rem of its own width instead of the viewport `md`, so it stays right in a narrow column or beside a sidebar.
|
|
112
|
+
- **`Input` `size="lg"`.** A thumb-friendly field at the height of the large `Button` (`h-control-lg`); `size` defaults to `md`. `size` is now the `md | lg` prop, no longer the native numeric attribute.
|
|
113
|
+
- **Key and Webhook icons.** `Key` and `Webhook` join the icon set (Lucide sources in `icons/svg`), with their lazy `<ui-icon>` glyphs.
|
|
114
|
+
### Liquid Glass on phones
|
|
115
|
+
|
|
116
|
+
- **Cheaper lens maps.** The displacement and specular maps are rasterised at no more than 1.5
|
|
117
|
+
pixels per CSS pixel (they are smooth fields that `feImage` stretches), and a large surface drops
|
|
118
|
+
toward one, so a 3x phone no longer builds a map 4x the size of the surface on the main thread.
|
|
119
|
+
The specular map (contour and glint) keeps up to 1.5 even where the large-surface cap has taken
|
|
120
|
+
the refraction map down to one. The crystal map, which mostly covers the margin its layer clips
|
|
121
|
+
away, is lowered toward 48,000 pixels but never below half a pixel per CSS pixel (so a very
|
|
122
|
+
large layer can still exceed that). `computeCrystalField` now accepts a `dpr` from 0.5. The
|
|
123
|
+
whole-surface field computes its per-column terms once, with the same output. Sample positions use
|
|
124
|
+
the effective ratio after rounding the map size, so a fractional size no longer drifts.
|
|
125
|
+
- **Lens work is spread over frames.** The per-frame pass that installs and resizes lenses stops
|
|
126
|
+
after about 12 ms and leaves the rest for the next frame, so several lenses built at once no
|
|
127
|
+
longer land in one task. A single lens build still runs whole (the budget is checked between
|
|
128
|
+
tasks, not inside one), the leftover tasks run first in the next pass so one slow task cannot
|
|
129
|
+
starve the others, and a lens that is undone drops its pending work.
|
|
130
|
+
- **A crystal lens no longer drops while an ancestor changes.** `<LiquidGlass />` read the crystal
|
|
131
|
+
surface (whose backdrop filter moves to its own layer) as not painting one, so any class, style or
|
|
132
|
+
`data-*` change above it, such as dragging, released and rebuilt the lens. The lens is kept only
|
|
133
|
+
while the surface itself still resolves to a backdrop filter, so a crystal surface whose own
|
|
134
|
+
liquid class stops applying (`data-[state=open]:liquid` closing) under a lensed ancestor releases.
|
|
135
|
+
|
|
136
|
+
### Liquid Glass is opt-in (breaking for the 0.3.0 previews)
|
|
137
|
+
|
|
138
|
+
Liquid Glass now costs nothing until an app asks for it. This replaces the material objects and
|
|
139
|
+
the per-component lens of the earlier 0.3.0 previews, which were never published (0.2.x users have
|
|
140
|
+
nothing to change).
|
|
141
|
+
|
|
142
|
+
- **Non-liquid components carry no liquid code.** Card, Dialog, Drawer, Popover, DropdownMenu,
|
|
143
|
+
ContextMenu, HoverCard, Topbar, Sidebar, ActionBar and CommandPalette are back to plain class
|
|
144
|
+
names: no lens hook, no option mapping, no glass-card detection, no ref composition, and no
|
|
145
|
+
chunk they could fetch later. `check:treeshake` asserts that no chunk of the `atoms`, `ai`,
|
|
146
|
+
`containers`, `forms`, `navigation`, `overlays`, `palette`, `primitives`, `shell` and `utils`
|
|
147
|
+
entries, eager or lazy, holds a glass module, so a page without Liquid Glass cannot fetch one at
|
|
148
|
+
run time. Sizes match the build before Liquid Glass (#35) within 15 bytes gzip (`shell` 10057 B, `overlays` 27125 B,
|
|
149
|
+
`containers` 89025 B, `utils` 7678 B).
|
|
150
|
+
- **New `@jcsoftdev/ui/liquid` entry** for the declarative API: `<LiquidGlass />`,
|
|
151
|
+
`startLiquidGlass()`, `liquidStyle()`, `liquidVars()`, `mergeLiquid()`, `LIQUID_DEFAULTS`,
|
|
152
|
+
`LIQUID_PRESETS`, `LIQUID_PRESET_CLEAR`, `LIQUID_PRESET_REGULAR`, `LIQUID_PRESET_THICK`,
|
|
153
|
+
`LIQUID_PRESET_CRYSTAL`, `supportsBackdropRefraction()` and the option types. It holds no static
|
|
154
|
+
import of the lens engine, so even a bundler that splits by file (esbuild) keeps the engine out
|
|
155
|
+
of the first load. `@jcsoftdev/ui/glass` keeps the imperative engine and the map builders.
|
|
156
|
+
- **`<LiquidGlass />`** (or `startLiquidGlass()`, which returns its stop; calls are counted) is the
|
|
157
|
+
only thing that loads the lens. Render it once near the root. It watches the document (classes,
|
|
158
|
+
`data-glass`, `data-glass-lens`, `data-style`, `data-theme`, added and removed nodes, and the
|
|
159
|
+
transparency, contrast and motion preferences) and gives the lens to every surface whose CSS
|
|
160
|
+
resolves to `--glass-lens: 1` with a backdrop filter (computed, so `md:liquid`, `dark:liquid`,
|
|
161
|
+
`data-[state=open]:liquid`, `aria-*` and `group-*` variants, container queries and an inline
|
|
162
|
+
`--glass-lens` count; pseudo-class variants such as `hover:liquid` are not followed; a custom
|
|
163
|
+
`@apply liquid` class needs `data-glass-lens="on"`),
|
|
164
|
+
fetching the engine the first time one does and retrying a failed fetch with a backoff (six attempts at most). It does
|
|
165
|
+
nothing on the server and nothing where the lens cannot paint (Safari, Firefox).
|
|
166
|
+
- **A lens applied by code and the watcher share an element safely.** Each element's lens keeps one
|
|
167
|
+
claim per owner: `applyGlassRefraction` / `useGlassRefraction` options win over the automatic
|
|
168
|
+
ones, the watcher never stops a manual lens, and after the manual cleanup the automatic lens takes
|
|
169
|
+
over again. A release left over from an ended claim is a no-op.
|
|
170
|
+
- **Lens slots go to surfaces that can show one.** Hidden (`display: none`), zero-area and
|
|
171
|
+
far-offscreen surfaces take none of the 8 slots, and are lensed once they show.
|
|
172
|
+
- **Options are `style={liquidStyle(options)}`**: synchronous custom properties, so the server
|
|
173
|
+
markup and the first client paint are already right, nothing changes at hydration, and no option
|
|
174
|
+
can go stale after it.
|
|
175
|
+
- The engine is split along its features: the crystal layer (`lens-crystal`, with `crystal-map`)
|
|
176
|
+
and the dispersion passes (`lens-dispersion`) are lazy chunks fetched only for a surface that
|
|
177
|
+
uses them. The specular and crystal map builders moved out of `displacement-map` into
|
|
178
|
+
`specular-map` and `crystal-map` (same exports from `@jcsoftdev/ui/glass`). The specular layer
|
|
179
|
+
and the motion stay in the engine chunk: every lensed surface uses both on its first frame.
|
|
180
|
+
- Topbar, Sidebar and CommandPalette accept `style` on their root.
|
|
181
|
+
- `check:size` measures the liquid tiers (Topbar alone, plus `liquidStyle`, plus `<LiquidGlass />`,
|
|
182
|
+
plus the lazy engine, plus the crystal and dispersion chunks).
|
|
183
|
+
|
|
184
|
+
### Migration
|
|
185
|
+
|
|
186
|
+
From the 0.3.0 previews (`main` before this change):
|
|
187
|
+
|
|
188
|
+
- `material={{ type: "liquid", ...options }}` becomes
|
|
189
|
+
`material="liquid" style={liquidStyle(options)}` (`"liquid-clear"` the same way). `material` only
|
|
190
|
+
takes `"solid" | "glass" | "glass-clear" | "liquid" | "liquid-clear"`.
|
|
191
|
+
- `material={{ type: "liquid", preset: "thick", radius: 24 }}` becomes
|
|
192
|
+
`material="liquid" style={liquidStyle(mergeLiquid(LIQUID_PRESET_THICK, { radius: 24 }))}`.
|
|
193
|
+
- The lens no longer turns on by itself: render `<LiquidGlass />` once (from
|
|
194
|
+
`@jcsoftdev/ui/liquid`) in an app that wants it. Without it, liquid surfaces keep the CSS look.
|
|
195
|
+
- `useGlassLens(ref?)` is removed. Drop the ref: with `<LiquidGlass />` mounted, any element with
|
|
196
|
+
the `liquid` or `liquid-clear` class (or a glass surface under `data-glass="liquid"`) is lensed.
|
|
197
|
+
`applyGlassRefraction()` and `useGlassRefraction()` remain for manual control.
|
|
198
|
+
- `materialStyle()`, `withMaterialStyle()`, `MaterialName`, `LiquidMaterial` and
|
|
199
|
+
`liquidOptionsOf()` are removed. `@jcsoftdev/ui/utils` exports `Material` (now a string union)
|
|
200
|
+
and `materialClass()` only.
|
|
201
|
+
- Import `LiquidGlass` and `startLiquidGlass` from `@jcsoftdev/ui/liquid`; the options, presets
|
|
202
|
+
and `liquidStyle` are exported from both `@jcsoftdev/ui/liquid` and `@jcsoftdev/ui/glass`.
|
|
203
|
+
- The automatic lens reads the pointer mode (`interactive`) only from the surface itself, on every
|
|
204
|
+
surface (before, only the overlays did).
|
|
205
|
+
- A surface that leaves the page releases its lens when the DOM mutation is observed (a microtask later), not synchronously.
|
|
206
|
+
|
|
207
|
+
From 0.2.x: nothing changes unless you adopt Liquid Glass.
|
|
208
|
+
|
|
209
|
+
### Security
|
|
210
|
+
|
|
211
|
+
- **RichTextEditor sanitizer: `javascript:` href bypass via Unicode whitespace.** The URL check ignored only ASCII and a few invisible characters, while the emitted `href` was `decodeEntities(href).trim()`, and `trim()` also strips U+00A0, U+1680, U+2000-200A, U+202F, U+205F and U+3000. A link such as `<a href=" javascript:alert(1)">` passed the check and was emitted as `href="javascript:alert(1)"` (stored XSS for apps that render sanitized HTML as markup); the output was not idempotent. The href is now normalized once, that exact string is validated (all whitespace and format characters ignored, then a protocol allowlist through `new URL`), and the same string is emitted. Anyone using `sanitizeHtml` or `isSafeUrl` should upgrade; stored content is re-sanitized on the next pass.
|
|
212
|
+
- **Markdown parser (low): bounded nesting and link scan.** Blockquote and list nesting is capped at 32 levels (deeper levels render as literal text), which removes a stack overflow on `>` x 20000 and a multi-second parse on deeply nested lists, and the link-target scan is bounded so `[](` repeated thousands of times is no longer quadratic.
|
|
213
|
+
|
|
214
|
+
### App-level building blocks
|
|
215
|
+
|
|
216
|
+
- **Tone palettes.** `tonePalettes` in a token file (optional) emits `--tone-<name>`, `--tone-<name>-soft` and `--tone-<name>-ink` for light and dark, plus `--color-tone-*` in `theme.css`. Names are kebab-case; `fill` and `soft` are required, `ink` falls back to `fill`. `buildTheme`, `buildTokensCss`, `buildThemeCss` and `ui-theme build` all honour it; files without the section build byte-identically.
|
|
217
|
+
- **Open `tone`.** `Chip`, `StatusDot`, `Kpi` and `Avatar` accept any tone name besides the built-in ones (`ChipTone`, `StatusDotTone`, `KpiTone`, `AvatarTone` are the built-in union plus `string & {}`; `ChipBuiltinTone` and friends keep the closed unions). Unknown names resolve through `--tone-<name>` variables set inline, so no class needs generating.
|
|
218
|
+
- **Kpi**: `tone`, `dot`, `icon`, `trend`. **KpiGroup**: `layout="auto-fit"` with `minItemWidth` (default 150) for separate cards in as many columns as fit.
|
|
219
|
+
- **Avatar**: `tone`, and `status` + `statusLabel` for a small status dot at the bottom-right.
|
|
220
|
+
- **EmptyState / ErrorState**: `variant="outlined"` (dashed border / danger border).
|
|
221
|
+
- **PageHeader**: `compact` (centred, tighter, body-size lede) and `breadcrumbs` (trail on its own row above the title).
|
|
222
|
+
- **Topbar**: `onSearch`, `searchLabel`, `searchPlaceholder`, `breadcrumbs` and `breadcrumbsLabel` are optional; missing parts render nothing (and Cmd/Ctrl+K is only bound with `onSearch`).
|
|
223
|
+
- **CardHeader**: `icon`, `title` and `action` slots; children still render as before.
|
|
224
|
+
- **Segmented**: `options` (`{ value, label, disabled? }[]`), `block` (full width, control-height items) and `allowDeselect` (default `false`: the pressed item stays selected; `true` lets a second press clear it).
|
|
225
|
+
- **Button**: while `loading` without a `loadingLabel`, the children stay and the UI string `loading` is announced.
|
|
226
|
+
- **CopyField**: label, monospace read-only value and a copy button with a 1.5 s copied state and a live region; strings `copy` and `copied` join the UI strings (`en`, `es`).
|
|
227
|
+
- **Layout**: `Page`, `Stack` and `Grid` (`@jcsoftdev/ui/containers/page`, `/stack`, `/grid`). `Page` is the `page` container, so `Cols` and `SettingsLayout` inside it react to the page width. `Grid` is intrinsic by default (`minColumnWidth`) or fixed with `columns`; `Stack` takes `direction`, `gap` and `align`.
|
|
228
|
+
- **Forms**: `Form`, `FormError` (`role="alert"`) and `FormStatus` (`role="status"`) in `@jcsoftdev/ui/forms/form`; the two messages render nothing for `null`, `undefined` or an empty `message`.
|
|
229
|
+
- **`Breadcrumbs`** (`@jcsoftdev/ui/navigation/breadcrumbs`): a named `nav` with an ordered list, `aria-current="page"` on the last item and a `renderLink` hook.
|
|
230
|
+
- **`LiveStatusBar`** (`@jcsoftdev/ui/states/live-status-bar`): `live`, `reconnecting` and `offline` states as a polite `role="status"` with a dot and localized text.
|
|
231
|
+
- **`BottomNav`** (`@jcsoftdev/ui/shell/bottom-nav`): phone navigation bar for `Sidebar` items; the items past the fifth slot go behind a "More" button that opens a drawer. It hides itself once the `AppShell` is 900 px wide.
|
|
232
|
+
- New localized strings: `breadcrumbs`, `live`, `reconnecting`, `offline`, `more`.
|
|
233
|
+
|
|
234
|
+
### Chart gaps
|
|
235
|
+
|
|
236
|
+
- **Cartesian charts** (`BarChart`, `AreaChart`, `LineChart`, `ComboChart`): `tooltipRows({ index, category, rows })` returns `{ title?, rows?, footer? }` to replace parts of the tooltip (the default is unchanged when absent; the hidden data table is untouched); `categoryTickEvery` (a step or `(index, label) => boolean`) overrides the automatic thinning of the category labels; `markers` also takes an array of indices of `categories` to dot only those points.
|
|
237
|
+
- **`ValueAxisOptions.min` / `max`** accept a function of the data bound, e.g. `max: (dataMax) => Math.ceil(dataMax / 400) * 400`. `resolveAxisBound` and `AxisBound` are exported from `core/types`; the horizontal bar, lollipop, dumbbell, range area and waterfall axes honour it too.
|
|
238
|
+
- **`HeatmapChart`**: `cellDetail(row, column, value)` returns extra `TooltipRow`s under the cell value; `ChartTooltip` gained a `footer` slot.
|
|
239
|
+
- **`DonutChart`**: `sliceLabels` (`true`, `"percent"` or `"value"`) draws the share or the formatted value inside the ring and skips slices too small to hold it; it combines with `outsideLabels`.
|
|
240
|
+
|
|
241
|
+
### Behavior change
|
|
242
|
+
|
|
243
|
+
- **`Segmented` keeps the selected item selected.** Pressing the selected `SegmentedItem` again used to clear the selection (value `""`); a single-select group now stays on it. `Segmented` takes `allowDeselect` (default `false`) to keep the old behavior.
|
|
4
244
|
|
|
5
245
|
### Fixes
|
|
6
246
|
|
|
247
|
+
- **PolarAreaChart hover no longer flickers.** The hovered sector steps out by 6px and was also the pointer target, so a still pointer near its inner edge fell outside the moved sector: hover, tooltip and dimming toggled about 25 times a second. Pointer events now go to invisible sectors at rest, with no gap between neighbours and covering the stepped-out area, as in DonutChart since 0.2.1. The tooltip stays inside the chart vertically too.
|
|
248
|
+
- **DonutChart, PieChart and PolarAreaChart keep a tapped slice.** On touch and pen, lifting the finger fires `pointerleave`, which dropped the slice right after the tap: tooltip, centre value and dimming flashed for a frame and vanished. A tap now pins the slice until the next tap on another slice or outside the chart; the mouse still drops the hover when it leaves. `useIndexNavigation` returns `pointerLeave` for this.
|
|
249
|
+
- **Chart tooltips stop swapping sides under the pointer.** On pointer-following tooltips (Sankey, Chord, Treemap, Icicle, Sunburst, Radar, horizontal Bar and Funnel, Scatter, ...) a 1-2px move across 60% of the width swapped the card from one side of the pointer to the other, and the 100ms transform transition animated the swap across the cursor. The side now has a dead zone (right of the pointer until 65% of the width, left of it until 55%, or until the card would overflow) and a swap jumps instead of sliding.
|
|
250
|
+
- **Waffle, Parliament and Pictogram keep the category over the gaps between its units** instead of hiding the tooltip until the pointer reaches the next unit; Treemap and Icicle snap to the nearest cell across the 1-6px gutters, and Sankey, Chord, RadialBar and every `useIndexNavigation` chart wait 60ms before clearing, so crossing a gutter goes from one mark to the next without an empty frame.
|
|
251
|
+
- **Charts react to taps on touch screens.** `ChartFrame` now owns touch selection for every chart: a tap pins the mark's (or category's) details, tapping it again, tapping outside or pressing Escape unpins, tapping another mark moves the pin, and a swipe or scroll (more than 10px) never selects. Lifting a finger no longer counts as leaving, and a tap snaps to the nearest mark within 44px. Cartesian charts (Bar, Line, Area, Combo, ChartGrid) pin the tapped category instead of ignoring the tap and picking the first one on focus; focusing a chart by pointer no longer selects the first item (only the keyboard does).
|
|
252
|
+
- **Chart details dock on phones.** `ChartTooltip` gets `dock="auto" | "always" | "never"` (default `auto`). `auto` docks the details in a full-width panel under the plot, in normal flow, based on the device: a coarse primary pointer or a viewport 480px wide or less. A narrow card on a desktop with a mouse keeps the floating card and reserves nothing. The panel reserves a fixed 160px (it scrolls past that) through CSS, so the reservation also holds on the server render and only exists while docking applies; its rows are at least 44px tall. A separate polite live region announces the pinned or keyboard-selected category, debounced and never for mouse hover. `ChartFrame` takes `dock` too, and `BarChart`, `LineChart`, `AreaChart`, `ComboChart` and `ChartGrid` forward it. Charts with `tooltip={false}` reserve nothing.
|
|
253
|
+
- **`AppShell` no longer re-renders the page during hydration.** Its context value changed in the first layout effect after hydration, which made Next.js client-render still-dehydrated Suspense boundaries (a hidden `div#S:0` stayed in the page). The value is now a store that never changes identity and reads `false` on the server and on the first client render; only `useAppShell` consumers update, once the width is measured.
|
|
254
|
+
- **`OfflineBanner` takes an `action`** (for example a retry button) after the queue counter.
|
|
255
|
+
- **`Checkbox` takes a `label`**: it renders a `<label>` bound to the box, so it names the checkbox and a click on it toggles. New `wrapper` and `label` parts.
|
|
7
256
|
- **Checkbox looks like a checkbox.** The box is square (`rounded-xs`, the 4px small-radius token, 3px in the compact theme) instead of a circle, and the checked and indeterminate fill is the accent (as in Switch and the selected RadioGroup row) instead of the success green. Round plus green read as a radio button in multi-select lists. Sizes, 44px touch hit area, focus ring, disabled state and the `box`/`indicator`/`icon` parts are unchanged; The indeterminate state draws a dash instead of a check mark, and a disabled checkbox is dimmed (`opacity-50`, `cursor-not-allowed`) like the other form controls. RadioGroup stays round.
|
|
8
257
|
|
|
9
|
-
|
|
258
|
+
### Theme builder
|
|
10
259
|
|
|
11
|
-
|
|
260
|
+
- **`@jcsoftdev/ui/theme-builder` stays available.** The subpath published in 0.2.2 (`buildTheme`, `buildTokensCss`, `buildThemeCss`, `buildFontsCss`, `buildThemeKt`; `buildTheme(tokens, { kotlin: false })`) is re-exported from `@jcsoftdev/ui-tokens` and shipped inside this package, so 0.2.2 consumers upgrade unchanged and nothing extra is installed.
|
|
261
|
+
|
|
262
|
+
### Crystal lens
|
|
263
|
+
|
|
264
|
+
- **`profile: "crystal"`** and the `crystal` preset (`data-glass="liquid-crystal"`): a thick, fully clear convex lens that minifies the backdrop, bends it hard towards the rim, splits colour at the edge and has no frost, veil or tint. `refraction` accepts 0 to 2 for it (defaults and the other profiles are unchanged; above 1 they behave as 1). The minifying map cannot fold; the filter runs on a layer that extends past the surface and is clipped to it. No contrast guarantee.
|
|
12
265
|
|
|
13
|
-
|
|
266
|
+
### Configurable Liquid Glass and liquid motion
|
|
14
267
|
|
|
15
|
-
|
|
268
|
+
- **`LiquidGlassOptions`**: `style={liquidStyle(options)}` on any liquid surface. Options: `refraction`,
|
|
269
|
+
`bevelWidth`, `profile` (`"full"`, `"dome"`, `"rim"`), `dispersion`, `frost`, `saturation`,
|
|
270
|
+
`brightness`, `tint`, `rim`, `specular`, `fresnel`, `grain`, `radius`, `opacity`, `shadow`,
|
|
271
|
+
`interactive`, `motion`. Each maps to a `--liquid-*` custom property that the CSS and the lens
|
|
272
|
+
read, so a scope or the theme can set them and a change applies live. Exported from
|
|
273
|
+
`@jcsoftdev/ui/liquid` with `LIQUID_DEFAULTS`, `LIQUID_PRESETS`, `liquidStyle` and `liquidVars`.
|
|
274
|
+
- **`data-glass` presets**: `liquid-clear`, `liquid-regular` and `liquid-thick` (in `base.css`).
|
|
275
|
+
The global switch is now `[data-glass^="liquid"]`.
|
|
276
|
+
- **Optics**: the `dome` profile (round contours), a size-scaled outer shadow, fresnel glow, film
|
|
277
|
+
grain, and a specular glint that follows `specular.angle`. Defaults are unchanged.
|
|
278
|
+
- **Motion**: an in-house spring and one rAF loop: the lens materialises by spring, a press deepens
|
|
279
|
+
it, swells the surface and lights a touch glow that follows the pointer (the rim light turns
|
|
280
|
+
towards it), and `interactive: "drag"` pulls the surface through a rubber band with a velocity
|
|
281
|
+
squash (mismatched X/Y springs) and a jelly settle. Off under `prefers-reduced-motion` and with
|
|
282
|
+
`motion: false`.
|
|
283
|
+
- New tokens: `liquid-rim-lit`, `liquid-rim-back`, `liquid-rim-ring`, `liquid-shadow-ink`,
|
|
284
|
+
`liquid-shadow-alpha`, `liquid-shadow-drop`, `liquid-shadow-blur`, `liquid-shadow-contact` (the
|
|
285
|
+
engine's size-scaled shadow now follows the theme in light and dark). The liquid utilities compose their backdrop filter from the blur and
|
|
286
|
+
saturate tokens and the per-surface options; overriding `--liquid-regular-filter` alone no longer
|
|
287
|
+
changes anything.
|
|
288
|
+
- A lower `opacity`, a `tint` or `grain` void the contrast guarantee of the defaults.
|
|
289
|
+
- Fix: a removed element released its lens only after the rebuild throttle; it is now immediate.
|
|
290
|
+
- Motion hardening: the motion is written to `translate`/`scale` composed with the author's own
|
|
291
|
+
(an author `transform` is untouched; inline values are restored at rest, nothing is pinned); a
|
|
292
|
+
drag ignores presses on buttons, links and fields inside the surface, captures the pointer only
|
|
293
|
+
after 6 px, and swallows just its own gesture's click (within ~350 ms); no style reads per frame
|
|
294
|
+
and no config refresh from the motion's own writes; `--liquid-motion` and `--liquid-interactive`
|
|
295
|
+
are live; a moved surface follows its new ancestors.
|
|
16
296
|
|
|
17
|
-
|
|
297
|
+
### Liquid variant of the glass (lensing)
|
|
18
298
|
|
|
19
|
-
|
|
299
|
+
Frosted glass is unchanged; Apple-style Liquid Glass is a second look next to it.
|
|
300
|
+
|
|
301
|
+
- **`liquid` and `liquid-clear` utilities and `material="liquid" | "liquid-clear"`**: thin blur, higher
|
|
302
|
+
saturation, specular rim (lit top-left edge and a fainter opposite one), inner highlight, edge
|
|
303
|
+
glow and lower inner shadow for thickness, press flex on interactive surfaces (brightens and
|
|
304
|
+
scales; no transition under reduced motion; `backdrop-filter` is never animated). `glass` and
|
|
305
|
+
`glass-clear` render exactly as in 0.2 (a golden test pins their CSS).
|
|
306
|
+
- **Global switch**: `data-glass="liquid"` on `<html>` or any scope makes `glass`, `glass-clear` and
|
|
307
|
+
the glass-preset chrome surfaces render liquid. Content (`surface-card`) stays solid.
|
|
308
|
+
- **Lens for liquid surfaces in Chromium** once `<LiquidGlass />` is mounted (see above). The displacement map is rasterised from a
|
|
309
|
+
rounded-rect signed distance field with a Snell's-law squircle profile, DPR aware; chromatic
|
|
310
|
+
dispersion on surfaces up to 100,000 px squared; the blur and legibility veil move into the
|
|
311
|
+
filter so the rim stays sharp while the middle stays frosted. Budgets: 8 lenses, 640,000 px
|
|
312
|
+
squared, rebuilds throttled, one coalesced pass per frame. Opt out with `data-glass-lens="off"`
|
|
313
|
+
(element or ancestor) or `--glass-lens: 0`. Other engines get the base liquid look.
|
|
314
|
+
- **Closer to Apple** (liquid only): refraction only across a bevel as wide as the corner radius
|
|
315
|
+
(centre shows the backdrop undisplaced), strength equal to the bevel width, blur 4px / 1.5px,
|
|
316
|
+
saturation 1.5, thinner veil (regular .6 light / .54 dark, clear .47 / .38) with a text halo
|
|
317
|
+
(`--liquid-halo`), a directional specular layer in the filter (glint tinted by the backdrop,
|
|
318
|
+
dark contour, faint inner shadow, second `feImage`), dispersion 0.05, a materialise ramp and a
|
|
319
|
+
press lift on the refraction, and a `--liquid-shadow` token. Liquid contrast floors are now
|
|
320
|
+
documented per variant (regular 4.5 / 3.5, clear 4.5 / 2).
|
|
321
|
+
- **Full-surface lens** (liquid): the lens now bends the whole surface (smooth dome, strongest at the
|
|
322
|
+
rim, 24 px cap) instead of a bevel only; `coverage: "rim"` / `--glass-lens-coverage: rim` keeps the
|
|
323
|
+
old extent. The serrated edge of the first lenses was a fold-over of the displacement (offset
|
|
324
|
+
falling faster than 1 px per px); both profiles are now fold-free, with a regression test. The
|
|
325
|
+
veil moved fully into the filter and is adaptive (only where the backdrop is close to the ink), the
|
|
326
|
+
tint is dropped while the lens is on, blur is 2 px / 0.6 px, the rim glint is brighter and wider,
|
|
327
|
+
and dispersion is off by default (`--glass-lens-dispersion` or the option turns it on).
|
|
328
|
+
- The full-surface lens is a crease-free superellipse dome (pull along the gradient of `r = (|u|^3 + |v|^3)^(1/3)`), not a per-axis or edge-distance field, so it no longer reads as a four-faced diamond; tests check direction continuity across the diagonals and a positive 2D Jacobian.
|
|
329
|
+
- **Fixes**: `Card` stays a server component; the lens follows class, `data-glass`, opt-out and
|
|
330
|
+
preference changes at runtime; area and dispersion budgets are enforced on every resize;
|
|
331
|
+
surfaces waiting for one of the 8 slots get one when it frees. New `check:rsc` script.
|
|
332
|
+
- `@jcsoftdev/ui/glass`: new `computeDisplacementField`, `lensProfile`;
|
|
333
|
+
`createDisplacementMap` now returns a PNG data URI (browser only); `applyGlassRefraction` gains
|
|
334
|
+
`dispersion`, `veil` and `auto`, and moves the blur into the filter. The default `scale` is 20.
|
|
335
|
+
- New shared tokens `--liquid-*` (blur, saturate, filters, tints, dim, rim, depth).
|
|
336
|
+
- Material components and the `cn` merge group accept the new values. Card and ActionBar type
|
|
337
|
+
their `ref` prop (it reaches the root).
|
|
338
|
+
|
|
339
|
+
### Liquid Glass
|
|
340
|
+
|
|
341
|
+
Apple-style glass for the control and navigation layer, with content kept solid.
|
|
342
|
+
|
|
343
|
+
- **Glass material tokens in every preset**: `--glass-regular-*` and `--glass-clear-*` (`tint`,
|
|
344
|
+
`blur`, `saturate`, `filter`, `border`, `edge`, `shadow`, `dim`, `fallback`) plus
|
|
345
|
+
`--glass-sheen`, `--glass-noise` (off) and `--glass-nested-tint`. The `glass` preset now tunes
|
|
346
|
+
them. `Theme.kt` exports `UiGlass` / `GlassMaterial`.
|
|
347
|
+
- **`glass` and `glass-clear` utilities** with an opaque base and the blur behind
|
|
348
|
+
`@supports (backdrop-filter)`; `prefers-reduced-transparency`, `prefers-contrast: more` and
|
|
349
|
+
`forced-colors` fall back to a solid fill with a border. Glass nested in glass drops its blur.
|
|
350
|
+
Specular edge highlight and sheen are built in. Both variants carry a legibility veil (stronger
|
|
351
|
+
for clear) so `text-ink` and `text-ink-2` keep 4.5:1 over white, black, split and striped
|
|
352
|
+
backdrops in both themes; `text-ink-3` and tinted text are not covered.
|
|
353
|
+
- **`material` prop** (`"solid" | "glass" | "glass-clear"`) on Card, Dialog, Drawer, Popover,
|
|
354
|
+
DropdownMenu, ContextMenu, HoverCard, CommandPalette, ActionBar, Topbar and Sidebar; every other
|
|
355
|
+
surface opts in with `glass`, `glass-clear` or `surface-solid` in `className`. The `cn` merge
|
|
356
|
+
treats the surface utilities as one group (the last one wins).
|
|
357
|
+
- **New `surface-nav`, `surface-side` and `surface-solid` utilities**; Topbar and Sidebar are glass
|
|
358
|
+
in the `glass` preset and unchanged elsewhere.
|
|
359
|
+
- **Opt-in refraction** in the new `@jcsoftdev/ui/glass` entry: `useGlassRefraction`,
|
|
360
|
+
`applyGlassRefraction`, `supportsBackdropRefraction`, `createDisplacementMap`. Chromium only,
|
|
361
|
+
never on by default, skipped under reduced transparency, more contrast, forced colors and reduced
|
|
362
|
+
motion. No dependencies.
|
|
363
|
+
- New [Liquid Glass guide](https://ui.jcsoftdev.com/docs/glass), stories and real-browser tests
|
|
364
|
+
(`pnpm test:glass`) including measured text contrast over a worst-case backdrop.
|
|
365
|
+
|
|
366
|
+
### Platform
|
|
367
|
+
|
|
368
|
+
- **Tokens live in `@jcsoftdev/ui-tokens`.** `@jcsoftdev/ui` still ships the same `styles/*`,
|
|
369
|
+
`tokens/*` and `ui-theme` bin; they are synced from ui-tokens at build time.
|
|
370
|
+
- **The `ui-theme` bin is now a single bundled file** (it inlines the theme engine from ui-tokens);
|
|
371
|
+
invoke it exactly as before. It is no longer a thin script next to `scripts/build-theme.mjs`.
|
|
372
|
+
- **`ui-theme build` also writes `tailwind.css`** next to `tokens.css`, `theme.css` and `fonts.css`.
|
|
373
|
+
- **`ui-theme generate`** derives a WCAG AA color set from `--brand` (and optional `--accent`,
|
|
374
|
+
`--neutral`, `--danger`) and writes `tokens.json` plus the CSS outputs; a bad hex prints a clean
|
|
375
|
+
error and exits 1. The same engine is available as `createTheme`, `toCss` and `applyTheme` in
|
|
376
|
+
`@jcsoftdev/ui-tokens`.
|
|
20
377
|
|
|
21
378
|
### Fixes
|
|
22
379
|
|
|
380
|
+
- **`ui-theme build --no-kotlin` no longer builds Kotlin.** It used to generate `Theme.kt` and discard it, so `var(...)` and `oklch(...)` colors still threw "Unsupported color for Kotlin". Without the flag, the error now names the token and suggests `--no-kotlin`. The builders in `@jcsoftdev/ui-tokens/build` take `kotlin: false` and have typed `buildTokensCss`, `buildThemeCss`, `buildFontsCss` and `buildThemeKt`.
|
|
23
381
|
- **DonutChart / PieChart no longer flicker on hover.** The hovered slice steps out by `explode`
|
|
24
382
|
and was also the pointer target, so a still pointer near its edge ended up outside the moved
|
|
25
383
|
slice, the hover dropped, the slice slid back under the pointer and the loop repeated (tooltip,
|
|
@@ -28,6 +386,31 @@
|
|
|
28
386
|
- `ChartTooltip` takes an optional `containerHeight` and keeps the card inside it vertically
|
|
29
387
|
(DonutChart passes it), so a slice near the top no longer pushes the card past the chart edge.
|
|
30
388
|
|
|
389
|
+
### Migration notes
|
|
390
|
+
|
|
391
|
+
- **Cards no longer blur.** `surface-card` is now an opaque fill with no `backdrop-filter`, in every
|
|
392
|
+
preset. In the `glass` preset cards (`surface-card`, `surface-control`) are opaque instead of
|
|
393
|
+
translucent. To get the old look on one card use `material="glass"` (or `className="glass"`).
|
|
394
|
+
- `--surface-alpha` is now `1` in every preset and is only kept as an alias. `--surface-blur` and
|
|
395
|
+
`--surface-filter` still exist; in the `glass` preset they equal `--glass-regular-blur` and
|
|
396
|
+
`--glass-regular-filter`, and `--surface-overlay` equals `--glass-regular-tint`.
|
|
397
|
+
- Translucent `bg-surface-overlay` without a blur was replaced by the `surface-overlay` utility in
|
|
398
|
+
the map controls, attachment preview, emoji picker, source card and conversation button.
|
|
399
|
+
- `cn("surface-card", "surface-overlay")` now returns `surface-overlay`.
|
|
400
|
+
- A menu or popover portaled out of a glass dialog is not a DOM descendant, so it is not detected as
|
|
401
|
+
nested glass; pass `material="solid"` if you want it opaque.
|
|
402
|
+
- Non-glass presets are unchanged: overlays, the top bar and the sidebar keep their 0.2.0 fills in
|
|
403
|
+
every media mode (new `--surface-overlay-fallback`, `--surface-nav-fallback` and
|
|
404
|
+
`--surface-side-fallback` default to the surface's own token). In the `glass` preset, browsers
|
|
405
|
+
without `backdrop-filter` and users with reduced transparency or more contrast now get an opaque
|
|
406
|
+
overlay instead of a translucent one, plus a ring (more contrast) or outline (forced colors).
|
|
407
|
+
- In the `glass` preset `--shadow-card` changed (an inset highlight plus a large drop shadow became
|
|
408
|
+
a 1px ring plus a softer drop), and the overlay fill went from 82% `--float` to the regular
|
|
409
|
+
glass tint (72% white in light, 62% near-black in dark) plus the veil, which only the
|
|
410
|
+
`surface-overlay` / `surface-nav` / `surface-side` utilities paint: a bare `bg-surface-overlay`
|
|
411
|
+
is a translucent colour without blur or veil, use the utility.
|
|
412
|
+
- The unprefixed `glass` class can collide with an existing `.glass` in your CSS; see the guide.
|
|
413
|
+
|
|
31
414
|
## 0.2.0 (2026-10-11)
|
|
32
415
|
|
|
33
416
|
Zero runtime dependencies, a published headless layer, per-part customization and a configurable
|
package/README.md
CHANGED
|
@@ -24,6 +24,7 @@ Set these on `<html>` (or any element to restyle only its subtree); no rebuild i
|
|
|
24
24
|
| `data-style="<preset>"` | Style preset (radii, borders, shadows, glass, ...). See https://ui.jcsoftdev.com/docs/theming/. |
|
|
25
25
|
| `data-density="<level>"` | Control and spacing density: `compact`, `normal`, `comfortable`, `touch`. |
|
|
26
26
|
| `data-radius="<level>"` | Global corner radius scale. |
|
|
27
|
+
| `data-glass="liquid\|liquid-clear\|liquid-regular\|liquid-thick\|liquid-crystal"` | Switch glass surfaces to Liquid Glass (lensing, specular rim) with a preset. Configure one surface with `style={liquidStyle(options)}` and mount `<LiquidGlass />` once for the lens (both from `@jcsoftdev/ui/liquid`); see https://ui.jcsoftdev.com/docs/glass/. |
|
|
27
28
|
|
|
28
29
|
### Subpath exports
|
|
29
30
|
|
|
@@ -51,6 +52,8 @@ npx ui-theme build my-tokens.json --out src/theme # optional: your own look (d
|
|
|
51
52
|
@source "../node_modules/@jcsoftdev/ui/dist"; /* lets Tailwind see the classes used by the components */
|
|
52
53
|
```
|
|
53
54
|
|
|
55
|
+
Import order is free: `theme.css` declares nothing in Tailwind's `theme` layer that points back at itself (tokens such as `--radius-input` are mapped with `@theme reference inline`, so `rounded-input` reads the raw variable directly). `tokens.css` and `base.css` can sit unlayered, or in a layer of your own (`@import "…/tokens.css" layer(ui);`) declared before or after `theme`, with no `@layer` reordering and no re-declared names. Verified with Tailwind 4.3.3.
|
|
56
|
+
|
|
54
57
|
```tsx
|
|
55
58
|
import { Button } from "@jcsoftdev/ui/atoms/button";
|
|
56
59
|
<Button variant="primary">Save</Button>;
|
|
@@ -65,7 +68,7 @@ import { Button } from "@jcsoftdev/ui/atoms/button";
|
|
|
65
68
|
| `tokens.css` | CSS variables. Light by default, dark through `prefers-color-scheme` and the `[data-theme="dark"]` / `[data-theme="light"]` override, brand palettes through `[data-accent="<id>"]`. |
|
|
66
69
|
| `theme.css` | Tailwind v4 `@theme inline` mapping variables to utilities (`bg-surface`, `text-ink`, `rounded-card`, `shadow-flat`, `text-page-title`, `h-control-height`, ...). |
|
|
67
70
|
| `fonts.css` | Optional `@import` for the Google Fonts declared in the tokens. Skip it when the app loads fonts itself (for example `next/font`, then override `--font-sans`). |
|
|
68
|
-
| `Theme.kt` | Compose Multiplatform colors (per theme), palettes, shapes, sizes and text styles, so a Kotlin app shares the same tokens. |
|
|
71
|
+
| `Theme.kt` | Compose Multiplatform colors (per theme), palettes, shapes, sizes and text styles, so a Kotlin app shares the same tokens. Needs hex or `rgb(a)` colors: pass `--no-kotlin` to skip it when tokens use `var(...)` or `oklch(...)`. |
|
|
69
72
|
|
|
70
73
|
Without a tokens argument the bundled default (`tokens/default.json`) is used; its output is already shipped as
|
|
71
74
|
`@jcsoftdev/ui/styles/{tokens,theme,fonts}.css`.
|
|
@@ -146,9 +149,60 @@ older components already ship (NumberStepper, Carousel, AI set) are not routed t
|
|
|
146
149
|
| --- | --- |
|
|
147
150
|
| `Button` | `loadingLabel` (shown instead of the children while `loading`, announced through a status region), `block` (full width), `size="lg"` (52px at normal density, scaled like the other controls). |
|
|
148
151
|
| `Field` | `optional` appends the localized "(optional)" marker to the label; `error` also accepts `null`. |
|
|
149
|
-
| `Banner` | `title`; a default glyph per tone when `icon` is not passed (`icon={null}` hides it, so status never relies on color alone); only `danger` is `role="alert"`, the rest are `role="status"`; the `info` tone uses the `info` tokens. |
|
|
152
|
+
| `Banner` | `appearance="outline"` (page surface, only the border carries the tone; default `soft`), `title`; a default glyph per tone when `icon` is not passed (`icon={null}` hides it, so status never relies on color alone); only `danger` is `role="alert"`, the rest are `role="status"`; the `info` tone uses the `info` tokens. |
|
|
150
153
|
| `Chip` | `icon`, `statusIcon` (prefixes `info`, `success`, `warning`, `danger` chips with their glyph), and an `info` tone. |
|
|
151
|
-
| `ErrorState` | `title` and `description` (`message` keeps working as the headline)
|
|
154
|
+
| `ErrorState` | `title` and `description` (`message` keeps working as the headline), `actions`; an `Error` or any non-renderable value is never printed, a generic localized sentence is shown instead. |
|
|
155
|
+
|
|
156
|
+
## Blocks for application screens (additive)
|
|
157
|
+
|
|
158
|
+
New components, all zero-dependency, localized through `UiStringsProvider`, laid out with container
|
|
159
|
+
queries and sized for touch density. Props, accessibility notes and type-checked examples:
|
|
160
|
+
https://ui.jcsoftdev.com/docs/blocks/
|
|
161
|
+
|
|
162
|
+
| Component | Entry | What it is |
|
|
163
|
+
| --- | --- | --- |
|
|
164
|
+
| `Spinner`, `Kbd` | `atoms` | Loading ring (`size`, `label`, `label={false}` for decorative) and a styled `<kbd>`. |
|
|
165
|
+
| `IconButton` | `atoms` | Square `Button` with a required `label` (`aria-label`), `variant`, `size`, `loading`. |
|
|
166
|
+
| `DueChip` | `atoms` | Due-date chip: overdue, soon (`soonDays`) and ok states with a glyph and sr-only suffix; time-zone safe. |
|
|
167
|
+
| `Seal` | `atoms` | Stamp mark: `title`, `icon`, `tone`, optional named `label`. |
|
|
168
|
+
| `Tooltip` | `overlays` | Hover and focus tip: `content`, `shortcut`, `side`, `openDelay`, `closeDelay`; `role="tooltip"`. |
|
|
169
|
+
| `AlertDialog` | `overlays` | `role="alertdialog"` with cancel and confirm, `tone="danger"`, async `onConfirm` with a pending state. |
|
|
170
|
+
| `SelectMenu` | `forms` | Custom listbox select over `options` (groups, disabled options, typeahead, hidden `name` input). |
|
|
171
|
+
| `Combobox` | `forms` | Filterable, async-friendly (`onSearchChange`, `loading`), `clearable`, `emptyText`. |
|
|
172
|
+
| `DatePicker`, `DateTimePicker` | `forms` | Typed masked input plus calendar popover; ISO values, `min`, `max`, `isDateDisabled`, locale week start. |
|
|
173
|
+
| `DateCalendar` | `calendar` | Standalone keyboard date grid behind the pickers. |
|
|
174
|
+
| `ChipGroup` | `forms` | Multi or single toggle chips (`aria-pressed`, roving focus, `count`, `name`). |
|
|
175
|
+
| `Wizard` | `navigation` | `Stepper` plus Back/Next/Finish: `steps`, async `canAdvance`, `onBeforeNext`, `onComplete`. |
|
|
176
|
+
| `TabsNav`, `TabsNavLink` | `navigation` | Link-mode sub-navigation strip (`aria-current="page"`, `renderLink` or `asChild`). |
|
|
177
|
+
| `Section`, `Note`, `Aside` | `containers` | Titled block with `actions` and optional `divider`, a text note with a `tone`, and a complementary region. |
|
|
178
|
+
| `ListDetail` | `containers` | Master-detail that collapses to one pane under 641px of its own width. |
|
|
179
|
+
| `Feed`, `FeedEvent` | `containers` | Activity log with a mark, text and `<time>` (absolute or `relative`). |
|
|
180
|
+
| `Shortcuts`, `ShortcutsItem` | `containers` | Link or button tiles with `icon`, `count`, `kbd`. |
|
|
181
|
+
|
|
182
|
+
Additive props on existing components:
|
|
183
|
+
|
|
184
|
+
| Component | Added |
|
|
185
|
+
| --- | --- |
|
|
186
|
+
| `DescriptionList` | `layout` (`auto`, `inline`, `stacked`), `columns` (1 to 3), `valueAlign` (`end`, `start`); `DescriptionListItem` with a dash placeholder for empty values. |
|
|
187
|
+
| `Chip` | `size="sm"` (compact; a tag is `<Chip size="sm" square>`). |
|
|
188
|
+
| `Skeleton` | `variant` `list`, `kpis`, `key-value`, `bar` and `count`. |
|
|
189
|
+
| `ErrorState` | `actions` node, rendered in the same row as the retry button (the retry button now sits inside a wrapper `div`). |
|
|
190
|
+
| `RadioGroup` | Each radio is named by its label and described by its description. |
|
|
191
|
+
| `Checkbox`, `Switch` | The 44px touch target is an invisible `::after`; under touch density the layout box stays 40px. |
|
|
192
|
+
| `Table` | `flush` (`true`, `"start"`, `"end"`), `stickyHeader`, `maxHeight`, selection (`selectedKeys`, `defaultSelectedKeys`, `onSelectedKeysChange`, `rowKey`, `TableSelectCell`, `TableSelectAllCell`), `TableActionsCell` (wraps, or swaps for your overflow `menu`, under a narrow table container). |
|
|
193
|
+
| `Section` | Parts `Section.Header`, `.Title`, `.Count`, `.Description`, `.Actions`, `.Body` next to the props; a titleless wrapper takes no heading level. |
|
|
194
|
+
| `Kpi` | Parts `Kpi.Label`, `.Value` (`mono`, `suffix`, `trend`), `.Description`; `card` chrome; `trailing` slot. |
|
|
195
|
+
| `Timeline` | `status` per item (`done`, `current`, `error`, `pending`) and `Timeline.Item` children. |
|
|
196
|
+
| `Stepper` | `status` per step with a glyph and a spoken state. |
|
|
197
|
+
| `AlertDialog` | `confirmDisabled`, `cancelDisabled`; compound `AlertDialog.Root`, `.Trigger`, `.Content`, `.Title`, `.Description`, `.Cancel`, `.Action`. |
|
|
198
|
+
| `ListDetail` | `onBack` for the back action; `onValueChange` never receives `null`. |
|
|
199
|
+
| `DueChip` | `state` forces `overdue`, `soon`, `ok` or `done`. |
|
|
200
|
+
| `Seal` | `tone="institutional"` and any `tonePalettes` tone by name. |
|
|
201
|
+
| `DropdownMenu` | `DropdownMenuContent bare` (no panel look), `DropdownMenuAnchor`, `dropdownMenuItemClasses`, `dropdownMenuSurfaceClasses` for custom menus. |
|
|
202
|
+
| `toast` | `toast.info`, `toast.warning`, `toast.danger`; success, info, warning and error toasts are tinted with a glyph. |
|
|
203
|
+
|
|
204
|
+
In tests, reset the toast store with `import { resetToasts } from "@jcsoftdev/ui/overlays/testing"`
|
|
205
|
+
(kept off the `overlays` entry so production bundles never carry it).
|
|
152
206
|
|
|
153
207
|
## ConfirmAction and ResponsiveList
|
|
154
208
|
|