@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
|
@@ -4,28 +4,27 @@ import {
|
|
|
4
4
|
useCallback,
|
|
5
5
|
useEffect,
|
|
6
6
|
useMemo,
|
|
7
|
-
useRef
|
|
8
|
-
useState
|
|
7
|
+
useRef
|
|
9
8
|
} from "react";
|
|
10
9
|
import { ActionElement } from "../internal/control/ActionElement.js";
|
|
11
10
|
import { classNames } from "../internal/classNames.js";
|
|
11
|
+
import { landmarkLabel } from "./internal/landmarkLabel.js";
|
|
12
12
|
import { useMessages } from "../internal/provider/EnvUIContext.js";
|
|
13
13
|
import { tableOfContents } from "../foundations/messages/tableOfContents.js";
|
|
14
|
+
import { flatten } from "./internal/tableOfContents/contentsOutline.js";
|
|
15
|
+
import { focusSection, rememberScroll } from "./internal/tableOfContents/sectionScroll.js";
|
|
16
|
+
import { useContentsHeadings } from "./internal/tableOfContents/useContentsHeadings.js";
|
|
14
17
|
import {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
} from "
|
|
19
|
-
import { focusSection, readSections } from "./internal/sectionScroll.js";
|
|
20
|
-
import { useContentsHeadings } from "./internal/useContentsHeadings.js";
|
|
21
|
-
import { createWaveDrawer } from "./internal/waveDrawer.js";
|
|
22
|
-
import { prefersReducedMotion, reducedMotionQuery } from "../internal/motion/reducedMotion.js";
|
|
18
|
+
scrollPauseThatEndsLinkScrollMs,
|
|
19
|
+
useReadingPlace
|
|
20
|
+
} from "./internal/tableOfContents/useReadingPlace.js";
|
|
21
|
+
import { prefersReducedMotion } from "../internal/motion/reducedMotion.js";
|
|
23
22
|
import { flag } from "../internal/flag.js";
|
|
23
|
+
import { useLatest } from "../internal/react/useLatest.js";
|
|
24
24
|
import "#styles/Base.css";
|
|
25
25
|
import "#styles/TableOfContents.css";
|
|
26
26
|
const defaultLevels = [2, 3];
|
|
27
|
-
|
|
28
|
-
function List({ items, current, passed, depth, onNavigate }) {
|
|
27
|
+
function ContentsList({ items, current, passed, depth, onNavigate }) {
|
|
29
28
|
return /* @__PURE__ */ jsx(
|
|
30
29
|
"ol",
|
|
31
30
|
{
|
|
@@ -44,7 +43,7 @@ function List({ items, current, passed, depth, onNavigate }) {
|
|
|
44
43
|
}
|
|
45
44
|
),
|
|
46
45
|
item.children && item.children.length > 0 && /* @__PURE__ */ jsx(
|
|
47
|
-
|
|
46
|
+
ContentsList,
|
|
48
47
|
{
|
|
49
48
|
items: item.children,
|
|
50
49
|
current,
|
|
@@ -62,6 +61,7 @@ function TableOfContents({
|
|
|
62
61
|
container,
|
|
63
62
|
levels = defaultLevels,
|
|
64
63
|
filter,
|
|
64
|
+
onNavigate,
|
|
65
65
|
"aria-label": label,
|
|
66
66
|
className,
|
|
67
67
|
...props
|
|
@@ -70,126 +70,37 @@ function TableOfContents({
|
|
|
70
70
|
const root = useRef(null);
|
|
71
71
|
const shape = useRef(null);
|
|
72
72
|
const items = useContentsHeadings({ givenItems, container, levels, filter, own: root });
|
|
73
|
-
const [current, setCurrent] = useState();
|
|
74
73
|
const chosenByLink = useRef(null);
|
|
75
|
-
const
|
|
76
|
-
const
|
|
77
|
-
|
|
78
|
-
const settleLater = useCallback((delay) => {
|
|
79
|
-
clearTimeout(settle.current);
|
|
80
|
-
const choice = chosenByLink.current;
|
|
81
|
-
if (!choice) return;
|
|
82
|
-
settle.current = window.setTimeout(() => {
|
|
83
|
-
choice.settled = true;
|
|
84
|
-
measureOnNextFrame.current();
|
|
85
|
-
}, delay);
|
|
86
|
-
}, []);
|
|
87
|
-
useEffect(() => () => clearTimeout(settle.current), []);
|
|
74
|
+
const scrollFrame = useRef(0);
|
|
75
|
+
const latestOnNavigate = useLatest(onNavigate);
|
|
76
|
+
useEffect(() => () => cancelAnimationFrame(scrollFrame.current), []);
|
|
88
77
|
const flat = useMemo(() => flatten(items), [items]);
|
|
89
78
|
const ids = flat.map((entry) => entry.id).join("\n");
|
|
90
|
-
|
|
91
|
-
function trackCurrentSectionAndDrawReadersPlace() {
|
|
92
|
-
if (ids === "") {
|
|
93
|
-
setCurrent(void 0);
|
|
94
|
-
return;
|
|
95
|
-
}
|
|
96
|
-
const sectionIds = ids.split("\n");
|
|
97
|
-
const first = document.getElementById(sectionIds[0]);
|
|
98
|
-
const doc = first?.ownerDocument ?? document;
|
|
99
|
-
let frame = 0;
|
|
100
|
-
const drawer = createWaveDrawer(
|
|
101
|
-
() => root.current,
|
|
102
|
-
() => shape.current,
|
|
103
|
-
reducedMotionQuery()
|
|
104
|
-
);
|
|
105
|
-
const update = () => {
|
|
106
|
-
frame = 0;
|
|
107
|
-
const choice = chosenByLink.current;
|
|
108
|
-
if (choice?.settled) {
|
|
109
|
-
setCurrent(choice.id);
|
|
110
|
-
drawer.wave(sectionIds.indexOf(choice.id));
|
|
111
|
-
return;
|
|
112
|
-
}
|
|
113
|
-
const elements = sectionIds.map((id) => doc.getElementById(id)).filter((element) => element !== null);
|
|
114
|
-
if (elements.length === 0) {
|
|
115
|
-
setCurrent(void 0);
|
|
116
|
-
drawer.wave(null);
|
|
117
|
-
return;
|
|
118
|
-
}
|
|
119
|
-
const { sections, view } = readSections(elements, doc);
|
|
120
|
-
let next = currentSection(sections, view);
|
|
121
|
-
let position = readingPosition(sections, view);
|
|
122
|
-
if (choice) {
|
|
123
|
-
const chosenIndex = sectionIds.indexOf(choice.id);
|
|
124
|
-
if (position > chosenIndex) position = chosenIndex;
|
|
125
|
-
if (next && sectionIds.indexOf(next) > chosenIndex) next = choice.id;
|
|
126
|
-
}
|
|
127
|
-
setCurrent(next);
|
|
128
|
-
drawer.wave(position);
|
|
129
|
-
};
|
|
130
|
-
const schedule = () => {
|
|
131
|
-
if (frame === 0) frame = requestAnimationFrame(update);
|
|
132
|
-
};
|
|
133
|
-
const onScroll = (event) => {
|
|
134
|
-
const target = event.target;
|
|
135
|
-
const sectionLookedUpAfresh = doc.getElementById(sectionIds[0]);
|
|
136
|
-
const movesNoSection = target instanceof Element && sectionLookedUpAfresh && !target.contains(sectionLookedUpAfresh);
|
|
137
|
-
if (movesNoSection) return;
|
|
138
|
-
const choice = chosenByLink.current;
|
|
139
|
-
const scrollALinkStarted = choice && !choice.settled;
|
|
140
|
-
if (scrollALinkStarted) {
|
|
141
|
-
settleLater(scrollPauseThatEndsLinkScrollMs);
|
|
142
|
-
schedule();
|
|
143
|
-
return;
|
|
144
|
-
}
|
|
145
|
-
chosenByLink.current = null;
|
|
146
|
-
schedule();
|
|
147
|
-
};
|
|
148
|
-
const onResize = () => schedule();
|
|
149
|
-
measureOnNextFrame.current = schedule;
|
|
150
|
-
schedule();
|
|
151
|
-
doc.addEventListener("scroll", onScroll, { capture: true, passive: true });
|
|
152
|
-
window.addEventListener("resize", onResize);
|
|
153
|
-
const resizes = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(onResize);
|
|
154
|
-
if (first?.parentElement) resizes?.observe(first.parentElement);
|
|
155
|
-
const body = root.current;
|
|
156
|
-
const entriesMovedByWrapOrFont = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(drawer.remeasure);
|
|
157
|
-
if (body) entriesMovedByWrapOrFont?.observe(body);
|
|
158
|
-
body?.addEventListener("pointerover", drawer.onPointerOver);
|
|
159
|
-
body?.addEventListener("pointerleave", drawer.onPointerLeave);
|
|
160
|
-
return () => {
|
|
161
|
-
cancelAnimationFrame(frame);
|
|
162
|
-
drawer.stop();
|
|
163
|
-
doc.removeEventListener("scroll", onScroll, { capture: true });
|
|
164
|
-
window.removeEventListener("resize", onResize);
|
|
165
|
-
resizes?.disconnect();
|
|
166
|
-
entriesMovedByWrapOrFont?.disconnect();
|
|
167
|
-
body?.removeEventListener("pointerover", drawer.onPointerOver);
|
|
168
|
-
body?.removeEventListener("pointerleave", drawer.onPointerLeave);
|
|
169
|
-
};
|
|
170
|
-
},
|
|
171
|
-
[ids, settleLater]
|
|
172
|
-
);
|
|
79
|
+
const { current, settleLater } = useReadingPlace({ ids, root, shape, chosenByLink });
|
|
173
80
|
const navigate = useCallback(
|
|
174
81
|
(event, id) => {
|
|
175
82
|
if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
|
|
176
83
|
return;
|
|
177
84
|
}
|
|
85
|
+
latestOnNavigate.current?.(id, event);
|
|
86
|
+
if (event.defaultPrevented) return;
|
|
178
87
|
const target = event.currentTarget.ownerDocument.getElementById(id);
|
|
179
88
|
if (!target) return;
|
|
180
|
-
|
|
89
|
+
const scrollBackFromBrowsersJump = rememberScroll(target);
|
|
181
90
|
const choice = { id, settled: false };
|
|
182
91
|
chosenByLink.current = choice;
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
92
|
+
cancelAnimationFrame(scrollFrame.current);
|
|
93
|
+
scrollFrame.current = requestAnimationFrame(() => {
|
|
94
|
+
scrollBackFromBrowsersJump();
|
|
95
|
+
target.scrollIntoView({
|
|
96
|
+
behavior: prefersReducedMotion() ? "instant" : "smooth",
|
|
97
|
+
block: "start"
|
|
98
|
+
});
|
|
99
|
+
settleLater(scrollPauseThatEndsLinkScrollMs * 2);
|
|
100
|
+
focusSection(target);
|
|
186
101
|
});
|
|
187
|
-
settleLater(scrollPauseThatEndsLinkScrollMs * 2);
|
|
188
|
-
const hash = `#${id}`;
|
|
189
|
-
if (window.location.hash !== hash) window.history.pushState(window.history.state, "", hash);
|
|
190
|
-
focusSection(target);
|
|
191
102
|
},
|
|
192
|
-
[settleLater]
|
|
103
|
+
[settleLater, latestOnNavigate]
|
|
193
104
|
);
|
|
194
105
|
const passed = useMemo(() => {
|
|
195
106
|
const index = current ? flat.findIndex((entry) => entry.id === current) : -1;
|
|
@@ -199,7 +110,7 @@ function TableOfContents({
|
|
|
199
110
|
"nav",
|
|
200
111
|
{
|
|
201
112
|
...props,
|
|
202
|
-
"aria-label": label
|
|
113
|
+
"aria-label": landmarkLabel(label, props["aria-labelledby"], messages.label),
|
|
203
114
|
className: classNames("env-table-of-contents", className),
|
|
204
115
|
hidden: items.length === 0 ? true : props.hidden,
|
|
205
116
|
children: /* @__PURE__ */ jsxs("div", { className: "env-table-of-contents-body", ref: root, children: [
|
|
@@ -213,7 +124,16 @@ function TableOfContents({
|
|
|
213
124
|
children: /* @__PURE__ */ jsx("path", {})
|
|
214
125
|
}
|
|
215
126
|
),
|
|
216
|
-
/* @__PURE__ */ jsx(
|
|
127
|
+
/* @__PURE__ */ jsx(
|
|
128
|
+
ContentsList,
|
|
129
|
+
{
|
|
130
|
+
items,
|
|
131
|
+
current,
|
|
132
|
+
passed,
|
|
133
|
+
depth: 0,
|
|
134
|
+
onNavigate: navigate
|
|
135
|
+
}
|
|
136
|
+
)
|
|
217
137
|
] })
|
|
218
138
|
}
|
|
219
139
|
);
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/navigation/TableOfContents.tsx"],
|
|
4
|
-
"sourcesContent": ["'use client';\n\nimport {\n useCallback,\n useEffect,\n useMemo,\n useRef,\n useState,\n type ComponentPropsWithRef,\n type MouseEvent,\n type RefObject,\n} from 'react';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { classNames } from '../internal/classNames.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { tableOfContents } from '../foundations/messages/tableOfContents.js';\nimport {\n currentSection,\n readingPosition,\n flatten,\n type TableOfContentsItem,\n} from './internal/contentsOutline.js';\nimport { focusSection, readSections } from './internal/sectionScroll.js';\nimport { useContentsHeadings } from './internal/useContentsHeadings.js';\nimport { createWaveDrawer } from './internal/waveDrawer.js';\nimport { prefersReducedMotion, reducedMotionQuery } from '../internal/motion/reducedMotion.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/TableOfContents.css';\n\nexport type { TableOfContentsItem } from './internal/contentsOutline.js';\n\nexport interface TableOfContentsProps extends Omit<ComponentPropsWithRef<'nav'>, 'children'> {\n /**\n * The sections to list, nested through `children`, each leading to the element with its `id`:\n * a heading or any other part of the page, under a label of your own. Without it, the component\n * lists the headings it finds in `container`, after it mounts.\n */\n items?: readonly TableOfContentsItem[];\n /**\n * Where to find the headings, without `items`: an element's ref or a CSS selector.\n * @default The page's `main` element, or the body without one\n */\n container?: RefObject<HTMLElement | null> | string;\n /**\n * The heading levels to list, without `items`. A heading nests under the one above it of a lower\n * level. A heading without an id gets one from its words.\n * @default [2, 3]\n */\n levels?: readonly HeadingLevel[];\n /** Leaves out the headings it returns false for, without `items`, such as an example's own. */\n filter?: (heading: HTMLElement) => boolean;\n /**\n * The accessible name of the navigation landmark.\n * @default 'On this page', or EnvUIProvider's messages.tableOfContents.label\n */\n 'aria-label'?: string;\n /** Classes for the `nav` element. */\n className?: string;\n}\n\nconst defaultLevels: readonly HeadingLevel[] = [2, 3];\n\nconst scrollPauseThatEndsLinkScrollMs = 150;\n\ninterface ListProps {\n items: readonly TableOfContentsItem[];\n current: string | undefined;\n passed: ReadonlySet<string>;\n depth: number;\n onNavigate: (event: MouseEvent<HTMLElement>, id: string) => void;\n}\n\nfunction List({ items, current, passed, depth, onNavigate }: ListProps) {\n return (\n <ol\n className=\"env-table-of-contents-list\"\n style={depth > 0 ? { '--env-table-of-contents-depth': depth } : undefined}\n >\n {items.map((item) => (\n <li key={item.id} className=\"env-table-of-contents-item\">\n <ActionElement\n className=\"env-table-of-contents-link\"\n href={`#${item.id}`}\n aria-current={item.id === current ? 'location' : undefined}\n data-passed={flag(passed.has(item.id))}\n onClick={(event) => onNavigate(event, item.id)}\n >\n {item.label}\n </ActionElement>\n {item.children && item.children.length > 0 && (\n <List\n items={item.children}\n current={current}\n passed={passed}\n depth={depth + 1}\n onNavigate={onNavigate}\n />\n )}\n </li>\n ))}\n </ol>\n );\n}\n\n/**\n * The page's sections as links, nested by level, with the one the reader is in marked as they\n * scroll: the headings in a container by default, or sections of your own.\n */\nexport function TableOfContents({\n items: givenItems,\n container,\n levels = defaultLevels,\n filter,\n 'aria-label': label,\n className,\n ...props\n}: TableOfContentsProps) {\n const messages = useMessages('tableOfContents', tableOfContents);\n const root = useRef<HTMLDivElement>(null);\n const shape = useRef<SVGSVGElement>(null);\n const items = useContentsHeadings({ givenItems, container, levels, filter, own: root });\n const [current, setCurrent] = useState<string>();\n const chosenByLink = useRef<{ id: string; settled: boolean } | null>(null);\n const settle = useRef(0);\n const measureOnNextFrame = useRef<() => void>(() => {});\n const settleLater = useCallback((delay: number) => {\n clearTimeout(settle.current);\n const choice = chosenByLink.current;\n if (!choice) return;\n settle.current = window.setTimeout(() => {\n choice.settled = true;\n measureOnNextFrame.current();\n }, delay);\n }, []);\n useEffect(() => () => clearTimeout(settle.current), []);\n const flat = useMemo(() => flatten(items), [items]);\n const ids = flat.map((entry) => entry.id).join('\\n');\n\n useEffect(\n function trackCurrentSectionAndDrawReadersPlace() {\n if (ids === '') {\n setCurrent(undefined);\n return;\n }\n const sectionIds = ids.split('\\n');\n const first = document.getElementById(sectionIds[0]);\n const doc = first?.ownerDocument ?? document;\n let frame = 0;\n\n const drawer = createWaveDrawer(\n () => root.current,\n () => shape.current,\n reducedMotionQuery(),\n );\n const update = () => {\n frame = 0;\n const choice = chosenByLink.current;\n if (choice?.settled) {\n setCurrent(choice.id);\n drawer.wave(sectionIds.indexOf(choice.id));\n return;\n }\n const elements = sectionIds\n .map((id) => doc.getElementById(id))\n .filter((element): element is HTMLElement => element !== null);\n if (elements.length === 0) {\n setCurrent(undefined);\n drawer.wave(null);\n return;\n }\n const { sections, view } = readSections(elements, doc);\n let next = currentSection(sections, view);\n let position = readingPosition(sections, view);\n if (choice) {\n const chosenIndex = sectionIds.indexOf(choice.id);\n if (position > chosenIndex) position = chosenIndex;\n if (next && sectionIds.indexOf(next) > chosenIndex) next = choice.id;\n }\n setCurrent(next);\n drawer.wave(position);\n };\n const schedule = () => {\n if (frame === 0) frame = requestAnimationFrame(update);\n };\n const onScroll = (event: Event) => {\n const target = event.target;\n const sectionLookedUpAfresh = doc.getElementById(sectionIds[0]);\n const movesNoSection =\n target instanceof Element &&\n sectionLookedUpAfresh &&\n !target.contains(sectionLookedUpAfresh);\n if (movesNoSection) return;\n const choice = chosenByLink.current;\n const scrollALinkStarted = choice && !choice.settled;\n if (scrollALinkStarted) {\n settleLater(scrollPauseThatEndsLinkScrollMs);\n schedule();\n return;\n }\n chosenByLink.current = null;\n schedule();\n };\n const onResize = () => schedule();\n measureOnNextFrame.current = schedule;\n schedule();\n doc.addEventListener('scroll', onScroll, { capture: true, passive: true });\n window.addEventListener('resize', onResize);\n const resizes = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(onResize);\n if (first?.parentElement) resizes?.observe(first.parentElement);\n const body = root.current;\n const entriesMovedByWrapOrFont =\n typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(drawer.remeasure);\n if (body) entriesMovedByWrapOrFont?.observe(body);\n body?.addEventListener('pointerover', drawer.onPointerOver);\n body?.addEventListener('pointerleave', drawer.onPointerLeave);\n return () => {\n cancelAnimationFrame(frame);\n drawer.stop();\n doc.removeEventListener('scroll', onScroll, { capture: true });\n window.removeEventListener('resize', onResize);\n resizes?.disconnect();\n entriesMovedByWrapOrFont?.disconnect();\n body?.removeEventListener('pointerover', drawer.onPointerOver);\n body?.removeEventListener('pointerleave', drawer.onPointerLeave);\n };\n },\n [ids, settleLater],\n );\n\n const navigate = useCallback(\n (event: MouseEvent<HTMLElement>, id: string) => {\n if (\n event.defaultPrevented ||\n event.button !== 0 ||\n event.metaKey ||\n event.ctrlKey ||\n event.shiftKey ||\n event.altKey\n ) {\n return;\n }\n const target = event.currentTarget.ownerDocument.getElementById(id);\n if (!target) return;\n event.preventDefault();\n const choice = { id, settled: false };\n chosenByLink.current = choice;\n target.scrollIntoView({\n behavior: prefersReducedMotion() ? 'instant' : 'smooth',\n block: 'start',\n });\n settleLater(scrollPauseThatEndsLinkScrollMs * 2);\n const hash = `#${id}`;\n if (window.location.hash !== hash) window.history.pushState(window.history.state, '', hash);\n focusSection(target);\n },\n [settleLater],\n );\n\n const passed = useMemo(() => {\n const index = current ? flat.findIndex((entry) => entry.id === current) : -1;\n return new Set(flat.slice(0, Math.max(0, index)).map((entry) => entry.id));\n }, [flat, current]);\n\n return (\n <nav\n {...props}\n aria-label={label ?? messages.label}\n className={classNames('env-table-of-contents', className)}\n hidden={items.length === 0 ? true : props.hidden}\n >\n <div className=\"env-table-of-contents-body\" ref={root}>\n <svg\n className=\"env-table-of-contents-wave\"\n ref={shape}\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path />\n </svg>\n <List items={items} current={current} passed={passed} depth={0} onNavigate={navigate} />\n </div>\n </nav>\n );\n}\n"],
|
|
5
|
-
"mappings": ";
|
|
4
|
+
"sourcesContent": ["'use client';\n\nimport {\n useCallback,\n useEffect,\n useMemo,\n useRef,\n type ComponentPropsWithRef,\n type MouseEvent,\n type ReactNode,\n type RefObject,\n} from 'react';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { classNames } from '../internal/classNames.js';\nimport { landmarkLabel } from './internal/landmarkLabel.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { tableOfContents } from '../foundations/messages/tableOfContents.js';\nimport { flatten } from './internal/tableOfContents/contentsOutline.js';\nimport { focusSection, rememberScroll } from './internal/tableOfContents/sectionScroll.js';\nimport { useContentsHeadings } from './internal/tableOfContents/useContentsHeadings.js';\nimport {\n scrollPauseThatEndsLinkScrollMs,\n useReadingPlace,\n type ChosenByLink,\n} from './internal/tableOfContents/useReadingPlace.js';\nimport { prefersReducedMotion } from '../internal/motion/reducedMotion.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport { useLatest } from '../internal/react/useLatest.js';\nimport '../styles/Base.css';\nimport '../styles/TableOfContents.css';\n\n/** One entry of a table of contents: a section of the page, and the sections nested in it. */\nexport interface TableOfContentsItem {\n /** The id of the element the entry leads to: a heading, or any section of the page with an id. */\n id: string;\n /** The entry's text, such as the heading's words or a shorter name for a section. */\n label: ReactNode;\n /** The sections nested under this one, such as a heading's subsections. */\n children?: readonly TableOfContentsItem[];\n}\n\nexport interface TableOfContentsProps extends Omit<ComponentPropsWithRef<'nav'>, 'children'> {\n /**\n * The sections to list, nested through `children`, each leading to the element with its `id`:\n * a heading or any other part of the page, under a label of your own. Without it, the component\n * lists the headings it finds in `container`, after it mounts.\n */\n items?: readonly TableOfContentsItem[];\n /**\n * Where to find the headings, without `items`: an element's ref or a CSS selector.\n * @default The page's `main` element, or the body without one\n */\n container?: RefObject<HTMLElement | null> | string;\n /**\n * The heading levels to list, without `items`. A heading nests under the one above it of a lower\n * level. A heading without an id gets one from its words.\n * @default [2, 3]\n */\n levels?: readonly HeadingLevel[];\n /** Leaves out the headings it returns false for, without `items`, such as an example's own. */\n filter?: (heading: HTMLElement) => boolean;\n /**\n * Called when people follow a link, with its section's id and the click, before envUI scrolls the\n * section into view and focuses it. Each link is an `#id` link through LinkProvider's link\n * component, so the application's router, or else the browser, changes the address. Call\n * preventDefault to make the jump yourself, without envUI's scroll or the address change.\n */\n onNavigate?: (id: string, event: MouseEvent<HTMLAnchorElement>) => void;\n /**\n * The accessible name of the navigation landmark.\n * @default 'On this page', or EnvUIProvider's messages.tableOfContents.label\n */\n 'aria-label'?: string;\n /** Classes for the `nav` element. */\n className?: string;\n}\n\nconst defaultLevels: readonly HeadingLevel[] = [2, 3];\n\ninterface ContentsListProps {\n items: readonly TableOfContentsItem[];\n current: string | undefined;\n passed: ReadonlySet<string>;\n depth: number;\n onNavigate: (event: MouseEvent<HTMLAnchorElement>, id: string) => void;\n}\n\nfunction ContentsList({ items, current, passed, depth, onNavigate }: ContentsListProps) {\n return (\n <ol\n className=\"env-table-of-contents-list\"\n style={depth > 0 ? { '--env-table-of-contents-depth': depth } : undefined}\n >\n {items.map((item) => (\n <li key={item.id} className=\"env-table-of-contents-item\">\n <ActionElement\n className=\"env-table-of-contents-link\"\n href={`#${item.id}`}\n aria-current={item.id === current ? 'location' : undefined}\n data-passed={flag(passed.has(item.id))}\n onClick={(event) => onNavigate(event, item.id)}\n >\n {item.label}\n </ActionElement>\n {item.children && item.children.length > 0 && (\n <ContentsList\n items={item.children}\n current={current}\n passed={passed}\n depth={depth + 1}\n onNavigate={onNavigate}\n />\n )}\n </li>\n ))}\n </ol>\n );\n}\n\n/**\n * The page's sections as links, nested by level, with the one the reader is in marked as they\n * scroll: the headings in a container by default, or sections of your own.\n */\nexport function TableOfContents({\n items: givenItems,\n container,\n levels = defaultLevels,\n filter,\n onNavigate,\n 'aria-label': label,\n className,\n ...props\n}: TableOfContentsProps) {\n const messages = useMessages('tableOfContents', tableOfContents);\n const root = useRef<HTMLDivElement>(null);\n const shape = useRef<SVGSVGElement>(null);\n const items = useContentsHeadings({ givenItems, container, levels, filter, own: root });\n const chosenByLink = useRef<ChosenByLink | null>(null);\n const scrollFrame = useRef(0);\n const latestOnNavigate = useLatest(onNavigate);\n useEffect(() => () => cancelAnimationFrame(scrollFrame.current), []);\n const flat = useMemo(() => flatten(items), [items]);\n const ids = flat.map((entry) => entry.id).join('\\n');\n const { current, settleLater } = useReadingPlace({ ids, root, shape, chosenByLink });\n\n const navigate = useCallback(\n (event: MouseEvent<HTMLAnchorElement>, id: string) => {\n if (\n event.defaultPrevented ||\n event.button !== 0 ||\n event.metaKey ||\n event.ctrlKey ||\n event.shiftKey ||\n event.altKey\n ) {\n return;\n }\n latestOnNavigate.current?.(id, event);\n if (event.defaultPrevented) return;\n const target = event.currentTarget.ownerDocument.getElementById(id);\n if (!target) return;\n const scrollBackFromBrowsersJump = rememberScroll(target);\n const choice = { id, settled: false };\n chosenByLink.current = choice;\n cancelAnimationFrame(scrollFrame.current);\n scrollFrame.current = requestAnimationFrame(() => {\n scrollBackFromBrowsersJump();\n target.scrollIntoView({\n behavior: prefersReducedMotion() ? 'instant' : 'smooth',\n block: 'start',\n });\n settleLater(scrollPauseThatEndsLinkScrollMs * 2);\n focusSection(target);\n });\n },\n [settleLater, latestOnNavigate],\n );\n\n const passed = useMemo(() => {\n const index = current ? flat.findIndex((entry) => entry.id === current) : -1;\n return new Set(flat.slice(0, Math.max(0, index)).map((entry) => entry.id));\n }, [flat, current]);\n\n return (\n <nav\n {...props}\n aria-label={landmarkLabel(label, props['aria-labelledby'], messages.label)}\n className={classNames('env-table-of-contents', className)}\n hidden={items.length === 0 ? true : props.hidden}\n >\n <div className=\"env-table-of-contents-body\" ref={root}>\n <svg\n className=\"env-table-of-contents-wave\"\n ref={shape}\n aria-hidden=\"true\"\n focusable=\"false\"\n >\n <path />\n </svg>\n <ContentsList\n items={items}\n current={current}\n passed={passed}\n depth={0}\n onNavigate={navigate}\n />\n </div>\n </nav>\n );\n}\n"],
|
|
5
|
+
"mappings": ";AA+FQ,SACE,KADF;AA7FR;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,eAAe;AACxB,SAAS,cAAc,sBAAsB;AAC7C,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,4BAA4B;AAErC,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAC1B,OAAO;AACP,OAAO;AAgDP,MAAM,gBAAyC,CAAC,GAAG,CAAC;AAUpD,SAAS,aAAa,EAAE,OAAO,SAAS,QAAQ,OAAO,WAAW,GAAsB;AACtF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAU;AAAA,MACV,OAAO,QAAQ,IAAI,EAAE,iCAAiC,MAAM,IAAI;AAAA,MAE/D,gBAAM,IAAI,CAAC,SACV,qBAAC,QAAiB,WAAU,8BAC1B;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV,MAAM,IAAI,KAAK,EAAE;AAAA,YACjB,gBAAc,KAAK,OAAO,UAAU,aAAa;AAAA,YACjD,eAAa,KAAK,OAAO,IAAI,KAAK,EAAE,CAAC;AAAA,YACrC,SAAS,CAAC,UAAU,WAAW,OAAO,KAAK,EAAE;AAAA,YAE5C,eAAK;AAAA;AAAA,QACR;AAAA,QACC,KAAK,YAAY,KAAK,SAAS,SAAS,KACvC;AAAA,UAAC;AAAA;AAAA,YACC,OAAO,KAAK;AAAA,YACZ;AAAA,YACA;AAAA,YACA,OAAO,QAAQ;AAAA,YACf;AAAA;AAAA,QACF;AAAA,WAjBK,KAAK,EAmBd,CACD;AAAA;AAAA,EACH;AAEJ;AAMO,SAAS,gBAAgB;AAAA,EAC9B,OAAO;AAAA,EACP;AAAA,EACA,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA,GAAG;AACL,GAAyB;AACvB,QAAM,WAAW,YAAY,mBAAmB,eAAe;AAC/D,QAAM,OAAO,OAAuB,IAAI;AACxC,QAAM,QAAQ,OAAsB,IAAI;AACxC,QAAM,QAAQ,oBAAoB,EAAE,YAAY,WAAW,QAAQ,QAAQ,KAAK,KAAK,CAAC;AACtF,QAAM,eAAe,OAA4B,IAAI;AACrD,QAAM,cAAc,OAAO,CAAC;AAC5B,QAAM,mBAAmB,UAAU,UAAU;AAC7C,YAAU,MAAM,MAAM,qBAAqB,YAAY,OAAO,GAAG,CAAC,CAAC;AACnE,QAAM,OAAO,QAAQ,MAAM,QAAQ,KAAK,GAAG,CAAC,KAAK,CAAC;AAClD,QAAM,MAAM,KAAK,IAAI,CAAC,UAAU,MAAM,EAAE,EAAE,KAAK,IAAI;AACnD,QAAM,EAAE,SAAS,YAAY,IAAI,gBAAgB,EAAE,KAAK,MAAM,OAAO,aAAa,CAAC;AAEnF,QAAM,WAAW;AAAA,IACf,CAAC,OAAsC,OAAe;AACpD,UACE,MAAM,oBACN,MAAM,WAAW,KACjB,MAAM,WACN,MAAM,WACN,MAAM,YACN,MAAM,QACN;AACA;AAAA,MACF;AACA,uBAAiB,UAAU,IAAI,KAAK;AACpC,UAAI,MAAM,iBAAkB;AAC5B,YAAM,SAAS,MAAM,cAAc,cAAc,eAAe,EAAE;AAClE,UAAI,CAAC,OAAQ;AACb,YAAM,6BAA6B,eAAe,MAAM;AACxD,YAAM,SAAS,EAAE,IAAI,SAAS,MAAM;AACpC,mBAAa,UAAU;AACvB,2BAAqB,YAAY,OAAO;AACxC,kBAAY,UAAU,sBAAsB,MAAM;AAChD,mCAA2B;AAC3B,eAAO,eAAe;AAAA,UACpB,UAAU,qBAAqB,IAAI,YAAY;AAAA,UAC/C,OAAO;AAAA,QACT,CAAC;AACD,oBAAY,kCAAkC,CAAC;AAC/C,qBAAa,MAAM;AAAA,MACrB,CAAC;AAAA,IACH;AAAA,IACA,CAAC,aAAa,gBAAgB;AAAA,EAChC;AAEA,QAAM,SAAS,QAAQ,MAAM;AAC3B,UAAM,QAAQ,UAAU,KAAK,UAAU,CAAC,UAAU,MAAM,OAAO,OAAO,IAAI;AAC1E,WAAO,IAAI,IAAI,KAAK,MAAM,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC;AAAA,EAC3E,GAAG,CAAC,MAAM,OAAO,CAAC;AAElB,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,cAAY,cAAc,OAAO,MAAM,iBAAiB,GAAG,SAAS,KAAK;AAAA,MACzE,WAAW,WAAW,yBAAyB,SAAS;AAAA,MACxD,QAAQ,MAAM,WAAW,IAAI,OAAO,MAAM;AAAA,MAE1C,+BAAC,SAAI,WAAU,8BAA6B,KAAK,MAC/C;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,WAAU;AAAA,YACV,KAAK;AAAA,YACL,eAAY;AAAA,YACZ,WAAU;AAAA,YAEV,8BAAC,UAAK;AAAA;AAAA,QACR;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA;AAAA,YACA;AAAA,YACA,OAAO;AAAA,YACP,YAAY;AAAA;AAAA,QACd;AAAA,SACF;AAAA;AAAA,EACF;AAEJ;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type ComponentPropsWithRef, type ReactNode } from 'react';
|
|
1
|
+
import { type ComponentPropsWithRef, type ComponentPropsWithoutRef, type ReactNode } from 'react';
|
|
2
2
|
import type { RowDensity } from '../foundations/Theme.js';
|
|
3
3
|
export interface TreeItem {
|
|
4
4
|
/** The row's value, a stable, unique identifier, which the tree's value names; rows carry it as data-id. */
|
|
@@ -13,17 +13,27 @@ export interface TreeItem {
|
|
|
13
13
|
/** The row's children show, as the rows that follow it in items; its chevron points down. */
|
|
14
14
|
expanded?: boolean;
|
|
15
15
|
/**
|
|
16
|
-
* The row's name,
|
|
17
|
-
* and ends with an ellipsis only where the row is
|
|
16
|
+
* The row's name: text, or content such as a name with its matched letters highlighted. It keeps
|
|
17
|
+
* its room before the description and the end, and ends with an ellipsis only where the row is
|
|
18
|
+
* too narrow for it alone. Type-ahead matches its text.
|
|
18
19
|
*/
|
|
19
|
-
label:
|
|
20
|
-
/**
|
|
21
|
-
|
|
20
|
+
label: ReactNode;
|
|
21
|
+
/**
|
|
22
|
+
* The row's name as plain text, which type-ahead matches, where the label's text isn't it.
|
|
23
|
+
* @default the label when it is a string, else the label's rendered text
|
|
24
|
+
*/
|
|
25
|
+
textValue?: string;
|
|
26
|
+
/**
|
|
27
|
+
* Content before the label, such as IconFolder or IconDescription: an envUI icon takes the control
|
|
28
|
+
* icon size and other content keeps its own. It is hidden from assistive technology, since the
|
|
29
|
+
* label names the item.
|
|
30
|
+
*/
|
|
31
|
+
start?: ReactNode;
|
|
22
32
|
/**
|
|
23
33
|
* Muted text after the label, such as a status or a path. It gives way first, to an ellipsis and
|
|
24
34
|
* then out of the row, where the row runs out of room, and is read with the label.
|
|
25
35
|
*/
|
|
26
|
-
description?:
|
|
36
|
+
description?: ReactNode;
|
|
27
37
|
/**
|
|
28
38
|
* Content at the end of the row, such as a Badge with a count, which keeps its size. It gives way
|
|
29
39
|
* to the label: where both don't fit, it leaves the row whole rather than squeeze the name. It
|
|
@@ -37,7 +47,16 @@ export interface TreeItem {
|
|
|
37
47
|
* opens nor expands.
|
|
38
48
|
*/
|
|
39
49
|
disabled?: boolean;
|
|
50
|
+
/**
|
|
51
|
+
* The row element's own props, such as a className, data attributes for its state, draggable and
|
|
52
|
+
* drag handlers for moving files. The tree's role, id, ARIA attributes and title stay its own.
|
|
53
|
+
*/
|
|
54
|
+
itemProps?: TreeItemElementProps;
|
|
40
55
|
}
|
|
56
|
+
/** What a Tree row's itemProps can set on the row element. */
|
|
57
|
+
export type TreeItemElementProps = Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'id' | 'role' | 'title' | 'dangerouslySetInnerHTML' | `aria-${string}`> & {
|
|
58
|
+
[attribute: `data-${string}`]: string | number | boolean | undefined;
|
|
59
|
+
};
|
|
41
60
|
/** What Tree's onAction receives beside the row. */
|
|
42
61
|
export interface TreeActionDetails {
|
|
43
62
|
/**
|
|
@@ -46,8 +65,7 @@ export interface TreeActionDetails {
|
|
|
46
65
|
*/
|
|
47
66
|
preview: boolean;
|
|
48
67
|
}
|
|
49
|
-
|
|
50
|
-
export interface TreeProps<Item extends TreeItem> extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue' | 'onChange' | 'aria-label' | 'contextMenu' | EventsTreeHandlesForRows> {
|
|
68
|
+
export interface TreeProps<Item extends TreeItem> extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue' | 'onChange' | 'aria-label' | 'contextMenu'> {
|
|
51
69
|
/**
|
|
52
70
|
* The visible rows in order, flattened: an expanded row is followed by its visible descendants.
|
|
53
71
|
* The application owns expansion; collapsing a row removes its descendants from items.
|
|
@@ -94,5 +112,4 @@ export interface TreeProps<Item extends TreeItem> extends Omit<ComponentPropsWit
|
|
|
94
112
|
* visible rows and owns expansion and selection; the tree owns focus, keyboard navigation and
|
|
95
113
|
* scrolling. It fills its parent's height, scrolls itself and renders only the rows in view.
|
|
96
114
|
*/
|
|
97
|
-
export declare function Tree<Item extends TreeItem>({ items, 'aria-label': label, value:
|
|
98
|
-
export {};
|
|
115
|
+
export declare function Tree<Item extends TreeItem>({ items, 'aria-label': label, value: selectedValue, onAction, onExpandedChange, contextMenu, contextMenuLabel, density, className, ref, onKeyDown: ownKeyDown, onScroll: ownScroll, onFocus: ownFocus, onPointerDown: ownPointerDown, onClick: ownClick, onDoubleClick: ownDoubleClick, onContextMenu: ownContextMenu, ...props }: TreeProps<Item>): import("react").JSX.Element;
|
package/dist/navigation/Tree.js
CHANGED
|
@@ -8,27 +8,25 @@ import {
|
|
|
8
8
|
useState
|
|
9
9
|
} from "react";
|
|
10
10
|
import { classNames } from "../internal/classNames.js";
|
|
11
|
-
import {
|
|
11
|
+
import { mergeRefs } from "../internal/react/setRef.js";
|
|
12
12
|
import { useMessages } from "../internal/provider/EnvUIContext.js";
|
|
13
13
|
import { tree as treeMessages } from "../foundations/messages/tree.js";
|
|
14
14
|
import { ContextMenu } from "../actions/ContextMenu.js";
|
|
15
15
|
import { isRightToLeft } from "../internal/dom/direction.js";
|
|
16
|
-
import {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
} from "./internal/treeModel.js";
|
|
21
|
-
import { placeRows, TreeRow } from "./internal/TreeRow.js";
|
|
22
|
-
import { useTreeTransitions } from "./internal/useTreeTransitions.js";
|
|
23
|
-
import { useTreeViewport } from "./internal/useTreeViewport.js";
|
|
16
|
+
import { rowElementId, siblingPositions, treeKeyAction } from "./internal/tree/treeModel.js";
|
|
17
|
+
import { placeRows, TreeRow } from "./internal/tree/TreeRow.js";
|
|
18
|
+
import { useTreeTransitions } from "./internal/tree/useTreeTransitions.js";
|
|
19
|
+
import { useTreeViewport } from "./internal/tree/useTreeViewport.js";
|
|
24
20
|
import { flag } from "../internal/flag.js";
|
|
21
|
+
import { chainHandlers } from "../internal/react/chainHandlers.js";
|
|
22
|
+
import { labelText } from "../internal/text/labelText.js";
|
|
25
23
|
import "#styles/Base.css";
|
|
26
24
|
import "#styles/Tree.css";
|
|
27
25
|
const startingShiftAppliesAtOnce = "none";
|
|
28
26
|
function Tree({
|
|
29
27
|
items,
|
|
30
28
|
"aria-label": label,
|
|
31
|
-
value:
|
|
29
|
+
value: selectedValue = null,
|
|
32
30
|
onAction,
|
|
33
31
|
onExpandedChange,
|
|
34
32
|
contextMenu,
|
|
@@ -39,16 +37,20 @@ function Tree({
|
|
|
39
37
|
onKeyDown: ownKeyDown,
|
|
40
38
|
onScroll: ownScroll,
|
|
41
39
|
onFocus: ownFocus,
|
|
40
|
+
onPointerDown: ownPointerDown,
|
|
41
|
+
onClick: ownClick,
|
|
42
|
+
onDoubleClick: ownDoubleClick,
|
|
43
|
+
onContextMenu: ownContextMenu,
|
|
42
44
|
...props
|
|
43
45
|
}) {
|
|
44
46
|
const messages = useMessages("tree", treeMessages);
|
|
45
47
|
const treeId = useId().replace(/[^A-Za-z0-9-]/g, "");
|
|
46
48
|
const container = useRef(null);
|
|
47
|
-
const [
|
|
49
|
+
const [activeValue, setActiveValue] = useState(selectedValue);
|
|
48
50
|
const [focusVisible, setFocusVisible] = useState(false);
|
|
49
51
|
const pointerFocus = useRef(false);
|
|
50
|
-
const typeahead = useRef({ text: "",
|
|
51
|
-
const
|
|
52
|
+
const typeahead = useRef({ text: "", at: 0 });
|
|
53
|
+
const indexByValue = useMemo(() => {
|
|
52
54
|
const map = /* @__PURE__ */ new Map();
|
|
53
55
|
items.forEach((item, index) => map.set(item.value, index));
|
|
54
56
|
return map;
|
|
@@ -56,8 +58,8 @@ function Tree({
|
|
|
56
58
|
const { positions, sizes } = useMemo(() => siblingPositions(items), [items]);
|
|
57
59
|
const { rowsElement, arriving, motion, moving } = useTreeTransitions(items);
|
|
58
60
|
const fallbackActiveIndex = useRef(0);
|
|
59
|
-
const selectedIndex =
|
|
60
|
-
let activeIndex =
|
|
61
|
+
const selectedIndex = selectedValue === null ? void 0 : indexByValue.get(selectedValue);
|
|
62
|
+
let activeIndex = activeValue === null ? -1 : indexByValue.get(activeValue) ?? -1;
|
|
61
63
|
if (activeIndex === -1 && items.length > 0)
|
|
62
64
|
activeIndex = selectedIndex ?? Math.min(fallbackActiveIndex.current, items.length - 1);
|
|
63
65
|
fallbackActiveIndex.current = Math.max(activeIndex, 0);
|
|
@@ -68,16 +70,16 @@ function Tree({
|
|
|
68
70
|
count: items.length,
|
|
69
71
|
activeIndex,
|
|
70
72
|
selectedIndex,
|
|
71
|
-
|
|
73
|
+
selectedValue
|
|
72
74
|
});
|
|
73
75
|
useEffect(() => {
|
|
74
|
-
if (
|
|
75
|
-
}, [
|
|
76
|
+
if (selectedValue !== null) setActiveValue(selectedValue);
|
|
77
|
+
}, [selectedValue]);
|
|
76
78
|
function activate(index) {
|
|
77
79
|
const at = Math.max(0, Math.min(items.length - 1, index));
|
|
78
80
|
const item = items[at];
|
|
79
81
|
if (!item) return;
|
|
80
|
-
|
|
82
|
+
setActiveValue(item.value);
|
|
81
83
|
scrollToIndex(at);
|
|
82
84
|
}
|
|
83
85
|
function open(item, preview) {
|
|
@@ -90,13 +92,19 @@ function Tree({
|
|
|
90
92
|
if (event.target !== event.currentTarget || !activeItem) return;
|
|
91
93
|
const keyBelongsToApplication = event.altKey || event.ctrlKey || event.metaKey;
|
|
92
94
|
if (keyBelongsToApplication) return;
|
|
95
|
+
const treeDocument = event.currentTarget.ownerDocument;
|
|
93
96
|
const action = treeKeyAction(
|
|
94
97
|
event.key,
|
|
95
98
|
items,
|
|
96
99
|
activeIndex,
|
|
97
100
|
pageRows,
|
|
98
101
|
isRightToLeft(event.currentTarget),
|
|
99
|
-
typeahead.current
|
|
102
|
+
typeahead.current,
|
|
103
|
+
(item) => labelText(
|
|
104
|
+
item.label,
|
|
105
|
+
item.textValue,
|
|
106
|
+
treeDocument.getElementById(rowElementId(treeId, item.value))?.querySelector(".env-tree-label")
|
|
107
|
+
)
|
|
100
108
|
);
|
|
101
109
|
if (!action) return;
|
|
102
110
|
if (action.kind === "move") activate(action.index);
|
|
@@ -107,13 +115,13 @@ function Tree({
|
|
|
107
115
|
}
|
|
108
116
|
function rowFromEvent(event) {
|
|
109
117
|
const row2 = event.target.closest(".env-tree-item");
|
|
110
|
-
const index = row2?.dataset.id === void 0 ? void 0 :
|
|
118
|
+
const index = row2?.dataset.id === void 0 ? void 0 : indexByValue.get(row2.dataset.id);
|
|
111
119
|
return index === void 0 ? void 0 : items[index];
|
|
112
120
|
}
|
|
113
121
|
function onRowClick(event) {
|
|
114
122
|
const item = rowFromEvent(event);
|
|
115
123
|
if (!item) return;
|
|
116
|
-
|
|
124
|
+
setActiveValue(item.value);
|
|
117
125
|
if (event.target.closest(".env-tree-chevron") && item.expandable) {
|
|
118
126
|
setExpanded(item, !item.expanded);
|
|
119
127
|
return;
|
|
@@ -132,7 +140,7 @@ function Tree({
|
|
|
132
140
|
id: rowElementId(treeId, item.value),
|
|
133
141
|
position: positions[index],
|
|
134
142
|
setSize: sizes[index],
|
|
135
|
-
selected: item.value ===
|
|
143
|
+
selected: item.value === selectedValue,
|
|
136
144
|
highlighted: index === activeIndex,
|
|
137
145
|
arriving: arriving.has(item.value),
|
|
138
146
|
top,
|
|
@@ -145,10 +153,7 @@ function Tree({
|
|
|
145
153
|
"div",
|
|
146
154
|
{
|
|
147
155
|
...props,
|
|
148
|
-
ref: (
|
|
149
|
-
container.current = node;
|
|
150
|
-
setRef(ref, node);
|
|
151
|
-
},
|
|
156
|
+
ref: mergeRefs(container, ref),
|
|
152
157
|
role: "tree",
|
|
153
158
|
"aria-label": label,
|
|
154
159
|
"aria-activedescendant": activeItem ? rowElementId(treeId, activeItem.value) : void 0,
|
|
@@ -156,15 +161,13 @@ function Tree({
|
|
|
156
161
|
className: classNames("env-tree", className),
|
|
157
162
|
"data-density": density,
|
|
158
163
|
"data-focus-visible": flag(focusVisible),
|
|
159
|
-
onKeyDown: (
|
|
160
|
-
ownKeyDown?.(event);
|
|
161
|
-
if (!event.defaultPrevented) onKeyDown(event);
|
|
162
|
-
},
|
|
164
|
+
onKeyDown: chainHandlers(ownKeyDown, onKeyDown),
|
|
163
165
|
onScroll: (event) => {
|
|
164
166
|
ownScroll?.(event);
|
|
165
167
|
onScroll(event.currentTarget.scrollTop);
|
|
166
168
|
},
|
|
167
|
-
onPointerDown: () => {
|
|
169
|
+
onPointerDown: (event) => {
|
|
170
|
+
ownPointerDown?.(event);
|
|
168
171
|
pointerFocus.current = true;
|
|
169
172
|
setFocusVisible(false);
|
|
170
173
|
},
|
|
@@ -173,11 +176,12 @@ function Tree({
|
|
|
173
176
|
if (event.target === event.currentTarget) setFocusVisible(!pointerFocus.current);
|
|
174
177
|
pointerFocus.current = false;
|
|
175
178
|
},
|
|
176
|
-
onClick: onRowClick,
|
|
177
|
-
onDoubleClick: onRowDoubleClick,
|
|
179
|
+
onClick: chainHandlers(ownClick, onRowClick),
|
|
180
|
+
onDoubleClick: chainHandlers(ownDoubleClick, onRowDoubleClick),
|
|
178
181
|
onContextMenu: (event) => {
|
|
182
|
+
ownContextMenu?.(event);
|
|
179
183
|
const item = rowFromEvent(event);
|
|
180
|
-
if (item)
|
|
184
|
+
if (item) setActiveValue(item.value);
|
|
181
185
|
},
|
|
182
186
|
children: /* @__PURE__ */ jsx(
|
|
183
187
|
"div",
|
|
@@ -200,8 +204,8 @@ function Tree({
|
|
|
200
204
|
{
|
|
201
205
|
"aria-label": contextMenuLabel ?? messages.contextMenu,
|
|
202
206
|
content: (target) => {
|
|
203
|
-
const
|
|
204
|
-
const index =
|
|
207
|
+
const value = target?.closest(".env-tree-item")?.dataset.id;
|
|
208
|
+
const index = value === void 0 ? void 0 : indexByValue.get(value);
|
|
205
209
|
return contextMenu(index === void 0 ? null : items[index]);
|
|
206
210
|
},
|
|
207
211
|
children: tree
|