@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,399 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as PromoSurfaceStories from './PromoSurface.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={PromoSurfaceStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# PromoSurface
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Kind:** structure
|
|
13
|
+
- **Status:** draft
|
|
14
|
+
- **Tokens used:** `--bg-inverse`, `--bg-secondary`, `--radius-800`, `--secondary-solid`, `--secondary-subtle`
|
|
15
|
+
- **Manifest version:** `1.5.0`
|
|
16
|
+
- **Storybook:** [design-system-atoms-promosurface](?path=/docs/design-system-atoms-promosurface--docs)
|
|
17
|
+
|
|
18
|
+
## Overview
|
|
19
|
+
|
|
20
|
+
**PromoSurface** is the plaque behind a promotional panel on a **public page** — fill, a tiled
|
|
21
|
+
brand pattern, and a mask that decides where the pattern shows through. Two components consume it:
|
|
22
|
+
**Hero**, the first-screen panel, and **Banner**. It is chrome only: nothing lives inside it. The
|
|
23
|
+
consumer composes its own text column and visual **on top** and swaps this instance to change tone,
|
|
24
|
+
so adding a surface tone never multiplies either consumer's own variant matrix.
|
|
25
|
+
|
|
26
|
+
**Do not** use it for in-app cards, sections or callouts — those take a plain background fill
|
|
27
|
+
(`--bg-primary`, `--bg-secondary`) with no pattern. PromoSurface is a public-page component; it does not exist to make an ordinary panel look
|
|
28
|
+
"branded".
|
|
29
|
+
|
|
30
|
+
## Rationale
|
|
31
|
+
|
|
32
|
+
The fill, the pattern and the veil move together as **one tone decision**, so pulling them out of
|
|
33
|
+
Hero's and Banner's own composition keeps a four-tone palette from turning into a multiplier on
|
|
34
|
+
either consumer's variant matrix. **Layout** lives on the surface rather than on either consumer
|
|
35
|
+
because the veil's geometry — which part of the plaque stays clear of the pattern — has to be
|
|
36
|
+
authored per layout, not computed at render time. The result is one shared atom that Hero and
|
|
37
|
+
Banner each swap by instance instead of re-declaring for themselves.
|
|
38
|
+
|
|
39
|
+
## Anatomy
|
|
40
|
+
|
|
41
|
+
Three painted layers, bottom to top (manifest `chrome.layers`) — rendered by **two** DOM nodes:
|
|
42
|
+
|
|
43
|
+
- **Panel fill** — the root `<div>` (`data-fods-part="root"`). Its own background carries one of
|
|
44
|
+
the four Surface fills, clipped to `rounded-800` (`--radius-800`) by `overflow-hidden`. It is
|
|
45
|
+
`relative` and `pointer-events-none`, and deliberately carries **no width, height or inset**.
|
|
46
|
+
- **Pattern tile** — a `<span>` (`data-fods-part="pattern"`) at `absolute inset-0`, class
|
|
47
|
+
`fods-promo-surface-pattern`. `background-image: url(pattern-dark.svg)`,
|
|
48
|
+
`background-repeat: repeat` and `background-size: 149.33px 156px` live in
|
|
49
|
+
`styles/promo-surface.css` (part of the package's `shared.css`). That size
|
|
50
|
+
is the **motif period**, not the painted image: `chrome.pattern.tile-size` (1.3.2) states both —
|
|
51
|
+
the 896 × 468 image is a 6 × 3 grid of one motif, so the motif repeats at about 149 × 156. Its
|
|
52
|
+
opacity is a per-Surface constant.
|
|
53
|
+
- **Veil** — **not a third element.** It is the `mask-image` (plus `-webkit-mask-image`) on that
|
|
54
|
+
same pattern node: an elliptical `radial-gradient` that is transparent at the core, 18% black at
|
|
55
|
+
the mid stop and per-surface black at 100%. By definition a mask sits above the `background-image`
|
|
56
|
+
it masks, which is how three layers fit into two DOM nodes.
|
|
57
|
+
|
|
58
|
+
The gradient itself is authored in the stylesheet; the component only hands the pattern node six
|
|
59
|
+
CSS custom properties inline (per-instance values a stylesheet cannot know), and nothing else:
|
|
60
|
+
|
|
61
|
+
```css
|
|
62
|
+
.fods-promo-surface-pattern {
|
|
63
|
+
mask-image: radial-gradient(
|
|
64
|
+
ellipse var(--promo-veil-rx) var(--promo-veil-ry) at var(--promo-veil-cx) var(--promo-veil-cy),
|
|
65
|
+
transparent 0%,
|
|
66
|
+
color-mix(in srgb, black 18%, transparent) var(--promo-veil-mid),
|
|
67
|
+
color-mix(in srgb, black var(--promo-veil-edge), transparent) 100%
|
|
68
|
+
);
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Those are CSS custom properties, not design tokens — the mask's black is an alpha channel and the
|
|
73
|
+
five geometry values are percentages, so none of them has a token.
|
|
74
|
+
|
|
75
|
+
Consumer content — text column, visual, slots — composes **above** this whole stack, never inside
|
|
76
|
+
it. The props type is `Omit<React.HTMLAttributes<HTMLDivElement>, 'role' | 'children'>`, so
|
|
77
|
+
"nothing lives inside it" is enforced by the **compiler**, not by a comment.
|
|
78
|
+
|
|
79
|
+
## Variants
|
|
80
|
+
|
|
81
|
+
Two **equally-ranked** axes, twelve combinations (3 × 4). `layout` sets the veil geometry;
|
|
82
|
+
`surface` sets the fill.
|
|
83
|
+
|
|
84
|
+
<Canvas of={PromoSurfaceStories.Matrix} />
|
|
85
|
+
|
|
86
|
+
<table>
|
|
87
|
+
<thead>
|
|
88
|
+
<tr><th>Axis</th><th>Values</th><th>Decides</th></tr>
|
|
89
|
+
</thead>
|
|
90
|
+
<tbody>
|
|
91
|
+
<tr>
|
|
92
|
+
<td><code>layout</code></td>
|
|
93
|
+
<td><code>vertical</code> · <code>side</code> · <code>top</code></td>
|
|
94
|
+
<td>The veil's geometry — which part of the plaque stays clear of the pattern.</td>
|
|
95
|
+
</tr>
|
|
96
|
+
<tr>
|
|
97
|
+
<td><code>surface</code></td>
|
|
98
|
+
<td><code>brand</code> · <code>utility</code> · <code>solid</code> · <code>inverse</code></td>
|
|
99
|
+
<td>The panel fill, and with it the ink the consumer must use on top.</td>
|
|
100
|
+
</tr>
|
|
101
|
+
</tbody>
|
|
102
|
+
</table>
|
|
103
|
+
|
|
104
|
+
### Layout — the veil geometry
|
|
105
|
+
|
|
106
|
+
Pick it from **where the copy sits**, never from the breakpoint (manifest `intent.rules[0]`). The
|
|
107
|
+
numbers below are the gradient's centre and its **radii** as percentages of the panel's own width
|
|
108
|
+
and height (`VEIL_GEOMETRY`); a radius above 100% runs past the panel edge, so the outermost stop
|
|
109
|
+
is never reached inside the visible area — deliberate on `side` and `top`, which fade rather than
|
|
110
|
+
complete.
|
|
111
|
+
|
|
112
|
+
<table>
|
|
113
|
+
<thead>
|
|
114
|
+
<tr>
|
|
115
|
+
<th>Layout</th>
|
|
116
|
+
<th>Clear area</th>
|
|
117
|
+
<th style={{ textAlign: 'right' }}>Centre (cx / cy)</th>
|
|
118
|
+
<th style={{ textAlign: 'right' }}>Radii (rx / ry)</th>
|
|
119
|
+
<th style={{ textAlign: 'right' }}>Mid stop</th>
|
|
120
|
+
</tr>
|
|
121
|
+
</thead>
|
|
122
|
+
<tbody>
|
|
123
|
+
<tr>
|
|
124
|
+
<td><code>vertical</code></td>
|
|
125
|
+
<td>A band down the middle; pattern strongest along the left and right edges — a wide panel with centred copy.</td>
|
|
126
|
+
<td style={{ textAlign: 'right' }}><code>50%</code> / <code>50%</code></td>
|
|
127
|
+
<td style={{ textAlign: 'right' }}><code>50%</code> / <code>83%</code></td>
|
|
128
|
+
<td style={{ textAlign: 'right' }}><code>57%</code></td>
|
|
129
|
+
</tr>
|
|
130
|
+
<tr>
|
|
131
|
+
<td><code>side</code></td>
|
|
132
|
+
<td>The left of the plaque; pattern builds toward the right edge — copy in a left-hand column with a visual opposite it.</td>
|
|
133
|
+
<td style={{ textAlign: 'right' }}><code>9%</code> / <code>50%</code></td>
|
|
134
|
+
<td style={{ textAlign: 'right' }}><code>91%</code> / <code>159%</code></td>
|
|
135
|
+
<td style={{ textAlign: 'right' }}><code>45%</code></td>
|
|
136
|
+
</tr>
|
|
137
|
+
<tr>
|
|
138
|
+
<td><code>top</code></td>
|
|
139
|
+
<td>A band across the top; pattern builds downward — a tall stacked panel with copy above the visual.</td>
|
|
140
|
+
<td style={{ textAlign: 'right' }}><code>50%</code> / <code>22%</code></td>
|
|
141
|
+
<td style={{ textAlign: 'right' }}><code>250%</code> / <code>38%</code></td>
|
|
142
|
+
<td style={{ textAlign: 'right' }}><code>45%</code></td>
|
|
143
|
+
</tr>
|
|
144
|
+
</tbody>
|
|
145
|
+
</table>
|
|
146
|
+
|
|
147
|
+
Put the copy **inside** the clear area of the Layout chosen. A panel whose copy falls outside it
|
|
148
|
+
renders the headline on top of the pattern, which is the one thing the veil exists to prevent.
|
|
149
|
+
|
|
150
|
+
### Surface — fill and the ink that pairs with it
|
|
151
|
+
|
|
152
|
+
This is the most important table on this component: **mixing one surface's fill with another
|
|
153
|
+
surface's ink is the only way it fails contrast with no code defect.** The surface itself renders no
|
|
154
|
+
text, so every contrast obligation belongs to what the consumer composes on top.
|
|
155
|
+
|
|
156
|
+
<Canvas of={PromoSurfaceStories.InkPairing} />
|
|
157
|
+
|
|
158
|
+
<table>
|
|
159
|
+
<thead>
|
|
160
|
+
<tr>
|
|
161
|
+
<th>Surface</th>
|
|
162
|
+
<th>Fill token (class)</th>
|
|
163
|
+
<th>Ink the consumer must use (class)</th>
|
|
164
|
+
<th style={{ textAlign: 'right' }}>Pattern opacity</th>
|
|
165
|
+
<th style={{ textAlign: 'right' }}>Veil edge alpha</th>
|
|
166
|
+
</tr>
|
|
167
|
+
</thead>
|
|
168
|
+
<tbody>
|
|
169
|
+
<tr>
|
|
170
|
+
<td><code>brand</code> (default)</td>
|
|
171
|
+
<td><code>--secondary-subtle</code> (<code>bg-secondary-subtle</code>)</td>
|
|
172
|
+
<td><code>--text-primary</code> (<code>text-text-primary</code>)</td>
|
|
173
|
+
<td style={{ textAlign: 'right' }}><code>0.08</code></td>
|
|
174
|
+
<td style={{ textAlign: 'right' }}><code>70%</code></td>
|
|
175
|
+
</tr>
|
|
176
|
+
<tr>
|
|
177
|
+
<td><code>utility</code></td>
|
|
178
|
+
<td><code>--bg-secondary</code> (<code>bg-background-secondary</code>)</td>
|
|
179
|
+
<td><code>--text-primary</code> (<code>text-text-primary</code>)</td>
|
|
180
|
+
<td style={{ textAlign: 'right' }}><code>0.08</code></td>
|
|
181
|
+
<td style={{ textAlign: 'right' }}><code>50%</code></td>
|
|
182
|
+
</tr>
|
|
183
|
+
<tr>
|
|
184
|
+
<td><code>solid</code></td>
|
|
185
|
+
<td><code>--secondary-solid</code> (<code>bg-secondary-solid</code>)</td>
|
|
186
|
+
<td><code>--secondary-foreground</code> (<code>text-secondary-foreground</code>)</td>
|
|
187
|
+
<td style={{ textAlign: 'right' }}><code>0.25</code></td>
|
|
188
|
+
<td style={{ textAlign: 'right' }}><code>100%</code></td>
|
|
189
|
+
</tr>
|
|
190
|
+
<tr>
|
|
191
|
+
<td><code>inverse</code></td>
|
|
192
|
+
<td><code>--bg-inverse</code> (<code>bg-background-inverse</code>)</td>
|
|
193
|
+
<td><code>--text-inverted</code> (<code>text-text-inverted</code>)</td>
|
|
194
|
+
<td style={{ textAlign: 'right' }}><code>0.25</code></td>
|
|
195
|
+
<td style={{ textAlign: 'right' }}><code>100%</code></td>
|
|
196
|
+
</tr>
|
|
197
|
+
</tbody>
|
|
198
|
+
</table>
|
|
199
|
+
|
|
200
|
+
`solid` and `inverse` are both dark plaques and are easy to confuse: `solid` is the **bright** brand
|
|
201
|
+
fill (`--secondary-solid`, blue/600), `inverse` is the **deep** one (`--bg-inverse`, blue/900) and
|
|
202
|
+
matches what `Surface=Inverse` means elsewhere in FODS, e.g. Sticky Context Bar.
|
|
203
|
+
|
|
204
|
+
**Pattern strength is a per-surface constant, not an instance control** (manifest
|
|
205
|
+
`intent.rules[2]`). The two numbers in the last two columns are the whole tuning: the light plaques
|
|
206
|
+
hold the pattern back at the veil's edge, the two dark ones reveal it fully and are dialled at the
|
|
207
|
+
tile's opacity instead. There is no `opacity` prop, and the four values are tuned so all four
|
|
208
|
+
plaques read at one weight by eye. The tile itself is **one shared asset**, never recoloured or
|
|
209
|
+
re-cut per surface.
|
|
210
|
+
|
|
211
|
+
**The tile must be fully opaque, and the opacity column is the only strength dial.** The four
|
|
212
|
+
values are measured against an opaque tile, so a tile carrying its own alpha would multiply into all
|
|
213
|
+
four at once — which a consumer cannot correct per surface without breaking exactly the parity the
|
|
214
|
+
values exist to hold (`chrome.pattern.asset`, 1.2.0). They are also measured **before the veil**:
|
|
215
|
+
what reaches the eye is the value times the veil's edge alpha, so Brand lands at 0.056 and Utility
|
|
216
|
+
at 0.04 while Solid and Inverse arrive whole.
|
|
217
|
+
|
|
218
|
+
The repo tile used to draw its `#226FA1` strokes at `fill-opacity: 0.5`, which built the pattern at
|
|
219
|
+
about half the drawn strength and near-invisible on Brand and Utility; this component compensated by
|
|
220
|
+
painting the manifest number doubled. `assets/cta-images/pattern-dark.svg` has since been re-cut
|
|
221
|
+
without the alpha, so the painted opacity is now the manifest value verbatim.
|
|
222
|
+
|
|
223
|
+
**Manifest 1.3.0 retuned the column** in Figma: Brand and Utility went `0.06` → `0.03`, Solid
|
|
224
|
+
`0.29` → `0.20` and Inverse `0.22` → `0.20`, so the two dark plaques now share one value. Only the
|
|
225
|
+
strength moved — the veil stops, the geometry, the tile asset and its scale are untouched, and it is
|
|
226
|
+
still a per-surface constant rather than an instance control.
|
|
227
|
+
|
|
228
|
+
**Manifest 1.4.0 strengthened the column again** (2026-10-08): Brand and Utility `0.03` → `0.08`,
|
|
229
|
+
Solid and Inverse `0.20` → `0.25`. The light pair and the dark pair each still share one value; the
|
|
230
|
+
veil stops, the geometry, the tile asset and its scale are unchanged. If you have a screenshot or a Figma
|
|
231
|
+
frame from between 2026-09-16 and 2026-10-08, the pattern in it is weaker than what ships now.
|
|
232
|
+
|
|
233
|
+
## Sizes
|
|
234
|
+
|
|
235
|
+
**No size axis** (manifest `intent.sizing`). The component takes no width or height of its own —
|
|
236
|
+
both painted layers stretch to the panel on both axes, and the consumer positions the surface from
|
|
237
|
+
the outside. A **fixed-height surface is the canonical breakage**: it either stops short of the
|
|
238
|
+
plaque or overruns it, and either result reads as a rendering fault rather than a design choice.
|
|
239
|
+
|
|
240
|
+
<Canvas of={PromoSurfaceStories.StretchContract} />
|
|
241
|
+
|
|
242
|
+
The demo panels in **`Playground` and `Matrix`** are sized from the manifest's
|
|
243
|
+
`delivery.storybookNote` — `vertical` and `side` at 1200 × 320, `top` at 358 × 662, the panel
|
|
244
|
+
sizes Hero and Banner actually ship at the widest and narrowest breakpoints. `InkPairing`
|
|
245
|
+
(280 × 160) and `StretchContract` (600 × 320) deliberately do not: the first is a swatch grid for
|
|
246
|
+
the fill/ink pairing and the second demonstrates the stretch contract, and neither is making a
|
|
247
|
+
claim about veil geometry. Note that even the sized panels carry `max-width: 100%`, so in a narrow
|
|
248
|
+
docs canvas the 1200-wide cells render narrower while the height holds — the proportions, and with
|
|
249
|
+
them the veil, shift accordingly. They are not decoration: the veil geometry is relative to the
|
|
250
|
+
panel's own proportions, so a square preview would put the clear area in the wrong place in every
|
|
251
|
+
one of the twelve cells.
|
|
252
|
+
|
|
253
|
+
## States
|
|
254
|
+
|
|
255
|
+
**This component has no states**, so there is no States story and no `<Canvas>` here. A background
|
|
256
|
+
plaque has no interaction and no lifecycle: it takes no input, holds no focus, does not load and is
|
|
257
|
+
not hovered — it is either rendered with the chosen `layout` and `surface`, or not rendered at all
|
|
258
|
+
(manifest `intent.states`).
|
|
259
|
+
|
|
260
|
+
The manifest is explicit about the consequence for this page (`delivery.storybookStates`): *"The
|
|
261
|
+
Definition of Done's five-interaction-states box does not apply: this component has no states (see
|
|
262
|
+
intent.states). Cover the 12 Layout x Surface cells instead."* That coverage is the
|
|
263
|
+
[Matrix](#variants) story above.
|
|
264
|
+
|
|
265
|
+
Whatever states the consumer's content carries — hover on a button, focus on a link — belong
|
|
266
|
+
entirely to that content.
|
|
267
|
+
|
|
268
|
+
**Motion: none.** The manifest declares the plaque static (1.4.1 `motion.none`: „static surface“) and lists no
|
|
269
|
+
`inherits` — the content slot's motion is the content's own, not the surface's.
|
|
270
|
+
|
|
271
|
+
## API
|
|
272
|
+
|
|
273
|
+
<Controls />
|
|
274
|
+
|
|
275
|
+
Two props, `layout` and `surface`, and deliberately **not** a single generic `variant`: the manifest
|
|
276
|
+
records Layout under `axes.variant` only because the schema's axis keys are fixed, and
|
|
277
|
+
`properties[].maps` overrides that — *"NOT the generic variant prop: … the component has two
|
|
278
|
+
equally-ranked tone axes and neither is 'the' variant."* Values are lowercase-kebab in code; the
|
|
279
|
+
Figma casing never reaches it.
|
|
280
|
+
|
|
281
|
+
The props type extends `Omit<React.HTMLAttributes<HTMLDivElement>, 'role' | 'children'>`. Both
|
|
282
|
+
omissions are load-bearing: `children` makes "nothing lives inside it" a compile error rather than a
|
|
283
|
+
convention, and dropping `role` keeps the element role-free as `delivery.react` requires — an
|
|
284
|
+
accidental `role="group"` on an `aria-hidden` node is something axe would not report.
|
|
285
|
+
|
|
286
|
+
## Do / Don't
|
|
287
|
+
|
|
288
|
+
- ✅ Match `layout` to where the consumer's copy actually sits.
|
|
289
|
+
- ✅ Use the ink token that pairs with the chosen `surface` (see the table above).
|
|
290
|
+
- ✅ Let the surface stretch to the panel on both axes (`absolute inset-0` in a `relative` panel).
|
|
291
|
+
- ✅ Treat pattern strength as fixed per `surface`.
|
|
292
|
+
- ✅ Compose the consumer's text and visual above the whole stack, as a sibling.
|
|
293
|
+
- ✅ Use it as the bottom layer of a Hero or Banner panel on a public page.
|
|
294
|
+
- ✅ Reuse the tile already in the frontend assets.
|
|
295
|
+
- ❌ Pick `layout` from the breakpoint.
|
|
296
|
+
- ❌ Mix one surface's fill with another surface's ink.
|
|
297
|
+
- ❌ Give it a fixed height.
|
|
298
|
+
- ❌ Retune the pattern's opacity or the veil's alpha on one instance — and remember **the veil is a
|
|
299
|
+
mask, not a colour overlay**: its alpha decides where the pattern shows, the core hides it and the
|
|
300
|
+
edges reveal it, so **raising the alpha makes the pattern MORE visible, not less**.
|
|
301
|
+
- ❌ Put content, text or an icon inside the surface itself.
|
|
302
|
+
- ❌ Reach for it as a background for an in-app card, section or callout — those take a plain
|
|
303
|
+
background fill (`--bg-primary`, `--bg-secondary`) with no pattern.
|
|
304
|
+
- ❌ Export a fresh tile from Figma or re-cut one per surface.
|
|
305
|
+
|
|
306
|
+
## Accessibility
|
|
307
|
+
|
|
308
|
+
- **Keyboard** — nothing. The surface is **not part of the tab order**: no `tabindex`, no
|
|
309
|
+
interactive element and no focusable child in the component.
|
|
310
|
+
- **ARIA** — the root carries `aria-hidden="true"` and **no role**. The whole component is
|
|
311
|
+
decorative, renders no text and has no accessible name to carry, because there is nothing to name.
|
|
312
|
+
`role` is `Omit`ted from the props type so it cannot be added by accident.
|
|
313
|
+
- **Screen reader** — announces nothing in any of the twelve cells; both painted layers are out of
|
|
314
|
+
the accessibility tree. Everything a user hears comes from the consumer's sibling content above
|
|
315
|
+
the surface.
|
|
316
|
+
- **Pointer** — `pointer-events-none` on the root. An `aria-hidden` layer that still swallowed
|
|
317
|
+
clicks would intercept them on their way to the copy and CTA composed above it.
|
|
318
|
+
- **Contrast** — the pattern tile and the veil are **decorative**: neither carries information on
|
|
319
|
+
its own, so neither is a graphical object WCAG **1.4.11** requires to meet a contrast minimum.
|
|
320
|
+
The pattern never sits under a headline — the veil's quiet core is the reading area. Text contrast
|
|
321
|
+
is entirely the consumer's, via the fill/ink pairing table. One recorded exception:
|
|
322
|
+
`--secondary-foreground` on `--secondary-solid` is **4.45:1**, an accepted brand exception scoped
|
|
323
|
+
to large or semibold copy — body-size copy on `solid` does not clear AA-Normal (manifest
|
|
324
|
+
`chrome.ink.note`).
|
|
325
|
+
- **Focus ring on the dark plaques** — `--outline-focus` is the same hex as `--secondary-solid`, so
|
|
326
|
+
the default ring is invisible on `solid`, and it measures **2.12:1** on `--bg-inverse`, under the
|
|
327
|
+
3:1 non-text floor. Anything focusable composed on those two fills must swap to
|
|
328
|
+
`--outline-focus-inverse` (9.43:1 on `--bg-inverse`, 4.45:1 on `--secondary-solid`). Manifest
|
|
329
|
+
`gaps[0]`, status **resolved** — no new token needed. **That obligation belongs to the consumer,
|
|
330
|
+
not to this atom, which holds no focus itself.**
|
|
331
|
+
- **Motion** — none (manifest `motion.none`). The veil is a static mask and the pattern a static tile; the component declares
|
|
332
|
+
no animation class, so `prefers-reduced-motion` has nothing to do here.
|
|
333
|
+
|
|
334
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
335
|
+
|
|
336
|
+
## Usage
|
|
337
|
+
|
|
338
|
+
The surface is positioned from the outside. This is how the stories' `Panel` composes it, and how
|
|
339
|
+
Hero and Banner do it — the surface is a background **sibling**, never a wrapper.
|
|
340
|
+
|
|
341
|
+
<Canvas of={PromoSurfaceStories.Playground} />
|
|
342
|
+
|
|
343
|
+
```tsx
|
|
344
|
+
// Good — surface stretched inside a `relative` panel, content as a sibling above it
|
|
345
|
+
<div className="relative">
|
|
346
|
+
<PromoSurface layout="side" surface="solid" className="absolute inset-0" />
|
|
347
|
+
<div className="relative z-10 p-800 text-secondary-foreground">
|
|
348
|
+
<h2 className="text-heading-lg font-semibold">Fakturujte za Acme s.r.o. online</h2>
|
|
349
|
+
<p className="text-body-sm">Vyzkoušejte to na firma@priklad.cz</p>
|
|
350
|
+
</div>
|
|
351
|
+
</div>
|
|
352
|
+
```
|
|
353
|
+
|
|
354
|
+
```tsx
|
|
355
|
+
// Don't — a height of its own instead of stretching (see the StretchContract story)
|
|
356
|
+
<PromoSurface layout="side" surface="brand" className="absolute inset-x-0 top-0 h-[180px]" />
|
|
357
|
+
|
|
358
|
+
// Don't — content inside the surface (also a TypeScript error: `children` is omitted)
|
|
359
|
+
<PromoSurface layout="vertical" surface="brand">
|
|
360
|
+
<h2>Fakturace pro Acme s.r.o.</h2>
|
|
361
|
+
</PromoSurface>
|
|
362
|
+
|
|
363
|
+
// Don't — `solid` fill with `inverse` ink; the fill/ink pairing is the whole rule
|
|
364
|
+
<PromoSurface layout="vertical" surface="solid" className="absolute inset-0" />
|
|
365
|
+
<p className="relative z-10 text-text-inverted">Acme s.r.o.</p>
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
## Related
|
|
369
|
+
|
|
370
|
+
- **Consumed by** — Hero and Banner, both via instance swap. Banner names its tone axis Brand /
|
|
371
|
+
Solid, the same values this atom's `surface` axis uses, so a Banner variant's Surface value passes
|
|
372
|
+
straight through with no mapping table (manifest `gaps[1]`, resolved).
|
|
373
|
+
- **Related surface** — Sticky Context Bar, the other FODS component whose `Surface=Inverse` binds
|
|
374
|
+
`--bg-inverse`.
|
|
375
|
+
- **Spec:** `spec/03-atoms/promo-surface.md`
|
|
376
|
+
and `promo-surface.manifest.json` (fill, radius, pattern opacity, veil stops and geometry per
|
|
377
|
+
variant).
|
|
378
|
+
- Not Radix-based — the component renders a plain `<div>` with one `<span>` inside.
|
|
379
|
+
|
|
380
|
+
## Migration notes
|
|
381
|
+
|
|
382
|
+
**Motion (manifest 1.4.1, 2026-11-03) — documentation only.** The motion audit declares the plaque static
|
|
383
|
+
(`motion.none`). No code change.
|
|
384
|
+
|
|
385
|
+
**PromoSurface is a new component.** Per the upstream spec's `## Migration`: *"No old class names,
|
|
386
|
+
no legacy markup and no prior variant scheme map onto it — there is nothing to rebind and nothing to
|
|
387
|
+
deprecate."*
|
|
388
|
+
|
|
389
|
+
The **pattern tile** is not new. PromoSurface reuses the existing pattern tile (in this package `src/styles/assets/pattern-dark.svg`) rather than exporting a fresh one —
|
|
390
|
+
one tile serves every Layout and every Surface, and the only thing that differs between them is its
|
|
391
|
+
opacity. PromoSurface paints it at `background-size: 149.33px 156px`
|
|
392
|
+
(`styles/promo-surface.css`).
|
|
393
|
+
|
|
394
|
+
The file **used to** carry a built-in `fill-opacity: 0.5`, and the painted opacities were the spec
|
|
395
|
+
numbers doubled to compensate. Manifest 1.2.0 closed that: `chrome.pattern.asset` now requires a
|
|
396
|
+
fully opaque tile, because *"a tile carrying its own alpha multiplies into every one of the four
|
|
397
|
+
values at once, so a consumer cannot correct it per surface without breaking the parity the values
|
|
398
|
+
exist to hold."* The asset was re-cut without the alpha and the opacities here are the manifest
|
|
399
|
+
numbers verbatim.
|
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
2
|
+
import { PromoSurface } from './PromoSurface';
|
|
3
|
+
import { Section, Showcase } from '../../storybook/Section';
|
|
4
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
5
|
+
|
|
6
|
+
const LAYOUTS = ['vertical', 'side', 'top'] as const;
|
|
7
|
+
const SURFACES = ['brand', 'utility', 'solid', 'inverse'] as const;
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Demo panel geometry, straight from `promo-surface.manifest.json`
|
|
11
|
+
* `delivery.storybookNote`:
|
|
12
|
+
*
|
|
13
|
+
* "A Matrix story needs a demo panel to sit in, because the surface has no
|
|
14
|
+
* intrinsic size, and the veil geometry is relative to the panel's own
|
|
15
|
+
* proportions — a square thumbnail misrepresents every cell. Demo Vertical and
|
|
16
|
+
* Side at 1200 x 320 and Top at 358 x 662; those are the panel sizes Hero and
|
|
17
|
+
* Banner actually ship at the widest and narrowest breakpoints."
|
|
18
|
+
*
|
|
19
|
+
* The numbers are therefore NOT decoration: a square preview would put the veil's
|
|
20
|
+
* clear area in the wrong place in every one of the twelve cells. They are inline
|
|
21
|
+
* styles rather than Tailwind arbitrary utilities because they are story scaffolding,
|
|
22
|
+
* not component design — nothing here should end up in the token lint's field of view.
|
|
23
|
+
*/
|
|
24
|
+
const PANEL_SIZE: Record<(typeof LAYOUTS)[number], { width: number; height: number }> = {
|
|
25
|
+
vertical: { width: 1200, height: 320 },
|
|
26
|
+
side: { width: 1200, height: 320 },
|
|
27
|
+
top: { width: 358, height: 662 },
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
/** The ink each Surface pairs with (`chrome.ink`) — the consumer's obligation. */
|
|
31
|
+
const INK_CLASS: Record<(typeof SURFACES)[number], string> = {
|
|
32
|
+
brand: 'text-text-primary',
|
|
33
|
+
utility: 'text-text-primary',
|
|
34
|
+
solid: 'text-secondary-foreground',
|
|
35
|
+
inverse: 'text-text-inverted',
|
|
36
|
+
};
|
|
37
|
+
|
|
38
|
+
const INK_TOKEN: Record<(typeof SURFACES)[number], string> = {
|
|
39
|
+
brand: '--text-primary',
|
|
40
|
+
utility: '--text-primary',
|
|
41
|
+
solid: '--secondary-foreground',
|
|
42
|
+
inverse: '--text-inverted',
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* A demo panel: `relative` box at the manifest's shipping size, with the surface
|
|
47
|
+
* absolutely filling it. This is exactly how Hero and Banner compose it — the surface
|
|
48
|
+
* is a background SIBLING, never a wrapper, so content never lands inside it
|
|
49
|
+
* (`intent.whenToUse`: "It is chrome only: nothing lives inside it").
|
|
50
|
+
*/
|
|
51
|
+
function Panel({
|
|
52
|
+
layout,
|
|
53
|
+
surface,
|
|
54
|
+
label,
|
|
55
|
+
}: {
|
|
56
|
+
layout: (typeof LAYOUTS)[number];
|
|
57
|
+
surface: (typeof SURFACES)[number];
|
|
58
|
+
label?: string;
|
|
59
|
+
}) {
|
|
60
|
+
const { width, height } = PANEL_SIZE[layout];
|
|
61
|
+
|
|
62
|
+
return (
|
|
63
|
+
<div className="flex max-w-full flex-col gap-200">
|
|
64
|
+
<div
|
|
65
|
+
className="relative max-w-full overflow-hidden"
|
|
66
|
+
style={{ width, height, maxWidth: '100%' }}
|
|
67
|
+
>
|
|
68
|
+
<PromoSurface layout={layout} surface={surface} className="absolute inset-0" />
|
|
69
|
+
{label && (
|
|
70
|
+
<p
|
|
71
|
+
className={`relative z-10 p-800 text-body-sm font-semibold ${INK_CLASS[surface]}`}
|
|
72
|
+
>
|
|
73
|
+
{label}
|
|
74
|
+
</p>
|
|
75
|
+
)}
|
|
76
|
+
</div>
|
|
77
|
+
<p className="text-body-xs text-text-secondary">
|
|
78
|
+
{layout} · {surface} — {width}×{height}
|
|
79
|
+
</p>
|
|
80
|
+
</div>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const meta = {
|
|
85
|
+
title: 'Design System/Atoms/PromoSurface',
|
|
86
|
+
component: PromoSurface,
|
|
87
|
+
parameters: {
|
|
88
|
+
layout: 'fullscreen',
|
|
89
|
+
docs: {
|
|
90
|
+
description: {
|
|
91
|
+
component: componentDoc({
|
|
92
|
+
summary:
|
|
93
|
+
'The promo plaque — fill, tiled brand pattern and the veil mask that keeps the reading area clear. Chrome only: it renders no text, holds no children and carries no ARIA role. Hero and Banner compose their own content as a sibling layer above it.',
|
|
94
|
+
useCases: [
|
|
95
|
+
'`layout` picks the veil geometry from **where the copy sits**, never from the breakpoint — `vertical` clears a band down the middle, `side` clears the left, `top` clears a band across the top.',
|
|
96
|
+
'`surface` picks the fill from the page family, and the consumer must then use the ink that pairs with it (see the Ink pairing story).',
|
|
97
|
+
'Position it yourself: the component takes no width or height of its own — typically `className="absolute inset-0"` inside a `relative` panel.',
|
|
98
|
+
],
|
|
99
|
+
bestPractices: [
|
|
100
|
+
'Let the surface stretch to the panel on both axes. A fixed-height surface is the canonical breakage — it either stops short of the plaque or overruns it.',
|
|
101
|
+
'Never mix one surface\'s fill with another surface\'s ink. That is the one way this component fails contrast with no code defect.',
|
|
102
|
+
'Pattern strength is a per-surface constant, not an instance control. Retuning opacity on one instance breaks the parity between the four tones.',
|
|
103
|
+
'Compose content ABOVE the surface as a sibling, never inside it.',
|
|
104
|
+
'Public pages only. In-app cards, sections and callouts take a plain `--bg-*` fill with no pattern.',
|
|
105
|
+
],
|
|
106
|
+
knownIssues: [
|
|
107
|
+
'The veil is a **mask**, not a colour overlay: its alpha decides where the pattern shows. The core hides the pattern and the edges reveal it, so raising the veil alpha makes the pattern MORE visible, not less.',
|
|
108
|
+
'`solid` and `inverse` are both dark plaques and easy to confuse. `solid` is the bright brand fill (`--secondary-solid`); `inverse` is the deep one (`--bg-inverse`).',
|
|
109
|
+
'On `solid` and `inverse` the default focus ring is invisible or under the 3:1 non-text floor, so anything focusable the consumer composes on top must swap to `--outline-focus-inverse`. That obligation belongs to the consumer — this atom holds no focus.',
|
|
110
|
+
'No interaction states exist on this component, so the Definition of Done\'s five-state box does not apply (manifest `delivery.storybookStates`). The 12 Layout × Surface cells are the coverage instead.',
|
|
111
|
+
],
|
|
112
|
+
docsLink: {
|
|
113
|
+
label: 'spec/03-atoms/promo-surface.md',
|
|
114
|
+
},
|
|
115
|
+
}),
|
|
116
|
+
},
|
|
117
|
+
},
|
|
118
|
+
},
|
|
119
|
+
argTypes: {
|
|
120
|
+
layout: {
|
|
121
|
+
control: 'inline-radio',
|
|
122
|
+
options: LAYOUTS,
|
|
123
|
+
description: 'Veil geometry — which part of the plaque stays clear of the pattern.',
|
|
124
|
+
},
|
|
125
|
+
surface: {
|
|
126
|
+
control: 'inline-radio',
|
|
127
|
+
options: SURFACES,
|
|
128
|
+
description: 'Panel fill, and with it the ink the consumer must use on top.',
|
|
129
|
+
},
|
|
130
|
+
},
|
|
131
|
+
args: {
|
|
132
|
+
layout: 'vertical',
|
|
133
|
+
surface: 'brand',
|
|
134
|
+
},
|
|
135
|
+
} satisfies Meta<typeof PromoSurface>;
|
|
136
|
+
|
|
137
|
+
export default meta;
|
|
138
|
+
type Story = StoryObj<typeof meta>;
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* The interactive cell. Rendered inside a demo panel at the manifest's shipping size
|
|
142
|
+
* for the chosen layout, because the veil geometry is relative to the panel's own
|
|
143
|
+
* proportions.
|
|
144
|
+
*/
|
|
145
|
+
export const Playground: Story = {
|
|
146
|
+
render: ({ layout = 'vertical', surface = 'brand' }) => (
|
|
147
|
+
<div className="p-800">
|
|
148
|
+
<Panel layout={layout} surface={surface} label="Content composes above the surface" />
|
|
149
|
+
</div>
|
|
150
|
+
),
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* All 12 cells — Layout (rows) × Surface (columns).
|
|
155
|
+
*
|
|
156
|
+
* This is the component's coverage story in place of a States matrix: the manifest is
|
|
157
|
+
* explicit that "the Definition of Done's five-interaction-states box does not apply:
|
|
158
|
+
* this component has no states. Cover the 12 Layout x Surface cells instead."
|
|
159
|
+
*/
|
|
160
|
+
export const Matrix: Story = {
|
|
161
|
+
parameters: { controls: { disable: true } },
|
|
162
|
+
render: () => (
|
|
163
|
+
<div className="p-800">
|
|
164
|
+
<Showcase>
|
|
165
|
+
{LAYOUTS.map(layout => (
|
|
166
|
+
<Section
|
|
167
|
+
key={layout}
|
|
168
|
+
title={layout}
|
|
169
|
+
description={
|
|
170
|
+
layout === 'vertical'
|
|
171
|
+
? 'Clears a band down the middle, pattern along the left and right edges — a wide panel with centred copy.'
|
|
172
|
+
: layout === 'side'
|
|
173
|
+
? 'Clears the left of the plaque, pattern builds toward the right edge — copy in a left-hand column with a visual opposite it.'
|
|
174
|
+
: 'Clears a band across the top, pattern builds downward — a tall stacked panel with copy above the visual.'
|
|
175
|
+
}
|
|
176
|
+
layout="row"
|
|
177
|
+
>
|
|
178
|
+
{SURFACES.map(surface => (
|
|
179
|
+
<Panel key={surface} layout={layout} surface={surface} />
|
|
180
|
+
))}
|
|
181
|
+
</Section>
|
|
182
|
+
))}
|
|
183
|
+
</Showcase>
|
|
184
|
+
</div>
|
|
185
|
+
),
|
|
186
|
+
};
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* The fill / ink pairing table, rendered live. Mixing one surface's fill with another
|
|
190
|
+
* surface's ink is the failure the Surface axis exists to prevent (`intent.rules[1]`),
|
|
191
|
+
* and it is invisible in a static class list — so it gets its own story.
|
|
192
|
+
*/
|
|
193
|
+
export const InkPairing: Story = {
|
|
194
|
+
parameters: { controls: { disable: true } },
|
|
195
|
+
render: () => (
|
|
196
|
+
<div className="p-800">
|
|
197
|
+
<Showcase>
|
|
198
|
+
<Section
|
|
199
|
+
title="Fill × ink"
|
|
200
|
+
description="Each plaque carries the ink token it pairs with. The surface itself renders no text — every contrast obligation belongs to the content composed on top."
|
|
201
|
+
layout="row"
|
|
202
|
+
>
|
|
203
|
+
{SURFACES.map(surface => (
|
|
204
|
+
<div
|
|
205
|
+
key={surface}
|
|
206
|
+
className="relative max-w-full overflow-hidden"
|
|
207
|
+
style={{ width: 280, height: 160 }}
|
|
208
|
+
>
|
|
209
|
+
<PromoSurface layout="vertical" surface={surface} className="absolute inset-0" />
|
|
210
|
+
<div className={`relative z-10 flex h-full flex-col justify-center gap-200 p-800 ${INK_CLASS[surface]}`}>
|
|
211
|
+
<p className="text-body-lg font-semibold">{surface}</p>
|
|
212
|
+
<p className="text-body-xs">{INK_TOKEN[surface]}</p>
|
|
213
|
+
</div>
|
|
214
|
+
</div>
|
|
215
|
+
))}
|
|
216
|
+
</Section>
|
|
217
|
+
</Showcase>
|
|
218
|
+
</div>
|
|
219
|
+
),
|
|
220
|
+
};
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* The two failure modes the spec calls out, side by side with the correct build.
|
|
224
|
+
*
|
|
225
|
+
* Left: a surface given a fixed height inside a taller panel — "the canonical way this
|
|
226
|
+
* breaks: it either stops short of the plaque or overruns it, and either result reads
|
|
227
|
+
* as a rendering fault rather than a design choice" (`intent.sizing`).
|
|
228
|
+
*
|
|
229
|
+
* Right: the same panel with the surface stretched on both axes.
|
|
230
|
+
*/
|
|
231
|
+
export const StretchContract: Story = {
|
|
232
|
+
parameters: { controls: { disable: true } },
|
|
233
|
+
render: () => (
|
|
234
|
+
<div className="p-800">
|
|
235
|
+
<Showcase>
|
|
236
|
+
<Section
|
|
237
|
+
title="Don't — fixed height"
|
|
238
|
+
description="The surface stops short of the plaque. Reads as a rendering fault, not a design."
|
|
239
|
+
layout="row"
|
|
240
|
+
>
|
|
241
|
+
<div className="relative max-w-full" style={{ width: 600, height: 320 }}>
|
|
242
|
+
{/* Deliberately wrong: a height of its own instead of stretching. 180 of
|
|
243
|
+
the panel's 320 — the shortfall IS the anti-pattern being shown. */}
|
|
244
|
+
<PromoSurface
|
|
245
|
+
layout="side"
|
|
246
|
+
surface="brand"
|
|
247
|
+
className="absolute inset-x-0 top-0"
|
|
248
|
+
style={{ height: 180 }}
|
|
249
|
+
/>
|
|
250
|
+
<p className="relative z-10 p-800 text-body-sm font-semibold text-text-primary">
|
|
251
|
+
Fixed height
|
|
252
|
+
</p>
|
|
253
|
+
</div>
|
|
254
|
+
</Section>
|
|
255
|
+
<Section
|
|
256
|
+
title="Do — stretched on both axes"
|
|
257
|
+
description="`absolute inset-0` inside a `relative` panel; the surface always matches the plaque's bounds."
|
|
258
|
+
layout="row"
|
|
259
|
+
>
|
|
260
|
+
<div className="relative max-w-full" style={{ width: 600, height: 320 }}>
|
|
261
|
+
<PromoSurface layout="side" surface="brand" className="absolute inset-0" />
|
|
262
|
+
<p className="relative z-10 p-800 text-body-sm font-semibold text-text-primary">
|
|
263
|
+
Stretched
|
|
264
|
+
</p>
|
|
265
|
+
</div>
|
|
266
|
+
</Section>
|
|
267
|
+
</Showcase>
|
|
268
|
+
</div>
|
|
269
|
+
),
|
|
270
|
+
};
|