@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,381 @@
|
|
|
1
|
+
import { Meta, Canvas } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as AnchoredPanelStories from './AnchoredPanel.stories';
|
|
3
|
+
|
|
4
|
+
<Meta of={AnchoredPanelStories} tags={['autodocs']} />
|
|
5
|
+
|
|
6
|
+
# Anchored Panel
|
|
7
|
+
|
|
8
|
+
## Metadata
|
|
9
|
+
|
|
10
|
+
- **Layer:** pattern — the shared panel **substrate** (`useAnchoredPanel` hook + `AnchoredPanel` composition helper). **Not a design-system entity:** no manifest, no Figma component, no `variant` axis.
|
|
11
|
+
- **Status:** draft
|
|
12
|
+
- **Manifest version:** not applicable — a pattern substrate. The manifested pieces composed into it carry their own versions (`list-row` 2.4.2, `divider` 1.4.0, `text-link` 1.11.2).
|
|
13
|
+
- **Behaviour engine:** [`@floating-ui/react`](https://floating-ui.com/docs/react) — `useFloating` + `offset` / `flip` / `shift` / `size`, `useListNavigation`, `useTypeahead`, `useClick`, `useDismiss`, `useRole`, `useTransitionStyles`, `FloatingPortal`, `FloatingFocusManager`
|
|
14
|
+
- **Tokens used:** `--bg-primary`, `--border-width-100`, `--font-size-xs`, `--font-weight-normal`, `--leading-loose`, `--outline-default`, `--radius-500`, `--shadow-overlay`, `--space-200`, `--space-400`, `--space-600`, `--space-700`, `--text-secondary`, `--z-index-dropdown`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
**Anchored Panel** is the layer every trigger-anchored floating panel sits on: it owns **where the
|
|
19
|
+
panel is**, **when it closes**, **how it animates**, **how wide / tall it may get**, and **how a list
|
|
20
|
+
cursor moves** — and nothing else. `useAnchoredPanel` produces that behaviour, `AnchoredPanel`
|
|
21
|
+
renders the portal plus the four nested elements the [popover surface](?path=/docs/design-system-patterns-popover-surface--docs)
|
|
22
|
+
recipe describes.
|
|
23
|
+
|
|
24
|
+
Use it when you are **building a new panel** in the Menu / Select / Combobox / Popover family, or need
|
|
25
|
+
an **arbitrary-content** popover (filter set, column chooser) that has no organism yet. Do **not**
|
|
26
|
+
reach for it to place a menu or a select on a screen — those already exist as
|
|
27
|
+
[`Menu`](?path=/docs/design-system-organisms-menu--docs) and
|
|
28
|
+
[`Select`](?path=/docs/design-system-organisms-select--docs). And do not use it for a **modal**: a
|
|
29
|
+
Modal's position is not derived from a trigger, which is the invariant "anchored" names.
|
|
30
|
+
|
|
31
|
+
"Anchored" is the spec's own word for these surfaces, and it is deliberately **not** "dropdown" — a
|
|
32
|
+
dropdown is a motion, not a function. A Select's panel is not a "dropdown" to its caller.
|
|
33
|
+
|
|
34
|
+
## Rationale
|
|
35
|
+
|
|
36
|
+
The same drop-down motion hides five widgets with **incompatible ARIA roles and keyboard contracts**,
|
|
37
|
+
so the design system ships **no** `Dropdown` component with a `variant="menu|select|combobox"` axis —
|
|
38
|
+
that would merge three keyboard models into one inaccessible widget
|
|
39
|
+
(`spec/04-molecules/_menu-family-planning.md`
|
|
40
|
+
§ Core principle). Consolidation therefore happens **one layer lower**, and this is that layer.
|
|
41
|
+
|
|
42
|
+
<table>
|
|
43
|
+
<thead>
|
|
44
|
+
<tr><th>Layer</th><th>Where</th><th>Owns</th></tr>
|
|
45
|
+
</thead>
|
|
46
|
+
<tbody>
|
|
47
|
+
<tr><td>1. chrome</td><td><code>popoverSurface.ts</code> (recipe)</td><td>Token bindings — fill, border, radius, shadow, z-index, symmetric padding, group inset</td></tr>
|
|
48
|
+
<tr><td>2. behaviour</td><td><code>useAnchoredPanel</code> (hook)</td><td>Positioning, collision flip / shift, width + height policy, dismissal, focus return, transition, list cursor, typeahead</td></tr>
|
|
49
|
+
<tr><td>2b. structure</td><td><code>AnchoredPanel</code> (helper)</td><td>Portal + the four nested elements of the recipe; header / footer outside the scroll region; the <code>z-dropdown</code> step on the positioned wrapper</td></tr>
|
|
50
|
+
<tr><td>3. semantics</td><td>the <strong>organism</strong></td><td><code>role</code>, the keyboard contract, the selection model, what a row means</td></tr>
|
|
51
|
+
</tbody>
|
|
52
|
+
</table>
|
|
53
|
+
|
|
54
|
+
Layer 3 is deliberately absent here: `AnchoredPanel` carries **no `role` and no `aria-*`** of its
|
|
55
|
+
own. That is why it may never grow a `type` / `variant` axis — the moment it does, it is the
|
|
56
|
+
`Dropdown` component the spec forbids.
|
|
57
|
+
|
|
58
|
+
## Anatomy
|
|
59
|
+
|
|
60
|
+
<Canvas of={AnchoredPanelStories.Anatomy} />
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
portal (FloatingPortal — escapes every overflow container)
|
|
64
|
+
└ positioning wrapper floatingStyles + width policy, tabIndex -1, no focus visual
|
|
65
|
+
└ surface popoverSurfaceVariants + enter/exit transition, role="none"
|
|
66
|
+
├ header ) outside the scroll region → sticky by construction
|
|
67
|
+
├ Divider ) the header's bottom rule — added by the panel, not the caller
|
|
68
|
+
├ body popoverBodyClass — the scroll region, max-height cap, role="none"
|
|
69
|
+
│ └ Group(s) AnchoredPanel.Group (--space-200 inset) + Divider siblings at 0 inset
|
|
70
|
+
└ Divider ) footer's top rule
|
|
71
|
+
└ footer ) outside the scroll region
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
- **Positioning wrapper** — absolutely positioned by floating-ui, focusable (`tabIndex={-1}`) so the
|
|
75
|
+
focus manager can land on it before the cursor reaches a row. It must **never** render a focus
|
|
76
|
+
visual: the ring belongs to the row (menu) or the trigger (select), never around a whole panel.
|
|
77
|
+
- **Surface** — the chrome recipe verbatim, plus the transition styles. `role="none"` keeps it out of
|
|
78
|
+
the a11y tree so the rows stay **owned children** of the organism's role (a `menu` counting
|
|
79
|
+
"1 of 4" must not see generic divs in between).
|
|
80
|
+
- **Header / footer** — passed as props, rendered **outside** the body, so they stay put while the
|
|
81
|
+
body scrolls. The panel adds the adjoining `Divider` itself: chrome seams are the surface's, not
|
|
82
|
+
the caller's. A seam is `aria-hidden`, since it is chrome rather than a group separator, and a
|
|
83
|
+
`listbox` panel may own only groups and options. A chrome link inside them is a [`TextLink`](?path=/docs/design-system-atoms-textlink--docs),
|
|
84
|
+
never a `ListRow` (see the [surface docs](?path=/docs/design-system-patterns-popover-surface--docs)).
|
|
85
|
+
- **Body** — the only scrolling element, `0` horizontal padding, so `Divider` siblings run full-bleed.
|
|
86
|
+
- **`AnchoredPanel.Group`** — the `--space-200` (4px) horizontal inset that holds a row's radius-8
|
|
87
|
+
highlight off the radius-12 panel corner. The inset lives on the group, never on the body.
|
|
88
|
+
|
|
89
|
+
## Variants
|
|
90
|
+
|
|
91
|
+
**None, by design** — no visual axis, no skin, no `type`. What the substrate does expose are three
|
|
92
|
+
**behaviour** axes the organism must choose explicitly:
|
|
93
|
+
|
|
94
|
+
<table>
|
|
95
|
+
<thead>
|
|
96
|
+
<tr><th><code>role</code></th><th><code>focusModel</code></th><th><code>widthPolicy</code></th><th>Typical organism</th></tr>
|
|
97
|
+
</thead>
|
|
98
|
+
<tbody>
|
|
99
|
+
<tr><td><code>menu</code></td><td><code>roving</code></td><td><code>content</code></td><td><a href="?path=/docs/design-system-organisms-menu--docs">Menu</a> — commands</td></tr>
|
|
100
|
+
<tr><td><code>listbox</code></td><td><code>virtual</code></td><td><code>trigger</code></td><td><a href="?path=/docs/design-system-organisms-select--docs">Select</a> / Combobox — values</td></tr>
|
|
101
|
+
<tr><td><code>group</code></td><td><code>virtual</code></td><td><code>content</code></td><td>Filter popover with checkboxes (role set via <code>panelProps</code>)</td></tr>
|
|
102
|
+
<tr><td><code>dialog</code></td><td><code>roving</code></td><td><code>content</code></td><td>Arbitrary content — the case with no organism yet (these stories)</td></tr>
|
|
103
|
+
</tbody>
|
|
104
|
+
</table>
|
|
105
|
+
|
|
106
|
+
**Focus model** — the one decision that cannot be got wrong:
|
|
107
|
+
|
|
108
|
+
<table>
|
|
109
|
+
<thead>
|
|
110
|
+
<tr><th>Model</th><th>DOM focus</th><th>Current row</th><th>Why</th></tr>
|
|
111
|
+
</thead>
|
|
112
|
+
<tbody>
|
|
113
|
+
<tr><td><code>virtual</code></td><td>stays on the <strong>trigger</strong></td><td><code>aria-activedescendant</code></td><td>A field trigger must keep focus so typing keeps working</td></tr>
|
|
114
|
+
<tr><td><code>roving</code></td><td>moves <strong>into the panel</strong></td><td>roving <code>tabindex</code> (exactly one row tabbable)</td><td>A command menu owns focus while open (APG)</td></tr>
|
|
115
|
+
</tbody>
|
|
116
|
+
</table>
|
|
117
|
+
|
|
118
|
+
`roving` wraps the panel in `FloatingFocusManager` (`modal={false}`, `initialFocus={0}`,
|
|
119
|
+
`returnFocus`). `initialFocus` must stay `>= 0`: a negative value means "ignore initial focus", which
|
|
120
|
+
leaves focus on the trigger and silently degrades a Menu into the Select's virtual model.
|
|
121
|
+
|
|
122
|
+
**Width policy** — `trigger` fills the trigger's width (a field's own drop-down must not be narrower
|
|
123
|
+
than the field); `content` hugs the longest row inside a min ~180 / max ~320 band (a kebab has no
|
|
124
|
+
meaningful width to fill).
|
|
125
|
+
|
|
126
|
+
## Matrix
|
|
127
|
+
|
|
128
|
+
Both matrices the substrate has, in one story. **Chrome × density** is the visual grid — which of the
|
|
129
|
+
two optional frames the panel carries, against the density — and it is rendered **inline, without the
|
|
130
|
+
portal**: eight live panels would cover one another, fight over initial focus on mount, and dismiss
|
|
131
|
+
together on the first outside click, so the grid would be unreadable. Each cell composes the very
|
|
132
|
+
parts `AnchoredPanel` composes, in the same order, so it cannot drift from the live panel above.
|
|
133
|
+
**Behaviour pairings** then renders the four sanctioned `role` × `focusModel` × `widthPolicy`
|
|
134
|
+
combinations as real, openable panels.
|
|
135
|
+
|
|
136
|
+
<Canvas of={AnchoredPanelStories.Matrix} />
|
|
137
|
+
|
|
138
|
+
Every knob is also live on its own in the
|
|
139
|
+
[Playground story](?path=/story/design-system-patterns-anchored-panel--playground) — `placement`
|
|
140
|
+
included, so you can push the panel towards a canvas edge and watch it flip.
|
|
141
|
+
|
|
142
|
+
## Sizes
|
|
143
|
+
|
|
144
|
+
<Canvas of={AnchoredPanelStories.Sizes} />
|
|
145
|
+
|
|
146
|
+
One density per panel, **one step below the trigger** that opened it. `size` lives on the **component
|
|
147
|
+
only** — it selects the row density and nothing else. The hook has no `size`: the body height cap is a
|
|
148
|
+
**row count** (8 rows of 40 plus the surface padding = 320) rather than a per-density height, so a Small
|
|
149
|
+
panel caps at the same 320 as a Medium one. The surface padding does not track density either — it is
|
|
150
|
+
a flat `--space-200` on both.
|
|
151
|
+
|
|
152
|
+
<table>
|
|
153
|
+
<thead>
|
|
154
|
+
<tr><th>Size</th><th>Surface padding</th><th>Row height</th><th>Body max-height</th></tr>
|
|
155
|
+
</thead>
|
|
156
|
+
<tbody>
|
|
157
|
+
<tr><td><code>md</code></td><td>4 / 4 (<code>--space-200</code>), 0 horizontal</td><td>40 (<code>ListRow md</code>)</td><td>320 px ≈ 8 rows</td></tr>
|
|
158
|
+
<tr><td><code>sm</code></td><td>4 / 4 (<code>--space-200</code>), 0 horizontal</td><td>36 (<code>ListRow sm</code>)</td><td>320 px ≈ 9 rows</td></tr>
|
|
159
|
+
</tbody>
|
|
160
|
+
</table>
|
|
161
|
+
|
|
162
|
+
## States
|
|
163
|
+
|
|
164
|
+
The substrate has no visual states of its own — a row's Hover / Highlighted / Selected belong to
|
|
165
|
+
[`ListRow`](?path=/docs/design-system-atoms-listrow--docs). What it does own is the panel's own
|
|
166
|
+
lifecycle:
|
|
167
|
+
|
|
168
|
+
- **Closed** — nothing in the DOM. `isMounted` is false, so the portal renders `null`.
|
|
169
|
+
- **Entering / exiting** — a 150 ms fade + 4px `translateY` (the `--duration-fast` class of motion).
|
|
170
|
+
`isMounted` stays true through the exit so the panel is not ripped out mid-frame.
|
|
171
|
+
- **Reduced motion** — under `prefers-reduced-motion: reduce` the slide and the duration are dropped
|
|
172
|
+
and only an instant fade remains. Read at **runtime** via `matchMedia`, because floating-ui applies
|
|
173
|
+
the transition as inline styles that a CSS media query cannot override.
|
|
174
|
+
- **Flipped / shifted** — on collision the panel flips above the trigger or shifts along it, keeping
|
|
175
|
+
8px of viewport padding clear. Position tracks scroll and resize (`autoUpdate`).
|
|
176
|
+
- **Capped / scrolled** — past the soft ~8–10-row cap the **body** scrolls; the panel never grows
|
|
177
|
+
past the viewport and the page behind it does not scroll. Header and footer stay put.
|
|
178
|
+
|
|
179
|
+
<Canvas of={AnchoredPanelStories.ScrollCap} />
|
|
180
|
+
|
|
181
|
+
## API
|
|
182
|
+
|
|
183
|
+
The substrate is a **hook + helper pair**, not a props-driven component, so there is no `<Controls />`
|
|
184
|
+
table: `AnchoredPanel`'s central prop is the hook's return value, which cannot be expressed as an arg.
|
|
185
|
+
The [Playground story](?path=/story/design-system-patterns-anchored-panel--playground) drives it
|
|
186
|
+
through a small stand-in panel instead, and puts every option below on a control.
|
|
187
|
+
|
|
188
|
+
### `useAnchoredPanel(options)`
|
|
189
|
+
|
|
190
|
+
<table>
|
|
191
|
+
<thead>
|
|
192
|
+
<tr><th>Option</th><th>Type</th><th>Default</th><th>Meaning</th></tr>
|
|
193
|
+
</thead>
|
|
194
|
+
<tbody>
|
|
195
|
+
<tr><td><code>open</code></td><td><code>boolean</code></td><td>—</td><td>Controlled open state; the organism owns it</td></tr>
|
|
196
|
+
<tr><td><code>onOpenChange</code></td><td><code>(open: boolean) => void</code></td><td>—</td><td>Open / close requested (click, dismiss, Esc)</td></tr>
|
|
197
|
+
<tr><td><code>role</code></td><td><code>'listbox' | 'menu' | 'group' | 'dialog'</code></td><td>—</td><td>Drives floating-ui's trigger↔panel ARIA pairing. <code>group</code> is not one floating-ui knows — there the organism sets the role itself via <code>panelProps</code></td></tr>
|
|
198
|
+
<tr><td><code>focusModel</code></td><td><code>'virtual' | 'roving'</code></td><td>—</td><td>Where DOM focus lives while open (see Variants)</td></tr>
|
|
199
|
+
<tr><td><code>widthPolicy</code></td><td><code>'trigger' | 'content'</code></td><td>—</td><td>Fill the trigger's width, or hug the content in the 180–320 band</td></tr>
|
|
200
|
+
<tr><td><code>itemCount</code></td><td><code>number</code></td><td>—</td><td>Documents the list length in one place; navigation itself is derived from <code>listRef</code></td></tr>
|
|
201
|
+
<tr><td><code>disabledIndices</code></td><td><code>number[]</code></td><td>—</td><td>Rows present but skipped by keyboard navigation</td></tr>
|
|
202
|
+
<tr><td><code>labels</code></td><td><code>Array<string | null></code></td><td><code>[]</code></td><td>Typeahead labels; <code>null</code> = a non-matchable row</td></tr>
|
|
203
|
+
<tr><td><code>selectedIndex</code></td><td><code>number | null</code></td><td><code>null</code></td><td>The persistently selected row, if the family has selection</td></tr>
|
|
204
|
+
<tr><td><code>typeahead</code></td><td><code>boolean</code></td><td><code>true</code></td><td>Type-to-jump</td></tr>
|
|
205
|
+
<tr><td><code>navigation</code></td><td><code>'list' | 'none'</code></td><td><code>'list'</code></td><td>Whether the content is a navigable list. <code>'none'</code> leaves the arrow keys, Home / End and typeahead to a content that owns its own keyboard model (the Date Picker grid)</td></tr>
|
|
206
|
+
<tr><td><code>placement</code></td><td><code>Placement</code></td><td><code>'bottom-start'</code></td><td>Preferred placement; flips on collision</td></tr>
|
|
207
|
+
</tbody>
|
|
208
|
+
</table>
|
|
209
|
+
|
|
210
|
+
Returned, in the order you normally wire it: `refs` (`setReference` → trigger, `setFloating` → panel),
|
|
211
|
+
`getReferenceProps` / `getFloatingProps` / `getItemProps`, `activeIndex` + `setActiveIndex`, `listRef`
|
|
212
|
+
(fill it with the row elements), `floatingStyles`, `transitionStyles`, `panelStyle`, `bodyStyle`,
|
|
213
|
+
`isMounted`, `context`, `close()` (closes **and** returns focus to the trigger), `isTypingRef`
|
|
214
|
+
(true while a typeahead query is in flight — lets the organism tell "Space selects" apart from
|
|
215
|
+
"Space is part of the query"), and `portalRoot` (the enclosing dialog, which `<AnchoredPanel>` portals
|
|
216
|
+
into; `undefined` outside a dialog).
|
|
217
|
+
|
|
218
|
+
### `<AnchoredPanel>`
|
|
219
|
+
|
|
220
|
+
<table>
|
|
221
|
+
<thead>
|
|
222
|
+
<tr><th>Prop</th><th>Type</th><th>Default</th><th>Meaning</th></tr>
|
|
223
|
+
</thead>
|
|
224
|
+
<tbody>
|
|
225
|
+
<tr><td><code>panel</code></td><td><code>UseAnchoredPanelReturn</code></td><td>—</td><td>The hook's return value</td></tr>
|
|
226
|
+
<tr><td><code>size</code></td><td><code>'md' | 'sm'</code></td><td><code>'md'</code></td><td>Density — the row height the panel is built for. Lives here only; the hook has no <code>size</code></td></tr>
|
|
227
|
+
<tr><td><code>focusModel</code></td><td><code>'virtual' | 'roving'</code></td><td>—</td><td><code>roving</code> wraps the panel in <code>FloatingFocusManager</code></td></tr>
|
|
228
|
+
<tr><td><code>panelProps</code></td><td><code>HTMLAttributes<HTMLDivElement></code></td><td>—</td><td>ARIA for the panel (<code>role</code>, <code>aria-label</code>, …). Required in practice — the substrate contributes no semantics</td></tr>
|
|
229
|
+
<tr><td><code>header</code> / <code>footer</code></td><td><code>ReactNode</code></td><td>—</td><td>Sticky content outside the scroll region; the panel adds the adjoining <code>Divider</code></td></tr>
|
|
230
|
+
<tr><td><code>children</code></td><td><code>ReactNode</code></td><td>—</td><td>Body — <code>AnchoredPanel.Group</code>s interleaved with <code>Divider</code> siblings</td></tr>
|
|
231
|
+
<tr><td><code>className</code></td><td><code>string</code></td><td>—</td><td>Extra classes on the surface element</td></tr>
|
|
232
|
+
</tbody>
|
|
233
|
+
</table>
|
|
234
|
+
|
|
235
|
+
`AnchoredPanel.Group` is a plain `div` with the group inset; it forwards its ref and every `div` prop.
|
|
236
|
+
It carries **no role by default, and usually none at all**: a `group` role is earned by its name
|
|
237
|
+
(`overlay-behavior.md` § A group role is earned by its name).
|
|
238
|
+
The wrapper is a `--space-200` inset frame — geometry, not an ARIA construct. The one pattern that
|
|
239
|
+
does set `role="group"` is the **multi-select filter**, where a labelled divider names it via
|
|
240
|
+
`aria-labelledby`; everywhere else (an action menu's dividers are deliberately plain) the wrapper
|
|
241
|
+
stays presentational.
|
|
242
|
+
|
|
243
|
+
That hook-up is concrete: [`Divider`](?path=/docs/design-system-atoms-divider--docs) puts an `id` on
|
|
244
|
+
its label node — generated, or the one you pass as `labelId` — and the group points
|
|
245
|
+
`aria-labelledby` at it. The divider's own `aria-label` names the *separator*; the `id` is what names
|
|
246
|
+
the *section*, and a group needs the latter.
|
|
247
|
+
|
|
248
|
+
```tsx
|
|
249
|
+
<Divider variant="line-label" label="Stav" labelId="filter-status" />
|
|
250
|
+
<AnchoredPanel.Group role="group" aria-labelledby="filter-status">
|
|
251
|
+
{/* … */}
|
|
252
|
+
</AnchoredPanel.Group>
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
## Do / Don't
|
|
256
|
+
|
|
257
|
+
- ✅ Pass `role` **and** `focusModel` explicitly, and keep the pair consistent (`menu` + `roving`,
|
|
258
|
+
`listbox` + `virtual`).
|
|
259
|
+
- ✅ Give the component the `size` matching the rows you put in it; don't look for a `size` on the
|
|
260
|
+
hook — the height cap is a row count, not a per-density height.
|
|
261
|
+
- ✅ Put rows in `AnchoredPanel.Group`; keep `Divider`s as **siblings** of the groups at 0 inset so
|
|
262
|
+
they run full-bleed.
|
|
263
|
+
- ✅ In the roving model give each row a `tabIndex` (0 for the active row, -1 otherwise) — a `ListRow`
|
|
264
|
+
is a `div` and is not focusable on its own.
|
|
265
|
+
- ✅ Close through `panel.close()` so focus returns to the trigger.
|
|
266
|
+
- ❌ Don't put `role="group"` on the wrapper to "make the structure explicit" — an unnamed group is
|
|
267
|
+
announced as a bare "group" and is pure noise. Only the multi-select filter earns the role, because
|
|
268
|
+
its labelled divider names it, through `aria-labelledby` → the divider's `labelId`. Never invent a
|
|
269
|
+
label just to justify one.
|
|
270
|
+
- ❌ Don't add a `variant` / `type` axis, a skin, or slots here — that is the forbidden `Dropdown`.
|
|
271
|
+
- ❌ Don't set `role` or `aria-*` on the substrate; pass them through `panelProps` from the organism.
|
|
272
|
+
- ❌ Don't put horizontal padding on the surface or the body — dividers must stay full-bleed.
|
|
273
|
+
- ❌ Don't render a focus ring around the panel; the ring lives on the row or the trigger.
|
|
274
|
+
- ❌ Don't reach for the substrate when `Menu` or `Select` already covers the case.
|
|
275
|
+
|
|
276
|
+
## Accessibility
|
|
277
|
+
|
|
278
|
+
- **Keyboard** — the substrate wires the **cursor**, not the meaning: **↑ ↓** walk the rows (looping),
|
|
279
|
+
**Home / End** jump to first / last, **typing** jumps by label, **Esc** and an outside pointer-down
|
|
280
|
+
dismiss, and focus returns to the trigger on every close. What **Enter / Space** do, and whether a
|
|
281
|
+
row closes the panel, is the organism's contract.
|
|
282
|
+
- **ARIA** — the substrate contributes **nothing**: `role` and `aria-label` come in via `panelProps`,
|
|
283
|
+
the trigger↔panel pairing is wired by floating-ui's `useRole` for the roles it knows
|
|
284
|
+
(`role="group"` is not one of them). Both chrome wrappers carry `role="none"` so the rows stay
|
|
285
|
+
owned children of the organism's role and item counting stays correct.
|
|
286
|
+
- **Focus** — `virtual` keeps DOM focus on the trigger with `aria-activedescendant`; `roving` moves
|
|
287
|
+
focus into the panel and restores it to the trigger on close. The panel container is focusable
|
|
288
|
+
(`tabIndex={-1}`) but must never show a focus visual.
|
|
289
|
+
- **Screen reader** — a portalled panel is announced through the trigger's `aria-expanded` +
|
|
290
|
+
`aria-controls` pair, so the role must actually be set: a panel with no `panelProps` announces as a
|
|
291
|
+
generic group and the trigger says nothing about what opened.
|
|
292
|
+
- **Motion** — the 150 ms fade + 4px slide collapses to an instant fade under
|
|
293
|
+
`prefers-reduced-motion: reduce`.
|
|
294
|
+
- **Contrast** — the substrate paints nothing but the chrome tokens; contrast is the row's and the
|
|
295
|
+
chrome link's business.
|
|
296
|
+
|
|
297
|
+
## Usage
|
|
298
|
+
|
|
299
|
+
```tsx
|
|
300
|
+
import { AnchoredPanel, useAnchoredPanel, ListRow, Divider } from '@invoiceonline/ui-react';
|
|
301
|
+
|
|
302
|
+
// Good — role + focusModel chosen explicitly, semantics passed in from the organism
|
|
303
|
+
const panel = useAnchoredPanel({
|
|
304
|
+
open,
|
|
305
|
+
onOpenChange: setOpen,
|
|
306
|
+
role: 'menu',
|
|
307
|
+
focusModel: 'roving',
|
|
308
|
+
widthPolicy: 'content',
|
|
309
|
+
itemCount: commands.length,
|
|
310
|
+
labels: commands.map(c => c.label),
|
|
311
|
+
});
|
|
312
|
+
|
|
313
|
+
<button ref={panel.refs.setReference} {...panel.getReferenceProps()}>Akce</button>
|
|
314
|
+
|
|
315
|
+
<AnchoredPanel
|
|
316
|
+
panel={panel}
|
|
317
|
+
size="md"
|
|
318
|
+
focusModel="roving"
|
|
319
|
+
panelProps={{ role: 'menu', 'aria-label': 'Akce' }}
|
|
320
|
+
>
|
|
321
|
+
<AnchoredPanel.Group>
|
|
322
|
+
{commands.map((c, i) => (
|
|
323
|
+
<ListRow
|
|
324
|
+
key={c.id}
|
|
325
|
+
role="menuitem"
|
|
326
|
+
ref={node => { panel.listRef.current[i] = node; }}
|
|
327
|
+
tabIndex={panel.activeIndex === i ? 0 : -1}
|
|
328
|
+
highlighted={panel.activeIndex === i}
|
|
329
|
+
{...panel.getItemProps()}
|
|
330
|
+
>
|
|
331
|
+
{c.label}
|
|
332
|
+
</ListRow>
|
|
333
|
+
))}
|
|
334
|
+
</AnchoredPanel.Group>
|
|
335
|
+
<Divider variant="line" />
|
|
336
|
+
</AnchoredPanel>
|
|
337
|
+
|
|
338
|
+
// Don't — no semantics at all: the panel announces as a generic group
|
|
339
|
+
<AnchoredPanel panel={panel} focusModel="roving">…</AnchoredPanel>
|
|
340
|
+
|
|
341
|
+
// Don't — a Divider inside the group loses its full bleed
|
|
342
|
+
<AnchoredPanel.Group>
|
|
343
|
+
<ListRow>…</ListRow>
|
|
344
|
+
<Divider variant="line" />
|
|
345
|
+
</AnchoredPanel.Group>
|
|
346
|
+
|
|
347
|
+
// Don't — mismatched density: the panel is built for `md`, the rows are `sm`
|
|
348
|
+
<AnchoredPanel panel={panel} size="md" focusModel="virtual">
|
|
349
|
+
<AnchoredPanel.Group>
|
|
350
|
+
<ListRow size="sm">…</ListRow>
|
|
351
|
+
</AnchoredPanel.Group>
|
|
352
|
+
</AnchoredPanel>
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
## Related
|
|
356
|
+
|
|
357
|
+
- **[Popover Surface](?path=/docs/design-system-patterns-popover-surface--docs)** — the chrome recipe this substrate applies (layer 1).
|
|
358
|
+
- **[Menu](?path=/docs/design-system-organisms-menu--docs)** — the `menu` organism on top of it (roving focus).
|
|
359
|
+
- **[Select](?path=/docs/design-system-organisms-select--docs)** — the `listbox` organism (virtual focus).
|
|
360
|
+
- **[ListRow](?path=/docs/design-system-atoms-listrow--docs)** · **[Divider](?path=/docs/design-system-atoms-divider--docs)** · **[TextLink](?path=/docs/design-system-atoms-textlink--docs)** — what the body and the chrome frames are composed from.
|
|
361
|
+
- [floating-ui React docs](https://floating-ui.com/docs/react) — the behaviour engine.
|
|
362
|
+
- Spec: `spec/06-patterns/overlay-behavior.md` · `spec/06-patterns/popover-patterns.md` · `spec/04-molecules/_menu-family-planning.md`
|
|
363
|
+
|
|
364
|
+
## Migration notes
|
|
365
|
+
|
|
366
|
+
Replaces ad-hoc floating panels: vanilla hover dropdowns and per-component `useState` +
|
|
367
|
+
absolutely positioned divs. Differences to expect:
|
|
368
|
+
|
|
369
|
+
- The panel is **portalled** and collision-aware, so it no longer clips inside an overflow container
|
|
370
|
+
and no longer needs a `z-index` guess at the call site.
|
|
371
|
+
- **Hover no longer opens or closes** anything — open is a click / keyboard action, close is Esc, an
|
|
372
|
+
outside pointer-down, or the organism's own invoke.
|
|
373
|
+
- Height is capped at 320 (8 rows of 40) and the **body** scrolls; the page behind the panel does not.
|
|
374
|
+
The cap is the published `--ds-overlay-max-height` (ui-system 0.10.0 onward), bound in CSS and
|
|
375
|
+
clamped further against the viewport through a local custom property the positioning middleware
|
|
376
|
+
writes — the `min(token, available height)` shape `popover-patterns.md` § Filling rules spells out.
|
|
377
|
+
The token stays the token; only the viewport half is computed.
|
|
378
|
+
- One token gap remains: the content width band (180 / 320) is a **stand-in in `useAnchoredPanel`** —
|
|
379
|
+
the spec states it as approximate, with no token behind it.
|
|
380
|
+
- Submenus / side flyouts (one level, hover-with-intent + safe triangle, `FloatingTree`) are specced
|
|
381
|
+
in `overlay-behavior.md` § Submenu / flyout but **not wired here yet**.
|