@envsemble/envui 2.0.0 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +258 -0
- package/README.md +14 -27
- package/dist/actions/Button.d.ts +25 -8
- package/dist/actions/Button.js.map +2 -2
- package/dist/actions/CommandPalette.d.ts +37 -9
- package/dist/actions/CommandPalette.js +111 -107
- package/dist/actions/CommandPalette.js.map +2 -2
- package/dist/actions/ConfirmButton.d.ts +1 -1
- package/dist/actions/ConfirmButton.js +2 -4
- package/dist/actions/ConfirmButton.js.map +2 -2
- package/dist/actions/ContextMenu.d.ts +1 -1
- package/dist/actions/ContextMenu.js +5 -6
- package/dist/actions/ContextMenu.js.map +2 -2
- package/dist/actions/CopyButton.js +2 -2
- package/dist/actions/CopyButton.js.map +2 -2
- package/dist/actions/Menubar.d.ts +12 -5
- package/dist/actions/Menubar.js +37 -29
- package/dist/actions/Menubar.js.map +3 -3
- package/dist/actions/Toolbar.d.ts +42 -2
- package/dist/actions/Toolbar.js +18 -0
- package/dist/actions/Toolbar.js.map +2 -2
- package/dist/actions/internal/ButtonBase.d.ts +3 -2
- package/dist/actions/internal/ButtonBase.js +2 -4
- package/dist/actions/internal/ButtonBase.js.map +2 -2
- package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
- package/dist/actions/internal/CommandPaletteOptions.js +24 -15
- package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
- package/dist/actions/internal/CommandPaletteStatus.js +23 -9
- package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
- package/dist/actions/menu/Menu.d.ts +5 -4
- package/dist/actions/menu/Menu.js +3 -6
- package/dist/actions/menu/Menu.js.map +2 -2
- package/dist/actions/menu/MenuChoices.d.ts +9 -7
- package/dist/actions/menu/MenuChoices.js +34 -6
- package/dist/actions/menu/MenuChoices.js.map +2 -2
- package/dist/actions/menu/MenuItem.d.ts +37 -8
- package/dist/actions/menu/MenuItem.js +47 -12
- package/dist/actions/menu/MenuItem.js.map +2 -2
- package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
- package/dist/actions/menu/MenuSubmenu.js +26 -24
- package/dist/actions/menu/MenuSubmenu.js.map +2 -2
- package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
- package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
- package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
- package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
- package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
- package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
- package/dist/assets/readme/overview-dark.png +0 -0
- package/dist/assets/readme/overview-light.png +0 -0
- package/dist/content/Accordion.d.ts +32 -2
- package/dist/content/Accordion.js +41 -12
- package/dist/content/Accordion.js.map +2 -2
- package/dist/content/CodeBlock.d.ts +13 -4
- package/dist/content/CodeBlock.js +2 -0
- package/dist/content/CodeBlock.js.map +2 -2
- package/dist/content/CodeDiff.d.ts +34 -4
- package/dist/content/CodeDiff.js +41 -24
- package/dist/content/CodeDiff.js.map +2 -2
- package/dist/content/Composer.d.ts +19 -2
- package/dist/content/Composer.js +19 -12
- package/dist/content/Composer.js.map +2 -2
- package/dist/content/Disclosure.d.ts +13 -1
- package/dist/content/Disclosure.js +9 -3
- package/dist/content/Disclosure.js.map +2 -2
- package/dist/content/HighlightedCodeBlock.d.ts +1 -1
- package/dist/content/HighlightedCodeBlock.js +2 -0
- package/dist/content/HighlightedCodeBlock.js.map +2 -2
- package/dist/content/Kbd.d.ts +12 -5
- package/dist/content/Kbd.js +2 -2
- package/dist/content/Kbd.js.map +2 -2
- package/dist/content/Markdown.d.ts +17 -1
- package/dist/content/Markdown.js +26 -4
- package/dist/content/Markdown.js.map +2 -2
- package/dist/content/Message.d.ts +29 -33
- package/dist/content/Message.js +21 -21
- package/dist/content/Message.js.map +2 -2
- package/dist/content/countDiffLines.d.ts +1 -1
- package/dist/content/countDiffLines.js.map +1 -1
- package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
- package/dist/content/internal/CodeBlockFrame.js +25 -13
- package/dist/content/internal/CodeBlockFrame.js.map +2 -2
- package/dist/content/internal/MessageListFollow.js +1 -1
- package/dist/content/internal/MessageListFollow.js.map +2 -2
- package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
- package/dist/content/internal/MessageStatusLabel.js.map +2 -2
- package/dist/content/internal/codeColors.js +2 -2
- package/dist/content/internal/codeColors.js.map +2 -2
- package/dist/content/internal/useCodeContrast.js +4 -3
- package/dist/content/internal/useCodeContrast.js.map +2 -2
- package/dist/data-display/Avatar.d.ts +13 -4
- package/dist/data-display/Avatar.js +8 -4
- package/dist/data-display/Avatar.js.map +2 -2
- package/dist/data-display/AvatarButton.d.ts +20 -5
- package/dist/data-display/AvatarButton.js +17 -2
- package/dist/data-display/AvatarButton.js.map +2 -2
- package/dist/data-display/AvatarGroup.d.ts +28 -12
- package/dist/data-display/AvatarGroup.js +21 -32
- package/dist/data-display/AvatarGroup.js.map +2 -2
- package/dist/data-display/Badge.d.ts +11 -8
- package/dist/data-display/Badge.js +4 -3
- package/dist/data-display/Badge.js.map +2 -2
- package/dist/data-display/List.d.ts +21 -9
- package/dist/data-display/List.js +1 -1
- package/dist/data-display/List.js.map +2 -2
- package/dist/data-display/Meter.d.ts +7 -1
- package/dist/data-display/Meter.js +11 -5
- package/dist/data-display/Meter.js.map +2 -2
- package/dist/data-display/RelativeTime.d.ts +8 -2
- package/dist/data-display/RelativeTime.js +18 -7
- package/dist/data-display/RelativeTime.js.map +2 -2
- package/dist/data-display/Table.d.ts +26 -7
- package/dist/data-display/Table.js +70 -65
- package/dist/data-display/Table.js.map +2 -2
- package/dist/data-display/formatRelativeTime.d.ts +0 -2
- package/dist/data-display/formatRelativeTime.js +4 -28
- package/dist/data-display/formatRelativeTime.js.map +2 -2
- package/dist/data-display/internal/ListNaming.js +1 -1
- package/dist/data-display/internal/ListNaming.js.map +1 -1
- package/dist/data-display/internal/ReorderableList.d.ts +3 -2
- package/dist/data-display/internal/ReorderableList.js +11 -16
- package/dist/data-display/internal/ReorderableList.js.map +2 -2
- package/dist/data-display/internal/avatarName.d.ts +2 -0
- package/dist/data-display/internal/avatarName.js +7 -0
- package/dist/data-display/internal/avatarName.js.map +7 -0
- package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
- package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
- package/dist/data-display/internal/listMarkup.js.map +7 -0
- package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
- package/dist/data-display/internal/relativeTimeFormat.js +12 -0
- package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
- package/dist/data-display/internal/reorderController.js +3 -3
- package/dist/data-display/internal/reorderController.js.map +2 -2
- package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
- package/dist/data-display/internal/reorderGeometry.js +1 -10
- package/dist/data-display/internal/reorderGeometry.js.map +2 -2
- package/dist/data-display/internal/tableColumns.js +8 -9
- package/dist/data-display/internal/tableColumns.js.map +2 -2
- package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
- package/dist/data-display/internal/tableStacking.js +49 -0
- package/dist/data-display/internal/tableStacking.js.map +7 -0
- package/dist/data-display/internal/useReorder.js +1 -1
- package/dist/data-display/internal/useReorder.js.map +1 -1
- package/dist/diff.d.ts +1 -1
- package/dist/diff.js +1 -4
- package/dist/diff.js.map +2 -2
- package/dist/feedback/Alert.d.ts +13 -3
- package/dist/feedback/Alert.js +16 -6
- package/dist/feedback/Alert.js.map +2 -2
- package/dist/feedback/EmptyState.d.ts +12 -3
- package/dist/feedback/EmptyState.js +6 -6
- package/dist/feedback/EmptyState.js.map +2 -2
- package/dist/feedback/Halo.d.ts +27 -0
- package/dist/feedback/Halo.js +21 -0
- package/dist/feedback/Halo.js.map +7 -0
- package/dist/feedback/Progress.js +3 -2
- package/dist/feedback/Progress.js.map +2 -2
- package/dist/feedback/toast/ToastProvider.js +1 -1
- package/dist/feedback/toast/ToastProvider.js.map +1 -1
- package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
- package/dist/feedback/toast/internal/ContainedToast.js +43 -0
- package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
- package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
- package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
- package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
- package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
- package/dist/feedback/toast/internal/LiveToast.js +78 -0
- package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
- package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
- package/dist/feedback/toast/internal/ToastBody.js +6 -2
- package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
- package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
- package/dist/feedback/toast/internal/ToastButtons.js +77 -0
- package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
- package/dist/feedback/toast/internal/ToastRegion.js +43 -172
- package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
- package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
- package/dist/feedback/toast/internal/toastEntry.js +10 -1
- package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
- package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
- package/dist/feedback/toast/internal/useToastController.js +4 -2
- package/dist/feedback/toast/internal/useToastController.js.map +2 -2
- package/dist/feedback/toast/internal/useToastGlide.js +2 -1
- package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
- package/dist/feedback/toast/toastTypes.d.ts +38 -11
- package/dist/feedback/toast/useToast.d.ts +0 -2
- package/dist/feedback/toast/useToast.js +2 -3
- package/dist/feedback/toast/useToast.js.map +2 -2
- package/dist/forms/Calendar.d.ts +30 -11
- package/dist/forms/Calendar.js +19 -13
- package/dist/forms/Calendar.js.map +2 -2
- package/dist/forms/Checkbox.d.ts +7 -1
- package/dist/forms/Checkbox.js +33 -27
- package/dist/forms/Checkbox.js.map +2 -2
- package/dist/forms/Combobox.d.ts +4 -4
- package/dist/forms/Combobox.js +26 -146
- package/dist/forms/Combobox.js.map +2 -2
- package/dist/forms/DatePicker.d.ts +38 -11
- package/dist/forms/DatePicker.js +32 -52
- package/dist/forms/DatePicker.js.map +2 -2
- package/dist/forms/DropZone.d.ts +23 -4
- package/dist/forms/DropZone.js +29 -11
- package/dist/forms/DropZone.js.map +2 -2
- package/dist/forms/Field.d.ts +7 -1
- package/dist/forms/Field.js +13 -6
- package/dist/forms/Field.js.map +2 -2
- package/dist/forms/MonthPicker.d.ts +8 -1
- package/dist/forms/MonthPicker.js +22 -42
- package/dist/forms/MonthPicker.js.map +2 -2
- package/dist/forms/Radio.d.ts +15 -5
- package/dist/forms/Radio.js +20 -18
- package/dist/forms/Radio.js.map +2 -2
- package/dist/forms/SearchField.d.ts +13 -5
- package/dist/forms/SearchField.js +26 -21
- package/dist/forms/SearchField.js.map +2 -2
- package/dist/forms/SegmentedControl.d.ts +37 -8
- package/dist/forms/SegmentedControl.js +31 -25
- package/dist/forms/SegmentedControl.js.map +2 -2
- package/dist/forms/Select.d.ts +31 -6
- package/dist/forms/Select.js +43 -24
- package/dist/forms/Select.js.map +2 -2
- package/dist/forms/Slider.d.ts +12 -4
- package/dist/forms/Slider.js +32 -21
- package/dist/forms/Slider.js.map +2 -2
- package/dist/forms/Switch.d.ts +7 -1
- package/dist/forms/Switch.js +31 -25
- package/dist/forms/Switch.js.map +2 -2
- package/dist/forms/TextField.d.ts +5 -5
- package/dist/forms/TextField.js +20 -11
- package/dist/forms/TextField.js.map +2 -2
- package/dist/forms/Textarea.d.ts +1 -1
- package/dist/forms/Textarea.js +12 -2
- package/dist/forms/Textarea.js.map +2 -2
- package/dist/forms/TimePicker.d.ts +8 -1
- package/dist/forms/TimePicker.js +20 -45
- package/dist/forms/TimePicker.js.map +2 -2
- package/dist/forms/color/ColorPicker.d.ts +1 -1
- package/dist/forms/color/ColorPicker.js +29 -23
- package/dist/forms/color/ColorPicker.js.map +2 -2
- package/dist/forms/color/ColorPickerButton.d.ts +12 -2
- package/dist/forms/color/ColorPickerButton.js +37 -22
- package/dist/forms/color/ColorPickerButton.js.map +2 -2
- package/dist/forms/color/ColorSwatch.js +2 -2
- package/dist/forms/color/ColorSwatch.js.map +2 -2
- package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
- package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
- package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
- package/dist/forms/color/internal/ColorLocale.js +2 -8
- package/dist/forms/color/internal/ColorLocale.js.map +2 -2
- package/dist/forms/color/internal/ColorValues.d.ts +1 -1
- package/dist/forms/color/internal/ColorValues.js +2 -2
- package/dist/forms/color/internal/ColorValues.js.map +2 -2
- package/dist/forms/color/internal/SwatchList.js +6 -9
- package/dist/forms/color/internal/SwatchList.js.map +2 -2
- package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
- package/dist/forms/color/internal/colorValue.d.ts +1 -0
- package/dist/forms/color/internal/colorValue.js +5 -0
- package/dist/forms/color/internal/colorValue.js.map +2 -2
- package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
- package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
- package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
- package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
- package/dist/forms/color/internal/useFormResetting.js +36 -0
- package/dist/forms/color/internal/useFormResetting.js.map +7 -0
- package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
- package/dist/forms/color/internal/useSwatchFocus.js +62 -0
- package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
- package/dist/forms/internal/ComboboxField.d.ts +30 -0
- package/dist/forms/internal/ComboboxField.js +147 -0
- package/dist/forms/internal/ComboboxField.js.map +7 -0
- package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
- package/dist/forms/internal/ComboboxPopup.js +8 -16
- package/dist/forms/internal/ComboboxPopup.js.map +2 -2
- package/dist/forms/internal/MonthGrid.d.ts +1 -1
- package/dist/forms/internal/MonthGrid.js +4 -4
- package/dist/forms/internal/MonthGrid.js.map +2 -2
- package/dist/forms/internal/PickerField.d.ts +32 -27
- package/dist/forms/internal/PickerField.js +70 -52
- package/dist/forms/internal/PickerField.js.map +3 -3
- package/dist/forms/internal/PickerPopup.d.ts +2 -1
- package/dist/forms/internal/PickerPopup.js +3 -0
- package/dist/forms/internal/PickerPopup.js.map +2 -2
- package/dist/forms/internal/TimeList.d.ts +1 -1
- package/dist/forms/internal/TimeList.js +4 -4
- package/dist/forms/internal/TimeList.js.map +2 -2
- package/dist/forms/internal/TimeWheel.d.ts +3 -3
- package/dist/forms/internal/TimeWheel.js +5 -5
- package/dist/forms/internal/TimeWheel.js.map +2 -2
- package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
- package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
- package/dist/forms/internal/calendarDays.js.map +7 -0
- package/dist/forms/internal/comboboxItems.d.ts +15 -4
- package/dist/forms/internal/comboboxItems.js +0 -12
- package/dist/forms/internal/comboboxItems.js.map +3 -3
- package/dist/forms/internal/pickerFocus.d.ts +4 -0
- package/dist/forms/internal/pickerFocus.js +13 -0
- package/dist/forms/internal/pickerFocus.js.map +7 -0
- package/dist/forms/internal/timeWheelRows.d.ts +4 -4
- package/dist/forms/internal/timeWheelRows.js +6 -4
- package/dist/forms/internal/timeWheelRows.js.map +2 -2
- package/dist/forms/internal/useComboboxOpen.js +2 -5
- package/dist/forms/internal/useComboboxOpen.js.map +2 -2
- package/dist/forms/internal/useComboboxOptions.js +3 -4
- package/dist/forms/internal/useComboboxOptions.js.map +2 -2
- package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
- package/dist/forms/internal/usePicker.d.ts +29 -0
- package/dist/forms/internal/usePicker.js +38 -0
- package/dist/forms/internal/usePicker.js.map +7 -0
- package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
- package/dist/forms/internal/usePickerFormatter.js +23 -0
- package/dist/forms/internal/usePickerFormatter.js.map +7 -0
- package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
- package/dist/forms/internal/useTimeWheelTurn.js +7 -7
- package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
- package/dist/foundations/PortalContainer.js +1 -1
- package/dist/foundations/PortalContainer.js.map +1 -1
- package/dist/foundations/Theme.d.ts +9 -2
- package/dist/foundations/Theme.js +24 -19
- package/dist/foundations/Theme.js.map +2 -2
- package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
- package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
- package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
- package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
- package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
- package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
- package/dist/foundations/ThemeToggle.d.ts +9 -2
- package/dist/foundations/ThemeToggle.js +3 -2
- package/dist/foundations/ThemeToggle.js.map +2 -2
- package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
- package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
- package/dist/foundations/internal/storedPreference.d.ts +3 -0
- package/dist/foundations/internal/storedPreference.js +8 -0
- package/dist/foundations/internal/storedPreference.js.map +7 -0
- package/dist/foundations/messages/defaultMessages.d.ts +4 -72
- package/dist/foundations/messages/defaultMessages.js +0 -14
- package/dist/foundations/messages/defaultMessages.js.map +2 -2
- package/dist/foundations/messages/list.d.ts +13 -35
- package/dist/foundations/messages/list.js +1 -5
- package/dist/foundations/messages/list.js.map +2 -2
- package/dist/foundations/messages/message.d.ts +1 -1
- package/dist/foundations/messages/message.js +1 -1
- package/dist/foundations/messages/message.js.map +1 -1
- package/dist/foundations/messages/navigation.d.ts +4 -0
- package/dist/foundations/messages/navigation.js +2 -0
- package/dist/foundations/messages/navigation.js.map +2 -2
- package/dist/foundations/themeBootstrap.d.ts +13 -35
- package/dist/foundations/themeBootstrap.js +4 -35
- package/dist/foundations/themeBootstrap.js.map +2 -2
- package/dist/foundations/themeStorage.d.ts +20 -0
- package/dist/foundations/themeStorage.js +12 -0
- package/dist/foundations/themeStorage.js.map +7 -0
- package/dist/foundations/useContainerSize.js +13 -11
- package/dist/foundations/useContainerSize.js.map +2 -2
- package/dist/foundations/useSkeleton.d.ts +5 -0
- package/dist/foundations/useSkeleton.js +10 -0
- package/dist/foundations/useSkeleton.js.map +7 -0
- package/dist/foundations/useStoredThemePreference.d.ts +16 -0
- package/dist/foundations/useStoredThemePreference.js +63 -0
- package/dist/foundations/useStoredThemePreference.js.map +7 -0
- package/dist/foundations/windowClasses.d.ts +0 -2
- package/dist/foundations/windowClasses.js +1 -4
- package/dist/foundations/windowClasses.js.map +2 -2
- package/dist/index.d.ts +15 -20
- package/dist/index.js +16 -36
- package/dist/index.js.map +2 -2
- package/dist/internal/control/ActionElement.d.ts +3 -2
- package/dist/internal/control/ActionElement.js +8 -0
- package/dist/internal/control/ActionElement.js.map +2 -2
- package/dist/internal/dialog/ModalLayer.d.ts +9 -0
- package/dist/internal/dialog/ModalLayer.js +32 -0
- package/dist/internal/dialog/ModalLayer.js.map +7 -0
- package/dist/internal/dom/idRefs.d.ts +2 -0
- package/dist/internal/dom/idRefs.js +7 -0
- package/dist/internal/dom/idRefs.js.map +7 -0
- package/dist/internal/dom/lengths.d.ts +3 -1
- package/dist/internal/dom/lengths.js +7 -2
- package/dist/internal/dom/lengths.js.map +2 -2
- package/dist/internal/dom/observeResize.d.ts +7 -0
- package/dist/internal/dom/observeResize.js +11 -0
- package/dist/internal/dom/observeResize.js.map +7 -0
- package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
- package/dist/internal/dom/verticalScrollerOf.js +12 -0
- package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
- package/dist/internal/field/FieldFrame.d.ts +2 -61
- package/dist/internal/field/FieldFrame.js +17 -8
- package/dist/internal/field/FieldFrame.js.map +2 -2
- package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
- package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
- package/dist/internal/field/RowControl.js.map +7 -0
- package/dist/internal/field/TextareaControl.d.ts +2 -2
- package/dist/internal/field/TextareaControl.js +5 -11
- package/dist/internal/field/TextareaControl.js.map +2 -2
- package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
- package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
- package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
- package/dist/internal/field/fieldProps.d.ts +67 -0
- package/dist/internal/field/fieldProps.js +1 -0
- package/dist/internal/field/fieldProps.js.map +7 -0
- package/dist/internal/field/fieldSizing.d.ts +1 -0
- package/dist/internal/field/fieldSizing.js +5 -0
- package/dist/internal/field/fieldSizing.js.map +7 -0
- package/dist/internal/field/useFieldControl.d.ts +36 -0
- package/dist/internal/field/useFieldControl.js +53 -0
- package/dist/internal/field/useFieldControl.js.map +7 -0
- package/dist/internal/field/useFormReset.js +1 -1
- package/dist/internal/field/useFormReset.js.map +1 -1
- package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
- package/dist/internal/icon/DecorativeIcon.js +6 -2
- package/dist/internal/icon/DecorativeIcon.js.map +2 -2
- package/dist/internal/layout/Slot.d.ts +2 -1
- package/dist/internal/layout/Slot.js +3 -1
- package/dist/internal/layout/Slot.js.map +2 -2
- package/dist/internal/popup/ListRow.d.ts +39 -0
- package/dist/internal/{list → popup}/ListRow.js +15 -7
- package/dist/internal/popup/ListRow.js.map +7 -0
- package/dist/internal/popup/PopupSurface.d.ts +1 -1
- package/dist/internal/popup/PopupSurface.js +3 -6
- package/dist/internal/popup/PopupSurface.js.map +2 -2
- package/dist/internal/popup/TooltipPopup.d.ts +3 -9
- package/dist/internal/popup/TooltipPopup.js +2 -9
- package/dist/internal/popup/TooltipPopup.js.map +2 -2
- package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
- package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
- package/dist/internal/popup/containedOverlays.js.map +7 -0
- package/dist/internal/popup/listEntries.d.ts +13 -0
- package/dist/internal/popup/listEntries.js +11 -0
- package/dist/internal/popup/listEntries.js.map +7 -0
- package/dist/internal/popup/useCutShort.d.ts +6 -0
- package/dist/internal/popup/useCutShort.js +19 -0
- package/dist/internal/popup/useCutShort.js.map +7 -0
- package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
- package/dist/internal/provider/PortalContainerContext.js +11 -0
- package/dist/internal/provider/PortalContainerContext.js.map +7 -0
- package/dist/internal/provider/formatters.d.ts +17 -0
- package/dist/internal/provider/formatters.js +21 -0
- package/dist/internal/provider/formatters.js.map +7 -0
- package/dist/internal/provider/locale.d.ts +4 -4
- package/dist/internal/provider/locale.js +9 -1
- package/dist/internal/provider/locale.js.map +2 -2
- package/dist/internal/provider/useDirection.d.ts +1 -1
- package/dist/internal/provider/useDirection.js +2 -14
- package/dist/internal/provider/useDirection.js.map +2 -2
- package/dist/internal/provider/useFormatters.d.ts +1 -16
- package/dist/internal/provider/useFormatters.js +3 -26
- package/dist/internal/provider/useFormatters.js.map +2 -2
- package/dist/internal/rangeBarProps.d.ts +6 -2
- package/dist/internal/react/chainHandlers.d.ts +6 -0
- package/dist/internal/react/chainHandlers.js +12 -0
- package/dist/internal/react/chainHandlers.js.map +7 -0
- package/dist/internal/react/renderElement.js +2 -14
- package/dist/internal/react/renderElement.js.map +2 -2
- package/dist/internal/react/rendersContent.d.ts +2 -0
- package/dist/internal/react/rendersContent.js +7 -0
- package/dist/internal/react/rendersContent.js.map +7 -0
- package/dist/internal/react/setRef.d.ts +6 -1
- package/dist/internal/react/setRef.js +13 -0
- package/dist/internal/react/setRef.js.map +2 -2
- package/dist/internal/react/useControllableState.js +1 -1
- package/dist/internal/react/useControllableState.js.map +1 -1
- package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
- package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
- package/dist/internal/react/useMergedRefs.d.ts +3 -0
- package/dist/internal/react/useMergedRefs.js +10 -0
- package/dist/internal/react/useMergedRefs.js.map +7 -0
- package/dist/internal/resize/useResizableWidth.d.ts +4 -16
- package/dist/internal/resize/useResizableWidth.js +5 -17
- package/dist/internal/resize/useResizableWidth.js.map +2 -2
- package/dist/internal/sizeTokens.d.ts +13 -0
- package/dist/internal/sizeTokens.js +15 -0
- package/dist/internal/sizeTokens.js.map +7 -0
- package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
- package/dist/internal/skeleton/SkeletonContext.js +7 -0
- package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
- package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
- package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
- package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
- package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
- package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
- package/dist/internal/skeleton/skeleton.js.map +7 -0
- package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
- package/dist/internal/skeleton/skeletonText.js.map +7 -0
- package/dist/internal/text/labelText.d.ts +15 -0
- package/dist/internal/text/labelText.js +34 -0
- package/dist/internal/text/labelText.js.map +7 -0
- package/dist/internal/text/useRenderedText.d.ts +3 -0
- package/dist/internal/text/useRenderedText.js +19 -0
- package/dist/internal/text/useRenderedText.js.map +7 -0
- package/dist/internal/theme/themeRoot.d.ts +27 -0
- package/dist/internal/theme/themeRoot.js +45 -0
- package/dist/internal/theme/themeRoot.js.map +7 -0
- package/dist/internal/typeahead.d.ts +9 -5
- package/dist/internal/typeahead.js +4 -1
- package/dist/internal/typeahead.js.map +2 -2
- package/dist/layout/Card.d.ts +21 -4
- package/dist/layout/Card.js +12 -6
- package/dist/layout/Card.js.map +2 -2
- package/dist/layout/Layout.d.ts +2 -2
- package/dist/layout/Layout.js.map +1 -1
- package/dist/layout/Page.d.ts +2 -2
- package/dist/layout/Page.js.map +1 -1
- package/dist/layout/PageHeader.d.ts +6 -1
- package/dist/layout/PageHeader.js +3 -1
- package/dist/layout/PageHeader.js.map +2 -2
- package/dist/layout/Panes.d.ts +10 -20
- package/dist/layout/Panes.js +5 -25
- package/dist/layout/Panes.js.map +2 -2
- package/dist/layout/ResizeHandle.d.ts +1 -0
- package/dist/layout/ResizeHandle.js +11 -21
- package/dist/layout/ResizeHandle.js.map +2 -2
- package/dist/layout/Scaffold.d.ts +14 -4
- package/dist/layout/Scaffold.js +16 -51
- package/dist/layout/Scaffold.js.map +2 -2
- package/dist/layout/Surface.d.ts +1 -1
- package/dist/layout/Surface.js +4 -1
- package/dist/layout/Surface.js.map +2 -2
- package/dist/layout/TopBar.d.ts +2 -2
- package/dist/layout/TopBar.js +4 -5
- package/dist/layout/TopBar.js.map +2 -2
- package/dist/layout/internal/LoadingBar.d.ts +3 -7
- package/dist/layout/internal/LoadingBar.js +5 -10
- package/dist/layout/internal/LoadingBar.js.map +2 -2
- package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
- package/dist/layout/internal/PageTitleFocus.js +3 -24
- package/dist/layout/internal/PageTitleFocus.js.map +2 -2
- package/dist/layout/internal/StickyHeaderSize.js +3 -3
- package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
- package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
- package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
- package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
- package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
- package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
- package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
- package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
- package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
- package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffoldPages.d.ts +9 -0
- package/dist/layout/internal/scaffoldPages.js +27 -0
- package/dist/layout/internal/scaffoldPages.js.map +7 -0
- package/dist/markdown.d.ts +0 -1
- package/dist/markdown.js +0 -1
- package/dist/markdown.js.map +2 -2
- package/dist/messages.d.ts +1 -1
- package/dist/messages.js +1 -6
- package/dist/messages.js.map +2 -2
- package/dist/navigation/Breadcrumbs.d.ts +15 -4
- package/dist/navigation/Breadcrumbs.js +36 -27
- package/dist/navigation/Breadcrumbs.js.map +2 -2
- package/dist/navigation/DocumentTabs.d.ts +54 -12
- package/dist/navigation/DocumentTabs.js +50 -150
- package/dist/navigation/DocumentTabs.js.map +3 -3
- package/dist/navigation/NavigationBar.d.ts +10 -3
- package/dist/navigation/NavigationBar.js +75 -35
- package/dist/navigation/NavigationBar.js.map +2 -2
- package/dist/navigation/NavigationDrawer.d.ts +9 -3
- package/dist/navigation/NavigationDrawer.js +24 -217
- package/dist/navigation/NavigationDrawer.js.map +2 -2
- package/dist/navigation/NavigationRail.d.ts +10 -3
- package/dist/navigation/NavigationRail.js +20 -10
- package/dist/navigation/NavigationRail.js.map +2 -2
- package/dist/navigation/Pager.d.ts +25 -11
- package/dist/navigation/Pager.js +49 -12
- package/dist/navigation/Pager.js.map +3 -3
- package/dist/navigation/Pagination.d.ts +24 -9
- package/dist/navigation/Pagination.js +37 -11
- package/dist/navigation/Pagination.js.map +2 -2
- package/dist/navigation/TableOfContents.d.ts +18 -4
- package/dist/navigation/TableOfContents.js +41 -121
- package/dist/navigation/TableOfContents.js.map +2 -2
- package/dist/navigation/Tree.d.ts +28 -11
- package/dist/navigation/Tree.js +41 -37
- package/dist/navigation/Tree.js.map +2 -2
- package/dist/navigation/destinations.d.ts +43 -11
- package/dist/navigation/internal/DestinationItem.d.ts +5 -41
- package/dist/navigation/internal/DestinationItem.js +41 -44
- package/dist/navigation/internal/DestinationItem.js.map +2 -2
- package/dist/navigation/internal/destinationModel.d.ts +16 -0
- package/dist/navigation/internal/destinationModel.js +28 -0
- package/dist/navigation/internal/destinationModel.js.map +7 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
- package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
- package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
- package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
- package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
- package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
- package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
- package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
- package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
- package/dist/navigation/internal/landmarkLabel.js +5 -0
- package/dist/navigation/internal/landmarkLabel.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
- package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
- package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
- package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
- package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
- package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
- package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
- package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
- package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
- package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
- package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
- package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
- package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
- package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
- package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
- package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
- package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
- package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
- package/dist/navigation/internal/tree/treeModel.js.map +7 -0
- package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
- package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
- package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
- package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
- package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
- package/dist/navigation/internal/useLabelText.d.ts +6 -0
- package/dist/navigation/internal/useLabelText.js +11 -0
- package/dist/navigation/internal/useLabelText.js.map +7 -0
- package/dist/navigation/navigationBackground.d.ts +0 -2
- package/dist/navigation/navigationBackground.js +0 -6
- package/dist/navigation/navigationBackground.js.map +3 -3
- package/dist/overlays/ConfirmDialog.d.ts +6 -3
- package/dist/overlays/ConfirmDialog.js +64 -68
- package/dist/overlays/ConfirmDialog.js.map +2 -2
- package/dist/overlays/Dialog.d.ts +40 -6
- package/dist/overlays/Dialog.js +69 -41
- package/dist/overlays/Dialog.js.map +2 -2
- package/dist/overlays/HoverCard.d.ts +9 -2
- package/dist/overlays/HoverCard.js +5 -5
- package/dist/overlays/HoverCard.js.map +2 -2
- package/dist/overlays/Popover.d.ts +20 -5
- package/dist/overlays/Popover.js +8 -6
- package/dist/overlays/Popover.js.map +2 -2
- package/dist/overlays/Sheet.d.ts +16 -3
- package/dist/overlays/Sheet.js +88 -87
- package/dist/overlays/Sheet.js.map +2 -2
- package/dist/overlays/Tooltip.d.ts +7 -0
- package/dist/overlays/Tooltip.js +10 -15
- package/dist/overlays/Tooltip.js.map +2 -2
- package/dist/overlays/internal/accessibleName.js +2 -1
- package/dist/overlays/internal/accessibleName.js.map +2 -2
- package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
- package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
- package/dist/overlays/internal/dialog/DialogParts.js +64 -0
- package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
- package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
- package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
- package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
- package/dist/styles/Accordion.css +1 -1
- package/dist/styles/Alert.css +1 -1
- package/dist/styles/Avatar.css +1 -1
- package/dist/styles/Badge.css +1 -1
- package/dist/styles/Base.css +1 -1
- package/dist/styles/Breadcrumbs.css +1 -1
- package/dist/styles/Card.css +1 -1
- package/dist/styles/Checkbox.css +1 -1
- package/dist/styles/Code.css +1 -1
- package/dist/styles/Combobox.css +1 -1
- package/dist/styles/CommandPalette.css +1 -1
- package/dist/styles/Composer.css +1 -1
- package/dist/styles/CopyButton.css +1 -1
- package/dist/styles/Dialog.css +1 -1
- package/dist/styles/Disclosure.css +1 -1
- package/dist/styles/DocumentTabs.css +1 -1
- package/dist/styles/DropZone.css +1 -1
- package/dist/styles/EmptyState.css +1 -1
- package/dist/styles/Halo.css +1 -0
- package/dist/styles/List.css +1 -1
- package/dist/styles/ListRow.css +1 -1
- package/dist/styles/LoadingBar.css +1 -1
- package/dist/styles/Menu.css +1 -1
- package/dist/styles/Message.css +1 -1
- package/dist/styles/Meter.css +1 -1
- package/dist/styles/NavigationBar.css +1 -1
- package/dist/styles/NavigationDestinations.css +1 -0
- package/dist/styles/NavigationDrawer.css +1 -1
- package/dist/styles/NavigationRail.css +1 -1
- package/dist/styles/Pager.css +1 -1
- package/dist/styles/Panes.css +1 -1
- package/dist/styles/Progress.css +1 -0
- package/dist/styles/Radio.css +1 -1
- package/dist/styles/Scaffold.css +1 -1
- package/dist/styles/SegmentedControl.css +1 -1
- package/dist/styles/Select.css +1 -1
- package/dist/styles/Switch.css +1 -1
- package/dist/styles/Table.css +1 -1
- package/dist/styles/TableOfContents.css +1 -1
- package/dist/styles/Text.css +1 -1
- package/dist/styles/TextField.css +1 -1
- package/dist/styles/Toast.css +1 -1
- package/dist/styles/Toolbar.css +1 -1
- package/dist/styles/Tree.css +1 -1
- package/dist/styles.css +1 -1
- package/dist/theme-bootstrap.d.ts +1 -1
- package/dist/theme-bootstrap.js +1 -8
- package/dist/theme-bootstrap.js.map +2 -2
- package/dist/theme-storage.d.ts +2 -0
- package/dist/theme-storage.js +3 -0
- package/dist/theme-storage.js.map +7 -0
- package/dist/tokens.json +0 -13
- package/docs/components/accordion.md +13 -0
- package/docs/components/alert.md +8 -1
- package/docs/components/avatar.md +16 -4
- package/docs/components/badge.md +10 -39
- package/docs/components/box.md +3 -3
- package/docs/components/breadcrumbs.md +6 -1
- package/docs/components/button.md +14 -9
- package/docs/components/card.md +14 -5
- package/docs/components/checkbox.md +3 -1
- package/docs/components/code.md +15 -6
- package/docs/components/color-picker.md +10 -2
- package/docs/components/column.md +2 -2
- package/docs/components/combobox.md +1 -1
- package/docs/components/command-palette.md +6 -2
- package/docs/components/composer.md +19 -8
- package/docs/components/confirm-dialog.md +3 -3
- package/docs/components/date-picker.md +15 -3
- package/docs/components/description-list.md +1 -1
- package/docs/components/dialog.md +34 -8
- package/docs/components/disclosure.md +4 -0
- package/docs/components/document-tabs.md +23 -13
- package/docs/components/drop-zone.md +10 -1
- package/docs/components/empty-state.md +12 -3
- package/docs/components/field.md +2 -1
- package/docs/components/graphic.md +1 -1
- package/docs/components/grid.md +2 -2
- package/docs/components/halo.md +80 -0
- package/docs/components/hover-card.md +2 -1
- package/docs/components/kbd.md +8 -2
- package/docs/components/link.md +1 -1
- package/docs/components/list.md +13 -5
- package/docs/components/markdown.md +9 -116
- package/docs/components/menu.md +28 -12
- package/docs/components/menubar.md +4 -3
- package/docs/components/message.md +17 -13
- package/docs/components/meter.md +8 -3
- package/docs/components/month-picker.md +4 -2
- package/docs/components/navigation-drawer.md +32 -7
- package/docs/components/page.md +4 -3
- package/docs/components/pager.md +16 -6
- package/docs/components/pagination.md +3 -2
- package/docs/components/panes.md +13 -26
- package/docs/components/popover.md +3 -2
- package/docs/components/progress.md +2 -2
- package/docs/components/radio.md +13 -5
- package/docs/components/relative-time.md +2 -1
- package/docs/components/resize-handle.md +6 -4
- package/docs/components/row.md +2 -2
- package/docs/components/scaffold.md +13 -4
- package/docs/components/segmented-control.md +10 -4
- package/docs/components/select.md +10 -2
- package/docs/components/sheet.md +4 -1
- package/docs/components/slider.md +8 -2
- package/docs/components/spinner.md +1 -1
- package/docs/components/surface.md +1 -1
- package/docs/components/switch.md +2 -0
- package/docs/components/table-of-contents.md +3 -2
- package/docs/components/table.md +18 -3
- package/docs/components/text-field.md +14 -8
- package/docs/components/time-picker.md +4 -2
- package/docs/components/toast.md +2 -1
- package/docs/components/toolbar.md +31 -6
- package/docs/components/tooltip.md +1 -0
- package/docs/components/top-bar.md +1 -1
- package/docs/components/tree.md +9 -4
- package/docs/customizing.md +59 -91
- package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
- package/docs/examples/alert/BannerAction.tsx +19 -0
- package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
- package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
- package/docs/examples/badge/CountsInButtons.tsx +2 -2
- package/docs/examples/badge/WithContent.tsx +13 -0
- package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
- package/docs/examples/button/ButtonAnatomy.tsx +1 -1
- package/docs/examples/button/CreateProject.tsx +1 -1
- package/docs/examples/button/FillSidebar.tsx +1 -1
- package/docs/examples/button/Icons.tsx +2 -2
- package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
- package/docs/examples/card/CardAnatomy.tsx +3 -1
- package/docs/examples/card/OpenFromCard.tsx +65 -0
- package/docs/examples/code/PackageManagers.tsx +35 -0
- package/docs/examples/code/SettingsDiff.tsx +5 -9
- package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
- package/docs/examples/colors/Status.tsx +6 -6
- package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
- package/docs/examples/command-palette/GoToDocument.tsx +17 -14
- package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
- package/docs/examples/command-palette/RunCommand.tsx +16 -12
- package/docs/examples/command-palette/SearchButton.tsx +2 -2
- package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
- package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
- package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
- package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
- package/docs/examples/dialog/EditMember.tsx +28 -0
- package/docs/examples/dialog/FindPlan.tsx +1 -1
- package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
- package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
- package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
- package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
- package/docs/examples/empty-state/WithIllustration.tsx +22 -0
- package/docs/examples/graphic/Colors.tsx +1 -1
- package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
- package/docs/examples/halo/AroundACard.tsx +14 -0
- package/docs/examples/halo/InviteTeam.tsx +15 -0
- package/docs/examples/halo/Tones.tsx +14 -0
- package/docs/examples/icons/FollowText.tsx +3 -3
- package/docs/examples/kbd/Sequences.tsx +10 -0
- package/docs/examples/list/TitleActions.tsx +32 -0
- package/docs/examples/menu/AccountSwitcher.tsx +32 -0
- package/docs/examples/menu/Choices.tsx +1 -1
- package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
- package/docs/examples/menu/Destinations.tsx +5 -5
- package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
- package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
- package/docs/examples/menu/MenuAnatomy.tsx +3 -3
- package/docs/examples/menu/Submenus.tsx +4 -4
- package/docs/examples/menubar/NotesMenubar.tsx +4 -4
- package/docs/examples/message/CommentThread.tsx +30 -0
- package/docs/examples/message/Conversation.tsx +7 -2
- package/docs/examples/meter/InlineUsage.tsx +10 -0
- package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
- package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
- package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
- package/docs/examples/page/WithHeader.tsx +1 -1
- package/docs/examples/page/WithToolbar.tsx +1 -1
- package/docs/examples/pager/LongTitles.tsx +2 -2
- package/docs/examples/pager/PagerAnatomy.tsx +2 -2
- package/docs/examples/pager/PreviousAndNext.tsx +2 -2
- package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
- package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
- package/docs/examples/panes/PanesAnatomy.tsx +20 -12
- package/docs/examples/panes/ResizableDetails.tsx +35 -2
- package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
- package/docs/examples/popover/DocumentDetails.tsx +1 -1
- package/docs/examples/popover/RenameInPlace.tsx +1 -1
- package/docs/examples/progress/ExportMembers.tsx +1 -1
- package/docs/examples/radio/PlanRows.tsx +35 -0
- package/docs/examples/relative-time/PastAndComing.tsx +6 -6
- package/docs/examples/relative-time/VersionLabels.tsx +5 -5
- package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
- package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
- package/docs/examples/row/SectionHeading.tsx +1 -1
- package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
- package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
- package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
- package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
- package/docs/examples/select/Assignee.tsx +29 -0
- package/docs/examples/select/SmallToolbar.tsx +23 -21
- package/docs/examples/sheet/FilterPanel.tsx +1 -1
- package/docs/examples/sheet/ShareChoices.tsx +1 -1
- package/docs/examples/slider/IconsAndUnits.tsx +42 -0
- package/docs/examples/spacing/Align.tsx +1 -1
- package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
- package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
- package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
- package/docs/examples/text-field/ContentAffixes.tsx +32 -0
- package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
- package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
- package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
- package/docs/examples/text-field/Variants.tsx +1 -1
- package/docs/examples/toast/ExportReady.tsx +7 -5
- package/docs/examples/toast/RetryAfterError.tsx +8 -6
- package/docs/examples/toast/ToastAnatomy.tsx +1 -1
- package/docs/examples/toast/TopCenter.tsx +1 -1
- package/docs/examples/toast/UndoArchive.tsx +10 -8
- package/docs/examples/toolbar/LabelledControls.tsx +40 -0
- package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
- package/docs/examples/tree/ContextMenuActions.tsx +5 -5
- package/docs/examples/tree/FileTree.tsx +1 -1
- package/docs/examples/tree/MatchedLetters.tsx +37 -0
- package/docs/examples/tree/NarrowTree.tsx +3 -3
- package/docs/examples/tree/RowDensity.tsx +6 -6
- package/docs/examples/tree/TreeAnatomy.tsx +2 -2
- package/docs/foundations/accessibility.md +3 -3
- package/docs/foundations/colors.md +2 -3
- package/docs/foundations/icons.md +3 -3
- package/docs/foundations/responsive.md +2 -2
- package/docs/foundations/spacing.md +2 -2
- package/docs/foundations/typography.md +2 -2
- package/docs/generated/exports.json +34 -52
- package/docs/generated/parts.json +469 -484
- package/docs/generated/props.json +1053 -903
- package/docs/index.md +52 -56
- package/docs/setup.md +62 -20
- package/docs/writing.md +1 -1
- package/package.json +6 -25
- package/dist/actions/internal/MenuPopup.js.map +0 -7
- package/dist/assets/readme/gallery-dark.png +0 -0
- package/dist/assets/readme/gallery-light.png +0 -0
- package/dist/content/MarkdownEditor.d.ts +0 -35
- package/dist/content/MarkdownEditor.js +0 -236
- package/dist/content/MarkdownEditor.js.map +0 -7
- package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
- package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
- package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
- package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
- package/dist/content/internal/markdown/markdownFormatting.js +0 -96
- package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
- package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
- package/dist/content/internal/markdown/markdownHistory.js +0 -54
- package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
- package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
- package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
- package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
- package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
- package/dist/data-display/AnimatedNumber.d.ts +0 -15
- package/dist/data-display/AnimatedNumber.js +0 -111
- package/dist/data-display/AnimatedNumber.js.map +0 -7
- package/dist/data-display/CalendarHeatmap.d.ts +0 -92
- package/dist/data-display/CalendarHeatmap.js +0 -224
- package/dist/data-display/CalendarHeatmap.js.map +0 -7
- package/dist/data-display/DiffStat.d.ts +0 -23
- package/dist/data-display/DiffStat.js +0 -42
- package/dist/data-display/DiffStat.js.map +0 -7
- package/dist/data-display/Rating.d.ts +0 -32
- package/dist/data-display/Rating.js +0 -45
- package/dist/data-display/Rating.js.map +0 -7
- package/dist/data-display/internal/ListRows.js.map +0 -7
- package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
- package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
- package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
- package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
- package/dist/data-display/internal/useHeatmapLabels.js +0 -56
- package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
- package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
- package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
- package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
- package/dist/dev/api.d.ts +0 -64
- package/dist/dev/api.js +0 -88
- package/dist/dev/api.js.map +0 -7
- package/dist/dev/elements.d.ts +0 -7
- package/dist/dev/elements.js +0 -32
- package/dist/dev/elements.js.map +0 -7
- package/dist/dev/inner.d.ts +0 -17
- package/dist/dev/inner.js +0 -139
- package/dist/dev/inner.js.map +0 -7
- package/dist/dev/install.d.ts +0 -64
- package/dist/dev/install.js +0 -128
- package/dist/dev/install.js.map +0 -7
- package/dist/dev/measure.d.ts +0 -10
- package/dist/dev/measure.js +0 -304
- package/dist/dev/measure.js.map +0 -7
- package/dist/dev/model.d.ts +0 -136
- package/dist/dev/model.js +0 -5
- package/dist/dev/model.js.map +0 -7
- package/dist/dev/overlays.d.ts +0 -5
- package/dist/dev/overlays.js +0 -52
- package/dist/dev/overlays.js.map +0 -7
- package/dist/dev/parts.d.ts +0 -49
- package/dist/dev/parts.js +0 -89
- package/dist/dev/parts.js.map +0 -7
- package/dist/dev/queries.d.ts +0 -28
- package/dist/dev/queries.js +0 -135
- package/dist/dev/queries.js.map +0 -7
- package/dist/dev/readout.d.ts +0 -9
- package/dist/dev/readout.js +0 -275
- package/dist/dev/readout.js.map +0 -7
- package/dist/dev/skeletonShift.d.ts +0 -6
- package/dist/dev/skeletonShift.js +0 -174
- package/dist/dev/skeletonShift.js.map +0 -7
- package/dist/dev/ui/Controls.d.ts +0 -20
- package/dist/dev/ui/Controls.js +0 -53
- package/dist/dev/ui/Controls.js.map +0 -7
- package/dist/dev/ui/DevMode.d.ts +0 -14
- package/dist/dev/ui/DevMode.js +0 -222
- package/dist/dev/ui/DevMode.js.map +0 -7
- package/dist/dev/ui/Frame.d.ts +0 -14
- package/dist/dev/ui/Frame.js +0 -178
- package/dist/dev/ui/Frame.js.map +0 -7
- package/dist/dev/ui/Icons.d.ts +0 -5
- package/dist/dev/ui/Icons.js +0 -38
- package/dist/dev/ui/Icons.js.map +0 -7
- package/dist/dev/ui/Inspector.d.ts +0 -24
- package/dist/dev/ui/Inspector.js +0 -366
- package/dist/dev/ui/Inspector.js.map +0 -7
- package/dist/dev/ui/Legend.d.ts +0 -4
- package/dist/dev/ui/Legend.js +0 -50
- package/dist/dev/ui/Legend.js.map +0 -7
- package/dist/dev/ui/NodeHints.d.ts +0 -15
- package/dist/dev/ui/NodeHints.js +0 -95
- package/dist/dev/ui/NodeHints.js.map +0 -7
- package/dist/dev/ui/PerformancePanel.d.ts +0 -3
- package/dist/dev/ui/PerformancePanel.js +0 -72
- package/dist/dev/ui/PerformancePanel.js.map +0 -7
- package/dist/dev/ui/Plane.d.ts +0 -37
- package/dist/dev/ui/Plane.js +0 -154
- package/dist/dev/ui/Plane.js.map +0 -7
- package/dist/dev/ui/View3D.d.ts +0 -19
- package/dist/dev/ui/View3D.js +0 -248
- package/dist/dev/ui/View3D.js.map +0 -7
- package/dist/dev/ui/ViewToolbar.d.ts +0 -40
- package/dist/dev/ui/ViewToolbar.js +0 -352
- package/dist/dev/ui/ViewToolbar.js.map +0 -7
- package/dist/dev/ui/camera.d.ts +0 -42
- package/dist/dev/ui/camera.js +0 -157
- package/dist/dev/ui/camera.js.map +0 -7
- package/dist/dev/ui/devices.d.ts +0 -9
- package/dist/dev/ui/devices.js +0 -34
- package/dist/dev/ui/devices.js.map +0 -7
- package/dist/dev/ui/editorTheme.d.ts +0 -6
- package/dist/dev/ui/editorTheme.js +0 -30
- package/dist/dev/ui/editorTheme.js.map +0 -7
- package/dist/dev/ui/sides.d.ts +0 -20
- package/dist/dev/ui/sides.js +0 -43
- package/dist/dev/ui/sides.js.map +0 -7
- package/dist/dev/ui/stats.d.ts +0 -25
- package/dist/dev/ui/stats.js +0 -26
- package/dist/dev/ui/stats.js.map +0 -7
- package/dist/dev/ui/surfaces.d.ts +0 -4
- package/dist/dev/ui/surfaces.js +0 -249
- package/dist/dev/ui/surfaces.js.map +0 -7
- package/dist/dev/ui/useLivePage.d.ts +0 -13
- package/dist/dev/ui/useLivePage.js +0 -138
- package/dist/dev/ui/useLivePage.js.map +0 -7
- package/dist/dev/ui/usePlaneHover.d.ts +0 -9
- package/dist/dev/ui/usePlaneHover.js +0 -46
- package/dist/dev/ui/usePlaneHover.js.map +0 -7
- package/dist/dev/ui/useViewFit.d.ts +0 -16
- package/dist/dev/ui/useViewFit.js +0 -59
- package/dist/dev/ui/useViewFit.js.map +0 -7
- package/dist/dev/ui/useViewWheel.d.ts +0 -11
- package/dist/dev/ui/useViewWheel.js +0 -48
- package/dist/dev/ui/useViewWheel.js.map +0 -7
- package/dist/dev/ui/wheel.d.ts +0 -7
- package/dist/dev/ui/wheel.js +0 -98
- package/dist/dev/ui/wheel.js.map +0 -7
- package/dist/dev/units.d.ts +0 -7
- package/dist/dev/units.js +0 -22
- package/dist/dev/units.js.map +0 -7
- package/dist/dev/usedTokens.d.ts +0 -5
- package/dist/dev/usedTokens.js +0 -56
- package/dist/dev/usedTokens.js.map +0 -7
- package/dist/dev.d.ts +0 -5
- package/dist/dev.js +0 -9
- package/dist/dev.js.map +0 -7
- package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
- package/dist/forms/color/internal/useColorState.d.ts +0 -10
- package/dist/forms/color/internal/useColorState.js +0 -49
- package/dist/forms/color/internal/useColorState.js.map +0 -7
- package/dist/forms/internal/usePickerValue.d.ts +0 -13
- package/dist/forms/internal/usePickerValue.js +0 -45
- package/dist/forms/internal/usePickerValue.js.map +0 -7
- package/dist/forms/internal/useRovingFocus.d.ts +0 -47
- package/dist/forms/internal/useRovingFocus.js +0 -179
- package/dist/forms/internal/useRovingFocus.js.map +0 -7
- package/dist/forms/rich-text/RichText.d.ts +0 -7
- package/dist/forms/rich-text/RichText.js +0 -91
- package/dist/forms/rich-text/RichText.js.map +0 -7
- package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
- package/dist/forms/rich-text/RichTextEditor.js +0 -225
- package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
- package/dist/forms/rich-text/extensions.d.ts +0 -10
- package/dist/forms/rich-text/extensions.js +0 -45
- package/dist/forms/rich-text/extensions.js.map +0 -7
- package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
- package/dist/forms/rich-text/internal/Listbox.js +0 -48
- package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
- package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
- package/dist/forms/rich-text/internal/Reference.js +0 -79
- package/dist/forms/rich-text/internal/Reference.js.map +0 -7
- package/dist/forms/rich-text/internal/commands.d.ts +0 -6
- package/dist/forms/rich-text/internal/commands.js +0 -74
- package/dist/forms/rich-text/internal/commands.js.map +0 -7
- package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
- package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
- package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
- package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
- package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
- package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
- package/dist/forms/rich-text/internal/suggestions.js +0 -185
- package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
- package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
- package/dist/forms/rich-text/internal/taskItem.js +0 -43
- package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
- package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
- package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
- package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
- package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
- package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
- package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
- package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
- package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
- package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
- package/dist/forms/rich-text/types.d.ts +0 -190
- package/dist/forms/rich-text/types.js +0 -1
- package/dist/foundations/SkeletonScope.js.map +0 -7
- package/dist/foundations/ThemePreference.d.ts +0 -35
- package/dist/foundations/ThemePreference.js.map +0 -7
- package/dist/foundations/internal/skeletonText.js.map +0 -7
- package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
- package/dist/foundations/messages/calendarHeatmap.js +0 -10
- package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
- package/dist/foundations/messages/diffStat.d.ts +0 -16
- package/dist/foundations/messages/diffStat.js +0 -17
- package/dist/foundations/messages/diffStat.js.map +0 -7
- package/dist/foundations/messages/editor.d.ts +0 -35
- package/dist/foundations/messages/editor.js +0 -34
- package/dist/foundations/messages/editor.js.map +0 -7
- package/dist/foundations/messages/linkDialog.d.ts +0 -20
- package/dist/foundations/messages/linkDialog.js +0 -20
- package/dist/foundations/messages/linkDialog.js.map +0 -7
- package/dist/foundations/messages/markdownEditor.d.ts +0 -26
- package/dist/foundations/messages/markdownEditor.js +0 -26
- package/dist/foundations/messages/markdownEditor.js.map +0 -7
- package/dist/foundations/messages/rating.d.ts +0 -11
- package/dist/foundations/messages/rating.js +0 -8
- package/dist/foundations/messages/rating.js.map +0 -7
- package/dist/foundations/messages/richText.d.ts +0 -34
- package/dist/foundations/messages/richText.js +0 -34
- package/dist/foundations/messages/richText.js.map +0 -7
- package/dist/internal/dialog/DialogParts.d.ts +0 -46
- package/dist/internal/dialog/DialogParts.js +0 -66
- package/dist/internal/dialog/DialogParts.js.map +0 -7
- package/dist/internal/dom/paints.d.ts +0 -5
- package/dist/internal/dom/paints.js +0 -17
- package/dist/internal/dom/paints.js.map +0 -7
- package/dist/internal/dom/useStripWheel.d.ts +0 -6
- package/dist/internal/dom/useStripWheel.js +0 -26
- package/dist/internal/dom/useStripWheel.js.map +0 -7
- package/dist/internal/editor/EditorStatus.d.ts +0 -8
- package/dist/internal/editor/EditorStatus.js +0 -11
- package/dist/internal/editor/EditorStatus.js.map +0 -7
- package/dist/internal/editor/EditorToolbar.d.ts +0 -28
- package/dist/internal/editor/EditorToolbar.js +0 -89
- package/dist/internal/editor/EditorToolbar.js.map +0 -7
- package/dist/internal/editor/LinkDialog.d.ts +0 -20
- package/dist/internal/editor/LinkDialog.js +0 -78
- package/dist/internal/editor/LinkDialog.js.map +0 -7
- package/dist/internal/editor/editorCommands.d.ts +0 -20
- package/dist/internal/editor/editorCommands.js +0 -45
- package/dist/internal/editor/editorCommands.js.map +0 -7
- package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
- package/dist/internal/field/rowControl.js.map +0 -7
- package/dist/internal/field/useFieldMetadata.d.ts +0 -16
- package/dist/internal/field/useFieldMetadata.js +0 -24
- package/dist/internal/field/useFieldMetadata.js.map +0 -7
- package/dist/internal/list/ListRow.d.ts +0 -33
- package/dist/internal/list/ListRow.js.map +0 -7
- package/dist/internal/popup/PortalContainerContext.js.map +0 -7
- package/dist/internal/react/useStackedReport.js +0 -28
- package/dist/internal/react/useStackedReport.js.map +0 -7
- package/dist/internal/skeleton.js.map +0 -7
- package/dist/internal/time/calendarDays.js.map +0 -7
- package/dist/layout/internal/navigationForms.js.map +0 -7
- package/dist/layout/internal/scrollKeys.js.map +0 -7
- package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
- package/dist/layout/internal/useScrollKeys.js.map +0 -7
- package/dist/layout/panesSize.d.ts +0 -13
- package/dist/layout/panesSize.js +0 -39
- package/dist/layout/panesSize.js.map +0 -7
- package/dist/navigation/internal/TreeRow.js.map +0 -7
- package/dist/navigation/internal/contentsOutline.d.ts +0 -60
- package/dist/navigation/internal/contentsOutline.js.map +0 -7
- package/dist/navigation/internal/contentsWave.js.map +0 -7
- package/dist/navigation/internal/sectionScroll.js.map +0 -7
- package/dist/navigation/internal/tabStrip.d.ts +0 -6
- package/dist/navigation/internal/tabStrip.js +0 -24
- package/dist/navigation/internal/tabStrip.js.map +0 -7
- package/dist/navigation/internal/treeModel.js.map +0 -7
- package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
- package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
- package/dist/navigation/internal/useTabDrag.js.map +0 -7
- package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
- package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
- package/dist/navigation/internal/useTreeViewport.js.map +0 -7
- package/dist/navigation/internal/waveDrawer.js.map +0 -7
- package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
- package/dist/rich-text.d.ts +0 -5
- package/dist/rich-text.js +0 -9
- package/dist/rich-text.js.map +0 -7
- package/dist/styles/CalendarHeatmap.css +0 -1
- package/dist/styles/Editor.css +0 -1
- package/dist/styles/Listbox.css +0 -1
- package/dist/styles/MarkdownEditor.css +0 -1
- package/dist/styles/Rating.css +0 -1
- package/dist/styles/RichText.css +0 -1
- package/docs/components/animated-number.md +0 -72
- package/docs/components/calendar-heatmap.md +0 -140
- package/docs/components/rating.md +0 -84
- package/docs/components/rich-text.md +0 -224
- package/docs/dev-mode.md +0 -59
- package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
- package/docs/examples/animated-number/CustomFormat.tsx +0 -28
- package/docs/examples/animated-number/ShowResults.tsx +0 -38
- package/docs/examples/badge/ChangeSize.tsx +0 -21
- package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
- package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
- package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
- package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
- package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
- package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
- package/docs/examples/markdown/LinkPicker.tsx +0 -65
- package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
- package/docs/examples/markdown/WriteNote.tsx +0 -21
- package/docs/examples/panes/ListAndDetail.tsx +0 -55
- package/docs/examples/rating/RatingAnatomy.tsx +0 -5
- package/docs/examples/rating/ReviewScore.tsx +0 -13
- package/docs/examples/rating/Scales.tsx +0 -11
- package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
- package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
- package/docs/examples/rich-text/References.tsx +0 -47
- package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
- package/docs/examples/rich-text/SavedContent.tsx +0 -33
- package/docs/examples/rich-text/SlashCommands.tsx +0 -24
- package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
- /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
- /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
- /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
- /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
- /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
- /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
- /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
- /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
- /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
- /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
- /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
- /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
- /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
- /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
- /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
package/docs/components/code.md
CHANGED
|
@@ -27,8 +27,6 @@ avoidWhen:
|
|
|
27
27
|
use: Kbd
|
|
28
28
|
- text: Formatted text written in Markdown, such as notes or a description.
|
|
29
29
|
use: Markdown
|
|
30
|
-
- text: The size of a change without its lines.
|
|
31
|
-
use: DiffStat
|
|
32
30
|
components:
|
|
33
31
|
- Code
|
|
34
32
|
- CodeBlock
|
|
@@ -39,6 +37,7 @@ examples: # Each file is examples/code/<Name>.tsx.
|
|
|
39
37
|
HighlightedSource: overview
|
|
40
38
|
InlineCode: { role: overview, caption: "Code: a command, a value or a file name inside a sentence." }
|
|
41
39
|
WrapLongLines: example
|
|
40
|
+
PackageManagers: example
|
|
42
41
|
CodeBlockAnatomy: anatomy
|
|
43
42
|
PlainOutput: example
|
|
44
43
|
SettingsDiff: example
|
|
@@ -53,6 +52,10 @@ examples: # Each file is examples/code/<Name>.tsx.
|
|
|
53
52
|
|
|
54
53
|
Example: WrapLongLines.
|
|
55
54
|
|
|
55
|
+
### Actions in the heading
|
|
56
|
+
|
|
57
|
+
Example: PackageManagers.
|
|
58
|
+
|
|
56
59
|
## Anatomy
|
|
57
60
|
|
|
58
61
|
1. **Block** (`env-code-block`)
|
|
@@ -102,7 +105,8 @@ Source, a command or output as plain text in the code theme of the app theme, su
|
|
|
102
105
|
| Prop | Type | Default | Description |
|
|
103
106
|
| --- | --- | --- | --- |
|
|
104
107
|
| `children` (required) | `string` | — | The source, as one string; it is shown and copied as it is. |
|
|
105
|
-
| `label` | `
|
|
108
|
+
| `label` | `ReactNode` | — | Names the block in its heading and for assistive technology, such as a file name, or content such as a file-type icon and a path link. Without one, the code takes the generic name of its language, such as Plain text code or TypeScript code, from messages.codeBlock.label. |
|
|
109
|
+
| `headerEnd` | `ReactNode` | — | Content at the end of the heading, before the copy button, such as Open in editor, Run, or a switch between npm, pnpm and yarn, placed as given. |
|
|
106
110
|
| `copyable` | `boolean` | `false` | Shows a copy button in the heading that copies the source; false by default. |
|
|
107
111
|
| `wrap` | `boolean` | `false` | Wraps long lines instead of scrolling them; false by default. |
|
|
108
112
|
|
|
@@ -116,7 +120,7 @@ Source with its syntax colored, in the code theme of the app theme, with that co
|
|
|
116
120
|
| --- | --- | --- | --- |
|
|
117
121
|
| `language` | `string` | — | The language to highlight: js, jsx, ts, tsx, java, json, html, xml, css, sql, sh, bash, yaml, md or ini, or their full names. Other values, and none, leave the source plain text. |
|
|
118
122
|
|
|
119
|
-
Also `children`, `label`, `copyable` and `wrap`, as on CodeBlock.
|
|
123
|
+
Also `children`, `label`, `headerEnd`, `copyable` and `wrap`, as on CodeBlock.
|
|
120
124
|
|
|
121
125
|
Native props: `<div>`.
|
|
122
126
|
|
|
@@ -132,13 +136,17 @@ The changes between two versions of a file, rendered by Diffs (diffs.com) in the
|
|
|
132
136
|
| `language` | `string` | — | Overrides the language the file name implies, such as json. |
|
|
133
137
|
| `header` | `boolean` | `true` | Shows the file header with its name and change counts; true by default. |
|
|
134
138
|
| `expandUnchanged` | `boolean` | `false` | Shows the unchanged lines between changes instead of folding them; false by default. |
|
|
135
|
-
| `layout` | `'auto' \| 'unified'` | `'auto'` | auto (default) sets old and new side by side from 56 rem of width; unified keeps one column. |
|
|
139
|
+
| `layout` | `'auto' \| 'split' \| 'unified'` | `'auto'` | auto (default) sets old and new side by side from 56 rem of width; split always sets them side by side, such as for a split and unified toggle; unified keeps one column. |
|
|
140
|
+
| `headerEnd` | `ReactNode` | — | Content at the end of the file header, such as View file, Accept or Revert, or a status Badge. |
|
|
141
|
+
| `annotations` | `readonly CodeDiffAnnotation[]` | — | Notes attached to lines, such as review comments, which renderAnnotation draws under them. |
|
|
142
|
+
| `renderAnnotation` | `(annotation: CodeDiffAnnotation) => ReactNode` | — | Draws one of annotations under its line. |
|
|
143
|
+
| `headingLevel` | `1 \| 2 \| 3 \| 4 \| 5 \| 6` | `3` | The level of the heading of what shows when the diff fails to load, for the page's outline. |
|
|
136
144
|
|
|
137
145
|
Native props: `<div>`.
|
|
138
146
|
|
|
139
147
|
### countDiffLines
|
|
140
148
|
|
|
141
|
-
How many lines a change adds and removes, as a
|
|
149
|
+
How many lines a change adds and removes, such as for the size of a change beside its file's name.
|
|
142
150
|
|
|
143
151
|
```ts
|
|
144
152
|
countDiffLines(before: string, after: string, filename?: string): { additions: number; deletions: number; }
|
|
@@ -155,6 +163,7 @@ countDiffLines(before: string, after: string, filename?: string): { additions: n
|
|
|
155
163
|
- `env-code-block`: The block of code.
|
|
156
164
|
- `env-code-block-copy-status`: The announcement that the code was copied.
|
|
157
165
|
- `env-code-block-header`: The row above the code: its label, such as a file name, and the copy button.
|
|
166
|
+
- `env-code-block-header-end`: The slot of the content at the end of the heading, before the copy button.
|
|
158
167
|
- `env-code-block-token`: One highlighted piece of the source, in its syntax color.
|
|
159
168
|
- `data-wrap`: present
|
|
160
169
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: ColorPicker
|
|
3
|
-
summary:
|
|
3
|
+
summary: Picks a color, as hex, RGB or HSL.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -39,6 +39,7 @@ examples: # Each file is examples/color-picker/<Name>.tsx.
|
|
|
39
39
|
EveryFormat: { role: overview, caption: "With alpha, one format at a time." }
|
|
40
40
|
FormatsTogether: example
|
|
41
41
|
PickerButtonOpen: example
|
|
42
|
+
TextColorInToolbar: example
|
|
42
43
|
PresetSwatches: example
|
|
43
44
|
Swatches: example
|
|
44
45
|
ColorPickerAnatomy: anatomy
|
|
@@ -57,6 +58,10 @@ Example: FormatsTogether.
|
|
|
57
58
|
|
|
58
59
|
Example: PickerButtonOpen.
|
|
59
60
|
|
|
61
|
+
### A trigger of your own, swatches first
|
|
62
|
+
|
|
63
|
+
Example: TextColorInToolbar.
|
|
64
|
+
|
|
60
65
|
### Preset swatches
|
|
61
66
|
|
|
62
67
|
Example: PresetSwatches.
|
|
@@ -130,6 +135,8 @@ A compact color picker on React Aria's color hooks: a square saturation and brig
|
|
|
130
135
|
| `eyeDropper` | `boolean` | `true` | Whether to show the eyedropper, which picks a color from the screen, where the browser has one (Chromium-based browsers on the desktop); elsewhere it never shows. |
|
|
131
136
|
| `copyable` | `boolean` | `true` | Whether to show the button that copies the color, as the fields show it. |
|
|
132
137
|
| `swatches` | `readonly ColorPickerSwatch[]` | — | Preset colors to choose from, under the fields: CSS color strings, React Aria's Colors, or `{ color, label }` with a name, such as the colors of a brand. |
|
|
138
|
+
| `swatchesFirst` | `boolean` | `false` | Show the swatches first, above the area and the fields, for a picker where presets are the usual choice, such as a tag's color. |
|
|
139
|
+
| `fields` | `boolean` | `true` | Whether to show the row of value fields, with the format select, the eyedropper and the copy button; without it, the area, the sliders and the swatches choose the color. |
|
|
133
140
|
| `name` | `string` | — | Submits the color with a form under this name, as a string in valueFormat. |
|
|
134
141
|
| `form` | `string` | — | The id of the form the color submits with, where the picker sits outside it. |
|
|
135
142
|
| `disabled` | `boolean` | `false` | Whether the picker takes no input, faded. |
|
|
@@ -149,8 +156,9 @@ A compact button that shows a color as a swatch and its value, and opens a Color
|
|
|
149
156
|
| `open` | `boolean` | — | Whether the picker is open, for a picker the application controls with onOpenChange. |
|
|
150
157
|
| `defaultOpen` | `boolean` | `false` | Whether an uncontrolled picker starts open, such as in a picture of it. |
|
|
151
158
|
| `onOpenChange` | `(open: boolean, details: PopoverOpenChangeDetails) => void` | — | Receives the requested state, and why, as Popover's onOpenChange does: such as to close the picker once a swatch is chosen. |
|
|
159
|
+
| `trigger` | `ReactElement \| ((color: { value: string }) => ReactElement)` | `a button with a swatch and the value` | The element that opens the picker in place of the swatch button, such as a text color button of a toolbar, an A over a bar of the color: an element, or a function that receives the color's value and returns one. It takes the native props given here, the opening behavior and, unless it has its own, the name after the label and the color; style it, and show the color, yourself. |
|
|
152
160
|
|
|
153
|
-
Also `label`, `value`, `defaultValue`, `onValueChange`, `valueFormat`, `formats`, `alpha`, `eyeDropper`, `copyable`, `swatches`, `name`, `form`, `disabled` and `readOnly`, as on ColorPicker.
|
|
161
|
+
Also `label`, `value`, `defaultValue`, `onValueChange`, `valueFormat`, `formats`, `alpha`, `eyeDropper`, `copyable`, `swatches`, `swatchesFirst`, `fields`, `name`, `form`, `disabled` and `readOnly`, as on ColorPicker.
|
|
154
162
|
|
|
155
163
|
Native props: `<button>`.
|
|
156
164
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Column
|
|
3
|
-
summary:
|
|
3
|
+
summary: Stacks content vertically with even gaps.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -63,7 +63,7 @@ Lays its direct children out one under another, `gap` apart, such as a form's fi
|
|
|
63
63
|
| `justify` | `'start' \| 'center' \| 'end' \| 'between'` | `'start'` | Where the children sit along the line when there is room to spare: at the start, in the center, at the end, such as a form's actions, or between, spread out to the edges. |
|
|
64
64
|
| `render` | `ReactElement` | — | The element to render, for its meaning, such as render={<section />} or render={<ul />}, or another component to lay out without a wrapper, such as a Surface: the primitive's attributes merge into its props. It must forward native props and refs. A div by default. |
|
|
65
65
|
| `ref` | `Ref<RenderedElement>` | — | The rendered element, a div by default. Its type is the element type parameter, which a ref passed in sets: a ref to the element that render makes, such as useRef<HTMLElement>(null) with render={<section />}, type-checks. |
|
|
66
|
-
| `name` | `string` | — | A name for this node, such as "filters" or "summary",
|
|
66
|
+
| `name` | `string` | — | A name for this node, such as "filters" or "summary", for the application's styles and tests to find it by; it renders as `data-env-name`. A component's part class names its node instead. |
|
|
67
67
|
| `container` | `string` | — | Makes the element a size container of this name, for container queries on its inline size, such as container="filters" for `@container filters (width >= 37.5rem)`. A container is as wide as its context gives it, never as its content. container="env-window" makes the element a window of its own on purpose, such as a preview frame, whose content lays out at its window class; other `env-*` names are envUI's own. |
|
|
68
68
|
| `padding` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9` | — | The inset on every side, a step of the spacing scale. None by default. |
|
|
69
69
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Combobox
|
|
3
|
-
summary: A text field that filters
|
|
3
|
+
summary: A text field that filters options as people type, to pick one or several as chips.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -115,8 +115,8 @@ A quick-open dialog near the top of the window: a search field over a list of op
|
|
|
115
115
|
| `aria-label` (required) | `string` | — | Accessible name of the dialog, the search field and the list. |
|
|
116
116
|
| `inputValue` (required) | `string` | — | The text in the search field. |
|
|
117
117
|
| `onInputValueChange` (required) | `(inputValue: string) => void` | — | Receives the text as people type. |
|
|
118
|
-
| `items` (required) | `readonly CommandPaletteItem[]` | — | Filtered and ranked by the application, in display order. |
|
|
119
|
-
| `suggestedItems` | `readonly CommandPaletteItem[]` | — | Shown in place of items while the search field is empty, such as recent documents or suggested pages under a group heading; options like any other. |
|
|
118
|
+
| `items` (required) | `readonly CommandPaletteItem[] \| readonly CommandPaletteGroup[]` | — | Filtered and ranked by the application, in display order; or groups of items, each under a heading. |
|
|
119
|
+
| `suggestedItems` | `readonly CommandPaletteItem[] \| readonly CommandPaletteGroup[]` | — | Shown in place of items while the search field is empty, such as recent documents or suggested pages under a group heading; options like any other. |
|
|
120
120
|
| `onAction` (required) | `(item: CommandPaletteItem, details: CommandPaletteActionDetails) => void` | — | Enter or a press on an option; Ctrl or Cmd sets modifier. |
|
|
121
121
|
| `closeOnAction` | `boolean` | `true` | Close after an option is chosen. |
|
|
122
122
|
| `placeholder` | `string` | — | Shown in the empty search field, such as "Search documents by name or folder". |
|
|
@@ -127,6 +127,8 @@ A quick-open dialog near the top of the window: a search field over a list of op
|
|
|
127
127
|
| `emptyIcon` | `ReactNode` | — | A decorative icon above the empty state's title, such as an error icon when the search failed; none by default. |
|
|
128
128
|
| `hints` | `readonly CommandPaletteHint[]` | — | Key hints below the list, such as { keys: ['Enter'], label: 'Open' }. A hint with Enter in its keys hides while there is no option to choose. |
|
|
129
129
|
| `footer` | `ReactNode` | — | Other content below the list, after the hints. |
|
|
130
|
+
| `searchStart` | `ReactNode` | — | Content before the search field in its row, such as a scope chip, In: Projects. |
|
|
131
|
+
| `searchEnd` | `ReactNode` | — | Content after the search field in its row, before the close button, such as a mode switch. |
|
|
130
132
|
|
|
131
133
|
Native props: `<div>`.
|
|
132
134
|
|
|
@@ -146,6 +148,8 @@ Native props: `<div>`.
|
|
|
146
148
|
- `env-command-palette-list`: The list of commands.
|
|
147
149
|
- `env-command-palette-positioner`: The palette's positioner.
|
|
148
150
|
- `env-command-palette-search`: The search field, a ghost TextField around the search input.
|
|
151
|
+
- `env-command-palette-search-end`: The slot of the content after the search field, such as a mode switch.
|
|
152
|
+
- `env-command-palette-search-start`: The slot of the content before the search field, such as a scope chip.
|
|
149
153
|
- `env-command-palette-status`: The EmptyState in place of the list, and the announcement of the number of results.
|
|
150
154
|
- `data-empty`: present, on `env-command-palette-status`
|
|
151
155
|
- `data-ending-style`: any value, or present
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Composer
|
|
3
|
-
summary:
|
|
3
|
+
summary: A chat message field that grows as people type.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Text & content
|
|
@@ -21,8 +21,6 @@ useWhen:
|
|
|
21
21
|
avoidWhen:
|
|
22
22
|
- text: Text over several lines in a form, where Enter starts a new line.
|
|
23
23
|
use: Textarea
|
|
24
|
-
- text: Formatted text with headings, lists and links.
|
|
25
|
-
use: MarkdownEditor
|
|
26
24
|
- text: The messages of the conversation itself.
|
|
27
25
|
use: Message
|
|
28
26
|
components:
|
|
@@ -30,6 +28,7 @@ components:
|
|
|
30
28
|
examples: # Each file is examples/composer/<Name>.tsx.
|
|
31
29
|
AskAnything: overview
|
|
32
30
|
StartAndFooter: example
|
|
31
|
+
AttachmentsAndVoice: example
|
|
33
32
|
ComposerAnatomy: anatomy
|
|
34
33
|
PendingSend: example
|
|
35
34
|
GrowingDraft: example
|
|
@@ -43,6 +42,10 @@ examples: # Each file is examples/composer/<Name>.tsx.
|
|
|
43
42
|
|
|
44
43
|
Example: StartAndFooter.
|
|
45
44
|
|
|
45
|
+
### Above the field and before Send
|
|
46
|
+
|
|
47
|
+
Example: AttachmentsAndVoice.
|
|
48
|
+
|
|
46
49
|
## Anatomy
|
|
47
50
|
|
|
48
51
|
1. **Composer** (`env-composer`)
|
|
@@ -66,10 +69,11 @@ Example: GrowingDraft.
|
|
|
66
69
|
|
|
67
70
|
### Keyboard
|
|
68
71
|
|
|
69
|
-
| Key
|
|
70
|
-
|
|
|
71
|
-
| <kbd>Enter</kbd> in the field
|
|
72
|
-
| <kbd>Shift</kbd>+<kbd>Enter</kbd> in the field
|
|
72
|
+
| Key | Action |
|
|
73
|
+
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
|
|
74
|
+
| <kbd>Enter</kbd> in the field | Sends the message, unless it is blank, pending or running. |
|
|
75
|
+
| <kbd>Shift</kbd>+<kbd>Enter</kbd> in the field | Starts a new line. |
|
|
76
|
+
| <kbd>Ctrl</kbd>+<kbd>Enter</kbd> or <kbd>⌘</kbd>+<kbd>Enter</kbd> in the field | In a composer that sends with a modifier, sends the message; Enter starts a new line. |
|
|
73
77
|
|
|
74
78
|
## Compose
|
|
75
79
|
|
|
@@ -83,7 +87,7 @@ import { Composer } from '@envsemble/envui';
|
|
|
83
87
|
|
|
84
88
|
### Composer
|
|
85
89
|
|
|
86
|
-
The message field of a conversation: a multiline field on a raised surface that grows with its text up to maxRows, with a send button at the end that becomes a stop button while running. Enter submits, Shift+Enter starts a new line and an input method's composition never submits. Without onSend, Enter and the send button submit the field's form.
|
|
90
|
+
The message field of a conversation: a multiline field on a raised surface that grows with its text up to maxRows, with a send button at the end that becomes a stop button while running. Enter submits, or with sendKey mod-enter Ctrl+Enter or ⌘+Enter; Shift+Enter starts a new line and an input method's composition never submits. Without onSend, Enter and the send button submit the field's form.
|
|
87
91
|
|
|
88
92
|
| Prop | Type | Default | Description |
|
|
89
93
|
| --- | --- | --- | --- |
|
|
@@ -99,6 +103,9 @@ The message field of a conversation: a multiline field on a raised surface that
|
|
|
99
103
|
| `minRows` | `number` | `1` | Lines the field shows while empty; 1 by default. |
|
|
100
104
|
| `maxRows` | `number` | `8` | Lines the field grows to before it scrolls; 8 by default. |
|
|
101
105
|
| `start` | `ReactNode` | — | Content at the start of the action row, such as an attach button or the name of a model. |
|
|
106
|
+
| `end` | `ReactNode` | — | Content in the action row just before the send button, such as a voice button, a model picker or a token count; the field then takes a row of its own above the action row. |
|
|
107
|
+
| `header` | `ReactNode` | — | Content inside the composer above the field, such as attachment chips, a quoted reply or context pills, placed as given. |
|
|
108
|
+
| `sendKey` | `'enter' \| 'mod-enter'` | `'enter'` | The key that sends: enter, where Shift+Enter starts a new line, or mod-enter, Ctrl+Enter or ⌘+Enter, where Enter starts a new line, for prompts that mostly take several lines. |
|
|
102
109
|
| `description` | `ReactNode` | — | Supporting text below the composer, such as a note on attachments; it describes the field. |
|
|
103
110
|
| `aria-label` | `string` | — | Required when `aria-labelledby` is not set. Names the field, which has no visible label, such as "Message"; this or aria-labelledby. |
|
|
104
111
|
| `aria-labelledby` | `string` | — | Required when `aria-label` is not set. The id of visible text that names the field; this or aria-label. |
|
|
@@ -110,11 +117,15 @@ Native props: `<textarea>`.
|
|
|
110
117
|
- `env-composer`: The message composer.
|
|
111
118
|
- `env-composer-action`: The send or stop button.
|
|
112
119
|
- `env-composer-description`: The slot of the supporting text below the composer.
|
|
120
|
+
- `env-composer-end`: The slot of the content in the action row before the send button.
|
|
113
121
|
- `env-composer-footer`: The supporting text below the composer, which describes the field.
|
|
122
|
+
- `env-composer-header`: The slot of the content inside the composer above the input, such as attachments.
|
|
114
123
|
- `env-composer-input`: The text input.
|
|
115
124
|
- `env-composer-start`: The slot of the content at the start of the action row.
|
|
116
125
|
- `env-composer-surface`: The surface around the input and the footer.
|
|
117
126
|
- `data-disabled`: present
|
|
127
|
+
- `data-end`: present
|
|
128
|
+
- `data-header`: present
|
|
118
129
|
- `data-running`: present
|
|
119
130
|
- `data-start`: present
|
|
120
131
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: ConfirmDialog
|
|
3
|
-
summary:
|
|
3
|
+
summary: A dialog that asks people to confirm an action before it runs.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Overlays
|
|
@@ -74,8 +74,8 @@ Asks people to confirm an action whose consequence needs a sentence, such as del
|
|
|
74
74
|
| `title` (required) | `ReactNode` | — | The question, which names the dialog, such as “Delete Northwind launch?”. |
|
|
75
75
|
| `description` | `ReactNode` | — | What confirming does and whether it can be undone; it describes the dialog. |
|
|
76
76
|
| `children` | `ReactNode` | — | More content between the heading and the actions, such as what else the action affects, or the one field a confirmation holds, such as a typed name. The dialog is a form: Enter in a field confirms as the confirm button does, through onConfirm. Hold no form here; use Dialog for one. |
|
|
77
|
-
| `confirmLabel` (required) | `
|
|
78
|
-
| `cancelLabel` | `
|
|
77
|
+
| `confirmLabel` (required) | `ReactNode` | — | The confirm button's label: a verb that names the consequence, such as Delete project. Like a Button's content, it can hold more, such as a Kbd of its shortcut. |
|
|
78
|
+
| `cancelLabel` | `ReactNode` | `'Cancel', or EnvUIProvider's messages.confirmDialog.cancel` | The cancel button's label. |
|
|
79
79
|
| `tone` | `'neutral' \| 'danger'` | `'neutral'` | danger for an action that deletes or ends something: the confirm button is a danger one and focus starts on Cancel, so a hurried Enter doesn't confirm. neutral starts focus on the confirm button. |
|
|
80
80
|
| `onConfirm` (required) | `() => void \| Promise<void>` | — | Runs the action when the confirm button is pressed, or Enter is pressed in a field in the dialog. The dialog closes when it returns, or, when it returns a promise, once the promise resolves; while it runs, the confirm button is pending and nothing dismisses the dialog. It runs once per opening: further presses, such as the second click of a double-click, are ignored until it fails or the dialog opens again. A rejected promise or a thrown error keeps it open and is passed to reportError, so show what went wrong with error. |
|
|
81
81
|
| `confirmDisabled` | `boolean` | `false` | Whether the confirm button is disabled, and Enter in a field doesn't confirm, such as for a confirmation that waits on a typed name. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: DatePicker
|
|
3
|
-
summary: A field
|
|
3
|
+
summary: A date field with a calendar, for a date or a date and time. The calendar also works on its own.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -38,6 +38,7 @@ examples: # Each file is examples/date-picker/<Name>.tsx.
|
|
|
38
38
|
DatePickerPopupAnatomy: anatomy
|
|
39
39
|
MeetingTime: example
|
|
40
40
|
WithinRange: example
|
|
41
|
+
PresetsAndBusyDays: example
|
|
41
42
|
---
|
|
42
43
|
|
|
43
44
|
# DatePicker
|
|
@@ -78,6 +79,10 @@ Example: MeetingTime.
|
|
|
78
79
|
|
|
79
80
|
Example: WithinRange.
|
|
80
81
|
|
|
82
|
+
### Presets and marked days
|
|
83
|
+
|
|
84
|
+
Example: PresetsAndBusyDays.
|
|
85
|
+
|
|
81
86
|
## Accessibility
|
|
82
87
|
|
|
83
88
|
### Keyboard
|
|
@@ -117,6 +122,8 @@ A field for a date, or a date and time, that shows the value in the reader's loc
|
|
|
117
122
|
| `granularity` | `'day' \| 'minute'` | `'day'` | What the value holds: day, a date as YYYY-MM-DD, or minute, a date and a time as YYYY-MM-DDTHH:mm, chosen in a list of times beside the calendar. |
|
|
118
123
|
| `min` | `string` | — | The earliest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; earlier days are unavailable. |
|
|
119
124
|
| `max` | `string` | — | The latest value, as YYYY-MM-DD or YYYY-MM-DDTHH:mm; later days are unavailable. |
|
|
125
|
+
| `isDateUnavailable` | `CalendarProps['isDateUnavailable']` | — | As Calendar's: whether a day, as YYYY-MM-DD, can't be chosen, such as a booked day. |
|
|
126
|
+
| `renderDay` | `CalendarProps['renderDay']` | — | As Calendar's: the content of a day's mark in the calendar in place of its number. |
|
|
120
127
|
| `placeholderTime` | `string` | — | The time a newly chosen day starts with, as HH:mm; 00:00 by default. |
|
|
121
128
|
| `minuteStep` | `number` | `15` | With the minute granularity, the minutes between the times the list offers, from 1 to 60. A value between them still shows in the list, in its place. |
|
|
122
129
|
| `locale` | `string` | — | The locale of the shown value and the calendar's names and numbers: EnvUIProvider's, else the browser's. Dates are Gregorian, also in a locale with a calendar of its own. |
|
|
@@ -130,13 +137,15 @@ A field for a date, or a date and time, that shows the value in the reader's loc
|
|
|
130
137
|
| `clearable` | `boolean` | `false` | A clear button in the field and in the calendar removes the value. |
|
|
131
138
|
| `open` | `boolean` | — | Whether the calendar is open; with `onOpenChange` it controls it. |
|
|
132
139
|
| `defaultOpen` | `boolean` | `false` | Whether an uncontrolled calendar starts open; closed by default. |
|
|
133
|
-
| `onOpenChange` | `(open: boolean, details:
|
|
140
|
+
| `onOpenChange` | `(open: boolean, details: DatePickerOpenChangeDetails) => void` | — | Called with the new state, and why, when the calendar opens or closes. |
|
|
134
141
|
| `clearLabel` | `string` | `'Clear', or EnvUIProvider's messages.datePicker.clear` | Accessible name of the field's clear button and text of the calendar's. |
|
|
135
142
|
| `todayLabel` | `string` | `'Today', or EnvUIProvider's messages.datePicker.today` | The calendar's shortcut to today. |
|
|
136
143
|
| `nowLabel` | `string` | `'Now', or EnvUIProvider's messages.datePicker.now` | With the minute granularity, the calendar's shortcut to the current date and time. |
|
|
137
144
|
| `timeLabel` | `string` | `'Time', or EnvUIProvider's messages.datePicker.time` | With the minute granularity, the heading and accessible name of the list of times. |
|
|
138
145
|
| `previousMonthLabel` | `string` | `'Previous month', or EnvUIProvider's messages.calendar.previousMonth` | Accessible name of the calendar's previous month button. |
|
|
139
146
|
| `nextMonthLabel` | `string` | `'Next month', or EnvUIProvider's messages.calendar.nextMonth` | Accessible name of the calendar's next month button. |
|
|
147
|
+
| `popupHeader` | `ReactNode` | — | Content at the top of the popup, above the calendar, such as presets: buttons for Tomorrow or Next Monday that set the value, from a field the application controls. |
|
|
148
|
+
| `popupFooter` | `ReactNode` | — | Content in the popup's footer, after its shortcut to the current date or time and before Clear, such as a note of the time zone or another action. |
|
|
140
149
|
| `label` | `ReactNode` | — | The field's visible name, above the field, such as Project name; it also names the control for assistive technology. |
|
|
141
150
|
| `description` | `ReactNode` | — | Lasting guidance under the field, such as a format or a limit, linked to the control as its description. |
|
|
142
151
|
| `error` | `ReactNode` | — | A message under the field that says how to correct the value. While it is set, the control is invalid (aria-invalid) and the message joins its description, after the description. |
|
|
@@ -147,7 +156,7 @@ Native props: `<button>`.
|
|
|
147
156
|
|
|
148
157
|
### Calendar
|
|
149
158
|
|
|
150
|
-
A month of days to choose one from, following the WAI-ARIA date picker grid: the arrow keys move by day and week, Page Up and Page Down by month (with Shift, by year), Home and End to the week's ends, and Enter or Space chooses the day. Named with aria-label or aria-labelledby, it is a group around the month's grid.
|
|
159
|
+
A month of days to choose one from, following the WAI-ARIA date picker grid: the arrow keys move by day and week, Page Up and Page Down by month (with Shift, by year), Home and End to the week's ends, and Enter or Space chooses the day. Named with aria-label or aria-labelledby, or by the List.Item whose control it is, it is a group around the month's grid.
|
|
151
160
|
|
|
152
161
|
| Prop | Type | Default | Description |
|
|
153
162
|
| --- | --- | --- | --- |
|
|
@@ -156,6 +165,8 @@ A month of days to choose one from, following the WAI-ARIA date picker grid: the
|
|
|
156
165
|
| `onValueChange` | `(value: string) => void` | — | Receives the chosen day as YYYY-MM-DD. |
|
|
157
166
|
| `min` | `string` | — | The earliest day that can be chosen, as YYYY-MM-DD; earlier days are unavailable. |
|
|
158
167
|
| `max` | `string` | — | The latest day that can be chosen, as YYYY-MM-DD; later days are unavailable. |
|
|
168
|
+
| `isDateUnavailable` | `(day: string) => boolean` | — | Whether a day, as YYYY-MM-DD, can't be chosen, such as a weekend, a holiday or a booked day; it shows dimmed and reports aria-disabled, as days outside min and max do, and the keyboard still moves onto it. |
|
|
169
|
+
| `renderDay` | `(day: string, state: CalendarDayState) => ReactNode` | `the day's number` | The content of a day's mark in place of its number, such as the number with a dot under it for a day with events, or a price; it receives the day as YYYY-MM-DD and its state. The cell keeps its role, its name, the full date, and its keyboard handling. |
|
|
159
170
|
| `weekStart` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `the locale's, or Monday where the browser cannot tell` | The first day of each week, from 0 for Sunday to 6 for Saturday. |
|
|
160
171
|
| `locale` | `string` | — | The locale of the month and weekday names and the day numbers: EnvUIProvider's, else the browser's. The days are always Gregorian, also in a locale with a calendar of its own. |
|
|
161
172
|
| `previousMonthLabel` | `string` | `'Previous month', or EnvUIProvider's messages.calendar.previousMonth` | Accessible name of the previous month button. |
|
|
@@ -190,6 +201,7 @@ Native props: `<div>`.
|
|
|
190
201
|
|
|
191
202
|
- `env-calendar`: The calendar of one month.
|
|
192
203
|
- `env-calendar-day`: One day.
|
|
204
|
+
- `env-calendar-day-content`: The slot of a day's content from renderDay, in its mark.
|
|
193
205
|
- `env-calendar-day-mark`: The mark under a day, such as today's.
|
|
194
206
|
- `env-calendar-grid`: The grid of days.
|
|
195
207
|
- `env-calendar-header`: The row with the month and the previous and next buttons.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Dialog
|
|
3
|
-
summary: A
|
|
3
|
+
summary: A window over the page for one focused task.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Overlays
|
|
@@ -22,6 +22,7 @@ avoidWhen:
|
|
|
22
22
|
components:
|
|
23
23
|
- Dialog
|
|
24
24
|
- DialogClose
|
|
25
|
+
- useDialogPending
|
|
25
26
|
examples: # Each file is examples/dialog/<Name>.tsx.
|
|
26
27
|
ProjectDetails: overview
|
|
27
28
|
FindPlan: example
|
|
@@ -29,6 +30,7 @@ examples: # Each file is examples/dialog/<Name>.tsx.
|
|
|
29
30
|
DialogAnatomy: anatomy
|
|
30
31
|
RenameProject: example
|
|
31
32
|
UnsavedChanges: example
|
|
33
|
+
EditMember: example
|
|
32
34
|
---
|
|
33
35
|
|
|
34
36
|
# Dialog
|
|
@@ -62,12 +64,20 @@ Example: RenameProject.
|
|
|
62
64
|
|
|
63
65
|
Example: UnsavedChanges.
|
|
64
66
|
|
|
67
|
+
### Actions at the start
|
|
68
|
+
|
|
69
|
+
Example: EditMember.
|
|
70
|
+
|
|
65
71
|
## Compose
|
|
66
72
|
|
|
67
73
|
### Import
|
|
68
74
|
|
|
69
75
|
```tsx
|
|
70
|
-
import {
|
|
76
|
+
import {
|
|
77
|
+
Dialog,
|
|
78
|
+
DialogClose,
|
|
79
|
+
useDialogPending,
|
|
80
|
+
} from '@envsemble/envui';
|
|
71
81
|
```
|
|
72
82
|
|
|
73
83
|
## Props
|
|
@@ -82,11 +92,16 @@ A focused task over the page: a centered modal, or a modal near the top of the w
|
|
|
82
92
|
| `defaultOpen` | `boolean` | `false` | Whether a dialog the application doesn't control is open on the first render. |
|
|
83
93
|
| `onOpenChange` | `(open: boolean, details: DialogOpenChangeDetails) => void` | — | Called with the requested state, and why, when the dialog asks to open or close: from the trigger, Escape, an outside press, the close button or a DialogClose. Not called for a dismissal that pending blocks. |
|
|
84
94
|
| `trigger` | `ReactElement` | — | The element that opens the dialog, such as a Button. It reports the dialog it opens, and focus returns to it on close. Omit it for a dialog the application opens with open. |
|
|
85
|
-
| `title`
|
|
95
|
+
| `title` | `ReactNode` | — | The dialog's heading and accessible name, such as “Delete project?”. Without one, such as for an image viewer or a search dialog its field names, name the dialog with aria-label or aria-labelledby. |
|
|
86
96
|
| `description` | `ReactNode` | — | Muted text under the title that describes the dialog to assistive technology too, such as what its action changes. |
|
|
87
97
|
| `children` | `ReactNode` | — | The content between the heading and the actions, such as text, fields or a list. |
|
|
88
|
-
| `actions` | `ReactNode` | — | The dialog's own actions, after the built-in close button, with the primary action last. They close the dialog only where they are DialogClose or set open to false. While the dialog is pending, the last one shows it, where it is a Button that sets no pending of its own. |
|
|
89
|
-
| `
|
|
98
|
+
| `actions` | `ReactNode` | — | The dialog's own actions, after the built-in close button, with the primary action last. They close the dialog only where they are DialogClose or set open to false. While the dialog is pending, the last one shows it, where it is a Button that sets no pending of its own; another component reads it with useDialogPending. |
|
|
99
|
+
| `actionsStart` | `ReactNode` | — | Content at the start of the actions' row, which takes the room the actions leave, such as a destructive Delete, a Learn more link or a Don't show again checkbox. |
|
|
100
|
+
| `closeButton` | `boolean` | `true` | Whether the dialog shows its built-in close button, as on a Sheet. Leave it out only where the dialog places its own DialogClose. |
|
|
101
|
+
| `closeButtonPlacement` | `'actions' \| 'heading'` | `'actions'` | Where the built-in close button is: actions, a secondary button that starts the actions; heading, an IconButton with a cross at the end of the heading, as on a Sheet. |
|
|
102
|
+
| `closeLabel` | `string` | `'Close', or EnvUIProvider's messages.dialog.close` | The label of the built-in close button, such as Cancel, or its name in the heading. |
|
|
103
|
+
| `headerStart` | `ReactNode` | — | Content before the title in the heading's row, such as a back button. |
|
|
104
|
+
| `headerEnd` | `ReactNode` | — | Content at the end of the heading's row, before a close button there, such as a Menu of more actions or an Open full page button. |
|
|
90
105
|
| `placement` | `'center' \| 'top'` | `'center'` | center for a modal in the middle of the window; top for a modal near the top of the window for search-like tasks, so results grow downward without moving the field. For a panel at an edge of the window, use Sheet. |
|
|
91
106
|
| `width` | `'md' \| 'lg'` | `'md'` | md, 28 rem wide, or lg, 44 rem, for content-heavy dialogs such as tables, comparisons and longer forms. Both narrow to fit the window. |
|
|
92
107
|
| `modal` | `boolean` | `true` | true traps focus in the dialog over a backdrop, hides the page from assistive technology, blocks presses on it and locks its scroll. false leaves the page usable beside the dialog; it then closes when focus or a press goes outside it, unless disablePointerDismissal. |
|
|
@@ -109,21 +124,32 @@ A button inside a Dialog or a Sheet that closes it after its own onClick, for an
|
|
|
109
124
|
| `underline` | `boolean` | `false` | Show an underline for the text variant. |
|
|
110
125
|
| `size` | `'sm' \| 'md' \| 'lg'` | — | The control height, sm, md or lg; without it, the container's, and else md. |
|
|
111
126
|
| `fullWidth` | `boolean` | `false` | Fill the width of the container, such as the actions of a narrow form stacked in a column. |
|
|
112
|
-
| `
|
|
113
|
-
| `
|
|
114
|
-
| `end` | `ReactNode` | — | Quiet content at the far end, such as a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the button. |
|
|
127
|
+
| `start` | `ReactNode` | — | Content before the label, such as IconAdd, 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. It is hidden from assistive technology, since the label names the button. |
|
|
128
|
+
| `end` | `ReactNode` | — | Content after the label, at the far end of a full-width button, such as IconChevronRight for a next step, or a shortcut's Kbd, with aria-hidden on its keys and aria-keyshortcuts on the button: an envUI icon takes the button's icon size and other content keeps its own. |
|
|
115
129
|
| `pending` | `boolean` | `false` | Its work is running: a spinner turns over it, it keeps its width and name, and presses do nothing. |
|
|
130
|
+
| `render` | `ReactElement` | — | Another element to render the button as, 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. It takes no type or disabled attribute; disabled reports aria-disabled and blocks presses. |
|
|
116
131
|
|
|
117
132
|
Native props: `<button>`.
|
|
118
133
|
|
|
134
|
+
### useDialogPending
|
|
135
|
+
|
|
136
|
+
Whether the Dialog or Sheet around it is pending, for an action component of the application's own, such as a Button wrapped for analytics, to show the work its press started.
|
|
137
|
+
|
|
138
|
+
```ts
|
|
139
|
+
useDialogPending(): boolean
|
|
140
|
+
```
|
|
141
|
+
|
|
119
142
|
## Part names
|
|
120
143
|
|
|
121
144
|
- `env-dialog`: The dialog.
|
|
122
145
|
- `env-dialog-actions`: The row of actions at the bottom.
|
|
146
|
+
- `env-dialog-actions-start`: The slot of the content at the start of the actions' row.
|
|
123
147
|
- `env-dialog-backdrop`: The backdrop behind a modal dialog.
|
|
124
148
|
- `env-dialog-content`: The dialog's content between the header and the actions.
|
|
125
149
|
- `env-dialog-description`: The sentence under the title.
|
|
126
150
|
- `env-dialog-header`: The row with the title and the close button.
|
|
151
|
+
- `env-dialog-header-end`: The slot of the content at the end of the title's row, before a close button.
|
|
152
|
+
- `env-dialog-header-start`: The slot of the content before the title.
|
|
127
153
|
- `env-dialog-heading`: The column with the title and the description.
|
|
128
154
|
- `env-dialog-positioner`: The positioner that centres the dialog.
|
|
129
155
|
- `env-dialog-surface`: The dialog's surface.
|
|
@@ -71,6 +71,8 @@ A summary that shows and hides the details below it, on the native details eleme
|
|
|
71
71
|
| `open` | `boolean` | — | Whether the details show, for a controlled disclosure: update it from onOpenChange. Use defaultOpen instead to leave it to the disclosure. |
|
|
72
72
|
| `defaultOpen` | `boolean` | `false` | Whether the details show at first, for a disclosure that keeps its own state. |
|
|
73
73
|
| `onOpenChange` | `(open: boolean) => void` | — | Receives whether the details show, each time the disclosure opens or closes. |
|
|
74
|
+
| `indicatorPlacement` | `'start' \| 'end'` | `'start'` | Where the chevron sits in the summary: before its words, or after them, as in a Show more link. |
|
|
75
|
+
| `panelLayout` | `'stack' \| 'flow'` | `'stack'` | stack lays the details out one under another, a small gap apart; flow places them as given, so they keep their own spacing and flow, such as inline text. |
|
|
74
76
|
|
|
75
77
|
Native props: `<details>`.
|
|
76
78
|
|
|
@@ -80,3 +82,5 @@ Native props: `<details>`.
|
|
|
80
82
|
- `env-disclosure-indicator`: The chevron before the summary's words, turned down while open.
|
|
81
83
|
- `env-disclosure-panel`: The panel it shows.
|
|
82
84
|
- `env-disclosure-title`: The slot of the summary's words.
|
|
85
|
+
- `data-indicator`: `end`
|
|
86
|
+
- `data-layout`: `flow`, on `env-disclosure-panel`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: DocumentTabs
|
|
3
|
-
summary:
|
|
3
|
+
summary: Tabs for open documents, as in a code editor.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Navigation
|
|
@@ -27,17 +27,24 @@ components:
|
|
|
27
27
|
examples: # Each file is examples/document-tabs/<Name>.tsx.
|
|
28
28
|
OpenDocuments: overview
|
|
29
29
|
DocumentTabsAnatomy: anatomy
|
|
30
|
+
EditorTabs: example
|
|
30
31
|
ManyTabs: example
|
|
31
32
|
---
|
|
32
33
|
|
|
33
34
|
# DocumentTabs
|
|
34
35
|
|
|
36
|
+
## Variants
|
|
37
|
+
|
|
38
|
+
### Tabs of an editor
|
|
39
|
+
|
|
40
|
+
Example: EditorTabs.
|
|
41
|
+
|
|
35
42
|
## Anatomy
|
|
36
43
|
|
|
37
44
|
1. **Tabs** (`env-document-tabs-list`)
|
|
38
45
|
2. **Item** (`env-document-tabs-item`)
|
|
39
46
|
3. **Tab** (`env-document-tabs-tab`)
|
|
40
|
-
4. **
|
|
47
|
+
4. **Start** (`env-document-tabs-tab-start`, `start`)
|
|
41
48
|
5. **Label** (`env-document-tabs-tab-label`, `label`)
|
|
42
49
|
6. **Close button** (`env-document-tabs-close`)
|
|
43
50
|
7. **End** (`env-document-tabs-end`, `end`)
|
|
@@ -53,12 +60,12 @@ Example: ManyTabs.
|
|
|
53
60
|
|
|
54
61
|
### Keyboard
|
|
55
62
|
|
|
56
|
-
| Key | Action
|
|
57
|
-
| -------------------------------------------------- |
|
|
58
|
-
| <kbd>←</kbd>, <kbd>→</kbd> | Moves to the previous or next tab and activates it, wrapping, in the reading direction.
|
|
59
|
-
| <kbd>Home</kbd>, <kbd>End</kbd> | Moves to the first or last tab and activates it.
|
|
60
|
-
| <kbd>Delete</kbd> or <kbd>Backspace</kbd> | Closes the focused tab; focus moves to the tab that becomes active.
|
|
61
|
-
| <kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> | Opens the context menu for the focused tab.
|
|
63
|
+
| Key | Action |
|
|
64
|
+
| -------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
|
65
|
+
| <kbd>←</kbd>, <kbd>→</kbd> | Moves to the previous or next tab and activates it, wrapping, in the reading direction. |
|
|
66
|
+
| <kbd>Home</kbd>, <kbd>End</kbd> | Moves to the first or last tab and activates it. |
|
|
67
|
+
| <kbd>Delete</kbd> or <kbd>Backspace</kbd> | Closes the focused tab unless it isn't closable; focus moves to the tab that becomes active. |
|
|
68
|
+
| <kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> | Opens the context menu for the focused tab. |
|
|
62
69
|
|
|
63
70
|
## Compose
|
|
64
71
|
|
|
@@ -80,16 +87,17 @@ Editor-style closable tabs for open documents, with the active document in a pan
|
|
|
80
87
|
| `items` (required) | `readonly DocumentTabsItem[]` | — | The open documents, in tab order. |
|
|
81
88
|
| `value` (required) | `string \| null` | — | The active tab, or null. |
|
|
82
89
|
| `onValueChange` (required) | `(value: string) => void` | — | Called with the tab's value when it is clicked or reached with the arrow keys, Home or End. |
|
|
83
|
-
| `onClose` (required) | `(
|
|
84
|
-
| `onPin` | `(
|
|
85
|
-
| `onReorder` | `(
|
|
90
|
+
| `onClose` (required) | `(value: string) => void` | — | Called from a tab's close button, a middle click, Delete or Backspace on the focused tab, and Close in the tab's context menu. |
|
|
91
|
+
| `onPin` | `(value: string) => void` | — | Called when a tab is double-clicked, typically to keep a preview tab open. |
|
|
92
|
+
| `onReorder` | `(values: string[]) => void` | — | Called with every tab's value in the new order when a tab is dragged to another place with a mouse or pen, or moved with Move left or Move right in its context menu, which also reach the keyboard and touch. Without it, the tabs keep their order. |
|
|
86
93
|
| `end` | `ReactNode` | — | Content after the tabs, outside the strip that scrolls and in line with it, such as a button that closes every tab or opens a new one. |
|
|
87
94
|
| `aria-label` (required) | `string` | — | Accessible name of the tab strip. |
|
|
88
95
|
| `panelId` | `string` | — | Id of the panel the active tab controls: the one DocumentTabs renders around children, or the one the application renders itself. |
|
|
89
|
-
| `closeLabel` | `(label: string) => string` | `'Close {label}', or EnvUIProvider's messages.documentTabs.close` | The name of the context menu's item that closes a tab, and the tooltip of its close button. |
|
|
96
|
+
| `closeLabel` | `(label: string) => string` | `'Close {label}', or EnvUIProvider's messages.documentTabs.close` | The name of the context menu's item that closes a tab, and the tooltip of its close button, from the tab's text value. |
|
|
90
97
|
| `onCloseAll` | `() => void` | — | Called from Close all tabs in the context menu. Each tab opens a context menu that closes it on right click, long press, the Menu key and Shift+F10; with onCloseAll, the menu also offers Close all tabs, and the strip around the tabs opens it too. |
|
|
91
98
|
| `closeAllLabel` | `string` | `'Close all tabs', or EnvUIProvider's messages.documentTabs.closeAll` | Label of the Close all tabs item. |
|
|
92
99
|
| `contextMenuLabel` | `string` | `'Tab actions', or EnvUIProvider's messages.documentTabs.contextMenu` | Accessible name of the context menu. |
|
|
100
|
+
| `contextMenu` | `(tab: DocumentTabsItem \| null) => ReactNode` | — | The application's own items for the context menu of the tab people open it on, or of the strip around the tabs when the tab is null, such as Close others or Copy path. They come after the built-in items, past a separator. |
|
|
93
101
|
|
|
94
102
|
Native props: `<div>`.
|
|
95
103
|
|
|
@@ -105,14 +113,16 @@ Native props: `<div>`.
|
|
|
105
113
|
- `env-document-tabs-panel-content`: The slot of the active document.
|
|
106
114
|
- `env-document-tabs-strip`: The bar that holds the tabs and the actions at their end.
|
|
107
115
|
- `env-document-tabs-tab`: A tab's button.
|
|
116
|
+
- `env-document-tabs-tab-end`: The slot after a tab's title, such as a dot for unsaved changes.
|
|
108
117
|
- `env-document-tabs-tab-label`: A tab's title.
|
|
118
|
+
- `env-document-tabs-tab-start`: The slot before a tab's title, such as a file type's icon.
|
|
109
119
|
- `data-active`: present, on `env-document-tabs-item`
|
|
110
120
|
- `data-drop`: `after`, `before`, on `env-document-tabs-item`
|
|
111
121
|
- `data-first-active`: present
|
|
112
122
|
- `data-moving`: `pointer`, on `env-document-tabs-item`
|
|
113
123
|
- `data-preview`: present, on `env-document-tabs-tab`
|
|
114
124
|
- `data-reordering`: present, on `env-document-tabs-list`
|
|
115
|
-
- `data-
|
|
125
|
+
- `data-value`: any value, or present, on `env-document-tabs-tab`
|
|
116
126
|
|
|
117
127
|
## Strings
|
|
118
128
|
|