@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,22 @@
|
|
|
1
|
+
export { Table } from './Table';
|
|
2
|
+
export {
|
|
3
|
+
TABLE_DEFAULT_PAGE_SIZE,
|
|
4
|
+
TABLE_PAGE_SIZE_OPTIONS,
|
|
5
|
+
type TableProps,
|
|
6
|
+
type TableCellAlign,
|
|
7
|
+
type TableColumnMeta,
|
|
8
|
+
type TableRowAction,
|
|
9
|
+
type TableSelection,
|
|
10
|
+
type TableColumnVisibility,
|
|
11
|
+
type TablePaginationLabels,
|
|
12
|
+
type TablePagination,
|
|
13
|
+
type TableEmptyKind,
|
|
14
|
+
type TableEmptyState,
|
|
15
|
+
type TableMobileLoadMore,
|
|
16
|
+
type TableMobileConfig,
|
|
17
|
+
type TableMobileProps,
|
|
18
|
+
type TableEmptyProps,
|
|
19
|
+
} from '../../internal/table/types';
|
|
20
|
+
export { createTableColumnHelper, tableFeatureSet, type TableFeatureSet } from '../../internal/table/features';
|
|
21
|
+
export { TableChildRowPrefix } from '../../internal/table/ChildRowPrefix';
|
|
22
|
+
export { useTableLayout, type TableLayout } from '../../internal/table/TableLayout';
|
|
@@ -0,0 +1,479 @@
|
|
|
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:** stable
|
|
13
|
+
- **Manifest version:** `2.14.1`
|
|
14
|
+
- **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`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
TextField is the single-line text input for short, free-form values: name, IČO / DIČ, e-mail,
|
|
19
|
+
phone, web, address, amount, or a search / filter box. `type` is a non-visual prop
|
|
20
|
+
(`text · email · tel · url · search · password`) — it changes the on-screen keyboard and slot
|
|
21
|
+
behaviour, never the look.
|
|
22
|
+
|
|
23
|
+
Reach for a different component when: the value spans multiple lines (→ **Textarea**), it is a date
|
|
24
|
+
(→ **Date Picker**), it comes from a fixed set of options (→ **Select**), or it needs an in-field
|
|
25
|
+
unit / computed suffix (→ **UnitField** / **NumberField**). A field that _looks_ editable but offers
|
|
26
|
+
a list is a Select, not a TextField.
|
|
27
|
+
|
|
28
|
+
TextField is only the **shell + value**. The floating label, helper text and error / success
|
|
29
|
+
messaging live in the `Field` wrapper — the canonical usage is
|
|
30
|
+
`<Field label="IČO"><TextField id="ico" /></Field>`.
|
|
31
|
+
|
|
32
|
+
<Canvas of={TextFieldStories.Playground} />
|
|
33
|
+
|
|
34
|
+
## Rationale
|
|
35
|
+
|
|
36
|
+
TextField codifies the parts that were previously implicit:
|
|
37
|
+
|
|
38
|
+
1. **The label belongs to the control, not to a sibling.** `Field` renders a real floating `<label>`
|
|
39
|
+
that cross-fades from placeholder position to the top border — so the field is always programmatically
|
|
40
|
+
labelled and the placeholder is never the only label.
|
|
41
|
+
2. **Validation is a first-class state, signalled twice.** Error / Success carry a border colour
|
|
42
|
+
**and** a trailing status icon — colour is never the sole cue (WCAG 1.4.1).
|
|
43
|
+
3. **One shell, many fields.** The border / fill / radius / floating-label notch is a single shape,
|
|
44
|
+
reused by UnitField, NumberField and the Select trigger — fix it once, it lands everywhere. The
|
|
45
|
+
inner `<input>` is borderless and transparent; the outer shell `<div>` owns all the chrome.
|
|
46
|
+
|
|
47
|
+
## Anatomy
|
|
48
|
+
|
|
49
|
+
- **Shell** (`<div>`) — outlined frame that owns border / fill / radius. `--bg-primary` fill,
|
|
50
|
+
`--outline-default` 1px border, radius `--radius-400`, horizontal padding `--space-500`, gap
|
|
51
|
+
`--space-400`. Height is fixed on the 4-grid (`md` 48, `sm` 40). A content-driven `min-width` of
|
|
52
|
+
80px keeps a ~5-char value from truncating.
|
|
53
|
+
- **Leading slot** (optional, `leadingIcon`) — 24/20px glyph (`--size-icon` md / `--size-icon-small` sm) in `--text-secondary`; a contextual icon
|
|
54
|
+
such as `magnifying-glass` for a filter field.
|
|
55
|
+
- **Value** (`<input>`) — borderless, transparent, `Body/M/Regular` in every size. `--text-primary`
|
|
56
|
+
when filled; placeholder ink is `--text-placeholder` (one tier quieter than the label) so an empty
|
|
57
|
+
field reads value > label > placeholder. **Overflow:** an over-long placeholder ellipsizes rather
|
|
58
|
+
than clipping mid-glyph (spec `text.placeholder.overflow = truncate`). `text-overflow` has to sit on
|
|
59
|
+
the `<input>` — `::placeholder` ignores it (verified in Chrome) — which leaves `text.value.overflow =
|
|
60
|
+
scroll` intact: a focused input still scrolls horizontally natively, so the ellipsis only appears on a
|
|
61
|
+
resting, unfocused, overflowing value. Inherited by every field on this shell (ComboboxField,
|
|
62
|
+
DateField, FieldPair).
|
|
63
|
+
- **Trailing slot** (optional, `trailingIcon`) — 24/20px affordance (clear, password reveal). Becomes
|
|
64
|
+
an interactive `<button>` when `onTrailingIconClick` is set (`trailingIconLabel` is its accessible
|
|
65
|
+
name). On Error / Success this slot is taken by the intrinsic status icon and the user affordance is
|
|
66
|
+
suppressed.
|
|
67
|
+
- **Status icon** (Error / Success) — trailing `warning-circle` (`--status-danger`) or `check`
|
|
68
|
+
(`--status-success-solid`). Error matches the Figma glyph; Success is the one that still
|
|
69
|
+
differs — the icon set ships `check-circle` too, but this component renders the bare `check`.
|
|
70
|
+
- **Focus** — on Default the shell border swaps to `--outline-focus` (1px, same weight). No additive
|
|
71
|
+
ring: the border swap is the sole focus indicator. On an **invalid** field the
|
|
72
|
+
border keeps `--status-danger` and thickens from `--border-width-100` to `--border-width-200`
|
|
73
|
+
instead — `--outline-focus` never shows on Error (see States → Error + focus). Success + focus is the
|
|
74
|
+
plain Focused swap. There is **no** hover state.
|
|
75
|
+
|
|
76
|
+
## Variants
|
|
77
|
+
|
|
78
|
+
TextField exposes no colour / style variants of its own — its manifest axes are `state`, `size` and
|
|
79
|
+
`content` (below). The state × size grid mirrors the Figma labelled matrix.
|
|
80
|
+
|
|
81
|
+
<Canvas of={TextFieldStories.Matrix} />
|
|
82
|
+
|
|
83
|
+
<table>
|
|
84
|
+
<thead>
|
|
85
|
+
<tr><th>Axis</th><th>Values</th><th>Notes</th></tr>
|
|
86
|
+
</thead>
|
|
87
|
+
<tbody>
|
|
88
|
+
<tr>
|
|
89
|
+
<td><code>state</code></td>
|
|
90
|
+
<td><code>default</code> · <code>focused</code> · <code>error</code> · <code>success</code> · <code>disabled</code> · <code>readonly</code></td>
|
|
91
|
+
<td>the colour matrix axis — see <a href="#states">States</a></td>
|
|
92
|
+
</tr>
|
|
93
|
+
<tr>
|
|
94
|
+
<td><code>size</code></td>
|
|
95
|
+
<td><code>md</code> · <code>sm</code></td>
|
|
96
|
+
<td>the measurement axis — see <a href="#sizes">Sizes</a></td>
|
|
97
|
+
</tr>
|
|
98
|
+
<tr>
|
|
99
|
+
<td><code>content</code></td>
|
|
100
|
+
<td><code>empty</code> · <code>filled</code></td>
|
|
101
|
+
<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>
|
|
102
|
+
</tr>
|
|
103
|
+
<tr>
|
|
104
|
+
<td><code>leadingIcon</code></td>
|
|
105
|
+
<td>any <code>IconName</code></td>
|
|
106
|
+
<td>leading glyph (search / filter); off by default</td>
|
|
107
|
+
</tr>
|
|
108
|
+
<tr>
|
|
109
|
+
<td><code>trailingIcon</code></td>
|
|
110
|
+
<td>any <code>IconName</code></td>
|
|
111
|
+
<td>trailing affordance (clear / reveal) on Default / Focused / Disabled; replaced by the status icon on Error / Success</td>
|
|
112
|
+
</tr>
|
|
113
|
+
</tbody>
|
|
114
|
+
</table>
|
|
115
|
+
|
|
116
|
+
The floating label, helper, error message and the "Volitelný" optional tag are **not** TextField
|
|
117
|
+
props — they are provided by the `Field` wrapper.
|
|
118
|
+
|
|
119
|
+
### Content
|
|
120
|
+
|
|
121
|
+
<Canvas of={TextFieldStories.ContentMatrix} />
|
|
122
|
+
|
|
123
|
+
The manifest's third axis — Figma's **Has value** (True/False) — is not a prop: it is simply whether
|
|
124
|
+
the field carries a value. It changes two things. **Inside the field:** an empty field shows the
|
|
125
|
+
placeholder in `--text-placeholder`, one tier quieter than the label; a filled field shows the value
|
|
126
|
+
in `--text-primary`. An **empty Disabled** field shows no placeholder at all — it shows an en dash
|
|
127
|
+
`–` in `--disabled-foreground` (manifest 2.9.0, `field-readonly.md` § En dash semantics). The dash
|
|
128
|
+
is visual only (`aria-hidden`); the accessible value stays empty, and the placeholder stays in
|
|
129
|
+
the DOM (transparent) as the accessible-name fallback for an unlabelled field. **On the `Field` label:** the
|
|
130
|
+
float rule keys off it — the label rests inside (placeholder position) only when the field is CALM,
|
|
131
|
+
i.e. empty *and* unfocused *and* valid *and* editable; a value, focus, a placeholder,
|
|
132
|
+
`state="error"`, Disabled or Read-only floats it. Read-only exists only *with* a value — there is no
|
|
133
|
+
empty Read-only cell in the Figma set (if one does occur, the same dash renders in `--text-primary`). The label
|
|
134
|
+
side of the axis is shown under [Label](#label); the matrix above renders the bare field.
|
|
135
|
+
|
|
136
|
+
## Sizes
|
|
137
|
+
|
|
138
|
+
<Canvas of={TextFieldStories.Sizes} />
|
|
139
|
+
|
|
140
|
+
<table>
|
|
141
|
+
<thead>
|
|
142
|
+
<tr>
|
|
143
|
+
<th><code>size</code></th>
|
|
144
|
+
<th style={{ textAlign: 'right' }}>Height</th>
|
|
145
|
+
<th>Padding (X)</th>
|
|
146
|
+
<th>Gap</th>
|
|
147
|
+
<th>Helper gap</th>
|
|
148
|
+
<th style={{ textAlign: 'right' }}>Icon</th>
|
|
149
|
+
<th>Radius</th>
|
|
150
|
+
<th>When</th>
|
|
151
|
+
</tr>
|
|
152
|
+
</thead>
|
|
153
|
+
<tbody>
|
|
154
|
+
<tr>
|
|
155
|
+
<td><code>md</code> (default)</td>
|
|
156
|
+
<td style={{ textAlign: 'right' }}>48px</td>
|
|
157
|
+
<td><code>--space-500</code></td>
|
|
158
|
+
<td><code>--space-400</code></td>
|
|
159
|
+
<td><code>--space-200</code></td>
|
|
160
|
+
<td style={{ textAlign: 'right' }}>24</td>
|
|
161
|
+
<td><code>--radius-400</code></td>
|
|
162
|
+
<td>standard forms</td>
|
|
163
|
+
</tr>
|
|
164
|
+
<tr>
|
|
165
|
+
<td><code>sm</code></td>
|
|
166
|
+
<td style={{ textAlign: 'right' }}>40px</td>
|
|
167
|
+
<td><code>--space-500</code></td>
|
|
168
|
+
<td><code>--space-400</code></td>
|
|
169
|
+
<td><code>--space-200</code></td>
|
|
170
|
+
<td style={{ textAlign: 'right' }}>20</td>
|
|
171
|
+
<td><code>--radius-400</code></td>
|
|
172
|
+
<td>dense rows, filter bars, table cells</td>
|
|
173
|
+
</tr>
|
|
174
|
+
</tbody>
|
|
175
|
+
</table>
|
|
176
|
+
|
|
177
|
+
**Helper gap** is the vertical step from the shell to the helper / message line that `Field`
|
|
178
|
+
renders below it — `sizes[].helperGap`, `--space-200` (4) since manifest 2.13.0 (8 read as too far
|
|
179
|
+
from the field). It is safe at 4 because the field has no focus ring to collide with the message,
|
|
180
|
+
and `Body/XS`'s loose leading keeps the optical gap near 8.
|
|
181
|
+
|
|
182
|
+
Heights are fixed on the 4-grid. Width is layout-driven — a field fills its column; the hard
|
|
183
|
+
`min-width` floor is 80px (baseline, no icons / Optional tag). Keep one size consistent within a form.
|
|
184
|
+
|
|
185
|
+
## States
|
|
186
|
+
|
|
187
|
+
<Canvas of={TextFieldStories.States} />
|
|
188
|
+
|
|
189
|
+
Six visual states. Native attributes win when set explicitly (`disabled` / `readOnly`), otherwise the
|
|
190
|
+
state is derived from the `state` prop.
|
|
191
|
+
|
|
192
|
+
<table>
|
|
193
|
+
<thead>
|
|
194
|
+
<tr><th>State</th><th>Border / fill</th><th>Behaviour</th></tr>
|
|
195
|
+
</thead>
|
|
196
|
+
<tbody>
|
|
197
|
+
<tr>
|
|
198
|
+
<td><code>default</code></td>
|
|
199
|
+
<td><code>--outline-default</code> border, <code>--bg-primary</code> fill</td>
|
|
200
|
+
<td>resting; border swaps to <code>--outline-focus</code> on focus-within (Default and Success only — Error keeps its colour, see below)</td>
|
|
201
|
+
</tr>
|
|
202
|
+
<tr>
|
|
203
|
+
<td><code>focused</code></td>
|
|
204
|
+
<td><code>--outline-focus</code> border (1px, no ring)</td>
|
|
205
|
+
<td>editing state; the <code>Field</code> label floats even when empty</td>
|
|
206
|
+
</tr>
|
|
207
|
+
<tr>
|
|
208
|
+
<td><code>error</code></td>
|
|
209
|
+
<td><code>--status-danger</code> border + trailing <code>warning-circle</code> icon</td>
|
|
210
|
+
<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>
|
|
211
|
+
</tr>
|
|
212
|
+
<tr>
|
|
213
|
+
<td><code>success</code></td>
|
|
214
|
+
<td><code>--status-success-solid</code> border + trailing <code>check</code> icon (non-text); <code>Field</code> label + confirmation message in <code>--status-success-tint-foreground</code> (AA)</td>
|
|
215
|
+
<td>colour + icon, never colour alone</td>
|
|
216
|
+
</tr>
|
|
217
|
+
<tr>
|
|
218
|
+
<td><code>disabled</code></td>
|
|
219
|
+
<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>
|
|
220
|
+
<td>"not applicable" — drops from the tab order, value not submitted</td>
|
|
221
|
+
</tr>
|
|
222
|
+
<tr>
|
|
223
|
+
<td><code>readonly</code></td>
|
|
224
|
+
<td><code>--outline-default</code> border @ <code>--border-width-100</code>, <code>--bg-readonly</code> fill, <code>--text-primary</code> value</td>
|
|
225
|
+
<td>"informative, not editable" — stays focusable, copyable and in the tab order, value submits (native <code>readonly</code>)</td>
|
|
226
|
+
</tr>
|
|
227
|
+
</tbody>
|
|
228
|
+
</table>
|
|
229
|
+
|
|
230
|
+
**Read-only ≠ Disabled.** Use `state="readonly"` for a value the user should see and copy but not edit
|
|
231
|
+
here (computed / derived / locked — e.g. a variable symbol derived from the invoice number). Use
|
|
232
|
+
`disabled` only when the field is genuinely not applicable. Focus is a 1px border-colour swap with no
|
|
233
|
+
ring — except on an invalid field (below); there is no hover state.
|
|
234
|
+
|
|
235
|
+
**Error + focus.** A composition, not a seventh State value. The border **keeps** `--status-danger` and
|
|
236
|
+
goes from `--border-width-100` to `--border-width-200` while the field has focus — colour carries the
|
|
237
|
+
state, weight carries the focus. `--outline-focus` never shows on an invalid field: a blue border would
|
|
238
|
+
say "fine" while label, icon and message say "wrong", and tabbing through an invalid form would blink
|
|
239
|
+
red → blue → red. The added weight sits **inside** the shell — an inset `box-shadow` of
|
|
240
|
+
`calc(var(--border-width-200) - var(--border-width-100))` on top of the 1px border — so the height
|
|
241
|
+
(48 / 40) is unchanged and the content does not shift. Label, status icon and message stay exactly as
|
|
242
|
+
in Error. Success + focus stays the plain Focused swap.
|
|
243
|
+
|
|
244
|
+
**Uncontrolled emptiness.** Without `value`, the field tracks whether it is empty from its own change
|
|
245
|
+
events rather than from the stale `defaultValue`, so the en dash of an empty Disabled / Read-only
|
|
246
|
+
field reflects what the user actually left in it. A native form reset fires no change event; the
|
|
247
|
+
field re-syncs from the restored value instead.
|
|
248
|
+
|
|
249
|
+
### Icons
|
|
250
|
+
|
|
251
|
+
An optional **leading** glyph (search / filter fields) and a **trailing** affordance (clear, password
|
|
252
|
+
reveal). On Error / Success the trailing slot is taken by the intrinsic status icon, so a user trailing
|
|
253
|
+
icon shows only on Default / Focused / Disabled.
|
|
254
|
+
|
|
255
|
+
Both glyph slots take `--disabled-foreground` on a Disabled field — the glyph is content, and Disabled
|
|
256
|
+
mutes all of it (manifest `families[].states.disabled.icon`) — and step down to `--icon-muted` on a
|
|
257
|
+
Read-only one, where the glyph marks what the field holds rather than offering an action. The Error /
|
|
258
|
+
Success ink belongs to the status icon, not to the user slots: a leading glyph stays `--text-secondary`
|
|
259
|
+
on an invalid field.
|
|
260
|
+
|
|
261
|
+
<Canvas of={TextFieldStories.WithIcons} />
|
|
262
|
+
|
|
263
|
+
### Label
|
|
264
|
+
|
|
265
|
+
The floating label across value × state. Empty + calm keeps the label **resting inside** (placeholder
|
|
266
|
+
position); a value, focus, error, Disabled or Read-only floats it to the top border. The floated
|
|
267
|
+
label's notch is a `--border-width-100` strip in the surface colour under the field (default
|
|
268
|
+
`--bg-primary`) that interrupts only the border line — not a full-height backplate — so the shell fill
|
|
269
|
+
(Disabled, Read-only) shows through behind the glyphs. The notch (and the optional tag's notch) widens
|
|
270
|
+
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
|
|
271
|
+
value — the empty Read-only cell is shown only for completeness.
|
|
272
|
+
|
|
273
|
+
<Canvas of={TextFieldStories.WithLabel} />
|
|
274
|
+
|
|
275
|
+
### Motion
|
|
276
|
+
|
|
277
|
+
<Canvas of={TextFieldStories.Motion} />
|
|
278
|
+
|
|
279
|
+
Manifest 2.14.0 `motion.states.value` — the one thing that moves. The label **never travels and never
|
|
280
|
+
scales** between its two poses: the pose change is a cross-fade of two copies. The `<label>` itself
|
|
281
|
+
jumps to its new pose and plays the enter keyframe; an `aria-hidden` ghost paints the pose it left
|
|
282
|
+
(through `::before`, so there is no second text node) and fades out, then unmounts. Nothing plays on
|
|
283
|
+
mount — only a real change of pose (focus, first character, clear + blur, error appearing).
|
|
284
|
+
|
|
285
|
+
<table>
|
|
286
|
+
<thead>
|
|
287
|
+
<tr><th>What</th><th>How</th><th>Reduced motion</th></tr>
|
|
288
|
+
</thead>
|
|
289
|
+
<tbody>
|
|
290
|
+
<tr>
|
|
291
|
+
<td>Resting → floated (enter)</td>
|
|
292
|
+
<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>
|
|
293
|
+
<td>Pose swaps at once — <code>motion-reduce:animate-none</code> on the label, <code>motion-reduce:hidden</code> on the ghost.</td>
|
|
294
|
+
</tr>
|
|
295
|
+
<tr>
|
|
296
|
+
<td>Floated → resting (exit)</td>
|
|
297
|
+
<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>
|
|
298
|
+
<td>Same — instant swap.</td>
|
|
299
|
+
</tr>
|
|
300
|
+
</tbody>
|
|
301
|
+
</table>
|
|
302
|
+
|
|
303
|
+
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
|
|
304
|
+
for the resting label — the manifest does not bind the floated label's fade-out separately. The
|
|
305
|
+
floated label's notch is painted on the label itself, so the border shows through it while it fades
|
|
306
|
+
in. The field family inherits this through the shared `Field` label (Textarea, Select / Combobox
|
|
307
|
+
Field, Date Field, Subject Lookup Field) and Field Pair's cells (`_field-segment`); fields whose
|
|
308
|
+
label is always floated (Unit Field, Number Field, Select Field) never change pose and never animate.
|
|
309
|
+
|
|
310
|
+
## API
|
|
311
|
+
|
|
312
|
+
<Controls />
|
|
313
|
+
|
|
314
|
+
## Do / Don't
|
|
315
|
+
|
|
316
|
+
- ✅ Always wrap in `Field` and give the `<input>` an `id` — the floating `<label>` is the accessible name.
|
|
317
|
+
- ✅ Use `state="readonly"` for locked values — it stays copyable and in the tab order.
|
|
318
|
+
- ✅ Write specific, impersonal errors ("IČO musí mít 8 číslic" — problem + fix) and pair `state="error"` with a matching `error` on `Field`.
|
|
319
|
+
- ✅ Reach for the right component — Select for a fixed set, Textarea for multi-line, Date Picker for dates.
|
|
320
|
+
- ❌ Don't use the placeholder as the only label — it disappears on input and fails a11y.
|
|
321
|
+
- ❌ Don't use `disabled` for a value the user still needs to read or copy.
|
|
322
|
+
- ❌ Don't ship generic "Neplatná hodnota" or commands ("Zadejte…").
|
|
323
|
+
- ❌ Don't place a TextField on a tinted / secondary background — the shell fill and contrast are built for `--bg-primary` only.
|
|
324
|
+
|
|
325
|
+
## Accessibility
|
|
326
|
+
|
|
327
|
+
- **Keyboard** — standard text entry. `disabled` fields drop from the tab order; a `readonly` field
|
|
328
|
+
stays focusable, its text is selectable / copyable, and its value **is** submitted with the form. To
|
|
329
|
+
show a non-editable but readable value use Read-only, never `disabled`.
|
|
330
|
+
- **ARIA** — `state="error"` sets `aria-invalid="true"`; associate the message via `aria-describedby`
|
|
331
|
+
(handled by `Field`). `readonly` sets `aria-readonly`. A label-less filter / search field needs an
|
|
332
|
+
explicit `aria-label` — the placeholder is not a label (WCAG 1.3.1 / 3.3.2). An interactive trailing
|
|
333
|
+
icon (`onTrailingIconClick`) requires `trailingIconLabel`.
|
|
334
|
+
- **Screen reader** — the floating `<label>` from `Field` is the accessible name; error / success are
|
|
335
|
+
conveyed by colour **and** a status icon (WCAG 1.4.1), so the cue is not colour-only.
|
|
336
|
+
- **Announcement** (manifest 2.9.1) — `Field` keeps the helper / message line **always mounted** as a
|
|
337
|
+
polite live region (`aria-live="polite"`), empty when there is no message, so an error or
|
|
338
|
+
confirmation that appears while focus is elsewhere (blur validation, an async check such as ARES) is
|
|
339
|
+
read out without moving focus — a region inserted together with its text is not announced. Never
|
|
340
|
+
`role="alert"`: an assertive announcement interrupts typing in the next field. The empty line adds no
|
|
341
|
+
gap, and `aria-describedby` points at it only while it holds a message. On a failed submit the form
|
|
342
|
+
moves focus to the first invalid field and the error is read via `aria-describedby`.
|
|
343
|
+
- **Contrast & motion** — focus is a 1px `--outline-focus` border swap with **no** ring. ⚠️ Accepted
|
|
344
|
+
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
|
|
345
|
+
fields: Error + focus keeps `--status-danger` and goes to `--border-width-200`, so focus stays
|
|
346
|
+
visible without trading the error colour for blue. Besides the border, the only motion is the
|
|
347
|
+
floating label's cross-fade (see States → Motion), which honours `prefers-reduced-motion` and swaps
|
|
348
|
+
the pose at once there.
|
|
349
|
+
|
|
350
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
351
|
+
|
|
352
|
+
## Copy
|
|
353
|
+
|
|
354
|
+
These are the canonical copy rules for fields: other field components (Field Pair, Select,
|
|
355
|
+
Textarea …) follow them. Examples are Czech (the primary market); the rules hold for every language
|
|
356
|
+
version. Text length varies by language, so the maximum lengths below are guidance, not an enforced
|
|
357
|
+
`maxlength`, and the helper and error lines wrap.
|
|
358
|
+
|
|
359
|
+
Voice: five principles.
|
|
360
|
+
|
|
361
|
+
1. **Impersonal and neutral.** In-app copy is depersonalised: avoid addressing the user (vy / ty)
|
|
362
|
+
where possible; prefer noun labels and plain statements.
|
|
363
|
+
2. **Clear over clever.** Plain language, active voice, no jargon: being clear always matters more
|
|
364
|
+
than being entertaining.
|
|
365
|
+
3. **Concise.** The shortest text that is still specific; honour the per-run maximum length.
|
|
366
|
+
4. **Specific and helpful.** Especially errors: say what is wrong **and** how to fix it; never
|
|
367
|
+
blame, never generic.
|
|
368
|
+
5. **Consistent terminology.** One word per concept (faktura, IČO, DIČ, odběratel …), matching the
|
|
369
|
+
product; don't introduce synonyms.
|
|
370
|
+
|
|
371
|
+
Per text run:
|
|
372
|
+
|
|
373
|
+
- **Label** (`label` on `Field`) — a noun phrase in sentence case, 1–3 words, no colon and no
|
|
374
|
+
command; always present. Instructions go in the helper, not the label. Single line, truncates with
|
|
375
|
+
an ellipsis at the field's inner width; about 24 characters at most.
|
|
376
|
+
- **Value** (the input's value) — single line; the editable input scrolls horizontally (no
|
|
377
|
+
ellipsis) and truncates only when rendered read-only. The component sets no maximum length: the
|
|
378
|
+
consumer sets `maxlength` per type (IČO 8, PSČ 5, …).
|
|
379
|
+
- **Placeholder** (`placeholder` on `TextField`) — optional, a **format example** only, never a
|
|
380
|
+
substitute for the label or a repeat of it. Shown only while the field is empty; never on a
|
|
381
|
+
Disabled field, which shows an en dash "–" instead. Single line, truncates with an ellipsis; about
|
|
382
|
+
30 characters at most.
|
|
383
|
+
- **Helper** (`helperText` on `Field`) — a persistent hint: the format, or where to find the value.
|
|
384
|
+
Concise, about one line; wraps and is never truncated; about 120 characters at most.
|
|
385
|
+
- **Error** (`error` on `Field`) — impersonal, **problem + fix or format**, specific; it replaces
|
|
386
|
+
the helper. Wraps and must stay fully visible (WCAG 3.3.1); the field keeps its height and only
|
|
387
|
+
the message area below grows; about 140 characters at most.
|
|
388
|
+
- **Optional tag** (`optionalLabel` on `Field`) — `Volitelný`, capitalised and without brackets, on
|
|
389
|
+
optional fields **only**.
|
|
390
|
+
|
|
391
|
+
Error pattern: `[what's wrong]( + [expected format])`, impersonal, e.g. "Neplatné datum — formát
|
|
392
|
+
DD. MM. RRRR". Not a command ("Zadejte…"), not a bare label ("Chyba").
|
|
393
|
+
|
|
394
|
+
<table>
|
|
395
|
+
<thead>
|
|
396
|
+
<tr><th>Run</th><th>✅</th><th>❌</th></tr>
|
|
397
|
+
</thead>
|
|
398
|
+
<tbody>
|
|
399
|
+
<tr><td>Label</td><td><code>IČO</code> · <code>Datum splatnosti</code></td><td><code>Zadejte vaše IČO:</code></td></tr>
|
|
400
|
+
<tr><td>Placeholder</td><td><code>12345678</code></td><td><code>Sem napište IČO</code></td></tr>
|
|
401
|
+
<tr><td>Helper</td><td><code>Najdete v hlavičce faktury</code></td><td><code>Toto pole je pro IČO</code></td></tr>
|
|
402
|
+
<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>
|
|
403
|
+
<tr><td>Optional tag</td><td><code>Volitelný</code></td><td><code>*</code> on every required field</td></tr>
|
|
404
|
+
</tbody>
|
|
405
|
+
</table>
|
|
406
|
+
|
|
407
|
+
## Usage
|
|
408
|
+
|
|
409
|
+
<Canvas of={TextFieldStories.WithField} />
|
|
410
|
+
|
|
411
|
+
```tsx
|
|
412
|
+
// Good — wrapped in Field, input has an id, label is the accessible name
|
|
413
|
+
<Field label="IČO" helperText="Najdete v hlavičce faktury">
|
|
414
|
+
<TextField id="ico" defaultValue="12345678" />
|
|
415
|
+
</Field>
|
|
416
|
+
|
|
417
|
+
// Good — error state paired with a matching, specific message
|
|
418
|
+
<Field label="IČO" error="IČO musí mít 8 číslic">
|
|
419
|
+
<TextField id="ico" state="error" defaultValue="1234" />
|
|
420
|
+
</Field>
|
|
421
|
+
|
|
422
|
+
// Good — locked, computed value stays copyable (readonly, not disabled)
|
|
423
|
+
<Field label="Variabilní symbol" helperText="Odvozeno z čísla faktury">
|
|
424
|
+
<TextField id="vs" state="readonly" defaultValue="20260721" />
|
|
425
|
+
</Field>
|
|
426
|
+
|
|
427
|
+
// Good — search / filter field with a leading glyph and an aria-label
|
|
428
|
+
<TextField leadingIcon="magnifying-glass" placeholder="Hledat…" aria-label="Hledat" />
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
```tsx
|
|
432
|
+
// Don't — placeholder used as the only label (no Field, no id, no aria-label)
|
|
433
|
+
<TextField placeholder="IČO" />
|
|
434
|
+
|
|
435
|
+
// Don't — disabled hides a value the user still needs to read / copy
|
|
436
|
+
<TextField state="disabled" defaultValue="20260721" />
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
## Related
|
|
440
|
+
|
|
441
|
+
- [`Field`](/docs/shadcn-field--docs) — the wrapper that supplies the floating label, helper and error / success messaging (mandatory partner).
|
|
442
|
+
- [`Textarea`](/docs/shadcn-textarea--docs) — multi-line sibling sharing the same shell.
|
|
443
|
+
- `UnitField` — TextField shell with an in-field unit / suffix (`Kč`, `%`).
|
|
444
|
+
- `NumberField` — the stepper variant for numeric quantities.
|
|
445
|
+
- `Select` — for choosing from a fixed set of options; reuses the same field shell.
|
|
446
|
+
- Spec: `spec/03-atoms/text-field.md`.
|
|
447
|
+
|
|
448
|
+
## Migration notes
|
|
449
|
+
|
|
450
|
+
- **Manifest 2.14.0 (2026-11-03) — floating-label motion.** The label used to *travel*: a 200ms
|
|
451
|
+
transition on `top` / `left` / `transform` / `font-size` / `color` / `padding` / `max-width`, plus a
|
|
452
|
+
delayed `background` for the notch, all on raw values. It now cross-fades on motion tokens (States →
|
|
453
|
+
Motion) and has no transition at all — status ink changes (error ↔ default) are now instant too, as
|
|
454
|
+
the manifest's motion block lists nothing else that moves. Field Pair dropped its own copy of the
|
|
455
|
+
old transition (`SEGMENT_LABEL_TRANSITION`) and cross-fades its cells the same way.
|
|
456
|
+
- **`type="date"` is specified upstream but NOT built here yet.** Manifest 2.7.0 (2026-08-31) adds it
|
|
457
|
+
to the non-visual type list: leading `calendar-dots` glyph, a tap or click anywhere on the field
|
|
458
|
+
opens a Single-month `DatePicker` anchored to it (Esc closes, focus returns — the picker's own
|
|
459
|
+
contract), and the value stays a typed-editable text input, *never* the native date input. It
|
|
460
|
+
closes the form-layout gap "Date Picker lacks a field-trigger variant" by extending the Field Pair
|
|
461
|
+
date-mode decisions (2026-08-05/11) to the standalone field. Today this component's `type` prop is
|
|
462
|
+
passed straight to the input and does none of that. The pieces exist (`DatePicker`, and the
|
|
463
|
+
`useDateFieldTrigger` extraction behind Field Pair's date mode), so this is a build, not a design
|
|
464
|
+
question.
|
|
465
|
+
- **`Help` (the label's ⓘ Tooltip trigger) is specified upstream but NOT built here.** The manifest
|
|
466
|
+
property `Help` (on the nested `_labelContainer`) puts an info ⓘ after the label text; `Field` has
|
|
467
|
+
no prop for it. Manifest 2.11.0 (2026-10-13) adds that a field with `Help` on floats its label even
|
|
468
|
+
while empty and shows the placeholder inside — the one exception to the floating-label rule — and
|
|
469
|
+
that there is no trailing help slot. Without a `Help` prop that exception has nothing to hang on, so
|
|
470
|
+
the float rule here is unchanged; until `Help` ships, put a hint the user needs before typing into
|
|
471
|
+
`helperText` (the spec's "helper first" route), never into a trailing icon.
|
|
472
|
+
- **Numeric quantities** with a stepper are a **separate NumberField component**, not a TextField
|
|
473
|
+
variant. **In-field units / computed suffixes** (`Kč`, `%`) live in the **separate UnitField**,
|
|
474
|
+
keeping TextField's trailing slot icons-only.
|
|
475
|
+
- **Icon names match the spec except for Success.** The component uses the canonical FODS
|
|
476
|
+
names (Error `warning-circle`, leading `magnifying-glass`); the legacy icon-font names are not
|
|
477
|
+
part of `IconName` in React. The one genuine difference is
|
|
478
|
+
Success, which renders the bare `check` where the spec names `check-circle` (the icon set has that
|
|
479
|
+
one too).
|