@invoiceonline/ui-react 0.0.0 → 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 +77 -1
- package/dist/assets/label-brush-1.svg +6 -0
- package/dist/assets/pattern-dark.svg +113 -0
- package/dist/components/action-row/ActionRow.d.ts +178 -0
- package/dist/components/action-row/ActionRow.js +340 -0
- package/dist/components/action-row/index.d.ts +2 -0
- package/dist/components/action-row/index.js +1 -0
- package/dist/components/alert/Alert.d.ts +314 -0
- package/dist/components/alert/Alert.js +446 -0
- package/dist/components/alert/index.d.ts +2 -0
- package/dist/components/alert/index.js +1 -0
- package/dist/components/anchored-panel/AnchoredPanel.d.ts +41 -0
- package/dist/components/anchored-panel/AnchoredPanel.js +72 -0
- package/dist/components/anchored-panel/index.d.ts +3 -0
- package/dist/components/anchored-panel/index.js +3 -0
- package/dist/components/badge/Badge.d.ts +146 -0
- package/dist/components/badge/Badge.js +258 -0
- package/dist/components/badge/index.d.ts +2 -0
- package/dist/components/badge/index.js +1 -0
- package/dist/components/banner/Banner.d.ts +209 -0
- package/dist/components/banner/Banner.js +339 -0
- package/dist/components/banner/index.d.ts +2 -0
- package/dist/components/banner/index.js +1 -0
- package/dist/components/button/Button.d.ts +54 -0
- package/dist/components/button/Button.js +312 -0
- package/dist/components/button/index.d.ts +2 -0
- package/dist/components/button/index.js +1 -0
- package/dist/components/button-group/ButtonGroup.d.ts +187 -0
- package/dist/components/button-group/ButtonGroup.js +217 -0
- package/dist/components/button-group/index.d.ts +2 -0
- package/dist/components/button-group/index.js +1 -0
- package/dist/components/card-select/CardSelect.d.ts +274 -0
- package/dist/components/card-select/CardSelect.js +561 -0
- package/dist/components/card-select/CardSelectGroup.d.ts +92 -0
- package/dist/components/card-select/CardSelectGroup.js +72 -0
- package/dist/components/card-select/index.d.ts +3 -0
- package/dist/components/card-select/index.js +3 -0
- package/dist/components/checkbox/Checkbox.d.ts +104 -0
- package/dist/components/checkbox/Checkbox.js +194 -0
- package/dist/components/checkbox/index.d.ts +2 -0
- package/dist/components/checkbox/index.js +1 -0
- package/dist/components/chip/Chip.d.ts +250 -0
- package/dist/components/chip/Chip.js +441 -0
- package/dist/components/chip/index.d.ts +2 -0
- package/dist/components/chip/index.js +1 -0
- package/dist/components/column-header/ColumnHeader.d.ts +144 -0
- package/dist/components/column-header/ColumnHeader.js +209 -0
- package/dist/components/column-header/index.d.ts +2 -0
- package/dist/components/column-header/index.js +1 -0
- package/dist/components/combobox-field/Combobox.d.ts +104 -0
- package/dist/components/combobox-field/Combobox.js +355 -0
- package/dist/components/combobox-field/ComboboxField.d.ts +76 -0
- package/dist/components/combobox-field/ComboboxField.js +98 -0
- package/dist/components/combobox-field/index.d.ts +3 -0
- package/dist/components/combobox-field/index.js +3 -0
- package/dist/components/date-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 +351 -3
- package/src/components/action-row/ActionRow.mdx +686 -0
- package/src/components/action-row/ActionRow.stories.tsx +669 -0
- package/src/components/action-row/ActionRow.tsx +632 -0
- package/src/components/action-row/index.ts +9 -0
- package/src/components/alert/Alert.mdx +377 -0
- package/src/components/alert/Alert.stories.tsx +674 -0
- package/src/components/alert/Alert.tsx +579 -0
- package/src/components/alert/index.ts +13 -0
- package/src/components/anchored-panel/AnchoredPanel.mdx +381 -0
- package/src/components/anchored-panel/AnchoredPanel.stories.tsx +593 -0
- package/src/components/anchored-panel/AnchoredPanel.tsx +176 -0
- package/src/components/anchored-panel/index.ts +15 -0
- package/src/components/badge/Badge.mdx +487 -0
- package/src/components/badge/Badge.stories.tsx +375 -0
- package/src/components/badge/Badge.tsx +360 -0
- package/src/components/badge/index.ts +10 -0
- package/src/components/banner/Banner.mdx +704 -0
- package/src/components/banner/Banner.stories.tsx +448 -0
- package/src/components/banner/Banner.tsx +602 -0
- package/src/components/banner/index.ts +14 -0
- package/src/components/button/Button.mdx +286 -0
- package/src/components/button/Button.stories.tsx +381 -0
- package/src/components/button/Button.tsx +384 -0
- package/src/components/button/index.ts +1 -0
- package/src/components/button-group/ButtonGroup.mdx +512 -0
- package/src/components/button-group/ButtonGroup.stories.tsx +714 -0
- package/src/components/button-group/ButtonGroup.tsx +491 -0
- package/src/components/button-group/index.ts +10 -0
- package/src/components/card-select/CardSelect.mdx +662 -0
- package/src/components/card-select/CardSelect.stories.tsx +784 -0
- package/src/components/card-select/CardSelect.tsx +783 -0
- package/src/components/card-select/CardSelectGroup.tsx +169 -0
- package/src/components/card-select/index.ts +18 -0
- package/src/components/checkbox/Checkbox.mdx +269 -0
- package/src/components/checkbox/Checkbox.stories.tsx +306 -0
- package/src/components/checkbox/Checkbox.tsx +343 -0
- package/src/components/checkbox/index.ts +1 -0
- package/src/components/chip/Chip.mdx +683 -0
- package/src/components/chip/Chip.stories.tsx +734 -0
- package/src/components/chip/Chip.tsx +732 -0
- package/src/components/chip/index.ts +9 -0
- package/src/components/column-header/ColumnHeader.mdx +301 -0
- package/src/components/column-header/ColumnHeader.stories.tsx +319 -0
- package/src/components/column-header/ColumnHeader.tsx +287 -0
- package/src/components/column-header/index.ts +7 -0
- package/src/components/combobox-field/Combobox.tsx +693 -0
- package/src/components/combobox-field/ComboboxField.mdx +525 -0
- package/src/components/combobox-field/ComboboxField.stories.tsx +502 -0
- package/src/components/combobox-field/ComboboxField.tsx +259 -0
- package/src/components/combobox-field/index.ts +12 -0
- package/src/components/date-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,704 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as BannerStories from './Banner.stories';
|
|
3
|
+
import { ViewportFrame } from '../../storybook/viewportFrame';
|
|
4
|
+
|
|
5
|
+
<Meta of={BannerStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# Banner
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** organism (Web layer, `spec/07-web/`)
|
|
12
|
+
- **Kind:** region
|
|
13
|
+
- **Status:** draft
|
|
14
|
+
- **Tokens used:** `--border-width-100`, `--border-width-200`, `--font-body`, `--font-heading`, `--font-size-display-d1`, `--font-size-display-d2`, `--font-size-display-d3`, `--font-size-heading-h1`, `--font-size-heading-h2`, `--font-size-heading-h3`, `--font-size-heading-h4`, `--font-size-heading-h5`, `--font-size-lg`, `--font-weight-bold`, `--font-weight-semibold`, `--leading-compact`, `--leading-relaxed`, `--leading-tight`, `--outline-focus-inverse`, `--radius-800`, `--secondary-tint-foreground`, `--space-1000`, `--space-1100`, `--space-1300`, `--space-400`, `--space-500`, `--space-600`, `--space-800`, `--space-900`, `--text-inverted`, `--text-primary`, `--text-wrap-body`, `--text-wrap-heading`
|
|
15
|
+
- **Manifest version:** `3.0.0`
|
|
16
|
+
- **Storybook:** [design-system-organisms-banner](?path=/docs/design-system-organisms-banner--docs)
|
|
17
|
+
|
|
18
|
+
## Overview
|
|
19
|
+
|
|
20
|
+
**Banner** is a promotional panel for public pages: one claim, an artwork recipe and a call to
|
|
21
|
+
action on a [PromoSurface](?path=/docs/design-system-atoms-promosurface--docs) plaque. Three
|
|
22
|
+
Compositions set how much room the pitch gets — **Person** (a character over an invoice, beside or
|
|
23
|
+
under the copy), **Invoice** (copy centred over a clipped invoice band) and **Mini** (a one-line
|
|
24
|
+
heading with the actions beside it, no artwork). What the panel asks the visitor to do is not a
|
|
25
|
+
variant: it is whatever goes in the **Actions** slot, passed as `children` — a button, two buttons,
|
|
26
|
+
a button and a link, or a field with its button.
|
|
27
|
+
|
|
28
|
+
The package ships no artwork (manifest 2.2.0 `delivery.react`): the app passes its own pictures as
|
|
29
|
+
React elements — Person takes `character` and `invoiceIllustration` `{ left, right }`, Invoice takes
|
|
30
|
+
`invoiceIllustration` only, Mini takes neither. Banner owns the boxes, their positions and the
|
|
31
|
+
clipping; how an app supplies pictures:
|
|
32
|
+
[Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets).
|
|
33
|
+
|
|
34
|
+
**Do not** use it for the first screen of a page or for copy that needs a kicker, a format icon or a
|
|
35
|
+
sub strip. That is a [Hero](?path=/docs/design-system-organisms-hero--docs) — never a fourth
|
|
36
|
+
`composition` value (`intent.rules[0]`). Like Hero, Banner inherits PromoSurface's public-page-only
|
|
37
|
+
restriction: it is not an in-app card or callout.
|
|
38
|
+
|
|
39
|
+
## Rationale
|
|
40
|
+
|
|
41
|
+
The artwork and the layout are the expensive, crafted part, so they stay a closed set of three
|
|
42
|
+
recipes on the same PromoSurface plaque Hero uses. The actions are cheap to vary and vary often
|
|
43
|
+
between pages — a sign-up, a search, a second route — so since 2.0.0 they live in one slot with an
|
|
44
|
+
accepted set of controls instead of a Composition value per arrangement.
|
|
45
|
+
|
|
46
|
+
What Banner deliberately does **not** own:
|
|
47
|
+
|
|
48
|
+
- **The page frame.** The width ladder, the side gutter (16 / 24 / 32 / 40 / 40) and the marketing
|
|
49
|
+
container cap are the page container's (spec/07-web → Page frame, `container.note`) — the same
|
|
50
|
+
split Hero documents. The plaque fills the block content with no max-width of its own. In these
|
|
51
|
+
stories a `pageContainer` decorator models the frame. The `--space-800` band above and below the
|
|
52
|
+
plaque **is** Banner's (2.1.0): the `<section>` carries it.
|
|
53
|
+
- **The heading level.** `headingLevel` is required with no default: `1` only where Banner is the
|
|
54
|
+
first screen, a lower level everywhere else; inside an article Mini sits one level below the
|
|
55
|
+
current section heading.
|
|
56
|
+
- **The controls in the slot and their states.** Button, Text Link, Text Field and Subject Lookup
|
|
57
|
+
Field own every interaction state (see States).
|
|
58
|
+
|
|
59
|
+
## Anatomy
|
|
60
|
+
|
|
61
|
+
Seventeen `data-fods-part` markers across the three compositions. The PromoSurface is **not** a
|
|
62
|
+
wrapper: it is an absolutely positioned sibling layer (`absolute inset-0`) inside the plaque, followed
|
|
63
|
+
in the tree by the visual and then the text column. Paint order is tree order, so the text column
|
|
64
|
+
lands above the visual and the visual above the surface — the layer order of
|
|
65
|
+
`regions.visual.note` — without a single `z-index`.
|
|
66
|
+
|
|
67
|
+
<table>
|
|
68
|
+
<thead>
|
|
69
|
+
<tr><th><code>data-fods-part</code></th><th>Element</th><th>Role</th><th>Chrome / tokens</th></tr>
|
|
70
|
+
</thead>
|
|
71
|
+
<tbody>
|
|
72
|
+
<tr>
|
|
73
|
+
<td><code>root</code></td><td><code><section></code></td>
|
|
74
|
+
<td>The region. Carries <code>data-fods-component="banner"</code>; unnamed on purpose (see Accessibility).</td>
|
|
75
|
+
<td><code>w-full</code>, no fill; <code>--space-800</code> above and below (2.1.0) — width and gutter are the page container's</td>
|
|
76
|
+
</tr>
|
|
77
|
+
<tr>
|
|
78
|
+
<td><code>panel</code></td><td><code><div></code></td>
|
|
79
|
+
<td>The plaque. <code>relative</code> so the absolute surface and visual resolve against it. Never clips (<code>intent.rules[3]</code>).</td>
|
|
80
|
+
<td><code>--radius-800</code>; ink <code>--text-primary</code> (Brand) / <code>--text-inverted</code> (Solid)</td>
|
|
81
|
+
</tr>
|
|
82
|
+
<tr>
|
|
83
|
+
<td><code>visual</code></td><td><code><div aria-hidden></code></td>
|
|
84
|
+
<td>Person and Invoice — the campaign artwork region. Mini renders none.</td>
|
|
85
|
+
<td>Invoice: <code>overflow-hidden</code>. Person: no clip on the box</td>
|
|
86
|
+
</tr>
|
|
87
|
+
<tr>
|
|
88
|
+
<td><code>artwork</code></td><td><code><div></code></td>
|
|
89
|
+
<td>Person only — the box holding the invoice graphic and the character.</td>
|
|
90
|
+
<td><code>clip-path: inset(-100% -100% 0)</code> — cuts the bottom edge only</td>
|
|
91
|
+
</tr>
|
|
92
|
+
<tr>
|
|
93
|
+
<td><code>invoice</code></td><td><code><div></code></td>
|
|
94
|
+
<td>The invoice graphic: two sheets pinned to opposite edges, so they spread apart as the box widens.</td>
|
|
95
|
+
<td><code>--space-800</code> taller than its box and run <code>--space-800</code> past its bottom edge</td>
|
|
96
|
+
</tr>
|
|
97
|
+
<tr>
|
|
98
|
+
<td><code>invoice-sheet-left</code> / <code>invoice-sheet-right</code></td><td><code><div></code></td>
|
|
99
|
+
<td>The two sheet boxes, holding <code>invoiceIllustration.left</code> / <code>.right</code> (<code>slots.invoice-illustration</code>), pinned to the start / end edge. Height = the invoice box, width from the picture's own ratio — a constant authored size at every breakpoint (1.8.0), never scaled with the band.</td>
|
|
100
|
+
<td><code>h-full w-auto max-w-none</code>; the picture <code>block h-full w-auto max-w-none</code></td>
|
|
101
|
+
</tr>
|
|
102
|
+
<tr>
|
|
103
|
+
<td><code>character</code></td><td><code><div></code></td>
|
|
104
|
+
<td>Person only — the box holding <code>character</code> (<code>slots.character</code>), bottom-anchored. The picture fills the box's width; its own ratio gives the height.</td>
|
|
105
|
+
<td>Authored px box (see Sizes); the picture <code>block h-auto w-full max-w-none</code></td>
|
|
106
|
+
</tr>
|
|
107
|
+
<tr>
|
|
108
|
+
<td><code>text-column</code></td><td><code><div></code></td>
|
|
109
|
+
<td>Copy (or Mini's heading) + actions. <code>relative</code>, so the in-flow column paints above the absolute siblings before it.</td>
|
|
110
|
+
<td>Gap <code>--space-800</code> (Mini <code>--space-600</code> below MD); padding per composition × breakpoint</td>
|
|
111
|
+
</tr>
|
|
112
|
+
<tr>
|
|
113
|
+
<td><code>copy</code></td><td><code><div></code></td>
|
|
114
|
+
<td>Person and Invoice — heading + the optional detail line. Mini has no copy frame.</td>
|
|
115
|
+
<td>Gap <code>--space-600</code> (the Heading Group D2 ladder, changelog 2026-08-28)</td>
|
|
116
|
+
</tr>
|
|
117
|
+
<tr>
|
|
118
|
+
<td><code>heading</code></td><td><code>Heading</code> atom</td>
|
|
119
|
+
<td>Person and Invoice — the panel's single claim. Tag from <code>headingLevel</code>, rendered at <code>size="d2"</code>.</td>
|
|
120
|
+
<td>Display/D2 via <code>text-display-d2</code> (<code>--font-size-display-d2</code>, bold, balanced wrapping); ink per <code>surface</code></td>
|
|
121
|
+
</tr>
|
|
122
|
+
<tr>
|
|
123
|
+
<td><code>mini-heading</code></td><td><code>Heading</code> atom</td>
|
|
124
|
+
<td>Mini — the short claim, FILL in the row from MD, at most three lines (<code>text.mini-heading</code>).</td>
|
|
125
|
+
<td>Display/D3 via <code>text-display-d3</code> (<code>--font-size-display-d3</code>); ink per <code>surface</code></td>
|
|
126
|
+
</tr>
|
|
127
|
+
<tr>
|
|
128
|
+
<td><code>body</code></td><td><code><p></code></td>
|
|
129
|
+
<td>Person and Invoice — the detail line, rendered only when <code>detail</code> is a non-blank string.</td>
|
|
130
|
+
<td>Inter Body/XL (<code>--font-size-lg</code> + <code>--leading-relaxed</code>) at every breakpoint, <code>--text-wrap-body</code>; ink per <code>surface</code></td>
|
|
131
|
+
</tr>
|
|
132
|
+
<tr>
|
|
133
|
+
<td><code>actions</code></td><td><code><div></code> / <code><form></code></td>
|
|
134
|
+
<td>The Actions slot (<code>slots.actions</code>) — renders <code>children</code>. A <code><form></code> when <code>actionsForm</code> is passed (a field + submit pair).</td>
|
|
135
|
+
<td>Gap <code>--space-400</code> — the adjacent-target minimum (<code>regions.actions.gap</code>); full-width column at Mobile (and SM on Mini), wrapping row above</td>
|
|
136
|
+
</tr>
|
|
137
|
+
<tr>
|
|
138
|
+
<td><code>action</code></td><td>Button → <code><a></code></td>
|
|
139
|
+
<td><code>BannerAction</code>, the slot's default content — Button <code>brand</code> rendered <code>asChild</code> as a link, leading icon <code>invoice-new</code>. Person / Invoice: <code>lg</code> at Mobile, <code>xl</code> from SM; Mini: <code>lg</code> everywhere.</td>
|
|
140
|
+
<td>Two instances of the same link, one per size band: the Mobile one full width with <code>sm:hidden</code>, the other with <code>hidden sm:inline-flex</code>. Button stays the only owner of both geometries; <code>display: none</code> keeps the hidden twin out of the tab order and the accessibility tree, and the swap is pure CSS (SSR-safe). <code>pl-500</code> / <code>pl-600</code> restore Button's leading-icon padding per size, which the <code>asChild</code> branch cannot derive. The Mobile label wraps to at most two lines (<code>line-clamp-2</code>); from SM it is a single <code>truncate</code> line</td>
|
|
141
|
+
</tr>
|
|
142
|
+
</tbody>
|
|
143
|
+
</table>
|
|
144
|
+
|
|
145
|
+
The `surface` layer itself is not in the table: it is the PromoSurface atom, measured under that
|
|
146
|
+
component. Banner chooses only its `layout` and `surface` (see Variants). Controls a consumer puts in
|
|
147
|
+
the slot keep their own markers.
|
|
148
|
+
|
|
149
|
+
## Variants
|
|
150
|
+
|
|
151
|
+
Three axes in the manifest — **Composition** × **Surface** × **Breakpoint** (3 × 2 × 5 = 30 cells).
|
|
152
|
+
Only the first two are props. **Breakpoint is not a prop** (`properties[Breakpoint].maps`): it is
|
|
153
|
+
pure CSS responsiveness, Mobile = unprefixed, SM = `sm:`, MD = `md:`, LG = `lg:`, XL = `xl:`.
|
|
154
|
+
|
|
155
|
+
The Matrix stories show the six Composition × Surface cells at every step of the ladder — XL, LG,
|
|
156
|
+
MD, SM and Mobile.
|
|
157
|
+
|
|
158
|
+
{/* Docs canvases render inline at the column width, where no breakpoint applies — so the
|
|
159
|
+
responsive stories are framed at their real viewport and scaled to fit. */}
|
|
160
|
+
<ViewportFrame storyId="design-system-organisms-banner--matrix" width={1280} label="Matrix · XL — viewport 1280, plaque 1190" />
|
|
161
|
+
<ViewportFrame storyId="design-system-organisms-banner--matrix-lg" width={1024} label="Matrix · LG — viewport 1024, plaque 880" />
|
|
162
|
+
<ViewportFrame storyId="design-system-organisms-banner--matrix-md" width={768} label="Matrix · MD — viewport 768, plaque 656" />
|
|
163
|
+
<ViewportFrame storyId="design-system-organisms-banner--matrix-sm" width={640} label="Matrix · SM — viewport 640, plaque 552" />
|
|
164
|
+
<ViewportFrame storyId="design-system-organisms-banner--matrix-mobile" width={390} label="Matrix · Mobile — viewport 390, plaque 358" />
|
|
165
|
+
|
|
166
|
+
<table>
|
|
167
|
+
<thead>
|
|
168
|
+
<tr><th><code>composition</code></th><th>Holds</th><th>Composition across the ladder</th></tr>
|
|
169
|
+
</thead>
|
|
170
|
+
<tbody>
|
|
171
|
+
<tr>
|
|
172
|
+
<td><code>person</code> (default)</td>
|
|
173
|
+
<td>Heading (Display/D2), optional detail, the Actions slot — over a character-on-invoice visual.</td>
|
|
174
|
+
<td>Copy beside the visual (left) at LG / XL; stacked above it and centred at MD / SM / Mobile.</td>
|
|
175
|
+
</tr>
|
|
176
|
+
<tr>
|
|
177
|
+
<td><code>invoice</code></td>
|
|
178
|
+
<td>The same heading / detail / actions, over an invoice-only band.</td>
|
|
179
|
+
<td>Copy centred in a vertical plaque at every breakpoint, capped at <code>--ds-content-narrow</code> (580).</td>
|
|
180
|
+
</tr>
|
|
181
|
+
<tr>
|
|
182
|
+
<td><code>mini</code></td>
|
|
183
|
+
<td>A short heading (Display/D3) and the Actions slot — no detail line, no artwork.</td>
|
|
184
|
+
<td>Heading (FILL) and actions (HUG) in one row at XL / LG / MD, gap <code>--space-800</code>, padding <code>--space-900</code>; stacked at SM / Mobile, gap <code>--space-600</code>, padding <code>--space-800</code>, left-aligned, the action full width.</td>
|
|
185
|
+
</tr>
|
|
186
|
+
</tbody>
|
|
187
|
+
</table>
|
|
188
|
+
|
|
189
|
+
### What goes in the Actions slot
|
|
190
|
+
|
|
191
|
+
One or two controls (`slots.actions`, `intent.rules[6]`). Never two Brand buttons, never a field
|
|
192
|
+
without its submit button.
|
|
193
|
+
|
|
194
|
+
<table>
|
|
195
|
+
<thead>
|
|
196
|
+
<tr><th>Filling</th><th>Surface</th><th>In code</th></tr>
|
|
197
|
+
</thead>
|
|
198
|
+
<tbody>
|
|
199
|
+
<tr><td>One Brand Button (default)</td><td>Brand · Solid</td><td><code><BannerAction href></code> — sized per Composition × Breakpoint</td></tr>
|
|
200
|
+
<tr><td>Text Field (or Subject Lookup Field) + its submit Brand Button</td><td>Brand · Solid</td><td><code><TextField size="md" aria-label leadingIcon></code> + <code><Button type="submit" size="lg"></code>, with <code>actionsForm</code> so Enter submits. The button stretches to the field's 48 from SM.</td></tr>
|
|
201
|
+
<tr><td>Brand Button + Secondary Button, Show surface on</td><td>Brand only</td><td><code><Button variant="secondary" showSurface></code> at the Brand Button's size</td></tr>
|
|
202
|
+
<tr><td>Brand Button + Text Link, md, underlined</td><td>Brand only</td><td><code><TextLink size="md" underline="on"></code> — Banner pads its hit area to 44, in-flow</td></tr>
|
|
203
|
+
</tbody>
|
|
204
|
+
</table>
|
|
205
|
+
|
|
206
|
+
<Canvas of={BannerStories.PersonField} />
|
|
207
|
+
<Canvas of={BannerStories.ActionsWithLink} />
|
|
208
|
+
<Canvas of={BannerStories.ActionsWithSecondary} />
|
|
209
|
+
|
|
210
|
+
### Mini
|
|
211
|
+
|
|
212
|
+
<Canvas of={BannerStories.MiniBrand} />
|
|
213
|
+
<Canvas of={BannerStories.MiniSolid} />
|
|
214
|
+
<ViewportFrame storyId="design-system-organisms-banner--mini-mobile" width={390} label="Mini · Mobile — stacked, the action full width" />
|
|
215
|
+
|
|
216
|
+
### Which PromoSurface layout applies where
|
|
217
|
+
|
|
218
|
+
The `layout` follows where the copy actually sits, never the breakpoint (`intent.rules[2]`).
|
|
219
|
+
|
|
220
|
+
<table>
|
|
221
|
+
<thead>
|
|
222
|
+
<tr><th>Cell</th><th>PromoSurface <code>layout</code></th><th>How it is selected</th></tr>
|
|
223
|
+
</thead>
|
|
224
|
+
<tbody>
|
|
225
|
+
<tr><td>Person · XL / LG</td><td><code>side</code></td><td>Instance with <code>hidden lg:block</code></td></tr>
|
|
226
|
+
<tr><td>Person · MD / SM / Mobile</td><td><code>top</code></td><td>Instance with <code>lg:hidden</code></td></tr>
|
|
227
|
+
<tr><td>Mini · XL / LG / MD</td><td><code>side</code></td><td>Instance with <code>hidden md:block</code></td></tr>
|
|
228
|
+
<tr><td>Mini · SM / Mobile</td><td><code>top</code></td><td>Instance with <code>md:hidden</code></td></tr>
|
|
229
|
+
<tr><td>Invoice · every breakpoint</td><td><code>vertical</code></td><td>One instance</td></tr>
|
|
230
|
+
</tbody>
|
|
231
|
+
</table>
|
|
232
|
+
|
|
233
|
+
Person and Mini render **two** PromoSurface instances for the same reason as Hero's `visual="on"`:
|
|
234
|
+
PromoSurface turns `layout` into inline custom properties, and an inline style cannot carry a media
|
|
235
|
+
query.
|
|
236
|
+
|
|
237
|
+
### Text alignment
|
|
238
|
+
|
|
239
|
+
`regions.text-column.align`: Person is **centred** at MD / SM / Mobile and **left** at LG / XL;
|
|
240
|
+
Invoice is centred everywhere; Mini is left at every breakpoint. The Person rule follows the manifest,
|
|
241
|
+
which records it as an open question (`gaps`).
|
|
242
|
+
|
|
243
|
+
### Surface tone
|
|
244
|
+
|
|
245
|
+
`surface` passes straight through to PromoSurface, which owns the fill; Banner pairs the ink with it
|
|
246
|
+
and the two never mix (`intent.rules[1]`).
|
|
247
|
+
|
|
248
|
+
<table>
|
|
249
|
+
<thead>
|
|
250
|
+
<tr><th><code>surface</code></th><th>Plaque fill (PromoSurface)</th><th>Heading ink</th><th>Detail ink</th><th>Slot focus ring</th></tr>
|
|
251
|
+
</thead>
|
|
252
|
+
<tbody>
|
|
253
|
+
<tr><td><code>brand</code> (default)</td><td><code>--secondary-subtle</code></td><td><code>--text-primary</code></td><td><code>--secondary-tint-foreground</code> (Person and Invoice)</td><td>Each control's default</td></tr>
|
|
254
|
+
<tr><td><code>solid</code></td><td><code>--secondary-solid</code></td><td><code>--text-inverted</code></td><td><code>--text-inverted</code></td><td><code>--outline-focus-inverse</code> on every slotted control</td></tr>
|
|
255
|
+
</tbody>
|
|
256
|
+
</table>
|
|
257
|
+
|
|
258
|
+
The heading ink is set on the heading part itself, because the Heading atom binds `--text-primary`
|
|
259
|
+
in its own base; the configured tailwind-merge drops the atom's class on Solid.
|
|
260
|
+
|
|
261
|
+
## Sizes
|
|
262
|
+
|
|
263
|
+
There is no `size` prop — Breakpoint **is** the sizing, and it is a ladder of authored steps, not a
|
|
264
|
+
scale (`intent.sizing`). One story per breakpoint, each pinned to the band-minimum viewport
|
|
265
|
+
(1280 / 1024 / 768 / 640) plus the 390 Mobile artboard; the page-container decorator clamps to the
|
|
266
|
+
marketing container and pads it by the gutter, which gives exactly the block content the plaque
|
|
267
|
+
fills (2.1.0).
|
|
268
|
+
|
|
269
|
+
<table>
|
|
270
|
+
<thead>
|
|
271
|
+
<tr>
|
|
272
|
+
<th>Breakpoint</th>
|
|
273
|
+
<th style={{ textAlign: 'right' }}>Viewport</th>
|
|
274
|
+
<th style={{ textAlign: 'right' }}>Block frame (container)</th>
|
|
275
|
+
<th>Gutter (container)</th>
|
|
276
|
+
<th style={{ textAlign: 'right' }}>Plaque = block content</th>
|
|
277
|
+
<th>Person split (text / visual)</th>
|
|
278
|
+
</tr>
|
|
279
|
+
</thead>
|
|
280
|
+
<tbody>
|
|
281
|
+
<tr><td>XL</td><td style={{ textAlign: 'right' }}>1280</td><td style={{ textAlign: 'right' }}>1270</td><td><code>--space-1000</code> (40)</td><td style={{ textAlign: 'right' }}>1190</td><td>basis 648 / 552, shrunk proportionally</td></tr>
|
|
282
|
+
<tr><td>LG</td><td style={{ textAlign: 'right' }}>1024</td><td style={{ textAlign: 'right' }}>960</td><td><code>--space-1000</code> (40)</td><td style={{ textAlign: 'right' }}>880</td><td>basis 520 / 424, shrunk proportionally</td></tr>
|
|
283
|
+
<tr><td>MD</td><td style={{ textAlign: 'right' }}>768</td><td style={{ textAlign: 'right' }}>720</td><td><code>--space-900</code> (32)</td><td style={{ textAlign: 'right' }}>656</td><td>stacked</td></tr>
|
|
284
|
+
<tr><td>SM</td><td style={{ textAlign: 'right' }}>640</td><td style={{ textAlign: 'right' }}>600</td><td><code>--space-800</code> (24)</td><td style={{ textAlign: 'right' }}>552</td><td>stacked</td></tr>
|
|
285
|
+
<tr><td>Mobile</td><td style={{ textAlign: 'right' }}>390</td><td style={{ textAlign: 'right' }}>fluid</td><td><code>--space-600</code> (16)</td><td style={{ textAlign: 'right' }}>358</td><td>stacked</td></tr>
|
|
286
|
+
</tbody>
|
|
287
|
+
</table>
|
|
288
|
+
|
|
289
|
+
The block frame is `--ds-container-sm` / `-md` / `-lg` / `-xl` (spec/07-web → Page frame). Above and
|
|
290
|
+
below the plaque the section carries `--space-800` (24) at every step — lighter than the page's
|
|
291
|
+
recommended vertical P, a deliberate exception so the plaque sits close to the sections around it.
|
|
292
|
+
|
|
293
|
+
The side-by-side split is a `basis` on **both** children (`lg:shrink lg:grow-0` on the text column,
|
|
294
|
+
`lg:shrink lg:grow` on the visual), so the plaque shares the deficit proportionally instead of
|
|
295
|
+
crushing one side. 2.1.0 narrowed the plaque (1200 → 1190 at XL, 944 → 880 at LG) without restating
|
|
296
|
+
the split; the authored bases stay and shrink to fit.
|
|
297
|
+
|
|
298
|
+
**The default action follows the ladder too** (`slots.actions`): on Person and Invoice Button `xl`
|
|
299
|
+
at XL / LG / MD / SM and `lg` at Mobile, where it runs full width and its label wraps to at most two
|
|
300
|
+
lines instead of truncating; on Mini `lg` at every breakpoint, because an `xl` button would outweigh
|
|
301
|
+
a one-line heading. A wrapped label takes `--space-400` (8) above and below, so the button grows
|
|
302
|
+
54 → 70 while a one-line button stays 44. No CSS selector can tell a wrapped label from a one-line
|
|
303
|
+
one, so the padding is always there and Button's 44 min-height does the switching: the Mobile
|
|
304
|
+
instance carries `py-[calc(var(--space-400)-var(--border-width-100))]` — one line is 27 + 2 × 7 + 2 × 1
|
|
305
|
+
border = 43, under the floor; two lines are 54 + 14 + 2 = 70. The plaque hugs its content, so the
|
|
306
|
+
heights the manifest records (Person 280 / 332 / 604 / 584 / 598, Invoice 280 / 280 / 504 / 484 / 514,
|
|
307
|
+
Mini 108 / 148 / 190 / 176 / 176) are an outcome, never pinned. See the `Two-line CTA · Mobile` story.
|
|
308
|
+
|
|
309
|
+
<ViewportFrame storyId="design-system-organisms-banner--breakpoint-xl" width={1280} label="XL — viewport 1280, plaque 1190" />
|
|
310
|
+
<ViewportFrame storyId="design-system-organisms-banner--breakpoint-lg" width={1024} label="LG — viewport 1024, plaque 880" />
|
|
311
|
+
<ViewportFrame storyId="design-system-organisms-banner--breakpoint-md" width={768} label="MD — viewport 768, plaque 656" />
|
|
312
|
+
<ViewportFrame storyId="design-system-organisms-banner--breakpoint-sm" width={640} label="SM — viewport 640, plaque 552" />
|
|
313
|
+
<ViewportFrame storyId="design-system-organisms-banner--breakpoint-mobile" width={390} label="Mobile — viewport 390, plaque 358" />
|
|
314
|
+
<ViewportFrame storyId="design-system-organisms-banner--reflow-320" width={320} label="Reflow · 320 — WCAG 1.4.10, below every authored step" />
|
|
315
|
+
<ViewportFrame storyId="design-system-organisms-banner--two-line-cta-mobile" width={390} label="Two-line CTA · Mobile — a wrapped label takes --space-400 above and below" />
|
|
316
|
+
|
|
317
|
+
### Text column padding
|
|
318
|
+
|
|
319
|
+
<table>
|
|
320
|
+
<thead>
|
|
321
|
+
<tr><th>Breakpoint</th><th>Person</th><th>Invoice</th><th>Mini</th></tr>
|
|
322
|
+
</thead>
|
|
323
|
+
<tbody>
|
|
324
|
+
<tr><td>XL / LG</td><td><code>--space-1100</code> (48) all round</td><td>x <code>--space-800</code> (24), y <code>--space-1100</code> (48); panel adds nothing</td><td rowSpan={2}><code>--space-900</code> (32) all round</td></tr>
|
|
325
|
+
<tr><td>MD</td><td><code>--space-1100</code> (48) all round</td><td rowSpan={3}>x <code>--space-800</code> (24), y <code>--space-1300</code> (80) — plus the panel's own <code>--space-1300</code> (80) above and below, so the copy starts 160 from the plaque edge</td></tr>
|
|
326
|
+
<tr><td>SM</td><td>x <code>--space-1000</code> (40), y <code>--space-1100</code> (48)</td><td rowSpan={2}><code>--space-800</code> (24) all round</td></tr>
|
|
327
|
+
<tr><td>Mobile</td><td>x <code>--space-800</code> (24), y <code>--space-1000</code> (40)</td></tr>
|
|
328
|
+
</tbody>
|
|
329
|
+
</table>
|
|
330
|
+
|
|
331
|
+
### The visual, per composition
|
|
332
|
+
|
|
333
|
+
- **Person, stacked (MD / SM / Mobile)** — an in-flow band 324 high under the copy, bleeding past
|
|
334
|
+
the plaque by the gutter on both sides (`-mx-600 sm:-mx-800 md:-mx-900`), so the artwork overhangs
|
|
335
|
+
the plaque's sides.
|
|
336
|
+
- **Person, side by side (LG / XL)** — the right-hand column, stretched to the plaque height that the
|
|
337
|
+
text column alone sets. The artwork box starts `--space-1000` (LG) / `--space-800` (XL) inside the
|
|
338
|
+
text column; the invoice graphic is 356 (LG) / 328 (XL) high.
|
|
339
|
+
- **Person, character** — 332 wide and centred while stacked, 362 at `--space-900` from the left at
|
|
340
|
+
LG, 310 at 114 from the left at XL.
|
|
341
|
+
- **Invoice** — an **absolute** band inside the plaque, inset past it by the breakpoint's gutter
|
|
342
|
+
(`-inset-x-600 sm:-inset-x-800 md:-inset-x-900 lg:-inset-x-1000`), bottom flush,
|
|
343
|
+
`overflow-hidden`. 142 high on Mobile, 195 on SM, 215 on MD; from LG it spans the plaque and
|
|
344
|
+
`--space-800` above it. The sheets keep their **authored size** at every breakpoint
|
|
345
|
+
(`regions.visual.note`): from LG the graphic is pinned to its authored 328 and a taller plaque only
|
|
346
|
+
moves it down with the bottom edge — the right sheet never reaches under the text column.
|
|
347
|
+
- **Mini** — no visual at all.
|
|
348
|
+
|
|
349
|
+
The Person artwork is **positioned, not clipped**: the visual carries no `overflow-hidden`, and the
|
|
350
|
+
artwork box cuts only its bottom edge (`clip-path: inset(-100% -100% 0)` — the one primitive that
|
|
351
|
+
cuts a single edge). Invoice is the opposite by design: its band clips, and the sheets run past the
|
|
352
|
+
bottom edge into that clip — the clip is the composition (`intent.rules[3]`).
|
|
353
|
+
|
|
354
|
+
### Authored px with no token
|
|
355
|
+
|
|
356
|
+
Every raw px in the recipe is Figma artwork or composition geometry with no spacing token, each
|
|
357
|
+
under its own inline `fods-lint-disable-next-line` with the reason: the character boxes (332 / 362 /
|
|
358
|
+
310) and its XL offset (114), the Person visual band height (324), the Person split bases
|
|
359
|
+
(LG 520 / 424, XL 648 / 552), the Person invoice heights (LG 356, XL 328), the Invoice band heights
|
|
360
|
+
(142 / 195 / 215) and its LG / XL invoice height (328), and the 44 target floor of a Text Link in the
|
|
361
|
+
slot. They are written inline rather than in a shared constant because a static check of the `tv()`
|
|
362
|
+
literal cannot follow a reference.
|
|
363
|
+
|
|
364
|
+
## States
|
|
365
|
+
|
|
366
|
+
**The shell has no interaction states** (`intent.states`) — no hover, active, focus, disabled or
|
|
367
|
+
loading of its own, and no `state` prop. Every interactive state lives on the controls in the Actions
|
|
368
|
+
slot — [Button](?path=/docs/design-system-atoms-button--docs),
|
|
369
|
+
[TextLink](?path=/docs/design-system-atoms-textlink--docs),
|
|
370
|
+
[TextField](?path=/docs/design-system-atoms-textfield--docs) and Subject Lookup Field; verify them
|
|
371
|
+
in their own stories (`delivery.storybookStates`). There is therefore no `States` story.
|
|
372
|
+
|
|
373
|
+
The one thing Banner overrides is the **focus-ring colour on `surface="solid"`** (see
|
|
374
|
+
Accessibility). What varies at the organism level is compositional, shown statically:
|
|
375
|
+
|
|
376
|
+
- **`detail` presence** — the Figma `Show body` toggle (Person and Invoice). In code it is the
|
|
377
|
+
presence of a non-blank `detail` string, not a second boolean; absent or empty renders no `<p>`.
|
|
378
|
+
- **`headingLevel`** — changes only the tag. The heading renders at Display/D2 (Mini D3).
|
|
379
|
+
|
|
380
|
+
<Canvas of={BannerStories.ShowBody} />
|
|
381
|
+
<Canvas of={BannerStories.ShowBodySolid} />
|
|
382
|
+
<Canvas of={BannerStories.HeadingLevelOne} />
|
|
383
|
+
|
|
384
|
+
## API
|
|
385
|
+
|
|
386
|
+
<Controls />
|
|
387
|
+
|
|
388
|
+
```ts
|
|
389
|
+
type BannerProps = BannerPersonProps | BannerInvoiceProps | BannerMiniProps;
|
|
390
|
+
type BannerPitchProps = BannerPersonProps | BannerInvoiceProps;
|
|
391
|
+
|
|
392
|
+
// common: surface?; heading; headingLevel; children (the Actions slot);
|
|
393
|
+
// actionsForm? (renders the slot as a <form> with these attributes)
|
|
394
|
+
// BannerPersonProps: composition?: 'person'; detail?; character: React.ReactElement;
|
|
395
|
+
// invoiceIllustration: BannerInvoiceIllustration
|
|
396
|
+
// BannerInvoiceProps: composition: 'invoice'; detail?; invoiceIllustration; character?: never
|
|
397
|
+
// BannerMiniProps: composition: 'mini'; detail?: undefined — Mini has no body run;
|
|
398
|
+
// character?: never; invoiceIllustration?: never — no visual layer
|
|
399
|
+
|
|
400
|
+
interface BannerInvoiceIllustration {
|
|
401
|
+
left: React.ReactElement; // pinned to the band's start edge
|
|
402
|
+
right: React.ReactElement; // pinned to the band's end edge
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
interface BannerActionProps {
|
|
406
|
+
href: string;
|
|
407
|
+
children: string; // the label, Button maxChars 24
|
|
408
|
+
icon?: IconName; // defaults to invoice-new
|
|
409
|
+
}
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
`heading` and `headingLevel` are required; `surface` defaults to `brand`, `composition` to
|
|
413
|
+
`person`. The pictures are the app's own elements — an `<img src={…} alt="" />` of its asset: Person
|
|
414
|
+
(the default) requires `character` and `invoiceIllustration`, Invoice requires `invoiceIllustration`,
|
|
415
|
+
and the union rejects both on Mini. The sheet boxes size their picture by height and the character
|
|
416
|
+
box by width, so an `<img>` keeps its own ratio; for an inline SVG see
|
|
417
|
+
[Consuming → Assets](?path=/docs/getting-started-consuming--docs#assets).
|
|
418
|
+
`BannerInvoiceIllustration` is exported. `children` is required — the Actions slot. `BannerAction` reads the enclosing Banner's
|
|
419
|
+
composition and picks its sizes (Person / Invoice lg → xl, Mini lg); use it inside a Banner only. The
|
|
420
|
+
ref forwards to the `<section>`, and the usual `HTMLAttributes` land on it.
|
|
421
|
+
|
|
422
|
+
`actionsForm` takes the form's attributes (`onSubmit`, `role`, `action`, `aria-label` …). Pass it
|
|
423
|
+
with a field + submit pair, so Enter in the field submits — the consumer reads the field value in its
|
|
424
|
+
own `onSubmit`.
|
|
425
|
+
|
|
426
|
+
The Controls panel drives a flat set of story args; the `actions` arg picks a slot filling.
|
|
427
|
+
|
|
428
|
+
## Do / Don't
|
|
429
|
+
|
|
430
|
+
- ✅ Pick `composition` from the closed set of three by how much room the pitch gets.
|
|
431
|
+
- ✅ Fill the Actions slot with one or two controls from its accepted set; `BannerAction` for the
|
|
432
|
+
default CTA.
|
|
433
|
+
- ✅ Keep `surface="solid"` to one Brand Button or a field with its button.
|
|
434
|
+
- ✅ Pick `surface` from the page family and let Banner pair the ink with it.
|
|
435
|
+
- ✅ Pass `headingLevel={1}` only where Banner is the page's first screen.
|
|
436
|
+
- ✅ Keep the heading one claim with no full stop — around 48 characters (`text.heading`); Mini one
|
|
437
|
+
line at XL, three at most (`text.mini-heading`).
|
|
438
|
+
- ✅ Turn `detail` on only where the extra line earns its space — one concrete fact, around 56
|
|
439
|
+
characters (`text.body`).
|
|
440
|
+
- ✅ Let the Person artwork overhang the plaque and the Invoice band clip — both are the composition.
|
|
441
|
+
- ✅ Give the page container the width ladder, the gutter and the cap; drop Banner into it at full
|
|
442
|
+
width.
|
|
443
|
+
- ❌ Don't add a Composition value to change the actions — fill the slot instead.
|
|
444
|
+
- ❌ Don't put two Brand buttons side by side, or a field without its submit button.
|
|
445
|
+
- ❌ Don't put a Secondary Button or a Text Link on the Solid plaque (1.33:1).
|
|
446
|
+
- ❌ Don't wrap Banner in a fixed-height box or add `overflow-hidden` to an ancestor — the frame hugs
|
|
447
|
+
the plaque, and a clip would crop the Person overhang.
|
|
448
|
+
- ❌ Don't give Banner its own max-width inside a page container — the plaque would collapse below
|
|
449
|
+
the content beside it.
|
|
450
|
+
- ❌ Don't enable `detail` on `surface="solid"` without reading the contrast exception below.
|
|
451
|
+
- ❌ Don't restyle the controls in the slot; their states are theirs.
|
|
452
|
+
|
|
453
|
+
## Accessibility
|
|
454
|
+
|
|
455
|
+
**Keyboard.** The shell holds no tab stops of its own. Focus lands only on the controls in the
|
|
456
|
+
Actions slot, in DOM order. With a field + submit pair the slot is a `<form>` (`actionsForm`), so
|
|
457
|
+
**Enter in the field submits** exactly like the button (covered in `Banner.test.tsx`). Give a search
|
|
458
|
+
form `role: 'search'` and use **one** per page: the form is an unnamed search landmark, which is fine
|
|
459
|
+
alone but ambiguous next to a second one. In a Subject Lookup Field Enter belongs to the lookup — with
|
|
460
|
+
nothing highlighted it does nothing, so the submit button is the only way to submit.
|
|
461
|
+
|
|
462
|
+
**ARIA / semantics.**
|
|
463
|
+
|
|
464
|
+
- The root is an **unnamed** `<section>` on purpose, like Hero: a named section would add a `region`
|
|
465
|
+
landmark, and the heading already labels the content.
|
|
466
|
+
- The heading level comes from the required `headingLevel` — the page decides, Banner never does.
|
|
467
|
+
- The whole visual carries `aria-hidden="true"`, so the app's pictures inside it are decorative: an
|
|
468
|
+
`<img>` takes `alt=""` and the copy carries the message. Mini has no artwork.
|
|
469
|
+
- A Text Field in the slot has no visible label, and neither its decorative icon nor the placeholder
|
|
470
|
+
names it — it needs an `aria-label` (`gaps`, label-less Text Field). A Subject Lookup Field keeps
|
|
471
|
+
its own floating label.
|
|
472
|
+
- `BannerAction` is a real `<a href>`; a field's action is a `type="submit"` button.
|
|
473
|
+
- A Text Link in the slot gets a hit area at least 44 tall, in-flow, so it never overlaps the
|
|
474
|
+
neighbouring button (`slots.actions` TEXT LINK TARGET).
|
|
475
|
+
|
|
476
|
+
**Contrast.**
|
|
477
|
+
|
|
478
|
+
- **Focus ring on Solid is Banner's job.** `--outline-focus` is the same hex as `--secondary-solid`,
|
|
479
|
+
so the default ring measures 1.00:1 on that plaque (`intent.rules[5]`). On `surface="solid"` the
|
|
480
|
+
`actions` slot swaps the ring of **every** control in it: buttons and links keep their own outline
|
|
481
|
+
geometry and take `--outline-focus-inverse`; a field — whose own focus is a border swap to
|
|
482
|
+
`--outline-focus`, invisible on the plaque — gets an `--outline-focus-inverse` ring outside its
|
|
483
|
+
shell with Button's width and 2px offset. The container owns the swap; the atoms are unchanged.
|
|
484
|
+
`surface="brand"` keeps every control's own default focus. Asserted in `Banner.test.tsx`.
|
|
485
|
+
- **Accepted exception — the detail line on Solid.** Body/XL is 20px Regular, which is not WCAG large
|
|
486
|
+
text, and `--text-inverted` on `--secondary-solid` measures **4.45:1** against the 4.5:1 floor
|
|
487
|
+
(`gaps[0]`). It stands as a scoped brand exception because `detail` is off by default and Mini has
|
|
488
|
+
none; passing `detail` on a Solid banner ships that known run.
|
|
489
|
+
- **Accepted exception — the placeholder of a label-less Text Field.** `--text-placeholder` at
|
|
490
|
+
2.71:1 stands because the placeholder is a non-load-bearing example; it does not replace the
|
|
491
|
+
`aria-label`.
|
|
492
|
+
- **Inherited exception — the Brand button label.** White on `--primary-solid` measures **2.37:1**
|
|
493
|
+
(hover 3.17:1), below AA and AA-Large. The exception belongs to the token and the Button, not to
|
|
494
|
+
Banner.
|
|
495
|
+
- The heading is bold Display/D2 (Mini D3) at every breakpoint and is unaffected by any exception.
|
|
496
|
+
|
|
497
|
+
**Reflow (1.4.10).** Banner assumes the page container's gutter (16 / 24 / 32 / 40 / 40): the Person
|
|
498
|
+
visual and the Invoice band bleed past the plaque by exactly that gutter. At 320 (and at every Mobile
|
|
499
|
+
width) the `lg` action label wraps to at most two lines and the button grows instead of overflowing
|
|
500
|
+
the fill or losing its last word, and the character scales down to the band instead of scrolling the
|
|
501
|
+
page sideways. See the `Reflow · 320` story.
|
|
502
|
+
|
|
503
|
+
**Motion.** Static (`motion.none`): nothing in Banner animates or transitions. Hover / press motion is
|
|
504
|
+
the slotted controls' own (`motion.inherits`: button, text-link, text-field, subject-lookup-field).
|
|
505
|
+
The scroll-linked parallax on the paper graphic is a **planned** manifest backlog item and
|
|
506
|
+
is not built into Banner.
|
|
507
|
+
|
|
508
|
+
**Windows High Contrast.** Buttons and links keep a visible outline ring in forced colours. A
|
|
509
|
+
field's border swap is overridden there, so on Brand its focus shows only the caret — a TextField
|
|
510
|
+
issue, tracked separately. On Solid the slot's outline ring stays visible.
|
|
511
|
+
|
|
512
|
+
Full checklist: `spec/01-foundations/accessibility.md`.
|
|
513
|
+
|
|
514
|
+
## Copy
|
|
515
|
+
|
|
516
|
+
Voice: the product tone — impersonal, plain, no exclamation. This section covers only the runs
|
|
517
|
+
Banner owns, the heading and the optional detail line; copy for the controls in the Actions slot is
|
|
518
|
+
canonical in their own pages ([Button](?path=/docs/design-system-atoms-button--docs) for action
|
|
519
|
+
labels, [TextLink](?path=/docs/design-system-atoms-textlink--docs) for link labels,
|
|
520
|
+
[TextField](?path=/docs/design-system-atoms-textfield--docs) for placeholders).
|
|
521
|
+
|
|
522
|
+
- **Heading** (Person, Invoice; `heading`) — one claim, no second sentence, no full stop. Wraps,
|
|
523
|
+
never truncates; at most 48 characters, 2 lines in the manifest. The canonical CZ string fills two
|
|
524
|
+
lines where the copy measure is widest and three at LG and Mobile; a longer market string grows the
|
|
525
|
+
plaque rather than truncating.
|
|
526
|
+
- **Heading** (Mini; `heading`) — one short claim, no full stop, same voice rules. Wraps, never
|
|
527
|
+
truncates; at most 48 characters and 3 lines: one line beside the button at XL, two at LG, three
|
|
528
|
+
at MD (the narrowest row, shared with the button), two at SM and Mobile above it.
|
|
529
|
+
- **Body** (the detail line; `detail`) — one concrete detail that earns the click, never a second
|
|
530
|
+
claim: it states a fact and stops. Wraps; at most 56 characters and 2 lines. Person and Invoice
|
|
531
|
+
only, off unless `detail` is passed; Mini has none. Read the Accessibility note on
|
|
532
|
+
`surface="solid"` before turning it on there.
|
|
533
|
+
- **Action label** (Button in the slot) — Button's 24-character limit still applies. One override
|
|
534
|
+
of Button's mechanics: at Mobile a full-width button's label wraps to two lines rather than
|
|
535
|
+
truncating, so a long market string costs a taller button, never its last word.
|
|
536
|
+
|
|
537
|
+
<table>
|
|
538
|
+
<thead>
|
|
539
|
+
<tr><th>Run</th><th>Write</th><th>✅</th><th>❌</th></tr>
|
|
540
|
+
</thead>
|
|
541
|
+
<tbody>
|
|
542
|
+
<tr><td>Heading (Person, Invoice)</td><td>one claim, no second sentence, no full stop</td><td><code>S námi zvládne fakturovat úplně každý</code></td><td><code>Fakturujte snadno. Vyzkoušejte to ještě dnes!</code></td></tr>
|
|
543
|
+
<tr><td>Heading (Mini)</td><td>one short claim, no full stop</td><td><code>Použijte šablonu pro rychlé vytvoření faktury</code></td><td><code>Chcete fakturovat rychleji? Máme pro vás šablonu.</code></td></tr>
|
|
544
|
+
<tr><td>Body (detail line)</td><td>one concrete detail that earns the click, never a second claim; states a fact and stops</td><td><code>První fakturu vystavíte do 30 vteřin.</code></td><td><code>Ušetříte čas i nervy a zamilujete si každou fakturu.</code></td></tr>
|
|
545
|
+
</tbody>
|
|
546
|
+
</table>
|
|
547
|
+
|
|
548
|
+
## Usage
|
|
549
|
+
|
|
550
|
+
```tsx
|
|
551
|
+
import { Banner, BannerAction, type BannerInvoiceIllustration } from '@invoiceonline/ui-react';
|
|
552
|
+
// The app's own copies of the artwork.
|
|
553
|
+
import bartender from './assets/banner-character.webp';
|
|
554
|
+
import sheetLeft from './assets/banner-invoice-sheet-left.webp';
|
|
555
|
+
import sheetRight from './assets/banner-invoice-sheet-right.webp';
|
|
556
|
+
|
|
557
|
+
const character = <img src={bartender} alt="" />;
|
|
558
|
+
const invoiceIllustration: BannerInvoiceIllustration = {
|
|
559
|
+
left: <img src={sheetLeft} alt="" />,
|
|
560
|
+
right: <img src={sheetRight} alt="" />,
|
|
561
|
+
};
|
|
562
|
+
|
|
563
|
+
// Good — the default Person, mid-page, one Brand action.
|
|
564
|
+
<Banner heading="S námi zvládne fakturovat úplně každý" headingLevel={2} character={character} invoiceIllustration={invoiceIllustration}>
|
|
565
|
+
<BannerAction href="#">Vystavit fakturu</BannerAction>
|
|
566
|
+
</Banner>
|
|
567
|
+
```
|
|
568
|
+
|
|
569
|
+
```tsx
|
|
570
|
+
// Good — Invoice on the Solid plaque: the sheets, no character.
|
|
571
|
+
<Banner composition="invoice" surface="solid" heading="S námi zvládne fakturovat úplně každý" headingLevel={2} invoiceIllustration={invoiceIllustration}>
|
|
572
|
+
<BannerAction href="#">Vystavit fakturu</BannerAction>
|
|
573
|
+
</Banner>
|
|
574
|
+
```
|
|
575
|
+
|
|
576
|
+
```tsx
|
|
577
|
+
// Good — Mini inside an article, one level below the current section heading.
|
|
578
|
+
<Banner composition="mini" heading="Použijte šablonu pro rychlé vytvoření faktury" headingLevel={3}>
|
|
579
|
+
<BannerAction href="#">Vystavit fakturu</BannerAction>
|
|
580
|
+
</Banner>
|
|
581
|
+
```
|
|
582
|
+
|
|
583
|
+
```tsx
|
|
584
|
+
// Good — Person with a field + its submit button: named field, Enter submits.
|
|
585
|
+
const inputRef = useRef<HTMLInputElement>(null);
|
|
586
|
+
|
|
587
|
+
<Banner
|
|
588
|
+
heading="S námi zvládne fakturovat úplně každý"
|
|
589
|
+
headingLevel={2}
|
|
590
|
+
character={character}
|
|
591
|
+
invoiceIllustration={invoiceIllustration}
|
|
592
|
+
actionsForm={{
|
|
593
|
+
role: 'search',
|
|
594
|
+
onSubmit: (event) => {
|
|
595
|
+
event.preventDefault();
|
|
596
|
+
search(inputRef.current?.value ?? '');
|
|
597
|
+
},
|
|
598
|
+
}}
|
|
599
|
+
>
|
|
600
|
+
<TextField ref={inputRef} size="md" type="search" leadingIcon="magnifying-glass" aria-label="IČO nebo název firmy" />
|
|
601
|
+
<Button type="submit" variant="brand" size="lg" leadingIcon={<Icon name="magnifying-glass" />}>Vyhledat</Button>
|
|
602
|
+
</Banner>
|
|
603
|
+
```
|
|
604
|
+
|
|
605
|
+
```tsx
|
|
606
|
+
// Don't — no headingLevel, no Actions slot, a detail line on Mini: none of them typechecks.
|
|
607
|
+
<Banner heading="…">…</Banner>
|
|
608
|
+
<Banner heading="…" headingLevel={2} />
|
|
609
|
+
<Banner composition="mini" heading="…" headingLevel={3} detail="…">…</Banner>
|
|
610
|
+
|
|
611
|
+
// Don't — Person without its pictures, or a picture on Mini: none of them typechecks either.
|
|
612
|
+
<Banner heading="…" headingLevel={2}>…</Banner>
|
|
613
|
+
<Banner composition="mini" heading="…" headingLevel={3} character={character}>…</Banner>
|
|
614
|
+
|
|
615
|
+
// Don't — a Text Link on the Solid plaque (1.33:1), or a field without its submit button.
|
|
616
|
+
<Banner surface="solid" heading="…" headingLevel={2} character={character} invoiceIllustration={invoiceIllustration}>
|
|
617
|
+
<BannerAction href="#">Vystavit fakturu</BannerAction>
|
|
618
|
+
<TextLink href="#">Zjistit více o fakturaci</TextLink>
|
|
619
|
+
</Banner>
|
|
620
|
+
```
|
|
621
|
+
|
|
622
|
+
## Related
|
|
623
|
+
|
|
624
|
+
- [Hero](?path=/docs/design-system-organisms-hero--docs) — the first-screen shell. Anything outside
|
|
625
|
+
Banner's three recipes belongs there.
|
|
626
|
+
- [PromoSurface](?path=/docs/design-system-atoms-promosurface--docs) — the plaque's fill, pattern and
|
|
627
|
+
veil; Banner chooses only its `layout` and `surface`.
|
|
628
|
+
- [Button](?path=/docs/design-system-atoms-button--docs),
|
|
629
|
+
[TextLink](?path=/docs/design-system-atoms-textlink--docs),
|
|
630
|
+
[TextField](?path=/docs/design-system-atoms-textfield--docs) — the controls the Actions slot
|
|
631
|
+
accepts, with every interaction state.
|
|
632
|
+
- [Heading](?path=/docs/design-system-atoms-heading--docs) — the heading atom, rendered at `d2` (Mini
|
|
633
|
+
`d3`).
|
|
634
|
+
- `spec/07-web/banner.md`
|
|
635
|
+
— upstream design spec; `spec/07-web/_README.md`
|
|
636
|
+
— the Web page frame and block rhythm.
|
|
637
|
+
- `spec/06-patterns/focus-ring.md`
|
|
638
|
+
— the container-owns-the-swap rule behind the Solid ring override.
|
|
639
|
+
|
|
640
|
+
## Migration notes
|
|
641
|
+
|
|
642
|
+
### 1.x → 2.0.0 (MAJOR, the first step of `delivery.migration`)
|
|
643
|
+
|
|
644
|
+
The fixed `primary-action` / `search-field` / `search-action` slots are gone; the actions are one
|
|
645
|
+
slot, passed as `children`.
|
|
646
|
+
|
|
647
|
+
<table>
|
|
648
|
+
<thead>
|
|
649
|
+
<tr><th>1.x</th><th>2.x</th></tr>
|
|
650
|
+
</thead>
|
|
651
|
+
<tbody>
|
|
652
|
+
<tr><td><code>composition="person-cta"</code> + <code>actionLabel</code> / <code>actionHref</code></td><td><code>composition="person"</code> (default) + <code><BannerAction href>label</BannerAction></code></td></tr>
|
|
653
|
+
<tr><td><code>composition="invoice-cta"</code> + <code>actionLabel</code> / <code>actionHref</code></td><td><code>composition="invoice"</code> + <code><BannerAction href>label</BannerAction></code></td></tr>
|
|
654
|
+
<tr><td><code>composition="person-search"</code> + <code>searchAriaLabel</code> / <code>searchPlaceholder</code> / <code>searchActionLabel</code> / <code>onSearch</code> / <code>defaultSearchValue</code></td><td><code>composition="person"</code> + <code>actionsForm</code> + <code><TextField aria-label …></code> and <code><Button type="submit"></code> as children; the consumer reads the value in <code>onSubmit</code></td></tr>
|
|
655
|
+
<tr><td>A separate heading-and-action strip, Blue / Light</td><td><code>composition="mini"</code>, <code>surface="solid"</code> / <code>"brand"</code> — not migrated yet (see below)</td></tr>
|
|
656
|
+
<tr><td><code>data-fods-part="primary-action"</code></td><td><code>data-fods-part="action"</code> (on <code>BannerAction</code>)</td></tr>
|
|
657
|
+
<tr><td><code>data-fods-part="search-field"</code> wrapper</td><td>none — the field is a direct child of <code>actions</code>; Banner's Solid ring targets the field shell</td></tr>
|
|
658
|
+
</tbody>
|
|
659
|
+
</table>
|
|
660
|
+
|
|
661
|
+
Not migrated: a separate heading-and-action strip — the manifest maps it to Mini, but it does not
|
|
662
|
+
consume Banner.
|
|
663
|
+
|
|
664
|
+
### 2.1.0 — the Web block frame
|
|
665
|
+
|
|
666
|
+
The outer frame is the Web block frame, not the viewport; the plaque fills the block content
|
|
667
|
+
(1190 / 880 / 656 / 552 / 358, was 1200 / 944 / 704 / 592 / 358). Code: the `<section>` now carries
|
|
668
|
+
`--space-800` above and below (it used to be bare). Consumers that wrapped Banner in their own
|
|
669
|
+
vertical padding subtract it (`pt-[calc(var(--space-1100)_-_var(--space-800))]` and the MD
|
|
670
|
+
counterpart; the same for `py`), so the gap between blocks stays 1100 / 1300.
|
|
671
|
+
|
|
672
|
+
### 2.2.0 — the app supplies the artwork
|
|
673
|
+
|
|
674
|
+
`delivery.react`: the illustration is a React element the consumer supplies; the
|
|
675
|
+
component ships no picture and owns only its box. Code: the artwork was a CSS background the
|
|
676
|
+
composition picked; now Person takes `character` and `invoiceIllustration` `{ left, right }`
|
|
677
|
+
(type `BannerInvoiceIllustration`), Invoice takes `invoiceIllustration`, Mini neither. The parts
|
|
678
|
+
`character`, `invoice-sheet-left` and `invoice-sheet-right` are `<div>` boxes holding the element
|
|
679
|
+
instead of empty `<span>`s. Every Person and Invoice banner adds the props with the app's own
|
|
680
|
+
copies of the pictures (see Usage).
|
|
681
|
+
|
|
682
|
+
### 3.0.0 — the same change, recorded as a major
|
|
683
|
+
|
|
684
|
+
The manifest now records the artwork change of 2.2.0 as a major: it breaks the implementation already built against 1.x in the existing Storybook, and `delivery.migration` (now 1.x → 3.0.0) lists the steps. The code here already takes the elements; nothing else changes.
|
|
685
|
+
|
|
686
|
+
### Known deviations and open questions
|
|
687
|
+
|
|
688
|
+
- **Person alignment below LG.** The manifest says centred at MD / SM / Mobile; it records this as
|
|
689
|
+
an open question (`gaps`). Code follows the manifest.
|
|
690
|
+
- **Person split at the 2.1.0 plaque widths.** The authored bases (648 / 552, 520 / 424) were
|
|
691
|
+
measured at the 1.x plaque (1200 / 944). 2.1.0 narrowed the plaque without restating them; the
|
|
692
|
+
bases shrink proportionally.
|
|
693
|
+
- **Artwork geometry.** Band heights are structured in `regions.visual`; column splits, character
|
|
694
|
+
boxes and invoice heights are authored geometry and ship as raw px under fods-lint suppressions.
|
|
695
|
+
- **Mini reads flat; Mini copy uses two verbs** (`gaps`, both deferred).
|
|
696
|
+
|
|
697
|
+
### Open upstream gaps (manifest `gaps`, deferred)
|
|
698
|
+
|
|
699
|
+
- **One tone token for the Solid ink.** Banner binds `--text-inverted` where PromoSurface's pairing
|
|
700
|
+
table names `--secondary-foreground`; both resolve to white. The rebind is a planned backlog item.
|
|
701
|
+
- **No Button size matches TextField `md`'s 48.** Banner stretches a submit button beside a field to
|
|
702
|
+
the field height — a per-consumer workaround for a ladder gap.
|
|
703
|
+
- **Subject Lookup bottom sheet below SM** is not fully specified upstream; Banner adds no behaviour
|
|
704
|
+
of its own.
|