@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,807 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
4
|
+
import { cn } from '../../internal/utils';
|
|
5
|
+
import { PromoSurface, type PromoSurfaceSurface } from '../promo-surface/PromoSurface';
|
|
6
|
+
import { useEnterOnView } from '../../internal/useEnterOnView';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Hero — the first-screen panel of a public page (`hero.manifest.json`, organism,
|
|
10
|
+
* v1.5.4, `kind: "region"`).
|
|
11
|
+
*
|
|
12
|
+
* A promo plaque carrying the page's single claim, at most two actions and — where the
|
|
13
|
+
* page has one — one image. Landing pages, the homepage, the news index, the register
|
|
14
|
+
* search. Never an in-app card, section or callout: the plaque comes from Promo
|
|
15
|
+
* Surface, a public-page-only atom (`intent.whenToUse`).
|
|
16
|
+
*
|
|
17
|
+
* ## No chrome of its own
|
|
18
|
+
*
|
|
19
|
+
* The fill, the tiled pattern and the veil are delegated WHOLE to `<PromoSurface>`.
|
|
20
|
+
* `container.note` is explicit that the root has no fill and no border — `--bg-primary`
|
|
21
|
+
* is the page canvas *behind* the component, not chrome. Per `delivery.react` the
|
|
22
|
+
* surface renders as "a sibling background layer, absolutely positioned to the panel's
|
|
23
|
+
* bounds", so the text column and the image are siblings ABOVE it, never inside it.
|
|
24
|
+
*
|
|
25
|
+
* Because an absolutely positioned sibling paints over static in-flow siblings, the
|
|
26
|
+
* content layers (`text-column`, `image`) are `relative`. Same trick ListRow /
|
|
27
|
+
* ActionRow use for their `::before` wash — no z-index needed.
|
|
28
|
+
*
|
|
29
|
+
* ## Axes: Breakpoint x Visual (+ sparse Actions width), 12 variants — only two are props
|
|
30
|
+
*
|
|
31
|
+
* `intent.sizing`: "No size axis — Breakpoint IS the sizing". The five breakpoints are
|
|
32
|
+
* pure CSS responsiveness, so there is no `size` and no `breakpoint` prop. Figma
|
|
33
|
+
* breakpoint -> Tailwind prefix: Mobile 390 = unprefixed, SM 600 = `sm:`, MD 720 =
|
|
34
|
+
* `md:`, LG 960 = `lg:`, XL 1270 = `xl:`.
|
|
35
|
+
*
|
|
36
|
+
* `visual` IS a prop, and a discriminated union rather than a boolean, because
|
|
37
|
+
* `intent.rules[1]` / `regions.image.note` / `intent.variants` all say the same thing
|
|
38
|
+
* three times: "An empty Image slot is not a centred hero — Visual=Off is the centred
|
|
39
|
+
* composition, built centred from the start, not an image slot left empty beside a
|
|
40
|
+
* full-width text column." It therefore has NO default: the page has to make the
|
|
41
|
+
* compositional choice consciously, and the union makes TypeScript enforce it (no
|
|
42
|
+
* runtime guard required).
|
|
43
|
+
*
|
|
44
|
+
* ## Booleans are slots
|
|
45
|
+
*
|
|
46
|
+
* The Figma booleans `Kicker` / `Body` / `Actions` / `Format icon` / `Sub`
|
|
47
|
+
* (`properties[]`) map onto slot PRESENCE — an undefined slot does not render. A Figma
|
|
48
|
+
* boolean plus an instance swap is one slot prop, never two props.
|
|
49
|
+
*
|
|
50
|
+
* ## No states
|
|
51
|
+
*
|
|
52
|
+
* `intent.states`: no interaction states on the shell. No hover, no active, no
|
|
53
|
+
* disabled, no loading — whatever lands in `actions` / `formatIcon` / `sub` owns its
|
|
54
|
+
* own states.
|
|
55
|
+
*
|
|
56
|
+
* ## Motion — one entrance, once
|
|
57
|
+
*
|
|
58
|
+
* `motion.enter` (1.5.2): kicker → heading → body → CTA fade in one after another over
|
|
59
|
+
* --duration-slow / --easing-enter, each settling --space-200 up into place; at
|
|
60
|
+
* Visual=On the image follows the text and only fades. It plays once, on first viewport
|
|
61
|
+
* entry (IntersectionObserver 0.3) — `useEnterOnView` drives `data-hero-motion` on the
|
|
62
|
+
* root and the pieces read it through the named group `hero`. The stagger has no token
|
|
63
|
+
* (manifest `gaps[]`), so each piece carries its step in `--hero-step` and the keyframe
|
|
64
|
+
* derives the delay from --duration-instant (the theme's `hero-enter-*`). The
|
|
65
|
+
* Format icon and `sub` are not in the sequence and never move. Every gating class is
|
|
66
|
+
* `motion-safe:`: under reduced motion the content is there at once, no fade-up.
|
|
67
|
+
* (`tailwindcss-animate` is not installed, so the keyframes are named, not `animate-in`.)
|
|
68
|
+
*/
|
|
69
|
+
const heroVariants = tv({
|
|
70
|
+
slots: {
|
|
71
|
+
root: [
|
|
72
|
+
// No fill, no border: container.note — --bg-primary is the page canvas behind the
|
|
73
|
+
// component, not chrome. No `mx-auto` either: the root is full width of whatever
|
|
74
|
+
// container it is dropped into, and that container does the centring.
|
|
75
|
+
// `group/hero` — the entrance pieces read the root's `data-hero-motion`.
|
|
76
|
+
'group/hero flex w-full flex-col',
|
|
77
|
+
/*
|
|
78
|
+
* VERTICAL ONLY. The horizontal half of what the manifest draws on this root — the
|
|
79
|
+
* 16/24/32/40 side gutter and the 1270/960/720/600 width ladder (intent.sizing) — is
|
|
80
|
+
* the PAGE CONTAINER, not chrome of this component. container.note says so itself:
|
|
81
|
+
* the root side padding is "the same 16/24/32/40/40 ladder Nav Bar cites", whose
|
|
82
|
+
* "code equivalent" it hands to layout-system.md — i.e. the layout layer. That layer
|
|
83
|
+
* is the consuming page's own container, and Hero repeating the ladder inside it made
|
|
84
|
+
* the plaque narrower than the page content
|
|
85
|
+
* (720 wide at an 900px viewport against a 786 feed). Storybook has no page container, so
|
|
86
|
+
* meta.decorators supplies the same container and the breakpoint stories still
|
|
87
|
+
* reproduce their Figma artboards.
|
|
88
|
+
*
|
|
89
|
+
* What stays is the root's own top/bottom band (container.note): Mobile 16 /
|
|
90
|
+
* --space-600, SM and up 24 / --space-800.
|
|
91
|
+
*/
|
|
92
|
+
'py-600 sm:py-800',
|
|
93
|
+
// Root gap = panel -> sub (container.note): --space-800 at MD/SM/Mobile,
|
|
94
|
+
// --space-900 at XL/LG.
|
|
95
|
+
'gap-800 lg:gap-900',
|
|
96
|
+
],
|
|
97
|
+
panel: [
|
|
98
|
+
// `relative` so the absolutely positioned Promo Surface layers resolve against the
|
|
99
|
+
// panel box (delivery.react: sized to the panel bounds).
|
|
100
|
+
'relative flex flex-col',
|
|
101
|
+
// regions.panel.note: radius --radius-800, matching Promo Surface.
|
|
102
|
+
'rounded-800',
|
|
103
|
+
/*
|
|
104
|
+
* The plaque's own vertical padding — 64 / --space-1200 — and it exists ONLY in the
|
|
105
|
+
* stacked composition. From `lg` up the text column sits BESIDE the image and carries
|
|
106
|
+
* the whole vertical rhythm itself (40 at LG, 64 at XL), so the panel goes back to
|
|
107
|
+
* zero; below `lg` the copy sits ABOVE the image and Figma adds this band on the panel
|
|
108
|
+
* on top of the text column's own 16/24.
|
|
109
|
+
*
|
|
110
|
+
* `pt` and not `py`: the bottom belongs to the Visual=Off arm only. At Visual=On the
|
|
111
|
+
* image is flush with the plaque's rounded bottom edge, so a bottom padding here would
|
|
112
|
+
* lift it off the edge — measured on 7252:122568 (Mobile) and 7308:123115 (MD), both
|
|
113
|
+
* `pt-[var(--space/1200)]` with no `pb`.
|
|
114
|
+
*
|
|
115
|
+
* regions.panel.padding (1.1.0) records it: "MD, SM and Mobile carry --space-1200/64
|
|
116
|
+
* top and bottom; XL and LG carry none... At Visual=On the bottom padding is dropped
|
|
117
|
+
* (top only) so the image meets the rounded bottom edge." The resulting distance from
|
|
118
|
+
* the plaque edge to the kicker (XL 64 / LG 40 / MD 88 / SM 88 / Mobile 80) is
|
|
119
|
+
* NON-MONOTONIC on purpose - the stacked composition gets more air above the kicker
|
|
120
|
+
* than XL does.
|
|
121
|
+
*/
|
|
122
|
+
'pt-1200 lg:pt-0',
|
|
123
|
+
// Deliberately NO overflow-hidden here. The Format icon bleeds over this very edge
|
|
124
|
+
// by design (intent.rules[3], "not a bug, a signature bleed"), so clipping the panel
|
|
125
|
+
// would erase the signature. The clip the image needs lives on the image slot
|
|
126
|
+
// instead, where it is the only thing being clipped.
|
|
127
|
+
],
|
|
128
|
+
// The plaque ink lives on the PANEL, not on the root, on purpose: chrome.ink pairs the
|
|
129
|
+
// ink with the FILL, and `sub` sits OUTSIDE the fill (regions.sub.note: "page chrome,
|
|
130
|
+
// not plaque chrome"), so it must not inherit the plaque ink.
|
|
131
|
+
textColumn: [
|
|
132
|
+
// `relative` so the in-flow content paints ABOVE the absolutely positioned surface
|
|
133
|
+
// siblings; a positioned sibling otherwise paints over static content.
|
|
134
|
+
'relative flex flex-col',
|
|
135
|
+
// regions.text-column.gap — copy block -> Actions. 32, not the 16 the runs inside the
|
|
136
|
+
// copy use: once the D2 ladder split those into 8 and 16 (see the `text` slot), the
|
|
137
|
+
// break before Actions had to read as visibly larger than either of them (1.3.0).
|
|
138
|
+
'gap-900',
|
|
139
|
+
// regions.text-column.padding, per breakpoint. Mobile 24 L/R + 16 T/B; MD and SM are
|
|
140
|
+
// identical at 32 L/R + 24 T/B; LG 40 all round; XL 64 T/B.
|
|
141
|
+
//
|
|
142
|
+
// The XL HORIZONTAL row is deliberately absent here: the manifest conditions the
|
|
143
|
+
// asymmetric 64 left / 24 right on the variant — "XL at Visual=On... the one
|
|
144
|
+
// asymmetric case, opening toward the image" — so it lives on the `visual.on` arm.
|
|
145
|
+
// "XL at Visual=Off: --space-1000/40 left+right", which is what `lg:p-1000` already
|
|
146
|
+
// gives: the centred composition has nothing to open toward, and the asymmetry would
|
|
147
|
+
// throw the copy 20px off the panel's axis.
|
|
148
|
+
//
|
|
149
|
+
// Mobile top/bottom is --space-600. The manifest used to name the Layout-collection
|
|
150
|
+
// side-padding var there; 1.1.0 replaced it with the --space token, since that var is
|
|
151
|
+
// the container's HORIZONTAL token and was being read off its own axis.
|
|
152
|
+
'px-800 py-600 sm:px-900 sm:py-800 lg:p-1000 xl:py-1200',
|
|
153
|
+
],
|
|
154
|
+
formatIcon: [
|
|
155
|
+
// Decorative art in a fixed box. intent.rules[2]: the ONE slot that is never
|
|
156
|
+
// stretched, everything else in the anatomy is auto-layout-sized.
|
|
157
|
+
'shrink-0',
|
|
158
|
+
// intent.rules[2] (1.5.1): a SQUARE 48x48 box (--size-illustration-spot) at every breakpoint.
|
|
159
|
+
'size-illustration-spot',
|
|
160
|
+
// The artwork is FITTED into the box (object-fit: contain), never cropped — cover
|
|
161
|
+
// would cut the sides off any mark whose ratio differs from the box. The slot owns
|
|
162
|
+
// the fit, so consumers pass a bare <img alt="">.
|
|
163
|
+
'[&_svg]:size-full [&_img]:size-full [&_img]:object-contain',
|
|
164
|
+
],
|
|
165
|
+
/*
|
|
166
|
+
* The copy block. regions.text-column.note (1.2.0) makes it TWO-TIER, matching the
|
|
167
|
+
* Heading Group molecule's D2 gap ladder: a `title-group` (kicker + heading) nested
|
|
168
|
+
* inside this block, which then holds title-group + body. It used to be one flat
|
|
169
|
+
* --space-500 (12) across all three runs.
|
|
170
|
+
*
|
|
171
|
+
* Figma names the outer frame `text`; the part keeps the name `copy` the manifest uses
|
|
172
|
+
* in prose ("the copy block") and the parts map already measures.
|
|
173
|
+
*/
|
|
174
|
+
copy: [
|
|
175
|
+
'flex flex-col',
|
|
176
|
+
// title-group -> body.
|
|
177
|
+
'gap-600',
|
|
178
|
+
// The 580px measure — notes[2]: "--ds-content-narrow, the system measure — not a
|
|
179
|
+
// component-owned raw value". Bound to the token, not restated as a literal.
|
|
180
|
+
'max-w-content-narrow',
|
|
181
|
+
],
|
|
182
|
+
titleGroup: [
|
|
183
|
+
'flex flex-col',
|
|
184
|
+
// kicker -> heading.
|
|
185
|
+
'gap-400',
|
|
186
|
+
],
|
|
187
|
+
kicker: [
|
|
188
|
+
// text.kicker: Caveat 20/26 at Mobile stepping to 32/40 at XL. --font-decorative
|
|
189
|
+
// (Caveat) reaches Tailwind as `font-caveat`, added to the config with this
|
|
190
|
+
// component as its first consumer.
|
|
191
|
+
'font-caveat',
|
|
192
|
+
// 20px = --font-size-lg = text-body-xl; 32px = --font-size-4xl = text-heading-xxl.
|
|
193
|
+
//
|
|
194
|
+
// The LEADING IS PX, and that is the sanctioned form, not a workaround. text-styles
|
|
195
|
+
// (Decorative/Caveat/32 and /20) sets lineHeight to null with the reason: "Caveat
|
|
196
|
+
// binds px leading on purpose — its sizes are not responsive, so px cannot drift, and
|
|
197
|
+
// a ratio token for one decorative style would widen the scale for nothing."
|
|
198
|
+
// --leading-compact is 1.3, which renders Caveat/32 at 41.6 rather than the drawn 40;
|
|
199
|
+
// Caveat/20 coincides with it at 26 but is written px too, so one rule stays one rule.
|
|
200
|
+
//
|
|
201
|
+
// Repeated at `md:` because `text-heading-xxl` ships --leading-loose inside its
|
|
202
|
+
// fontSize tuple and Tailwind emits every `md:` rule after every unprefixed one.
|
|
203
|
+
// fods-lint-disable-next-line Caveat px leading (26 at Mobile / 40 from MD) per spec/02-tokens/text-styles.json — Decorative/Caveat binds px on purpose, no leading token carries 1.25
|
|
204
|
+
'text-body-xl leading-[26px] md:text-heading-xxl md:leading-[40px]',
|
|
205
|
+
// motion.enter — first in the sequence (see the JSDoc § Motion).
|
|
206
|
+
'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
|
|
207
|
+
],
|
|
208
|
+
heading: [
|
|
209
|
+
// text.heading: Poppins Bold, 130% leading, 40px at XL down to 32px at Mobile.
|
|
210
|
+
//
|
|
211
|
+
// ONE class, no `md:` pair: --font-size-display-d2 already carries that step
|
|
212
|
+
// itself. tokens.css redefines the primitive inside `@media (max-width: 767px)`
|
|
213
|
+
// (2.5rem -> 2rem), so `text-display-d2` resolves to 40px from MD up and 32px
|
|
214
|
+
// below it — exactly the two numbers text.heading names.
|
|
215
|
+
//
|
|
216
|
+
// Do NOT reach for `text-display-d3` at mobile to spell the 32 out: d3 has its
|
|
217
|
+
// OWN mobile override (2rem -> 1.625rem), so `text-display-d3 md:text-display-d2`
|
|
218
|
+
// renders the claim at 26px below 768px, not 32px. Measured against
|
|
219
|
+
// the mobile override of --ds-font-size-display-d3 in tokens.css.
|
|
220
|
+
//
|
|
221
|
+
// No separate leading class: the `display-d2` scale entry in the theme
|
|
222
|
+
// carries --leading-compact (1.3 = the 130% the manifest asks for) in its
|
|
223
|
+
// fontSize tuple, and the ratio follows the mobile font-size step on its own.
|
|
224
|
+
'font-poppins font-bold',
|
|
225
|
+
'text-display-d2',
|
|
226
|
+
// A 5-to-7-word claim (text.heading) reads badly with one orphaned word.
|
|
227
|
+
// Bound to the token, not the bare `text-balance` utility: the value is the
|
|
228
|
+
// same today, but only the token is what `$textWrapRule` (Display + Heading
|
|
229
|
+
// styles bind --text-wrap-heading) lets a check against the manifest grade.
|
|
230
|
+
'[text-wrap:var(--text-wrap-heading)]',
|
|
231
|
+
// motion.enter — after the kicker.
|
|
232
|
+
'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
|
|
233
|
+
],
|
|
234
|
+
body: [
|
|
235
|
+
// typography.runs.body: Body/XL — 20px/150% at EVERY breakpoint. Not the Section
|
|
236
|
+
// Header D2 -> Body/L ladder default: a Promo Surface plaque's body is a lead
|
|
237
|
+
// paragraph, so it takes the promo-plaque carve-out (the same Body/XL Banner holds).
|
|
238
|
+
//
|
|
239
|
+
// ONE class, no `md:` pair and no explicit leading: Body/XL binds --font-size-lg with
|
|
240
|
+
// --leading-relaxed, which is exactly what `text-body-xl` already carries in its
|
|
241
|
+
// tuple (the theme). The Typography collection does not step Body styles,
|
|
242
|
+
// so 20 holds on Mobile too.
|
|
243
|
+
'font-inter',
|
|
244
|
+
'text-body-xl',
|
|
245
|
+
// Body/XL binds --text-wrap-body (pretty) via $textWrapRule — the token, not
|
|
246
|
+
// the bare `text-pretty` utility, so the binding is measurable.
|
|
247
|
+
'[text-wrap:var(--text-wrap-body)]',
|
|
248
|
+
// motion.enter — after the heading.
|
|
249
|
+
'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
|
|
250
|
+
],
|
|
251
|
+
actions: [
|
|
252
|
+
// slots.actions: ONE block stretched to the text column, up to 2 children,
|
|
253
|
+
// itemSpacing --space-400. The width cap is on the `actionsWidth` variant, not
|
|
254
|
+
// here — see that variant for why the slot has two.
|
|
255
|
+
'flex flex-wrap items-center gap-400',
|
|
256
|
+
'w-full',
|
|
257
|
+
// motion.enter — the CTA closes the text sequence.
|
|
258
|
+
'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-rise',
|
|
259
|
+
],
|
|
260
|
+
image: [
|
|
261
|
+
// `relative` for the same paint-order reason as the text column.
|
|
262
|
+
'relative flex w-full',
|
|
263
|
+
// overflow-hidden belongs HERE and not on the panel. regions.image says the graphic
|
|
264
|
+
// is clipped to the slot, but intent.rules[3] says the Format icon must overflow the
|
|
265
|
+
// panel edge; one `overflow-hidden` on the shared ancestor cannot do both, so the
|
|
266
|
+
// clip is scoped to the only child that needs it. The panel radius therefore has to
|
|
267
|
+
// be repeated on this slot, on the corners the image actually touches: the bottom
|
|
268
|
+
// pair while stacked, the right pair once it sits beside the text column. Corners are
|
|
269
|
+
// set one by one at lg: `lg:rounded-b-none` + `lg:rounded-r-800` collide on the
|
|
270
|
+
// bottom-right corner and the later rule in the built CSS zeroes it.
|
|
271
|
+
'overflow-hidden rounded-b-800 lg:rounded-bl-none lg:rounded-tr-800 lg:rounded-br-800',
|
|
272
|
+
// Bottom anchoring, required beside the text column and harmless while stacked (the
|
|
273
|
+
// graphic spans the full slot width there, so there is no slack to anchor). NOT
|
|
274
|
+
// items-stretch: stretching an img with height:auto would distort the 4:3 ratio.
|
|
275
|
+
'items-end justify-start',
|
|
276
|
+
// intent.sizing / regions.image / delivery.react (1.4.0), per COMPOSITION:
|
|
277
|
+
// stacked (MD, SM, Mobile) the graphic takes the slot WIDTH, height follows, in flow,
|
|
278
|
+
// nothing clipped.
|
|
279
|
+
'[&_img]:h-auto [&_img]:w-full',
|
|
280
|
+
// Side by side (XL, LG) it takes the slot HEIGHT, anchored bottom-left, width from
|
|
281
|
+
// the ratio; the overrun is cut on the RIGHT by this slot's overflow-hidden, and a
|
|
282
|
+
// narrower graphic leaves the remainder empty. Out of flow, so it never feeds the
|
|
283
|
+
// panel's HUG height — the text column sets it. `max-w-none` lifts the preflight
|
|
284
|
+
// `max-width: 100%`, which would otherwise squeeze the width and distort the ratio.
|
|
285
|
+
'lg:[&_img]:absolute lg:[&_img]:bottom-0 lg:[&_img]:left-0',
|
|
286
|
+
'lg:[&_img]:h-full lg:[&_img]:w-auto lg:[&_img]:max-w-none',
|
|
287
|
+
// motion.enter — after the text, and a fade only: the image never slides.
|
|
288
|
+
'motion-safe:group-data-[hero-motion=armed]/hero:opacity-0 motion-safe:group-data-[hero-motion=play]/hero:animate-hero-enter-fade',
|
|
289
|
+
],
|
|
290
|
+
sub: [
|
|
291
|
+
// regions.sub.note: row at XL/LG/MD, column at SM/Mobile, FILL width. The maxWidth
|
|
292
|
+
// numbers recorded there track the ROOT, which a FILL-width child of the root is
|
|
293
|
+
// already bounded by, so they are inert in code and no cap is emitted here.
|
|
294
|
+
// No gap: the slot takes exactly ONE child (a format switcher, a figure strip or a
|
|
295
|
+
// progress component), which owns its own internal spacing.
|
|
296
|
+
'flex w-full flex-col md:flex-row',
|
|
297
|
+
],
|
|
298
|
+
},
|
|
299
|
+
variants: {
|
|
300
|
+
/*
|
|
301
|
+
* Which content band the actions block is capped to.
|
|
302
|
+
*
|
|
303
|
+
* `axes.actions-width` (1.3.0): Narrow binds --ds-content-narrow (580, the default),
|
|
304
|
+
* Medium binds --ds-content-medium (786, the width a featured card is drawn at).
|
|
305
|
+
* 580 is "the measure" — right for the two prose-scale fillings, a button group
|
|
306
|
+
* or a search field, which should not run wider than the claim above them.
|
|
307
|
+
*
|
|
308
|
+
* Featured content is the case it does not fit: the featured-content hero (Figma:
|
|
309
|
+
* node 283:7000) fills the slot with a bordered card 786 wide,
|
|
310
|
+
* centred in the 1190 panel (x=202, 1190 − 2·202 = 786). At 580 that card would clamp
|
|
311
|
+
* and re-centre, which is not the design.
|
|
312
|
+
*
|
|
313
|
+
* SPARSE on purpose — the axis exists only at XL·Off and LG·Off, "the two cells whose
|
|
314
|
+
* text column fits 786"; every other cell's column is narrower than the Narrow cap
|
|
315
|
+
* already. The copy block keeps its 580 prose measure on both values.
|
|
316
|
+
*/
|
|
317
|
+
actionsWidth: {
|
|
318
|
+
narrow: { actions: 'max-w-content-narrow' },
|
|
319
|
+
medium: { actions: 'max-w-content-medium' },
|
|
320
|
+
},
|
|
321
|
+
/*
|
|
322
|
+
* Ink follows the plaque fill (promo-surface.manifest.json chrome.ink). Mixing one
|
|
323
|
+
* surface fill with another surface ink is the failure that axis exists to prevent.
|
|
324
|
+
*
|
|
325
|
+
* `chrome.ink` is the PANEL's ink, not every run's: on the two LIGHT plaques the copy
|
|
326
|
+
* carries two inks — heading --text-primary, kicker and body
|
|
327
|
+
* --secondary-tint-foreground, which is the token documented for "text inside
|
|
328
|
+
* blue-tinted badges, banners, tinted sections" and the one --secondary-subtle pairs
|
|
329
|
+
* itself with. The manifest has nowhere to state a per-run ink (banner.manifest.json
|
|
330
|
+
* records the same gap as BLOCKED on schema shape), so it stays here.
|
|
331
|
+
*
|
|
332
|
+
* The DARK plaques keep inheriting the panel ink: blue/900 on a blue/600 or blue/900
|
|
333
|
+
* fill is unreadable, and `chrome.ink` is unambiguous for those two.
|
|
334
|
+
*/
|
|
335
|
+
surface: {
|
|
336
|
+
brand: {
|
|
337
|
+
panel: 'text-text-primary',
|
|
338
|
+
kicker: 'text-secondary-tint-foreground',
|
|
339
|
+
body: 'text-secondary-tint-foreground',
|
|
340
|
+
},
|
|
341
|
+
utility: {
|
|
342
|
+
panel: 'text-text-primary',
|
|
343
|
+
kicker: 'text-secondary-tint-foreground',
|
|
344
|
+
body: 'text-secondary-tint-foreground',
|
|
345
|
+
},
|
|
346
|
+
solid: { panel: 'text-secondary-foreground' },
|
|
347
|
+
inverse: { panel: 'text-text-inverted' },
|
|
348
|
+
},
|
|
349
|
+
// regions.panel.note. Visual=On: two children side by side at XL/LG, stacked at
|
|
350
|
+
// MD/SM/Mobile. Visual=Off: one child, centred, no image child at all.
|
|
351
|
+
visual: {
|
|
352
|
+
on: {
|
|
353
|
+
panel: 'lg:flex-row',
|
|
354
|
+
/*
|
|
355
|
+
* The side-by-side split, as a flex BASIS on both children rather than a fixed
|
|
356
|
+
* width on one of them.
|
|
357
|
+
*
|
|
358
|
+
* `intent.sizing` gives the text column a per-breakpoint px width and lets the
|
|
359
|
+
* image take "the rest": XL panel 1190 = 639 + 551 (53.7% / 46.3%), LG panel
|
|
360
|
+
* 880 = 480 + 400 (54.5% / 45.5%). At the container caps the two bases sum to
|
|
361
|
+
* the panel exactly, so these numbers reproduce Figma to the pixel.
|
|
362
|
+
*
|
|
363
|
+
* LG is "text column 480 (copy 400 plus --space-1000 on each side) / image 400"
|
|
364
|
+
* (1.4.0; 1.3.x said 400 for the column, which was the copy width).
|
|
365
|
+
*
|
|
366
|
+
* Why not `w-[639px] shrink-0` on the column with `flex-1` on the image — which
|
|
367
|
+
* is what this was first built as, and it was WRONG: `flex-1` is `flex: 1 1 0%`,
|
|
368
|
+
* so the image's basis is 0 and it absorbs the ENTIRE deficit whenever the panel
|
|
369
|
+
* comes out narrower than the cap. In the Storybook docs iframe (panel ~892px)
|
|
370
|
+
* that rendered a 639/892 = 72% text column against a squeezed image, nothing
|
|
371
|
+
* like the near-half split the design asks for.
|
|
372
|
+
*
|
|
373
|
+
* With a real basis on both and shrink on both, flexbox distributes any deficit
|
|
374
|
+
* in PROPORTION to the bases, so the ratio survives at any container width while
|
|
375
|
+
* still being exact at 1190 and 880. Growth cannot drift it either: at every
|
|
376
|
+
* breakpoint the root's own cap makes the panel equal the sum of the bases.
|
|
377
|
+
*/
|
|
378
|
+
textColumn: [
|
|
379
|
+
/*
|
|
380
|
+
* Alignment follows the COMPOSITION, not the Visual variant: stacked is
|
|
381
|
+
* centred, side-by-side is flush left. Verified against the Figma renders —
|
|
382
|
+
* MD·On (7308:123114) and Mobile·On (7252:122567) centre the kicker, heading
|
|
383
|
+
* and body, while LG·On (7308:123084) sets all three flush left. It is the same
|
|
384
|
+
* `lg` seam the Promo Surface layout swap uses above, and for the same reason:
|
|
385
|
+
* below it the copy sits ABOVE the image, so centring it is what balances the
|
|
386
|
+
* column; from `lg` up it sits BESIDE the image and centring would push the
|
|
387
|
+
* text away from the edge it should align to.
|
|
388
|
+
*
|
|
389
|
+
* regions.text-column.align (1.1.0) now says it in the manifest, in these terms:
|
|
390
|
+
* "Follows the COMPOSITION, not the Visual variant: stacked is centred (MD/SM/
|
|
391
|
+
* Mobile at Visual=On, and every Visual=Off), side-by-side is left (XL/LG at
|
|
392
|
+
* Visual=On). This is the same boundary regions.panel.note switches the Promo
|
|
393
|
+
* Surface Layout on." It closes with the trap this was first built into:
|
|
394
|
+
* "Reading 'Visual=On is the left-aligned composition' from intent.rules and
|
|
395
|
+
* applying it at every breakpoint is the wrong result."
|
|
396
|
+
*/
|
|
397
|
+
'items-center text-center lg:items-start lg:text-left',
|
|
398
|
+
'lg:grow-0 lg:shrink',
|
|
399
|
+
// fods-lint-disable-next-line LG text-column basis from intent.sizing (panel 880 = 480 + 400, a 400 copy plus 40 each side); a composition measure, no semantic space token reaches 480
|
|
400
|
+
'lg:basis-[480px]',
|
|
401
|
+
// fods-lint-disable-next-line XL text-column basis from intent.sizing (panel 1190 = 639 + 551); a composition measure, no semantic space token reaches 639
|
|
402
|
+
'xl:basis-[639px]',
|
|
403
|
+
// regions.text-column.padding, "XL at Visual=On: --space-1200/64 left+top+bottom,
|
|
404
|
+
// --space-800/24 right (the one asymmetric case, opening toward the image)". The
|
|
405
|
+
// manifest conditions it on the variant, which is why it is not in the base slot
|
|
406
|
+
// — see the padding comment there. `xl:` is emitted after `lg:`, so this overrides
|
|
407
|
+
// the symmetric `lg:p-1000` without depending on utility order inside one query.
|
|
408
|
+
'xl:pl-1200 xl:pr-800',
|
|
409
|
+
],
|
|
410
|
+
// The 580 measure cap is centred in the column while stacked and flush left once
|
|
411
|
+
// the column sits beside the image — same seam as the alignment above.
|
|
412
|
+
copy: 'mx-auto lg:mx-0',
|
|
413
|
+
// Actions follow the copy: a centred claim over left-aligned buttons reads as a
|
|
414
|
+
// mistake, and `slots.actions` calls the block "stretched to the text column",
|
|
415
|
+
// which centring does not change.
|
|
416
|
+
actions: 'justify-center lg:justify-start',
|
|
417
|
+
// intent.rules[3]: MD/SM/Mobile keep the icon in flow, centred above the kicker,
|
|
418
|
+
// "because there is no side margin left to bleed into". XL/LG hang it left of the
|
|
419
|
+
// text column, absolutely positioned, overflowing the panel edge. The text column
|
|
420
|
+
// is flush with the panel edge in this composition, so a negative left offset on
|
|
421
|
+
// the column IS the panel-edge overflow.
|
|
422
|
+
formatIcon: [
|
|
423
|
+
'self-center lg:absolute lg:self-auto',
|
|
424
|
+
// Top-aligned with the copy block, i.e. level with the kicker (1.4.0
|
|
425
|
+
// regions.text-column.note). The offset is therefore the text column's own top
|
|
426
|
+
// padding: 40 at LG, 64 at XL.
|
|
427
|
+
'lg:top-1000 xl:top-1200',
|
|
428
|
+
// LG overflows by 20 = --space-700.
|
|
429
|
+
'lg:-left-700',
|
|
430
|
+
// XL overflows by 19, not 20. notes[1] calls the 19-vs-20 difference intentional
|
|
431
|
+
// variation and says explicitly it is "not meant to be equalized to one identical
|
|
432
|
+
// value", so it is reproduced rather than rounded onto the grid.
|
|
433
|
+
// fods-lint-disable-next-line 19px XL signature bleed; notes[1] forbids equalizing it with the LG 20px value, and 19 is off the --space grid by design
|
|
434
|
+
'xl:-left-[19px]',
|
|
435
|
+
],
|
|
436
|
+
// Beside the text column from LG up; full panel width while stacked. The basis is
|
|
437
|
+
// the other half of the split above — the remainder of the panel at each cap
|
|
438
|
+
// (LG 880 − 480 = 400, XL 1190 − 639 = 551) — so a deficit is shared in
|
|
439
|
+
// proportion instead of landing entirely here. `min-w-0` still lets it go below
|
|
440
|
+
// its content width rather than pushing the panel wider.
|
|
441
|
+
image: [
|
|
442
|
+
'lg:min-w-0 lg:grow lg:shrink',
|
|
443
|
+
// fods-lint-disable-next-line LG image basis from intent.sizing (panel 880 − 480 text); a composition measure with no semantic space token
|
|
444
|
+
'lg:basis-[400px]',
|
|
445
|
+
// fods-lint-disable-next-line XL image basis from intent.sizing (panel 1190 − 639 text); a composition measure with no semantic space token
|
|
446
|
+
'xl:basis-[551px]',
|
|
447
|
+
],
|
|
448
|
+
},
|
|
449
|
+
off: {
|
|
450
|
+
// The centred composition, built centred (intent.rules[1]).
|
|
451
|
+
//
|
|
452
|
+
// The bottom half of the plaque's vertical band (see the `panel` slot for the top):
|
|
453
|
+
// with no image to reach the rounded bottom edge, the 64 / --space-1200 closes the
|
|
454
|
+
// plaque symmetrically while stacked, and goes to zero from `lg` up with the top.
|
|
455
|
+
panel: ['items-center text-center', 'pb-1200 lg:pb-0'],
|
|
456
|
+
textColumn: 'w-full items-center',
|
|
457
|
+
copy: 'mx-auto',
|
|
458
|
+
actions: 'mx-auto justify-center',
|
|
459
|
+
// No absolute bleed in this composition: with the text column centred, "left of
|
|
460
|
+
// the text column" lands INSIDE the plaque instead of over its edge, which is not
|
|
461
|
+
// the signature intent.rules[3] describes. The icon stays in flow and centred
|
|
462
|
+
// above the kicker at every breakpoint.
|
|
463
|
+
formatIcon: 'self-center',
|
|
464
|
+
},
|
|
465
|
+
},
|
|
466
|
+
},
|
|
467
|
+
defaultVariants: {
|
|
468
|
+
surface: 'brand',
|
|
469
|
+
actionsWidth: 'narrow',
|
|
470
|
+
},
|
|
471
|
+
});
|
|
472
|
+
|
|
473
|
+
/**
|
|
474
|
+
* The plaque tone, passed straight through to `<PromoSurface surface>`, which owns the
|
|
475
|
+
* fill. Hero only pairs the matching ink with it (`chrome.ink`).
|
|
476
|
+
*
|
|
477
|
+
* `solid` and `inverse` are DARK plaques, and two obligations ride on the consumer there
|
|
478
|
+
* (`intent.rules`):
|
|
479
|
+
*
|
|
480
|
+
* 1. ONE brand CTA, no secondary action — the same rule Banner holds. `Secondary` and
|
|
481
|
+
* `Tertiary` both ink their label with `--secondary`, which measures 1.33:1 on
|
|
482
|
+
* `--secondary-solid` and 1.59:1 on `--bg-inverse`; the label disappears and all that
|
|
483
|
+
* is left of the button is its border. No Button family is built for a dark ground and
|
|
484
|
+
* none is coming — the stance is compose, not recolour
|
|
485
|
+
* (`spec/06-patterns/inverse-surface.md`).
|
|
486
|
+
* 2. The default focus ring is under the 3:1 non-text floor there, so anything focusable
|
|
487
|
+
* composed into `actions` MUST bind `--outline-focus-inverse`
|
|
488
|
+
* (`focus-visible:outline-outline-focus-inverse`). It is `outline-*`, never `ring-*`:
|
|
489
|
+
* the floor wants an additive offset OUTLINE, and a ring is a box-shadow that would
|
|
490
|
+
* sit alongside the real one instead of replacing it. Hero cannot do that for you:
|
|
491
|
+
* it owns no focusable element and never overrides the focus behaviour of its slot
|
|
492
|
+
* content — see `ActionsBlock` in the stories for the shape. The obligation is
|
|
493
|
+
* Actions-only: `regions.sub.note` puts `sub` OUTSIDE the plaque fill, so a white
|
|
494
|
+
* inverse ring would be wrong there.
|
|
495
|
+
*/
|
|
496
|
+
export type HeroSurface = PromoSurfaceSurface;
|
|
497
|
+
|
|
498
|
+
/**
|
|
499
|
+
* The entrance order, one `--hero-step` per piece that is actually rendered — an absent
|
|
500
|
+
* kicker or body does not leave a gap in the sequence. Literal classes, so Tailwind sees
|
|
501
|
+
* them; five pieces at most (kicker, heading, body, actions, image).
|
|
502
|
+
*/
|
|
503
|
+
const ENTER_STEP = [
|
|
504
|
+
'[--hero-step:0]',
|
|
505
|
+
'[--hero-step:1]',
|
|
506
|
+
'[--hero-step:2]',
|
|
507
|
+
'[--hero-step:3]',
|
|
508
|
+
'[--hero-step:4]',
|
|
509
|
+
] as const;
|
|
510
|
+
|
|
511
|
+
type HeroEnterPart = 'kicker' | 'heading' | 'body' | 'actions' | 'image';
|
|
512
|
+
const HERO_ENTER_ORDER: readonly HeroEnterPart[] = ['kicker', 'heading', 'body', 'actions', 'image'];
|
|
513
|
+
|
|
514
|
+
/** The step class of every rendered piece, numbered in `HERO_ENTER_ORDER` over the present ones. */
|
|
515
|
+
const heroEnterSteps = (present: Record<HeroEnterPart, boolean>): Partial<Record<HeroEnterPart, string>> => {
|
|
516
|
+
const steps: Partial<Record<HeroEnterPart, string>> = {};
|
|
517
|
+
HERO_ENTER_ORDER.filter(part => present[part]).forEach((part, index) => {
|
|
518
|
+
steps[part] = ENTER_STEP[Math.min(index, ENTER_STEP.length - 1)];
|
|
519
|
+
});
|
|
520
|
+
return steps;
|
|
521
|
+
};
|
|
522
|
+
|
|
523
|
+
/**
|
|
524
|
+
* Which content band `actions` is capped to — `narrow` (580, the measure) for buttons
|
|
525
|
+
* and search fields, `medium` (786, the non-prose column) for a featured-content card.
|
|
526
|
+
* See the `actionsWidth` variant in the recipe for the reasoning.
|
|
527
|
+
*/
|
|
528
|
+
export type HeroActionsWidth = 'narrow' | 'medium';
|
|
529
|
+
|
|
530
|
+
export interface HeroBase extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
|
|
531
|
+
/**
|
|
532
|
+
* The page claim. Rendered as the page's `<h1>` (`delivery.react`), so there must be
|
|
533
|
+
* exactly one Hero per page. Wraps, ~70 characters (`text.heading`).
|
|
534
|
+
*/
|
|
535
|
+
heading: React.ReactNode;
|
|
536
|
+
/**
|
|
537
|
+
* The line ABOVE the heading. A plain text line, never a heading itself
|
|
538
|
+
* (`delivery.react`, `text.kicker`) — do not pass a heading element and do not give it
|
|
539
|
+
* `role="heading"`; that breaks the page heading order for screen-reader users.
|
|
540
|
+
* Wraps to 2 lines, ~60 characters.
|
|
541
|
+
*/
|
|
542
|
+
kicker?: React.ReactNode;
|
|
543
|
+
/**
|
|
544
|
+
* ONE block, not a row of loose buttons (`slots.actions`): a button group, a search
|
|
545
|
+
* field or a featured-content component, up to 2 children, stretched to the text
|
|
546
|
+
* column. The block keeps its own hover / focus / active / disabled states — see
|
|
547
|
+
* `surface` for the one obligation it inherits from the plaque.
|
|
548
|
+
*/
|
|
549
|
+
actions?: React.ReactNode;
|
|
550
|
+
/**
|
|
551
|
+
* The width cap on the `actions` block. Defaults to `narrow` (`--ds-content-narrow`,
|
|
552
|
+
* 580 = the measure), which is right for a button group or a search field. Set `medium`
|
|
553
|
+
* (`--ds-content-medium`, 786) only when the slot carries FEATURED CONTENT — a bordered
|
|
554
|
+
* card, which the measure would clamp and re-centre. Ignored when `actions` is not set.
|
|
555
|
+
*
|
|
556
|
+
* The axis is SPARSE upstream: `axes.actions-width` exists only at XL·Off and LG·Off,
|
|
557
|
+
* "the two cells whose text column fits 786" (`slots.actions.note`). Every other cell's
|
|
558
|
+
* column is narrower than the Narrow cap already, so `medium` has nothing to buy there.
|
|
559
|
+
* The copy block keeps its 580 prose measure on both values — only this slot swaps.
|
|
560
|
+
*/
|
|
561
|
+
actionsWidth?: HeroActionsWidth;
|
|
562
|
+
/**
|
|
563
|
+
* A document-format mark — Word / Excel / PDF / Sheets / Docs. A closed vocabulary by
|
|
564
|
+
* convention; Figma stopped enforcing it in 1.0.0 (`changelog`), the intent did not
|
|
565
|
+
* change: a format mark, not arbitrary art.
|
|
566
|
+
*
|
|
567
|
+
* ARTWORK, NOT A GLYPH. The slot holds the format's own mark artwork — the square
|
|
568
|
+
* Word / Excel / PDF / Sheets / Docs images a template landing page
|
|
569
|
+
* ships — not an icon glyph; Sheets and Docs are deliberately NOT being added to the
|
|
570
|
+
* icon set. `intent.rules[2]` (1.5.1) sizes the box a square 48×48 (`--size-illustration-spot`) at
|
|
571
|
+
* every breakpoint, and the slot fits the artwork into it (`object-fit: contain`), never
|
|
572
|
+
* crops it. Pass a bare `<img alt="">` — the slot owns geometry and fit.
|
|
573
|
+
*
|
|
574
|
+
* Purely decorative. The wrapper carries `aria-hidden="true"` because the format is
|
|
575
|
+
* always named in the copy, so the mark never carries its own accessible name.
|
|
576
|
+
*/
|
|
577
|
+
formatIcon?: React.ReactNode;
|
|
578
|
+
/**
|
|
579
|
+
* The strip UNDER the plaque — a format switcher, a figure strip or progress. It sits
|
|
580
|
+
* outside the Promo Surface fill: page chrome, not plaque chrome (`regions.sub.note`),
|
|
581
|
+
* so it does not inherit the plaque ink. Off unless the page opts in.
|
|
582
|
+
*/
|
|
583
|
+
sub?: React.ReactNode;
|
|
584
|
+
/** The plaque tone. Defaults to `brand`. */
|
|
585
|
+
surface?: HeroSurface;
|
|
586
|
+
className?: string;
|
|
587
|
+
}
|
|
588
|
+
|
|
589
|
+
/**
|
|
590
|
+
* The lead under the heading, in one of two mutually exclusive forms — a union rather than
|
|
591
|
+
* two loose optionals, so the compiler rejects passing both instead of the component having
|
|
592
|
+
* to pick a winner at runtime. Same device, and same reason, as the `visual` / `image` pair.
|
|
593
|
+
*
|
|
594
|
+
* `body` is the normal one: a node, rendered inside the component's own `<p>`.
|
|
595
|
+
*
|
|
596
|
+
* `bodyHtml` exists for ONE case — a lead that arrives as rich text from a CMS. Such a CMS wraps
|
|
597
|
+
* every `perex` in its own `<p>`, and a `<p>` inside a `<p>` is not merely invalid: the HTML
|
|
598
|
+
* parser splits it into siblings, so on a server-rendered page (`renderToString` on the
|
|
599
|
+
* server, `hydrateRoot` on the client) the parsed tree stops matching what React expects and
|
|
600
|
+
* the whole SSR tree is thrown away and repainted. This arm therefore renders a `<div>` — the
|
|
601
|
+
* CMS supplies the paragraph semantics itself, one level in.
|
|
602
|
+
*
|
|
603
|
+
* `<p>` is NOT a contract here, which is what makes this legal: `delivery.react` is the one
|
|
604
|
+
* place the manifest names elements and it names `<h1>` for the heading and `<img>` for the
|
|
605
|
+
* image — `body` is absent from it, `text.body` records only overflow and length, and
|
|
606
|
+
* `typography.runs.body` calls the lead a "paragraph" as a TYPOGRAPHIC reading (it is
|
|
607
|
+
* justifying Body/XL over Body/L), not as markup.
|
|
608
|
+
*
|
|
609
|
+
* `bodyHtml?: undefined` on the other arm, NOT `bodyHtml?: never` — for the reason already
|
|
610
|
+
* written out on `image` below.
|
|
611
|
+
*/
|
|
612
|
+
type HeroBodyProps =
|
|
613
|
+
| { body?: React.ReactNode; bodyHtml?: undefined }
|
|
614
|
+
/**
|
|
615
|
+
* TRUSTED, EDITORIAL HTML ONLY. This is the only `dangerouslySetInnerHTML` in the design
|
|
616
|
+
* system, and it stays that way on purpose: the string must come from a CMS the team
|
|
617
|
+
* controls, never from anything a visitor can write, and sanitising it is the caller's job
|
|
618
|
+
* — Hero cannot tell the two apart.
|
|
619
|
+
*
|
|
620
|
+
* `text.body` still holds: one lead paragraph, 3 lines / ~120 characters. Tailwind's
|
|
621
|
+
* preflight zeroes `<p>` margins, so two paragraphs would run together — the component
|
|
622
|
+
* deliberately adds no spacing for that, because the spec does not expect a second one.
|
|
623
|
+
*/
|
|
624
|
+
| { bodyHtml: string; body?: undefined };
|
|
625
|
+
|
|
626
|
+
/**
|
|
627
|
+
* `visual` has NO default. Visual=Off is not "Visual=On without an image", it is a
|
|
628
|
+
* different composition (`intent.rules[1]`), so the page has to choose.
|
|
629
|
+
*
|
|
630
|
+
* The `image` node is the consumer's own `<img>` or visual component, which means the
|
|
631
|
+
* ALT TEXT is the consumer's responsibility — and it is required: give it real alt text
|
|
632
|
+
* describing the page claim, not `alt=""` and not the file name. Hero cannot supply it,
|
|
633
|
+
* hence no `imageAlt` prop.
|
|
634
|
+
*/
|
|
635
|
+
export type HeroProps = HeroBase &
|
|
636
|
+
(
|
|
637
|
+
| { visual: 'on'; image: React.ReactNode }
|
|
638
|
+
// `image?: undefined`, NOT `image?: never`. Both forbid passing a node on the Off
|
|
639
|
+
// arm, which is the contract that matters, but `never` also rejects an explicit
|
|
640
|
+
// `image={undefined}` — so a caller that spreads a shared prop bag, and every
|
|
641
|
+
// Storybook story that overrides the meta-level `image`, could not turn the image
|
|
642
|
+
// off without a cast. Caught by `tsc` on the CentredNoVisual story.
|
|
643
|
+
| { visual: 'off'; image?: undefined }
|
|
644
|
+
) &
|
|
645
|
+
HeroBodyProps;
|
|
646
|
+
|
|
647
|
+
const Hero = React.forwardRef<HTMLElement, HeroProps>((props, ref) => {
|
|
648
|
+
// Annotating the binding pattern instead of casting: every arm of both unions is
|
|
649
|
+
// assignable to this shape (`image?: undefined` widens to `image?: React.ReactNode`, and
|
|
650
|
+
// the same for `bodyHtml?: undefined` against `string`), so `image`, `body` and `bodyHtml`
|
|
651
|
+
// can be destructured out of the rest props without an assertion.
|
|
652
|
+
const {
|
|
653
|
+
heading,
|
|
654
|
+
kicker,
|
|
655
|
+
body,
|
|
656
|
+
bodyHtml,
|
|
657
|
+
actions,
|
|
658
|
+
actionsWidth = 'narrow',
|
|
659
|
+
formatIcon,
|
|
660
|
+
sub,
|
|
661
|
+
surface = 'brand',
|
|
662
|
+
visual,
|
|
663
|
+
image,
|
|
664
|
+
className,
|
|
665
|
+
...rest
|
|
666
|
+
}: HeroBase & {
|
|
667
|
+
visual: 'on' | 'off';
|
|
668
|
+
image?: React.ReactNode;
|
|
669
|
+
body?: React.ReactNode;
|
|
670
|
+
bodyHtml?: string;
|
|
671
|
+
} = props;
|
|
672
|
+
|
|
673
|
+
const slots = heroVariants({ surface, visual, actionsWidth });
|
|
674
|
+
|
|
675
|
+
const rootRef = React.useRef<HTMLElement | null>(null);
|
|
676
|
+
const setRootRef = React.useCallback((node: HTMLElement | null) => {
|
|
677
|
+
rootRef.current = node;
|
|
678
|
+
if (typeof ref === 'function') ref(node);
|
|
679
|
+
else if (ref) ref.current = node;
|
|
680
|
+
}, [ref]);
|
|
681
|
+
const enter = useEnterOnView(rootRef);
|
|
682
|
+
const step = heroEnterSteps({
|
|
683
|
+
kicker: kicker != null,
|
|
684
|
+
heading: true,
|
|
685
|
+
body: bodyHtml != null || body != null,
|
|
686
|
+
actions: actions != null,
|
|
687
|
+
image: visual === 'on',
|
|
688
|
+
});
|
|
689
|
+
|
|
690
|
+
return (
|
|
691
|
+
// A plain <section>, left deliberately UNNAMED: an unnamed section is exposed as
|
|
692
|
+
// generic, while naming it would add a `region` landmark on top of the page's own
|
|
693
|
+
// banner/main structure. The <h1> below already labels this content.
|
|
694
|
+
<section
|
|
695
|
+
ref={setRootRef}
|
|
696
|
+
data-fods-component="hero"
|
|
697
|
+
data-fods-part="root"
|
|
698
|
+
className={cn(slots.root(), className)}
|
|
699
|
+
{...rest}
|
|
700
|
+
// After the rest props, so a consumer cannot shadow the entrance state by accident.
|
|
701
|
+
data-hero-motion={enter === 'static' ? undefined : enter}
|
|
702
|
+
>
|
|
703
|
+
<div data-fods-part="panel" className={slots.panel()}>
|
|
704
|
+
{visual === 'off' ? (
|
|
705
|
+
/*
|
|
706
|
+
* Visual=Off is a SINGLE surface instance: regions.panel.note pins
|
|
707
|
+
* Layout=Vertical to *every* Visual=Off variant, so there is nothing
|
|
708
|
+
* breakpoint-dependent left to switch.
|
|
709
|
+
*/
|
|
710
|
+
<PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />
|
|
711
|
+
) : (
|
|
712
|
+
/*
|
|
713
|
+
* Visual=On needs TWO instances, swapped by visibility at the `lg` boundary.
|
|
714
|
+
*
|
|
715
|
+
* Why not one: regions.panel.note pins Layout=Side at XL/LG and Layout=Top at
|
|
716
|
+
* MD/SM/Mobile, but PromoSurface takes `layout` as a PROP and turns it into
|
|
717
|
+
* inline custom properties (`--promo-veil-*`) for the veil geometry. An inline
|
|
718
|
+
* style cannot carry a media query, so a single instance can never be
|
|
719
|
+
* responsive — the layout has to be chosen in CSS, i.e. by rendering both and
|
|
720
|
+
* hiding one.
|
|
721
|
+
*
|
|
722
|
+
* Why `lg` (>=1024): Side covers XL+LG, Top covers MD/SM/Mobile, and `lg` is
|
|
723
|
+
* exactly that seam.
|
|
724
|
+
*
|
|
725
|
+
* Why it matters: the wrong Layout puts the decorative pattern UNDER the
|
|
726
|
+
* headline instead of clearing it (intent.rules[4]) — the single failure the
|
|
727
|
+
* veil exists to prevent.
|
|
728
|
+
*/
|
|
729
|
+
<>
|
|
730
|
+
<PromoSurface
|
|
731
|
+
layout="top"
|
|
732
|
+
surface={surface}
|
|
733
|
+
className="absolute inset-0 lg:hidden"
|
|
734
|
+
/>
|
|
735
|
+
<PromoSurface
|
|
736
|
+
layout="side"
|
|
737
|
+
surface={surface}
|
|
738
|
+
className="absolute inset-0 hidden lg:block"
|
|
739
|
+
/>
|
|
740
|
+
</>
|
|
741
|
+
)}
|
|
742
|
+
|
|
743
|
+
<div data-fods-part="text-column" className={slots.textColumn()}>
|
|
744
|
+
{formatIcon != null && (
|
|
745
|
+
<span
|
|
746
|
+
aria-hidden="true"
|
|
747
|
+
data-fods-part="format-icon"
|
|
748
|
+
className={slots.formatIcon()}
|
|
749
|
+
>
|
|
750
|
+
{formatIcon}
|
|
751
|
+
</span>
|
|
752
|
+
)}
|
|
753
|
+
<div data-fods-part="copy" className={slots.copy()}>
|
|
754
|
+
<div data-fods-part="title-group" className={slots.titleGroup()}>
|
|
755
|
+
{kicker != null && (
|
|
756
|
+
<p data-fods-part="kicker" className={cn(slots.kicker(), step.kicker)}>
|
|
757
|
+
{kicker}
|
|
758
|
+
</p>
|
|
759
|
+
)}
|
|
760
|
+
<h1 data-fods-part="heading" className={cn(slots.heading(), step.heading)}>
|
|
761
|
+
{heading}
|
|
762
|
+
</h1>
|
|
763
|
+
</div>
|
|
764
|
+
{/*
|
|
765
|
+
One part, two elements. `bodyHtml` takes the `<div>` because CMS rich text
|
|
766
|
+
brings its own `<p>` — see HeroBodyProps for why that cannot nest. Both carry
|
|
767
|
+
the SAME `data-fods-part` and the SAME recipe slot, so the parts map, the
|
|
768
|
+
S7c/d markup pairing and every typography assertion keep measuring one thing.
|
|
769
|
+
*/}
|
|
770
|
+
{bodyHtml != null ? (
|
|
771
|
+
<div
|
|
772
|
+
data-fods-part="body"
|
|
773
|
+
className={cn(slots.body(), step.body)}
|
|
774
|
+
dangerouslySetInnerHTML={{ __html: bodyHtml }}
|
|
775
|
+
/>
|
|
776
|
+
) : body != null ? (
|
|
777
|
+
<p data-fods-part="body" className={cn(slots.body(), step.body)}>
|
|
778
|
+
{body}
|
|
779
|
+
</p>
|
|
780
|
+
) : null}
|
|
781
|
+
</div>
|
|
782
|
+
{actions != null && (
|
|
783
|
+
<div data-fods-part="actions" className={cn(slots.actions(), step.actions)}>
|
|
784
|
+
{actions}
|
|
785
|
+
</div>
|
|
786
|
+
)}
|
|
787
|
+
</div>
|
|
788
|
+
|
|
789
|
+
{/* regions.image: absent entirely at Visual=Off — not hidden, not an empty slot. */}
|
|
790
|
+
{visual === 'on' && (
|
|
791
|
+
<div data-fods-part="image" className={cn(slots.image(), step.image)}>
|
|
792
|
+
{image}
|
|
793
|
+
</div>
|
|
794
|
+
)}
|
|
795
|
+
</div>
|
|
796
|
+
|
|
797
|
+
{sub != null && (
|
|
798
|
+
<div data-fods-part="sub" className={slots.sub()}>
|
|
799
|
+
{sub}
|
|
800
|
+
</div>
|
|
801
|
+
)}
|
|
802
|
+
</section>
|
|
803
|
+
);
|
|
804
|
+
});
|
|
805
|
+
Hero.displayName = 'Hero';
|
|
806
|
+
|
|
807
|
+
export { Hero, heroVariants };
|