@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,379 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
|
+
|
|
3
|
+
<Meta title="Getting Started/Consuming" />
|
|
4
|
+
|
|
5
|
+
# Consuming `@invoiceonline/ui-react`
|
|
6
|
+
|
|
7
|
+
The React components of FODS, the FakturaOnline design system. This page is for the app
|
|
8
|
+
that installs the package: what to import, which CSS to load and in what order, which
|
|
9
|
+
providers to mount, and what the package leaves to you. Every component has its own docs
|
|
10
|
+
page in this Storybook and in the package (`src/components/<folder>/<Name>.mdx`).
|
|
11
|
+
|
|
12
|
+
**For AI agents.** An agent working in the app starts at `AGENTS.md` and `llms.txt` in the
|
|
13
|
+
package root (`node_modules/@invoiceonline/ui-react/`): the rules of this page in short and
|
|
14
|
+
every component with its import. Import `AGENTS.md` into the app's own agent instructions so
|
|
15
|
+
every session reads it; [For AI agents](?path=/docs/getting-started-for-ai-agents--docs) has
|
|
16
|
+
the rest.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
npm install @invoiceonline/ui-react
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
- **Peer dependencies:** `react` and `react-dom` `^19.0.0` and `@tanstack/react-table`
|
|
25
|
+
`^9.3.1` (the types of `Table` props come from it, see below). npm 7 and later installs a
|
|
26
|
+
missing peer dependency itself.
|
|
27
|
+
- **The design tokens ship in the package**, from the same commit as the components and
|
|
28
|
+
their theme: `@invoiceonline/ui-react/tokens.css` (the CSS variables, loaded once per app,
|
|
29
|
+
see Styles), `@invoiceonline/ui-react/tokens` (the same tokens as JS: `primitives`,
|
|
30
|
+
`semantic`, `springs`, `curves`) and `@invoiceonline/ui-react/tokens.flat.json`. Do not
|
|
31
|
+
install `@invoiceonline/ui-system` next to it: a `tokens.css` from another version can lack
|
|
32
|
+
a variable the components refer to, and nothing fails when it does.
|
|
33
|
+
- **ESM only.** There is no CommonJS build. A test runner that loads CommonJS (Jest without
|
|
34
|
+
ESM support) has to transform the package.
|
|
35
|
+
- **Fonts are not shipped.** The tokens name the faces, the app loads them: Inter
|
|
36
|
+
(`--font-body`), Poppins (`--font-heading`) and Caveat (`--font-decorative`, used by the
|
|
37
|
+
pointer label of ProgressBar and the `kicker` of HeadingGroup and Hero).
|
|
38
|
+
- **Dependencies** install with the package: Radix (Dialog, Slot, Tooltip), Floating UI,
|
|
39
|
+
Motion, date-fns, react-day-picker, react-number-format, ECharts, `clsx`,
|
|
40
|
+
`tailwind-merge` and `tailwind-variants`. `sideEffects` in `package.json` names only the
|
|
41
|
+
CSS, so a bundler can leave out the code of the components the app does not import
|
|
42
|
+
(ECharts, for one, is used only by StatusSummaryBar).
|
|
43
|
+
- **Table state types.** The props of `Table` use TanStack types that the package does not
|
|
44
|
+
re-export: `SortingState` (`sorting`), `RowSelectionState` (`selection.state`) and
|
|
45
|
+
`ColumnVisibilityState` (`columnVisibility.state`). `@tanstack/react-table` is a peer
|
|
46
|
+
dependency, so the app and the package share one copy: import the types from there.
|
|
47
|
+
Column definitions come from `createTableColumnHelper`, which the package exports.
|
|
48
|
+
|
|
49
|
+
## Imports
|
|
50
|
+
|
|
51
|
+
```tsx
|
|
52
|
+
import { Button, TextField } from '@invoiceonline/ui-react'; // root entry
|
|
53
|
+
import { Button } from '@invoiceonline/ui-react/button'; // one component folder
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Each component folder has its own entry, named after the folder (`button-group`,
|
|
57
|
+
`text-field`, `promo-sticker`…). The tokens have theirs: `@invoiceonline/ui-react/tokens`. The root entry re-exports all of them plus `FodsProvider`,
|
|
58
|
+
`cn`, `hasOpenFloatingPanel`, `PortalContainerContext`, `buttonSegmentVariants` and
|
|
59
|
+
`progressBarItemVariants`. Anything not listed in the `exports` of `package.json` is
|
|
60
|
+
private: never import a `dist/…` or `src/…` path.
|
|
61
|
+
|
|
62
|
+
## Styles
|
|
63
|
+
|
|
64
|
+
The package ships its CSS in two shapes. Pick one; never both.
|
|
65
|
+
|
|
66
|
+
### An app without Tailwind
|
|
67
|
+
|
|
68
|
+
The order of layers goes in a stylesheet of its own, imported first:
|
|
69
|
+
|
|
70
|
+
```css
|
|
71
|
+
/* layers.css: nothing but the order. `properties` is Tailwind's fallback layer
|
|
72
|
+
for its --tw-* variables and has to sit below fods; `reset` is yours. */
|
|
73
|
+
@layer properties, reset, fods;
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
```css
|
|
77
|
+
/* globals.css */
|
|
78
|
+
@import "./layers.css";
|
|
79
|
+
@import "@invoiceonline/ui-react/tokens.css";
|
|
80
|
+
@import "@invoiceonline/ui-react/styles.css";
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Do not write the `@layer` line into the file that holds the two package imports. A bundler
|
|
84
|
+
that inlines imports can emit the imported stylesheets ahead of that line (Next.js 16 with
|
|
85
|
+
Turbopack does). `styles.css` then declares `properties` and `fods` first, `reset` lands
|
|
86
|
+
after `fods`, and a reset of the app in that layer overrides the components. As an import
|
|
87
|
+
of its own the line stays first.
|
|
88
|
+
|
|
89
|
+
`styles.css` holds the scoped reset, the keyframes, the artwork rules (PromoSticker and
|
|
90
|
+
PromoSurface) and every utility class the
|
|
91
|
+
components use.
|
|
92
|
+
|
|
93
|
+
### An app with Tailwind 4
|
|
94
|
+
|
|
95
|
+
The app's Tailwind generates the utility classes from the package's compiled JS. The
|
|
96
|
+
package adds its theme (the token-to-utility map) and the hand-written rules that class
|
|
97
|
+
scanning cannot produce.
|
|
98
|
+
|
|
99
|
+
```css
|
|
100
|
+
/* Before every import: fods has to sit below utilities. */
|
|
101
|
+
@layer theme, base, fods, components, utilities;
|
|
102
|
+
@import "tailwindcss";
|
|
103
|
+
@import "@invoiceonline/ui-react/tokens.css" layer(theme);
|
|
104
|
+
@import "@invoiceonline/ui-react/theme.css";
|
|
105
|
+
@import "@invoiceonline/ui-react/shared.css";
|
|
106
|
+
/* The path from this stylesheet to the package's dist/, not src/. */
|
|
107
|
+
@source "../node_modules/@invoiceonline/ui-react/dist";
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
- Do not import `styles.css` as well: it would add a second copy of the utilities.
|
|
111
|
+
- The first line is required. `@import "tailwindcss"` declares the layers `theme, base,
|
|
112
|
+
components, utilities`; without your own declaration before it, `fods` lands after
|
|
113
|
+
`utilities` and the scoped reset in `fods.base` overrides the component utilities
|
|
114
|
+
(padding, gap, border) that your Tailwind writes into `utilities`.
|
|
115
|
+
- `theme.css` is an `@theme inline reference` block: utilities get the token variable
|
|
116
|
+
itself (`gap: var(--space-200)`) and no theme variable is emitted.
|
|
117
|
+
- **`theme.css` replaces the theme of your Tailwind, it does not add to it.** It starts with
|
|
118
|
+
`--*: initial`, which drops every default of Tailwind for the whole build: after the
|
|
119
|
+
import, `gap-4`, `p-4`, `text-sm` or `bg-red-500` in your own code produce no CSS, only
|
|
120
|
+
the classes of the FODS tokens do (`gap-200`, `text-body-sm`, `bg-primary`). This mode is
|
|
121
|
+
for an app that is styled with the FODS tokens. An app that keeps Tailwind's default scale
|
|
122
|
+
for its own code uses the mode without Tailwind for the package (`styles.css`) instead.
|
|
123
|
+
|
|
124
|
+
### Cascade layers
|
|
125
|
+
|
|
126
|
+
Every rule of `styles.css` sits in `@layer fods.base` (reset, keyframes, artwork rules) or
|
|
127
|
+
`@layer fods.utilities` (utility classes). In the mode with Tailwind, `shared.css` brings
|
|
128
|
+
`fods.base` and your Tailwind writes the utility classes into its own `utilities` layer.
|
|
129
|
+
Two consequences follow from how the cascade treats layers.
|
|
130
|
+
|
|
131
|
+
**Your unlayered CSS beats the package, whatever its specificity.** A global `button { … }`,
|
|
132
|
+
`a { … }`, `h1, h2, h3 { … }` or a reset like `* { padding: 0; margin: 0 }` that is not in a
|
|
133
|
+
layer overrides the component rules. Some concrete breakages:
|
|
134
|
+
|
|
135
|
+
- `* { padding: 0 }` removes the padding of Button, Badge, ListRow and the fields.
|
|
136
|
+
- A global `input { … }` rule breaks Checkbox, Radio and Switch: each of them lays a
|
|
137
|
+
transparent native `<input>` over its visual control with `absolute`, a size utility and
|
|
138
|
+
`opacity-0`, and an unlayered `input` rule that sets position, size or opacity wins over
|
|
139
|
+
those utilities.
|
|
140
|
+
- `a { … }` takes the underline handling and the colour transition of TextLink;
|
|
141
|
+
`h1, h2, h3 { line-height }` changes the line height of Heading.
|
|
142
|
+
|
|
143
|
+
Put such rules in a layer declared before `fods`, as `reset` in the recipe without
|
|
144
|
+
Tailwind. The order is already declared by the stylesheet imported first, so the app's
|
|
145
|
+
stylesheet only fills the layer:
|
|
146
|
+
|
|
147
|
+
```css
|
|
148
|
+
@layer reset {
|
|
149
|
+
* { margin: 0; padding: 0; box-sizing: border-box; }
|
|
150
|
+
}
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
Or keep them off the components with `:not([data-fods-part], [data-fods-part] *)`, the
|
|
154
|
+
selector the package's own reset is scoped by. `:not([data-fods-part])` alone is not enough:
|
|
155
|
+
not every element inside a component carries the attribute (the native `<input>` of
|
|
156
|
+
Checkbox, Radio and Switch does not).
|
|
157
|
+
|
|
158
|
+
**With `!important` the order turns around: an earlier layer wins**, and important
|
|
159
|
+
declarations in any layer win over important unlayered ones. TextLink sets its colours with
|
|
160
|
+
`!important` utilities, so unlayered CSS of the app cannot recolour a TextLink, not even
|
|
161
|
+
with `!important`, and neither can a layer declared after the one the utilities are in;
|
|
162
|
+
use the `variant` and `surface` props instead. Its
|
|
163
|
+
normal (non-important) declarations, such as the transition and `no-underline` on the link,
|
|
164
|
+
still lose to any unlayered `a { … }` rule of the app.
|
|
165
|
+
|
|
166
|
+
### The `data-fods-*` attributes
|
|
167
|
+
|
|
168
|
+
The components mark their root with `data-fods-component` and their named parts with
|
|
169
|
+
`data-fods-part`. Both are public: select by them to keep your own rules off the
|
|
170
|
+
components, as above, or to find a component in a test. Do not style the components
|
|
171
|
+
through them. The look of a part comes from its props; a rule of the app that targets
|
|
172
|
+
`[data-fods-part]` is an override the package cannot see, and `fods-lint --consumer` fails
|
|
173
|
+
on it. Inside `:not(…)`, as in the selector above, the attribute only excludes and is
|
|
174
|
+
allowed.
|
|
175
|
+
|
|
176
|
+
### No preflight: what a component sets and what it inherits
|
|
177
|
+
|
|
178
|
+
The package does not ship Tailwind's preflight, which would restyle the whole page. Instead
|
|
179
|
+
`fods.base` holds a reset scoped to `[data-fods-part]` and its descendants, wrapped in
|
|
180
|
+
`:where()` so its specificity is zero: any utility class and any rule of yours wins. It sets
|
|
181
|
+
`box-sizing`, zero margin and padding, `border: 0 solid`, and takes the native look off
|
|
182
|
+
buttons, inputs, links, headings and lists inside a component.
|
|
183
|
+
|
|
184
|
+
- **Set by the component:** the font family (`--font-body`, and the font smoothing) on every
|
|
185
|
+
component root, and the regular weight (`--font-weight-normal`) on the outermost FODS
|
|
186
|
+
element only, so a component nested in another still inherits the weight of the part it
|
|
187
|
+
sits in. Heading, Display and other parts with their own face set it with a utility, which
|
|
188
|
+
wins.
|
|
189
|
+
- **Set by the text styles:** `letter-spacing` on every part that carries a text style.
|
|
190
|
+
Headings and Display carry it in their utility; Body text tracks per weight (Regular
|
|
191
|
+
+0.35 %, Semibold −0.88 % of the font size), written as zero-specificity rules in
|
|
192
|
+
`shared.css`, so a rule of your own on the element still wins.
|
|
193
|
+
- **Inherited from your page:** line height where a part does not set its own,
|
|
194
|
+
`text-transform` and `font-style`. A page with a large `line-height` on `body` makes the
|
|
195
|
+
components that do not set their own taller.
|
|
196
|
+
- **TextLink is left out of both rules on purpose:** a link inside a sentence keeps the
|
|
197
|
+
weight and the font smoothing of that sentence.
|
|
198
|
+
|
|
199
|
+
## Moving a hand-made button to Button
|
|
200
|
+
|
|
201
|
+
The variant names do not follow the token names. `variant="primary"` of Button and
|
|
202
|
+
IconButton is the blue in-app default, drawn with `--secondary-solid`. The orange fill,
|
|
203
|
+
drawn with `--primary-solid`, is `variant="brand"`. A hand-made orange button therefore maps
|
|
204
|
+
to `brand`, not to `primary`; when each of the two belongs is on the Button docs page.
|
|
205
|
+
|
|
206
|
+
Expect the swap to be visible. Padding, corner radius, border and height of Button come
|
|
207
|
+
from the design tokens and usually differ from a hand-made button: a button can get
|
|
208
|
+
narrower, its corners smaller, a 1 px border can appear. That is the design system's look,
|
|
209
|
+
not a regression; do not restore the old look with CSS. If a size does not fit a layout,
|
|
210
|
+
pick another `size`.
|
|
211
|
+
|
|
212
|
+
## Providers
|
|
213
|
+
|
|
214
|
+
Mount `FodsProvider` once per React root, around everything that renders a FODS component.
|
|
215
|
+
It is the first and normally the only provider step:
|
|
216
|
+
|
|
217
|
+
```tsx
|
|
218
|
+
import { FodsProvider } from '@invoiceonline/ui-react';
|
|
219
|
+
|
|
220
|
+
export default function RootLayout({ children }: { children: React.ReactNode }) {
|
|
221
|
+
return (
|
|
222
|
+
<html lang="cs">
|
|
223
|
+
<body>
|
|
224
|
+
<FodsProvider>{children}</FodsProvider>
|
|
225
|
+
</body>
|
|
226
|
+
</html>
|
|
227
|
+
);
|
|
228
|
+
}
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
Without it:
|
|
232
|
+
|
|
233
|
+
- **These throw** (`` `Tooltip` must be used within `TooltipProvider` ``), because they
|
|
234
|
+
render a Tooltip: `Tooltip` (except its `toggletip` mode) and `TooltipRoot`, `Chip` with `info`, `Switch`
|
|
235
|
+
with `infoIcon`, every `ColumnHeader`, `StatusSummaryBar`, an `ActionRow` whose `badge`
|
|
236
|
+
has a `tooltip` (desktop), a `FilterChip` whose `value` collapses to `+N`, and a
|
|
237
|
+
`FilterFacet` with `multiple` once two or more values are applied (through that
|
|
238
|
+
FilterChip). `Table` mounts its own
|
|
239
|
+
`TooltipProvider` and works without it.
|
|
240
|
+
- **These carets turn even under reduced motion:** the open / closed caret of
|
|
241
|
+
`SplitButton`, `ButtonGroupItem` with `caret`, `DropdownButton`, `SelectField` (and
|
|
242
|
+
`Select`), `ComboboxField` (and `Combobox`), `FilterChip` (and `FilterFacet`), `FAQ`,
|
|
243
|
+
`FormBlock`, `StatusSummaryBar` and the mobile layout of `Table`. The caret does not read
|
|
244
|
+
the setting itself.
|
|
245
|
+
|
|
246
|
+
The provider does nothing else. The other animations follow the user's
|
|
247
|
+
reduced-motion setting on their own: the Motion-driven ones (Modal, Drawer, Alert, Tooltip,
|
|
248
|
+
Switch, CardSelect, FAQ and FormBlock content, the mobile bottom sheets…) read it through
|
|
249
|
+
Motion's `useReducedMotion` or a `prefers-reduced-motion` query, and the CSS ones through
|
|
250
|
+
`prefers-reduced-motion`. Under it each one stops, is reduced or keeps running as the
|
|
251
|
+
`motion` block of its manifest says (the floating label of `Field` stops, Skeleton and
|
|
252
|
+
ProgressBar switch to a reduced form, the spinner of a loading Button keeps turning).
|
|
253
|
+
|
|
254
|
+
What it contains, and when to mount those providers yourself:
|
|
255
|
+
|
|
256
|
+
- **`TooltipProvider`.** `Tooltip` is built on Radix Tooltip, whose root needs the
|
|
257
|
+
provider above it; the `toggletip` mode does not read it. The package's
|
|
258
|
+
`TooltipProvider` sets the shared open delay. It stays exported: mount it yourself, below
|
|
259
|
+
`FodsProvider`, only to pass another `delayDuration` to part of the app; the nearest
|
|
260
|
+
provider wins.
|
|
261
|
+
- **`MotionConfig reducedMotion="user"`** (from `motion`, a dependency of the package)
|
|
262
|
+
drops transform animation under reduced motion, which is what stops the carets above.
|
|
263
|
+
`FodsProvider` imports `motion/react` from the package's own dependency, so the app needs
|
|
264
|
+
no `motion` dependency for it. Mount a `MotionConfig` of your own only for other Motion
|
|
265
|
+
settings; it reaches the components only when the app resolves the same copy of `motion`
|
|
266
|
+
as the package, because Motion's context belongs to the copy that creates it.
|
|
267
|
+
|
|
268
|
+
## Portals
|
|
269
|
+
|
|
270
|
+
Several components render outside their place in the DOM:
|
|
271
|
+
|
|
272
|
+
- `Modal`, `Drawer` and the mobile bottom sheet of `Menu`, `Select`, `Combobox`,
|
|
273
|
+
`FilterFacet` and `SubjectLookupField` are Radix dialogs portalled to `document.body`.
|
|
274
|
+
- The bubble of `Tooltip` is portalled to `document.body`.
|
|
275
|
+
- The floating panels (`AnchoredPanel`, and the desktop panels of `Menu`, `Select`,
|
|
276
|
+
`Combobox`, `FilterFacet`, `SubjectLookupField`, `DateField`, `FieldPair` and the column
|
|
277
|
+
settings of `Table`) and the `toggletip` bubble portal into the enclosing `Modal` or
|
|
278
|
+
`Drawer` when their trigger sits inside one, and to `document.body` otherwise. Inside a
|
|
279
|
+
dialog they have to, to stay inside its focus trap.
|
|
280
|
+
|
|
281
|
+
To portal into another element than `document.body` (an island whose styles are scoped to
|
|
282
|
+
a class, an element inside a shadow root), provide that element through `PortalContainerContext`. Every
|
|
283
|
+
portal above reads it; the panels inside a `Modal` or `Drawer` still go into the dialog.
|
|
284
|
+
|
|
285
|
+
```tsx
|
|
286
|
+
import { PortalContainerContext } from '@invoiceonline/ui-react';
|
|
287
|
+
|
|
288
|
+
<PortalContainerContext.Provider value={islandElement}>{children}</PortalContainerContext.Provider>
|
|
289
|
+
```
|
|
290
|
+
|
|
291
|
+
## Assets
|
|
292
|
+
|
|
293
|
+
The components ship no illustrations. A component that shows one takes it from the app as a
|
|
294
|
+
React element (`<img src={…} alt="" />` of the app's own file, or an inline SVG) and keeps
|
|
295
|
+
only the box: its size, position and clipping. The box is hidden from screen readers, so an
|
|
296
|
+
`<img>` takes `alt=""`; the component's own text carries the message.
|
|
297
|
+
|
|
298
|
+
| Component | Prop | Picture |
|
|
299
|
+
|---|---|---|
|
|
300
|
+
| FormSection (`header="h3"`), FormBlock | `illustration` | an `Illustration / Section` picture |
|
|
301
|
+
| Banner (`person`, `invoice`) | `character` (person only), `invoiceIllustration` `{ left, right }` | the character and the two invoice sheets |
|
|
302
|
+
| Table | `emptyState.illustration` | an `Illustration / Big` picture for the empty-state kind |
|
|
303
|
+
|
|
304
|
+
Which picture goes where is in the component's docs page and in the spec of the
|
|
305
|
+
illustrations.
|
|
306
|
+
|
|
307
|
+
Two components draw a picture from the stylesheet as part of their look: the component
|
|
308
|
+
carries a class and the `url()` sits in `styles.css` and `shared.css`, pointing at
|
|
309
|
+
`./assets/…`, which the package publishes in `dist/assets/`.
|
|
310
|
+
|
|
311
|
+
- PromoSurface: the pattern tile (`pattern-dark.svg`).
|
|
312
|
+
- PromoSticker: the brush (`label-brush-1.svg`).
|
|
313
|
+
|
|
314
|
+
How to load them:
|
|
315
|
+
|
|
316
|
+
- Import the stylesheet through a bundler that resolves `url()` in imported CSS. Vite does
|
|
317
|
+
it with and without `@tailwindcss/vite`, and so does Next.js 16 in both style modes (with
|
|
318
|
+
`@tailwindcss/postcss` in the mode with Tailwind): the files are copied into the build
|
|
319
|
+
output and the `url()` is rewritten.
|
|
320
|
+
- The Tailwind CLI does not: it leaves `url('./assets/…')` relative to its output file, so
|
|
321
|
+
the files 404 unless `dist/assets/` is copied next to that output. The same happens when
|
|
322
|
+
`styles.css` alone is copied into a public folder.
|
|
323
|
+
- Served from another origin (a CDN or an asset host), the brush needs an
|
|
324
|
+
`Access-Control-Allow-Origin` header: it is a CSS mask, which the browser loads in CORS
|
|
325
|
+
mode, so without the header the brush disappears and the sticker's white text sits on a
|
|
326
|
+
white page. The pattern tile is a background image and is not affected.
|
|
327
|
+
|
|
328
|
+
## Server components (Next.js App Router)
|
|
329
|
+
|
|
330
|
+
Every component file starts with `"use client"`, and the directive is kept per file in
|
|
331
|
+
`dist/`, so a server component can import and render the components directly; each one
|
|
332
|
+
becomes a client component at that point. What a server component passes to them has to be
|
|
333
|
+
serialisable, so event handlers (`onClick`, `onCheckedChange`…), render functions and the
|
|
334
|
+
`columns` of `Table` (they hold `cell` renderers) live in a client component of your own.
|
|
335
|
+
`FodsProvider` starts with `"use client"` as well, so a server layout renders it directly,
|
|
336
|
+
as in the example. Values that a component file exports next to its component
|
|
337
|
+
(`buttonVariants`, `textLinkVariants`…) are client references in a server component and
|
|
338
|
+
cannot be called or read there.
|
|
339
|
+
|
|
340
|
+
## Texts and locale
|
|
341
|
+
|
|
342
|
+
The package has no translations: user-facing texts come in through props. The props below
|
|
343
|
+
are optional and default to Czech. **An app with more than one language version passes every one of them from its translations, on
|
|
344
|
+
every use**; otherwise a page in another language shows or announces Czech.
|
|
345
|
+
|
|
346
|
+
| Component | Prop | Czech default | When it renders |
|
|
347
|
+
|---|---|---|---|
|
|
348
|
+
| `Modal` | `closeLabel` | «Zavřít» | name of the close control, whenever it is shown |
|
|
349
|
+
| `Menu`, `Select`, `Combobox`, `FilterFacet`, `SubjectLookupField` | `sheetCloseLabel` | «Zavřít» | visually hidden close button of the mobile bottom sheet, first focus stop |
|
|
350
|
+
| `FilterFacet` (`multiple`) | `doneLabel` | «Hotovo» | the closing button in the footer of the mobile bottom sheet |
|
|
351
|
+
| `Pagination` | every key of `labels` | «Stránkování», «Předchozí», «Další», «Stránka», «Další stránky» | always |
|
|
352
|
+
| `Table` | `loadedLabel` | «Načteno» | announced to screen readers when a `loading` ends |
|
|
353
|
+
| `Table` | `mobile.moreLabel` | «Více» | the more-actions dropdown of the mobile layout |
|
|
354
|
+
| `FileUpload` | `triggerLabel`, `dropHintText` | «Nahrajte svůj soubor», « nebo jej sem přetáhněte» | the prompt sentence of the empty drop-zone |
|
|
355
|
+
| `FileUpload` | `viewLabel`, `removeLabel` | «Zobrazit», «Odebrat» | name prefix of the row actions, composed with the filename |
|
|
356
|
+
| `FileUpload` | `uploadingLabel` | «Nahrávání souboru» | name of the progress bar, announced when an upload starts |
|
|
357
|
+
|
|
358
|
+
Some of them never show in a visual check: `loadedLabel`, Modal `closeLabel`, the
|
|
359
|
+
`nav`, `page` and `morePages` keys of Pagination `labels`, and FileUpload `viewLabel`,
|
|
360
|
+
`removeLabel` and `uploadingLabel` are only announced, and
|
|
361
|
+
`sheetCloseLabel` shows only while it has keyboard focus. Check them in code review.
|
|
362
|
+
|
|
363
|
+
Number and date formatting default to Czech as well: `locale` is `'cs'` on `NumberField`,
|
|
364
|
+
`UnitField`, `FieldPair`, `ItemRow` and `FilterChip`, and the `cs` locale of date-fns on
|
|
365
|
+
`DatePicker`, `DateField` and a `FieldPair` in date mode (there the prop is `dateLocale`):
|
|
366
|
+
weekday names, month caption, week start.
|
|
367
|
+
|
|
368
|
+
## Known gaps
|
|
369
|
+
|
|
370
|
+
- **SplitButton and Menu.** `Menu` takes its `trigger` (a `ButtonGroupItem` with `caret`
|
|
371
|
+
or an icon-only one, a `DropdownButton` or an `IconButton`) and wires the open state, the keyboard,
|
|
372
|
+
`aria-controls` and the return of focus by cloning it with a `ref`. `SplitButton` cannot
|
|
373
|
+
be that trigger: its `ref` goes to the main half and its other props to the container.
|
|
374
|
+
Its trigger half keeps the open state itself (click toggles, ArrowDown opens, Escape
|
|
375
|
+
closes; `open`, `defaultOpen`, `onOpenChange` to control it) and renders no menu; render
|
|
376
|
+
the panel from `open` / `onOpenChange`. The trigger half takes no `ref` or
|
|
377
|
+
`aria-controls` from you.
|
|
378
|
+
- **Not every FODS component is in the package.** `llms.txt` lists the ones that are; a
|
|
379
|
+
component that is not there (Breadcrumbs, Toast…) is missing.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
|
+
|
|
3
|
+
<Meta title="Getting Started/Contributing" />
|
|
4
|
+
|
|
5
|
+
# Contributing
|
|
6
|
+
|
|
7
|
+
For a person who changes a component of this package. The package is built in the design
|
|
8
|
+
system repository, in `packages/react`; the full path of a change, with its roles and
|
|
9
|
+
commands, is `docs/react/manifest-to-code.md` there. This page is the short version.
|
|
10
|
+
|
|
11
|
+
## Where a change starts
|
|
12
|
+
|
|
13
|
+
A component is specified before it is coded. Its manifest
|
|
14
|
+
(`spec/<layer>/<name>.manifest.json`) holds the variants, sizes, states and the token of every
|
|
15
|
+
part; the component `.md` beside it holds the prose. The code follows the manifest, never the
|
|
16
|
+
other way round, and never a Figma frame directly. When the manifest and the code disagree and
|
|
17
|
+
the code is not simply wrong, the question goes back to the spec owner.
|
|
18
|
+
|
|
19
|
+
## What one component is
|
|
20
|
+
|
|
21
|
+
One folder, `src/components/<folder>/`:
|
|
22
|
+
|
|
23
|
+
- `<Name>.tsx` — the component. Tokens reach it only through the theme-mapped utility classes;
|
|
24
|
+
no colour, spacing, radius, duration or easing is written as a literal.
|
|
25
|
+
- `<Name>.test.tsx` — roles, accessible names and ARIA state, not implementation.
|
|
26
|
+
- `<Name>.stories.tsx` — the stories named in
|
|
27
|
+
[Introduction](?path=/docs/getting-started-introduction--docs).
|
|
28
|
+
- `<Name>.mdx` — the docs page. Every factual sentence is provable in the code, the stories or
|
|
29
|
+
the manifest.
|
|
30
|
+
- `index.ts` — the folder's exports. The package root and the `exports` map are generated
|
|
31
|
+
from it.
|
|
32
|
+
|
|
33
|
+
## Definition of Done
|
|
34
|
+
|
|
35
|
+
A component is done when all of these hold, not when it renders:
|
|
36
|
+
|
|
37
|
+
1. **Matrix.** A Matrix story renders every combination of the manifest's axes, and a
|
|
38
|
+
Playground story has a control for every prop.
|
|
39
|
+
2. **States.** Default, hover, active, focus and disabled (and loading, where the manifest has
|
|
40
|
+
it) are shown or reachable without a cursor.
|
|
41
|
+
3. **Bindings.** Every colour, border and size on screen resolves to the token the manifest
|
|
42
|
+
names for that part and state.
|
|
43
|
+
4. **Acceptance in Storybook.** The spec owner has reviewed the component in the Storybook
|
|
44
|
+
preview of the pull request and approved the pull request.
|
|
45
|
+
5. **Manifest version.** The Metadata block of the docs page states the manifest version the
|
|
46
|
+
component was built against.
|
|
47
|
+
6. **Migration first.** A migration the manifest requires is applied before any other change.
|
|
48
|
+
|
|
49
|
+
## Gates
|
|
50
|
+
|
|
51
|
+
Run from the repository root; CI runs the same ones on every pull request.
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npm run generate:check -w @invoiceonline/ui-react # generated files are up to date
|
|
55
|
+
npm run lint -w @invoiceonline/ui-react
|
|
56
|
+
npm run typecheck -w @invoiceonline/ui-react
|
|
57
|
+
npm run test -w @invoiceonline/ui-react # unit tests
|
|
58
|
+
npm run test:stories -w @invoiceonline/ui-react # every story in headless Chromium, with the a11y checks
|
|
59
|
+
npm run check:manifest-versions -w @invoiceonline/ui-react # a changed component states its manifest version
|
|
60
|
+
npm run build -w @invoiceonline/ui-react
|
|
61
|
+
npm run check:classes -w @invoiceonline/ui-react # every utility class has CSS (after build)
|
|
62
|
+
npm run build-storybook -w @invoiceonline/ui-react
|
|
63
|
+
npm run check:story-ids -w @invoiceonline/ui-react # the Storybook IDs the manifests name exist (after build-storybook)
|
|
64
|
+
npm run check:package -w @invoiceonline/ui-react # package shape, nothing internal in the published files
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
CI also compares every component with its manifest, from the sources and in the built
|
|
68
|
+
Storybook: the recorded version, the token of every part, the stories against the axes and
|
|
69
|
+
the tokens the docs page lists.
|
|
70
|
+
|
|
71
|
+
## Before the pull request
|
|
72
|
+
|
|
73
|
+
- A change under `src/` carries a changeset (`.changeset/*.md`): `patch` for a change inside
|
|
74
|
+
the existing API, `minor` for a new variant, size, state, slot or prop, and a breaking change
|
|
75
|
+
with a `### Migration` section in its body.
|
|
76
|
+
- After a change of exports, tokens or the theme: `npm run generate -w @invoiceonline/ui-react`.
|
|
77
|
+
Generated files (`*.generated.*`, `src/index.ts`, `llms.txt`) are never edited by hand.
|
|
78
|
+
- The docs page moves with the code in the same pull request.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
|
+
|
|
3
|
+
<Meta title="Getting Started/For AI agents" />
|
|
4
|
+
|
|
5
|
+
# For AI agents
|
|
6
|
+
|
|
7
|
+
How an AI agent reads this package, in an app that installs it or from this Storybook.
|
|
8
|
+
|
|
9
|
+
## Where the docs are in the tarball
|
|
10
|
+
|
|
11
|
+
The published package (`node_modules/@invoiceonline/ui-react/`) ships `dist/`, `src/` without
|
|
12
|
+
the tests, `docs/`, `AGENTS.md`, `llms.txt` and `CHANGELOG.md`.
|
|
13
|
+
|
|
14
|
+
- `llms.txt` — every component with its import, its exports, a one-line summary and its
|
|
15
|
+
Storybook docs ID. Generated with the package; start here.
|
|
16
|
+
- `AGENTS.md` — the rules for an agent working in an app that uses the package (imports,
|
|
17
|
+
styles, providers, portals, texts, missing components). `llms.txt` copies the same bullets.
|
|
18
|
+
- `docs/Consuming.mdx` — the consumer guide; `docs/Introduction.mdx` — how to read this
|
|
19
|
+
Storybook; `docs/Contributing.mdx` — how a component of the package is built and accepted.
|
|
20
|
+
- `src/components/<folder>/<Name>.mdx` — the docs page of one component;
|
|
21
|
+
`<Name>.stories.tsx` the working examples; `<Name>.tsx` the props with their JSDoc. Types
|
|
22
|
+
are in `dist/**/*.d.ts`.
|
|
23
|
+
|
|
24
|
+
## The MCP server of this Storybook
|
|
25
|
+
|
|
26
|
+
The Storybook runs `@storybook/addon-mcp` with the components manifest switched on
|
|
27
|
+
(`features.componentsManifest`). The dev server (`npm run storybook`) serves an MCP endpoint at
|
|
28
|
+
`/mcp` that lists the components, their props and their stories, so an agent can query the
|
|
29
|
+
manifest instead of reading the sources; a static build carries only the manifest files.
|
|
30
|
+
|
|
31
|
+
## How a docs ID is derived
|
|
32
|
+
|
|
33
|
+
A component's docs ID is the stories `title` in lowercase with every run of other characters
|
|
34
|
+
replaced by one hyphen, plus `--docs`: `Design System/Atoms/Button` → `design-system-atoms-button--docs`.
|
|
35
|
+
A story ID takes the export name split at its capitals (`FiveStatuses` → `five-statuses`) in place
|
|
36
|
+
of `docs`. The titles are pinned:
|
|
37
|
+
each component's manifest records its docs ID, so a title never changes on its own.
|
|
38
|
+
|
|
39
|
+
## What on a docs page is evidence-bound
|
|
40
|
+
|
|
41
|
+
Every factual sentence of a component docs page is verifiable against one of three files: the
|
|
42
|
+
component's `<Name>.tsx`, its `<Name>.stories.tsx` or its manifest. Overview and Rationale
|
|
43
|
+
carry intent; Anatomy, Variants, Sizes, States, API, Accessibility and Usage describe the code
|
|
44
|
+
as it is. **Tokens used** is traced by hand from the classes of the component. **Migration
|
|
45
|
+
notes** record manifest version → version changes, never the history of any app.
|
|
46
|
+
|
|
47
|
+
## How to read Controls
|
|
48
|
+
|
|
49
|
+
The **API** section renders Storybook's Controls table from the TypeScript types and the JSDoc
|
|
50
|
+
of the props (`react-docgen-typescript`, props of dependencies filtered out). A prop marked
|
|
51
|
+
*Story-only* in its description belongs to the story's render, not to the component. The
|
|
52
|
+
default texts are Czech; an app with another language passes every text through the props
|
|
53
|
+
listed in Consuming → Texts and locale.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
|
+
|
|
3
|
+
<Meta title="Getting Started/Introduction" />
|
|
4
|
+
|
|
5
|
+
# Introduction
|
|
6
|
+
|
|
7
|
+
This Storybook documents `@invoiceonline/ui-react`: the React components of FODS, the
|
|
8
|
+
FakturaOnline design system, built on the design tokens the package ships. It is the
|
|
9
|
+
acceptance point of every component and the reference for the apps that install the package.
|
|
10
|
+
|
|
11
|
+
## How the sidebar reads
|
|
12
|
+
|
|
13
|
+
- **Getting Started** — this page, [Consuming](?path=/docs/getting-started-consuming--docs)
|
|
14
|
+
(styles, providers, portals, texts and locale) and
|
|
15
|
+
[For AI agents](?path=/docs/getting-started-for-ai-agents--docs).
|
|
16
|
+
- **Foundations** — the tokens: colours, type, spacing, sizes, radius and borders, elevation,
|
|
17
|
+
layout, motion. The tables are generated from the tokens the package ships.
|
|
18
|
+
- **Design System** — the components, one group per spec layer: Atoms, Molecules, Organisms,
|
|
19
|
+
Patterns. Each component has a **Docs** page first, then its stories.
|
|
20
|
+
- **Changelog** — the releases of the package and of the tokens, plus the pending changesets.
|
|
21
|
+
|
|
22
|
+
## Story conventions
|
|
23
|
+
|
|
24
|
+
A component's stories follow the same names, so the sidebar reads the same everywhere:
|
|
25
|
+
|
|
26
|
+
- **Playground** — the interactive story with a control for every prop.
|
|
27
|
+
- **Matrix** — the full grid of the manifest's axes (variant × size × state), the way the
|
|
28
|
+
Figma labelled grid lays it out.
|
|
29
|
+
- **States** — the interaction states (default, hover, active, focus, disabled, loading) shown
|
|
30
|
+
statically, so a reviewer sees them without a cursor.
|
|
31
|
+
- **Sizes** — one row per size, where the component has a size axis.
|
|
32
|
+
- **Motion** — what animates and how it behaves under reduced motion.
|
|
33
|
+
- **Compositions** and **Recipes** — the component inside the pattern it belongs to, on sample
|
|
34
|
+
data.
|
|
35
|
+
- **Viewport ·** stories render at one real width (a breakpoint band or the 390 mobile
|
|
36
|
+
reference) because a docs canvas always sits in a desktop viewport.
|
|
37
|
+
|
|
38
|
+
Sample texts are Czech, the language of the package defaults, and fictitious: companies,
|
|
39
|
+
addresses, e-mails and links name no real business and no real app. The toolbar backgrounds
|
|
40
|
+
`light`, `secondary` and `dark` are the three page surfaces of the tokens.
|
|
41
|
+
|
|
42
|
+
## The Metadata block of a docs page
|
|
43
|
+
|
|
44
|
+
Every component docs page opens with the same bullet list:
|
|
45
|
+
|
|
46
|
+
- **Layer** and **Status** — the spec layer and the delivery state of the component.
|
|
47
|
+
- **Tokens used** — the semantic tokens the component binds, traced from its classes by hand.
|
|
48
|
+
- **Manifest version** — the version of the component's manifest the code was built against.
|
|
49
|
+
A later MINOR or MAJOR manifest version re-opens the component until the stories pass against
|
|
50
|
+
it again; a PATCH never does.
|
|
51
|
+
|
|
52
|
+
Everything else on a docs page is provable against the component's source, its stories or its
|
|
53
|
+
manifest; the Migration notes record manifest version → version changes, never the history of any
|
|
54
|
+
app.
|