@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/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,263 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 3.0.1 — 2026-11-21
|
|
4
|
+
|
|
5
|
+
A patch release with one fix, to CodeBlock.
|
|
6
|
+
|
|
7
|
+
### Patch Changes
|
|
8
|
+
|
|
9
|
+
- CodeBlock: code that scrolls sideways now runs to the block's edges instead of being cut off at its padding, so scrolling no longer narrows what shows. At rest the code keeps the same inset, and the focus ring of the scrolling code sits inside the block.
|
|
10
|
+
|
|
11
|
+
## 3.0.0 — 2026-11-21
|
|
12
|
+
|
|
13
|
+
envUI 3.0 gives each place one name and leaves the application its own decisions. Components that belong to one kind of product leave the library (AnimatedNumber, CalendarHeatmap, DiffStat, Rating, MarkdownEditor, RichTextEditor and dev mode), content before a label is always `start`, and where a theme preference or a pane's width is kept is the application's call. Halo is new, a breathing halo that points at the one thing to look at next, and NavigationRail's current destination now looks like the drawer's current row. Each breaking change below says what to write instead.
|
|
14
|
+
|
|
15
|
+
### Major Changes
|
|
16
|
+
|
|
17
|
+
- AnimatedNumber leaves the library: a number that rolls to its new value is one effect, not a component every app needs.
|
|
18
|
+
|
|
19
|
+
Breaking changes:
|
|
20
|
+
|
|
21
|
+
- `AnimatedNumber` and `AnimatedNumberProps` are removed, with the parts `env-animated-number`, `env-animated-number-value` and `env-animated-number-previous` and their states `data-direction` (`up` and `down`) and `data-value`: write the number as plain text, such as `Show {total} tasks`. An app that wants it to roll animates it itself, timed by `--env-motion-duration-medium` and `--env-motion-ease-enter`, and only under `prefers-reduced-motion: no-preference`.
|
|
22
|
+
|
|
23
|
+
- CalendarHeatmap leaves the library: a calendar of daily counts is a code host's contribution grid, the application's to design.
|
|
24
|
+
|
|
25
|
+
Breaking changes:
|
|
26
|
+
|
|
27
|
+
- `CalendarHeatmap`, `CalendarHeatmapProps`, `CalendarHeatmapDay` and `CalendarHeatmapCell` are removed, with the parts `env-calendar-heatmap`, `env-calendar-heatmap-corner`, `env-calendar-heatmap-day`, `env-calendar-heatmap-grid`, `env-calendar-heatmap-month`, `env-calendar-heatmap-pad`, `env-calendar-heatmap-scroll`, `env-calendar-heatmap-swatch`, `env-calendar-heatmap-tooltip`, `env-calendar-heatmap-tooltip-positioner`, `env-calendar-heatmap-weekday` and `env-calendar-heatmap-legend`, their states `data-date`, `data-day`, `data-level`, `data-closed` and `data-tone` (`primary`, `accent`, `neutral`, `success`, `warning`, `danger` and `done`), and EnvUIProvider's `messages.calendarHeatmap`: an app that shows one builds its own, such as an element with `role="grid"` holding a `role="row"` per weekday, whose days are each a `role="gridcell"` inside a `<Tooltip>`, colored by mixing a tone's text color, such as `var(--env-color-fg-success)`, into `var(--env-color-bg-page)`.
|
|
28
|
+
|
|
29
|
+
- CommandPalette groups its items only as Select and Combobox do, in `{ label, items }` groups; an item's `group` key is removed.
|
|
30
|
+
|
|
31
|
+
Breaking changes:
|
|
32
|
+
|
|
33
|
+
- `CommandPaletteItem.group` is removed. Pass the groups in `items` or `suggestedItems`: `items={[{ label: 'Documents', items: documents }]}` in place of `items={documents.map((document) => ({ ...document, group: 'Documents' }))}`. A group with no items shows no heading.
|
|
34
|
+
- `CommandPaletteItem` reserves `items`: an entry with an `items` array is a group.
|
|
35
|
+
|
|
36
|
+
- Dev mode is removed. The lint rules, the contrast of the tokens and the components' accessibility already hold what its readout checked, and a page's layout is the browser's developer tools' to show.
|
|
37
|
+
|
|
38
|
+
Breaking changes:
|
|
39
|
+
|
|
40
|
+
- The entry point `@envsemble/envui/dev` is removed, with `installDevMode`, `layout`, `window.envui.layout`, the Alt+Shift+D view and the types `DevModeHandle`, `DevModeOptions`, `LayoutApi`, `LayoutAtResult`, `LayoutOptions`, `LayoutSize`, `LayoutProblem`, `LayoutProblemRule`, `PartsEntry`, `PartsFile` and `SkeletonShiftOptions`: delete the `import('@envsemble/envui/dev')` behind the development check. Lint with [`@envsemble/eslint-plugin-envui` and `@envsemble/stylelint-config-envui`](https://github.com/envsemble/envUI/blob/main/docs/setup.md), and inspect a page's layout in the browser's developer tools.
|
|
41
|
+
|
|
42
|
+
- DiffStat leaves the library: a change's line counts as one pill is one product's display, and CodeDiff's file header already shows them. `countDiffLines` from `@envsemble/envui/diff` still counts them.
|
|
43
|
+
|
|
44
|
+
Breaking changes:
|
|
45
|
+
|
|
46
|
+
- `DiffStat` and `DiffStatProps` are removed, with the parts `env-diff-stat`, `env-diff-stat-additions`, `env-diff-stat-deletions` and `env-diff-stat-label` and EnvUIProvider's `messages.diffStat`: write `<Badge>` with `+12` in `var(--env-color-fg-success)`, `−3` in `var(--env-color-fg-danger)` and `<VisuallyHidden>12 added lines and 3 removed lines</VisuallyHidden>`.
|
|
47
|
+
|
|
48
|
+
- DocumentTabs: a tab carries its item's `value` in `data-value`, the attribute named after that prop, and `onClose`, `onPin` and `onReorder` name what they receive `value` and `values`. See [DocumentTabs](https://github.com/envsemble/envUI/blob/main/docs/components/document-tabs.md).
|
|
49
|
+
|
|
50
|
+
Breaking changes:
|
|
51
|
+
|
|
52
|
+
- The state `data-tab-id` on `env-document-tabs-tab` is now `data-value`: select a tab with `.env-document-tabs-tab[data-value="…"]`.
|
|
53
|
+
|
|
54
|
+
- TopBar: its loading bar is the only one envUI renders, so `env-loading-bar` always lies along the top bar's edge and the part that said so goes. See [TopBar](https://github.com/envsemble/envUI/blob/main/docs/components/top-bar.md).
|
|
55
|
+
|
|
56
|
+
Breaking changes:
|
|
57
|
+
|
|
58
|
+
- The part `env-loading-bar-contained` is removed: select the bar with `.env-loading-bar`, or with `.env-top-bar-loading-bar` for TopBar's.
|
|
59
|
+
|
|
60
|
+
- MarkdownEditor is removed. An editor's storage format, toolbar, link picking and uploads are the application's decisions, so the editor is the application's own. `@envsemble/envui/markdown` keeps Markdown, which shows what was written in envUI's typography.
|
|
61
|
+
|
|
62
|
+
Breaking changes:
|
|
63
|
+
|
|
64
|
+
- `MarkdownEditor` is removed from `@envsemble/envui/markdown`, with the types `MarkdownEditorProps`, `MarkdownEditorActions`, `MarkdownEditorMode`, `MarkdownCommand`, `MarkdownLink` and `MarkdownLinkRequest`, the `markdownEditor`, `editor` and `linkDialog` messages, the parts `env-markdown-editor`, `env-markdown-editor-input`, `env-markdown-editor-view`, `env-markdown-editor-views` and `env-markdown-editor-write`, and the editor toolbar's `env-editor-toolbar` and `env-editor-status`. Write Markdown in a [Textarea](https://github.com/envsemble/envUI/blob/main/docs/components/text-field.md), or the application's own editor, and show it with [Markdown](https://github.com/envsemble/envUI/blob/main/docs/components/markdown.md), such as a SegmentedControl that switches between the two.
|
|
65
|
+
|
|
66
|
+
- MessageList: a reply on its way is a Message with `status="working"`, rendered last, with the list's `aria-busy` set while it streams in. It lines up with the other messages, takes the agent's Avatar in `start`, and a Stop button in its `actions` reaches the keyboard and assistive technology, which the hidden busy row did not. See [Message](https://github.com/envsemble/envUI/blob/main/docs/components/message.md).
|
|
67
|
+
|
|
68
|
+
Breaking changes:
|
|
69
|
+
|
|
70
|
+
- MessageList's `busy`, `busyAuthor` and `busyLabel` are removed, with the part `env-message-list-busy`: write `aria-busy={replying}` on the MessageList and, last in it, `<Message from="other" author="Agent" status="working" statusLabel="Thinking">{replySoFar}</Message>`.
|
|
71
|
+
|
|
72
|
+
- Pagination requires `onPageChange`, `pageHref` or both, so a pager that leads nowhere doesn't compile. See [Pagination](https://github.com/envsemble/envUI/blob/main/docs/components/pagination.md).
|
|
73
|
+
|
|
74
|
+
Breaking changes:
|
|
75
|
+
|
|
76
|
+
- `PaginationProps` is a type instead of an interface, a union of `onPageChange` and `pageHref`. An interface that extends it writes a type alias with an intersection instead.
|
|
77
|
+
- `TreeRowElementProps` is renamed `TreeItemElementProps`, the type of a Tree row's `itemProps`.
|
|
78
|
+
- `NavigationLabels` is removed: NavigationRail and NavigationBar take `visibleLabel={false}` in place of `labels="tooltip"`.
|
|
79
|
+
|
|
80
|
+
- One leading slot, `start`, holds the content before a label everywhere: Menu's items and submenus, a CommandPalette item, Button, Badge, TextField, a SegmentedControl item, a Tree item, a DocumentTabs tab, Pager.Previous and the rows of Combobox and Select; Button's and Pager.Next's `end` holds everything after their label. An envUI icon in either takes the icon size and other content, such as an Avatar, keeps its own; a menu widens its leading column only when some row's start holds more than an icon. A Combobox option's `start` renders through the row's start slot, at the size it had. See [Menu](https://github.com/envsemble/envUI/blob/main/docs/components/menu.md) and [Button](https://github.com/envsemble/envUI/blob/main/docs/components/button.md).
|
|
81
|
+
|
|
82
|
+
Breaking changes:
|
|
83
|
+
|
|
84
|
+
- `icon` on `Menu.Item`, `Menu.CheckboxItem`, `Menu.RadioItem` and `Menu.Submenu` is removed: write `start={<IconSettings />}`.
|
|
85
|
+
- A CommandPalette item's `icon` is removed: write `start: <IconSettings />`.
|
|
86
|
+
- Button's and ConfirmButton's `startIcon` is removed, with the part `env-button-start-icon`: write `start={<IconAdd />}`; the content is in `env-button-start`.
|
|
87
|
+
- Badge's `icon` is removed: write `start={<IconCheckCircle />}`, or `start={null}` for a done badge without its check mark. Assistive technology reads `start` unless the content hides itself, as an envUI icon without a label does.
|
|
88
|
+
- The part `env-list-row-icon` of the rows of Select, Combobox and CommandPalette is removed: the content before a row's name is in `env-list-row-start`.
|
|
89
|
+
- TextField's `startIcon` is removed, with the state `data-start-icon` on `env-text-field-control`: write `start={<IconMail />}`; the content is still in `env-text-field-start`, and the state is `data-start`.
|
|
90
|
+
- A SegmentedControl item's `icon` is removed, with the part `env-segmented-control-item-icon`: write `start: <IconViewList />`; the content is in `env-segmented-control-item-start`.
|
|
91
|
+
- A Tree item's `icon` is removed, with the part `env-tree-icon`: write `start: <IconFolder />`; the content is in `env-tree-start`.
|
|
92
|
+
- A DocumentTabs item's `icon` is removed: write `start: <IconDescription />`; the content is in `env-document-tabs-tab-start`.
|
|
93
|
+
- Pager.Previous's and Pager.Next's `icon` is removed: write `start={<IconArrowBack />}` on Pager.Previous and `end={<IconArrowForward />}` on Pager.Next; the content is in `env-pager-link-start` and `env-pager-link-end`. `Pager.LinkProps` no longer has `icon`, `Pager.PreviousProps` adds `start` to it and `Pager.NextProps` `end`.
|
|
94
|
+
- Button's, ConfirmButton's and DialogClose's `endIcon` is removed, with the part `env-button-end-icon`: write `end={<IconChevronRight />}`; the content is in `env-button-end`, which sits at the far end of a full-width button.
|
|
95
|
+
- `start` and `end` size envUI's icons and a Graphic, not a raw `<svg>` or another package's icon component, which `icon`, `startIcon` and `endIcon` wrapped: wrap those in `<Graphic alt="">`.
|
|
96
|
+
|
|
97
|
+
- DatePicker, TimePicker, MonthPicker and Menubar.Menu name what their `onOpenChange` receives the way every other overlay does: `DatePickerOpenChangeDetails`, `TimePickerOpenChangeDetails` and `MonthPickerOpenChangeDetails`, with their `…OpenChangeReason` types, and `Menubar.OpenChangeDetails`. The details themselves are the same.
|
|
98
|
+
|
|
99
|
+
Breaking changes:
|
|
100
|
+
|
|
101
|
+
- `PickerOpenChangeDetails` and `PickerOpenChangeReason` are no longer exported: write `DatePickerOpenChangeDetails` and `DatePickerOpenChangeReason`, or the TimePicker or MonthPicker ones.
|
|
102
|
+
- `Menubar.MenuFocusDetails` is renamed: write `Menubar.OpenChangeDetails`.
|
|
103
|
+
|
|
104
|
+
- Pagination's `formatRange` is renamed `renderRange`, since it returns content, as every function prop that draws a part is named `render<Part>`; a function named `format<Part>` returns text.
|
|
105
|
+
|
|
106
|
+
Breaking changes:
|
|
107
|
+
|
|
108
|
+
- Pagination's `formatRange` is now `renderRange`, with the same argument and return type: write `renderRange={({ start, end, total }) => …}`.
|
|
109
|
+
|
|
110
|
+
- Panes leaves where a pane's width is kept to the application: it no longer writes or reads a cookie. Panes takes `width`, `defaultWidth` and `onWidthChange`, so an application keeps the width people choose wherever it likes, such as in a cookie its server reads, in localStorage or in the user's account, and passes it back. See [Panes](https://github.com/envsemble/envUI/blob/main/docs/components/panes.md).
|
|
111
|
+
|
|
112
|
+
Breaking changes:
|
|
113
|
+
|
|
114
|
+
- Panes.Root's `persist` and `persistedWidth` and the export `readPanesWidth` are removed. Keep the width in the application and pass it back: `<Panes.Root width={width} onWidthChange={(next, { committed }) => { setWidth(next); if (committed) storeWidth(next); }}>` in place of `<Panes.Root persist="inbox" persistedWidth={readPanesWidth(cookieHeader, 'inbox')}>`, where `width` starts from the width the application stored, such as one its server read from its own cookie, and `storeWidth` keeps it there. A double click on the handle still calls `onWidthChange` with `defaultWidth`.
|
|
115
|
+
|
|
116
|
+
- Radio names its label's parts as Checkbox and Switch do: `env-radio-label` is the label with the description under it, and `env-radio-label-content` the slot inside it. See [Customize](https://github.com/envsemble/envUI/blob/main/docs/customizing.md).
|
|
117
|
+
|
|
118
|
+
Breaking changes:
|
|
119
|
+
|
|
120
|
+
- `env-radio-label` is now the wrapper of the label and its description, which had no class: a selector that targeted the label's slot as `env-radio-label` targets `env-radio-label-content`.
|
|
121
|
+
|
|
122
|
+
- Rating leaves the library: a row of review stars is a consumer and shopping pattern, outside the B2B and developer tools envUI is for.
|
|
123
|
+
|
|
124
|
+
Breaking changes:
|
|
125
|
+
|
|
126
|
+
- `Rating` and `RatingProps` are removed, with the parts `env-rating`, `env-rating-value`, `env-rating-stars`, `env-rating-star` and `env-rating-star-half`, the star's state `data-fill` (`full` and `half`), the token `--env-color-fg-rating-star` and EnvUIProvider's `messages.rating`: an app that shows a score in stars builds it from Row, Text and IconStar, as one image named such as "4.5 out of 5 stars", with its filled stars in IconStar's `tone="warning"` or the app's own color.
|
|
127
|
+
|
|
128
|
+
- RichTextEditor and RichText are removed, with the entry point `@envsemble/envui/rich-text`. An editor's storage format, schema, mentions and uploads are the application's decisions, so the editor is the application's own, built on the editor library it chooses.
|
|
129
|
+
|
|
130
|
+
Breaking changes:
|
|
131
|
+
|
|
132
|
+
- `@envsemble/envui/rich-text` is removed, with `RichTextEditor`, `RichText`, `createRichTextExtensions`, the types `RichTextEditorProps`, `RichTextEditorHandle`, `RichTextProps`, `RichTextReference`, `RichTextReferenceSource`, `RichTextRenderOptions`, `RichTextAttachment`, `RichTextCommand`, `RichTextSlashCommand`, `RichTextSuggestionContent` and `RichTextLinkEvent`, the `MarkdownLink` and `MarkdownLinkRequest` types this entry point also exported, and the `richText` messages. The parts go with them: RichText's `env-rich-text`, `env-rich-text-document`, `env-rich-text-reference`, `env-rich-text-suggestions`, `env-rich-text-suggestions-positioner`, `env-rich-text-task`, `env-rich-text-task-check` and `env-rich-text-task-content`, with the states `data-checked` (`true`, `false`) and `data-reference-id`; RichTextEditor's `env-rich-text-editor`, `env-rich-text-editor-content`, `env-rich-text-editor-control` and `env-rich-text-editor-footer`, with the states `data-disabled`, `data-invalid` and `data-readonly`; and the suggestion list's `env-listbox`, `env-listbox-options` and `env-listbox-empty`. Build the editor on Tiptap or another editor library in the application, and drop the Tiptap and `marked` packages if nothing else needs them. Show saved Markdown read-only with [Markdown](https://github.com/envsemble/envUI/blob/main/docs/components/markdown.md), and take plain text on several lines with Textarea.
|
|
133
|
+
|
|
134
|
+
- TableOfContents leaves the address to the application's router: each entry is an `#id` link through LinkProvider's link component, which now handles the click, so the router, or else the browser, changes the address and decides whether a jump adds a history entry. envUI still scrolls the section into view, focuses it and marks it current. `onNavigate` is called with the section's id and the click before envUI's scroll; call `preventDefault` in it to make the jump yourself. See [TableOfContents](https://github.com/envsemble/envUI/blob/main/docs/components/table-of-contents.md).
|
|
135
|
+
|
|
136
|
+
Breaking changes:
|
|
137
|
+
|
|
138
|
+
- TableOfContents no longer calls `history.pushState` itself. A click on an entry reaches LinkProvider's link component, as a click on any other envUI link does: a router link that handles `#id` links changes the address its own way, and without one the browser follows the fragment. To keep the address as it is, call `event.preventDefault()` in `onNavigate` and scroll to the section yourself.
|
|
139
|
+
|
|
140
|
+
- Table.Root's scroll region takes its class through `regionProps`, with its style, ref, data attributes and listeners, so the region has one way to set each. See [Table](https://github.com/envsemble/envUI/blob/main/docs/components/table.md).
|
|
141
|
+
|
|
142
|
+
Breaking changes:
|
|
143
|
+
|
|
144
|
+
- Table.Root's `regionClassName` is removed: write `regionProps={{ className }}`.
|
|
145
|
+
|
|
146
|
+
- ThemePreferenceProvider leaves where the theme preference is kept to the application: it takes `preference`, `defaultPreference` and `onPreferenceChange`, so an application keeps the choice in a cookie, so a server-rendered page matches it, or in the user's account, so it follows them across devices. The provider no longer reads or writes localStorage. `@envsemble/envui/theme-storage` keeps it in localStorage for an application that wants that: `useStoredThemePreference` returns the props to spread on the provider and follows a choice made in another tab, and `createStoredThemeBootstrapScript` reads it before the first paint. See [Setup](https://github.com/envsemble/envUI/blob/main/docs/setup.md#theme-preference).
|
|
147
|
+
|
|
148
|
+
Breaking changes:
|
|
149
|
+
|
|
150
|
+
- ThemePreferenceProvider no longer stores the preference. To keep it in localStorage as before, write `const storedTheme = useStoredThemePreference({ storageKey: 'app-theme' })` and `<ThemePreferenceProvider theme={theme} {...storedTheme}>`, with `useStoredThemePreference` from `@envsemble/envui/theme-storage`; to keep it elsewhere, pass `preference` and `onPreferenceChange`.
|
|
151
|
+
- `ThemeDefinition` and `defineTheme` no longer take `storageKey` and `defaultPreference`. Pass the storage key to `useStoredThemePreference` and `createStoredThemeBootstrapScript` as `{ storageKey }`, and the default as ThemePreferenceProvider's `defaultPreference` prop or the storage options' `defaultPreference`.
|
|
152
|
+
- `createThemeBootstrapScript` no longer reads localStorage: it paints the preference given as `createThemeBootstrapScript(theme, { preference })`, or the system theme. For the stored preference, write `createStoredThemeBootstrapScript(theme, { storageKey })` from `@envsemble/envui/theme-storage` in its place.
|
|
153
|
+
|
|
154
|
+
- ToastProvider: a notification's actions are one list, `actions`, such as Undo, or Undo and View, in the order given with the main one last, wrapping when they don't fit. See [Toast](https://github.com/envsemble/envUI/blob/main/docs/components/toast.md).
|
|
155
|
+
|
|
156
|
+
Breaking changes:
|
|
157
|
+
|
|
158
|
+
- A notification's single `action` is removed. Write `actions: [{ label: 'Undo', onClick: undo }]` instead of `action: { label: 'Undo', onClick: undo }`.
|
|
159
|
+
- `ToastAction` is a union instead of an interface: a button with `onClick`, or a link with `href` and an optional `onClick`. An interface that extends it writes a type alias with an intersection instead.
|
|
160
|
+
|
|
161
|
+
### Minor Changes
|
|
162
|
+
|
|
163
|
+
- AvatarGroup: a person takes `itemProps`, more props for their avatar, or for its link or button when it is pressable, such as data attributes for tests or a title; its class joins the avatar's, and the avatar's name and role stay. A person takes the same `name`, `src`, `fallback`, `hue`, `badge` and `selected` as Avatar, typed from AvatarProps. See [Avatar](https://github.com/envsemble/envUI/blob/main/docs/components/avatar.md).
|
|
164
|
+
- Breadcrumbs: a crumb's `itemProps` sets more props on its link, button or text, such as `target` and `rel` to open it in a new tab, or data attributes for tests; its class joins the crumb's, and the crumb's `aria-current` and name stay its own. See [Breadcrumbs](https://github.com/envsemble/envUI/blob/main/docs/components/breadcrumbs.md).
|
|
165
|
+
- Combobox: a group's heading takes content, as Select's does, such as an icon or a count beside the group's name. The type of `ComboboxGroup.label` widens from `string` to `ReactNode`: groups an app passes in keep working, and code that reads a group's label back as a string needs a check that it is one. See [Combobox](https://github.com/envsemble/envUI/blob/main/docs/components/combobox.md).
|
|
166
|
+
- DocumentTabs: a tab's `label` takes content, such as a dimmed folder before a name two tabs share, and the tab, its native tooltip, its close button and its context menu are named by its text: the new `textValue`, else the label when it is a string, else the label's rendered text. A tab's new `itemProps` sets more props on its element, such as a className or data attributes for tests; its `onPointerDown`, `onMouseDown` and `onAuxClick` run before the tab's own, and its other handlers after the tab's own. The type of `DocumentTabsItem.label` widens from `string` to `ReactNode`: tabs an app passes in keep working, and code that reads `label` back as a string needs a check that it is one, or `textValue`. See [DocumentTabs](https://github.com/envsemble/envUI/blob/main/docs/components/document-tabs.md).
|
|
167
|
+
- DropZone takes `render`, another element to render the zone as, such as the application's own panel or table region, which then takes dropped files and gets the zone's `data-drag-over`; and `target={false}` leaves out the target button, for content with its own Browse button that opens the picker through `inputRef`, while the label and description name the zone as a group. See [DropZone](https://github.com/envsemble/envUI/blob/main/docs/components/drop-zone.md).
|
|
168
|
+
- Halo: a new component that draws a soft halo breathing around what it holds, to point at the one control or region to look at next, such as the first step of onboarding or a product tour. The halo stays outside its content, takes no room and is hidden from assistive technology; it holds still with a reduced-motion preference and shows in the system highlight color with forced colors. `tone` is `accent` or `primary`, `--env-halo-indicator` gives it any other color, and `--env-halo-radius` the corners it follows. `render={<div />}` wraps a block, and without children a Halo is the box the application places, such as over a region it measured. See [Halo](https://github.com/envsemble/envUI/blob/main/docs/components/halo.md).
|
|
169
|
+
- IconButton takes `render`, as Button does: another element to render the button as, such as a label for a file input shaped like an icon button. Its class, look, state attributes, icon and handlers merge into that element's props, and a disabled one reports aria-disabled and blocks presses. See [Button](https://github.com/envsemble/envUI/blob/main/docs/components/button.md).
|
|
170
|
+
- Select, Combobox and CommandPalette: an option takes `itemProps`, more props for its element, such as a title or data attributes for tests, its class beside the option's own; the option's role, id and ARIA attributes stay its own. See [Select](https://github.com/envsemble/envUI/blob/main/docs/components/select.md), [Combobox](https://github.com/envsemble/envUI/blob/main/docs/components/combobox.md) and [CommandPalette](https://github.com/envsemble/envUI/blob/main/docs/components/command-palette.md).
|
|
171
|
+
- Markdown: `allowLinkSchemes` lets links take the application's own schemes beside the safe ones, such as `allowLinkSchemes={['vscode']}` for links that open the editor, and keeps the safe-link check for every other link: a `javascript:` link still renders as plain text, and `javascript`, `data` and `vbscript` are refused even when listed. See [Markdown](https://github.com/envsemble/envUI/blob/main/docs/components/markdown.md).
|
|
172
|
+
- Meter: `label` is optional, as on Progress, for a bare bar named with `aria-label` or `aria-labelledby`, such as in a table's usage column; without a label or `valueText` the bar has no row above it. See [Meter](https://github.com/envsemble/envUI/blob/main/docs/components/meter.md).
|
|
173
|
+
- NavigationRail's current destination now looks like a NavigationDrawer's current row: the whole item, icon and label, takes the selected fill with the drawer's corners, its label turns semibold and its icon stays filled. Before, only a rounded rectangle behind the icon was filled. Hover and press fill the whole item too, the keyboard focus ring goes around it, and the rail has a small inline padding so the items sit inside it. NavigationBar is unchanged.
|
|
174
|
+
|
|
175
|
+
`--env-navigation-rail-item-selected` now colors the current item's fill, and `--env-navigation-rail-item-selected-content` its icon and label; `--env-navigation-rail-item-container` colors each item's fill at rest.
|
|
176
|
+
|
|
177
|
+
- Radio: `labelPlacement="start"` puts the label before the radio, as on Checkbox and Switch, keeping the native label that names and chooses it. See [Radio](https://github.com/envsemble/envUI/blob/main/docs/components/radio.md).
|
|
178
|
+
- List: a row's `control` takes any field, such as a Select, a SegmentedControl, a Slider, a TextField, a Combobox, a RadioGroup, a picker or a Calendar, as well as a Switch, a Checkbox or a Radio. A field there with no name of its own is named by the row's `label` and described by its `description`, so a settings row writes its label once: `<List.Item label="Theme" description="Follows the system until set" control={<Select items={themes} />} />`. A field with its own `label`, `aria-label` or `aria-labelledby` keeps it. SegmentedControl's `aria-label` and Slider's `label` are optional for this. See [List](https://github.com/envsemble/envUI/blob/main/docs/components/list.md).
|
|
179
|
+
|
|
180
|
+
### Patch Changes
|
|
181
|
+
|
|
182
|
+
- CommandPalette: an item whose label is content and that has no `textValue` takes the label's rendered text as its text, rather than its id.
|
|
183
|
+
|
|
184
|
+
## 2.1.0 — 2026-11-19
|
|
185
|
+
|
|
186
|
+
envUI 2.1 lets an app put what it wants where it wants. Labels across the library take any content again, components gain start, end, header and action slots and render functions, rows and items pass an app's own props through, and the lint rules report only real mistakes. Nothing breaks: every 2.0 call compiles and renders as before, and the few item types that widened say what code that reads them back needs.
|
|
187
|
+
|
|
188
|
+
### Minor Changes
|
|
189
|
+
|
|
190
|
+
- Accordion: an item takes `end`, content beside its heading and outside its button, such as a Switch, a Badge with a Menu, or a Delete IconButton. `indicator` replaces the plus and minus with the application's own, such as a chevron, or `null` for none, and `indicatorPlacement="end"` moves it after the title; set on Accordion.Root they apply to every item, and an item's own replace them. See [Accordion](https://github.com/envsemble/envUI/blob/main/docs/components/accordion.md).
|
|
191
|
+
- Alert: `title` takes any content again, as in 1.x, such as a branch name in Code or a link, and `actionsPlacement="end"` puts the actions at the end of the alert's row, before the dismiss button, as in a one-line banner such as "Sync paused. Resume"; they move below the message where the alert is too narrow for both. See [Alert](https://github.com/envsemble/envUI/blob/main/docs/components/alert.md).
|
|
192
|
+
- AvatarButton: `description` takes any content, such as an organization's name with its plan's Badge, and the button passes `hue`, `selected` and `badge` to its avatar, so an account trigger can take an organization's own color or show a presence dot. See [Avatar](https://github.com/envsemble/envUI/blob/main/docs/components/avatar.md).
|
|
193
|
+
- Avatar: `fallback` also takes an element, placed on the hue's fill in its deep shade, such as an icon or a Graphic for a bot, an AI agent, a team or a service account. A new `badge` places a small mark at the avatar's bottom end, such as a presence dot, an unread marker or an organization's mark, and moves to the top end while the avatar is selected. See [Avatar](https://github.com/envsemble/envUI/blob/main/docs/components/avatar.md).
|
|
194
|
+
- AvatarGroup: each person takes a `hue`, a `badge` such as a presence dot, and a `tooltip` for a pressable avatar, such as the name with a role or an e-mail address. `renderOverflowTooltip` gives the overflow chip's tooltip the application's own content, such as the hidden people with their avatars. Accessible names stay the people's names, and the pile lays out and spreads as before. See [Avatar](https://github.com/envsemble/envUI/blob/main/docs/components/avatar.md).
|
|
195
|
+
- Badge: the label takes any content again, as in 1.x, such as a bold value or a RelativeTime in "Expires in 3 days", and still ends with an ellipsis where it is cut short. A new `start` places content before the label, such as an icon, a small Avatar or a color swatch: an envUI icon takes the badge's icon size and other content keeps its own, and assistive technology reads it unless it hides itself, as an unlabelled icon does. A done badge leads with a check mark unless given another `start`, or `null` for none. See [Badge](https://github.com/envsemble/envUI/blob/main/docs/components/badge.md).
|
|
196
|
+
- Breadcrumbs: a crumb's `label` takes any content again, as in 1.x, such as an Avatar before a project's name. It names the crumb's link or button, the trail still cuts it short beyond 20 rem, and the tooltip then shows the same content in full. The type widens from `string` to `ReactNode`: labels an app passes in keep working, and code that reads `label` back as a string needs a check that it is one. See [Breadcrumbs](https://github.com/envsemble/envUI/blob/main/docs/components/breadcrumbs.md).
|
|
197
|
+
- Button: `start` places content before the label, such as an icon or a small Avatar of the person a button assigns: an envUI icon takes the button's icon size and other content keeps its own, hidden from assistive technology as the label names the button. `render` renders the button as another element, such as a label for a file input or a router's own link in one place: the button's class, look, state attributes, content and handlers merge into its props, and a disabled one reports aria-disabled and blocks presses. See [Button](https://github.com/envsemble/envUI/blob/main/docs/components/button.md).
|
|
198
|
+
- Calendar: `isDateUnavailable` makes the days it returns true for unavailable, such as weekends, holidays or booked days, as days outside `min` and `max` are, and `renderDay` gives each day's mark its content in place of the number, such as the number with a dot for a day with events, or a price; each day keeps its role, its name and its keyboard handling. See [DatePicker](https://github.com/envsemble/envUI/blob/main/docs/components/date-picker.md).
|
|
199
|
+
- Card: a content card takes `interactive`, and a link or button inside it marked `data-row-target`, such as its title, stretches over the card and takes its click, as in an interactive List row, while every other link, button and field in the card, such as an author's link in the description or a Menu in `headerEnd`, stays clickable above it. A grid of project cards that open on click can keep a title row, a status Badge and an overflow Menu. `headerEnd` puts content at the end of the title row, after the meta, such as an Edit Button or a Menu, as on Dialog and Sheet. `description` is no longer a paragraph, so a list or a row of Badges is valid there; its look is unchanged. See [Card](https://github.com/envsemble/envUI/blob/main/docs/components/card.md).
|
|
200
|
+
- Checkbox: `labelPlacement="start"` puts the label before the box, such as an inline Dark mode setting whose label leads, keeping the native label that names and toggles it. See [Checkbox](https://github.com/envsemble/envUI/blob/main/docs/components/checkbox.md).
|
|
201
|
+
- CodeBlock and HighlightedCodeBlock: `label` takes any content, such as a file-type icon with a path link, and the code is named by the label as shown. `headerEnd` places content at the end of the heading before the copy button (the part `env-code-block-header-end`), such as Open in editor, Run, or a switch between npm, pnpm and yarn. See [Code](https://github.com/envsemble/envUI/blob/main/docs/components/code.md).
|
|
202
|
+
- CodeDiff: `headerEnd` places content at the end of the file header, such as View file, Accept or a status Badge, and `annotations` with `renderAnnotation` attach notes to lines, such as review comments. `layout="split"` sets the two versions side by side at any width, and `headingLevel` sets the level of the failed state's heading for the page's outline. See [Code](https://github.com/envsemble/envUI/blob/main/docs/components/code.md).
|
|
203
|
+
- ColorPickerButton: `trigger` opens the picker from the application's own element in place of the swatch button, such as a toolbar's text color button with a bar of the color, given as an element or a function of the color's value; it takes the native props, the opening behavior and, unless it has its own, the name after the label and the color, and `Toolbar.Item` puts it in a toolbar's arrow-key path. It also takes the picker's new `swatchesFirst` and `fields`. See [ColorPicker](https://github.com/envsemble/envUI/blob/main/docs/components/color-picker.md).
|
|
204
|
+
- ColorPicker: `fields={false}` leaves out the row of value fields, with its format select, eyedropper and copy button, and `swatchesFirst` shows the swatches above the area, for a compact picker where presets are the usual choice, such as a tag's color. See [ColorPicker](https://github.com/envsemble/envUI/blob/main/docs/components/color-picker.md).
|
|
205
|
+
- Combobox: an option takes `end`, content at the end of its row in the list, such as a role Badge or a count, read as part of its name; its label stays the text the field shows once chosen and the default filter matches. See [Combobox](https://github.com/envsemble/envUI/blob/main/docs/components/combobox.md).
|
|
206
|
+
- CommandPalette: an item takes `start`, content before its label, such as an icon or a person's Avatar among the results, where an envUI icon takes the icon size and other content keeps its own. `items` and `suggestedItems` take groups, `{ label, items }`, as Select's and Combobox's do, each under a heading that takes content, such as an icon or a count beside the group's name. `searchStart` and `searchEnd` place content in the search row, before the field and after it, such as a scope chip or a mode switch. See [CommandPalette](https://github.com/envsemble/envUI/blob/main/docs/components/command-palette.md).
|
|
207
|
+
- Composer: `header` places content inside the composer above the field (the part `env-composer-header`), such as attachment chips, a quoted reply or context pills, and `end` places content in the action row just before the send button, such as a voice button, a model picker or a token count. `sendKey="mod-enter"` makes Ctrl+Enter or ⌘+Enter send and Enter start a new line, for prompts that mostly take several lines; Enter still sends by default. See [Composer](https://github.com/envsemble/envUI/blob/main/docs/components/composer.md).
|
|
208
|
+
- ConfirmDialog: `confirmLabel` and `cancelLabel` take content, as a Button does, such as a Kbd of the shortcut beside Delete project. See [ConfirmDialog](https://github.com/envsemble/envUI/blob/main/docs/components/confirm-dialog.md).
|
|
209
|
+
- DatePicker: `popupHeader` places content at the top of the popup, above the calendar, such as presets for Tomorrow or Next Monday that set the value, and `popupFooter` content in its footer after Today and before Clear, such as a note of the time zone. It takes Calendar's `isDateUnavailable` and `renderDay` too, and Today is unavailable on a day the application makes unavailable. See [DatePicker](https://github.com/envsemble/envUI/blob/main/docs/components/date-picker.md).
|
|
210
|
+
- Dialog: `actionsStart` puts content at the start of the actions' row, such as a destructive Delete, a Learn more link or a Don't show again checkbox; `headerStart` and `headerEnd` put content before the title and at the end of its row, such as a back button or a Menu. `closeButtonPlacement="heading"` moves the built-in close button to the heading, as an IconButton with a cross as on a Sheet, and `closeButton={false}` leaves it out, as on a Sheet, for a dialog that places its own DialogClose. `title` is optional where `aria-label` or `aria-labelledby` names the dialog, such as an image viewer. The new `useDialogPending` hook gives any action component of the application's own the dialog's or sheet's pending state, where the last action isn't a plain Button. See [Dialog](https://github.com/envsemble/envUI/blob/main/docs/components/dialog.md).
|
|
211
|
+
- Disclosure: `indicatorPlacement="end"` puts the chevron after the summary's words, as in a Show more link, and `panelLayout="flow"` places the details as given, so they keep their own spacing and flow, such as inline text; the stacked panel stays the default. See [Disclosure](https://github.com/envsemble/envUI/blob/main/docs/components/disclosure.md).
|
|
212
|
+
- DocumentTabs: a tab's `end` holds content after its name, such as a dot for unsaved changes or a Badge of errors, left out of the tab's name. A tab whose `closable` is false has no close button and stays open on a middle click, Delete and Backspace, such as a pinned or welcome tab, and its context menu leaves out Close. The new `contextMenu` adds the application's own items, such as Close others or Copy path, after the built-in ones, for the tab people open the menu on or the strip around the tabs. See [DocumentTabs](https://github.com/envsemble/envUI/blob/main/docs/components/document-tabs.md).
|
|
213
|
+
- DropZone: `children` places content inside the zone, under its target, such as the chosen files with their previews and Remove buttons, or a Browse button that opens the file picker through `inputRef`. Files dropped on it are taken too, and it can hold controls, since it sits beside the target button rather than inside it. See [DropZone](https://github.com/envsemble/envUI/blob/main/docs/components/drop-zone.md).
|
|
214
|
+
- EmptyState: `illustration` shows a decorative drawing or image above the title at its own size, no wider than the region, in place of `icon`, which takes the icon size. See [EmptyState](https://github.com/envsemble/envUI/blob/main/docs/components/empty-state.md).
|
|
215
|
+
- Field: `Field.Error` takes `render`, the element or function to render the message as, which was dropped before, and `icon`, another icon before the message or null for none, such as for a compact error beside a control. See [Field](https://github.com/envsemble/envUI/blob/main/docs/components/field.md).
|
|
216
|
+
- HoverCard: `underline={false}` leaves a text trigger without the dotted underline, `env-hover-detail`, for text styled its own way, such as @mentions in a feed. See [HoverCard](https://github.com/envsemble/envUI/blob/main/docs/components/hover-card.md).
|
|
217
|
+
- Kbd: each of `keys` takes any content, such as an icon for an arrow or Return, and `separator` sets what joins them: a + by default, `null` for none as in ⌘⇧P, or a word for a sequence such as G then I. See [Kbd](https://github.com/envsemble/envUI/blob/main/docs/components/kbd.md).
|
|
218
|
+
- List: a titled List.Root takes `headerEnd`, content at the end of the title's line and outside the heading (the part `env-list-header-end`), such as an Add button, a Manage link or a count. In an interactive List.Item, links, buttons and fields in the label, the description or the children, such as an author's link, now stay clickable above the stretched `data-row-target`, as in Table. `handlePlacement="end"` puts a reorderable list's drag handles at the end of each row. See [List](https://github.com/envsemble/envUI/blob/main/docs/components/list.md).
|
|
219
|
+
- Markdown: `allowHtml` keeps raw HTML, such as details, sub, sup or an img with a width, for trusted content such as an application's own docs or a README. Only a rehype-raw in `rehypePlugins` renders it, so give a sanitizer such as rehype-sanitize with it; raw HTML is still dropped by default. See [Markdown](https://github.com/envsemble/envUI/blob/main/docs/components/markdown.md).
|
|
220
|
+
- Menu: `Menu.Item`, `Menu.CheckboxItem`, `Menu.RadioItem` and `Menu.Submenu` take `start`, content before the label, such as an icon or an Avatar in an account switcher: an envUI icon takes the icon size and other content keeps its own, the menu's leading column widens only when some row's start holds more than an icon, and the labels of every row still line up. The items take the native attributes of their row too, such as `style`, `id`, `ref` and data attributes for a test id or analytics, and `Menu.Item` takes `closeOnClick={false}` to keep the menu open after an action people repeat, such as Zoom in. Typing in an open menu matches each item's label, not the text of its `start` content, and `textValue` gives it the label's text where the label isn't a string. `Menu.Submenu` takes `end`, such as a count beside its chevron, and `triggerProps`, the className, style, ref and attributes of the row that opens it, typed `Menu.TriggerProps`. See [Menu](https://github.com/envsemble/envUI/blob/main/docs/components/menu.md).
|
|
221
|
+
- Menubar: `Menubar.Menu` takes `triggerProps`, the className, style, ref and attributes of its trigger button, typed `Menu.TriggerProps` as a `Menu.Submenu`'s are, and its `accessKey` is underlined in a label that holds an icon beside its text or wraps it in an element, such as a span, too. See [Menubar](https://github.com/envsemble/envUI/blob/main/docs/components/menubar.md).
|
|
222
|
+
- Message: `author` takes any content again, as in 1.x, such as a link to a profile with a Bot or Owner Badge, and `statusLabel` takes content such as a sentence with a Try again link. A new `start` places content in a column beside the message, such as the author's Avatar or an assistant's mark. `status="working"` shows a reply still being written, with a spinner and Working or its `statusLabel`, such as the step an agent is on, and the reply streamed so far: render it last in a MessageList with `aria-busy`, so the thinking row lines up with the other messages, its avatar in `start` and a Stop button in `actions` that assistive technology reaches. See [Message](https://github.com/envsemble/envUI/blob/main/docs/components/message.md).
|
|
223
|
+
- Meter: `layout="inline"` puts the label, the bar and the value on one line, as in a table's usage column or a list row; stacked stays the default. See [Meter](https://github.com/envsemble/envUI/blob/main/docs/components/meter.md).
|
|
224
|
+
- MonthPicker: `popupHeader` places content at the top of the popup, above its months, such as presets that set the value, and `popupFooter` content in its footer after This month and before Clear, such as a note of the fiscal year. See [MonthPicker](https://github.com/envsemble/envUI/blob/main/docs/components/month-picker.md).
|
|
225
|
+
- NavigationBar: `visibleLabel={false}` shows each destination's label only in a tooltip, as NavigationRail's does, and a destination's new `textValue`, `itemProps`, `disabled` and `count` of true work in the bar and in its More menu. See [NavigationDrawer](https://github.com/envsemble/envUI/blob/main/docs/components/navigation-drawer.md).
|
|
226
|
+
- NavigationDrawer: `groupEnd` puts content after a group's heading, outside it, such as an IconButton that adds a project to Projects or a Menu of the group's actions. A destination's new `textValue`, `itemProps`, `disabled` and `count` of true work in the drawer too, and a section's button takes its name from `textValue` where the label is content. See [NavigationDrawer](https://github.com/envsemble/envUI/blob/main/docs/components/navigation-drawer.md).
|
|
227
|
+
- NavigationRail: `visibleLabel={false}` makes an icon-only rail, such as a code editor's activity bar: each label shows only in a tooltip on hover and keyboard focus, and still names its destination. A destination's `label` also takes content, such as a name with a small Beta mark, with its text in `textValue`; `itemProps` sets more props on its link or button, such as `target`, `rel` or data attributes; `disabled` dims it and takes it out of reach; and a `count` of true shows a dot with no number, named as Activity, new, from the new `messages.navigation.itemNew`. These destination fields work in NavigationBar and NavigationDrawer too. The type of a destination's `label` widens from `string` to `ReactNode`, and its `count` from `number` to `number | true`: destinations an app passes in keep working, and code that reads `label` back as a string, or `count` as a number, needs a check that it is one. See [NavigationDrawer](https://github.com/envsemble/envUI/blob/main/docs/components/navigation-drawer.md).
|
|
228
|
+
- PageHeader renders its `children` under the toolbar, placed as given, such as a progress strip or an inline Alert, and they stick with the header. Before, children type-checked but were dropped. See [Page](https://github.com/envsemble/envUI/blob/main/docs/components/page.md).
|
|
229
|
+
- Pager: `Pager.Previous` and `Pager.Next` take `label`, the direction label above the title for that link alone, such as Previous chapter or Back to setup, in place of `messages.pager.previous` or `next`; `null` leaves it out. See [Pager](https://github.com/envsemble/envUI/blob/main/docs/components/pager.md).
|
|
230
|
+
- Pagination: `pageHref` gives each page its address, such as `?page=3`, and the previous and next controls are then links through the LinkProvider, 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. `onPageChange` is optional with `pageHref`. See [Pagination](https://github.com/envsemble/envUI/blob/main/docs/components/pagination.md).
|
|
231
|
+
- Panes: a pane an application renders alone, such as the list while no item is open, fills the region whichever pane is sized, and the resize handle hides. Before, it kept the sized width or sat in the last column. See [Panes](https://github.com/envsemble/envUI/blob/main/docs/components/panes.md).
|
|
232
|
+
- Popover: `trigger` is optional for a popover the application opens with `open`, and `anchor` opens it beside an element, its ref or a virtual element with a getBoundingClientRect, such as a table cell or a range of selected text. See [Popover](https://github.com/envsemble/envUI/blob/main/docs/components/popover.md).
|
|
233
|
+
- Progress: `label` is optional, for a bare bar named with `aria-label` or `aria-labelledby`, such as by the file name beside it in a row; without a label or `valueText` the bar has no row above it. See [Progress](https://github.com/envsemble/envUI/blob/main/docs/components/progress.md).
|
|
234
|
+
- Radio: `label` is optional. A Radio without one is named and described by the List.Item whose `control` it is, as a Checkbox and a Switch are, so a plan picker's rows can carry a price and a Badge, or by its `aria-label` or `aria-labelledby`, such as a radio in a table's cell; its RadioGroup still gives it the shared name and state. See [Radio](https://github.com/envsemble/envUI/blob/main/docs/components/radio.md).
|
|
235
|
+
- RelativeTime: `renderTooltip` gives the tooltip the application's own content from the moment, such as the time with its time zone, in UTC, or "Edited by Alex Morgan at 9:41". See [RelativeTime](https://github.com/envsemble/envUI/blob/main/docs/components/relative-time.md).
|
|
236
|
+
- Scaffold takes `aside`, a region at the end edge beside the body, such as an inspector, and `bottomBar`, a bar along the bottom, such as a status bar. Both stay in view while the document scrolls, as the rail and the top bar do: the bottom bar sits above a NavigationBar, and focus scrolls clear of it. Without them the layout is unchanged. See [Scaffold](https://github.com/envsemble/envUI/blob/main/docs/components/scaffold.md).
|
|
237
|
+
- SearchField: `endAction` places a control at the field's end after the clear button, such as a Filters IconButton, or a quiet hint such as a shortcut's Kbd, and the query stops short of both. `label` takes any content, as TextField's does. See [TextField](https://github.com/envsemble/envUI/blob/main/docs/components/text-field.md).
|
|
238
|
+
- SegmentedControl: an item's `label` takes any content again, as in 1.x, such as a status dot beside the text; a full-width control still cuts it short and its tooltip shows the same content whole. An item takes `end`, content after the label and count such as a Badge, read as part of its name, and `itemProps`, more props for its button, such as a title or data attributes for tests, its class beside the segment's own. With `visibleLabel: false` a segment shows only its `start`, such as an icon, as in a List and Grid view switch: its label still names it and shows in a tooltip on hover and keyboard focus. The type of an item's `label` widens from `string` to `ReactNode`: items an app passes in keep working, and code that reads `label` back as a string needs a check that it is one. See [SegmentedControl](https://github.com/envsemble/envUI/blob/main/docs/components/segmented-control.md).
|
|
239
|
+
- Select: an option takes `start` content before its label, such as a status dot, a priority's icon, a flag or an Avatar, which the trigger also shows before the chosen label, and `end` content in the list, such as a count or a Badge. `items` also takes groups, `{ label, items }`, each under a heading that names it for assistive technology. The label stays the text people type ahead on and the trigger shows. The type of `items` widens from `readonly SelectItem[]` to `readonly SelectItem[] | readonly SelectGroup[]`: lists an app passes in keep working, and code that reads `items` back as options needs a check that an entry isn't a group. See [Select](https://github.com/envsemble/envUI/blob/main/docs/components/select.md).
|
|
240
|
+
- Sheet: `actionsStart` puts content at the start of the actions' row, such as a Reset button, and `headerStart` and `headerEnd` put content before the title and before the close button, such as a back button, a Menu of more actions or an Open full page button. See [Sheet](https://github.com/envsemble/envUI/blob/main/docs/components/sheet.md).
|
|
241
|
+
- Slider: `label` takes any content again, as in 1.x, such as a volume icon beside the text; it still names the slider and ends in an ellipsis where the slider is narrow. `renderValue` shows the value at the slider's end as any content, such as the number with its unit styled apart, while `formatValue`, or the number in the locale, stays what assistive technology announces. The type of `label` widens from `string` to `ReactNode`: code that reads it back as a string needs a check that it is one. See [Slider](https://github.com/envsemble/envUI/blob/main/docs/components/slider.md).
|
|
242
|
+
- Switch: `labelPlacement="start"` puts the label before the track, such as an inline Dark mode setting whose label leads, keeping the native label that names and toggles it. See [Switch](https://github.com/envsemble/envUI/blob/main/docs/components/switch.md).
|
|
243
|
+
- Table: `Table.Foot` renders a tfoot for totals or a summary row, on the header's shaded band, keeping its roles while rows stack. Table.HeaderCell takes `end`, content beside the sort button and outside it, such as a column menu, a filter IconButton or a select-all Checkbox; the header's name stays its label. Table.Root takes `regionProps` for the scroll region, such as a ref for scrolling to a row, a style with a measured height, data attributes or listeners. See [Table](https://github.com/envsemble/envUI/blob/main/docs/components/table.md).
|
|
244
|
+
- TextField and SearchField: `prefix` and `suffix` take any content again, as in 1.x, such as a currency's icon beside its code or a small Avatar before the value, at its own size; the field still cuts them short with an ellipsis, and reads their text after the label. The type widens from `string` to `ReactNode`: code that reads them back as strings needs a check that they are. See [TextField](https://github.com/envsemble/envUI/blob/main/docs/components/text-field.md).
|
|
245
|
+
- ThemeMenuRadioGroup takes `children`, Menu.RadioItems valued system, light or dark, in place of its three default choices, such as Light and Dark alone or a choice with a hint beside it, and passes `className` to the group. Its `closeOnClick` applies to the given choices too, unless one sets its own. See [Menu](https://github.com/envsemble/envUI/blob/main/docs/components/menu.md).
|
|
246
|
+
- Theme takes `render`, like Box and Text: its boundary can be the element a region needs, such as `render={<section />}` for a landmark or `render={<tbody />}` inside a table, with the boundary's class and attributes merged into it as on Box and Text, its styles, event handlers and refs kept beside the boundary's, instead of an extra div. See [Setup](https://github.com/envsemble/envUI/blob/main/docs/setup.md#theme).
|
|
247
|
+
- ThemeToggle takes `icon`, such as one of the application's own, in place of the dark and light mode icons; its name stays Switch to dark theme or Switch to light theme. See [Setup](https://github.com/envsemble/envUI/blob/main/docs/setup.md#theme-preference).
|
|
248
|
+
- TimePicker: `popupHeader` places content at the top of the popup, above its list, such as presets that set the value, and `popupFooter` content in its footer after its shortcut to the current time and before Clear, such as a note of the time zone. See [TimePicker](https://github.com/envsemble/envUI/blob/main/docs/components/time-picker.md).
|
|
249
|
+
- ToastProvider: a notification's `message` takes content, such as the name of what changed in bold or a link to it, and its native title and announcement take its text: `textValue`, else the message when it is a string, else the message's rendered text. `icon` replaces the tone's icon, such as with an Avatar for a mention, or `null` shows none. An action takes `href`, which makes it a link through the LinkProvider, with an optional `onClick`; an action without `href` needs its `onClick`. The type of a notification's `message` widens from `string` to `ReactNode`, and an action's `onClick` is optional on a link: code that reads `message` back as a string, or calls an action's `onClick`, needs a check that it is one, or that it is there. See [Toast](https://github.com/envsemble/envUI/blob/main/docs/components/toast.md).
|
|
250
|
+
- Toolbar: `Toolbar.Item` makes any button-like control one stop of the toolbar's arrow-key path, such as a Button with a visible label, `render={<Button start={<IconShare />}>Share</Button>}`, or a Menu's trigger, `trigger={<Toolbar.Item render={<Button>Paragraph</Button>} />}`. `Toolbar.Input` does the same for a text input, such as a font size. See [Toolbar](https://github.com/envsemble/envUI/blob/main/docs/components/toolbar.md).
|
|
251
|
+
- Tooltip: `underline={false}` leaves a text trigger without the dotted underline, `env-hover-detail`, as on a HoverCard. See [Tooltip](https://github.com/envsemble/envUI/blob/main/docs/components/tooltip.md).
|
|
252
|
+
- Tree: a row's `label` and `description` take any content again, as in 1.x, such as a name with the letters a search matched in bold, and type-ahead matches the label's rendered text, or `textValue` where that isn't the name. A row's `itemProps` sets its own props on the row element, such as a className or data attribute for its state, or `draggable` and drag handlers for moving files; the tree keeps its role, id, ARIA attributes and title. The tree also takes `onClick`, `onDoubleClick`, `onContextMenu` and `onPointerDown`, which run before its own handling; a click or double click whose default is prevented doesn't open the row. The types of `label` and `description` widen from `string` to `ReactNode`: rows an app passes in keep working, and code that reads `label` or `description` back as a string needs a check that it is one. See [Tree](https://github.com/envsemble/envUI/blob/main/docs/components/tree.md).
|
|
253
|
+
|
|
254
|
+
### Patch Changes
|
|
255
|
+
|
|
256
|
+
- AvatarButton and a pressable AvatarGroup avatar: a `badge` given as text, such as online, now follows the name in the button's or link's accessible name, as in Alex Morgan, online, so the name includes the text the button shows. A badge that is an element, such as a presence dot, leaves the name as it was.
|
|
257
|
+
- Pager: where the previous and next links don't fit side by side, such as on a phone, they stack as rows of the pager's full width, the previous first, rather than wrap into two centred cards of different widths.
|
|
258
|
+
- Toolbar: a separator stays visible on the recessed surface in the light theme, where it had faded to almost the well's own shade since 2.0's deeper well. In light it is now a tint of the text color, so it keeps the same step from any surface a toolbar sits on; dark and high contrast look as before.
|
|
259
|
+
- Breadcrumbs and TableOfContents: on a touch screen, a breadcrumb's link has a touch target of 2.75 rem (44 px) around it, and a wrapping trail's lines sit far enough apart for it; each TableOfContents link is 2.75 rem tall. With a mouse both look as before.
|
|
260
|
+
|
|
3
261
|
## 2.0.0 — 2026-11-19
|
|
4
262
|
|
|
5
263
|
envUI 2.0 steers by its code and looks quieter. Fewer, better components: Tabs, LineArt and PanelDock are gone, Panes is one part with a resize handle, and EmptyState, ResizeHandle and VisuallyHidden arrive. The light and dark themes keep things apart, and alike: light surfaces sit a step apart around a real recessed well, selection stays apart from hover, and nothing shows in one theme and disappears in the other. Each breaking change below says what to write instead.
|
package/README.md
CHANGED
|
@@ -7,18 +7,20 @@
|
|
|
7
7
|
[](https://www.npmjs.com/package/@envsemble/envui)
|
|
8
8
|

|
|
9
9
|
|
|
10
|
-
envUI gives B2B SaaS products and AI developer tools one consistent interface: themes and components, from a button or a form to an app frame, a data table or a conversation with an agent. Its documentation is written for the people and the coding agents who build with it, and ships in the package.
|
|
11
|
-
|
|
12
10
|
[Website](https://envui.envsemble.com) · [Docs](https://envui.envsemble.com/docs) · [Changelog](CHANGELOG.md) · [Contributing](https://github.com/envsemble/envUI/blob/main/CONTRIBUTING.md)
|
|
13
11
|
|
|
14
12
|
<picture>
|
|
15
13
|
<source media="(prefers-color-scheme: dark)" srcset="dist/assets/readme/overview-dark.png">
|
|
16
|
-
<img src="dist/assets/readme/overview-light.png" alt="The
|
|
14
|
+
<img src="dist/assets/readme/overview-light.png" alt="The front page of the envUI website: its headline, the Explore button and the setup prompt to copy, over a component's code beside the card it renders" width="1440">
|
|
17
15
|
</picture>
|
|
18
16
|
|
|
19
17
|
## Get started
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
```bash
|
|
20
|
+
npm install --save-exact @envsemble/envui
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
[Install and set up](https://envui.envsemble.com/docs/setup) covers styles, theme and router. Or let a coding agent do it:
|
|
22
24
|
|
|
23
25
|
```text
|
|
24
26
|
Set up envUI in my app: envui.envsemble.com/SKILL.md
|
|
@@ -26,28 +28,13 @@ Set up envUI in my app: envui.envsemble.com/SKILL.md
|
|
|
26
28
|
|
|
27
29
|
## What’s inside
|
|
28
30
|
|
|
29
|
-
- **
|
|
30
|
-
- **Components:**
|
|
31
|
-
- **Content:** Markdown, code highlighting
|
|
32
|
-
- **
|
|
33
|
-
- **
|
|
34
|
-
- **Lint rules:** an [ESLint plugin and a Stylelint config](https://envui.envsemble.com/docs?section=lint-rules) that
|
|
35
|
-
|
|
36
|
-
<picture>
|
|
37
|
-
<source media="(prefers-color-scheme: dark)" srcset="dist/assets/readme/gallery-dark.png">
|
|
38
|
-
<img src="dist/assets/readme/gallery-light.png" alt="The components gallery of the envUI website: a live tile for each component, grouped by what it is for, starting with the actions: Button, Link, Toolbar, Menu, Menubar and CommandPalette" width="1920">
|
|
39
|
-
</picture>
|
|
40
|
-
|
|
41
|
-
## Documentation
|
|
42
|
-
|
|
43
|
-
The [website](https://envui.envsemble.com) has two parts. The catalogue shows every foundation and component, live. The [Docs](https://envui.envsemble.com/docs) are the developer reference: setup, guides, props, part names and the changelog. The same pages ship in the package under `docs/`, so an agent reads the ones for the version it has installed.
|
|
44
|
-
|
|
45
|
-
## Contributing
|
|
46
|
-
|
|
47
|
-
To work on envUI itself, start with [CONTRIBUTING.md](https://github.com/envsemble/envUI/blob/main/CONTRIBUTING.md).
|
|
48
|
-
|
|
49
|
-
## Versions and license
|
|
31
|
+
- **Themes:** light, dark and high contrast, with design tokens for type, spacing and density.
|
|
32
|
+
- **Components:** from buttons and forms to app frames, data tables and agent conversations, with Base UI under the complex interactions.
|
|
33
|
+
- **Content:** Markdown, code highlighting and diffs, on entry points of their own.
|
|
34
|
+
- **No CDN:** the Geist fonts and Material Symbols Rounded icons ship in the package.
|
|
35
|
+
- **Docs in the package:** under `docs/`, so an agent reads the ones for the version it has installed.
|
|
36
|
+
- **Lint rules:** an [ESLint plugin and a Stylelint config](https://envui.envsemble.com/docs?section=lint-rules) that point to the envUI component or token instead of hand-built controls and raw colors.
|
|
50
37
|
|
|
51
|
-
|
|
38
|
+
## License
|
|
52
39
|
|
|
53
|
-
|
|
40
|
+
[MIT](LICENSE), for the code; the envUI name and logos remain envsemble’s. Bundled third-party assets and dependencies keep their [notices](THIRD_PARTY_NOTICES.md) and [licenses](licenses/).
|
package/dist/actions/Button.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ComponentPropsWithRef, ReactNode } from 'react';
|
|
1
|
+
import type { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';
|
|
2
2
|
import type { ActionElementProps } from '../internal/control/ActionElement.js';
|
|
3
3
|
import type { ControlTone, ControlVariant } from '../internal/control/ControlDefaults.js';
|
|
4
4
|
import type { ControlSize } from '../foundations/Theme.js';
|
|
@@ -73,13 +73,16 @@ export type ButtonAppearanceProps = ButtonEmphasisProps & {
|
|
|
73
73
|
* @default false
|
|
74
74
|
*/
|
|
75
75
|
fullWidth?: boolean;
|
|
76
|
-
/** A decorative icon before the label, such as IconAdd. */
|
|
77
|
-
startIcon?: ReactNode;
|
|
78
|
-
/** A decorative icon after the label, such as a ChevronRight for a next step. */
|
|
79
|
-
endIcon?: ReactNode;
|
|
80
76
|
/**
|
|
81
|
-
*
|
|
82
|
-
*
|
|
77
|
+
* Content before the label, such as IconAdd, or a small Avatar of the person a button assigns: an
|
|
78
|
+
* envUI icon takes the button's icon size and other content keeps its own. It is hidden from
|
|
79
|
+
* assistive technology, since the label names the button.
|
|
80
|
+
*/
|
|
81
|
+
start?: ReactNode;
|
|
82
|
+
/**
|
|
83
|
+
* Content after the label, at the far end of a full-width button, such as IconChevronRight for a
|
|
84
|
+
* next step, or a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the
|
|
85
|
+
* button: an envUI icon takes the button's icon size and other content keeps its own.
|
|
83
86
|
*/
|
|
84
87
|
end?: ReactNode;
|
|
85
88
|
/**
|
|
@@ -89,7 +92,15 @@ export type ButtonAppearanceProps = ButtonEmphasisProps & {
|
|
|
89
92
|
*/
|
|
90
93
|
pending?: boolean;
|
|
91
94
|
};
|
|
92
|
-
export type ButtonProps = ButtonAppearanceProps & ActionElementProps
|
|
95
|
+
export type ButtonProps = ButtonAppearanceProps & ActionElementProps & {
|
|
96
|
+
/**
|
|
97
|
+
* Another element to render the button as, such as a label for a file input, or a router's own
|
|
98
|
+
* link in one place: the button's class, look, state attributes, content and handlers merge
|
|
99
|
+
* into its props. It takes no type or disabled attribute; disabled reports aria-disabled and
|
|
100
|
+
* blocks presses.
|
|
101
|
+
*/
|
|
102
|
+
render?: ReactElement;
|
|
103
|
+
};
|
|
93
104
|
/**
|
|
94
105
|
* Starts an action, or goes to a destination with href, in one of five variants and three tones,
|
|
95
106
|
* with optional icons. It renders a native button or link. An icon alone is an IconButton.
|
|
@@ -126,6 +137,12 @@ export type IconButtonProps = IconButtonElementProps & IconButtonEmphasisProps &
|
|
|
126
137
|
pending?: boolean;
|
|
127
138
|
/** As Button's: the height, and the width, of the square button. */
|
|
128
139
|
size?: ControlSize;
|
|
140
|
+
/**
|
|
141
|
+
* As Button's: another element to render the button as, such as a label for a file input
|
|
142
|
+
* shaped like an icon button. Its class, look, state attributes, icon and handlers merge into
|
|
143
|
+
* that element's props; disabled reports aria-disabled and blocks presses.
|
|
144
|
+
*/
|
|
145
|
+
render?: ReactElement;
|
|
129
146
|
};
|
|
130
147
|
/**
|
|
131
148
|
* A square button that shows its icon alone, named by aria-label or aria-labelledby, such as a
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/actions/Button.tsx"],
|
|
4
|
-
"sourcesContent": ["import type { ComponentPropsWithRef, ReactNode } from 'react';\nimport type { ActionElementProps } from '../internal/control/ActionElement.js';\nimport type { ControlTone, ControlVariant } from '../internal/control/ControlDefaults.js';\nimport { ButtonBase, type ButtonBaseProps } from './internal/ButtonBase.js';\nimport type { ControlSize } from '../foundations/Theme.js';\n\n/**\n * A button's emphasis: primary for the main action of a view; secondary, a quiet neutral fill, and\n * outline, a thin edge, for the rest; ghost for an application's chrome, such as a toolbar, and\n * text for a link-like action.\n */\nexport type ButtonVariant = ControlVariant;\n\n/**\n * A button's meaning: neutral for most actions, accent for a rare consequential one that must stand\n * out, and danger for an action that deletes or ends something.\n */\nexport type ButtonTone = ControlTone;\n\n/**\n * The designed pairs of variant and tone: a primary button takes any tone; outline, ghost and text\n * buttons take neutral or danger; a secondary button is neutral.\n */\nexport type ButtonEmphasisProps =\n | {\n /**\n * The emphasis, primary for a group's main action; without it, the container's, such as ghost\n * in a toolbar, and else primary.\n * @default 'primary'\n */\n variant?: ButtonVariant;\n /**\n * The meaning: neutral for most actions, danger for one that deletes or ends something, and\n * accent, on a primary only, for a main action that must stand apart from the brand blue.\n * @default 'neutral'\n */\n tone?: 'neutral';\n }\n | { variant?: 'primary' | 'outline' | 'ghost' | 'text'; tone?: 'neutral' | 'danger' }\n | { variant?: 'primary'; tone?: ButtonTone };\n\n/**\n * IconButton's designed pairs: as Button's, but without a variant it is a neutral secondary button,\n * so a tone other than neutral needs a variant that takes it.\n */\nexport type IconButtonEmphasisProps =\n | {\n /**\n * The emphasis, as Button's. Without it, the button takes the variant its container gives,\n * such as ghost in a toolbar, and else secondary.\n * @default 'secondary'\n */\n variant?: ButtonVariant;\n /**\n * The meaning, as Button's.\n * @default 'neutral'\n */\n tone?: 'neutral';\n }\n | { variant: 'primary' | 'outline' | 'ghost' | 'text'; tone?: 'neutral' | 'danger' }\n | { variant: 'primary'; tone?: ButtonTone };\n\nexport type ButtonAppearanceProps = ButtonEmphasisProps & {\n /**\n * Show an underline for the text variant.\n * @default false\n */\n underline?: boolean;\n /** The control height, sm, md or lg; without it, the container's, and else md. */\n size?: ControlSize;\n /**\n * Fill the width of the container, such as the actions of a narrow form stacked in a column.\n * @default false\n */\n fullWidth?: boolean;\n
|
|
5
|
-
"mappings": "
|
|
4
|
+
"sourcesContent": ["import type { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';\nimport type { ActionElementProps } from '../internal/control/ActionElement.js';\nimport type { ControlTone, ControlVariant } from '../internal/control/ControlDefaults.js';\nimport { ButtonBase, type ButtonBaseProps } from './internal/ButtonBase.js';\nimport type { ControlSize } from '../foundations/Theme.js';\n\n/**\n * A button's emphasis: primary for the main action of a view; secondary, a quiet neutral fill, and\n * outline, a thin edge, for the rest; ghost for an application's chrome, such as a toolbar, and\n * text for a link-like action.\n */\nexport type ButtonVariant = ControlVariant;\n\n/**\n * A button's meaning: neutral for most actions, accent for a rare consequential one that must stand\n * out, and danger for an action that deletes or ends something.\n */\nexport type ButtonTone = ControlTone;\n\n/**\n * The designed pairs of variant and tone: a primary button takes any tone; outline, ghost and text\n * buttons take neutral or danger; a secondary button is neutral.\n */\nexport type ButtonEmphasisProps =\n | {\n /**\n * The emphasis, primary for a group's main action; without it, the container's, such as ghost\n * in a toolbar, and else primary.\n * @default 'primary'\n */\n variant?: ButtonVariant;\n /**\n * The meaning: neutral for most actions, danger for one that deletes or ends something, and\n * accent, on a primary only, for a main action that must stand apart from the brand blue.\n * @default 'neutral'\n */\n tone?: 'neutral';\n }\n | { variant?: 'primary' | 'outline' | 'ghost' | 'text'; tone?: 'neutral' | 'danger' }\n | { variant?: 'primary'; tone?: ButtonTone };\n\n/**\n * IconButton's designed pairs: as Button's, but without a variant it is a neutral secondary button,\n * so a tone other than neutral needs a variant that takes it.\n */\nexport type IconButtonEmphasisProps =\n | {\n /**\n * The emphasis, as Button's. Without it, the button takes the variant its container gives,\n * such as ghost in a toolbar, and else secondary.\n * @default 'secondary'\n */\n variant?: ButtonVariant;\n /**\n * The meaning, as Button's.\n * @default 'neutral'\n */\n tone?: 'neutral';\n }\n | { variant: 'primary' | 'outline' | 'ghost' | 'text'; tone?: 'neutral' | 'danger' }\n | { variant: 'primary'; tone?: ButtonTone };\n\nexport type ButtonAppearanceProps = ButtonEmphasisProps & {\n /**\n * Show an underline for the text variant.\n * @default false\n */\n underline?: boolean;\n /** The control height, sm, md or lg; without it, the container's, and else md. */\n size?: ControlSize;\n /**\n * Fill the width of the container, such as the actions of a narrow form stacked in a column.\n * @default false\n */\n fullWidth?: boolean;\n /**\n * Content before the label, such as IconAdd, or a small Avatar of the person a button assigns: an\n * envUI icon takes the button's icon size and other content keeps its own. It is hidden from\n * assistive technology, since the label names the button.\n */\n start?: ReactNode;\n /**\n * Content after the label, at the far end of a full-width button, such as IconChevronRight for a\n * next step, or a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the\n * button: an envUI icon takes the button's icon size and other content keeps its own.\n */\n end?: ReactNode;\n /**\n * Its work is running: a spinner turns over it, it keeps its width and name, and presses do\n * nothing.\n * @default false\n */\n pending?: boolean;\n};\nexport type ButtonProps = ButtonAppearanceProps &\n ActionElementProps & {\n /**\n * Another element to render the button as, such as a label for a file input, or a router's own\n * link in one place: the button's class, look, state attributes, content and handlers merge\n * into its props. It takes no type or disabled attribute; disabled reports aria-disabled and\n * blocks presses.\n */\n render?: ReactElement;\n };\n\n/**\n * Starts an action, or goes to a destination with href, in one of five variants and three tones,\n * with optional icons. It renders a native button or link. An icon alone is an IconButton.\n */\nexport function Button(props: ButtonProps) {\n return <ButtonBase {...props} fallbackVariant=\"primary\" />;\n}\n\ntype IconButtonElementProps =\n | (Omit<ComponentPropsWithRef<'button'>, 'children' | 'aria-label'> & { href?: undefined })\n | (Omit<ComponentPropsWithRef<'a'>, 'children' | 'aria-label'> & {\n /** The destination: the button is a native link, through the LinkProvider's link component. */\n href: string;\n /**\n * A disabled button cannot be pressed; a disabled link has no destination, cannot be focused\n * or followed, and reports aria-disabled.\n * @default false\n */\n disabled?: boolean;\n });\n\ntype IconButtonName =\n | {\n /** The action's name, which assistive technology announces, such as Open settings. */\n 'aria-label': string;\n /** The id of visible text that names the action; this or aria-label. */\n 'aria-labelledby'?: string;\n }\n | { 'aria-label'?: string; 'aria-labelledby': string };\n\nexport type IconButtonProps = IconButtonElementProps &\n IconButtonEmphasisProps &\n IconButtonName & {\n /** The icon, such as Settings. */\n icon: ReactNode;\n /**\n * As Button's: a spinner replaces the icon while the work runs.\n * @default false\n */\n pending?: boolean;\n /** As Button's: the height, and the width, of the square button. */\n size?: ControlSize;\n /**\n * As Button's: another element to render the button as, such as a label for a file input\n * shaped like an icon button. Its class, look, state attributes, icon and handlers merge into\n * that element's props; disabled reports aria-disabled and blocks presses.\n */\n render?: ReactElement;\n };\n\n/**\n * A square button that shows its icon alone, named by aria-label or aria-labelledby, such as a\n * close button with the Close cross; with href, a native link. Without a variant it takes its\n * container's, and else the neutral secondary one.\n */\nexport function IconButton(props: IconButtonProps) {\n return <ButtonBase {...(props as ButtonBaseProps)} iconOnly fallbackVariant=\"secondary\" />;\n}\n"],
|
|
5
|
+
"mappings": "AA8GS;AA3GT,SAAS,kBAAwC;AA0G1C,SAAS,OAAO,OAAoB;AACzC,SAAO,oBAAC,cAAY,GAAG,OAAO,iBAAgB,WAAU;AAC1D;AAiDO,SAAS,WAAW,OAAwB;AACjD,SAAO,oBAAC,cAAY,GAAI,OAA2B,UAAQ,MAAC,iBAAgB,aAAY;AAC1F;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,22 +1,43 @@
|
|
|
1
1
|
import { type ComponentPropsWithRef, type ReactNode } from 'react';
|
|
2
|
+
import type { ListItemElementProps } from '../internal/popup/listEntries.js';
|
|
2
3
|
import type { DialogOpenChangeReason } from '../overlays/Dialog.js';
|
|
3
4
|
export interface CommandPaletteItem {
|
|
4
5
|
/** Stable identifier; options carry it as data-item-id. */
|
|
5
6
|
id: string;
|
|
6
7
|
/** The option's text; also its accessible name unless textValue is set. */
|
|
7
8
|
label: ReactNode;
|
|
8
|
-
/**
|
|
9
|
+
/**
|
|
10
|
+
* The label as plain text, where the label is content rather than text.
|
|
11
|
+
* @default the label when it is a string, else the label's rendered text
|
|
12
|
+
*/
|
|
9
13
|
textValue?: string;
|
|
10
14
|
/** Muted text under the label, such as a folder path. */
|
|
11
15
|
description?: ReactNode;
|
|
12
|
-
/**
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
+
/**
|
|
17
|
+
* Content before the label, such as an icon or a person's Avatar among the results: an envUI icon
|
|
18
|
+
* takes the icon size and other content keeps its own. It is hidden from assistive technology.
|
|
19
|
+
*/
|
|
20
|
+
start?: ReactNode;
|
|
16
21
|
/** End content, such as a Kbd shortcut or a Badge. */
|
|
17
22
|
end?: ReactNode;
|
|
18
23
|
/** The option shows but can't be chosen, such as a command that doesn't apply here. */
|
|
19
24
|
disabled?: boolean;
|
|
25
|
+
/**
|
|
26
|
+
* More props for the option's element, such as a title or data attributes for tests. Its class
|
|
27
|
+
* joins the option's; the option's role, id and ARIA attributes stay its own.
|
|
28
|
+
*/
|
|
29
|
+
itemProps?: CommandPaletteItemElementProps;
|
|
30
|
+
/** Reserved: an entry with an `items` array is a group, so an item has none. */
|
|
31
|
+
items?: never;
|
|
32
|
+
}
|
|
33
|
+
/** What a CommandPalette item's itemProps can set on its option element. */
|
|
34
|
+
export type CommandPaletteItemElementProps = ListItemElementProps;
|
|
35
|
+
/** Items of a CommandPalette under a heading, which also names the group for assistive technology. */
|
|
36
|
+
export interface CommandPaletteGroup {
|
|
37
|
+
/** The group's heading: text, or content such as an icon or a count beside the group's name. */
|
|
38
|
+
label: ReactNode;
|
|
39
|
+
/** The items under the heading, in display order; a group with none shows no heading. */
|
|
40
|
+
items: readonly CommandPaletteItem[];
|
|
20
41
|
}
|
|
21
42
|
/** A key hint in the footer: the keys as Kbd, then what they do. */
|
|
22
43
|
export interface CommandPaletteHint {
|
|
@@ -48,13 +69,16 @@ export interface CommandPaletteProps extends Omit<ComponentPropsWithRef<'div'>,
|
|
|
48
69
|
inputValue: string;
|
|
49
70
|
/** Receives the text as people type. */
|
|
50
71
|
onInputValueChange: (inputValue: string) => void;
|
|
51
|
-
/**
|
|
52
|
-
|
|
72
|
+
/**
|
|
73
|
+
* Filtered and ranked by the application, in display order; or groups of items, each under a
|
|
74
|
+
* heading.
|
|
75
|
+
*/
|
|
76
|
+
items: readonly CommandPaletteItem[] | readonly CommandPaletteGroup[];
|
|
53
77
|
/**
|
|
54
78
|
* Shown in place of items while the search field is empty, such as recent documents or
|
|
55
79
|
* suggested pages under a group heading; options like any other.
|
|
56
80
|
*/
|
|
57
|
-
suggestedItems?: readonly CommandPaletteItem[];
|
|
81
|
+
suggestedItems?: readonly CommandPaletteItem[] | readonly CommandPaletteGroup[];
|
|
58
82
|
/** Enter or a press on an option; Ctrl or Cmd sets modifier. */
|
|
59
83
|
onAction: (item: CommandPaletteItem, details: CommandPaletteActionDetails) => void;
|
|
60
84
|
/**
|
|
@@ -102,6 +126,10 @@ export interface CommandPaletteProps extends Omit<ComponentPropsWithRef<'div'>,
|
|
|
102
126
|
hints?: readonly CommandPaletteHint[];
|
|
103
127
|
/** Other content below the list, after the hints. */
|
|
104
128
|
footer?: ReactNode;
|
|
129
|
+
/** Content before the search field in its row, such as a scope chip, In: Projects. */
|
|
130
|
+
searchStart?: ReactNode;
|
|
131
|
+
/** Content after the search field in its row, before the close button, such as a mode switch. */
|
|
132
|
+
searchEnd?: ReactNode;
|
|
105
133
|
}
|
|
106
134
|
/**
|
|
107
135
|
* A quick-open dialog near the top of the window: a search field over a list of options the
|
|
@@ -109,4 +137,4 @@ export interface CommandPaletteProps extends Omit<ComponentPropsWithRef<'div'>,
|
|
|
109
137
|
* number of results is announced as it changes. className, style, ref and data attributes go to
|
|
110
138
|
* the dialog's surface.
|
|
111
139
|
*/
|
|
112
|
-
export declare function CommandPalette({ open, onOpenChange, 'aria-label': label, inputValue, onInputValueChange, items: results, suggestedItems, onAction, closeOnAction, placeholder, loading, loadingLabel, emptyLabel, emptyDescription, emptyIcon, hints, footer, className, ...popupProps }: CommandPaletteProps): import("react").JSX.Element;
|
|
140
|
+
export declare function CommandPalette({ open, onOpenChange, 'aria-label': label, inputValue, onInputValueChange, items: results, suggestedItems, onAction, closeOnAction, placeholder, loading, loadingLabel, emptyLabel, emptyDescription, emptyIcon, hints, footer, searchStart, searchEnd, className, ...popupProps }: CommandPaletteProps): import("react").JSX.Element;
|