@jcsoftdev/ui 0.5.0 → 0.6.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 +337 -0
- package/README.md +25 -3
- package/bin/ui-theme.mjs +40 -6
- package/dist/ai/code-block/code-block.js +1 -1
- package/dist/atoms/big-date/big-date.js +2 -2
- package/dist/atoms/button/button.d.ts +6 -1
- package/dist/atoms/button/button.js +2 -2
- package/dist/atoms/chip/chip.d.ts +5 -0
- package/dist/atoms/chip/chip.js +3 -3
- package/dist/atoms/icon-button/icon-button.js +1 -1
- package/dist/atoms/internal/hit-area.d.ts +5 -4
- package/dist/atoms/internal/hit-area.js +1 -1
- package/dist/atoms/progress/index.d.ts +1 -1
- package/dist/atoms/progress/index.js +4 -1
- package/dist/atoms/progress/progress.d.ts +6 -1
- package/dist/atoms/progress/progress.js +19 -1
- package/dist/atoms/radio-group/radio-group.js +1 -1
- package/dist/atoms/status-pill/status-pill.d.ts +16 -5
- package/dist/atoms/status-pill/status-pill.js +43 -18
- package/dist/brand/logo-forge.js +1 -1
- package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
- package/dist/charts/chart-grid/chart-grid.js +2 -2
- package/dist/charts/chord-chart/chord-chart.js +1 -1
- package/dist/charts/core/axes.js +2 -2
- package/dist/charts/core/cartesian/annotations.js +2 -2
- package/dist/charts/core/cartesian/marks.js +1 -1
- package/dist/charts/core/distribution/marks.js +1 -1
- package/dist/charts/core/distribution/xy-points.js +1 -1
- package/dist/charts/core/export-menu.js +1 -1
- package/dist/charts/funnel-chart/funnel-chart.js +1 -1
- package/dist/charts/gantt-chart/gantt-chart.js +4 -4
- package/dist/charts/gantt-chart/gantt-marks.js +3 -3
- package/dist/charts/index.d.ts +2 -0
- package/dist/charts/index.js +2 -0
- package/dist/charts/maps/geo/map-data-table.js +1 -1
- package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
- package/dist/charts/radar-chart/radar-chart.js +1 -1
- package/dist/charts/stock-chart/stock-chart.js +1 -1
- package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
- package/dist/charts/stock-chart/stock-plot.js +2 -2
- package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
- package/dist/containers/chat-thread/chat-thread.js +219 -0
- package/dist/containers/chat-thread/format.d.ts +20 -0
- package/dist/containers/chat-thread/format.js +50 -0
- package/dist/containers/chat-thread/index.d.ts +1 -0
- package/dist/containers/chat-thread/index.js +8 -0
- package/dist/containers/cols/cols.d.ts +1 -1
- package/dist/containers/cols/cols.js +7 -0
- package/dist/containers/comment/comment.js +1 -1
- package/dist/containers/context-rail/context-rail.d.ts +62 -0
- package/dist/containers/context-rail/context-rail.js +175 -0
- package/dist/containers/context-rail/index.d.ts +1 -0
- package/dist/containers/context-rail/index.js +6 -0
- package/dist/containers/dashboard/dashboard.d.ts +40 -0
- package/dist/containers/dashboard/dashboard.js +84 -0
- package/dist/containers/dashboard/index.d.ts +1 -0
- package/dist/containers/dashboard/index.js +14 -0
- package/dist/containers/data-grid/data-grid.demos.js +4 -4
- package/dist/containers/data-grid/data-grid.js +6 -6
- package/dist/containers/data-grid/filter-builder-editor.js +2 -2
- package/dist/containers/data-grid/grid-toolbar.js +1 -1
- package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
- package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
- package/dist/containers/detail-header/detail-header.d.ts +24 -0
- package/dist/containers/detail-header/detail-header.js +32 -0
- package/dist/containers/detail-header/index.d.ts +1 -0
- package/dist/containers/detail-header/index.js +6 -0
- package/dist/containers/facts/facts.js +1 -1
- package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
- package/dist/containers/filter-bar/filter-bar.js +123 -0
- package/dist/containers/filter-bar/index.d.ts +1 -0
- package/dist/containers/filter-bar/index.js +6 -0
- package/dist/containers/hbars/hbars.js +2 -2
- package/dist/containers/index.d.ts +9 -0
- package/dist/containers/index.js +9 -0
- package/dist/containers/kanban/kanban.d.ts +23 -2
- package/dist/containers/kanban/kanban.js +101 -21
- package/dist/containers/kanban/model.d.ts +12 -0
- package/dist/containers/kanban/model.js +8 -0
- package/dist/containers/kpi/kpi.js +1 -1
- package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
- package/dist/containers/kpi-group/kpi-group.js +6 -2
- package/dist/containers/list-detail/index.d.ts +1 -1
- package/dist/containers/list-detail/index.js +4 -0
- package/dist/containers/list-detail/list-detail.d.ts +51 -3
- package/dist/containers/list-detail/list-detail.js +109 -15
- package/dist/containers/page/page.d.ts +17 -4
- package/dist/containers/page/page.js +33 -4
- package/dist/containers/page-header/back.d.ts +10 -0
- package/dist/containers/page-header/back.js +28 -0
- package/dist/containers/page-header/index.d.ts +1 -0
- package/dist/containers/page-header/index.js +1 -0
- package/dist/containers/page-header/page-header.d.ts +19 -2
- package/dist/containers/page-header/page-header.js +26 -2
- package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
- package/dist/containers/pagination/cursor-pagination.js +48 -0
- package/dist/containers/pagination/index.d.ts +3 -0
- package/dist/containers/pagination/index.js +10 -0
- package/dist/containers/pagination/pagination.d.ts +52 -0
- package/dist/containers/pagination/pagination.js +216 -0
- package/dist/containers/pagination/range.d.ts +29 -0
- package/dist/containers/pagination/range.js +42 -0
- package/dist/containers/pagination/use-pagination.d.ts +18 -0
- package/dist/containers/pagination/use-pagination.js +22 -0
- package/dist/containers/responsive-list/responsive-list.d.ts +28 -2
- package/dist/containers/responsive-list/responsive-list.js +134 -25
- package/dist/containers/row-actions/index.d.ts +1 -0
- package/dist/containers/row-actions/index.js +4 -0
- package/dist/containers/row-actions/row-actions.d.ts +26 -0
- package/dist/containers/row-actions/row-actions.js +78 -0
- package/dist/containers/selectable-card/index.d.ts +1 -0
- package/dist/containers/selectable-card/index.js +6 -0
- package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
- package/dist/containers/selectable-card/selectable-card.js +57 -0
- package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
- package/dist/containers/settings-layout/settings-layout.js +63 -8
- package/dist/containers/shortcuts/shortcuts.js +1 -1
- package/dist/containers/table/cell-padding.d.ts +2 -0
- package/dist/containers/table/cell-padding.js +4 -0
- package/dist/containers/table/index.d.ts +1 -0
- package/dist/containers/table/index.js +8 -0
- package/dist/containers/table/sort.d.ts +14 -0
- package/dist/containers/table/sort.js +11 -0
- package/dist/containers/table/table-parts.d.ts +24 -0
- package/dist/containers/table/table-parts.js +52 -0
- package/dist/containers/table/table.d.ts +37 -3
- package/dist/containers/table/table.js +120 -19
- package/dist/containers/table-columns-menu/index.d.ts +1 -0
- package/dist/containers/table-columns-menu/index.js +6 -0
- package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
- package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
- package/dist/dashboards/layout.d.ts +1 -27
- package/dist/dashboards/layout.js +8 -40
- package/dist/forms/chip-group/chip-group.d.ts +5 -0
- package/dist/forms/chip-group/chip-group.js +3 -1
- package/dist/forms/combobox/combobox.js +1 -1
- package/dist/forms/copy-field/copy-field.js +1 -1
- package/dist/forms/date-picker/date-picker.d.ts +3 -1
- package/dist/forms/date-picker/date-picker.js +4 -2
- package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
- package/dist/forms/date-picker/date-time-picker.js +13 -2
- package/dist/forms/field/field.d.ts +9 -2
- package/dist/forms/field/field.js +18 -4
- package/dist/forms/fieldset/fieldset.d.ts +11 -0
- package/dist/forms/fieldset/fieldset.js +12 -0
- package/dist/forms/fieldset/index.d.ts +1 -0
- package/dist/forms/fieldset/index.js +4 -0
- package/dist/forms/form-footer/form-footer.d.ts +26 -0
- package/dist/forms/form-footer/form-footer.js +44 -0
- package/dist/forms/form-footer/index.d.ts +1 -0
- package/dist/forms/form-footer/index.js +4 -0
- package/dist/forms/form-grid/form-grid.d.ts +21 -4
- package/dist/forms/form-grid/form-grid.js +20 -3
- package/dist/forms/form-grid/index.d.ts +1 -1
- package/dist/forms/form-grid/index.js +6 -2
- package/dist/forms/form-section/form-section.d.ts +12 -0
- package/dist/forms/form-section/form-section.js +30 -0
- package/dist/forms/form-section/index.d.ts +1 -0
- package/dist/forms/form-section/index.js +4 -0
- package/dist/forms/index.d.ts +3 -0
- package/dist/forms/index.js +3 -0
- package/dist/forms/input/input.d.ts +6 -2
- package/dist/forms/input/input.js +4 -1
- package/dist/forms/internal/listbox-items.d.ts +1 -1
- package/dist/forms/internal/listbox-items.js +3 -2
- package/dist/forms/native-select/native-select.js +1 -1
- package/dist/forms/select/index.d.ts +1 -1
- package/dist/forms/select/select.d.ts +5 -2
- package/dist/forms/select/select.js +7 -2
- package/dist/forms/select-menu/select-menu.js +1 -1
- package/dist/forms/time-input/time-input.d.ts +4 -2
- package/dist/forms/time-input/time-input.js +3 -1
- package/dist/i18n/strings.d.ts +86 -0
- package/dist/i18n/strings.js +46 -0
- package/dist/motion/count-up.d.ts +20 -0
- package/dist/motion/count-up.js +59 -0
- package/dist/motion/cross-fade.d.ts +21 -0
- package/dist/motion/cross-fade.js +86 -0
- package/dist/motion/index.d.ts +5 -0
- package/dist/motion/index.js +14 -0
- package/dist/motion/model.d.ts +15 -0
- package/dist/motion/model.js +68 -0
- package/dist/motion/motion-styles.d.ts +1 -0
- package/dist/motion/motion-styles.js +35 -0
- package/dist/motion/reveal.d.ts +37 -0
- package/dist/motion/reveal.js +69 -0
- package/dist/motion/use-enter-phase.d.ts +11 -0
- package/dist/motion/use-enter-phase.js +40 -0
- package/dist/motion/use-highlight-row.d.ts +22 -0
- package/dist/motion/use-highlight-row.js +38 -0
- package/dist/navigation/tabs/tabs.js +1 -1
- package/dist/navigation/wizard/wizard.d.ts +4 -1
- package/dist/navigation/wizard/wizard.js +3 -0
- package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
- package/dist/overlays/context-menu/context-menu.js +3 -1
- package/dist/overlays/dialog/dialog.js +10 -2
- package/dist/overlays/drawer/drawer.d.ts +18 -4
- package/dist/overlays/drawer/drawer.js +53 -4
- package/dist/overlays/drawer/index.d.ts +1 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
- package/dist/overlays/hover-card/hover-card.js +2 -0
- package/dist/overlays/popover/popover.js +2 -0
- package/dist/overlays/toaster/index.d.ts +1 -1
- package/dist/overlays/toaster/toaster.d.ts +28 -2
- package/dist/overlays/toaster/toaster.js +73 -29
- package/dist/overlays/tooltip/tooltip.js +2 -0
- package/dist/primitives/use-presence.js +9 -0
- package/dist/shell/app-shell/app-shell.d.ts +8 -1
- package/dist/shell/app-shell/app-shell.js +50 -3
- package/dist/shell/index.d.ts +1 -0
- package/dist/shell/index.js +1 -0
- package/dist/shell/sidebar/sidebar.d.ts +17 -1
- package/dist/shell/sidebar/sidebar.js +126 -76
- package/dist/shell/topbar/topbar.d.ts +4 -2
- package/dist/shell/topbar/topbar.js +2 -0
- package/dist/showcase/operations-bento.js +2 -2
- package/dist/states/empty-state/empty-state.d.ts +10 -3
- package/dist/states/empty-state/empty-state.js +46 -5
- package/dist/states/error-state/error-state.js +1 -1
- package/dist/states/skeleton/skeleton.js +1 -1
- package/dist/utils/class-tokens.generated.js +4 -6
- package/dist/utils/list-navigation.d.ts +14 -0
- package/dist/utils/list-navigation.js +44 -0
- package/dist/utils/overlay-motion.d.ts +12 -0
- package/dist/utils/overlay-motion.js +14 -0
- package/dist/utils/use-container-width.d.ts +6 -0
- package/dist/utils/use-container-width.js +19 -0
- package/package.json +2 -2
- package/scripts/build-theme.mjs +46 -5
- package/src/ai/code-block/code-block.tsx +1 -1
- package/src/atoms/big-date/big-date.tsx +2 -2
- package/src/atoms/button/button.tsx +8 -3
- package/src/atoms/chip/chip.tsx +8 -3
- package/src/atoms/icon-button/icon-button.tsx +1 -1
- package/src/atoms/internal/hit-area.ts +5 -4
- package/src/atoms/progress/index.ts +8 -1
- package/src/atoms/progress/progress.tsx +30 -1
- package/src/atoms/radio-group/radio-group.tsx +1 -1
- package/src/atoms/status-pill/status-pill.tsx +59 -18
- package/src/brand/logo-forge.tsx +1 -1
- package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
- package/src/charts/chart-grid/chart-grid.tsx +2 -2
- package/src/charts/chord-chart/chord-chart.tsx +1 -1
- package/src/charts/core/axes.tsx +2 -2
- package/src/charts/core/cartesian/annotations.tsx +2 -2
- package/src/charts/core/cartesian/marks.tsx +1 -1
- package/src/charts/core/distribution/marks.tsx +1 -1
- package/src/charts/core/distribution/xy-points.tsx +1 -1
- package/src/charts/core/export-menu.tsx +1 -1
- package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
- package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
- package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
- package/src/charts/index.ts +2 -0
- package/src/charts/maps/geo/map-data-table.tsx +1 -1
- package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
- package/src/charts/radar-chart/radar-chart.tsx +1 -1
- package/src/charts/stock-chart/stock-chart.tsx +1 -1
- package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
- package/src/charts/stock-chart/stock-plot.tsx +2 -2
- package/src/containers/chat-thread/chat-thread.tsx +331 -0
- package/src/containers/chat-thread/format.ts +67 -0
- package/src/containers/chat-thread/index.ts +12 -0
- package/src/containers/cols/cols.tsx +13 -1
- package/src/containers/comment/comment.tsx +1 -1
- package/src/containers/context-rail/context-rail.tsx +229 -0
- package/src/containers/context-rail/index.ts +7 -0
- package/src/containers/dashboard/dashboard.tsx +142 -0
- package/src/containers/dashboard/index.ts +12 -0
- package/src/containers/data-grid/data-grid.demos.tsx +4 -4
- package/src/containers/data-grid/data-grid.tsx +6 -6
- package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
- package/src/containers/data-grid/grid-toolbar.tsx +1 -1
- package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
- package/src/containers/detail-header/detail-header.tsx +64 -0
- package/src/containers/detail-header/index.ts +5 -0
- package/src/containers/facts/facts.tsx +1 -1
- package/src/containers/filter-bar/filter-bar.tsx +201 -0
- package/src/containers/filter-bar/index.ts +7 -0
- package/src/containers/hbars/hbars.tsx +2 -2
- package/src/containers/index.ts +9 -0
- package/src/containers/kanban/kanban.tsx +146 -39
- package/src/containers/kanban/model.ts +20 -0
- package/src/containers/kpi/kpi.tsx +1 -1
- package/src/containers/kpi-group/kpi-group.tsx +17 -2
- package/src/containers/list-detail/index.ts +5 -0
- package/src/containers/list-detail/list-detail.tsx +157 -9
- package/src/containers/page/page.tsx +61 -7
- package/src/containers/page-header/back.tsx +42 -0
- package/src/containers/page-header/index.ts +1 -0
- package/src/containers/page-header/page-header.tsx +49 -3
- package/src/containers/pagination/cursor-pagination.tsx +79 -0
- package/src/containers/pagination/index.ts +7 -0
- package/src/containers/pagination/pagination.tsx +266 -0
- package/src/containers/pagination/range.ts +68 -0
- package/src/containers/pagination/use-pagination.ts +44 -0
- package/src/containers/responsive-list/responsive-list.tsx +183 -46
- package/src/containers/row-actions/index.ts +1 -0
- package/src/containers/row-actions/row-actions.tsx +114 -0
- package/src/containers/selectable-card/index.ts +5 -0
- package/src/containers/selectable-card/selectable-card.tsx +84 -0
- package/src/containers/settings-layout/settings-layout.tsx +104 -13
- package/src/containers/shortcuts/shortcuts.tsx +1 -1
- package/src/containers/table/cell-padding.ts +2 -0
- package/src/containers/table/index.ts +6 -0
- package/src/containers/table/sort.ts +23 -0
- package/src/containers/table/table-parts.tsx +81 -0
- package/src/containers/table/table.tsx +212 -45
- package/src/containers/table-columns-menu/index.ts +5 -0
- package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
- package/src/dashboards/layout.tsx +8 -75
- package/src/forms/chip-group/chip-group.tsx +8 -1
- package/src/forms/combobox/combobox.tsx +1 -1
- package/src/forms/copy-field/copy-field.tsx +1 -1
- package/src/forms/date-picker/date-picker.tsx +7 -2
- package/src/forms/date-picker/date-time-picker.tsx +28 -2
- package/src/forms/field/field.tsx +30 -3
- package/src/forms/fieldset/fieldset.tsx +22 -0
- package/src/forms/fieldset/index.ts +1 -0
- package/src/forms/form-footer/form-footer.tsx +74 -0
- package/src/forms/form-footer/index.ts +1 -0
- package/src/forms/form-grid/form-grid.tsx +42 -5
- package/src/forms/form-grid/index.ts +8 -1
- package/src/forms/form-section/form-section.tsx +41 -0
- package/src/forms/form-section/index.ts +1 -0
- package/src/forms/index.ts +3 -0
- package/src/forms/input/input.tsx +10 -3
- package/src/forms/internal/listbox-items.tsx +3 -4
- package/src/forms/native-select/native-select.tsx +1 -1
- package/src/forms/select/index.ts +1 -1
- package/src/forms/select/select.tsx +14 -3
- package/src/forms/select-menu/select-menu.tsx +1 -1
- package/src/forms/time-input/time-input.tsx +6 -2
- package/src/i18n/strings.ts +86 -0
- package/src/motion/count-up.tsx +83 -0
- package/src/motion/cross-fade.tsx +139 -0
- package/src/motion/index.ts +5 -0
- package/src/motion/model.ts +86 -0
- package/src/motion/motion-styles.tsx +47 -0
- package/src/motion/reveal.tsx +115 -0
- package/src/motion/use-enter-phase.ts +50 -0
- package/src/motion/use-highlight-row.ts +63 -0
- package/src/navigation/tabs/tabs.tsx +1 -1
- package/src/navigation/wizard/wizard.tsx +6 -1
- package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
- package/src/overlays/context-menu/context-menu.tsx +3 -2
- package/src/overlays/dialog/dialog.tsx +7 -2
- package/src/overlays/drawer/drawer.tsx +68 -6
- package/src/overlays/drawer/index.ts +1 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
- package/src/overlays/hover-card/hover-card.tsx +2 -0
- package/src/overlays/popover/popover.tsx +2 -0
- package/src/overlays/toaster/index.ts +2 -0
- package/src/overlays/toaster/toaster.tsx +113 -17
- package/src/overlays/tooltip/tooltip.tsx +2 -0
- package/src/primitives/use-presence.ts +13 -0
- package/src/shell/app-shell/app-shell.tsx +54 -2
- package/src/shell/index.ts +1 -0
- package/src/shell/sidebar/sidebar.tsx +154 -75
- package/src/shell/topbar/topbar.tsx +8 -0
- package/src/showcase/operations-bento.tsx +2 -2
- package/src/states/empty-state/empty-state.tsx +52 -9
- package/src/states/error-state/error-state.tsx +1 -1
- package/src/states/skeleton/skeleton.tsx +1 -1
- package/src/utils/class-tokens.generated.ts +4 -6
- package/src/utils/list-navigation.ts +63 -0
- package/src/utils/overlay-motion.ts +33 -0
- package/src/utils/use-container-width.ts +24 -0
- package/styles/Theme.kt +15 -18
- package/styles/tailwind.css +29 -28
- package/styles/theme.css +29 -28
- package/styles/tokens.css +46 -0
- package/tokens/default.json +51 -29
package/src/i18n/strings.ts
CHANGED
|
@@ -3,6 +3,8 @@ export interface UiStrings {
|
|
|
3
3
|
close: string;
|
|
4
4
|
loading: string;
|
|
5
5
|
optional: string;
|
|
6
|
+
save: string;
|
|
7
|
+
unsavedChanges: string;
|
|
6
8
|
cancel: string;
|
|
7
9
|
confirm: string;
|
|
8
10
|
processing: string;
|
|
@@ -56,6 +58,44 @@ export interface UiStrings {
|
|
|
56
58
|
selectAll: string;
|
|
57
59
|
/** Name of the overflow menu trigger of a `TableActionsCell`. */
|
|
58
60
|
rowActions: string;
|
|
61
|
+
/** Default body of a `TableEmpty` row. */
|
|
62
|
+
tableEmpty: string;
|
|
63
|
+
/** Label of the `TableColumnsMenu` trigger and its group. */
|
|
64
|
+
columns: string;
|
|
65
|
+
/** Name of the `Pagination` landmark. */
|
|
66
|
+
pagination: string;
|
|
67
|
+
/** Label of the page size picker of a `Pagination`. */
|
|
68
|
+
rowsPerPage: string;
|
|
69
|
+
/** Range text of a `Pagination`; `{first}`, `{last}` and `{total}` are replaced. */
|
|
70
|
+
pageRange: string;
|
|
71
|
+
firstPage: string;
|
|
72
|
+
previousPage: string;
|
|
73
|
+
nextPage: string;
|
|
74
|
+
lastPage: string;
|
|
75
|
+
/** Range text of a `Pagination variant="pages"`; `{first}`, `{last}` and `{total}` are replaced. */
|
|
76
|
+
showingRange: string;
|
|
77
|
+
/** Range text of a `CursorPagination` (no known total); `{first}` and `{last}` are replaced. */
|
|
78
|
+
showingRangeOpen: string;
|
|
79
|
+
/** Visible label of the previous-page button of `Pagination variant="pages"` and `CursorPagination`. */
|
|
80
|
+
previous: string;
|
|
81
|
+
/** Name of a page number button; `{page}` is replaced. */
|
|
82
|
+
pageNumber: string;
|
|
83
|
+
/** Name of the search field of a `FilterBar`. */
|
|
84
|
+
search: string;
|
|
85
|
+
/** Label of the `FilterBar` button that opens every filter under a narrow container. */
|
|
86
|
+
filters: string;
|
|
87
|
+
/** Label of the `FilterBar` button that opens the extra filters. */
|
|
88
|
+
moreFilters: string;
|
|
89
|
+
/** Clears every active filter of a `FilterBar`. */
|
|
90
|
+
clearAllFilters: string;
|
|
91
|
+
/** Name of the remove button of an active filter chip; `{filter}` is replaced by its label. */
|
|
92
|
+
removeFilter: string;
|
|
93
|
+
/** Name of the list of active filter chips of a `FilterBar`. */
|
|
94
|
+
activeFilters: string;
|
|
95
|
+
/** Result count of a `FilterBar` for exactly one result. */
|
|
96
|
+
resultOne: string;
|
|
97
|
+
/** Result count of a `FilterBar`; `{count}` is replaced. */
|
|
98
|
+
resultMany: string;
|
|
59
99
|
/** Name of the `PasswordInput` toggle; its pressed state says whether the password is visible. */
|
|
60
100
|
showPassword: string;
|
|
61
101
|
/** Default title of a `LoginForm`. */
|
|
@@ -98,6 +138,8 @@ export const uiStrings = {
|
|
|
98
138
|
close: "Close",
|
|
99
139
|
loading: "Loading",
|
|
100
140
|
optional: "optional",
|
|
141
|
+
save: "Save",
|
|
142
|
+
unsavedChanges: "Unsaved changes",
|
|
101
143
|
cancel: "Cancel",
|
|
102
144
|
confirm: "Confirm",
|
|
103
145
|
processing: "Processing…",
|
|
@@ -140,6 +182,27 @@ export const uiStrings = {
|
|
|
140
182
|
selectRow: "Select {row}",
|
|
141
183
|
selectAll: "Select all rows",
|
|
142
184
|
rowActions: "Row actions",
|
|
185
|
+
tableEmpty: "No rows to show",
|
|
186
|
+
columns: "Columns",
|
|
187
|
+
pagination: "Pagination",
|
|
188
|
+
rowsPerPage: "Rows per page",
|
|
189
|
+
pageRange: "{first}–{last} of {total}",
|
|
190
|
+
firstPage: "First page",
|
|
191
|
+
previousPage: "Previous page",
|
|
192
|
+
nextPage: "Next page",
|
|
193
|
+
lastPage: "Last page",
|
|
194
|
+
showingRange: "Showing {first}–{last} of {total}",
|
|
195
|
+
showingRangeOpen: "Showing {first}–{last}",
|
|
196
|
+
previous: "Previous",
|
|
197
|
+
pageNumber: "Page {page}",
|
|
198
|
+
search: "Search",
|
|
199
|
+
filters: "Filters",
|
|
200
|
+
moreFilters: "More filters",
|
|
201
|
+
clearAllFilters: "Clear all filters",
|
|
202
|
+
removeFilter: "Remove filter {filter}",
|
|
203
|
+
activeFilters: "Active filters",
|
|
204
|
+
resultOne: "1 result",
|
|
205
|
+
resultMany: "{count} results",
|
|
143
206
|
showPassword: "Show password",
|
|
144
207
|
signIn: "Sign in",
|
|
145
208
|
signInAs: "Sign in as",
|
|
@@ -162,6 +225,8 @@ export const uiStrings = {
|
|
|
162
225
|
close: "Cerrar",
|
|
163
226
|
loading: "Cargando",
|
|
164
227
|
optional: "opcional",
|
|
228
|
+
save: "Guardar",
|
|
229
|
+
unsavedChanges: "Cambios sin guardar",
|
|
165
230
|
cancel: "Cancelar",
|
|
166
231
|
confirm: "Confirmar",
|
|
167
232
|
processing: "Procesando…",
|
|
@@ -204,6 +269,27 @@ export const uiStrings = {
|
|
|
204
269
|
selectRow: "Seleccionar {row}",
|
|
205
270
|
selectAll: "Seleccionar todas las filas",
|
|
206
271
|
rowActions: "Acciones de la fila",
|
|
272
|
+
tableEmpty: "No hay filas para mostrar",
|
|
273
|
+
columns: "Columnas",
|
|
274
|
+
pagination: "Paginación",
|
|
275
|
+
rowsPerPage: "Filas por página",
|
|
276
|
+
pageRange: "{first}–{last} de {total}",
|
|
277
|
+
firstPage: "Primera página",
|
|
278
|
+
previousPage: "Página anterior",
|
|
279
|
+
nextPage: "Página siguiente",
|
|
280
|
+
lastPage: "Última página",
|
|
281
|
+
showingRange: "Mostrando {first}–{last} de {total}",
|
|
282
|
+
showingRangeOpen: "Mostrando {first}–{last}",
|
|
283
|
+
previous: "Anterior",
|
|
284
|
+
pageNumber: "Página {page}",
|
|
285
|
+
search: "Buscar",
|
|
286
|
+
filters: "Filtros",
|
|
287
|
+
moreFilters: "Más filtros",
|
|
288
|
+
clearAllFilters: "Limpiar todos los filtros",
|
|
289
|
+
removeFilter: "Quitar filtro {filter}",
|
|
290
|
+
activeFilters: "Filtros activos",
|
|
291
|
+
resultOne: "1 resultado",
|
|
292
|
+
resultMany: "{count} resultados",
|
|
207
293
|
showPassword: "Mostrar contraseña",
|
|
208
294
|
signIn: "Inicia sesión",
|
|
209
295
|
signInAs: "Ingresar como",
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { type HTMLAttributes, type Ref, useEffect, useMemo, useRef, useState } from "react";
|
|
4
|
+
import { useUiStrings } from "../i18n/index.js";
|
|
5
|
+
import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
|
|
6
|
+
import { composeRefs } from "../utils/slot.js";
|
|
7
|
+
import { COUNT_UP_SCALE, countAt, parseDuration, parseEasing } from "./model.js";
|
|
8
|
+
import { MotionStyles } from "./motion-styles.js";
|
|
9
|
+
import { useStartedOnServer } from "./use-enter-phase.js";
|
|
10
|
+
|
|
11
|
+
/** Anything with an `Intl.NumberFormat`-style `format`, such as `new Intl.NumberFormat(...)`. */
|
|
12
|
+
export interface NumberFormatter {
|
|
13
|
+
format(value: number): string;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export interface CountUpProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
|
|
17
|
+
value: number;
|
|
18
|
+
/** Formats every shown value. Defaults to `Intl.NumberFormat` in the UI strings locale. */
|
|
19
|
+
formatter?: NumberFormatter;
|
|
20
|
+
/** Where a client-side mount starts counting from. Default 0. */
|
|
21
|
+
from?: number;
|
|
22
|
+
ref?: Ref<HTMLSpanElement>;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* A number that counts to `value` over 1.5 `--motion-duration`s with `--motion-ease`, on a client
|
|
27
|
+
* mount and on every change. Server HTML, hydration and reduced motion show the final value at
|
|
28
|
+
* once. While it counts, assistive tech reads only the final value and the final text reserves
|
|
29
|
+
* its width, so the line does not grow digit by digit. Works as the `value` of a `Kpi`.
|
|
30
|
+
*/
|
|
31
|
+
export function CountUp({ value, formatter, from = 0, className, ref, ...props }: CountUpProps) {
|
|
32
|
+
const { locale } = useUiStrings();
|
|
33
|
+
const format = useMemo(() => formatter ?? new Intl.NumberFormat(locale), [formatter, locale]);
|
|
34
|
+
const startedOnServer = useStartedOnServer();
|
|
35
|
+
const reduced = usePrefersReducedMotion();
|
|
36
|
+
const [shown, setShown] = useState(() => (startedOnServer || reduced ? value : from));
|
|
37
|
+
const node = useRef<HTMLSpanElement>(null);
|
|
38
|
+
const latest = useRef(shown);
|
|
39
|
+
latest.current = shown;
|
|
40
|
+
|
|
41
|
+
useEffect(() => {
|
|
42
|
+
const start = latest.current;
|
|
43
|
+
const el = node.current;
|
|
44
|
+
if (reduced || start === value || !el || typeof requestAnimationFrame === "undefined") {
|
|
45
|
+
setShown(value);
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
const styles = getComputedStyle(el);
|
|
49
|
+
const duration = parseDuration(styles.getPropertyValue("--motion-duration")) * COUNT_UP_SCALE;
|
|
50
|
+
const ease = parseEasing(styles.getPropertyValue("--motion-ease"));
|
|
51
|
+
const t0 = performance.now();
|
|
52
|
+
let frame = requestAnimationFrame(function tick(now) {
|
|
53
|
+
const next = countAt(start, value, now - t0, duration, ease);
|
|
54
|
+
setShown(next);
|
|
55
|
+
if (next !== value) frame = requestAnimationFrame(tick);
|
|
56
|
+
});
|
|
57
|
+
return () => cancelAnimationFrame(frame);
|
|
58
|
+
}, [value, reduced]);
|
|
59
|
+
|
|
60
|
+
const final = format.format(value);
|
|
61
|
+
return (
|
|
62
|
+
<>
|
|
63
|
+
<MotionStyles />
|
|
64
|
+
<span
|
|
65
|
+
ref={composeRefs(ref, node)}
|
|
66
|
+
className={className ? `ui-count ${className}` : "ui-count"}
|
|
67
|
+
{...props}
|
|
68
|
+
>
|
|
69
|
+
{shown === value ? (
|
|
70
|
+
final
|
|
71
|
+
) : (
|
|
72
|
+
<>
|
|
73
|
+
<span className="ui-count-run" aria-hidden="true">
|
|
74
|
+
<span>{final}</span>
|
|
75
|
+
<span>{format.format(shown)}</span>
|
|
76
|
+
</span>
|
|
77
|
+
<span className="ui-motion-sr">{final}</span>
|
|
78
|
+
</>
|
|
79
|
+
)}
|
|
80
|
+
</span>
|
|
81
|
+
</>
|
|
82
|
+
);
|
|
83
|
+
}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
type AnimationEvent,
|
|
5
|
+
type HTMLAttributes,
|
|
6
|
+
type Key,
|
|
7
|
+
type ReactNode,
|
|
8
|
+
type Ref,
|
|
9
|
+
useEffect,
|
|
10
|
+
useLayoutEffect,
|
|
11
|
+
useRef,
|
|
12
|
+
useState,
|
|
13
|
+
} from "react";
|
|
14
|
+
import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
|
|
15
|
+
import { MotionStyles } from "./motion-styles.js";
|
|
16
|
+
|
|
17
|
+
interface Leaving {
|
|
18
|
+
key: Key;
|
|
19
|
+
node: ReactNode;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
interface SwapState {
|
|
23
|
+
key: Key;
|
|
24
|
+
entering: Key | null;
|
|
25
|
+
leaving: Leaving[];
|
|
26
|
+
/** Bumped each time focus was inside the content that left, so it moves to the new content. */
|
|
27
|
+
refocus: number;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Leaving layers are dropped on `animationend`; this bounds them when no animation runs. */
|
|
31
|
+
const LEAVE_TIMEOUT_MS = 1000;
|
|
32
|
+
|
|
33
|
+
export interface CrossFadeProps extends HTMLAttributes<HTMLDivElement> {
|
|
34
|
+
/** Identity of the content. A new key fades the old content out and the new one in. */
|
|
35
|
+
contentKey: Key;
|
|
36
|
+
children?: ReactNode;
|
|
37
|
+
ref?: Ref<HTMLDivElement>;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Swaps keyed content (a list-detail pane, a tab panel) with a cross-fade and a 4px rise. The old
|
|
42
|
+
* content stays mounted on top of the new one until it has faded, out of the layout (so nothing
|
|
43
|
+
* jumps), hidden from assistive tech and inert. If focus was inside the old content it moves to
|
|
44
|
+
* the new content. The first render (also server HTML) never animates; reduced motion swaps
|
|
45
|
+
* without any fade.
|
|
46
|
+
*/
|
|
47
|
+
export function CrossFade({ contentKey, children, ref, ...props }: CrossFadeProps) {
|
|
48
|
+
const reduced = usePrefersReducedMotion();
|
|
49
|
+
const current = useRef<HTMLDivElement>(null);
|
|
50
|
+
const committed = useRef<ReactNode>(children);
|
|
51
|
+
const [state, setState] = useState<SwapState>({
|
|
52
|
+
key: contentKey,
|
|
53
|
+
entering: null,
|
|
54
|
+
leaving: [],
|
|
55
|
+
refocus: 0,
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
if (state.key !== contentKey) {
|
|
59
|
+
const animate = !reduced;
|
|
60
|
+
const focused = typeof document !== "undefined" && document.activeElement;
|
|
61
|
+
setState({
|
|
62
|
+
key: contentKey,
|
|
63
|
+
entering: animate ? contentKey : null,
|
|
64
|
+
leaving: animate
|
|
65
|
+
? [
|
|
66
|
+
...state.leaving.filter((layer) => layer.key !== contentKey),
|
|
67
|
+
{ key: state.key, node: committed.current },
|
|
68
|
+
]
|
|
69
|
+
: [],
|
|
70
|
+
refocus: focused && current.current?.contains(focused) ? state.refocus + 1 : state.refocus,
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
useLayoutEffect(() => {
|
|
75
|
+
committed.current = children;
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
useLayoutEffect(() => {
|
|
79
|
+
if (state.refocus === 0 || !current.current) return;
|
|
80
|
+
current.current.tabIndex = -1;
|
|
81
|
+
current.current.focus({ preventScroll: true });
|
|
82
|
+
}, [state.refocus]);
|
|
83
|
+
|
|
84
|
+
const leavingCount = state.leaving.length;
|
|
85
|
+
useEffect(() => {
|
|
86
|
+
if (leavingCount === 0) return;
|
|
87
|
+
const timer = setTimeout(() => setState((s) => ({ ...s, leaving: [] })), LEAVE_TIMEOUT_MS);
|
|
88
|
+
return () => clearTimeout(timer);
|
|
89
|
+
}, [leavingCount]);
|
|
90
|
+
|
|
91
|
+
const drop = (key: Key) => (event: AnimationEvent<HTMLDivElement>) => {
|
|
92
|
+
if (event.target !== event.currentTarget) return;
|
|
93
|
+
setState((s) => ({ ...s, leaving: s.leaving.filter((layer) => layer.key !== key) }));
|
|
94
|
+
};
|
|
95
|
+
|
|
96
|
+
const layers = [
|
|
97
|
+
...state.leaving.map((layer) => (
|
|
98
|
+
<div
|
|
99
|
+
key={`k:${String(layer.key)}`}
|
|
100
|
+
data-motion-leave=""
|
|
101
|
+
aria-hidden="true"
|
|
102
|
+
inert
|
|
103
|
+
onAnimationEnd={drop(layer.key)}
|
|
104
|
+
>
|
|
105
|
+
{layer.node}
|
|
106
|
+
</div>
|
|
107
|
+
)),
|
|
108
|
+
<div
|
|
109
|
+
key={`k:${String(contentKey)}`}
|
|
110
|
+
ref={current}
|
|
111
|
+
data-motion={state.entering === contentKey ? "enter" : undefined}
|
|
112
|
+
>
|
|
113
|
+
{children}
|
|
114
|
+
</div>,
|
|
115
|
+
];
|
|
116
|
+
|
|
117
|
+
return (
|
|
118
|
+
<>
|
|
119
|
+
<MotionStyles />
|
|
120
|
+
<div ref={ref} data-motion-swap="" {...props}>
|
|
121
|
+
{layers}
|
|
122
|
+
</div>
|
|
123
|
+
</>
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
export interface PresenceProps extends Omit<CrossFadeProps, "contentKey"> {
|
|
128
|
+
/** Shows the children when true; changes fade them in and out. */
|
|
129
|
+
present: boolean;
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** `CrossFade` between the children and nothing: shows or hides content with a fade. */
|
|
133
|
+
export function Presence({ present, children, ...props }: PresenceProps) {
|
|
134
|
+
return (
|
|
135
|
+
<CrossFade contentKey={present ? "present" : "absent"} {...props}>
|
|
136
|
+
{present ? children : null}
|
|
137
|
+
</CrossFade>
|
|
138
|
+
);
|
|
139
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { CountUp, type CountUpProps, type NumberFormatter } from "./count-up.js";
|
|
2
|
+
export { CrossFade, type CrossFadeProps, Presence, type PresenceProps } from "./cross-fade.js";
|
|
3
|
+
export { MotionStyles } from "./motion-styles.js";
|
|
4
|
+
export { Reveal, type RevealProps, Stagger, type StaggerProps } from "./reveal.js";
|
|
5
|
+
export { type HighlightRow, type HighlightRowProps, useHighlightRow } from "./use-highlight-row.js";
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// Pure motion math shared by the motion components: token parsing, easing and the count-up tween.
|
|
2
|
+
|
|
3
|
+
/** Fallbacks when the theme does not define `--motion-duration` / `--motion-ease`. */
|
|
4
|
+
export const DEFAULT_DURATION_MS = 180;
|
|
5
|
+
export const DEFAULT_EASE = "cubic-bezier(.2,.8,.2,1)";
|
|
6
|
+
|
|
7
|
+
/** A count-up runs this many token durations: long enough to read, still under 300ms by default. */
|
|
8
|
+
export const COUNT_UP_SCALE = 1.5;
|
|
9
|
+
|
|
10
|
+
export type Easing = (t: number) => number;
|
|
11
|
+
|
|
12
|
+
/** Milliseconds from a CSS time (`180ms`, `.18s`); `fallback` when it does not parse. */
|
|
13
|
+
export function parseDuration(value: string | null | undefined, fallback = DEFAULT_DURATION_MS) {
|
|
14
|
+
const match = /^\s*(-?\d*\.?\d+)\s*(ms|s)\s*$/i.exec(value ?? "");
|
|
15
|
+
if (!match) return fallback;
|
|
16
|
+
const amount = Number(match[1]) * (match[2]?.toLowerCase() === "s" ? 1000 : 1);
|
|
17
|
+
return Number.isFinite(amount) && amount >= 0 ? amount : fallback;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
function cubicBezier(x1: number, y1: number, x2: number, y2: number): Easing {
|
|
21
|
+
const sample = (a: number, b: number, t: number) =>
|
|
22
|
+
3 * a * t * (1 - t) ** 2 + 3 * b * t ** 2 * (1 - t) + t ** 3;
|
|
23
|
+
const slope = (a: number, b: number, t: number) =>
|
|
24
|
+
3 * a * (1 - t) ** 2 + 6 * (b - a) * t * (1 - t) + 3 * (1 - b) * t ** 2;
|
|
25
|
+
return (x) => {
|
|
26
|
+
if (x <= 0) return 0;
|
|
27
|
+
if (x >= 1) return 1;
|
|
28
|
+
let t = x;
|
|
29
|
+
for (let i = 0; i < 8; i += 1) {
|
|
30
|
+
const error = sample(x1, x2, t) - x;
|
|
31
|
+
if (Math.abs(error) < 1e-6) return sample(y1, y2, t);
|
|
32
|
+
const d = slope(x1, x2, t);
|
|
33
|
+
if (Math.abs(d) < 1e-6) break;
|
|
34
|
+
t -= error / d;
|
|
35
|
+
}
|
|
36
|
+
let lo = 0;
|
|
37
|
+
let hi = 1;
|
|
38
|
+
t = x;
|
|
39
|
+
for (let i = 0; i < 30; i += 1) {
|
|
40
|
+
const value = sample(x1, x2, t);
|
|
41
|
+
if (Math.abs(value - x) < 1e-6) break;
|
|
42
|
+
if (value < x) lo = t;
|
|
43
|
+
else hi = t;
|
|
44
|
+
t = (lo + hi) / 2;
|
|
45
|
+
}
|
|
46
|
+
return sample(y1, y2, t);
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const KEYWORDS: Record<string, [number, number, number, number]> = {
|
|
51
|
+
ease: [0.25, 0.1, 0.25, 1],
|
|
52
|
+
"ease-in": [0.42, 0, 1, 1],
|
|
53
|
+
"ease-out": [0, 0, 0.58, 1],
|
|
54
|
+
"ease-in-out": [0.42, 0, 0.58, 1],
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
/** Easing function for a CSS `<easing-function>`: `linear`, the `ease*` keywords or `cubic-bezier()`. */
|
|
58
|
+
export function parseEasing(value: string | null | undefined): Easing {
|
|
59
|
+
const text = (value ?? "").trim().toLowerCase();
|
|
60
|
+
if (text === "linear") return (t) => Math.min(1, Math.max(0, t));
|
|
61
|
+
const keyword = KEYWORDS[text];
|
|
62
|
+
if (keyword) return cubicBezier(...keyword);
|
|
63
|
+
const match = /^cubic-bezier\(([^)]*)\)$/.exec(text);
|
|
64
|
+
const points = match?.[1]?.split(",").map(Number);
|
|
65
|
+
if (points?.length === 4 && points.every(Number.isFinite)) {
|
|
66
|
+
const [x1, y1, x2, y2] = points as [number, number, number, number];
|
|
67
|
+
if (x1 >= 0 && x1 <= 1 && x2 >= 0 && x2 <= 1) return cubicBezier(x1, y1, x2, y2);
|
|
68
|
+
}
|
|
69
|
+
return cubicBezier(0.2, 0.8, 0.2, 1);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* Value a count-up shows `elapsed` ms into a run of `duration` ms. It lands exactly on `to` at the
|
|
74
|
+
* end, and integer runs stay integers so a formatter never flashes decimals.
|
|
75
|
+
*/
|
|
76
|
+
export function countAt(
|
|
77
|
+
from: number,
|
|
78
|
+
to: number,
|
|
79
|
+
elapsed: number,
|
|
80
|
+
duration: number,
|
|
81
|
+
ease: Easing,
|
|
82
|
+
): number {
|
|
83
|
+
if (!(duration > 0) || elapsed >= duration) return to;
|
|
84
|
+
const value = from + (to - from) * ease(Math.max(0, elapsed) / duration);
|
|
85
|
+
return Number.isInteger(from) && Number.isInteger(to) ? Math.round(value) : value;
|
|
86
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rules of the motion entry. Every duration and easing comes from `--motion-duration` and
|
|
3
|
+
* `--motion-ease`, so a theme that shortens them (or makes them linear) restyles all motion.
|
|
4
|
+
* Enter and leave animate only `opacity` and `transform`; the row pulse animates a background
|
|
5
|
+
* colour, which repaints but never lays out. Hidden states use `opacity`, never `visibility` or
|
|
6
|
+
* `display`, so assistive tech reads the content while it animates.
|
|
7
|
+
*
|
|
8
|
+
* React 19 hoists and dedupes `<style href precedence>`, so every component can render this and
|
|
9
|
+
* the rules are injected once, also in server HTML.
|
|
10
|
+
*/
|
|
11
|
+
const D = "var(--motion-duration,180ms)";
|
|
12
|
+
const E = "var(--motion-ease,cubic-bezier(.2,.8,.2,1))";
|
|
13
|
+
|
|
14
|
+
const CSS = `
|
|
15
|
+
@keyframes ui-motion-enter{from{opacity:0;transform:translate3d(0,var(--ui-motion-rise,6px),0)}}
|
|
16
|
+
@keyframes ui-motion-leave{to{opacity:0}}
|
|
17
|
+
@keyframes ui-motion-pulse-a{from{background-color:var(--ui-motion-highlight)}}
|
|
18
|
+
@keyframes ui-motion-pulse-b{from{background-color:var(--ui-motion-highlight)}}
|
|
19
|
+
[data-motion-stagger]{--ui-motion-step:min(calc(${D} / 4),calc(var(--ui-motion-span,calc(${D} * 1.5)) / var(--ui-motion-n,1)))}
|
|
20
|
+
[data-motion=wait]{opacity:0}
|
|
21
|
+
[data-motion=wait]:focus-within{opacity:1}
|
|
22
|
+
[data-motion=enter]{animation:ui-motion-enter ${D} ${E} backwards;animation-delay:calc(var(--ui-motion-delay,0ms) + var(--ui-motion-i,0) * var(--ui-motion-step,0ms))}
|
|
23
|
+
[data-motion-swap]{position:relative}
|
|
24
|
+
[data-motion-swap]>[data-motion=enter]{--ui-motion-rise:4px}
|
|
25
|
+
[data-motion-swap]>[data-motion-leave]{position:absolute;inset:0 0 auto;pointer-events:none;animation:ui-motion-leave ${D} ${E} forwards}
|
|
26
|
+
[data-motion-pulse]{--ui-motion-highlight:color-mix(in srgb,var(--accent,currentColor) 24%,transparent)}
|
|
27
|
+
[data-motion-pulse=a]:not(tr),tr[data-motion-pulse=a]>*{animation:ui-motion-pulse-a calc(${D} * 1.6) ${E}}
|
|
28
|
+
[data-motion-pulse=b]:not(tr),tr[data-motion-pulse=b]>*{animation:ui-motion-pulse-b calc(${D} * 1.6) ${E}}
|
|
29
|
+
.ui-count{font-variant-numeric:tabular-nums}
|
|
30
|
+
.ui-count-run{display:inline-grid;justify-items:end}
|
|
31
|
+
.ui-count-run>*{grid-area:1/1}
|
|
32
|
+
.ui-count-run>:first-child{visibility:hidden}
|
|
33
|
+
.ui-motion-sr{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap;border:0}
|
|
34
|
+
@media (prefers-reduced-motion:reduce){
|
|
35
|
+
[data-motion]{animation:none!important;opacity:1!important}
|
|
36
|
+
[data-motion-swap]>[data-motion-leave]{display:none}
|
|
37
|
+
[data-motion-pulse]:not(tr),tr[data-motion-pulse]>*{animation:none!important}
|
|
38
|
+
}
|
|
39
|
+
`;
|
|
40
|
+
|
|
41
|
+
export function MotionStyles() {
|
|
42
|
+
return (
|
|
43
|
+
<style href="jcsoftdev-ui-motion" precedence="default">
|
|
44
|
+
{CSS}
|
|
45
|
+
</style>
|
|
46
|
+
);
|
|
47
|
+
}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
Children,
|
|
5
|
+
type CSSProperties,
|
|
6
|
+
type HTMLAttributes,
|
|
7
|
+
isValidElement,
|
|
8
|
+
type ReactNode,
|
|
9
|
+
type Ref,
|
|
10
|
+
} from "react";
|
|
11
|
+
import { composeRefs, Slot } from "../utils/slot.js";
|
|
12
|
+
import { MotionStyles } from "./motion-styles.js";
|
|
13
|
+
import { type EnterPhase, useEnterPhase } from "./use-enter-phase.js";
|
|
14
|
+
|
|
15
|
+
type MotionVars = CSSProperties & Record<`--ui-motion-${string}`, string | number>;
|
|
16
|
+
|
|
17
|
+
function phaseProps(phase: EnterPhase, vars: MotionVars, style?: CSSProperties) {
|
|
18
|
+
if (phase === "static") return { style };
|
|
19
|
+
return { "data-motion": phase, style: { ...vars, ...style } };
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface RevealProps extends HTMLAttributes<HTMLElement> {
|
|
23
|
+
/** Extra wait before entering, in ms. */
|
|
24
|
+
delay?: number;
|
|
25
|
+
/** Enter when the element first scrolls into view instead of on mount. */
|
|
26
|
+
inView?: boolean;
|
|
27
|
+
/** Animate the single child element instead of rendering a `div`. */
|
|
28
|
+
asChild?: boolean;
|
|
29
|
+
ref?: Ref<HTMLElement>;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Fades its content in with a small rise when it mounts on the client, or first scrolls into view
|
|
34
|
+
* with `inView`. Server-rendered content and reduced motion show the end state at once. The
|
|
35
|
+
* content stays in the accessibility tree the whole time: hiding uses `opacity` only.
|
|
36
|
+
*/
|
|
37
|
+
export function Reveal({ delay, inView = false, asChild, style, ref, ...props }: RevealProps) {
|
|
38
|
+
const [phaseRef, phase] = useEnterPhase(inView);
|
|
39
|
+
const Comp = asChild ? Slot : "div";
|
|
40
|
+
const vars: MotionVars = { "--ui-motion-i": 0 };
|
|
41
|
+
if (delay) vars["--ui-motion-delay"] = `${delay}ms`;
|
|
42
|
+
return (
|
|
43
|
+
<>
|
|
44
|
+
<MotionStyles />
|
|
45
|
+
<Comp
|
|
46
|
+
ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<HTMLDivElement>}
|
|
47
|
+
{...phaseProps(phase, vars, style)}
|
|
48
|
+
{...props}
|
|
49
|
+
/>
|
|
50
|
+
</>
|
|
51
|
+
);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export interface StaggerProps extends HTMLAttributes<HTMLElement> {
|
|
55
|
+
/** Extra wait before the first child enters, in ms. */
|
|
56
|
+
delay?: number;
|
|
57
|
+
/** Start when the group first scrolls into view instead of on mount. */
|
|
58
|
+
inView?: boolean;
|
|
59
|
+
/**
|
|
60
|
+
* Longest gap between the first and the last child's start, in ms. Each step is a quarter of
|
|
61
|
+
* `--motion-duration`, shortened so long lists still fit in this span (default 1.5 durations).
|
|
62
|
+
*/
|
|
63
|
+
maxStagger?: number;
|
|
64
|
+
/** Element that wraps the children, e.g. `ul` for a list of `li`. */
|
|
65
|
+
as?: "div" | "ul" | "ol" | "section";
|
|
66
|
+
ref?: Ref<HTMLElement>;
|
|
67
|
+
children?: ReactNode;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Its children enter one after another, like `Reveal`, with the whole sequence capped by
|
|
72
|
+
* `maxStagger`. Each child element receives `data-motion` and a `style` variable, so it must
|
|
73
|
+
* pass `style` and `data-*` props to its DOM element (every element and most components do).
|
|
74
|
+
*/
|
|
75
|
+
export function Stagger({
|
|
76
|
+
delay,
|
|
77
|
+
inView = false,
|
|
78
|
+
maxStagger,
|
|
79
|
+
as: Tag = "div",
|
|
80
|
+
style,
|
|
81
|
+
ref,
|
|
82
|
+
children,
|
|
83
|
+
...props
|
|
84
|
+
}: StaggerProps) {
|
|
85
|
+
const [phaseRef, phase] = useEnterPhase(inView);
|
|
86
|
+
const items = Children.toArray(children);
|
|
87
|
+
const vars: MotionVars = { "--ui-motion-n": Math.max(1, items.length - 1) };
|
|
88
|
+
if (maxStagger !== undefined) vars["--ui-motion-span"] = `${Math.max(0, maxStagger)}ms`;
|
|
89
|
+
const itemVars = (i: number): MotionVars => {
|
|
90
|
+
const next: MotionVars = { "--ui-motion-i": i };
|
|
91
|
+
if (delay) next["--ui-motion-delay"] = `${delay}ms`;
|
|
92
|
+
return next;
|
|
93
|
+
};
|
|
94
|
+
return (
|
|
95
|
+
<>
|
|
96
|
+
<MotionStyles />
|
|
97
|
+
<Tag
|
|
98
|
+
ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<never>}
|
|
99
|
+
data-motion-stagger={phase === "static" ? undefined : ""}
|
|
100
|
+
style={phase === "static" ? style : { ...vars, ...style }}
|
|
101
|
+
{...props}
|
|
102
|
+
>
|
|
103
|
+
{items.map((child, i) =>
|
|
104
|
+
isValidElement(child) ? (
|
|
105
|
+
<Slot key={child.key} {...phaseProps(phase, itemVars(i))}>
|
|
106
|
+
{child}
|
|
107
|
+
</Slot>
|
|
108
|
+
) : (
|
|
109
|
+
child
|
|
110
|
+
),
|
|
111
|
+
)}
|
|
112
|
+
</Tag>
|
|
113
|
+
</>
|
|
114
|
+
);
|
|
115
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { type RefCallback, useEffect, useState, useSyncExternalStore } from "react";
|
|
4
|
+
import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
|
|
5
|
+
|
|
6
|
+
const subscribeNever = () => () => {};
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* True when this component's first render came from server HTML (on the server and while
|
|
10
|
+
* hydrating), false when it mounted on the client. Fixed for the component's lifetime, so server
|
|
11
|
+
* markup is never animated after hydration and hydration always matches it.
|
|
12
|
+
*/
|
|
13
|
+
export function useStartedOnServer(): boolean {
|
|
14
|
+
const hydrating = useSyncExternalStore(
|
|
15
|
+
subscribeNever,
|
|
16
|
+
() => false,
|
|
17
|
+
() => true,
|
|
18
|
+
);
|
|
19
|
+
const [started] = useState(hydrating);
|
|
20
|
+
return started;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** `static`: no motion (server HTML or reduced motion). `wait`: hidden until in view. `enter`: animating in. */
|
|
24
|
+
export type EnterPhase = "static" | "wait" | "enter";
|
|
25
|
+
|
|
26
|
+
/** Phase of an enter animation, on mount or (with `inView`) when the element first scrolls into view. */
|
|
27
|
+
export function useEnterPhase(inView: boolean): [RefCallback<HTMLElement>, EnterPhase] {
|
|
28
|
+
const startedOnServer = useStartedOnServer();
|
|
29
|
+
const reduced = usePrefersReducedMotion();
|
|
30
|
+
const [seen, setSeen] = useState(!inView);
|
|
31
|
+
const [node, setNode] = useState<HTMLElement | null>(null);
|
|
32
|
+
const animate = !startedOnServer && !reduced;
|
|
33
|
+
|
|
34
|
+
useEffect(() => {
|
|
35
|
+
if (!animate || seen || !node) return;
|
|
36
|
+
if (typeof IntersectionObserver === "undefined") {
|
|
37
|
+
setSeen(true);
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
const observer = new IntersectionObserver((entries) => {
|
|
41
|
+
if (!entries.some((entry) => entry.isIntersecting)) return;
|
|
42
|
+
observer.disconnect();
|
|
43
|
+
setSeen(true);
|
|
44
|
+
});
|
|
45
|
+
observer.observe(node);
|
|
46
|
+
return () => observer.disconnect();
|
|
47
|
+
}, [animate, seen, node]);
|
|
48
|
+
|
|
49
|
+
return [setNode, !animate ? "static" : seen ? "enter" : "wait"];
|
|
50
|
+
}
|