@envsemble/envui 2.0.0 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +258 -0
- package/README.md +14 -27
- package/dist/actions/Button.d.ts +25 -8
- package/dist/actions/Button.js.map +2 -2
- package/dist/actions/CommandPalette.d.ts +37 -9
- package/dist/actions/CommandPalette.js +111 -107
- package/dist/actions/CommandPalette.js.map +2 -2
- package/dist/actions/ConfirmButton.d.ts +1 -1
- package/dist/actions/ConfirmButton.js +2 -4
- package/dist/actions/ConfirmButton.js.map +2 -2
- package/dist/actions/ContextMenu.d.ts +1 -1
- package/dist/actions/ContextMenu.js +5 -6
- package/dist/actions/ContextMenu.js.map +2 -2
- package/dist/actions/CopyButton.js +2 -2
- package/dist/actions/CopyButton.js.map +2 -2
- package/dist/actions/Menubar.d.ts +12 -5
- package/dist/actions/Menubar.js +37 -29
- package/dist/actions/Menubar.js.map +3 -3
- package/dist/actions/Toolbar.d.ts +42 -2
- package/dist/actions/Toolbar.js +18 -0
- package/dist/actions/Toolbar.js.map +2 -2
- package/dist/actions/internal/ButtonBase.d.ts +3 -2
- package/dist/actions/internal/ButtonBase.js +2 -4
- package/dist/actions/internal/ButtonBase.js.map +2 -2
- package/dist/actions/internal/CommandPaletteOptions.d.ts +7 -6
- package/dist/actions/internal/CommandPaletteOptions.js +24 -15
- package/dist/actions/internal/CommandPaletteOptions.js.map +2 -2
- package/dist/actions/internal/CommandPaletteStatus.js +23 -9
- package/dist/actions/internal/CommandPaletteStatus.js.map +2 -2
- package/dist/actions/menu/Menu.d.ts +5 -4
- package/dist/actions/menu/Menu.js +3 -6
- package/dist/actions/menu/Menu.js.map +2 -2
- package/dist/actions/menu/MenuChoices.d.ts +9 -7
- package/dist/actions/menu/MenuChoices.js +34 -6
- package/dist/actions/menu/MenuChoices.js.map +2 -2
- package/dist/actions/menu/MenuItem.d.ts +37 -8
- package/dist/actions/menu/MenuItem.js +47 -12
- package/dist/actions/menu/MenuItem.js.map +2 -2
- package/dist/actions/menu/MenuSubmenu.d.ts +9 -3
- package/dist/actions/menu/MenuSubmenu.js +26 -24
- package/dist/actions/menu/MenuSubmenu.js.map +2 -2
- package/dist/actions/{internal → menu/internal}/MenuPopup.d.ts +2 -3
- package/dist/actions/{internal → menu/internal}/MenuPopup.js +7 -12
- package/dist/actions/menu/internal/MenuPopup.js.map +7 -0
- package/dist/actions/{internal → menu/internal}/menuOpenChange.d.ts +1 -1
- package/dist/actions/menu/internal/menuTriggerProps.d.ts +11 -0
- package/dist/actions/menu/internal/menuTriggerProps.js +1 -0
- package/dist/assets/readme/overview-dark.png +0 -0
- package/dist/assets/readme/overview-light.png +0 -0
- package/dist/content/Accordion.d.ts +32 -2
- package/dist/content/Accordion.js +41 -12
- package/dist/content/Accordion.js.map +2 -2
- package/dist/content/CodeBlock.d.ts +13 -4
- package/dist/content/CodeBlock.js +2 -0
- package/dist/content/CodeBlock.js.map +2 -2
- package/dist/content/CodeDiff.d.ts +34 -4
- package/dist/content/CodeDiff.js +41 -24
- package/dist/content/CodeDiff.js.map +2 -2
- package/dist/content/Composer.d.ts +19 -2
- package/dist/content/Composer.js +19 -12
- package/dist/content/Composer.js.map +2 -2
- package/dist/content/Disclosure.d.ts +13 -1
- package/dist/content/Disclosure.js +9 -3
- package/dist/content/Disclosure.js.map +2 -2
- package/dist/content/HighlightedCodeBlock.d.ts +1 -1
- package/dist/content/HighlightedCodeBlock.js +2 -0
- package/dist/content/HighlightedCodeBlock.js.map +2 -2
- package/dist/content/Kbd.d.ts +12 -5
- package/dist/content/Kbd.js +2 -2
- package/dist/content/Kbd.js.map +2 -2
- package/dist/content/Markdown.d.ts +17 -1
- package/dist/content/Markdown.js +26 -4
- package/dist/content/Markdown.js.map +2 -2
- package/dist/content/Message.d.ts +29 -33
- package/dist/content/Message.js +21 -21
- package/dist/content/Message.js.map +2 -2
- package/dist/content/countDiffLines.d.ts +1 -1
- package/dist/content/countDiffLines.js.map +1 -1
- package/dist/content/internal/CodeBlockFrame.d.ts +3 -2
- package/dist/content/internal/CodeBlockFrame.js +25 -13
- package/dist/content/internal/CodeBlockFrame.js.map +2 -2
- package/dist/content/internal/MessageListFollow.js +1 -1
- package/dist/content/internal/MessageListFollow.js.map +2 -2
- package/dist/content/internal/MessageStatusLabel.d.ts +2 -1
- package/dist/content/internal/MessageStatusLabel.js.map +2 -2
- package/dist/content/internal/codeColors.js +2 -2
- package/dist/content/internal/codeColors.js.map +2 -2
- package/dist/content/internal/useCodeContrast.js +4 -3
- package/dist/content/internal/useCodeContrast.js.map +2 -2
- package/dist/data-display/Avatar.d.ts +13 -4
- package/dist/data-display/Avatar.js +8 -4
- package/dist/data-display/Avatar.js.map +2 -2
- package/dist/data-display/AvatarButton.d.ts +20 -5
- package/dist/data-display/AvatarButton.js +17 -2
- package/dist/data-display/AvatarButton.js.map +2 -2
- package/dist/data-display/AvatarGroup.d.ts +28 -12
- package/dist/data-display/AvatarGroup.js +21 -32
- package/dist/data-display/AvatarGroup.js.map +2 -2
- package/dist/data-display/Badge.d.ts +11 -8
- package/dist/data-display/Badge.js +4 -3
- package/dist/data-display/Badge.js.map +2 -2
- package/dist/data-display/List.d.ts +21 -9
- package/dist/data-display/List.js +1 -1
- package/dist/data-display/List.js.map +2 -2
- package/dist/data-display/Meter.d.ts +7 -1
- package/dist/data-display/Meter.js +11 -5
- package/dist/data-display/Meter.js.map +2 -2
- package/dist/data-display/RelativeTime.d.ts +8 -2
- package/dist/data-display/RelativeTime.js +18 -7
- package/dist/data-display/RelativeTime.js.map +2 -2
- package/dist/data-display/Table.d.ts +26 -7
- package/dist/data-display/Table.js +70 -65
- package/dist/data-display/Table.js.map +2 -2
- package/dist/data-display/formatRelativeTime.d.ts +0 -2
- package/dist/data-display/formatRelativeTime.js +4 -28
- package/dist/data-display/formatRelativeTime.js.map +2 -2
- package/dist/data-display/internal/ListNaming.js +1 -1
- package/dist/data-display/internal/ListNaming.js.map +1 -1
- package/dist/data-display/internal/ReorderableList.d.ts +3 -2
- package/dist/data-display/internal/ReorderableList.js +11 -16
- package/dist/data-display/internal/ReorderableList.js.map +2 -2
- package/dist/data-display/internal/avatarName.d.ts +2 -0
- package/dist/data-display/internal/avatarName.js +7 -0
- package/dist/data-display/internal/avatarName.js.map +7 -0
- package/dist/data-display/internal/{ListRows.d.ts → listMarkup.d.ts} +1 -1
- package/dist/data-display/internal/{ListRows.js → listMarkup.js} +29 -15
- package/dist/data-display/internal/listMarkup.js.map +7 -0
- package/dist/data-display/internal/relativeTimeFormat.d.ts +3 -0
- package/dist/data-display/internal/relativeTimeFormat.js +12 -0
- package/dist/data-display/internal/relativeTimeFormat.js.map +7 -0
- package/dist/data-display/internal/reorderController.js +3 -3
- package/dist/data-display/internal/reorderController.js.map +2 -2
- package/dist/data-display/internal/reorderGeometry.d.ts +0 -1
- package/dist/data-display/internal/reorderGeometry.js +1 -10
- package/dist/data-display/internal/reorderGeometry.js.map +2 -2
- package/dist/data-display/internal/tableColumns.js +8 -9
- package/dist/data-display/internal/tableColumns.js.map +2 -2
- package/dist/{internal/react/useStackedReport.d.ts → data-display/internal/tableStacking.d.ts} +2 -0
- package/dist/data-display/internal/tableStacking.js +49 -0
- package/dist/data-display/internal/tableStacking.js.map +7 -0
- package/dist/data-display/internal/useReorder.js +1 -1
- package/dist/data-display/internal/useReorder.js.map +1 -1
- package/dist/diff.d.ts +1 -1
- package/dist/diff.js +1 -4
- package/dist/diff.js.map +2 -2
- package/dist/feedback/Alert.d.ts +13 -3
- package/dist/feedback/Alert.js +16 -6
- package/dist/feedback/Alert.js.map +2 -2
- package/dist/feedback/EmptyState.d.ts +12 -3
- package/dist/feedback/EmptyState.js +6 -6
- package/dist/feedback/EmptyState.js.map +2 -2
- package/dist/feedback/Halo.d.ts +27 -0
- package/dist/feedback/Halo.js +21 -0
- package/dist/feedback/Halo.js.map +7 -0
- package/dist/feedback/Progress.js +3 -2
- package/dist/feedback/Progress.js.map +2 -2
- package/dist/feedback/toast/ToastProvider.js +1 -1
- package/dist/feedback/toast/ToastProvider.js.map +1 -1
- package/dist/feedback/toast/internal/ContainedToast.d.ts +12 -0
- package/dist/feedback/toast/internal/ContainedToast.js +43 -0
- package/dist/feedback/toast/internal/ContainedToast.js.map +7 -0
- package/dist/feedback/toast/internal/{PictureNotice.d.ts → ContainedToastRoot.d.ts} +1 -1
- package/dist/feedback/toast/internal/{PictureNotice.js → ContainedToastRoot.js} +3 -3
- package/dist/feedback/toast/internal/ContainedToastRoot.js.map +7 -0
- package/dist/feedback/toast/internal/LiveToast.d.ts +10 -0
- package/dist/feedback/toast/internal/LiveToast.js +78 -0
- package/dist/feedback/toast/internal/LiveToast.js.map +7 -0
- package/dist/feedback/toast/internal/ToastBody.d.ts +2 -1
- package/dist/feedback/toast/internal/ToastBody.js +6 -2
- package/dist/feedback/toast/internal/ToastBody.js.map +2 -2
- package/dist/feedback/toast/internal/ToastButtons.d.ts +14 -0
- package/dist/feedback/toast/internal/ToastButtons.js +77 -0
- package/dist/feedback/toast/internal/ToastButtons.js.map +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.d.ts +3 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js +7 -0
- package/dist/feedback/toast/internal/ToastManagerContext.js.map +7 -0
- package/dist/feedback/toast/internal/ToastRegion.js +43 -172
- package/dist/feedback/toast/internal/ToastRegion.js.map +2 -2
- package/dist/feedback/toast/internal/toastEntry.d.ts +9 -2
- package/dist/feedback/toast/internal/toastEntry.js +10 -1
- package/dist/feedback/toast/internal/toastEntry.js.map +2 -2
- package/dist/feedback/toast/internal/useToastController.d.ts +3 -3
- package/dist/feedback/toast/internal/useToastController.js +4 -2
- package/dist/feedback/toast/internal/useToastController.js.map +2 -2
- package/dist/feedback/toast/internal/useToastGlide.js +2 -1
- package/dist/feedback/toast/internal/useToastGlide.js.map +2 -2
- package/dist/feedback/toast/toastTypes.d.ts +38 -11
- package/dist/feedback/toast/useToast.d.ts +0 -2
- package/dist/feedback/toast/useToast.js +2 -3
- package/dist/feedback/toast/useToast.js.map +2 -2
- package/dist/forms/Calendar.d.ts +30 -11
- package/dist/forms/Calendar.js +19 -13
- package/dist/forms/Calendar.js.map +2 -2
- package/dist/forms/Checkbox.d.ts +7 -1
- package/dist/forms/Checkbox.js +33 -27
- package/dist/forms/Checkbox.js.map +2 -2
- package/dist/forms/Combobox.d.ts +4 -4
- package/dist/forms/Combobox.js +26 -146
- package/dist/forms/Combobox.js.map +2 -2
- package/dist/forms/DatePicker.d.ts +38 -11
- package/dist/forms/DatePicker.js +32 -52
- package/dist/forms/DatePicker.js.map +2 -2
- package/dist/forms/DropZone.d.ts +23 -4
- package/dist/forms/DropZone.js +29 -11
- package/dist/forms/DropZone.js.map +2 -2
- package/dist/forms/Field.d.ts +7 -1
- package/dist/forms/Field.js +13 -6
- package/dist/forms/Field.js.map +2 -2
- package/dist/forms/MonthPicker.d.ts +8 -1
- package/dist/forms/MonthPicker.js +22 -42
- package/dist/forms/MonthPicker.js.map +2 -2
- package/dist/forms/Radio.d.ts +15 -5
- package/dist/forms/Radio.js +20 -18
- package/dist/forms/Radio.js.map +2 -2
- package/dist/forms/SearchField.d.ts +13 -5
- package/dist/forms/SearchField.js +26 -21
- package/dist/forms/SearchField.js.map +2 -2
- package/dist/forms/SegmentedControl.d.ts +37 -8
- package/dist/forms/SegmentedControl.js +31 -25
- package/dist/forms/SegmentedControl.js.map +2 -2
- package/dist/forms/Select.d.ts +31 -6
- package/dist/forms/Select.js +43 -24
- package/dist/forms/Select.js.map +2 -2
- package/dist/forms/Slider.d.ts +12 -4
- package/dist/forms/Slider.js +32 -21
- package/dist/forms/Slider.js.map +2 -2
- package/dist/forms/Switch.d.ts +7 -1
- package/dist/forms/Switch.js +31 -25
- package/dist/forms/Switch.js.map +2 -2
- package/dist/forms/TextField.d.ts +5 -5
- package/dist/forms/TextField.js +20 -11
- package/dist/forms/TextField.js.map +2 -2
- package/dist/forms/Textarea.d.ts +1 -1
- package/dist/forms/Textarea.js +12 -2
- package/dist/forms/Textarea.js.map +2 -2
- package/dist/forms/TimePicker.d.ts +8 -1
- package/dist/forms/TimePicker.js +20 -45
- package/dist/forms/TimePicker.js.map +2 -2
- package/dist/forms/color/ColorPicker.d.ts +1 -1
- package/dist/forms/color/ColorPicker.js +29 -23
- package/dist/forms/color/ColorPicker.js.map +2 -2
- package/dist/forms/color/ColorPickerButton.d.ts +12 -2
- package/dist/forms/color/ColorPickerButton.js +37 -22
- package/dist/forms/color/ColorPickerButton.js.map +2 -2
- package/dist/forms/color/ColorSwatch.js +2 -2
- package/dist/forms/color/ColorSwatch.js.map +2 -2
- package/dist/forms/color/internal/{colorChange.js → ColorChangeContext.js} +1 -1
- package/dist/forms/color/internal/{colorChange.js.map → ColorChangeContext.js.map} +1 -1
- package/dist/forms/color/internal/ColorLocale.d.ts +0 -3
- package/dist/forms/color/internal/ColorLocale.js +2 -8
- package/dist/forms/color/internal/ColorLocale.js.map +2 -2
- package/dist/forms/color/internal/ColorValues.d.ts +1 -1
- package/dist/forms/color/internal/ColorValues.js +2 -2
- package/dist/forms/color/internal/ColorValues.js.map +2 -2
- package/dist/forms/color/internal/SwatchList.js +6 -9
- package/dist/forms/color/internal/SwatchList.js.map +2 -2
- package/dist/forms/color/internal/colorPickerValueProps.d.ts +12 -0
- package/dist/forms/color/internal/colorValue.d.ts +1 -0
- package/dist/forms/color/internal/colorValue.js +5 -0
- package/dist/forms/color/internal/colorValue.js.map +2 -2
- package/dist/forms/color/internal/useColorFollowingValue.d.ts +7 -0
- package/dist/forms/color/internal/useColorFollowingValue.js +15 -0
- package/dist/forms/color/internal/useColorFollowingValue.js.map +7 -0
- package/dist/forms/color/internal/useFormResetting.d.ts +9 -0
- package/dist/forms/color/internal/useFormResetting.js +36 -0
- package/dist/forms/color/internal/useFormResetting.js.map +7 -0
- package/dist/forms/color/internal/useSwatchFocus.d.ts +17 -0
- package/dist/forms/color/internal/useSwatchFocus.js +62 -0
- package/dist/forms/color/internal/useSwatchFocus.js.map +7 -0
- package/dist/forms/internal/ComboboxField.d.ts +30 -0
- package/dist/forms/internal/ComboboxField.js +147 -0
- package/dist/forms/internal/ComboboxField.js.map +7 -0
- package/dist/forms/internal/ComboboxPopup.d.ts +2 -2
- package/dist/forms/internal/ComboboxPopup.js +8 -16
- package/dist/forms/internal/ComboboxPopup.js.map +2 -2
- package/dist/forms/internal/MonthGrid.d.ts +1 -1
- package/dist/forms/internal/MonthGrid.js +4 -4
- package/dist/forms/internal/MonthGrid.js.map +2 -2
- package/dist/forms/internal/PickerField.d.ts +32 -27
- package/dist/forms/internal/PickerField.js +70 -52
- package/dist/forms/internal/PickerField.js.map +3 -3
- package/dist/forms/internal/PickerPopup.d.ts +2 -1
- package/dist/forms/internal/PickerPopup.js +3 -0
- package/dist/forms/internal/PickerPopup.js.map +2 -2
- package/dist/forms/internal/TimeList.d.ts +1 -1
- package/dist/forms/internal/TimeList.js +4 -4
- package/dist/forms/internal/TimeList.js.map +2 -2
- package/dist/forms/internal/TimeWheel.d.ts +3 -3
- package/dist/forms/internal/TimeWheel.js +5 -5
- package/dist/forms/internal/TimeWheel.js.map +2 -2
- package/dist/{internal/time → forms/internal}/calendarDays.d.ts +1 -0
- package/dist/{internal/time → forms/internal}/calendarDays.js +5 -1
- package/dist/forms/internal/calendarDays.js.map +7 -0
- package/dist/forms/internal/comboboxItems.d.ts +15 -4
- package/dist/forms/internal/comboboxItems.js +0 -12
- package/dist/forms/internal/comboboxItems.js.map +3 -3
- package/dist/forms/internal/pickerFocus.d.ts +4 -0
- package/dist/forms/internal/pickerFocus.js +13 -0
- package/dist/forms/internal/pickerFocus.js.map +7 -0
- package/dist/forms/internal/timeWheelRows.d.ts +4 -4
- package/dist/forms/internal/timeWheelRows.js +6 -4
- package/dist/forms/internal/timeWheelRows.js.map +2 -2
- package/dist/forms/internal/useComboboxOpen.js +2 -5
- package/dist/forms/internal/useComboboxOpen.js.map +2 -2
- package/dist/forms/internal/useComboboxOptions.js +3 -4
- package/dist/forms/internal/useComboboxOptions.js.map +2 -2
- package/dist/forms/internal/useComboboxSelection.d.ts +1 -1
- package/dist/forms/internal/usePicker.d.ts +29 -0
- package/dist/forms/internal/usePicker.js +38 -0
- package/dist/forms/internal/usePicker.js.map +7 -0
- package/dist/forms/internal/usePickerFormatter.d.ts +4 -0
- package/dist/forms/internal/usePickerFormatter.js +23 -0
- package/dist/forms/internal/usePickerFormatter.js.map +7 -0
- package/dist/forms/internal/useTimeWheelTurn.d.ts +2 -2
- package/dist/forms/internal/useTimeWheelTurn.js +7 -7
- package/dist/forms/internal/useTimeWheelTurn.js.map +2 -2
- package/dist/foundations/PortalContainer.js +1 -1
- package/dist/foundations/PortalContainer.js.map +1 -1
- package/dist/foundations/Theme.d.ts +9 -2
- package/dist/foundations/Theme.js +24 -19
- package/dist/foundations/Theme.js.map +2 -2
- package/dist/foundations/ThemeMenuRadioGroup.d.ts +13 -6
- package/dist/foundations/ThemeMenuRadioGroup.js +6 -11
- package/dist/foundations/ThemeMenuRadioGroup.js.map +2 -2
- package/dist/foundations/ThemePreferenceProvider.d.ts +48 -0
- package/dist/foundations/{ThemePreference.js → ThemePreferenceProvider.js} +48 -106
- package/dist/foundations/ThemePreferenceProvider.js.map +7 -0
- package/dist/foundations/ThemeToggle.d.ts +9 -2
- package/dist/foundations/ThemeToggle.js +3 -2
- package/dist/foundations/ThemeToggle.js.map +2 -2
- package/dist/foundations/internal/ThemePreferenceContext.d.ts +4 -4
- package/dist/foundations/internal/ThemePreferenceContext.js.map +1 -1
- package/dist/foundations/internal/storedPreference.d.ts +3 -0
- package/dist/foundations/internal/storedPreference.js +8 -0
- package/dist/foundations/internal/storedPreference.js.map +7 -0
- package/dist/foundations/messages/defaultMessages.d.ts +4 -72
- package/dist/foundations/messages/defaultMessages.js +0 -14
- package/dist/foundations/messages/defaultMessages.js.map +2 -2
- package/dist/foundations/messages/list.d.ts +13 -35
- package/dist/foundations/messages/list.js +1 -5
- package/dist/foundations/messages/list.js.map +2 -2
- package/dist/foundations/messages/message.d.ts +1 -1
- package/dist/foundations/messages/message.js +1 -1
- package/dist/foundations/messages/message.js.map +1 -1
- package/dist/foundations/messages/navigation.d.ts +4 -0
- package/dist/foundations/messages/navigation.js +2 -0
- package/dist/foundations/messages/navigation.js.map +2 -2
- package/dist/foundations/themeBootstrap.d.ts +13 -35
- package/dist/foundations/themeBootstrap.js +4 -35
- package/dist/foundations/themeBootstrap.js.map +2 -2
- package/dist/foundations/themeStorage.d.ts +20 -0
- package/dist/foundations/themeStorage.js +12 -0
- package/dist/foundations/themeStorage.js.map +7 -0
- package/dist/foundations/useContainerSize.js +13 -11
- package/dist/foundations/useContainerSize.js.map +2 -2
- package/dist/foundations/useSkeleton.d.ts +5 -0
- package/dist/foundations/useSkeleton.js +10 -0
- package/dist/foundations/useSkeleton.js.map +7 -0
- package/dist/foundations/useStoredThemePreference.d.ts +16 -0
- package/dist/foundations/useStoredThemePreference.js +63 -0
- package/dist/foundations/useStoredThemePreference.js.map +7 -0
- package/dist/foundations/windowClasses.d.ts +0 -2
- package/dist/foundations/windowClasses.js +1 -4
- package/dist/foundations/windowClasses.js.map +2 -2
- package/dist/index.d.ts +15 -20
- package/dist/index.js +16 -36
- package/dist/index.js.map +2 -2
- package/dist/internal/control/ActionElement.d.ts +3 -2
- package/dist/internal/control/ActionElement.js +8 -0
- package/dist/internal/control/ActionElement.js.map +2 -2
- package/dist/internal/dialog/ModalLayer.d.ts +9 -0
- package/dist/internal/dialog/ModalLayer.js +32 -0
- package/dist/internal/dialog/ModalLayer.js.map +7 -0
- package/dist/internal/dom/idRefs.d.ts +2 -0
- package/dist/internal/dom/idRefs.js +7 -0
- package/dist/internal/dom/idRefs.js.map +7 -0
- package/dist/internal/dom/lengths.d.ts +3 -1
- package/dist/internal/dom/lengths.js +7 -2
- package/dist/internal/dom/lengths.js.map +2 -2
- package/dist/internal/dom/observeResize.d.ts +7 -0
- package/dist/internal/dom/observeResize.js +11 -0
- package/dist/internal/dom/observeResize.js.map +7 -0
- package/dist/internal/dom/verticalScrollerOf.d.ts +5 -0
- package/dist/internal/dom/verticalScrollerOf.js +12 -0
- package/dist/internal/dom/verticalScrollerOf.js.map +7 -0
- package/dist/internal/field/FieldFrame.d.ts +2 -61
- package/dist/internal/field/FieldFrame.js +17 -8
- package/dist/internal/field/FieldFrame.js.map +2 -2
- package/dist/internal/field/{rowControl.d.ts → RowControl.d.ts} +2 -2
- package/dist/internal/field/{rowControl.js → RowControl.js} +4 -7
- package/dist/internal/field/RowControl.js.map +7 -0
- package/dist/internal/field/TextareaControl.d.ts +2 -2
- package/dist/internal/field/TextareaControl.js +5 -11
- package/dist/internal/field/TextareaControl.js.map +2 -2
- package/dist/internal/field/{TextareaResizeEdge.d.ts → TextareaResizeHandle.d.ts} +1 -1
- package/dist/internal/field/{TextareaResizeEdge.js → TextareaResizeHandle.js} +10 -11
- package/dist/internal/field/TextareaResizeHandle.js.map +7 -0
- package/dist/internal/field/fieldProps.d.ts +67 -0
- package/dist/internal/field/fieldProps.js +1 -0
- package/dist/internal/field/fieldProps.js.map +7 -0
- package/dist/internal/field/fieldSizing.d.ts +1 -0
- package/dist/internal/field/fieldSizing.js +5 -0
- package/dist/internal/field/fieldSizing.js.map +7 -0
- package/dist/internal/field/useFieldControl.d.ts +36 -0
- package/dist/internal/field/useFieldControl.js +53 -0
- package/dist/internal/field/useFieldControl.js.map +7 -0
- package/dist/internal/field/useFormReset.js +1 -1
- package/dist/internal/field/useFormReset.js.map +1 -1
- package/dist/internal/icon/DecorativeIcon.d.ts +2 -1
- package/dist/internal/icon/DecorativeIcon.js +6 -2
- package/dist/internal/icon/DecorativeIcon.js.map +2 -2
- package/dist/internal/layout/Slot.d.ts +2 -1
- package/dist/internal/layout/Slot.js +3 -1
- package/dist/internal/layout/Slot.js.map +2 -2
- package/dist/internal/popup/ListRow.d.ts +39 -0
- package/dist/internal/{list → popup}/ListRow.js +15 -7
- package/dist/internal/popup/ListRow.js.map +7 -0
- package/dist/internal/popup/PopupSurface.d.ts +1 -1
- package/dist/internal/popup/PopupSurface.js +3 -6
- package/dist/internal/popup/PopupSurface.js.map +2 -2
- package/dist/internal/popup/TooltipPopup.d.ts +3 -9
- package/dist/internal/popup/TooltipPopup.js +2 -9
- package/dist/internal/popup/TooltipPopup.js.map +2 -2
- package/dist/internal/popup/{PortalContainerContext.d.ts → containedOverlays.d.ts} +2 -14
- package/dist/internal/popup/{PortalContainerContext.js → containedOverlays.js} +7 -13
- package/dist/internal/popup/containedOverlays.js.map +7 -0
- package/dist/internal/popup/listEntries.d.ts +13 -0
- package/dist/internal/popup/listEntries.js +11 -0
- package/dist/internal/popup/listEntries.js.map +7 -0
- package/dist/internal/popup/useCutShort.d.ts +6 -0
- package/dist/internal/popup/useCutShort.js +19 -0
- package/dist/internal/popup/useCutShort.js.map +7 -0
- package/dist/internal/provider/PortalContainerContext.d.ts +14 -0
- package/dist/internal/provider/PortalContainerContext.js +11 -0
- package/dist/internal/provider/PortalContainerContext.js.map +7 -0
- package/dist/internal/provider/formatters.d.ts +17 -0
- package/dist/internal/provider/formatters.js +21 -0
- package/dist/internal/provider/formatters.js.map +7 -0
- package/dist/internal/provider/locale.d.ts +4 -4
- package/dist/internal/provider/locale.js +9 -1
- package/dist/internal/provider/locale.js.map +2 -2
- package/dist/internal/provider/useDirection.d.ts +1 -1
- package/dist/internal/provider/useDirection.js +2 -14
- package/dist/internal/provider/useDirection.js.map +2 -2
- package/dist/internal/provider/useFormatters.d.ts +1 -16
- package/dist/internal/provider/useFormatters.js +3 -26
- package/dist/internal/provider/useFormatters.js.map +2 -2
- package/dist/internal/rangeBarProps.d.ts +6 -2
- package/dist/internal/react/chainHandlers.d.ts +6 -0
- package/dist/internal/react/chainHandlers.js +12 -0
- package/dist/internal/react/chainHandlers.js.map +7 -0
- package/dist/internal/react/renderElement.js +2 -14
- package/dist/internal/react/renderElement.js.map +2 -2
- package/dist/internal/react/rendersContent.d.ts +2 -0
- package/dist/internal/react/rendersContent.js +7 -0
- package/dist/internal/react/rendersContent.js.map +7 -0
- package/dist/internal/react/setRef.d.ts +6 -1
- package/dist/internal/react/setRef.js +13 -0
- package/dist/internal/react/setRef.js.map +2 -2
- package/dist/internal/react/useControllableState.js +1 -1
- package/dist/internal/react/useControllableState.js.map +1 -1
- package/dist/internal/{useCopy.js.map → react/useCopy.js.map} +1 -1
- package/dist/internal/{useLatest.js.map → react/useLatest.js.map} +1 -1
- package/dist/internal/react/useMergedRefs.d.ts +3 -0
- package/dist/internal/react/useMergedRefs.js +10 -0
- package/dist/internal/react/useMergedRefs.js.map +7 -0
- package/dist/internal/resize/useResizableWidth.d.ts +4 -16
- package/dist/internal/resize/useResizableWidth.js +5 -17
- package/dist/internal/resize/useResizableWidth.js.map +2 -2
- package/dist/internal/sizeTokens.d.ts +13 -0
- package/dist/internal/sizeTokens.js +15 -0
- package/dist/internal/sizeTokens.js.map +7 -0
- package/dist/internal/skeleton/SkeletonContext.d.ts +2 -0
- package/dist/internal/skeleton/SkeletonContext.js +7 -0
- package/dist/internal/skeleton/SkeletonContext.js.map +7 -0
- package/dist/{foundations → internal/skeleton}/SkeletonScope.d.ts +0 -10
- package/dist/{foundations → internal/skeleton}/SkeletonScope.js +6 -11
- package/dist/internal/skeleton/SkeletonScope.js.map +7 -0
- package/dist/internal/{skeleton.d.ts → skeleton/skeleton.d.ts} +1 -3
- package/dist/internal/{skeleton.js → skeleton/skeleton.js} +1 -2
- package/dist/internal/skeleton/skeleton.js.map +7 -0
- package/dist/{foundations/internal → internal/skeleton}/skeletonText.js +5 -5
- package/dist/internal/skeleton/skeletonText.js.map +7 -0
- package/dist/internal/text/labelText.d.ts +15 -0
- package/dist/internal/text/labelText.js +34 -0
- package/dist/internal/text/labelText.js.map +7 -0
- package/dist/internal/text/useRenderedText.d.ts +3 -0
- package/dist/internal/text/useRenderedText.js +19 -0
- package/dist/internal/text/useRenderedText.js.map +7 -0
- package/dist/internal/theme/themeRoot.d.ts +27 -0
- package/dist/internal/theme/themeRoot.js +45 -0
- package/dist/internal/theme/themeRoot.js.map +7 -0
- package/dist/internal/typeahead.d.ts +9 -5
- package/dist/internal/typeahead.js +4 -1
- package/dist/internal/typeahead.js.map +2 -2
- package/dist/layout/Card.d.ts +21 -4
- package/dist/layout/Card.js +12 -6
- package/dist/layout/Card.js.map +2 -2
- package/dist/layout/Layout.d.ts +2 -2
- package/dist/layout/Layout.js.map +1 -1
- package/dist/layout/Page.d.ts +2 -2
- package/dist/layout/Page.js.map +1 -1
- package/dist/layout/PageHeader.d.ts +6 -1
- package/dist/layout/PageHeader.js +3 -1
- package/dist/layout/PageHeader.js.map +2 -2
- package/dist/layout/Panes.d.ts +10 -20
- package/dist/layout/Panes.js +5 -25
- package/dist/layout/Panes.js.map +2 -2
- package/dist/layout/ResizeHandle.d.ts +1 -0
- package/dist/layout/ResizeHandle.js +11 -21
- package/dist/layout/ResizeHandle.js.map +2 -2
- package/dist/layout/Scaffold.d.ts +14 -4
- package/dist/layout/Scaffold.js +16 -51
- package/dist/layout/Scaffold.js.map +2 -2
- package/dist/layout/Surface.d.ts +1 -1
- package/dist/layout/Surface.js +4 -1
- package/dist/layout/Surface.js.map +2 -2
- package/dist/layout/TopBar.d.ts +2 -2
- package/dist/layout/TopBar.js +4 -5
- package/dist/layout/TopBar.js.map +2 -2
- package/dist/layout/internal/LoadingBar.d.ts +3 -7
- package/dist/layout/internal/LoadingBar.js +5 -10
- package/dist/layout/internal/LoadingBar.js.map +2 -2
- package/dist/layout/internal/PageTitleFocus.d.ts +0 -9
- package/dist/layout/internal/PageTitleFocus.js +3 -24
- package/dist/layout/internal/PageTitleFocus.js.map +2 -2
- package/dist/layout/internal/StickyHeaderSize.js +3 -3
- package/dist/layout/internal/StickyHeaderSize.js.map +2 -2
- package/dist/layout/internal/{navigationForms.d.ts → scaffold/navigationForms.d.ts} +2 -2
- package/dist/layout/internal/scaffold/navigationForms.js.map +7 -0
- package/dist/layout/internal/{scaffoldFocus.js.map → scaffold/scaffoldFocus.js.map} +1 -1
- package/dist/layout/internal/{scrollKeys.js → scaffold/scrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/scrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffold/useBarSizes.d.ts +6 -0
- package/dist/layout/internal/scaffold/useBarSizes.js +54 -0
- package/dist/layout/internal/scaffold/useBarSizes.js.map +7 -0
- package/dist/layout/internal/{useNavigationFocusHandoff.js → scaffold/useNavigationFocusHandoff.js} +5 -4
- package/dist/layout/internal/scaffold/useNavigationFocusHandoff.js.map +7 -0
- package/dist/layout/internal/{useScrollKeys.js → scaffold/useScrollKeys.js} +1 -1
- package/dist/layout/internal/scaffold/useScrollKeys.js.map +7 -0
- package/dist/layout/internal/scaffoldPages.d.ts +9 -0
- package/dist/layout/internal/scaffoldPages.js +27 -0
- package/dist/layout/internal/scaffoldPages.js.map +7 -0
- package/dist/markdown.d.ts +0 -1
- package/dist/markdown.js +0 -1
- package/dist/markdown.js.map +2 -2
- package/dist/messages.d.ts +1 -1
- package/dist/messages.js +1 -6
- package/dist/messages.js.map +2 -2
- package/dist/navigation/Breadcrumbs.d.ts +15 -4
- package/dist/navigation/Breadcrumbs.js +36 -27
- package/dist/navigation/Breadcrumbs.js.map +2 -2
- package/dist/navigation/DocumentTabs.d.ts +54 -12
- package/dist/navigation/DocumentTabs.js +50 -150
- package/dist/navigation/DocumentTabs.js.map +3 -3
- package/dist/navigation/NavigationBar.d.ts +10 -3
- package/dist/navigation/NavigationBar.js +75 -35
- package/dist/navigation/NavigationBar.js.map +2 -2
- package/dist/navigation/NavigationDrawer.d.ts +9 -3
- package/dist/navigation/NavigationDrawer.js +24 -217
- package/dist/navigation/NavigationDrawer.js.map +2 -2
- package/dist/navigation/NavigationRail.d.ts +10 -3
- package/dist/navigation/NavigationRail.js +20 -10
- package/dist/navigation/NavigationRail.js.map +2 -2
- package/dist/navigation/Pager.d.ts +25 -11
- package/dist/navigation/Pager.js +49 -12
- package/dist/navigation/Pager.js.map +3 -3
- package/dist/navigation/Pagination.d.ts +24 -9
- package/dist/navigation/Pagination.js +37 -11
- package/dist/navigation/Pagination.js.map +2 -2
- package/dist/navigation/TableOfContents.d.ts +18 -4
- package/dist/navigation/TableOfContents.js +41 -121
- package/dist/navigation/TableOfContents.js.map +2 -2
- package/dist/navigation/Tree.d.ts +28 -11
- package/dist/navigation/Tree.js +41 -37
- package/dist/navigation/Tree.js.map +2 -2
- package/dist/navigation/destinations.d.ts +43 -11
- package/dist/navigation/internal/DestinationItem.d.ts +5 -41
- package/dist/navigation/internal/DestinationItem.js +41 -44
- package/dist/navigation/internal/DestinationItem.js.map +2 -2
- package/dist/navigation/internal/destinationModel.d.ts +16 -0
- package/dist/navigation/internal/destinationModel.js +28 -0
- package/dist/navigation/internal/destinationModel.js.map +7 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.d.ts +12 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js +122 -0
- package/dist/navigation/internal/documentTabs/DocumentTab.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.d.ts +21 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js +73 -0
- package/dist/navigation/internal/documentTabs/tabMenuContent.js.map +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.d.ts +7 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js +26 -0
- package/dist/navigation/internal/documentTabs/tabStrip.js.map +7 -0
- package/dist/navigation/internal/{useTabCloseFocus.js → documentTabs/useTabCloseFocus.js} +2 -2
- package/dist/navigation/internal/documentTabs/useTabCloseFocus.js.map +7 -0
- package/dist/navigation/internal/{useTabDrag.d.ts → documentTabs/useTabDrag.d.ts} +3 -3
- package/dist/navigation/internal/{useTabDrag.js → documentTabs/useTabDrag.js} +8 -8
- package/dist/navigation/internal/documentTabs/useTabDrag.js.map +7 -0
- package/dist/navigation/internal/{useTabStripScrolling.js → documentTabs/useTabStripScrolling.js} +22 -3
- package/dist/navigation/internal/documentTabs/useTabStripScrolling.js.map +7 -0
- package/dist/navigation/internal/landmarkLabel.d.ts +1 -0
- package/dist/navigation/internal/landmarkLabel.js +5 -0
- package/dist/navigation/internal/landmarkLabel.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.d.ts +18 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js +151 -0
- package/dist/navigation/internal/navigationDrawer/DrawerRows.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.d.ts +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js +13 -0
- package/dist/navigation/internal/navigationDrawer/destinationSections.js.map +7 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.d.ts +6 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js +57 -0
- package/dist/navigation/internal/navigationDrawer/useExpandedSections.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.d.ts +26 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js +38 -0
- package/dist/navigation/internal/tableOfContents/contentsOutline.js.map +7 -0
- package/dist/navigation/internal/{contentsWave.js → tableOfContents/contentsWave.js} +1 -1
- package/dist/navigation/internal/tableOfContents/contentsWave.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/readingPosition.d.ts +25 -0
- package/dist/navigation/internal/{contentsOutline.js → tableOfContents/readingPosition.js} +2 -37
- package/dist/navigation/internal/tableOfContents/readingPosition.js.map +7 -0
- package/dist/navigation/internal/{sectionScroll.d.ts → tableOfContents/sectionScroll.d.ts} +6 -1
- package/dist/navigation/internal/{sectionScroll.js → tableOfContents/sectionScroll.js} +18 -10
- package/dist/navigation/internal/tableOfContents/sectionScroll.js.map +7 -0
- package/dist/navigation/internal/{useContentsHeadings.d.ts → tableOfContents/useContentsHeadings.d.ts} +2 -2
- package/dist/navigation/internal/{useContentsHeadings.js → tableOfContents/useContentsHeadings.js} +4 -7
- package/dist/navigation/internal/tableOfContents/useContentsHeadings.js.map +7 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.d.ts +15 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js +119 -0
- package/dist/navigation/internal/tableOfContents/useReadingPlace.js.map +7 -0
- package/dist/navigation/internal/{waveDrawer.js → tableOfContents/waveDrawer.js} +5 -4
- package/dist/navigation/internal/tableOfContents/waveDrawer.js.map +7 -0
- package/dist/navigation/internal/{TreeRow.d.ts → tree/TreeRow.d.ts} +1 -1
- package/dist/navigation/internal/{TreeRow.js → tree/TreeRow.js} +9 -5
- package/dist/navigation/internal/tree/TreeRow.js.map +7 -0
- package/dist/navigation/internal/{treeModel.d.ts → tree/treeModel.d.ts} +7 -9
- package/dist/navigation/internal/{treeModel.js → tree/treeModel.js} +10 -13
- package/dist/navigation/internal/tree/treeModel.js.map +7 -0
- package/dist/navigation/internal/{useTreeTransitions.d.ts → tree/useTreeTransitions.d.ts} +1 -1
- package/dist/navigation/internal/tree/useTreeTransitions.js.map +7 -0
- package/dist/navigation/internal/{useTreeViewport.d.ts → tree/useTreeViewport.d.ts} +3 -3
- package/dist/navigation/internal/{useTreeViewport.js → tree/useTreeViewport.js} +11 -12
- package/dist/navigation/internal/tree/useTreeViewport.js.map +7 -0
- package/dist/navigation/internal/useLabelText.d.ts +6 -0
- package/dist/navigation/internal/useLabelText.js +11 -0
- package/dist/navigation/internal/useLabelText.js.map +7 -0
- package/dist/navigation/navigationBackground.d.ts +0 -2
- package/dist/navigation/navigationBackground.js +0 -6
- package/dist/navigation/navigationBackground.js.map +3 -3
- package/dist/overlays/ConfirmDialog.d.ts +6 -3
- package/dist/overlays/ConfirmDialog.js +64 -68
- package/dist/overlays/ConfirmDialog.js.map +2 -2
- package/dist/overlays/Dialog.d.ts +40 -6
- package/dist/overlays/Dialog.js +69 -41
- package/dist/overlays/Dialog.js.map +2 -2
- package/dist/overlays/HoverCard.d.ts +9 -2
- package/dist/overlays/HoverCard.js +5 -5
- package/dist/overlays/HoverCard.js.map +2 -2
- package/dist/overlays/Popover.d.ts +20 -5
- package/dist/overlays/Popover.js +8 -6
- package/dist/overlays/Popover.js.map +2 -2
- package/dist/overlays/Sheet.d.ts +16 -3
- package/dist/overlays/Sheet.js +88 -87
- package/dist/overlays/Sheet.js.map +2 -2
- package/dist/overlays/Tooltip.d.ts +7 -0
- package/dist/overlays/Tooltip.js +10 -15
- package/dist/overlays/Tooltip.js.map +2 -2
- package/dist/overlays/internal/accessibleName.js +2 -1
- package/dist/overlays/internal/accessibleName.js.map +2 -2
- package/dist/overlays/internal/dialog/DialogHeadingClose.d.ts +8 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js +19 -0
- package/dist/overlays/internal/dialog/DialogHeadingClose.js.map +7 -0
- package/dist/overlays/internal/dialog/DialogParts.d.ts +33 -0
- package/dist/overlays/internal/dialog/DialogParts.js +64 -0
- package/dist/overlays/internal/dialog/DialogParts.js.map +7 -0
- package/dist/overlays/internal/{DialogPendingAction.d.ts → dialog/dialogPending.d.ts} +8 -0
- package/dist/overlays/internal/{DialogPendingAction.js → dialog/dialogPending.js} +13 -2
- package/dist/overlays/internal/dialog/dialogPending.js.map +7 -0
- package/dist/styles/Accordion.css +1 -1
- package/dist/styles/Alert.css +1 -1
- package/dist/styles/Avatar.css +1 -1
- package/dist/styles/Badge.css +1 -1
- package/dist/styles/Base.css +1 -1
- package/dist/styles/Breadcrumbs.css +1 -1
- package/dist/styles/Card.css +1 -1
- package/dist/styles/Checkbox.css +1 -1
- package/dist/styles/Code.css +1 -1
- package/dist/styles/Combobox.css +1 -1
- package/dist/styles/CommandPalette.css +1 -1
- package/dist/styles/Composer.css +1 -1
- package/dist/styles/CopyButton.css +1 -1
- package/dist/styles/Dialog.css +1 -1
- package/dist/styles/Disclosure.css +1 -1
- package/dist/styles/DocumentTabs.css +1 -1
- package/dist/styles/DropZone.css +1 -1
- package/dist/styles/EmptyState.css +1 -1
- package/dist/styles/Halo.css +1 -0
- package/dist/styles/List.css +1 -1
- package/dist/styles/ListRow.css +1 -1
- package/dist/styles/LoadingBar.css +1 -1
- package/dist/styles/Menu.css +1 -1
- package/dist/styles/Message.css +1 -1
- package/dist/styles/Meter.css +1 -1
- package/dist/styles/NavigationBar.css +1 -1
- package/dist/styles/NavigationDestinations.css +1 -0
- package/dist/styles/NavigationDrawer.css +1 -1
- package/dist/styles/NavigationRail.css +1 -1
- package/dist/styles/Pager.css +1 -1
- package/dist/styles/Panes.css +1 -1
- package/dist/styles/Progress.css +1 -0
- package/dist/styles/Radio.css +1 -1
- package/dist/styles/Scaffold.css +1 -1
- package/dist/styles/SegmentedControl.css +1 -1
- package/dist/styles/Select.css +1 -1
- package/dist/styles/Switch.css +1 -1
- package/dist/styles/Table.css +1 -1
- package/dist/styles/TableOfContents.css +1 -1
- package/dist/styles/Text.css +1 -1
- package/dist/styles/TextField.css +1 -1
- package/dist/styles/Toast.css +1 -1
- package/dist/styles/Toolbar.css +1 -1
- package/dist/styles/Tree.css +1 -1
- package/dist/styles.css +1 -1
- package/dist/theme-bootstrap.d.ts +1 -1
- package/dist/theme-bootstrap.js +1 -8
- package/dist/theme-bootstrap.js.map +2 -2
- package/dist/theme-storage.d.ts +2 -0
- package/dist/theme-storage.js +3 -0
- package/dist/theme-storage.js.map +7 -0
- package/dist/tokens.json +0 -13
- package/docs/components/accordion.md +13 -0
- package/docs/components/alert.md +8 -1
- package/docs/components/avatar.md +16 -4
- package/docs/components/badge.md +10 -39
- package/docs/components/box.md +3 -3
- package/docs/components/breadcrumbs.md +6 -1
- package/docs/components/button.md +14 -9
- package/docs/components/card.md +14 -5
- package/docs/components/checkbox.md +3 -1
- package/docs/components/code.md +15 -6
- package/docs/components/color-picker.md +10 -2
- package/docs/components/column.md +2 -2
- package/docs/components/combobox.md +1 -1
- package/docs/components/command-palette.md +6 -2
- package/docs/components/composer.md +19 -8
- package/docs/components/confirm-dialog.md +3 -3
- package/docs/components/date-picker.md +15 -3
- package/docs/components/description-list.md +1 -1
- package/docs/components/dialog.md +34 -8
- package/docs/components/disclosure.md +4 -0
- package/docs/components/document-tabs.md +23 -13
- package/docs/components/drop-zone.md +10 -1
- package/docs/components/empty-state.md +12 -3
- package/docs/components/field.md +2 -1
- package/docs/components/graphic.md +1 -1
- package/docs/components/grid.md +2 -2
- package/docs/components/halo.md +80 -0
- package/docs/components/hover-card.md +2 -1
- package/docs/components/kbd.md +8 -2
- package/docs/components/link.md +1 -1
- package/docs/components/list.md +13 -5
- package/docs/components/markdown.md +9 -116
- package/docs/components/menu.md +28 -12
- package/docs/components/menubar.md +4 -3
- package/docs/components/message.md +17 -13
- package/docs/components/meter.md +8 -3
- package/docs/components/month-picker.md +4 -2
- package/docs/components/navigation-drawer.md +32 -7
- package/docs/components/page.md +4 -3
- package/docs/components/pager.md +16 -6
- package/docs/components/pagination.md +3 -2
- package/docs/components/panes.md +13 -26
- package/docs/components/popover.md +3 -2
- package/docs/components/progress.md +2 -2
- package/docs/components/radio.md +13 -5
- package/docs/components/relative-time.md +2 -1
- package/docs/components/resize-handle.md +6 -4
- package/docs/components/row.md +2 -2
- package/docs/components/scaffold.md +13 -4
- package/docs/components/segmented-control.md +10 -4
- package/docs/components/select.md +10 -2
- package/docs/components/sheet.md +4 -1
- package/docs/components/slider.md +8 -2
- package/docs/components/spinner.md +1 -1
- package/docs/components/surface.md +1 -1
- package/docs/components/switch.md +2 -0
- package/docs/components/table-of-contents.md +3 -2
- package/docs/components/table.md +18 -3
- package/docs/components/text-field.md +14 -8
- package/docs/components/time-picker.md +4 -2
- package/docs/components/toast.md +2 -1
- package/docs/components/toolbar.md +31 -6
- package/docs/components/tooltip.md +1 -0
- package/docs/components/top-bar.md +1 -1
- package/docs/components/tree.md +9 -4
- package/docs/customizing.md +59 -91
- package/docs/examples/accordion/IntegrationSwitches.tsx +33 -0
- package/docs/examples/alert/BannerAction.tsx +19 -0
- package/docs/examples/avatar/BotsAndPresence.tsx +24 -0
- package/docs/examples/badge/BadgeAnatomy.tsx +1 -1
- package/docs/examples/badge/CountsInButtons.tsx +2 -2
- package/docs/examples/badge/WithContent.tsx +13 -0
- package/docs/examples/breadcrumbs/WithAvatar.tsx +20 -0
- package/docs/examples/button/ButtonAnatomy.tsx +1 -1
- package/docs/examples/button/CreateProject.tsx +1 -1
- package/docs/examples/button/FillSidebar.tsx +1 -1
- package/docs/examples/button/Icons.tsx +2 -2
- package/docs/examples/button/PictureBeforeLabel.tsx +14 -0
- package/docs/examples/card/CardAnatomy.tsx +3 -1
- package/docs/examples/card/OpenFromCard.tsx +65 -0
- package/docs/examples/code/PackageManagers.tsx +35 -0
- package/docs/examples/code/SettingsDiff.tsx +5 -9
- package/docs/examples/color-picker/TextColorInToolbar.tsx +44 -0
- package/docs/examples/colors/Status.tsx +6 -6
- package/docs/examples/command-palette/CommandPaletteAnatomy.tsx +11 -5
- package/docs/examples/command-palette/GoToDocument.tsx +17 -14
- package/docs/examples/command-palette/NarrowSidebar.tsx +1 -1
- package/docs/examples/command-palette/RunCommand.tsx +16 -12
- package/docs/examples/command-palette/SearchButton.tsx +2 -2
- package/docs/examples/command-palette/TypeToSearch.tsx +2 -2
- package/docs/examples/composer/AttachmentsAndVoice.tsx +30 -0
- package/docs/examples/confirm-dialog/FromMenu.tsx +1 -1
- package/docs/examples/date-picker/PresetsAndBusyDays.tsx +61 -0
- package/docs/examples/dialog/EditMember.tsx +28 -0
- package/docs/examples/dialog/FindPlan.tsx +1 -1
- package/docs/examples/document-tabs/DocumentTabsAnatomy.tsx +2 -2
- package/docs/examples/document-tabs/EditorTabs.tsx +57 -0
- package/docs/examples/document-tabs/OpenDocuments.tsx +2 -2
- package/docs/examples/drop-zone/FilesInsideTheZone.tsx +40 -0
- package/docs/examples/empty-state/WithIllustration.tsx +22 -0
- package/docs/examples/graphic/Colors.tsx +1 -1
- package/docs/examples/graphic/SignInWithLogo.tsx +1 -1
- package/docs/examples/halo/AroundACard.tsx +14 -0
- package/docs/examples/halo/InviteTeam.tsx +15 -0
- package/docs/examples/halo/Tones.tsx +14 -0
- package/docs/examples/icons/FollowText.tsx +3 -3
- package/docs/examples/kbd/Sequences.tsx +10 -0
- package/docs/examples/list/TitleActions.tsx +32 -0
- package/docs/examples/menu/AccountSwitcher.tsx +32 -0
- package/docs/examples/menu/Choices.tsx +1 -1
- package/docs/examples/menu/ContextMenuForRows.tsx +3 -3
- package/docs/examples/menu/Destinations.tsx +5 -5
- package/docs/examples/menu/GroupsAndSeparators.tsx +6 -6
- package/docs/examples/menu/IconsAndShortcuts.tsx +5 -5
- package/docs/examples/menu/MenuAnatomy.tsx +3 -3
- package/docs/examples/menu/Submenus.tsx +4 -4
- package/docs/examples/menubar/NotesMenubar.tsx +4 -4
- package/docs/examples/message/CommentThread.tsx +30 -0
- package/docs/examples/message/Conversation.tsx +7 -2
- package/docs/examples/meter/InlineUsage.tsx +10 -0
- package/docs/examples/navigation-drawer/ActivityBar.tsx +26 -0
- package/docs/examples/navigation-drawer/GroupActions.tsx +43 -0
- package/docs/examples/page/WithBreadcrumbs.tsx +1 -1
- package/docs/examples/page/WithHeader.tsx +1 -1
- package/docs/examples/page/WithToolbar.tsx +1 -1
- package/docs/examples/pager/LongTitles.tsx +2 -2
- package/docs/examples/pager/PagerAnatomy.tsx +2 -2
- package/docs/examples/pager/PreviousAndNext.tsx +2 -2
- package/docs/examples/pager/StepThroughAGuide.tsx +2 -2
- package/docs/examples/panes/DocumentAndDetails.tsx +53 -0
- package/docs/examples/panes/PanesAnatomy.tsx +20 -12
- package/docs/examples/panes/ResizableDetails.tsx +35 -2
- package/docs/examples/panes/StackedWhenNarrow.tsx +11 -10
- package/docs/examples/popover/DocumentDetails.tsx +1 -1
- package/docs/examples/popover/RenameInPlace.tsx +1 -1
- package/docs/examples/progress/ExportMembers.tsx +1 -1
- package/docs/examples/radio/PlanRows.tsx +35 -0
- package/docs/examples/relative-time/PastAndComing.tsx +6 -6
- package/docs/examples/relative-time/VersionLabels.tsx +5 -5
- package/docs/examples/resize-handle/DockedLogs.tsx +44 -0
- package/docs/examples/resize-handle/ResizeHandleAnatomy.tsx +22 -22
- package/docs/examples/row/SectionHeading.tsx +1 -1
- package/docs/examples/scaffold/InspectorAndStatus.tsx +63 -0
- package/docs/examples/segmented-control/IconOnlyAndBadge.tsx +31 -0
- package/docs/examples/segmented-control/SegmentedControlAnatomy.tsx +2 -2
- package/docs/examples/segmented-control/SmallToolbar.tsx +4 -4
- package/docs/examples/select/Assignee.tsx +29 -0
- package/docs/examples/select/SmallToolbar.tsx +23 -21
- package/docs/examples/sheet/FilterPanel.tsx +1 -1
- package/docs/examples/sheet/ShareChoices.tsx +1 -1
- package/docs/examples/slider/IconsAndUnits.tsx +42 -0
- package/docs/examples/spacing/Align.tsx +1 -1
- package/docs/examples/table/HeaderEndAndTotals.tsx +61 -0
- package/docs/examples/table/WorkItemsWithParts.tsx +1 -1
- package/docs/examples/table-of-contents/DocsArticle.tsx +16 -11
- package/docs/examples/text-field/ContentAffixes.tsx +32 -0
- package/docs/examples/text-field/FieldsBesideButtons.tsx +1 -1
- package/docs/examples/text-field/IconAndEndAction.tsx +1 -1
- package/docs/examples/text-field/TextFieldAnatomy.tsx +1 -1
- package/docs/examples/text-field/Variants.tsx +1 -1
- package/docs/examples/toast/ExportReady.tsx +7 -5
- package/docs/examples/toast/RetryAfterError.tsx +8 -6
- package/docs/examples/toast/ToastAnatomy.tsx +1 -1
- package/docs/examples/toast/TopCenter.tsx +1 -1
- package/docs/examples/toast/UndoArchive.tsx +10 -8
- package/docs/examples/toolbar/LabelledControls.tsx +40 -0
- package/docs/examples/tooltip/MenuTrigger.tsx +2 -2
- package/docs/examples/tree/ContextMenuActions.tsx +5 -5
- package/docs/examples/tree/FileTree.tsx +1 -1
- package/docs/examples/tree/MatchedLetters.tsx +37 -0
- package/docs/examples/tree/NarrowTree.tsx +3 -3
- package/docs/examples/tree/RowDensity.tsx +6 -6
- package/docs/examples/tree/TreeAnatomy.tsx +2 -2
- package/docs/foundations/accessibility.md +3 -3
- package/docs/foundations/colors.md +2 -3
- package/docs/foundations/icons.md +3 -3
- package/docs/foundations/responsive.md +2 -2
- package/docs/foundations/spacing.md +2 -2
- package/docs/foundations/typography.md +2 -2
- package/docs/generated/exports.json +34 -52
- package/docs/generated/parts.json +469 -484
- package/docs/generated/props.json +1053 -903
- package/docs/index.md +52 -56
- package/docs/setup.md +62 -20
- package/docs/writing.md +1 -1
- package/package.json +6 -25
- package/dist/actions/internal/MenuPopup.js.map +0 -7
- package/dist/assets/readme/gallery-dark.png +0 -0
- package/dist/assets/readme/gallery-light.png +0 -0
- package/dist/content/MarkdownEditor.d.ts +0 -35
- package/dist/content/MarkdownEditor.js +0 -236
- package/dist/content/MarkdownEditor.js.map +0 -7
- package/dist/content/internal/markdown/MarkdownPreview.d.ts +0 -9
- package/dist/content/internal/markdown/MarkdownPreview.js +0 -30
- package/dist/content/internal/markdown/MarkdownPreview.js.map +0 -7
- package/dist/content/internal/markdown/markdownFormatting.d.ts +0 -15
- package/dist/content/internal/markdown/markdownFormatting.js +0 -96
- package/dist/content/internal/markdown/markdownFormatting.js.map +0 -7
- package/dist/content/internal/markdown/markdownHistory.d.ts +0 -10
- package/dist/content/internal/markdown/markdownHistory.js +0 -54
- package/dist/content/internal/markdown/markdownHistory.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownEditing.d.ts +0 -19
- package/dist/content/internal/markdown/useMarkdownEditing.js +0 -127
- package/dist/content/internal/markdown/useMarkdownEditing.js.map +0 -7
- package/dist/content/internal/markdown/useMarkdownLink.d.ts +0 -22
- package/dist/content/internal/markdown/useMarkdownLink.js +0 -73
- package/dist/content/internal/markdown/useMarkdownLink.js.map +0 -7
- package/dist/data-display/AnimatedNumber.d.ts +0 -15
- package/dist/data-display/AnimatedNumber.js +0 -111
- package/dist/data-display/AnimatedNumber.js.map +0 -7
- package/dist/data-display/CalendarHeatmap.d.ts +0 -92
- package/dist/data-display/CalendarHeatmap.js +0 -224
- package/dist/data-display/CalendarHeatmap.js.map +0 -7
- package/dist/data-display/DiffStat.d.ts +0 -23
- package/dist/data-display/DiffStat.js +0 -42
- package/dist/data-display/DiffStat.js.map +0 -7
- package/dist/data-display/Rating.d.ts +0 -32
- package/dist/data-display/Rating.js +0 -45
- package/dist/data-display/Rating.js.map +0 -7
- package/dist/data-display/internal/ListRows.js.map +0 -7
- package/dist/data-display/internal/calendarHeatmapModel.d.ts +0 -44
- package/dist/data-display/internal/calendarHeatmapModel.js +0 -133
- package/dist/data-display/internal/calendarHeatmapModel.js.map +0 -7
- package/dist/data-display/internal/useHeatmapLabels.d.ts +0 -16
- package/dist/data-display/internal/useHeatmapLabels.js +0 -56
- package/dist/data-display/internal/useHeatmapLabels.js.map +0 -7
- package/dist/data-display/internal/useHeatmapTooltip.d.ts +0 -24
- package/dist/data-display/internal/useHeatmapTooltip.js +0 -142
- package/dist/data-display/internal/useHeatmapTooltip.js.map +0 -7
- package/dist/dev/api.d.ts +0 -64
- package/dist/dev/api.js +0 -88
- package/dist/dev/api.js.map +0 -7
- package/dist/dev/elements.d.ts +0 -7
- package/dist/dev/elements.js +0 -32
- package/dist/dev/elements.js.map +0 -7
- package/dist/dev/inner.d.ts +0 -17
- package/dist/dev/inner.js +0 -139
- package/dist/dev/inner.js.map +0 -7
- package/dist/dev/install.d.ts +0 -64
- package/dist/dev/install.js +0 -128
- package/dist/dev/install.js.map +0 -7
- package/dist/dev/measure.d.ts +0 -10
- package/dist/dev/measure.js +0 -304
- package/dist/dev/measure.js.map +0 -7
- package/dist/dev/model.d.ts +0 -136
- package/dist/dev/model.js +0 -5
- package/dist/dev/model.js.map +0 -7
- package/dist/dev/overlays.d.ts +0 -5
- package/dist/dev/overlays.js +0 -52
- package/dist/dev/overlays.js.map +0 -7
- package/dist/dev/parts.d.ts +0 -49
- package/dist/dev/parts.js +0 -89
- package/dist/dev/parts.js.map +0 -7
- package/dist/dev/queries.d.ts +0 -28
- package/dist/dev/queries.js +0 -135
- package/dist/dev/queries.js.map +0 -7
- package/dist/dev/readout.d.ts +0 -9
- package/dist/dev/readout.js +0 -275
- package/dist/dev/readout.js.map +0 -7
- package/dist/dev/skeletonShift.d.ts +0 -6
- package/dist/dev/skeletonShift.js +0 -174
- package/dist/dev/skeletonShift.js.map +0 -7
- package/dist/dev/ui/Controls.d.ts +0 -20
- package/dist/dev/ui/Controls.js +0 -53
- package/dist/dev/ui/Controls.js.map +0 -7
- package/dist/dev/ui/DevMode.d.ts +0 -14
- package/dist/dev/ui/DevMode.js +0 -222
- package/dist/dev/ui/DevMode.js.map +0 -7
- package/dist/dev/ui/Frame.d.ts +0 -14
- package/dist/dev/ui/Frame.js +0 -178
- package/dist/dev/ui/Frame.js.map +0 -7
- package/dist/dev/ui/Icons.d.ts +0 -5
- package/dist/dev/ui/Icons.js +0 -38
- package/dist/dev/ui/Icons.js.map +0 -7
- package/dist/dev/ui/Inspector.d.ts +0 -24
- package/dist/dev/ui/Inspector.js +0 -366
- package/dist/dev/ui/Inspector.js.map +0 -7
- package/dist/dev/ui/Legend.d.ts +0 -4
- package/dist/dev/ui/Legend.js +0 -50
- package/dist/dev/ui/Legend.js.map +0 -7
- package/dist/dev/ui/NodeHints.d.ts +0 -15
- package/dist/dev/ui/NodeHints.js +0 -95
- package/dist/dev/ui/NodeHints.js.map +0 -7
- package/dist/dev/ui/PerformancePanel.d.ts +0 -3
- package/dist/dev/ui/PerformancePanel.js +0 -72
- package/dist/dev/ui/PerformancePanel.js.map +0 -7
- package/dist/dev/ui/Plane.d.ts +0 -37
- package/dist/dev/ui/Plane.js +0 -154
- package/dist/dev/ui/Plane.js.map +0 -7
- package/dist/dev/ui/View3D.d.ts +0 -19
- package/dist/dev/ui/View3D.js +0 -248
- package/dist/dev/ui/View3D.js.map +0 -7
- package/dist/dev/ui/ViewToolbar.d.ts +0 -40
- package/dist/dev/ui/ViewToolbar.js +0 -352
- package/dist/dev/ui/ViewToolbar.js.map +0 -7
- package/dist/dev/ui/camera.d.ts +0 -42
- package/dist/dev/ui/camera.js +0 -157
- package/dist/dev/ui/camera.js.map +0 -7
- package/dist/dev/ui/devices.d.ts +0 -9
- package/dist/dev/ui/devices.js +0 -34
- package/dist/dev/ui/devices.js.map +0 -7
- package/dist/dev/ui/editorTheme.d.ts +0 -6
- package/dist/dev/ui/editorTheme.js +0 -30
- package/dist/dev/ui/editorTheme.js.map +0 -7
- package/dist/dev/ui/sides.d.ts +0 -20
- package/dist/dev/ui/sides.js +0 -43
- package/dist/dev/ui/sides.js.map +0 -7
- package/dist/dev/ui/stats.d.ts +0 -25
- package/dist/dev/ui/stats.js +0 -26
- package/dist/dev/ui/stats.js.map +0 -7
- package/dist/dev/ui/surfaces.d.ts +0 -4
- package/dist/dev/ui/surfaces.js +0 -249
- package/dist/dev/ui/surfaces.js.map +0 -7
- package/dist/dev/ui/useLivePage.d.ts +0 -13
- package/dist/dev/ui/useLivePage.js +0 -138
- package/dist/dev/ui/useLivePage.js.map +0 -7
- package/dist/dev/ui/usePlaneHover.d.ts +0 -9
- package/dist/dev/ui/usePlaneHover.js +0 -46
- package/dist/dev/ui/usePlaneHover.js.map +0 -7
- package/dist/dev/ui/useViewFit.d.ts +0 -16
- package/dist/dev/ui/useViewFit.js +0 -59
- package/dist/dev/ui/useViewFit.js.map +0 -7
- package/dist/dev/ui/useViewWheel.d.ts +0 -11
- package/dist/dev/ui/useViewWheel.js +0 -48
- package/dist/dev/ui/useViewWheel.js.map +0 -7
- package/dist/dev/ui/wheel.d.ts +0 -7
- package/dist/dev/ui/wheel.js +0 -98
- package/dist/dev/ui/wheel.js.map +0 -7
- package/dist/dev/units.d.ts +0 -7
- package/dist/dev/units.js +0 -22
- package/dist/dev/units.js.map +0 -7
- package/dist/dev/usedTokens.d.ts +0 -5
- package/dist/dev/usedTokens.js +0 -56
- package/dist/dev/usedTokens.js.map +0 -7
- package/dist/dev.d.ts +0 -5
- package/dist/dev.js +0 -9
- package/dist/dev.js.map +0 -7
- package/dist/feedback/toast/internal/PictureNotice.js.map +0 -7
- package/dist/forms/color/internal/useColorState.d.ts +0 -10
- package/dist/forms/color/internal/useColorState.js +0 -49
- package/dist/forms/color/internal/useColorState.js.map +0 -7
- package/dist/forms/internal/usePickerValue.d.ts +0 -13
- package/dist/forms/internal/usePickerValue.js +0 -45
- package/dist/forms/internal/usePickerValue.js.map +0 -7
- package/dist/forms/internal/useRovingFocus.d.ts +0 -47
- package/dist/forms/internal/useRovingFocus.js +0 -179
- package/dist/forms/internal/useRovingFocus.js.map +0 -7
- package/dist/forms/rich-text/RichText.d.ts +0 -7
- package/dist/forms/rich-text/RichText.js +0 -91
- package/dist/forms/rich-text/RichText.js.map +0 -7
- package/dist/forms/rich-text/RichTextEditor.d.ts +0 -9
- package/dist/forms/rich-text/RichTextEditor.js +0 -225
- package/dist/forms/rich-text/RichTextEditor.js.map +0 -7
- package/dist/forms/rich-text/extensions.d.ts +0 -10
- package/dist/forms/rich-text/extensions.js +0 -45
- package/dist/forms/rich-text/extensions.js.map +0 -7
- package/dist/forms/rich-text/internal/Listbox.d.ts +0 -10
- package/dist/forms/rich-text/internal/Listbox.js +0 -48
- package/dist/forms/rich-text/internal/Listbox.js.map +0 -7
- package/dist/forms/rich-text/internal/Reference.d.ts +0 -13
- package/dist/forms/rich-text/internal/Reference.js +0 -79
- package/dist/forms/rich-text/internal/Reference.js.map +0 -7
- package/dist/forms/rich-text/internal/commands.d.ts +0 -6
- package/dist/forms/rich-text/internal/commands.js +0 -74
- package/dist/forms/rich-text/internal/commands.js.map +0 -7
- package/dist/forms/rich-text/internal/readOnlyCheckbox.d.ts +0 -6
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js +0 -9
- package/dist/forms/rich-text/internal/readOnlyCheckbox.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceAttributes.d.ts +0 -3
- package/dist/forms/rich-text/internal/referenceAttributes.js +0 -23
- package/dist/forms/rich-text/internal/referenceAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/referenceExtension.d.ts +0 -2
- package/dist/forms/rich-text/internal/referenceExtension.js +0 -103
- package/dist/forms/rich-text/internal/referenceExtension.js.map +0 -7
- package/dist/forms/rich-text/internal/suggestions.d.ts +0 -16
- package/dist/forms/rich-text/internal/suggestions.js +0 -185
- package/dist/forms/rich-text/internal/suggestions.js.map +0 -7
- package/dist/forms/rich-text/internal/taskItem.d.ts +0 -1
- package/dist/forms/rich-text/internal/taskItem.js +0 -43
- package/dist/forms/rich-text/internal/taskItem.js.map +0 -7
- package/dist/forms/rich-text/internal/useDocumentAttributes.d.ts +0 -13
- package/dist/forms/rich-text/internal/useDocumentAttributes.js +0 -42
- package/dist/forms/rich-text/internal/useDocumentAttributes.js.map +0 -7
- package/dist/forms/rich-text/internal/useLinksAndUploads.d.ts +0 -19
- package/dist/forms/rich-text/internal/useLinksAndUploads.js +0 -141
- package/dist/forms/rich-text/internal/useLinksAndUploads.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextDocument.d.ts +0 -26
- package/dist/forms/rich-text/internal/useRichTextDocument.js +0 -101
- package/dist/forms/rich-text/internal/useRichTextDocument.js.map +0 -7
- package/dist/forms/rich-text/internal/useRichTextExtensions.d.ts +0 -13
- package/dist/forms/rich-text/internal/useRichTextExtensions.js +0 -85
- package/dist/forms/rich-text/internal/useRichTextExtensions.js.map +0 -7
- package/dist/forms/rich-text/types.d.ts +0 -190
- package/dist/forms/rich-text/types.js +0 -1
- package/dist/foundations/SkeletonScope.js.map +0 -7
- package/dist/foundations/ThemePreference.d.ts +0 -35
- package/dist/foundations/ThemePreference.js.map +0 -7
- package/dist/foundations/internal/skeletonText.js.map +0 -7
- package/dist/foundations/messages/calendarHeatmap.d.ts +0 -10
- package/dist/foundations/messages/calendarHeatmap.js +0 -10
- package/dist/foundations/messages/calendarHeatmap.js.map +0 -7
- package/dist/foundations/messages/diffStat.d.ts +0 -16
- package/dist/foundations/messages/diffStat.js +0 -17
- package/dist/foundations/messages/diffStat.js.map +0 -7
- package/dist/foundations/messages/editor.d.ts +0 -35
- package/dist/foundations/messages/editor.js +0 -34
- package/dist/foundations/messages/editor.js.map +0 -7
- package/dist/foundations/messages/linkDialog.d.ts +0 -20
- package/dist/foundations/messages/linkDialog.js +0 -20
- package/dist/foundations/messages/linkDialog.js.map +0 -7
- package/dist/foundations/messages/markdownEditor.d.ts +0 -26
- package/dist/foundations/messages/markdownEditor.js +0 -26
- package/dist/foundations/messages/markdownEditor.js.map +0 -7
- package/dist/foundations/messages/rating.d.ts +0 -11
- package/dist/foundations/messages/rating.js +0 -8
- package/dist/foundations/messages/rating.js.map +0 -7
- package/dist/foundations/messages/richText.d.ts +0 -34
- package/dist/foundations/messages/richText.js +0 -34
- package/dist/foundations/messages/richText.js.map +0 -7
- package/dist/internal/dialog/DialogParts.d.ts +0 -46
- package/dist/internal/dialog/DialogParts.js +0 -66
- package/dist/internal/dialog/DialogParts.js.map +0 -7
- package/dist/internal/dom/paints.d.ts +0 -5
- package/dist/internal/dom/paints.js +0 -17
- package/dist/internal/dom/paints.js.map +0 -7
- package/dist/internal/dom/useStripWheel.d.ts +0 -6
- package/dist/internal/dom/useStripWheel.js +0 -26
- package/dist/internal/dom/useStripWheel.js.map +0 -7
- package/dist/internal/editor/EditorStatus.d.ts +0 -8
- package/dist/internal/editor/EditorStatus.js +0 -11
- package/dist/internal/editor/EditorStatus.js.map +0 -7
- package/dist/internal/editor/EditorToolbar.d.ts +0 -28
- package/dist/internal/editor/EditorToolbar.js +0 -89
- package/dist/internal/editor/EditorToolbar.js.map +0 -7
- package/dist/internal/editor/LinkDialog.d.ts +0 -20
- package/dist/internal/editor/LinkDialog.js +0 -78
- package/dist/internal/editor/LinkDialog.js.map +0 -7
- package/dist/internal/editor/editorCommands.d.ts +0 -20
- package/dist/internal/editor/editorCommands.js +0 -45
- package/dist/internal/editor/editorCommands.js.map +0 -7
- package/dist/internal/field/TextareaResizeEdge.js.map +0 -7
- package/dist/internal/field/rowControl.js.map +0 -7
- package/dist/internal/field/useFieldMetadata.d.ts +0 -16
- package/dist/internal/field/useFieldMetadata.js +0 -24
- package/dist/internal/field/useFieldMetadata.js.map +0 -7
- package/dist/internal/list/ListRow.d.ts +0 -33
- package/dist/internal/list/ListRow.js.map +0 -7
- package/dist/internal/popup/PortalContainerContext.js.map +0 -7
- package/dist/internal/react/useStackedReport.js +0 -28
- package/dist/internal/react/useStackedReport.js.map +0 -7
- package/dist/internal/skeleton.js.map +0 -7
- package/dist/internal/time/calendarDays.js.map +0 -7
- package/dist/layout/internal/navigationForms.js.map +0 -7
- package/dist/layout/internal/scrollKeys.js.map +0 -7
- package/dist/layout/internal/useNavigationFocusHandoff.js.map +0 -7
- package/dist/layout/internal/useScrollKeys.js.map +0 -7
- package/dist/layout/panesSize.d.ts +0 -13
- package/dist/layout/panesSize.js +0 -39
- package/dist/layout/panesSize.js.map +0 -7
- package/dist/navigation/internal/TreeRow.js.map +0 -7
- package/dist/navigation/internal/contentsOutline.d.ts +0 -60
- package/dist/navigation/internal/contentsOutline.js.map +0 -7
- package/dist/navigation/internal/contentsWave.js.map +0 -7
- package/dist/navigation/internal/sectionScroll.js.map +0 -7
- package/dist/navigation/internal/tabStrip.d.ts +0 -6
- package/dist/navigation/internal/tabStrip.js +0 -24
- package/dist/navigation/internal/tabStrip.js.map +0 -7
- package/dist/navigation/internal/treeModel.js.map +0 -7
- package/dist/navigation/internal/useContentsHeadings.js.map +0 -7
- package/dist/navigation/internal/useTabCloseFocus.js.map +0 -7
- package/dist/navigation/internal/useTabDrag.js.map +0 -7
- package/dist/navigation/internal/useTabStripScrolling.js.map +0 -7
- package/dist/navigation/internal/useTreeTransitions.js.map +0 -7
- package/dist/navigation/internal/useTreeViewport.js.map +0 -7
- package/dist/navigation/internal/waveDrawer.js.map +0 -7
- package/dist/overlays/internal/DialogPendingAction.js.map +0 -7
- package/dist/rich-text.d.ts +0 -5
- package/dist/rich-text.js +0 -9
- package/dist/rich-text.js.map +0 -7
- package/dist/styles/CalendarHeatmap.css +0 -1
- package/dist/styles/Editor.css +0 -1
- package/dist/styles/Listbox.css +0 -1
- package/dist/styles/MarkdownEditor.css +0 -1
- package/dist/styles/Rating.css +0 -1
- package/dist/styles/RichText.css +0 -1
- package/docs/components/animated-number.md +0 -72
- package/docs/components/calendar-heatmap.md +0 -140
- package/docs/components/rating.md +0 -84
- package/docs/components/rich-text.md +0 -224
- package/docs/dev-mode.md +0 -59
- package/docs/examples/animated-number/AnimatedNumberAnatomy.tsx +0 -9
- package/docs/examples/animated-number/CustomFormat.tsx +0 -28
- package/docs/examples/animated-number/ShowResults.tsx +0 -38
- package/docs/examples/badge/ChangeSize.tsx +0 -21
- package/docs/examples/calendar-heatmap/ApplicationStrings.tsx +0 -23
- package/docs/examples/calendar-heatmap/ColorByRank.tsx +0 -26
- package/docs/examples/calendar-heatmap/CustomTooltip.tsx +0 -26
- package/docs/examples/calendar-heatmap/Deployments.tsx +0 -22
- package/docs/examples/calendar-heatmap/HeatmapAnatomy.tsx +0 -10
- package/docs/examples/calendar-heatmap/ScrollingWeeks.tsx +0 -10
- package/docs/examples/markdown/LinkPicker.tsx +0 -65
- package/docs/examples/markdown/MarkdownEditorAnatomy.tsx +0 -13
- package/docs/examples/markdown/WriteNote.tsx +0 -21
- package/docs/examples/panes/ListAndDetail.tsx +0 -55
- package/docs/examples/rating/RatingAnatomy.tsx +0 -5
- package/docs/examples/rating/ReviewScore.tsx +0 -13
- package/docs/examples/rating/Scales.tsx +0 -11
- package/docs/examples/resize-handle/ProjectSidebar.tsx +0 -40
- package/docs/examples/rich-text/MeetingNotes.tsx +0 -14
- package/docs/examples/rich-text/References.tsx +0 -47
- package/docs/examples/rich-text/RichTextAnatomy.tsx +0 -18
- package/docs/examples/rich-text/SavedContent.tsx +0 -33
- package/docs/examples/rich-text/SlashCommands.tsx +0 -24
- package/docs/examples/rich-text/UploadsAndLinks.tsx +0 -36
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js +0 -0
- /package/dist/actions/{internal → menu/internal}/menuOpenChange.js.map +0 -0
- /package/dist/{forms/rich-text/types.js.map → actions/menu/internal/menuTriggerProps.js.map} +0 -0
- /package/dist/forms/color/internal/{colorChange.d.ts → ColorChangeContext.d.ts} +0 -0
- /package/dist/internal/{useCopy.d.ts → react/useCopy.d.ts} +0 -0
- /package/dist/internal/{useCopy.js → react/useCopy.js} +0 -0
- /package/dist/internal/{useLatest.d.ts → react/useLatest.d.ts} +0 -0
- /package/dist/internal/{useLatest.js → react/useLatest.js} +0 -0
- /package/dist/{foundations/internal → internal/skeleton}/skeletonText.d.ts +0 -0
- /package/dist/layout/internal/{navigationForms.js → scaffold/navigationForms.js} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.d.ts → scaffold/scaffoldFocus.d.ts} +0 -0
- /package/dist/layout/internal/{scaffoldFocus.js → scaffold/scaffoldFocus.js} +0 -0
- /package/dist/layout/internal/{scrollKeys.d.ts → scaffold/scrollKeys.d.ts} +0 -0
- /package/dist/layout/internal/{useNavigationFocusHandoff.d.ts → scaffold/useNavigationFocusHandoff.d.ts} +0 -0
- /package/dist/layout/internal/{useScrollKeys.d.ts → scaffold/useScrollKeys.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabCloseFocus.d.ts → documentTabs/useTabCloseFocus.d.ts} +0 -0
- /package/dist/navigation/internal/{useTabStripScrolling.d.ts → documentTabs/useTabStripScrolling.d.ts} +0 -0
- /package/dist/navigation/internal/{contentsWave.d.ts → tableOfContents/contentsWave.d.ts} +0 -0
- /package/dist/navigation/internal/{waveDrawer.d.ts → tableOfContents/waveDrawer.d.ts} +0 -0
- /package/dist/navigation/internal/{useTreeTransitions.js → tree/useTreeTransitions.js} +0 -0
- /package/dist/styles/{TextareaResizeEdge.css → TextareaResizeHandle.css} +0 -0
package/dist/layout/Card.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/Card.tsx"],
|
|
4
|
-
"sourcesContent": ["import type {\n ComponentPropsWithRef,\n CSSProperties,\n MouseEventHandler,\n ReactElement,\n ReactNode,\n} from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { Text } from '../foundations/Text.js';\nimport { Column, Row, type SpaceStep } from './Layout.js';\nimport { Surface } from './Surface.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { given, type SkeletonProps } from '../internal/skeleton.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/Card.css';\n\n/**\n * A card's fill: muted, the standalone card fill; default, a quieter fill that groups content, as a\n * pane's; or page, the page's own color.\n */\nexport type CardBackground = 'muted' | 'default' | 'page';\n\ninterface CardSurfaceProps extends SkeletonProps {\n /**\n * The fill: muted, the standalone card fill; default, a quieter fill that groups content, such as\n * a section of a settings page; or page, the page's own color, for a card inside a pane.\n * @default 'muted'\n */\n background?: CardBackground;\n /**\n * The inset on every side, as a step of the spacing scale, such as 6 for 2 rem; 0 removes it.\n * Without it, the inset follows the window's width.\n * @default 1.25 rem in narrow windows, growing to 1.5 rem from 50 rem wide\n */\n padding?: SpaceStep;\n /** The card's class, beside env-card. */\n className?: string;\n /** Styles of the card. */\n style?: CSSProperties;\n}\n\n/** What only a content card takes; an interactive card is one link or button. */\ninterface CardContentOptions {\n /**\n * The card's title at the top: an `h3` in the title type. headingLevel sets another level. Given\n * as undefined, such as over a placeholder item, a skeleton shows a bar in its place.\n */\n title?: ReactNode;\n /**\n * The title's heading level, for the page's outline; the type stays the title type.\n * @default 3\n */\n headingLevel?: HeadingLevel;\n /** A short fact at the end of the title row, such as when the card was updated. */\n meta?: ReactNode;\n /** A sentence under the title, in muted text. */\n description?: ReactNode;\n /**\n * The card's controls, such as Buttons, in a strip along the bottom of the card, at its end and\n * wrapping onto more lines where they don't fit.\n */\n actions?: ReactNode;\n /**\n * The element for the card's meaning, such as render={<article />} or render={<section />}. A\n * div by default.\n */\n render?: ReactElement;\n}\n\ntype NoContentOptions = { [Key in keyof CardContentOptions]?: never };\n\n
|
|
5
|
-
"mappings": "
|
|
4
|
+
"sourcesContent": ["import type {\n ComponentPropsWithRef,\n CSSProperties,\n MouseEventHandler,\n ReactElement,\n ReactNode,\n} from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { Text } from '../foundations/Text.js';\nimport { Column, Row, type SpaceStep } from './Layout.js';\nimport { Surface } from './Surface.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ActionElement } from '../internal/control/ActionElement.js';\nimport { given, type SkeletonProps } from '../internal/skeleton/skeleton.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport { rendersContent } from '../internal/react/rendersContent.js';\nimport '../styles/Base.css';\nimport '../styles/Card.css';\n\n/**\n * A card's fill: muted, the standalone card fill; default, a quieter fill that groups content, as a\n * pane's; or page, the page's own color.\n */\nexport type CardBackground = 'muted' | 'default' | 'page';\n\ninterface CardSurfaceProps extends SkeletonProps {\n /**\n * The fill: muted, the standalone card fill; default, a quieter fill that groups content, such as\n * a section of a settings page; or page, the page's own color, for a card inside a pane.\n * @default 'muted'\n */\n background?: CardBackground;\n /**\n * The inset on every side, as a step of the spacing scale, such as 6 for 2 rem; 0 removes it.\n * Without it, the inset follows the window's width.\n * @default 1.25 rem in narrow windows, growing to 1.5 rem from 50 rem wide\n */\n padding?: SpaceStep;\n /** The card's class, beside env-card. */\n className?: string;\n /** Styles of the card. */\n style?: CSSProperties;\n}\n\n/** What only a content card takes; an interactive card is one link or button. */\ninterface CardContentOptions {\n /**\n * The card's title at the top: an `h3` in the title type. headingLevel sets another level. Given\n * as undefined, such as over a placeholder item, a skeleton shows a bar in its place.\n */\n title?: ReactNode;\n /**\n * The title's heading level, for the page's outline; the type stays the title type.\n * @default 3\n */\n headingLevel?: HeadingLevel;\n /** A short fact at the end of the title row, such as when the card was updated. */\n meta?: ReactNode;\n /**\n * Content at the end of the title row, after the meta, such as an overflow Menu or an Edit\n * Button, placed as given.\n */\n headerEnd?: ReactNode;\n /** A sentence under the title, in muted text. */\n description?: ReactNode;\n /**\n * The card's controls, such as Buttons, in a strip along the bottom of the card, at its end and\n * wrapping onto more lines where they don't fit. For controls beside the title, use headerEnd.\n */\n actions?: ReactNode;\n /**\n * The card opens something through a link or button inside, such as its title: it reacts to\n * hover, keyboard focus on that target and presses. Mark the link or button `data-row-target` to\n * stretch it over the card; the other links, buttons and fields in the card, such as an author's\n * link in the description or a Menu in headerEnd, stay clickable above it.\n * @default false\n */\n interactive?: boolean;\n /**\n * The element for the card's meaning, such as render={<article />} or render={<section />}. A\n * div by default.\n */\n render?: ReactElement;\n}\n\ntype NoContentOptions = { [Key in keyof CardContentOptions]?: never };\n\n/**\n * A content card: a div, or the element of render, with an optional title row and actions; with\n * interactive, a link or button inside marked data-row-target takes the card's click.\n */\nexport type CardContentProps = CardSurfaceProps &\n CardContentOptions &\n Omit<ComponentPropsWithRef<'div'>, keyof CardSurfaceProps | 'title' | 'onClick'> & {\n href?: undefined;\n onClick?: undefined;\n };\n\n/** A link card: the whole card is one native link, through the LinkProvider. */\nexport type CardLinkProps = CardSurfaceProps &\n NoContentOptions &\n Omit<ComponentPropsWithRef<'a'>, keyof CardSurfaceProps> & {\n /** The destination: the whole card is one native link, through the LinkProvider. */\n href: string;\n /**\n * A disabled link card has no destination, cannot be focused and reports aria-disabled; a\n * disabled button card cannot be pressed.\n * @default false\n */\n disabled?: boolean;\n };\n\n/** A button card: the whole card is one native button that starts an action. */\nexport type CardButtonProps = CardSurfaceProps &\n NoContentOptions &\n Omit<ComponentPropsWithRef<'button'>, keyof CardSurfaceProps | 'onClick'> & {\n href?: undefined;\n /** Runs when the card is pressed: the whole card is one native button. */\n onClick: MouseEventHandler<HTMLButtonElement>;\n };\n\n/**\n * A content card (the default), a link card with href, or a button card with onClick. A link or\n * button card holds its content alone: no title or actions. A content card that opens one place\n * and keeps a title, meta and actions takes interactive and a data-row-target link instead.\n */\nexport type CardProps = CardContentProps | CardLinkProps | CardButtonProps;\n\n/**\n * A rounded surface that groups content about one subject: a content card with an optional\n * title row and actions, or one link or button.\n */\nexport function Card(props: CardProps) {\n if (props.href !== undefined || props.onClick !== undefined)\n return <InteractiveCard {...props} />;\n return <ContentCard {...props} />;\n}\n\nfunction InteractiveCard({\n background = 'muted',\n padding,\n skeleton,\n className,\n style,\n children,\n ...props\n}: CardLinkProps | CardButtonProps) {\n return (\n <Surface\n background={background}\n padding={padding}\n skeleton={skeleton}\n render={\n <Column\n gap={4}\n render={<ActionElement {...props} />}\n className={classNames('env-card', className)}\n style={style}\n data-interactive=\"\"\n />\n }\n >\n {children}\n </Surface>\n );\n}\n\nfunction ContentCard(allProps: CardContentProps) {\n const slots = {\n title: given(allProps, 'title'),\n meta: given(allProps, 'meta'),\n description: given(allProps, 'description'),\n };\n return <ContentCardLayout {...allProps} slots={slots} />;\n}\n\nfunction ContentCardLayout({\n slots,\n background = 'muted',\n padding,\n skeleton,\n title,\n headingLevel,\n meta,\n headerEnd,\n description,\n actions,\n interactive = false,\n render,\n className,\n style,\n children,\n ...props\n}: CardContentProps & { slots: Record<'title' | 'meta' | 'description', boolean> }) {\n const hasTitle = title != null || slots.title;\n const hasMeta = meta != null || slots.meta;\n const hasEnd = headerEnd != null;\n const hasActions = rendersContent(actions);\n const level = headingLevel ?? 3;\n const Heading = `h${level}` as const;\n const headingText = hasTitle && (\n <Text render={<Heading />} variant=\"title\" className=\"env-card-title\">\n {title}\n </Text>\n );\n const header = (hasTitle || hasMeta || hasEnd) && (\n <Row wrap align=\"center\" gap={3} className=\"env-card-header\">\n {headingText}\n {hasMeta && (\n <Text render={<span />} variant=\"body-sm\" className=\"env-card-meta\">\n {meta}\n </Text>\n )}\n {hasEnd && (\n <Slot className=\"env-card-header-end\" layout=\"row\" shrink=\"never\">\n {headerEnd}\n </Slot>\n )}\n </Row>\n );\n const descriptionText = (description != null || slots.description) && (\n <Text render={<div />} variant=\"body\" emphasis=\"muted\" className=\"env-card-description\">\n {description}\n </Text>\n );\n let content: ReactNode;\n if (hasActions) {\n content = (\n <>\n <Column gap={4} className=\"env-card-body\">\n {header}\n {descriptionText}\n {children}\n </Column>\n <footer className=\"env-card-footer\">\n <Slot className=\"env-card-actions\" layout=\"row\">\n {actions}\n </Slot>\n </footer>\n </>\n );\n } else {\n content = (\n <>\n {header}\n {descriptionText}\n {children}\n </>\n );\n }\n return (\n <Surface\n background={background}\n padding={padding}\n skeleton={skeleton}\n render={\n <Column\n {...props}\n render={render}\n gap={hasActions ? 0 : 4}\n className={classNames('env-card', className)}\n style={style}\n data-actions={flag(hasActions)}\n data-interactive={flag(interactive)}\n />\n }\n >\n {content}\n </Surface>\n );\n}\n"],
|
|
5
|
+
"mappings": "AAuIW,SA8FL,UA9FK,KAwEP,YAxEO;AAhIX,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AACrB,SAAS,QAAQ,WAA2B;AAC5C,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAC9B,SAAS,aAAiC;AAE1C,SAAS,YAAY;AACrB,SAAS,sBAAsB;AAC/B,OAAO;AACP,OAAO;AAmHA,SAAS,KAAK,OAAkB;AACrC,MAAI,MAAM,SAAS,UAAa,MAAM,YAAY;AAChD,WAAO,oBAAC,mBAAiB,GAAG,OAAO;AACrC,SAAO,oBAAC,eAAa,GAAG,OAAO;AACjC;AAEA,SAAS,gBAAgB;AAAA,EACvB,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoC;AAClC,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA,QACE;AAAA,QAAC;AAAA;AAAA,UACC,KAAK;AAAA,UACL,QAAQ,oBAAC,iBAAe,GAAG,OAAO;AAAA,UAClC,WAAW,WAAW,YAAY,SAAS;AAAA,UAC3C;AAAA,UACA,oBAAiB;AAAA;AAAA,MACnB;AAAA,MAGD;AAAA;AAAA,EACH;AAEJ;AAEA,SAAS,YAAY,UAA4B;AAC/C,QAAM,QAAQ;AAAA,IACZ,OAAO,MAAM,UAAU,OAAO;AAAA,IAC9B,MAAM,MAAM,UAAU,MAAM;AAAA,IAC5B,aAAa,MAAM,UAAU,aAAa;AAAA,EAC5C;AACA,SAAO,oBAAC,qBAAmB,GAAG,UAAU,OAAc;AACxD;AAEA,SAAS,kBAAkB;AAAA,EACzB;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoF;AAClF,QAAM,WAAW,SAAS,QAAQ,MAAM;AACxC,QAAM,UAAU,QAAQ,QAAQ,MAAM;AACtC,QAAM,SAAS,aAAa;AAC5B,QAAM,aAAa,eAAe,OAAO;AACzC,QAAM,QAAQ,gBAAgB;AAC9B,QAAM,UAAU,IAAI,KAAK;AACzB,QAAM,cAAc,YAClB,oBAAC,QAAK,QAAQ,oBAAC,WAAQ,GAAI,SAAQ,SAAQ,WAAU,kBAClD,iBACH;AAEF,QAAM,UAAU,YAAY,WAAW,WACrC,qBAAC,OAAI,MAAI,MAAC,OAAM,UAAS,KAAK,GAAG,WAAU,mBACxC;AAAA;AAAA,IACA,WACC,oBAAC,QAAK,QAAQ,oBAAC,UAAK,GAAI,SAAQ,WAAU,WAAU,iBACjD,gBACH;AAAA,IAED,UACC,oBAAC,QAAK,WAAU,uBAAsB,QAAO,OAAM,QAAO,SACvD,qBACH;AAAA,KAEJ;AAEF,QAAM,mBAAmB,eAAe,QAAQ,MAAM,gBACpD,oBAAC,QAAK,QAAQ,oBAAC,SAAI,GAAI,SAAQ,QAAO,UAAS,SAAQ,WAAU,wBAC9D,uBACH;AAEF,MAAI;AACJ,MAAI,YAAY;AACd,cACE,iCACE;AAAA,2BAAC,UAAO,KAAK,GAAG,WAAU,iBACvB;AAAA;AAAA,QACA;AAAA,QACA;AAAA,SACH;AAAA,MACA,oBAAC,YAAO,WAAU,mBAChB,8BAAC,QAAK,WAAU,oBAAmB,QAAO,OACvC,mBACH,GACF;AAAA,OACF;AAAA,EAEJ,OAAO;AACL,cACE,iCACG;AAAA;AAAA,MACA;AAAA,MACA;AAAA,OACH;AAAA,EAEJ;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA,QACE;AAAA,QAAC;AAAA;AAAA,UACE,GAAG;AAAA,UACJ;AAAA,UACA,KAAK,aAAa,IAAI;AAAA,UACtB,WAAW,WAAW,YAAY,SAAS;AAAA,UAC3C;AAAA,UACA,gBAAc,KAAK,UAAU;AAAA,UAC7B,oBAAkB,KAAK,WAAW;AAAA;AAAA,MACpC;AAAA,MAGD;AAAA;AAAA,EACH;AAEJ;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/layout/Layout.d.ts
CHANGED
|
@@ -39,8 +39,8 @@ type PrimitiveOptions<RenderedElement extends HTMLElement> = {
|
|
|
39
39
|
*/
|
|
40
40
|
ref?: Ref<RenderedElement>;
|
|
41
41
|
/**
|
|
42
|
-
* A name for this node, such as "filters" or "summary",
|
|
43
|
-
* renders as `data-env-name`. A component's part class names its node instead.
|
|
42
|
+
* A name for this node, such as "filters" or "summary", for the application's styles and tests
|
|
43
|
+
* to find it by; it renders as `data-env-name`. A component's part class names its node instead.
|
|
44
44
|
*/
|
|
45
45
|
name?: string;
|
|
46
46
|
/**
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/Layout.tsx"],
|
|
4
|
-
"sourcesContent": ["import type { ComponentPropsWithRef, ReactElement, Ref } from 'react';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport { flag } from '../internal/flag.js';\nimport { primitiveAttributes, rowAttributes } from '../internal/layout/primitiveAttributes.js';\nimport '../styles/Base.css';\nimport '../styles/Layout.css';\n\n/**\n * A step in the shared spacing scale: 1 is 0.25 rem, 2 is 0.5 rem, 3 is 0.75 rem, 4 is 1 rem, 5 is\n * 1.5 rem, 6 is 2 rem, 7 is 2.5 rem, 8 is 3 rem and 9 is 4 rem, smaller at the compact scale; 0 is\n * none.\n */\nexport type SpaceStep = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\n/**\n * How children line up across a Row or Column, or in their cells of a Grid: stretch, as wide as a\n * column or as tall as a row, except controls such as buttons, which keep their own size; start,\n * center and end keep each child at its own size, at that side or in the middle.\n */\nexport type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';\n\n/**\n * Where children sit along a Row or Column when there is room to spare: at the start, in the\n * center, at the end, or between, spread out with the first and last at the edges.\n */\nexport type LayoutJustify = 'start' | 'center' | 'end' | 'between';\n\n/**\n * A Grid's columns: a number of equal columns; a `grid-template-columns` template, such as\n * `'minmax(0, 2fr) minmax(0, 1fr)'`; or `{ min: '12rem' }`, as many equal columns as fit at that\n * width or wider, also when fewer items than that fill them (auto-fill), so items keep one width.\n */\nexport type GridColumns = number | string | { min: `${number}rem` };\n\n/** What every primitive takes: its element, its ref, a name and its padding. */\ntype PrimitiveOptions<RenderedElement extends HTMLElement> = {\n /**\n * The element to render, for its meaning, such as render={<section />} or render={<ul />}, or\n * another component to lay out without a wrapper, such as a Surface: the primitive's attributes\n * merge into its props. It must forward native props and refs. A div by default.\n */\n render?: ReactElement;\n /**\n * The rendered element, a div by default. Its type is the element type parameter, which a ref\n * passed in sets: a ref to the element that render makes, such as useRef<HTMLElement>(null) with\n * render={<section />}, type-checks.\n */\n ref?: Ref<RenderedElement>;\n /**\n * A name for this node, such as \"filters\" or \"summary\",
|
|
4
|
+
"sourcesContent": ["import type { ComponentPropsWithRef, ReactElement, Ref } from 'react';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport { flag } from '../internal/flag.js';\nimport { primitiveAttributes, rowAttributes } from '../internal/layout/primitiveAttributes.js';\nimport '../styles/Base.css';\nimport '../styles/Layout.css';\n\n/**\n * A step in the shared spacing scale: 1 is 0.25 rem, 2 is 0.5 rem, 3 is 0.75 rem, 4 is 1 rem, 5 is\n * 1.5 rem, 6 is 2 rem, 7 is 2.5 rem, 8 is 3 rem and 9 is 4 rem, smaller at the compact scale; 0 is\n * none.\n */\nexport type SpaceStep = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;\n\n/**\n * How children line up across a Row or Column, or in their cells of a Grid: stretch, as wide as a\n * column or as tall as a row, except controls such as buttons, which keep their own size; start,\n * center and end keep each child at its own size, at that side or in the middle.\n */\nexport type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';\n\n/**\n * Where children sit along a Row or Column when there is room to spare: at the start, in the\n * center, at the end, or between, spread out with the first and last at the edges.\n */\nexport type LayoutJustify = 'start' | 'center' | 'end' | 'between';\n\n/**\n * A Grid's columns: a number of equal columns; a `grid-template-columns` template, such as\n * `'minmax(0, 2fr) minmax(0, 1fr)'`; or `{ min: '12rem' }`, as many equal columns as fit at that\n * width or wider, also when fewer items than that fill them (auto-fill), so items keep one width.\n */\nexport type GridColumns = number | string | { min: `${number}rem` };\n\n/** What every primitive takes: its element, its ref, a name and its padding. */\ntype PrimitiveOptions<RenderedElement extends HTMLElement> = {\n /**\n * The element to render, for its meaning, such as render={<section />} or render={<ul />}, or\n * another component to lay out without a wrapper, such as a Surface: the primitive's attributes\n * merge into its props. It must forward native props and refs. A div by default.\n */\n render?: ReactElement;\n /**\n * The rendered element, a div by default. Its type is the element type parameter, which a ref\n * passed in sets: a ref to the element that render makes, such as useRef<HTMLElement>(null) with\n * render={<section />}, type-checks.\n */\n ref?: Ref<RenderedElement>;\n /**\n * A name for this node, such as \"filters\" or \"summary\", for the application's styles and tests\n * to find it by; it renders as `data-env-name`. A component's part class names its node instead.\n */\n name?: string;\n /**\n * Makes the element a size container of this name, for container queries on its inline size,\n * such as container=\"filters\" for `@container filters (width >= 37.5rem)`. A container is as\n * wide as its context gives it, never as its content. container=\"env-window\" makes the element\n * a window of its own on purpose, such as a preview frame, whose content lays out at its window\n * class; other `env-*` names are envUI's own.\n */\n container?: string;\n /** The inset on every side, a step of the spacing scale. None by default. */\n padding?: SpaceStep;\n};\n\ntype NativeProps<Own> = Omit<ComponentPropsWithRef<'div'>, keyof Own | 'ref'>;\n\nexport type BoxProps<RenderedElement extends HTMLElement = HTMLDivElement> =\n PrimitiveOptions<RenderedElement> & NativeProps<PrimitiveOptions<RenderedElement>>;\n\ninterface LineOptions {\n /** The space between the direct children, a step of the spacing scale. None by default. */\n gap?: SpaceStep;\n /**\n * How the children line up across the line: stretch, the default, makes each as wide as a\n * column or as tall as a row, except controls such as buttons, which keep their own size; start,\n * center and end keep every child at its own size.\n * @default 'stretch'\n */\n align?: LayoutAlign;\n /**\n * Where the children sit along the line when there is room to spare: at the start, in the\n * center, at the end, such as a form's actions, or between, spread out to the edges.\n * @default 'start'\n */\n justify?: LayoutJustify;\n}\n\ninterface RowOptions extends LineOptions {\n /**\n * Lets the row run onto more lines when its children don't fit, as a row of actions does.\n * @default false\n */\n wrap?: boolean;\n}\n\nexport type RowProps<RenderedElement extends HTMLElement = HTMLDivElement> = RowOptions &\n PrimitiveOptions<RenderedElement> &\n NativeProps<RowOptions & PrimitiveOptions<RenderedElement>>;\n\nexport type ColumnProps<RenderedElement extends HTMLElement = HTMLDivElement> = LineOptions &\n PrimitiveOptions<RenderedElement> &\n NativeProps<LineOptions & PrimitiveOptions<RenderedElement>>;\n\ninterface GridOptions {\n /**\n * The columns: a number of equal columns, a `grid-template-columns` template, such as\n * `'minmax(0, 2fr) minmax(0, 1fr)'`, or `{ min: '12rem' }`, as many equal columns as fit at that\n * width or wider, with empty columns where items run out, so every item keeps one width. One\n * column by default.\n */\n columns?: GridColumns;\n /** The space between rows and columns, a step of the spacing scale. None by default. */\n gap?: SpaceStep;\n /**\n * How each child lines up in its cell's height: stretch, the default, fills the row; start,\n * center and end keep it at its own height.\n * @default 'stretch'\n */\n align?: LayoutAlign;\n}\n\nexport type GridProps<RenderedElement extends HTMLElement = HTMLDivElement> = GridOptions &\n PrimitiveOptions<RenderedElement> &\n NativeProps<GridOptions & PrimitiveOptions<RenderedElement>>;\n\n/**\n * A plain block for what needs no row or column of its own: an inset (`padding`), a size container\n * (`container`) or a named node. It sizes to its content and never paints.\n */\nexport function Box<RenderedElement extends HTMLElement = HTMLDivElement>({\n render,\n ...props\n}: BoxProps<RenderedElement>) {\n return renderElement('div', render, primitiveAttributes('box', props));\n}\n\n/**\n * Lays its direct children out side by side, `gap` apart, with `wrap` to run onto more lines,\n * such as a form's actions. A flex row that sizes to its content and never paints.\n */\nexport function Row<RenderedElement extends HTMLElement = HTMLDivElement>({\n render,\n ...props\n}: RowProps<RenderedElement>) {\n return renderElement('div', render, rowAttributes(props));\n}\n\n/**\n * Lays its direct children out one under another, `gap` apart, such as a form's fields. A flex\n * column that sizes to its content and never paints.\n */\nexport function Column<RenderedElement extends HTMLElement = HTMLDivElement>({\n render,\n ...props\n}: ColumnProps<RenderedElement>) {\n return renderElement('div', render, primitiveAttributes('column', props));\n}\n\nfunction gridTemplate(columns: GridColumns): string {\n if (typeof columns === 'number') return `repeat(${columns}, minmax(0, 1fr))`;\n if (typeof columns === 'string') return columns;\n return `repeat(auto-fill, minmax(min(100%, ${columns.min}), 1fr))`;\n}\n\n/**\n * Lays its direct children out in columns, `gap` apart: a number of equal columns, a template, or\n * as many as fit at a minimum width. A CSS grid that sizes to its content and never paints.\n */\nexport function Grid<RenderedElement extends HTMLElement = HTMLDivElement>({\n render,\n columns,\n ...props\n}: GridProps<RenderedElement>) {\n return renderElement(\n 'div',\n render,\n primitiveAttributes(\n 'grid',\n props,\n { 'data-columns': flag(columns !== undefined) },\n columns === undefined ? {} : { '--_grid-columns': gridTemplate(columns) },\n ),\n );\n}\n"],
|
|
5
5
|
"mappings": "AACA,SAAS,qBAAqB;AAC9B,SAAS,YAAY;AACrB,SAAS,qBAAqB,qBAAqB;AACnD,OAAO;AACP,OAAO;AA6HA,SAAS,IAA0D;AAAA,EACxE;AAAA,EACA,GAAG;AACL,GAA8B;AAC5B,SAAO,cAAc,OAAO,QAAQ,oBAAoB,OAAO,KAAK,CAAC;AACvE;AAMO,SAAS,IAA0D;AAAA,EACxE;AAAA,EACA,GAAG;AACL,GAA8B;AAC5B,SAAO,cAAc,OAAO,QAAQ,cAAc,KAAK,CAAC;AAC1D;AAMO,SAAS,OAA6D;AAAA,EAC3E;AAAA,EACA,GAAG;AACL,GAAiC;AAC/B,SAAO,cAAc,OAAO,QAAQ,oBAAoB,UAAU,KAAK,CAAC;AAC1E;AAEA,SAAS,aAAa,SAA8B;AAClD,MAAI,OAAO,YAAY,SAAU,QAAO,UAAU,OAAO;AACzD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,SAAO,sCAAsC,QAAQ,GAAG;AAC1D;AAMO,SAAS,KAA2D;AAAA,EACzE;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAA+B;AAC7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA,EAAE,gBAAgB,KAAK,YAAY,MAAS,EAAE;AAAA,MAC9C,YAAY,SAAY,CAAC,IAAI,EAAE,mBAAmB,aAAa,OAAO,EAAE;AAAA,IAC1E;AAAA,EACF;AACF;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/layout/Page.d.ts
CHANGED
|
@@ -19,8 +19,8 @@ export interface PageProps extends ComponentPropsWithRef<'div'> {
|
|
|
19
19
|
*/
|
|
20
20
|
gutter?: boolean;
|
|
21
21
|
/**
|
|
22
|
-
* A name for this node, such as "settings",
|
|
23
|
-
* `data-env-name`.
|
|
22
|
+
* A name for this node, such as "settings", for the application's styles and tests to find it by; it
|
|
23
|
+
* renders as `data-env-name`.
|
|
24
24
|
*/
|
|
25
25
|
name?: string;
|
|
26
26
|
/**
|
package/dist/layout/Page.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/Page.tsx"],
|
|
4
|
-
"sourcesContent": ["import type { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport '../styles/Base.css';\nimport '../styles/Page.css';\n\n/** A page column's width: sm 40 rem, md 60 rem, lg 76 rem, or full, the whole width. */\nexport type PageWidth = 'sm' | 'md' | 'lg' | 'full';\n\nexport interface PageProps extends ComponentPropsWithRef<'div'> {\n /**\n * How wide the content may grow, a readable width: sm (40 rem) for a form or a settings page, md\n * (60 rem) for a document or a detail page, lg (76 rem) for a dashboard or a list, full for\n * content that uses the whole width, such as a board. The column is centered in the space it has.\n * @default 'lg'\n */\n width?: PageWidth;\n /** The page's heading, usually a PageHeader, at the top of the same column. */\n header?: ReactNode;\n /**\n * Pads the column at its inline edges with the page gutter, which follows the window class of\n * the region the page sits in: 1 rem in a compact one, 1.5 rem from medium. False leaves the\n * edges to the content, such as a page that is one full-bleed table.\n * @default true\n */\n gutter?: boolean;\n /**\n * A name for this node, such as \"settings\",
|
|
4
|
+
"sourcesContent": ["import type { ComponentPropsWithRef, ReactElement, ReactNode } from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { renderElement } from '../internal/react/renderElement.js';\nimport '../styles/Base.css';\nimport '../styles/Page.css';\n\n/** A page column's width: sm 40 rem, md 60 rem, lg 76 rem, or full, the whole width. */\nexport type PageWidth = 'sm' | 'md' | 'lg' | 'full';\n\nexport interface PageProps extends ComponentPropsWithRef<'div'> {\n /**\n * How wide the content may grow, a readable width: sm (40 rem) for a form or a settings page, md\n * (60 rem) for a document or a detail page, lg (76 rem) for a dashboard or a list, full for\n * content that uses the whole width, such as a board. The column is centered in the space it has.\n * @default 'lg'\n */\n width?: PageWidth;\n /** The page's heading, usually a PageHeader, at the top of the same column. */\n header?: ReactNode;\n /**\n * Pads the column at its inline edges with the page gutter, which follows the window class of\n * the region the page sits in: 1 rem in a compact one, 1.5 rem from medium. False leaves the\n * edges to the content, such as a page that is one full-bleed table.\n * @default true\n */\n gutter?: boolean;\n /**\n * A name for this node, such as \"settings\", for the application's styles and tests to find it by; it\n * renders as `data-env-name`.\n */\n name?: string;\n /**\n * The element to render, for its meaning, such as render={<article />}; a div by default. The\n * page's class and attributes merge into its props.\n */\n render?: ReactElement;\n /** The page's content, under its header. */\n children?: ReactNode;\n}\n\n/**\n * The column a page's content sits in: invisible structure that never paints, centered, as wide\n * as `width` at most, with the page gutter at its edges and the page's header at its top. Its\n * gutters follow the window class of the region it sits in, such as a Scaffold's body or a pane,\n * and it is the env-page container for the content inside. It adds no landmark; put it in a\n * Scaffold's body, or the application's own main.\n */\nexport function Page({\n width = 'lg',\n header,\n gutter = true,\n name,\n render,\n className,\n children,\n ...props\n}: PageProps) {\n return renderElement('div', render, {\n ...props,\n className: classNames('env-page', className),\n 'data-env-layout': 'page',\n 'data-env-name': name,\n 'data-width': width,\n 'data-gutter': gutter ? undefined : 'none',\n children:\n header == null ? (\n children\n ) : (\n <>\n {header}\n <div className=\"env-page-content\">{children}</div>\n </>\n ),\n });\n}\n"],
|
|
5
5
|
"mappings": "AAoEQ,mBAEE,KAFF;AAnER,SAAS,kBAAkB;AAC3B,SAAS,qBAAqB;AAC9B,OAAO;AACP,OAAO;AA2CA,SAAS,KAAK;AAAA,EACnB,QAAQ;AAAA,EACR;AAAA,EACA,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAc;AACZ,SAAO,cAAc,OAAO,QAAQ;AAAA,IAClC,GAAG;AAAA,IACH,WAAW,WAAW,YAAY,SAAS;AAAA,IAC3C,mBAAmB;AAAA,IACnB,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe,SAAS,SAAY;AAAA,IACpC,UACE,UAAU,OACR,WAEA,iCACG;AAAA;AAAA,MACD,oBAAC,SAAI,WAAU,oBAAoB,UAAS;AAAA,OAC9C;AAAA,EAEN,CAAC;AACH;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -53,10 +53,15 @@ export interface PageHeaderProps extends Omit<ComponentPropsWithRef<'div'>, 'tit
|
|
|
53
53
|
* @default true
|
|
54
54
|
*/
|
|
55
55
|
focusOnNavigation?: boolean;
|
|
56
|
+
/**
|
|
57
|
+
* More rows under the toolbar, placed as given, such as a progress strip or an inline Alert. They
|
|
58
|
+
* stay in the header, so they stick with it.
|
|
59
|
+
*/
|
|
60
|
+
children?: ReactNode;
|
|
56
61
|
}
|
|
57
62
|
/**
|
|
58
63
|
* The heading of a page: its title with an optional trail above it, a description, leading content,
|
|
59
64
|
* meta beside the title, actions at the end and a toolbar row under it, built from Row and
|
|
60
65
|
* Column. It responds to its own width, and can stick to the top of the area that scrolls.
|
|
61
66
|
*/
|
|
62
|
-
export declare function PageHeader({ title, headingLevel, description, breadcrumbs, start, meta, actions, toolbar, sticky, controlSize, focusOnNavigation, className, ...props }: PageHeaderProps): import("react").JSX.Element;
|
|
67
|
+
export declare function PageHeader({ title, headingLevel, description, breadcrumbs, start, meta, actions, toolbar, sticky, controlSize, focusOnNavigation, className, children, ...props }: PageHeaderProps): import("react").JSX.Element;
|
|
@@ -22,6 +22,7 @@ function PageHeader({
|
|
|
22
22
|
controlSize = "md",
|
|
23
23
|
focusOnNavigation = true,
|
|
24
24
|
className,
|
|
25
|
+
children,
|
|
25
26
|
...props
|
|
26
27
|
}) {
|
|
27
28
|
const Heading = `h${headingLevel}`;
|
|
@@ -62,7 +63,8 @@ function PageHeader({
|
|
|
62
63
|
] }),
|
|
63
64
|
actions != null && /* @__PURE__ */ jsx(Slot, { className: "env-page-header-actions", layout: "row", children: /* @__PURE__ */ jsx(ControlDefaults, { size: controlSize, children: actions }) })
|
|
64
65
|
] }),
|
|
65
|
-
toolbar != null && /* @__PURE__ */ jsx(Slot, { className: "env-page-header-toolbar", children: /* @__PURE__ */ jsx(ControlDefaults, { size: controlSize, children: toolbar }) })
|
|
66
|
+
toolbar != null && /* @__PURE__ */ jsx(Slot, { className: "env-page-header-toolbar", children: /* @__PURE__ */ jsx(ControlDefaults, { size: controlSize, children: toolbar }) }),
|
|
67
|
+
children
|
|
66
68
|
]
|
|
67
69
|
}
|
|
68
70
|
);
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/PageHeader.tsx"],
|
|
4
|
-
"sourcesContent": ["import type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { Column, Row } from './Layout.js';\nimport { Text } from '../foundations/Text.js';\nimport { classNames } from '../internal/classNames.js';\nimport { ControlDefaults } from '../internal/control/ControlDefaults.js';\nimport { StickyHeaderSize } from './internal/StickyHeaderSize.js';\nimport { PageTitleFocus } from './internal/PageTitleFocus.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/PageHeader.css';\n\nexport interface PageHeaderProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {\n /** The page's title. It wraps, balanced across its lines, and is never cut short. */\n title: ReactNode;\n /**\n * The title's heading level: 1 for the page's own heading, a lower level for a header inside a\n * pane or a section that sits under another heading. It looks the same at every level.\n * @default 1\n */\n headingLevel?: HeadingLevel;\n /**\n * Under the title, such as a sentence on what the page is for, or a status line. Text takes the\n * smaller muted text; any content, block content too, keeps its own look.\n */\n description?: ReactNode;\n /** The trail to the page, usually Breadcrumbs with wrap={false}, above the title. */\n breadcrumbs?: ReactNode;\n /** Before the title: an Avatar, an icon or a back IconButton. */\n start?: ReactNode;\n /** Beside the title, wrapping with it: Badges, such as a status, or a count. */\n meta?: ReactNode;\n /**\n * The page's actions, at the end of the title row: its primary action last. Below 37.5 rem of\n * the header's own width, a compact one, they move under the title and wrap.\n */\n actions?: ReactNode;\n /**\n * A second row under the title: search, filters and view switches, laid out with\n * `<Row wrap justify=\"between\">`; see Toolbar's layouts.\n */\n toolbar?: ReactNode;\n /**\n * Keeps the header in view at the top of the area that scrolls, over the content that scrolls\n * under it: under a Scaffold's top bar where the document scrolls, or at the top of a Scaffold's\n * body that scrolls. As a Page's header, what scrolls into view below it, such as a field taking\n * focus, keeps clear of it: the header measures its height, which CSS reckons from its rows until\n * script runs.\n */\n sticky?: boolean;\n /**\n * The size of the buttons and icon buttons in `actions` and `toolbar` that set none: sm for a\n * dense page, such as one in a small window, or md. Give fields in the toolbar the same `size`.\n * @default 'md'\n */\n controlSize?: 'sm' | 'md';\n /**\n * In a Scaffold, moves focus to the title of a level 1 header when the page changes: as a new\n * page's header mounts after the Scaffold first showed, not as a title changes. People using a screen\n * reader then hear the new page, and the next Tab starts from it. Focus moved there shows no\n * ring, and focus in a field or an open overlay stays where it is. False leaves focus to the\n * application.\n * @default true\n */\n focusOnNavigation?: boolean;\n}\n\n/**\n * The heading of a page: its title with an optional trail above it, a description, leading content,\n * meta beside the title, actions at the end and a toolbar row under it, built from Row and\n * Column. It responds to its own width, and can stick to the top of the area that scrolls.\n */\nexport function PageHeader({\n title,\n headingLevel = 1,\n description,\n breadcrumbs,\n start,\n meta,\n actions,\n toolbar,\n sticky = false,\n controlSize = 'md',\n focusOnNavigation = true,\n className,\n ...props\n}: PageHeaderProps) {\n const Heading = `h${headingLevel}` as const;\n const isPagesOwnHeading = headingLevel === 1;\n const titleTakesFocus = isPagesOwnHeading && focusOnNavigation;\n return (\n <Column\n gap={3}\n {...props}\n className={classNames('env-page-header', className)}\n data-sticky={flag(sticky)}\n >\n {sticky && <StickyHeaderSize />}\n {breadcrumbs != null && <Slot className=\"env-page-header-breadcrumbs\">{breadcrumbs}</Slot>}\n <Row wrap gap={4} align=\"start\" className=\"env-page-header-row\">\n {start != null && (\n <Slot className=\"env-page-header-start\" layout=\"row\" shrink=\"never\">\n {start}\n </Slot>\n )}\n <Column gap={1} className=\"env-page-header-heading\">\n <Row wrap align=\"center\" className=\"env-page-header-title-line\">\n <Text\n variant=\"headline\"\n render={\n <Heading\n className=\"env-page-header-title\"\n tabIndex={titleTakesFocus ? -1 : undefined}\n />\n }\n >\n {title}\n </Text>\n {isPagesOwnHeading && <PageTitleFocus enabled={focusOnNavigation} />}\n {meta != null && (\n <Slot className=\"env-page-header-meta\" layout=\"row\">\n {meta}\n </Slot>\n )}\n </Row>\n {description != null && (\n <Slot className=\"env-page-header-description\">{description}</Slot>\n )}\n </Column>\n {actions != null && (\n <Slot className=\"env-page-header-actions\" layout=\"row\">\n <ControlDefaults size={controlSize}>{actions}</ControlDefaults>\n </Slot>\n )}\n </Row>\n {toolbar != null && (\n <Slot className=\"env-page-header-toolbar\">\n <ControlDefaults size={controlSize}>{toolbar}</ControlDefaults>\n </Slot>\n )}\n </Column>\n );\n}\n"],
|
|
5
|
-
"mappings": "
|
|
4
|
+
"sourcesContent": ["import type { ComponentPropsWithRef, ReactNode } from 'react';\nimport { Column, Row } from './Layout.js';\nimport { Text } from '../foundations/Text.js';\nimport { classNames } from '../internal/classNames.js';\nimport { ControlDefaults } from '../internal/control/ControlDefaults.js';\nimport { StickyHeaderSize } from './internal/StickyHeaderSize.js';\nimport { PageTitleFocus } from './internal/PageTitleFocus.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport type { HeadingLevel } from '../foundations/headingLevel.js';\nimport { flag } from '../internal/flag.js';\nimport '../styles/Base.css';\nimport '../styles/PageHeader.css';\n\nexport interface PageHeaderProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {\n /** The page's title. It wraps, balanced across its lines, and is never cut short. */\n title: ReactNode;\n /**\n * The title's heading level: 1 for the page's own heading, a lower level for a header inside a\n * pane or a section that sits under another heading. It looks the same at every level.\n * @default 1\n */\n headingLevel?: HeadingLevel;\n /**\n * Under the title, such as a sentence on what the page is for, or a status line. Text takes the\n * smaller muted text; any content, block content too, keeps its own look.\n */\n description?: ReactNode;\n /** The trail to the page, usually Breadcrumbs with wrap={false}, above the title. */\n breadcrumbs?: ReactNode;\n /** Before the title: an Avatar, an icon or a back IconButton. */\n start?: ReactNode;\n /** Beside the title, wrapping with it: Badges, such as a status, or a count. */\n meta?: ReactNode;\n /**\n * The page's actions, at the end of the title row: its primary action last. Below 37.5 rem of\n * the header's own width, a compact one, they move under the title and wrap.\n */\n actions?: ReactNode;\n /**\n * A second row under the title: search, filters and view switches, laid out with\n * `<Row wrap justify=\"between\">`; see Toolbar's layouts.\n */\n toolbar?: ReactNode;\n /**\n * Keeps the header in view at the top of the area that scrolls, over the content that scrolls\n * under it: under a Scaffold's top bar where the document scrolls, or at the top of a Scaffold's\n * body that scrolls. As a Page's header, what scrolls into view below it, such as a field taking\n * focus, keeps clear of it: the header measures its height, which CSS reckons from its rows until\n * script runs.\n */\n sticky?: boolean;\n /**\n * The size of the buttons and icon buttons in `actions` and `toolbar` that set none: sm for a\n * dense page, such as one in a small window, or md. Give fields in the toolbar the same `size`.\n * @default 'md'\n */\n controlSize?: 'sm' | 'md';\n /**\n * In a Scaffold, moves focus to the title of a level 1 header when the page changes: as a new\n * page's header mounts after the Scaffold first showed, not as a title changes. People using a screen\n * reader then hear the new page, and the next Tab starts from it. Focus moved there shows no\n * ring, and focus in a field or an open overlay stays where it is. False leaves focus to the\n * application.\n * @default true\n */\n focusOnNavigation?: boolean;\n /**\n * More rows under the toolbar, placed as given, such as a progress strip or an inline Alert. They\n * stay in the header, so they stick with it.\n */\n children?: ReactNode;\n}\n\n/**\n * The heading of a page: its title with an optional trail above it, a description, leading content,\n * meta beside the title, actions at the end and a toolbar row under it, built from Row and\n * Column. It responds to its own width, and can stick to the top of the area that scrolls.\n */\nexport function PageHeader({\n title,\n headingLevel = 1,\n description,\n breadcrumbs,\n start,\n meta,\n actions,\n toolbar,\n sticky = false,\n controlSize = 'md',\n focusOnNavigation = true,\n className,\n children,\n ...props\n}: PageHeaderProps) {\n const Heading = `h${headingLevel}` as const;\n const isPagesOwnHeading = headingLevel === 1;\n const titleTakesFocus = isPagesOwnHeading && focusOnNavigation;\n return (\n <Column\n gap={3}\n {...props}\n className={classNames('env-page-header', className)}\n data-sticky={flag(sticky)}\n >\n {sticky && <StickyHeaderSize />}\n {breadcrumbs != null && <Slot className=\"env-page-header-breadcrumbs\">{breadcrumbs}</Slot>}\n <Row wrap gap={4} align=\"start\" className=\"env-page-header-row\">\n {start != null && (\n <Slot className=\"env-page-header-start\" layout=\"row\" shrink=\"never\">\n {start}\n </Slot>\n )}\n <Column gap={1} className=\"env-page-header-heading\">\n <Row wrap align=\"center\" className=\"env-page-header-title-line\">\n <Text\n variant=\"headline\"\n render={\n <Heading\n className=\"env-page-header-title\"\n tabIndex={titleTakesFocus ? -1 : undefined}\n />\n }\n >\n {title}\n </Text>\n {isPagesOwnHeading && <PageTitleFocus enabled={focusOnNavigation} />}\n {meta != null && (\n <Slot className=\"env-page-header-meta\" layout=\"row\">\n {meta}\n </Slot>\n )}\n </Row>\n {description != null && (\n <Slot className=\"env-page-header-description\">{description}</Slot>\n )}\n </Column>\n {actions != null && (\n <Slot className=\"env-page-header-actions\" layout=\"row\">\n <ControlDefaults size={controlSize}>{actions}</ControlDefaults>\n </Slot>\n )}\n </Row>\n {toolbar != null && (\n <Slot className=\"env-page-header-toolbar\">\n <ControlDefaults size={controlSize}>{toolbar}</ControlDefaults>\n </Slot>\n )}\n {children}\n </Column>\n );\n}\n"],
|
|
5
|
+
"mappings": "AAwGiB,cASP,YATO;AAvGjB,SAAS,QAAQ,WAAW;AAC5B,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,sBAAsB;AAC/B,SAAS,YAAY;AAErB,SAAS,YAAY;AACrB,OAAO;AACP,OAAO;AAmEA,SAAS,WAAW;AAAA,EACzB;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,UAAU,IAAI,YAAY;AAChC,QAAM,oBAAoB,iBAAiB;AAC3C,QAAM,kBAAkB,qBAAqB;AAC7C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACJ,GAAG;AAAA,MACJ,WAAW,WAAW,mBAAmB,SAAS;AAAA,MAClD,eAAa,KAAK,MAAM;AAAA,MAEvB;AAAA,kBAAU,oBAAC,oBAAiB;AAAA,QAC5B,eAAe,QAAQ,oBAAC,QAAK,WAAU,+BAA+B,uBAAY;AAAA,QACnF,qBAAC,OAAI,MAAI,MAAC,KAAK,GAAG,OAAM,SAAQ,WAAU,uBACvC;AAAA,mBAAS,QACR,oBAAC,QAAK,WAAU,yBAAwB,QAAO,OAAM,QAAO,SACzD,iBACH;AAAA,UAEF,qBAAC,UAAO,KAAK,GAAG,WAAU,2BACxB;AAAA,iCAAC,OAAI,MAAI,MAAC,OAAM,UAAS,WAAU,8BACjC;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,SAAQ;AAAA,kBACR,QACE;AAAA,oBAAC;AAAA;AAAA,sBACC,WAAU;AAAA,sBACV,UAAU,kBAAkB,KAAK;AAAA;AAAA,kBACnC;AAAA,kBAGD;AAAA;AAAA,cACH;AAAA,cACC,qBAAqB,oBAAC,kBAAe,SAAS,mBAAmB;AAAA,cACjE,QAAQ,QACP,oBAAC,QAAK,WAAU,wBAAuB,QAAO,OAC3C,gBACH;AAAA,eAEJ;AAAA,YACC,eAAe,QACd,oBAAC,QAAK,WAAU,+BAA+B,uBAAY;AAAA,aAE/D;AAAA,UACC,WAAW,QACV,oBAAC,QAAK,WAAU,2BAA0B,QAAO,OAC/C,8BAAC,mBAAgB,MAAM,aAAc,mBAAQ,GAC/C;AAAA,WAEJ;AAAA,QACC,WAAW,QACV,oBAAC,QAAK,WAAU,2BACd,8BAAC,mBAAgB,MAAM,aAAc,mBAAQ,GAC/C;AAAA,QAED;AAAA;AAAA;AAAA,EACH;AAEJ;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/layout/Panes.d.ts
CHANGED
|
@@ -20,8 +20,9 @@ export interface RootProps extends Omit<ComponentPropsWithRef<'div'>, 'children'
|
|
|
20
20
|
/** The sized pane's width in rem, for Panes the application controls with onWidthChange. */
|
|
21
21
|
width?: number;
|
|
22
22
|
/**
|
|
23
|
-
* The sized pane's width in rem until people choose one with Panes.ResizeHandle,
|
|
24
|
-
*
|
|
23
|
+
* The sized pane's width in rem until people choose one with Panes.ResizeHandle, and the width a
|
|
24
|
+
* double click on the handle returns it to. To keep the width people choose, store what
|
|
25
|
+
* onWidthChange receives and pass it back here.
|
|
25
26
|
* @default 22.5
|
|
26
27
|
*/
|
|
27
28
|
defaultWidth?: number;
|
|
@@ -41,21 +42,8 @@ export interface RootProps extends Omit<ComponentPropsWithRef<'div'>, 'children'
|
|
|
41
42
|
*/
|
|
42
43
|
maxWidth?: number;
|
|
43
44
|
/**
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
* server with `readPanesWidth(cookieHeader, key)` and pass it as `persistedWidth`, so the server's
|
|
47
|
-
* markup has it and nothing moves as the page hydrates. Without that, the kept width applies
|
|
48
|
-
* after the first render.
|
|
49
|
-
*/
|
|
50
|
-
persist?: string;
|
|
51
|
-
/**
|
|
52
|
-
* The width kept under `persist`, in rem, as the server read it from the request's cookies with
|
|
53
|
-
* `readPanesWidth`: the first render uses it, on the server and in the browser alike.
|
|
54
|
-
*/
|
|
55
|
-
persistedWidth?: number;
|
|
56
|
-
/**
|
|
57
|
-
* A name for this node, such as "inbox", which dev mode and the docs show; it renders as
|
|
58
|
-
* `data-env-name`.
|
|
45
|
+
* A name for this node, such as "inbox", for the application's styles and tests to find it by; it
|
|
46
|
+
* renders as `data-env-name`.
|
|
59
47
|
*/
|
|
60
48
|
name?: string;
|
|
61
49
|
/** The two panes, with a Panes.ResizeHandle between them for people to resize them. */
|
|
@@ -81,15 +69,17 @@ export interface ResizeHandleProps extends Omit<HandleProps, 'axis' | 'value' |
|
|
|
81
69
|
*/
|
|
82
70
|
label?: string;
|
|
83
71
|
}
|
|
84
|
-
declare function Root({ sized, stackBelow, width, defaultWidth, onWidthChange, minWidth, maxWidth,
|
|
72
|
+
declare function Root({ sized, stackBelow, width, defaultWidth, onWidthChange, minWidth, maxWidth, name, className, style, children, ...props }: RootProps): import("react").JSX.Element;
|
|
85
73
|
declare function Pane({ label, header, className, children, ...props }: PaneProps): import("react").JSX.Element;
|
|
86
74
|
declare function ResizeHandle({ label, className, onDoubleClick, ...props }: ResizeHandleProps): import("react").JSX.Element;
|
|
87
75
|
/**
|
|
88
76
|
* A region split into two panes side by side, such as a list and its detail: one pane has a width
|
|
89
77
|
* of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each
|
|
90
78
|
* pane's content scrolls on its own under its header when Panes has a height. With `stackBelow`
|
|
91
|
-
* the panes stack in a narrow region.
|
|
92
|
-
*
|
|
79
|
+
* the panes stack in a narrow region. A pane the application renders alone, such as the list
|
|
80
|
+
* while no item is open, fills the region and the handle hides. Panes fill their region with square
|
|
81
|
+
* corners; an application rounds them with its own class, and the panes follow, since the root
|
|
82
|
+
* clips them.
|
|
93
83
|
*/
|
|
94
84
|
declare const RootPart: typeof Root & {
|
|
95
85
|
displayName: string;
|
package/dist/layout/Panes.js
CHANGED
|
@@ -5,21 +5,20 @@ import {
|
|
|
5
5
|
cloneElement,
|
|
6
6
|
createContext,
|
|
7
7
|
isValidElement,
|
|
8
|
-
useCallback,
|
|
9
8
|
useContext,
|
|
10
9
|
useId,
|
|
11
|
-
useLayoutEffect,
|
|
12
10
|
useMemo
|
|
13
11
|
} from "react";
|
|
14
12
|
import { panes } from "../foundations/messages/panes.js";
|
|
15
13
|
import { classNames } from "../internal/classNames.js";
|
|
14
|
+
import { panesOtherMinRem, panesSizeRem } from "../internal/sizeTokens.js";
|
|
16
15
|
import { useMessages } from "../internal/provider/EnvUIContext.js";
|
|
17
16
|
import { withDisplayName } from "../internal/react/withDisplayName.js";
|
|
18
|
-
import { readPanesWidth, writePanesWidth } from "./panesSize.js";
|
|
19
17
|
import { remPixels, roundToHundredth } from "../internal/dom/lengths.js";
|
|
20
18
|
import { useResizableWidth } from "../internal/resize/useResizableWidth.js";
|
|
21
19
|
import { Slot } from "../internal/layout/Slot.js";
|
|
22
20
|
import { ResizeHandle as Handle } from "./ResizeHandle.js";
|
|
21
|
+
import { chainHandlers } from "../internal/react/chainHandlers.js";
|
|
23
22
|
import "#styles/Base.css";
|
|
24
23
|
import "#styles/Panes.css";
|
|
25
24
|
const PanesContext = createContext(null);
|
|
@@ -28,23 +27,20 @@ function usePanes(part) {
|
|
|
28
27
|
if (!context) throw new Error(`Panes.${part} must be inside Panes.Root.`);
|
|
29
28
|
return context;
|
|
30
29
|
}
|
|
31
|
-
const fallbackOtherPaneMinWidthRem = 16;
|
|
32
30
|
function widestSizedPaneRem(handle) {
|
|
33
31
|
const root = handle.parentElement;
|
|
34
32
|
if (!root) return Infinity;
|
|
35
|
-
const other = Number.parseFloat(getComputedStyle(root).getPropertyValue("--env-panes-other-min")) ||
|
|
33
|
+
const other = Number.parseFloat(getComputedStyle(root).getPropertyValue("--env-panes-other-min")) || panesOtherMinRem;
|
|
36
34
|
return roundToHundredth(root.clientWidth / remPixels(handle) - other);
|
|
37
35
|
}
|
|
38
36
|
function Root({
|
|
39
37
|
sized = "start",
|
|
40
38
|
stackBelow,
|
|
41
39
|
width,
|
|
42
|
-
defaultWidth =
|
|
40
|
+
defaultWidth = panesSizeRem,
|
|
43
41
|
onWidthChange,
|
|
44
42
|
minWidth = 16,
|
|
45
43
|
maxWidth = 40,
|
|
46
|
-
persist,
|
|
47
|
-
persistedWidth,
|
|
48
44
|
name,
|
|
49
45
|
className,
|
|
50
46
|
style,
|
|
@@ -52,29 +48,16 @@ function Root({
|
|
|
52
48
|
...props
|
|
53
49
|
}) {
|
|
54
50
|
const sizeText = useMessages("panes", panes).size;
|
|
55
|
-
const keep = useCallback(
|
|
56
|
-
(kept) => {
|
|
57
|
-
if (persist) writePanesWidth(persist, kept);
|
|
58
|
-
},
|
|
59
|
-
[persist]
|
|
60
|
-
);
|
|
61
51
|
const resize = useResizableWidth({
|
|
62
52
|
width,
|
|
63
53
|
defaultWidth,
|
|
64
54
|
onWidthChange,
|
|
65
55
|
minWidth,
|
|
66
56
|
maxWidth,
|
|
67
|
-
keptWidth: persistedWidth,
|
|
68
|
-
keep,
|
|
69
57
|
room: widestSizedPaneRem,
|
|
70
58
|
reverse: sized === "end",
|
|
71
59
|
widthText: (size) => sizeText({ size })
|
|
72
60
|
});
|
|
73
|
-
const { restore } = resize;
|
|
74
|
-
useLayoutEffect(() => {
|
|
75
|
-
const kept = persist ? readPanesWidth(document.cookie, persist) : void 0;
|
|
76
|
-
if (kept !== void 0) restore(kept);
|
|
77
|
-
}, [persist, restore]);
|
|
78
61
|
const fallbackId = `${useId()}-sized`;
|
|
79
62
|
const paneAt = [];
|
|
80
63
|
const given = [];
|
|
@@ -133,10 +116,7 @@ function ResizeHandle({ label, className, onDoubleClick, ...props }) {
|
|
|
133
116
|
label: label ?? messages.resize,
|
|
134
117
|
"aria-controls": sizedId,
|
|
135
118
|
className: classNames("env-panes-resize-handle", className),
|
|
136
|
-
onDoubleClick: (
|
|
137
|
-
onDoubleClick?.(event);
|
|
138
|
-
handle.onDoubleClick(event);
|
|
139
|
-
}
|
|
119
|
+
onDoubleClick: chainHandlers(onDoubleClick, handle.onDoubleClick)
|
|
140
120
|
}
|
|
141
121
|
);
|
|
142
122
|
}
|
package/dist/layout/Panes.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/Panes.tsx"],
|
|
4
|
-
"sourcesContent": ["'use client';\n\nimport {\n Children,\n cloneElement,\n createContext,\n isValidElement,\n useCallback,\n useContext,\n useId,\n useLayoutEffect,\n useMemo,\n type ReactElement,\n type ComponentPropsWithRef,\n type ReactNode,\n} from 'react';\nimport { panes } from '../foundations/messages/panes.js';\nimport { classNames } from '../internal/classNames.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport { readPanesWidth, writePanesWidth } from './panesSize.js';\nimport type { ResizeDetails } from '../internal/resize/resizeDetails.js';\nimport { remPixels, roundToHundredth } from '../internal/dom/lengths.js';\nimport { useResizableWidth } from '../internal/resize/useResizableWidth.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ResizeHandle as Handle, type ResizeHandleProps as HandleProps } from './ResizeHandle.js';\nimport '../styles/Base.css';\nimport '../styles/Panes.css';\n\n/** The window class of Panes' own width below which its panes stack, one above the other. */\nexport type StackBelow = 'medium' | 'expanded' | 'large';\n\nexport interface RootProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {\n /**\n * Which pane has a width of its own, which Panes.ResizeHandle resizes: the first, such as a list\n * or a sidebar, or the last, such as details. The other pane takes the rest of the room.\n * @default 'start'\n */\n sized?: 'start' | 'end';\n /**\n * The window class of the Panes' own width below which the panes stack, the first above the\n * last, each half the height, and the resize handle hides: medium (37.5 rem), expanded\n * (52.5 rem) or large (75 rem). CSS decides it, so the server's markup is right before any script\n * runs. Without it the panes always sit side by side.\n */\n stackBelow?: StackBelow;\n /** The sized pane's width in rem, for Panes the application controls with onWidthChange. */\n width?: number;\n /**\n * The sized pane's width in rem until people choose one with Panes.ResizeHandle, or one is kept\n * under `persist`, and the width a double click on the handle returns it to.\n * @default 22.5\n */\n defaultWidth?: number;\n /**\n * Receives each new width of the sized pane, in rem: while dragging the handle with committed\n * false, and with committed true as a drag ends, a key moves it or a double click resets it.\n */\n onWidthChange?: (width: number, details: ResizeDetails) => void;\n /**\n * The sized pane's smallest width, in rem.\n * @default 16\n */\n minWidth?: number;\n /**\n * The sized pane's largest width, in rem. It never leaves the other pane less than 16 rem.\n * @default 40\n */\n maxWidth?: number;\n /**\n * Keeps the width people choose in a cookie of this name, for Panes the application doesn't\n * control; a double click on the handle forgets it and returns to `defaultWidth`. Read it on the\n * server with `readPanesWidth(cookieHeader, key)` and pass it as `persistedWidth`, so the server's\n * markup has it and nothing moves as the page hydrates. Without that, the kept width applies\n * after the first render.\n */\n persist?: string;\n /**\n * The width kept under `persist`, in rem, as the server read it from the request's cookies with\n * `readPanesWidth`: the first render uses it, on the server and in the browser alike.\n */\n persistedWidth?: number;\n /**\n * A name for this node, such as \"inbox\", which dev mode and the docs show; it renders as\n * `data-env-name`.\n */\n name?: string;\n /** The two panes, with a Panes.ResizeHandle between them for people to resize them. */\n children: ReactNode;\n}\n\nexport interface PaneProps extends ComponentPropsWithRef<'div'> {\n /**\n * Names the pane, which makes it a region landmark that people can jump to, such as Messages.\n * Name the panes of a page's main layout; leave small panes unnamed.\n */\n label?: string;\n /**\n * The top of the pane, which stays in view while the pane's content scrolls under it, such as a\n * PageHeader or a Toolbar.\n */\n header?: ReactNode;\n}\n\n/** Panes.ResizeHandle's props: a ResizeHandle's look and name, with Panes keeping the width. */\nexport interface ResizeHandleProps extends Omit<\n HandleProps,\n | 'axis'\n | 'value'\n | 'min'\n | 'max'\n | 'room'\n | 'step'\n | 'largeStep'\n | 'unit'\n | 'percentOf'\n | 'reverse'\n | 'onChange'\n | 'valueText'\n | 'label'\n | 'aria-label'\n> {\n /**\n * The handle's name, which says what it resizes, such as Resize the project list.\n * @default 'Resize panes', or EnvUIProvider's messages.panes.resize\n */\n label?: string;\n}\n\ninterface PanesContextValue {\n handle: ReturnType<typeof useResizableWidth>['handleProps'];\n sizedId: string;\n}\n\nconst PanesContext = createContext<PanesContextValue | null>(null);\n\nfunction usePanes(part: string) {\n const context = useContext(PanesContext);\n if (!context) throw new Error(`Panes.${part} must be inside Panes.Root.`);\n return context;\n}\n\nconst fallbackOtherPaneMinWidthRem = 16;\n\nfunction widestSizedPaneRem(handle: HTMLElement) {\n const root = handle.parentElement;\n if (!root) return Infinity;\n const other =\n Number.parseFloat(getComputedStyle(root).getPropertyValue('--env-panes-other-min')) ||\n fallbackOtherPaneMinWidthRem;\n return roundToHundredth(root.clientWidth / remPixels(handle) - other);\n}\n\nfunction Root({\n sized = 'start',\n stackBelow,\n width,\n defaultWidth = 22.5,\n onWidthChange,\n minWidth = 16,\n maxWidth = 40,\n persist,\n persistedWidth,\n name,\n className,\n style,\n children,\n ...props\n}: RootProps) {\n const sizeText = useMessages('panes', panes).size;\n const keep = useCallback(\n (kept: number | undefined) => {\n if (persist) writePanesWidth(persist, kept);\n },\n [persist],\n );\n const resize = useResizableWidth({\n width,\n defaultWidth,\n onWidthChange,\n minWidth,\n maxWidth,\n keptWidth: persistedWidth,\n keep,\n room: widestSizedPaneRem,\n reverse: sized === 'end',\n widthText: (size) => sizeText({ size }),\n });\n const { restore } = resize;\n useLayoutEffect(() => {\n const kept = persist ? readPanesWidth(document.cookie, persist) : undefined;\n if (kept !== undefined) restore(kept);\n }, [persist, restore]);\n const fallbackId = `${useId()}-sized`;\n const paneAt: number[] = [];\n const given: ReactElement<PaneProps>[] = [];\n Children.forEach(children, (child, index) => {\n if (!isValidElement<PaneProps>(child) || child.type !== PanePart) return;\n paneAt.push(index);\n given.push(child);\n });\n const sizedIndex = sized === 'start' ? paneAt[0] : paneAt.at(-1);\n const sizedPane = sized === 'start' ? given[0] : given.at(-1);\n const sizedId = sizedPane?.props.id ?? fallbackId;\n const context = useMemo<PanesContextValue>(\n () => ({ handle: resize.handleProps, sizedId }),\n [resize.handleProps, sizedId],\n );\n return (\n <PanesContext value={context}>\n <div\n {...props}\n className={classNames('env-panes', className)}\n style={{ '--env-panes-size': `${resize.width}rem`, ...style }}\n data-env-layout=\"panes\"\n data-env-name={name}\n data-sized={sized}\n data-stack-below={stackBelow}\n >\n {Children.map(children, (child, index) =>\n index === sizedIndex && isValidElement<PaneProps>(child) && child.props.id === undefined\n ? cloneElement(child, { id: sizedId })\n : child,\n )}\n </div>\n </PanesContext>\n );\n}\n\nfunction Pane({ label, header, className, children, ...props }: PaneProps) {\n usePanes('Pane');\n return (\n <div\n {...props}\n className={classNames('env-panes-pane', className)}\n {...(label !== undefined && { role: 'region', 'aria-label': label })}\n >\n {header != null && (\n <div className=\"env-panes-header\">\n <Slot className=\"env-panes-header-content\" grow>\n {header}\n </Slot>\n </div>\n )}\n <div className=\"env-panes-body\">{children}</div>\n </div>\n );\n}\n\nfunction ResizeHandle({ label, className, onDoubleClick, ...props }: ResizeHandleProps) {\n const { handle, sizedId } = usePanes('ResizeHandle');\n const messages = useMessages('panes', panes);\n return (\n <Handle\n {...props}\n {...handle}\n label={label ?? messages.resize}\n aria-controls={sizedId}\n className={classNames('env-panes-resize-handle', className)}\n onDoubleClick={(event) => {\n onDoubleClick?.(event);\n handle.onDoubleClick(event);\n }}\n />\n );\n}\n\n/**\n * A region split into two panes side by side, such as a list and its detail: one pane has a width\n * of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each\n * pane's content scrolls on its own under its header when Panes has a height. With `stackBelow`\n * the panes stack in a narrow region. Panes fill their region with square corners; an application\n * rounds them with its own class, and the panes follow, since the root clips them.\n */\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Panes.Root');\n/** One pane: the first or the last child of Panes.Root, with an optional header. */\nconst PanePart = /* @__PURE__ */ withDisplayName(Pane, 'Panes.Pane');\n/**\n * The ResizeHandle between the panes, which resizes the sized pane: invisible on the seam with its\n * grip of three dots, a line along it under the pointer, while dragged and with keyboard focus. Its\n * hit area reaches only into the pane after it, so the scrollbar and the controls at the edge of the\n * pane before it stay reachable. The arrow keys move it 1 rem a step, 5 with Shift, and a double\n * click returns the pane to its default width. It hides while the panes stack.\n */\nconst ResizeHandlePart = /* @__PURE__ */ withDisplayName(ResizeHandle, 'Panes.ResizeHandle');\nexport { RootPart as Root, PanePart as Pane, ResizeHandlePart as ResizeHandle };\n"],
|
|
5
|
-
"mappings": ";
|
|
4
|
+
"sourcesContent": ["'use client';\n\nimport {\n Children,\n cloneElement,\n createContext,\n isValidElement,\n useContext,\n useId,\n useMemo,\n type ReactElement,\n type ComponentPropsWithRef,\n type ReactNode,\n} from 'react';\nimport { panes } from '../foundations/messages/panes.js';\nimport { classNames } from '../internal/classNames.js';\nimport { panesOtherMinRem, panesSizeRem } from '../internal/sizeTokens.js';\nimport { useMessages } from '../internal/provider/EnvUIContext.js';\nimport { withDisplayName } from '../internal/react/withDisplayName.js';\nimport type { ResizeDetails } from '../internal/resize/resizeDetails.js';\nimport { remPixels, roundToHundredth } from '../internal/dom/lengths.js';\nimport { useResizableWidth } from '../internal/resize/useResizableWidth.js';\nimport { Slot } from '../internal/layout/Slot.js';\nimport { ResizeHandle as Handle, type ResizeHandleProps as HandleProps } from './ResizeHandle.js';\nimport { chainHandlers } from '../internal/react/chainHandlers.js';\nimport '../styles/Base.css';\nimport '../styles/Panes.css';\n\n/** The window class of Panes' own width below which its panes stack, one above the other. */\nexport type StackBelow = 'medium' | 'expanded' | 'large';\n\nexport interface RootProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {\n /**\n * Which pane has a width of its own, which Panes.ResizeHandle resizes: the first, such as a list\n * or a sidebar, or the last, such as details. The other pane takes the rest of the room.\n * @default 'start'\n */\n sized?: 'start' | 'end';\n /**\n * The window class of the Panes' own width below which the panes stack, the first above the\n * last, each half the height, and the resize handle hides: medium (37.5 rem), expanded\n * (52.5 rem) or large (75 rem). CSS decides it, so the server's markup is right before any script\n * runs. Without it the panes always sit side by side.\n */\n stackBelow?: StackBelow;\n /** The sized pane's width in rem, for Panes the application controls with onWidthChange. */\n width?: number;\n /**\n * The sized pane's width in rem until people choose one with Panes.ResizeHandle, and the width a\n * double click on the handle returns it to. To keep the width people choose, store what\n * onWidthChange receives and pass it back here.\n * @default 22.5\n */\n defaultWidth?: number;\n /**\n * Receives each new width of the sized pane, in rem: while dragging the handle with committed\n * false, and with committed true as a drag ends, a key moves it or a double click resets it.\n */\n onWidthChange?: (width: number, details: ResizeDetails) => void;\n /**\n * The sized pane's smallest width, in rem.\n * @default 16\n */\n minWidth?: number;\n /**\n * The sized pane's largest width, in rem. It never leaves the other pane less than 16 rem.\n * @default 40\n */\n maxWidth?: number;\n /**\n * A name for this node, such as \"inbox\", for the application's styles and tests to find it by; it\n * renders as `data-env-name`.\n */\n name?: string;\n /** The two panes, with a Panes.ResizeHandle between them for people to resize them. */\n children: ReactNode;\n}\n\nexport interface PaneProps extends ComponentPropsWithRef<'div'> {\n /**\n * Names the pane, which makes it a region landmark that people can jump to, such as Messages.\n * Name the panes of a page's main layout; leave small panes unnamed.\n */\n label?: string;\n /**\n * The top of the pane, which stays in view while the pane's content scrolls under it, such as a\n * PageHeader or a Toolbar.\n */\n header?: ReactNode;\n}\n\n/** Panes.ResizeHandle's props: a ResizeHandle's look and name, with Panes keeping the width. */\nexport interface ResizeHandleProps extends Omit<\n HandleProps,\n | 'axis'\n | 'value'\n | 'min'\n | 'max'\n | 'room'\n | 'step'\n | 'largeStep'\n | 'unit'\n | 'percentOf'\n | 'reverse'\n | 'onChange'\n | 'valueText'\n | 'label'\n | 'aria-label'\n> {\n /**\n * The handle's name, which says what it resizes, such as Resize the project list.\n * @default 'Resize panes', or EnvUIProvider's messages.panes.resize\n */\n label?: string;\n}\n\ninterface PanesContextValue {\n handle: ReturnType<typeof useResizableWidth>['handleProps'];\n sizedId: string;\n}\n\nconst PanesContext = createContext<PanesContextValue | null>(null);\n\nfunction usePanes(part: string) {\n const context = useContext(PanesContext);\n if (!context) throw new Error(`Panes.${part} must be inside Panes.Root.`);\n return context;\n}\n\nfunction widestSizedPaneRem(handle: HTMLElement) {\n const root = handle.parentElement;\n if (!root) return Infinity;\n const other =\n Number.parseFloat(getComputedStyle(root).getPropertyValue('--env-panes-other-min')) ||\n panesOtherMinRem;\n return roundToHundredth(root.clientWidth / remPixels(handle) - other);\n}\n\nfunction Root({\n sized = 'start',\n stackBelow,\n width,\n defaultWidth = panesSizeRem,\n onWidthChange,\n minWidth = 16,\n maxWidth = 40,\n name,\n className,\n style,\n children,\n ...props\n}: RootProps) {\n const sizeText = useMessages('panes', panes).size;\n const resize = useResizableWidth({\n width,\n defaultWidth,\n onWidthChange,\n minWidth,\n maxWidth,\n room: widestSizedPaneRem,\n reverse: sized === 'end',\n widthText: (size) => sizeText({ size }),\n });\n const fallbackId = `${useId()}-sized`;\n const paneAt: number[] = [];\n const given: ReactElement<PaneProps>[] = [];\n Children.forEach(children, (child, index) => {\n if (!isValidElement<PaneProps>(child) || child.type !== PanePart) return;\n paneAt.push(index);\n given.push(child);\n });\n const sizedIndex = sized === 'start' ? paneAt[0] : paneAt.at(-1);\n const sizedPane = sized === 'start' ? given[0] : given.at(-1);\n const sizedId = sizedPane?.props.id ?? fallbackId;\n const context = useMemo<PanesContextValue>(\n () => ({ handle: resize.handleProps, sizedId }),\n [resize.handleProps, sizedId],\n );\n return (\n <PanesContext value={context}>\n <div\n {...props}\n className={classNames('env-panes', className)}\n style={{ '--env-panes-size': `${resize.width}rem`, ...style }}\n data-env-layout=\"panes\"\n data-env-name={name}\n data-sized={sized}\n data-stack-below={stackBelow}\n >\n {Children.map(children, (child, index) =>\n index === sizedIndex && isValidElement<PaneProps>(child) && child.props.id === undefined\n ? cloneElement(child, { id: sizedId })\n : child,\n )}\n </div>\n </PanesContext>\n );\n}\n\nfunction Pane({ label, header, className, children, ...props }: PaneProps) {\n usePanes('Pane');\n return (\n <div\n {...props}\n className={classNames('env-panes-pane', className)}\n {...(label !== undefined && { role: 'region', 'aria-label': label })}\n >\n {header != null && (\n <div className=\"env-panes-header\">\n <Slot className=\"env-panes-header-content\" grow>\n {header}\n </Slot>\n </div>\n )}\n <div className=\"env-panes-body\">{children}</div>\n </div>\n );\n}\n\nfunction ResizeHandle({ label, className, onDoubleClick, ...props }: ResizeHandleProps) {\n const { handle, sizedId } = usePanes('ResizeHandle');\n const messages = useMessages('panes', panes);\n return (\n <Handle\n {...props}\n {...handle}\n label={label ?? messages.resize}\n aria-controls={sizedId}\n className={classNames('env-panes-resize-handle', className)}\n onDoubleClick={chainHandlers(onDoubleClick, handle.onDoubleClick)}\n />\n );\n}\n\n/**\n * A region split into two panes side by side, such as a list and its detail: one pane has a width\n * of its own, which a Panes.ResizeHandle between them resizes, and the other takes the rest. Each\n * pane's content scrolls on its own under its header when Panes has a height. With `stackBelow`\n * the panes stack in a narrow region. A pane the application renders alone, such as the list\n * while no item is open, fills the region and the handle hides. Panes fill their region with square\n * corners; an application rounds them with its own class, and the panes follow, since the root\n * clips them.\n */\nconst RootPart = /* @__PURE__ */ withDisplayName(Root, 'Panes.Root');\n/** One pane: the first or the last child of Panes.Root, with an optional header. */\nconst PanePart = /* @__PURE__ */ withDisplayName(Pane, 'Panes.Pane');\n/**\n * The ResizeHandle between the panes, which resizes the sized pane: invisible on the seam with its\n * grip of three dots, a line along it under the pointer, while dragged and with keyboard focus. Its\n * hit area reaches only into the pane after it, so the scrollbar and the controls at the edge of the\n * pane before it stay reachable. The arrow keys move it 1 rem a step, 5 with Shift, and a double\n * click returns the pane to its default width. It hides while the panes stack.\n */\nconst ResizeHandlePart = /* @__PURE__ */ withDisplayName(ResizeHandle, 'Panes.ResizeHandle');\nexport { RootPart as Root, PanePart as Pane, ResizeHandlePart as ResizeHandle };\n"],
|
|
5
|
+
"mappings": ";AAoLM,cAsBF,YAtBE;AAlLN;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB,oBAAoB;AAC/C,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAEhC,SAAS,WAAW,wBAAwB;AAC5C,SAAS,yBAAyB;AAClC,SAAS,YAAY;AACrB,SAAS,gBAAgB,cAAqD;AAC9E,SAAS,qBAAqB;AAC9B,OAAO;AACP,OAAO;AA+FP,MAAM,eAAe,cAAwC,IAAI;AAEjE,SAAS,SAAS,MAAc;AAC9B,QAAM,UAAU,WAAW,YAAY;AACvC,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,SAAS,IAAI,6BAA6B;AACxE,SAAO;AACT;AAEA,SAAS,mBAAmB,QAAqB;AAC/C,QAAM,OAAO,OAAO;AACpB,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,QACJ,OAAO,WAAW,iBAAiB,IAAI,EAAE,iBAAiB,uBAAuB,CAAC,KAClF;AACF,SAAO,iBAAiB,KAAK,cAAc,UAAU,MAAM,IAAI,KAAK;AACtE;AAEA,SAAS,KAAK;AAAA,EACZ,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA,WAAW;AAAA,EACX,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAc;AACZ,QAAM,WAAW,YAAY,SAAS,KAAK,EAAE;AAC7C,QAAM,SAAS,kBAAkB;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN,SAAS,UAAU;AAAA,IACnB,WAAW,CAAC,SAAS,SAAS,EAAE,KAAK,CAAC;AAAA,EACxC,CAAC;AACD,QAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,QAAM,SAAmB,CAAC;AAC1B,QAAM,QAAmC,CAAC;AAC1C,WAAS,QAAQ,UAAU,CAAC,OAAO,UAAU;AAC3C,QAAI,CAAC,eAA0B,KAAK,KAAK,MAAM,SAAS,SAAU;AAClE,WAAO,KAAK,KAAK;AACjB,UAAM,KAAK,KAAK;AAAA,EAClB,CAAC;AACD,QAAM,aAAa,UAAU,UAAU,OAAO,CAAC,IAAI,OAAO,GAAG,EAAE;AAC/D,QAAM,YAAY,UAAU,UAAU,MAAM,CAAC,IAAI,MAAM,GAAG,EAAE;AAC5D,QAAM,UAAU,WAAW,MAAM,MAAM;AACvC,QAAM,UAAU;AAAA,IACd,OAAO,EAAE,QAAQ,OAAO,aAAa,QAAQ;AAAA,IAC7C,CAAC,OAAO,aAAa,OAAO;AAAA,EAC9B;AACA,SACE,oBAAC,gBAAa,OAAO,SACnB;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,WAAW,WAAW,aAAa,SAAS;AAAA,MAC5C,OAAO,EAAE,oBAAoB,GAAG,OAAO,KAAK,OAAO,GAAG,MAAM;AAAA,MAC5D,mBAAgB;AAAA,MAChB,iBAAe;AAAA,MACf,cAAY;AAAA,MACZ,oBAAkB;AAAA,MAEjB,mBAAS;AAAA,QAAI;AAAA,QAAU,CAAC,OAAO,UAC9B,UAAU,cAAc,eAA0B,KAAK,KAAK,MAAM,MAAM,OAAO,SAC3E,aAAa,OAAO,EAAE,IAAI,QAAQ,CAAC,IACnC;AAAA,MACN;AAAA;AAAA,EACF,GACF;AAEJ;AAEA,SAAS,KAAK,EAAE,OAAO,QAAQ,WAAW,UAAU,GAAG,MAAM,GAAc;AACzE,WAAS,MAAM;AACf,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,WAAW,WAAW,kBAAkB,SAAS;AAAA,MAChD,GAAI,UAAU,UAAa,EAAE,MAAM,UAAU,cAAc,MAAM;AAAA,MAEjE;AAAA,kBAAU,QACT,oBAAC,SAAI,WAAU,oBACb,8BAAC,QAAK,WAAU,4BAA2B,MAAI,MAC5C,kBACH,GACF;AAAA,QAEF,oBAAC,SAAI,WAAU,kBAAkB,UAAS;AAAA;AAAA;AAAA,EAC5C;AAEJ;AAEA,SAAS,aAAa,EAAE,OAAO,WAAW,eAAe,GAAG,MAAM,GAAsB;AACtF,QAAM,EAAE,QAAQ,QAAQ,IAAI,SAAS,cAAc;AACnD,QAAM,WAAW,YAAY,SAAS,KAAK;AAC3C,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACH,GAAG;AAAA,MACJ,OAAO,SAAS,SAAS;AAAA,MACzB,iBAAe;AAAA,MACf,WAAW,WAAW,2BAA2B,SAAS;AAAA,MAC1D,eAAe,cAAc,eAAe,OAAO,aAAa;AAAA;AAAA,EAClE;AAEJ;AAWA,MAAM,WAA2B,gCAAgB,MAAM,YAAY;AAEnE,MAAM,WAA2B,gCAAgB,MAAM,YAAY;AAQnE,MAAM,mBAAmC,gCAAgB,cAAc,oBAAoB;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { type ComponentPropsWithRef } from 'react';
|
|
2
2
|
import { type ResizeOptions } from '../internal/resize/useResize.js';
|
|
3
|
+
export type { ResizeDetails } from '../internal/resize/resizeDetails.js';
|
|
3
4
|
export type ResizeHandleProps = ResizeOptions & Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children' | 'role' | 'tabIndex'> & {
|
|
4
5
|
/** The handle's name, which says what it resizes, such as Resize the project list. */
|
|
5
6
|
label: string;
|
|
@@ -2,10 +2,11 @@
|
|
|
2
2
|
import { jsx } from "react/jsx-runtime";
|
|
3
3
|
import { useEffect, useRef } from "react";
|
|
4
4
|
import { classNames } from "../internal/classNames.js";
|
|
5
|
-
import {
|
|
5
|
+
import { mergeRefs } from "../internal/react/setRef.js";
|
|
6
6
|
import { useResize } from "../internal/resize/useResize.js";
|
|
7
|
-
import { useLatest } from "../internal/useLatest.js";
|
|
7
|
+
import { useLatest } from "../internal/react/useLatest.js";
|
|
8
8
|
import { flag } from "../internal/flag.js";
|
|
9
|
+
import { chainHandlers } from "../internal/react/chainHandlers.js";
|
|
9
10
|
import "#styles/Base.css";
|
|
10
11
|
import "#styles/ResizeHandle.css";
|
|
11
12
|
function ResizeHandle({
|
|
@@ -73,31 +74,20 @@ function ResizeHandle({
|
|
|
73
74
|
{
|
|
74
75
|
...props,
|
|
75
76
|
...own,
|
|
76
|
-
onPointerDown:
|
|
77
|
-
onPointerMove:
|
|
78
|
-
onPointerUp:
|
|
79
|
-
onPointerCancel:
|
|
80
|
-
onLostPointerCapture:
|
|
81
|
-
onKeyDown:
|
|
82
|
-
onFocus:
|
|
83
|
-
ref: (
|
|
84
|
-
element.current = node;
|
|
85
|
-
setRef(ref, node);
|
|
86
|
-
},
|
|
77
|
+
onPointerDown: chainHandlers(props.onPointerDown, onPointerDown),
|
|
78
|
+
onPointerMove: chainHandlers(props.onPointerMove, onPointerMove),
|
|
79
|
+
onPointerUp: chainHandlers(props.onPointerUp, onPointerUp),
|
|
80
|
+
onPointerCancel: chainHandlers(props.onPointerCancel, onPointerCancel),
|
|
81
|
+
onLostPointerCapture: chainHandlers(props.onLostPointerCapture, onLostPointerCapture),
|
|
82
|
+
onKeyDown: chainHandlers(props.onKeyDown, onKeyDown),
|
|
83
|
+
onFocus: chainHandlers(props.onFocus, onFocus),
|
|
84
|
+
ref: mergeRefs(element, ref),
|
|
87
85
|
"aria-label": label,
|
|
88
86
|
"data-grip": flag(grip),
|
|
89
87
|
className: classNames("env-resize-handle", className)
|
|
90
88
|
}
|
|
91
89
|
);
|
|
92
90
|
}
|
|
93
|
-
function first(theirs, ours) {
|
|
94
|
-
if (!theirs) return ours;
|
|
95
|
-
if (!ours) return theirs;
|
|
96
|
-
return (event) => {
|
|
97
|
-
theirs(event);
|
|
98
|
-
if (!event.defaultPrevented) ours(event);
|
|
99
|
-
};
|
|
100
|
-
}
|
|
101
91
|
export {
|
|
102
92
|
ResizeHandle
|
|
103
93
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/layout/ResizeHandle.tsx"],
|
|
4
|
-
"sourcesContent": ["'use client';\n\nimport { useEffect, useRef, type ComponentPropsWithRef
|
|
5
|
-
"mappings": ";
|
|
4
|
+
"sourcesContent": ["'use client';\n\nimport { useEffect, useRef, type ComponentPropsWithRef } from 'react';\nimport { classNames } from '../internal/classNames.js';\nimport { mergeRefs } from '../internal/react/setRef.js';\nimport { useResize, type ResizeOptions } from '../internal/resize/useResize.js';\nimport { useLatest } from '../internal/react/useLatest.js';\nimport { flag } from '../internal/flag.js';\nimport { chainHandlers } from '../internal/react/chainHandlers.js';\nimport '../styles/Base.css';\nimport '../styles/ResizeHandle.css';\n\nexport type { ResizeDetails } from '../internal/resize/resizeDetails.js';\n\nexport type ResizeHandleProps = ResizeOptions &\n Omit<ComponentPropsWithRef<'div'>, 'onChange' | 'children' | 'role' | 'tabIndex'> & {\n /** The handle's name, which says what it resizes, such as Resize the project list. */\n label: string;\n /**\n * Shows a grip of three dots at the handle's middle. false leaves the handle invisible until\n * the pointer is over it, it has keyboard focus or it is dragged.\n * @default true\n */\n grip?: boolean;\n };\n\n/**\n * A handle that resizes what is beside it, such as two panes or a panel's edge: a focusable\n * separator, named by its label, that the pointer drags and the arrow keys, Page Up, Page Down,\n * Home and End move, with aria-valuenow, aria-valuemin, aria-valuemax and aria-valuetext. Its track\n * is invisible, with a grip of three dots at its middle; a 1 px line shows along it under the\n * pointer and while it is dragged, and a 2 px line in the focus color with keyboard focus. The handle's box is\n * what the pointer reaches: place and size it with a class on the edge it moves. The application\n * keeps the size; give the handle `aria-controls` with the id of what it resizes. Handlers given to\n * it run first, and one that calls preventDefault stops the handle's own.\n *\n * <ResizeHandle axis=\"inline\" label=\"Resize the sidebar\" aria-controls=\"sidebar\" value={width}\n * min={12} max={30} unit=\"rem\" step={1} onChange={(next) => setWidth(next)}\n * className=\"app-sidebar-edge\" />\n */\nexport function ResizeHandle({\n axis,\n value,\n min,\n max,\n room,\n step,\n largeStep,\n unit,\n percentOf,\n reverse,\n onChange,\n valueText,\n disabled,\n label,\n grip = true,\n className,\n ref,\n ...props\n}: ResizeHandleProps) {\n const { handleProps, measureRoomTheLargestValueFollows: measure } = useResize({\n axis,\n value,\n min,\n max,\n room,\n step,\n largeStep,\n unit,\n percentOf,\n reverse,\n onChange,\n valueText,\n disabled,\n });\n const element = useRef<HTMLDivElement | null>(null);\n const latestMeasure = useLatest(measure);\n const measures = room !== undefined;\n useEffect(\n function measureRoomOncePlacedAndAsWindowResizes() {\n const handle = element.current;\n if (!measures || !handle) return;\n const read = () => latestMeasure.current(handle);\n read();\n const view = handle.ownerDocument.defaultView;\n view?.addEventListener('resize', read);\n return () => view?.removeEventListener('resize', read);\n },\n [measures, latestMeasure],\n );\n const {\n onPointerDown,\n onPointerMove,\n onPointerUp,\n onPointerCancel,\n onLostPointerCapture,\n onKeyDown,\n onFocus,\n ...own\n } = handleProps;\n return (\n <div\n {...props}\n {...own}\n onPointerDown={chainHandlers(props.onPointerDown, onPointerDown)}\n onPointerMove={chainHandlers(props.onPointerMove, onPointerMove)}\n onPointerUp={chainHandlers(props.onPointerUp, onPointerUp)}\n onPointerCancel={chainHandlers(props.onPointerCancel, onPointerCancel)}\n onLostPointerCapture={chainHandlers(props.onLostPointerCapture, onLostPointerCapture)}\n onKeyDown={chainHandlers(props.onKeyDown, onKeyDown)}\n onFocus={chainHandlers(props.onFocus, onFocus)}\n ref={mergeRefs(element, ref)}\n aria-label={label}\n data-grip={flag(grip)}\n className={classNames('env-resize-handle', className)}\n />\n );\n}\n"],
|
|
5
|
+
"mappings": ";AAqGI;AAnGJ,SAAS,WAAW,cAA0C;AAC9D,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAC1B,SAAS,iBAAqC;AAC9C,SAAS,iBAAiB;AAC1B,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAC9B,OAAO;AACP,OAAO;AA8BA,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,EAAE,aAAa,mCAAmC,QAAQ,IAAI,UAAU;AAAA,IAC5E;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,UAAU,OAA8B,IAAI;AAClD,QAAM,gBAAgB,UAAU,OAAO;AACvC,QAAM,WAAW,SAAS;AAC1B;AAAA,IACE,SAAS,0CAA0C;AACjD,YAAM,SAAS,QAAQ;AACvB,UAAI,CAAC,YAAY,CAAC,OAAQ;AAC1B,YAAM,OAAO,MAAM,cAAc,QAAQ,MAAM;AAC/C,WAAK;AACL,YAAM,OAAO,OAAO,cAAc;AAClC,YAAM,iBAAiB,UAAU,IAAI;AACrC,aAAO,MAAM,MAAM,oBAAoB,UAAU,IAAI;AAAA,IACvD;AAAA,IACA,CAAC,UAAU,aAAa;AAAA,EAC1B;AACA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACH,GAAG;AAAA,MACJ,eAAe,cAAc,MAAM,eAAe,aAAa;AAAA,MAC/D,eAAe,cAAc,MAAM,eAAe,aAAa;AAAA,MAC/D,aAAa,cAAc,MAAM,aAAa,WAAW;AAAA,MACzD,iBAAiB,cAAc,MAAM,iBAAiB,eAAe;AAAA,MACrE,sBAAsB,cAAc,MAAM,sBAAsB,oBAAoB;AAAA,MACpF,WAAW,cAAc,MAAM,WAAW,SAAS;AAAA,MACnD,SAAS,cAAc,MAAM,SAAS,OAAO;AAAA,MAC7C,KAAK,UAAU,SAAS,GAAG;AAAA,MAC3B,cAAY;AAAA,MACZ,aAAW,KAAK,IAAI;AAAA,MACpB,WAAW,WAAW,qBAAqB,SAAS;AAAA;AAAA,EACtD;AAEJ;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -22,6 +22,16 @@ export type ScaffoldForms = Partial<Record<WindowClass, ScaffoldNavigationForm |
|
|
|
22
22
|
export interface ScaffoldProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
|
|
23
23
|
/** The top bar region, above the body: usually a TopBar. */
|
|
24
24
|
topBar?: ReactNode;
|
|
25
|
+
/**
|
|
26
|
+
* A region at the end edge, beside the body and under the top bar, such as an inspector, at the
|
|
27
|
+
* width of its content and scrolling on its own. It stays in view as the rail does.
|
|
28
|
+
*/
|
|
29
|
+
aside?: ReactNode;
|
|
30
|
+
/**
|
|
31
|
+
* A bar along the bottom of the body and the aside region, such as a status bar, above a
|
|
32
|
+
* NavigationBar. It stays in view as the top bar does, and focus scrolls clear of it.
|
|
33
|
+
*/
|
|
34
|
+
bottomBar?: ReactNode;
|
|
25
35
|
/**
|
|
26
36
|
* The navigation forms, such as `{ bar: <NavigationBar … />, rail: <NavigationRail … />, drawer: <NavigationDrawer … /> }`
|
|
27
37
|
* with the same destinations. One shows at a time, chosen by the Scaffold's own width; give only
|
|
@@ -81,8 +91,8 @@ export interface ScaffoldProps extends Omit<ComponentPropsWithRef<'div'>, 'child
|
|
|
81
91
|
*/
|
|
82
92
|
landmarks?: boolean;
|
|
83
93
|
/**
|
|
84
|
-
* A name for this node, such as "app",
|
|
85
|
-
* `data-env-name`.
|
|
94
|
+
* A name for this node, such as "app", for the application's styles and tests to find it by; it
|
|
95
|
+
* renders as `data-env-name`.
|
|
86
96
|
*/
|
|
87
97
|
name?: string;
|
|
88
98
|
/** The body: the page's main content, usually a Page or Panes. */
|
|
@@ -90,10 +100,10 @@ export interface ScaffoldProps extends Omit<ComponentPropsWithRef<'div'>, 'child
|
|
|
90
100
|
}
|
|
91
101
|
/**
|
|
92
102
|
* The invisible structure of an application's screen: a top bar region, a navigation region and
|
|
93
|
-
* the body. It never paints. It shows one navigation form at a time by its own width: a
|
|
103
|
+
* the body, with an optional aside region and bottom bar. It never paints. It shows one navigation form at a time by its own width: a
|
|
94
104
|
* NavigationBar at the bottom of a compact window, a NavigationRail at the start of a medium one
|
|
95
105
|
* and a NavigationDrawer at the start from expanded. The document scrolls by default, with the top
|
|
96
106
|
* bar, the bar and the rail or the drawer kept in view; `scroll="body"` scrolls the body alone.
|
|
97
107
|
* Skip links to the body and the navigation come first.
|
|
98
108
|
*/
|
|
99
|
-
export declare function Scaffold({ topBar, navigation, navigationForms, topBarSpan, scroll, bodyId, bodyRef, skipToContentLabel, skipToNavigationLabel, landmarks, name, className, ref, children, ...props }: ScaffoldProps): import("react").JSX.Element;
|
|
109
|
+
export declare function Scaffold({ topBar, aside, bottomBar, navigation, navigationForms, topBarSpan, scroll, bodyId, bodyRef, skipToContentLabel, skipToNavigationLabel, landmarks, name, className, ref, children, ...props }: ScaffoldProps): import("react").JSX.Element;
|