@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,602 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import * as React from 'react';
|
|
4
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
5
|
+
import { cn } from '../../internal/utils';
|
|
6
|
+
import { Button } from '../button/Button';
|
|
7
|
+
import { Heading, type HeadingLevel } from '../heading/Heading';
|
|
8
|
+
import { PromoSurface } from '../promo-surface/PromoSurface';
|
|
9
|
+
import { Icon, type IconName } from '../icon/Icon';
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Banner — a promotional panel for public pages (`banner.manifest.json`, Web layer
|
|
13
|
+
* `spec/07-web/`, v3.0.0, `kind: "region"`).
|
|
14
|
+
*
|
|
15
|
+
* Three artwork-and-layout recipes, closed set (`intent.rules[0]`): Person, Invoice and
|
|
16
|
+
* Mini. The actions are NOT a variant — they are the one Actions slot (`slots.actions`),
|
|
17
|
+
* passed as `children`. Content that fits none of the recipes is a Hero.
|
|
18
|
+
*
|
|
19
|
+
* ## Structure (`delivery.react`)
|
|
20
|
+
*
|
|
21
|
+
* `<section>` (24 above and below, `container.note`) → plaque (`relative rounded-800`) →
|
|
22
|
+
* the Promo Surface as an absolutely positioned SIBLING layer (never a wrapper), then the
|
|
23
|
+
* visual (Person / Invoice only), then the text column. Paint order is tree order, so
|
|
24
|
+
* the text column lands on top of the visual and the visual on top of the surface — no
|
|
25
|
+
* z-index.
|
|
26
|
+
*
|
|
27
|
+
* ## What is NOT Banner's
|
|
28
|
+
*
|
|
29
|
+
* The outer frame's width ladder, side gutter (16/24/32/40/40) and the marketing
|
|
30
|
+
* container cap are the PAGE container (`container.note`, spec/07-web → Page frame); the
|
|
31
|
+
* plaque fills whatever container it is dropped into and has no max-width of its own.
|
|
32
|
+
* Storybook models the container with a decorator.
|
|
33
|
+
*
|
|
34
|
+
* ## Artwork is the app's (2.2.0, `delivery.react`)
|
|
35
|
+
*
|
|
36
|
+
* The package ships no picture. Person takes `character` (`slots.character`), Person and
|
|
37
|
+
* Invoice take `invoiceIllustration` `{ left, right }` (`slots.invoice-illustration`),
|
|
38
|
+
* each a React element — an `<img alt="">` of the app's own asset. Mini takes neither;
|
|
39
|
+
* the props union rejects them there. Banner owns only the boxes, their positions and
|
|
40
|
+
* the clipping of `regions.visual`, and the whole visual layer is `aria-hidden`.
|
|
41
|
+
*
|
|
42
|
+
* ## Actions slot
|
|
43
|
+
*
|
|
44
|
+
* Accepts Button, Text Link, Text Field and Subject Lookup Field, one or two of them
|
|
45
|
+
* (`intent.rules[6]`). `BannerAction` is the default content — the Brand link button
|
|
46
|
+
* sized per Composition × Breakpoint. A field + submit pair passes `actionsForm` so the
|
|
47
|
+
* slot renders as a `<form>` and Enter in the field submits (spec Accessibility).
|
|
48
|
+
*
|
|
49
|
+
* ## Breakpoint is not a prop
|
|
50
|
+
*
|
|
51
|
+
* `properties[Breakpoint].maps`: the five steps are the responsive ladder, pure CSS.
|
|
52
|
+
* Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
|
|
53
|
+
*
|
|
54
|
+
* ## No states
|
|
55
|
+
*
|
|
56
|
+
* `intent.states`: the shell is non-interactive. The controls in the slot own every
|
|
57
|
+
* hover / active / focus-visible / disabled state. The one thing Banner overrides is the
|
|
58
|
+
* focus-ring COLOUR of every slotted control on Surface=Solid (`intent.rules[5]`).
|
|
59
|
+
*/
|
|
60
|
+
|
|
61
|
+
/*
|
|
62
|
+
* Every raw px below is an authored Figma artwork / composition measurement with no
|
|
63
|
+
* --space token (component set 7355:3105), each under its own fods-lint suppression.
|
|
64
|
+
* They are written inline in the recipe, not in a shared constant, because
|
|
65
|
+
* a static check of the tv() literal cannot follow a reference.
|
|
66
|
+
*/
|
|
67
|
+
const bannerVariants = tv({
|
|
68
|
+
slots: {
|
|
69
|
+
// A plain section, no fill: --bg-primary is the page canvas (container.fill). 2.1.0:
|
|
70
|
+
// the section carries the Web block band itself — --space-800 above and below at
|
|
71
|
+
// every step, a deliberate exception to the page's recommended P (container.note).
|
|
72
|
+
root: 'w-full py-800',
|
|
73
|
+
panel: [
|
|
74
|
+
// `relative` so the absolute surface and visual resolve against the plaque.
|
|
75
|
+
// No overflow-hidden, ever: intent.rules[3] — "The panel itself never clips."
|
|
76
|
+
'relative flex rounded-800',
|
|
77
|
+
],
|
|
78
|
+
textColumn: [
|
|
79
|
+
// `relative` so the in-flow column paints above the absolute siblings before it.
|
|
80
|
+
'relative flex flex-col',
|
|
81
|
+
// regions.text-column.note: copy -> actions.
|
|
82
|
+
'gap-800',
|
|
83
|
+
],
|
|
84
|
+
copy: [
|
|
85
|
+
'flex w-full flex-col',
|
|
86
|
+
// regions.text-column.note: heading -> body (Heading Group D2 ladder).
|
|
87
|
+
'gap-600',
|
|
88
|
+
],
|
|
89
|
+
// Typography is the Heading atom's (`d2`, Mini `d3`); only the per-surface ink lives here.
|
|
90
|
+
heading: '',
|
|
91
|
+
body: [
|
|
92
|
+
// typography.runs.body: Body/XL, 20 at every breakpoint (promo-plaque carve-out).
|
|
93
|
+
'font-inter text-body-xl',
|
|
94
|
+
'[text-wrap:var(--text-wrap-body)]',
|
|
95
|
+
],
|
|
96
|
+
/*
|
|
97
|
+
* regions.actions: one wrapping row at gap --space-400 (the adjacent-target minimum),
|
|
98
|
+
* a full-width column at Mobile (and at SM on Mini). The row direction is per
|
|
99
|
+
* Composition below.
|
|
100
|
+
*/
|
|
101
|
+
actions: [
|
|
102
|
+
'flex w-full flex-col gap-400',
|
|
103
|
+
// A field (any child that is not a button or a link) takes the room the button
|
|
104
|
+
// leaves it; flex-basis 0 so it never wraps the button onto a second line.
|
|
105
|
+
'sm:[&>:not(a,button)]:min-w-0 sm:[&>:not(a,button)]:flex-1',
|
|
106
|
+
// slots.actions FIELD + BUTTON: no Button size is 48 (gaps[4]), so beside a field
|
|
107
|
+
// the submit button is stretched to Text Field md's 48. Stacked it keeps its 44.
|
|
108
|
+
'sm:has-[input]:[&>button]:min-h-1100',
|
|
109
|
+
// slots.actions TEXT LINK TARGET: the hit area is padded to the 44 floor, in-flow
|
|
110
|
+
// so it never overlaps the neighbouring button; the visual stays the link's.
|
|
111
|
+
'[&>[data-fods-component=text-link]]:inline-flex [&>[data-fods-component=text-link]]:items-center [&>[data-fods-component=text-link]]:justify-center',
|
|
112
|
+
// fods-lint-disable-next-line 44px target floor for a Text Link in the slot (slots.actions TEXT LINK TARGET, Button lg height); no --space token
|
|
113
|
+
'[&>[data-fods-component=text-link]]:min-h-[44px]',
|
|
114
|
+
],
|
|
115
|
+
/*
|
|
116
|
+
* BannerAction — the slot's default content: one Brand link button. Button has one
|
|
117
|
+
* size per instance, so the action renders one instance per size band and CSS shows
|
|
118
|
+
* exactly one — Button stays the only owner of both geometries, and `display: none`
|
|
119
|
+
* keeps the hidden twin out of the tab order and the accessibility tree. SSR-safe,
|
|
120
|
+
* no viewport hook. `pl-*` restates Button's leading-icon padding (its `hasLeading`
|
|
121
|
+
* compound), which the asChild branch cannot derive. `max-w-full` bounds the label
|
|
122
|
+
* at 320px reflow.
|
|
123
|
+
*/
|
|
124
|
+
action: 'max-w-full',
|
|
125
|
+
/*
|
|
126
|
+
* 1.8.0: a label wrapped to two lines gets --space-400 above and below (54 -> 70);
|
|
127
|
+
* a one-line button stays 44. No CSS selector can tell a wrapped label from a
|
|
128
|
+
* one-line one, so the padding is unconditional and Button's 44 min-height does the
|
|
129
|
+
* switching: one line is 27 + 2 x 7 + 2 x 1 border = 43, under the floor, so the
|
|
130
|
+
* button stays 44; two lines are 54 + 14 + 2 = 70. The 1px border is subtracted
|
|
131
|
+
* because Figma's inside stroke sits within the 8 while a CSS border adds to it.
|
|
132
|
+
*/
|
|
133
|
+
actionMobile: 'w-full pl-500 py-[calc(var(--space-400)-var(--border-width-100))] sm:hidden',
|
|
134
|
+
actionDesktop: 'hidden pl-600 sm:inline-flex',
|
|
135
|
+
// 1.7.0: at Mobile the label wraps to at most two lines and the button grows,
|
|
136
|
+
// overriding Button's single-line text.label; from SM it truncates on one line.
|
|
137
|
+
actionLabelMobile: 'min-w-0 line-clamp-2 whitespace-normal',
|
|
138
|
+
actionLabelDesktop: 'min-w-0 truncate',
|
|
139
|
+
visual: '',
|
|
140
|
+
artwork: [
|
|
141
|
+
'absolute inset-0',
|
|
142
|
+
// Beside the copy the artwork starts 40 (LG) / 24 (XL) INSIDE the text column.
|
|
143
|
+
'lg:-left-1000 xl:-left-800',
|
|
144
|
+
// Person artwork clips at the plaque's bottom edge ONLY (intent.rules[3]): it
|
|
145
|
+
// overhangs the top and the sides uncropped. A clip-path inset with negative
|
|
146
|
+
// top/sides is the one primitive that cuts a single edge.
|
|
147
|
+
'[clip-path:inset(-100%_-100%_0)]',
|
|
148
|
+
],
|
|
149
|
+
invoice: [
|
|
150
|
+
// Two sheets as tall as this box, pinned to its opposite edges, so they spread
|
|
151
|
+
// apart as the box widens (regions.visual.note: Sheet·Left MIN, Sheet·Right MAX).
|
|
152
|
+
'absolute inset-x-0',
|
|
153
|
+
// Authored 24 taller than its band and run past the bottom edge, where the band
|
|
154
|
+
// clips it — "sliding under the plaque's lower rim".
|
|
155
|
+
'-bottom-800 h-[calc(100%+var(--space-800))]',
|
|
156
|
+
],
|
|
157
|
+
// Each sheet is sized by height only: the app's picture (`invoiceIllustration`)
|
|
158
|
+
// fills the box's height and its own ratio gives the width, so the box hugs it.
|
|
159
|
+
invoiceSheetLeft: 'absolute inset-y-0 left-0 h-full w-auto max-w-none *:block *:h-full *:w-auto *:max-w-none',
|
|
160
|
+
invoiceSheetRight: 'absolute inset-y-0 right-0 h-full w-auto max-w-none *:block *:h-full *:w-auto *:max-w-none',
|
|
161
|
+
// Person only. Bottom-anchored; the app's picture (`character`) is already cropped
|
|
162
|
+
// like the Figma mask, so it fills the box's width and its own ratio gives the
|
|
163
|
+
// height. Box 332 centred while stacked, 362 at x=32 (LG), 310 at x=114 (XL) inside
|
|
164
|
+
// the artwork box.
|
|
165
|
+
character: [
|
|
166
|
+
'absolute bottom-0 h-auto max-w-none *:block *:h-auto *:w-full *:max-w-none',
|
|
167
|
+
'left-1/2 -translate-x-1/2 lg:left-900 lg:translate-x-0',
|
|
168
|
+
// Capped at the band so a sub-332 viewport scales the character instead of
|
|
169
|
+
// scrolling the page sideways; every authored width is wider than the box.
|
|
170
|
+
// fods-lint-disable-next-line authored character box 332px (Figma Person MD/SM/Mobile); artwork geometry, no --space token
|
|
171
|
+
'w-[min(332px,100%)]',
|
|
172
|
+
// fods-lint-disable-next-line authored character box 362px (Figma Person LG); artwork geometry, no --space token
|
|
173
|
+
'lg:w-[min(362px,100%)]',
|
|
174
|
+
// fods-lint-disable-next-line authored character box 310px (Figma Person XL); artwork geometry, no --space token
|
|
175
|
+
'xl:w-[min(310px,100%)]',
|
|
176
|
+
// fods-lint-disable-next-line authored XL character offset 114px inside the artwork box (Figma Person XL); artwork geometry, no --space token
|
|
177
|
+
'xl:left-[114px]',
|
|
178
|
+
],
|
|
179
|
+
},
|
|
180
|
+
variants: {
|
|
181
|
+
composition: {
|
|
182
|
+
person: {
|
|
183
|
+
// Copy above the visual while stacked, beside it (left) from LG. `-reverse`
|
|
184
|
+
// because the visual precedes the text column in the tree (paint order).
|
|
185
|
+
panel: 'flex-col-reverse lg:flex-row-reverse',
|
|
186
|
+
textColumn: [
|
|
187
|
+
// regions.text-column.align: centred at MD/SM/Mobile, left at XL/LG.
|
|
188
|
+
'items-center text-center lg:items-start lg:text-left',
|
|
189
|
+
// Mobile 24 × 40, SM 40 × 48, MD/LG/XL 48 all round.
|
|
190
|
+
'px-800 py-1000 sm:px-1000 sm:py-1100 md:p-1100',
|
|
191
|
+
// Side-by-side split authored as XL 648 + 552, LG 520 + 424, as a basis on
|
|
192
|
+
// BOTH children so the plaque (2.1.0: 1190 / 880, the block content) shares
|
|
193
|
+
// the deficit proportionally (Hero's `visual.on` split explains why flex-1 on
|
|
194
|
+
// one side is wrong).
|
|
195
|
+
'lg:shrink lg:grow-0',
|
|
196
|
+
// fods-lint-disable-next-line authored LG text-column width 520 (Figma Person LG split); composition measure, no --space token
|
|
197
|
+
'lg:basis-[520px]',
|
|
198
|
+
// fods-lint-disable-next-line authored XL text-column width 648 (Figma Person XL split); composition measure, no --space token
|
|
199
|
+
'xl:basis-[648px]',
|
|
200
|
+
],
|
|
201
|
+
// regions.actions.align: centred at MD/SM/Mobile, left at XL/LG.
|
|
202
|
+
actions: 'sm:flex-row sm:flex-wrap sm:justify-center lg:justify-start',
|
|
203
|
+
visual: [
|
|
204
|
+
'relative',
|
|
205
|
+
// Stacked: an in-flow band bleeding past the plaque by the gutter on both
|
|
206
|
+
// sides (16 / 24 / 32), so the artwork overhangs the plaque's sides.
|
|
207
|
+
'-mx-600 sm:-mx-800 md:-mx-900 lg:mx-0',
|
|
208
|
+
// fods-lint-disable-next-line authored 324px Person visual band height (Figma MD/SM/Mobile); artwork geometry, no --space token
|
|
209
|
+
'h-[324px]',
|
|
210
|
+
// Beside the copy: stretched to the plaque height, which the text column
|
|
211
|
+
// alone sets (everything inside is absolute).
|
|
212
|
+
'lg:h-auto lg:min-w-0 lg:shrink lg:grow',
|
|
213
|
+
// fods-lint-disable-next-line authored LG visual width 424 (Figma Person LG split); composition measure, no --space token
|
|
214
|
+
'lg:basis-[424px]',
|
|
215
|
+
// fods-lint-disable-next-line authored XL visual width 552 (Figma Person XL split); composition measure, no --space token
|
|
216
|
+
'xl:basis-[552px]',
|
|
217
|
+
],
|
|
218
|
+
// Beside the copy the invoice graphic is authored 464×356 (LG) / 576×328 (XL);
|
|
219
|
+
// stacked it follows the shared band + 24 recipe.
|
|
220
|
+
invoice: [
|
|
221
|
+
// fods-lint-disable-next-line authored LG invoice graphic height 356 (Figma Person LG); artwork geometry, no --space token
|
|
222
|
+
'lg:h-[356px]',
|
|
223
|
+
// fods-lint-disable-next-line authored XL invoice graphic height 328 (Figma Person XL); artwork geometry, no --space token
|
|
224
|
+
'xl:h-[328px]',
|
|
225
|
+
],
|
|
226
|
+
},
|
|
227
|
+
invoice: {
|
|
228
|
+
// Copy centred in the plaque at every breakpoint (Promo Surface Layout=Vertical).
|
|
229
|
+
// Below LG the plaque adds 80 above and below on top of the column's own 80
|
|
230
|
+
// (copy starts 160 from the top edge); from LG the column carries 48 alone.
|
|
231
|
+
panel: 'flex-col items-center py-1300 lg:py-0',
|
|
232
|
+
textColumn: [
|
|
233
|
+
'w-full items-center text-center',
|
|
234
|
+
// The 580 measure — the system's --ds-content-narrow.
|
|
235
|
+
'max-w-content-narrow',
|
|
236
|
+
'px-800 py-1300 lg:py-1100',
|
|
237
|
+
],
|
|
238
|
+
actions: 'sm:flex-row sm:flex-wrap sm:justify-center',
|
|
239
|
+
// 1.8.0 (regions.visual.note): the sheets keep their authored size at every
|
|
240
|
+
// breakpoint. Below LG the band is a fixed authored height, so band + 24 is a
|
|
241
|
+
// constant already; from LG the band follows the plaque, so the graphic is
|
|
242
|
+
// pinned to its authored height (plaque 280 + 24 above + 24 run-past) and a
|
|
243
|
+
// taller plaque only moves it down with the bottom edge.
|
|
244
|
+
// fods-lint-disable-next-line authored 328px Invoice invoice graphic height (Figma LG/XL); artwork geometry, no --space token
|
|
245
|
+
invoice: 'lg:h-[328px]',
|
|
246
|
+
visual: [
|
|
247
|
+
// An ABSOLUTE band inside the plaque, inset past it by the breakpoint's gutter
|
|
248
|
+
// (-16 / -24 / -32 / -40 / -40), bottom flush, clipped (regions.visual.note).
|
|
249
|
+
'absolute bottom-0 overflow-hidden',
|
|
250
|
+
'-inset-x-600 sm:-inset-x-800 md:-inset-x-900 lg:-inset-x-1000',
|
|
251
|
+
// fods-lint-disable-next-line authored 142px Invoice band height (Figma Mobile); artwork geometry, no --space token
|
|
252
|
+
'h-[142px]',
|
|
253
|
+
// fods-lint-disable-next-line authored 195px Invoice band height (Figma SM); artwork geometry, no --space token
|
|
254
|
+
'sm:h-[195px]',
|
|
255
|
+
// fods-lint-disable-next-line authored 215px Invoice band height (Figma MD); artwork geometry, no --space token
|
|
256
|
+
'md:h-[215px]',
|
|
257
|
+
// LG/XL: the band spans the plaque and 24 above it.
|
|
258
|
+
'lg:-top-800 lg:h-auto',
|
|
259
|
+
],
|
|
260
|
+
},
|
|
261
|
+
/*
|
|
262
|
+
* Mini (2.0.0, regions.text-column.note): no copy frame, no body, no visual. At
|
|
263
|
+
* XL / LG / MD the heading (FILL) and the slot (HUG) share one counter-axis-centred
|
|
264
|
+
* row, gap --space-800, plaque padding --space-900 (Layout=Side); at SM / Mobile
|
|
265
|
+
* they stack heading-first, gap --space-600, padding --space-800, left-aligned,
|
|
266
|
+
* the slot full width (Layout=Top).
|
|
267
|
+
*/
|
|
268
|
+
mini: {
|
|
269
|
+
panel: 'flex-col',
|
|
270
|
+
textColumn: [
|
|
271
|
+
'w-full items-stretch text-left',
|
|
272
|
+
'gap-600 p-800',
|
|
273
|
+
'md:flex-row md:items-center md:gap-800 md:p-900',
|
|
274
|
+
],
|
|
275
|
+
heading: 'min-w-0 md:flex-1',
|
|
276
|
+
actions: 'md:w-auto md:shrink-0 md:flex-row md:flex-wrap md:justify-end',
|
|
277
|
+
// Mini's action is lg at every step, so its leading-icon padding is lg's too.
|
|
278
|
+
actionDesktop: 'pl-500',
|
|
279
|
+
},
|
|
280
|
+
},
|
|
281
|
+
/*
|
|
282
|
+
* Surface picks the plaque AND the ink together (intent.rules[1]). The heading ink
|
|
283
|
+
* is set on the part itself because the Heading atom binds --text-primary in its
|
|
284
|
+
* own base; the body ink on Brand is --secondary-tint-foreground (changelog
|
|
285
|
+
* 2026-08-23).
|
|
286
|
+
*
|
|
287
|
+
* Solid: --outline-focus is the same hex as --secondary-solid, so Banner swaps the
|
|
288
|
+
* ring colour of EVERY control in the Actions slot to --outline-focus-inverse
|
|
289
|
+
* (intent.rules[5], focus.note, chrome.focus-ring). The container owns the swap,
|
|
290
|
+
* never the atom, so it is written as descendant rules on the slot:
|
|
291
|
+
* - buttons and links keep their own outline geometry; only the colour changes.
|
|
292
|
+
* `:is(a,button)` adds one element to the specificity, so the swap beats the
|
|
293
|
+
* atom's own `focus-visible:outline-outline-focus` regardless of CSS order.
|
|
294
|
+
* - a field's own focus is a border swap to --outline-focus, invisible on this
|
|
295
|
+
* plaque, so its shell — the element whose direct child is the input — gets the
|
|
296
|
+
* offset ring Button draws, following the shell's own --radius-400.
|
|
297
|
+
*/
|
|
298
|
+
surface: {
|
|
299
|
+
brand: {
|
|
300
|
+
panel: 'text-text-primary',
|
|
301
|
+
heading: 'text-text-primary',
|
|
302
|
+
body: 'text-secondary-tint-foreground',
|
|
303
|
+
},
|
|
304
|
+
solid: {
|
|
305
|
+
panel: 'text-text-inverted',
|
|
306
|
+
heading: 'text-text-inverted',
|
|
307
|
+
body: 'text-text-inverted',
|
|
308
|
+
actions: [
|
|
309
|
+
'[&_:is(a,button):focus-visible]:outline-outline-focus-inverse',
|
|
310
|
+
'[&_:has(>input:focus-visible)]:outline [&_:has(>input:focus-visible)]:outline-200',
|
|
311
|
+
'[&_:has(>input:focus-visible)]:outline-offset-2 [&_:has(>input:focus-visible)]:outline-outline-focus-inverse',
|
|
312
|
+
],
|
|
313
|
+
},
|
|
314
|
+
},
|
|
315
|
+
},
|
|
316
|
+
defaultVariants: {
|
|
317
|
+
composition: 'person',
|
|
318
|
+
surface: 'brand',
|
|
319
|
+
},
|
|
320
|
+
});
|
|
321
|
+
|
|
322
|
+
/** `properties[Composition].maps` — `person` · `invoice` · `mini`. */
|
|
323
|
+
export type BannerComposition = 'person' | 'invoice' | 'mini';
|
|
324
|
+
/** Passed straight through to `<PromoSurface surface>` — same spelling (`properties[Surface]`). */
|
|
325
|
+
export type BannerSurface = 'brand' | 'solid';
|
|
326
|
+
|
|
327
|
+
interface BannerCommon extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
|
|
328
|
+
/** Plaque tone + ink. Defaults to `brand`. */
|
|
329
|
+
surface?: BannerSurface;
|
|
330
|
+
/**
|
|
331
|
+
* The panel's single claim — one sentence, no full stop, ~48 characters
|
|
332
|
+
* (`text.heading`, Mini `text.mini-heading`).
|
|
333
|
+
*/
|
|
334
|
+
heading: string;
|
|
335
|
+
/**
|
|
336
|
+
* Required: the page decides (spec Accessibility) — `1` where Banner IS the first
|
|
337
|
+
* screen, a lower level everywhere else; inside an article Mini sits one level below
|
|
338
|
+
* the current section heading. Never derived from the Display size.
|
|
339
|
+
*/
|
|
340
|
+
headingLevel: HeadingLevel;
|
|
341
|
+
/**
|
|
342
|
+
* The Actions slot (`slots.actions`): one or two controls from the accepted set —
|
|
343
|
+
* Button, Text Link, Text Field, Subject Lookup Field. `<BannerAction>` is the
|
|
344
|
+
* default content. On `surface="solid"` only one Brand Button or a field with its
|
|
345
|
+
* submit button (`intent.rules[6]`).
|
|
346
|
+
*/
|
|
347
|
+
children: React.ReactNode;
|
|
348
|
+
/**
|
|
349
|
+
* Renders the Actions slot as a `<form>` with these attributes — for a field + submit
|
|
350
|
+
* pair, so Enter in the field performs the button's action (spec Accessibility).
|
|
351
|
+
*/
|
|
352
|
+
actionsForm?: Omit<React.FormHTMLAttributes<HTMLFormElement>, 'className' | 'children'>;
|
|
353
|
+
className?: string;
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
/**
|
|
357
|
+
* The two invoice sheets of the visual (`slots.invoice-illustration`), each an element
|
|
358
|
+
* the app supplies — an `<img alt="">` of its own asset. The component pins `left` to
|
|
359
|
+
* the band's start edge and `right` to its end edge and sizes both by height.
|
|
360
|
+
*/
|
|
361
|
+
export interface BannerInvoiceIllustration {
|
|
362
|
+
left: React.ReactElement;
|
|
363
|
+
right: React.ReactElement;
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
interface BannerPitchCommon extends BannerCommon {
|
|
367
|
+
/**
|
|
368
|
+
* The optional detail line (Figma `Show body` + `Body text`). Absent or empty renders
|
|
369
|
+
* no line. On `surface="solid"` it ships a known 4.45:1 run (spec Accessibility).
|
|
370
|
+
*/
|
|
371
|
+
detail?: string;
|
|
372
|
+
/**
|
|
373
|
+
* The invoice sheets (`slots.invoice-illustration`). The package ships no picture:
|
|
374
|
+
* pass the app's own (`{ left: <img src={sheetLeft} alt="" />, right: … }`). The
|
|
375
|
+
* visual layer is `aria-hidden` — the copy carries the message.
|
|
376
|
+
*/
|
|
377
|
+
invoiceIllustration: BannerInvoiceIllustration;
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
/** Person (the default composition): heading, optional detail line, actions, character + invoice sheets. */
|
|
381
|
+
export interface BannerPersonProps extends BannerPitchCommon {
|
|
382
|
+
composition?: 'person';
|
|
383
|
+
/**
|
|
384
|
+
* The character (`slots.character`), an element the app supplies — e.g.
|
|
385
|
+
* `<img src={bartender} alt="" />`. Sized by width; its own ratio gives the height.
|
|
386
|
+
*/
|
|
387
|
+
character: React.ReactElement;
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/** Invoice: heading, optional detail line, actions, invoice sheets — no character. */
|
|
391
|
+
export interface BannerInvoiceProps extends BannerPitchCommon {
|
|
392
|
+
composition: 'invoice';
|
|
393
|
+
/** Invoice has no character (`slots.character` is Person only). */
|
|
394
|
+
character?: never;
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
/** Person and Invoice — the compositions with a visual. */
|
|
398
|
+
export type BannerPitchProps = BannerPersonProps | BannerInvoiceProps;
|
|
399
|
+
|
|
400
|
+
/** Mini: a short Display/D3 heading with the actions beside it — no detail line, no artwork. */
|
|
401
|
+
export interface BannerMiniProps extends BannerCommon {
|
|
402
|
+
composition: 'mini';
|
|
403
|
+
/** Mini has no body run (`properties[Body text].maps`). */
|
|
404
|
+
detail?: undefined;
|
|
405
|
+
/** Mini renders no visual layer. */
|
|
406
|
+
character?: never;
|
|
407
|
+
/** Mini renders no visual layer. */
|
|
408
|
+
invoiceIllustration?: never;
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
export type BannerProps = BannerPersonProps | BannerInvoiceProps | BannerMiniProps;
|
|
412
|
+
|
|
413
|
+
const BannerCompositionContext = React.createContext<BannerComposition>('person');
|
|
414
|
+
|
|
415
|
+
/**
|
|
416
|
+
* Action size per size band (`slots.actions.default`): Person and Invoice lg at Mobile,
|
|
417
|
+
* xl from SM; Mini lg at every breakpoint.
|
|
418
|
+
*/
|
|
419
|
+
const ACTION_SIZES: Record<BannerComposition, { mobile: 'lg'; desktop: 'lg' | 'xl' }> = {
|
|
420
|
+
person: { mobile: 'lg', desktop: 'xl' },
|
|
421
|
+
invoice: { mobile: 'lg', desktop: 'xl' },
|
|
422
|
+
mini: { mobile: 'lg', desktop: 'lg' },
|
|
423
|
+
};
|
|
424
|
+
|
|
425
|
+
export interface BannerActionProps {
|
|
426
|
+
href: string;
|
|
427
|
+
/** The action label — Button's maxChars 24 (`slots.actions`). */
|
|
428
|
+
children: string;
|
|
429
|
+
/** Leading icon. Defaults to `invoice-new` (`slots.actions.default`). */
|
|
430
|
+
icon?: IconName;
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* The Actions slot's default content: one Brand link button with a leading icon, sized
|
|
435
|
+
* by the enclosing Banner's Composition. Use it inside `<Banner>` only.
|
|
436
|
+
*/
|
|
437
|
+
const BannerAction = ({ href, children, icon = 'invoice-new' }: BannerActionProps) => {
|
|
438
|
+
const composition = React.useContext(BannerCompositionContext);
|
|
439
|
+
const slots = bannerVariants({ composition });
|
|
440
|
+
const sizes = ACTION_SIZES[composition];
|
|
441
|
+
|
|
442
|
+
const instances = [
|
|
443
|
+
{ size: sizes.mobile, button: slots.actionMobile(), label: slots.actionLabelMobile() },
|
|
444
|
+
{ size: sizes.desktop, button: slots.actionDesktop(), label: slots.actionLabelDesktop() },
|
|
445
|
+
];
|
|
446
|
+
|
|
447
|
+
return (
|
|
448
|
+
<>
|
|
449
|
+
{instances.map(({ size, button, label }, index) => (
|
|
450
|
+
<Button
|
|
451
|
+
key={index}
|
|
452
|
+
variant="brand"
|
|
453
|
+
size={size}
|
|
454
|
+
asChild
|
|
455
|
+
data-fods-part="action"
|
|
456
|
+
className={cn(slots.action(), button)}
|
|
457
|
+
>
|
|
458
|
+
<a href={href}>
|
|
459
|
+
<Icon name={icon} />
|
|
460
|
+
{/* The native branch's label span: asChild keeps children untouched,
|
|
461
|
+
so the label contract has to be restated here. */}
|
|
462
|
+
<span className={label}>{children}</span>
|
|
463
|
+
</a>
|
|
464
|
+
</Button>
|
|
465
|
+
))}
|
|
466
|
+
</>
|
|
467
|
+
);
|
|
468
|
+
};
|
|
469
|
+
BannerAction.displayName = 'BannerAction';
|
|
470
|
+
|
|
471
|
+
const Banner = React.forwardRef<HTMLElement, BannerProps>((props, ref) => {
|
|
472
|
+
const {
|
|
473
|
+
composition = 'person',
|
|
474
|
+
surface = 'brand',
|
|
475
|
+
heading,
|
|
476
|
+
headingLevel,
|
|
477
|
+
detail,
|
|
478
|
+
character,
|
|
479
|
+
invoiceIllustration,
|
|
480
|
+
children,
|
|
481
|
+
actionsForm,
|
|
482
|
+
className,
|
|
483
|
+
...rest
|
|
484
|
+
} = props;
|
|
485
|
+
|
|
486
|
+
const slots = bannerVariants({ composition, surface });
|
|
487
|
+
const isMini = composition === 'mini';
|
|
488
|
+
// `??` would let an empty string through and render an empty paragraph.
|
|
489
|
+
const hasDetail = !isMini && detail != null && detail.trim() !== '';
|
|
490
|
+
|
|
491
|
+
const invoice = (
|
|
492
|
+
<div data-fods-part="invoice" className={slots.invoice()}>
|
|
493
|
+
<div data-fods-part="invoice-sheet-left" className={slots.invoiceSheetLeft()}>
|
|
494
|
+
{invoiceIllustration?.left}
|
|
495
|
+
</div>
|
|
496
|
+
<div data-fods-part="invoice-sheet-right" className={slots.invoiceSheetRight()}>
|
|
497
|
+
{invoiceIllustration?.right}
|
|
498
|
+
</div>
|
|
499
|
+
</div>
|
|
500
|
+
);
|
|
501
|
+
|
|
502
|
+
/*
|
|
503
|
+
* The delegated Promo Surface Layout follows where the copy sits (intent.rules[2]).
|
|
504
|
+
* Person and Mini swap two instances — PromoSurface turns `layout` into inline custom
|
|
505
|
+
* properties, which cannot carry a media query (same reason as Hero's Visual=On).
|
|
506
|
+
* Person: Top below LG, Side from LG. Mini: Top below MD, Side from MD.
|
|
507
|
+
* Invoice: one Vertical instance at every breakpoint.
|
|
508
|
+
*/
|
|
509
|
+
let surfaceLayer: React.ReactNode;
|
|
510
|
+
if (composition === 'invoice') {
|
|
511
|
+
surfaceLayer = <PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />;
|
|
512
|
+
} else if (isMini) {
|
|
513
|
+
surfaceLayer = (
|
|
514
|
+
<>
|
|
515
|
+
<PromoSurface layout="top" surface={surface} className="absolute inset-0 md:hidden" />
|
|
516
|
+
<PromoSurface layout="side" surface={surface} className="absolute inset-0 hidden md:block" />
|
|
517
|
+
</>
|
|
518
|
+
);
|
|
519
|
+
} else {
|
|
520
|
+
surfaceLayer = (
|
|
521
|
+
<>
|
|
522
|
+
<PromoSurface layout="top" surface={surface} className="absolute inset-0 lg:hidden" />
|
|
523
|
+
<PromoSurface layout="side" surface={surface} className="absolute inset-0 hidden lg:block" />
|
|
524
|
+
</>
|
|
525
|
+
);
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
// typography.runs: Display/D2 on Person and Invoice, Display/D3 on Mini. Two literal
|
|
529
|
+
// branches so each part marker can be read statically.
|
|
530
|
+
const headingNode = isMini ? (
|
|
531
|
+
<Heading level={headingLevel} size="d3" data-fods-part="mini-heading" className={slots.heading()}>
|
|
532
|
+
{heading}
|
|
533
|
+
</Heading>
|
|
534
|
+
) : (
|
|
535
|
+
<Heading level={headingLevel} size="d2" data-fods-part="heading" className={slots.heading()}>
|
|
536
|
+
{heading}
|
|
537
|
+
</Heading>
|
|
538
|
+
);
|
|
539
|
+
|
|
540
|
+
const actions = actionsForm ? (
|
|
541
|
+
<form {...actionsForm} data-fods-part="actions" className={slots.actions()}>
|
|
542
|
+
{children}
|
|
543
|
+
</form>
|
|
544
|
+
) : (
|
|
545
|
+
<div data-fods-part="actions" className={slots.actions()}>
|
|
546
|
+
{children}
|
|
547
|
+
</div>
|
|
548
|
+
);
|
|
549
|
+
|
|
550
|
+
return (
|
|
551
|
+
// Unnamed on purpose, like Hero: a named section would add a `region` landmark;
|
|
552
|
+
// the heading already labels the content.
|
|
553
|
+
<section
|
|
554
|
+
ref={ref}
|
|
555
|
+
data-fods-component="banner"
|
|
556
|
+
data-fods-part="root"
|
|
557
|
+
className={cn(slots.root(), className)}
|
|
558
|
+
{...rest}
|
|
559
|
+
>
|
|
560
|
+
<div data-fods-part="panel" className={slots.panel()}>
|
|
561
|
+
{surfaceLayer}
|
|
562
|
+
|
|
563
|
+
{/* Decorative campaign artwork the app supplies — the copy carries the message,
|
|
564
|
+
so the whole layer is aria-hidden. Mini has none. */}
|
|
565
|
+
{!isMini && (
|
|
566
|
+
<div aria-hidden="true" data-fods-part="visual" className={slots.visual()}>
|
|
567
|
+
{composition === 'person' ? (
|
|
568
|
+
<div data-fods-part="artwork" className={slots.artwork()}>
|
|
569
|
+
{invoice}
|
|
570
|
+
<div data-fods-part="character" className={slots.character()}>
|
|
571
|
+
{character}
|
|
572
|
+
</div>
|
|
573
|
+
</div>
|
|
574
|
+
) : (
|
|
575
|
+
invoice
|
|
576
|
+
)}
|
|
577
|
+
</div>
|
|
578
|
+
)}
|
|
579
|
+
|
|
580
|
+
<div data-fods-part="text-column" className={slots.textColumn()}>
|
|
581
|
+
{isMini ? (
|
|
582
|
+
headingNode
|
|
583
|
+
) : (
|
|
584
|
+
<div data-fods-part="copy" className={slots.copy()}>
|
|
585
|
+
{headingNode}
|
|
586
|
+
{hasDetail && (
|
|
587
|
+
<p data-fods-part="body" className={slots.body()}>
|
|
588
|
+
{detail}
|
|
589
|
+
</p>
|
|
590
|
+
)}
|
|
591
|
+
</div>
|
|
592
|
+
)}
|
|
593
|
+
|
|
594
|
+
<BannerCompositionContext.Provider value={composition}>{actions}</BannerCompositionContext.Provider>
|
|
595
|
+
</div>
|
|
596
|
+
</div>
|
|
597
|
+
</section>
|
|
598
|
+
);
|
|
599
|
+
});
|
|
600
|
+
Banner.displayName = 'Banner';
|
|
601
|
+
|
|
602
|
+
export { Banner, BannerAction, bannerVariants };
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export {
|
|
2
|
+
Banner,
|
|
3
|
+
BannerAction,
|
|
4
|
+
bannerVariants,
|
|
5
|
+
type BannerProps,
|
|
6
|
+
type BannerPitchProps,
|
|
7
|
+
type BannerPersonProps,
|
|
8
|
+
type BannerInvoiceProps,
|
|
9
|
+
type BannerMiniProps,
|
|
10
|
+
type BannerInvoiceIllustration,
|
|
11
|
+
type BannerActionProps,
|
|
12
|
+
type BannerComposition,
|
|
13
|
+
type BannerSurface,
|
|
14
|
+
} from './Banner';
|