@invoiceonline/ui-react 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +99 -0
- package/CHANGELOG.md +131 -0
- package/LICENSE +9 -0
- package/README.md +78 -2
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-field/DateField.d.ts +52 -0
- package/dist/components/date-field/DateField.js +45 -0
- package/dist/components/date-field/index.d.ts +2 -0
- package/dist/components/date-field/index.js +1 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +118 -0
- package/dist/components/field/Field.js +327 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +194 -0
- package/dist/components/field-pair/FieldPair.js +321 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +65 -0
- package/dist/components/text-field/TextField.js +173 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +75 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.js +183 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +37 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +379 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +556 -0
- package/package.json +357 -4
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-field/DateField.mdx +340 -0
- package/src/components/date-field/DateField.stories.tsx +221 -0
- package/src/components/date-field/DateField.tsx +176 -0
- package/src/components/date-field/index.ts +1 -0
- package/src/components/date-picker/DatePicker.mdx +436 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +765 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +308 -0
- package/src/components/field-pair/FieldPair.stories.tsx +530 -0
- package/src/components/field-pair/FieldPair.tsx +796 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +479 -0
- package/src/components/text-field/TextField.stories.tsx +366 -0
- package/src/components/text-field/TextField.tsx +391 -0
- package/src/components/text-field/index.ts +8 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +71 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +357 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +47 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +355 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { usePrefersReducedMotion } from './usePrefersReducedMotion';
|
|
4
|
+
|
|
5
|
+
export type EasingFunction = (progress: number) => number;
|
|
6
|
+
|
|
7
|
+
/** Decelerating cubic — the same curve ECharts calls `cubicOut`. */
|
|
8
|
+
export const easeOutCubic: EasingFunction = progress => 1 - (1 - progress) ** 3;
|
|
9
|
+
|
|
10
|
+
export interface UseCountUpOptions {
|
|
11
|
+
/** Animation length in ms. `0` (or less) snaps. */
|
|
12
|
+
duration: number;
|
|
13
|
+
/** Maps linear progress 0…1 to eased progress. Defaults to `easeOutCubic`. */
|
|
14
|
+
easing?: EasingFunction;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Animates a number from the value it currently shows to `value` whenever `value`
|
|
19
|
+
* changes.
|
|
20
|
+
*
|
|
21
|
+
* - The first render shows `value` as is; only later changes animate.
|
|
22
|
+
* - A change arriving mid-animation continues from the intermediate value, so the
|
|
23
|
+
* number never jumps back to the previous target first.
|
|
24
|
+
* - `prefers-reduced-motion: reduce` snaps to the target.
|
|
25
|
+
*
|
|
26
|
+
* The returned value is fractional while animating; format it for display and keep
|
|
27
|
+
* the final value available to assistive technology separately, so a screen reader
|
|
28
|
+
* never reads the intermediate frames.
|
|
29
|
+
*/
|
|
30
|
+
export function useCountUp(value: number, { duration, easing = easeOutCubic }: UseCountUpOptions): number {
|
|
31
|
+
const reducedMotion = usePrefersReducedMotion();
|
|
32
|
+
const [display, setDisplay] = React.useState(value);
|
|
33
|
+
// Mirrors `display` without a render, so the next animation knows where it starts.
|
|
34
|
+
const displayRef = React.useRef(value);
|
|
35
|
+
// Latest easing without restarting a running animation for an inline function.
|
|
36
|
+
const easingRef = React.useRef(easing);
|
|
37
|
+
easingRef.current = easing;
|
|
38
|
+
|
|
39
|
+
React.useEffect(() => {
|
|
40
|
+
const from = displayRef.current;
|
|
41
|
+
if (from === value) return undefined;
|
|
42
|
+
|
|
43
|
+
const canAnimate = !reducedMotion && duration > 0 && typeof window !== 'undefined' && !!window.requestAnimationFrame;
|
|
44
|
+
if (!canAnimate) {
|
|
45
|
+
displayRef.current = value;
|
|
46
|
+
setDisplay(value);
|
|
47
|
+
return undefined;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
let frame = 0;
|
|
51
|
+
let start: number | null = null;
|
|
52
|
+
const step = (timestamp: number) => {
|
|
53
|
+
if (start === null) start = timestamp;
|
|
54
|
+
const progress = Math.min(1, (timestamp - start) / duration);
|
|
55
|
+
const next = progress >= 1 ? value : from + (value - from) * easingRef.current(progress);
|
|
56
|
+
displayRef.current = next;
|
|
57
|
+
setDisplay(next);
|
|
58
|
+
if (progress < 1) frame = window.requestAnimationFrame(step);
|
|
59
|
+
};
|
|
60
|
+
frame = window.requestAnimationFrame(step);
|
|
61
|
+
return () => window.cancelAnimationFrame(frame);
|
|
62
|
+
}, [value, duration, reducedMotion]);
|
|
63
|
+
|
|
64
|
+
return display;
|
|
65
|
+
}
|
|
@@ -0,0 +1,357 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { FloatingPortal, FloatingFocusManager } from '@floating-ui/react';
|
|
4
|
+
import { format, isAfter, isBefore, isValid, parse, startOfDay } from 'date-fns';
|
|
5
|
+
import { cs } from 'date-fns/locale/cs';
|
|
6
|
+
import type { Locale } from 'date-fns';
|
|
7
|
+
import { DatePicker, type DatePickerNavLabels } from '../components/date-picker/DatePicker';
|
|
8
|
+
import { popoverSurfaceVariants } from './popoverSurface';
|
|
9
|
+
import { useAnchoredPanel } from './useAnchoredPanel';
|
|
10
|
+
|
|
11
|
+
// =============================================================================
|
|
12
|
+
// useDateFieldTrigger — the date behaviour behind a date field, without the
|
|
13
|
+
// shell it is drawn in.
|
|
14
|
+
//
|
|
15
|
+
// Two call sites need the SAME behaviour in two different chromes: `DateField`
|
|
16
|
+
// (a bordered Text Field) and a `FieldPair` cell in `format="date"` (a
|
|
17
|
+
// borderless Field Segment — the mobile substitute for Date Picker's dual-month
|
|
18
|
+
// range mode, spec 04-molecules/field-pair.md § Field Segment). Everything that
|
|
19
|
+
// is not the chrome lives here: draft/commit parsing, the day-granular min/max
|
|
20
|
+
// clamp, the "whole field is the trigger" click rule, the ArrowDown route into
|
|
21
|
+
// the grid, the blur-into-panel guard, and the portal + focus manager + panel.
|
|
22
|
+
//
|
|
23
|
+
// The doctrine for WHY the field is the trigger (rather than a button beside
|
|
24
|
+
// it), and why the input carries `role="combobox"`, is in the header of
|
|
25
|
+
// `DateField.tsx` — read it there, it is not repeated here.
|
|
26
|
+
//
|
|
27
|
+
// The panel is returned as a ready-made node on purpose: it guarantees both
|
|
28
|
+
// call sites render the identical portal/focus-manager/DatePicker stack,
|
|
29
|
+
// including the deliberate decision NOT to spread `panelStyle`.
|
|
30
|
+
// =============================================================================
|
|
31
|
+
|
|
32
|
+
export interface UseDateFieldTriggerOptions {
|
|
33
|
+
/**
|
|
34
|
+
* `false` makes the hook inert — the panel never opens and nothing is
|
|
35
|
+
* rendered. A `FieldPair` cell that is not in date mode still has to CALL the
|
|
36
|
+
* hook (rules of hooks), so it passes `enabled: false` instead of skipping it.
|
|
37
|
+
*/
|
|
38
|
+
enabled?: boolean;
|
|
39
|
+
/** The chosen date. Controlled. */
|
|
40
|
+
value?: Date;
|
|
41
|
+
onValueChange?: (value: Date | undefined) => void;
|
|
42
|
+
/**
|
|
43
|
+
* Display + parse pattern, date-fns syntax (e.g. `dd. MM. yyyy` for CZ,
|
|
44
|
+
* `MM/dd/yyyy` for US). Per-market values are the consumer's to supply.
|
|
45
|
+
*/
|
|
46
|
+
dateFormat?: string;
|
|
47
|
+
/** Locale driving the panel's week start, weekday names and month caption. */
|
|
48
|
+
locale?: Locale;
|
|
49
|
+
/** Earliest / latest selectable date. */
|
|
50
|
+
minDate?: Date;
|
|
51
|
+
maxDate?: Date;
|
|
52
|
+
disabled?: boolean;
|
|
53
|
+
readOnly?: boolean;
|
|
54
|
+
/**
|
|
55
|
+
* Accessible name for the calendar panel (`role="dialog"`). Required and never
|
|
56
|
+
* defaulted — the design system is locale-agnostic, and a name invisible to
|
|
57
|
+
* sighted review is exactly the kind that ships untranslated.
|
|
58
|
+
*/
|
|
59
|
+
panelLabel: string;
|
|
60
|
+
/** Accessible names for the panel's four navigation chevrons. */
|
|
61
|
+
navLabels: DatePickerNavLabels;
|
|
62
|
+
/** External ref to merge into the input (`DateField` forwards one). */
|
|
63
|
+
inputRef?: React.Ref<HTMLInputElement>;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** Props the hook contributes to the `<input>`; merged with the caller's. */
|
|
67
|
+
interface DateTriggerInputProps {
|
|
68
|
+
value: string;
|
|
69
|
+
onChange: React.ChangeEventHandler<HTMLInputElement>;
|
|
70
|
+
onBlur: React.FocusEventHandler<HTMLInputElement>;
|
|
71
|
+
onKeyDown: React.KeyboardEventHandler<HTMLInputElement>;
|
|
72
|
+
role: 'combobox';
|
|
73
|
+
'aria-haspopup': 'dialog';
|
|
74
|
+
'aria-expanded': boolean;
|
|
75
|
+
'aria-controls': string | undefined;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export interface UseDateFieldTriggerReturn {
|
|
79
|
+
open: boolean;
|
|
80
|
+
/** The text the input shows — the raw draft, or the formatted value. */
|
|
81
|
+
displayValue: string;
|
|
82
|
+
/** Callback ref for the `<input>` (merges the caller's `inputRef`). */
|
|
83
|
+
setInputRef: (node: HTMLInputElement | null) => void;
|
|
84
|
+
/**
|
|
85
|
+
* Spread on the element that IS the trigger — `DateField`'s wrapper, or a
|
|
86
|
+
* `FieldPair` cell. Only the anchor ref and the pointer handlers — mouse-down
|
|
87
|
+
* keeps focus in the input, click opens the panel. The substrate's
|
|
88
|
+
* `getReferenceProps` is deliberately NOT used, because it would put
|
|
89
|
+
* `aria-expanded` / id wiring on a non-interactive element and duplicate the
|
|
90
|
+
* click handling that already lives on the input.
|
|
91
|
+
*/
|
|
92
|
+
triggerProps: {
|
|
93
|
+
ref: (node: HTMLElement | null) => void;
|
|
94
|
+
onMouseDown: React.MouseEventHandler;
|
|
95
|
+
onClick: React.MouseEventHandler;
|
|
96
|
+
};
|
|
97
|
+
/** floating-ui idiom — merges the caller's handlers with the hook's. */
|
|
98
|
+
getInputProps: <T extends Record<string, unknown>>(user?: T) => T & DateTriggerInputProps;
|
|
99
|
+
/** Portal + focus manager + DatePicker. Render as a sibling of the trigger. */
|
|
100
|
+
panel: React.ReactNode;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export function useDateFieldTrigger({
|
|
104
|
+
enabled = true,
|
|
105
|
+
value,
|
|
106
|
+
onValueChange,
|
|
107
|
+
dateFormat = 'dd. MM. yyyy',
|
|
108
|
+
locale = cs,
|
|
109
|
+
minDate,
|
|
110
|
+
maxDate,
|
|
111
|
+
disabled,
|
|
112
|
+
readOnly,
|
|
113
|
+
panelLabel,
|
|
114
|
+
navLabels,
|
|
115
|
+
inputRef: externalRef,
|
|
116
|
+
}: UseDateFieldTriggerOptions): UseDateFieldTriggerReturn {
|
|
117
|
+
const [open, setOpen] = React.useState(false);
|
|
118
|
+
// The trigger owns the click and the panel dismissal, so it needs a handle on
|
|
119
|
+
// its own input to put focus back where a typist expects it.
|
|
120
|
+
const inputRef = React.useRef<HTMLInputElement>(null);
|
|
121
|
+
const setInputRef = React.useCallback(
|
|
122
|
+
(node: HTMLInputElement | null) => {
|
|
123
|
+
inputRef.current = node;
|
|
124
|
+
if (typeof externalRef === 'function') externalRef(node);
|
|
125
|
+
else if (externalRef) (externalRef as React.MutableRefObject<HTMLInputElement | null>).current = node;
|
|
126
|
+
},
|
|
127
|
+
[externalRef],
|
|
128
|
+
);
|
|
129
|
+
// How the panel was opened decides where focus goes. Opening by CLICK must
|
|
130
|
+
// leave focus in the input — the field is typeable, and yanking focus into
|
|
131
|
+
// the grid would break mid-typing. Opening by ArrowDown is explicit keyboard
|
|
132
|
+
// intent to browse the calendar, so there focus moves onto a day.
|
|
133
|
+
const [openedByKeyboard, setOpenedByKeyboard] = React.useState(false);
|
|
134
|
+
const panelId = React.useId();
|
|
135
|
+
|
|
136
|
+
// Read-only keeps the calendar affordance but the trigger must not open the
|
|
137
|
+
// panel — the value is a fact to read, not a control (spec
|
|
138
|
+
// 06-patterns/field-readonly.md). `enabled` is the same gate for a FieldPair
|
|
139
|
+
// cell that is not in date mode at all.
|
|
140
|
+
const canOpen = enabled && !disabled && !readOnly;
|
|
141
|
+
|
|
142
|
+
const openPanel = (byKeyboard: boolean) => {
|
|
143
|
+
if (!canOpen || open) return;
|
|
144
|
+
setOpenedByKeyboard(byKeyboard);
|
|
145
|
+
setOpen(true);
|
|
146
|
+
};
|
|
147
|
+
|
|
148
|
+
// The text the input shows. While the user is typing we hand the raw draft
|
|
149
|
+
// back unchanged; a committed value is re-formatted from the Date so the
|
|
150
|
+
// field always settles into the canonical pattern.
|
|
151
|
+
const [draft, setDraft] = React.useState<string | null>(null);
|
|
152
|
+
const displayValue = draft ?? (value ? format(value, dateFormat, { locale }) : '');
|
|
153
|
+
|
|
154
|
+
const panel = useAnchoredPanel({
|
|
155
|
+
open,
|
|
156
|
+
onOpenChange: next => setOpen(next && canOpen),
|
|
157
|
+
role: 'dialog',
|
|
158
|
+
focusModel: 'roving',
|
|
159
|
+
// The panel is a calendar, not the field's drop-down list: it hugs its own
|
|
160
|
+
// grid rather than stretching to the trigger's width.
|
|
161
|
+
widthPolicy: 'content',
|
|
162
|
+
// The grid owns the Arrow keys, PageUp/PageDown and Home/End.
|
|
163
|
+
navigation: 'none',
|
|
164
|
+
itemCount: 0,
|
|
165
|
+
typeahead: false,
|
|
166
|
+
});
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* Anywhere in the trigger opens the calendar — the shell padding (and, in
|
|
170
|
+
* `DateField`, the glyph) is part of the trigger, not decoration you can click
|
|
171
|
+
* through. A press that missed the input keeps focus there (see
|
|
172
|
+
* `handleTriggerMouseDown`), so the field stays typeable.
|
|
173
|
+
*
|
|
174
|
+
* It opens but deliberately does NOT toggle (`openPanel` returns early while
|
|
175
|
+
* open), so clicking into the text to place the caret keeps the calendar up.
|
|
176
|
+
*/
|
|
177
|
+
const handleTriggerClick = (event: React.MouseEvent) => {
|
|
178
|
+
if (disabled || !enabled) return;
|
|
179
|
+
if (event.target !== inputRef.current) inputRef.current?.focus();
|
|
180
|
+
openPanel(false);
|
|
181
|
+
};
|
|
182
|
+
|
|
183
|
+
// A press on the glyph, the shell padding or a FieldPair cell's labels is
|
|
184
|
+
// handled on mouse-down, whose default would move focus from the input to
|
|
185
|
+
// <body>: the blur would commit — i.e. discard — a half-typed draft and drop
|
|
186
|
+
// the floating label before the click refocuses. Same rule as Combobox's
|
|
187
|
+
// `handleTriggerMouseDown`; not on pointer-down, where preventing does not
|
|
188
|
+
// stop the focus move.
|
|
189
|
+
const handleTriggerMouseDown = (event: React.MouseEvent) => {
|
|
190
|
+
if (disabled || !enabled) return;
|
|
191
|
+
if (event.target === inputRef.current) return;
|
|
192
|
+
if ((event.target as HTMLElement).closest('button')) return;
|
|
193
|
+
event.preventDefault();
|
|
194
|
+
inputRef.current?.focus();
|
|
195
|
+
};
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* `ArrowDown` is the keyboard route into the calendar, whether or not it is
|
|
199
|
+
* already up: a click-open deliberately leaves focus in the input, so without
|
|
200
|
+
* the second branch a keyboard user could only reach the grid by tabbing.
|
|
201
|
+
*/
|
|
202
|
+
const handleTriggerKeyDown = (event: React.KeyboardEvent) => {
|
|
203
|
+
if (event.key !== 'ArrowDown') return;
|
|
204
|
+
if (!open) {
|
|
205
|
+
event.preventDefault();
|
|
206
|
+
openPanel(true);
|
|
207
|
+
return;
|
|
208
|
+
}
|
|
209
|
+
// The grid's single tabstop — react-day-picker parks `tabindex="0"` on the
|
|
210
|
+
// selected day, or on today when there is no selection.
|
|
211
|
+
const day = panel.refs.floating.current?.querySelector<HTMLButtonElement>(
|
|
212
|
+
'button[tabindex="0"]',
|
|
213
|
+
);
|
|
214
|
+
if (!day) return;
|
|
215
|
+
event.preventDefault();
|
|
216
|
+
day.focus();
|
|
217
|
+
};
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Commit a typed draft. An unparseable draft is discarded, not coerced — and
|
|
221
|
+
* so is one that parses but falls outside `minDate` / `maxDate`: the panel
|
|
222
|
+
* hard-disables those days, so typing must not be a back door around the same
|
|
223
|
+
* bound. Comparison is day-granular to match the panel's own matchers, where
|
|
224
|
+
* `{ before: minDate }` bounds by day and a `minDate` carrying a time
|
|
225
|
+
* component must still leave its own day selectable.
|
|
226
|
+
*/
|
|
227
|
+
const commitDraft = () => {
|
|
228
|
+
if (draft === null) return;
|
|
229
|
+
const trimmed = draft.trim();
|
|
230
|
+
setDraft(null);
|
|
231
|
+
if (trimmed === '') {
|
|
232
|
+
onValueChange?.(undefined);
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
const parsed = parse(trimmed, dateFormat, new Date(), { locale });
|
|
236
|
+
if (!isValid(parsed)) return;
|
|
237
|
+
const day = startOfDay(parsed);
|
|
238
|
+
if (minDate && isBefore(day, startOfDay(minDate))) return;
|
|
239
|
+
if (maxDate && isAfter(day, startOfDay(maxDate))) return;
|
|
240
|
+
onValueChange?.(parsed);
|
|
241
|
+
};
|
|
242
|
+
|
|
243
|
+
const handleSelect = (next: Date | undefined) => {
|
|
244
|
+
setDraft(null);
|
|
245
|
+
onValueChange?.(next);
|
|
246
|
+
setOpen(false);
|
|
247
|
+
// Focus returns to the trigger on dismissal (spec § Dismissal). The trigger
|
|
248
|
+
// is the field, but the caret belongs in the input.
|
|
249
|
+
inputRef.current?.focus();
|
|
250
|
+
};
|
|
251
|
+
|
|
252
|
+
const handleBlur = (event: React.FocusEvent<HTMLInputElement>) => {
|
|
253
|
+
// Focus moving INTO the panel is not the end of editing: the panel is a
|
|
254
|
+
// non-modal portal, so clicking a day blurs the input first and only then
|
|
255
|
+
// selects. Committing here would emit the draft and the picked day as two
|
|
256
|
+
// separate values, running whatever the consumer hangs off `onValueChange`
|
|
257
|
+
// twice — the first time on an intermediate the user never meant to submit.
|
|
258
|
+
// The draft is kept, not dropped, so paging the calendar and returning to
|
|
259
|
+
// the input resumes typing; `handleSelect` clears it when a day wins.
|
|
260
|
+
const intoPanel = panel.refs.floating.current?.contains(
|
|
261
|
+
event.relatedTarget as Node | null,
|
|
262
|
+
);
|
|
263
|
+
if (!intoPanel) commitDraft();
|
|
264
|
+
};
|
|
265
|
+
|
|
266
|
+
/**
|
|
267
|
+
* Merge order is load-bearing: the hook's handler runs FIRST, then the
|
|
268
|
+
* caller's. `onBlur` must commit (or hold) the draft before a consumer's own
|
|
269
|
+
* blur logic sees the field, and `onKeyDown` must claim `ArrowDown` for the
|
|
270
|
+
* calendar before anything else reads it.
|
|
271
|
+
*/
|
|
272
|
+
const getInputProps = <T extends Record<string, unknown>>(
|
|
273
|
+
user?: T,
|
|
274
|
+
): T & DateTriggerInputProps => {
|
|
275
|
+
const userChange = user?.onChange as React.ChangeEventHandler<HTMLInputElement> | undefined;
|
|
276
|
+
const userBlur = user?.onBlur as React.FocusEventHandler<HTMLInputElement> | undefined;
|
|
277
|
+
const userKeyDown = user?.onKeyDown as React.KeyboardEventHandler<HTMLInputElement> | undefined;
|
|
278
|
+
|
|
279
|
+
return {
|
|
280
|
+
...(user as T),
|
|
281
|
+
value: displayValue,
|
|
282
|
+
onChange: (event) => {
|
|
283
|
+
setDraft(event.target.value);
|
|
284
|
+
userChange?.(event);
|
|
285
|
+
},
|
|
286
|
+
onBlur: (event) => {
|
|
287
|
+
handleBlur(event);
|
|
288
|
+
userBlur?.(event);
|
|
289
|
+
},
|
|
290
|
+
onKeyDown: (event) => {
|
|
291
|
+
handleTriggerKeyDown(event);
|
|
292
|
+
userKeyDown?.(event);
|
|
293
|
+
},
|
|
294
|
+
// A text input that owns a popup IS a combobox (APG Date Picker
|
|
295
|
+
// Combobox). The role goes on the input rather than on a separate button,
|
|
296
|
+
// because there is no button any more.
|
|
297
|
+
role: 'combobox',
|
|
298
|
+
'aria-haspopup': 'dialog',
|
|
299
|
+
'aria-expanded': open,
|
|
300
|
+
'aria-controls': open ? panelId : undefined,
|
|
301
|
+
};
|
|
302
|
+
};
|
|
303
|
+
|
|
304
|
+
return {
|
|
305
|
+
open,
|
|
306
|
+
displayValue,
|
|
307
|
+
setInputRef,
|
|
308
|
+
triggerProps: {
|
|
309
|
+
ref: panel.refs.setReference,
|
|
310
|
+
onMouseDown: handleTriggerMouseDown,
|
|
311
|
+
onClick: handleTriggerClick,
|
|
312
|
+
},
|
|
313
|
+
getInputProps,
|
|
314
|
+
panel: panel.isMounted ? (
|
|
315
|
+
<FloatingPortal root={panel.portalRoot}>
|
|
316
|
+
{/* `initialFocus={-1}` hands initial focus to the calendar itself:
|
|
317
|
+
react-day-picker's `autoFocus` lands on the selected day (or today),
|
|
318
|
+
whereas the focus manager's own index would land on the first
|
|
319
|
+
chevron. */}
|
|
320
|
+
<FloatingFocusManager context={panel.context} modal={false} initialFocus={-1} returnFocus>
|
|
321
|
+
<div
|
|
322
|
+
ref={panel.refs.setFloating}
|
|
323
|
+
// `panelStyle` is deliberately NOT spread: the substrate's content
|
|
324
|
+
// policy caps a LIST panel at 320px, and the calendar is a fixed 380
|
|
325
|
+
// (dual: 760). The grid sizes the panel here.
|
|
326
|
+
style={panel.floatingStyles}
|
|
327
|
+
// `z-dropdown` for the same reason as in AnchoredPanel: without it a neighbouring
|
|
328
|
+
// Field's floating label (`z-4`) paints through the open calendar.
|
|
329
|
+
className="z-dropdown outline-none"
|
|
330
|
+
{...panel.getFloatingProps({ id: panelId, 'aria-label': panelLabel })}
|
|
331
|
+
>
|
|
332
|
+
{/* The host surface (date-picker 1.0.0 § chrome.host): DatePicker
|
|
333
|
+
paints nothing, so the Popover surface recipe draws fill, border,
|
|
334
|
+
radius and shadow here. No padding and no gap — the month columns
|
|
335
|
+
pad themselves, and the host adds nothing around a bare picker. */}
|
|
336
|
+
<div
|
|
337
|
+
className={popoverSurfaceVariants({ className: 'gap-0 py-0' })}
|
|
338
|
+
style={panel.transitionStyles}
|
|
339
|
+
>
|
|
340
|
+
<DatePicker
|
|
341
|
+
// Only a keyboard open pulls focus onto a day; a click leaves it
|
|
342
|
+
// in the input so typing keeps working.
|
|
343
|
+
autoFocus={openedByKeyboard}
|
|
344
|
+
value={value}
|
|
345
|
+
onValueChange={handleSelect}
|
|
346
|
+
minDate={minDate}
|
|
347
|
+
maxDate={maxDate}
|
|
348
|
+
locale={locale}
|
|
349
|
+
navLabels={navLabels}
|
|
350
|
+
/>
|
|
351
|
+
</div>
|
|
352
|
+
</div>
|
|
353
|
+
</FloatingFocusManager>
|
|
354
|
+
</FloatingPortal>
|
|
355
|
+
) : null,
|
|
356
|
+
};
|
|
357
|
+
}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { init, use as registerModules, type ComposeOption, type ECElementEvent, type EChartsType } from 'echarts/core';
|
|
4
|
+
import { PieChart, type PieSeriesOption } from 'echarts/charts';
|
|
5
|
+
import { SVGRenderer } from 'echarts/renderers';
|
|
6
|
+
|
|
7
|
+
// Modular registration: only what the design system draws ships in the bundle —
|
|
8
|
+
// the pie series and the SVG renderer. No tooltip component: tooltips are the FODS
|
|
9
|
+
// Tooltip atom, never the chart library's default.
|
|
10
|
+
registerModules([PieChart, SVGRenderer]);
|
|
11
|
+
|
|
12
|
+
export type EChartOption = ComposeOption<PieSeriesOption>;
|
|
13
|
+
export type { PieSeriesOption };
|
|
14
|
+
|
|
15
|
+
export type EChartEventName = 'mouseover' | 'mousemove' | 'mouseout' | 'globalout';
|
|
16
|
+
export type EChartEventHandlers = Partial<Record<EChartEventName, (event: ECElementEvent) => void>>;
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* Thin ECharts lifecycle for a design-system chart: init on the container, apply
|
|
20
|
+
* `option` whenever it changes, follow the container size, dispose on unmount.
|
|
21
|
+
*
|
|
22
|
+
* `option` is applied with merge semantics, so a data change MORPHS the existing
|
|
23
|
+
* shapes (matched by data `name`) instead of redrawing them. Pass `null` to keep the
|
|
24
|
+
* chart empty until the container has been measured.
|
|
25
|
+
*
|
|
26
|
+
* `entrance`, when given, is applied INSTEAD of the first `option` a chart instance
|
|
27
|
+
* receives — a sequence of options set back to back, for an enter animation the
|
|
28
|
+
* library's own first-render animation cannot express. Every later `option` is
|
|
29
|
+
* merged as usual, so the entrance never replays on a data change.
|
|
30
|
+
*
|
|
31
|
+
* Returns the instance ref for imperative calls (`dispatchAction`).
|
|
32
|
+
*/
|
|
33
|
+
export function useEChart(
|
|
34
|
+
containerRef: React.RefObject<HTMLElement | null>,
|
|
35
|
+
option: EChartOption | null,
|
|
36
|
+
handlers?: EChartEventHandlers,
|
|
37
|
+
entrance?: readonly EChartOption[] | null,
|
|
38
|
+
): React.RefObject<EChartsType | null> {
|
|
39
|
+
const chartRef = React.useRef<EChartsType | null>(null);
|
|
40
|
+
const enteredRef = React.useRef(false);
|
|
41
|
+
const handlersRef = React.useRef(handlers);
|
|
42
|
+
handlersRef.current = handlers;
|
|
43
|
+
|
|
44
|
+
React.useEffect(() => {
|
|
45
|
+
const container = containerRef.current;
|
|
46
|
+
if (!container) return undefined;
|
|
47
|
+
const chart = init(container, undefined, { renderer: 'svg' });
|
|
48
|
+
chartRef.current = chart;
|
|
49
|
+
enteredRef.current = false;
|
|
50
|
+
|
|
51
|
+
const names: EChartEventName[] = ['mouseover', 'mousemove', 'mouseout', 'globalout'];
|
|
52
|
+
for (const name of names) {
|
|
53
|
+
chart.on(name, (event: unknown) => handlersRef.current?.[name]?.(event as ECElementEvent));
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
// The observer also fires once on `observe()`. `resize()` re-lays the chart with
|
|
57
|
+
// no animation, which would cut a running entrance short — so only a real size
|
|
58
|
+
// change resizes.
|
|
59
|
+
const observer =
|
|
60
|
+
typeof ResizeObserver === 'undefined'
|
|
61
|
+
? null
|
|
62
|
+
: new ResizeObserver(() => {
|
|
63
|
+
if (container.clientWidth !== chart.getWidth() || container.clientHeight !== chart.getHeight()) {
|
|
64
|
+
chart.resize();
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
observer?.observe(container);
|
|
68
|
+
|
|
69
|
+
return () => {
|
|
70
|
+
observer?.disconnect();
|
|
71
|
+
chart.dispose();
|
|
72
|
+
chartRef.current = null;
|
|
73
|
+
};
|
|
74
|
+
}, [containerRef]);
|
|
75
|
+
|
|
76
|
+
React.useEffect(() => {
|
|
77
|
+
const chart = chartRef.current;
|
|
78
|
+
if (!chart || !option) return;
|
|
79
|
+
if (!enteredRef.current && entrance) {
|
|
80
|
+
entrance.forEach(step => chart.setOption(step));
|
|
81
|
+
} else {
|
|
82
|
+
chart.setOption(option);
|
|
83
|
+
}
|
|
84
|
+
enteredRef.current = true;
|
|
85
|
+
}, [option, entrance]);
|
|
86
|
+
|
|
87
|
+
return chartRef;
|
|
88
|
+
}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { observerThresholds, viewportPlacement } from './enterOnViewGeometry';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* A once-only entrance on first viewport entry, with no motion library: the hook only
|
|
7
|
+
* decides WHEN; the keyframes live in `styles/motion.css` and the gating classes on the
|
|
8
|
+
* component (`group-data-[…]`). First consumer: Hero (`hero.manifest.json` 1.5.2
|
|
9
|
+
* `motion.enter` — "Plays once, on first viewport entry (IntersectionObserver 0.3)").
|
|
10
|
+
*
|
|
11
|
+
* - `static` — the final pose, no animation. Where IntersectionObserver is missing,
|
|
12
|
+
* under `prefers-reduced-motion`, and for an element first seen already scrolled past
|
|
13
|
+
* (in the top-level document; inside a frame it stays armed, see `viewportPlacement`).
|
|
14
|
+
* - `armed` — the entrance's start pose (hidden), waiting for the viewport.
|
|
15
|
+
* - `play` — the entrance runs, once; the state never leaves `play` afterwards.
|
|
16
|
+
*
|
|
17
|
+
* Never a flash of visible content that then disappears:
|
|
18
|
+
* - Server render and hydration start in `play`. The markup reaches the browser with the
|
|
19
|
+
* animation already on, so the CSS plays it on first paint and no JS is needed; the
|
|
20
|
+
* hydration render matches it and React never touches the attribute again.
|
|
21
|
+
* - A client-only mount (route change, Storybook) arms in a layout
|
|
22
|
+
* effect, i.e. before the first paint, and the observer flips it to `play`.
|
|
23
|
+
* The gating classes are `motion-safe:` only, so reduced motion renders the final pose in
|
|
24
|
+
* every state — the JS check below just spares the observer.
|
|
25
|
+
*/
|
|
26
|
+
export type EnterOnViewState = 'static' | 'armed' | 'play';
|
|
27
|
+
|
|
28
|
+
const noopSubscribe = () => () => {};
|
|
29
|
+
|
|
30
|
+
const useIsomorphicLayoutEffect = typeof window === 'undefined' ? React.useEffect : React.useLayoutEffect;
|
|
31
|
+
|
|
32
|
+
/** The document sits in a frame: the observer then reports against the top page's viewport. */
|
|
33
|
+
const isEmbedded = (): boolean => typeof window !== 'undefined' && window.self !== window.top;
|
|
34
|
+
|
|
35
|
+
const prefersReducedMotion = (): boolean =>
|
|
36
|
+
typeof window !== 'undefined' && Boolean(window.matchMedia?.('(prefers-reduced-motion: reduce)').matches);
|
|
37
|
+
|
|
38
|
+
export function useEnterOnView<T extends HTMLElement>(
|
|
39
|
+
ref: React.RefObject<T | null>,
|
|
40
|
+
threshold = 0.3,
|
|
41
|
+
): EnterOnViewState {
|
|
42
|
+
// `true` only while rendering on the server or hydrating its markup — the two renders
|
|
43
|
+
// whose output the browser may already have painted.
|
|
44
|
+
const fromServer = React.useSyncExternalStore(noopSubscribe, () => false, () => true);
|
|
45
|
+
const [state, setState] = React.useState<EnterOnViewState>(() => (fromServer ? 'play' : 'static'));
|
|
46
|
+
// Once played (or server-started), never armed again — not by a re-run of the effect.
|
|
47
|
+
const done = React.useRef(state === 'play');
|
|
48
|
+
|
|
49
|
+
useIsomorphicLayoutEffect(() => {
|
|
50
|
+
const element = ref.current;
|
|
51
|
+
if (done.current || !element) return undefined;
|
|
52
|
+
if (typeof IntersectionObserver === 'undefined' || prefersReducedMotion()) return undefined;
|
|
53
|
+
|
|
54
|
+
setState('armed');
|
|
55
|
+
const embedded = isEmbedded();
|
|
56
|
+
const observer = new IntersectionObserver((entries) => {
|
|
57
|
+
entries.forEach((entry) => {
|
|
58
|
+
const { inView, past } = viewportPlacement(entry, threshold, embedded);
|
|
59
|
+
if (past) {
|
|
60
|
+
// Already scrolled past (restored scroll position, anchor jump): show it as is.
|
|
61
|
+
done.current = true;
|
|
62
|
+
setState('static');
|
|
63
|
+
observer.disconnect();
|
|
64
|
+
} else if (inView) {
|
|
65
|
+
done.current = true;
|
|
66
|
+
setState('play');
|
|
67
|
+
observer.disconnect();
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
}, { threshold: observerThresholds(threshold) });
|
|
71
|
+
observer.observe(element);
|
|
72
|
+
|
|
73
|
+
return () => {
|
|
74
|
+
observer.disconnect();
|
|
75
|
+
setState(current => (current === 'armed' ? 'static' : current));
|
|
76
|
+
};
|
|
77
|
+
}, [ref, threshold]);
|
|
78
|
+
|
|
79
|
+
return state;
|
|
80
|
+
}
|