@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,683 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as ChipStories from './Chip.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={ChipStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# Chip
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Status:** draft
|
|
13
|
+
- **Tokens used:** `--bg-primary`, `--bg-secondary`, `--border-width-100`, `--border-width-200`, `--disabled-control`, `--disabled-foreground`, `--font-body`, `--font-size-sm`, `--font-size-xxs`, `--font-weight-semibold`, `--leading-loose`, `--leading-relaxed`, `--outline-default`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--radius-300`, `--size-icon-2xsmall`, `--size-icon-xsmall`, `--space-100`, `--space-200`, `--space-300`, `--space-400`, `--space-600`, `--space-800`, `--status-danger-soft`, `--status-danger-solid`, `--status-danger-subtle`, `--status-danger-subtle-border`, `--status-danger-tint-foreground`, `--status-info-soft`, `--status-info-solid`, `--status-info-subtle`, `--status-info-subtle-border`, `--status-info-tint-foreground`, `--status-success-soft`, `--status-success-solid`, `--status-success-subtle`, `--status-success-subtle-border`, `--status-success-tint-foreground`, `--status-violet-soft`, `--status-violet-solid`, `--status-violet-subtle`, `--status-violet-subtle-border`, `--status-violet-tint-foreground`, `--status-warning-soft`, `--status-warning-solid`, `--status-warning-subtle`, `--status-warning-subtle-border`, `--status-warning-tint-foreground`, `--tertiary-soft`, `--tertiary-solid`, `--tertiary-subtle`, `--tertiary-subtle-border`, `--tertiary-tint-foreground`, `--text-inverted`, `--text-wrap-body`
|
|
14
|
+
- **Manifest version:** `1.8.1`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
Chip is the **interactive tag family** — three types in one set:
|
|
19
|
+
|
|
20
|
+
- **Basic** — a plain tag (no checkbox, no ×): pill + label, the whole chip is the click target,
|
|
21
|
+
e.g. a lightweight filter above a table. With `href` it is a **link** instead — a chip that leads
|
|
22
|
+
to a listing, such as the category chips under an article; a Basic chip that only filters stays a
|
|
23
|
+
button.
|
|
24
|
+
- **Selectable** (the default) — a filter / toggle chip. Selection is carried by a **leading
|
|
25
|
+
checkbox**; the pill stays a soft status tint. This is the invoice-list status filter
|
|
26
|
+
(*Zaplaceno* / *Nezaplaceno* / *Po splatnosti* / *Budoucí*).
|
|
27
|
+
- **Deleteable** — a removable tag the user dismisses via a trailing **×**.
|
|
28
|
+
|
|
29
|
+
Reach for Chip when a tag **does something**. **Do NOT use it** for a tag that only *reports* state
|
|
30
|
+
(that is **Badge**), for a primary action (**Button**), or for a bare count (a plain number). A
|
|
31
|
+
filter-bar **facet trigger** whose selection recolours the pill is **Filter Chip** — a different
|
|
32
|
+
(32/40) control tier, not this one.
|
|
33
|
+
|
|
34
|
+
<Canvas of={ChipStories.Playground} />
|
|
35
|
+
|
|
36
|
+
## Rationale
|
|
37
|
+
|
|
38
|
+
The deprecated system bundled four "badge" sets that conflated two jobs — *reporting* status (Badge,
|
|
39
|
+
Badge Advanced) and *interacting* with it (Selectable, Deleteable). Badge took the read-only job;
|
|
40
|
+
**Chip takes the interactive one**, so each atom has exactly one behaviour contract: Badge is static
|
|
41
|
+
text with no states, Chip adds **hover, focus, disabled** plus an affordance (checkbox or ×).
|
|
42
|
+
|
|
43
|
+
Chip shares Badge's soft status palette — a chip and a status badge sit together in one row without
|
|
44
|
+
clashing — and shares its chrome through the `Pill` (`spec/06-patterns/pill.md`)
|
|
45
|
+
recipe (shape, radius, height, label, colour model, gap, padding). The one deliberate divergence:
|
|
46
|
+
**selection does not recolour the pill.** A selected chip
|
|
47
|
+
shows its selection purely through its checkbox — only the checkbox fills, and
|
|
48
|
+
it fills in the *chip's own family colour*, overriding the standalone Checkbox's blue. That is why
|
|
49
|
+
Chip carries no Badge-style Solid appearance.
|
|
50
|
+
|
|
51
|
+
## Anatomy
|
|
52
|
+
|
|
53
|
+
- **Pill** (`root`) — the container. `inline-flex` chrome: fill + ink per emotion × state, radius and
|
|
54
|
+
gap per size, `transition-[background-color,color]` over `--duration-hover` / `--easing-standard` (manifest 1.7.2
|
|
55
|
+
`motion.states.hover` — the hover fill eases). It is the only element that carries colour — every glyph rides
|
|
56
|
+
`currentColor` off the pill's `text-*` class. Its element depends on the type: an `<a>` for
|
|
57
|
+
Basic **with `href`**, a `<button>` for Basic without `href` and without the ⓘ, a `<span>` for
|
|
58
|
+
Basic with the ⓘ (a `<button>` may not contain the ⓘ trigger, which is itself a button), and a
|
|
59
|
+
`<span>` for Selectable and Deleteable — five shells, not three. The pill's ink and its
|
|
60
|
+
`no-underline` carry Tailwind's `!` (important) flag, so a consuming app's global `a` colour or
|
|
61
|
+
underline rule cannot repaint the link shell; the values are still the manifest tokens.
|
|
62
|
+
- **Leading icon** (`leading-icon`, Deleteable · Basic, optional, **on by default**) — a glyph before
|
|
63
|
+
the label, added in manifest 1.7.0 (`slots.leading-icon`, prop `leadingIcon`). Same rule as Badge
|
|
64
|
+
and Button: it shows by default and is left out only where space is tight. Size is the chip's own
|
|
65
|
+
glyph size (`sizes[].icon`: 16 `--size-icon-xsmall` / 14 `--size-icon-2xsmall`), the gap is the pill's gap, and the ink is the label's in every
|
|
66
|
+
state (currentColor off the pill). Order: Deleteable = glyph → label → ×; Basic = glyph → label →
|
|
67
|
+
optional ⓘ. Decorative — `Icon` renders `aria-hidden`. **Not on Selectable**: its checkbox is the
|
|
68
|
+
leading element, so a `leadingIcon` there logs a dev warning and renders nothing.
|
|
69
|
+
- **Label** — `Body/S/Semibold` (`md`) / `Body/XXS/Semibold` (`sm`), `min-w-0 truncate`. Plain text:
|
|
70
|
+
1 line, ≤ ~24 chars per the manifest's `text.label`, truncated on overflow. On a Basic chip it is
|
|
71
|
+
the only element — unless the ⓘ is on, and then it shares the pill with the trigger.
|
|
72
|
+
- **Toggle** (Selectable) — the `<label>` that makes the checkbox + text one target. It owns the
|
|
73
|
+
checkbox↔label gap (equal to the pill's own gap) and carries no colour of its own.
|
|
74
|
+
- **Checkbox** (Selectable) — a 16px box (`--space-600`) at both chip sizes, `--radius-200`,
|
|
75
|
+
`--border-width-100`. Unchecked it is `--bg-primary` with the chip's family `-subtle-border` (e.g.
|
|
76
|
+
`--status-warning-subtle-border`; Neutral `--tertiary-subtle-border`) — a control on a status
|
|
77
|
+
surface takes its border from that surface — and checked it takes the chip's family solid. Selection is driven by a real
|
|
78
|
+
`<input type="checkbox">` that sits visually hidden over the box with a 24×24 (`--space-800`)
|
|
79
|
+
centred hit area; the visible box and the check overlay are its `peer` siblings. The box fills over
|
|
80
|
+
`--duration-toggle` / `--easing-standard` — the standalone Checkbox's toggle motion, which the chip
|
|
81
|
+
inherits (`motion.inherits: ["checkbox"]`, 1.7.2); the tick appears with the fill, at once. The
|
|
82
|
+
check glyph is the Checkbox's own `sm` glyph size, `--size-icon-2xsmall`, at **both** chip sizes:
|
|
83
|
+
the Chip never sizes it, so it does not follow the chip's `size` (manifest 1.8.1
|
|
84
|
+
`slots.checkbox`).
|
|
85
|
+
- **ⓘ** (Selectable · Basic, optional) — a Tooltip trigger rendered after the label as a real focusable
|
|
86
|
+
`<button>`, named by `info.label`; **composition by reference**, the Chip does not own the tooltip,
|
|
87
|
+
it attaches one. It is a *sibling* of the clickable element, never a child (an interactive element
|
|
88
|
+
may not contain another one). Opened to Basic in `chip` 1.2.0: a status pill that must not offer a
|
|
89
|
+
payment checkbox — an invoice's `Budoucí` — still needs the tooltip the rest of the Stav column
|
|
90
|
+
shows. **Not on Deleteable**: that trailing slot is the ×, and two trailing affordances compete for
|
|
91
|
+
the same click. **Not on a link chip** either (Basic with `href`): the trigger is a `<button>`, and
|
|
92
|
+
an interactive element may not nest inside an `<a>`.
|
|
93
|
+
- **×** (Deleteable) — a real `<button type="button">` named by the required `removeLabel`, the click
|
|
94
|
+
target, with a 24×24 (`--space-800`) hit area drawn as a centred `::before` even though the glyph
|
|
95
|
+
is 14–16px, so the target grows without moving the pill.
|
|
96
|
+
|
|
97
|
+
Heights are **grid-derived** (line box + block padding) and land at 30 / 22 per the manifest —
|
|
98
|
+
deliberately not a fixed `h-*`, exactly as in Badge.
|
|
99
|
+
|
|
100
|
+
A Pill **hugs its content on both axes** and the root enforces that with `w-fit h-fit`. This is not
|
|
101
|
+
redundant with `inline-flex`: a grid item is blockified to `flex` and then stretched by the default
|
|
102
|
+
`justify-self` / `align-self: stretch`, which inflates the pill to its cell and pushes the trailing ×
|
|
103
|
+
away from the label. So the × is always exactly `gap` from the label **and** the type's right inline
|
|
104
|
+
padding from the edge — the two can never disagree, because the width never inflates. A chip is never
|
|
105
|
+
full-width; a bar of chips wraps, it does not stretch.
|
|
106
|
+
|
|
107
|
+
> **The nested checkbox is Chip's own markup, not a `<Checkbox>` instance.** It reuses the
|
|
108
|
+
> peer-driven pattern from `Checkbox.tsx`, but the host-family override (the checked fill is the
|
|
109
|
+
> chip's own family solid, e.g. `--status-success-solid`) and the chip's disabled treatment
|
|
110
|
+
> (`--bg-secondary` + `--outline-default`)
|
|
111
|
+
> cannot be expressed through the `Checkbox` API. The same override reaches the unchecked box: its
|
|
112
|
+
> border is the family's `-subtle-border` instead of the standalone Checkbox's `--outline-strong`
|
|
113
|
+
> (`chip.manifest.json` 1.5.1 `slots.checkbox`, the family border on `--bg-primary`). Nor does it take the standalone
|
|
114
|
+
> Checkbox's `--secondary` hover border — the Figma Hover variants keep the box border and change
|
|
115
|
+
> only the pill's fill.
|
|
116
|
+
|
|
117
|
+
## Variants
|
|
118
|
+
|
|
119
|
+
Two axes: **type** (3) changes composition, **emotion** (6) changes colour — across two sizes and the
|
|
120
|
+
Default · Hover · Disabled state axis, that is the manifest's 108-variant matrix.
|
|
121
|
+
|
|
122
|
+
<Canvas of={ChipStories.Types} />
|
|
123
|
+
|
|
124
|
+
<table>
|
|
125
|
+
<thead>
|
|
126
|
+
<tr><th>Type</th><th>When</th><th>Composition</th><th>Focus ring owner</th></tr>
|
|
127
|
+
</thead>
|
|
128
|
+
<tbody>
|
|
129
|
+
<tr>
|
|
130
|
+
<td><code>basic</code></td>
|
|
131
|
+
<td>A plain filter tag, e.g. above a table — the whole chip is the click target</td>
|
|
132
|
+
<td>The pill IS a <code><button type="button"></code> + optional leading glyph + label; with the optional ⓘ the root degrades to a <code><span></code> wrapping an inner button (glyph + label) + the trigger</td>
|
|
133
|
+
<td>The pill itself (<code>focus-visible:</code> on the root); with the ⓘ, the inner button that wraps the label — the ⓘ rings itself</td>
|
|
134
|
+
</tr>
|
|
135
|
+
<tr>
|
|
136
|
+
<td><code>basic</code> + <code>href</code></td>
|
|
137
|
+
<td>A chip that leads to a listing, e.g. the category chips under an article</td>
|
|
138
|
+
<td>The pill IS an <code><a href></code> + optional leading glyph + label; never an ⓘ</td>
|
|
139
|
+
<td>The pill itself, the same root ring as the Basic button</td>
|
|
140
|
+
</tr>
|
|
141
|
+
<tr>
|
|
142
|
+
<td><code>selectable</code> (default)</td>
|
|
143
|
+
<td>A status filter the user toggles; selection lives in the leading checkbox</td>
|
|
144
|
+
<td><code><span></code> pill + <code><label></code> wrapping a native <code><input type="checkbox"></code>, the visible box, the check overlay, the label and an optional ⓘ</td>
|
|
145
|
+
<td>The pill, scoped to the input (<code>has-[input:focus-visible]:</code>) so the ⓘ does not trigger it</td>
|
|
146
|
+
</tr>
|
|
147
|
+
<tr>
|
|
148
|
+
<td><code>deleteable</code></td>
|
|
149
|
+
<td>A removable token — an applied filter, an e-mail-template variable</td>
|
|
150
|
+
<td><code><span></code> pill + optional leading glyph + label + a real <code><button></code> carrying the ×, named by the required <code>removeLabel</code></td>
|
|
151
|
+
<td>The <strong>×</strong> button — the pill is a plain <code><span></code> and holds no DOM focus</td>
|
|
152
|
+
</tr>
|
|
153
|
+
</tbody>
|
|
154
|
+
</table>
|
|
155
|
+
|
|
156
|
+
**Basic as a link** (manifest 1.7.3 `delivery.react`) — pass `href` and the whole pill renders as an
|
|
157
|
+
`<a href>`. Palette, sizes, padding, leading glyph, hover and disabled colours are Basic's; only the
|
|
158
|
+
element changes. A Basic chip without `href` stays the `<button>` filter tag.
|
|
159
|
+
|
|
160
|
+
<Canvas of={ChipStories.Links} />
|
|
161
|
+
|
|
162
|
+
<Canvas of={ChipStories.Emotions} />
|
|
163
|
+
|
|
164
|
+
<table>
|
|
165
|
+
<thead>
|
|
166
|
+
<tr><th>Emotion</th><th>When</th><th>Rest (Default)</th><th>Hover</th><th>Checked checkbox</th></tr>
|
|
167
|
+
</thead>
|
|
168
|
+
<tbody>
|
|
169
|
+
<tr>
|
|
170
|
+
<td><code>info</code> (default)</td>
|
|
171
|
+
<td>Informational / draft (<em>Návrh</em>)</td>
|
|
172
|
+
<td><code>--status-info-subtle</code> + <code>--status-info-tint-foreground</code></td>
|
|
173
|
+
<td><code>--status-info-soft</code></td>
|
|
174
|
+
<td><code>--status-info-solid</code> box + <code>--status-info-foreground</code> check</td>
|
|
175
|
+
</tr>
|
|
176
|
+
<tr>
|
|
177
|
+
<td><code>success</code></td>
|
|
178
|
+
<td>Paid, done (<em>Zaplaceno</em>)</td>
|
|
179
|
+
<td><code>--status-success-subtle</code> + <code>--status-success-tint-foreground</code></td>
|
|
180
|
+
<td><code>--status-success-soft</code></td>
|
|
181
|
+
<td><code>--status-success-solid</code> box + <code>--status-success-foreground</code> check</td>
|
|
182
|
+
</tr>
|
|
183
|
+
<tr>
|
|
184
|
+
<td><code>warning</code></td>
|
|
185
|
+
<td>Attention, unpaid (<em>Nezaplaceno</em>)</td>
|
|
186
|
+
<td><code>--status-warning-subtle</code> + <code>--status-warning-tint-foreground</code></td>
|
|
187
|
+
<td><code>--status-warning-soft</code></td>
|
|
188
|
+
<td><code>--status-warning-solid</code> box + <strong>dark</strong> <code>--status-warning-foreground</code> check</td>
|
|
189
|
+
</tr>
|
|
190
|
+
<tr>
|
|
191
|
+
<td><code>danger</code></td>
|
|
192
|
+
<td>Overdue, error (<em>Po splatnosti</em>)</td>
|
|
193
|
+
<td><code>--status-danger-subtle</code> + <code>--status-danger-tint-foreground</code></td>
|
|
194
|
+
<td><code>--status-danger-soft</code></td>
|
|
195
|
+
<td><code>--status-danger-solid</code> box + <code>--status-danger-foreground</code> check</td>
|
|
196
|
+
</tr>
|
|
197
|
+
<tr>
|
|
198
|
+
<td><code>violet</code></td>
|
|
199
|
+
<td>Upcoming (<em>Budoucí</em>)</td>
|
|
200
|
+
<td><code>--status-violet-subtle</code> + <code>--status-violet-tint-foreground</code></td>
|
|
201
|
+
<td><code>--status-violet-soft</code></td>
|
|
202
|
+
<td><code>--status-violet-solid</code> box + <code>--status-violet-foreground</code> check</td>
|
|
203
|
+
</tr>
|
|
204
|
+
<tr>
|
|
205
|
+
<td><code>neutral</code></td>
|
|
206
|
+
<td>Draft / no status, generic tokens (<em>Koncept</em>)</td>
|
|
207
|
+
<td><code>--tertiary-subtle</code> + <code>--tertiary-tint-foreground</code></td>
|
|
208
|
+
<td><code>--tertiary-soft</code></td>
|
|
209
|
+
<td><code>--tertiary-solid</code> box + <code>--tertiary-foreground</code> check</td>
|
|
210
|
+
</tr>
|
|
211
|
+
</tbody>
|
|
212
|
+
</table>
|
|
213
|
+
|
|
214
|
+
The full type × emotion × size grid, mirroring the Figma labelled set — Basic and Deleteable with
|
|
215
|
+
the leading glyph on, as the set ships it (`Show leading icon` = true):
|
|
216
|
+
|
|
217
|
+
<Canvas of={ChipStories.Matrix} />
|
|
218
|
+
|
|
219
|
+
**Leading icon** (manifest 1.7.0) — the optional glyph before the label on Deleteable and Basic. The
|
|
220
|
+
Figma set starts every variant on `Icons / info`, but that is an artefact of the instance swap (it
|
|
221
|
+
needs one starting value), not a code default: `leadingIcon` has none, and the caller passes the
|
|
222
|
+
glyph that fits the tag — Badge's status set (`BADGE_STATUS_ICONS`) is the preferred one, so a chip
|
|
223
|
+
and a badge of the same family show the same glyph.
|
|
224
|
+
|
|
225
|
+
<Canvas of={ChipStories.LeadingIcon} />
|
|
226
|
+
|
|
227
|
+
> **The check glyph is white in every family — a signed contrast exception.** White on
|
|
228
|
+
> `--status-warning-solid` measures **2.37:1**, so this build originally bound each family's own
|
|
229
|
+
> `-foreground` ink instead (dark for Warning) and flagged the substitution for the designer. The
|
|
230
|
+
> spec owner decided the other way: `chip.manifest.json` 1.3.0 `slots.checkbox` records the white
|
|
231
|
+
> tick as an accepted, signed exception (2026-09-04) and says *"Do NOT bind
|
|
232
|
+
> `--status-warning-foreground` (or any other `-foreground` role) to this glyph — it stays white,
|
|
233
|
+
> full stop."* The reasoning is that the checked contract is system-wide — one glyph colour, never
|
|
234
|
+
> re-derived per family — and the tick is already duplicated by the selected fill itself plus the
|
|
235
|
+
> chip's label, so the sub-AA glyph is not the sole carrier of the checked state. The code binds
|
|
236
|
+
> `--text-inverted` once, on the glyph slot.
|
|
237
|
+
|
|
238
|
+
## Sizes
|
|
239
|
+
|
|
240
|
+
<Canvas of={ChipStories.Sizes} />
|
|
241
|
+
|
|
242
|
+
<table>
|
|
243
|
+
<thead>
|
|
244
|
+
<tr><th>Size</th><th style={{ textAlign: 'right' }}>Height</th><th>Label</th><th style={{ textAlign: 'right' }}>Leading / ⓘ / × glyph</th><th>Checkbox</th><th>Radius</th><th>Block padding</th><th>Gap</th></tr>
|
|
245
|
+
</thead>
|
|
246
|
+
<tbody>
|
|
247
|
+
<tr>
|
|
248
|
+
<td><code>md</code> (default)</td>
|
|
249
|
+
<td style={{ textAlign: 'right' }}>30px</td>
|
|
250
|
+
<td><code>Body/S/Semibold</code> (14) + <code>--leading-loose</code></td>
|
|
251
|
+
<td style={{ textAlign: 'right' }}>16px</td>
|
|
252
|
+
<td>16px box (Checkbox size S), check <code>--size-icon-2xsmall</code></td>
|
|
253
|
+
<td><code>--radius-300</code></td>
|
|
254
|
+
<td><code>--space-200</code></td>
|
|
255
|
+
<td><code>--space-300</code></td>
|
|
256
|
+
</tr>
|
|
257
|
+
<tr>
|
|
258
|
+
<td><code>sm</code></td>
|
|
259
|
+
<td style={{ textAlign: 'right' }}>22px</td>
|
|
260
|
+
<td><code>Body/XXS/Semibold</code> (12)</td>
|
|
261
|
+
<td style={{ textAlign: 'right' }}>14px</td>
|
|
262
|
+
<td>16px box (Checkbox size S), check <code>--size-icon-2xsmall</code></td>
|
|
263
|
+
<td><code>--radius-200</code></td>
|
|
264
|
+
<td><code>--space-100</code></td>
|
|
265
|
+
<td><code>--space-200</code></td>
|
|
266
|
+
</tr>
|
|
267
|
+
</tbody>
|
|
268
|
+
</table>
|
|
269
|
+
|
|
270
|
+
The `md` label sets `--leading-loose` explicitly: the project-wide `text-body-sm` maps to
|
|
271
|
+
`--leading-tight`, which would leave the pill 3px short of the spec height. `text-body-xxs` already
|
|
272
|
+
carries its own relaxed leading, so `sm` adds nothing. The leading checkbox stays **size S (16px)** in
|
|
273
|
+
both sizes — never scale it, scaling gives an off-grid border — and so does its check glyph, which is
|
|
274
|
+
the Checkbox's own step, not the chip's glyph size.
|
|
275
|
+
|
|
276
|
+
**Inline padding is a per-TYPE rule, not a size row.** It comes from the Pill recipe: the text side
|
|
277
|
+
keeps the size base, the affordance side steps down one spacing step in code, and Basic (no
|
|
278
|
+
affordance) is a compact symmetric `--space-300` at both sizes. Since manifest 1.4.0 the Basic pair
|
|
279
|
+
is structural — `sizes[].paddingXByType.basic` — but the other four stay in `paddingText` /
|
|
280
|
+
`paddingIcon`, and the static verifier reads neither: its size vocabulary resolves one flat value per
|
|
281
|
+
aspect, not a value keyed by a second axis. The runtime pass settles all six.
|
|
282
|
+
|
|
283
|
+
> **Deleteable + leading glyph is derived, not specified.** Manifest 1.7.0 adds the slot but says
|
|
284
|
+
> nothing about padding. The Pill recipe names a *leading status glyph* as an affordance side (that
|
|
285
|
+
> is Badge's step-down), so the glyph side takes the same one-step-down value as the × side. Basic
|
|
286
|
+
> stays at its symmetric `--space-300` — it has no text-side base to step from. Awaiting the
|
|
287
|
+
> designer's confirmation.
|
|
288
|
+
|
|
289
|
+
<table>
|
|
290
|
+
<thead>
|
|
291
|
+
<tr><th>Type</th><th>Size</th><th>Left</th><th>Right</th></tr>
|
|
292
|
+
</thead>
|
|
293
|
+
<tbody>
|
|
294
|
+
<tr><td><code>basic</code></td><td><code>md</code> · <code>sm</code></td><td><code>--space-300</code></td><td><code>--space-300</code></td></tr>
|
|
295
|
+
<tr><td><code>selectable</code></td><td><code>md</code></td><td><code>--space-300</code> (checkbox side)</td><td><code>--space-400</code></td></tr>
|
|
296
|
+
<tr><td><code>selectable</code></td><td><code>sm</code></td><td><code>--space-200</code> (checkbox side)</td><td><code>--space-300</code></td></tr>
|
|
297
|
+
<tr><td><code>deleteable</code></td><td><code>md</code></td><td><code>--space-400</code></td><td><code>--space-300</code> (× side)</td></tr>
|
|
298
|
+
<tr><td><code>deleteable</code></td><td><code>sm</code></td><td><code>--space-300</code></td><td><code>--space-200</code> (× side)</td></tr>
|
|
299
|
+
<tr><td><code>deleteable</code> + leading glyph</td><td><code>md</code></td><td><code>--space-300</code> (glyph side)</td><td><code>--space-300</code> (× side)</td></tr>
|
|
300
|
+
<tr><td><code>deleteable</code> + leading glyph</td><td><code>sm</code></td><td><code>--space-200</code> (glyph side)</td><td><code>--space-200</code> (× side)</td></tr>
|
|
301
|
+
</tbody>
|
|
302
|
+
</table>
|
|
303
|
+
|
|
304
|
+
## States
|
|
305
|
+
|
|
306
|
+
<Canvas of={ChipStories.States} />
|
|
307
|
+
|
|
308
|
+
- **Default** — the family's soft rest tint (`--status-info-subtle` …, `neutral` →
|
|
309
|
+
`--tertiary-subtle`) with the matching `-tint-foreground` ink.
|
|
310
|
+
- **Hover** — the pill deepens one tint step (`--status-info-subtle` → `--status-info-soft`, and so
|
|
311
|
+
on per family; `neutral` → `--tertiary-soft`) — and **nothing else changes.** The nested checkbox
|
|
312
|
+
keeps its family `-subtle-border` and the × keeps the label ink: the Figma Default → Hover pairs
|
|
313
|
+
differ by exactly one variable, the pill's fill. Chip therefore does **not** inherit the standalone
|
|
314
|
+
Checkbox's `--secondary` hover border; the whole affordance lives on the pill. The fill change eases
|
|
315
|
+
over `--duration-hover` / `--easing-standard` (`motion.states.hover`, `background-color` only). The
|
|
316
|
+
leading glyph keeps the label ink here as in every state.
|
|
317
|
+
- **Focus** — **not a Chip variant.** It is the cross-cutting focus-ring pattern: an additive
|
|
318
|
+
`:focus-visible` outline in `--outline-focus` at `--border-width-200` with a 2px offset, never a
|
|
319
|
+
border on the pill (that would shift layout). Who draws it depends on the type — see the table in
|
|
320
|
+
[Variants](#variants). The ⓘ trigger rings *itself* and is deliberately outside the chip's focus
|
|
321
|
+
contract, which is why the Selectable ring is scoped to `has-[input:focus-visible]:`.
|
|
322
|
+
- **Disabled** — a uniform `--disabled-control` fill + a neutral `--outline-default` hairline at
|
|
323
|
+
`--border-width-100` + `--disabled-foreground` ink, **emotion-independent** (Button token parity)
|
|
324
|
+
and built from tokens, never `opacity`. The hairline is `strokeMode: "inset-outline"` — the Filter
|
|
325
|
+
Chip recipe, an `outline` at −1px, so the pill keeps its box (manifest 1.5.0). It shares the root's
|
|
326
|
+
one `outline` with the focus ring, but never at the same time: nothing in a disabled chip can take
|
|
327
|
+
focus; the emotion compounds are gated on
|
|
328
|
+
`disabled: false`, so no family fill or `hover:` class is emitted to compete. The checkbox is muted
|
|
329
|
+
to `--bg-secondary` + `--outline-default` and the check glyph to `--disabled-foreground`, checked
|
|
330
|
+
or not. Every sub-control gets the native `disabled` attribute — and only that; a natively disabled control is already exposed as disabled, so no `aria-disabled` is repeated beside it.
|
|
331
|
+
The one exception is the **link** shell, because an `<a>` has no native `disabled`: as on
|
|
332
|
+
`TextLink`, the `href` is removed, `role="link"` is re-stated, `aria-disabled="true"` and
|
|
333
|
+
`tabIndex={-1}` are set, and the click — Enter included — is swallowed.
|
|
334
|
+
- **Selected** (Selectable) — carried **only** by the checkbox; the pill never recolours. There is no
|
|
335
|
+
solid "selected" fill (that is Badge Solid).
|
|
336
|
+
- **There is no Active state.** The manifest's state axis is Default · Hover · Disabled only.
|
|
337
|
+
|
|
338
|
+
<Canvas of={ChipStories.Selection} />
|
|
339
|
+
|
|
340
|
+
> **⚠️ Missing token — the × has no hover paint.** The spec gives the Deleteable × "its own hover",
|
|
341
|
+
> but the manifest binds no token for it. The × therefore ships a hit area and a focus ring and no
|
|
342
|
+
> darkening of its own; what changes under the pointer is the pill's Hover tint. Needs a design
|
|
343
|
+
> decision rather than an invented value.
|
|
344
|
+
|
|
345
|
+
The States story's last grid runs the same four states over Basic, **Basic link**, Basic + ⓘ and
|
|
346
|
+
Deleteable; the link row's Disabled cell is the href-less, `aria-disabled` link.
|
|
347
|
+
|
|
348
|
+
Hover and Focus are **forced statically** in the States story: they are pseudo-classes, and
|
|
349
|
+
`parameters.pseudo` cannot reach them because Tailwind v4 wraps every `hover:` utility in
|
|
350
|
+
`@media (hover: hover)`.
|
|
351
|
+
|
|
352
|
+
## API
|
|
353
|
+
|
|
354
|
+
<Controls />
|
|
355
|
+
|
|
356
|
+
**`info` renders a plain `Tooltip`, so it needs a `TooltipProvider` ancestor**; `FodsProvider` mounts one at the app root.
|
|
357
|
+
Without it the component throws "`Tooltip` must be used within `TooltipProvider`"
|
|
358
|
+
and the tree does not render.
|
|
359
|
+
|
|
360
|
+
<table>
|
|
361
|
+
<thead>
|
|
362
|
+
<tr><th>Prop</th><th>Type</th><th>Default</th><th>Note</th></tr>
|
|
363
|
+
</thead>
|
|
364
|
+
<tbody>
|
|
365
|
+
<tr>
|
|
366
|
+
<td><code>type</code></td>
|
|
367
|
+
<td><code>'basic' | 'selectable' | 'deleteable'</code></td>
|
|
368
|
+
<td><code>'selectable'</code></td>
|
|
369
|
+
<td>Composition, not colour. Also decides which element the chip renders as (with <code>href</code> on Basic).</td>
|
|
370
|
+
</tr>
|
|
371
|
+
<tr>
|
|
372
|
+
<td><code>emotion</code></td>
|
|
373
|
+
<td><code>'info' | 'success' | 'warning' | 'danger' | 'violet' | 'neutral'</code></td>
|
|
374
|
+
<td><code>'info'</code></td>
|
|
375
|
+
<td>Status colour family; <code>neutral</code> maps onto the <code>--tertiary-*</code> ramp.</td>
|
|
376
|
+
</tr>
|
|
377
|
+
<tr>
|
|
378
|
+
<td><code>size</code></td>
|
|
379
|
+
<td><code>'md' | 'sm'</code></td>
|
|
380
|
+
<td><code>'md'</code></td>
|
|
381
|
+
<td>30px / 22px.</td>
|
|
382
|
+
</tr>
|
|
383
|
+
<tr>
|
|
384
|
+
<td><code>disabled</code></td>
|
|
385
|
+
<td><code>boolean</code></td>
|
|
386
|
+
<td><code>false</code></td>
|
|
387
|
+
<td>Muted <code>--disabled-control</code> fill + <code>--outline-default</code> hairline; propagates to the input, the ⓘ and the ×.</td>
|
|
388
|
+
</tr>
|
|
389
|
+
<tr>
|
|
390
|
+
<td><code>children</code></td>
|
|
391
|
+
<td><code>string</code></td>
|
|
392
|
+
<td>—</td>
|
|
393
|
+
<td><strong>Plain text on purpose</strong>, not <code>ReactNode</code>: 1 line, ≤ ~24 chars, truncated on overflow.</td>
|
|
394
|
+
</tr>
|
|
395
|
+
<tr>
|
|
396
|
+
<td><code>checked</code></td>
|
|
397
|
+
<td><code>boolean</code></td>
|
|
398
|
+
<td>—</td>
|
|
399
|
+
<td>Controlled selection (Selectable). The pill never recolours; only the checkbox does.</td>
|
|
400
|
+
</tr>
|
|
401
|
+
<tr>
|
|
402
|
+
<td><code>defaultChecked</code></td>
|
|
403
|
+
<td><code>boolean</code></td>
|
|
404
|
+
<td>—</td>
|
|
405
|
+
<td>Uncontrolled initial selection; the DOM owns the value from there on. A form submit also needs a <code>name</code> / <code>value</code> pair — those go through <code>inputProps</code>, not the rest props.</td>
|
|
406
|
+
</tr>
|
|
407
|
+
<tr>
|
|
408
|
+
<td><code>inputProps</code></td>
|
|
409
|
+
<td><code>Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'defaultChecked' | 'onChange' | 'disabled' | 'className'></code></td>
|
|
410
|
+
<td>—</td>
|
|
411
|
+
<td>Extra attributes for the native checkbox (Selectable only) — <code>name</code>, <code>value</code>, <code>id</code>, <code>aria-describedby</code>, <code>required</code>, <code>form</code>. The rest props go to the <strong>pill</strong>, which is right for <code>onClick</code> or a <code>data-*</code> hook and wrong for input metadata: a <code>name</code> on a <code><span></code> is invisible to <code>FormData</code> and an <code>aria-describedby</code> there names the wrapper, not the control. On another type it logs a dev warning.</td>
|
|
412
|
+
</tr>
|
|
413
|
+
<tr>
|
|
414
|
+
<td><code>onCheckedChange</code></td>
|
|
415
|
+
<td><code>(checked: boolean) => void</code></td>
|
|
416
|
+
<td>—</td>
|
|
417
|
+
<td>Receives the new boolean, not the DOM event.</td>
|
|
418
|
+
</tr>
|
|
419
|
+
<tr>
|
|
420
|
+
<td><code>info</code></td>
|
|
421
|
+
<td><code>{ content: React.ReactNode; label: string }</code></td>
|
|
422
|
+
<td>—</td>
|
|
423
|
+
<td><strong>A slot prop, not a boolean.</strong> Tooltip content plus the trigger's accessible name; its <em>presence</em> renders the ⓘ, collapsing the Figma <code>Info</code> boolean and the icon swap into one prop, so a caller can never ask for an icon it has no content for. The name rides along with the content because an icon-only button must have one and there is no default to fall back on — a pair cannot be half-supplied. Selectable and Basic (opened to Basic in 1.2.0) — on <code>deleteable</code>, and on a Basic chip with <code>href</code>, it logs a dev warning and renders nothing.</td>
|
|
424
|
+
</tr>
|
|
425
|
+
<tr>
|
|
426
|
+
<td><code>href</code></td>
|
|
427
|
+
<td><code>string</code></td>
|
|
428
|
+
<td>—</td>
|
|
429
|
+
<td>Navigation target, <strong>Basic only</strong> (manifest 1.7.3 <code>delivery.react</code>). With it the whole pill renders as an <code><a href></code> named by its label; without it Basic stays the <code><button></code>. A link chip takes no ⓘ. With <code>disabled</code> the href is removed and the link is <code>aria-disabled</code> and out of the tab order. On <code>selectable</code> / <code>deleteable</code> it logs a dev warning and renders no link. There is no <code>asChild</code> / router-link form and no <code>target</code> / <code>rel</code> prop.</td>
|
|
430
|
+
</tr>
|
|
431
|
+
<tr>
|
|
432
|
+
<td><code>leadingIcon</code></td>
|
|
433
|
+
<td><code>IconName</code></td>
|
|
434
|
+
<td>—</td>
|
|
435
|
+
<td>Optional leading glyph before the label (manifest 1.7.0 <code>slots.leading-icon</code>; the Figma <code>Show leading icon</code> boolean and the <code>Leading icon</code> swap collapse into this one prop). <strong>Deleteable and Basic only</strong> — on <code>selectable</code> it logs a dev warning and renders nothing. On by default in the spec, so pass it unless space is tight; there is no code default glyph (Figma's <code>info</code> is a swap artefact). 16 / 14px, label ink, <code>aria-hidden</code>.</td>
|
|
436
|
+
</tr>
|
|
437
|
+
<tr>
|
|
438
|
+
<td><code>onRemove</code></td>
|
|
439
|
+
<td><code>() => void</code></td>
|
|
440
|
+
<td>—</td>
|
|
441
|
+
<td>Remove handler for the trailing ×. Deleteable only — on another type it logs a dev warning.</td>
|
|
442
|
+
</tr>
|
|
443
|
+
<tr>
|
|
444
|
+
<td><code>removeLabel</code></td>
|
|
445
|
+
<td><code>string</code> — <strong>required for <code>type="deleteable"</code></strong></td>
|
|
446
|
+
<td>—</td>
|
|
447
|
+
<td>Accessible name of the icon-only × button, supplied by the caller's translation layer. Name the <em>tag</em>, not the verb alone ("Odebrat Praha"), so a run of chips does not announce the same name over and over. The requirement is carried by a union keyed on <code>type</code>, so a Deleteable chip without it does not compile.</td>
|
|
448
|
+
</tr>
|
|
449
|
+
</tbody>
|
|
450
|
+
</table>
|
|
451
|
+
|
|
452
|
+
Any other `HTMLAttributes` are spread onto the pill; `className` is merged with the recipe's classes.
|
|
453
|
+
Attributes meant for the native checkbox go through `inputProps` instead.
|
|
454
|
+
|
|
455
|
+
> **Neither accessible name has a default.** The chip has no locale of its own — `removeLabel` and
|
|
456
|
+
> `info.label` are supplied by the consumer's translation layer. The upstream spec
|
|
457
|
+
> writes the × as `<button aria-label="Odebrat …">`, but that is prose for a Czech product: a
|
|
458
|
+
> built-in fallback would announce Czech to every screen-reader user on the PL / SK / EN markets that
|
|
459
|
+
> forgot to pass one. TypeScript enforces both — `removeLabel` through the `type`-keyed union, the ⓘ
|
|
460
|
+
> name by travelling inside the `info` pair.
|
|
461
|
+
|
|
462
|
+
<Canvas of={ChipStories.WithInfo} />
|
|
463
|
+
|
|
464
|
+
## Do / Don't
|
|
465
|
+
|
|
466
|
+
- ✅ Use `selectable` for a toggle / filter, `deleteable` for a removable tag, `basic` for a plain
|
|
467
|
+
clickable filter tag, and `basic` with `href` for a chip that leads to a listing.
|
|
468
|
+
- ✅ Show selection with the checkbox and keep the pill soft — the pill **never** recolours on select.
|
|
469
|
+
- ✅ Keep the label to 1–2 words (≤ ~24 chars), sentence case, no terminal period — it truncates if
|
|
470
|
+
longer.
|
|
471
|
+
- ✅ Match the chip emotion to the status it filters or tags, and reuse the app's existing status
|
|
472
|
+
vocabulary.
|
|
473
|
+
- ✅ Pass `removeLabel` (and `info.label`) from your own translation layer, naming the tag — and let
|
|
474
|
+
the × keep its ≥24×24 hit area.
|
|
475
|
+
- ✅ Route `name` / `value` / `aria-describedby` for the checkbox through `inputProps`; the rest props
|
|
476
|
+
land on the pill.
|
|
477
|
+
- ✅ Keep the leading glyph on for Deleteable and Basic, with the status glyph of the chip's family
|
|
478
|
+
(`BADGE_STATUS_ICONS`); drop it only where space is tight.
|
|
479
|
+
- ❌ Don't use a Chip to *report* read-only status (that is **Badge**) or as a primary action (that is
|
|
480
|
+
**Button**).
|
|
481
|
+
- ❌ Don't reach for Chip as a filter-bar **facet trigger** whose selection recolours the pill — that
|
|
482
|
+
is **Filter Chip**, the 32/40 control tier.
|
|
483
|
+
- ❌ Don't navigate from a Basic button's `onClick` — a chip that leads somewhere takes `href` and is
|
|
484
|
+
a real link. Don't give a link chip an ⓘ (it is dropped), and don't put `href` on Selectable or
|
|
485
|
+
Deleteable (it is dropped).
|
|
486
|
+
- ❌ Don't mix chip sizes in one bar, and don't stack many Deleteable tags without wrap.
|
|
487
|
+
- ❌ Don't lean on the tint alone to carry meaning — it lives in the label + control (WCAG 1.4.1).
|
|
488
|
+
- ❌ Don't override the colours via `className`; the emotion × state pairs are token-bound.
|
|
489
|
+
- ❌ Don't give a Selectable chip a `leadingIcon` — its checkbox is the leading element — and don't
|
|
490
|
+
let the glyph carry meaning the label does not already state.
|
|
491
|
+
- ❌ Don't hardcode the control names in the chip (or wish for a default back) — the atom ships on ten
|
|
492
|
+
markets and a Czech string here reaches every one of them.
|
|
493
|
+
|
|
494
|
+
## Accessibility
|
|
495
|
+
|
|
496
|
+
- **Keyboard** — Basic renders the pill as a native `<button type="button">`, so it is one tab stop
|
|
497
|
+
and activates on Enter / Space; with the optional ⓘ it becomes two — an inner button around the
|
|
498
|
+
label and the trigger beside it. Basic with `href` is a native `<a href>`: one tab stop, Enter
|
|
499
|
+
follows it, and the focus ring sits on the whole pill. A disabled link chip leaves the tab order
|
|
500
|
+
and swallows clicks and Enter. Selectable is a real `<input type="checkbox">` inside a `<label>`:
|
|
501
|
+
Tab reaches the input, Space toggles it, and the whole toggle (box + label) is the pointer target.
|
|
502
|
+
Deleteable puts the tab stop on the × `<button>` and takes no ⓘ at all. Where the ⓘ does
|
|
503
|
+
appear (Basic, Selectable) it is a further `<button>` and its own tab stop. Each chip in a bar is its own tab stop.
|
|
504
|
+
- **ARIA** — every icon-only control has a name and it always comes from the caller: the × from the
|
|
505
|
+
required `removeLabel`, the ⓘ from `info.label`. There is no built-in fallback (see the note under
|
|
506
|
+
[API](#api)), and both are enforced by the prop types, so an unnamed control cannot ship. The
|
|
507
|
+
visible checkbox square is `aria-hidden` (it is decoration over the real input), and glyphs go
|
|
508
|
+
through `Icon`, which always renders `aria-hidden="true"`. `disabled` sets the native `disabled`
|
|
509
|
+
attribute on the button / input. A link chip's name is its label; disabled, it has no `href`, so
|
|
510
|
+
the code re-states `role="link"` (an href-less `<a>` is a generic element on which `aria-disabled`
|
|
511
|
+
announces nothing) and sets `aria-disabled="true"`. Selection is exposed by the native
|
|
512
|
+
checkbox, never by colour alone; `aria-describedby` for the checkbox goes through `inputProps`, so
|
|
513
|
+
it names the control rather than the wrapper.
|
|
514
|
+
- **Screen reader** — a Selectable chip reads as a checkbox with the label as its name and the native
|
|
515
|
+
checked state; a Deleteable chip reads as its label text plus a separate button carrying
|
|
516
|
+
`removeLabel`; a link chip is exposed as a link named by its label (role `link`, plus
|
|
517
|
+
`aria-disabled="true"` when disabled). Removal itself is announced by the surrounding list update, not by the chip — there
|
|
518
|
+
is no `aria-live` on the chip.
|
|
519
|
+
- **Contrast & motion** — the pill pairs `-tint-foreground` ink with the `-subtle` / `-soft` fills,
|
|
520
|
+
and disabled uses the `--disabled-control` / `--disabled-foreground` pair plus an `--outline-default` hairline. The check glyph is
|
|
521
|
+
`--text-inverted` (white) in every family, Warning included, at a measured 2.37:1 — an accepted,
|
|
522
|
+
owner-signed exception rather than an oversight, because the tick never carries the checked state
|
|
523
|
+
on its own; see the note in [Variants](#variants). Focus is an additive `--outline-focus` ring at `--border-width-200` with a
|
|
524
|
+
2px offset, never a border swap. The only motion is a colour transition that names its properties (never `transition-colors`, which would also ease the focus ring's `outline-color`) — the pill's hover fill over
|
|
525
|
+
`--duration-hover` and the checkbox fill over `--duration-toggle`, both on `--easing-standard` — no
|
|
526
|
+
transforms, no animation. Removing a Deleteable chip is not animated by the chip; the surrounding
|
|
527
|
+
row owns the exit (manifest `motion.note`).
|
|
528
|
+
- **Leading icon** — decorative (`aria-hidden`, through `Icon`), because the label already names the
|
|
529
|
+
tag; it is never the sole carrier of meaning.
|
|
530
|
+
|
|
531
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
532
|
+
|
|
533
|
+
## Copy
|
|
534
|
+
|
|
535
|
+
Voice: impersonal and in-app.
|
|
536
|
+
|
|
537
|
+
- **Label** (`children`, a plain string) — a status / category noun (Selectable) or the tag's value
|
|
538
|
+
(Deleteable), sentence case, no terminal period. 1–2 words, at most 24 characters, single line;
|
|
539
|
+
an over-long label truncates with an ellipsis, so shorten it instead. Match the existing status
|
|
540
|
+
vocabulary; don't invent synonyms per screen.
|
|
541
|
+
- **× remove label** (`removeLabel`, Deleteable) — not visible text: the × button's accessible name,
|
|
542
|
+
phrased as an action, `Odebrat {label}` (e.g. `Odebrat Po splatnosti`).
|
|
543
|
+
|
|
544
|
+
<table>
|
|
545
|
+
<thead>
|
|
546
|
+
<tr><th>Run</th><th>Do</th><th>Don't</th></tr>
|
|
547
|
+
</thead>
|
|
548
|
+
<tbody>
|
|
549
|
+
<tr>
|
|
550
|
+
<td>Label</td>
|
|
551
|
+
<td><code>Zaplaceno</code> · <code>Nezaplaceno</code> · <code>Po splatnosti</code> · <code>Budoucí</code> · <code>Číslo faktury</code></td>
|
|
552
|
+
<td><code>Faktury, které nebyly zaplaceny</code> (too long: that is helper text, not a chip)</td>
|
|
553
|
+
</tr>
|
|
554
|
+
<tr>
|
|
555
|
+
<td>× remove label</td>
|
|
556
|
+
<td><code>Odebrat Nezaplaceno</code></td>
|
|
557
|
+
<td></td>
|
|
558
|
+
</tr>
|
|
559
|
+
</tbody>
|
|
560
|
+
</table>
|
|
561
|
+
|
|
562
|
+
## Usage
|
|
563
|
+
|
|
564
|
+
<Canvas of={ChipStories.FilterBar} />
|
|
565
|
+
|
|
566
|
+
```tsx
|
|
567
|
+
import { BADGE_STATUS_ICONS, Chip } from '@invoiceonline/ui-react';
|
|
568
|
+
|
|
569
|
+
// Good — a controlled status filter bar; selection shows on the checkbox
|
|
570
|
+
<Chip
|
|
571
|
+
type="selectable"
|
|
572
|
+
emotion="success"
|
|
573
|
+
checked={selected.includes('Zaplaceno')}
|
|
574
|
+
onCheckedChange={checked => toggle('Zaplaceno', checked)}
|
|
575
|
+
>
|
|
576
|
+
Zaplaceno
|
|
577
|
+
</Chip>
|
|
578
|
+
|
|
579
|
+
// Good — the optional ⓘ: passing content IS the toggle, and the name travels with it
|
|
580
|
+
<Chip
|
|
581
|
+
type="selectable"
|
|
582
|
+
emotion="danger"
|
|
583
|
+
info={{
|
|
584
|
+
content: t('invoices.status.overdue.hint'),
|
|
585
|
+
label: t('invoices.status.overdue.infoLabel'),
|
|
586
|
+
}}
|
|
587
|
+
>
|
|
588
|
+
Po splatnosti
|
|
589
|
+
</Chip>
|
|
590
|
+
|
|
591
|
+
// Good — an uncontrolled chip inside a real form; name/value reach the checkbox
|
|
592
|
+
<Chip type="selectable" emotion="success" defaultChecked inputProps={{ name: 'status[]', value: 'paid' }}>
|
|
593
|
+
Zaplaceno
|
|
594
|
+
</Chip>
|
|
595
|
+
|
|
596
|
+
// Good — a dense run of removable tokens; the × name comes from the translation layer
|
|
597
|
+
<Chip
|
|
598
|
+
type="deleteable"
|
|
599
|
+
emotion="neutral"
|
|
600
|
+
size="sm"
|
|
601
|
+
removeLabel={t('filters.remove', { label: 'Odběratel' })}
|
|
602
|
+
onRemove={() => removeToken('Odběratel')}
|
|
603
|
+
>
|
|
604
|
+
Odběratel
|
|
605
|
+
</Chip>
|
|
606
|
+
|
|
607
|
+
// Good — a chip that leads to a listing is a link: the whole pill is the <a href>
|
|
608
|
+
<Chip type="basic" emotion="info" href="#" leadingIcon={BADGE_STATUS_ICONS.info}>
|
|
609
|
+
Fakturace
|
|
610
|
+
</Chip>
|
|
611
|
+
|
|
612
|
+
// Good — a plain clickable filter tag above a table, leading glyph on
|
|
613
|
+
<Chip type="basic" emotion="info" leadingIcon={BADGE_STATUS_ICONS.info} onClick={openDrafts}>
|
|
614
|
+
Návrh
|
|
615
|
+
</Chip>
|
|
616
|
+
```
|
|
617
|
+
|
|
618
|
+
```tsx
|
|
619
|
+
// Don't — a read-only status is a Badge, not a Chip
|
|
620
|
+
<Chip type="basic" emotion="success">Zaplaceno</Chip> // ...when nothing happens on click
|
|
621
|
+
|
|
622
|
+
// Don't — `children` is a string; markup is not a chip label
|
|
623
|
+
<Chip type="selectable"><strong>Po</strong> splatnosti</Chip>
|
|
624
|
+
|
|
625
|
+
// Don't — a sentence in a chip; it truncates
|
|
626
|
+
<Chip type="basic" emotion="danger">Faktura je 14 dní po splatnosti, pošlete upomínku.</Chip>
|
|
627
|
+
|
|
628
|
+
// Don't — on Deleteable the trailing slot is already the ×; this logs a dev warning and renders nothing
|
|
629
|
+
<Chip type="deleteable" removeLabel="Odebrat Číslo faktury" info={{ content: 'Nápověda', label: 'Nápověda' }}>
|
|
630
|
+
Číslo faktury
|
|
631
|
+
</Chip>
|
|
632
|
+
|
|
633
|
+
// Don't — navigation from a button's onClick; a chip that leads somewhere takes href
|
|
634
|
+
<Chip type="basic" emotion="info" onClick={() => navigate('#')}>Fakturace</Chip>
|
|
635
|
+
|
|
636
|
+
// Don't — an ⓘ on a link chip; a tooltip trigger cannot nest in an <a> (dev warning, nothing renders)
|
|
637
|
+
<Chip type="basic" href="#" info={{ content: 'Nápověda', label: 'Nápověda' }}>Fakturace</Chip>
|
|
638
|
+
|
|
639
|
+
// Don't — a leading glyph on Selectable; the checkbox is the leading element (dev warning, nothing renders)
|
|
640
|
+
<Chip type="selectable" leadingIcon="check">Zaplaceno</Chip>
|
|
641
|
+
|
|
642
|
+
// Don't — form metadata on the pill; a <span name> is invisible to FormData
|
|
643
|
+
<Chip type="selectable" name="status[]" value="paid">Zaplaceno</Chip> // ...use inputProps
|
|
644
|
+
|
|
645
|
+
// Don't — hardcoded colours instead of the emotion tokens
|
|
646
|
+
<Chip className="bg-[#e6f8ee] text-[#0a7a3d]">Zaplaceno</Chip>
|
|
647
|
+
```
|
|
648
|
+
|
|
649
|
+
## Related
|
|
650
|
+
|
|
651
|
+
- [`Badge`](?path=/docs/design-system-atoms-badge--docs) — the **read-only** sibling on the same Pill
|
|
652
|
+
recipe. Anything that only reports state belongs there.
|
|
653
|
+
- [`Checkbox`](?path=/docs/design-system-atoms-checkbox--docs) — the standalone control whose
|
|
654
|
+
unchecked chrome the nested box keeps parity with (the chip renders its own markup so it can apply
|
|
655
|
+
the host-family override).
|
|
656
|
+
- [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — whose disabled-link recipe (no
|
|
657
|
+
`href`, `role="link"`, `aria-disabled`, out of the tab order) the link chip follows.
|
|
658
|
+
- [`Tooltip`](?path=/docs/design-system-atoms-tooltip--docs) — attached by reference to the ⓘ trigger.
|
|
659
|
+
Stories mount a `TooltipProvider` in the meta decorator, below the global `FodsProvider` of the
|
|
660
|
+
package's Storybook; a consumer gets one from `FodsProvider` (see [API](#api)).
|
|
661
|
+
- Spec: `spec/03-atoms/chip.md`,
|
|
662
|
+
the shared chrome recipe `spec/06-patterns/pill.md`,
|
|
663
|
+
the focus pattern `spec/06-patterns/focus-ring.md`,
|
|
664
|
+
and the control-tier sibling `spec/03-atoms/filter-chip.md`.
|
|
665
|
+
|
|
666
|
+
## Migration notes
|
|
667
|
+
|
|
668
|
+
**Manifest 1.4.0 → 1.5.0 (ui-system 0.13.0).** Disabled gains a `--outline-default` hairline at
|
|
669
|
+
`--border-width-100` (inset outline) in every family, and its fill rebinds `--disabled` →
|
|
670
|
+
`--disabled-control`.
|
|
671
|
+
|
|
672
|
+
**Manifest 1.6.0 → 1.7.2 (2026-11-03).** 1.7.0 adds the optional `leading-icon` slot on Deleteable
|
|
673
|
+
and Basic (on by default; prop `leadingIcon`), and 1.7.2 completes the motion block: the hover
|
|
674
|
+
fill eases over `--duration-hover` / `--easing-standard`, the Selectable checkbox inherits the
|
|
675
|
+
Checkbox toggle motion, and a Deleteable chip's removal belongs to the consumer. No existing consumer
|
|
676
|
+
passed a leading glyph, so nothing renders differently until one does.
|
|
677
|
+
|
|
678
|
+
**Manifest 1.7.2 → 1.8.1 (2026-11-12).** 1.7.3 names Basic as a link when it leads to a listing: new
|
|
679
|
+
optional prop `href` (Basic only) renders the pill as an `<a href>` with no ⓘ; without `href` Basic
|
|
680
|
+
is the `<button>` it was. The pill's ink and `no-underline` gain the `!` flag so global link styles
|
|
681
|
+
cannot repaint it. 1.8.0 moves the spec status draft → stable and changes nothing to build. 1.8.1
|
|
682
|
+
states that the Selectable check glyph is the Checkbox's own `sm` size, `--size-icon-2xsmall`, at
|
|
683
|
+
both chip sizes; the code already rendered it at that size, so the check does not change.
|