@arshad-shah/cynosure 0.3.0 → 0.5.0
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/README.md +6 -6
- package/dist/_virtual/_rolldown/runtime.js +12 -0
- package/dist/adapters/astro/index.d.ts +53 -0
- package/dist/adapters/astro/index.js +27 -0
- package/dist/adapters/astro/index.js.map +1 -0
- package/dist/adapters/vite/index.d.ts +11 -0
- package/dist/adapters/vite/index.js +33 -12
- package/dist/adapters/vite/index.js.map +1 -1
- package/dist/brands/googleplay.d.ts +2 -0
- package/dist/brands/googleplay.js +17 -0
- package/dist/brands/googleplay.js.map +1 -0
- package/dist/brands/index.d.ts +1 -0
- package/dist/brands/index.js +132 -130
- package/dist/components/Accordion/Accordion.d.ts +1 -1
- package/dist/components/Accordion/Accordion.js +26 -26
- package/dist/components/Accordion/Accordion.js.map +1 -1
- package/dist/components/Announcer/Announcer.d.ts +2 -1
- package/dist/components/Announcer/Announcer.js +32 -34
- package/dist/components/Announcer/Announcer.js.map +1 -1
- package/dist/components/AppShell/AppShell.js +41 -41
- package/dist/components/AppShell/AppShell.js.map +1 -1
- package/dist/components/Avatar/Avatar.js +20 -20
- package/dist/components/Avatar/Avatar.js.map +1 -1
- package/dist/components/Badge/Badge.d.ts +19 -5
- package/dist/components/Badge/Badge.js +19 -13
- package/dist/components/Badge/Badge.js.map +1 -1
- package/dist/components/Button/Button.d.ts +30 -6
- package/dist/components/Button/Button.js +50 -42
- package/dist/components/Button/Button.js.map +1 -1
- package/dist/components/Calendar/Calendar.js +158 -161
- package/dist/components/Calendar/Calendar.js.map +1 -1
- package/dist/components/Calendar/dates.js +42 -38
- package/dist/components/Calendar/dates.js.map +1 -1
- package/dist/components/Card/Card.d.ts +22 -2
- package/dist/components/Card/Card.js +60 -52
- package/dist/components/Card/Card.js.map +1 -1
- package/dist/components/ChatMessage/ChatMessage.d.ts +55 -0
- package/dist/components/ChatMessage/ChatMessage.js +50 -0
- package/dist/components/ChatMessage/ChatMessage.js.map +1 -0
- package/dist/components/ChatMessage/index.d.ts +1 -0
- package/dist/components/Checkbox/Checkbox.d.ts +4 -4
- package/dist/components/Checkbox/Checkbox.js +33 -8
- package/dist/components/Checkbox/Checkbox.js.map +1 -1
- package/dist/components/Checklist/Checklist.js +21 -21
- package/dist/components/Checklist/Checklist.js.map +1 -1
- package/dist/components/Choice/Choice.d.ts +73 -0
- package/dist/components/Choice/Choice.js +41 -0
- package/dist/components/Choice/Choice.js.map +1 -0
- package/dist/components/Choice/index.d.ts +1 -0
- package/dist/components/CodeBlock/CodeBlock.d.ts +6 -1
- package/dist/components/CodeBlock/CodeBlock.js +40 -37
- package/dist/components/CodeBlock/CodeBlock.js.map +1 -1
- package/dist/components/ColorField/ColorField.d.ts +3 -2
- package/dist/components/ColorField/ColorField.js +202 -212
- package/dist/components/ColorField/ColorField.js.map +1 -1
- package/dist/components/ColorField/read-color.js +5 -6
- package/dist/components/ColorField/read-color.js.map +1 -1
- package/dist/components/ColorSwatches/ColorSwatches.js +42 -33
- package/dist/components/ColorSwatches/ColorSwatches.js.map +1 -1
- package/dist/components/Combobox/Combobox.d.ts +13 -2
- package/dist/components/Combobox/Combobox.js +118 -129
- package/dist/components/Combobox/Combobox.js.map +1 -1
- package/dist/components/CommandPalette/CommandPalette.d.ts +14 -1
- package/dist/components/CommandPalette/CommandPalette.js +153 -109
- package/dist/components/CommandPalette/CommandPalette.js.map +1 -1
- package/dist/components/CommandPalette/index.d.ts +1 -1
- package/dist/components/CompareSlider/CompareSlider.js +14 -14
- package/dist/components/CompareSlider/CompareSlider.js.map +1 -1
- package/dist/components/Container/Container.d.ts +2 -2
- package/dist/components/Container/Container.js +17 -13
- package/dist/components/Container/Container.js.map +1 -1
- package/dist/components/ContextMenu/ContextMenu.d.ts +27 -13
- package/dist/components/ContextMenu/ContextMenu.js +64 -46
- package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
- package/dist/components/CopyButton/CopyButton.js +41 -41
- package/dist/components/CopyButton/CopyButton.js.map +1 -1
- package/dist/components/DataGrid/DataGrid.d.ts +135 -0
- package/dist/components/DataGrid/DataGrid.js +385 -0
- package/dist/components/DataGrid/DataGrid.js.map +1 -0
- package/dist/components/DataGrid/index.d.ts +1 -0
- package/dist/components/DateField/DateField.d.ts +4 -3
- package/dist/components/DateField/DateField.js +70 -59
- package/dist/components/DateField/DateField.js.map +1 -1
- package/dist/components/DeviceFrame/DeviceFrame.d.ts +63 -0
- package/dist/components/DeviceFrame/DeviceFrame.js +54 -0
- package/dist/components/DeviceFrame/DeviceFrame.js.map +1 -0
- package/dist/components/DeviceFrame/index.d.ts +1 -0
- package/dist/components/Dialog/Dialog.d.ts +10 -1
- package/dist/components/Dialog/Dialog.js +82 -81
- package/dist/components/Dialog/Dialog.js.map +1 -1
- package/dist/components/Disclosure/Disclosure.d.ts +15 -1
- package/dist/components/Disclosure/Disclosure.js +37 -30
- package/dist/components/Disclosure/Disclosure.js.map +1 -1
- package/dist/components/DocumentViewport/DocumentViewport.js +54 -57
- package/dist/components/DocumentViewport/DocumentViewport.js.map +1 -1
- package/dist/components/EmptyState/EmptyState.d.ts +5 -2
- package/dist/components/EmptyState/EmptyState.js.map +1 -1
- package/dist/components/ErrorBoundary/ErrorBoundary.d.ts +59 -0
- package/dist/components/ErrorBoundary/ErrorBoundary.js +53 -0
- package/dist/components/ErrorBoundary/ErrorBoundary.js.map +1 -0
- package/dist/components/ErrorBoundary/index.d.ts +1 -0
- package/dist/components/Field/Field.d.ts +38 -5
- package/dist/components/Field/Field.js +48 -42
- package/dist/components/Field/Field.js.map +1 -1
- package/dist/components/Field/index.d.ts +1 -1
- package/dist/components/FileDrop/FileDrop.d.ts +26 -1
- package/dist/components/FileDrop/FileDrop.js +150 -99
- package/dist/components/FileDrop/FileDrop.js.map +1 -1
- package/dist/components/FloatingToolbar/FloatingToolbar.js +80 -77
- package/dist/components/FloatingToolbar/FloatingToolbar.js.map +1 -1
- package/dist/components/Grid/Grid.d.ts +32 -11
- package/dist/components/Grid/Grid.js +78 -48
- package/dist/components/Grid/Grid.js.map +1 -1
- package/dist/components/Grid/index.d.ts +1 -1
- package/dist/components/Heading/Heading.d.ts +4 -2
- package/dist/components/Heading/Heading.js.map +1 -1
- package/dist/components/HighlightedText/HighlightedText.d.ts +40 -0
- package/dist/components/HighlightedText/HighlightedText.js +36 -0
- package/dist/components/HighlightedText/HighlightedText.js.map +1 -0
- package/dist/components/HighlightedText/index.d.ts +2 -0
- package/dist/components/HotkeyField/HotkeyField.d.ts +84 -0
- package/dist/components/HotkeyField/HotkeyField.js +161 -0
- package/dist/components/HotkeyField/HotkeyField.js.map +1 -0
- package/dist/components/HotkeyField/index.d.ts +1 -0
- package/dist/components/HoverCard/HoverCard.js +6 -6
- package/dist/components/HoverCard/HoverCard.js.map +1 -1
- package/dist/components/IconButton/IconButton.d.ts +16 -1
- package/dist/components/IconButton/IconButton.js +20 -15
- package/dist/components/IconButton/IconButton.js.map +1 -1
- package/dist/components/IconTile/IconTile.d.ts +45 -0
- package/dist/components/IconTile/IconTile.js +25 -0
- package/dist/components/IconTile/IconTile.js.map +1 -0
- package/dist/components/IconTile/index.d.ts +1 -0
- package/dist/components/Image/Image.js.map +1 -1
- package/dist/components/Inline/Inline.d.ts +3 -3
- package/dist/components/Inline/Inline.js +12 -22
- package/dist/components/Inline/Inline.js.map +1 -1
- package/dist/components/Kbd/Kbd.d.ts +0 -2
- package/dist/components/Kbd/Kbd.js +16 -22
- package/dist/components/Kbd/Kbd.js.map +1 -1
- package/dist/components/KeyValueEditor/KeyValueEditor.js +37 -36
- package/dist/components/KeyValueEditor/KeyValueEditor.js.map +1 -1
- package/dist/components/KeyValueEditor/bulk.js +3 -4
- package/dist/components/KeyValueEditor/bulk.js.map +1 -1
- package/dist/components/Link/Link.d.ts +9 -1
- package/dist/components/Link/Link.js +20 -18
- package/dist/components/Link/Link.js.map +1 -1
- package/dist/components/List/List.d.ts +73 -0
- package/dist/components/List/List.js +64 -0
- package/dist/components/List/List.js.map +1 -0
- package/dist/components/List/index.d.ts +1 -0
- package/dist/components/ListRow/ListRow.d.ts +105 -0
- package/dist/components/ListRow/ListRow.js +164 -0
- package/dist/components/ListRow/ListRow.js.map +1 -0
- package/dist/components/ListRow/index.d.ts +1 -0
- package/dist/components/LoadingDots/LoadingDots.d.ts +7 -2
- package/dist/components/LoadingDots/LoadingDots.js +28 -18
- package/dist/components/LoadingDots/LoadingDots.js.map +1 -1
- package/dist/components/Menu/Menu.d.ts +29 -11
- package/dist/components/Menu/Menu.js +204 -111
- package/dist/components/Menu/Menu.js.map +1 -1
- package/dist/components/Menubar/Menubar.d.ts +40 -0
- package/dist/components/Menubar/Menubar.js +82 -0
- package/dist/components/Menubar/Menubar.js.map +1 -0
- package/dist/components/Menubar/index.d.ts +1 -0
- package/dist/components/Notice/Notice.d.ts +11 -2
- package/dist/components/Notice/Notice.js +31 -27
- package/dist/components/Notice/Notice.js.map +1 -1
- package/dist/components/NumberField/NumberField.d.ts +8 -3
- package/dist/components/NumberField/NumberField.js +151 -100
- package/dist/components/NumberField/NumberField.js.map +1 -1
- package/dist/components/OptionList/OptionList.d.ts +102 -0
- package/dist/components/OptionList/OptionList.js +98 -0
- package/dist/components/OptionList/OptionList.js.map +1 -0
- package/dist/components/OptionList/index.d.ts +1 -0
- package/dist/components/OverlayFrame/OverlayFrame.d.ts +33 -0
- package/dist/components/OverlayFrame/OverlayFrame.js +20 -0
- package/dist/components/OverlayFrame/OverlayFrame.js.map +1 -0
- package/dist/components/OverlayFrame/index.d.ts +1 -0
- package/dist/components/PageHeader/PageHeader.d.ts +6 -0
- package/dist/components/PageHeader/PageHeader.js +27 -27
- package/dist/components/PageHeader/PageHeader.js.map +1 -1
- package/dist/components/Pagination/Pagination.js +31 -30
- package/dist/components/Pagination/Pagination.js.map +1 -1
- package/dist/components/PanZoomCanvas/PanZoomCanvas.d.ts +71 -4
- package/dist/components/PanZoomCanvas/PanZoomCanvas.js +197 -141
- package/dist/components/PanZoomCanvas/PanZoomCanvas.js.map +1 -1
- package/dist/components/PanZoomCanvas/index.d.ts +1 -1
- package/dist/components/PathField/PathField.d.ts +68 -0
- package/dist/components/PathField/PathField.js +67 -0
- package/dist/components/PathField/PathField.js.map +1 -0
- package/dist/components/PathField/index.d.ts +1 -0
- package/dist/components/Popover/Popover.d.ts +16 -3
- package/dist/components/Popover/Popover.js +51 -42
- package/dist/components/Popover/Popover.js.map +1 -1
- package/dist/components/ProgressBar/ProgressBar.d.ts +4 -3
- package/dist/components/ProgressBar/ProgressBar.js.map +1 -1
- package/dist/components/QRCode/QRCode.d.ts +56 -0
- package/dist/components/QRCode/QRCode.js +48 -0
- package/dist/components/QRCode/QRCode.js.map +1 -0
- package/dist/components/QRCode/index.d.ts +1 -0
- package/dist/components/RadioGroup/RadioGroup.js +32 -24
- package/dist/components/RadioGroup/RadioGroup.js.map +1 -1
- package/dist/components/RowActions/RowActions.d.ts +35 -0
- package/dist/components/RowActions/RowActions.js +38 -0
- package/dist/components/RowActions/RowActions.js.map +1 -0
- package/dist/components/RowActions/index.d.ts +1 -0
- package/dist/components/ScrollArea/ScrollArea.d.ts +55 -0
- package/dist/components/ScrollArea/ScrollArea.js +55 -0
- package/dist/components/ScrollArea/ScrollArea.js.map +1 -0
- package/dist/components/ScrollArea/index.d.ts +1 -0
- package/dist/components/SearchField/SearchField.d.ts +17 -0
- package/dist/components/SearchField/SearchField.js +31 -17
- package/dist/components/SearchField/SearchField.js.map +1 -1
- package/dist/components/SearchField/index.d.ts +1 -1
- package/dist/components/Section/Section.d.ts +57 -0
- package/dist/components/Section/Section.js +27 -0
- package/dist/components/Section/Section.js.map +1 -0
- package/dist/components/Section/index.d.ts +1 -0
- package/dist/components/SegmentedControl/SegmentedControl.d.ts +6 -3
- package/dist/components/SegmentedControl/SegmentedControl.js +24 -20
- package/dist/components/SegmentedControl/SegmentedControl.js.map +1 -1
- package/dist/components/Select/Select.d.ts +22 -6
- package/dist/components/Select/Select.js +155 -156
- package/dist/components/Select/Select.js.map +1 -1
- package/dist/components/SelectionFrame/frame-math.js +19 -20
- package/dist/components/SelectionFrame/frame-math.js.map +1 -1
- package/dist/components/Sheet/Sheet.js +12 -7
- package/dist/components/Sheet/Sheet.js.map +1 -1
- package/dist/components/SideNav/SideNav.d.ts +13 -1
- package/dist/components/SideNav/SideNav.js +100 -91
- package/dist/components/SideNav/SideNav.js.map +1 -1
- package/dist/components/SignaturePad/SignaturePad.js +63 -62
- package/dist/components/SignaturePad/SignaturePad.js.map +1 -1
- package/dist/components/SignaturePad/ink.js +0 -1
- package/dist/components/SignaturePad/ink.js.map +1 -1
- package/dist/components/SiteFooter/SiteFooter.d.ts +66 -0
- package/dist/components/SiteFooter/SiteFooter.js +80 -0
- package/dist/components/SiteFooter/SiteFooter.js.map +1 -0
- package/dist/components/SiteFooter/index.d.ts +1 -0
- package/dist/components/SiteHeader/SiteHeader.d.ts +78 -0
- package/dist/components/SiteHeader/SiteHeader.js +114 -0
- package/dist/components/SiteHeader/SiteHeader.js.map +1 -0
- package/dist/components/SiteHeader/index.d.ts +1 -0
- package/dist/components/SkipLink/SkipLink.d.ts +42 -0
- package/dist/components/SkipLink/SkipLink.js +43 -0
- package/dist/components/SkipLink/SkipLink.js.map +1 -0
- package/dist/components/SkipLink/index.d.ts +1 -0
- package/dist/components/Slider/Slider.js +88 -91
- package/dist/components/Slider/Slider.js.map +1 -1
- package/dist/components/SortButton/SortButton.d.ts +36 -0
- package/dist/components/SortButton/SortButton.js +35 -0
- package/dist/components/SortButton/SortButton.js.map +1 -0
- package/dist/components/SortButton/index.d.ts +1 -0
- package/dist/components/SortableList/SortableList.js +146 -120
- package/dist/components/SortableList/SortableList.js.map +1 -1
- package/dist/components/SplitPane/SplitPane.d.ts +32 -12
- package/dist/components/SplitPane/SplitPane.js +105 -59
- package/dist/components/SplitPane/SplitPane.js.map +1 -1
- package/dist/components/Stack/Stack.d.ts +16 -7
- package/dist/components/Stack/Stack.js +32 -18
- package/dist/components/Stack/Stack.js.map +1 -1
- package/dist/components/Stack/index.d.ts +1 -1
- package/dist/components/Stat/Stat.d.ts +88 -0
- package/dist/components/Stat/Stat.js +105 -0
- package/dist/components/Stat/Stat.js.map +1 -0
- package/dist/components/Stat/index.d.ts +1 -0
- package/dist/components/StatusBar/StatusBar.d.ts +95 -0
- package/dist/components/StatusBar/StatusBar.js +110 -0
- package/dist/components/StatusBar/StatusBar.js.map +1 -0
- package/dist/components/StatusBar/index.d.ts +1 -0
- package/dist/components/Steps/Steps.d.ts +10 -4
- package/dist/components/Steps/Steps.js +31 -30
- package/dist/components/Steps/Steps.js.map +1 -1
- package/dist/components/Switch/Switch.d.ts +4 -4
- package/dist/components/Switch/Switch.js +18 -7
- package/dist/components/Switch/Switch.js.map +1 -1
- package/dist/components/Table/Table.d.ts +6 -6
- package/dist/components/Table/Table.js +73 -102
- package/dist/components/Table/Table.js.map +1 -1
- package/dist/components/Tabs/Tabs.d.ts +55 -6
- package/dist/components/Tabs/Tabs.js +288 -169
- package/dist/components/Tabs/Tabs.js.map +1 -1
- package/dist/components/TagInput/TagInput.d.ts +10 -2
- package/dist/components/TagInput/TagInput.js +137 -148
- package/dist/components/TagInput/TagInput.js.map +1 -1
- package/dist/components/Text/Text.d.ts +6 -0
- package/dist/components/Text/Text.js +18 -17
- package/dist/components/Text/Text.js.map +1 -1
- package/dist/components/TextArea/TextArea.d.ts +37 -6
- package/dist/components/TextArea/TextArea.js +200 -72
- package/dist/components/TextArea/TextArea.js.map +1 -1
- package/dist/components/TextArea/index.d.ts +1 -1
- package/dist/components/TextField/TextField.d.ts +22 -6
- package/dist/components/TextField/TextField.js +59 -53
- package/dist/components/TextField/TextField.js.map +1 -1
- package/dist/components/ThemeToggle/ThemeToggle.d.ts +7 -1
- package/dist/components/ThemeToggle/ThemeToggle.js +33 -30
- package/dist/components/ThemeToggle/ThemeToggle.js.map +1 -1
- package/dist/components/TimeField/TimeField.d.ts +4 -3
- package/dist/components/TimeField/TimeField.js +197 -183
- package/dist/components/TimeField/TimeField.js.map +1 -1
- package/dist/components/TitleBar/TitleBar.d.ts +91 -0
- package/dist/components/TitleBar/TitleBar.js +80 -0
- package/dist/components/TitleBar/TitleBar.js.map +1 -0
- package/dist/components/TitleBar/index.d.ts +1 -0
- package/dist/components/Toast/Toast.d.ts +17 -2
- package/dist/components/Toast/Toast.js +166 -147
- package/dist/components/Toast/Toast.js.map +1 -1
- package/dist/components/Toast/index.d.ts +1 -1
- package/dist/components/Toolbar/Toolbar.js +11 -12
- package/dist/components/Toolbar/Toolbar.js.map +1 -1
- package/dist/components/Tooltip/Tooltip.d.ts +23 -1
- package/dist/components/Tooltip/Tooltip.js +50 -31
- package/dist/components/Tooltip/Tooltip.js.map +1 -1
- package/dist/components/Tree/Tree.d.ts +92 -11
- package/dist/components/Tree/Tree.js +332 -164
- package/dist/components/Tree/Tree.js.map +1 -1
- package/dist/components/VirtualList/VirtualList.d.ts +27 -4
- package/dist/components/VirtualList/VirtualList.js +179 -145
- package/dist/components/VirtualList/VirtualList.js.map +1 -1
- package/dist/components/VirtualList/index.d.ts +1 -1
- package/dist/components/VisuallyHidden/VisuallyHidden.d.ts +24 -0
- package/dist/components/VisuallyHidden/VisuallyHidden.js +17 -0
- package/dist/components/VisuallyHidden/VisuallyHidden.js.map +1 -0
- package/dist/components/VisuallyHidden/index.d.ts +1 -0
- package/dist/components/ZoomControls/ZoomControls.d.ts +6 -2
- package/dist/components/ZoomControls/ZoomControls.js +37 -37
- package/dist/components/ZoomControls/ZoomControls.js.map +1 -1
- package/dist/entries/tokens.js +22 -16
- package/dist/foundations/ChoiceBase/ChoiceBase.js +15 -13
- package/dist/foundations/ChoiceBase/ChoiceBase.js.map +1 -1
- package/dist/foundations/HiddenValue/HiddenValue.js +5 -5
- package/dist/foundations/HiddenValue/HiddenValue.js.map +1 -1
- package/dist/foundations/Icon/Icon.d.ts +6 -1
- package/dist/foundations/Icon/Icon.js +15 -14
- package/dist/foundations/Icon/Icon.js.map +1 -1
- package/dist/foundations/LiveRegion/LiveRegion.d.ts +33 -0
- package/dist/foundations/LiveRegion/LiveRegion.js +29 -0
- package/dist/foundations/LiveRegion/LiveRegion.js.map +1 -0
- package/dist/foundations/LiveRegion/index.d.ts +1 -0
- package/dist/foundations/canvas-size.d.ts +14 -0
- package/dist/foundations/canvas-size.js +32 -0
- package/dist/foundations/canvas-size.js.map +1 -0
- package/dist/foundations/dir.js +0 -1
- package/dist/foundations/dir.js.map +1 -1
- package/dist/foundations/draft.d.ts +14 -0
- package/dist/foundations/draft.js +22 -0
- package/dist/foundations/draft.js.map +1 -0
- package/dist/foundations/edge.d.ts +20 -0
- package/dist/foundations/edge.js +26 -0
- package/dist/foundations/edge.js.map +1 -0
- package/dist/foundations/focus.d.ts +5 -0
- package/dist/foundations/focus.js +10 -0
- package/dist/foundations/focus.js.map +1 -0
- package/dist/foundations/hotkey.d.ts +23 -1
- package/dist/foundations/hotkey.js +48 -26
- package/dist/foundations/hotkey.js.map +1 -1
- package/dist/foundations/icon-size.d.ts +7 -0
- package/dist/foundations/icon-size.js +6 -0
- package/dist/foundations/icon-size.js.map +1 -0
- package/dist/foundations/image-outcome.d.ts +8 -3
- package/dist/foundations/image-outcome.js +12 -8
- package/dist/foundations/image-outcome.js.map +1 -1
- package/dist/foundations/keys.js +12 -13
- package/dist/foundations/keys.js.map +1 -1
- package/dist/foundations/layout.d.ts +81 -0
- package/dist/foundations/layout.js +29 -0
- package/dist/foundations/layout.js.map +1 -0
- package/dist/foundations/listbox.d.ts +47 -2
- package/dist/foundations/listbox.js +56 -25
- package/dist/foundations/listbox.js.map +1 -1
- package/dist/foundations/math.d.ts +25 -0
- package/dist/foundations/math.js +14 -3
- package/dist/foundations/math.js.map +1 -1
- package/dist/foundations/media-query.d.ts +5 -0
- package/dist/foundations/media-query.js +14 -0
- package/dist/foundations/media-query.js.map +1 -0
- package/dist/foundations/motion.d.ts +12 -0
- package/dist/foundations/motion.js +21 -0
- package/dist/foundations/motion.js.map +1 -0
- package/dist/foundations/option-icon.d.ts +3 -1
- package/dist/foundations/option-icon.js +6 -6
- package/dist/foundations/option-icon.js.map +1 -1
- package/dist/foundations/printing.d.ts +6 -0
- package/dist/foundations/printing.js +17 -0
- package/dist/foundations/printing.js.map +1 -0
- package/dist/foundations/qr.d.ts +42 -0
- package/dist/foundations/qr.js +245 -0
- package/dist/foundations/qr.js.map +1 -0
- package/dist/foundations/refs.d.ts +8 -0
- package/dist/foundations/refs.js +14 -0
- package/dist/foundations/refs.js.map +1 -0
- package/dist/foundations/reorder.js +5 -6
- package/dist/foundations/reorder.js.map +1 -1
- package/dist/foundations/roving-focus.d.ts +10 -0
- package/dist/foundations/roving-focus.js +34 -31
- package/dist/foundations/roving-focus.js.map +1 -1
- package/dist/foundations/scroll-align.d.ts +11 -0
- package/dist/foundations/scroll-align.js +8 -0
- package/dist/foundations/scroll-align.js.map +1 -0
- package/dist/foundations/sort.d.ts +13 -0
- package/dist/foundations/sort.js +26 -0
- package/dist/foundations/sort.js.map +1 -0
- package/dist/foundations/text-match.d.ts +11 -0
- package/dist/foundations/text-match.js +20 -0
- package/dist/foundations/text-match.js.map +1 -0
- package/dist/foundations/tone-icons.js +4 -5
- package/dist/foundations/tone-icons.js.map +1 -1
- package/dist/foundations/use-follow.d.ts +29 -0
- package/dist/foundations/use-follow.js +51 -0
- package/dist/foundations/use-follow.js.map +1 -0
- package/dist/foundations/virtual-window.d.ts +22 -5
- package/dist/foundations/virtual-window.js +58 -54
- package/dist/foundations/virtual-window.js.map +1 -1
- package/dist/foundations/zoom-gestures.d.ts +23 -1
- package/dist/foundations/zoom-gestures.js +123 -84
- package/dist/foundations/zoom-gestures.js.map +1 -1
- package/dist/foundations/zoom.d.ts +10 -4
- package/dist/foundations/zoom.js +16 -17
- package/dist/foundations/zoom.js.map +1 -1
- package/dist/icons/book-marked.d.ts +2 -0
- package/dist/icons/book-marked.js +14 -0
- package/dist/icons/book-marked.js.map +1 -0
- package/dist/icons/boxes.d.ts +2 -0
- package/dist/icons/boxes.js +34 -0
- package/dist/icons/boxes.js.map +1 -0
- package/dist/icons/by-name.d.ts +11 -0
- package/dist/icons/by-name.js +11 -0
- package/dist/icons/by-name.js.map +1 -0
- package/dist/icons/cable.d.ts +2 -0
- package/dist/icons/cable.js +14 -0
- package/dist/icons/cable.js.map +1 -0
- package/dist/icons/calendar-days.d.ts +2 -0
- package/dist/icons/calendar-days.js +24 -0
- package/dist/icons/calendar-days.js.map +1 -0
- package/dist/icons/check-check.d.ts +2 -0
- package/dist/icons/check-check.js +17 -0
- package/dist/icons/check-check.js.map +1 -0
- package/dist/icons/check-square.d.ts +2 -0
- package/dist/icons/check-square.js +14 -0
- package/dist/icons/check-square.js.map +1 -0
- package/dist/icons/clipboard-paste.d.ts +2 -0
- package/dist/icons/clipboard-paste.js +30 -0
- package/dist/icons/clipboard-paste.js.map +1 -0
- package/dist/icons/crescent.d.ts +2 -0
- package/dist/icons/crescent.js +14 -0
- package/dist/icons/crescent.js.map +1 -0
- package/dist/icons/facet.d.ts +274 -0
- package/dist/icons/facet.js +830 -0
- package/dist/icons/facet.js.map +1 -0
- package/dist/icons/file-plus.d.ts +2 -0
- package/dist/icons/file-plus.js +14 -0
- package/dist/icons/file-plus.js.map +1 -0
- package/dist/icons/file-question.d.ts +2 -0
- package/dist/icons/file-question.js +14 -0
- package/dist/icons/file-question.js.map +1 -0
- package/dist/icons/file-search.d.ts +2 -0
- package/dist/icons/file-search.js +24 -0
- package/dist/icons/file-search.js.map +1 -0
- package/dist/icons/function.d.ts +2 -0
- package/dist/icons/function.js +20 -0
- package/dist/icons/function.js.map +1 -0
- package/dist/icons/gauge.d.ts +2 -0
- package/dist/icons/gauge.js +14 -0
- package/dist/icons/gauge.js.map +1 -0
- package/dist/icons/hourglass.d.ts +2 -0
- package/dist/icons/hourglass.js +14 -0
- package/dist/icons/hourglass.js.map +1 -0
- package/dist/icons/index.d.ts +1 -240
- package/dist/icons/index.js +546 -478
- package/dist/icons/kaaba.d.ts +2 -0
- package/dist/icons/kaaba.js +14 -0
- package/dist/icons/kaaba.js.map +1 -0
- package/dist/icons/keywords.d.ts +35 -1
- package/dist/icons/keywords.js +274 -1
- package/dist/icons/keywords.js.map +1 -1
- package/dist/icons/languages.d.ts +2 -0
- package/dist/icons/languages.js +14 -0
- package/dist/icons/languages.js.map +1 -0
- package/dist/icons/list-tree.d.ts +2 -0
- package/dist/icons/list-tree.js +14 -0
- package/dist/icons/list-tree.js.map +1 -0
- package/dist/icons/loader.d.ts +2 -0
- package/dist/icons/loader.js +14 -0
- package/dist/icons/loader.js.map +1 -0
- package/dist/icons/monitor-down.d.ts +2 -0
- package/dist/icons/monitor-down.js +24 -0
- package/dist/icons/monitor-down.js.map +1 -0
- package/dist/icons/mosque.d.ts +2 -0
- package/dist/icons/mosque.js +14 -0
- package/dist/icons/mosque.js.map +1 -0
- package/dist/icons/panel-right.d.ts +2 -0
- package/dist/icons/panel-right.js +20 -0
- package/dist/icons/panel-right.js.map +1 -0
- package/dist/icons/party-popper.d.ts +2 -0
- package/dist/icons/party-popper.js +14 -0
- package/dist/icons/party-popper.js.map +1 -0
- package/dist/icons/power-off.d.ts +2 -0
- package/dist/icons/power-off.js +14 -0
- package/dist/icons/power-off.js.map +1 -0
- package/dist/icons/prayer-beads.d.ts +2 -0
- package/dist/icons/prayer-beads.js +67 -0
- package/dist/icons/prayer-beads.js.map +1 -0
- package/dist/icons/qr-code.d.ts +2 -0
- package/dist/icons/qr-code.js +38 -0
- package/dist/icons/qr-code.js.map +1 -0
- package/dist/icons/refresh-cw.d.ts +2 -0
- package/dist/icons/refresh-cw.js +14 -0
- package/dist/icons/refresh-cw.js.map +1 -0
- package/dist/icons/rocket.d.ts +2 -0
- package/dist/icons/rocket.js +21 -0
- package/dist/icons/rocket.js.map +1 -0
- package/dist/icons/rows.d.ts +2 -0
- package/dist/icons/rows.js +20 -0
- package/dist/icons/rows.js.map +1 -0
- package/dist/icons/scissors.d.ts +2 -0
- package/dist/icons/scissors.js +26 -0
- package/dist/icons/scissors.js.map +1 -0
- package/dist/icons/shield-question.d.ts +2 -0
- package/dist/icons/shield-question.js +14 -0
- package/dist/icons/shield-question.js.map +1 -0
- package/dist/icons/square-plus.d.ts +2 -0
- package/dist/icons/square-plus.js +20 -0
- package/dist/icons/square-plus.js.map +1 -0
- package/dist/icons/text-select.d.ts +2 -0
- package/dist/icons/text-select.js +14 -0
- package/dist/icons/text-select.js.map +1 -0
- package/dist/icons/types.d.ts +1 -1
- package/dist/icons/types.js +2 -1
- package/dist/icons/types.js.map +1 -1
- package/dist/icons/window-maximize.d.ts +2 -0
- package/dist/icons/window-maximize.js +14 -0
- package/dist/icons/window-maximize.js.map +1 -0
- package/dist/icons/window-restore.d.ts +2 -0
- package/dist/icons/window-restore.js +20 -0
- package/dist/icons/window-restore.js.map +1 -0
- package/dist/index.d.ts +38 -9
- package/dist/index.js +326 -249
- package/dist/overlay/dismiss.js +15 -13
- package/dist/overlay/dismiss.js.map +1 -1
- package/dist/overlay/floating.d.ts +7 -2
- package/dist/overlay/floating.js +29 -21
- package/dist/overlay/floating.js.map +1 -1
- package/dist/overlay/listbox-layer.d.ts +3 -2
- package/dist/overlay/listbox-layer.js.map +1 -1
- package/dist/overlay/position.d.ts +5 -2
- package/dist/overlay/position.js +19 -19
- package/dist/overlay/position.js.map +1 -1
- package/dist/overlay/toast-host.js +3 -2
- package/dist/overlay/toast-host.js.map +1 -1
- package/dist/overlay/use-anchored-position.d.ts +2 -2
- package/dist/overlay/use-anchored-position.js +25 -25
- package/dist/overlay/use-anchored-position.js.map +1 -1
- package/dist/styles/announcer.css +1 -1
- package/dist/styles/app-shell.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/button.css +1 -1
- package/dist/styles/calendar.css +1 -1
- package/dist/styles/card.css +1 -1
- package/dist/styles/chat-message.css +1 -0
- package/dist/styles/checkbox.css +1 -1
- package/dist/styles/choice-base.css +1 -0
- package/dist/styles/choice.css +1 -1
- package/dist/styles/code-block.css +1 -1
- package/dist/styles/color-field.css +1 -1
- package/dist/styles/combobox.css +1 -1
- package/dist/styles/command-palette.css +1 -1
- package/dist/styles/copy-button.css +1 -1
- package/dist/styles/data-grid.css +1 -0
- package/dist/styles/date-field.css +1 -1
- package/dist/styles/device-frame.css +1 -0
- package/dist/styles/dialog.css +1 -1
- package/dist/styles/disclosure.css +1 -1
- package/dist/styles/error-boundary.css +1 -0
- package/dist/styles/field.css +1 -1
- package/dist/styles/file-drop.css +1 -1
- package/dist/styles/floating-toolbar.css +1 -1
- package/dist/styles/generated-css.d.ts +1 -1
- package/dist/styles/generated-css.js +3 -3
- package/dist/styles/generated-css.js.map +1 -1
- package/dist/styles/grid.css +1 -1
- package/dist/styles/heading.css +1 -1
- package/dist/styles/highlighted-text.css +1 -0
- package/dist/styles/hotkey-field.css +1 -0
- package/dist/styles/icon-tile.css +1 -0
- package/dist/styles/icon.css +1 -1
- package/dist/styles/inline.css +1 -0
- package/dist/styles/key-value-editor.css +1 -1
- package/dist/styles/link.css +1 -1
- package/dist/styles/list-row.css +1 -0
- package/dist/styles/list.css +1 -0
- package/dist/styles/loading-dots.css +1 -1
- package/dist/styles/manifest.json +852 -0
- package/dist/styles/menu.css +1 -1
- package/dist/styles/menubar.css +1 -0
- package/dist/styles/notice.css +1 -1
- package/dist/styles/number-field.css +1 -1
- package/dist/styles/option-list.css +1 -0
- package/dist/styles/overlay-frame.css +1 -0
- package/dist/styles/pagination.css +1 -1
- package/dist/styles/pan-zoom-canvas.css +1 -1
- package/dist/styles/path-field.css +1 -0
- package/dist/styles/popover.css +1 -1
- package/dist/styles/progress-bar.css +1 -1
- package/dist/styles/qr-code.css +1 -0
- package/dist/styles/radio-group.css +1 -1
- package/dist/styles/row-actions.css +1 -0
- package/dist/styles/scroll-area.css +1 -0
- package/dist/styles/search-field.css +1 -1
- package/dist/styles/section.css +1 -0
- package/dist/styles/segmented-control.css +1 -1
- package/dist/styles/select.css +1 -1
- package/dist/styles/sheet.css +1 -1
- package/dist/styles/side-nav.css +1 -1
- package/dist/styles/site-footer.css +1 -0
- package/dist/styles/site-header.css +1 -0
- package/dist/styles/skip-link.css +1 -0
- package/dist/styles/sort-button.css +1 -0
- package/dist/styles/sortable-list.css +1 -1
- package/dist/styles/split-pane.css +1 -1
- package/dist/styles/stack.css +1 -1
- package/dist/styles/stat.css +1 -0
- package/dist/styles/status-bar.css +1 -0
- package/dist/styles/steps.css +1 -1
- package/dist/styles/switch.css +1 -0
- package/dist/styles/table.css +1 -1
- package/dist/styles/tabs.css +1 -1
- package/dist/styles/tag-input.css +1 -1
- package/dist/styles/text-area.css +1 -1
- package/dist/styles/text-field.css +1 -1
- package/dist/styles/text.css +1 -1
- package/dist/styles/time-field.css +1 -1
- package/dist/styles/title-bar.css +1 -0
- package/dist/styles/toast.css +1 -1
- package/dist/styles/tokens.css +3 -3
- package/dist/styles/tree.css +1 -1
- package/dist/styles/virtual-list.css +1 -1
- package/dist/styles/visually-hidden.css +1 -0
- package/dist/styles.css +3 -3
- package/dist/theme/CynosureTheme.d.ts +7 -3
- package/dist/theme/CynosureTheme.js +47 -31
- package/dist/theme/CynosureTheme.js.map +1 -1
- package/dist/theme/index.d.ts +1 -0
- package/dist/theme/theme-context.d.ts +9 -0
- package/dist/theme/theme-context.js +8 -0
- package/dist/theme/theme-context.js.map +1 -0
- package/dist/theme/theme-init-script.js +0 -1
- package/dist/theme/theme-init-script.js.map +1 -1
- package/dist/theme/use-color-mode.d.ts +3 -2
- package/dist/theme/use-color-mode.js +35 -38
- package/dist/theme/use-color-mode.js.map +1 -1
- package/dist/theme/use-cynosure-theme.d.ts +18 -0
- package/dist/theme/use-cynosure-theme.js +23 -0
- package/dist/theme/use-cynosure-theme.js.map +1 -0
- package/dist/tokens/chart-themes.d.ts +38 -0
- package/dist/tokens/chart-themes.js +35 -0
- package/dist/tokens/chart-themes.js.map +1 -0
- package/dist/tokens/create-theme.d.ts +11 -1
- package/dist/tokens/create-theme.js +194 -125
- package/dist/tokens/create-theme.js.map +1 -1
- package/dist/tokens/defaults.d.ts +3 -3
- package/dist/tokens/defaults.js +1 -0
- package/dist/tokens/defaults.js.map +1 -1
- package/dist/tokens/editor-themes.d.ts +9 -2
- package/dist/tokens/editor-themes.js +43 -42
- package/dist/tokens/editor-themes.js.map +1 -1
- package/dist/tokens/index.d.ts +3 -1
- package/dist/tokens/named-themes.d.ts +41 -0
- package/dist/tokens/named-themes.js +118 -0
- package/dist/tokens/named-themes.js.map +1 -0
- package/dist/tokens/schema.d.ts +24 -1
- package/dist/tokens/schema.js +13 -0
- package/dist/tokens/schema.js.map +1 -0
- package/dist/tokens/to-css.js +34 -31
- package/dist/tokens/to-css.js.map +1 -1
- package/package.json +15 -6
- package/dist/components/Checkbox/ChoiceRow.d.ts +0 -39
- package/dist/components/Checkbox/ChoiceRow.js +0 -58
- package/dist/components/Checkbox/ChoiceRow.js.map +0 -1
- package/dist/components/Stack/space.d.ts +0 -18
- package/dist/components/Stack/space.js +0 -12
- package/dist/components/Stack/space.js.map +0 -1
- package/dist/styles/hidden-value.css +0 -1
- package/dist/styles/iconbutton.css +0 -1
|
@@ -1,50 +1,69 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
2
|
+
import { useClientLayoutEffect as L } from "../../foundations/client-layout-effect.js";
|
|
3
|
+
import { useDismiss as D } from "../../overlay/dismiss.js";
|
|
4
|
+
import { usePopover as F } from "../../overlay/floating.js";
|
|
5
|
+
import { useAnchoredPosition as N } from "../../overlay/use-anchored-position.js";
|
|
6
|
+
import { cloneElement as O, useCallback as x, useEffect as g, useId as W, useRef as o, useState as R } from "react";
|
|
7
|
+
import { jsx as $, jsxs as k } from "react/jsx-runtime";
|
|
8
|
+
function w(u, l) {
|
|
9
|
+
const [b, v] = R(!1), e = o(null);
|
|
10
|
+
return L(() => {
|
|
11
|
+
const a = u ? l() : null, n = a && typeof u == "function" ? u(a) : a, s = () => {
|
|
12
|
+
const c = e.current?.el;
|
|
13
|
+
v(!!c && c.scrollWidth > c.clientWidth);
|
|
14
|
+
};
|
|
15
|
+
n !== (e.current?.el ?? null) && (e.current?.observer.disconnect(), e.current = n ? {
|
|
16
|
+
el: n,
|
|
17
|
+
observer: new ResizeObserver(s)
|
|
18
|
+
} : null, e.current?.observer.observe(n)), s();
|
|
19
|
+
}), g(() => () => e.current?.observer.disconnect(), []), b;
|
|
20
|
+
}
|
|
21
|
+
function H({ content: u, children: l, placement: b = "top", delay: v = 300, className: e, disabled: a = !1, describe: n = !0, whenTruncated: s }) {
|
|
22
|
+
const c = `cy-tip-${W().replace(/:/g, "")}`, h = o(null), f = o(null), t = o(void 0), [y, p] = R(!1), E = () => h.current?.firstElementChild ?? h.current, P = o(null), m = o(!1), B = w(s, E), i = a || (s ? !B : !1), T = n && !s, C = o(i);
|
|
23
|
+
C.current = i;
|
|
24
|
+
const j = x((r) => {
|
|
25
|
+
clearTimeout(t.current), !C.current && (t.current = setTimeout(() => p(!0), r));
|
|
26
|
+
}, []), d = x((r = 0) => {
|
|
27
|
+
clearTimeout(t.current), t.current = setTimeout(() => p(!1), r);
|
|
12
28
|
}, []);
|
|
13
|
-
return
|
|
14
|
-
|
|
15
|
-
}),
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
29
|
+
return g(() => () => clearTimeout(t.current), []), g(() => {
|
|
30
|
+
i && (clearTimeout(t.current), p(!1));
|
|
31
|
+
}, [i]), L(() => {
|
|
32
|
+
P.current = E();
|
|
33
|
+
}), F(f, y), D({
|
|
34
|
+
open: y,
|
|
35
|
+
onClose: () => p(!1),
|
|
36
|
+
inside: [P, f],
|
|
19
37
|
outside: !1
|
|
20
|
-
}),
|
|
21
|
-
ref:
|
|
22
|
-
className: "cy-tooltip-anchor",
|
|
23
|
-
onPointerEnter: (
|
|
24
|
-
onPointerLeave: () =>
|
|
38
|
+
}), N(P, f, y, b), /* @__PURE__ */ k("span", {
|
|
39
|
+
ref: h,
|
|
40
|
+
className: e ? `cy-tooltip-anchor ${e}` : "cy-tooltip-anchor",
|
|
41
|
+
onPointerEnter: (r) => r.pointerType !== "touch" && j(v),
|
|
42
|
+
onPointerLeave: () => d(120),
|
|
25
43
|
onPointerDown: () => {
|
|
26
|
-
|
|
44
|
+
m.current = !0, d();
|
|
27
45
|
},
|
|
28
|
-
onFocus: (
|
|
29
|
-
!
|
|
46
|
+
onFocus: (r) => {
|
|
47
|
+
!m.current && r.target.matches(":focus-visible") && j(0), m.current = !1;
|
|
30
48
|
},
|
|
31
49
|
onBlur: () => {
|
|
32
|
-
|
|
50
|
+
m.current = !1, d();
|
|
33
51
|
},
|
|
34
|
-
children: [
|
|
35
|
-
ref:
|
|
36
|
-
id:
|
|
52
|
+
children: [i || !T ? l : O(l, { "aria-describedby": [l.props["aria-describedby"], c].filter(Boolean).join(" ") }), !i && /* @__PURE__ */ $("span", {
|
|
53
|
+
ref: f,
|
|
54
|
+
id: c,
|
|
37
55
|
role: "tooltip",
|
|
56
|
+
"aria-hidden": T ? void 0 : !0,
|
|
38
57
|
className: "cy-tooltip",
|
|
39
58
|
popover: "manual",
|
|
40
59
|
onPointerEnter: () => clearTimeout(t.current),
|
|
41
|
-
onPointerLeave: () =>
|
|
42
|
-
children:
|
|
60
|
+
onPointerLeave: () => d(120),
|
|
61
|
+
children: u
|
|
43
62
|
})]
|
|
44
63
|
});
|
|
45
64
|
}
|
|
46
65
|
export {
|
|
47
|
-
|
|
66
|
+
H as Tooltip
|
|
48
67
|
};
|
|
49
68
|
|
|
50
69
|
//# sourceMappingURL=Tooltip.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Tooltip.js","names":["useDismiss","usePopover","useAnchoredPosition","cloneElement","useCallback","useEffect","useId","useLayoutEffect","useRef","useState","jsx","jsxs","Tooltip","content","children","placement","delay","id","anchor","tip","timer","open","setOpen","trigger","triggerRef","pointerFocus","show","wait","hide"],"sources":["../../../src/components/Tooltip/Tooltip.tsx"],"sourcesContent":["import {\n cloneElement,\n type ReactElement,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition } from \"../../overlay/use-anchored-position.js\";\n\nexport interface TooltipTokens {\n bg: string;\n ink: string;\n radius: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tooltip: TooltipTokens;\n }\n}\n\nexport interface TooltipProps {\n /** Short supplementary text; it becomes the trigger's accessible description. */\n content: ReactNode;\n /** One focusable element (Button, IconButton, Link…). */\n children: ReactElement<Record<string, unknown>>;\n /** Preferred side; flips when it does not fit. Default \"top\". */\n placement?: Placement;\n /** Hover delay in ms (focus opens immediately). */\n delay?: number;\n}\n\n/**\n * Tooltip in the top layer (Popover API), positioned against its trigger. Opens on hover after `delay` and on\n * keyboard focus; dismissible with Escape; hoverable; never opens on touch (WCAG 1.4.13).\n */\nexport function Tooltip({ content, children, placement = \"top\", delay = 300 }: TooltipProps) {\n const id = `cy-tip-${useId().replace(/:/g, \"\")}`;\n const anchor = useRef<HTMLSpanElement>(null);\n const tip = useRef<HTMLSpanElement>(null);\n const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n const [open, setOpen] = useState(false);\n const trigger = () => (anchor.current?.firstElementChild as HTMLElement | null) ?? anchor.current;\n const triggerRef = useRef<HTMLElement | null>(null);\n // Focus that follows a pointer press (mouse or touch) is not keyboard focus: hover handles mouse, touch never opens.\n const pointerFocus = useRef(false);\n\n const show = useCallback((wait: number) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(true), wait);\n }, []);\n const hide = useCallback((wait = 0) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(false), wait);\n }, []);\n\n useEffect(() => () => clearTimeout(timer.current), []);\n useLayoutEffect(() => {\n triggerRef.current = trigger();\n });\n usePopover(tip, open);\n // Escape closes the tooltip first when it sits inside a Popover, Menu or Dialog (shared layer stack).\n useDismiss({ open, onClose: () => setOpen(false), inside: [triggerRef, tip], outside: false });\n useAnchoredPosition(triggerRef, tip, open, placement);\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: delegated hover/focus listeners for the interactive child\n <span\n ref={anchor}\n className=\"cy-tooltip-anchor\"\n onPointerEnter={(e) => e.pointerType !== \"touch\" && show(delay)}\n onPointerLeave={() => hide(120)}\n onPointerDown={() => {\n pointerFocus.current = true;\n hide();\n }}\n onFocus={(e) => {\n if (!pointerFocus.current && (e.target as HTMLElement).matches(\":focus-visible\")) show(0);\n pointerFocus.current = false;\n }}\n onBlur={() => {\n pointerFocus.current = false;\n hide();\n }}\n >\n {cloneElement(children, {\n \"aria-describedby\": [children.props[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n })}\n <span\n ref={tip}\n id={id}\n role=\"tooltip\"\n className=\"cy-tooltip\"\n {...{ popover: \"manual\" }}\n onPointerEnter={() => clearTimeout(timer.current)}\n onPointerLeave={() => hide(120)}\n >\n {content}\n </span>\n </span>\n );\n}\n"],"mappings":";;;;;;AA4CA,SAAgBY,EAAQ,EAAE,SAAAC,GAAS,UAAAC,GAAU,WAAAC,IAAY,OAAO,OAAAC,IAAQ,IAAA,GAAqB;AAC3F,QAAMC,IAAK,UAAUX,EAAM,EAAE,QAAQ,MAAM,EAAE,CAAA,IACvCY,IAASV,EAAwB,IAAI,GACrCW,IAAMX,EAAwB,IAAI,GAClCY,IAAQZ,EAAkD,MAAS,GACnE,CAACa,GAAMC,CAAA,IAAWb,EAAS,EAAK,GAChCc,IAAA,MAAiBL,EAAO,SAAS,qBAA4CA,EAAO,SACpFM,IAAahB,EAA2B,IAAI,GAE5CiB,IAAejB,EAAO,EAAK,GAE3BkB,IAAOtB,EAAA,CAAauB,MAAiB;AACzC,iBAAaP,EAAM,OAAO,GAC1BA,EAAM,UAAU,WAAA,MAAiBE,EAAQ,EAAI,GAAGK,CAAI;AAAA,EACtD,GAAG,CAAC,CAAC,GACCC,IAAOxB,EAAA,CAAauB,IAAO,MAAM;AACrC,iBAAaP,EAAM,OAAO,GAC1BA,EAAM,UAAU,WAAA,MAAiBE,EAAQ,EAAK,GAAGK,CAAI;AAAA,EACvD,GAAG,CAAC,CAAC;AAEL,SAAAtB,EAAA,MAAA,MAAsB,aAAae,EAAM,OAAO,GAAG,CAAC,CAAC,GACrDb,EAAA,MAAsB;AACpB,IAAAiB,EAAW,UAAUD,EAAQ;AAAA,EAC/B,CAAC,GACDtB,EAAWkB,GAAKE,CAAI,GAEpBrB,EAAW;AAAA,IAAE,MAAAqB;AAAA,IAAM,SAAA,MAAeC,EAAQ,EAAK;AAAA,IAAG,QAAQ,CAACE,GAAYL,CAAG;AAAA,IAAG,SAAS;AAAA,EAAM,CAAC,GAC7FjB,EAAoBsB,GAAYL,GAAKE,GAAMN,CAAS,GAIlD,gBAAAJ,EAAC,QAAD;AAAA,IACE,KAAKO;AAAA,IACL,WAAU;AAAA,IACV,gBAAA,CAAiB,MAAM,EAAE,gBAAgB,WAAWQ,EAAKV,CAAK;AAAA,IAC9D,gBAAA,MAAsBY,EAAK,GAAG;AAAA,IAC9B,eAAA,MAAqB;AACnB,MAAAH,EAAa,UAAU,IACvBG,EAAK;AAAA,IACP;AAAA,IACA,SAAA,CAAU,MAAM;AACd,MAAI,CAACH,EAAa,WAAY,EAAE,OAAuB,QAAQ,gBAAgB,KAAGC,EAAK,CAAC,GACxFD,EAAa,UAAU;AAAA,IACzB;AAAA,IACA,QAAA,MAAc;AACZ,MAAAA,EAAa,UAAU,IACvBG,EAAK;AAAA,IACP;AAAA,IAhBF,UAAA,CAkBGzB,EAAaW,GAAU,EACtB,oBAAoB,CAACA,EAAS,MAAM,kBAAA,GAAqBG,CAAE,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,EACvF,CAAC,GACD,gBAAAP,EAAC,QAAD;AAAA,MACE,KAAKS;AAAA,MACD,IAAAF;AAAA,MACJ,MAAK;AAAA,MACL,WAAU;AAAA,MACJ,SAAS;AAAA,MACf,gBAAA,MAAsB,aAAaG,EAAM,OAAO;AAAA,MAChD,gBAAA,MAAsBQ,EAAK,GAAG;AAAA,MAE7B,UAAAf;AAAA,IACG,CAAA,CACF;AAAA,E;AAEV"}
|
|
1
|
+
{"version":3,"file":"Tooltip.js","names":["useClientLayoutEffect","useDismiss","usePopover","useAnchoredPosition","cloneElement","useCallback","useEffect","useId","useRef","useState","jsx","jsxs","useTruncated","whenTruncated","trigger","cut","setCut","watched","host","el","measure","node","Tooltip","content","children","placement","delay","className","off","describes","id","anchor","tip","timer","open","setOpen","triggerRef","pointerFocus","disabled","describe","disabledNow","show","wait","hide","e"],"sources":["../../../src/components/Tooltip/Tooltip.tsx"],"sourcesContent":["import {\n cloneElement,\n type ReactElement,\n type ReactNode,\n useCallback,\n useEffect,\n useId,\n useRef,\n useState,\n} from \"react\";\nimport { useClientLayoutEffect } from \"../../foundations/client-layout-effect.js\";\nimport { useDismiss } from \"../../overlay/dismiss.js\";\nimport { usePopover } from \"../../overlay/floating.js\";\nimport type { Placement } from \"../../overlay/position.js\";\nimport { useAnchoredPosition } from \"../../overlay/use-anchored-position.js\";\n\nexport interface TooltipTokens {\n bg: string;\n ink: string;\n radius: string;\n maxWidth: string;\n}\n\ndeclare module \"../../tokens/schema.js\" {\n interface ComponentTokens {\n tooltip: TooltipTokens;\n }\n}\n\nexport interface TooltipProps {\n /** Short supplementary text; it becomes the trigger's accessible description. */\n content: ReactNode;\n /** One focusable element (Button, IconButton, Link…). */\n children: ReactElement<Record<string, unknown>>;\n /** Preferred side; flips when it does not fit. Default \"top\". */\n placement?: Placement;\n /** Hover delay in ms (focus opens immediately). */\n delay?: number;\n /**\n * Added to the element around the trigger (the anchor, the box the parent lays out), for layout: a grid area,\n * `flex`, margins.\n */\n className?: string | undefined;\n /**\n * Turn the tooltip off without remounting the trigger: no tip, no description, hover and focus do nothing. For a\n * tooltip that only matters sometimes, such as the full text of a label while it is cut short.\n */\n disabled?: boolean | undefined;\n /**\n * `false` when the tip only repeats text the trigger's name already holds, such as a label cut short with an\n * ellipsis: it is shown but hidden from assistive technology, and does not describe the trigger. Default true.\n */\n describe?: boolean | undefined;\n /**\n * Show the tip only while text is cut short (it overflows its box, as with an ellipsis), for the full text of a\n * label: `true` measures the trigger, a function picks the element inside it that holds the text. It is measured\n * after every render and whenever the element is resized, and the tip repeats the trigger's name, so it implies\n * `describe={false}`.\n */\n whenTruncated?: boolean | ((trigger: HTMLElement) => HTMLElement | null) | undefined;\n}\n\n/**\n * Whether the text `whenTruncated` names is cut short: measured after every render (the text may change while the box\n * keeps its width) and, through one ResizeObserver, whenever its box is resized (the window, a neighbour). Off: false.\n */\nfunction useTruncated(whenTruncated: TooltipProps[\"whenTruncated\"], trigger: () => HTMLElement | null) {\n const [cut, setCut] = useState(false);\n const watched = useRef<{ el: HTMLElement; observer: ResizeObserver } | null>(null);\n useClientLayoutEffect(() => {\n const host = whenTruncated ? trigger() : null;\n const el = host && typeof whenTruncated === \"function\" ? whenTruncated(host) : host;\n const measure = () => {\n const node = watched.current?.el;\n setCut(!!node && node.scrollWidth > node.clientWidth);\n };\n if (el !== (watched.current?.el ?? null)) {\n watched.current?.observer.disconnect();\n watched.current = el ? { el, observer: new ResizeObserver(measure) } : null;\n watched.current?.observer.observe(el as HTMLElement);\n }\n measure();\n });\n useEffect(() => () => watched.current?.observer.disconnect(), []);\n return cut;\n}\n\n/**\n * Tooltip in the top layer (Popover API), positioned against its trigger. Opens on hover after `delay` and on\n * keyboard focus; dismissible with Escape; hoverable; never opens on touch (WCAG 1.4.13).\n */\nexport function Tooltip({\n content,\n children,\n placement = \"top\",\n delay = 300,\n className,\n disabled: off = false,\n describe: describes = true,\n whenTruncated,\n}: TooltipProps) {\n const id = `cy-tip-${useId().replace(/:/g, \"\")}`;\n const anchor = useRef<HTMLSpanElement>(null);\n const tip = useRef<HTMLSpanElement>(null);\n const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n const [open, setOpen] = useState(false);\n const trigger = () => (anchor.current?.firstElementChild as HTMLElement | null) ?? anchor.current;\n const triggerRef = useRef<HTMLElement | null>(null);\n // Focus that follows a pointer press (mouse or touch) is not keyboard focus: hover handles mouse, touch never opens.\n const pointerFocus = useRef(false);\n\n const cut = useTruncated(whenTruncated, trigger);\n const disabled = off || (whenTruncated ? !cut : false);\n const describe = describes && !whenTruncated;\n const disabledNow = useRef(disabled);\n disabledNow.current = disabled;\n const show = useCallback((wait: number) => {\n clearTimeout(timer.current);\n if (disabledNow.current) return;\n timer.current = setTimeout(() => setOpen(true), wait);\n }, []);\n const hide = useCallback((wait = 0) => {\n clearTimeout(timer.current);\n timer.current = setTimeout(() => setOpen(false), wait);\n }, []);\n\n useEffect(() => () => clearTimeout(timer.current), []);\n // Disabled while open (a label stopped being cut short): close, so it does not reappear when enabled again.\n useEffect(() => {\n if (disabled) {\n clearTimeout(timer.current);\n setOpen(false);\n }\n }, [disabled]);\n useClientLayoutEffect(() => {\n triggerRef.current = trigger();\n });\n usePopover(tip, open);\n // Escape closes the tooltip first when it sits inside a Popover, Menu or Dialog (shared layer stack).\n useDismiss({ open, onClose: () => setOpen(false), inside: [triggerRef, tip], outside: false });\n useAnchoredPosition(triggerRef, tip, open, placement);\n\n return (\n // biome-ignore lint/a11y/noStaticElementInteractions: delegated hover/focus listeners for the interactive child\n <span\n ref={anchor}\n className={className ? `cy-tooltip-anchor ${className}` : \"cy-tooltip-anchor\"}\n onPointerEnter={(e) => e.pointerType !== \"touch\" && show(delay)}\n onPointerLeave={() => hide(120)}\n onPointerDown={() => {\n pointerFocus.current = true;\n hide();\n }}\n onFocus={(e) => {\n if (!pointerFocus.current && (e.target as HTMLElement).matches(\":focus-visible\")) show(0);\n pointerFocus.current = false;\n }}\n onBlur={() => {\n pointerFocus.current = false;\n hide();\n }}\n >\n {disabled || !describe\n ? children\n : cloneElement(children, {\n \"aria-describedby\": [children.props[\"aria-describedby\"], id].filter(Boolean).join(\" \"),\n })}\n {!disabled && (\n <span\n ref={tip}\n id={id}\n role=\"tooltip\"\n aria-hidden={describe ? undefined : true}\n className=\"cy-tooltip\"\n {...{ popover: \"manual\" }}\n onPointerEnter={() => clearTimeout(timer.current)}\n onPointerLeave={() => hide(120)}\n >\n {content}\n </span>\n )}\n </span>\n );\n}\n"],"mappings":"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"}
|
|
@@ -1,7 +1,11 @@
|
|
|
1
|
-
import { type CSSProperties, type ReactNode } from "react";
|
|
1
|
+
import { type CSSProperties, type ReactNode, type Ref } from "react";
|
|
2
|
+
import { type OptionIconColor } from "../../foundations/option-icon.js";
|
|
2
3
|
import type { IconData } from "../../icons/types.js";
|
|
3
4
|
import type { Size } from "../../tokens/schema.js";
|
|
5
|
+
import type { MenuEntry } from "../Menu/Menu.js";
|
|
4
6
|
export interface TreeTokens {
|
|
7
|
+
trailingInk: string;
|
|
8
|
+
groupInk: string;
|
|
5
9
|
indent: string;
|
|
6
10
|
rowHeight: string;
|
|
7
11
|
selectedBg: string;
|
|
@@ -11,25 +15,76 @@ declare module "../../tokens/schema.js" {
|
|
|
11
15
|
tree: TreeTokens;
|
|
12
16
|
}
|
|
13
17
|
}
|
|
14
|
-
|
|
18
|
+
/** A button at the end of a row (View data, Open in a new tab), shown while the row is hovered, focused or selected. */
|
|
19
|
+
export interface TreeItemAction {
|
|
20
|
+
/** Handed to `onCommand` with the item when the button is pressed. */
|
|
21
|
+
value: string;
|
|
22
|
+
/** The button's accessible name and tooltip. */
|
|
23
|
+
label: string;
|
|
24
|
+
/** The button's icon. */
|
|
25
|
+
icon: IconData;
|
|
26
|
+
/** Shown but cannot be pressed. */
|
|
27
|
+
disabled?: boolean;
|
|
28
|
+
}
|
|
29
|
+
export interface TreeItem<T = unknown> extends OptionIconColor {
|
|
30
|
+
/** Identifies the item: selection, expansion, `loadingIds`, `errorIds` and `reload` use it. Unique in the tree. */
|
|
15
31
|
id: string;
|
|
32
|
+
/** The row's text; type-ahead and a string `filter` match it. */
|
|
16
33
|
label: string;
|
|
34
|
+
/** Icon before the label, muted by default. Colour it with `iconTone` or `iconColor`. */
|
|
17
35
|
icon?: IconData;
|
|
36
|
+
/** Shown but cannot be focused, selected or acted on. */
|
|
18
37
|
disabled?: boolean;
|
|
19
38
|
/** Known children. Leave it out and set `hasChildren` to load them with `loadChildren` on first expand. */
|
|
20
|
-
children?: TreeItem[];
|
|
39
|
+
children?: TreeItem<T>[];
|
|
40
|
+
/** It has children not known yet: loaded by `loadChildren`, or put in `children` by you (`loadingIds`). */
|
|
21
41
|
hasChildren?: boolean;
|
|
42
|
+
/**
|
|
43
|
+
* `group`: a heading for the rows under it (Tables, Views, Functions). It is never selected: Enter, Space and a click
|
|
44
|
+
* open and close it, and its end shows how many children it has (shown ones, while filtering) unless `trailing` is
|
|
45
|
+
* given.
|
|
46
|
+
*/
|
|
47
|
+
kind?: "item" | "group";
|
|
48
|
+
/** At the end of the row: a count, a badge, a short value. Part of the row's name. */
|
|
49
|
+
trailing?: ReactNode;
|
|
50
|
+
/** Your own payload (a table's schema, a node's type), handed back with the item in every callback. */
|
|
51
|
+
data?: T;
|
|
52
|
+
/**
|
|
53
|
+
* Buttons at the end of the row, shown while it is hovered, focused or selected. On the focused row they are in the
|
|
54
|
+
* Tab order: Tab reaches them, Shift+Tab or Escape goes back to the row. Pressed, they call `onCommand`.
|
|
55
|
+
*/
|
|
56
|
+
actions?: TreeItemAction[];
|
|
57
|
+
/**
|
|
58
|
+
* Commands in a ContextMenu, opened by right-click, a long press, Shift+F10 or the context menu key on the row: items,
|
|
59
|
+
* or sections of items, as in `Menu`. Chosen, they call `onCommand`.
|
|
60
|
+
*/
|
|
61
|
+
contextMenu?: MenuEntry[];
|
|
62
|
+
}
|
|
63
|
+
/** Imperative control of a Tree, through its `handle` prop. */
|
|
64
|
+
export interface TreeHandle {
|
|
65
|
+
/**
|
|
66
|
+
* Forget the loaded children of an item and run `loadChildren` again: now when it is open (a loading row shows),
|
|
67
|
+
* else the next time it opens.
|
|
68
|
+
*/
|
|
69
|
+
reload: (id: string) => void;
|
|
22
70
|
}
|
|
23
71
|
export interface TreeLabels {
|
|
24
72
|
loading: string;
|
|
25
73
|
/** Row shown when `loadChildren` fails; Enter or a click on it tries again. */
|
|
26
74
|
failed: string;
|
|
75
|
+
/** The name of a row's context menu, from its label. Default "users actions". */
|
|
76
|
+
menu: (label: string) => string;
|
|
27
77
|
}
|
|
28
|
-
|
|
78
|
+
/**
|
|
79
|
+
* Which items match: a string (case-insensitive, anywhere in the label), or a function returning true, false, or the
|
|
80
|
+
* indices of the matched characters in the label (a fuzzy matcher's positions) to mark exactly those.
|
|
81
|
+
*/
|
|
82
|
+
export type TreeFilter<T = unknown> = string | ((item: TreeItem<T>) => boolean | readonly number[] | null);
|
|
83
|
+
export interface TreeProps<T = unknown> {
|
|
29
84
|
/** Accessible name of the tree. */
|
|
30
85
|
label: string;
|
|
31
86
|
/** The top-level items; each can hold more under `children`. */
|
|
32
|
-
items: TreeItem[];
|
|
87
|
+
items: TreeItem<T>[];
|
|
33
88
|
/** Selected ids (controlled) and the default for uncontrolled use. */
|
|
34
89
|
selected?: string[];
|
|
35
90
|
/** Ids selected at the start when uncontrolled. */
|
|
@@ -45,11 +100,37 @@ export interface TreeProps {
|
|
|
45
100
|
/** `single` (default): one at a time. `multiple`: Space and clicks toggle. */
|
|
46
101
|
selectionMode?: "single" | "multiple";
|
|
47
102
|
/** Fetch the children of an item that `hasChildren` but has none yet. */
|
|
48
|
-
loadChildren?: (item: TreeItem) => Promise<TreeItem[]>;
|
|
49
|
-
/**
|
|
50
|
-
|
|
103
|
+
loadChildren?: (item: TreeItem<T>) => Promise<TreeItem<T>[]>;
|
|
104
|
+
/**
|
|
105
|
+
* Items whose children are loading somewhere else (a store): a loading row shows under them while open and they have
|
|
106
|
+
* no `children` yet; with children, the item is only marked busy.
|
|
107
|
+
*/
|
|
108
|
+
loadingIds?: readonly string[];
|
|
109
|
+
/** Items whose children failed to load somewhere else: an error row shows under them in place of any children. */
|
|
110
|
+
errorIds?: readonly string[];
|
|
111
|
+
/** Called when a failed item is retried (Enter or a click on its error row, or `renderError`'s `retry`). */
|
|
112
|
+
onRetry?: (item: TreeItem<T>) => void;
|
|
113
|
+
/** Content of the error row of an item whose children failed. `retry` runs `loadChildren` again and `onRetry`. */
|
|
114
|
+
renderError?: (item: TreeItem<T>, retry: () => void) => ReactNode;
|
|
115
|
+
/** Content of a row shown under an open item that has no children ("No columns"). Without it, nothing shows. */
|
|
116
|
+
renderEmpty?: (item: TreeItem<T>) => ReactNode;
|
|
117
|
+
/**
|
|
118
|
+
* Show only matching items, with their ancestors (opened) and their own children, and mark the matched text. A string
|
|
119
|
+
* matches the label anywhere, ignoring case. Only known children are searched. Pass a stable function (useCallback):
|
|
120
|
+
* branches closed while filtering open again when it changes.
|
|
121
|
+
*/
|
|
122
|
+
filter?: TreeFilter<T> | undefined;
|
|
123
|
+
/**
|
|
124
|
+
* Custom row content after the chevron and icon (a value, a badge, a line number). `label` is the label as the tree
|
|
125
|
+
* would draw it (with matches marked while filtering). The item's `label` still drives type-ahead.
|
|
126
|
+
*/
|
|
127
|
+
renderLabel?: (item: TreeItem<T>, label: ReactNode) => ReactNode;
|
|
51
128
|
/** Enter (or a double-click) on an item: its default action, such as opening it or copying its path. Space selects. */
|
|
52
|
-
onAction?: ((item: TreeItem) => void) | undefined;
|
|
129
|
+
onAction?: ((item: TreeItem<T>) => void) | undefined;
|
|
130
|
+
/** Called with the `value` of a pressed row action or a chosen context menu command, and the row's item. */
|
|
131
|
+
onCommand?: ((value: string, item: TreeItem<T>) => void) | undefined;
|
|
132
|
+
/** Imperative control: `reload(id)`. */
|
|
133
|
+
handle?: Ref<TreeHandle>;
|
|
53
134
|
/**
|
|
54
135
|
* Render only the rows in view (for tens of thousands of rows). Give the tree a height (`style` or a class); rows
|
|
55
136
|
* must share one height.
|
|
@@ -57,7 +138,7 @@ export interface TreeProps {
|
|
|
57
138
|
virtual?: boolean;
|
|
58
139
|
/** Row height and indent. Default "md". */
|
|
59
140
|
size?: Extract<Size, "sm" | "md">;
|
|
60
|
-
/** Replace the built-in English text: the loading row
|
|
141
|
+
/** Replace the built-in English text: the loading row, the failed-to-load row and the context menu's name. */
|
|
61
142
|
labels?: Partial<TreeLabels>;
|
|
62
143
|
/** Added to the root element, for layout. */
|
|
63
144
|
className?: string;
|
|
@@ -65,4 +146,4 @@ export interface TreeProps {
|
|
|
65
146
|
style?: CSSProperties;
|
|
66
147
|
}
|
|
67
148
|
/** Hierarchical list (WAI-ARIA APG tree view): arrows, type-ahead, expand and collapse, selection, lazy children. */
|
|
68
|
-
export declare function Tree
|
|
149
|
+
export declare function Tree<T = unknown>(props: TreeProps<T>): import("react").JSX.Element;
|