@invoiceonline/ui-react 0.0.0-stage → 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 +78 -2
- 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 +357 -4
- 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 @@
|
|
|
1
|
+
export { Modal, ModalTitle, modalVariants, type ModalProps, type ModalType, type ModalSize } from './Modal';
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as NavLinkStories from './NavLink.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={NavLinkStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# NavLink
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** atom
|
|
11
|
+
- **Status:** draft
|
|
12
|
+
- **Tokens used:** `--border-width-200`, `--disabled-foreground`, `--duration-hover`, `--duration-toggle`, `--easing-standard`, `--font-body`, `--font-size-base`, `--font-weight-semibold`, `--leading-relaxed`, `--outline-focus`, `--outline-strong`, `--radius-200`, `--secondary`, `--secondary-active`, `--size-icon`, `--space-1000`, `--space-400`, `--text-wrap-body`
|
|
13
|
+
- **Manifest version:** `1.4.4`
|
|
14
|
+
|
|
15
|
+
## Overview
|
|
16
|
+
|
|
17
|
+
One item of a navigation group: the header menu, in-app section tabs, a sub-nav. A ghost link in the `--secondary` blue with an optional decorative leading icon and a 2px indicator bar at its bottom edge. It marks **where you are** (the Current state, `aria-current="page"`), not what you trigger.
|
|
18
|
+
|
|
19
|
+
Do **not** use it for an action that does something (→ [`Button`](?path=/docs/design-system-atoms-button--docs)), for a footer or in-prose link (→ [`TextLink`](?path=/docs/design-system-atoms-textlink--docs)), or for an icon-only control (→ [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs)).
|
|
20
|
+
|
|
21
|
+
## Rationale
|
|
22
|
+
|
|
23
|
+
A nav item looks like a ghost button, but two things a button does not express are promoted into this component:
|
|
24
|
+
|
|
25
|
+
1. **Current page.** A nav item needs a persistent *you-are-here* state, distinct from a pressed `:active`. Current is `aria-current="page"` and is shown by the active ink **plus** a 2px bottom indicator bar, a non-colour cue (WCAG 1.4.1), so Current never relies on a blue-against-darker-blue difference alone. Hover previews the same bar in a muted neutral.
|
|
26
|
+
2. **Spacing and collapse belong to the row, not the link.** NavLink has no side padding: the spacing between items is one `gap` on the parent menu. The leading icon can be switched off, so a responsive-collapse controller can drop it as the first reduction step while the label stays.
|
|
27
|
+
|
|
28
|
+
## Anatomy
|
|
29
|
+
|
|
30
|
+
A real `<a href>`, laid out as an `inline-flex` row centred on its cross axis, with these parts (`data-fods-part`):
|
|
31
|
+
|
|
32
|
+
- **`root`** — the anchor. Row height 40 (`--space-1000`), gap `--space-400` between icon and label, radius `--radius-200`, **no side padding**. It carries the ink of both the label and the icon.
|
|
33
|
+
- **`leading-icon`** — optional, default glyph `house`, sized `--size-icon` (24). It draws in `currentColor`, so it follows the root's ink in every state. Decorative: hidden from assistive tech. Switched off by `showIcon={false}`.
|
|
34
|
+
- **`label`** — `children`. `Body/M` (`--font-size-base`), `--font-weight-semibold`, one line, truncated with an ellipsis when its slot is narrower than the text. The accessible name.
|
|
35
|
+
- **`indicator`** — the 2px bar, an empty decorative span (`aria-hidden="true"`) absolutely positioned flush at the bottom edge. It spans the whole content row (icon + gap + label), so it shrinks to the label alone when the icon is off and grows with a longer label. Its height is `--border-width-200`: the span's only box is a transparent `border-b-200`, and its background carries the state colour.
|
|
36
|
+
|
|
37
|
+
## Variants
|
|
38
|
+
|
|
39
|
+
No variant axis: NavLink has one ghost style. The only content switch is the leading icon, shown with and without it in [States](#states).
|
|
40
|
+
|
|
41
|
+
<table>
|
|
42
|
+
<thead>
|
|
43
|
+
<tr><th>Prop</th><th>Values</th><th>Default</th><th>Notes</th></tr>
|
|
44
|
+
</thead>
|
|
45
|
+
<tbody>
|
|
46
|
+
<tr><td><code>showIcon</code></td><td><code>true</code> / <code>false</code></td><td><code>true</code></td><td>The handle a responsive-collapse controller turns off first; the label always stays.</td></tr>
|
|
47
|
+
<tr><td><code>leadingIcon</code></td><td>an icon name</td><td><code>house</code></td><td>The leading glyph. Decorative.</td></tr>
|
|
48
|
+
</tbody>
|
|
49
|
+
</table>
|
|
50
|
+
|
|
51
|
+
## Sizes
|
|
52
|
+
|
|
53
|
+
One size only (M, the header row height); there is no size prop.
|
|
54
|
+
|
|
55
|
+
<table>
|
|
56
|
+
<thead>
|
|
57
|
+
<tr><th>Size</th><th style={{ textAlign: 'right' }}>Row height</th><th>Font</th><th style={{ textAlign: 'right' }}>Icon</th><th>Gap</th><th>Radius</th><th>Side padding</th></tr>
|
|
58
|
+
</thead>
|
|
59
|
+
<tbody>
|
|
60
|
+
<tr>
|
|
61
|
+
<td><code>M</code></td>
|
|
62
|
+
<td style={{ textAlign: 'right' }}>40 (<code>--space-1000</code>)</td>
|
|
63
|
+
<td><code>Body/M</code>, semibold</td>
|
|
64
|
+
<td style={{ textAlign: 'right' }}>24 (<code>--size-icon</code>)</td>
|
|
65
|
+
<td><code>--space-400</code> (8)</td>
|
|
66
|
+
<td><code>--radius-200</code></td>
|
|
67
|
+
<td>none</td>
|
|
68
|
+
</tr>
|
|
69
|
+
</tbody>
|
|
70
|
+
</table>
|
|
71
|
+
|
|
72
|
+
The 40 row height is the tap target, and the missing side padding does not reduce it. In a dense or touch layout add vertical hit-padding; never shrink the row.
|
|
73
|
+
|
|
74
|
+
## States
|
|
75
|
+
|
|
76
|
+
<Canvas of={NavLinkStories.Matrix} />
|
|
77
|
+
|
|
78
|
+
<table>
|
|
79
|
+
<thead>
|
|
80
|
+
<tr><th>State</th><th>Ink (label + icon)</th><th>Indicator bar</th><th>How it is reached</th></tr>
|
|
81
|
+
</thead>
|
|
82
|
+
<tbody>
|
|
83
|
+
<tr><td>Default</td><td><code>--secondary</code></td><td>none</td><td>rest</td></tr>
|
|
84
|
+
<tr><td>Hover</td><td><code>--secondary-active</code></td><td><code>--outline-strong</code> (muted preview)</td><td><code>:hover</code>; only on an item that is not the current one</td></tr>
|
|
85
|
+
<tr><td>Current</td><td><code>--secondary-active</code></td><td><code>--secondary-active</code></td><td><code>aria-current</code> set to any value other than <code>false</code></td></tr>
|
|
86
|
+
<tr><td>Disabled</td><td><code>--disabled-foreground</code></td><td>none</td><td><code>disabled</code></td></tr>
|
|
87
|
+
</tbody>
|
|
88
|
+
</table>
|
|
89
|
+
|
|
90
|
+
- **Hover and Current share the ink**, so the bar is what tells them apart: muted on Hover, blue on Current.
|
|
91
|
+
- **Current** is read from `aria-current`; there is no `current` prop. Any value other than `false` / `"false"` counts, so `"location"` on a sub-nav paints the same cue a screen reader announces.
|
|
92
|
+
- **Disabled** shows no Current cue and announces none: a disabled item does not render `aria-current`, even when you pass it.
|
|
93
|
+
- **Focus** is not a state of the axis but the additive focus ring on `:focus-visible`: an `--outline-focus` outline at `--border-width-200`, 2px outside the root. The ink does not change. The ring follows the root's `--radius-200` corner 2px out.
|
|
94
|
+
- **Motion** — the ink and the bar ease on `--easing-standard`: over `--duration-hover` on an ordinary item, over `--duration-toggle` on the current one (a CSS transition takes the duration of the state it enters). These are colour fades, not movement.
|
|
95
|
+
|
|
96
|
+
In the grid above, Hover and Focus are drawn by copies of the component's own classes, so they show without a pointer or a keyboard.
|
|
97
|
+
|
|
98
|
+
## API
|
|
99
|
+
|
|
100
|
+
<Controls />
|
|
101
|
+
|
|
102
|
+
Notable behaviour not visible in the table:
|
|
103
|
+
|
|
104
|
+
- `href` is required: NavLink always renders an `<a>`. There is no `asChild`.
|
|
105
|
+
- `aria-current` drives the Current state (see [States](#states)).
|
|
106
|
+
- `disabled` removes the `href`, sets `aria-disabled="true"` and `tabIndex={-1}`, drops `aria-current`, cancels the click (neither your `onClick` nor your `onClickCapture` is called) and re-states `role="link"`, because an anchor without `href` loses its implicit link role.
|
|
107
|
+
- The ref is forwarded to the `<a>`; every other anchor attribute is passed through. `className` is merged onto the root.
|
|
108
|
+
|
|
109
|
+
## Do / Don't
|
|
110
|
+
|
|
111
|
+
- ✅ Let the **parent menu's `gap`** set the spacing between links; links hug their text and align flush to the group edge.
|
|
112
|
+
- ✅ Drive **Current** from `aria-current="page"`; the indicator bar is the redundant, colour-independent cue.
|
|
113
|
+
- ✅ Turn the icon off with `showIcon={false}` under responsive collapse: the icon goes first, the label stays.
|
|
114
|
+
- ✅ Keep the **40px row height** as the tap target.
|
|
115
|
+
- ✅ Keep the indicator bar at the full content width (icon + label, or the label alone when the icon is off).
|
|
116
|
+
- ❌ Don't add horizontal padding to the link to space items out; that belongs to the container.
|
|
117
|
+
- ❌ Don't use NavLink for footer links (`TextLink`) or for actions (`Button`).
|
|
118
|
+
- ❌ Don't signal Current with colour alone; keep the indicator bar.
|
|
119
|
+
- ❌ Don't remove the focus ring.
|
|
120
|
+
|
|
121
|
+
## Accessibility
|
|
122
|
+
|
|
123
|
+
- **Keyboard** — a native `<a href>`: Tab reaches it, Enter follows it. Nothing is re-implemented in JS. A disabled item is taken out of the tab order (`tabIndex={-1}`).
|
|
124
|
+
- **ARIA (what you provide)** — `aria-current="page"` on the item of the open route. Wrap the items in a `<nav>` with an `aria-label` and a list, as in the [Navigation](#usage) example. While enabled the component adds no `role`; a disabled item gets `aria-disabled="true"` and `role="link"` and loses `aria-current`. Give each `<nav>` on a page its own name.
|
|
125
|
+
- **Screen reader** — the visible label is the accessible name; the icon and the indicator bar are decorative (`aria-hidden`). Dropping the icon on responsive collapse changes neither the name nor the current-page semantics.
|
|
126
|
+
- **Contrast** — the resting ink `--secondary` is the AA-safe blue step. Current is not carried by colour alone: the 2px bar is the non-colour cue WCAG 1.4.1 asks for, mirroring `aria-current`.
|
|
127
|
+
- **Disabled** — prefer hiding a route to disabling it. A disabled item is skipped by Tab, but a screen reader still reads it in browse mode as an unavailable link, so say why elsewhere.
|
|
128
|
+
- **Forced colours** — only the current item's bar is drawn (`forced-colors:visible`); the bar of every other item is hidden, so Current keeps its cue when the system replaces the colours.
|
|
129
|
+
- **Motion** — only colour transitions (ink and bar), no transform, so nothing needs a reduced-motion opt-out.
|
|
130
|
+
- **Target** — the 40px row is the tap target; the missing side padding does not reduce it. On a touch layout add vertical hit-padding around it.
|
|
131
|
+
|
|
132
|
+
## Copy
|
|
133
|
+
|
|
134
|
+
Voice: impersonal and plain, with consistent terminology. A nav item names a destination, not an action.
|
|
135
|
+
|
|
136
|
+
- **Label** (`children`) — a short destination noun, one or two words: „Přehled“, „Faktury“, „Výdaje“, „Kontakty“, never a verb phrase such as „Zobrazit faktury“ (that is a Button label). The same word as the page or section it leads to, and the same term in the header, the breadcrumb and a sub-nav. Sentence case, no trailing punctuation. Single line, truncated; about 20 characters as guidance. A screen reader hears the whole label, the eye only the part that fits. Responsive collapse drops the icon, never the word, so the label alone must be self-explanatory.
|
|
137
|
+
|
|
138
|
+
Canonical labels:
|
|
139
|
+
|
|
140
|
+
<table>
|
|
141
|
+
<thead>
|
|
142
|
+
<tr><th>Label</th><th>Not</th></tr>
|
|
143
|
+
</thead>
|
|
144
|
+
<tbody>
|
|
145
|
+
<tr><td>Přehled</td><td></td></tr>
|
|
146
|
+
<tr><td>Faktury</td><td>Zobrazit faktury</td></tr>
|
|
147
|
+
<tr><td>Výdaje</td><td>Přejít na výdaje</td></tr>
|
|
148
|
+
<tr><td>Kontakty</td><td>Kontakty: / KONTAKTY</td></tr>
|
|
149
|
+
</tbody>
|
|
150
|
+
</table>
|
|
151
|
+
|
|
152
|
+
## Usage
|
|
153
|
+
|
|
154
|
+
<Canvas of={NavLinkStories.Navigation} />
|
|
155
|
+
|
|
156
|
+
<Canvas of={NavLinkStories.LongLabel} />
|
|
157
|
+
|
|
158
|
+
```tsx
|
|
159
|
+
import { NavLink } from '@invoiceonline/ui-react';
|
|
160
|
+
|
|
161
|
+
// Good — a header menu: the parent sets one gap, the open route carries aria-current
|
|
162
|
+
<nav aria-label="Hlavní navigace">
|
|
163
|
+
<ul className="flex items-center gap-500">
|
|
164
|
+
<li><NavLink href="#" leadingIcon="house">Přehled</NavLink></li>
|
|
165
|
+
<li><NavLink href="#" leadingIcon="invoice-new" aria-current="page">Faktury</NavLink></li>
|
|
166
|
+
<li><NavLink href="#" leadingIcon="expense">Výdaje</NavLink></li>
|
|
167
|
+
<li><NavLink href="#" leadingIcon="address-book">Kontakty</NavLink></li>
|
|
168
|
+
</ul>
|
|
169
|
+
</nav>
|
|
170
|
+
|
|
171
|
+
// Good — after the first collapse step: icons off, labels stay
|
|
172
|
+
<NavLink href="#" showIcon={false} aria-current="page">Faktury</NavLink>
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
```tsx
|
|
176
|
+
// Don't — padding on the link to space the items out (the parent's gap does that)
|
|
177
|
+
<NavLink href="#" className="px-500">Faktury</NavLink>
|
|
178
|
+
|
|
179
|
+
// Don't — an action dressed as a nav item
|
|
180
|
+
<NavLink href="#" onClick={createInvoice}>Vystavit fakturu</NavLink> // → <Button>
|
|
181
|
+
|
|
182
|
+
// Don't — a verb phrase as the label
|
|
183
|
+
<NavLink href="#">Zobrazit faktury</NavLink> // → „Faktury“
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
## Related
|
|
187
|
+
|
|
188
|
+
- [`Button`](?path=/docs/design-system-atoms-button--docs) — an action with chrome; NavLink is wayfinding, not an action.
|
|
189
|
+
- [`TextLink`](?path=/docs/design-system-atoms-textlink--docs) — footer and in-prose links.
|
|
190
|
+
- [`IconButton`](?path=/docs/design-system-atoms-iconbutton--docs) — the icon-only control.
|
|
191
|
+
- [`Icon`](?path=/docs/design-system-atoms-icon--docs) — the decorative glyph rendered by `leadingIcon`.
|
|
192
|
+
- Spec: `spec/03-atoms/nav-link.md` + `nav-link.manifest.json`.
|
|
193
|
+
|
|
194
|
+
## Migration notes
|
|
195
|
+
|
|
196
|
+
Not applicable: the component was built against manifest `1.4.4` and has not been rebuilt against another version.
|
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
2
|
+
import { expect, userEvent, within } from 'storybook/test';
|
|
3
|
+
import { NavLink } from './NavLink';
|
|
4
|
+
import { Section, Showcase } from '../../storybook/Section';
|
|
5
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
6
|
+
|
|
7
|
+
/** `axes.state` of the manifest. Hover is `:hover`, Current is `aria-current`, never a prop. */
|
|
8
|
+
const STATES = ['default', 'hover', 'current', 'disabled'] as const;
|
|
9
|
+
/** The `Show icon` boolean. */
|
|
10
|
+
const SHOW_ICON = [true, false] as const;
|
|
11
|
+
/** The manifest's own example destinations. */
|
|
12
|
+
const ITEMS = [
|
|
13
|
+
{ label: 'Přehled', icon: 'house' },
|
|
14
|
+
{ label: 'Faktury', icon: 'invoice-new' },
|
|
15
|
+
{ label: 'Výdaje', icon: 'expense' },
|
|
16
|
+
{ label: 'Kontakty', icon: 'address-book' },
|
|
17
|
+
] as const;
|
|
18
|
+
/** A secondary menu with one item that is not available. */
|
|
19
|
+
const SECONDARY_ITEMS = [
|
|
20
|
+
{ label: 'Nastavení', disabled: false },
|
|
21
|
+
{ label: 'Zprávy', disabled: true },
|
|
22
|
+
{ label: 'Nápověda', disabled: false },
|
|
23
|
+
] as const;
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Bare twins of NavLink's own `hover:` classes, for the Hover row: the
|
|
27
|
+
* `--secondary-active` ink on the root and the muted `--outline-strong` bar. A
|
|
28
|
+
* docs cell cannot show them without a live pointer: Tailwind v4 wraps every
|
|
29
|
+
* `hover:` utility in `@media (hover: hover)`, which `storybook-addon-pseudo-states`
|
|
30
|
+
* does not rewrite. The ink keeps the component's `!` so tailwind-merge replaces
|
|
31
|
+
* the resting `!text-secondary` instead of losing to it.
|
|
32
|
+
*/
|
|
33
|
+
const FORCE_HOVER = '!text-secondary-active [&>[data-fods-part=indicator]]:bg-outline-strong';
|
|
34
|
+
/** Bare twin of the `focus-visible:` ring (manifest `focus`: offset, `--outline-focus`, 2px). */
|
|
35
|
+
const FORCE_RING = 'outline outline-200 outline-outline-focus outline-offset-2';
|
|
36
|
+
|
|
37
|
+
const meta = {
|
|
38
|
+
title: 'Design System/Atoms/NavLink',
|
|
39
|
+
component: NavLink,
|
|
40
|
+
parameters: {
|
|
41
|
+
layout: 'centered',
|
|
42
|
+
docs: {
|
|
43
|
+
description: {
|
|
44
|
+
component: componentDoc({
|
|
45
|
+
summary:
|
|
46
|
+
'One item of a navigation group: a ghost link in the `--secondary` blue with an optional leading icon and a 2px indicator bar at its bottom edge. It marks where you are (the Current state, `aria-current="page"`), not what you trigger.',
|
|
47
|
+
useCases: [
|
|
48
|
+
'The header menu, section tabs, a sub-nav',
|
|
49
|
+
'`aria-current="page"` on the item of the open route paints the Current state: the active ink plus the indicator bar',
|
|
50
|
+
'`showIcon={false}` drops the leading icon; it is what the responsive-collapse controller turns off first, the label stays',
|
|
51
|
+
],
|
|
52
|
+
bestPractices: [
|
|
53
|
+
'The parent menu sets the spacing between items with one `gap`; the link itself has no side padding',
|
|
54
|
+
'The label is a short destination noun and the accessible name; the icon and the bar are decorative',
|
|
55
|
+
'Never signal Current by colour alone: the bar is the non-colour cue',
|
|
56
|
+
'Not for actions (`Button`) or footer and in-prose links (`TextLink`)',
|
|
57
|
+
],
|
|
58
|
+
knownIssues: [
|
|
59
|
+
'The bar is `--border-width-200` tall, and the theme has no height utility for a border-width token, so it is drawn as a transparent `border-b-200` on an empty span whose background carries the state colour',
|
|
60
|
+
],
|
|
61
|
+
docsLink: {
|
|
62
|
+
label: 'spec/03-atoms/nav-link.md',
|
|
63
|
+
},
|
|
64
|
+
}),
|
|
65
|
+
},
|
|
66
|
+
},
|
|
67
|
+
},
|
|
68
|
+
} satisfies Meta<typeof NavLink>;
|
|
69
|
+
|
|
70
|
+
export default meta;
|
|
71
|
+
type Story = StoryObj<typeof meta>;
|
|
72
|
+
|
|
73
|
+
export const Playground: Story = {
|
|
74
|
+
args: {
|
|
75
|
+
children: 'Faktury',
|
|
76
|
+
href: '#',
|
|
77
|
+
leadingIcon: 'house',
|
|
78
|
+
showIcon: true,
|
|
79
|
+
disabled: false,
|
|
80
|
+
'aria-current': undefined,
|
|
81
|
+
},
|
|
82
|
+
argTypes: {
|
|
83
|
+
href: { control: 'text' },
|
|
84
|
+
leadingIcon: { control: 'select', options: ITEMS.map(item => item.icon) },
|
|
85
|
+
showIcon: { control: 'boolean' },
|
|
86
|
+
disabled: { control: 'boolean' },
|
|
87
|
+
'aria-current': { control: 'select', options: [undefined, 'page'] },
|
|
88
|
+
},
|
|
89
|
+
};
|
|
90
|
+
|
|
91
|
+
/** Static props per state row. Hover is a forced class pair, never a prop. */
|
|
92
|
+
function stateProps(state: (typeof STATES)[number]) {
|
|
93
|
+
switch (state) {
|
|
94
|
+
case 'hover':
|
|
95
|
+
return { className: FORCE_HOVER };
|
|
96
|
+
case 'current':
|
|
97
|
+
return { 'aria-current': 'page' as const };
|
|
98
|
+
case 'disabled':
|
|
99
|
+
return { disabled: true };
|
|
100
|
+
default:
|
|
101
|
+
return {};
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
export const Matrix: Story = {
|
|
106
|
+
args: { children: 'Faktury', href: '#' },
|
|
107
|
+
parameters: {
|
|
108
|
+
docs: {
|
|
109
|
+
description: {
|
|
110
|
+
story:
|
|
111
|
+
'Every state of the manifest, with and without the icon. Default `--secondary`; Hover `--secondary-active` with the muted `--outline-strong` bar; Current `--secondary-active` with the `--secondary-active` bar; Disabled `--disabled-foreground`, no bar. The bar spans the whole content row, so it shrinks to the label when the icon is off. Focus is the cross-cutting ring, not a state of the axis: `--outline-focus`, 2px outside. Hover and Focus are drawn by bare twins of the component\'s own classes, so the grid shows them without a pointer or a keyboard.',
|
|
112
|
+
},
|
|
113
|
+
},
|
|
114
|
+
},
|
|
115
|
+
render: () => (
|
|
116
|
+
<Showcase>
|
|
117
|
+
{STATES.map(state => (
|
|
118
|
+
<Section key={state} title={state}>
|
|
119
|
+
{SHOW_ICON.map(showIcon => (
|
|
120
|
+
<NavLink key={String(showIcon)} href="#" showIcon={showIcon} {...stateProps(state)}>
|
|
121
|
+
Faktury
|
|
122
|
+
</NavLink>
|
|
123
|
+
))}
|
|
124
|
+
</Section>
|
|
125
|
+
))}
|
|
126
|
+
<Section title="focus">
|
|
127
|
+
{SHOW_ICON.map(showIcon => (
|
|
128
|
+
<NavLink key={String(showIcon)} href="#" showIcon={showIcon} className={FORCE_RING}>
|
|
129
|
+
Faktury
|
|
130
|
+
</NavLink>
|
|
131
|
+
))}
|
|
132
|
+
</Section>
|
|
133
|
+
</Showcase>
|
|
134
|
+
),
|
|
135
|
+
};
|
|
136
|
+
|
|
137
|
+
export const Navigation: Story = {
|
|
138
|
+
args: { children: 'Přehled', href: '#' },
|
|
139
|
+
parameters: {
|
|
140
|
+
docs: {
|
|
141
|
+
description: {
|
|
142
|
+
story:
|
|
143
|
+
'A header menu: the parent sets one `gap` and the items carry no side padding. The open route carries `aria-current="page"`. Below, the same menu after the first step of responsive collapse: the icons are gone, the labels stay, and the gap steps up from `--space-500` to `--space-600` so the links do not read as one line (spec/06-patterns/responsive-collapse.md). Last, a secondary menu with one disabled item: it has no href, no `aria-current` and is skipped by Tab.',
|
|
144
|
+
},
|
|
145
|
+
},
|
|
146
|
+
},
|
|
147
|
+
render: () => (
|
|
148
|
+
<Showcase>
|
|
149
|
+
<Section title="With icons">
|
|
150
|
+
<nav aria-label="Hlavní navigace">
|
|
151
|
+
<ul className="flex items-center gap-500">
|
|
152
|
+
{ITEMS.map((item, index) => (
|
|
153
|
+
<li key={item.label}>
|
|
154
|
+
<NavLink href="#" leadingIcon={item.icon} aria-current={index === 1 ? 'page' : undefined}>
|
|
155
|
+
{item.label}
|
|
156
|
+
</NavLink>
|
|
157
|
+
</li>
|
|
158
|
+
))}
|
|
159
|
+
</ul>
|
|
160
|
+
</nav>
|
|
161
|
+
</Section>
|
|
162
|
+
<Section title="Collapsed: icons off">
|
|
163
|
+
<nav aria-label="Sbalená navigace">
|
|
164
|
+
<ul className="flex items-center gap-600">
|
|
165
|
+
{ITEMS.map((item, index) => (
|
|
166
|
+
<li key={item.label}>
|
|
167
|
+
<NavLink href="#" leadingIcon={item.icon} showIcon={false} aria-current={index === 1 ? 'page' : undefined}>
|
|
168
|
+
{item.label}
|
|
169
|
+
</NavLink>
|
|
170
|
+
</li>
|
|
171
|
+
))}
|
|
172
|
+
</ul>
|
|
173
|
+
</nav>
|
|
174
|
+
</Section>
|
|
175
|
+
<Section title="With a disabled item">
|
|
176
|
+
<nav aria-label="Vedlejší navigace">
|
|
177
|
+
<ul className="flex items-center gap-600">
|
|
178
|
+
{SECONDARY_ITEMS.map(item => (
|
|
179
|
+
<li key={item.label}>
|
|
180
|
+
<NavLink href="#" showIcon={false} disabled={item.disabled}>
|
|
181
|
+
{item.label}
|
|
182
|
+
</NavLink>
|
|
183
|
+
</li>
|
|
184
|
+
))}
|
|
185
|
+
</ul>
|
|
186
|
+
</nav>
|
|
187
|
+
</Section>
|
|
188
|
+
</Showcase>
|
|
189
|
+
),
|
|
190
|
+
play: async ({ canvasElement }) => {
|
|
191
|
+
const canvas = within(canvasElement);
|
|
192
|
+
const main = within(canvas.getByRole('navigation', { name: 'Hlavní navigace' }));
|
|
193
|
+
const first = main.getByRole('link', { name: 'Přehled' });
|
|
194
|
+
|
|
195
|
+
// Tab reaches the first link and draws the real :focus-visible ring
|
|
196
|
+
// (manifest focus: offset style, 2px outside).
|
|
197
|
+
await userEvent.tab();
|
|
198
|
+
await expect(first).toHaveFocus();
|
|
199
|
+
const ring = getComputedStyle(first);
|
|
200
|
+
await expect(ring.outlineStyle).not.toBe('none');
|
|
201
|
+
// fods-lint-disable-next-line px — asserts the computed offset of manifest focus.offset (2px); the computed value is a px string, not a token
|
|
202
|
+
await expect(ring.outlineOffset).toBe('2px');
|
|
203
|
+
|
|
204
|
+
// Tab skips the disabled item of the secondary menu.
|
|
205
|
+
const secondary = within(canvas.getByRole('navigation', { name: 'Vedlejší navigace' }));
|
|
206
|
+
const before = secondary.getByRole('link', { name: 'Nastavení' });
|
|
207
|
+
const disabled = secondary.getByRole('link', { name: 'Zprávy' });
|
|
208
|
+
const after = secondary.getByRole('link', { name: 'Nápověda' });
|
|
209
|
+
await expect(disabled).toHaveAttribute('aria-disabled', 'true');
|
|
210
|
+
await expect(disabled).not.toHaveAttribute('href');
|
|
211
|
+
for (let i = 0; i < 20 && document.activeElement !== before; i++) await userEvent.tab();
|
|
212
|
+
await expect(before).toHaveFocus();
|
|
213
|
+
await userEvent.tab();
|
|
214
|
+
await expect(after).toHaveFocus();
|
|
215
|
+
await expect(disabled).not.toHaveFocus();
|
|
216
|
+
},
|
|
217
|
+
};
|
|
218
|
+
|
|
219
|
+
export const LongLabel: Story = {
|
|
220
|
+
args: { children: 'Nastavení oznámení', href: '#' },
|
|
221
|
+
parameters: {
|
|
222
|
+
docs: {
|
|
223
|
+
description: {
|
|
224
|
+
story:
|
|
225
|
+
'A label wider than its slot: each link sits in a cell `--space-1300` wide. The label stays on one line (manifest `text.label`) and truncates with an ellipsis, and the bar spans the whole link, so it still marks the Current item at the cell\'s width; with the icon on, the glyph and the gap leave the label less room. Twenty characters is the guidance for a label.',
|
|
226
|
+
},
|
|
227
|
+
},
|
|
228
|
+
},
|
|
229
|
+
render: args => (
|
|
230
|
+
<Showcase>
|
|
231
|
+
<Section title="With icon">
|
|
232
|
+
<div className="w-1300 shrink-0">
|
|
233
|
+
<NavLink {...args} aria-current="page" />
|
|
234
|
+
</div>
|
|
235
|
+
</Section>
|
|
236
|
+
<Section title="Icon off">
|
|
237
|
+
<div className="w-1300 shrink-0">
|
|
238
|
+
<NavLink {...args} aria-current="page" showIcon={false} />
|
|
239
|
+
</div>
|
|
240
|
+
</Section>
|
|
241
|
+
</Showcase>
|
|
242
|
+
),
|
|
243
|
+
};
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
// The configured `tv`: its extended tailwind-merge knows that `text-body-*` is a
|
|
4
|
+
// font-size and `text-secondary` a colour, so the two do not annihilate each other.
|
|
5
|
+
import { tv, type VariantProps } from '../../internal/tailwind-variants';
|
|
6
|
+
import { Icon, type IconName } from '../icon/Icon';
|
|
7
|
+
import { cn, suppressDisabledClick } from '../../internal/utils';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* NavLink — one item of a navigation group: the header menu, section tabs, a sub-nav
|
|
11
|
+
* (ui-system atom `nav-link`, manifest 1.4.4, Figma node 6173-36717). A ghost link in
|
|
12
|
+
* the `--secondary` blue with an optional decorative leading icon and a 2px indicator
|
|
13
|
+
* bar at its bottom edge. It marks WHERE you are, not what you trigger: an action is a
|
|
14
|
+
* `Button`, a footer or in-prose link a `TextLink`, an icon-only control an `IconButton`.
|
|
15
|
+
*
|
|
16
|
+
* Token bindings (manifest `families[0].states`, `indicator`, `sizes[0]`, `focus`,
|
|
17
|
+
* `typography.runs.label`):
|
|
18
|
+
* - ink (label + icon): default `--secondary`; hover and current `--secondary-active`;
|
|
19
|
+
* disabled `--disabled-foreground`. The icon draws in `currentColor`, so it follows
|
|
20
|
+
* the root's ink.
|
|
21
|
+
* - indicator bar: hover `--outline-strong` (the muted preview), current
|
|
22
|
+
* `--secondary-active`; nothing on default and disabled. Height `--border-width-200`
|
|
23
|
+
* (see note 1).
|
|
24
|
+
* - size M: row height 40 (`min-h-1000`, the `--space-1000` step, as Button md); gap
|
|
25
|
+
* `--space-400`; icon `--size-icon`; radius `--radius-200`; no side padding at all
|
|
26
|
+
* (manifest notes[0]: the spacing between items is the parent menu's `gap`).
|
|
27
|
+
* - label: Body/M (`text-body-base`), `--font-weight-semibold`, one line, truncated.
|
|
28
|
+
* - focus: additive `--outline-focus` ring on `:focus-visible`, `--border-width-200`,
|
|
29
|
+
* 2px outside. On the `--radius-200` root a 2px offset draws the ring at 6px, which
|
|
30
|
+
* is the `--radius-300` the manifest's `focus.note` asks for; no ink recolour.
|
|
31
|
+
*
|
|
32
|
+
* Notes worth knowing:
|
|
33
|
+
*
|
|
34
|
+
* 1. INDICATOR HEIGHT. The bar is `--border-width-200` tall, and the theme has no
|
|
35
|
+
* height utility that reads a border-width token (`--border-width-*` maps to
|
|
36
|
+
* border, outline and ring widths only). So the bar is an EMPTY absolutely
|
|
37
|
+
* positioned span whose only box is a transparent `border-b-200`: its height is
|
|
38
|
+
* exactly `--border-width-200`, and its `background-color` (which paints under a
|
|
39
|
+
* transparent border, `background-clip: border-box`) carries the state colour. The
|
|
40
|
+
* colour stays a fill, as the manifest's motion block describes it
|
|
41
|
+
* (`background-color is the 2px bottom indicator bar`).
|
|
42
|
+
* 2. CURRENT IS `aria-current`, NOT A PROP. The manifest maps `State=Current` to
|
|
43
|
+
* `aria-current="page"` (`properties[0].maps`), and the spec says "Drive Current
|
|
44
|
+
* from aria-current". So there is no `current` prop: pass `aria-current="page"` on
|
|
45
|
+
* the open route and the component reads it. Any value other than `false` /
|
|
46
|
+
* `"false"` counts, so `"location"` on a sub-nav paints the same cue the screen
|
|
47
|
+
* reader announces.
|
|
48
|
+
* 3. MOTION (manifest `motion.states`): ink and bar ease on `--easing-standard`, over
|
|
49
|
+
* `--duration-hover` for hover and `--duration-toggle` when the item becomes the
|
|
50
|
+
* current one. A CSS transition takes the duration of the state it is entering,
|
|
51
|
+
* so the current item carries `duration-toggle` and every other item
|
|
52
|
+
* `duration-hover`. These are colour fades, not movement, so they stay under
|
|
53
|
+
* `prefers-reduced-motion` as on Button and TextLink.
|
|
54
|
+
* 4. `!` ON THE INK. A consuming app may carry a global unlayered `a { color }` rule,
|
|
55
|
+
* which beats every layered colour utility on an anchor. The `!` forces only the
|
|
56
|
+
* precedence; the values are tokens. Same workaround as TextLink and Button.
|
|
57
|
+
*
|
|
58
|
+
* Semantics / a11y:
|
|
59
|
+
* - always a real `<a href>`; the label is the accessible name, the icon and the bar
|
|
60
|
+
* are decorative (`aria-hidden`).
|
|
61
|
+
* - `disabled` has no native equivalent on an anchor, so the href is dropped,
|
|
62
|
+
* `aria-disabled="true"` and `tabIndex={-1}` are set and clicks are suppressed in
|
|
63
|
+
* the CAPTURE phase (`suppressDisabledClick`, as TextLink does), so neither the
|
|
64
|
+
* consumer's `onClick` nor its `onClickCapture` runs. Dropping the href also drops
|
|
65
|
+
* the implicit `link` role, so `role="link"` is re-stated while disabled (TextLink
|
|
66
|
+
* does the same). A disabled item renders no `aria-current`: it shows no current
|
|
67
|
+
* cue, so the screen reader is not told "current page" either. While `disabled` is
|
|
68
|
+
* false, a consumer's own `aria-disabled` passes through untouched.
|
|
69
|
+
* - forced colours: the bar is a transparent border painted by its background, which
|
|
70
|
+
* forced-colors mode repaints as one system colour on every item, so the bar is
|
|
71
|
+
* `invisible` there except on the current item. The ink is forced to one system
|
|
72
|
+
* colour on every item too, so the bar is what keeps Current visible.
|
|
73
|
+
*/
|
|
74
|
+
const navLinkVariants = tv({
|
|
75
|
+
slots: {
|
|
76
|
+
root: [
|
|
77
|
+
// `relative`: the indicator bar is positioned against the root. `group`: the
|
|
78
|
+
// bar's hover preview is driven by the pointer anywhere on the link.
|
|
79
|
+
'group relative inline-flex min-w-0 max-w-full items-center',
|
|
80
|
+
// sizes[0] (M): 40 tap-target row, --space-400 icon↔label gap, --size-icon
|
|
81
|
+
// glyph, --radius-200. No padding-inline: spacing is the parent's gap.
|
|
82
|
+
'min-h-1000 gap-400 rounded-200 [&_.icon]:size-icon',
|
|
83
|
+
'font-inter cursor-pointer !no-underline hover:!no-underline',
|
|
84
|
+
'!text-secondary hover:!text-secondary-active',
|
|
85
|
+
'transition-[color] duration-hover ease-standard',
|
|
86
|
+
// Additive offset outline per focus-ring.md (manifest focus: style offset,
|
|
87
|
+
// --outline-focus, 2px). Never removed, no ink change.
|
|
88
|
+
'focus-visible:outline focus-visible:outline-200 focus-visible:outline-outline-focus focus-visible:outline-offset-2',
|
|
89
|
+
],
|
|
90
|
+
icon: 'shrink-0',
|
|
91
|
+
// typography.runs.label: Body/M, semibold, and the style's --text-wrap-body.
|
|
92
|
+
// text.label: one line, truncated. The wrap token goes on the `text-wrap-style`
|
|
93
|
+
// longhand on purpose: the `text-wrap` shorthand also sets `text-wrap-mode`
|
|
94
|
+
// and could undo the `nowrap` that `truncate` depends on.
|
|
95
|
+
label: 'min-w-0 truncate text-body-base font-semibold [text-wrap-style:var(--text-wrap-body)]',
|
|
96
|
+
// The bar: see JSDoc note 1. Spans the root, which has no side padding, so it
|
|
97
|
+
// covers the full content row (icon + gap + label, or the label alone).
|
|
98
|
+
indicator: [
|
|
99
|
+
'pointer-events-none absolute bottom-0 left-0 right-0',
|
|
100
|
+
'border-b-200 border-transparent',
|
|
101
|
+
'transition-[background-color] duration-hover ease-standard',
|
|
102
|
+
// Forced colours: only the current bar stays (see Semantics / a11y).
|
|
103
|
+
'forced-colors:invisible',
|
|
104
|
+
],
|
|
105
|
+
},
|
|
106
|
+
variants: {
|
|
107
|
+
current: {
|
|
108
|
+
true: {
|
|
109
|
+
root: '!text-secondary-active duration-toggle',
|
|
110
|
+
indicator: 'bg-secondary-active duration-toggle forced-colors:visible',
|
|
111
|
+
},
|
|
112
|
+
// Only a link that is not the current one previews the bar on hover.
|
|
113
|
+
false: { indicator: 'group-hover:bg-outline-strong' },
|
|
114
|
+
},
|
|
115
|
+
/**
|
|
116
|
+
* Declared after `current` so tailwind-merge keeps the disabled ink. The root
|
|
117
|
+
* takes no pointer events, so neither the hover ink nor the hover bar can fire.
|
|
118
|
+
* No `cursor-not-allowed`: it would sit on an element that ignores the pointer.
|
|
119
|
+
*/
|
|
120
|
+
disabled: {
|
|
121
|
+
true: {
|
|
122
|
+
root: 'pointer-events-none !text-disabled-foreground hover:!text-disabled-foreground',
|
|
123
|
+
},
|
|
124
|
+
false: {},
|
|
125
|
+
},
|
|
126
|
+
},
|
|
127
|
+
defaultVariants: {
|
|
128
|
+
current: false,
|
|
129
|
+
disabled: false,
|
|
130
|
+
},
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
export type NavLinkCurrent = React.AriaAttributes['aria-current'];
|
|
134
|
+
|
|
135
|
+
export interface NavLinkProps
|
|
136
|
+
extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'href'>,
|
|
137
|
+
Omit<VariantProps<typeof navLinkVariants>, 'current' | 'disabled'> {
|
|
138
|
+
/** The destination. A nav item is always a real `<a href>`. */
|
|
139
|
+
href: string;
|
|
140
|
+
/**
|
|
141
|
+
* `"page"` on the item of the open route: the Current state, with the indicator
|
|
142
|
+
* bar. The component reads it, there is no separate `current` prop. Not rendered
|
|
143
|
+
* while `disabled`.
|
|
144
|
+
*/
|
|
145
|
+
'aria-current'?: NavLinkCurrent;
|
|
146
|
+
/** Leading glyph (manifest `slots.leading-icon`, default `house`). Decorative. */
|
|
147
|
+
leadingIcon?: IconName;
|
|
148
|
+
/**
|
|
149
|
+
* Show the leading icon. The responsive-collapse controller turns it off first;
|
|
150
|
+
* the label always stays.
|
|
151
|
+
*/
|
|
152
|
+
showIcon?: boolean;
|
|
153
|
+
/**
|
|
154
|
+
* Not actionable: `--disabled-foreground`, no href, `aria-disabled`, out of the tab
|
|
155
|
+
* order, no `aria-current`.
|
|
156
|
+
*/
|
|
157
|
+
disabled?: boolean;
|
|
158
|
+
/** The destination's name: a short noun, which is also the accessible name. */
|
|
159
|
+
children: React.ReactNode;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function isCurrentValue(value: NavLinkCurrent): boolean {
|
|
163
|
+
return value != null && value !== false && value !== 'false';
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
const NavLink = React.forwardRef<HTMLAnchorElement, NavLinkProps>(
|
|
167
|
+
(
|
|
168
|
+
{
|
|
169
|
+
className,
|
|
170
|
+
href,
|
|
171
|
+
leadingIcon = 'house',
|
|
172
|
+
showIcon = true,
|
|
173
|
+
disabled = false,
|
|
174
|
+
'aria-current': ariaCurrent,
|
|
175
|
+
onClick,
|
|
176
|
+
onClickCapture,
|
|
177
|
+
'aria-disabled': ariaDisabled,
|
|
178
|
+
children,
|
|
179
|
+
...props
|
|
180
|
+
},
|
|
181
|
+
ref,
|
|
182
|
+
) => {
|
|
183
|
+
// A disabled item shows no current cue (the manifest has no Disabled + Current
|
|
184
|
+
// cell), and so does not announce one: `aria-current` is dropped with it.
|
|
185
|
+
const current = isCurrentValue(ariaCurrent) && !disabled;
|
|
186
|
+
const slots = navLinkVariants({ current, disabled });
|
|
187
|
+
|
|
188
|
+
// `data-fods-*` before the spread (a host may re-label the element as its own
|
|
189
|
+
// part); the behavioural props after it, so a consumer cannot shadow them.
|
|
190
|
+
return (
|
|
191
|
+
<a
|
|
192
|
+
ref={ref}
|
|
193
|
+
// data-fods-part marks the component's parts for measurement in the browser.
|
|
194
|
+
// Not inert in this package: `styles/base.css` scopes its reset to these attributes.
|
|
195
|
+
data-fods-component="nav-link"
|
|
196
|
+
data-fods-part="root"
|
|
197
|
+
{...props}
|
|
198
|
+
href={disabled ? undefined : href}
|
|
199
|
+
aria-current={disabled ? undefined : ariaCurrent}
|
|
200
|
+
// Without an href the anchor is a generic element, on which `aria-disabled`
|
|
201
|
+
// announces nothing, so the role is re-stated while disabled.
|
|
202
|
+
role={disabled ? 'link' : props.role}
|
|
203
|
+
aria-disabled={disabled ? true : ariaDisabled}
|
|
204
|
+
tabIndex={disabled ? -1 : props.tabIndex}
|
|
205
|
+
// While disabled the click is cancelled in the CAPTURE phase, as TextLink does,
|
|
206
|
+
// and the consumer's own handlers are dropped: there is nothing left for them.
|
|
207
|
+
onClick={disabled ? undefined : onClick}
|
|
208
|
+
onClickCapture={disabled ? suppressDisabledClick : onClickCapture}
|
|
209
|
+
className={cn(slots.root(), className)}
|
|
210
|
+
>
|
|
211
|
+
{showIcon && <Icon name={leadingIcon} data-fods-part="leading-icon" className={slots.icon()} />}
|
|
212
|
+
<span data-fods-part="label" className={slots.label()}>
|
|
213
|
+
{children}
|
|
214
|
+
</span>
|
|
215
|
+
<span data-fods-part="indicator" aria-hidden="true" className={slots.indicator()} />
|
|
216
|
+
</a>
|
|
217
|
+
);
|
|
218
|
+
},
|
|
219
|
+
);
|
|
220
|
+
NavLink.displayName = 'NavLink';
|
|
221
|
+
|
|
222
|
+
export { NavLink, navLinkVariants };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { NavLink, navLinkVariants, type NavLinkProps, type NavLinkCurrent } from './NavLink';
|