@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/panes.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Panes
|
|
3
|
-
summary:
|
|
3
|
+
summary: Two panes side by side, such as a document and its details.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -14,8 +14,8 @@ aliases:
|
|
|
14
14
|
- side pane
|
|
15
15
|
- resizable panes
|
|
16
16
|
useWhen:
|
|
17
|
-
- A list beside the chosen item's detail, such as messages
|
|
18
17
|
- A document beside its details, which people resize
|
|
18
|
+
- Two views of one thing side by side, such as source and its preview
|
|
19
19
|
avoidWhen:
|
|
20
20
|
- text: An application's screen with its top bar and navigation.
|
|
21
21
|
use: Scaffold
|
|
@@ -25,9 +25,8 @@ avoidWhen:
|
|
|
25
25
|
use: ResizeHandle
|
|
26
26
|
components:
|
|
27
27
|
- Panes
|
|
28
|
-
- readPanesWidth
|
|
29
28
|
examples: # Each file is examples/panes/<Name>.tsx.
|
|
30
|
-
|
|
29
|
+
DocumentAndDetails: { role: overview, caption: "A document and its details, with the resize handle on the seam; the details pane keeps its width as the region resizes." }
|
|
31
30
|
ResizableDetails: example
|
|
32
31
|
PanesAnatomy: anatomy
|
|
33
32
|
StackedWhenNarrow: example
|
|
@@ -35,18 +34,12 @@ examples: # Each file is examples/panes/<Name>.tsx.
|
|
|
35
34
|
|
|
36
35
|
# Panes
|
|
37
36
|
|
|
38
|
-
## Variants
|
|
39
|
-
|
|
40
|
-
### Details at the end
|
|
41
|
-
|
|
42
|
-
Example: ResizableDetails.
|
|
43
|
-
|
|
44
37
|
## Anatomy
|
|
45
38
|
|
|
46
39
|
1. **Root** (`env-panes`)
|
|
47
|
-
2. **Pane** (`env-panes-pane`)
|
|
40
|
+
2. **Pane** (`env-panes-pane:first-child`)
|
|
48
41
|
3. **Resize handle** (`env-panes-resize-handle`)
|
|
49
|
-
4. **Pane** (`env-panes-pane`)
|
|
42
|
+
4. **Pane** (`env-panes-pane:last-child`)
|
|
50
43
|
|
|
51
44
|
## Behaviour
|
|
52
45
|
|
|
@@ -54,6 +47,10 @@ Example: ResizableDetails.
|
|
|
54
47
|
|
|
55
48
|
Example: StackedWhenNarrow.
|
|
56
49
|
|
|
50
|
+
### Keeping the width people chose
|
|
51
|
+
|
|
52
|
+
Example: ResizableDetails.
|
|
53
|
+
|
|
57
54
|
## Accessibility
|
|
58
55
|
|
|
59
56
|
### Keyboard
|
|
@@ -69,27 +66,25 @@ Example: StackedWhenNarrow.
|
|
|
69
66
|
### Import
|
|
70
67
|
|
|
71
68
|
```tsx
|
|
72
|
-
import { Panes
|
|
69
|
+
import { Panes } from '@envsemble/envui';
|
|
73
70
|
```
|
|
74
71
|
|
|
75
72
|
## Props
|
|
76
73
|
|
|
77
74
|
### Panes.Root
|
|
78
75
|
|
|
79
|
-
A region split into two panes side by side, such as a list and its detail: one pane has a width of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each pane's content scrolls on its own under its header when Panes has a height. With `stackBelow` the panes stack in a narrow region. Panes fill their region with square corners; an application rounds them with its own class, and the panes follow, since the root clips them.
|
|
76
|
+
A region split into two panes side by side, such as a list and its detail: one pane has a width of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each pane's content scrolls on its own under its header when Panes has a height. With `stackBelow` the panes stack in a narrow region. A pane the application renders alone, such as the list while no item is open, fills the region and the handle hides. Panes fill their region with square corners; an application rounds them with its own class, and the panes follow, since the root clips them.
|
|
80
77
|
|
|
81
78
|
| Prop | Type | Default | Description |
|
|
82
79
|
| --- | --- | --- | --- |
|
|
83
80
|
| `sized` | `'start' \| 'end'` | `'start'` | Which pane has a width of its own, which Panes.ResizeHandle resizes: the first, such as a list or a sidebar, or the last, such as details. The other pane takes the rest of the room. |
|
|
84
81
|
| `stackBelow` | `'medium' \| 'expanded' \| 'large'` | — | The window class of the Panes' own width below which the panes stack, the first above the last, each half the height, and the resize handle hides: medium (37.5 rem), expanded (52.5 rem) or large (75 rem). CSS decides it, so the server's markup is right before any script runs. Without it the panes always sit side by side. |
|
|
85
82
|
| `width` | `number` | — | The sized pane's width in rem, for Panes the application controls with onWidthChange. |
|
|
86
|
-
| `defaultWidth` | `number` | `22.5` | The sized pane's width in rem until people choose one with Panes.ResizeHandle,
|
|
83
|
+
| `defaultWidth` | `number` | `22.5` | The sized pane's width in rem until people choose one with Panes.ResizeHandle, and the width a double click on the handle returns it to. To keep the width people choose, store what onWidthChange receives and pass it back here. |
|
|
87
84
|
| `onWidthChange` | `(width: number, details: ResizeDetails) => void` | — | Receives each new width of the sized pane, in rem: while dragging the handle with committed false, and with committed true as a drag ends, a key moves it or a double click resets it. |
|
|
88
85
|
| `minWidth` | `number` | `16` | The sized pane's smallest width, in rem. |
|
|
89
86
|
| `maxWidth` | `number` | `40` | The sized pane's largest width, in rem. It never leaves the other pane less than 16 rem. |
|
|
90
|
-
| `
|
|
91
|
-
| `persistedWidth` | `number` | — | The width kept under `persist`, in rem, as the server read it from the request's cookies with `readPanesWidth`: the first render uses it, on the server and in the browser alike. |
|
|
92
|
-
| `name` | `string` | — | A name for this node, such as "inbox", which dev mode and the docs show; it renders as `data-env-name`. |
|
|
87
|
+
| `name` | `string` | — | A name for this node, such as "inbox", for the application's styles and tests to find it by; it renders as `data-env-name`. |
|
|
93
88
|
| `children` (required) | `ReactNode` | — | The two panes, with a Panes.ResizeHandle between them for people to resize them. |
|
|
94
89
|
|
|
95
90
|
Native props: `<div>`.
|
|
@@ -117,14 +112,6 @@ The ResizeHandle between the panes, which resizes the sized pane: invisible on t
|
|
|
117
112
|
|
|
118
113
|
Native props: `<div>`.
|
|
119
114
|
|
|
120
|
-
### readPanesWidth
|
|
121
|
-
|
|
122
|
-
The width Panes keeps under its `persist` key, read from a Cookie header, such as the request's on the server, or from `document.cookie`. Render Panes.Root with it as `persistedWidth`, on the server and in the browser alike, so the server's markup has the width people chose and nothing moves as the page hydrates: <Panes.Root persist="inbox" persistedWidth={readPanesWidth(cookieHeader, 'inbox')}> Returns undefined where no width is kept under the key, or what is kept there is no width.
|
|
123
|
-
|
|
124
|
-
```ts
|
|
125
|
-
readPanesWidth(cookies: string | null | undefined, key: string): number | undefined
|
|
126
|
-
```
|
|
127
|
-
|
|
128
115
|
## Part names
|
|
129
116
|
|
|
130
117
|
- `env-panes`: The panes: a region split into two panes side by side, or stacked in less room; it never paints.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Popover
|
|
3
|
-
summary: A floating panel
|
|
3
|
+
summary: A floating panel next to the control that opens it, for details or a small form.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Overlays
|
|
@@ -70,7 +70,8 @@ A floating panel beside its trigger, for details or a small form: it opens on pr
|
|
|
70
70
|
|
|
71
71
|
| Prop | Type | Default | Description |
|
|
72
72
|
| --- | --- | --- | --- |
|
|
73
|
-
| `trigger`
|
|
73
|
+
| `trigger` | `ReactElement` | — | The control that opens and closes the popover, such as a Button or an IconButton. It must take a ref and props: it receives the press handler, aria-haspopup and aria-expanded. Leave it out for a popover the application opens with open, beside its anchor. |
|
|
74
|
+
| `anchor` | `PopoverAnchor` | `the trigger` | What the popover opens beside where that isn't its trigger, such as a table cell, a word in the text or a range of selected text: an element, its ref, or a virtual element with a getBoundingClientRect. |
|
|
74
75
|
| `title` | `ReactNode` | — | A heading at the top, such as the name of what the popover describes; it names the popover. |
|
|
75
76
|
| `children` (required) | `ReactNode \| ((close: () => void) => ReactNode)` | — | The popover's content, or a function that receives close, for an action inside it that should close the popover once it is done, such as a form's submit. |
|
|
76
77
|
| `aria-label` | `string` | — | The popover's accessible name when it has no title, such as Rename document. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Progress
|
|
3
|
-
summary:
|
|
3
|
+
summary: Shows how much of a task is done, or that it is still running.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Feedback
|
|
@@ -86,7 +86,7 @@ How much of a task is done, such as an upload or an import: a label, an optional
|
|
|
86
86
|
| --- | --- | --- | --- |
|
|
87
87
|
| `value` (required) | `number \| null` | — | How much of the task is done, between min and max, such as 40 of 100; null while the amount of work is unknown, which shows an indeterminate bar announced as Loading. |
|
|
88
88
|
| `segments` | `number` | — | Splits the track into this many equal steps, such as 4 for a task of four stages, each filling in turn. Without it, the track is one bar. |
|
|
89
|
-
| `label`
|
|
89
|
+
| `label` | `ReactNode` | — | What the bar shows, such as Seats assigned; it shows with the bar and names it. Leave it out for a bare bar named with aria-label or aria-labelledby, such as by the name beside it in a row; without a label or valueText the bar has no row above it. |
|
|
90
90
|
| `min` | `number` | `0` | The low end of the range. |
|
|
91
91
|
| `max` | `number` | `100` | The high end of the range. |
|
|
92
92
|
| `valueText` | `ReactNode` | — | The value as text at the end of the label's row, formatted by the application, such as 2 of 5 or 40%. Without it, no value shows. |
|
package/docs/components/radio.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Radio
|
|
3
|
-
summary:
|
|
3
|
+
summary: Picks one of up to five options, all visible at once.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -28,6 +28,7 @@ components:
|
|
|
28
28
|
examples: # Each file is examples/radio/<Name>.tsx.
|
|
29
29
|
ChooseLanguage: overview
|
|
30
30
|
SideBySide: example
|
|
31
|
+
PlanRows: example
|
|
31
32
|
RadioAnatomy: anatomy
|
|
32
33
|
RequiredChoice: example
|
|
33
34
|
---
|
|
@@ -40,12 +41,16 @@ examples: # Each file is examples/radio/<Name>.tsx.
|
|
|
40
41
|
|
|
41
42
|
Example: SideBySide.
|
|
42
43
|
|
|
44
|
+
### Rows of a list
|
|
45
|
+
|
|
46
|
+
Example: PlanRows.
|
|
47
|
+
|
|
43
48
|
## Anatomy
|
|
44
49
|
|
|
45
50
|
1. **Group** (`env-radio-group`)
|
|
46
51
|
2. **Group label** (`env-radio-group > legend`, `label`)
|
|
47
52
|
3. **Option** (`env-radio`)
|
|
48
|
-
4. **Label** (`env-radio
|
|
53
|
+
4. **Label** (`env-radio-label`, `label`)
|
|
49
54
|
5. **Description** (`env-radio-description`, `description`)
|
|
50
55
|
6. **Radio** (`env-radio-input`)
|
|
51
56
|
7. **State layer** (`env-radio-control`)
|
|
@@ -73,7 +78,7 @@ A set of up to five options to choose exactly one from, all in view: a native fi
|
|
|
73
78
|
| Prop | Type | Default | Description |
|
|
74
79
|
| --- | --- | --- | --- |
|
|
75
80
|
| `ref` | `Ref<HTMLFieldSetElement>` | — | The group's fieldset. |
|
|
76
|
-
| `label` | `ReactNode` | — | The group's visible name, such as Visibility, as the fieldset's legend above the options. It names the group for assistive technology. Without it, name it with aria-label or aria-labelledby. |
|
|
81
|
+
| `label` | `ReactNode` | — | The group's visible name, such as Visibility, as the fieldset's legend above the options. It names the group for assistive technology. Without it, a List.Item whose control it is names it, or name it with aria-label or aria-labelledby. |
|
|
77
82
|
| `value` | `string \| null` | — | The value of the chosen option in a controlled group, or null for none; update it from onValueChange. |
|
|
78
83
|
| `defaultValue` | `string` | — | The value of the option an uncontrolled group starts with; a native form reset returns to it. Without value or defaultValue, no option is chosen until people choose one. |
|
|
79
84
|
| `onValueChange` | `(value: string) => void` | — | Receives the value of the option people choose. |
|
|
@@ -96,8 +101,9 @@ One option of a RadioGroup: a native radio input with its label, and an optional
|
|
|
96
101
|
| `className` | `string` | — | The option's class, on its root element, the label around the radio and the text. |
|
|
97
102
|
| `style` | `CSSProperties` | — | Styles of the root element. |
|
|
98
103
|
| `value` (required) | `string` | — | The value the group reports and a form submits when this option is chosen. |
|
|
99
|
-
| `label`
|
|
104
|
+
| `label` | `ReactNode` | — | The option's visible name, such as Private; pressing it chooses the option. Without it, a List.Item whose control it is names it, such as a plan's row with its price and features, or name it with aria-label or aria-labelledby, such as a radio in a table's cell. |
|
|
100
105
|
| `description` | `ReactNode` | — | A short, muted line under the label that helps people choose, such as Only the people you invite. It is part of the option's label, so it is read with its name. |
|
|
106
|
+
| `labelPlacement` | `'end' \| 'start'` | `'end'` | Where the label sits beside the radio: end, after it, or start, before it, such as in an inline row whose label leads; the native label still names the radio. |
|
|
101
107
|
|
|
102
108
|
Native props: `<input>`.
|
|
103
109
|
|
|
@@ -119,7 +125,9 @@ Native props: `<input>`.
|
|
|
119
125
|
- `env-radio-description`: A radio's description.
|
|
120
126
|
- `env-radio-description-content`: The slot of a radio's description.
|
|
121
127
|
- `env-radio-input`: The native input.
|
|
122
|
-
- `env-radio-label`: The
|
|
128
|
+
- `env-radio-label`: The label, with the description under it.
|
|
129
|
+
- `env-radio-label-content`: The slot of the label.
|
|
130
|
+
- `data-label-placement`: `start`
|
|
123
131
|
- `data-orientation`: `horizontal`, `vertical`
|
|
124
132
|
|
|
125
133
|
## Color properties
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: RelativeTime
|
|
3
|
-
summary: A
|
|
3
|
+
summary: A time shown relative to now, such as 3 hours ago, kept up to date.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Data display
|
|
@@ -70,6 +70,7 @@ A moment in a time element as text relative to now, such as "3 hours ago", with
|
|
|
70
70
|
| `value` (required) | `RelativeTimeValue` | — | The moment to describe: a Date, milliseconds since 1970 or a date string such as an ISO 8601 timestamp. An invalid moment renders nothing. |
|
|
71
71
|
| `now` | `Date \| number` | — | A fixed moment to compare with, for tests and server rendering; the text then stays as it is. Without it, or with an invalid one, the text follows the current time. |
|
|
72
72
|
| `tooltip` | `boolean` | `true` | Show the date and time in a tooltip on hover, such as "Oct 14, 2026, 9:41 AM", in the reader's time zone and the locale. Turn it off where the exact moment shows nearby. Inside an application's own Tooltip, that one describes the time instead. |
|
|
73
|
+
| `renderTooltip` | `(date: Date) => ReactNode` | — | The tooltip's content from the moment, such as the time with its time zone, in UTC, or "Edited by Alex Morgan at 9:41"; the date and time in the locale by default. |
|
|
73
74
|
| `locale` | `string \| readonly string[]` | `EnvUIProvider's locale for RelativeTime, else the runtime's language: the browser's, or the server's while rendering there` | The language of the text, and of the date and time in RelativeTime's tooltip, as a BCP 47 tag such as "en-GB" or "de", or a list of them in order of preference. |
|
|
74
75
|
| `format` | `'long' \| 'short' \| 'narrow'` | `'long'` | How long the words are, from Intl.RelativeTimeFormat: long "3 hours ago", short "3 hr. ago" or narrow "3h ago", in the locale's own wording. |
|
|
75
76
|
| `nowLabel` | `string` | `'just now' or 'now' in English, the locale's word for now elsewhere` | Text for a moment less than 45 seconds away, past or coming, such as "moments ago". English says "just now" of a past moment and "now" of a coming one; other languages the locale's word. RelativeTime takes EnvUIProvider's `messages.relativeTime.now` without it. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: ResizeHandle
|
|
3
|
-
summary: A handle
|
|
3
|
+
summary: A handle that resizes the area next to it, by dragging or with the arrow keys.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 2.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -11,17 +11,19 @@ aliases:
|
|
|
11
11
|
- drag handle
|
|
12
12
|
- separator
|
|
13
13
|
useWhen:
|
|
14
|
-
- A
|
|
15
|
-
- An edge
|
|
14
|
+
- A docked panel whose height people choose, such as a run's logs
|
|
15
|
+
- An edge that none of envUI's resizable components already gives
|
|
16
16
|
avoidWhen:
|
|
17
17
|
- text: Two panes of one region, side by side, one of them resized.
|
|
18
18
|
use: Panes
|
|
19
|
+
- text: An application's navigation, whose width people choose.
|
|
20
|
+
use: NavigationDrawer
|
|
19
21
|
- text: A panel over the page whose width people choose.
|
|
20
22
|
use: Sheet
|
|
21
23
|
components:
|
|
22
24
|
- ResizeHandle
|
|
23
25
|
examples: # Each file is examples/resize-handle/<Name>.tsx.
|
|
24
|
-
|
|
26
|
+
DockedLogs: { role: overview, caption: "The top edge of a run's logs, which people drag up to read more of them; its grip shows where to take it." }
|
|
25
27
|
ResizeHandleAnatomy: anatomy
|
|
26
28
|
WithoutAGrip: example
|
|
27
29
|
---
|
package/docs/components/row.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Row
|
|
3
|
-
summary:
|
|
3
|
+
summary: Places content side by side with even gaps, wrapping when it doesn't fit.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -65,7 +65,7 @@ Lays its direct children out side by side, `gap` apart, with `wrap` to run onto
|
|
|
65
65
|
| `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. |
|
|
66
66
|
| `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. |
|
|
67
67
|
| `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. |
|
|
68
|
-
| `name` | `string` | — | A name for this node, such as "filters" or "summary",
|
|
68
|
+
| `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. |
|
|
69
69
|
| `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. |
|
|
70
70
|
| `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. |
|
|
71
71
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Scaffold
|
|
3
|
-
summary: The
|
|
3
|
+
summary: 'The layout of an app screen: top bar, navigation and page.'
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: App frame & layout
|
|
@@ -24,7 +24,7 @@ useWhen:
|
|
|
24
24
|
avoidWhen:
|
|
25
25
|
- text: A readable column for a page's content, with its gutters.
|
|
26
26
|
use: Page
|
|
27
|
-
- text: Two panes side by side inside the body, such as a
|
|
27
|
+
- text: Two panes side by side inside the body, such as a document and its details.
|
|
28
28
|
use: Panes
|
|
29
29
|
components:
|
|
30
30
|
- Scaffold
|
|
@@ -33,6 +33,7 @@ examples: # Each file is examples/scaffold/<Name>.tsx.
|
|
|
33
33
|
ChooseForms: example
|
|
34
34
|
NarrowNavigation: example
|
|
35
35
|
TitleBarAcross: example
|
|
36
|
+
InspectorAndStatus: example
|
|
36
37
|
NavigationApart: example
|
|
37
38
|
ScaffoldAnatomy: anatomy
|
|
38
39
|
FormsByWidth: example
|
|
@@ -54,6 +55,10 @@ Example: NarrowNavigation.
|
|
|
54
55
|
|
|
55
56
|
Example: TitleBarAcross.
|
|
56
57
|
|
|
58
|
+
### An inspector and a status bar
|
|
59
|
+
|
|
60
|
+
Example: InspectorAndStatus.
|
|
61
|
+
|
|
57
62
|
### Backgrounds
|
|
58
63
|
|
|
59
64
|
Example: NavigationApart.
|
|
@@ -83,11 +88,13 @@ import { Scaffold } from '@envsemble/envui';
|
|
|
83
88
|
|
|
84
89
|
### Scaffold
|
|
85
90
|
|
|
86
|
-
The invisible structure of an application's screen: a top bar region, a navigation region and the body. It never paints. It shows one navigation form at a time by its own width: a NavigationBar at the bottom of a compact window, a NavigationRail at the start of a medium one and a NavigationDrawer at the start from expanded. The document scrolls by default, with the top bar, the bar and the rail or the drawer kept in view; `scroll="body"` scrolls the body alone. Skip links to the body and the navigation come first.
|
|
91
|
+
The invisible structure of an application's screen: a top bar region, a navigation region and the body, with an optional aside region and bottom bar. It never paints. It shows one navigation form at a time by its own width: a NavigationBar at the bottom of a compact window, a NavigationRail at the start of a medium one and a NavigationDrawer at the start from expanded. The document scrolls by default, with the top bar, the bar and the rail or the drawer kept in view; `scroll="body"` scrolls the body alone. Skip links to the body and the navigation come first.
|
|
87
92
|
|
|
88
93
|
| Prop | Type | Default | Description |
|
|
89
94
|
| --- | --- | --- | --- |
|
|
90
95
|
| `topBar` | `ReactNode` | — | The top bar region, above the body: usually a TopBar. |
|
|
96
|
+
| `aside` | `ReactNode` | — | A region at the end edge, beside the body and under the top bar, such as an inspector, at the width of its content and scrolling on its own. It stays in view as the rail does. |
|
|
97
|
+
| `bottomBar` | `ReactNode` | — | A bar along the bottom of the body and the aside region, such as a status bar, above a NavigationBar. It stays in view as the top bar does, and focus scrolls clear of it. |
|
|
91
98
|
| `navigation` | `ScaffoldNavigation` | — | The navigation forms, such as `{ bar: <NavigationBar … />, rail: <NavigationRail … />, drawer: <NavigationDrawer … /> }` with the same destinations. One shows at a time, chosen by the Scaffold's own width; give only the forms the application uses. |
|
|
92
99
|
| `navigationForms` | `ScaffoldForms` | `{ compact: 'bar', medium: 'rail', expanded: 'drawer', large: 'drawer' }` | Which form shows at each window class, or none, such as `{ compact: 'none' }` for an application that opens its navigation from the top bar on a phone. Where the form a window class asks for wasn't given, the nearest given form shows: a rail for a drawer and the other way round, then the bar. |
|
|
93
100
|
| `topBarSpan` | `'body' \| 'full'` | `'body'` | body: the top bar sits above the body, beside the rail or drawer, which run the full height. full: the top bar runs across the whole width, above the navigation, as a window's title bar must. |
|
|
@@ -97,7 +104,7 @@ The invisible structure of an application's screen: a top bar region, a navigati
|
|
|
97
104
|
| `skipToContentLabel` | `string` | `'Skip to content', or EnvUIProvider's messages.scaffold.skipToContent` | The name of the skip link to the body. |
|
|
98
105
|
| `skipToNavigationLabel` | `string` | `'Skip to navigation', or EnvUIProvider's messages.scaffold.skipToNavigation` | The name of the skip link to the navigation. |
|
|
99
106
|
| `landmarks` | `boolean` | `true` | false renders the regions without landmarks, a div for the banner and the main, and no skip links, for a preview of an application inside another page's main content. |
|
|
100
|
-
| `name` | `string` | — | A name for this node, such as "app",
|
|
107
|
+
| `name` | `string` | — | A name for this node, such as "app", for the application's styles and tests to find it by; it renders as `data-env-name`. |
|
|
101
108
|
| `children` | `ReactNode` | — | The body: the page's main content, usually a Page or Panes. |
|
|
102
109
|
|
|
103
110
|
Native props: `<div>`.
|
|
@@ -105,8 +112,10 @@ Native props: `<div>`.
|
|
|
105
112
|
## Part names
|
|
106
113
|
|
|
107
114
|
- `env-scaffold`: The scaffold: the top bar, navigation and body regions; it never paints.
|
|
115
|
+
- `env-scaffold-aside`: The aside region at the end edge beside the body, such as an inspector, which scrolls on its own.
|
|
108
116
|
- `env-scaffold-bar`: The slot of the navigation bar, at the bottom of a compact window.
|
|
109
117
|
- `env-scaffold-body`: The body, the main region, which scrolls.
|
|
118
|
+
- `env-scaffold-bottom-bar`: The bottom bar region under the body and the aside region, such as a status bar.
|
|
110
119
|
- `env-scaffold-drawer`: The slot of the navigation drawer, at the start from expanded.
|
|
111
120
|
- `env-scaffold-navigation`: The navigation region, which holds a slot per form.
|
|
112
121
|
- `env-scaffold-rail`: The slot of the navigation rail, at the start of a medium window.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: SegmentedControl
|
|
3
|
-
summary:
|
|
3
|
+
summary: Switches between a few views or filters of the same content.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -28,6 +28,7 @@ components:
|
|
|
28
28
|
examples: # Each file is examples/segmented-control/<Name>.tsx.
|
|
29
29
|
WorkItems: overview
|
|
30
30
|
SmallToolbar: example
|
|
31
|
+
IconOnlyAndBadge: example
|
|
31
32
|
SegmentedControlAnatomy: anatomy
|
|
32
33
|
FullWidthScope: example
|
|
33
34
|
---
|
|
@@ -40,12 +41,16 @@ examples: # Each file is examples/segmented-control/<Name>.tsx.
|
|
|
40
41
|
|
|
41
42
|
Example: SmallToolbar.
|
|
42
43
|
|
|
44
|
+
### Icon-only segments and badges
|
|
45
|
+
|
|
46
|
+
Example: IconOnlyAndBadge.
|
|
47
|
+
|
|
43
48
|
## Anatomy
|
|
44
49
|
|
|
45
50
|
1. **Track** (`env-segmented-control`)
|
|
46
51
|
2. **Thumb** (`env-segmented-control-item[data-checked]`)
|
|
47
52
|
3. **Segment** (`env-segmented-control-item[data-unchecked]`)
|
|
48
|
-
4. **
|
|
53
|
+
4. **Start** (`env-segmented-control-item[data-unchecked] > env-segmented-control-item-start`, `start`)
|
|
49
54
|
5. **Label** (`env-segmented-control-item-label`, `label`)
|
|
50
55
|
6. **Count** (`env-segmented-control-item-count`, `count`)
|
|
51
56
|
|
|
@@ -75,7 +80,7 @@ One choice among a few items, such as views or filters of the same content: segm
|
|
|
75
80
|
| `value` | `string` | — | The chosen item's value, for a control the application keeps; update it from onValueChange. |
|
|
76
81
|
| `defaultValue` | `string` | `the first item's value` | The item an uncontrolled control starts with chosen. |
|
|
77
82
|
| `onValueChange` | `(value: string) => void` | — | Receives the value of the item people choose, by pressing it or with the arrow keys. |
|
|
78
|
-
| `aria-label`
|
|
83
|
+
| `aria-label` | `string` | — | The group's accessible name, such as Work items; the control has no visible label. Without it, a List.Item whose control it is names it, or name it with aria-labelledby. |
|
|
79
84
|
| `size` | `'sm' \| 'md' \| 'lg'` | — | The height, as on every control: sm, md or lg in the current scale, so it lines up with buttons and fields of the same size. Without it, it takes the control height of its container, md unless the container sets another. |
|
|
80
85
|
| `fullWidth` | `boolean` | `false` | Fill the available width, split evenly between the items; a label too long for its share is cut short with an ellipsis and shows whole in a tooltip. Without it the control is as wide as its items, and scrolls in a container too narrow for them. |
|
|
81
86
|
| `disabled` | `boolean` | `false` | Disable every item; the control can't be focused or changed. |
|
|
@@ -87,8 +92,9 @@ Native props: `<div>`.
|
|
|
87
92
|
- `env-segmented-control`: The segmented control: the track the segments sit in.
|
|
88
93
|
- `env-segmented-control-item`: One segment; the chosen one rises on a raised thumb.
|
|
89
94
|
- `env-segmented-control-item-count`: A segment's count.
|
|
90
|
-
- `env-segmented-control-item-
|
|
95
|
+
- `env-segmented-control-item-end`: The slot of the content after a segment's label and count, such as a Badge.
|
|
91
96
|
- `env-segmented-control-item-label`: A segment's label.
|
|
97
|
+
- `env-segmented-control-item-start`: The slot of the content before a segment's label, such as an icon.
|
|
92
98
|
- `env-segmented-control-thumb`: The raised thumb that travels to the chosen segment, hidden until it has measured it.
|
|
93
99
|
- `data-checked`: any value, or present, on `env-segmented-control-item`
|
|
94
100
|
- `data-disabled`: any value, or present, on `env-segmented-control-item`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Select
|
|
3
|
-
summary:
|
|
3
|
+
summary: A dropdown for picking one option.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -31,6 +31,7 @@ components:
|
|
|
31
31
|
examples: # Each file is examples/select/<Name>.tsx.
|
|
32
32
|
ProjectVisibility: overview
|
|
33
33
|
SmallToolbar: example
|
|
34
|
+
Assignee: example
|
|
34
35
|
SelectAnatomy: anatomy
|
|
35
36
|
SelectListAnatomy: anatomy
|
|
36
37
|
SettingsForm: example
|
|
@@ -44,6 +45,10 @@ examples: # Each file is examples/select/<Name>.tsx.
|
|
|
44
45
|
|
|
45
46
|
Example: SmallToolbar.
|
|
46
47
|
|
|
48
|
+
### Pictures and groups
|
|
49
|
+
|
|
50
|
+
Example: Assignee.
|
|
51
|
+
|
|
47
52
|
## Anatomy
|
|
48
53
|
|
|
49
54
|
1. **Select** (`env-select`)
|
|
@@ -82,7 +87,7 @@ One choice from a list that stays collapsed until opened: an outlined field, as
|
|
|
82
87
|
| `ref` | `Ref<HTMLButtonElement>` | — | The trigger, the button that shows the chosen option and opens the list. |
|
|
83
88
|
| `className` | `string` | — | The field's class, on its root element, beside env-field and env-select. |
|
|
84
89
|
| `style` | `CSSProperties` | — | Styles of the field's root element. |
|
|
85
|
-
| `items` (required) | `readonly SelectItem[]` | — | The options of the list, in order, each with a value, a label, an optional description and whether it is disabled. |
|
|
90
|
+
| `items` (required) | `readonly SelectItem[] \| readonly SelectGroup[]` | — | The options of the list, in order, each with a value, a label, an optional description, start and end content and whether it is disabled; or groups of options under headings. |
|
|
86
91
|
| `value` | `string \| null` | — | The chosen option's value in a controlled select, or null for none, which shows the placeholder; update it from onValueChange. |
|
|
87
92
|
| `defaultValue` | `string \| null` | — | The chosen option's value an uncontrolled select starts with; a native form reset returns to it. Without it, nothing is chosen and the trigger shows the placeholder. |
|
|
88
93
|
| `onValueChange` | `(value: string \| null) => void` | — | Receives the value of the option people choose. |
|
|
@@ -107,6 +112,8 @@ Native props: `<button>`.
|
|
|
107
112
|
- `env-select`: The select field.
|
|
108
113
|
- `env-select-control`: The outlined box that holds the button and the chevron.
|
|
109
114
|
- `env-select-end`: The chevron's place at the end of the well.
|
|
115
|
+
- `env-select-group`: A group of options.
|
|
116
|
+
- `env-select-group-label`: A group's heading.
|
|
110
117
|
- `env-select-icon`: The chevron.
|
|
111
118
|
- `env-select-item`: One option.
|
|
112
119
|
- `env-select-item-indicator`: The check of the chosen option.
|
|
@@ -117,6 +124,7 @@ Native props: `<button>`.
|
|
|
117
124
|
- `env-select-sizer`: The labels of every option, hidden, which give the field its width without a visible label.
|
|
118
125
|
- `env-select-trigger`: The button that shows the value and opens the list.
|
|
119
126
|
- `env-select-value`: The chosen option's label.
|
|
127
|
+
- `env-select-value-start`: The slot of the chosen option's start content on the trigger.
|
|
120
128
|
- `data-disabled`: any value, or present, on `env-select-item`
|
|
121
129
|
- `data-highlighted`: any value, or present, on `env-select-item`
|
|
122
130
|
- `data-label-hidden`: any value, or present
|
package/docs/components/sheet.md
CHANGED
|
@@ -95,7 +95,10 @@ A panel that slides in over the page from an edge of the window, for filters, de
|
|
|
95
95
|
| `aria-label` | `string` | — | The sheet's accessible name where it has no visible title. |
|
|
96
96
|
| `description` | `ReactNode` | — | Muted text under the title that describes the sheet to assistive technology too. |
|
|
97
97
|
| `children` | `ReactNode` | — | The content under the heading, such as filters, details or choices. It scrolls. |
|
|
98
|
-
| `actions` | `ReactNode` | — | Actions at the end of the content, such as Apply, with the primary action last. While the sheet is pending, the last one shows it, where it is a Button that sets no pending of its own. |
|
|
98
|
+
| `actions` | `ReactNode` | — | Actions at the end of the content, such as Apply, with the primary action last. While the sheet 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 Reset button or a Learn more link. |
|
|
100
|
+
| `headerStart` | `ReactNode` | — | Content before the title in the heading's row, such as a back button. |
|
|
101
|
+
| `headerEnd` | `ReactNode` | — | Content at the end of the heading's row, before the close button, such as a Menu of more actions or an Open full page button. |
|
|
99
102
|
| `closeButton` | `boolean` | `true` | Whether the sheet shows its close button, an IconButton with a cross at the end of the heading. Leave it out only where the sheet holds another control that closes it. |
|
|
100
103
|
| `closeLabel` | `string` | `'Close', or EnvUIProvider's messages.dialog.close` | The close button's name. |
|
|
101
104
|
| `width` | `'md' \| 'lg' \| number \| (string & {})` | `'md'` | A side sheet's width: md, 24 rem, for details and filters; lg, 44 rem, for content-heavy panels such as tables and comparisons; or any CSS length, such as min(20rem, 100% - 2rem). md takes the whole width of a compact window, lg of a compact or medium one, where the page beside it would be a sliver. A number is a width in rem: with `resizable`, the width the application controls with onWidthChange, while a CSS length is ignored, and warned of while developing: the sheet starts at `defaultWidth`. A bottom sheet ignores it. |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Slider
|
|
3
|
-
summary:
|
|
3
|
+
summary: Picks a value in a range, by dragging or with the keyboard.
|
|
4
4
|
status: stable
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Forms & selection
|
|
@@ -29,6 +29,7 @@ examples: # Each file is examples/slider/<Name>.tsx.
|
|
|
29
29
|
SliderAnatomy: { role: anatomy, caption: "As under the pointer, which shows the handle." }
|
|
30
30
|
SaveOnRelease: example
|
|
31
31
|
SessionTimeout: example
|
|
32
|
+
IconsAndUnits: example
|
|
32
33
|
NarrowSlider: example
|
|
33
34
|
---
|
|
34
35
|
|
|
@@ -54,6 +55,10 @@ Example: SaveOnRelease.
|
|
|
54
55
|
|
|
55
56
|
Example: SessionTimeout.
|
|
56
57
|
|
|
58
|
+
### Icons and units
|
|
59
|
+
|
|
60
|
+
Example: IconsAndUnits.
|
|
61
|
+
|
|
57
62
|
### Adapting to width
|
|
58
63
|
|
|
59
64
|
Example: NarrowSlider.
|
|
@@ -84,7 +89,7 @@ A value in a range, as a field: as tall as the fields and with their corners, so
|
|
|
84
89
|
|
|
85
90
|
| Prop | Type | Default | Description |
|
|
86
91
|
| --- | --- | --- | --- |
|
|
87
|
-
| `label`
|
|
92
|
+
| `label` | `ReactNode` | — | The value's name, inside the slider at its start, such as Opacity: text, or any content, such as a volume icon beside the text. It names the slider, and ends in an ellipsis where the slider is too narrow for it. Without it, a List.Item whose control it is names the slider, or name it with aria-label or aria-labelledby. |
|
|
88
93
|
| `description` | `ReactNode` | — | Lasting guidance under the slider, such as what the value applies to, linked to the slider as its description. |
|
|
89
94
|
| `error` | `ReactNode` | — | A message under the slider that says how to correct the value; it joins the slider's description, after the description. |
|
|
90
95
|
| `value` | `number` | — | The value of a controlled slider; update it from onValueChange. |
|
|
@@ -96,6 +101,7 @@ A value in a range, as a field: as tall as the fields and with their corners, so
|
|
|
96
101
|
| `step` | `number` | `1` | The distance between the values the slider can take, counted from min; an arrow key moves by it. |
|
|
97
102
|
| `largeStep` | `number` | `a tenth of the range in whole steps, at least one step` | The change of Page Up, Page Down and an arrow key with Shift. |
|
|
98
103
|
| `formatValue` | `(value: number) => string` | — | The value as people read it at the slider's end and assistive technology announces it, such as (value) => `${value}%`. Without it, the number shows in the locale. |
|
|
104
|
+
| `renderValue` | `(value: number) => ReactNode` | — | What the slider's end shows for the value in place of formatValue's text, such as the number with its unit styled apart, or a swatch; formatValue, or the number in the locale, stays what assistive technology announces. |
|
|
99
105
|
| `locale` | `string` | — | The locale of the shown number: EnvUIProvider's, else the browser's. |
|
|
100
106
|
| `disabled` | `boolean` | `false` | Dim the slider; it can't be focused or moved, and forms leave it out. |
|
|
101
107
|
| `name` | `string` | — | Submits the value with a form under this name. |
|
|
@@ -79,6 +79,7 @@ An on/off setting that takes effect at once: a native checkbox with the switch r
|
|
|
79
79
|
| `style` | `CSSProperties` | — | Styles of the root element. |
|
|
80
80
|
| `label` | `ReactNode` | — | The setting the switch turns on or off, such as Show completed tasks, beside the track. It names the switch, stays the same in both states, and pressing it toggles the switch too. Without it, a List.Item whose control it is names it, or name it with aria-label or aria-labelledby. |
|
|
81
81
|
| `description` | `ReactNode` | — | A short, muted line under the label, such as what the option changes. It is part of the switch's label, so it is read with its name. |
|
|
82
|
+
| `labelPlacement` | `'end' \| 'start'` | `'end'` | Where the label sits beside the track: end, after it, or start, before it, as in an inline Dark mode switch whose label leads; the native label still names the switch. |
|
|
82
83
|
| `checked` | `boolean` | — | Whether a controlled switch is on; update it from onCheckedChange. |
|
|
83
84
|
| `defaultChecked` | `boolean` | `false` | Whether an uncontrolled switch starts on; a native form reset returns it to this state. |
|
|
84
85
|
| `onCheckedChange` | `(checked: boolean) => void` | — | Receives the new state each time people turn the switch on or off. |
|
|
@@ -93,6 +94,7 @@ Native props: `<input>`.
|
|
|
93
94
|
- `env-switch-input`: The native input.
|
|
94
95
|
- `env-switch-label`: The label, with the description under it.
|
|
95
96
|
- `env-switch-label-content`: The slot of the label.
|
|
97
|
+
- `data-label-placement`: `start`
|
|
96
98
|
|
|
97
99
|
## Color properties
|
|
98
100
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: TableOfContents
|
|
3
|
-
summary:
|
|
3
|
+
summary: Links to the page's sections, with the current one highlighted.
|
|
4
4
|
status: beta
|
|
5
5
|
since: 1.0.0
|
|
6
6
|
category: Navigation
|
|
@@ -39,7 +39,7 @@ examples: # Each file is examples/table-of-contents/<Name>.tsx.
|
|
|
39
39
|
|
|
40
40
|
1. **Contents** (`env-table-of-contents`)
|
|
41
41
|
2. **Reader's place** (`env-table-of-contents-wave`)
|
|
42
|
-
3. **Link** (`env-table-of-contents-link:not([aria-current])`)
|
|
42
|
+
3. **Link** (`env-table-of-contents-item:last-child > env-table-of-contents-link:not([aria-current])`)
|
|
43
43
|
4. **Current section** (`env-table-of-contents-link[aria-current='location']`)
|
|
44
44
|
|
|
45
45
|
## Behaviour
|
|
@@ -68,6 +68,7 @@ The page's sections as links, nested by level, with the one the reader is in mar
|
|
|
68
68
|
| `container` | `RefObject<HTMLElement \| null> \| string` | `The page's `main` element, or the body without one` | Where to find the headings, without `items`: an element's ref or a CSS selector. |
|
|
69
69
|
| `levels` | `readonly HeadingLevel[]` | `[2, 3]` | The heading levels to list, without `items`. A heading nests under the one above it of a lower level. A heading without an id gets one from its words. |
|
|
70
70
|
| `filter` | `(heading: HTMLElement) => boolean` | — | Leaves out the headings it returns false for, without `items`, such as an example's own. |
|
|
71
|
+
| `onNavigate` | `(id: string, event: MouseEvent<HTMLAnchorElement>) => void` | — | Called when people follow a link, with its section's id and the click, before envUI scrolls the section into view and focuses it. Each link is an `#id` link through LinkProvider's link component, so the application's router, or else the browser, changes the address. Call preventDefault to make the jump yourself, without envUI's scroll or the address change. |
|
|
71
72
|
| `aria-label` | `string` | `'On this page', or EnvUIProvider's messages.tableOfContents.label` | The accessible name of the navigation landmark. |
|
|
72
73
|
| `className` | `string` | — | Classes for the `nav` element. |
|
|
73
74
|
|