@jcsoftdev/ui 0.2.3 → 0.3.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/CHANGELOG.md +288 -7
- package/README.md +2 -1
- package/bin/ui-theme.mjs +1151 -25
- package/dist/ai/attachment/attachment.js +1 -1
- package/dist/ai/chat-list/group.js +3 -1
- package/dist/ai/conversation/conversation.js +1 -1
- package/dist/ai/internal/use-copy.d.ts +1 -5
- package/dist/ai/internal/use-copy.js +1 -32
- package/dist/ai/markdown/parse.js +59 -17
- package/dist/ai/source/source.js +1 -1
- package/dist/atoms/avatar/avatar.d.ts +13 -3
- package/dist/atoms/avatar/avatar.js +40 -2
- package/dist/atoms/avatar/index.d.ts +1 -1
- package/dist/atoms/avatar/index.js +3 -1
- package/dist/atoms/button/button.d.ts +4 -1
- package/dist/atoms/button/button.js +4 -2
- package/dist/atoms/checkbox/checkbox.d.ts +8 -3
- package/dist/atoms/checkbox/checkbox.js +23 -2
- package/dist/atoms/chip/chip.d.ts +9 -3
- package/dist/atoms/chip/chip.js +26 -4
- package/dist/atoms/chip/index.d.ts +1 -1
- package/dist/atoms/chip/index.js +4 -1
- package/dist/atoms/status-dot/index.d.ts +1 -1
- package/dist/atoms/status-dot/status-dot.d.ts +4 -2
- package/dist/atoms/status-dot/status-dot.js +5 -1
- package/dist/charts/bar-chart/bar-race-chart.js +1 -0
- package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
- package/dist/charts/chord-chart/chord-chart.js +13 -5
- package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
- package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
- package/dist/charts/core/cartesian/layout.d.ts +6 -1
- package/dist/charts/core/cartesian/layout.js +14 -5
- package/dist/charts/core/cartesian/marks.d.ts +2 -2
- package/dist/charts/core/cartesian/marks.js +1 -1
- package/dist/charts/core/cartesian/types.d.ts +28 -2
- package/dist/charts/core/category-explorer.d.ts +2 -2
- package/dist/charts/core/category-explorer.js +8 -4
- package/dist/charts/core/chart-dock.d.ts +26 -0
- package/dist/charts/core/chart-dock.js +45 -0
- package/dist/charts/core/chart-frame.d.ts +9 -2
- package/dist/charts/core/chart-frame.js +105 -25
- package/dist/charts/core/distribution/explorer.d.ts +5 -2
- package/dist/charts/core/distribution/explorer.js +12 -5
- package/dist/charts/core/distribution/xy-points.js +1 -1
- package/dist/charts/core/index.d.ts +3 -0
- package/dist/charts/core/index.js +3 -0
- package/dist/charts/core/leave-grace.d.ts +11 -0
- package/dist/charts/core/leave-grace.js +26 -0
- package/dist/charts/core/nearest.d.ts +14 -0
- package/dist/charts/core/nearest.js +22 -0
- package/dist/charts/core/plot-overlay.js +9 -3
- package/dist/charts/core/pointer.test-utils.d.ts +38 -0
- package/dist/charts/core/pointer.test-utils.js +123 -0
- package/dist/charts/core/tooltip.d.ts +25 -2
- package/dist/charts/core/tooltip.js +115 -40
- package/dist/charts/core/touch-select.d.ts +20 -0
- package/dist/charts/core/touch-select.js +184 -0
- package/dist/charts/core/types.d.ts +8 -4
- package/dist/charts/core/types.js +5 -0
- package/dist/charts/core/use-index-navigation.d.ts +17 -6
- package/dist/charts/core/use-index-navigation.js +47 -10
- package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
- package/dist/charts/donut-chart/donut-chart.js +40 -1
- package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
- package/dist/charts/donut-chart/slice-labels.js +20 -0
- package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
- package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
- package/dist/charts/funnel-chart/funnel-chart.js +2 -1
- package/dist/charts/gauge-chart/gauge-chart.js +2 -1
- package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
- package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
- package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
- package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
- package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
- package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
- package/dist/charts/icicle-chart/icicle-chart.js +7 -9
- package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
- package/dist/charts/maps/geo/map-viewport.js +1 -1
- package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
- package/dist/charts/progress-units/progress-units.js +1 -0
- package/dist/charts/radar-chart/radar-chart.js +1 -1
- package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
- package/dist/charts/range-area-chart/range-area-chart.js +3 -2
- package/dist/charts/sankey-chart/sankey-chart.js +12 -4
- package/dist/charts/tree-chart/tree-chart.js +1 -0
- package/dist/charts/treemap-chart/treemap-chart.js +2 -7
- package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
- package/dist/containers/action-bar/action-bar.d.ts +11 -2
- package/dist/containers/action-bar/action-bar.js +4 -1
- package/dist/containers/card/card.d.ts +21 -3
- package/dist/containers/card/card.js +20 -5
- package/dist/containers/grid/grid.d.ts +15 -0
- package/dist/containers/grid/grid.js +24 -0
- package/dist/containers/grid/index.d.ts +1 -0
- package/dist/containers/grid/index.js +4 -0
- package/dist/containers/index.d.ts +3 -0
- package/dist/containers/index.js +3 -0
- package/dist/containers/kpi/kpi.d.ts +13 -2
- package/dist/containers/kpi/kpi.js +86 -24
- package/dist/containers/kpi-group/index.d.ts +1 -1
- package/dist/containers/kpi-group/index.js +3 -1
- package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
- package/dist/containers/kpi-group/kpi-group.js +11 -1
- package/dist/containers/page/index.d.ts +1 -0
- package/dist/containers/page/index.js +4 -0
- package/dist/containers/page/page.d.ts +7 -0
- package/dist/containers/page/page.js +14 -0
- package/dist/containers/page-header/page-header.d.ts +8 -3
- package/dist/containers/page-header/page-header.js +35 -8
- package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
- package/dist/containers/responsive-list/responsive-list.js +6 -3
- package/dist/containers/stack/index.d.ts +1 -0
- package/dist/containers/stack/index.js +6 -0
- package/dist/containers/stack/stack.d.ts +15 -0
- package/dist/containers/stack/stack.js +43 -0
- package/dist/forms/copy-field/copy-field.d.ts +17 -0
- package/dist/forms/copy-field/copy-field.js +72 -0
- package/dist/forms/copy-field/index.d.ts +1 -0
- package/dist/forms/copy-field/index.js +4 -0
- package/dist/forms/emoji-picker/emoji-picker.js +1 -1
- package/dist/forms/form/form.d.ts +15 -0
- package/dist/forms/form/form.js +29 -0
- package/dist/forms/form/index.d.ts +1 -0
- package/dist/forms/form/index.js +10 -0
- package/dist/forms/index.d.ts +2 -0
- package/dist/forms/index.js +2 -0
- package/dist/forms/input/index.d.ts +1 -1
- package/dist/forms/input/index.js +3 -2
- package/dist/forms/input/input.d.ts +6 -2
- package/dist/forms/input/input.js +9 -3
- package/dist/glass/crystal-map.d.ts +70 -0
- package/dist/glass/crystal-map.js +88 -0
- package/dist/glass/displacement-map.d.ts +117 -0
- package/dist/glass/displacement-map.js +201 -0
- package/dist/glass/index.d.ts +8 -0
- package/dist/glass/index.js +63 -0
- package/dist/glass/lens-crystal.d.ts +29 -0
- package/dist/glass/lens-crystal.js +161 -0
- package/dist/glass/lens-dispersion.d.ts +11 -0
- package/dist/glass/lens-dispersion.js +19 -0
- package/dist/glass/liquid-glass.d.ts +41 -0
- package/dist/glass/liquid-glass.js +256 -0
- package/dist/glass/liquid-motion.d.ts +53 -0
- package/dist/glass/liquid-motion.js +302 -0
- package/dist/glass/liquid-options.d.ts +162 -0
- package/dist/glass/liquid-options.js +179 -0
- package/dist/glass/refraction.d.ts +100 -0
- package/dist/glass/refraction.js +714 -0
- package/dist/glass/specular-map.d.ts +26 -0
- package/dist/glass/specular-map.js +75 -0
- package/dist/glass/spring.d.ts +79 -0
- package/dist/glass/spring.js +58 -0
- package/dist/glass/support.d.ts +13 -0
- package/dist/glass/support.js +14 -0
- package/dist/glass/use-glass-refraction.d.ts +8 -0
- package/dist/glass/use-glass-refraction.js +16 -0
- package/dist/i18n/strings.d.ts +24 -0
- package/dist/i18n/strings.js +18 -2
- package/dist/icons/index.d.ts +2 -0
- package/dist/icons/index.js +4 -0
- package/dist/icons/key.d.ts +2 -0
- package/dist/icons/key.js +12 -0
- package/dist/icons/webhook.d.ts +2 -0
- package/dist/icons/webhook.js +12 -0
- package/dist/liquid/index.d.ts +3 -0
- package/dist/liquid/index.js +29 -0
- package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
- package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
- package/dist/navigation/breadcrumbs/index.d.ts +1 -0
- package/dist/navigation/breadcrumbs/index.js +6 -0
- package/dist/navigation/index.d.ts +1 -0
- package/dist/navigation/index.js +1 -0
- package/dist/navigation/segmented/index.d.ts +1 -1
- package/dist/navigation/segmented/model.d.ts +5 -0
- package/dist/navigation/segmented/model.js +6 -0
- package/dist/navigation/segmented/segmented.d.ts +17 -3
- package/dist/navigation/segmented/segmented.js +20 -4
- package/dist/overlays/context-menu/context-menu.d.ts +9 -1
- package/dist/overlays/context-menu/context-menu.js +4 -1
- package/dist/overlays/dialog/dialog.d.ts +9 -1
- package/dist/overlays/dialog/dialog.js +3 -0
- package/dist/overlays/drawer/drawer.d.ts +9 -1
- package/dist/overlays/drawer/drawer.js +3 -0
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +9 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +3 -1
- package/dist/overlays/hover-card/hover-card.d.ts +10 -1
- package/dist/overlays/hover-card/hover-card.js +4 -1
- package/dist/overlays/popover/popover.d.ts +9 -1
- package/dist/overlays/popover/popover.js +3 -0
- package/dist/palette/command-palette/command-palette.d.ts +12 -2
- package/dist/palette/command-palette/command-palette.js +5 -0
- package/dist/primitives/command/command.d.ts +3 -2
- package/dist/primitives/command/command.js +2 -0
- package/dist/primitives/menu/menu.js +1 -1
- package/dist/primitives/popper/popper.js +5 -0
- package/dist/rich-text/rich-text-editor.js +94 -8
- package/dist/rich-text/sanitize.js +70 -20
- package/dist/shell/app-shell/app-shell.d.ts +17 -0
- package/dist/shell/app-shell/app-shell.js +44 -4
- package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
- package/dist/shell/bottom-nav/bottom-nav.js +124 -0
- package/dist/shell/bottom-nav/index.d.ts +2 -0
- package/dist/shell/bottom-nav/index.js +9 -0
- package/dist/shell/bottom-nav/split.d.ts +11 -0
- package/dist/shell/bottom-nav/split.js +10 -0
- package/dist/shell/sidebar/sidebar.d.ts +16 -2
- package/dist/shell/sidebar/sidebar.js +46 -4
- package/dist/shell/topbar/topbar.d.ts +20 -9
- package/dist/shell/topbar/topbar.js +16 -9
- package/dist/states/empty-state/empty-state.d.ts +3 -1
- package/dist/states/empty-state/empty-state.js +9 -1
- package/dist/states/error-state/error-state.d.ts +3 -1
- package/dist/states/error-state/error-state.js +2 -0
- package/dist/states/index.d.ts +1 -0
- package/dist/states/index.js +1 -0
- package/dist/states/live-status-bar/index.d.ts +1 -0
- package/dist/states/live-status-bar/index.js +6 -0
- package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
- package/dist/states/live-status-bar/live-status-bar.js +49 -0
- package/dist/states/offline-banner/offline-banner.d.ts +3 -1
- package/dist/states/offline-banner/offline-banner.js +8 -4
- package/dist/utils/class-groups.js +17 -0
- package/dist/utils/index.d.ts +1 -0
- package/dist/utils/index.js +2 -0
- package/dist/utils/material.d.ts +13 -0
- package/dist/utils/material.js +6 -0
- package/dist/utils/tone.d.ts +8 -0
- package/dist/utils/tone.js +17 -0
- package/dist/utils/use-copy.d.ts +5 -0
- package/dist/utils/use-copy.js +35 -0
- package/icons/svg/key.svg +5 -0
- package/icons/svg/webhook.svg +5 -0
- package/package.json +31 -21
- package/scripts/build-theme.d.mts +22 -0
- package/scripts/build-theme.mjs +236 -4
- package/src/ai/attachment/attachment.tsx +1 -1
- package/src/ai/chat-list/group.ts +3 -1
- package/src/ai/conversation/conversation.tsx +1 -1
- package/src/ai/internal/use-copy.ts +1 -38
- package/src/ai/markdown/parse.ts +74 -17
- package/src/ai/source/source.tsx +1 -1
- package/src/atoms/avatar/avatar.tsx +57 -4
- package/src/atoms/avatar/index.ts +8 -1
- package/src/atoms/button/button.tsx +8 -3
- package/src/atoms/checkbox/checkbox.tsx +30 -3
- package/src/atoms/chip/chip.tsx +37 -5
- package/src/atoms/chip/index.ts +7 -1
- package/src/atoms/status-dot/index.ts +1 -0
- package/src/atoms/status-dot/status-dot.tsx +15 -3
- package/src/charts/README.md +21 -0
- package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
- package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
- package/src/charts/chord-chart/chord-chart.tsx +13 -5
- package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
- package/src/charts/core/cartesian/layout.ts +29 -10
- package/src/charts/core/cartesian/marks.tsx +3 -3
- package/src/charts/core/cartesian/types.ts +30 -2
- package/src/charts/core/category-explorer.tsx +12 -6
- package/src/charts/core/chart-dock.tsx +68 -0
- package/src/charts/core/chart-frame.tsx +116 -27
- package/src/charts/core/distribution/explorer.tsx +17 -7
- package/src/charts/core/distribution/xy-points.tsx +1 -1
- package/src/charts/core/index.ts +3 -0
- package/src/charts/core/leave-grace.ts +35 -0
- package/src/charts/core/nearest.ts +38 -0
- package/src/charts/core/plot-overlay.tsx +9 -3
- package/src/charts/core/pointer.test-utils.ts +146 -0
- package/src/charts/core/tooltip.tsx +129 -15
- package/src/charts/core/touch-select.ts +250 -0
- package/src/charts/core/types.ts +13 -4
- package/src/charts/core/use-index-navigation.ts +70 -11
- package/src/charts/donut-chart/donut-chart.tsx +53 -3
- package/src/charts/donut-chart/slice-labels.ts +39 -0
- package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
- package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
- package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
- package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
- package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
- package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
- package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
- package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
- package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
- package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
- package/src/charts/maps/geo/map-viewport.tsx +1 -1
- package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
- package/src/charts/progress-units/progress-units.tsx +1 -0
- package/src/charts/radar-chart/radar-chart.tsx +1 -1
- package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
- package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
- package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
- package/src/charts/tree-chart/tree-chart.tsx +1 -0
- package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
- package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
- package/src/containers/action-bar/action-bar.tsx +13 -2
- package/src/containers/card/card.tsx +43 -4
- package/src/containers/grid/grid.tsx +37 -0
- package/src/containers/grid/index.ts +1 -0
- package/src/containers/index.ts +3 -0
- package/src/containers/kpi/kpi.tsx +116 -22
- package/src/containers/kpi-group/index.ts +7 -1
- package/src/containers/kpi-group/kpi-group.tsx +26 -1
- package/src/containers/page/index.ts +1 -0
- package/src/containers/page/page.tsx +17 -0
- package/src/containers/page-header/page-header.tsx +38 -8
- package/src/containers/responsive-list/responsive-list.tsx +7 -4
- package/src/containers/stack/index.ts +7 -0
- package/src/containers/stack/stack.tsx +55 -0
- package/src/forms/copy-field/copy-field.tsx +88 -0
- package/src/forms/copy-field/index.ts +1 -0
- package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
- package/src/forms/form/form.tsx +46 -0
- package/src/forms/form/index.ts +8 -0
- package/src/forms/index.ts +2 -0
- package/src/forms/input/index.ts +1 -1
- package/src/forms/input/input.tsx +14 -3
- package/src/glass/crystal-map.ts +150 -0
- package/src/glass/displacement-map.ts +317 -0
- package/src/glass/index.ts +43 -0
- package/src/glass/lens-crystal.ts +226 -0
- package/src/glass/lens-dispersion.ts +34 -0
- package/src/glass/liquid-glass.tsx +371 -0
- package/src/glass/liquid-motion.ts +395 -0
- package/src/glass/liquid-options.ts +306 -0
- package/src/glass/refraction.ts +1010 -0
- package/src/glass/specular-map.ts +95 -0
- package/src/glass/spring.ts +98 -0
- package/src/glass/support.ts +27 -0
- package/src/glass/use-glass-refraction.ts +21 -0
- package/src/i18n/strings.ts +24 -0
- package/src/icons/index.ts +2 -0
- package/src/icons/key.tsx +13 -0
- package/src/icons/webhook.tsx +13 -0
- package/src/liquid/index.ts +24 -0
- package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
- package/src/navigation/breadcrumbs/index.ts +8 -0
- package/src/navigation/index.ts +1 -0
- package/src/navigation/segmented/index.ts +1 -0
- package/src/navigation/segmented/model.ts +11 -0
- package/src/navigation/segmented/segmented.tsx +45 -6
- package/src/overlays/context-menu/context-menu.tsx +11 -1
- package/src/overlays/dialog/dialog.tsx +10 -0
- package/src/overlays/drawer/drawer.tsx +10 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +10 -1
- package/src/overlays/hover-card/hover-card.tsx +12 -1
- package/src/overlays/popover/popover.tsx +10 -0
- package/src/palette/command-palette/command-palette.tsx +15 -1
- package/src/primitives/command/command.tsx +4 -0
- package/src/primitives/menu/menu.tsx +1 -1
- package/src/primitives/popper/popper.tsx +10 -0
- package/src/rich-text/rich-text-editor.tsx +116 -13
- package/src/rich-text/sanitize.ts +94 -23
- package/src/shell/app-shell/app-shell.tsx +60 -4
- package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
- package/src/shell/bottom-nav/index.ts +8 -0
- package/src/shell/bottom-nav/split.ts +20 -0
- package/src/shell/sidebar/sidebar.tsx +51 -5
- package/src/shell/topbar/topbar.tsx +81 -58
- package/src/states/empty-state/empty-state.tsx +11 -1
- package/src/states/error-state/error-state.tsx +4 -0
- package/src/states/index.ts +1 -0
- package/src/states/live-status-bar/index.ts +6 -0
- package/src/states/live-status-bar/live-status-bar.tsx +62 -0
- package/src/states/offline-banner/offline-banner.tsx +13 -5
- package/src/utils/class-groups.ts +17 -0
- package/src/utils/index.ts +1 -0
- package/src/utils/material.ts +16 -0
- package/src/utils/tone.ts +29 -0
- package/src/utils/use-copy.ts +38 -0
- package/styles/Theme.kt +64 -3
- package/styles/base.css +51 -0
- package/styles/tailwind.css +833 -0
- package/styles/theme.css +546 -4
- package/styles/tokens.css +788 -15
- package/tokens/default.json +918 -29
- package/scripts/build-theme.d.ts +0 -18
|
@@ -331,7 +331,7 @@ function BeeswarmPlot({
|
|
|
331
331
|
count: points.length,
|
|
332
332
|
active,
|
|
333
333
|
onActiveChange: setActive,
|
|
334
|
-
pick: (x, y) => nearestPoint(points, x, y, 14),
|
|
334
|
+
pick: (x, y, radius2) => nearestPoint(points, x, y, radius2 ?? 14),
|
|
335
335
|
label: labels.explore,
|
|
336
336
|
valueText,
|
|
337
337
|
margin,
|
|
@@ -8,6 +8,7 @@ import { chordLayout, chordsOf, ribbonPath } from "../core/chord.js";
|
|
|
8
8
|
import { ChartDataTable } from "../core/data-table.js";
|
|
9
9
|
import { DEFAULT_EXPORT_TEXTS, ExportMenu } from "../core/export-menu.js";
|
|
10
10
|
import { resolveFormat } from "../core/format.js";
|
|
11
|
+
import { useLeaveGrace } from "../core/leave-grace.js";
|
|
11
12
|
import { ChartLegend } from "../core/legend.js";
|
|
12
13
|
import { EASE_OUT, fadeIn, useEntryAnimation } from "../core/motion.js";
|
|
13
14
|
import { seriesColor } from "../core/palette.js";
|
|
@@ -160,6 +161,11 @@ function ChordPlot({
|
|
|
160
161
|
);
|
|
161
162
|
const nav = useIndexNavigation(order.length, { wrap: true });
|
|
162
163
|
const [hover, setHover] = useState(null);
|
|
164
|
+
const { leave: leaveSoon, hold } = useLeaveGrace(() => setHover(null));
|
|
165
|
+
const showHover = (next) => {
|
|
166
|
+
hold();
|
|
167
|
+
setHover(next);
|
|
168
|
+
};
|
|
163
169
|
const rim = showLabels && width >= 420;
|
|
164
170
|
const labelRoom = rim ? Math.min(
|
|
165
171
|
width * 0.28,
|
|
@@ -300,8 +306,8 @@ function ChordPlot({
|
|
|
300
306
|
radius: inner - 2,
|
|
301
307
|
colors,
|
|
302
308
|
lit,
|
|
303
|
-
onEnter: (chord, event) =>
|
|
304
|
-
onLeave:
|
|
309
|
+
onEnter: (chord, event) => showHover({ focus: { kind: "chord", key: chordKey(chord) }, ...point(event) }),
|
|
310
|
+
onLeave: leaveSoon
|
|
305
311
|
}
|
|
306
312
|
),
|
|
307
313
|
layout.groups.map((group) => {
|
|
@@ -321,6 +327,7 @@ function ChordPlot({
|
|
|
321
327
|
endAngle: group.endAngle,
|
|
322
328
|
cornerRadius: 3
|
|
323
329
|
}),
|
|
330
|
+
"data-chart-hit": "",
|
|
324
331
|
className: onGroupClick ? "cursor-pointer" : "cursor-default",
|
|
325
332
|
style: {
|
|
326
333
|
fill: colors[group.index],
|
|
@@ -329,9 +336,9 @@ function ChordPlot({
|
|
|
329
336
|
transformBox: "fill-box",
|
|
330
337
|
transformOrigin: "center"
|
|
331
338
|
},
|
|
332
|
-
onPointerEnter: (event) =>
|
|
333
|
-
onPointerMove: (event) =>
|
|
334
|
-
onPointerLeave:
|
|
339
|
+
onPointerEnter: (event) => showHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
|
|
340
|
+
onPointerMove: (event) => showHover({ focus: { kind: "group", index: group.index }, ...point(event) }),
|
|
341
|
+
onPointerLeave: leaveSoon,
|
|
335
342
|
onClick: () => {
|
|
336
343
|
const input = groups[group.index];
|
|
337
344
|
if (input) onGroupClick?.(input, group.index);
|
|
@@ -404,6 +411,7 @@ const ChordRibbons = memo(function ChordRibbons2({
|
|
|
404
411
|
"path",
|
|
405
412
|
{
|
|
406
413
|
"data-ribbon": "",
|
|
414
|
+
"data-chart-hit": "",
|
|
407
415
|
d: ribbonPath(chord, radius),
|
|
408
416
|
className: "motion-safe:transition-[fill-opacity] motion-safe:duration-150",
|
|
409
417
|
style: {
|
|
@@ -5,4 +5,4 @@ import type { CartesianChartProps } from "./types.js";
|
|
|
5
5
|
* exploration, annotations, entry animation and the zoom brush.
|
|
6
6
|
* `LineChart`, `AreaChart`, `BarChart` and `ComboChart` are presets of it.
|
|
7
7
|
*/
|
|
8
|
-
export declare function CartesianChart({ categories, series, title, description, height, aspectRatio, orientation, stack, curve, markers, dataLabels, gradient, lineGradient, transition, maxPoints, syncId, onPointClick, barRadius, valueFormat, xFormat, xScale, yAxis, rightAxis, axes, grid, legend, tooltip, annotations, categoryGroups, categoryLabelRotation, onCategoryClick, brush, rangeSelect, overlay, loading, animate, initialHidden, labels: labelsProp, className, }: CartesianChartProps): import("react").JSX.Element;
|
|
8
|
+
export declare function CartesianChart({ categories, series, title, description, height, aspectRatio, orientation, stack, curve, markers, dataLabels, gradient, lineGradient, transition, maxPoints, syncId, onPointClick, barRadius, valueFormat, xFormat, xScale, yAxis, rightAxis, axes, grid, legend, tooltip, dock, tooltipRows, annotations, categoryGroups, categoryLabelRotation, categoryTickEvery, onCategoryClick, brush, rangeSelect, overlay, loading, animate, initialHidden, labels: labelsProp, className, }: CartesianChartProps): import("react").JSX.Element;
|
|
@@ -51,6 +51,9 @@ function legendShape(kind, dashed) {
|
|
|
51
51
|
function safeId(raw) {
|
|
52
52
|
return raw.replace(/[^a-zA-Z0-9_-]/g, "");
|
|
53
53
|
}
|
|
54
|
+
function sourceIndex(indices, start, index) {
|
|
55
|
+
return start + (indices ? indices[index] : index);
|
|
56
|
+
}
|
|
54
57
|
function titleOf(value, xLabel, custom) {
|
|
55
58
|
if (value instanceof Date && !custom) return formatDate(value);
|
|
56
59
|
return xLabel(value);
|
|
@@ -83,9 +86,12 @@ function CartesianChart({
|
|
|
83
86
|
grid = true,
|
|
84
87
|
legend,
|
|
85
88
|
tooltip = true,
|
|
89
|
+
dock,
|
|
90
|
+
tooltipRows,
|
|
86
91
|
annotations,
|
|
87
92
|
categoryGroups,
|
|
88
93
|
categoryLabelRotation,
|
|
94
|
+
categoryTickEvery,
|
|
89
95
|
onCategoryClick,
|
|
90
96
|
brush = false,
|
|
91
97
|
rangeSelect,
|
|
@@ -188,6 +194,7 @@ function CartesianChart({
|
|
|
188
194
|
labels,
|
|
189
195
|
loading,
|
|
190
196
|
empty,
|
|
197
|
+
dock: tooltip ? dock : "never",
|
|
191
198
|
skeleton: series.some((item) => item.kind === "column") ? "bars" : "line",
|
|
192
199
|
legendPosition: legendPlacement ?? "top",
|
|
193
200
|
legend: showLegend ? /* @__PURE__ */ jsx(
|
|
@@ -235,9 +242,11 @@ function CartesianChart({
|
|
|
235
242
|
axes,
|
|
236
243
|
grid,
|
|
237
244
|
tooltip,
|
|
245
|
+
tooltipRows,
|
|
238
246
|
annotations,
|
|
239
247
|
categoryGroups,
|
|
240
248
|
categoryLabelRotation,
|
|
249
|
+
categoryTickEvery,
|
|
241
250
|
onCategoryClick,
|
|
242
251
|
rangeSelect,
|
|
243
252
|
overlay,
|
|
@@ -280,9 +289,11 @@ function CartesianPlot({
|
|
|
280
289
|
axes,
|
|
281
290
|
grid = true,
|
|
282
291
|
tooltip = true,
|
|
292
|
+
tooltipRows,
|
|
283
293
|
annotations,
|
|
284
294
|
categoryGroups,
|
|
285
295
|
categoryLabelRotation,
|
|
296
|
+
categoryTickEvery,
|
|
286
297
|
onCategoryClick,
|
|
287
298
|
rangeSelect,
|
|
288
299
|
overlay,
|
|
@@ -365,7 +376,8 @@ function CartesianPlot({
|
|
|
365
376
|
axes,
|
|
366
377
|
annotations: annotations ?? [],
|
|
367
378
|
categoryGroups: groupsOn,
|
|
368
|
-
labelRotation: categoryLabelRotation
|
|
379
|
+
labelRotation: categoryLabelRotation,
|
|
380
|
+
categoryTickEvery
|
|
369
381
|
}),
|
|
370
382
|
[
|
|
371
383
|
width,
|
|
@@ -384,7 +396,8 @@ function CartesianPlot({
|
|
|
384
396
|
axes,
|
|
385
397
|
annotations,
|
|
386
398
|
groupsOn,
|
|
387
|
-
categoryLabelRotation
|
|
399
|
+
categoryLabelRotation,
|
|
400
|
+
categoryTickEvery
|
|
388
401
|
]
|
|
389
402
|
);
|
|
390
403
|
const natural = useMemo(() => computeLayout(layoutInput), [layoutInput]);
|
|
@@ -572,8 +585,8 @@ function CartesianPlot({
|
|
|
572
585
|
event.currentTarget.releasePointerCapture(event.pointerId);
|
|
573
586
|
}
|
|
574
587
|
};
|
|
575
|
-
const onPointerLeave = () => {
|
|
576
|
-
if (dragStart.current != null) return;
|
|
588
|
+
const onPointerLeave = (event) => {
|
|
589
|
+
if (dragStart.current != null || event.pointerType === "touch") return;
|
|
577
590
|
setActive(null);
|
|
578
591
|
setPointer(null);
|
|
579
592
|
setNoteKey(null);
|
|
@@ -657,12 +670,24 @@ function CartesianPlot({
|
|
|
657
670
|
emphasis: true
|
|
658
671
|
});
|
|
659
672
|
}
|
|
660
|
-
|
|
673
|
+
const title2 = titleOf(category, xLabel, customXLabel);
|
|
674
|
+
const text = `${title2}: ${rows.map((row) => `${row.name} ${row.value}`).join(", ")}`;
|
|
675
|
+
const custom = tooltipRows?.({
|
|
676
|
+
index: sourceIndex(sampled.indices ?? void 0, start, index),
|
|
677
|
+
category,
|
|
678
|
+
rows
|
|
679
|
+
});
|
|
680
|
+
return {
|
|
681
|
+
title: custom?.title ?? title2,
|
|
682
|
+
rows: custom?.rows ?? rows,
|
|
683
|
+
footer: custom?.footer,
|
|
684
|
+
text
|
|
685
|
+
};
|
|
661
686
|
},
|
|
662
|
-
[sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel]
|
|
687
|
+
[sampled, layout, stack, valueFormat, labels.total, xLabel, customXLabel, tooltipRows, start]
|
|
663
688
|
);
|
|
664
689
|
const details = active != null && active < count ? describe(active) : null;
|
|
665
|
-
const valueText = details ?
|
|
690
|
+
const valueText = details ? details.text : labels.explore;
|
|
666
691
|
let anchor = null;
|
|
667
692
|
if (active != null && active < count) {
|
|
668
693
|
const position = layout.positions[active];
|
|
@@ -682,6 +707,15 @@ function CartesianPlot({
|
|
|
682
707
|
};
|
|
683
708
|
}
|
|
684
709
|
}
|
|
710
|
+
const markerSet = useMemo(
|
|
711
|
+
() => Array.isArray(markers) ? new Set(
|
|
712
|
+
sampled.categories.flatMap(
|
|
713
|
+
(_, index) => markers.includes(sourceIndex(sampled.indices ?? void 0, start, index)) ? [index] : []
|
|
714
|
+
)
|
|
715
|
+
) : null,
|
|
716
|
+
[markers, sampled, start]
|
|
717
|
+
);
|
|
718
|
+
const markersFor = (dense) => markerSet ?? (markers === true && dense);
|
|
685
719
|
const activePosition = active != null ? layout.positions[active] : void 0;
|
|
686
720
|
const bandSize = layout.mode === "band" ? layout.step : 0;
|
|
687
721
|
const gradientId = (seriesId) => `${uid}-g-${safeId(seriesId)}`;
|
|
@@ -821,7 +855,7 @@ function CartesianPlot({
|
|
|
821
855
|
geometry: item,
|
|
822
856
|
dimmed: highlighted != null && highlighted !== item.id,
|
|
823
857
|
gradientId: gradient ? gradientId(item.id) : void 0,
|
|
824
|
-
markers:
|
|
858
|
+
markers: markersFor(count <= Math.max(2, innerWidth / 9)),
|
|
825
859
|
stacked: stackedAreas,
|
|
826
860
|
...markProps(item.id)
|
|
827
861
|
},
|
|
@@ -846,7 +880,7 @@ function CartesianPlot({
|
|
|
846
880
|
{
|
|
847
881
|
geometry: item,
|
|
848
882
|
dimmed: highlighted != null && highlighted !== item.id,
|
|
849
|
-
markers:
|
|
883
|
+
markers: markersFor(count <= Math.max(2, innerWidth / 9)),
|
|
850
884
|
stacked: stackedAreas,
|
|
851
885
|
...markProps(item.id)
|
|
852
886
|
},
|
|
@@ -986,7 +1020,9 @@ function CartesianPlot({
|
|
|
986
1020
|
"aria-valuenow": (active ?? 0) + 1,
|
|
987
1021
|
"aria-valuetext": valueText,
|
|
988
1022
|
onKeyDown,
|
|
989
|
-
onFocus: () =>
|
|
1023
|
+
onFocus: (event) => {
|
|
1024
|
+
if (event.currentTarget.matches(":focus-visible")) setActive((current) => current ?? 0);
|
|
1025
|
+
},
|
|
990
1026
|
onBlur: () => setActive(null),
|
|
991
1027
|
onPointerDown,
|
|
992
1028
|
onPointerMove,
|
|
@@ -1019,7 +1055,8 @@ function CartesianPlot({
|
|
|
1019
1055
|
y: anchor.y,
|
|
1020
1056
|
containerWidth: width,
|
|
1021
1057
|
title: details.title,
|
|
1022
|
-
rows: details.rows
|
|
1058
|
+
rows: details.rows,
|
|
1059
|
+
footer: details.footer
|
|
1023
1060
|
}
|
|
1024
1061
|
) : null,
|
|
1025
1062
|
range ? /* @__PURE__ */ jsxs(
|
|
@@ -5,7 +5,7 @@ import { type Curve, type Point } from "../path.js";
|
|
|
5
5
|
import type { ChartPattern } from "../patterns.js";
|
|
6
6
|
import { type ContinuousScale } from "../scales/linear.js";
|
|
7
7
|
import { type StackLayer, type StackMode } from "../stack.js";
|
|
8
|
-
import type
|
|
8
|
+
import { type ChartAnnotation, type ValueAxisOptions, type XValue } from "../types.js";
|
|
9
9
|
import { type CartesianAxisSpec } from "./axis-stack.js";
|
|
10
10
|
import type { MarkKind } from "./types.js";
|
|
11
11
|
/** A visible series with its data already cut to the zoom window. */
|
|
@@ -152,9 +152,14 @@ export interface LayoutInput {
|
|
|
152
152
|
categoryGroups?: boolean;
|
|
153
153
|
/** Degrees to tilt the category labels (vertical charts). */
|
|
154
154
|
labelRotation?: number;
|
|
155
|
+
/** Shows every n-th category label, or the ones the predicate accepts; replaces the automatic thinning. */
|
|
156
|
+
categoryTickEvery?: number | ((index: number, label: string) => boolean);
|
|
155
157
|
}
|
|
158
|
+
/** Keeps the category ticks picked by `every`: each n-th one (from the first), or those the predicate accepts. */
|
|
159
|
+
export declare function pickCategoryTicks(ticks: readonly AxisTick[], every: number | ((index: number, label: string) => boolean)): AxisTick[];
|
|
156
160
|
/** Default category label: Spanish short dates, grouped numbers, strings as given. */
|
|
157
161
|
export declare function defaultXLabel(value: XValue): string;
|
|
162
|
+
export declare function axisDomain(series: readonly ResolvedSeries[], layers: ReadonlyMap<string, StackLayer>, options: ValueAxisOptions, annotationValues: readonly number[]): [number, number];
|
|
158
163
|
/**
|
|
159
164
|
* Computes every pixel of a cartesian chart: margins, scales, ticks, paths,
|
|
160
165
|
* bars, labels and annotations. Pure, so it is memoised by the component and
|
|
@@ -9,7 +9,16 @@ import { extent, linearScale } from "../scales/linear.js";
|
|
|
9
9
|
import { logScale } from "../scales/log.js";
|
|
10
10
|
import { shortMonth, timeScale } from "../scales/time.js";
|
|
11
11
|
import { stackLayers } from "../stack.js";
|
|
12
|
+
import {
|
|
13
|
+
resolveAxisBound
|
|
14
|
+
} from "../types.js";
|
|
12
15
|
import { resolveAxes, stackAxes } from "./axis-stack.js";
|
|
16
|
+
function pickCategoryTicks(ticks, every) {
|
|
17
|
+
const step = typeof every === "number" ? Math.max(1, Math.floor(every)) : 0;
|
|
18
|
+
return ticks.filter(
|
|
19
|
+
(tick, index) => typeof every === "function" ? every(index, tick.label) : index % step === 0
|
|
20
|
+
);
|
|
21
|
+
}
|
|
13
22
|
const clamp = (value, lo, hi) => Math.min(hi, Math.max(lo, value));
|
|
14
23
|
function defaultXLabel(value) {
|
|
15
24
|
if (value instanceof Date) return `${value.getDate()} ${shortMonth(value)}`;
|
|
@@ -63,9 +72,7 @@ function axisDomain(series, layers, options, annotationValues) {
|
|
|
63
72
|
lo = Math.min(lo, 0);
|
|
64
73
|
hi = Math.max(hi, 0);
|
|
65
74
|
}
|
|
66
|
-
|
|
67
|
-
if (options.max != null) hi = options.max;
|
|
68
|
-
return [lo, hi];
|
|
75
|
+
return [resolveAxisBound(options.min, lo), resolveAxisBound(options.max, hi)];
|
|
69
76
|
}
|
|
70
77
|
function makeValueScale(domain, range, options, tickCount, fixed) {
|
|
71
78
|
if (options.scale === "log") return logScale({ domain, range });
|
|
@@ -250,7 +257,7 @@ function computeLayout(input) {
|
|
|
250
257
|
position: positions[index],
|
|
251
258
|
label
|
|
252
259
|
}));
|
|
253
|
-
categoryTicks = horizontal ? ticks : rotation ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0) : thinTicks(ticks, 12);
|
|
260
|
+
categoryTicks = input.categoryTickEvery != null ? pickCategoryTicks(ticks, input.categoryTickEvery) : horizontal ? ticks : rotation ? ticks.filter((_, index) => index % Math.max(1, Math.ceil(14 / band.step)) === 0) : thinTicks(ticks, 12);
|
|
254
261
|
indexAt = band.indexAt;
|
|
255
262
|
mode = band.type;
|
|
256
263
|
}
|
|
@@ -545,6 +552,8 @@ function computeLayout(input) {
|
|
|
545
552
|
};
|
|
546
553
|
}
|
|
547
554
|
export {
|
|
555
|
+
axisDomain,
|
|
548
556
|
computeLayout,
|
|
549
|
-
defaultXLabel
|
|
557
|
+
defaultXLabel,
|
|
558
|
+
pickCategoryTicks
|
|
550
559
|
};
|
|
@@ -5,8 +5,8 @@ export interface SeriesMarkProps {
|
|
|
5
5
|
dimmed: boolean;
|
|
6
6
|
/** Id of the gradient (areas) defined in the chart `<defs>`. */
|
|
7
7
|
gradientId?: string;
|
|
8
|
-
/** Static dots on every point (lines and areas). */
|
|
9
|
-
markers: boolean
|
|
8
|
+
/** Static dots on every point (lines and areas), or only on the listed point indices. */
|
|
9
|
+
markers: boolean | ReadonlySet<number>;
|
|
10
10
|
/** Stacked areas use a flatter fill so layers stay distinguishable. */
|
|
11
11
|
stacked: boolean;
|
|
12
12
|
/** Id of a gradient that strokes the line instead of the flat color. */
|
|
@@ -44,7 +44,7 @@ const LineAreaMark = memo(function LineAreaMark2({
|
|
|
44
44
|
}
|
|
45
45
|
) : null,
|
|
46
46
|
markers ? geometry.points.map(
|
|
47
|
-
(point, index) => point ? /* @__PURE__ */ jsx(
|
|
47
|
+
(point, index) => point && (markers === true || markers.has(index)) ? /* @__PURE__ */ jsx(
|
|
48
48
|
"circle",
|
|
49
49
|
{
|
|
50
50
|
cx: point.x,
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import type { ReactNode } from "react";
|
|
2
|
+
import type { ChartDockMode } from "../chart-dock.js";
|
|
2
3
|
import type { ValueFormat } from "../format.js";
|
|
3
4
|
import type { Curve } from "../path.js";
|
|
4
5
|
import type { StackMode } from "../stack.js";
|
|
6
|
+
import type { TooltipRow } from "../tooltip.js";
|
|
5
7
|
import type { ChartAnnotation, ChartLabels, ChartSeries, ValueAxisOptions, XValue } from "../types.js";
|
|
6
8
|
import type { CartesianAxisSpec } from "./axis-stack.js";
|
|
7
9
|
export type MarkKind = "line" | "area" | "column";
|
|
@@ -71,6 +73,21 @@ export interface CartesianOverlay {
|
|
|
71
73
|
svg?: (plot: CartesianPlotInfo) => ReactNode;
|
|
72
74
|
html?: (plot: CartesianPlotInfo) => ReactNode;
|
|
73
75
|
}
|
|
76
|
+
/** What `tooltipRows` receives for the hovered category. */
|
|
77
|
+
export interface CartesianTooltipContext {
|
|
78
|
+
/** Index in the `categories` you passed (not in the zoomed or downsampled window). */
|
|
79
|
+
index: number;
|
|
80
|
+
category: XValue;
|
|
81
|
+
/** The rows the tooltip would show. */
|
|
82
|
+
rows: TooltipRow[];
|
|
83
|
+
}
|
|
84
|
+
/** What `tooltipRows` may replace; omitted parts keep their default. */
|
|
85
|
+
export interface CartesianTooltipContent {
|
|
86
|
+
title?: ReactNode;
|
|
87
|
+
rows?: TooltipRow[];
|
|
88
|
+
/** Rendered under the rows. */
|
|
89
|
+
footer?: ReactNode;
|
|
90
|
+
}
|
|
74
91
|
export interface CartesianChartProps {
|
|
75
92
|
/** One entry per data point: strings, numbers or dates. */
|
|
76
93
|
categories: readonly XValue[];
|
|
@@ -88,8 +105,8 @@ export interface CartesianChartProps {
|
|
|
88
105
|
/** Stacks every area and column series. */
|
|
89
106
|
stack?: StackMode;
|
|
90
107
|
curve?: Curve;
|
|
91
|
-
/** Dots on every line point
|
|
92
|
-
markers?: boolean;
|
|
108
|
+
/** Dots on every line point, or only on these indices of `categories`. Hovered points are always marked. */
|
|
109
|
+
markers?: boolean | readonly number[];
|
|
93
110
|
/** Values printed on the marks. */
|
|
94
111
|
dataLabels?: boolean;
|
|
95
112
|
/** Strokes lines with a gradient from each series color to the next palette color. */
|
|
@@ -126,9 +143,18 @@ export interface CartesianChartProps {
|
|
|
126
143
|
legend?: boolean | "top" | "bottom";
|
|
127
144
|
/** Shared tooltip (default true). */
|
|
128
145
|
tooltip?: boolean;
|
|
146
|
+
/**
|
|
147
|
+
* Where the tooltip's details go: `auto` (default) docks them in a panel under the chart on
|
|
148
|
+
* containers 480px wide or less and on coarse pointers, `always` / `never` force it.
|
|
149
|
+
*/
|
|
150
|
+
dock?: ChartDockMode;
|
|
151
|
+
/** Customises the tooltip content of a category: replace the title or rows, or add a footer. */
|
|
152
|
+
tooltipRows?: (context: CartesianTooltipContext) => CartesianTooltipContent;
|
|
129
153
|
annotations?: readonly ChartAnnotation[];
|
|
130
154
|
/** Tilts the category labels (degrees, e.g. -45) so long names fit; vertical charts only. */
|
|
131
155
|
categoryLabelRotation?: number;
|
|
156
|
+
/** Shows every n-th category label, or those the predicate accepts; replaces the automatic thinning. */
|
|
157
|
+
categoryTickEvery?: number | ((index: number, label: string) => boolean);
|
|
132
158
|
/** Second tier of labels under the category axis (vertical charts); counts must add up to the categories. */
|
|
133
159
|
categoryGroups?: readonly CategoryGroup[];
|
|
134
160
|
/** Click (or Enter on the focused plot) on a category; receives its index in `categories`. */
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type KeyboardEvent, type PointerEvent } from "react";
|
|
1
|
+
import { type FocusEvent, type KeyboardEvent, type PointerEvent } from "react";
|
|
2
2
|
export interface CategoryExplorerOptions {
|
|
3
3
|
count: number;
|
|
4
4
|
/** Hidden categories are skipped by the keyboard and ignored by the pointer. */
|
|
@@ -23,7 +23,7 @@ export interface CategoryExplorer {
|
|
|
23
23
|
onPointerLeave: () => void;
|
|
24
24
|
};
|
|
25
25
|
onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
|
|
26
|
-
onFocus: () => void;
|
|
26
|
+
onFocus: (event?: FocusEvent<HTMLElement>) => void;
|
|
27
27
|
onBlur: () => void;
|
|
28
28
|
}
|
|
29
29
|
/**
|
|
@@ -19,13 +19,14 @@ function useCategoryExplorer({
|
|
|
19
19
|
const target = event.target;
|
|
20
20
|
const hit = target?.closest?.("[data-category]");
|
|
21
21
|
const index = hit ? Number(hit.getAttribute("data-category")) : Number.NaN;
|
|
22
|
+
const rect = event.currentTarget.getBoundingClientRect();
|
|
23
|
+
const at = { x: event.clientX - rect.left, y: event.clientY - rect.top };
|
|
22
24
|
if (!Number.isInteger(index) || !available.includes(index)) {
|
|
23
|
-
|
|
25
|
+
if (active != null) setPointer(at);
|
|
24
26
|
return;
|
|
25
27
|
}
|
|
26
|
-
const rect = event.currentTarget.getBoundingClientRect();
|
|
27
28
|
setActive(index);
|
|
28
|
-
setPointer(
|
|
29
|
+
setPointer(at);
|
|
29
30
|
};
|
|
30
31
|
const onKeyDown = (event) => {
|
|
31
32
|
if (!available.length) return;
|
|
@@ -51,7 +52,10 @@ function useCategoryExplorer({
|
|
|
51
52
|
position: shown == null ? null : pointer ?? anchor(shown),
|
|
52
53
|
pointerProps: { onPointerMove, onPointerLeave: clear },
|
|
53
54
|
onKeyDown,
|
|
54
|
-
onFocus: () =>
|
|
55
|
+
onFocus: (event) => {
|
|
56
|
+
if (event && !event.currentTarget.matches(":focus-visible")) return;
|
|
57
|
+
setActive((current) => current ?? available[0] ?? null);
|
|
58
|
+
},
|
|
55
59
|
onBlur: clear
|
|
56
60
|
};
|
|
57
61
|
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/** How a chart's details are shown: `auto` docks on narrow containers and coarse pointers. */
|
|
2
|
+
export type ChartDockMode = "auto" | "always" | "never";
|
|
3
|
+
/** Viewports up to this width (px) dock their details in `auto` mode. */
|
|
4
|
+
export declare const DOCK_MAX_WIDTH = 480;
|
|
5
|
+
/** Minimum height (px) of a touch target, and the snap radius of a tap. */
|
|
6
|
+
export declare const TOUCH_TARGET = 44;
|
|
7
|
+
/** True on a coarse pointer or a viewport of 480px or less; false during SSR. */
|
|
8
|
+
export declare function useDockDevice(): boolean;
|
|
9
|
+
/** Whether details dock for `mode` on this device (`device` is `useDockDevice()`). */
|
|
10
|
+
export declare function resolveDocked(mode: ChartDockMode, device: boolean): boolean;
|
|
11
|
+
/**
|
|
12
|
+
* Classes that show the reserved panel for `mode` without JavaScript, so server markup already
|
|
13
|
+
* holds the space on a phone: always visible for `always`, on a coarse pointer or a viewport of
|
|
14
|
+
* 480px or less for `auto`.
|
|
15
|
+
*/
|
|
16
|
+
export declare const DOCK_SLOT_VISIBILITY: Record<Exclude<ChartDockMode, "never">, string>;
|
|
17
|
+
export interface ChartDockValue {
|
|
18
|
+
/** Element under the plot that receives docked details; null when the frame never docks. */
|
|
19
|
+
slot: HTMLElement | null;
|
|
20
|
+
docked: boolean;
|
|
21
|
+
/** Announces docked details to screen readers; ignored for mouse hover, debounced. */
|
|
22
|
+
announce: (text: string) => void;
|
|
23
|
+
}
|
|
24
|
+
export declare const ChartDockProvider: import("react").Provider<ChartDockValue>;
|
|
25
|
+
/** Dock state of the enclosing `ChartFrame`. */
|
|
26
|
+
export declare function useChartDock(): ChartDockValue;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { createContext, useContext, useSyncExternalStore } from "react";
|
|
3
|
+
const DOCK_MAX_WIDTH = 480;
|
|
4
|
+
const TOUCH_TARGET = 44;
|
|
5
|
+
const DOCK_QUERY = `(pointer: coarse), (max-width: ${DOCK_MAX_WIDTH}px)`;
|
|
6
|
+
function subscribe(onChange) {
|
|
7
|
+
const media = window.matchMedia(DOCK_QUERY);
|
|
8
|
+
media.addEventListener("change", onChange);
|
|
9
|
+
return () => media.removeEventListener("change", onChange);
|
|
10
|
+
}
|
|
11
|
+
function useDockDevice() {
|
|
12
|
+
return useSyncExternalStore(
|
|
13
|
+
subscribe,
|
|
14
|
+
() => window.matchMedia(DOCK_QUERY).matches,
|
|
15
|
+
() => false
|
|
16
|
+
);
|
|
17
|
+
}
|
|
18
|
+
function resolveDocked(mode, device) {
|
|
19
|
+
if (mode === "always") return true;
|
|
20
|
+
if (mode === "never") return false;
|
|
21
|
+
return device;
|
|
22
|
+
}
|
|
23
|
+
const DOCK_SLOT_VISIBILITY = {
|
|
24
|
+
always: "block",
|
|
25
|
+
auto: "hidden [@media(pointer:coarse)]:block [@media(max-width:480px)]:block"
|
|
26
|
+
};
|
|
27
|
+
const ChartDockContext = createContext({
|
|
28
|
+
slot: null,
|
|
29
|
+
docked: false,
|
|
30
|
+
announce: () => {
|
|
31
|
+
}
|
|
32
|
+
});
|
|
33
|
+
const ChartDockProvider = ChartDockContext.Provider;
|
|
34
|
+
function useChartDock() {
|
|
35
|
+
return useContext(ChartDockContext);
|
|
36
|
+
}
|
|
37
|
+
export {
|
|
38
|
+
ChartDockProvider,
|
|
39
|
+
DOCK_MAX_WIDTH,
|
|
40
|
+
DOCK_SLOT_VISIBILITY,
|
|
41
|
+
TOUCH_TARGET,
|
|
42
|
+
resolveDocked,
|
|
43
|
+
useChartDock,
|
|
44
|
+
useDockDevice
|
|
45
|
+
};
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type ReactNode } from "react";
|
|
2
|
+
import { type ChartDockMode } from "./chart-dock.js";
|
|
2
3
|
import type { ChartLabels } from "./types.js";
|
|
3
4
|
export interface ChartFrameProps {
|
|
4
5
|
/**
|
|
@@ -25,6 +26,12 @@ export interface ChartFrameProps {
|
|
|
25
26
|
legendAside?: boolean;
|
|
26
27
|
/** Accessible data table (usually `ChartDataTable`), rendered after the drawing. */
|
|
27
28
|
table?: ReactNode;
|
|
29
|
+
/**
|
|
30
|
+
* Where a chart's details go. `auto` (default) docks them in a panel under the drawing when the
|
|
31
|
+
* frame is 480px wide or less, or the primary pointer is coarse; `always` / `never` force it.
|
|
32
|
+
* The panel reserves a fixed height (it scrolls past that), so the content below never jumps.
|
|
33
|
+
*/
|
|
34
|
+
dock?: ChartDockMode;
|
|
28
35
|
/** Content under the drawing, e.g. the brush. Hidden while loading or empty. */
|
|
29
36
|
footer?: ReactNode;
|
|
30
37
|
className?: string;
|
|
@@ -37,4 +44,4 @@ export interface ChartFrameProps {
|
|
|
37
44
|
* legend, drawing, footer and the hidden data table in a consistent order.
|
|
38
45
|
* The root has no padding or margin: the drawing touches the container edges.
|
|
39
46
|
*/
|
|
40
|
-
export declare function ChartFrame({ height, aspectRatio, labels, loading, empty, skeleton, legend, legendPosition, legendAside, table, footer, className, children, }: ChartFrameProps): import("react").JSX.Element;
|
|
47
|
+
export declare function ChartFrame({ height, aspectRatio, labels, loading, empty, skeleton, legend, legendPosition, legendAside, table, footer, dock, className, children, }: ChartFrameProps): import("react").JSX.Element;
|