@envsemble/envui 2.0.0 → 3.0.1
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/CHANGELOG.md +258 -0
- package/README.md +14 -27
- package/dist/actions/Button.d.ts +25 -8
- package/dist/actions/Button.js.map +2 -2
- package/dist/actions/CommandPalette.d.ts +37 -9
- package/dist/actions/CommandPalette.js +111 -107
- package/dist/actions/CommandPalette.js.map +2 -2
- package/dist/actions/ConfirmButton.d.ts +1 -1
- package/dist/actions/ConfirmButton.js +2 -4
- package/dist/actions/ConfirmButton.js.map +2 -2
- package/dist/actions/ContextMenu.d.ts +1 -1
- package/dist/actions/ContextMenu.js +5 -6
- package/dist/actions/ContextMenu.js.map +2 -2
- package/dist/actions/CopyButton.js +2 -2
- package/dist/actions/CopyButton.js.map +2 -2
- package/dist/actions/Menubar.d.ts +12 -5
- package/dist/actions/Menubar.js +37 -29
- package/dist/actions/Menubar.js.map +3 -3
- package/dist/actions/Toolbar.d.ts +42 -2
- package/dist/actions/Toolbar.js +18 -0
- package/dist/actions/Toolbar.js.map +2 -2
- package/dist/actions/internal/ButtonBase.d.ts +3 -2
- package/dist/actions/internal/ButtonBase.js +2 -4
- package/dist/actions/internal/ButtonBase.js.map +2 -2
- package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
- package/dist/actions/internal/CommandPaletteOptions.js +24 -15
- package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
- package/dist/actions/internal/CommandPaletteStatus.js +23 -9
- package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
- package/dist/actions/menu/Menu.d.ts +5 -4
- package/dist/actions/menu/Menu.js +3 -6
- package/dist/actions/menu/Menu.js.map +2 -2
- package/dist/actions/menu/MenuChoices.d.ts +9 -7
- package/dist/actions/menu/MenuChoices.js +34 -6
- package/dist/actions/menu/MenuChoices.js.map +2 -2
- package/dist/actions/menu/MenuItem.d.ts +37 -8
- package/dist/actions/menu/MenuItem.js +47 -12
- package/dist/actions/menu/MenuItem.js.map +2 -2
- package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
- package/dist/actions/menu/MenuSubmenu.js +26 -24
- package/dist/actions/menu/MenuSubmenu.js.map +2 -2
- package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
- package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
- package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
- package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
- package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
- package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
- package/dist/assets/readme/overview-dark.png +0 -0
- package/dist/assets/readme/overview-light.png +0 -0
- package/dist/content/Accordion.d.ts +32 -2
- package/dist/content/Accordion.js +41 -12
- package/dist/content/Accordion.js.map +2 -2
- package/dist/content/CodeBlock.d.ts +13 -4
- package/dist/content/CodeBlock.js +2 -0
- package/dist/content/CodeBlock.js.map +2 -2
- package/dist/content/CodeDiff.d.ts +34 -4
- package/dist/content/CodeDiff.js +41 -24
- package/dist/content/CodeDiff.js.map +2 -2
- package/dist/content/Composer.d.ts +19 -2
- package/dist/content/Composer.js +19 -12
- package/dist/content/Composer.js.map +2 -2
- package/dist/content/Disclosure.d.ts +13 -1
- package/dist/content/Disclosure.js +9 -3
- package/dist/content/Disclosure.js.map +2 -2
- package/dist/content/HighlightedCodeBlock.d.ts +1 -1
- package/dist/content/HighlightedCodeBlock.js +2 -0
- package/dist/content/HighlightedCodeBlock.js.map +2 -2
- package/dist/content/Kbd.d.ts +12 -5
- package/dist/content/Kbd.js +2 -2
- package/dist/content/Kbd.js.map +2 -2
- package/dist/content/Markdown.d.ts +17 -1
- package/dist/content/Markdown.js +26 -4
- package/dist/content/Markdown.js.map +2 -2
- package/dist/content/Message.d.ts +29 -33
- package/dist/content/Message.js +21 -21
- package/dist/content/Message.js.map +2 -2
- package/dist/content/countDiffLines.d.ts +1 -1
- package/dist/content/countDiffLines.js.map +1 -1
- package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
- package/dist/content/internal/CodeBlockFrame.js +25 -13
- package/dist/content/internal/CodeBlockFrame.js.map +2 -2
- package/dist/content/internal/MessageListFollow.js +1 -1
- package/dist/content/internal/MessageListFollow.js.map +2 -2
- package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
- package/dist/content/internal/MessageStatusLabel.js.map +2 -2
- package/dist/content/internal/codeColors.js +2 -2
- package/dist/content/internal/codeColors.js.map +2 -2
- package/dist/content/internal/useCodeContrast.js +4 -3
- package/dist/content/internal/useCodeContrast.js.map +2 -2
- package/dist/data-display/Avatar.d.ts +13 -4
- package/dist/data-display/Avatar.js +8 -4
- package/dist/data-display/Avatar.js.map +2 -2
- package/dist/data-display/AvatarButton.d.ts +20 -5
- package/dist/data-display/AvatarButton.js +17 -2
- package/dist/data-display/AvatarButton.js.map +2 -2
- package/dist/data-display/AvatarGroup.d.ts +28 -12
- package/dist/data-display/AvatarGroup.js +21 -32
- package/dist/data-display/AvatarGroup.js.map +2 -2
- package/dist/data-display/Badge.d.ts +11 -8
- package/dist/data-display/Badge.js +4 -3
- package/dist/data-display/Badge.js.map +2 -2
- package/dist/data-display/List.d.ts +21 -9
- package/dist/data-display/List.js +1 -1
- package/dist/data-display/List.js.map +2 -2
- package/dist/data-display/Meter.d.ts +7 -1
- package/dist/data-display/Meter.js +11 -5
- package/dist/data-display/Meter.js.map +2 -2
- package/dist/data-display/RelativeTime.d.ts +8 -2
- package/dist/data-display/RelativeTime.js +18 -7
- package/dist/data-display/RelativeTime.js.map +2 -2
- package/dist/data-display/Table.d.ts +26 -7
- package/dist/data-display/Table.js +70 -65
- package/dist/data-display/Table.js.map +2 -2
- package/dist/data-display/formatRelativeTime.d.ts +0 -2
- package/dist/data-display/formatRelativeTime.js +4 -28
- package/dist/data-display/formatRelativeTime.js.map +2 -2
- package/dist/data-display/internal/ListNaming.js +1 -1
- package/dist/data-display/internal/ListNaming.js.map +1 -1
- package/dist/data-display/internal/ReorderableList.d.ts +3 -2
- package/dist/data-display/internal/ReorderableList.js +11 -16
- package/dist/data-display/internal/ReorderableList.js.map +2 -2
- package/dist/data-display/internal/avatarName.d.ts +2 -0
- package/dist/data-display/internal/avatarName.js +7 -0
- package/dist/data-display/internal/avatarName.js.map +7 -0
- package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
- package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
- package/dist/data-display/internal/listMarkup.js.map +7 -0
- package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
- package/dist/data-display/internal/relativeTimeFormat.js +12 -0
- package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
- package/dist/data-display/internal/reorderController.js +3 -3
- package/dist/data-display/internal/reorderController.js.map +2 -2
- package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
- package/dist/data-display/internal/reorderGeometry.js +1 -10
- package/dist/data-display/internal/reorderGeometry.js.map +2 -2
- package/dist/data-display/internal/tableColumns.js +8 -9
- package/dist/data-display/internal/tableColumns.js.map +2 -2
- package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
- package/dist/data-display/internal/tableStacking.js +49 -0
- package/dist/data-display/internal/tableStacking.js.map +7 -0
- package/dist/data-display/internal/useReorder.js +1 -1
- package/dist/data-display/internal/useReorder.js.map +1 -1
- package/dist/diff.d.ts +1 -1
- package/dist/diff.js +1 -4
- package/dist/diff.js.map +2 -2
- package/dist/feedback/Alert.d.ts +13 -3
- package/dist/feedback/Alert.js +16 -6
- package/dist/feedback/Alert.js.map +2 -2
- package/dist/feedback/EmptyState.d.ts +12 -3
- package/dist/feedback/EmptyState.js +6 -6
- package/dist/feedback/EmptyState.js.map +2 -2
- package/dist/feedback/Halo.d.ts +27 -0
- package/dist/feedback/Halo.js +21 -0
- package/dist/feedback/Halo.js.map +7 -0
- package/dist/feedback/Progress.js +3 -2
- package/dist/feedback/Progress.js.map +2 -2
- package/dist/feedback/toast/ToastProvider.js +1 -1
- package/dist/feedback/toast/ToastProvider.js.map +1 -1
- package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
- package/dist/feedback/toast/internal/ContainedToast.js +43 -0
- package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
- package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
- package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
- package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
- package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
- package/dist/feedback/toast/internal/LiveToast.js +78 -0
- package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
- package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
- package/dist/feedback/toast/internal/ToastBody.js +6 -2
- package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
- package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
- package/dist/feedback/toast/internal/ToastButtons.js +77 -0
- package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
- package/dist/feedback/toast/internal/ToastRegion.js +43 -172
- package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
- package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
- package/dist/feedback/toast/internal/toastEntry.js +10 -1
- package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
- package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
- package/dist/feedback/toast/internal/useToastController.js +4 -2
- package/dist/feedback/toast/internal/useToastController.js.map +2 -2
- package/dist/feedback/toast/internal/useToastGlide.js +2 -1
- package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
- package/dist/feedback/toast/toastTypes.d.ts +38 -11
- package/dist/feedback/toast/useToast.d.ts +0 -2
- package/dist/feedback/toast/useToast.js +2 -3
- package/dist/feedback/toast/useToast.js.map +2 -2
- package/dist/forms/Calendar.d.ts +30 -11
- package/dist/forms/Calendar.js +19 -13
- package/dist/forms/Calendar.js.map +2 -2
- package/dist/forms/Checkbox.d.ts +7 -1
- package/dist/forms/Checkbox.js +33 -27
- package/dist/forms/Checkbox.js.map +2 -2
- package/dist/forms/Combobox.d.ts +4 -4
- package/dist/forms/Combobox.js +26 -146
- package/dist/forms/Combobox.js.map +2 -2
- package/dist/forms/DatePicker.d.ts +38 -11
- package/dist/forms/DatePicker.js +32 -52
- package/dist/forms/DatePicker.js.map +2 -2
- package/dist/forms/DropZone.d.ts +23 -4
- package/dist/forms/DropZone.js +29 -11
- package/dist/forms/DropZone.js.map +2 -2
- package/dist/forms/Field.d.ts +7 -1
- package/dist/forms/Field.js +13 -6
- package/dist/forms/Field.js.map +2 -2
- package/dist/forms/MonthPicker.d.ts +8 -1
- package/dist/forms/MonthPicker.js +22 -42
- package/dist/forms/MonthPicker.js.map +2 -2
- package/dist/forms/Radio.d.ts +15 -5
- package/dist/forms/Radio.js +20 -18
- package/dist/forms/Radio.js.map +2 -2
- package/dist/forms/SearchField.d.ts +13 -5
- package/dist/forms/SearchField.js +26 -21
- package/dist/forms/SearchField.js.map +2 -2
- package/dist/forms/SegmentedControl.d.ts +37 -8
- package/dist/forms/SegmentedControl.js +31 -25
- package/dist/forms/SegmentedControl.js.map +2 -2
- package/dist/forms/Select.d.ts +31 -6
- package/dist/forms/Select.js +43 -24
- package/dist/forms/Select.js.map +2 -2
- package/dist/forms/Slider.d.ts +12 -4
- package/dist/forms/Slider.js +32 -21
- package/dist/forms/Slider.js.map +2 -2
- package/dist/forms/Switch.d.ts +7 -1
- package/dist/forms/Switch.js +31 -25
- package/dist/forms/Switch.js.map +2 -2
- package/dist/forms/TextField.d.ts +5 -5
- package/dist/forms/TextField.js +20 -11
- package/dist/forms/TextField.js.map +2 -2
- package/dist/forms/Textarea.d.ts +1 -1
- package/dist/forms/Textarea.js +12 -2
- package/dist/forms/Textarea.js.map +2 -2
- package/dist/forms/TimePicker.d.ts +8 -1
- package/dist/forms/TimePicker.js +20 -45
- package/dist/forms/TimePicker.js.map +2 -2
- package/dist/forms/color/ColorPicker.d.ts +1 -1
- package/dist/forms/color/ColorPicker.js +29 -23
- package/dist/forms/color/ColorPicker.js.map +2 -2
- package/dist/forms/color/ColorPickerButton.d.ts +12 -2
- package/dist/forms/color/ColorPickerButton.js +37 -22
- package/dist/forms/color/ColorPickerButton.js.map +2 -2
- package/dist/forms/color/ColorSwatch.js +2 -2
- package/dist/forms/color/ColorSwatch.js.map +2 -2
- package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
- package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
- package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
- package/dist/forms/color/internal/ColorLocale.js +2 -8
- package/dist/forms/color/internal/ColorLocale.js.map +2 -2
- package/dist/forms/color/internal/ColorValues.d.ts +1 -1
- package/dist/forms/color/internal/ColorValues.js +2 -2
- package/dist/forms/color/internal/ColorValues.js.map +2 -2
- package/dist/forms/color/internal/SwatchList.js +6 -9
- package/dist/forms/color/internal/SwatchList.js.map +2 -2
- package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
- package/dist/forms/color/internal/colorValue.d.ts +1 -0
- package/dist/forms/color/internal/colorValue.js +5 -0
- package/dist/forms/color/internal/colorValue.js.map +2 -2
- package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
- package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
- package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
- package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
- package/dist/forms/color/internal/useFormResetting.js +36 -0
- package/dist/forms/color/internal/useFormResetting.js.map +7 -0
- package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
- package/dist/forms/color/internal/useSwatchFocus.js +62 -0
- package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
- package/dist/forms/internal/ComboboxField.d.ts +30 -0
- package/dist/forms/internal/ComboboxField.js +147 -0
- package/dist/forms/internal/ComboboxField.js.map +7 -0
- package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
- package/dist/forms/internal/ComboboxPopup.js +8 -16
- package/dist/forms/internal/ComboboxPopup.js.map +2 -2
- package/dist/forms/internal/MonthGrid.d.ts +1 -1
- package/dist/forms/internal/MonthGrid.js +4 -4
- package/dist/forms/internal/MonthGrid.js.map +2 -2
- package/dist/forms/internal/PickerField.d.ts +32 -27
- package/dist/forms/internal/PickerField.js +70 -52
- package/dist/forms/internal/PickerField.js.map +3 -3
- package/dist/forms/internal/PickerPopup.d.ts +2 -1
- package/dist/forms/internal/PickerPopup.js +3 -0
- package/dist/forms/internal/PickerPopup.js.map +2 -2
- package/dist/forms/internal/TimeList.d.ts +1 -1
- package/dist/forms/internal/TimeList.js +4 -4
- package/dist/forms/internal/TimeList.js.map +2 -2
- package/dist/forms/internal/TimeWheel.d.ts +3 -3
- package/dist/forms/internal/TimeWheel.js +5 -5
- package/dist/forms/internal/TimeWheel.js.map +2 -2
- package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
- package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
- package/dist/forms/internal/calendarDays.js.map +7 -0
- package/dist/forms/internal/comboboxItems.d.ts +15 -4
- package/dist/forms/internal/comboboxItems.js +0 -12
- package/dist/forms/internal/comboboxItems.js.map +3 -3
- package/dist/forms/internal/pickerFocus.d.ts +4 -0
- package/dist/forms/internal/pickerFocus.js +13 -0
- package/dist/forms/internal/pickerFocus.js.map +7 -0
- package/dist/forms/internal/timeWheelRows.d.ts +4 -4
- package/dist/forms/internal/timeWheelRows.js +6 -4
- package/dist/forms/internal/timeWheelRows.js.map +2 -2
- package/dist/forms/internal/useComboboxOpen.js +2 -5
- package/dist/forms/internal/useComboboxOpen.js.map +2 -2
- package/dist/forms/internal/useComboboxOptions.js +3 -4
- package/dist/forms/internal/useComboboxOptions.js.map +2 -2
- package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
- package/dist/forms/internal/usePicker.d.ts +29 -0
- package/dist/forms/internal/usePicker.js +38 -0
- package/dist/forms/internal/usePicker.js.map +7 -0
- package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
- package/dist/forms/internal/usePickerFormatter.js +23 -0
- package/dist/forms/internal/usePickerFormatter.js.map +7 -0
- package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
- package/dist/forms/internal/useTimeWheelTurn.js +7 -7
- package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
- package/dist/foundations/PortalContainer.js +1 -1
- package/dist/foundations/PortalContainer.js.map +1 -1
- package/dist/foundations/Theme.d.ts +9 -2
- package/dist/foundations/Theme.js +24 -19
- package/dist/foundations/Theme.js.map +2 -2
- package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
- package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
- package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
- package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
- package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
- package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
- package/dist/foundations/ThemeToggle.d.ts +9 -2
- package/dist/foundations/ThemeToggle.js +3 -2
- package/dist/foundations/ThemeToggle.js.map +2 -2
- package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
- package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
- package/dist/foundations/internal/storedPreference.d.ts +3 -0
- package/dist/foundations/internal/storedPreference.js +8 -0
- package/dist/foundations/internal/storedPreference.js.map +7 -0
- package/dist/foundations/messages/defaultMessages.d.ts +4 -72
- package/dist/foundations/messages/defaultMessages.js +0 -14
- package/dist/foundations/messages/defaultMessages.js.map +2 -2
- package/dist/foundations/messages/list.d.ts +13 -35
- package/dist/foundations/messages/list.js +1 -5
- package/dist/foundations/messages/list.js.map +2 -2
- package/dist/foundations/messages/message.d.ts +1 -1
- package/dist/foundations/messages/message.js +1 -1
- package/dist/foundations/messages/message.js.map +1 -1
- package/dist/foundations/messages/navigation.d.ts +4 -0
- package/dist/foundations/messages/navigation.js +2 -0
- package/dist/foundations/messages/navigation.js.map +2 -2
- package/dist/foundations/themeBootstrap.d.ts +13 -35
- package/dist/foundations/themeBootstrap.js +4 -35
- package/dist/foundations/themeBootstrap.js.map +2 -2
- package/dist/foundations/themeStorage.d.ts +20 -0
- package/dist/foundations/themeStorage.js +12 -0
- package/dist/foundations/themeStorage.js.map +7 -0
- package/dist/foundations/useContainerSize.js +13 -11
- package/dist/foundations/useContainerSize.js.map +2 -2
- package/dist/foundations/useSkeleton.d.ts +5 -0
- package/dist/foundations/useSkeleton.js +10 -0
- package/dist/foundations/useSkeleton.js.map +7 -0
- package/dist/foundations/useStoredThemePreference.d.ts +16 -0
- package/dist/foundations/useStoredThemePreference.js +63 -0
- package/dist/foundations/useStoredThemePreference.js.map +7 -0
- package/dist/foundations/windowClasses.d.ts +0 -2
- package/dist/foundations/windowClasses.js +1 -4
- package/dist/foundations/windowClasses.js.map +2 -2
- package/dist/index.d.ts +15 -20
- package/dist/index.js +16 -36
- package/dist/index.js.map +2 -2
- package/dist/internal/control/ActionElement.d.ts +3 -2
- package/dist/internal/control/ActionElement.js +8 -0
- package/dist/internal/control/ActionElement.js.map +2 -2
- package/dist/internal/dialog/ModalLayer.d.ts +9 -0
- package/dist/internal/dialog/ModalLayer.js +32 -0
- package/dist/internal/dialog/ModalLayer.js.map +7 -0
- package/dist/internal/dom/idRefs.d.ts +2 -0
- package/dist/internal/dom/idRefs.js +7 -0
- package/dist/internal/dom/idRefs.js.map +7 -0
- package/dist/internal/dom/lengths.d.ts +3 -1
- package/dist/internal/dom/lengths.js +7 -2
- package/dist/internal/dom/lengths.js.map +2 -2
- package/dist/internal/dom/observeResize.d.ts +7 -0
- package/dist/internal/dom/observeResize.js +11 -0
- package/dist/internal/dom/observeResize.js.map +7 -0
- package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
- package/dist/internal/dom/verticalScrollerOf.js +12 -0
- package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
- package/dist/internal/field/FieldFrame.d.ts +2 -61
- package/dist/internal/field/FieldFrame.js +17 -8
- package/dist/internal/field/FieldFrame.js.map +2 -2
- package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
- package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
- package/dist/internal/field/RowControl.js.map +7 -0
- package/dist/internal/field/TextareaControl.d.ts +2 -2
- package/dist/internal/field/TextareaControl.js +5 -11
- package/dist/internal/field/TextareaControl.js.map +2 -2
- package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
- package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
- package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
- package/dist/internal/field/fieldProps.d.ts +67 -0
- package/dist/internal/field/fieldProps.js +1 -0
- package/dist/internal/field/fieldProps.js.map +7 -0
- package/dist/internal/field/fieldSizing.d.ts +1 -0
- package/dist/internal/field/fieldSizing.js +5 -0
- package/dist/internal/field/fieldSizing.js.map +7 -0
- package/dist/internal/field/useFieldControl.d.ts +36 -0
- package/dist/internal/field/useFieldControl.js +53 -0
- package/dist/internal/field/useFieldControl.js.map +7 -0
- package/dist/internal/field/useFormReset.js +1 -1
- package/dist/internal/field/useFormReset.js.map +1 -1
- package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
- package/dist/internal/icon/DecorativeIcon.js +6 -2
- package/dist/internal/icon/DecorativeIcon.js.map +2 -2
- package/dist/internal/layout/Slot.d.ts +2 -1
- package/dist/internal/layout/Slot.js +3 -1
- package/dist/internal/layout/Slot.js.map +2 -2
- package/dist/internal/popup/ListRow.d.ts +39 -0
- package/dist/internal/{list → popup}/ListRow.js +15 -7
- package/dist/internal/popup/ListRow.js.map +7 -0
- package/dist/internal/popup/PopupSurface.d.ts +1 -1
- package/dist/internal/popup/PopupSurface.js +3 -6
- package/dist/internal/popup/PopupSurface.js.map +2 -2
- package/dist/internal/popup/TooltipPopup.d.ts +3 -9
- package/dist/internal/popup/TooltipPopup.js +2 -9
- package/dist/internal/popup/TooltipPopup.js.map +2 -2
- package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
- package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
- package/dist/internal/popup/containedOverlays.js.map +7 -0
- package/dist/internal/popup/listEntries.d.ts +13 -0
- package/dist/internal/popup/listEntries.js +11 -0
- package/dist/internal/popup/listEntries.js.map +7 -0
- package/dist/internal/popup/useCutShort.d.ts +6 -0
- package/dist/internal/popup/useCutShort.js +19 -0
- package/dist/internal/popup/useCutShort.js.map +7 -0
- package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
- package/dist/internal/provider/PortalContainerContext.js +11 -0
- package/dist/internal/provider/PortalContainerContext.js.map +7 -0
- package/dist/internal/provider/formatters.d.ts +17 -0
- package/dist/internal/provider/formatters.js +21 -0
- package/dist/internal/provider/formatters.js.map +7 -0
- package/dist/internal/provider/locale.d.ts +4 -4
- package/dist/internal/provider/locale.js +9 -1
- package/dist/internal/provider/locale.js.map +2 -2
- package/dist/internal/provider/useDirection.d.ts +1 -1
- package/dist/internal/provider/useDirection.js +2 -14
- package/dist/internal/provider/useDirection.js.map +2 -2
- package/dist/internal/provider/useFormatters.d.ts +1 -16
- package/dist/internal/provider/useFormatters.js +3 -26
- package/dist/internal/provider/useFormatters.js.map +2 -2
- package/dist/internal/rangeBarProps.d.ts +6 -2
- package/dist/internal/react/chainHandlers.d.ts +6 -0
- package/dist/internal/react/chainHandlers.js +12 -0
- package/dist/internal/react/chainHandlers.js.map +7 -0
- package/dist/internal/react/renderElement.js +2 -14
- package/dist/internal/react/renderElement.js.map +2 -2
- package/dist/internal/react/rendersContent.d.ts +2 -0
- package/dist/internal/react/rendersContent.js +7 -0
- package/dist/internal/react/rendersContent.js.map +7 -0
- package/dist/internal/react/setRef.d.ts +6 -1
- package/dist/internal/react/setRef.js +13 -0
- package/dist/internal/react/setRef.js.map +2 -2
- package/dist/internal/react/useControllableState.js +1 -1
- package/dist/internal/react/useControllableState.js.map +1 -1
- package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
- package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
- package/dist/internal/react/useMergedRefs.d.ts +3 -0
- package/dist/internal/react/useMergedRefs.js +10 -0
- package/dist/internal/react/useMergedRefs.js.map +7 -0
- package/dist/internal/resize/useResizableWidth.d.ts +4 -16
- package/dist/internal/resize/useResizableWidth.js +5 -17
- package/dist/internal/resize/useResizableWidth.js.map +2 -2
- package/dist/internal/sizeTokens.d.ts +13 -0
- package/dist/internal/sizeTokens.js +15 -0
- package/dist/internal/sizeTokens.js.map +7 -0
- package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
- package/dist/internal/skeleton/SkeletonContext.js +7 -0
- package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
- package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
- package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
- package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
- package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
- package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
- package/dist/internal/skeleton/skeleton.js.map +7 -0
- package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
- package/dist/internal/skeleton/skeletonText.js.map +7 -0
- package/dist/internal/text/labelText.d.ts +15 -0
- package/dist/internal/text/labelText.js +34 -0
- package/dist/internal/text/labelText.js.map +7 -0
- package/dist/internal/text/useRenderedText.d.ts +3 -0
- package/dist/internal/text/useRenderedText.js +19 -0
- package/dist/internal/text/useRenderedText.js.map +7 -0
- package/dist/internal/theme/themeRoot.d.ts +27 -0
- package/dist/internal/theme/themeRoot.js +45 -0
- package/dist/internal/theme/themeRoot.js.map +7 -0
- package/dist/internal/typeahead.d.ts +9 -5
- package/dist/internal/typeahead.js +4 -1
- package/dist/internal/typeahead.js.map +2 -2
- package/dist/layout/Card.d.ts +21 -4
- package/dist/layout/Card.js +12 -6
- package/dist/layout/Card.js.map +2 -2
- package/dist/layout/Layout.d.ts +2 -2
- package/dist/layout/Layout.js.map +1 -1
- package/dist/layout/Page.d.ts +2 -2
- package/dist/layout/Page.js.map +1 -1
- package/dist/layout/PageHeader.d.ts +6 -1
- package/dist/layout/PageHeader.js +3 -1
- package/dist/layout/PageHeader.js.map +2 -2
- package/dist/layout/Panes.d.ts +10 -20
- package/dist/layout/Panes.js +5 -25
- package/dist/layout/Panes.js.map +2 -2
- package/dist/layout/ResizeHandle.d.ts +1 -0
- package/dist/layout/ResizeHandle.js +11 -21
- package/dist/layout/ResizeHandle.js.map +2 -2
- package/dist/layout/Scaffold.d.ts +14 -4
- package/dist/layout/Scaffold.js +16 -51
- package/dist/layout/Scaffold.js.map +2 -2
- package/dist/layout/Surface.d.ts +1 -1
- package/dist/layout/Surface.js +4 -1
- package/dist/layout/Surface.js.map +2 -2
- package/dist/layout/TopBar.d.ts +2 -2
- package/dist/layout/TopBar.js +4 -5
- package/dist/layout/TopBar.js.map +2 -2
- package/dist/layout/internal/LoadingBar.d.ts +3 -7
- package/dist/layout/internal/LoadingBar.js +5 -10
- package/dist/layout/internal/LoadingBar.js.map +2 -2
- package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
- package/dist/layout/internal/PageTitleFocus.js +3 -24
- package/dist/layout/internal/PageTitleFocus.js.map +2 -2
- package/dist/layout/internal/StickyHeaderSize.js +3 -3
- package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
- package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
- package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
- package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
- package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
- package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
- package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
- package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
- package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
- package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffoldPages.d.ts +9 -0
- package/dist/layout/internal/scaffoldPages.js +27 -0
- package/dist/layout/internal/scaffoldPages.js.map +7 -0
- package/dist/markdown.d.ts +0 -1
- package/dist/markdown.js +0 -1
- package/dist/markdown.js.map +2 -2
- package/dist/messages.d.ts +1 -1
- package/dist/messages.js +1 -6
- package/dist/messages.js.map +2 -2
- package/dist/navigation/Breadcrumbs.d.ts +15 -4
- package/dist/navigation/Breadcrumbs.js +36 -27
- package/dist/navigation/Breadcrumbs.js.map +2 -2
- package/dist/navigation/DocumentTabs.d.ts +54 -12
- package/dist/navigation/DocumentTabs.js +50 -150
- package/dist/navigation/DocumentTabs.js.map +3 -3
- package/dist/navigation/NavigationBar.d.ts +10 -3
- package/dist/navigation/NavigationBar.js +75 -35
- package/dist/navigation/NavigationBar.js.map +2 -2
- package/dist/navigation/NavigationDrawer.d.ts +9 -3
- package/dist/navigation/NavigationDrawer.js +24 -217
- package/dist/navigation/NavigationDrawer.js.map +2 -2
- package/dist/navigation/NavigationRail.d.ts +10 -3
- package/dist/navigation/NavigationRail.js +20 -10
- package/dist/navigation/NavigationRail.js.map +2 -2
- package/dist/navigation/Pager.d.ts +25 -11
- package/dist/navigation/Pager.js +49 -12
- package/dist/navigation/Pager.js.map +3 -3
- package/dist/navigation/Pagination.d.ts +24 -9
- package/dist/navigation/Pagination.js +37 -11
- package/dist/navigation/Pagination.js.map +2 -2
- package/dist/navigation/TableOfContents.d.ts +18 -4
- package/dist/navigation/TableOfContents.js +41 -121
- package/dist/navigation/TableOfContents.js.map +2 -2
- package/dist/navigation/Tree.d.ts +28 -11
- package/dist/navigation/Tree.js +41 -37
- package/dist/navigation/Tree.js.map +2 -2
- package/dist/navigation/destinations.d.ts +43 -11
- package/dist/navigation/internal/DestinationItem.d.ts +5 -41
- package/dist/navigation/internal/DestinationItem.js +41 -44
- package/dist/navigation/internal/DestinationItem.js.map +2 -2
- package/dist/navigation/internal/destinationModel.d.ts +16 -0
- package/dist/navigation/internal/destinationModel.js +28 -0
- package/dist/navigation/internal/destinationModel.js.map +7 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
- package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
- package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
- package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
- package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
- package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
- package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
- package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
- package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
- package/dist/navigation/internal/landmarkLabel.js +5 -0
- package/dist/navigation/internal/landmarkLabel.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
- package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
- package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
- package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
- package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
- package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
- package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
- package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
- package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
- package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
- package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
- package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
- package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
- package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
- package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
- package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
- package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
- package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
- package/dist/navigation/internal/tree/treeModel.js.map +7 -0
- package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
- package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
- package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
- package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
- package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
- package/dist/navigation/internal/useLabelText.d.ts +6 -0
- package/dist/navigation/internal/useLabelText.js +11 -0
- package/dist/navigation/internal/useLabelText.js.map +7 -0
- package/dist/navigation/navigationBackground.d.ts +0 -2
- package/dist/navigation/navigationBackground.js +0 -6
- package/dist/navigation/navigationBackground.js.map +3 -3
- package/dist/overlays/ConfirmDialog.d.ts +6 -3
- package/dist/overlays/ConfirmDialog.js +64 -68
- package/dist/overlays/ConfirmDialog.js.map +2 -2
- package/dist/overlays/Dialog.d.ts +40 -6
- package/dist/overlays/Dialog.js +69 -41
- package/dist/overlays/Dialog.js.map +2 -2
- package/dist/overlays/HoverCard.d.ts +9 -2
- package/dist/overlays/HoverCard.js +5 -5
- package/dist/overlays/HoverCard.js.map +2 -2
- package/dist/overlays/Popover.d.ts +20 -5
- package/dist/overlays/Popover.js +8 -6
- package/dist/overlays/Popover.js.map +2 -2
- package/dist/overlays/Sheet.d.ts +16 -3
- package/dist/overlays/Sheet.js +88 -87
- package/dist/overlays/Sheet.js.map +2 -2
- package/dist/overlays/Tooltip.d.ts +7 -0
- package/dist/overlays/Tooltip.js +10 -15
- package/dist/overlays/Tooltip.js.map +2 -2
- package/dist/overlays/internal/accessibleName.js +2 -1
- package/dist/overlays/internal/accessibleName.js.map +2 -2
- package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
- package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
- package/dist/overlays/internal/dialog/DialogParts.js +64 -0
- package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
- package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
- package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
- package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
- package/dist/styles/Accordion.css +1 -1
- package/dist/styles/Alert.css +1 -1
- package/dist/styles/Avatar.css +1 -1
- package/dist/styles/Badge.css +1 -1
- package/dist/styles/Base.css +1 -1
- package/dist/styles/Breadcrumbs.css +1 -1
- package/dist/styles/Card.css +1 -1
- package/dist/styles/Checkbox.css +1 -1
- package/dist/styles/Code.css +1 -1
- package/dist/styles/Combobox.css +1 -1
- package/dist/styles/CommandPalette.css +1 -1
- package/dist/styles/Composer.css +1 -1
- package/dist/styles/CopyButton.css +1 -1
- package/dist/styles/Dialog.css +1 -1
- package/dist/styles/Disclosure.css +1 -1
- package/dist/styles/DocumentTabs.css +1 -1
- package/dist/styles/DropZone.css +1 -1
- package/dist/styles/EmptyState.css +1 -1
- package/dist/styles/Halo.css +1 -0
- package/dist/styles/List.css +1 -1
- package/dist/styles/ListRow.css +1 -1
- package/dist/styles/LoadingBar.css +1 -1
- package/dist/styles/Menu.css +1 -1
- package/dist/styles/Message.css +1 -1
- package/dist/styles/Meter.css +1 -1
- package/dist/styles/NavigationBar.css +1 -1
- package/dist/styles/NavigationDestinations.css +1 -0
- package/dist/styles/NavigationDrawer.css +1 -1
- package/dist/styles/NavigationRail.css +1 -1
- package/dist/styles/Pager.css +1 -1
- package/dist/styles/Panes.css +1 -1
- package/dist/styles/Progress.css +1 -0
- package/dist/styles/Radio.css +1 -1
- package/dist/styles/Scaffold.css +1 -1
- package/dist/styles/SegmentedControl.css +1 -1
- package/dist/styles/Select.css +1 -1
- package/dist/styles/Switch.css +1 -1
- package/dist/styles/Table.css +1 -1
- package/dist/styles/TableOfContents.css +1 -1
- package/dist/styles/Text.css +1 -1
- package/dist/styles/TextField.css +1 -1
- package/dist/styles/Toast.css +1 -1
- package/dist/styles/Toolbar.css +1 -1
- package/dist/styles/Tree.css +1 -1
- package/dist/styles.css +1 -1
- package/dist/theme-bootstrap.d.ts +1 -1
- package/dist/theme-bootstrap.js +1 -8
- package/dist/theme-bootstrap.js.map +2 -2
- package/dist/theme-storage.d.ts +2 -0
- package/dist/theme-storage.js +3 -0
- package/dist/theme-storage.js.map +7 -0
- package/dist/tokens.json +0 -13
- package/docs/components/accordion.md +13 -0
- package/docs/components/alert.md +8 -1
- package/docs/components/avatar.md +16 -4
- package/docs/components/badge.md +10 -39
- package/docs/components/box.md +3 -3
- package/docs/components/breadcrumbs.md +6 -1
- package/docs/components/button.md +14 -9
- package/docs/components/card.md +14 -5
- package/docs/components/checkbox.md +3 -1
- package/docs/components/code.md +15 -6
- package/docs/components/color-picker.md +10 -2
- package/docs/components/column.md +2 -2
- package/docs/components/combobox.md +1 -1
- package/docs/components/command-palette.md +6 -2
- package/docs/components/composer.md +19 -8
- package/docs/components/confirm-dialog.md +3 -3
- package/docs/components/date-picker.md +15 -3
- package/docs/components/description-list.md +1 -1
- package/docs/components/dialog.md +34 -8
- package/docs/components/disclosure.md +4 -0
- package/docs/components/document-tabs.md +23 -13
- package/docs/components/drop-zone.md +10 -1
- package/docs/components/empty-state.md +12 -3
- package/docs/components/field.md +2 -1
- package/docs/components/graphic.md +1 -1
- package/docs/components/grid.md +2 -2
- package/docs/components/halo.md +80 -0
- package/docs/components/hover-card.md +2 -1
- package/docs/components/kbd.md +8 -2
- package/docs/components/link.md +1 -1
- package/docs/components/list.md +13 -5
- package/docs/components/markdown.md +9 -116
- package/docs/components/menu.md +28 -12
- package/docs/components/menubar.md +4 -3
- package/docs/components/message.md +17 -13
- package/docs/components/meter.md +8 -3
- package/docs/components/month-picker.md +4 -2
- package/docs/components/navigation-drawer.md +32 -7
- package/docs/components/page.md +4 -3
- package/docs/components/pager.md +16 -6
- package/docs/components/pagination.md +3 -2
- package/docs/components/panes.md +13 -26
- package/docs/components/popover.md +3 -2
- package/docs/components/progress.md +2 -2
- package/docs/components/radio.md +13 -5
- package/docs/components/relative-time.md +2 -1
- package/docs/components/resize-handle.md +6 -4
- package/docs/components/row.md +2 -2
- package/docs/components/scaffold.md +13 -4
- package/docs/components/segmented-control.md +10 -4
- package/docs/components/select.md +10 -2
- package/docs/components/sheet.md +4 -1
- package/docs/components/slider.md +8 -2
- package/docs/components/spinner.md +1 -1
- package/docs/components/surface.md +1 -1
- package/docs/components/switch.md +2 -0
- package/docs/components/table-of-contents.md +3 -2
- package/docs/components/table.md +18 -3
- package/docs/components/text-field.md +14 -8
- package/docs/components/time-picker.md +4 -2
- package/docs/components/toast.md +2 -1
- package/docs/components/toolbar.md +31 -6
- package/docs/components/tooltip.md +1 -0
- package/docs/components/top-bar.md +1 -1
- package/docs/components/tree.md +9 -4
- package/docs/customizing.md +59 -91
- package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
- package/docs/examples/alert/BannerAction.tsx +19 -0
- package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
- package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
- package/docs/examples/badge/CountsInButtons.tsx +2 -2
- package/docs/examples/badge/WithContent.tsx +13 -0
- package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
- package/docs/examples/button/ButtonAnatomy.tsx +1 -1
- package/docs/examples/button/CreateProject.tsx +1 -1
- package/docs/examples/button/FillSidebar.tsx +1 -1
- package/docs/examples/button/Icons.tsx +2 -2
- package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
- package/docs/examples/card/CardAnatomy.tsx +3 -1
- package/docs/examples/card/OpenFromCard.tsx +65 -0
- package/docs/examples/code/PackageManagers.tsx +35 -0
- package/docs/examples/code/SettingsDiff.tsx +5 -9
- package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
- package/docs/examples/colors/Status.tsx +6 -6
- package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
- package/docs/examples/command-palette/GoToDocument.tsx +17 -14
- package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
- package/docs/examples/command-palette/RunCommand.tsx +16 -12
- package/docs/examples/command-palette/SearchButton.tsx +2 -2
- package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
- package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
- package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
- package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
- package/docs/examples/dialog/EditMember.tsx +28 -0
- package/docs/examples/dialog/FindPlan.tsx +1 -1
- package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
- package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
- package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
- package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
- package/docs/examples/empty-state/WithIllustration.tsx +22 -0
- package/docs/examples/graphic/Colors.tsx +1 -1
- package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
- package/docs/examples/halo/AroundACard.tsx +14 -0
- package/docs/examples/halo/InviteTeam.tsx +15 -0
- package/docs/examples/halo/Tones.tsx +14 -0
- package/docs/examples/icons/FollowText.tsx +3 -3
- package/docs/examples/kbd/Sequences.tsx +10 -0
- package/docs/examples/list/TitleActions.tsx +32 -0
- package/docs/examples/menu/AccountSwitcher.tsx +32 -0
- package/docs/examples/menu/Choices.tsx +1 -1
- package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
- package/docs/examples/menu/Destinations.tsx +5 -5
- package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
- package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
- package/docs/examples/menu/MenuAnatomy.tsx +3 -3
- package/docs/examples/menu/Submenus.tsx +4 -4
- package/docs/examples/menubar/NotesMenubar.tsx +4 -4
- package/docs/examples/message/CommentThread.tsx +30 -0
- package/docs/examples/message/Conversation.tsx +7 -2
- package/docs/examples/meter/InlineUsage.tsx +10 -0
- package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
- package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
- package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
- package/docs/examples/page/WithHeader.tsx +1 -1
- package/docs/examples/page/WithToolbar.tsx +1 -1
- package/docs/examples/pager/LongTitles.tsx +2 -2
- package/docs/examples/pager/PagerAnatomy.tsx +2 -2
- package/docs/examples/pager/PreviousAndNext.tsx +2 -2
- package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
- package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
- package/docs/examples/panes/PanesAnatomy.tsx +20 -12
- package/docs/examples/panes/ResizableDetails.tsx +35 -2
- package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
- package/docs/examples/popover/DocumentDetails.tsx +1 -1
- package/docs/examples/popover/RenameInPlace.tsx +1 -1
- package/docs/examples/progress/ExportMembers.tsx +1 -1
- package/docs/examples/radio/PlanRows.tsx +35 -0
- package/docs/examples/relative-time/PastAndComing.tsx +6 -6
- package/docs/examples/relative-time/VersionLabels.tsx +5 -5
- package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
- package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
- package/docs/examples/row/SectionHeading.tsx +1 -1
- package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
- package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
- package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
- package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
- package/docs/examples/select/Assignee.tsx +29 -0
- package/docs/examples/select/SmallToolbar.tsx +23 -21
- package/docs/examples/sheet/FilterPanel.tsx +1 -1
- package/docs/examples/sheet/ShareChoices.tsx +1 -1
- package/docs/examples/slider/IconsAndUnits.tsx +42 -0
- package/docs/examples/spacing/Align.tsx +1 -1
- package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
- package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
- package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
- package/docs/examples/text-field/ContentAffixes.tsx +32 -0
- package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
- package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
- package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
- package/docs/examples/text-field/Variants.tsx +1 -1
- package/docs/examples/toast/ExportReady.tsx +7 -5
- package/docs/examples/toast/RetryAfterError.tsx +8 -6
- package/docs/examples/toast/ToastAnatomy.tsx +1 -1
- package/docs/examples/toast/TopCenter.tsx +1 -1
- package/docs/examples/toast/UndoArchive.tsx +10 -8
- package/docs/examples/toolbar/LabelledControls.tsx +40 -0
- package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
- package/docs/examples/tree/ContextMenuActions.tsx +5 -5
- package/docs/examples/tree/FileTree.tsx +1 -1
- package/docs/examples/tree/MatchedLetters.tsx +37 -0
- package/docs/examples/tree/NarrowTree.tsx +3 -3
- package/docs/examples/tree/RowDensity.tsx +6 -6
- package/docs/examples/tree/TreeAnatomy.tsx +2 -2
- package/docs/foundations/accessibility.md +3 -3
- package/docs/foundations/colors.md +2 -3
- package/docs/foundations/icons.md +3 -3
- package/docs/foundations/responsive.md +2 -2
- package/docs/foundations/spacing.md +2 -2
- package/docs/foundations/typography.md +2 -2
- package/docs/generated/exports.json +34 -52
- package/docs/generated/parts.json +469 -484
- package/docs/generated/props.json +1053 -903
- package/docs/index.md +52 -56
- package/docs/setup.md +62 -20
- package/docs/writing.md +1 -1
- package/package.json +6 -25
- package/dist/actions/internal/MenuPopup.js.map +0 -7
- package/dist/assets/readme/gallery-dark.png +0 -0
- package/dist/assets/readme/gallery-light.png +0 -0
- package/dist/content/MarkdownEditor.d.ts +0 -35
- package/dist/content/MarkdownEditor.js +0 -236
- package/dist/content/MarkdownEditor.js.map +0 -7
- package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
- package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
- package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
- package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
- package/dist/content/internal/markdown/markdownFormatting.js +0 -96
- package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
- package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
- package/dist/content/internal/markdown/markdownHistory.js +0 -54
- package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
- package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
- package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
- package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
- package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
- package/dist/data-display/AnimatedNumber.d.ts +0 -15
- package/dist/data-display/AnimatedNumber.js +0 -111
- package/dist/data-display/AnimatedNumber.js.map +0 -7
- package/dist/data-display/CalendarHeatmap.d.ts +0 -92
- package/dist/data-display/CalendarHeatmap.js +0 -224
- package/dist/data-display/CalendarHeatmap.js.map +0 -7
- package/dist/data-display/DiffStat.d.ts +0 -23
- package/dist/data-display/DiffStat.js +0 -42
- package/dist/data-display/DiffStat.js.map +0 -7
- package/dist/data-display/Rating.d.ts +0 -32
- package/dist/data-display/Rating.js +0 -45
- package/dist/data-display/Rating.js.map +0 -7
- package/dist/data-display/internal/ListRows.js.map +0 -7
- package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
- package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
- package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
- package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
- package/dist/data-display/internal/useHeatmapLabels.js +0 -56
- package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
- package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
- package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
- package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
- package/dist/dev/api.d.ts +0 -64
- package/dist/dev/api.js +0 -88
- package/dist/dev/api.js.map +0 -7
- package/dist/dev/elements.d.ts +0 -7
- package/dist/dev/elements.js +0 -32
- package/dist/dev/elements.js.map +0 -7
- package/dist/dev/inner.d.ts +0 -17
- package/dist/dev/inner.js +0 -139
- package/dist/dev/inner.js.map +0 -7
- package/dist/dev/install.d.ts +0 -64
- package/dist/dev/install.js +0 -128
- package/dist/dev/install.js.map +0 -7
- package/dist/dev/measure.d.ts +0 -10
- package/dist/dev/measure.js +0 -304
- package/dist/dev/measure.js.map +0 -7
- package/dist/dev/model.d.ts +0 -136
- package/dist/dev/model.js +0 -5
- package/dist/dev/model.js.map +0 -7
- package/dist/dev/overlays.d.ts +0 -5
- package/dist/dev/overlays.js +0 -52
- package/dist/dev/overlays.js.map +0 -7
- package/dist/dev/parts.d.ts +0 -49
- package/dist/dev/parts.js +0 -89
- package/dist/dev/parts.js.map +0 -7
- package/dist/dev/queries.d.ts +0 -28
- package/dist/dev/queries.js +0 -135
- package/dist/dev/queries.js.map +0 -7
- package/dist/dev/readout.d.ts +0 -9
- package/dist/dev/readout.js +0 -275
- package/dist/dev/readout.js.map +0 -7
- package/dist/dev/skeletonShift.d.ts +0 -6
- package/dist/dev/skeletonShift.js +0 -174
- package/dist/dev/skeletonShift.js.map +0 -7
- package/dist/dev/ui/Controls.d.ts +0 -20
- package/dist/dev/ui/Controls.js +0 -53
- package/dist/dev/ui/Controls.js.map +0 -7
- package/dist/dev/ui/DevMode.d.ts +0 -14
- package/dist/dev/ui/DevMode.js +0 -222
- package/dist/dev/ui/DevMode.js.map +0 -7
- package/dist/dev/ui/Frame.d.ts +0 -14
- package/dist/dev/ui/Frame.js +0 -178
- package/dist/dev/ui/Frame.js.map +0 -7
- package/dist/dev/ui/Icons.d.ts +0 -5
- package/dist/dev/ui/Icons.js +0 -38
- package/dist/dev/ui/Icons.js.map +0 -7
- package/dist/dev/ui/Inspector.d.ts +0 -24
- package/dist/dev/ui/Inspector.js +0 -366
- package/dist/dev/ui/Inspector.js.map +0 -7
- package/dist/dev/ui/Legend.d.ts +0 -4
- package/dist/dev/ui/Legend.js +0 -50
- package/dist/dev/ui/Legend.js.map +0 -7
- package/dist/dev/ui/NodeHints.d.ts +0 -15
- package/dist/dev/ui/NodeHints.js +0 -95
- package/dist/dev/ui/NodeHints.js.map +0 -7
- package/dist/dev/ui/PerformancePanel.d.ts +0 -3
- package/dist/dev/ui/PerformancePanel.js +0 -72
- package/dist/dev/ui/PerformancePanel.js.map +0 -7
- package/dist/dev/ui/Plane.d.ts +0 -37
- package/dist/dev/ui/Plane.js +0 -154
- package/dist/dev/ui/Plane.js.map +0 -7
- package/dist/dev/ui/View3D.d.ts +0 -19
- package/dist/dev/ui/View3D.js +0 -248
- package/dist/dev/ui/View3D.js.map +0 -7
- package/dist/dev/ui/ViewToolbar.d.ts +0 -40
- package/dist/dev/ui/ViewToolbar.js +0 -352
- package/dist/dev/ui/ViewToolbar.js.map +0 -7
- package/dist/dev/ui/camera.d.ts +0 -42
- package/dist/dev/ui/camera.js +0 -157
- package/dist/dev/ui/camera.js.map +0 -7
- package/dist/dev/ui/devices.d.ts +0 -9
- package/dist/dev/ui/devices.js +0 -34
- package/dist/dev/ui/devices.js.map +0 -7
- package/dist/dev/ui/editorTheme.d.ts +0 -6
- package/dist/dev/ui/editorTheme.js +0 -30
- package/dist/dev/ui/editorTheme.js.map +0 -7
- package/dist/dev/ui/sides.d.ts +0 -20
- package/dist/dev/ui/sides.js +0 -43
- package/dist/dev/ui/sides.js.map +0 -7
- package/dist/dev/ui/stats.d.ts +0 -25
- package/dist/dev/ui/stats.js +0 -26
- package/dist/dev/ui/stats.js.map +0 -7
- package/dist/dev/ui/surfaces.d.ts +0 -4
- package/dist/dev/ui/surfaces.js +0 -249
- package/dist/dev/ui/surfaces.js.map +0 -7
- package/dist/dev/ui/useLivePage.d.ts +0 -13
- package/dist/dev/ui/useLivePage.js +0 -138
- package/dist/dev/ui/useLivePage.js.map +0 -7
- package/dist/dev/ui/usePlaneHover.d.ts +0 -9
- package/dist/dev/ui/usePlaneHover.js +0 -46
- package/dist/dev/ui/usePlaneHover.js.map +0 -7
- package/dist/dev/ui/useViewFit.d.ts +0 -16
- package/dist/dev/ui/useViewFit.js +0 -59
- package/dist/dev/ui/useViewFit.js.map +0 -7
- package/dist/dev/ui/useViewWheel.d.ts +0 -11
- package/dist/dev/ui/useViewWheel.js +0 -48
- package/dist/dev/ui/useViewWheel.js.map +0 -7
- package/dist/dev/ui/wheel.d.ts +0 -7
- package/dist/dev/ui/wheel.js +0 -98
- package/dist/dev/ui/wheel.js.map +0 -7
- package/dist/dev/units.d.ts +0 -7
- package/dist/dev/units.js +0 -22
- package/dist/dev/units.js.map +0 -7
- package/dist/dev/usedTokens.d.ts +0 -5
- package/dist/dev/usedTokens.js +0 -56
- package/dist/dev/usedTokens.js.map +0 -7
- package/dist/dev.d.ts +0 -5
- package/dist/dev.js +0 -9
- package/dist/dev.js.map +0 -7
- package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
- package/dist/forms/color/internal/useColorState.d.ts +0 -10
- package/dist/forms/color/internal/useColorState.js +0 -49
- package/dist/forms/color/internal/useColorState.js.map +0 -7
- package/dist/forms/internal/usePickerValue.d.ts +0 -13
- package/dist/forms/internal/usePickerValue.js +0 -45
- package/dist/forms/internal/usePickerValue.js.map +0 -7
- package/dist/forms/internal/useRovingFocus.d.ts +0 -47
- package/dist/forms/internal/useRovingFocus.js +0 -179
- package/dist/forms/internal/useRovingFocus.js.map +0 -7
- package/dist/forms/rich-text/RichText.d.ts +0 -7
- package/dist/forms/rich-text/RichText.js +0 -91
- package/dist/forms/rich-text/RichText.js.map +0 -7
- package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
- package/dist/forms/rich-text/RichTextEditor.js +0 -225
- package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
- package/dist/forms/rich-text/extensions.d.ts +0 -10
- package/dist/forms/rich-text/extensions.js +0 -45
- package/dist/forms/rich-text/extensions.js.map +0 -7
- package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
- package/dist/forms/rich-text/internal/Listbox.js +0 -48
- package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
- package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
- package/dist/forms/rich-text/internal/Reference.js +0 -79
- package/dist/forms/rich-text/internal/Reference.js.map +0 -7
- package/dist/forms/rich-text/internal/commands.d.ts +0 -6
- package/dist/forms/rich-text/internal/commands.js +0 -74
- package/dist/forms/rich-text/internal/commands.js.map +0 -7
- package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
- package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
- package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
- package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
- package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
- package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
- package/dist/forms/rich-text/internal/suggestions.js +0 -185
- package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
- package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
- package/dist/forms/rich-text/internal/taskItem.js +0 -43
- package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
- package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
- package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
- package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
- package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
- package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
- package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
- package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
- package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
- package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
- package/dist/forms/rich-text/types.d.ts +0 -190
- package/dist/forms/rich-text/types.js +0 -1
- package/dist/foundations/SkeletonScope.js.map +0 -7
- package/dist/foundations/ThemePreference.d.ts +0 -35
- package/dist/foundations/ThemePreference.js.map +0 -7
- package/dist/foundations/internal/skeletonText.js.map +0 -7
- package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
- package/dist/foundations/messages/calendarHeatmap.js +0 -10
- package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
- package/dist/foundations/messages/diffStat.d.ts +0 -16
- package/dist/foundations/messages/diffStat.js +0 -17
- package/dist/foundations/messages/diffStat.js.map +0 -7
- package/dist/foundations/messages/editor.d.ts +0 -35
- package/dist/foundations/messages/editor.js +0 -34
- package/dist/foundations/messages/editor.js.map +0 -7
- package/dist/foundations/messages/linkDialog.d.ts +0 -20
- package/dist/foundations/messages/linkDialog.js +0 -20
- package/dist/foundations/messages/linkDialog.js.map +0 -7
- package/dist/foundations/messages/markdownEditor.d.ts +0 -26
- package/dist/foundations/messages/markdownEditor.js +0 -26
- package/dist/foundations/messages/markdownEditor.js.map +0 -7
- package/dist/foundations/messages/rating.d.ts +0 -11
- package/dist/foundations/messages/rating.js +0 -8
- package/dist/foundations/messages/rating.js.map +0 -7
- package/dist/foundations/messages/richText.d.ts +0 -34
- package/dist/foundations/messages/richText.js +0 -34
- package/dist/foundations/messages/richText.js.map +0 -7
- package/dist/internal/dialog/DialogParts.d.ts +0 -46
- package/dist/internal/dialog/DialogParts.js +0 -66
- package/dist/internal/dialog/DialogParts.js.map +0 -7
- package/dist/internal/dom/paints.d.ts +0 -5
- package/dist/internal/dom/paints.js +0 -17
- package/dist/internal/dom/paints.js.map +0 -7
- package/dist/internal/dom/useStripWheel.d.ts +0 -6
- package/dist/internal/dom/useStripWheel.js +0 -26
- package/dist/internal/dom/useStripWheel.js.map +0 -7
- package/dist/internal/editor/EditorStatus.d.ts +0 -8
- package/dist/internal/editor/EditorStatus.js +0 -11
- package/dist/internal/editor/EditorStatus.js.map +0 -7
- package/dist/internal/editor/EditorToolbar.d.ts +0 -28
- package/dist/internal/editor/EditorToolbar.js +0 -89
- package/dist/internal/editor/EditorToolbar.js.map +0 -7
- package/dist/internal/editor/LinkDialog.d.ts +0 -20
- package/dist/internal/editor/LinkDialog.js +0 -78
- package/dist/internal/editor/LinkDialog.js.map +0 -7
- package/dist/internal/editor/editorCommands.d.ts +0 -20
- package/dist/internal/editor/editorCommands.js +0 -45
- package/dist/internal/editor/editorCommands.js.map +0 -7
- package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
- package/dist/internal/field/rowControl.js.map +0 -7
- package/dist/internal/field/useFieldMetadata.d.ts +0 -16
- package/dist/internal/field/useFieldMetadata.js +0 -24
- package/dist/internal/field/useFieldMetadata.js.map +0 -7
- package/dist/internal/list/ListRow.d.ts +0 -33
- package/dist/internal/list/ListRow.js.map +0 -7
- package/dist/internal/popup/PortalContainerContext.js.map +0 -7
- package/dist/internal/react/useStackedReport.js +0 -28
- package/dist/internal/react/useStackedReport.js.map +0 -7
- package/dist/internal/skeleton.js.map +0 -7
- package/dist/internal/time/calendarDays.js.map +0 -7
- package/dist/layout/internal/navigationForms.js.map +0 -7
- package/dist/layout/internal/scrollKeys.js.map +0 -7
- package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
- package/dist/layout/internal/useScrollKeys.js.map +0 -7
- package/dist/layout/panesSize.d.ts +0 -13
- package/dist/layout/panesSize.js +0 -39
- package/dist/layout/panesSize.js.map +0 -7
- package/dist/navigation/internal/TreeRow.js.map +0 -7
- package/dist/navigation/internal/contentsOutline.d.ts +0 -60
- package/dist/navigation/internal/contentsOutline.js.map +0 -7
- package/dist/navigation/internal/contentsWave.js.map +0 -7
- package/dist/navigation/internal/sectionScroll.js.map +0 -7
- package/dist/navigation/internal/tabStrip.d.ts +0 -6
- package/dist/navigation/internal/tabStrip.js +0 -24
- package/dist/navigation/internal/tabStrip.js.map +0 -7
- package/dist/navigation/internal/treeModel.js.map +0 -7
- package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
- package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
- package/dist/navigation/internal/useTabDrag.js.map +0 -7
- package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
- package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
- package/dist/navigation/internal/useTreeViewport.js.map +0 -7
- package/dist/navigation/internal/waveDrawer.js.map +0 -7
- package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
- package/dist/rich-text.d.ts +0 -5
- package/dist/rich-text.js +0 -9
- package/dist/rich-text.js.map +0 -7
- package/dist/styles/CalendarHeatmap.css +0 -1
- package/dist/styles/Editor.css +0 -1
- package/dist/styles/Listbox.css +0 -1
- package/dist/styles/MarkdownEditor.css +0 -1
- package/dist/styles/Rating.css +0 -1
- package/dist/styles/RichText.css +0 -1
- package/docs/components/animated-number.md +0 -72
- package/docs/components/calendar-heatmap.md +0 -140
- package/docs/components/rating.md +0 -84
- package/docs/components/rich-text.md +0 -224
- package/docs/dev-mode.md +0 -59
- package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
- package/docs/examples/animated-number/CustomFormat.tsx +0 -28
- package/docs/examples/animated-number/ShowResults.tsx +0 -38
- package/docs/examples/badge/ChangeSize.tsx +0 -21
- package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
- package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
- package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
- package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
- package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
- package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
- package/docs/examples/markdown/LinkPicker.tsx +0 -65
- package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
- package/docs/examples/markdown/WriteNote.tsx +0 -21
- package/docs/examples/panes/ListAndDetail.tsx +0 -55
- package/docs/examples/rating/RatingAnatomy.tsx +0 -5
- package/docs/examples/rating/ReviewScore.tsx +0 -13
- package/docs/examples/rating/Scales.tsx +0 -11
- package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
- package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
- package/docs/examples/rich-text/References.tsx +0 -47
- package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
- package/docs/examples/rich-text/SavedContent.tsx +0 -33
- package/docs/examples/rich-text/SlashCommands.tsx +0 -24
- package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
- /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
- /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
- /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
- /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
- /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
- /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
- /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
- /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
- /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
- /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
- /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
- /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
- /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
- /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
- /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
package/docs/components/menu.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Menu
|
|
3
|
-
summary:
|
|
3
|
+
summary: A list of actions and links, opened from a button or a right click.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Actions
|
|
@@ -38,6 +38,7 @@ examples: # Each file is examples/menu/<Name>.tsx.
|
|
|
38
38
|
GroupsAndSeparators: example
|
|
39
39
|
Choices: example
|
|
40
40
|
Submenus: example
|
|
41
|
+
AccountSwitcher: example
|
|
41
42
|
Destinations: example
|
|
42
43
|
MenuAnatomy: anatomy
|
|
43
44
|
---
|
|
@@ -62,6 +63,10 @@ Example: Choices.
|
|
|
62
63
|
|
|
63
64
|
Example: Submenus.
|
|
64
65
|
|
|
66
|
+
### Pictures before the label
|
|
67
|
+
|
|
68
|
+
Example: AccountSwitcher.
|
|
69
|
+
|
|
65
70
|
### Destinations
|
|
66
71
|
|
|
67
72
|
Example: Destinations.
|
|
@@ -71,7 +76,7 @@ Example: Destinations.
|
|
|
71
76
|
1. **Menu** (`env-menu`)
|
|
72
77
|
2. **Group label** (`env-menu-group-label`, `label`)
|
|
73
78
|
3. **Item** (`env-menu-item`)
|
|
74
|
-
4. **
|
|
79
|
+
4. **Start** (`env-menu-item-start`, `start`)
|
|
75
80
|
5. **Shortcut** (`env-menu-item-shortcut`, `shortcut`)
|
|
76
81
|
6. **Description** (`env-menu-item-description`, `description`)
|
|
77
82
|
7. **Separator** (`env-menu-separator`)
|
|
@@ -141,15 +146,18 @@ One action (onClick) or destination (href) in a Menu. Destinations use the LinkP
|
|
|
141
146
|
| `aria-current` | `AriaAttributes['aria-current']` | — | Marks a destination as the page shown now, such as aria-current="page" on the current one of a NavigationBar's destinations that its More menu holds. |
|
|
142
147
|
| `aria-label` | `string` | — | The item's accessible name, where its label and end content don't say it as wanted, such as Inbox, 3 new for a destination whose count shows as a badge. |
|
|
143
148
|
| `className` | `string` | — | Class of the item's row. |
|
|
144
|
-
| `
|
|
149
|
+
| `start` | `ReactNode` | — | Content before the label, such as the Settings icon or an Avatar in an account switcher: an envUI icon takes the icon size and other content keeps its own, and the labels of the menu's rows still line up. It is hidden from assistive technology, since the label names the item. |
|
|
145
150
|
| `children` (required) | `ReactNode` | — | The item's label, which names it. |
|
|
151
|
+
| `textValue` | `string` | `children, when it is a string` | The label as plain text, which typing a letter in the open menu matches, where children isn't a string, such as a label with a Badge or emphasis inside. |
|
|
146
152
|
| `description` | `ReactNode` | — | A second, muted line; announced as the item's description. |
|
|
147
153
|
| `shortcut` | `string` | — | Keyboard hint at the end, such as Ctrl+P, shown as Kbd keys and announced as aria-keyshortcuts; a sequence, such as Ctrl+K Ctrl+S, shows its keys without the attribute. The application handles the shortcut itself. |
|
|
148
154
|
| `end` | `ReactNode` | — | End content, such as a Badge or a count; it is part of the item's name. |
|
|
155
|
+
| `ref` | `Ref<HTMLElement>` | — | The item's row element. |
|
|
156
|
+
| `rel` | `string` | — | The destination's relationship to the page, such as noopener, as on a native link. |
|
|
149
157
|
| `href` | `string` | — | The destination: the item is a link, through the LinkProvider's link component, and the menu closes as it is followed. |
|
|
150
158
|
| `onClick` | `(event: MouseEvent<HTMLElement>) => void` | — | Runs as the destination is followed, before the menu closes, such as to record the choice; the link still navigates. |
|
|
151
159
|
| `target` | `string` | — | Where the destination opens, such as _blank, as on a native link. |
|
|
152
|
-
| `
|
|
160
|
+
| `closeOnClick` | `boolean` | `true` | Close the menu once the action runs; false keeps it open, for an action people repeat, such as Zoom in. |
|
|
153
161
|
|
|
154
162
|
Native props: HTML element.
|
|
155
163
|
|
|
@@ -175,8 +183,9 @@ A row that opens a nested menu beside it, on hover or with the keyboard. The sub
|
|
|
175
183
|
| `className` | `string` | — | Class of the submenu popup. |
|
|
176
184
|
| `ref` | `Ref<HTMLDivElement>` | — | The submenu popup's ref. |
|
|
177
185
|
| `style` | `CSSProperties` | — | The submenu popup's inline style. |
|
|
186
|
+
| `triggerProps` | `TriggerProps` | — | Attributes of the row that opens the submenu, such as a className, a style, a ref or a data attribute; the submenu's own className, style and ref are its popup's. |
|
|
178
187
|
|
|
179
|
-
Also `
|
|
188
|
+
Also `start`, `end`, `textValue` and `description`, as on Menu.Item.
|
|
180
189
|
|
|
181
190
|
Native props: `<div>`.
|
|
182
191
|
|
|
@@ -214,9 +223,11 @@ One option of a Menu.RadioGroup.
|
|
|
214
223
|
| --- | --- | --- | --- |
|
|
215
224
|
| `value` (required) | `string` | — | The value the Menu.RadioGroup reports when this item is chosen. |
|
|
216
225
|
| `disabled` | `boolean` | `false` | The item stays in place, dimmed, but cannot be chosen. |
|
|
217
|
-
| `closeOnClick` | `boolean` | `true` | Close the menu after choosing. |
|
|
226
|
+
| `closeOnClick` | `boolean` | `true, or the closeOnClick of the ThemeMenuRadioGroup around it` | Close the menu after choosing. |
|
|
218
227
|
|
|
219
|
-
Also `className`, `children`, `end`, `
|
|
228
|
+
Also `className`, `children`, `start`, `end`, `textValue`, `description` and `ref`, as on Menu.Item.
|
|
229
|
+
|
|
230
|
+
Native props: HTML element.
|
|
220
231
|
|
|
221
232
|
### Menu.CheckboxItem
|
|
222
233
|
|
|
@@ -230,7 +241,9 @@ An independent on/off option; a check mark shows while it is on.
|
|
|
230
241
|
| `disabled` | `boolean` | `false` | The item stays in place, dimmed, but cannot be toggled. |
|
|
231
242
|
| `closeOnClick` | `boolean` | `false` | Close the menu after toggling; off by default, so several options can change. |
|
|
232
243
|
|
|
233
|
-
Also `className`, `
|
|
244
|
+
Also `className`, `start`, `children`, `textValue`, `description`, `shortcut`, `end` and `ref`, as on Menu.Item.
|
|
245
|
+
|
|
246
|
+
Native props: HTML element.
|
|
234
247
|
|
|
235
248
|
### ContextMenu
|
|
236
249
|
|
|
@@ -253,14 +266,16 @@ Native props: `<div>`.
|
|
|
253
266
|
|
|
254
267
|
### ThemeMenuRadioGroup
|
|
255
268
|
|
|
256
|
-
The theme choice for a Menu: System, Light and Dark as radio items. Inside a ThemePreferenceProvider it shows and
|
|
269
|
+
The theme choice for a Menu: System, Light and Dark as radio items. Inside a ThemePreferenceProvider it shows and changes the provider's preference; value and onValueChange connect it to a preference outside one.
|
|
257
270
|
|
|
258
271
|
| Prop | Type | Default | Description |
|
|
259
272
|
| --- | --- | --- | --- |
|
|
260
273
|
| `value` | `'light' \| 'dark' \| 'system'` | `the nearest ThemePreferenceProvider's preference` | The chosen preference: system, light or dark. |
|
|
261
|
-
| `onValueChange` | `(value: ThemePreference) => void` | `the nearest ThemePreferenceProvider's setPreference
|
|
274
|
+
| `onValueChange` | `(value: ThemePreference) => void` | `the nearest ThemePreferenceProvider's setPreference` | Called with the preference chosen, for a group outside a ThemePreferenceProvider. |
|
|
262
275
|
| `label` | `ReactNode` | — | A small heading above the choices, which names the group. Leave it out inside a submenu, which its row already names. |
|
|
263
|
-
| `closeOnClick` | `boolean` | `false` | Close the menu after a choice. Off by default, so people see the theme change with the menu still open. |
|
|
276
|
+
| `closeOnClick` | `boolean` | `false` | Close the menu after a choice. Off by default, so people see the theme change with the menu still open. It applies to the choices given as children too, unless one sets its own. |
|
|
277
|
+
| `children` | `ReactNode` | — | The choices, as Menu.RadioItems valued system, light or dark, in place of the three default ones: such as Light and Dark alone, or a choice with a hint beside it. |
|
|
278
|
+
| `className` | `string` | — | The group's class, beside env-menu-group. |
|
|
264
279
|
|
|
265
280
|
Also `aria-labelledby`, as on Menu.RadioGroup.
|
|
266
281
|
|
|
@@ -278,6 +293,7 @@ Also `aria-labelledby`, as on Menu.RadioGroup.
|
|
|
278
293
|
- `env-menu-item-indicator-slot`: The place for a chosen item's check.
|
|
279
294
|
- `env-menu-item-label`: An item's label.
|
|
280
295
|
- `env-menu-item-shortcut`: An item's keyboard shortcut.
|
|
296
|
+
- `env-menu-item-start`: The slot of the content before an item's label, such as an icon or an Avatar.
|
|
281
297
|
- `env-menu-item-text`: The column with an item's label and description.
|
|
282
298
|
- `env-menu-positioner`: The menu's positioner.
|
|
283
299
|
- `env-menu-separator`: The line between groups.
|
|
@@ -296,7 +312,7 @@ Each sets a color of one instance, through `style` or CSS; its hover, focus and
|
|
|
296
312
|
|
|
297
313
|
- `--env-menu-item-container`: The item's fill; the highlight and press are state layers over it.
|
|
298
314
|
- `--env-menu-item-content`: The label, and the color of the state layers.
|
|
299
|
-
- `--env-menu-item-icon`: The
|
|
315
|
+
- `--env-menu-item-icon`: The content before the label, such as its icon.
|
|
300
316
|
|
|
301
317
|
## Strings
|
|
302
318
|
|
|
@@ -86,14 +86,15 @@ One menu of a Menubar.Root: a small text trigger and the menu that opens below i
|
|
|
86
86
|
|
|
87
87
|
| Prop | Type | Default | Description |
|
|
88
88
|
| --- | --- | --- | --- |
|
|
89
|
-
| `label` (required) | `ReactNode` | — | The trigger's text, such as File. |
|
|
90
|
-
| `accessKey` | `string` | — | A letter of the label, such as F for File. With Menubar.Root's accessKeys, holding Alt underlines it and Alt with the letter opens the menu. |
|
|
89
|
+
| `label` (required) | `ReactNode` | — | The trigger's text, such as File, or content such as an icon beside the text. |
|
|
90
|
+
| `accessKey` | `string` | — | A letter of the label, such as F for File. With Menubar.Root's accessKeys, holding Alt underlines it, in the label's text also beside an icon or inside an element such as a span, and Alt with the letter opens the menu. |
|
|
91
|
+
| `triggerProps` | `TriggerProps` | — | Attributes of the trigger button, such as a className, a style, a ref or a data attribute; the menu's own className, style and ref are its popup's. |
|
|
91
92
|
| `children` (required) | `ReactNode` | — | The menu's items: Menu.Item, Menu.Submenu, Menu.Separator and the other menu parts. |
|
|
92
93
|
| `aria-label` | `string` | — | Accessible name of the menu; by default the label, when it is a string. |
|
|
93
94
|
| `disabled` | `boolean` | `false` | The trigger stays in place, dimmed, but doesn't open its menu. |
|
|
94
95
|
| `open` | `boolean` | — | Controlled visibility. |
|
|
95
96
|
| `defaultOpen` | `boolean` | `false` | Whether an uncontrolled menu starts open; closed by default. |
|
|
96
|
-
| `onOpenChange` | `(open: boolean, details:
|
|
97
|
+
| `onOpenChange` | `(open: boolean, details: OpenChangeDetails) => void` | — | Called when the menu opens or closes, with the element that had focus before the menubar took it. |
|
|
97
98
|
| `className` | `string` | — | Class of the menu popup. |
|
|
98
99
|
| `ref` | `Ref<HTMLDivElement>` | — | The menu popup's ref; the trigger is the menubar's own. |
|
|
99
100
|
| `style` | `CSSProperties` | — | The menu popup's inline style. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Message
|
|
3
|
-
summary:
|
|
3
|
+
summary: 'Chat messages: yours as bubbles, others at full width.'
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Text & content
|
|
@@ -34,6 +34,7 @@ examples: # Each file is examples/message/<Name>.tsx.
|
|
|
34
34
|
FormattedAnswer: variants
|
|
35
35
|
MessageAnatomy: anatomy
|
|
36
36
|
DeliveryStatus: example
|
|
37
|
+
CommentThread: example
|
|
37
38
|
BubbleWidth: example
|
|
38
39
|
---
|
|
39
40
|
|
|
@@ -60,6 +61,10 @@ examples: # Each file is examples/message/<Name>.tsx.
|
|
|
60
61
|
|
|
61
62
|
Example: DeliveryStatus.
|
|
62
63
|
|
|
64
|
+
### Avatars and rich authors
|
|
65
|
+
|
|
66
|
+
Example: CommentThread.
|
|
67
|
+
|
|
63
68
|
### Adapting to width
|
|
64
69
|
|
|
65
70
|
Example: BubbleWidth.
|
|
@@ -81,25 +86,23 @@ One entry of a conversation, such as a chat message or a comment, as an article:
|
|
|
81
86
|
| Prop | Type | Default | Description |
|
|
82
87
|
| --- | --- | --- | --- |
|
|
83
88
|
| `from` (required) | `'self' \| 'other'` | — | self: written by the person using the app, a compact bubble at the inline end. other: from anyone else, such as an assistant or another participant, full-width content without a bubble. |
|
|
84
|
-
| `author` | `
|
|
89
|
+
| `author` | `ReactNode` | — | Who wrote the message, such as a name, shown above it at weight 500, or content such as a link to their profile with a Bot or Owner Badge. Leave it out where the conversation makes it clear, such as on your own messages in a conversation with one person. |
|
|
90
|
+
| `start` | `ReactNode` | — | Content beside the message, at its inline start, placed as given, such as the author's Avatar or an assistant's mark, in a column of its own beside the header and the content. |
|
|
85
91
|
| `meta` | `ReactNode` | — | Supporting facts beside the author, in the muted color, such as the time or a RelativeTime. |
|
|
86
92
|
| `actions` | `ReactNode` | — | Small actions below the message, such as Copy or Try again: buttons without a variant or size of their own are small ghost buttons, at the inline end for your own messages. false and null count as absent. |
|
|
87
|
-
| `status` | `'sending' \| 'failed'` | — | A message on its way, sending, with a spinner and Sending;
|
|
88
|
-
| `statusLabel` | `
|
|
89
|
-
| `children`
|
|
93
|
+
| `status` | `'sending' \| 'failed' \| 'working'` | — | A message on its way, sending, with a spinner and Sending; one that could not be sent, failed, with an error icon and Not sent in the danger tone and, on your own message, a red outline around the bubble; or a reply still being written, working, with a spinner and Working, such as an agent's while it runs, last in a MessageList with aria-busy. Without it the message is sent. |
|
|
94
|
+
| `statusLabel` | `ReactNode` | `'Sending', 'Not sent' or 'Working'` | The content beside the status icon, such as "Could not deliver", a sentence with a Try again link or the step a reply is on, Running tests…. It overrides EnvUIProvider's `messages.message.sending`, `.failed` and `.working`. |
|
|
95
|
+
| `children` | `ReactNode` | — | The message. Plain text keeps its line breaks; formatted content, such as Markdown, fills the width of a message from someone else. A working message shows the reply streamed so far, or only its status while it is empty. |
|
|
90
96
|
| `skeleton` | `boolean` | `false` | Shows it and its content as a busy skeleton while that loads; turning it on or off renders the content anew. |
|
|
91
97
|
|
|
92
98
|
Native props: HTML element.
|
|
93
99
|
|
|
94
100
|
### MessageList
|
|
95
101
|
|
|
96
|
-
The messages of a conversation in order, as a log: assistive technology politely announces messages added anywhere in it and text that changes.
|
|
102
|
+
The messages of a conversation in order, as a log: assistive technology politely announces messages added anywhere in it and text that changes. While a reply is on its way or streams in, set aria-busy, so assistive technology waits for it to finish instead of announcing every step, and show it as a Message with status working, last. Set follow where the list scrolls by itself. Name it with aria-label or aria-labelledby.
|
|
97
103
|
|
|
98
104
|
| Prop | Type | Default | Description |
|
|
99
105
|
| --- | --- | --- | --- |
|
|
100
|
-
| `busy` | `boolean` | `false` | A reply is on its way or streaming in: after the last message, where the reply will show, a row with the busy author, a quiet spinner and Working in the muted color; and the log reports aria-busy, so assistive technology can wait for the reply to finish instead of announcing every step. |
|
|
101
|
-
| `busyAuthor` | `string` | — | Who the reply on its way comes from, such as Agent, named on the busy row as a message's author. |
|
|
102
|
-
| `busyLabel` | `string` | `'Working'` | The text beside the busy spinner, such as "Thinking". It overrides EnvUIProvider's `messages.message.working`. |
|
|
103
106
|
| `follow` | `boolean` | `false` | The list scrolls by itself and follows the conversation: it fills the height its container gives it, opens at the latest message and keeps the latest in view while the reader is at the end. Once they scroll away and more arrives, a Jump to latest button shows at its foot, which scrolls back to the end. |
|
|
104
107
|
| `jumpToLatestLabel` | `string` | `'Jump to latest'` | The text of the Jump to latest button of a list that follows. It overrides EnvUIProvider's `messages.message.jumpToLatest`. |
|
|
105
108
|
|
|
@@ -115,16 +118,17 @@ Native props: `<div>`.
|
|
|
115
118
|
- `env-message-content`: The slot of the message's content, in a bubble on your own messages.
|
|
116
119
|
- `env-message-header`: The row with the author and the meta.
|
|
117
120
|
- `env-message-meta`: The slot of the time or another fact about the message.
|
|
118
|
-
- `env-message-
|
|
121
|
+
- `env-message-start`: The slot of the content beside the message at its inline start, such as the author's avatar.
|
|
122
|
+
- `env-message-status`: The sending, failed or working status.
|
|
119
123
|
- `env-message-text`: Content given as plain text, which keeps its line breaks.
|
|
120
124
|
- `data-env-skeleton`: any value, or present, on `env-message`, `env-message-author`, `env-message-header`, `env-message-meta`
|
|
121
125
|
- `data-from`: `other`, `self`
|
|
122
|
-
- `data-
|
|
126
|
+
- `data-start`: present
|
|
127
|
+
- `data-status`: `failed`, `sending`, `working`
|
|
123
128
|
|
|
124
129
|
### MessageList
|
|
125
130
|
|
|
126
131
|
- `env-message-list`: The list of messages.
|
|
127
|
-
- `env-message-list-busy`: The row after the last message while busy: the busy author, a spinner and Working.
|
|
128
132
|
- `env-message-list-jump`: The place of the Jump to latest button at the foot of a list that follows.
|
|
129
133
|
- `data-follow`: present
|
|
130
134
|
|
|
@@ -136,5 +140,5 @@ EnvUIProvider's `messages` overrides each, and a component's own label prop wins
|
|
|
136
140
|
| --- | --- | --- |
|
|
137
141
|
| `messages.message.sending` | `"Sending"` | The status of a message on its way. |
|
|
138
142
|
| `messages.message.failed` | `"Not sent"` | The status of a message that could not be sent. |
|
|
139
|
-
| `messages.message.working` | `"Working"` |
|
|
143
|
+
| `messages.message.working` | `"Working"` | The status of a reply still being written, beside its spinner. |
|
|
140
144
|
| `messages.message.jumpToLatest` | `"Jump to latest"` | The button of a MessageList that follows, shown once newer messages arrive out of view. |
|
package/docs/components/meter.md
CHANGED
|
@@ -20,13 +20,12 @@ avoidWhen:
|
|
|
20
20
|
use: Progress
|
|
21
21
|
- text: A value people set within a range, such as a volume or a limit.
|
|
22
22
|
use: Slider
|
|
23
|
-
- text: A score on a scale of stars, such as a review's 4.5 out of 5.
|
|
24
|
-
use: Rating
|
|
25
23
|
components:
|
|
26
24
|
- Meter
|
|
27
25
|
examples: # Each file is examples/meter/<Name>.tsx.
|
|
28
26
|
SeatsAssigned: overview
|
|
29
27
|
MeterAnatomy: anatomy
|
|
28
|
+
InlineUsage: example
|
|
30
29
|
LongLabel: example
|
|
31
30
|
---
|
|
32
31
|
|
|
@@ -42,6 +41,10 @@ examples: # Each file is examples/meter/<Name>.tsx.
|
|
|
42
41
|
|
|
43
42
|
## Behaviour
|
|
44
43
|
|
|
44
|
+
### On one line
|
|
45
|
+
|
|
46
|
+
Example: InlineUsage.
|
|
47
|
+
|
|
45
48
|
### Adapting to width
|
|
46
49
|
|
|
47
50
|
Example: LongLabel.
|
|
@@ -63,7 +66,8 @@ A measurement within a known range, such as the seats assigned of a plan or the
|
|
|
63
66
|
| Prop | Type | Default | Description |
|
|
64
67
|
| --- | --- | --- | --- |
|
|
65
68
|
| `value` (required) | `number` | — | The measurement, between min and max. A value outside the range shows, and is reported, as the nearest end. |
|
|
66
|
-
| `
|
|
69
|
+
| `layout` | `'stacked' \| 'inline'` | `'stacked'` | stacked puts the label and the value on a row above the bar; inline puts the label, the bar and the value on one line, as in a table's usage column or a list row. |
|
|
70
|
+
| `label` | `ReactNode` | — | What the bar shows, such as Seats assigned; it shows with the bar and names it. Leave it out for a bare bar named with aria-label or aria-labelledby, such as by the name beside it in a row; without a label or valueText the bar has no row above it. |
|
|
67
71
|
| `min` | `number` | `0` | The low end of the range. |
|
|
68
72
|
| `max` | `number` | `100` | The high end of the range. |
|
|
69
73
|
| `valueText` | `ReactNode` | — | The value as text at the end of the label's row, formatted by the application, such as 2 of 5 or 40%. Without it, no value shows. |
|
|
@@ -79,3 +83,4 @@ Native props: `<div>`.
|
|
|
79
83
|
- `env-meter-label`: The label.
|
|
80
84
|
- `env-meter-track`: The track.
|
|
81
85
|
- `env-meter-value`: The value as text.
|
|
86
|
+
- `data-layout`: `inline`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: MonthPicker
|
|
3
|
-
summary: A field
|
|
3
|
+
summary: A field for picking a month from a view of the year.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -84,6 +84,7 @@ A field for a month of a year that shows the value in the reader's locale and op
|
|
|
84
84
|
|
|
85
85
|
| Prop | Type | Default | Description |
|
|
86
86
|
| --- | --- | --- | --- |
|
|
87
|
+
| `onOpenChange` | `(open: boolean, details: MonthPickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the popup opens or closes. |
|
|
87
88
|
| `value` | `string \| null` | — | The value: a month as YYYY-MM. null, or an empty string, for none. |
|
|
88
89
|
| `defaultValue` | `string \| null` | `null` | The value an uncontrolled field starts with, and that a form reset restores; none by default. |
|
|
89
90
|
| `onValueChange` | `(value: string \| null) => void` | — | Receives the new value as YYYY-MM, or null once the field is cleared. |
|
|
@@ -105,7 +106,8 @@ A field for a month of a year that shows the value in the reader's locale and op
|
|
|
105
106
|
| `clearable` | `boolean` | `false` | A clear button in the field and in the popup removes the value. |
|
|
106
107
|
| `open` | `boolean` | — | Whether the popup is open; with `onOpenChange` it controls it. |
|
|
107
108
|
| `defaultOpen` | `boolean` | `false` | Whether an uncontrolled popup starts open; closed by default. |
|
|
108
|
-
| `
|
|
109
|
+
| `popupHeader` | `ReactNode` | — | Content at the top of the popup, above the calendar or the list, such as presets: buttons for Tomorrow or Next Monday that set the value, from a field the application controls. |
|
|
110
|
+
| `popupFooter` | `ReactNode` | — | Content in the popup's footer, after its shortcut to the current date or time and before Clear, such as a note of the time zone or another action. |
|
|
109
111
|
| `label` | `ReactNode` | — | The field's visible name, above the field, such as Project name; it also names the control for assistive technology. |
|
|
110
112
|
| `description` | `ReactNode` | — | Lasting guidance under the field, such as a format or a limit, linked to the control as its description. |
|
|
111
113
|
| `error` | `ReactNode` | — | A message under the field that says how to correct the value. While it is set, the control is invalid (aria-invalid) and the message joins its description, after the description. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: NavigationDrawer
|
|
3
|
-
summary: An
|
|
3
|
+
summary: An app's main navigation, shown as a drawer, a rail or a bar depending on the window width.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Navigation
|
|
@@ -62,6 +62,8 @@ examples: # Each file is examples/navigation-drawer/<Name>.tsx.
|
|
|
62
62
|
TabletDestinations: { role: overview, caption: "NavigationRail: each destination an icon above a short label, for a tablet." }
|
|
63
63
|
PhoneDestinations: { role: overview, caption: "NavigationBar: three to five destinations along the bottom of a phone." }
|
|
64
64
|
GuideSections: example
|
|
65
|
+
ActivityBar: example
|
|
66
|
+
GroupActions: example
|
|
65
67
|
DrawerAnatomy: anatomy
|
|
66
68
|
RailAnatomy: anatomy
|
|
67
69
|
BarAnatomy: anatomy
|
|
@@ -81,6 +83,14 @@ examples: # Each file is examples/navigation-drawer/<Name>.tsx.
|
|
|
81
83
|
|
|
82
84
|
Example: GuideSections.
|
|
83
85
|
|
|
86
|
+
### Icons with tooltips
|
|
87
|
+
|
|
88
|
+
Example: ActivityBar.
|
|
89
|
+
|
|
90
|
+
### Actions beside a group
|
|
91
|
+
|
|
92
|
+
Example: GroupActions.
|
|
93
|
+
|
|
84
94
|
## Anatomy
|
|
85
95
|
|
|
86
96
|
1. **NavigationDrawer** (`env-navigation-drawer`)
|
|
@@ -169,6 +179,7 @@ The navigation drawer for expanded and larger windows: a column at the window's
|
|
|
169
179
|
| `onExpandedChange` | `(expanded: string[]) => void` | — | Receives the open sections, as in `expanded`, as one opens or closes, and as the current destination moves into a closed section, which opens. |
|
|
170
180
|
| `header` | `ReactNode` | — | Content above the destinations, such as the application's name or a search trigger. |
|
|
171
181
|
| `footer` | `ReactNode` | — | Content below the destinations, at the bottom of the drawer, such as the account's menu. |
|
|
182
|
+
| `groupEnd` | `(group: string) => ReactNode` | — | Content after a group's heading, outside it, such as an IconButton that adds a project to Projects, a Menu of the group's actions or a count. It keeps its size, and the heading gives way to it. |
|
|
172
183
|
| `headingLevel` | `Exclude<HeadingLevel, 1>` | `2` | The level of the groups' headings, which assistive technology lists with the page's headings: one below the heading the drawer sits under, such as 3 in a drawer under an h2. |
|
|
173
184
|
| `background` | `'default' \| 'page'` | `'default'` | The drawer's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
|
|
174
185
|
| `aria-label` | `string` | `messages.navigation.label, Main` | Names the navigation landmark, such as Main or Project; give each landmark of a page its own. |
|
|
@@ -193,6 +204,7 @@ The navigation rail for medium windows, such as tablets: a narrow column at the
|
|
|
193
204
|
| `header` | `ReactNode` | — | Content above the destinations, such as a button that opens a Sheet with the NavigationDrawer, or the main action of the page. |
|
|
194
205
|
| `footer` | `ReactNode` | — | Content at the bottom of the rail, such as the account's AvatarButton. |
|
|
195
206
|
| `background` | `'default' \| 'page'` | `'default'` | The rail's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
|
|
207
|
+
| `visibleLabel` | `boolean` | `true` | Whether the destinations' labels show under their icons. False shows the icons only, for an icon-only rail such as a code editor's activity bar: each label still names its destination and shows in a tooltip on hover and keyboard focus. |
|
|
196
208
|
|
|
197
209
|
Also `aria-label` and `skeleton`, as on NavigationDrawer.
|
|
198
210
|
|
|
@@ -206,6 +218,7 @@ The navigation bar for compact windows, such as phones: up to five destinations
|
|
|
206
218
|
| --- | --- | --- | --- |
|
|
207
219
|
| `destinations` (required) | `readonly Destination[]` | — | The application's destinations, the same array NavigationRail and NavigationDrawer take. Give the bar 3 to 5: past 5 it shows the first 4 and a More item that opens the rest in a menu. Groups and nested destinations don't show: a destination whose `children` hold the current one takes the current fill. |
|
|
208
220
|
| `background` | `'default' \| 'page'` | `'default'` | The bar's background, named as Surface's and Card's: default, the default surface color, the app frame's own fill that stands apart from the page; page, the page's background, the same as the content beside it, from which a Scaffold sets it apart with a hairline. On a surface, such as a Sheet, both take the surface's color. |
|
|
221
|
+
| `visibleLabel` | `boolean` | `true` | Whether the destinations' labels show under their icons. False shows the icons only, for an icon-only bar such as a code editor's activity bar: each label still names its destination and shows in a tooltip on hover and keyboard focus. |
|
|
209
222
|
|
|
210
223
|
Also `aria-label` and `skeleton`, as on NavigationDrawer.
|
|
211
224
|
|
|
@@ -223,7 +236,9 @@ Native props: `<nav>`.
|
|
|
223
236
|
- `env-navigation-drawer-count`: A destination's count, at the item's end; 999+ above 999.
|
|
224
237
|
- `env-navigation-drawer-end`: The slot of a destination's own controls at the end of its row, outside its link or button.
|
|
225
238
|
- `env-navigation-drawer-footer`: The slot of the content below the destinations, at the bottom of the drawer.
|
|
239
|
+
- `env-navigation-drawer-group-end`: The slot of the content after a group's heading, outside it.
|
|
226
240
|
- `env-navigation-drawer-group-label`: A group's label, which names the group's list.
|
|
241
|
+
- `env-navigation-drawer-group-row`: A group's heading with the content after it, in one row.
|
|
227
242
|
- `env-navigation-drawer-header`: The slot of the content above the destinations, such as the application's name or a search trigger.
|
|
228
243
|
- `env-navigation-drawer-item`: A destination: a link or button as wide as the drawer, with its icon, label and count.
|
|
229
244
|
- `env-navigation-drawer-label`: A destination's label.
|
|
@@ -234,6 +249,8 @@ Native props: `<nav>`.
|
|
|
234
249
|
- `env-navigation-drawer-toggle`: The button at the end of a section's link that opens and closes the section.
|
|
235
250
|
- `data-background`: `default`, `page`
|
|
236
251
|
- `data-current`: any value, or present, on `env-navigation-drawer-item`
|
|
252
|
+
- `data-disabled`: any value, or present, on `env-navigation-drawer-item`
|
|
253
|
+
- `data-dot`: any value, or present, on `env-navigation-drawer-count`
|
|
237
254
|
- `data-ending-style`: any value, or present, on `env-navigation-drawer-children`
|
|
238
255
|
- `data-env-skeleton`: any value, or present
|
|
239
256
|
- `data-resizable`: present
|
|
@@ -245,18 +262,22 @@ Native props: `<nav>`.
|
|
|
245
262
|
- `env-navigation-rail-count`: A destination's count, on the icon's top end; 999+ above 999.
|
|
246
263
|
- `env-navigation-rail-footer`: The slot of the content at the bottom of the rail, such as the account's button.
|
|
247
264
|
- `env-navigation-rail-header`: The slot of the content above the destinations, such as a button that opens the drawer or the main action.
|
|
248
|
-
- `env-navigation-rail-indicator`: The
|
|
249
|
-
- `env-navigation-rail-item`: A destination: a link or button
|
|
265
|
+
- `env-navigation-rail-indicator`: The box around a destination's icon, which holds its count.
|
|
266
|
+
- `env-navigation-rail-item`: A destination: a link or button, its icon above its label. The current one takes the selected fill and a semibold label, as a navigation drawer's current row does.
|
|
250
267
|
- `env-navigation-rail-label`: A destination's short label, under its indicator.
|
|
251
268
|
- `env-navigation-rail-list`: The list of destinations, one under another, which scrolls where the rail is shorter.
|
|
252
269
|
- `data-background`: `default`, `page`
|
|
253
270
|
- `data-current`: any value, or present, on `env-navigation-rail-item`
|
|
271
|
+
- `data-disabled`: any value, or present, on `env-navigation-rail-item`
|
|
272
|
+
- `data-dot`: any value, or present, on `env-navigation-rail-count`
|
|
254
273
|
- `data-env-skeleton`: any value, or present
|
|
274
|
+
- `data-label-hidden`: present
|
|
255
275
|
|
|
256
276
|
### NavigationBar
|
|
257
277
|
|
|
258
278
|
- `env-navigation-bar`: The navigation bar: a nav landmark across the bottom of a compact window.
|
|
259
279
|
- `env-navigation-bar-count`: A destination's count, on the icon's top end; 999+ above 999.
|
|
280
|
+
- `env-navigation-bar-dot`: The dot at the end of a menu item in More whose destination has something new and no count.
|
|
260
281
|
- `env-navigation-bar-indicator`: The rounded rectangle around a destination's icon, filled while the destination is current.
|
|
261
282
|
- `env-navigation-bar-item`: A destination: a link or button with its indicator above its label.
|
|
262
283
|
- `env-navigation-bar-label`: A destination's label, under its indicator, cut short with an ellipsis.
|
|
@@ -264,7 +285,10 @@ Native props: `<nav>`.
|
|
|
264
285
|
- `env-navigation-bar-more`: The last item past five destinations, which opens the rest in a menu.
|
|
265
286
|
- `data-background`: `default`, `page`
|
|
266
287
|
- `data-current`: present, on `env-navigation-bar-item`
|
|
288
|
+
- `data-disabled`: any value, or present, on `env-navigation-bar-item`
|
|
289
|
+
- `data-dot`: any value, or present, on `env-navigation-bar-count`
|
|
267
290
|
- `data-env-skeleton`: any value, or present
|
|
291
|
+
- `data-label-hidden`: present
|
|
268
292
|
|
|
269
293
|
## Color properties
|
|
270
294
|
|
|
@@ -280,11 +304,11 @@ Each sets a color of one instance, through `style` or CSS; its hover, focus and
|
|
|
280
304
|
|
|
281
305
|
### NavigationRail
|
|
282
306
|
|
|
283
|
-
- `--env-navigation-rail-item-container`:
|
|
284
|
-
- `--env-navigation-rail-item-content`: The label, and the color of the state layers.
|
|
307
|
+
- `--env-navigation-rail-item-container`: A destination's fill at rest; set, it takes state layers instead of the navigation's designed hover and press fills.
|
|
308
|
+
- `--env-navigation-rail-item-content`: The label of a destination that is not current, and the color of the state layers.
|
|
285
309
|
- `--env-navigation-rail-item-icon`: The icon of a destination that is not current.
|
|
286
|
-
- `--env-navigation-rail-item-selected`: The
|
|
287
|
-
- `--env-navigation-rail-item-selected-content`: The icon of the current destination.
|
|
310
|
+
- `--env-navigation-rail-item-selected`: The fill of the current destination.
|
|
311
|
+
- `--env-navigation-rail-item-selected-content`: The icon and label of the current destination.
|
|
288
312
|
|
|
289
313
|
### NavigationBar
|
|
290
314
|
|
|
@@ -302,6 +326,7 @@ EnvUIProvider's `messages` overrides each, and a component's own label prop wins
|
|
|
302
326
|
| --- | --- | --- |
|
|
303
327
|
| `messages.navigation.label` | `"Main"` | Names the navigation landmark where the application gives it no name of its own. |
|
|
304
328
|
| `messages.navigation.itemCount` | `({ label, count }) => string` | Names a destination with a count, such as Inbox, 3 new. |
|
|
329
|
+
| `messages.navigation.itemNew` | `({ label }) => string` | Names a destination with something new and no count, shown as a dot, such as Activity, new. |
|
|
305
330
|
| `messages.navigation.more` | `"More"` | Labels the NavigationBar's last item, which opens the destinations that don't fit in a menu. |
|
|
306
331
|
| `messages.navigation.moreCurrent` | `({ name }) => string` | Names the NavigationBar's More item while its menu holds the current destination, after its name with any count, such as More, 5 new, current page inside. |
|
|
307
332
|
| `messages.navigation.contents` | `({ label }) => string` | Names the button beside a NavigationDrawer destination that opens and closes the destinations nested under it, such as Guides contents; its aria-expanded says whether they show. |
|
package/docs/components/page.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Page
|
|
3
|
-
summary: The column a page
|
|
3
|
+
summary: The content column of a page, below its title and actions.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -30,7 +30,7 @@ avoidWhen:
|
|
|
30
30
|
use: Scaffold
|
|
31
31
|
- text: The application's bar across every page, with its name and account menu.
|
|
32
32
|
use: TopBar
|
|
33
|
-
- text: Two panes side by side, such as a
|
|
33
|
+
- text: Two panes side by side, such as a document and its details.
|
|
34
34
|
use: Panes
|
|
35
35
|
components:
|
|
36
36
|
- Page
|
|
@@ -101,7 +101,7 @@ The column a page's content sits in: invisible structure that never paints, cent
|
|
|
101
101
|
| `width` | `'sm' \| 'md' \| 'lg' \| 'full'` | `'lg'` | How wide the content may grow, a readable width: sm (40 rem) for a form or a settings page, md (60 rem) for a document or a detail page, lg (76 rem) for a dashboard or a list, full for content that uses the whole width, such as a board. The column is centered in the space it has. |
|
|
102
102
|
| `header` | `ReactNode` | — | The page's heading, usually a PageHeader, at the top of the same column. |
|
|
103
103
|
| `gutter` | `boolean` | `true` | Pads the column at its inline edges with the page gutter, which follows the window class of the region the page sits in: 1 rem in a compact one, 1.5 rem from medium. False leaves the edges to the content, such as a page that is one full-bleed table. |
|
|
104
|
-
| `name` | `string` | — | A name for this node, such as "settings",
|
|
104
|
+
| `name` | `string` | — | A name for this node, such as "settings", for the application's styles and tests to find it by; it renders as `data-env-name`. |
|
|
105
105
|
| `render` | `ReactElement` | — | The element to render, for its meaning, such as render={<article />}; a div by default. The page's class and attributes merge into its props. |
|
|
106
106
|
| `children` | `ReactNode` | — | The page's content, under its header. |
|
|
107
107
|
|
|
@@ -124,6 +124,7 @@ The heading of a page: its title with an optional trail above it, a description,
|
|
|
124
124
|
| `sticky` | `boolean` | `false` | Keeps the header in view at the top of the area that scrolls, over the content that scrolls under it: under a Scaffold's top bar where the document scrolls, or at the top of a Scaffold's body that scrolls. As a Page's header, what scrolls into view below it, such as a field taking focus, keeps clear of it: the header measures its height, which CSS reckons from its rows until script runs. |
|
|
125
125
|
| `controlSize` | `'sm' \| 'md'` | `'md'` | The size of the buttons and icon buttons in `actions` and `toolbar` that set none: sm for a dense page, such as one in a small window, or md. Give fields in the toolbar the same `size`. |
|
|
126
126
|
| `focusOnNavigation` | `boolean` | `true` | In a Scaffold, moves focus to the title of a level 1 header when the page changes: as a new page's header mounts after the Scaffold first showed, not as a title changes. People using a screen reader then hear the new page, and the next Tab starts from it. Focus moved there shows no ring, and focus in a field or an open overlay stays where it is. False leaves focus to the application. |
|
|
127
|
+
| `children` | `ReactNode` | — | More rows under the toolbar, placed as given, such as a progress strip or an inline Alert. They stay in the header, so they stick with it. |
|
|
127
128
|
|
|
128
129
|
Native props: `<div>`.
|
|
129
130
|
|
package/docs/components/pager.md
CHANGED
|
@@ -46,7 +46,7 @@ Example: ComposedParts.
|
|
|
46
46
|
|
|
47
47
|
1. **Pager** (`env-pager`)
|
|
48
48
|
2. **Link** (`env-pager-link-previous`, `previous`)
|
|
49
|
-
3. **
|
|
49
|
+
3. **Start** (`env-pager-link-start`, `start`)
|
|
50
50
|
4. **Direction** (`env-pager-link-label`)
|
|
51
51
|
5. **Title** (`env-pager-link-title`, `children`)
|
|
52
52
|
|
|
@@ -72,7 +72,7 @@ import { Pager } from '@envsemble/envui';
|
|
|
72
72
|
|
|
73
73
|
### Pager.Root
|
|
74
74
|
|
|
75
|
-
A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous and Pager.Next children; either one can be left out, and without any it renders nothing.
|
|
75
|
+
A centered pair of previous and next destinations in a navigation landmark, its Pager.Previous and Pager.Next children; either one can be left out, and without any it renders nothing. Where the two don't fit side by side, they stack as rows of the pager's width, the previous first.
|
|
76
76
|
|
|
77
77
|
| Prop | Type | Default | Description |
|
|
78
78
|
| --- | --- | --- | --- |
|
|
@@ -83,32 +83,42 @@ Native props: `<nav>`.
|
|
|
83
83
|
|
|
84
84
|
### Pager.Previous
|
|
85
85
|
|
|
86
|
-
The destination before this one: a native link with rel="prev", its title under the label Previous (EnvUIProvider's messages.pager.previous), and
|
|
86
|
+
The destination before this one: a native link with rel="prev", its title under the label Previous (EnvUIProvider's messages.pager.previous), and optional content before them, its start. It also stands alone, outside Pager.Root.
|
|
87
87
|
|
|
88
88
|
| Prop | Type | Default | Description |
|
|
89
89
|
| --- | --- | --- | --- |
|
|
90
90
|
| `href` (required) | `string` | — | The destination; the link renders through the LinkProvider's link component. |
|
|
91
91
|
| `children` (required) | `ReactNode` | — | The destination's title, such as the name of the next page. It shows below the direction label, wraps between words, and names the link after the label. |
|
|
92
|
-
| `icon` | `ReactNode` | — | A decorative icon, such as ArrowBack, before the previous destination's text, or such as ArrowForward, after the next one's; none by default. |
|
|
93
92
|
| `rel` | `string` | `'prev' on Pager.Previous, 'next' on Pager.Next` | The link's relation to this page. |
|
|
93
|
+
| `label` | `ReactNode` | `'Previous' or 'Up next', or EnvUIProvider's messages.pager.previous or next` | The direction label above the title, such as Previous chapter or Back to setup, for this link alone; null leaves it out. |
|
|
94
|
+
| `start` | `ReactNode` | — | Content before the text, such as IconArrowBack: an envUI icon takes the pager's icon size and other content keeps its own. It is hidden from assistive technology; none by default. |
|
|
94
95
|
|
|
95
96
|
Native props: `<a>`.
|
|
96
97
|
|
|
97
98
|
### Pager.Next
|
|
98
99
|
|
|
99
|
-
The destination after this one: a native link with rel="next", its title under the label Up next (EnvUIProvider's messages.pager.next), and
|
|
100
|
+
The destination after this one: a native link with rel="next", its title under the label Up next (EnvUIProvider's messages.pager.next), and optional content after them, its end. It also stands alone, outside Pager.Root.
|
|
100
101
|
|
|
101
|
-
|
|
102
|
+
| Prop | Type | Default | Description |
|
|
103
|
+
| --- | --- | --- | --- |
|
|
104
|
+
| `end` | `ReactNode` | — | Content after the text, such as IconArrowForward: an envUI icon takes the pager's icon size and other content keeps its own. It is hidden from assistive technology; none by default. |
|
|
105
|
+
|
|
106
|
+
Also `href`, `children`, `rel` and `label`, as on Pager.Previous.
|
|
107
|
+
|
|
108
|
+
Native props: `<a>`.
|
|
102
109
|
|
|
103
110
|
## Part names
|
|
104
111
|
|
|
105
112
|
- `env-pager`: The previous and next links.
|
|
106
113
|
- `env-pager-link`: One link.
|
|
107
114
|
- `env-pager-link-copy`: The column with a link's label and title.
|
|
115
|
+
- `env-pager-link-end`: The slot of the content after the next link's text, such as an icon.
|
|
108
116
|
- `env-pager-link-label`: A link's label, Previous or Next.
|
|
109
117
|
- `env-pager-link-next`: The link to the next page.
|
|
110
118
|
- `env-pager-link-previous`: The link to the previous page.
|
|
119
|
+
- `env-pager-link-start`: The slot of the content before the previous link's text, such as an icon.
|
|
111
120
|
- `env-pager-link-title`: The title of the page a link leads to.
|
|
121
|
+
- `data-stacked`: present
|
|
112
122
|
|
|
113
123
|
## Strings
|
|
114
124
|
|
|
@@ -62,15 +62,16 @@ Compact pagination for toolbars: the range of items shown, such as 1–60 of 245
|
|
|
62
62
|
| `pageSize` (required) | `number` | — | The most items a page shows, such as 60; at least 1. |
|
|
63
63
|
| `total` | `number` | — | All items, when known; the range then ends with it, as in 1–60 of 245, and the last page ends the list. Leave it out for a list read in batches, where hasNextPage says when it ends. |
|
|
64
64
|
| `hasNextPage` | `boolean` | `true` | Whether a later page exists, for a list without total, such as from a cursor's has more. |
|
|
65
|
-
| `onPageChange` (required) | `(page: number) => void` | — | Receives the page before or after the current one when its button is pressed. The application loads that page and passes it back as page. |
|
|
66
65
|
| `pending` | `boolean` | `false` | A page is loading: the button pressed shows a spinner, also when the load starts in an effect after the page changes, and both buttons ignore presses while staying focusable. A load for another reason, such as a refresh, makes both wait without a spinner. |
|
|
67
66
|
| `hideWhenSinglePage` | `boolean` | `false` | Render nothing while every item fits on one page, so neither button has anywhere to go. |
|
|
68
|
-
| `
|
|
67
|
+
| `renderRange` | `(range: PaginationRange) => ReactNode` | `1–60 of 245, or 61–120 without total, with numbers in the locale` | Draws the range from the first and last item shown, the total, the page and the page count, for one pager; EnvUIProvider's messages.pagination.range writes it for every pager. |
|
|
69
68
|
| `previousLabel` | `string` | `'Previous page', or EnvUIProvider's messages.pagination.previous` | The previous button's accessible name and tooltip. |
|
|
70
69
|
| `nextLabel` | `string` | `'Next page', or EnvUIProvider's messages.pagination.next` | The next button's accessible name and tooltip. |
|
|
71
70
|
| `variant` | `'primary' \| 'secondary' \| 'outline' \| 'ghost' \| 'text'` | `'ghost'` | The buttons' variant, as on IconButton: quiet neutral icon buttons by default. |
|
|
72
71
|
| `size` | `'sm' \| 'md' \| 'lg'` | — | The buttons' height, as on every control: sm, md or lg in the current scale. Without it, they take the control height of the container, md unless the container sets another. |
|
|
73
72
|
| `aria-label` | `string` | `'Pagination', or EnvUIProvider's messages.pagination.label` | The navigation landmark's name, such as Report pages, where a page has more than one. |
|
|
73
|
+
| `onPageChange` | `(page: number) => void` | — | Required when `pageHref` is not set. Receives the page before or after the current one when its button is pressed. The application loads that page and passes it back as page. Give it, or pageHref, or both. |
|
|
74
|
+
| `pageHref` | `(page: number) => string` | — | Required when `onPageChange` is not set. The address of a page, such as `?page=3`, for a list whose pages have their own URLs: the previous and next controls are then links, through the LinkProvider's link component, which open in a new tab, are crawlable and work before hydration. A control with no page to go to reports aria-disabled and has no destination. |
|
|
74
75
|
|
|
75
76
|
Native props: `<nav>`.
|
|
76
77
|
|