@invoiceonline/ui-react 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +100 -0
- package/CHANGELOG.md +149 -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-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 +119 -0
- package/dist/components/field/Field.js +332 -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 +210 -0
- package/dist/components/field-pair/FieldPair.js +335 -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 +160 -0
- package/dist/components/text-field/TextField.js +244 -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 +130 -0
- package/dist/index.js +74 -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.d.ts +60 -0
- package/dist/internal/useDateFieldTrigger.js +235 -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 +44 -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 +396 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +550 -0
- package/package.json +347 -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-picker/DatePicker.mdx +440 -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 +787 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +312 -0
- package/src/components/field-pair/FieldPair.stories.tsx +539 -0
- package/src/components/field-pair/FieldPair.tsx +845 -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 +699 -0
- package/src/components/text-field/TextField.stories.tsx +674 -0
- package/src/components/text-field/TextField.tsx +645 -0
- package/src/components/text-field/index.ts +11 -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 +70 -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 +497 -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 +57 -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 +360 -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,699 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as TextFieldStories from './TextField.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={TextFieldStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# TextField
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Status:** draft — the `type="date"` mode built against manifest 2.15.0 has no recorded design
|
|
13
|
+
acceptance yet; the page returns to `stable` once it does.
|
|
14
|
+
- **Manifest version:** `2.15.0`
|
|
15
|
+
- **Tokens used:** `--bg-primary`, `--bg-readonly`, `--border-width-100`, `--border-width-200`, `--disabled-background`, `--disabled-foreground`, `--font-body`, `--font-size-base`, `--font-size-heading-h5`, `--font-size-sm`, `--font-size-xs`, `--font-size-xxs`, `--font-weight-bold`, `--font-weight-normal`, `--icon-muted`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-400`, `--size-icon`, `--size-icon-small`, `--space-1000`, `--space-1100`, `--space-200`, `--space-300`, `--space-400`, `--space-500`, `--space-700`, `--space-800`, `--status-danger`, `--status-success-solid`, `--status-success-tint-foreground`, `--text-placeholder`, `--text-primary`, `--text-secondary`, `--text-wrap-body`
|
|
16
|
+
|
|
17
|
+
## Overview
|
|
18
|
+
|
|
19
|
+
TextField is the single-line text input for short, free-form values: name, IČO / DIČ, e-mail,
|
|
20
|
+
phone, web, address, amount, date, or a search / filter box. `type` is a non-visual prop
|
|
21
|
+
(`text · email · tel · url · search · password · numeric`, plus `date`) — it changes the on-screen
|
|
22
|
+
keyboard and slot behaviour, never the look (`numeric` only right-aligns the value); any other HTML input type does not type-check. `type="date"` turns the field into a date field: a typeable date with
|
|
23
|
+
the calendar glyph and the Single month Date Picker (see [Date mode](#date-mode)). A date field is
|
|
24
|
+
this component, not a separate one.
|
|
25
|
+
|
|
26
|
+
Reach for a different component when: the value spans multiple lines (→ **Textarea**), it comes from
|
|
27
|
+
a fixed set of options (→ **Select**), or it needs an in-field unit / computed suffix
|
|
28
|
+
(→ **UnitField** / **NumberField**). A field that _looks_ editable but offers a list is a Select, not
|
|
29
|
+
a TextField. The **Date Picker** is not a competing field: it is the panel a `type="date"` TextField
|
|
30
|
+
opens.
|
|
31
|
+
|
|
32
|
+
TextField is only the **shell + value**. The floating label, helper text and error / success
|
|
33
|
+
messaging live in the `Field` wrapper — the canonical usage is
|
|
34
|
+
`<Field label="IČO"><TextField id="ico" /></Field>`.
|
|
35
|
+
|
|
36
|
+
<Canvas of={TextFieldStories.Playground} />
|
|
37
|
+
|
|
38
|
+
## Rationale
|
|
39
|
+
|
|
40
|
+
TextField codifies the parts that were previously implicit:
|
|
41
|
+
|
|
42
|
+
1. **The label belongs to the control, not to a sibling.** `Field` renders a real floating `<label>`
|
|
43
|
+
that cross-fades from placeholder position to the top border — so the field is always programmatically
|
|
44
|
+
labelled and the placeholder is never the only label.
|
|
45
|
+
2. **Validation is a first-class state, signalled twice.** Error / Success carry a border colour
|
|
46
|
+
**and** a trailing status icon — colour is never the sole cue (WCAG 1.4.1).
|
|
47
|
+
3. **One shell, many fields.** The border / fill / radius / floating-label notch is a single shape,
|
|
48
|
+
reused by UnitField, NumberField and the Select trigger — fix it once, it lands everywhere. The
|
|
49
|
+
inner `<input>` is borderless and transparent; the outer shell `<div>` owns all the chrome.
|
|
50
|
+
|
|
51
|
+
## Anatomy
|
|
52
|
+
|
|
53
|
+
- **Shell** (`<div>`) — outlined frame that owns border / fill / radius. `--bg-primary` fill,
|
|
54
|
+
`--outline-default` 1px border, radius `--radius-400`, horizontal padding `--space-500`, gap
|
|
55
|
+
`--space-400`. Height is fixed on the 4-grid (`md` 48, `sm` 40). A content-driven `min-width` of
|
|
56
|
+
80px keeps a ~5-char value from truncating.
|
|
57
|
+
- **Leading slot** (optional, `leadingIcon`) — 24/20px glyph (`--size-icon` md / `--size-icon-small` sm) in `--text-secondary`; a contextual icon
|
|
58
|
+
such as `magnifying-glass` for a filter field.
|
|
59
|
+
- **Value** (`<input>`) — borderless, transparent, `Body/M/Regular` in every size. `--text-primary`
|
|
60
|
+
when filled; placeholder ink is `--text-placeholder` (one tier quieter than the label) so an empty
|
|
61
|
+
field reads value > label > placeholder. **Overflow:** an over-long placeholder ellipsizes rather
|
|
62
|
+
than clipping mid-glyph (spec `text.placeholder.overflow = truncate`). `text-overflow` has to sit on
|
|
63
|
+
the `<input>` — `::placeholder` ignores it (verified in Chrome) — which leaves `text.value.overflow =
|
|
64
|
+
scroll` intact: a focused input still scrolls horizontally natively, so the ellipsis only appears on a
|
|
65
|
+
resting, unfocused, overflowing value. The `type="date"` mode renders this same shell, so it
|
|
66
|
+
behaves the same.
|
|
67
|
+
- **Trailing slot** (optional, `trailingIcon`) — 24/20px affordance (clear, password reveal). Becomes
|
|
68
|
+
an interactive `<button>` when `onTrailingIconClick` is set (`trailingIconLabel` is its accessible
|
|
69
|
+
name). On Error / Success this slot is taken by the intrinsic status icon and the user affordance is
|
|
70
|
+
suppressed.
|
|
71
|
+
- **Status icon** (Error / Success) — trailing `warning-circle` (`--status-danger`) or `check-circle`
|
|
72
|
+
(`--status-success-solid`), both the Figma glyphs.
|
|
73
|
+
- **Focus** — on Default the shell border swaps to `--outline-focus` (1px, same weight). No additive
|
|
74
|
+
ring: the border swap is the sole focus indicator. On an **invalid** field the
|
|
75
|
+
border keeps `--status-danger` and thickens from `--border-width-100` to `--border-width-200`
|
|
76
|
+
instead — `--outline-focus` never shows on Error (see States → Error + focus). Success + focus is the
|
|
77
|
+
plain Focused swap. There is **no** hover state.
|
|
78
|
+
|
|
79
|
+
## Variants
|
|
80
|
+
|
|
81
|
+
TextField exposes no colour / style variants of its own — its manifest axes are `state`, `size` and
|
|
82
|
+
`content` (below). The state × size grid mirrors the Figma labelled matrix.
|
|
83
|
+
|
|
84
|
+
<Canvas of={TextFieldStories.Matrix} />
|
|
85
|
+
|
|
86
|
+
<table>
|
|
87
|
+
<thead>
|
|
88
|
+
<tr><th>Axis</th><th>Values</th><th>Notes</th></tr>
|
|
89
|
+
</thead>
|
|
90
|
+
<tbody>
|
|
91
|
+
<tr>
|
|
92
|
+
<td><code>state</code></td>
|
|
93
|
+
<td><code>default</code> · <code>focused</code> · <code>error</code> · <code>success</code> · <code>disabled</code> · <code>readonly</code></td>
|
|
94
|
+
<td>the colour matrix axis — see <a href="#states">States</a></td>
|
|
95
|
+
</tr>
|
|
96
|
+
<tr>
|
|
97
|
+
<td><code>size</code></td>
|
|
98
|
+
<td><code>md</code> · <code>sm</code></td>
|
|
99
|
+
<td>the measurement axis — see <a href="#sizes">Sizes</a></td>
|
|
100
|
+
</tr>
|
|
101
|
+
<tr>
|
|
102
|
+
<td><code>content</code></td>
|
|
103
|
+
<td><code>empty</code> · <code>filled</code></td>
|
|
104
|
+
<td>Figma <strong>Has value</strong>; not a prop — it is the presence of a <code>value</code> / <code>defaultValue</code>. See <a href="#content">Content</a></td>
|
|
105
|
+
</tr>
|
|
106
|
+
<tr>
|
|
107
|
+
<td><code>leadingIcon</code></td>
|
|
108
|
+
<td>any <code>IconName</code></td>
|
|
109
|
+
<td>leading glyph (search / filter); off by default</td>
|
|
110
|
+
</tr>
|
|
111
|
+
<tr>
|
|
112
|
+
<td><code>trailingIcon</code></td>
|
|
113
|
+
<td>any <code>IconName</code></td>
|
|
114
|
+
<td>trailing affordance (clear / reveal) on Default / Focused / Disabled; replaced by the status icon on Error / Success</td>
|
|
115
|
+
</tr>
|
|
116
|
+
</tbody>
|
|
117
|
+
</table>
|
|
118
|
+
|
|
119
|
+
The floating label, helper, error message and the "Volitelný" optional tag are **not** TextField
|
|
120
|
+
props — they are provided by the `Field` wrapper.
|
|
121
|
+
|
|
122
|
+
### Content
|
|
123
|
+
|
|
124
|
+
<Canvas of={TextFieldStories.ContentMatrix} />
|
|
125
|
+
|
|
126
|
+
The manifest's third axis — Figma's **Has value** (True/False) — is not a prop: it is simply whether
|
|
127
|
+
the field carries a value. It changes two things. **Inside the field:** an empty field shows the
|
|
128
|
+
placeholder in `--text-placeholder`, one tier quieter than the label; a filled field shows the value
|
|
129
|
+
in `--text-primary`. An **empty Disabled** field shows no placeholder at all — it shows an en dash
|
|
130
|
+
`–` in `--disabled-foreground` (manifest 2.9.0, `field-readonly.md` § En dash semantics). The dash
|
|
131
|
+
is visual only (`aria-hidden`); the accessible value stays empty, and the placeholder stays in
|
|
132
|
+
the DOM (transparent) as the accessible-name fallback for an unlabelled field. **On the `Field` label:** the
|
|
133
|
+
float rule keys off it — the label rests inside (placeholder position) only when the field is CALM,
|
|
134
|
+
i.e. empty *and* unfocused *and* valid *and* editable; a value, focus, a placeholder,
|
|
135
|
+
`state="error"`, Disabled or Read-only floats it. Read-only exists only *with* a value — there is no
|
|
136
|
+
empty Read-only cell in the Figma set (if one does occur, the same dash renders in `--text-primary`). The label
|
|
137
|
+
side of the axis is shown under [Label](#label); the matrix above renders the bare field.
|
|
138
|
+
|
|
139
|
+
## Sizes
|
|
140
|
+
|
|
141
|
+
<Canvas of={TextFieldStories.Sizes} />
|
|
142
|
+
|
|
143
|
+
<table>
|
|
144
|
+
<thead>
|
|
145
|
+
<tr>
|
|
146
|
+
<th><code>size</code></th>
|
|
147
|
+
<th style={{ textAlign: 'right' }}>Height</th>
|
|
148
|
+
<th>Padding (X)</th>
|
|
149
|
+
<th>Gap</th>
|
|
150
|
+
<th>Helper gap</th>
|
|
151
|
+
<th style={{ textAlign: 'right' }}>Icon</th>
|
|
152
|
+
<th>Radius</th>
|
|
153
|
+
<th>When</th>
|
|
154
|
+
</tr>
|
|
155
|
+
</thead>
|
|
156
|
+
<tbody>
|
|
157
|
+
<tr>
|
|
158
|
+
<td><code>md</code> (default)</td>
|
|
159
|
+
<td style={{ textAlign: 'right' }}>48px</td>
|
|
160
|
+
<td><code>--space-500</code></td>
|
|
161
|
+
<td><code>--space-400</code></td>
|
|
162
|
+
<td><code>--space-200</code></td>
|
|
163
|
+
<td style={{ textAlign: 'right' }}>24</td>
|
|
164
|
+
<td><code>--radius-400</code></td>
|
|
165
|
+
<td>standard forms</td>
|
|
166
|
+
</tr>
|
|
167
|
+
<tr>
|
|
168
|
+
<td><code>sm</code></td>
|
|
169
|
+
<td style={{ textAlign: 'right' }}>40px</td>
|
|
170
|
+
<td><code>--space-500</code></td>
|
|
171
|
+
<td><code>--space-400</code></td>
|
|
172
|
+
<td><code>--space-200</code></td>
|
|
173
|
+
<td style={{ textAlign: 'right' }}>20</td>
|
|
174
|
+
<td><code>--radius-400</code></td>
|
|
175
|
+
<td>dense rows, filter bars, table cells</td>
|
|
176
|
+
</tr>
|
|
177
|
+
</tbody>
|
|
178
|
+
</table>
|
|
179
|
+
|
|
180
|
+
**Helper gap** is the vertical step from the shell to the helper / message line that `Field`
|
|
181
|
+
renders below it — `sizes[].helperGap`, `--space-200` (4) since manifest 2.13.0 (8 read as too far
|
|
182
|
+
from the field). It is safe at 4 because the field has no focus ring to collide with the message,
|
|
183
|
+
and `Body/XS`'s loose leading keeps the optical gap near 8.
|
|
184
|
+
|
|
185
|
+
Heights are fixed on the 4-grid. Width is layout-driven — a field fills its column; the hard
|
|
186
|
+
`min-width` floor is 80px (baseline, no icons / Optional tag). Keep one size consistent within a form.
|
|
187
|
+
|
|
188
|
+
## States
|
|
189
|
+
|
|
190
|
+
<Canvas of={TextFieldStories.States} />
|
|
191
|
+
|
|
192
|
+
Six visual states. Native attributes win when set explicitly (`disabled` / `readOnly`), otherwise the
|
|
193
|
+
state is derived from the `state` prop.
|
|
194
|
+
|
|
195
|
+
<table>
|
|
196
|
+
<thead>
|
|
197
|
+
<tr><th>State</th><th>Border / fill</th><th>Behaviour</th></tr>
|
|
198
|
+
</thead>
|
|
199
|
+
<tbody>
|
|
200
|
+
<tr>
|
|
201
|
+
<td><code>default</code></td>
|
|
202
|
+
<td><code>--outline-default</code> border, <code>--bg-primary</code> fill</td>
|
|
203
|
+
<td>resting; border swaps to <code>--outline-focus</code> on focus-within (Default and Success only — Error keeps its colour, see below)</td>
|
|
204
|
+
</tr>
|
|
205
|
+
<tr>
|
|
206
|
+
<td><code>focused</code></td>
|
|
207
|
+
<td><code>--outline-focus</code> border (1px, no ring)</td>
|
|
208
|
+
<td>editing state; the <code>Field</code> label floats even when empty</td>
|
|
209
|
+
</tr>
|
|
210
|
+
<tr>
|
|
211
|
+
<td><code>error</code></td>
|
|
212
|
+
<td><code>--status-danger</code> border + trailing <code>warning-circle</code> icon</td>
|
|
213
|
+
<td>sets <code>aria-invalid="true"</code>; pair with a matching <code>error</code> message on <code>Field</code>; on focus the border stays <code>--status-danger</code> and thickens to <code>--border-width-200</code> (never <code>--outline-focus</code>)</td>
|
|
214
|
+
</tr>
|
|
215
|
+
<tr>
|
|
216
|
+
<td><code>success</code></td>
|
|
217
|
+
<td><code>--status-success-solid</code> border + trailing <code>check-circle</code> icon (non-text); <code>Field</code> label + confirmation message in <code>--status-success-tint-foreground</code> (AA)</td>
|
|
218
|
+
<td>colour + icon, never colour alone</td>
|
|
219
|
+
</tr>
|
|
220
|
+
<tr>
|
|
221
|
+
<td><code>disabled</code></td>
|
|
222
|
+
<td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--disabled-background</code> fill, <code>--disabled-foreground</code> content; empty → <code>–</code></td>
|
|
223
|
+
<td>"not applicable" — drops from the tab order, value not submitted</td>
|
|
224
|
+
</tr>
|
|
225
|
+
<tr>
|
|
226
|
+
<td><code>readonly</code></td>
|
|
227
|
+
<td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--bg-readonly</code> fill, <code>--text-primary</code> value</td>
|
|
228
|
+
<td>"informative, not editable" — stays focusable, copyable and in the tab order, value submits (native <code>readonly</code>)</td>
|
|
229
|
+
</tr>
|
|
230
|
+
</tbody>
|
|
231
|
+
</table>
|
|
232
|
+
|
|
233
|
+
**Read-only ≠ Disabled.** Use `state="readonly"` for a value the user should see and copy but not edit
|
|
234
|
+
here (computed / derived / locked — e.g. a variable symbol derived from the invoice number). Use
|
|
235
|
+
`disabled` only when the field is genuinely not applicable. Focus is a 1px border-colour swap with no
|
|
236
|
+
ring — except on an invalid field (below); there is no hover state.
|
|
237
|
+
|
|
238
|
+
**Error + focus.** A composition, not a seventh State value. The border **keeps** `--status-danger` and
|
|
239
|
+
goes from `--border-width-100` to `--border-width-200` while the field has focus — colour carries the
|
|
240
|
+
state, weight carries the focus. `--outline-focus` never shows on an invalid field: a blue border would
|
|
241
|
+
say "fine" while label, icon and message say "wrong", and tabbing through an invalid form would blink
|
|
242
|
+
red → blue → red. The added weight sits **inside** the shell — an inset `box-shadow` of
|
|
243
|
+
`calc(var(--border-width-200) - var(--border-width-100))` on top of the 1px border — so the height
|
|
244
|
+
(48 / 40) is unchanged and the content does not shift. Label, status icon and message stay exactly as
|
|
245
|
+
in Error. Success + focus stays the plain Focused swap.
|
|
246
|
+
|
|
247
|
+
**Uncontrolled emptiness.** Without `value`, the field tracks whether it is empty from its own change
|
|
248
|
+
events rather than from the stale `defaultValue`, so the en dash of an empty Disabled / Read-only
|
|
249
|
+
field reflects what the user actually left in it. A native form reset fires no change event; the
|
|
250
|
+
field re-syncs from the restored value instead.
|
|
251
|
+
|
|
252
|
+
### Icons
|
|
253
|
+
|
|
254
|
+
An optional **leading** glyph (search / filter fields) and a **trailing** affordance (clear, password
|
|
255
|
+
reveal). On Error / Success the trailing slot is taken by the intrinsic status icon, so a user trailing
|
|
256
|
+
icon shows only on Default / Focused / Disabled.
|
|
257
|
+
|
|
258
|
+
Both glyph slots take `--disabled-foreground` on a Disabled field — the glyph is content, and Disabled
|
|
259
|
+
mutes all of it (manifest `families[].states.disabled.icon`) — and step down to `--icon-muted` on a
|
|
260
|
+
Read-only one, where the glyph marks what the field holds rather than offering an action. The Error /
|
|
261
|
+
Success ink belongs to the status icon, not to the user slots: a leading glyph stays `--text-secondary`
|
|
262
|
+
on an invalid field.
|
|
263
|
+
|
|
264
|
+
<Canvas of={TextFieldStories.WithIcons} />
|
|
265
|
+
|
|
266
|
+
### Label
|
|
267
|
+
|
|
268
|
+
The floating label across value × state. Empty + calm keeps the label **resting inside** (placeholder
|
|
269
|
+
position); a value, focus, error, Disabled or Read-only floats it to the top border. The floated
|
|
270
|
+
label's notch is a `--border-width-100` strip in the surface colour under the field (default
|
|
271
|
+
`--bg-primary`) that interrupts only the border line — not a full-height backplate — so the shell fill
|
|
272
|
+
(Disabled, Read-only) shows through behind the glyphs. The notch (and the optional tag's notch) widens
|
|
273
|
+
to `--border-width-200` while an invalid field is focused, so no red line shows under the label. Per spec a Read-only field always carries a
|
|
274
|
+
value — the empty Read-only cell is shown only for completeness.
|
|
275
|
+
|
|
276
|
+
<Canvas of={TextFieldStories.WithLabel} />
|
|
277
|
+
|
|
278
|
+
### Motion
|
|
279
|
+
|
|
280
|
+
<Canvas of={TextFieldStories.Motion} />
|
|
281
|
+
|
|
282
|
+
Manifest 2.14.0 `motion.states.value` — the one thing that moves. The label **never travels and never
|
|
283
|
+
scales** between its two poses: the pose change is a cross-fade of two copies. The `<label>` itself
|
|
284
|
+
jumps to its new pose and plays the enter keyframe; an `aria-hidden` ghost paints the pose it left
|
|
285
|
+
(through `::before`, so there is no second text node) and fades out, then unmounts. Nothing plays on
|
|
286
|
+
mount — only a real change of pose (focus, first character, clear + blur, error appearing).
|
|
287
|
+
|
|
288
|
+
<table>
|
|
289
|
+
<thead>
|
|
290
|
+
<tr><th>What</th><th>How</th><th>Reduced motion</th></tr>
|
|
291
|
+
</thead>
|
|
292
|
+
<tbody>
|
|
293
|
+
<tr>
|
|
294
|
+
<td>Resting → floated (enter)</td>
|
|
295
|
+
<td>Floated label: opacity 0 → 1 and <code>translateY(-{'--space-200'})</code> → 0 (it settles 4px <em>down</em> onto the border) over <code>--duration-normal</code> + <code>--easing-enter</code> (<code>animate-field-label-float-in</code>). Resting copy: opacity 1 → 0 over <code>--duration-fast</code> + <code>--easing-exit</code> (<code>animate-field-label-out</code>).</td>
|
|
296
|
+
<td>Pose swaps at once — <code>motion-reduce:animate-none</code> on the label, <code>motion-reduce:hidden</code> on the ghost.</td>
|
|
297
|
+
</tr>
|
|
298
|
+
<tr>
|
|
299
|
+
<td>Floated → resting (exit)</td>
|
|
300
|
+
<td>Resting label: opacity only, <code>--duration-normal</code> + <code>--easing-enter</code> (<code>animate-field-label-rest-in</code>), no settle. Floated copy fades out on <code>--duration-fast</code> + <code>--easing-exit</code>.</td>
|
|
301
|
+
<td>Same — instant swap.</td>
|
|
302
|
+
</tr>
|
|
303
|
+
</tbody>
|
|
304
|
+
</table>
|
|
305
|
+
|
|
306
|
+
The `--space-200` settle is a deliberate calm-motion exception (like Hero's); text never scales. The leaving pose on the way back reuses the exit pair the manifest names
|
|
307
|
+
for the resting label — the manifest does not bind the floated label's fade-out separately. The
|
|
308
|
+
floated label's notch is painted on the label itself, so the border shows through it while it fades
|
|
309
|
+
in. The field family inherits this through the shared `Field` label (Textarea, Select / Combobox
|
|
310
|
+
Field, Subject Lookup Field, and TextField's own `type="date"` mode) and Field Pair's cells (`_field-segment`); fields whose
|
|
311
|
+
label is always floated (Unit Field, Number Field, Select Field) never change pose and never animate.
|
|
312
|
+
|
|
313
|
+
## Date mode
|
|
314
|
+
|
|
315
|
+
<Canvas of={TextFieldStories.DateMode} />
|
|
316
|
+
|
|
317
|
+
`type="date"` is this field with a calendar (manifest `delivery.react`, 2.15.0). What changes:
|
|
318
|
+
|
|
319
|
+
- **The value is a `Date`**, in through `value` (controlled) or `defaultValue` (uncontrolled) and out
|
|
320
|
+
through `onValueChange`, never the formatted string. Clearing the field reports `undefined`.
|
|
321
|
+
Turning the `Date` into what the API stores is the consumer's job. The native string `value` /
|
|
322
|
+
`defaultValue` / `onChange` of the plain field give way to these `Date` props.
|
|
323
|
+
- **The format is the market's, not the design system's.** `dateFormat` (a date-fns pattern) and
|
|
324
|
+
`locale` (a date-fns `Locale`) are both required, with no default and no Czech fallback: the
|
|
325
|
+
consumer passes the format and locale of the market the field is shown in, and the field both
|
|
326
|
+
displays and parses the typed text in that format. `locale` also sets the calendar's week start,
|
|
327
|
+
weekday and month names. Examples: Czech `dd. MM. yyyy`, US `MM/dd/yyyy`, Dutch `dd-MM-yyyy`.
|
|
328
|
+
- **The native input stays `type="text"`**, never the native date input: no browser picker, no native
|
|
329
|
+
formatting. A typist keys the date straight in; the calendar is a faster alternative, never the only
|
|
330
|
+
way in.
|
|
331
|
+
- **The whole field is the trigger.** A click anywhere on the field (the input, the glyph or the shell
|
|
332
|
+
padding) opens the Single month Date Picker anchored to it. A press that misses the input keeps focus
|
|
333
|
+
and a half-typed draft in the input. Clicking the input again while the calendar is open does not
|
|
334
|
+
close it, so the caret can be placed.
|
|
335
|
+
- **The `calendar-dots` glyph is decorative.** It is forced into the leading slot, `aria-hidden` and not
|
|
336
|
+
focusable; there is no button in the field. `leadingIcon`, `trailingIcon` and the trailing-button
|
|
337
|
+
props are not accepted in this mode.
|
|
338
|
+
- **`minDate` / `maxDate` bound both routes.** The calendar disables the days outside them, and a typed
|
|
339
|
+
date outside them is rejected, the same as an unparseable one. Both bounds are inclusive and compared
|
|
340
|
+
by day.
|
|
341
|
+
- **The typed draft commits on blur, and on Enter.** Enter commits before it submits the form, so a
|
|
342
|
+
submit never carries a date the input no longer shows. The draft is parsed against `dateFormat` and `locale`; a draft that does
|
|
343
|
+
not parse, or parses to a day outside `minDate` / `maxDate`, is never coerced and never swapped back
|
|
344
|
+
for the old date. The typed text stays in the input, and the value becomes `undefined`
|
|
345
|
+
(`onValueChange(undefined)`, unless it already was), so a form cannot submit a date the user no
|
|
346
|
+
longer sees. The field raises no error state of its own; validation messaging stays the form's job
|
|
347
|
+
(`state="error"` + `error` on `Field`). `onInvalidInput(raw, reason)` tells the form why: `'unparseable'`
|
|
348
|
+
or `'out-of-range'`, with the text the user typed — the hook for the [Copy](#copy) error pattern,
|
|
349
|
+
shown next to that text (story `Date — Invalid typed date`). A valid or an emptied draft does not
|
|
350
|
+
fire it, and a rejected text the user has not edited is reported once, not on every blur; after a
|
|
351
|
+
change of `minDate` / `maxDate` or the format, the next blur or Enter judges it again. Picking
|
|
352
|
+
a day, a date the consumer sets, or a native form reset replaces the rejected text; text the user
|
|
353
|
+
is still typing is never replaced by an outside value change. Setting `value` to `undefined` does
|
|
354
|
+
not clear the rejected text (the value already is `undefined`); to empty the field from code,
|
|
355
|
+
reset its form or remount it with a new `key`.
|
|
356
|
+
- **One action reports one value.** Picking a day over a half-typed draft reports only the picked day:
|
|
357
|
+
the blur that moves focus into the calendar does not commit the draft.
|
|
358
|
+
- **Read-only never opens the calendar.** The glyph stays as a quiet marker in `--icon-muted`; the value
|
|
359
|
+
stays focusable and copyable. Disabled does not open it either. A calendar that is open when the
|
|
360
|
+
field turns disabled or read-only closes, and unlocking the field does not reopen it.
|
|
361
|
+
- **The label follows the one floating-label rule.** An empty, unfocused, valid date field without a
|
|
362
|
+
placeholder rests its `Field` label inside; a value, focus or a format placeholder floats it. The label
|
|
363
|
+
is offset past the calendar glyph in both poses.
|
|
364
|
+
|
|
365
|
+
The same field for another market, here `dateFormat="MM/dd/yyyy"` + `locale={enUS}`:
|
|
366
|
+
|
|
367
|
+
<Canvas of={TextFieldStories.DateOtherMarket} />
|
|
368
|
+
|
|
369
|
+
State × size, as for the plain field:
|
|
370
|
+
|
|
371
|
+
<Canvas of={TextFieldStories.DateMatrix} />
|
|
372
|
+
|
|
373
|
+
The calendar open from the keyboard (focus the field, press `ArrowDown`): focus lands on the selected
|
|
374
|
+
day, and the dialog is named by the field's label.
|
|
375
|
+
|
|
376
|
+
<Canvas of={TextFieldStories.DateOpen} />
|
|
377
|
+
|
|
378
|
+
An invalid typed date stays where the user typed it: `32. 13. 2026` + Tab keeps the text, the value
|
|
379
|
+
becomes `undefined`, and the form shows the [Copy](#copy) error next to it.
|
|
380
|
+
|
|
381
|
+
<Canvas of={TextFieldStories.DateInvalid} />
|
|
382
|
+
|
|
383
|
+
The date-mode props (the shared ones, `state`, `size`, `disabled`, `readOnly`, `placeholder`, `id`
|
|
384
|
+
and the rest, work as for the plain field):
|
|
385
|
+
|
|
386
|
+
<table>
|
|
387
|
+
<thead>
|
|
388
|
+
<tr><th>Prop</th><th>Type</th><th>Required</th><th>Notes</th></tr>
|
|
389
|
+
</thead>
|
|
390
|
+
<tbody>
|
|
391
|
+
<tr>
|
|
392
|
+
<td><code>type</code></td>
|
|
393
|
+
<td><code>'date'</code></td>
|
|
394
|
+
<td>yes</td>
|
|
395
|
+
<td>selects the date mode</td>
|
|
396
|
+
</tr>
|
|
397
|
+
<tr>
|
|
398
|
+
<td><code>value</code></td>
|
|
399
|
+
<td><code>Date</code></td>
|
|
400
|
+
<td>no</td>
|
|
401
|
+
<td>the chosen date; controlled while it is not <code>undefined</code></td>
|
|
402
|
+
</tr>
|
|
403
|
+
<tr>
|
|
404
|
+
<td><code>defaultValue</code></td>
|
|
405
|
+
<td><code>Date</code></td>
|
|
406
|
+
<td>no</td>
|
|
407
|
+
<td>initial date of an uncontrolled field (<code>value</code> left out)</td>
|
|
408
|
+
</tr>
|
|
409
|
+
<tr>
|
|
410
|
+
<td><code>onValueChange</code></td>
|
|
411
|
+
<td><code>(value: Date | undefined) => void</code></td>
|
|
412
|
+
<td>no</td>
|
|
413
|
+
<td>the committed date: a parsed typed draft, a picked day, or <code>undefined</code> when cleared</td>
|
|
414
|
+
</tr>
|
|
415
|
+
<tr>
|
|
416
|
+
<td><code>onInvalidInput</code></td>
|
|
417
|
+
<td><code>(raw: string, reason: 'unparseable' | 'out-of-range') => void</code></td>
|
|
418
|
+
<td>no</td>
|
|
419
|
+
<td>a typed draft was rejected on commit (blur or Enter): not in <code>dateFormat</code>, or outside <code>minDate</code> / <code>maxDate</code>; the typed text stays and the value becomes <code>undefined</code> (reported through <code>onValueChange</code> first). Use it to show the error on <code>Field</code></td>
|
|
420
|
+
</tr>
|
|
421
|
+
<tr>
|
|
422
|
+
<td><code>dateFormat</code></td>
|
|
423
|
+
<td><code>string</code></td>
|
|
424
|
+
<td>yes, no default</td>
|
|
425
|
+
<td>display + parse pattern in date-fns syntax, the market's (<code>dd. MM. yyyy</code>, <code>MM/dd/yyyy</code>, <code>dd-MM-yyyy</code>)</td>
|
|
426
|
+
</tr>
|
|
427
|
+
<tr>
|
|
428
|
+
<td><code>locale</code></td>
|
|
429
|
+
<td><code>Locale</code> (date-fns)</td>
|
|
430
|
+
<td>yes, no default</td>
|
|
431
|
+
<td>the market's locale: the calendar's week start, weekday and month names, and the parse</td>
|
|
432
|
+
</tr>
|
|
433
|
+
<tr>
|
|
434
|
+
<td><code>minDate</code> / <code>maxDate</code></td>
|
|
435
|
+
<td><code>Date</code></td>
|
|
436
|
+
<td>no</td>
|
|
437
|
+
<td>earliest / latest selectable day, inclusive; bounds the calendar and a typed date</td>
|
|
438
|
+
</tr>
|
|
439
|
+
<tr>
|
|
440
|
+
<td><code>panelLabelledBy</code></td>
|
|
441
|
+
<td><code>string</code></td>
|
|
442
|
+
<td>no</td>
|
|
443
|
+
<td>id of the visible text naming the calendar dialog (<code>aria-labelledby</code>); <code>Field</code> fills it with its <code><label></code> id, so inside a labelled <code>Field</code> there is nothing to pass. Wins over <code>panelLabel</code></td>
|
|
444
|
+
</tr>
|
|
445
|
+
<tr>
|
|
446
|
+
<td><code>panelLabel</code></td>
|
|
447
|
+
<td><code>string</code></td>
|
|
448
|
+
<td>no, no default</td>
|
|
449
|
+
<td>fallback accessible name (<code>aria-label</code>) of the calendar dialog, used only when nothing visible names the field. Without it the dialog takes the field's own <code>aria-labelledby</code> / <code>aria-label</code>; with no name at all it warns in development</td>
|
|
450
|
+
</tr>
|
|
451
|
+
<tr>
|
|
452
|
+
<td><code>navLabels</code></td>
|
|
453
|
+
<td><code>DatePickerNavLabels</code></td>
|
|
454
|
+
<td>yes</td>
|
|
455
|
+
<td>accessible names of the calendar's four chevrons: <code>previousMonth</code>, <code>nextMonth</code>, <code>previousYear</code>, <code>nextYear</code></td>
|
|
456
|
+
</tr>
|
|
457
|
+
<tr>
|
|
458
|
+
<td><code>className</code></td>
|
|
459
|
+
<td><code>string</code></td>
|
|
460
|
+
<td>no</td>
|
|
461
|
+
<td>applied to the trigger wrapper around the shell</td>
|
|
462
|
+
</tr>
|
|
463
|
+
</tbody>
|
|
464
|
+
</table>
|
|
465
|
+
|
|
466
|
+
## API
|
|
467
|
+
|
|
468
|
+
<Controls />
|
|
469
|
+
|
|
470
|
+
## Do / Don't
|
|
471
|
+
|
|
472
|
+
- ✅ Always wrap in `Field` and give the `<input>` an `id` — the floating `<label>` is the accessible name.
|
|
473
|
+
- ✅ Use `state="readonly"` for locked values — it stays copyable and in the tab order.
|
|
474
|
+
- ✅ Write specific, impersonal errors ("IČO musí mít 8 číslic" — problem + fix) and pair `state="error"` with a matching `error` on `Field`.
|
|
475
|
+
- ✅ Reach for the right component — Select for a fixed set, Textarea for multi-line; a date is a `type="date"` TextField that opens the Date Picker.
|
|
476
|
+
- ✅ For a date, pass the `dateFormat` and `locale` of the market the field is shown in, from the app's market config.
|
|
477
|
+
- ❌ Don't use the placeholder as the only label — it disappears on input and fails a11y.
|
|
478
|
+
- ❌ Don't build a separate "date field" component — a date field is this one with `type="date"`.
|
|
479
|
+
- ❌ Don't use `disabled` for a value the user still needs to read or copy.
|
|
480
|
+
- ❌ Don't ship generic "Neplatná hodnota" or commands ("Zadejte…").
|
|
481
|
+
- ❌ Don't place a TextField on a tinted / secondary background — the shell fill and contrast are built for `--bg-primary` only.
|
|
482
|
+
|
|
483
|
+
## Accessibility
|
|
484
|
+
|
|
485
|
+
- **Keyboard** — standard text entry. `disabled` fields drop from the tab order; a `readonly` field
|
|
486
|
+
stays focusable, its text is selectable / copyable, and its value **is** submitted with the form. To
|
|
487
|
+
show a non-editable but readable value use Read-only, never `disabled`.
|
|
488
|
+
- **ARIA** — `state="error"` sets `aria-invalid="true"`; associate the message via `aria-describedby`
|
|
489
|
+
(handled by `Field`). `readonly` sets `aria-readonly`. A label-less filter / search field needs an
|
|
490
|
+
explicit `aria-label` — the placeholder is not a label (WCAG 1.3.1 / 3.3.2). An interactive trailing
|
|
491
|
+
icon (`onTrailingIconClick`) requires `trailingIconLabel`.
|
|
492
|
+
- **Date mode: keyboard** — the input is typeable like any TextField. `ArrowDown` opens the calendar and
|
|
493
|
+
moves focus onto the selected day (or today); with the calendar already open from a click, `ArrowDown`
|
|
494
|
+
moves focus into the grid. Opening by click leaves focus in the input, so typing keeps working.
|
|
495
|
+
Picking a day closes the calendar and returns focus to the input; `Esc` closes it and returns focus
|
|
496
|
+
to the field. With the calendar open, `Tab` runs from the input through the year and month
|
|
497
|
+
chevrons to the day, then leaves the calendar. A half-typed draft commits when `Tab` leaves the
|
|
498
|
+
input, as on any blur, so `onValueChange` or `onInvalidInput` fires before focus reaches the
|
|
499
|
+
calendar. The draft is kept only when focus moves straight into the open calendar — `ArrowDown`,
|
|
500
|
+
or a press on a day or a chevron: picking a day there replaces the draft, and only the picked day
|
|
501
|
+
is reported.
|
|
502
|
+
- **Date mode: format** — tell the user the format in the helper (or in the error), never only in the
|
|
503
|
+
placeholder, which disappears as soon as they type (WCAG 3.3.2). The Date story does it with the
|
|
504
|
+
helper «Formát DD. MM. RRRR».
|
|
505
|
+
- **Date mode: ARIA** — the input itself is the trigger: `role="combobox"`, `aria-haspopup="dialog"`,
|
|
506
|
+
`aria-expanded`, and `aria-controls` pointing at the calendar while it is open. A disabled date
|
|
507
|
+
field keeps the combobox role; a read-only one owns no calendar, so it is a plain textbox without
|
|
508
|
+
`role="combobox"` or `aria-haspopup`. The calendar is `role="dialog"`, named by the field's visible
|
|
509
|
+
`<label>` through `aria-labelledby` (`Field` passes it as `panelLabelledBy`); `panelLabel` is the
|
|
510
|
+
`aria-label` fallback for a field with no visible label, and without it the field's own
|
|
511
|
+
`aria-label` names the dialog too. Its chevrons are named by `navLabels`, which is required and
|
|
512
|
+
has no default — the consumer passes the names in the market's language. The calendar glyph is `aria-hidden`. Inside a `Modal` the calendar renders within the modal's dialog, so a day can take focus
|
|
513
|
+
past the focus trap.
|
|
514
|
+
- **Screen reader** — the floating `<label>` from `Field` is the accessible name; error / success are
|
|
515
|
+
conveyed by colour **and** a status icon (WCAG 1.4.1), so the cue is not colour-only.
|
|
516
|
+
- **Announcement** (manifest 2.9.1) — `Field` keeps the helper / message line **always mounted** as a
|
|
517
|
+
polite live region (`aria-live="polite"`), empty when there is no message, so an error or
|
|
518
|
+
confirmation that appears while focus is elsewhere (blur validation, an async check such as ARES) is
|
|
519
|
+
read out without moving focus — a region inserted together with its text is not announced. Never
|
|
520
|
+
`role="alert"`: an assertive announcement interrupts typing in the next field. The empty line adds no
|
|
521
|
+
gap, and `aria-describedby` points at it only while it holds a message. On a failed submit the form
|
|
522
|
+
moves focus to the first invalid field and the error is read via `aria-describedby`.
|
|
523
|
+
- **Contrast & motion** — focus is a 1px `--outline-focus` border swap with **no** ring. ⚠️ Accepted
|
|
524
|
+
tradeoff: a 1px swap is weaker than an offset ring and borderline for WCAG 2.4.11. The mitigation — thicken the focus border, never re-add a ring — is applied on invalid
|
|
525
|
+
fields: Error + focus keeps `--status-danger` and goes to `--border-width-200`, so focus stays
|
|
526
|
+
visible without trading the error colour for blue. Besides the border, the only motion of the field
|
|
527
|
+
is the floating label's cross-fade (see States → Motion), which honours `prefers-reduced-motion` and
|
|
528
|
+
swaps the pose at once there.
|
|
529
|
+
|
|
530
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
531
|
+
|
|
532
|
+
## Copy
|
|
533
|
+
|
|
534
|
+
These are the canonical copy rules for fields: other field components (Field Pair, Select,
|
|
535
|
+
Textarea …) follow them. Examples are Czech (the primary market); the rules hold for every language
|
|
536
|
+
version. Text length varies by language, so the maximum lengths below are guidance, not an enforced
|
|
537
|
+
`maxlength`, and the helper and error lines wrap.
|
|
538
|
+
|
|
539
|
+
Voice: five principles.
|
|
540
|
+
|
|
541
|
+
1. **Impersonal and neutral.** In-app copy is depersonalised: avoid addressing the user (vy / ty)
|
|
542
|
+
where possible; prefer noun labels and plain statements.
|
|
543
|
+
2. **Clear over clever.** Plain language, active voice, no jargon: being clear always matters more
|
|
544
|
+
than being entertaining.
|
|
545
|
+
3. **Concise.** The shortest text that is still specific; honour the per-run maximum length.
|
|
546
|
+
4. **Specific and helpful.** Especially errors: say what is wrong **and** how to fix it; never
|
|
547
|
+
blame, never generic.
|
|
548
|
+
5. **Consistent terminology.** One word per concept (faktura, IČO, DIČ, odběratel …), matching the
|
|
549
|
+
product; don't introduce synonyms.
|
|
550
|
+
|
|
551
|
+
Per text run:
|
|
552
|
+
|
|
553
|
+
- **Label** (`label` on `Field`) — a noun phrase in sentence case, 1–3 words, no colon and no
|
|
554
|
+
command; always present. Instructions go in the helper, not the label. Single line, truncates with
|
|
555
|
+
an ellipsis at the field's inner width; about 24 characters at most.
|
|
556
|
+
- **Value** (the input's value) — single line; the editable input scrolls horizontally (no
|
|
557
|
+
ellipsis) and truncates only when rendered read-only. The component sets no maximum length: the
|
|
558
|
+
consumer sets `maxlength` per type (IČO 8, PSČ 5, …).
|
|
559
|
+
- **Placeholder** (`placeholder` on `TextField`) — optional, a **format example** only, never a
|
|
560
|
+
substitute for the label or a repeat of it. Shown only while the field is empty; never on a
|
|
561
|
+
Disabled field, which shows an en dash "–" instead. Single line, truncates with an ellipsis; about
|
|
562
|
+
30 characters at most.
|
|
563
|
+
- **Helper** (`helperText` on `Field`) — a persistent hint: the format, or where to find the value.
|
|
564
|
+
Concise, about one line; wraps and is never truncated; about 120 characters at most.
|
|
565
|
+
- **Error** (`error` on `Field`) — impersonal, **problem + fix or format**, specific; it replaces
|
|
566
|
+
the helper. Wraps and must stay fully visible (WCAG 3.3.1); the field keeps its height and only
|
|
567
|
+
the message area below grows; about 140 characters at most.
|
|
568
|
+
- **Optional tag** (`optionalLabel` on `Field`) — `Volitelný`, capitalised and without brackets, on
|
|
569
|
+
optional fields **only**.
|
|
570
|
+
|
|
571
|
+
Error pattern: `[what's wrong]( + [expected format])`, impersonal, e.g. "Neplatné datum — formát
|
|
572
|
+
DD. MM. RRRR". The format named is the market's own (see [Date mode](#date-mode)); `DD. MM. RRRR` is
|
|
573
|
+
the Czech one, and the same holds for a date field's format placeholder. Not a command ("Zadejte…"),
|
|
574
|
+
not a bare label ("Chyba").
|
|
575
|
+
|
|
576
|
+
<table>
|
|
577
|
+
<thead>
|
|
578
|
+
<tr><th>Run</th><th>✅</th><th>❌</th></tr>
|
|
579
|
+
</thead>
|
|
580
|
+
<tbody>
|
|
581
|
+
<tr><td>Label</td><td><code>IČO</code> · <code>Datum splatnosti</code></td><td><code>Zadejte vaše IČO:</code></td></tr>
|
|
582
|
+
<tr><td>Placeholder</td><td><code>12345678</code></td><td><code>Sem napište IČO</code></td></tr>
|
|
583
|
+
<tr><td>Helper</td><td><code>Najdete v hlavičce faktury</code></td><td><code>Toto pole je pro IČO</code></td></tr>
|
|
584
|
+
<tr><td>Error</td><td><code>IČO musí mít 8 číslic</code></td><td><code>Chyba</code> · <code>Neplatná hodnota</code></td></tr>
|
|
585
|
+
<tr><td>Optional tag</td><td><code>Volitelný</code></td><td><code>*</code> on every required field</td></tr>
|
|
586
|
+
</tbody>
|
|
587
|
+
</table>
|
|
588
|
+
|
|
589
|
+
## Usage
|
|
590
|
+
|
|
591
|
+
<Canvas of={TextFieldStories.WithField} />
|
|
592
|
+
|
|
593
|
+
```tsx
|
|
594
|
+
// Good — wrapped in Field, input has an id, label is the accessible name
|
|
595
|
+
<Field label="IČO" helperText="Najdete v hlavičce faktury">
|
|
596
|
+
<TextField id="ico" defaultValue="12345678" />
|
|
597
|
+
</Field>
|
|
598
|
+
|
|
599
|
+
// Good — error state paired with a matching, specific message
|
|
600
|
+
<Field label="IČO" error="IČO musí mít 8 číslic">
|
|
601
|
+
<TextField id="ico" state="error" defaultValue="1234" />
|
|
602
|
+
</Field>
|
|
603
|
+
|
|
604
|
+
// Good — locked, computed value stays copyable (readonly, not disabled)
|
|
605
|
+
<Field label="Variabilní symbol" helperText="Odvozeno z čísla faktury">
|
|
606
|
+
<TextField id="vs" state="readonly" defaultValue="20260721" />
|
|
607
|
+
</Field>
|
|
608
|
+
|
|
609
|
+
// Good — search / filter field with a leading glyph and an aria-label
|
|
610
|
+
<TextField leadingIcon="magnifying-glass" placeholder="Hledat…" aria-label="Hledat" />
|
|
611
|
+
|
|
612
|
+
// Good — a date: a Date in and out; format, locale and the calendar's names
|
|
613
|
+
// come from the market the field is shown in (here the Czech one); the helper
|
|
614
|
+
// states the format, and a rejected draft becomes the Field's error, shown
|
|
615
|
+
// next to the text the user typed
|
|
616
|
+
const [issuedOn, setIssuedOn] = React.useState<Date | undefined>();
|
|
617
|
+
const [dateError, setDateError] = React.useState<string>();
|
|
618
|
+
|
|
619
|
+
<Field
|
|
620
|
+
label="Datum vystavení"
|
|
621
|
+
helperText="Formát DD. MM. RRRR"
|
|
622
|
+
error={dateError}
|
|
623
|
+
>
|
|
624
|
+
<TextField
|
|
625
|
+
type="date"
|
|
626
|
+
id="issued-on"
|
|
627
|
+
state={dateError ? 'error' : undefined}
|
|
628
|
+
value={issuedOn}
|
|
629
|
+
onValueChange={date => { setDateError(undefined); setIssuedOn(date); }}
|
|
630
|
+
onInvalidInput={(_raw, reason) => setDateError(
|
|
631
|
+
reason === 'out-of-range'
|
|
632
|
+
? 'Datum musí být nejdříve 1. 1. 2020'
|
|
633
|
+
: 'Neplatné datum — formát DD. MM. RRRR',
|
|
634
|
+
)}
|
|
635
|
+
dateFormat="dd. MM. yyyy" // another market passes its own pattern and texts
|
|
636
|
+
locale={cs} // the date-fns Locale of the market
|
|
637
|
+
navLabels={{
|
|
638
|
+
previousMonth: 'Předchozí měsíc',
|
|
639
|
+
nextMonth: 'Další měsíc',
|
|
640
|
+
previousYear: 'Předchozí rok',
|
|
641
|
+
nextYear: 'Další rok',
|
|
642
|
+
}}
|
|
643
|
+
placeholder="DD. MM. RRRR"
|
|
644
|
+
minDate={new Date(2020, 0, 1)}
|
|
645
|
+
/>
|
|
646
|
+
</Field>
|
|
647
|
+
```
|
|
648
|
+
|
|
649
|
+
```tsx
|
|
650
|
+
// Don't — placeholder used as the only label (no Field, no id, no aria-label)
|
|
651
|
+
<TextField placeholder="IČO" />
|
|
652
|
+
|
|
653
|
+
// Don't — disabled hides a value the user still needs to read / copy
|
|
654
|
+
<TextField state="disabled" defaultValue="20260721" />
|
|
655
|
+
|
|
656
|
+
// Don't — a formatted string is not a date value; the value is a Date
|
|
657
|
+
<TextField type="date" value="15. 04. 2026" {...marketDateProps} />
|
|
658
|
+
```
|
|
659
|
+
|
|
660
|
+
## Related
|
|
661
|
+
|
|
662
|
+
- [`Field`](?path=/docs/design-system-atoms-field--docs) — the wrapper that supplies the floating label, helper and error / success messaging (mandatory partner).
|
|
663
|
+
- [`Textarea`](?path=/docs/design-system-atoms-textarea--docs) — multi-line sibling sharing the same shell.
|
|
664
|
+
- [`DatePicker`](?path=/docs/design-system-molecules-datepicker--docs) — the calendar panel `type="date"` opens; use it directly for a dual-month range.
|
|
665
|
+
- [`FieldPair`](?path=/docs/design-system-molecules-fieldpair--docs) — `format="date"`: a date range as two fused cells, each opening its own single-month calendar.
|
|
666
|
+
- `UnitField` — TextField shell with an in-field unit / suffix (`Kč`, `%`).
|
|
667
|
+
- `NumberField` — the stepper variant for numeric quantities.
|
|
668
|
+
- `Select` — for choosing from a fixed set of options; reuses the same field shell.
|
|
669
|
+
- Spec: `spec/03-atoms/text-field.md`.
|
|
670
|
+
|
|
671
|
+
## Migration notes
|
|
672
|
+
|
|
673
|
+
- **Manifest 2.14.0 (2026-11-03) — floating-label motion.** The label used to *travel*: a 200ms
|
|
674
|
+
transition on `top` / `left` / `transform` / `font-size` / `color` / `padding` / `max-width`, plus a
|
|
675
|
+
delayed `background` for the notch, all on raw values. It now cross-fades on motion tokens (States →
|
|
676
|
+
Motion) and has no transition at all — status ink changes (error ↔ default) are now instant too, as
|
|
677
|
+
the manifest's motion block lists nothing else that moves. Field Pair dropped its own copy of the
|
|
678
|
+
old transition (`SEGMENT_LABEL_TRANSITION`) and cross-fades its cells the same way.
|
|
679
|
+
- **Manifest 2.15.0 (2026-11-19) — `type="date"` built.** The type that manifest 2.7.0 added is now
|
|
680
|
+
implemented (see [Date mode](#date-mode)); before, `type` was passed straight to the input. 2.15.0
|
|
681
|
+
makes the format the market's: the value is a `Date`, and `dateFormat` + `locale` are required props
|
|
682
|
+
with no Czech default. A `type="date"` TextField without them, or with a string `value`, does not
|
|
683
|
+
type-check. `type` is also narrowed to the manifest's list (`text`, `email`, `tel`, `url`,
|
|
684
|
+
`search`, `password`, `numeric`, `date`). `numeric` is not an HTML input type: it renders
|
|
685
|
+
`type="text"` with `inputMode="numeric"`, right-aligned, so a digit string such as an IČO keeps its
|
|
686
|
+
leading zeros. A number you calculate with belongs in `NumberField` or `UnitField`.
|
|
687
|
+
- **`Help` (the label's ⓘ Tooltip trigger) is specified upstream but NOT built here.** The manifest
|
|
688
|
+
property `Help` (on the nested `_labelContainer`) puts an info ⓘ after the label text; `Field` has
|
|
689
|
+
no prop for it. Manifest 2.11.0 (2026-10-13) adds that a field with `Help` on floats its label even
|
|
690
|
+
while empty and shows the placeholder inside — the one exception to the floating-label rule — and
|
|
691
|
+
that there is no trailing help slot. Without a `Help` prop that exception has nothing to hang on, so
|
|
692
|
+
the float rule here is unchanged; until `Help` ships, put a hint the user needs before typing into
|
|
693
|
+
`helperText` (the spec's "helper first" route), never into a trailing icon.
|
|
694
|
+
- **Numeric quantities** with a stepper are a **separate NumberField component**, not a TextField
|
|
695
|
+
variant. **In-field units / computed suffixes** (`Kč`, `%`) live in the **separate UnitField**,
|
|
696
|
+
keeping TextField's trailing slot icons-only.
|
|
697
|
+
- **Icon names match the spec.** The component uses the canonical FODS names (Error
|
|
698
|
+
`warning-circle`, Success `check-circle`, leading `magnifying-glass`); the legacy icon-font names
|
|
699
|
+
are not part of `IconName` in React.
|