@invoiceonline/ui-react 0.0.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +100 -0
- package/CHANGELOG.md +149 -0
- package/LICENSE +9 -0
- package/README.md +77 -1
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-picker/DatePicker.d.ts +53 -0
- package/dist/components/date-picker/DatePicker.js +329 -0
- package/dist/components/date-picker/index.d.ts +2 -0
- package/dist/components/date-picker/index.js +1 -0
- package/dist/components/divider/Divider.d.ts +81 -0
- package/dist/components/divider/Divider.js +93 -0
- package/dist/components/divider/index.d.ts +2 -0
- package/dist/components/divider/index.js +1 -0
- package/dist/components/drawer/Drawer.d.ts +128 -0
- package/dist/components/drawer/Drawer.js +367 -0
- package/dist/components/drawer/index.d.ts +2 -0
- package/dist/components/drawer/index.js +1 -0
- package/dist/components/dropdown-button/DropdownButton.d.ts +72 -0
- package/dist/components/dropdown-button/DropdownButton.js +122 -0
- package/dist/components/dropdown-button/index.d.ts +2 -0
- package/dist/components/dropdown-button/index.js +1 -0
- package/dist/components/faq/FAQ.d.ts +135 -0
- package/dist/components/faq/FAQ.js +258 -0
- package/dist/components/faq/index.d.ts +2 -0
- package/dist/components/faq/index.js +1 -0
- package/dist/components/field/Field.d.ts +119 -0
- package/dist/components/field/Field.js +332 -0
- package/dist/components/field/index.d.ts +2 -0
- package/dist/components/field/index.js +1 -0
- package/dist/components/field-pair/FieldPair.d.ts +210 -0
- package/dist/components/field-pair/FieldPair.js +335 -0
- package/dist/components/field-pair/index.d.ts +2 -0
- package/dist/components/field-pair/index.js +1 -0
- package/dist/components/file-upload/FileUpload.d.ts +137 -0
- package/dist/components/file-upload/FileUpload.js +434 -0
- package/dist/components/file-upload/index.d.ts +2 -0
- package/dist/components/file-upload/index.js +1 -0
- package/dist/components/filter-chip/FilterChip.d.ts +373 -0
- package/dist/components/filter-chip/FilterChip.js +517 -0
- package/dist/components/filter-chip/index.d.ts +2 -0
- package/dist/components/filter-chip/index.js +1 -0
- package/dist/components/filter-facet/FilterFacet.d.ts +116 -0
- package/dist/components/filter-facet/FilterFacet.js +632 -0
- package/dist/components/filter-facet/index.d.ts +2 -0
- package/dist/components/filter-facet/index.js +1 -0
- package/dist/components/firm-avatar/FirmAvatar.d.ts +75 -0
- package/dist/components/firm-avatar/FirmAvatar.js +119 -0
- package/dist/components/firm-avatar/index.d.ts +2 -0
- package/dist/components/firm-avatar/index.js +1 -0
- package/dist/components/form-actions/FormActions.d.ts +123 -0
- package/dist/components/form-actions/FormActions.js +195 -0
- package/dist/components/form-actions/index.d.ts +2 -0
- package/dist/components/form-actions/index.js +1 -0
- package/dist/components/form-block/FormBlock.d.ts +252 -0
- package/dist/components/form-block/FormBlock.js +420 -0
- package/dist/components/form-block/index.d.ts +3 -0
- package/dist/components/form-block/index.js +3 -0
- package/dist/components/form-section/FormSection.d.ts +130 -0
- package/dist/components/form-section/FormSection.js +206 -0
- package/dist/components/form-section/index.d.ts +2 -0
- package/dist/components/form-section/index.js +1 -0
- package/dist/components/heading/Heading.d.ts +69 -0
- package/dist/components/heading/Heading.js +79 -0
- package/dist/components/heading/index.d.ts +2 -0
- package/dist/components/heading/index.js +1 -0
- package/dist/components/heading-group/HeadingGroup.d.ts +258 -0
- package/dist/components/heading-group/HeadingGroup.js +255 -0
- package/dist/components/heading-group/index.d.ts +2 -0
- package/dist/components/heading-group/index.js +1 -0
- package/dist/components/hero/Hero.d.ts +268 -0
- package/dist/components/hero/Hero.js +316 -0
- package/dist/components/hero/index.d.ts +2 -0
- package/dist/components/hero/index.js +1 -0
- package/dist/components/icon/Icon.d.ts +27 -0
- package/dist/components/icon/Icon.js +30 -0
- package/dist/components/icon/index.d.ts +3 -0
- package/dist/components/icon/index.js +3 -0
- package/dist/components/icon-button/IconButton.d.ts +75 -0
- package/dist/components/icon-button/IconButton.js +151 -0
- package/dist/components/icon-button/index.d.ts +2 -0
- package/dist/components/icon-button/index.js +1 -0
- package/dist/components/item-row/ItemRow.d.ts +253 -0
- package/dist/components/item-row/ItemRow.js +496 -0
- package/dist/components/item-row/index.d.ts +2 -0
- package/dist/components/item-row/index.js +1 -0
- package/dist/components/list-row/ListRow.d.ts +165 -0
- package/dist/components/list-row/ListRow.js +233 -0
- package/dist/components/list-row/index.d.ts +2 -0
- package/dist/components/list-row/index.js +1 -0
- package/dist/components/menu/Menu.d.ts +64 -0
- package/dist/components/menu/Menu.js +186 -0
- package/dist/components/menu/index.d.ts +2 -0
- package/dist/components/menu/index.js +1 -0
- package/dist/components/modal/Modal.d.ts +272 -0
- package/dist/components/modal/Modal.js +788 -0
- package/dist/components/modal/index.d.ts +2 -0
- package/dist/components/modal/index.js +1 -0
- package/dist/components/nav-link/NavLink.d.ts +123 -0
- package/dist/components/nav-link/NavLink.js +157 -0
- package/dist/components/nav-link/index.d.ts +2 -0
- package/dist/components/nav-link/index.js +1 -0
- package/dist/components/number-field/NumberField.d.ts +62 -0
- package/dist/components/number-field/NumberField.js +210 -0
- package/dist/components/number-field/index.d.ts +2 -0
- package/dist/components/number-field/index.js +1 -0
- package/dist/components/pagination/Pagination.d.ts +133 -0
- package/dist/components/pagination/Pagination.js +217 -0
- package/dist/components/pagination/index.d.ts +3 -0
- package/dist/components/pagination/index.js +3 -0
- package/dist/components/popover-surface/index.d.ts +2 -0
- package/dist/components/popover-surface/index.js +1 -0
- package/dist/components/progress-bar/ProgressBar.d.ts +260 -0
- package/dist/components/progress-bar/ProgressBar.js +470 -0
- package/dist/components/progress-bar/index.d.ts +2 -0
- package/dist/components/progress-bar/index.js +1 -0
- package/dist/components/promo-sticker/PromoSticker.d.ts +204 -0
- package/dist/components/promo-sticker/PromoSticker.js +177 -0
- package/dist/components/promo-sticker/index.d.ts +2 -0
- package/dist/components/promo-sticker/index.js +1 -0
- package/dist/components/promo-surface/PromoSurface.d.ts +94 -0
- package/dist/components/promo-surface/PromoSurface.js +119 -0
- package/dist/components/promo-surface/index.d.ts +2 -0
- package/dist/components/promo-surface/index.js +1 -0
- package/dist/components/radio/Radio.d.ts +92 -0
- package/dist/components/radio/Radio.js +171 -0
- package/dist/components/radio/index.d.ts +2 -0
- package/dist/components/radio/index.js +1 -0
- package/dist/components/radio-group/RadioGroup.d.ts +61 -0
- package/dist/components/radio-group/RadioGroup.js +51 -0
- package/dist/components/radio-group/index.d.ts +2 -0
- package/dist/components/radio-group/index.js +1 -0
- package/dist/components/select/Select.d.ts +65 -0
- package/dist/components/select/Select.js +176 -0
- package/dist/components/select/index.d.ts +2 -0
- package/dist/components/select/index.js +1 -0
- package/dist/components/select-field/SelectField.d.ts +16 -0
- package/dist/components/select-field/SelectField.js +55 -0
- package/dist/components/select-field/index.d.ts +2 -0
- package/dist/components/select-field/index.js +1 -0
- package/dist/components/skeleton/Skeleton.d.ts +64 -0
- package/dist/components/skeleton/Skeleton.js +65 -0
- package/dist/components/skeleton/index.d.ts +2 -0
- package/dist/components/skeleton/index.js +1 -0
- package/dist/components/split-button/SplitButton.d.ts +80 -0
- package/dist/components/split-button/SplitButton.js +182 -0
- package/dist/components/split-button/index.d.ts +2 -0
- package/dist/components/split-button/index.js +1 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.d.ts +118 -0
- package/dist/components/status-summary-bar/StatusSummaryBar.js +278 -0
- package/dist/components/status-summary-bar/index.d.ts +2 -0
- package/dist/components/status-summary-bar/index.js +1 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.d.ts +157 -0
- package/dist/components/subject-lookup-field/SubjectLookupField.js +663 -0
- package/dist/components/subject-lookup-field/index.d.ts +2 -0
- package/dist/components/subject-lookup-field/index.js +1 -0
- package/dist/components/switch/Switch.d.ts +152 -0
- package/dist/components/switch/Switch.js +307 -0
- package/dist/components/switch/index.d.ts +2 -0
- package/dist/components/switch/index.js +1 -0
- package/dist/components/table/Table.d.ts +5 -0
- package/dist/components/table/Table.js +601 -0
- package/dist/components/table/index.d.ts +6 -0
- package/dist/components/table/index.js +6 -0
- package/dist/components/text-field/TextField.d.ts +160 -0
- package/dist/components/text-field/TextField.js +244 -0
- package/dist/components/text-field/index.d.ts +2 -0
- package/dist/components/text-field/index.js +1 -0
- package/dist/components/text-link/TextLink.d.ts +260 -0
- package/dist/components/text-link/TextLink.js +303 -0
- package/dist/components/text-link/index.d.ts +2 -0
- package/dist/components/text-link/index.js +1 -0
- package/dist/components/textarea/Textarea.d.ts +93 -0
- package/dist/components/textarea/Textarea.js +256 -0
- package/dist/components/textarea/index.d.ts +2 -0
- package/dist/components/textarea/index.js +1 -0
- package/dist/components/tooltip/Tooltip.d.ts +129 -0
- package/dist/components/tooltip/Tooltip.js +457 -0
- package/dist/components/tooltip/index.d.ts +2 -0
- package/dist/components/tooltip/index.js +1 -0
- package/dist/components/unit-field/UnitField.d.ts +46 -0
- package/dist/components/unit-field/UnitField.js +133 -0
- package/dist/components/unit-field/index.d.ts +2 -0
- package/dist/components/unit-field/index.js +1 -0
- package/dist/icons/icon-registry.generated.js +500 -0
- package/dist/icons/icon-types.generated.d.ts +2 -0
- package/dist/icons/icon-types.generated.js +126 -0
- package/dist/index.d.ts +130 -0
- package/dist/index.js +74 -0
- package/dist/internal/BottomSheet.js +496 -0
- package/dist/internal/FodsProvider.d.ts +25 -0
- package/dist/internal/FodsProvider.js +32 -0
- package/dist/internal/MotionCaret.js +35 -0
- package/dist/internal/NumberFormatInput.d.ts +21 -0
- package/dist/internal/NumberFormatInput.js +126 -0
- package/dist/internal/SummaryDonut.d.ts +3 -0
- package/dist/internal/SummaryDonut.js +300 -0
- package/dist/internal/buttonSegment.d.ts +44 -0
- package/dist/internal/buttonSegment.js +126 -0
- package/dist/internal/collapseRoom.js +128 -0
- package/dist/internal/comboboxKeys.js +44 -0
- package/dist/internal/contentPresence.js +46 -0
- package/dist/internal/dayCell.js +95 -0
- package/dist/internal/dialogPortal.d.ts +2 -0
- package/dist/internal/dialogPortal.js +21 -0
- package/dist/internal/donutSweeps.js +65 -0
- package/dist/internal/enterOnViewGeometry.js +46 -0
- package/dist/internal/faqItem.js +80 -0
- package/dist/internal/floatingLabelMotion.js +68 -0
- package/dist/internal/formBlockContext.d.ts +22 -0
- package/dist/internal/formBlockContext.js +20 -0
- package/dist/internal/heightRoom.js +87 -0
- package/dist/internal/numberSeparators.js +62 -0
- package/dist/internal/overlayMotion.js +48 -0
- package/dist/internal/paginationItem.d.ts +8 -0
- package/dist/internal/paginationItem.js +22 -0
- package/dist/internal/popoverSurface.d.ts +8 -0
- package/dist/internal/popoverSurface.js +23 -0
- package/dist/internal/portalContainer.d.ts +1 -0
- package/dist/internal/portalContainer.js +6 -0
- package/dist/internal/progressBarItem.d.ts +207 -0
- package/dist/internal/progressBarItem.js +264 -0
- package/dist/internal/selectionControlText.js +12 -0
- package/dist/internal/statusSummaryParts.js +371 -0
- package/dist/internal/summaryMotion.js +75 -0
- package/dist/internal/table/ChildConnector.js +62 -0
- package/dist/internal/table/ChildRowPrefix.d.ts +9 -0
- package/dist/internal/table/ChildRowPrefix.js +27 -0
- package/dist/internal/table/ColumnSettings.js +135 -0
- package/dist/internal/table/ScrollRegion.js +114 -0
- package/dist/internal/table/TableEmpty.js +93 -0
- package/dist/internal/table/TableLayout.d.ts +17 -0
- package/dist/internal/table/TableLayout.js +29 -0
- package/dist/internal/table/TableLoadStatus.js +56 -0
- package/dist/internal/table/TableMobile.js +488 -0
- package/dist/internal/table/TruncatedCell.js +33 -0
- package/dist/internal/table/emptyValue.js +10 -0
- package/dist/internal/table/features.d.ts +41 -0
- package/dist/internal/table/features.js +31 -0
- package/dist/internal/table/recipes.js +227 -0
- package/dist/internal/table/rowClick.js +9 -0
- package/dist/internal/table/types.d.ts +325 -0
- package/dist/internal/table/types.js +13 -0
- package/dist/internal/tailwind-variants.d.ts +3 -0
- package/dist/internal/tailwind-variants.js +37 -0
- package/dist/internal/tooltipContext.js +5 -0
- package/dist/internal/tw-merge-config.generated.js +314 -0
- package/dist/internal/useAnchoredPanel.d.ts +87 -0
- package/dist/internal/useAnchoredPanel.js +108 -0
- package/dist/internal/useCountUp.js +53 -0
- package/dist/internal/useDateFieldTrigger.d.ts +60 -0
- package/dist/internal/useDateFieldTrigger.js +235 -0
- package/dist/internal/useEChart.js +59 -0
- package/dist/internal/useEnterOnView.js +42 -0
- package/dist/internal/useFloatingBar.js +100 -0
- package/dist/internal/useFormReset.js +44 -0
- package/dist/internal/useIsMobile.js +44 -0
- package/dist/internal/useOneRowOverflow.js +88 -0
- package/dist/internal/usePrefersReducedMotion.js +25 -0
- package/dist/internal/useReturnFocus.js +26 -0
- package/dist/internal/utils.d.ts +7 -0
- package/dist/internal/utils.js +58 -0
- package/dist/node_modules/@tanstack/store/dist/store.d.ts +29 -0
- package/dist/node_modules/@tanstack/store/dist/types.d.ts +38 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/cells/coreCellsFeature.types.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/columns/coreColumnsFeature.types.d.ts +90 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/coreFeatures.d.ts +17 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/headers/coreHeadersFeature.types.d.ts +114 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/reactivity/coreReactivityFeature.types.d.ts +51 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/row-models/coreRowModelsFeature.types.d.ts +29 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/rows/coreRowsFeature.types.d.ts +129 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/core/table/coreTablesFeature.types.d.ts +203 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-selection/cellSelectionFeature.types.d.ts +294 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/cell-spanning/cellSpanningFeature.types.d.ts +148 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-faceting/columnFacetingFeature.types.d.ts +63 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/columnFilteringFeature.types.d.ts +209 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-filtering/filterFns.d.ts +35 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-grouping/columnGroupingFeature.types.d.ts +128 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-ordering/columnOrderingFeature.types.d.ts +82 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-pinning/columnPinningFeature.types.d.ts +195 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-resizing/columnResizingFeature.types.d.ts +73 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-sizing/columnSizingFeature.types.d.ts +134 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/column-visibility/columnVisibilityFeature.types.d.ts +92 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/global-filtering/globalFilteringFeature.types.d.ts +67 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/aggregationFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.types.d.ts +183 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-aggregation/rowAggregationFeature.utils.d.ts +18 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-expanding/rowExpandingFeature.types.d.ts +125 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pagination/rowPaginationFeature.types.d.ts +135 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-pinning/rowPinningFeature.types.d.ts +76 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-selection/rowSelectionFeature.types.d.ts +187 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/rowSortingFeature.types.d.ts +236 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/row-sorting/sortFns.d.ts +23 -0
- package/dist/node_modules/@tanstack/table-core/dist/features/stockFeatures.d.ts +37 -0
- package/dist/node_modules/@tanstack/table-core/dist/helpers/columnHelper.d.ts +47 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Cell.d.ts +16 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Column.d.ts +30 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/ColumnDef.d.ts +123 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Header.d.ts +12 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/HeaderGroup.d.ts +6 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Row.d.ts +24 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModel.d.ts +19 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/RowModelFns.d.ts +11 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/Table.d.ts +53 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableFeatures.d.ts +416 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableOptions.d.ts +78 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/TableState.d.ts +46 -0
- package/dist/node_modules/@tanstack/table-core/dist/types/type-utils.d.ts +25 -0
- package/dist/shared.css +179 -0
- package/dist/styles.css +5467 -0
- package/dist/theme.css +314 -0
- package/dist/theme.map.json +278 -0
- package/dist/tokens/index.d.ts +2 -0
- package/dist/tokens/index.js +1 -0
- package/dist/tokens/tokens.generated.d.ts +2040 -0
- package/dist/tokens/tokens.generated.js +2053 -0
- package/dist/tokens.css +484 -0
- package/dist/tokens.flat.json +429 -0
- package/docs/Consuming.mdx +396 -0
- package/docs/Contributing.mdx +78 -0
- package/docs/ForAgents.mdx +53 -0
- package/docs/Introduction.mdx +54 -0
- package/llms.txt +550 -0
- package/package.json +347 -3
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-picker/DatePicker.mdx +440 -0
- package/src/components/date-picker/DatePicker.stories.tsx +458 -0
- package/src/components/date-picker/DatePicker.tsx +688 -0
- package/src/components/date-picker/index.ts +9 -0
- package/src/components/divider/Divider.mdx +256 -0
- package/src/components/divider/Divider.stories.tsx +177 -0
- package/src/components/divider/Divider.tsx +193 -0
- package/src/components/divider/index.ts +1 -0
- package/src/components/drawer/Drawer.mdx +518 -0
- package/src/components/drawer/Drawer.stories.tsx +392 -0
- package/src/components/drawer/Drawer.tsx +683 -0
- package/src/components/drawer/index.ts +1 -0
- package/src/components/dropdown-button/DropdownButton.mdx +285 -0
- package/src/components/dropdown-button/DropdownButton.stories.tsx +398 -0
- package/src/components/dropdown-button/DropdownButton.tsx +198 -0
- package/src/components/dropdown-button/index.ts +7 -0
- package/src/components/faq/FAQ.mdx +364 -0
- package/src/components/faq/FAQ.stories.tsx +343 -0
- package/src/components/faq/FAQ.tsx +337 -0
- package/src/components/faq/index.ts +1 -0
- package/src/components/field/Field.mdx +129 -0
- package/src/components/field/Field.stories.tsx +461 -0
- package/src/components/field/Field.tsx +787 -0
- package/src/components/field/index.ts +20 -0
- package/src/components/field-pair/FieldPair.mdx +312 -0
- package/src/components/field-pair/FieldPair.stories.tsx +539 -0
- package/src/components/field-pair/FieldPair.tsx +845 -0
- package/src/components/field-pair/index.ts +9 -0
- package/src/components/file-upload/FileUpload.mdx +345 -0
- package/src/components/file-upload/FileUpload.stories.tsx +698 -0
- package/src/components/file-upload/FileUpload.tsx +802 -0
- package/src/components/file-upload/index.ts +6 -0
- package/src/components/filter-chip/FilterChip.mdx +778 -0
- package/src/components/filter-chip/FilterChip.stories.tsx +827 -0
- package/src/components/filter-chip/FilterChip.tsx +881 -0
- package/src/components/filter-chip/index.ts +11 -0
- package/src/components/filter-facet/FilterFacet.mdx +536 -0
- package/src/components/filter-facet/FilterFacet.stories.tsx +506 -0
- package/src/components/filter-facet/FilterFacet.tsx +1160 -0
- package/src/components/filter-facet/index.ts +7 -0
- package/src/components/firm-avatar/FirmAvatar.mdx +280 -0
- package/src/components/firm-avatar/FirmAvatar.stories.tsx +147 -0
- package/src/components/firm-avatar/FirmAvatar.tsx +172 -0
- package/src/components/firm-avatar/index.ts +7 -0
- package/src/components/form-actions/FormActions.mdx +518 -0
- package/src/components/form-actions/FormActions.stories.tsx +621 -0
- package/src/components/form-actions/FormActions.tsx +273 -0
- package/src/components/form-actions/index.ts +6 -0
- package/src/components/form-block/FormBlock.mdx +728 -0
- package/src/components/form-block/FormBlock.stories.tsx +813 -0
- package/src/components/form-block/FormBlock.tsx +679 -0
- package/src/components/form-block/index.ts +13 -0
- package/src/components/form-section/FormSection.mdx +436 -0
- package/src/components/form-section/FormSection.stories.tsx +407 -0
- package/src/components/form-section/FormSection.tsx +290 -0
- package/src/components/form-section/index.ts +17 -0
- package/src/components/heading/Heading.mdx +206 -0
- package/src/components/heading/Heading.stories.tsx +169 -0
- package/src/components/heading/Heading.tsx +124 -0
- package/src/components/heading/index.ts +8 -0
- package/src/components/heading-group/HeadingGroup.mdx +521 -0
- package/src/components/heading-group/HeadingGroup.stories.tsx +353 -0
- package/src/components/heading-group/HeadingGroup.tsx +396 -0
- package/src/components/heading-group/index.ts +7 -0
- package/src/components/hero/Hero.mdx +742 -0
- package/src/components/hero/Hero.stories.tsx +527 -0
- package/src/components/hero/Hero.tsx +807 -0
- package/src/components/hero/index.ts +1 -0
- package/src/components/icon/Icon.mdx +329 -0
- package/src/components/icon/Icon.stories.tsx +398 -0
- package/src/components/icon/Icon.tsx +97 -0
- package/src/components/icon/index.ts +2 -0
- package/src/components/icon-button/IconButton.mdx +206 -0
- package/src/components/icon-button/IconButton.stories.tsx +341 -0
- package/src/components/icon-button/IconButton.tsx +273 -0
- package/src/components/icon-button/index.ts +1 -0
- package/src/components/item-row/ItemRow.mdx +533 -0
- package/src/components/item-row/ItemRow.stories.tsx +434 -0
- package/src/components/item-row/ItemRow.tsx +676 -0
- package/src/components/item-row/index.ts +9 -0
- package/src/components/list-row/ListRow.mdx +404 -0
- package/src/components/list-row/ListRow.stories.tsx +404 -0
- package/src/components/list-row/ListRow.tsx +424 -0
- package/src/components/list-row/index.ts +1 -0
- package/src/components/menu/Menu.mdx +268 -0
- package/src/components/menu/Menu.stories.tsx +455 -0
- package/src/components/menu/Menu.tsx +452 -0
- package/src/components/menu/index.ts +1 -0
- package/src/components/modal/Modal.mdx +854 -0
- package/src/components/modal/Modal.stories.tsx +881 -0
- package/src/components/modal/Modal.tsx +1434 -0
- package/src/components/modal/index.ts +1 -0
- package/src/components/nav-link/NavLink.mdx +196 -0
- package/src/components/nav-link/NavLink.stories.tsx +243 -0
- package/src/components/nav-link/NavLink.tsx +222 -0
- package/src/components/nav-link/index.ts +1 -0
- package/src/components/number-field/NumberField.mdx +223 -0
- package/src/components/number-field/NumberField.stories.tsx +291 -0
- package/src/components/number-field/NumberField.tsx +388 -0
- package/src/components/number-field/index.ts +6 -0
- package/src/components/pagination/Pagination.mdx +305 -0
- package/src/components/pagination/Pagination.stories.tsx +333 -0
- package/src/components/pagination/Pagination.tsx +343 -0
- package/src/components/pagination/index.ts +8 -0
- package/src/components/popover-surface/PopoverSurface.mdx +158 -0
- package/src/components/popover-surface/PopoverSurface.stories.tsx +421 -0
- package/src/components/popover-surface/index.ts +1 -0
- package/src/components/progress-bar/ProgressBar.mdx +802 -0
- package/src/components/progress-bar/ProgressBar.stories.tsx +533 -0
- package/src/components/progress-bar/ProgressBar.tsx +654 -0
- package/src/components/progress-bar/index.ts +9 -0
- package/src/components/promo-sticker/PromoSticker.mdx +436 -0
- package/src/components/promo-sticker/PromoSticker.stories.tsx +363 -0
- package/src/components/promo-sticker/PromoSticker.tsx +313 -0
- package/src/components/promo-sticker/index.ts +7 -0
- package/src/components/promo-surface/PromoSurface.mdx +399 -0
- package/src/components/promo-surface/PromoSurface.stories.tsx +270 -0
- package/src/components/promo-surface/PromoSurface.tsx +305 -0
- package/src/components/promo-surface/index.ts +7 -0
- package/src/components/radio/Radio.mdx +243 -0
- package/src/components/radio/Radio.stories.tsx +307 -0
- package/src/components/radio/Radio.tsx +288 -0
- package/src/components/radio/index.ts +1 -0
- package/src/components/radio-group/RadioGroup.mdx +119 -0
- package/src/components/radio-group/RadioGroup.stories.tsx +225 -0
- package/src/components/radio-group/RadioGroup.tsx +139 -0
- package/src/components/radio-group/index.ts +1 -0
- package/src/components/select/Select.mdx +241 -0
- package/src/components/select/Select.stories.tsx +404 -0
- package/src/components/select/Select.tsx +381 -0
- package/src/components/select/index.ts +1 -0
- package/src/components/select-field/SelectField.mdx +324 -0
- package/src/components/select-field/SelectField.stories.tsx +460 -0
- package/src/components/select-field/SelectField.tsx +138 -0
- package/src/components/select-field/index.ts +1 -0
- package/src/components/skeleton/Skeleton.mdx +194 -0
- package/src/components/skeleton/Skeleton.stories.tsx +260 -0
- package/src/components/skeleton/Skeleton.tsx +107 -0
- package/src/components/skeleton/index.ts +1 -0
- package/src/components/split-button/SplitButton.mdx +445 -0
- package/src/components/split-button/SplitButton.stories.tsx +465 -0
- package/src/components/split-button/SplitButton.tsx +361 -0
- package/src/components/split-button/index.ts +7 -0
- package/src/components/status-summary-bar/StatusSummaryBar.mdx +338 -0
- package/src/components/status-summary-bar/StatusSummaryBar.stories.tsx +408 -0
- package/src/components/status-summary-bar/StatusSummaryBar.tsx +428 -0
- package/src/components/status-summary-bar/index.ts +8 -0
- package/src/components/subject-lookup-field/SubjectLookupField.mdx +378 -0
- package/src/components/subject-lookup-field/SubjectLookupField.stories.tsx +393 -0
- package/src/components/subject-lookup-field/SubjectLookupField.tsx +1079 -0
- package/src/components/subject-lookup-field/index.ts +11 -0
- package/src/components/switch/Switch.mdx +376 -0
- package/src/components/switch/Switch.stories.tsx +296 -0
- package/src/components/switch/Switch.tsx +483 -0
- package/src/components/switch/index.ts +1 -0
- package/src/components/table/Table.mdx +575 -0
- package/src/components/table/Table.stories.tsx +1049 -0
- package/src/components/table/Table.tsx +745 -0
- package/src/components/table/TableConsumers.stories.tsx +195 -0
- package/src/components/table/_tableFixtures.ts +1189 -0
- package/src/components/table/index.ts +22 -0
- package/src/components/text-field/TextField.mdx +699 -0
- package/src/components/text-field/TextField.stories.tsx +674 -0
- package/src/components/text-field/TextField.tsx +645 -0
- package/src/components/text-field/index.ts +11 -0
- package/src/components/text-link/TextLink.mdx +353 -0
- package/src/components/text-link/TextLink.stories.tsx +458 -0
- package/src/components/text-link/TextLink.tsx +504 -0
- package/src/components/text-link/index.ts +10 -0
- package/src/components/textarea/Textarea.mdx +244 -0
- package/src/components/textarea/Textarea.stories.tsx +371 -0
- package/src/components/textarea/Textarea.tsx +489 -0
- package/src/components/textarea/index.ts +9 -0
- package/src/components/tooltip/Tooltip.mdx +462 -0
- package/src/components/tooltip/Tooltip.stories.tsx +500 -0
- package/src/components/tooltip/Tooltip.tsx +756 -0
- package/src/components/tooltip/index.ts +13 -0
- package/src/components/unit-field/UnitField.mdx +215 -0
- package/src/components/unit-field/UnitField.stories.tsx +291 -0
- package/src/components/unit-field/UnitField.tsx +255 -0
- package/src/components/unit-field/index.ts +7 -0
- package/src/icons/icon-registry.generated.ts +510 -0
- package/src/icons/icon-types.generated.ts +256 -0
- package/src/index.ts +70 -0
- package/src/internal/BottomSheet.tsx +714 -0
- package/src/internal/FodsProvider.tsx +36 -0
- package/src/internal/MotionCaret.tsx +53 -0
- package/src/internal/NumberFormatInput.tsx +276 -0
- package/src/internal/SummaryDonut.tsx +359 -0
- package/src/internal/buttonSegment.ts +241 -0
- package/src/internal/collapseRoom.ts +130 -0
- package/src/internal/comboboxKeys.ts +90 -0
- package/src/internal/contentPresence.ts +46 -0
- package/src/internal/dayCell.ts +274 -0
- package/src/internal/dialogPortal.ts +50 -0
- package/src/internal/donutSweeps.ts +77 -0
- package/src/internal/enterOnViewGeometry.ts +53 -0
- package/src/internal/faqItem.ts +104 -0
- package/src/internal/floatingLabelMotion.tsx +109 -0
- package/src/internal/formBlockContext.ts +27 -0
- package/src/internal/heightRoom.ts +135 -0
- package/src/internal/numberSeparators.ts +93 -0
- package/src/internal/overlayMotion.tsx +32 -0
- package/src/internal/paginationItem.ts +106 -0
- package/src/internal/popoverSurface.ts +78 -0
- package/src/internal/portalContainer.ts +11 -0
- package/src/internal/progressBarItem.ts +356 -0
- package/src/internal/selectionControlText.ts +42 -0
- package/src/internal/statusSummaryParts.tsx +475 -0
- package/src/internal/summaryMotion.ts +111 -0
- package/src/internal/table/ChildConnector.tsx +57 -0
- package/src/internal/table/ChildRowPrefix.tsx +21 -0
- package/src/internal/table/ColumnSettings.tsx +194 -0
- package/src/internal/table/ScrollRegion.tsx +176 -0
- package/src/internal/table/TableEmpty.tsx +99 -0
- package/src/internal/table/TableLayout.tsx +29 -0
- package/src/internal/table/TableLoadStatus.tsx +60 -0
- package/src/internal/table/TableMobile.tsx +582 -0
- package/src/internal/table/TruncatedCell.tsx +35 -0
- package/src/internal/table/emptyValue.ts +11 -0
- package/src/internal/table/features.ts +44 -0
- package/src/internal/table/recipes.ts +263 -0
- package/src/internal/table/rowClick.ts +8 -0
- package/src/internal/table/types.ts +342 -0
- package/src/internal/tailwind-variants.ts +65 -0
- package/src/internal/tooltipContext.ts +15 -0
- package/src/internal/tw-merge-config.generated.ts +275 -0
- package/src/internal/useAnchoredPanel.ts +340 -0
- package/src/internal/useCountUp.ts +65 -0
- package/src/internal/useDateFieldTrigger.tsx +497 -0
- package/src/internal/useEChart.ts +88 -0
- package/src/internal/useEnterOnView.ts +80 -0
- package/src/internal/useFloatingBar.ts +125 -0
- package/src/internal/useFormReset.ts +57 -0
- package/src/internal/useIsMobile.ts +64 -0
- package/src/internal/useNoImplicitSubmit.ts +41 -0
- package/src/internal/useOneRowOverflow.ts +103 -0
- package/src/internal/usePrefersReducedMotion.ts +27 -0
- package/src/internal/useReturnFocus.ts +34 -0
- package/src/internal/utils.ts +58 -0
- package/src/recipes/EmptyState.stories.tsx +105 -0
- package/src/recipes/Form.stories.tsx +360 -0
- package/src/recipes/ModalWithForm.stories.tsx +219 -0
- package/src/recipes/Recipes.mdx +61 -0
- package/src/recipes/TableWithFilters.stories.tsx +278 -0
- package/src/storybook/FodsFamily.tsx +39 -0
- package/src/storybook/Section.tsx +36 -0
- package/src/storybook/a11y.ts +24 -0
- package/src/storybook/assets/banner-character-bartender.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-left.webp +0 -0
- package/src/storybook/assets/banner-invoice-sheet-right.webp +0 -0
- package/src/storybook/assets/invoice-hero.webp +0 -0
- package/src/storybook/assets/invoice.webp +0 -0
- package/src/storybook/assets/section-document-info.svg +21 -0
- package/src/storybook/assets/section-gear-checklist.svg +11 -0
- package/src/storybook/assets/section-person-arrow-in.svg +15 -0
- package/src/storybook/assets/section-person-arrow-out.svg +22 -0
- package/src/storybook/assets/section-receipt-dollar.svg +23 -0
- package/src/storybook/assets/table-empty-folder-empty.png +0 -0
- package/src/storybook/assets/table-empty-folder-magnifying-glass.png +0 -0
- package/src/storybook/assets/table-empty-funnel.png +0 -0
- package/src/storybook/assets/table-empty-load-failed.png +0 -0
- package/src/storybook/assets/wallet-spot.png +0 -0
- package/src/storybook/assets.d.ts +17 -0
- package/src/storybook/componentDoc.ts +41 -0
- package/src/storybook/fitFrame.tsx +70 -0
- package/src/storybook/forceStates.tsx +647 -0
- package/src/storybook/illustrations.tsx +66 -0
- package/src/storybook/viewportFrame.tsx +58 -0
- package/src/styles/assets/label-brush-1.svg +6 -0
- package/src/styles/assets/pattern-dark.svg +113 -0
- package/src/styles/base.css +106 -0
- package/src/styles/index.css +15 -0
- package/src/styles/motion.css +157 -0
- package/src/styles/promo-sticker.css +27 -0
- package/src/styles/promo-surface.css +49 -0
- package/src/styles/shared.css +11 -0
- package/src/styles/theme.generated.css +314 -0
- package/src/styles/theme.map.json +278 -0
- package/src/styles/tracking.generated.css +12 -0
- package/src/tokens/index.ts +4 -0
- package/src/tokens/tokens.generated.ts +542 -0
|
@@ -0,0 +1,504 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { Slot } from '@radix-ui/react-slot';
|
|
4
|
+
// The configured `tv` — its extended tailwind-merge knows that `text-body-*` is a
|
|
5
|
+
// font-size and `text-text-link` a colour, so the two do not annihilate each other
|
|
6
|
+
// (the plain `tailwind-variants` export classifies both as text-colour).
|
|
7
|
+
import { tv, type VariantProps } from '../../internal/tailwind-variants';
|
|
8
|
+
import { Icon, type IconName } from '../icon/Icon';
|
|
9
|
+
import { cn, stripChildClickHandlers, suppressDisabledClick } from '../../internal/utils';
|
|
10
|
+
import { TooltipBodyContext } from '../../internal/tooltipContext';
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* TextLink — an inline or standalone text link (ui-system atom, manifest 1.11.0,
|
|
14
|
+
* Figma node 6232-139323). Link-blue text with an optional decorative leading /
|
|
15
|
+
* trailing icon and NO button chrome: it reads as text that happens to be
|
|
16
|
+
* actionable. Distinct from `Button` (an action with chrome) and from the header
|
|
17
|
+
* nav current-page marker (NavLink).
|
|
18
|
+
*
|
|
19
|
+
* Two orthogonal axes (the underline was split out of the semantic axis in
|
|
20
|
+
* manifest 1.6.0):
|
|
21
|
+
*
|
|
22
|
+
* - `variant` carries intent, weight and colour — `default` (inline / in-prose),
|
|
23
|
+
* `strong` (Semibold standalone action links), `quiet` (muted `--text-secondary`,
|
|
24
|
+
* footer link columns);
|
|
25
|
+
* - `underline` carries only the line — `on` (default) is underlined in every
|
|
26
|
+
* state including disabled; `off` is bare at rest/disabled and underlines on
|
|
27
|
+
* hover. Use `off` ONLY where a non-colour affordance sits next to the label
|
|
28
|
+
* (an icon, or list grouping) — WCAG 1.4.1.
|
|
29
|
+
*
|
|
30
|
+
* Token bindings (manifest `families` / `sizes` / `focus`):
|
|
31
|
+
* - default + strong: rest `--text-link`, hover `--text-link-hover`
|
|
32
|
+
* - quiet: rest AND hover `--text-secondary` (the colour deliberately does not
|
|
33
|
+
* change — the hover signal is the underline)
|
|
34
|
+
* - disabled (every variant): `--disabled-foreground`
|
|
35
|
+
* - sizes: xxs `--font-size-xxs` (12) · s `--font-size-sm` (14) · m
|
|
36
|
+
* `--font-size-base` (16); icon↔label gap `--space-200` (4) on all three.
|
|
37
|
+
* `inherit` is the fourth, code-only tier — see note 1.
|
|
38
|
+
* - focus: additive `--outline-focus` ring, `--border-width-200`, stroke OUTSIDE,
|
|
39
|
+
* 3 px offset, radius `--radius-300`, no padding (an inline link must not bloat)
|
|
40
|
+
*
|
|
41
|
+
* Deviations from the manifest that are worth knowing:
|
|
42
|
+
*
|
|
43
|
+
* 1. INHERITANCE — the manifest's inline archetype says an inline link inherits
|
|
44
|
+
* BOTH the surrounding weight and its font-size / line-height (spec «Inline
|
|
45
|
+
* links inherit the surrounding text»). Weight: `default` emits NO font-weight
|
|
46
|
+
* class at all (`--font-weight-normal` on the Default family is only the
|
|
47
|
+
* standalone / Figma-rendering binding); `strong` pins `font-semibold`, `quiet`
|
|
48
|
+
* pins `font-normal` (both are standalone). Size: the three named tiers all
|
|
49
|
+
* emit `text-body-*`, which sets font-size AND line-height, so an inline link
|
|
50
|
+
* would always override the paragraph's rhythm — hence `size="inherit"`, which
|
|
51
|
+
* emits nothing at all. It has no Figma counterpart (Figma cannot express
|
|
52
|
+
* "inherit"); the standalone tiers stay the manifest's XXS / S / M.
|
|
53
|
+
* 2. FOCUS OFFSET — the design system has no 3 px spacing token and Tailwind's
|
|
54
|
+
* `outline-offset-*` scale stops at 2 / 4, so the 3 px offset is written as an
|
|
55
|
+
* arbitrary value. It is a ring geometry constant from the manifest, not a
|
|
56
|
+
* token bypass. Colour and width are both bound: `--outline-focus` through
|
|
57
|
+
* `outline-outline-focus`, and `--border-width-200` through `outline-200`
|
|
58
|
+
* (the config now carries an `outlineWidth` scale keyed on the width tokens,
|
|
59
|
+
* so the ring follows a re-tint instead of sitting on Tailwind's own 2 px).
|
|
60
|
+
* 3. ICON SIZE — width and height of every `.icon` in the link, from the
|
|
61
|
+
* manifest `sizes[].icon` (`[&_.icon]:size-icon-*`, as Button): xxs
|
|
62
|
+
* `--size-icon-2xsmall` (14) · s `--size-icon-xsmall` (16) · m
|
|
63
|
+
* `--size-icon-small` (20). `inherit` has no manifest row and no token: its
|
|
64
|
+
* icon is `1em`, so it follows the paragraph (see the size variant).
|
|
65
|
+
* 4. UNDERLINE SCOPE — the line lives on the LABEL slot, not on the root. The
|
|
66
|
+
* manifest's anatomy makes the icons decorative glyphs sitting beside the
|
|
67
|
+
* label, so underlining the root would drag the line under the icon and the
|
|
68
|
+
* flex gap would break it into disjoint segments at a different offset. The
|
|
69
|
+
* Underline=Off hover line is driven by `group-hover` so it still appears
|
|
70
|
+
* when the pointer rests on the icon.
|
|
71
|
+
*
|
|
72
|
+
* In `asChild` mode there is no label slot — root and label are the SAME
|
|
73
|
+
* element — and neither `slots.label()` nor `group-hover:` survives that
|
|
74
|
+
* collapse: `group-hover:` compiles to `:is(:where(.group):hover *)`, a
|
|
75
|
+
* DESCENDANT selector, so the group element never matches itself. That branch
|
|
76
|
+
* therefore emits its own folded pair (`!underline` / `hover:!underline`)
|
|
77
|
+
* instead of the label slot. The `!` is the same global-anchor workaround as
|
|
78
|
+
* the colours (note 5): an unlayered global `a { text-decoration: none }` in a consuming
|
|
79
|
+
* app beats a plain layered `underline` utility, leaving an `asChild` anchor with no line
|
|
80
|
+
* at all — and Underline=Off's hover line is the WCAG
|
|
81
|
+
* 1.4.1 non-colour signal the whole variant rests on.
|
|
82
|
+
* 5. `!` ON THE COLOURS — a consuming app may carry a global
|
|
83
|
+
* `a { color: var(--text-link) }` (and a `:hover` sibling); the package ships no
|
|
84
|
+
* anchor rule of its own. Such a rule OUTSIDE any `@layer` beats every Tailwind
|
|
85
|
+
* colour utility on an anchor; in `@layer base` with the specificity of a bare `a`,
|
|
86
|
+
* a plain utility wins. The `!` stays for now (it forces only precedence,
|
|
87
|
+
* the values are tokens); dropping it here and in `Button` is a separate cleanup.
|
|
88
|
+
*
|
|
89
|
+
* Semantics / a11y:
|
|
90
|
+
* - with `href` → a real `<a href>`; without `href` (an in-page action) → a
|
|
91
|
+
* `<button type="button">` styled as a link. Never a clickable `<span>`.
|
|
92
|
+
* - `disabled` on an `<a>` has no native equivalent, so the href is dropped and
|
|
93
|
+
* `aria-disabled="true"` + `tabIndex={-1}` are set and clicks are suppressed;
|
|
94
|
+
* on the `<button>` branch the native `disabled` attribute is used as well.
|
|
95
|
+
* Dropping the href also strips the anchor's IMPLICIT `link` role (an `<a>`
|
|
96
|
+
* without href is a generic element), and `aria-disabled` on a generic element
|
|
97
|
+
* announces nothing — so the role is re-stated explicitly while disabled. That
|
|
98
|
+
* is what makes "announced as disabled, skipped when tabbing" actually true.
|
|
99
|
+
* In `asChild` mode the child owns its href and its handlers, so the suppression
|
|
100
|
+
* moves to the CAPTURE phase — `Slot` composes handlers child-first, which puts a
|
|
101
|
+
* bubble-phase guard behind the child's own `onClick` (see `suppressDisabledClick`).
|
|
102
|
+
* For the same reason the child's own click handlers are stripped while disabled
|
|
103
|
+
* (`stripChildClickHandlers`): a child-declared `onClickCapture` would otherwise be
|
|
104
|
+
* composed ahead of the guard and still fire.
|
|
105
|
+
* - `target="_blank"` always ships `rel="noopener"` (plus `noreferrer` when the
|
|
106
|
+
* consumer passes no `rel` of its own) — a security control against reverse
|
|
107
|
+
* tabnabbing. Announcing "opens in a new window" is the LABEL's job (text in
|
|
108
|
+
* the accessible name), never the icon's.
|
|
109
|
+
* - icons are decorative: `Icon` already renders `aria-hidden="true"`.
|
|
110
|
+
*/
|
|
111
|
+
const textLinkVariants = tv({
|
|
112
|
+
slots: {
|
|
113
|
+
root: [
|
|
114
|
+
'group',
|
|
115
|
+
'font-inter',
|
|
116
|
+
'cursor-pointer',
|
|
117
|
+
// Motion (manifest 1.13.1 `motion.states`): hover eases the ink and the
|
|
118
|
+
// underline colour over --duration-hover, press over --duration-press, both on
|
|
119
|
+
// --easing-standard. No family has a pressed ink of its own today (inverse shares
|
|
120
|
+
// the hover ink, the light-surface families have no pressed step), so press is
|
|
121
|
+
// wired for the manifest but changes nothing visible.
|
|
122
|
+
// A consumer's global anchor rule in `@layer base` with the specificity of a bare `a`
|
|
123
|
+
// loses to this transition on an `<a>`; the package ships no anchor rule, and a
|
|
124
|
+
// consumer's unlayered `a` transition would win. Never `!` here: a layered
|
|
125
|
+
// `!important` would outrank an unlayered motion freeze in a test harness, which
|
|
126
|
+
// would then measure mid-transition.
|
|
127
|
+
'transition-[color,text-decoration-color] duration-hover ease-standard active:duration-press',
|
|
128
|
+
'rounded-300',
|
|
129
|
+
// The line belongs to the label slot, never to the root — see JSDoc note 4.
|
|
130
|
+
'no-underline',
|
|
131
|
+
// 3 px offset — one step beyond the family's 2 px; text is lighter than a
|
|
132
|
+
// button, so it earns more air. No token exists for 3 px (see JSDoc note 2).
|
|
133
|
+
/* fods-lint-disable-next-line outline-offset — off-grid 3 px focus offset mandated by the manifest (text-link focus.offset); no spacing token exists and Tailwind's outline-offset scale skips 3 */
|
|
134
|
+
'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-[3px]',
|
|
135
|
+
],
|
|
136
|
+
label: '',
|
|
137
|
+
},
|
|
138
|
+
variants: {
|
|
139
|
+
variant: {
|
|
140
|
+
// No font-weight class on purpose — the inline archetype inherits it.
|
|
141
|
+
// The `!` on every colour guards against a consumer's global anchor rule; it is not
|
|
142
|
+
// a token bypass — see JSDoc note 5.
|
|
143
|
+
default: { root: '!text-text-link hover:!text-text-link-hover' },
|
|
144
|
+
strong: { root: 'font-semibold !text-text-link hover:!text-text-link-hover' },
|
|
145
|
+
quiet: { root: 'font-normal !text-text-secondary hover:!text-text-secondary' },
|
|
146
|
+
},
|
|
147
|
+
size: {
|
|
148
|
+
// Icon = manifest sizes[].icon, as width/height on every `.icon` in the link
|
|
149
|
+
// (the glyph TextLink renders from a name and a consumer's element alike).
|
|
150
|
+
xxs: { root: 'text-body-xxs [&_.icon]:size-icon-2xsmall' },
|
|
151
|
+
sm: { root: 'text-body-sm [&_.icon]:size-icon-xsmall' },
|
|
152
|
+
md: { root: 'text-body-base [&_.icon]:size-icon-small' },
|
|
153
|
+
// The inline tier: no font-size and no line-height class, so both come from
|
|
154
|
+
// the surrounding paragraph (see JSDoc note 1). It is code-only (no manifest
|
|
155
|
+
// row), so there is no `sizes[].icon` token to bind: the glyph is sized `1em`
|
|
156
|
+
// to follow the running text it sits in, whatever tier that is. A fixed
|
|
157
|
+
// `--size-icon*` step would be right for one paragraph size and wrong for the
|
|
158
|
+
// rest. This is the one deliberate non-token icon size in the package.
|
|
159
|
+
inherit: { root: '[&_.icon]:size-[1em]' },
|
|
160
|
+
},
|
|
161
|
+
underline: {
|
|
162
|
+
on: { label: 'underline' },
|
|
163
|
+
// The hover line is driven from the root (`group`) so it also appears when
|
|
164
|
+
// the pointer sits on the icon rather than on the label itself.
|
|
165
|
+
off: { label: 'no-underline group-hover:underline' },
|
|
166
|
+
},
|
|
167
|
+
/**
|
|
168
|
+
* With an icon the link becomes a flex row (the gap needs a flex container);
|
|
169
|
+
* without one it stays `inline` so a link inside running prose wraps with the
|
|
170
|
+
* paragraph instead of becoming an unbreakable box.
|
|
171
|
+
*/
|
|
172
|
+
hasIcon: {
|
|
173
|
+
// Two different alignments on purpose, and they are not interchangeable:
|
|
174
|
+
//
|
|
175
|
+
// - the LABEL is baseline-aligned (manifest anatomy: "a horizontal row,
|
|
176
|
+
// baseline-aligned"). Because it participates in baseline alignment it
|
|
177
|
+
// also supplies the flex container's own baseline, so no `vertical-align`
|
|
178
|
+
// override is needed and the link sits on the paragraph's baseline — an
|
|
179
|
+
// inline link must not shift the line;
|
|
180
|
+
// - the ICON is centred instead. `.icon` is an inline-block `<svg>` whose
|
|
181
|
+
// glyph is drawn in the middle of its box while the box's baseline is
|
|
182
|
+
// its bottom edge. Baseline-aligning that box therefore lifts
|
|
183
|
+
// the glyph visibly above the text. Centring it on the line box is what
|
|
184
|
+
// actually reads as baseline-aligned to the eye.
|
|
185
|
+
//
|
|
186
|
+
// The centring targets every direct child except the label, not `.icon`: an
|
|
187
|
+
// icon slot may be a rendered element (`<MotionCaret>` — an inline-flex span
|
|
188
|
+
// around the svg), and then that wrapper is the flex item, so `self-center`
|
|
189
|
+
// on the nested svg would centre nothing.
|
|
190
|
+
true: { root: 'inline-flex items-baseline gap-200 [&>:not([data-fods-part=label])]:self-center' },
|
|
191
|
+
false: { root: 'inline' },
|
|
192
|
+
},
|
|
193
|
+
/**
|
|
194
|
+
* Declared last so tailwind-merge drops the family colour in favour of the
|
|
195
|
+
* disabled ink; the `!` on top is the global-anchor workaround from note 5,
|
|
196
|
+
* without which a consumer's unlayered global anchor rule repaints a disabled link in link-blue.
|
|
197
|
+
*
|
|
198
|
+
* The rest underline is deliberately left alone: Underline=On stays underlined
|
|
199
|
+
* when disabled (manifest `families`), and Underline=Off cannot gain the hover
|
|
200
|
+
* line because the root takes no pointer events. No `cursor-not-allowed` — it
|
|
201
|
+
* would sit on the very element that just turned off pointer events, so it
|
|
202
|
+
* could never render.
|
|
203
|
+
*/
|
|
204
|
+
disabled: {
|
|
205
|
+
true: {
|
|
206
|
+
root: ['pointer-events-none', '!text-disabled-foreground hover:!text-disabled-foreground'],
|
|
207
|
+
},
|
|
208
|
+
false: {},
|
|
209
|
+
},
|
|
210
|
+
/**
|
|
211
|
+
* The ground the link is composed on (`axes.surface`, full matrix x2). This is a
|
|
212
|
+
* CONTAINER-DRIVEN swap, not a new resting-colour axis of the atom: the dark
|
|
213
|
+
* container picks the value, and the whole ink + ring package travels with it
|
|
214
|
+
* (`spec/06-patterns/inverse-surface.md`).
|
|
215
|
+
*
|
|
216
|
+
* `inverse` renders ONE ladder for all three families — the family keeps only its
|
|
217
|
+
* weight and decoration mechanics. Rest is the QUIET step, `--text-inverted-secondary`
|
|
218
|
+
* (blue/200, 7.10:1), deliberately not white: the copy around a bar link is already
|
|
219
|
+
* `--text-inverted`, and a white link would hang on the underline alone. Interaction
|
|
220
|
+
* brightens to `--text-inverted` (9.43:1), the mirror of a light-surface link
|
|
221
|
+
* darkening toward `--text-primary`. Hover and pressed share it — 1.11.0 dropped the
|
|
222
|
+
* `color-mix` midpoint the older `delivery.inverseLink` described, because Figma could
|
|
223
|
+
* not render it without binding a Layer-1 primitive.
|
|
224
|
+
*
|
|
225
|
+
* SCOPE — `--bg-inverse` ONLY. On a `--secondary-solid` panel (Promo Surface
|
|
226
|
+
* Solid/Inverse) the same ladder measures 4.45 / 3.86 / 3.35 and fails AA for normal
|
|
227
|
+
* text, so no quiet text action goes on that fill at all: compose the one filled
|
|
228
|
+
* `Brand` CTA instead.
|
|
229
|
+
*
|
|
230
|
+
* The focus ring swaps with it. `--outline-focus` is 2.12:1 on `--bg-inverse`, under
|
|
231
|
+
* the 3:1 non-text floor; `--outline-focus-inverse` is 9.43:1. Mandatory, not cosmetic.
|
|
232
|
+
*/
|
|
233
|
+
surface: {
|
|
234
|
+
default: {},
|
|
235
|
+
inverse: {
|
|
236
|
+
root: [
|
|
237
|
+
'!text-text-inverted-secondary hover:!text-text-inverted',
|
|
238
|
+
'focus-visible:outline-outline-focus-inverse',
|
|
239
|
+
],
|
|
240
|
+
},
|
|
241
|
+
},
|
|
242
|
+
},
|
|
243
|
+
compoundVariants: [
|
|
244
|
+
/*
|
|
245
|
+
* Disabled on inverse. `--disabled-foreground` is a light-surface ink and disappears
|
|
246
|
+
* on a dark ground, so the pattern dims the resting ink instead: "--text-inverted-
|
|
247
|
+
* secondary at 50% opacity" — exempt from contrast by WCAG 1.4.3. Declared after both
|
|
248
|
+
* variants so tailwind-merge keeps this colour over each of them.
|
|
249
|
+
*/
|
|
250
|
+
{
|
|
251
|
+
surface: 'inverse',
|
|
252
|
+
disabled: true,
|
|
253
|
+
// Slot-scoped: with `slots`, a bare `class` on a compoundVariant does not land on
|
|
254
|
+
// the root, so the ink would silently stay at the resting inverse step.
|
|
255
|
+
class: {
|
|
256
|
+
root: '!text-text-inverted-secondary/50 hover:!text-text-inverted-secondary/50',
|
|
257
|
+
},
|
|
258
|
+
},
|
|
259
|
+
],
|
|
260
|
+
defaultVariants: {
|
|
261
|
+
variant: 'default',
|
|
262
|
+
size: 'md',
|
|
263
|
+
underline: 'on',
|
|
264
|
+
hasIcon: false,
|
|
265
|
+
disabled: false,
|
|
266
|
+
surface: 'default',
|
|
267
|
+
},
|
|
268
|
+
});
|
|
269
|
+
|
|
270
|
+
export type TextLinkVariant = 'default' | 'strong' | 'quiet';
|
|
271
|
+
export type TextLinkSize = 'xxs' | 'sm' | 'md' | 'inherit';
|
|
272
|
+
export type TextLinkUnderline = 'on' | 'off';
|
|
273
|
+
export type TextLinkSurface = 'default' | 'inverse';
|
|
274
|
+
export type TextLinkElement = HTMLAnchorElement | HTMLButtonElement;
|
|
275
|
+
|
|
276
|
+
export interface TextLinkProps
|
|
277
|
+
extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'>,
|
|
278
|
+
Omit<VariantProps<typeof textLinkVariants>, 'hasIcon' | 'disabled'> {
|
|
279
|
+
/** Intent family — weight + colour. */
|
|
280
|
+
variant?: TextLinkVariant;
|
|
281
|
+
/**
|
|
282
|
+
* Standalone tiers 12 / 14 / 16. Use `inherit` for an INLINE link: it emits no
|
|
283
|
+
* font-size and no line-height, so both come from the surrounding paragraph and
|
|
284
|
+
* the link never shifts the line.
|
|
285
|
+
*/
|
|
286
|
+
size?: TextLinkSize;
|
|
287
|
+
/** `on` (default) = underlined in every state; `off` = bare at rest, underlines on hover. */
|
|
288
|
+
underline?: TextLinkUnderline;
|
|
289
|
+
/**
|
|
290
|
+
* The ground this link is composed on. `inverse` is for `--bg-inverse` chrome ONLY —
|
|
291
|
+
* an announcement bar, dark page chrome — where the container swaps the whole ink and
|
|
292
|
+
* ring package (`spec/06-patterns/inverse-surface.md`). Not for a `--secondary-solid`
|
|
293
|
+
* panel: the ladder fails AA there, so that fill takes a filled `Brand` CTA and no
|
|
294
|
+
* quiet text action at all.
|
|
295
|
+
*
|
|
296
|
+
* Keep `underline="on"` (the default) on inverse — the line is the non-colour cue
|
|
297
|
+
* (WCAG 1.4.1), and use `variant="strong"` for a bar CTA.
|
|
298
|
+
*/
|
|
299
|
+
surface?: TextLinkSurface;
|
|
300
|
+
/** Navigation target. Omit for an in-page action — the component then renders a `<button>`. */
|
|
301
|
+
href?: string;
|
|
302
|
+
/**
|
|
303
|
+
* Decorative glyph before the label — an icon name, or a rendered element (e.g. a
|
|
304
|
+
* turning caret). TextLink sizes it and colours it with `currentColor`.
|
|
305
|
+
*/
|
|
306
|
+
leadingIcon?: IconName | React.ReactElement;
|
|
307
|
+
/**
|
|
308
|
+
* Decorative glyph after the label — an icon name, or a rendered element (e.g. a
|
|
309
|
+
* turning caret). TextLink sizes it and colours it with `currentColor`.
|
|
310
|
+
*/
|
|
311
|
+
trailingIcon?: IconName | React.ReactElement;
|
|
312
|
+
/** Not actionable: `--disabled-foreground`, no href, `aria-disabled`, out of the tab order. */
|
|
313
|
+
disabled?: boolean;
|
|
314
|
+
/**
|
|
315
|
+
* Render as a Radix `Slot`, merging props onto the single child element
|
|
316
|
+
* (e.g. a React Router `<Link>`). The consumer owns the children, so icons are
|
|
317
|
+
* composed by hand and `href` on this component is ignored — the child carries
|
|
318
|
+
* its own `href` / `to`.
|
|
319
|
+
*
|
|
320
|
+
* `disabled` here cannot remove the child's href, so the link stays copyable and
|
|
321
|
+
* middle-clickable; what it does do is the disabled visual, `aria-disabled`,
|
|
322
|
+
* `tabIndex={-1}` and CAPTURE-phase click suppression (which also covers keyboard
|
|
323
|
+
* Enter, since that fires a click, and the child's OWN `onClick` / `onClickCapture`,
|
|
324
|
+
* which are stripped from the clone — `Slot` composes handlers child-first, so both a
|
|
325
|
+
* bubble-phase guard and a merged capture handler would arrive too late).
|
|
326
|
+
*/
|
|
327
|
+
asChild?: boolean;
|
|
328
|
+
/** Visible label = the accessible name. Never icon-only. */
|
|
329
|
+
children: React.ReactNode;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
/** A name is a glyph from the registry; an element is rendered as given. */
|
|
333
|
+
function renderIcon(icon: IconName | React.ReactElement): React.ReactNode {
|
|
334
|
+
return typeof icon === 'string' ? <Icon name={icon} /> : icon;
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* `target="_blank"` must not leave the new tab with a handle on `window.opener`.
|
|
339
|
+
* A consumer-supplied `rel` is respected and only topped up with `noopener`;
|
|
340
|
+
* with no `rel` at all we ship the full `noopener noreferrer`.
|
|
341
|
+
*/
|
|
342
|
+
function resolveRel(target: string | undefined, rel: string | undefined): string | undefined {
|
|
343
|
+
if (target !== '_blank') return rel;
|
|
344
|
+
if (rel == null) return 'noopener noreferrer';
|
|
345
|
+
|
|
346
|
+
const tokens = rel.split(/\s+/).filter(Boolean);
|
|
347
|
+
if (!tokens.includes('noopener')) tokens.push('noopener');
|
|
348
|
+
return tokens.join(' ');
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
const TextLink = React.forwardRef<TextLinkElement, TextLinkProps>(
|
|
352
|
+
(
|
|
353
|
+
{
|
|
354
|
+
className,
|
|
355
|
+
variant = 'default',
|
|
356
|
+
size = 'md',
|
|
357
|
+
underline = 'on',
|
|
358
|
+
surface = 'default',
|
|
359
|
+
href,
|
|
360
|
+
target,
|
|
361
|
+
rel,
|
|
362
|
+
leadingIcon,
|
|
363
|
+
trailingIcon,
|
|
364
|
+
disabled = false,
|
|
365
|
+
asChild = false,
|
|
366
|
+
onClick,
|
|
367
|
+
children,
|
|
368
|
+
...restProps
|
|
369
|
+
},
|
|
370
|
+
ref,
|
|
371
|
+
) => {
|
|
372
|
+
// Inside a toggletip bubble the link is described by the bubble's body text and
|
|
373
|
+
// closes the bubble once activated (Tooltip 1.3.0).
|
|
374
|
+
const tooltipBody = React.useContext(TooltipBodyContext);
|
|
375
|
+
const props =
|
|
376
|
+
tooltipBody == null
|
|
377
|
+
? restProps
|
|
378
|
+
: {
|
|
379
|
+
...restProps,
|
|
380
|
+
'aria-describedby': restProps['aria-describedby'] ?? tooltipBody.bodyId,
|
|
381
|
+
};
|
|
382
|
+
const hasIcon = leadingIcon != null || trailingIcon != null;
|
|
383
|
+
const slots = textLinkVariants({ variant, size, underline, surface, hasIcon, disabled });
|
|
384
|
+
const classes = cn(slots.root(), className);
|
|
385
|
+
|
|
386
|
+
const handleClick = (event: React.MouseEvent<TextLinkElement>) => {
|
|
387
|
+
if (disabled) {
|
|
388
|
+
event.preventDefault();
|
|
389
|
+
return;
|
|
390
|
+
}
|
|
391
|
+
onClick?.(event as React.MouseEvent<HTMLAnchorElement>);
|
|
392
|
+
tooltipBody?.close();
|
|
393
|
+
};
|
|
394
|
+
|
|
395
|
+
if (asChild) {
|
|
396
|
+
// Built as an object: `Slot`'s props type is element-agnostic, so anchor-only
|
|
397
|
+
// attributes (target / rel) cannot be written as JSX attributes on it.
|
|
398
|
+
//
|
|
399
|
+
// Root and label collapse onto one element here, which neither `slots.label()`
|
|
400
|
+
// nor `group-hover:` survives — hence the folded pair, and the `!` against an
|
|
401
|
+
// unlayered global anchor rule. See JSDoc note 4.
|
|
402
|
+
const foldedUnderline = underline === 'on' ? '!underline' : 'no-underline hover:!underline';
|
|
403
|
+
const slotProps = {
|
|
404
|
+
// Root and label are the same element in this branch, so it carries the root
|
|
405
|
+
// part only. Before the spread,
|
|
406
|
+
// like the two element branches below — a host that composes TextLink into a
|
|
407
|
+
// larger part has to be able to re-label it.
|
|
408
|
+
'data-fods-component': 'text-link',
|
|
409
|
+
'data-fods-part': 'root',
|
|
410
|
+
...props,
|
|
411
|
+
className: cn(slots.root(), foldedUnderline, className),
|
|
412
|
+
'aria-disabled': disabled || undefined,
|
|
413
|
+
// The child owns its href, so `disabled` cannot strip it — suppressing the
|
|
414
|
+
// click is what keeps a disabled link inoperable, keyboard Enter included.
|
|
415
|
+
tabIndex: disabled ? -1 : props.tabIndex,
|
|
416
|
+
// The suppression has to run in the CAPTURE phase: `Slot` composes handlers
|
|
417
|
+
// child-first, so a bubble-phase guard would only fire after the child's own
|
|
418
|
+
// `onClick` had already navigated (see `suppressDisabledClick`). Our own
|
|
419
|
+
// `onClick` is dropped while disabled — there is nothing left for it to do.
|
|
420
|
+
// A child that declares `onClickCapture` ITSELF would be composed child-first
|
|
421
|
+
// as well, so the children go through `stripChildClickHandlers` below.
|
|
422
|
+
...(disabled
|
|
423
|
+
? { onClick: undefined, onClickCapture: suppressDisabledClick }
|
|
424
|
+
: { onClick: handleClick }),
|
|
425
|
+
target,
|
|
426
|
+
rel: resolveRel(target, rel),
|
|
427
|
+
};
|
|
428
|
+
|
|
429
|
+
return (
|
|
430
|
+
<Slot ref={ref as React.Ref<HTMLElement>} {...slotProps}>
|
|
431
|
+
{disabled ? stripChildClickHandlers(children) : children}
|
|
432
|
+
</Slot>
|
|
433
|
+
);
|
|
434
|
+
}
|
|
435
|
+
|
|
436
|
+
const content = (
|
|
437
|
+
<>
|
|
438
|
+
{leadingIcon != null && renderIcon(leadingIcon)}
|
|
439
|
+
{/* The label carries the underline; the decorative icons stay bare. */}
|
|
440
|
+
<span data-fods-part="label" className={slots.label()}>
|
|
441
|
+
{children}
|
|
442
|
+
</span>
|
|
443
|
+
{trailingIcon != null && renderIcon(trailingIcon)}
|
|
444
|
+
</>
|
|
445
|
+
);
|
|
446
|
+
|
|
447
|
+
// In-page action — a <button> styled as a link, never a clickable <span>.
|
|
448
|
+
// `{...props}` deliberately goes FIRST in both branches: `type`, `disabled`,
|
|
449
|
+
// `rel` and the click suppression are load-bearing contracts, not defaults a
|
|
450
|
+
// consumer should be able to shadow. (Button / DropdownButton spread last.)
|
|
451
|
+
//
|
|
452
|
+
// That rule is about BEHAVIOURAL props only. The `data-fods-*` markers are
|
|
453
|
+
// metadata for the verifier, not behaviour, and they sit BEFORE the spread on
|
|
454
|
+
// purpose: a host that composes TextLink into a larger part (ActionRow) has to
|
|
455
|
+
// be able to re-label the element as its own part, or the runtime sweep grades
|
|
456
|
+
// the host's node against text-link's expectations. Overriding them changes
|
|
457
|
+
// nothing a user can see.
|
|
458
|
+
if (href == null) {
|
|
459
|
+
const buttonProps = props as unknown as React.ButtonHTMLAttributes<HTMLButtonElement>;
|
|
460
|
+
return (
|
|
461
|
+
<button
|
|
462
|
+
ref={ref as React.Ref<HTMLButtonElement>}
|
|
463
|
+
// data-fods-part marks the component's parts for measurement in the
|
|
464
|
+
// browser. Not inert in this package: `styles/base.css` scopes its reset to these attributes.
|
|
465
|
+
data-fods-component="text-link"
|
|
466
|
+
data-fods-part="root"
|
|
467
|
+
{...buttonProps}
|
|
468
|
+
type="button"
|
|
469
|
+
disabled={disabled}
|
|
470
|
+
aria-disabled={disabled || undefined}
|
|
471
|
+
onClick={handleClick}
|
|
472
|
+
className={classes}
|
|
473
|
+
>
|
|
474
|
+
{content}
|
|
475
|
+
</button>
|
|
476
|
+
);
|
|
477
|
+
}
|
|
478
|
+
|
|
479
|
+
return (
|
|
480
|
+
<a
|
|
481
|
+
ref={ref as React.Ref<HTMLAnchorElement>}
|
|
482
|
+
data-fods-component="text-link"
|
|
483
|
+
data-fods-part="root"
|
|
484
|
+
{...props}
|
|
485
|
+
href={disabled ? undefined : href}
|
|
486
|
+
target={target}
|
|
487
|
+
rel={resolveRel(target, rel)}
|
|
488
|
+
// Without an href the anchor is a generic element, and `aria-disabled` on a
|
|
489
|
+
// generic element announces nothing — so the role is re-stated while
|
|
490
|
+
// disabled to keep the state reaching assistive tech.
|
|
491
|
+
role={disabled ? 'link' : undefined}
|
|
492
|
+
aria-disabled={disabled || undefined}
|
|
493
|
+
tabIndex={disabled ? -1 : props.tabIndex}
|
|
494
|
+
onClick={handleClick}
|
|
495
|
+
className={classes}
|
|
496
|
+
>
|
|
497
|
+
{content}
|
|
498
|
+
</a>
|
|
499
|
+
);
|
|
500
|
+
},
|
|
501
|
+
);
|
|
502
|
+
TextLink.displayName = 'TextLink';
|
|
503
|
+
|
|
504
|
+
export { TextLink, textLinkVariants };
|