@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,280 @@
|
|
|
1
|
+
import { Meta, Canvas, Controls } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import * as FirmAvatarStories from './FirmAvatar.stories';
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
<Meta of={FirmAvatarStories} tags={['autodocs']} />
|
|
6
|
+
|
|
7
|
+
# FirmAvatar
|
|
8
|
+
|
|
9
|
+
## Metadata
|
|
10
|
+
|
|
11
|
+
- **Layer:** atom
|
|
12
|
+
- **Status:** stable
|
|
13
|
+
- **Tokens used:** `--font-heading`, `--font-size-heading-h5`, `--font-weight-semibold`, `--leading-relaxed`, `--radius-400`, `--secondary-hover`, `--secondary-solid`, `--secondary-subtle`, `--secondary-tint-foreground`, `--space-1100`, `--space-900`, `--text-inverted`
|
|
14
|
+
- **Manifest version:** `1.1.1`
|
|
15
|
+
|
|
16
|
+
## Overview
|
|
17
|
+
|
|
18
|
+
FirmAvatar is the **firm identity chip**: the initials of the firm name on a tinted square, where
|
|
19
|
+
Solid marks the active firm. It is the visual identity of a firm wherever firms are listed or
|
|
20
|
+
switched — the leading element of an Action Row in the account menu (`size="sm"`) and the account
|
|
21
|
+
card at the top of the account menu (`size="md"`).
|
|
22
|
+
|
|
23
|
+
**Do NOT use it** as a person avatar or as a status carrier. For a row about a non-firm entity
|
|
24
|
+
(a bank account, a unit) use Action Row's leading slot with an entity glyph instead. Tariff state is
|
|
25
|
+
never shown on the avatar — that is the Badge on the row or the Alert in the account card.
|
|
26
|
+
|
|
27
|
+
<Canvas of={FirmAvatarStories.Playground} />
|
|
28
|
+
|
|
29
|
+
## Rationale
|
|
30
|
+
|
|
31
|
+
Two hosts render the same firm identity, and both need the same initials rule and the same
|
|
32
|
+
selection colours, so the chip is one atom rather than a detail of each host. The one constraint
|
|
33
|
+
that shapes it: the fill carries selection and nothing else.
|
|
34
|
+
|
|
35
|
+
Two implementation decisions are worth knowing:
|
|
36
|
+
|
|
37
|
+
- **The md Solid gradient is a layered `background-image`.** The `md` + Solid compound variant adds
|
|
38
|
+
`bg-[image:linear-gradient(135deg,var(--secondary-solid),var(--secondary-hover))]` on top of the
|
|
39
|
+
family's flat `bg-secondary-solid`. The Tailwind 4 shorthand `bg-linear-135` was not used, because
|
|
40
|
+
tailwind-merge 2.5 (the version in use when this was decided) classified it as a background colour and dropped it against `bg-secondary-solid`.
|
|
41
|
+
Layering keeps the manifest's flat Solid base true at both sizes. The static verifier has no
|
|
42
|
+
gradient aspect, so the gradient itself is asserted by the unit test
|
|
43
|
+
(`FirmAvatar.test.tsx`).
|
|
44
|
+
- **Initials are computed, never passed.** There is no initials prop — the component derives them
|
|
45
|
+
from `name` (and `email` as the fallback) through the exported `firmInitials` helper.
|
|
46
|
+
|
|
47
|
+
## Anatomy
|
|
48
|
+
|
|
49
|
+
- **Root** (`data-fods-part="root"`) — a `<span>` square, `inline-grid` with `place-items-center`,
|
|
50
|
+
box `--space-900` (sm, 32 px) or `--space-1100` (md, 48 px), radius `--radius-400`. Fill per
|
|
51
|
+
family: `--secondary-subtle` (Subtle), flat `--secondary-solid` (sm Solid), or the 135deg
|
|
52
|
+
`--secondary-solid` → `--secondary-hover` gradient over the flat `--secondary-solid` base
|
|
53
|
+
(md Solid).
|
|
54
|
+
- **Initials** (`data-fods-part="initials"`) — the `initials` text run: Heading/H5 —
|
|
55
|
+
`--font-heading` (Poppins), `--font-size-heading-h5`, `--font-weight-semibold`, single line
|
|
56
|
+
(`whitespace-nowrap`), the same style at both sizes. Ink per family:
|
|
57
|
+
`--secondary-tint-foreground` (Subtle) or `--text-inverted` (Solid).
|
|
58
|
+
|
|
59
|
+
## Variants
|
|
60
|
+
|
|
61
|
+
<Canvas of={FirmAvatarStories.Matrix} />
|
|
62
|
+
|
|
63
|
+
Three variants, a **sparse** set: sm × (Subtle · Solid), plus md Solid. **md Subtle does not
|
|
64
|
+
exist** — an md avatar always shows the active firm, so `size="md"` renders Solid whatever
|
|
65
|
+
`selected` says. The fill is a recolour axis driven by the host's selection (`selected`), not an
|
|
66
|
+
interaction state.
|
|
67
|
+
|
|
68
|
+
<table>
|
|
69
|
+
<thead>
|
|
70
|
+
<tr><th>Variant</th><th>Props</th><th>When</th><th>Tokens</th></tr>
|
|
71
|
+
</thead>
|
|
72
|
+
<tbody>
|
|
73
|
+
<tr>
|
|
74
|
+
<td>sm Subtle</td>
|
|
75
|
+
<td><code>size="sm"</code> (default), <code>selected</code> false (default)</td>
|
|
76
|
+
<td>Any firm that is not the active one, on an Action Row</td>
|
|
77
|
+
<td>fill <code>--secondary-subtle</code>, initials <code>--secondary-tint-foreground</code></td>
|
|
78
|
+
</tr>
|
|
79
|
+
<tr>
|
|
80
|
+
<td>sm Solid</td>
|
|
81
|
+
<td><code>size="sm"</code>, <code>selected</code></td>
|
|
82
|
+
<td>The active firm, on the Selected Action Row</td>
|
|
83
|
+
<td>fill <code>--secondary-solid</code> (flat), initials <code>--text-inverted</code></td>
|
|
84
|
+
</tr>
|
|
85
|
+
<tr>
|
|
86
|
+
<td>md Solid</td>
|
|
87
|
+
<td><code>size="md"</code> (<code>selected</code> ignored)</td>
|
|
88
|
+
<td>The active firm, in the account card</td>
|
|
89
|
+
<td>fill gradient 135deg <code>--secondary-solid</code> → <code>--secondary-hover</code> over flat <code>--secondary-solid</code>, initials <code>--text-inverted</code></td>
|
|
90
|
+
</tr>
|
|
91
|
+
</tbody>
|
|
92
|
+
</table>
|
|
93
|
+
|
|
94
|
+
sm Solid is flat and md Solid is a gradient **on purpose** (manifest `notes[1]`); do not unify them.
|
|
95
|
+
|
|
96
|
+
## Sizes
|
|
97
|
+
|
|
98
|
+
The Matrix above shows both sizes. The host fixes the size — never choose it for emphasis.
|
|
99
|
+
|
|
100
|
+
<table>
|
|
101
|
+
<thead>
|
|
102
|
+
<tr><th>Size</th><th style={{ textAlign: 'right' }}>Box</th><th>Box token</th><th>Radius</th><th>Initials</th><th>Host</th><th>Fills</th></tr>
|
|
103
|
+
</thead>
|
|
104
|
+
<tbody>
|
|
105
|
+
<tr>
|
|
106
|
+
<td><code>sm</code> (S)</td>
|
|
107
|
+
<td style={{ textAlign: 'right' }}>32</td>
|
|
108
|
+
<td><code>--space-900</code></td>
|
|
109
|
+
<td><code>--radius-400</code></td>
|
|
110
|
+
<td>Heading/H5</td>
|
|
111
|
+
<td>Action Row leading element</td>
|
|
112
|
+
<td>Subtle or Solid</td>
|
|
113
|
+
</tr>
|
|
114
|
+
<tr>
|
|
115
|
+
<td><code>md</code> (M)</td>
|
|
116
|
+
<td style={{ textAlign: 'right' }}>48</td>
|
|
117
|
+
<td><code>--space-1100</code></td>
|
|
118
|
+
<td><code>--radius-400</code></td>
|
|
119
|
+
<td>Heading/H5</td>
|
|
120
|
+
<td>Account card</td>
|
|
121
|
+
<td>Solid only</td>
|
|
122
|
+
</tr>
|
|
123
|
+
</tbody>
|
|
124
|
+
</table>
|
|
125
|
+
|
|
126
|
+
The upstream spec lists the initials' line height as *Not specified*. The component uses
|
|
127
|
+
`text-heading-h5`, which carries Heading/H5's own leading (`--leading-relaxed`) — the same way the
|
|
128
|
+
Drawer title takes it.
|
|
129
|
+
|
|
130
|
+
## States
|
|
131
|
+
|
|
132
|
+
None. The avatar is static and non-interactive: no hover, focus or pressed state of its own — the
|
|
133
|
+
host row owns those. There is no States story because there is nothing to show beyond the
|
|
134
|
+
Matrix.
|
|
135
|
+
|
|
136
|
+
The fill encodes selection:
|
|
137
|
+
|
|
138
|
+
- **Solid** — the active firm (`selected`, or any `size="md"`).
|
|
139
|
+
- **Subtle** — every other firm (sm only).
|
|
140
|
+
|
|
141
|
+
Solid appears on one firm at a time. The host passes the active flag; nothing on the avatar itself
|
|
142
|
+
drives the fill.
|
|
143
|
+
|
|
144
|
+
**Motion: none.** Manifest 1.1.1 `motion.none`: „no motion of its own; the Solid / Subtle fill flip is driven by the
|
|
145
|
+
host row's state toggle". The avatar declares no transition — the fill flips at once, in step with the host (in
|
|
146
|
+
[ActionRow](?path=/docs/design-system-atoms-actionrow--docs) the row's Selected fill eases over `--duration-toggle`
|
|
147
|
+
while the avatar swaps).
|
|
148
|
+
|
|
149
|
+
### Initials
|
|
150
|
+
|
|
151
|
+
<Canvas of={FirmAvatarStories.Initials} />
|
|
152
|
+
|
|
153
|
+
`firmInitials(name, email)` implements the spec's initials rule; the story renders every row of
|
|
154
|
+
the spec's example table, and the unit test asserts each one.
|
|
155
|
+
|
|
156
|
+
1. Take the **displayed** name — the caller resolves the label chain (firm name → supplier name) and
|
|
157
|
+
passes the result as `name`. The name is NFC-normalised. Characters that are neither letters nor
|
|
158
|
+
digits are trimmed from **both ends of every word**, and a word left empty is dropped
|
|
159
|
+
(`Novák & Syn` → `NS`, manifest 1.0.2).
|
|
160
|
+
2. Skip legal forms — `spol. s r.o.`, `s r.o.`, `s.r.o.`, `spol.`, `a.s.`, `k.s.`, `v.o.s.`,
|
|
161
|
+
`z.s.`, `o.p.s.`, `s.p.` (whole words, case-insensitive, longest first) — and one-letter words.
|
|
162
|
+
A single digit is kept: it counts like a letter.
|
|
163
|
+
3. Two or more words remain → the first character of each of the first two words; one word → its
|
|
164
|
+
first two characters.
|
|
165
|
+
4. Uppercase with the Czech locale; diacritics are kept (`Truhlářství Černý` → `TČ`).
|
|
166
|
+
5. Nothing left → the e-mail's local part split at `.` `_` `-` (`jan.novak` → `JN`, `info` → `IN`).
|
|
167
|
+
|
|
168
|
+
The code differs from the spec's **illustrative snippet** in two places: it takes characters by
|
|
169
|
+
**code point** (`Array.from`), not by UTF-16 unit, and with no name and no e-mail it returns an
|
|
170
|
+
**empty string** (the avatar then renders an empty square). The per-word trim and the legal-form
|
|
171
|
+
skip match the snippet since manifest 1.0.4.
|
|
172
|
+
|
|
173
|
+
## API
|
|
174
|
+
|
|
175
|
+
<Controls />
|
|
176
|
+
|
|
177
|
+
`firmInitials` and `firmAvatarVariants` are exported alongside the component. The root accepts
|
|
178
|
+
the standard `<span>` HTML attributes except `children`, plus `className` and a forwarded `ref`.
|
|
179
|
+
|
|
180
|
+
## Do / Don't
|
|
181
|
+
|
|
182
|
+
- ✅ Pass the displayed firm `name` and the account `email`; let the component compute the initials
|
|
183
|
+
- ✅ Drive `selected` from the host's active-firm flag — exactly one Solid avatar per menu
|
|
184
|
+
- ✅ Keep `md` for the account card and `sm` for Action Row
|
|
185
|
+
- ✅ Show tariff state with the Badge on the row, or the Alert in the account card
|
|
186
|
+
- ❌ Type initials as free text per screen (there is no prop for it)
|
|
187
|
+
- ❌ Pick Solid or Subtle for emphasis or decoration, or render two firms Solid at once
|
|
188
|
+
- ❌ Try to build an md Subtle — `size="md"` always renders Solid
|
|
189
|
+
- ❌ Use FirmAvatar for a person or a non-firm entity, or recolour it to show tariff state
|
|
190
|
+
|
|
191
|
+
## Accessibility
|
|
192
|
+
|
|
193
|
+
- **Keyboard** — none. The root has no `role` and no `tabindex`; it is never a tab stop. Focus and
|
|
194
|
+
the focus ring belong to the host row.
|
|
195
|
+
- **ARIA** — the root always carries `aria-hidden="true"`. It is set **after** the spread props, so
|
|
196
|
+
a consumer cannot override it: both hosts always render the firm name beside the avatar, and the
|
|
197
|
+
initials would only repeat it.
|
|
198
|
+
- **Screen reader** — hears nothing from the avatar; the adjacent firm name carries the accessible
|
|
199
|
+
text. Selection is announced by the host, not by the fill.
|
|
200
|
+
- **Contrast & motion** — Subtle initials (`--secondary-tint-foreground` on `--secondary-subtle`)
|
|
201
|
+
clear AAA. Solid initials (`--text-inverted` on flat `--secondary-solid`, and on the
|
|
202
|
+
`--secondary-solid` end of the md gradient) are 4.45:1, 0.05 below AA-Normal — covered by the
|
|
203
|
+
accepted upstream `--secondary-solid` white-label exception because the initials are decorative
|
|
204
|
+
and the firm name carries the same information (manifest `notes[3]`). No motion (manifest `motion.none`).
|
|
205
|
+
|
|
206
|
+
Accessibility floor for every FODS component: `spec/01-foundations/accessibility.md`.
|
|
207
|
+
|
|
208
|
+
## Copy
|
|
209
|
+
|
|
210
|
+
Voice: nobody writes the avatar's text; the code derives it, and consistency means one thing:
|
|
211
|
+
the same firm shows the same initials on every surface.
|
|
212
|
+
|
|
213
|
+
- **Initials** (`initials`): computed by `firmInitials` from `name`, with `email` as the
|
|
214
|
+
fallback; there is no prop for the text itself. Uppercase, diacritics kept. One line, at most
|
|
215
|
+
two characters, always exactly two (one only when the source string has a single letter). No
|
|
216
|
+
truncation and no ellipsis: the rule, not the string length, keeps it inside the square.
|
|
217
|
+
|
|
218
|
+
Canonical results of the initials rule:
|
|
219
|
+
|
|
220
|
+
<table>
|
|
221
|
+
<thead>
|
|
222
|
+
<tr><th>Source</th><th>Initials</th><th>Why</th></tr>
|
|
223
|
+
</thead>
|
|
224
|
+
<tbody>
|
|
225
|
+
<tr><td>Beta s.r.o.</td><td><code>BE</code></td><td>s.r.o. skipped; one word left → its first two letters</td></tr>
|
|
226
|
+
<tr><td>Café Karlín</td><td><code>CK</code></td><td>first letters of the first two words</td></tr>
|
|
227
|
+
<tr><td>Novák & Syn</td><td><code>NS</code></td><td><code>&</code> trims to nothing and is dropped</td></tr>
|
|
228
|
+
<tr><td>Zelená zahrada s.r.o.</td><td><code>ZZ</code></td><td>s.r.o. skipped; first two words</td></tr>
|
|
229
|
+
<tr><td>Studio Ateliér 7</td><td><code>SA</code></td><td>first letters of the first two words</td></tr>
|
|
230
|
+
<tr><td>Zemědělské družstvo Vysočina Horní Cerekev a.s.</td><td><code>ZD</code></td><td>first two words only; the rest is dropped</td></tr>
|
|
231
|
+
<tr><td>7 Hills s.r.o.</td><td><code>7H</code></td><td>a digit counts like a letter</td></tr>
|
|
232
|
+
<tr><td>Novák spol. s r.o.</td><td><code>NO</code></td><td>multi-word legal form skipped; one word left</td></tr>
|
|
233
|
+
<tr><td>Truhlářství Černý</td><td><code>TČ</code></td><td>diacritics kept</td></tr>
|
|
234
|
+
<tr><td>no firm name, supplier „Jan Novák“</td><td><code>JN</code></td><td>supplier name from the label chain</td></tr>
|
|
235
|
+
<tr><td>no name, e-mail <code>jan.novak@…</code></td><td><code>JN</code></td><td>e-mail local part split at <code>.</code></td></tr>
|
|
236
|
+
<tr><td>no name, e-mail <code>info@…</code></td><td><code>IN</code></td><td>single part → first two letters</td></tr>
|
|
237
|
+
</tbody>
|
|
238
|
+
</table>
|
|
239
|
+
|
|
240
|
+
Wrong results to watch for: `BS` for Beta s.r.o. (the legal form counted as a word), `ZDV`
|
|
241
|
+
(more than two characters), `B` for a one-word name (it gives two letters), `ck` (not
|
|
242
|
+
uppercased), an empty square when there is no firm name (the e-mail fallback skipped).
|
|
243
|
+
|
|
244
|
+
## Usage
|
|
245
|
+
|
|
246
|
+
```tsx
|
|
247
|
+
import { FirmAvatar } from '@invoiceonline/ui-react';
|
|
248
|
+
|
|
249
|
+
// Action Row leading element — Solid only for the active firm
|
|
250
|
+
<FirmAvatar name="Acme s.r.o." email="firma@priklad.cz" selected={isActiveFirm} />
|
|
251
|
+
|
|
252
|
+
// Account card — always the active firm, always Solid
|
|
253
|
+
<FirmAvatar name="Acme s.r.o." email="firma@priklad.cz" size="md" />
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
Don't:
|
|
257
|
+
|
|
258
|
+
```tsx
|
|
259
|
+
// Initials are derived, not passed; md cannot be Subtle; selection is not decoration
|
|
260
|
+
<FirmAvatar name="AC" />
|
|
261
|
+
<FirmAvatar name="Acme s.r.o." size="md" selected={false} />
|
|
262
|
+
<FirmAvatar name="Acme s.r.o." selected />
|
|
263
|
+
<FirmAvatar name="Beta s.r.o." selected />
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
## Related
|
|
267
|
+
|
|
268
|
+
- **Host:** ActionRow — the `sm` avatar is the row's leading element and `selected` follows the
|
|
269
|
+
row's Selected state ([ActionRow docs](?path=/docs/design-system-atoms-actionrow--docs)).
|
|
270
|
+
The account card (product composition) hosts the `md` avatar.
|
|
271
|
+
- **Tariff state, never on the avatar:** Badge (on the row) · Alert (in the account card).
|
|
272
|
+
- **Spec:** `spec/03-atoms/firm-avatar.md`
|
|
273
|
+
|
|
274
|
+
## Migration notes
|
|
275
|
+
|
|
276
|
+
**Motion (manifest 1.1.1, 2026-11-03) — documentation only.** The motion audit declares the avatar static
|
|
277
|
+
(`motion.none`); the fill flip belongs to the host's toggle. No code change.
|
|
278
|
+
|
|
279
|
+
Not applicable — the manifest records no predecessor component, legacy class names or replaced
|
|
280
|
+
values ("No migration mapping is specified for Firm Avatar 1.0.0" — upstream spec).
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
3
|
+
import { FirmAvatar, firmInitials, type FirmAvatarSize } from './FirmAvatar';
|
|
4
|
+
import { Section, Showcase } from '../../storybook/Section';
|
|
5
|
+
import { FodsFamily } from '../../storybook/FodsFamily';
|
|
6
|
+
import { componentDoc } from '../../storybook/componentDoc';
|
|
7
|
+
|
|
8
|
+
const STYLES = ['subtle', 'solid'] as const;
|
|
9
|
+
const SIZES = ['sm', 'md'] as const satisfies readonly FirmAvatarSize[];
|
|
10
|
+
|
|
11
|
+
/** The spec § Copy example table, verbatim. */
|
|
12
|
+
const INITIALS_EXAMPLES = [
|
|
13
|
+
{ name: 'Beta s.r.o.', why: 's.r.o. skipped; one word left → its first two letters' },
|
|
14
|
+
{ name: 'Café Karlín', why: 'first letters of the first two words' },
|
|
15
|
+
{ name: 'Novák & Syn', why: '& trims to nothing and is dropped' },
|
|
16
|
+
{ name: 'Zelená zahrada s.r.o.', why: 's.r.o. skipped; first two words' },
|
|
17
|
+
{ name: 'Studio Ateliér 7', why: 'first letters of the first two words' },
|
|
18
|
+
{
|
|
19
|
+
name: 'Zemědělské družstvo Vysočina Horní Cerekev a.s.',
|
|
20
|
+
why: 'first two words only; the rest is dropped',
|
|
21
|
+
},
|
|
22
|
+
{ name: '7 Hills s.r.o.', why: 'a digit counts like a letter' },
|
|
23
|
+
{ name: 'Novák spol. s r.o.', why: 'multi-word legal form skipped; one word left' },
|
|
24
|
+
{ name: 'Truhlářství Černý', why: 'diacritics kept' },
|
|
25
|
+
{ name: 'Jan Novák', source: 'no firm name, supplier „Jan Novák“', why: 'supplier name from the label chain' },
|
|
26
|
+
{ email: 'jan.novak@example.cz', source: 'no name, e-mail jan.novak@…', why: 'e-mail local part split at .' },
|
|
27
|
+
{ email: 'info@example.cz', source: 'no name, e-mail info@…', why: 'single part → first two letters' },
|
|
28
|
+
] as const satisfies readonly { name?: string; email?: string; source?: string; why: string }[];
|
|
29
|
+
|
|
30
|
+
const meta = {
|
|
31
|
+
title: 'Design System/Atoms/FirmAvatar',
|
|
32
|
+
component: FirmAvatar,
|
|
33
|
+
parameters: {
|
|
34
|
+
layout: 'centered',
|
|
35
|
+
docs: {
|
|
36
|
+
description: {
|
|
37
|
+
component: componentDoc({
|
|
38
|
+
summary:
|
|
39
|
+
'Firm identity chip — initials of the firm name on a tinted square; Solid marks the active firm. 3 variants (sparse): sm Subtle, sm Solid (flat), md Solid (135deg gradient). There is no md Subtle.',
|
|
40
|
+
useCases: [
|
|
41
|
+
'`size="sm"` — the leading element of an Action Row in the account menu; `selected` follows the row\'s Selected state',
|
|
42
|
+
'`size="md"` — the account card at the top of the account menu; always the active firm, always Solid',
|
|
43
|
+
],
|
|
44
|
+
bestPractices: [
|
|
45
|
+
'Pass the displayed firm `name` (firm name → supplier name) and the account `email` — the initials are computed by `firmInitials`, never typed as free text',
|
|
46
|
+
'Drive `selected` from the host\'s active-firm flag; exactly one Solid avatar per menu',
|
|
47
|
+
'Decorative: always `aria-hidden` — the firm name beside it carries the accessible text',
|
|
48
|
+
'Never encode tariff state on the avatar — that is the Badge on the row or the Alert in the account card',
|
|
49
|
+
],
|
|
50
|
+
}),
|
|
51
|
+
},
|
|
52
|
+
},
|
|
53
|
+
},
|
|
54
|
+
} satisfies Meta<typeof FirmAvatar>;
|
|
55
|
+
|
|
56
|
+
export default meta;
|
|
57
|
+
type Story = StoryObj<typeof meta>;
|
|
58
|
+
|
|
59
|
+
export const Playground: Story = {
|
|
60
|
+
args: {
|
|
61
|
+
name: 'Beta s.r.o.',
|
|
62
|
+
email: 'jan.novak@example.cz',
|
|
63
|
+
selected: false,
|
|
64
|
+
size: 'sm',
|
|
65
|
+
},
|
|
66
|
+
argTypes: {
|
|
67
|
+
name: { control: 'text' },
|
|
68
|
+
email: { control: 'text' },
|
|
69
|
+
selected: { control: 'boolean' },
|
|
70
|
+
size: { control: 'inline-radio', options: SIZES },
|
|
71
|
+
},
|
|
72
|
+
};
|
|
73
|
+
|
|
74
|
+
export const Matrix: Story = {
|
|
75
|
+
args: { name: 'Beta s.r.o.' },
|
|
76
|
+
parameters: {
|
|
77
|
+
docs: {
|
|
78
|
+
description: {
|
|
79
|
+
story:
|
|
80
|
+
'The sparse Fill × Size set. Subtle = `--secondary-subtle` + `--secondary-tint-foreground`; Solid = `--text-inverted` initials on flat `--secondary-solid` (sm) or the 135deg `--secondary-solid` → `--secondary-hover` gradient (md). md Subtle does not exist — `size="md"` always renders Solid.',
|
|
81
|
+
},
|
|
82
|
+
},
|
|
83
|
+
},
|
|
84
|
+
render: () => (
|
|
85
|
+
<Showcase>
|
|
86
|
+
<Section title="Fill × size" layout="column">
|
|
87
|
+
<div className="grid grid-cols-[100px_repeat(2,minmax(0,max-content))] items-center gap-x-800 gap-y-500">
|
|
88
|
+
<div />
|
|
89
|
+
{SIZES.map(size => (
|
|
90
|
+
<div key={size} className="text-body-xs font-semibold text-text-secondary">
|
|
91
|
+
{size}
|
|
92
|
+
</div>
|
|
93
|
+
))}
|
|
94
|
+
{STYLES.map(style => (
|
|
95
|
+
<FodsFamily key={style} name={style}>
|
|
96
|
+
<div className="text-body-sm text-text-secondary">{style}</div>
|
|
97
|
+
{SIZES.map(size =>
|
|
98
|
+
style === 'subtle' && size === 'md' ? (
|
|
99
|
+
<div key={size} className="text-body-xs text-text-tertiary">
|
|
100
|
+
n/a
|
|
101
|
+
</div>
|
|
102
|
+
) : (
|
|
103
|
+
<div key={size}>
|
|
104
|
+
<FirmAvatar name="Beta s.r.o." size={size} selected={style === 'solid'} />
|
|
105
|
+
</div>
|
|
106
|
+
),
|
|
107
|
+
)}
|
|
108
|
+
</FodsFamily>
|
|
109
|
+
))}
|
|
110
|
+
</div>
|
|
111
|
+
</Section>
|
|
112
|
+
</Showcase>
|
|
113
|
+
),
|
|
114
|
+
};
|
|
115
|
+
|
|
116
|
+
export const Initials: Story = {
|
|
117
|
+
args: { name: 'Beta s.r.o.' },
|
|
118
|
+
parameters: {
|
|
119
|
+
docs: {
|
|
120
|
+
description: {
|
|
121
|
+
story:
|
|
122
|
+
'The initials rule (spec § Copy) applied to every row of the spec\'s example table: legal forms and one-letter words skipped (a digit counts), first characters of the first two words or the first two of a single word, uppercased with diacritics kept; nothing left → the e-mail local part split at `.` `_` `-`.',
|
|
123
|
+
},
|
|
124
|
+
},
|
|
125
|
+
},
|
|
126
|
+
render: () => (
|
|
127
|
+
<Showcase>
|
|
128
|
+
<Section title="Spec example table" layout="column">
|
|
129
|
+
<div className="grid grid-cols-[max-content_max-content_max-content_minmax(0,1fr)] items-center gap-x-600 gap-y-300">
|
|
130
|
+
{INITIALS_EXAMPLES.map((example) => {
|
|
131
|
+
const name = 'name' in example ? example.name : undefined;
|
|
132
|
+
const email = 'email' in example ? example.email : undefined;
|
|
133
|
+
const source = 'source' in example ? example.source : name;
|
|
134
|
+
return (
|
|
135
|
+
<React.Fragment key={source}>
|
|
136
|
+
<FirmAvatar name={name} email={email} />
|
|
137
|
+
<code className="text-body-sm text-text-primary">{firmInitials(name, email)}</code>
|
|
138
|
+
<span className="text-body-sm text-text-primary">{source}</span>
|
|
139
|
+
<span className="text-body-xs text-text-secondary">{example.why}</span>
|
|
140
|
+
</React.Fragment>
|
|
141
|
+
);
|
|
142
|
+
})}
|
|
143
|
+
</div>
|
|
144
|
+
</Section>
|
|
145
|
+
</Showcase>
|
|
146
|
+
),
|
|
147
|
+
};
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { tv } from '../../internal/tailwind-variants';
|
|
4
|
+
import { cn } from '../../internal/utils';
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Firm Avatar — the firm identity chip (upstream spec `03-atoms/firm-avatar.md`,
|
|
8
|
+
* manifest 1.1.1): the initials of the firm name on a tinted square. Solid marks
|
|
9
|
+
* the active firm, Subtle every other one.
|
|
10
|
+
*
|
|
11
|
+
* Hosts fix the size: `sm` (32, `--space-900`) is the Action Row leading element,
|
|
12
|
+
* `md` (48, `--space-1100`) the account card. The variant set is SPARSE — there is
|
|
13
|
+
* no md Subtle, because an md avatar always shows the active firm, so `size="md"`
|
|
14
|
+
* renders Solid whatever `selected` says.
|
|
15
|
+
*
|
|
16
|
+
* Solid differs by size on purpose (manifest `notes[1]`): sm Solid is the flat
|
|
17
|
+
* `--secondary-solid` of `families[Solid]`, md Solid paints the
|
|
18
|
+
* `chrome.solid-fill.M` gradient — 135deg, `--secondary-solid` → `--secondary-hover`.
|
|
19
|
+
* The gradient is a `background-image` layered over the same flat base colour, so
|
|
20
|
+
* the family binding stays true at both sizes.
|
|
21
|
+
*
|
|
22
|
+
* Static and decorative: no role, no tabindex, no interaction state, always
|
|
23
|
+
* `aria-hidden` — the firm name rendered beside it carries the accessible text.
|
|
24
|
+
*/
|
|
25
|
+
const firmAvatarVariants = tv({
|
|
26
|
+
slots: {
|
|
27
|
+
root: 'inline-grid shrink-0 place-items-center rounded-400',
|
|
28
|
+
/**
|
|
29
|
+
* `typography.runs.initials` — Heading/H5: `--font-heading` (Poppins),
|
|
30
|
+
* `--font-size-heading-h5`, `--font-weight-semibold`. The spec leaves the line
|
|
31
|
+
* height unspecified; `text-heading-h5` carries Heading/H5's own leading, the
|
|
32
|
+
* same way Drawer's title and Promo Sticker's label take it.
|
|
33
|
+
*/
|
|
34
|
+
initials: 'whitespace-nowrap font-poppins text-heading-h5 font-semibold',
|
|
35
|
+
},
|
|
36
|
+
variants: {
|
|
37
|
+
fill: {
|
|
38
|
+
subtle: {
|
|
39
|
+
root: 'bg-secondary-subtle',
|
|
40
|
+
initials: 'text-secondary-tint-foreground',
|
|
41
|
+
},
|
|
42
|
+
solid: {
|
|
43
|
+
root: 'bg-secondary-solid',
|
|
44
|
+
initials: 'text-text-inverted',
|
|
45
|
+
},
|
|
46
|
+
},
|
|
47
|
+
size: {
|
|
48
|
+
sm: { root: 'size-900' },
|
|
49
|
+
md: { root: 'size-1100' },
|
|
50
|
+
},
|
|
51
|
+
},
|
|
52
|
+
compoundVariants: [
|
|
53
|
+
{
|
|
54
|
+
fill: 'solid',
|
|
55
|
+
size: 'md',
|
|
56
|
+
class: {
|
|
57
|
+
root: 'bg-[image:linear-gradient(135deg,var(--secondary-solid),var(--secondary-hover))]',
|
|
58
|
+
},
|
|
59
|
+
},
|
|
60
|
+
],
|
|
61
|
+
defaultVariants: {
|
|
62
|
+
fill: 'subtle',
|
|
63
|
+
size: 'sm',
|
|
64
|
+
},
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
export type FirmAvatarSize = 'sm' | 'md';
|
|
68
|
+
|
|
69
|
+
/** Longest first, so `spol. s r.o.` is consumed before `s r.o.` and `spol.`. */
|
|
70
|
+
const LEGAL_FORMS = [
|
|
71
|
+
'spol. s r.o.',
|
|
72
|
+
's r.o.',
|
|
73
|
+
's.r.o.',
|
|
74
|
+
'spol.',
|
|
75
|
+
'a.s.',
|
|
76
|
+
'k.s.',
|
|
77
|
+
'v.o.s.',
|
|
78
|
+
'z.s.',
|
|
79
|
+
'o.p.s.',
|
|
80
|
+
's.p.',
|
|
81
|
+
];
|
|
82
|
+
|
|
83
|
+
// A whole-word match may be wrapped in edge punctuation — `(s.r.o.)`, `„a.s.“`, `a.s.,` —
|
|
84
|
+
// which spec § Copy step 1 trims before the legal-form skip. A comma ends the word even with
|
|
85
|
+
// no space after it (`s.r.o.,IČ`).
|
|
86
|
+
const LEGAL_FORM_PATTERNS = LEGAL_FORMS.map(
|
|
87
|
+
form =>
|
|
88
|
+
new RegExp(
|
|
89
|
+
`(^|\\s)[^\\p{L}\\p{N}\\s]*${form.replace(/\./g, '\\.').replace(/ /g, '\\s+')}(?=[^\\p{L}\\p{N}\\s]*(?:[\\s,]|$))`,
|
|
90
|
+
'giu',
|
|
91
|
+
),
|
|
92
|
+
);
|
|
93
|
+
|
|
94
|
+
const EDGE_NON_ALNUM = /^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu;
|
|
95
|
+
|
|
96
|
+
function initialsFrom(words: string[]): string {
|
|
97
|
+
// Array.from splits by code point, so an astral letter is never cut in half.
|
|
98
|
+
if (words.length >= 2) return Array.from(words[0])[0] + Array.from(words[1])[0];
|
|
99
|
+
return words.length === 1 ? Array.from(words[0]).slice(0, 2).join('') : '';
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
function wordsOfName(name: string): string[] {
|
|
103
|
+
let stripped = ` ${name.normalize('NFC')} `;
|
|
104
|
+
for (const pattern of LEGAL_FORM_PATTERNS) stripped = stripped.replace(pattern, ' ');
|
|
105
|
+
return stripped
|
|
106
|
+
.split(/\s+/)
|
|
107
|
+
.map(word => word.replace(EDGE_NON_ALNUM, ''))
|
|
108
|
+
// One-letter words are skipped; a single digit counts like a letter.
|
|
109
|
+
.filter(word => Array.from(word).length > 1 || /^\p{N}$/u.test(word));
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* The initials rule (spec § Copy): the displayed name with legal forms and
|
|
114
|
+
* one-letter words skipped → the first characters of the first two words, or the
|
|
115
|
+
* first two of a single word; nothing left → the e-mail's local part split at
|
|
116
|
+
* `.` `_` `-`. Uppercased with the Czech locale, diacritics kept.
|
|
117
|
+
*
|
|
118
|
+
* `name` is the DISPLAYED name — the caller resolves the label chain (firm name →
|
|
119
|
+
* supplier name) and passes the result.
|
|
120
|
+
*/
|
|
121
|
+
export function firmInitials(name?: string | null, email?: string | null): string {
|
|
122
|
+
const fromName = name?.trim() ? initialsFrom(wordsOfName(name)) : '';
|
|
123
|
+
if (fromName) return fromName.toLocaleUpperCase('cs');
|
|
124
|
+
|
|
125
|
+
const local = (email ?? '').split('@')[0].normalize('NFC');
|
|
126
|
+
const parts = local
|
|
127
|
+
.split(/[._-]/)
|
|
128
|
+
.map(part => part.replace(EDGE_NON_ALNUM, ''))
|
|
129
|
+
.filter(Boolean);
|
|
130
|
+
return initialsFrom(parts).toLocaleUpperCase('cs');
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
export interface FirmAvatarProps
|
|
134
|
+
extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> {
|
|
135
|
+
/** The displayed firm name (firm name → supplier name); the initials are derived from it. */
|
|
136
|
+
name?: string | null;
|
|
137
|
+
/** The account e-mail — the initials fallback when `name` yields nothing. */
|
|
138
|
+
email?: string | null;
|
|
139
|
+
/**
|
|
140
|
+
* The active firm. Driven by the host's selection, never picked for emphasis —
|
|
141
|
+
* inside Action Row it follows the row's Selected state.
|
|
142
|
+
*/
|
|
143
|
+
selected?: boolean;
|
|
144
|
+
/** `sm` (32, Action Row) or `md` (48, account card — always Solid). */
|
|
145
|
+
size?: FirmAvatarSize;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
const FirmAvatar = React.forwardRef<HTMLSpanElement, FirmAvatarProps>(
|
|
149
|
+
({ className, name, email, selected = false, size = 'sm', ...props }, ref) => {
|
|
150
|
+
// There is no md Subtle: an md avatar is always the active firm.
|
|
151
|
+
const fill = selected || size === 'md' ? 'solid' : 'subtle';
|
|
152
|
+
const slots = firmAvatarVariants({ fill, size });
|
|
153
|
+
|
|
154
|
+
return (
|
|
155
|
+
<span
|
|
156
|
+
ref={ref}
|
|
157
|
+
data-fods-component="firm-avatar"
|
|
158
|
+
data-fods-part="root"
|
|
159
|
+
className={cn(slots.root(), className)}
|
|
160
|
+
{...props}
|
|
161
|
+
aria-hidden="true"
|
|
162
|
+
>
|
|
163
|
+
<span data-fods-part="initials" className={slots.initials()}>
|
|
164
|
+
{firmInitials(name, email)}
|
|
165
|
+
</span>
|
|
166
|
+
</span>
|
|
167
|
+
);
|
|
168
|
+
},
|
|
169
|
+
);
|
|
170
|
+
FirmAvatar.displayName = 'FirmAvatar';
|
|
171
|
+
|
|
172
|
+
export { FirmAvatar, firmAvatarVariants };
|