@invoiceonline/ui-react 0.0.0 → 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 +77 -1
- 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 +351 -3
- 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,259 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import * as React from 'react';
|
|
4
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
5
|
+
import { Icon, type IconName, type IconSize } from '../icon/Icon';
|
|
6
|
+
import { MotionCaret } from '../../internal/MotionCaret';
|
|
7
|
+
import { cn } from '../../internal/utils';
|
|
8
|
+
import { textFieldShellVariants, textFieldValueVariants } from '../text-field/TextField';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* ComboboxField — the GENERIC TRIGGER of a type-to-narrow picker over a set too
|
|
12
|
+
* large to scan, where picking commits one plain value. Explicitly NOT the ARES
|
|
13
|
+
* subject lookup: manifest 1.6.3 `intent.whenToUse` hands the customer
|
|
14
|
+
* (Odběratel) and supplier (Dodavatel) lookup surfaces to its own molecule, Subject Lookup Field, which
|
|
15
|
+
* queries saved contacts and the registry at once and autofills an identity block.
|
|
16
|
+
* It draws the Text Field shell around a
|
|
17
|
+
* native `<input role="combobox">`; the result list is NOT part of this component —
|
|
18
|
+
* that surface is composed separately from `popoverSurfaceVariants` + `ListRow`.
|
|
19
|
+
*
|
|
20
|
+
* `state` is a FLOW axis — the life-cycle of ONE search — not a matrix of independent
|
|
21
|
+
* skins: default → focused (empty) → typing → loading → open (results) → selected,
|
|
22
|
+
* with the clear × on `selected` resetting back toward `default`. Only three things
|
|
23
|
+
* move across the flow: the border, the value ink, and the trailing indicator.
|
|
24
|
+
*
|
|
25
|
+
* There is deliberately NO error / success / disabled / readonly axis: registry
|
|
26
|
+
* validation (invalid IČO, verifying, verified, retry) belongs on the manual-entry
|
|
27
|
+
* TextFields that the overlay's "Zadám vše o subjektu ručně" escape hatch opens.
|
|
28
|
+
*
|
|
29
|
+
* Focus is a BORDER SWAP to `--outline-focus`, no additive ring (Text Field parity).
|
|
30
|
+
*
|
|
31
|
+
* `Field` integration: ComboboxField intentionally has no entry in `Field`'s
|
|
32
|
+
* `FIELD_CHILD_TRAITS` — it behaves like TextField, so the label floats once the
|
|
33
|
+
* field is focused or filled. Note that `Field` also floats whenever a `placeholder` is
|
|
34
|
+
* set, which the spec's Default copy always is: wrapped in `Field`, the resting field
|
|
35
|
+
* therefore shows the floated label chip ABOVE the interior placeholder. Figma's Default
|
|
36
|
+
* variant instead hides the label entirely (the 2026-07-09 fix upstream). Ours is the
|
|
37
|
+
* deliberate deviation — the repo-wide `Field` float rule wins, and it keeps a visible
|
|
38
|
+
* label on a resting field instead of leaving the placeholder as the only name.
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
export type ComboboxFieldSize = 'md' | 'sm';
|
|
42
|
+
export type ComboboxFieldState =
|
|
43
|
+
| 'default'
|
|
44
|
+
| 'focused'
|
|
45
|
+
| 'typing'
|
|
46
|
+
| 'loading'
|
|
47
|
+
| 'open'
|
|
48
|
+
| 'selected';
|
|
49
|
+
|
|
50
|
+
export interface ComboboxFieldBaseProps
|
|
51
|
+
extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'> {
|
|
52
|
+
/** Field height — Medium (48) standard invoice forms, Small (40) dense filter bars */
|
|
53
|
+
size?: ComboboxFieldSize;
|
|
54
|
+
/**
|
|
55
|
+
* Optional leading search magnifier (`magnifying-glass`). Available on the shell but OFF by
|
|
56
|
+
* default — the shipped trigger leads with the label and shows only the trailing
|
|
57
|
+
* indicator. The ARES-specific chrome lives in the separate Subject Lookup pattern.
|
|
58
|
+
*/
|
|
59
|
+
leadingIcon?: IconName;
|
|
60
|
+
/** Additional className for the shell */
|
|
61
|
+
className?: string;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* The clear × is spec-mandatory on `selected` (overlay decision S6 — single-value clear
|
|
66
|
+
* lives on the trigger, never inside a result row), so the flow state and the clear
|
|
67
|
+
* affordance are ONE contract: `state="selected"` requires `onClear`, and `onClear`
|
|
68
|
+
* requires a `clearLabel` — the button is icon-only and can never ship nameless
|
|
69
|
+
* (WCAG 4.1.2). Every other state refuses both props: the trailing slot belongs to the
|
|
70
|
+
* state machine, not to the consumer.
|
|
71
|
+
*/
|
|
72
|
+
type ComboboxFieldClearButton =
|
|
73
|
+
| {
|
|
74
|
+
state: 'selected';
|
|
75
|
+
onClear: () => void;
|
|
76
|
+
clearLabel: string;
|
|
77
|
+
/**
|
|
78
|
+
* Optional second line under the committed value — the picked entity's second
|
|
79
|
+
* fact (the IBAN under a bank-account name) or a two-word note that it is
|
|
80
|
+
* missing (`IBAN nevyplněn`). Not a helper: never a rule, hint or error.
|
|
81
|
+
* Selected only (manifest 1.8.0 parts.value-description), hence typed here.
|
|
82
|
+
*/
|
|
83
|
+
valueDescription?: string;
|
|
84
|
+
}
|
|
85
|
+
| {
|
|
86
|
+
/** Flow state — the life-cycle of one search, not a set of independent looks. */
|
|
87
|
+
state?: Exclude<ComboboxFieldState, 'selected'>;
|
|
88
|
+
onClear?: undefined;
|
|
89
|
+
clearLabel?: undefined;
|
|
90
|
+
valueDescription?: undefined;
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
export type ComboboxFieldProps = ComboboxFieldBaseProps & ComboboxFieldClearButton;
|
|
94
|
+
|
|
95
|
+
// Value description run — Body/S, --text-secondary, one line with ellipsis
|
|
96
|
+
// (manifest 1.8.0 typography.runs / text.value-description).
|
|
97
|
+
const comboboxValueDescriptionVariants = tv({
|
|
98
|
+
base: 'truncate font-inter font-normal text-body-sm text-text-secondary',
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
/** States in which the popup is open, so `aria-expanded` derives to true. */
|
|
102
|
+
const EXPANDED_STATES: readonly ComboboxFieldState[] = ['typing', 'loading', 'open'];
|
|
103
|
+
|
|
104
|
+
/** States that paint the focus border (`--outline-focus`) instead of the resting one. */
|
|
105
|
+
const FOCUS_BORDER_STATES: readonly ComboboxFieldState[] = [
|
|
106
|
+
'focused',
|
|
107
|
+
'typing',
|
|
108
|
+
'loading',
|
|
109
|
+
'open',
|
|
110
|
+
];
|
|
111
|
+
|
|
112
|
+
const ComboboxField = React.forwardRef<HTMLInputElement, ComboboxFieldProps>(
|
|
113
|
+
(
|
|
114
|
+
{
|
|
115
|
+
className,
|
|
116
|
+
size = 'md',
|
|
117
|
+
state = 'default',
|
|
118
|
+
leadingIcon,
|
|
119
|
+
onClear,
|
|
120
|
+
clearLabel,
|
|
121
|
+
disabled,
|
|
122
|
+
// The browser's autofill panel renders over the result listbox and competes with
|
|
123
|
+
// it for the same keystrokes, so a combobox input opts out by default (ARIA APG
|
|
124
|
+
// combobox pattern). Overridable — a consumer wiring a real address field may want it.
|
|
125
|
+
autoComplete = 'off',
|
|
126
|
+
'aria-expanded': ariaExpanded,
|
|
127
|
+
'aria-describedby': ariaDescribedBy,
|
|
128
|
+
valueDescription,
|
|
129
|
+
...props
|
|
130
|
+
},
|
|
131
|
+
ref,
|
|
132
|
+
) => {
|
|
133
|
+
const descriptionId = React.useId();
|
|
134
|
+
const showDescription = state === 'selected' && Boolean(valueDescription);
|
|
135
|
+
// The description is not part of the input's value: the <input> holds the first
|
|
136
|
+
// line only and points at the description (combobox-field.md § Accessibility).
|
|
137
|
+
const describedBy =
|
|
138
|
+
[ariaDescribedBy, showDescription ? descriptionId : null].filter(Boolean).join(' ') ||
|
|
139
|
+
undefined;
|
|
140
|
+
|
|
141
|
+
// The flow state maps onto the two Text Field shell states we need: `default`
|
|
142
|
+
// (which already carries `focus-within:border-outline-focus`) for the resting
|
|
143
|
+
// and committed ends of the flow, `focused` for the four mid-search states.
|
|
144
|
+
const shellState = FOCUS_BORDER_STATES.includes(state) ? 'focused' : 'default';
|
|
145
|
+
|
|
146
|
+
// Every glyph in the shell — leading magnifier, caret, spinner, clear × — uses the
|
|
147
|
+
// Text Field icon tier: the trailing slot inside the nested Text Field instance
|
|
148
|
+
// measures 24×24 on Medium and 20×20 on Small in Figma, same as TextField and
|
|
149
|
+
// SelectField. The manifest's 2026-07-15 change was about the GLYPH (caret-down →
|
|
150
|
+
// caret-down-small), which is what the caret below renders. The box is the
|
|
151
|
+
// glyph's size step: sizes[].icon = --size-icon (24) / --size-icon-small (20).
|
|
152
|
+
const iconSize: IconSize = size === 'sm' ? 'small' : 'default';
|
|
153
|
+
|
|
154
|
+
// `loading` is mid-search WITH the panel open (it announces "Vyhledávám…" through
|
|
155
|
+
// the popup's live region), so it derives to expanded like `typing` / `open`. An
|
|
156
|
+
// explicitly passed `aria-expanded` always wins — the organism owning the popup
|
|
157
|
+
// knows better. `aria-controls` / `aria-activedescendant` are never derived: they
|
|
158
|
+
// reference ids this field does not own, so they only pass through.
|
|
159
|
+
const isExpanded = ariaExpanded ?? EXPANDED_STATES.includes(state);
|
|
160
|
+
|
|
161
|
+
let trailingEl: React.ReactNode;
|
|
162
|
+
if (state === 'loading') {
|
|
163
|
+
trailingEl = (
|
|
164
|
+
<Icon
|
|
165
|
+
name="spinner"
|
|
166
|
+
size={iconSize}
|
|
167
|
+
className="shrink-0 animate-spin text-text-secondary"
|
|
168
|
+
/>
|
|
169
|
+
);
|
|
170
|
+
// The × renders on `selected` regardless of a (type-guaranteed) `onClear`, so a
|
|
171
|
+
// plain-JS caller that drops the handler still gets the spec's indicator, not a
|
|
172
|
+
// caret that lies about the state.
|
|
173
|
+
} else if (state === 'selected') {
|
|
174
|
+
trailingEl = (
|
|
175
|
+
<button
|
|
176
|
+
type="button"
|
|
177
|
+
onClick={onClear}
|
|
178
|
+
// A `disabled` input has to neutralise the clear affordance too — otherwise
|
|
179
|
+
// the × stays focusable and clickable and can still change the value of a
|
|
180
|
+
// field the consumer has switched off (TextField parity).
|
|
181
|
+
disabled={disabled}
|
|
182
|
+
aria-label={clearLabel}
|
|
183
|
+
className="flex min-h-800 min-w-800 shrink-0 items-center justify-center rounded-200 text-text-secondary outline-none focus-visible:ring-200 focus-visible:ring-outline-focus cursor-pointer disabled:cursor-not-allowed"
|
|
184
|
+
>
|
|
185
|
+
<Icon name="x-small" size={iconSize} className="shrink-0" />
|
|
186
|
+
</button>
|
|
187
|
+
);
|
|
188
|
+
} else {
|
|
189
|
+
// One glyph that turns 180° while the list is open (typing / results).
|
|
190
|
+
trailingEl = (
|
|
191
|
+
<MotionCaret open={state === 'typing' || state === 'open'}>
|
|
192
|
+
<Icon name="caret-down-small" size={iconSize} className="shrink-0 text-icon-muted" />
|
|
193
|
+
</MotionCaret>
|
|
194
|
+
);
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
const inputEl = (
|
|
198
|
+
<input
|
|
199
|
+
ref={ref}
|
|
200
|
+
type="text"
|
|
201
|
+
role="combobox"
|
|
202
|
+
data-fods-part="value"
|
|
203
|
+
autoComplete={autoComplete}
|
|
204
|
+
aria-autocomplete="list"
|
|
205
|
+
aria-expanded={isExpanded}
|
|
206
|
+
aria-busy={state === 'loading' || undefined}
|
|
207
|
+
aria-describedby={describedBy}
|
|
208
|
+
disabled={disabled}
|
|
209
|
+
className={textFieldValueVariants({ state: 'default' })}
|
|
210
|
+
{...props}
|
|
211
|
+
/>
|
|
212
|
+
);
|
|
213
|
+
|
|
214
|
+
return (
|
|
215
|
+
<div
|
|
216
|
+
// data-fods-* mark the parts the FODS verifier measures in the browser.
|
|
217
|
+
// Not inert in this package: `styles/base.css` scopes its reset to them.
|
|
218
|
+
// This component shares TextField's shell recipe but renders its own
|
|
219
|
+
// markup, so the attributes have to be repeated here.
|
|
220
|
+
data-fods-component="combobox-field"
|
|
221
|
+
data-fods-part="root"
|
|
222
|
+
className={cn(
|
|
223
|
+
textFieldShellVariants({ inputSize: size, state: shellState }),
|
|
224
|
+
// With a description the fixed height becomes the minimum: the shell hugs
|
|
225
|
+
// two text lines with --space-500 above and below (sizes[].note).
|
|
226
|
+
showDescription && ['h-auto py-500', size === 'sm' ? 'min-h-1000' : 'min-h-1100'],
|
|
227
|
+
className,
|
|
228
|
+
)}
|
|
229
|
+
>
|
|
230
|
+
{leadingIcon ? (
|
|
231
|
+
<Icon
|
|
232
|
+
name={leadingIcon}
|
|
233
|
+
size={iconSize}
|
|
234
|
+
className="shrink-0 text-icon-muted"
|
|
235
|
+
/>
|
|
236
|
+
) : null}
|
|
237
|
+
|
|
238
|
+
{/* Always wrapped: toggling the wrapper would remount the input (focus, typed text). */}
|
|
239
|
+
<div className="flex min-w-0 flex-1 flex-col">
|
|
240
|
+
{inputEl}
|
|
241
|
+
{showDescription ? (
|
|
242
|
+
<span
|
|
243
|
+
id={descriptionId}
|
|
244
|
+
data-fods-part="value-description"
|
|
245
|
+
className={comboboxValueDescriptionVariants()}
|
|
246
|
+
>
|
|
247
|
+
{valueDescription}
|
|
248
|
+
</span>
|
|
249
|
+
) : null}
|
|
250
|
+
</div>
|
|
251
|
+
|
|
252
|
+
{trailingEl}
|
|
253
|
+
</div>
|
|
254
|
+
);
|
|
255
|
+
},
|
|
256
|
+
);
|
|
257
|
+
ComboboxField.displayName = 'ComboboxField';
|
|
258
|
+
|
|
259
|
+
export { ComboboxField };
|
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as DateFieldStories from './DateField.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={DateFieldStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# DateField
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** molecule
|
|
11
|
+
- **Status:** stable
|
|
12
|
+
- **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-weight-normal`, `--icon-muted`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--radius-200`, `--radius-400`, `--space-1000`, `--space-1100`, `--space-400`, `--space-500`, `--status-danger`, `--status-success-solid`, `--text-placeholder`, `--text-primary`, `--text-secondary`
|
|
13
|
+
- **Manifest version:** `1.2.1` (`spec/04-molecules/date-picker.manifest.json` — the panel's manifest; DateField has no manifest of its own)
|
|
14
|
+
|
|
15
|
+
## Overview
|
|
16
|
+
|
|
17
|
+
DateField is the field a Date Picker opens from — a Text Field shell with a calendar glyph in the
|
|
18
|
+
leading slot. Because it is a real editable `<input>`, a date can be **typed as well as picked**;
|
|
19
|
+
the typed draft is parsed against `dateFormat` on blur. Use it for any single date in a form: expense
|
|
20
|
+
date, invoice issue date, taxable date, due date. **Do not** use it for a date *range* — reach for the
|
|
21
|
+
dual-month [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) directly, this field
|
|
22
|
+
holds one date. Do not use it for a free-form "period" or "month" selector either; the panel is a day
|
|
23
|
+
grid.
|
|
24
|
+
|
|
25
|
+
**Typing is bounded exactly like picking.** A draft that does not parse is discarded rather than
|
|
26
|
+
coerced — and so is one that parses but lands outside `minDate` / `maxDate`, since the panel disables
|
|
27
|
+
those days outright. In both cases `onValueChange` is not called at all and the field falls back to the
|
|
28
|
+
value it still holds, so a controlled value can never leave the bounds by the keyboard route.
|
|
29
|
+
|
|
30
|
+
**One user action reports one value.** Clicking a day over a half-typed draft does not commit the draft
|
|
31
|
+
first: the panel is a non-modal portal, so the click blurs the input before it selects, and that blur is
|
|
32
|
+
recognised as focus moving *into* the panel rather than the end of editing. Only the picked day reaches
|
|
33
|
+
`onValueChange`, so validation or autosave hung off it runs once — never on an intermediate the user
|
|
34
|
+
never meant to submit. The draft survives paging the calendar and returning to the input.
|
|
35
|
+
|
|
36
|
+
## Rationale
|
|
37
|
+
|
|
38
|
+
Upstream is explicit that a date field is a **sibling of Text Field, not a Select**:
|
|
39
|
+
|
|
40
|
+
- `_text-field-inventory.md` lists *"Date — issue date, taxable date"* as a **Text Field row**, while
|
|
41
|
+
Selects sit in a separate section titled *"Adjacent — not a Text Field"*.
|
|
42
|
+
- `_text-field-planning.md`, decision 2: *"**Textarea** and **Date Picker** are **separate siblings**
|
|
43
|
+
that reuse `_inputShell`."*
|
|
44
|
+
|
|
45
|
+
That is why the `SelectField` pattern (a read-only `<button role="combobox">`) is **deliberately not
|
|
46
|
+
reused** here: it would take typing away. For a keyboard user filling a long invoice form, keying a
|
|
47
|
+
date is faster than paging through a calendar.
|
|
48
|
+
|
|
49
|
+
**The whole field is the trigger, and the glyph is decoration.** No spec file states which side the
|
|
50
|
+
glyph sits on: `text-field.md` describes the leading slot as a *"contextual glyph (search)"* and the
|
|
51
|
+
trailing slot as *"clear / password-reveal"*, and neither names a calendar — so the position follows the
|
|
52
|
+
design. `field-readonly.md:69` is the single place the glyph is mentioned at all, and it agrees with
|
|
53
|
+
this model: the icon is *"a quiet affordance, **not an active control**"* and it is *"**the trigger**"*
|
|
54
|
+
— i.e. the field — that opens the calendar. Hence `role="combobox"` on the input (the APG *Date Picker
|
|
55
|
+
Combobox* pattern) rather than `aria-haspopup` on a button, because there is no button.
|
|
56
|
+
|
|
57
|
+
> Superseded: an earlier build put the calendar in the trailing slot as an interactive icon button and
|
|
58
|
+
> justified it from the *"busy slot"* wording of the grill documents. That wording is about Select
|
|
59
|
+
> carets and password-reveals, not about a date field, and the grill documents are working notes rather
|
|
60
|
+
> than canonical spec.
|
|
61
|
+
|
|
62
|
+
## Anatomy
|
|
63
|
+
|
|
64
|
+
- **Shell** — the Text Field shell: border, fill, `--radius-400`, height tier. Owns the floating-label
|
|
65
|
+
notch and the focus border swap.
|
|
66
|
+
- **Value input** — a native, editable `<input type="text">` showing either the value formatted with
|
|
67
|
+
`dateFormat`, or the placeholder pattern.
|
|
68
|
+
- **Leading calendar glyph** — the `calendar-dots` icon, **decorative** (`aria-hidden`): it marks what the
|
|
69
|
+
field holds and is not focusable. In read-only it steps down from `--text-secondary` to `--icon-muted`
|
|
70
|
+
(`field-readonly.md`).
|
|
71
|
+
- **The input carries the ARIA** — `role="combobox"`, `aria-haspopup="dialog"`, `aria-expanded` and
|
|
72
|
+
`aria-controls`.
|
|
73
|
+
- **The wrapper carries the click** — "the whole field is the trigger" is literal: the open handler
|
|
74
|
+
sits on the wrapper, not on the `<input>`, because the glyph and the shell padding are the input's
|
|
75
|
+
*siblings* and would otherwise be dead area. A press that did not land in the input is handled on
|
|
76
|
+
mouse-down so focus never leaves the input — a half-typed draft survives and the label does not
|
|
77
|
+
flicker — and the field stays typeable. It opens but does **not** toggle, so clicking into the text to
|
|
78
|
+
place the caret while the calendar is up keeps it up. `ArrowDown` opens it too — and, when it is
|
|
79
|
+
already open, moves focus into the day grid.
|
|
80
|
+
- **Panel** — the [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) rendered in a
|
|
81
|
+
portal, anchored via `useAnchoredPanel` (`role: 'dialog'`, `focusModel: 'roving'`,
|
|
82
|
+
`navigation: 'none'` — the day grid owns the arrow keys, `widthPolicy: 'content'` — the calendar hugs
|
|
83
|
+
its own grid instead of the trigger width). Since date-picker 1.0.0 the calendar paints no surface,
|
|
84
|
+
so the panel wraps it in the Popover surface recipe (`popoverSurfaceVariants`, padless — the month
|
|
85
|
+
columns pad themselves): same `--bg-primary` fill, 1px `--outline-default` border, `--radius-500`
|
|
86
|
+
corners and `--shadow-overlay` as before, now owned by the host.
|
|
87
|
+
- **Label / helper / error line** — live in [`Field`](?path=/docs/design-system-atoms-field--docs), not
|
|
88
|
+
here. DateField is the shell + value only.
|
|
89
|
+
|
|
90
|
+
<Canvas of={DateFieldStories.WithField} />
|
|
91
|
+
|
|
92
|
+
## Variants
|
|
93
|
+
|
|
94
|
+
**No variant axis.** DateField is one field with one job — pick or type a single date. Everything that
|
|
95
|
+
would otherwise be a variant is either a **size** (height tier) or a **state**. The display pattern is
|
|
96
|
+
data (`dateFormat`), not a variant. There is therefore no `Variants` story.
|
|
97
|
+
|
|
98
|
+
## Matrix
|
|
99
|
+
|
|
100
|
+
<Canvas of={DateFieldStories.Matrix} />
|
|
101
|
+
|
|
102
|
+
The full state × size grid, mirroring the Figma labelled grid — rows are states, columns are sizes.
|
|
103
|
+
|
|
104
|
+
## Sizes
|
|
105
|
+
|
|
106
|
+
<Canvas of={DateFieldStories.Sizes} />
|
|
107
|
+
|
|
108
|
+
<table>
|
|
109
|
+
<thead>
|
|
110
|
+
<tr>
|
|
111
|
+
<th>Size</th>
|
|
112
|
+
<th>Height</th>
|
|
113
|
+
<th>Icon</th>
|
|
114
|
+
<th>When</th>
|
|
115
|
+
</tr>
|
|
116
|
+
</thead>
|
|
117
|
+
<tbody>
|
|
118
|
+
<tr>
|
|
119
|
+
<td><code>md</code> (default)</td>
|
|
120
|
+
<td>48 px (<code>h-1100</code>)</td>
|
|
121
|
+
<td>24 px</td>
|
|
122
|
+
<td>Standalone field in a form</td>
|
|
123
|
+
</tr>
|
|
124
|
+
<tr>
|
|
125
|
+
<td><code>sm</code></td>
|
|
126
|
+
<td>40 px (<code>h-1000</code>)</td>
|
|
127
|
+
<td>20 px</td>
|
|
128
|
+
<td>Dense rows (invoice item rows, list filters)</td>
|
|
129
|
+
</tr>
|
|
130
|
+
</tbody>
|
|
131
|
+
</table>
|
|
132
|
+
|
|
133
|
+
Padding and font are the Text Field tiers: `px-500` / `gap-400`, value always Body/M/Regular.
|
|
134
|
+
|
|
135
|
+
## States
|
|
136
|
+
|
|
137
|
+
<Canvas of={DateFieldStories.States} />
|
|
138
|
+
|
|
139
|
+
<table>
|
|
140
|
+
<thead>
|
|
141
|
+
<tr>
|
|
142
|
+
<th>State</th>
|
|
143
|
+
<th>Shell</th>
|
|
144
|
+
<th>Value / icon</th>
|
|
145
|
+
<th>Behaviour</th>
|
|
146
|
+
</tr>
|
|
147
|
+
</thead>
|
|
148
|
+
<tbody>
|
|
149
|
+
<tr>
|
|
150
|
+
<td><code>default</code></td>
|
|
151
|
+
<td>border <code>--outline-default</code>, on focus-within <code>--outline-focus</code></td>
|
|
152
|
+
<td>value <code>--text-primary</code>, placeholder <code>--text-placeholder</code>, icon <code>--text-secondary</code></td>
|
|
153
|
+
<td>Typing allowed; a click <em>anywhere in the field</em> (glyph and padding included) or <code>ArrowDown</code> opens the panel</td>
|
|
154
|
+
</tr>
|
|
155
|
+
<tr>
|
|
156
|
+
<td><code>success</code></td>
|
|
157
|
+
<td>border <code>--status-success-solid</code></td>
|
|
158
|
+
<td>calendar glyph <strong>stays</strong> leading; the <code>check</code> status icon takes the trailing slot</td>
|
|
159
|
+
<td>Unchanged; injected by <code>Field</code> when it is given a <code>success</code> message</td>
|
|
160
|
+
</tr>
|
|
161
|
+
<tr>
|
|
162
|
+
<td><code>error</code></td>
|
|
163
|
+
<td>border <code>--status-danger</code></td>
|
|
164
|
+
<td>calendar glyph <strong>stays</strong> in the leading slot; the intrinsic status icon takes the <em>trailing</em> slot, so the two never collide</td>
|
|
165
|
+
<td>Unchanged; sets <code>aria-invalid</code></td>
|
|
166
|
+
</tr>
|
|
167
|
+
<tr>
|
|
168
|
+
<td><code>disabled</code></td>
|
|
169
|
+
<td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--disabled-background</code> fill</td>
|
|
170
|
+
<td>ink <code>--disabled-foreground</code></td>
|
|
171
|
+
<td>Input disabled and out of tab order; the panel cannot open</td>
|
|
172
|
+
</tr>
|
|
173
|
+
<tr>
|
|
174
|
+
<td><code>readonly</code></td>
|
|
175
|
+
<td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--bg-readonly</code> fill</td>
|
|
176
|
+
<td>value <code>--text-primary</code>, icon <code>--icon-muted</code></td>
|
|
177
|
+
<td>Shows the value, is copyable and submits with the form, but the trigger <strong>does not open the calendar</strong> (<code>field-readonly.md:69</code>); carries <code>aria-readonly</code></td>
|
|
178
|
+
</tr>
|
|
179
|
+
</tbody>
|
|
180
|
+
</table>
|
|
181
|
+
|
|
182
|
+
Interactive states are CSS, not props: focus is a border-colour swap on the shell. The field has a
|
|
183
|
+
single focusable element — the input — so there is no second focus ring to reason about.
|
|
184
|
+
|
|
185
|
+
## Mobile
|
|
186
|
+
|
|
187
|
+
A **single** date field needs nothing special on a phone. The two things that do move belong to the
|
|
188
|
+
panel it opens, and are worth knowing here because this is where the decision gets made
|
|
189
|
+
(manifest `date-picker` 1.2.1 § `chrome.mobile` — see [DatePicker → Mobile](?path=/docs/design-system-molecules-datepicker--docs#mobile)):
|
|
190
|
+
|
|
191
|
+
- The single-month picker steps its **side padding** down below `md` (768px), `--space-600` → `--space-400`, so its 364px minimum clears a 390px viewport.
|
|
192
|
+
- The popover may **flip/shift past the page's own 16px gutter** toward the viewport edge; it is not confined to the padded content column.
|
|
193
|
+
|
|
194
|
+
**A date range is the case that does not scale down.** Two DateFields side by side do not fit a
|
|
195
|
+
phone column, and the dual-month DatePicker — the desktop answer — fits no phone viewport at all
|
|
196
|
+
(~760px, and the 48×36 Day Cell is a touch target that must not shrink — its `<button>` fills the
|
|
197
|
+
whole cell, so 48×36 is the real hit area and not just the tile). On mobile a range is
|
|
198
|
+
therefore a [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) in `format="date"`:
|
|
199
|
+
two fused cells, each opening its **own** single-month panel, no shared calendar and no cross-field
|
|
200
|
+
`minDate`/`maxDate`.
|
|
201
|
+
|
|
202
|
+
## API
|
|
203
|
+
|
|
204
|
+
<Controls of={DateFieldStories.Playground} />
|
|
205
|
+
|
|
206
|
+
<table>
|
|
207
|
+
<thead>
|
|
208
|
+
<tr>
|
|
209
|
+
<th>Prop</th>
|
|
210
|
+
<th>Type</th>
|
|
211
|
+
<th>Default</th>
|
|
212
|
+
<th>Notes</th>
|
|
213
|
+
</tr>
|
|
214
|
+
</thead>
|
|
215
|
+
<tbody>
|
|
216
|
+
<tr><td><code>value</code></td><td><code>Date</code></td><td>—</td><td>Controlled. The chosen date.</td></tr>
|
|
217
|
+
<tr><td><code>onValueChange</code></td><td><code>(value: Date | undefined) => void</code></td><td>—</td><td>Fires on day pick and on a committed draft; <code>undefined</code> means "unset".</td></tr>
|
|
218
|
+
<tr><td><code>size</code></td><td><code>'md' | 'sm'</code></td><td><code>'md'</code></td><td>Text Field height tier.</td></tr>
|
|
219
|
+
<tr><td><code>state</code></td><td><code>'default' | 'focused' | 'error' | 'success' | 'disabled' | 'readonly'</code></td><td><code>'default'</code></td><td>Visual state; usually driven by <code>Field</code>.</td></tr>
|
|
220
|
+
<tr><td><code>dateFormat</code></td><td><code>string</code></td><td><code>dd. MM. yyyy</code></td><td>Display <em>and</em> parse pattern, date-fns syntax.</td></tr>
|
|
221
|
+
<tr><td><code>locale</code></td><td><code>Locale</code> (date-fns)</td><td><code>cs</code></td><td>Drives week start, weekday names, month caption.</td></tr>
|
|
222
|
+
<tr><td><code>minDate</code> / <code>maxDate</code></td><td><code>Date</code></td><td>—</td><td>Bounds the window the panel offers (out-of-range days render disabled) <em>and</em> the typed draft — an out-of-range date is discarded on commit, day-granular.</td></tr>
|
|
223
|
+
<tr><td><code>placeholder</code></td><td><code>string</code></td><td>—</td><td>Show the expected pattern here, never the label.</td></tr>
|
|
224
|
+
<tr><td><code>id</code> / <code>name</code></td><td><code>string</code></td><td>—</td><td><code>id</code> is required for <code>Field</code> to wire label + helper text.</td></tr>
|
|
225
|
+
<tr><td><code>disabled</code> / <code>readOnly</code></td><td><code>boolean</code></td><td>—</td><td>Native attributes; win over <code>state</code> when set explicitly.</td></tr>
|
|
226
|
+
<tr><td><code>panelLabel</code> <strong>(required)</strong></td><td><code>string</code></td><td>—</td><td><code>aria-label</code> of the panel dialog. No default: the design system is locale-agnostic, and a name invisible to sighted review is exactly the kind that ships untranslated.</td></tr>
|
|
227
|
+
<tr><td><code>navLabels</code> <strong>(required)</strong></td><td><code>{ previousMonth, nextMonth, previousYear, nextYear }</code></td><td>—</td><td>Accessible names for the panel's four chevrons, passed straight through to <code>DatePicker</code>.</td></tr>
|
|
228
|
+
<tr><td><code>onFocus</code> / <code>onBlur</code></td><td><code>FocusEventHandler<HTMLInputElement></code></td><td>—</td><td>Forwarded to the input; the draft commit runs before <code>onBlur</code> — except when focus moves into the panel, where the day click is the commit instead.</td></tr>
|
|
229
|
+
<tr><td><code>aria-invalid</code> / <code>aria-describedby</code></td><td><code>boolean</code> / <code>string</code></td><td>—</td><td>Injected by <code>Field</code>; declared explicitly so the clone cannot drop them.</td></tr>
|
|
230
|
+
</tbody>
|
|
231
|
+
</table>
|
|
232
|
+
|
|
233
|
+
## Do / Don't
|
|
234
|
+
|
|
235
|
+
- ✅ Wrap in `Field` for the floating label — the `<label>` is the accessible name.
|
|
236
|
+
- ✅ Use the placeholder to show the expected pattern (`dd. mm. rrrr`). DateField follows the Text
|
|
237
|
+
Field floating-label rule, so an empty, unfocused field with **no** placeholder rests its label
|
|
238
|
+
inside the shell; a placeholder both teaches the format and floats the label out of its way.
|
|
239
|
+
- ✅ Take `dateFormat` from the consumer's locale config, so a market change does not need a code change.
|
|
240
|
+
- ✅ Keep the field typeable — do not layer a read-only overlay over the input to "force" the picker.
|
|
241
|
+
- ❌ Never use the placeholder as the label.
|
|
242
|
+
- ❌ Don't hardcode `dateFormat` per call site.
|
|
243
|
+
- ❌ Don't use two DateFields glued together as a range picker — on desktop use the dual-month `DatePicker`, on mobile a `FieldPair` in `format="date"` (see [Mobile](#mobile)).
|
|
244
|
+
- ❌ Don't rely on the field to validate: an unparseable draft is discarded, no error state is raised.
|
|
245
|
+
|
|
246
|
+
## Accessibility
|
|
247
|
+
|
|
248
|
+
- **Keyboard** — Tab reaches **one** element, the input; the calendar glyph is decoration and never
|
|
249
|
+
takes focus. `ArrowDown` opens the panel and moves focus onto a day — and when the panel is already
|
|
250
|
+
up (a click-open leaves focus in the input on purpose) it is the route *into* the grid, so a keyboard
|
|
251
|
+
user is never stuck having to Tab there. `Esc` closes it. Inside the panel
|
|
252
|
+
the day grid owns arrows / `PageUp` / `PageDown` / `Home` / `End` (`navigation: 'none'` on the
|
|
253
|
+
substrate) and is itself **one tab stop**: a single day carries `tabindex="0"` (the selected date,
|
|
254
|
+
else today, else the first day) and the rest are reached only by the arrow keys, so Tab never walks
|
|
255
|
+
35 days. Picking a day closes the panel and returns focus to the input. The shell shows focus as an
|
|
256
|
+
`--outline-focus` border swap.
|
|
257
|
+
- **Focus follows how the panel was opened.** Opening by **click** leaves focus in the input, because
|
|
258
|
+
the field is typeable and pulling focus into the grid would cut a typist off mid-date. Opening by
|
|
259
|
+
**ArrowDown** is explicit intent to browse, so there focus lands on the selected day (or today).
|
|
260
|
+
- **ARIA** — the input is the trigger: `role="combobox"` + `aria-haspopup="dialog"` + `aria-expanded` +
|
|
261
|
+
`aria-controls` pointing at the panel while it is open (APG *Date Picker Combobox*). The panel is
|
|
262
|
+
`role="dialog"` with `aria-label={panelLabel}`. Read-only carries `aria-readonly`, error carries
|
|
263
|
+
`aria-invalid`. Helper text is associated via `aria-describedby`, injected by `Field`.
|
|
264
|
+
- **Screen reader** — the input announces as a combobox with the `<label>` text, the formatted value and
|
|
265
|
+
its expanded state. Opening the panel announces the dialog by its `panelLabel`, then the grid by its
|
|
266
|
+
month caption. (Wording derived from the ARIA wiring — not yet verified against a real screen reader.)
|
|
267
|
+
- **Colour is never the only cue** — `Field` renders the error *text* alongside the `--status-danger`
|
|
268
|
+
border, so the error state does not rely on colour alone (WCAG 1.4.1).
|
|
269
|
+
- **Motion** — the panel's enter/exit is a 150 ms opacity + translate transition from
|
|
270
|
+
`useAnchoredPanel`, which reads `prefers-reduced-motion` at runtime and drops both the slide and the
|
|
271
|
+
duration when it is set.
|
|
272
|
+
|
|
273
|
+
> **Not yet measured:** the ink/background contrast ratios come from the FODS semantic tokens and have
|
|
274
|
+
> not been verified for this component. Run the `storybook-a11y-auditor` (or an axe pass over the
|
|
275
|
+
> stories) before treating AA conformance as confirmed.
|
|
276
|
+
|
|
277
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
278
|
+
|
|
279
|
+
## Usage
|
|
280
|
+
|
|
281
|
+
```tsx
|
|
282
|
+
// Good — Field owns the label / helper / error, DateField owns the value
|
|
283
|
+
const [issuedOn, setIssuedOn] = React.useState<Date | undefined>();
|
|
284
|
+
|
|
285
|
+
<Field label="Datum vystavení" helperText="Datum, kdy byla faktura vystavena">
|
|
286
|
+
<DateField
|
|
287
|
+
id="issued-on"
|
|
288
|
+
name="issued_on"
|
|
289
|
+
value={issuedOn}
|
|
290
|
+
onValueChange={setIssuedOn}
|
|
291
|
+
placeholder="dd. mm. rrrr"
|
|
292
|
+
dateFormat={locale.dateFormat} // 'dd. MM. yyyy' CZ, 'MM/dd/yyyy' US, 'dd/MM/yyyy' GB
|
|
293
|
+
minDate={new Date(2020, 0, 1)}
|
|
294
|
+
/>
|
|
295
|
+
</Field>
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
Typing behaviour worth knowing:
|
|
299
|
+
|
|
300
|
+
- The typed draft is parsed **on blur** against `dateFormat`. A draft that does not parse is
|
|
301
|
+
**discarded, not coerced** — the field falls back to the committed value and raises **no** error state
|
|
302
|
+
of its own. Known limitation: validation is the form's job.
|
|
303
|
+
- An emptied field is a legitimate "unset the date" and reports `undefined`.
|
|
304
|
+
- DateField is deliberately **not** marked `autoFloating` in `Field.tsx` → `FIELD_CHILD_TRAITS`: it is a Text Field
|
|
305
|
+
sibling and follows the one floating-label rule (`text-field.md` § States), so an empty, unfocused,
|
|
306
|
+
valid date field rests its label inside. In practice the label floats anyway on the recommended
|
|
307
|
+
usage, because the format hint is passed as a `placeholder` and a placeholder floats it. Forcing the
|
|
308
|
+
float would strand the label over an empty shell whenever no placeholder was given.
|
|
309
|
+
|
|
310
|
+
```tsx
|
|
311
|
+
// Don't — the placeholder is not an accessible name
|
|
312
|
+
<DateField placeholder="Datum vystavení" value={issuedOn} onValueChange={setIssuedOn} />
|
|
313
|
+
|
|
314
|
+
// Don't — hardcoded per-market pattern in the call site
|
|
315
|
+
<DateField dateFormat="MM/dd/yyyy" value={issuedOn} onValueChange={setIssuedOn} />
|
|
316
|
+
|
|
317
|
+
// Don't — a range is not two DateFields; use the dual-month DatePicker
|
|
318
|
+
<DateField value={from} onValueChange={setFrom} />
|
|
319
|
+
<DateField value={to} onValueChange={setTo} />
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
## Related
|
|
323
|
+
|
|
324
|
+
- [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) — the panel this field opens; use
|
|
325
|
+
it directly for a dual-month range (desktop only — it has no mobile treatment).
|
|
326
|
+
- [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) — `format="date"`: the range form
|
|
327
|
+
that works on a phone, two cells each opening their own single-month panel.
|
|
328
|
+
- [`TextField`](?path=/docs/design-system-atoms-textfield--docs) — the shell DateField reuses (border,
|
|
329
|
+
fill, height tiers, leading / trailing slot contract).
|
|
330
|
+
- [`Field`](?path=/docs/design-system-atoms-field--docs) — floating label, helper text, error line;
|
|
331
|
+
injects `aria-invalid` / `aria-describedby`.
|
|
332
|
+
- [`SelectField`](?path=/docs/design-system-molecules-selectfield--docs) — the sibling trigger that
|
|
333
|
+
**does not** allow typing: a read-only `<button role="combobox">`, because a Select's value must be one
|
|
334
|
+
of a closed list. A date is an open, keyable value, so DateField stays an `<input>`.
|
|
335
|
+
- Spec: `spec/03-atoms/text-field.md` ·
|
|
336
|
+
`spec/04-molecules/date-picker.md` · `spec/06-patterns/field-readonly.md`
|
|
337
|
+
|
|
338
|
+
## Migration notes
|
|
339
|
+
|
|
340
|
+
Not applicable.
|