@jcsoftdev/ui 0.2.2 → 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 +292 -5
- 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 +33 -6
- 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 +44 -10
- 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
|
@@ -8,8 +8,10 @@ import {
|
|
|
8
8
|
useContext,
|
|
9
9
|
useEffect,
|
|
10
10
|
useLayoutEffect,
|
|
11
|
+
useMemo,
|
|
11
12
|
useRef,
|
|
12
13
|
useState,
|
|
14
|
+
useSyncExternalStore,
|
|
13
15
|
} from "react";
|
|
14
16
|
import { cn } from "../../utils/cn.js";
|
|
15
17
|
import { useComposedRefs } from "../../utils/compose.js";
|
|
@@ -48,11 +50,57 @@ interface AppShellState {
|
|
|
48
50
|
compact: boolean;
|
|
49
51
|
}
|
|
50
52
|
|
|
51
|
-
|
|
53
|
+
/** Measured compact flag of one `AppShell`, readable through `useSyncExternalStore`. */
|
|
54
|
+
export interface AppShellStore {
|
|
55
|
+
subscribe: (listener: () => void) => () => void;
|
|
56
|
+
getSnapshot: () => boolean;
|
|
57
|
+
/** Same value the first client render reads, so hydration never sees a different snapshot. */
|
|
58
|
+
getServerSnapshot: () => boolean;
|
|
59
|
+
/** Starts measuring `element`; returns the stop function. */
|
|
60
|
+
observe: (element: HTMLElement) => () => void;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export function createAppShellStore(): AppShellStore {
|
|
64
|
+
let compact = false;
|
|
65
|
+
const listeners = new Set<() => void>();
|
|
66
|
+
const set = (next: boolean) => {
|
|
67
|
+
if (next === compact) return;
|
|
68
|
+
compact = next;
|
|
69
|
+
for (const listener of listeners) listener();
|
|
70
|
+
};
|
|
71
|
+
return {
|
|
72
|
+
subscribe(listener) {
|
|
73
|
+
listeners.add(listener);
|
|
74
|
+
return () => void listeners.delete(listener);
|
|
75
|
+
},
|
|
76
|
+
getSnapshot: () => compact,
|
|
77
|
+
getServerSnapshot: () => false,
|
|
78
|
+
observe(element) {
|
|
79
|
+
const measure = () => set(element.getBoundingClientRect().width < APP_SHELL_BREAKPOINT);
|
|
80
|
+
measure();
|
|
81
|
+
if (typeof ResizeObserver === "undefined") return () => {};
|
|
82
|
+
const observer = new ResizeObserver(measure);
|
|
83
|
+
observer.observe(element);
|
|
84
|
+
return () => observer.disconnect();
|
|
85
|
+
},
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const noopSubscribe = () => () => {};
|
|
90
|
+
const alwaysFalse = () => false;
|
|
91
|
+
|
|
92
|
+
/** Not part of the public API; exported for the hydration test. */
|
|
93
|
+
export const AppShellContext = createContext<AppShellStore | null>(null);
|
|
52
94
|
|
|
53
95
|
/** `null` outside an `AppShell`; otherwise whether the shell is narrower than 900 px. */
|
|
54
96
|
export function useAppShell(): AppShellState | null {
|
|
55
|
-
|
|
97
|
+
const store = useContext(AppShellContext);
|
|
98
|
+
const compact = useSyncExternalStore(
|
|
99
|
+
store?.subscribe ?? noopSubscribe,
|
|
100
|
+
store?.getSnapshot ?? alwaysFalse,
|
|
101
|
+
alwaysFalse,
|
|
102
|
+
);
|
|
103
|
+
return useMemo(() => (store ? { compact } : null), [store, compact]);
|
|
56
104
|
}
|
|
57
105
|
|
|
58
106
|
export interface AppShellProps extends ComponentPropsWithRef<"div"> {
|
|
@@ -63,13 +111,21 @@ export interface AppShellProps extends ComponentPropsWithRef<"div"> {
|
|
|
63
111
|
* Root of the app frame (sidebar + topbar + page). It is the `app` container: the sidebar turns
|
|
64
112
|
* into a drawer and the topbar shows its menu button when the SHELL is under 900 px wide,
|
|
65
113
|
* whatever the viewport is, so the same shell works in a full page, a preview or a story.
|
|
114
|
+
*
|
|
115
|
+
* The context value is a store that never changes identity, and it reads `false` on the server
|
|
116
|
+
* and on the first client render. Only components that call `useAppShell` update, and only once
|
|
117
|
+
* the measure arrives, so nothing above a still-dehydrated Suspense boundary re-renders during
|
|
118
|
+
* hydration (a provider value that changed there made Next.js client-render those boundaries).
|
|
66
119
|
*/
|
|
67
120
|
export function AppShell({ children, className, ref: forwardedRef, ...props }: AppShellProps) {
|
|
68
121
|
const ref = useRef<HTMLDivElement>(null);
|
|
69
|
-
const
|
|
122
|
+
const [store] = useState(createAppShellStore);
|
|
70
123
|
const composedRef = useComposedRefs(ref, forwardedRef);
|
|
124
|
+
|
|
125
|
+
useEffect(() => (ref.current ? store.observe(ref.current) : undefined), [store]);
|
|
126
|
+
|
|
71
127
|
return (
|
|
72
|
-
<AppShellContext.Provider value={
|
|
128
|
+
<AppShellContext.Provider value={store}>
|
|
73
129
|
<div ref={composedRef} {...props} className={cn("@container/app flex min-w-0", className)}>
|
|
74
130
|
{children}
|
|
75
131
|
</div>
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import { type ReactNode, useState } from "react";
|
|
4
|
+
import { useUiStrings } from "../../i18n/index.js";
|
|
5
|
+
import { Menu } from "../../icons/index.js";
|
|
6
|
+
import { Drawer, DrawerContent, DrawerTitle } from "../../overlays/drawer/index.js";
|
|
7
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
8
|
+
import { cn } from "../../utils/cn.js";
|
|
9
|
+
import type { SidebarItem, SidebarLinkProps } from "../sidebar/index.js";
|
|
10
|
+
import { BOTTOM_NAV_MAX_SLOTS, splitBottomNavItems } from "./split.js";
|
|
11
|
+
|
|
12
|
+
export interface BottomNavLinkProps extends SidebarLinkProps {
|
|
13
|
+
/** Closes the "More" drawer after a navigation; pass it through to the rendered element. */
|
|
14
|
+
onClick?: () => void;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/** Renders a bottom-nav link; inject your router's link component here. */
|
|
18
|
+
export type BottomNavRenderLink = (props: BottomNavLinkProps) => ReactNode;
|
|
19
|
+
|
|
20
|
+
export type BottomNavPart =
|
|
21
|
+
| "root"
|
|
22
|
+
| "list"
|
|
23
|
+
| "item"
|
|
24
|
+
| "badge"
|
|
25
|
+
| "moreButton"
|
|
26
|
+
| "moreContent"
|
|
27
|
+
| "moreLink"
|
|
28
|
+
| "moreFooter";
|
|
29
|
+
|
|
30
|
+
export interface BottomNavProps {
|
|
31
|
+
/** Same items as `Sidebar` (`groups.flatMap((group) => group.items)`). Order decides what overflows. */
|
|
32
|
+
items: readonly SidebarItem[];
|
|
33
|
+
/** Accessible name of the bar landmark. */
|
|
34
|
+
ariaLabel: string;
|
|
35
|
+
/** Slots in the bar including "More". Defaults to 5; with fewer items than slots there is no "More". */
|
|
36
|
+
maxSlots?: number;
|
|
37
|
+
/** Text of the "More" button and the drawer title. Defaults to the localized "More". */
|
|
38
|
+
moreLabel?: string;
|
|
39
|
+
/** Pinned at the bottom of the "More" drawer, e.g. the account or a sign-out button. */
|
|
40
|
+
moreFooter?: ReactNode;
|
|
41
|
+
/** Link renderer; defaults to a plain anchor. */
|
|
42
|
+
renderLink?: BottomNavRenderLink;
|
|
43
|
+
className?: string;
|
|
44
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
|
|
45
|
+
classNames?: ClassNames<BottomNavPart>;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const defaultRenderLink: BottomNavRenderLink = ({ children, ...props }) => (
|
|
49
|
+
<a {...props}>{children}</a>
|
|
50
|
+
);
|
|
51
|
+
|
|
52
|
+
const slotClasses =
|
|
53
|
+
"relative flex min-h-14 w-full flex-col items-center justify-center gap-0.5 px-1 text-ink-2 text-meta focus-visible:focus-ring aria-[current=page]:font-bold aria-[current=page]:text-accent-ink data-[active=true]:font-bold data-[active=true]:text-accent-ink [&_svg]:size-5 [&_svg]:shrink-0";
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Phone navigation bar for `Sidebar`'s items. The first items fill the bar and the rest move
|
|
57
|
+
* behind a "More" button that opens a drawer. Place it as the last child of the page column
|
|
58
|
+
* inside `AppShell`: it sticks to the bottom of the viewport and hides itself once the shell is
|
|
59
|
+
* 900 px or wider, where the sidebar takes over. Without an `AppShell` it is always visible.
|
|
60
|
+
*/
|
|
61
|
+
export function BottomNav({
|
|
62
|
+
items,
|
|
63
|
+
ariaLabel,
|
|
64
|
+
maxSlots = BOTTOM_NAV_MAX_SLOTS,
|
|
65
|
+
moreLabel,
|
|
66
|
+
moreFooter,
|
|
67
|
+
renderLink = defaultRenderLink,
|
|
68
|
+
className,
|
|
69
|
+
classNames,
|
|
70
|
+
}: BottomNavProps) {
|
|
71
|
+
const strings = useUiStrings();
|
|
72
|
+
const [moreOpen, setMoreOpen] = useState(false);
|
|
73
|
+
const { visible, overflow } = splitBottomNavItems(items, maxSlots);
|
|
74
|
+
const more = moreLabel ?? strings.more;
|
|
75
|
+
const moreActive = overflow.some((item) => item.active);
|
|
76
|
+
|
|
77
|
+
return (
|
|
78
|
+
<>
|
|
79
|
+
<nav
|
|
80
|
+
aria-label={ariaLabel}
|
|
81
|
+
className={cn(
|
|
82
|
+
"sticky bottom-0 z-40 border-t-divider bg-surface pb-[env(safe-area-inset-bottom)] @min-[900px]/app:hidden",
|
|
83
|
+
classNames?.root,
|
|
84
|
+
className,
|
|
85
|
+
)}
|
|
86
|
+
>
|
|
87
|
+
<ul
|
|
88
|
+
className={cn(
|
|
89
|
+
"m-0 grid list-none auto-cols-[minmax(min-content,1fr)] grid-flow-col p-0",
|
|
90
|
+
classNames?.list,
|
|
91
|
+
)}
|
|
92
|
+
>
|
|
93
|
+
{visible.map((item) => (
|
|
94
|
+
<li key={item.id} className={classNames?.item}>
|
|
95
|
+
{renderLink({
|
|
96
|
+
href: item.href,
|
|
97
|
+
"aria-current": item.active ? "page" : undefined,
|
|
98
|
+
className: slotClasses,
|
|
99
|
+
children: (
|
|
100
|
+
<>
|
|
101
|
+
<span className="relative">
|
|
102
|
+
{item.icon}
|
|
103
|
+
{item.badge !== undefined ? (
|
|
104
|
+
<>
|
|
105
|
+
<span
|
|
106
|
+
aria-hidden="true"
|
|
107
|
+
className={cn(
|
|
108
|
+
"absolute -top-0.5 -right-1 size-2 rounded-pill",
|
|
109
|
+
item.badgeTone === "danger" ? "bg-danger" : "bg-warning",
|
|
110
|
+
classNames?.badge,
|
|
111
|
+
)}
|
|
112
|
+
/>
|
|
113
|
+
<span className="sr-only">{item.badgeLabel ?? item.badge}</span>
|
|
114
|
+
</>
|
|
115
|
+
) : null}
|
|
116
|
+
</span>
|
|
117
|
+
<span className="max-w-full truncate">{item.label}</span>
|
|
118
|
+
</>
|
|
119
|
+
),
|
|
120
|
+
})}
|
|
121
|
+
</li>
|
|
122
|
+
))}
|
|
123
|
+
{overflow.length > 0 ? (
|
|
124
|
+
<li className={classNames?.item}>
|
|
125
|
+
<button
|
|
126
|
+
type="button"
|
|
127
|
+
data-active={moreActive}
|
|
128
|
+
aria-haspopup="dialog"
|
|
129
|
+
aria-expanded={moreOpen}
|
|
130
|
+
onClick={() => setMoreOpen(true)}
|
|
131
|
+
className={cn(slotClasses, classNames?.moreButton)}
|
|
132
|
+
>
|
|
133
|
+
<Menu aria-hidden="true" />
|
|
134
|
+
<span>{more}</span>
|
|
135
|
+
</button>
|
|
136
|
+
</li>
|
|
137
|
+
) : null}
|
|
138
|
+
</ul>
|
|
139
|
+
</nav>
|
|
140
|
+
|
|
141
|
+
{overflow.length > 0 ? (
|
|
142
|
+
<Drawer open={moreOpen} onOpenChange={setMoreOpen}>
|
|
143
|
+
<DrawerContent
|
|
144
|
+
aria-describedby={undefined}
|
|
145
|
+
className={cn("gap-4 p-4", classNames?.moreContent)}
|
|
146
|
+
>
|
|
147
|
+
<DrawerTitle className="font-semibold text-lede">{more}</DrawerTitle>
|
|
148
|
+
<nav aria-label={more} className="flex flex-col gap-px">
|
|
149
|
+
{overflow.map((item) => (
|
|
150
|
+
<div key={item.id}>
|
|
151
|
+
{renderLink({
|
|
152
|
+
href: item.href,
|
|
153
|
+
"aria-current": item.active ? "page" : undefined,
|
|
154
|
+
onClick: () => setMoreOpen(false),
|
|
155
|
+
className: cn(
|
|
156
|
+
"flex min-h-11 items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring aria-[current=page]:bg-accent-soft aria-[current=page]:font-bold aria-[current=page]:text-accent-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
|
|
157
|
+
classNames?.moreLink,
|
|
158
|
+
),
|
|
159
|
+
children: (
|
|
160
|
+
<>
|
|
161
|
+
{item.icon}
|
|
162
|
+
<span className="min-w-0 truncate">{item.label}</span>
|
|
163
|
+
{item.badge !== undefined ? (
|
|
164
|
+
<span className="ml-auto shrink-0 rounded-chip bg-surface-2 px-1.5 py-0.75 text-count text-ink-2">
|
|
165
|
+
{item.badge}
|
|
166
|
+
{item.badgeLabel ? (
|
|
167
|
+
<span className="sr-only"> {item.badgeLabel}</span>
|
|
168
|
+
) : null}
|
|
169
|
+
</span>
|
|
170
|
+
) : null}
|
|
171
|
+
</>
|
|
172
|
+
),
|
|
173
|
+
})}
|
|
174
|
+
</div>
|
|
175
|
+
))}
|
|
176
|
+
</nav>
|
|
177
|
+
{moreFooter ? (
|
|
178
|
+
<div className={cn("mt-auto border-t-divider pt-3", classNames?.moreFooter)}>
|
|
179
|
+
{moreFooter}
|
|
180
|
+
</div>
|
|
181
|
+
) : null}
|
|
182
|
+
</DrawerContent>
|
|
183
|
+
</Drawer>
|
|
184
|
+
) : null}
|
|
185
|
+
</>
|
|
186
|
+
);
|
|
187
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/** Slots of a bottom bar on a phone, the "More" button included. */
|
|
2
|
+
export const BOTTOM_NAV_MAX_SLOTS = 5;
|
|
3
|
+
|
|
4
|
+
export interface BottomNavSplit<T> {
|
|
5
|
+
visible: T[];
|
|
6
|
+
overflow: T[];
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Items shown in the bar and items moved behind "More". Everything fits when there are at most
|
|
11
|
+
* `maxSlots` items; otherwise one slot is given to "More" and the rest overflow in order.
|
|
12
|
+
*/
|
|
13
|
+
export function splitBottomNavItems<T>(
|
|
14
|
+
items: readonly T[],
|
|
15
|
+
maxSlots: number = BOTTOM_NAV_MAX_SLOTS,
|
|
16
|
+
): BottomNavSplit<T> {
|
|
17
|
+
const slots = Math.max(2, Math.floor(maxSlots));
|
|
18
|
+
if (items.length <= slots) return { visible: [...items], overflow: [] };
|
|
19
|
+
return { visible: items.slice(0, slots - 1), overflow: items.slice(slots - 1) };
|
|
20
|
+
}
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
|
|
3
|
-
import { type ReactNode, useEffect, useRef } from "react";
|
|
3
|
+
import { type CSSProperties, type ReactNode, useEffect, useRef } from "react";
|
|
4
4
|
import type { ClassNames } from "../../utils/class-names.js";
|
|
5
5
|
import { cn } from "../../utils/cn.js";
|
|
6
|
+
import { type Material, materialClass } from "../../utils/material.js";
|
|
6
7
|
import { useAppShell, useCompactContainer } from "../app-shell/app-shell.js";
|
|
7
8
|
|
|
8
9
|
export interface SidebarLinkProps {
|
|
@@ -10,6 +11,8 @@ export interface SidebarLinkProps {
|
|
|
10
11
|
className: string;
|
|
11
12
|
children: ReactNode;
|
|
12
13
|
"aria-current"?: "page";
|
|
14
|
+
/** Set in rail mode, where the label is visually hidden. */
|
|
15
|
+
title?: string;
|
|
13
16
|
}
|
|
14
17
|
|
|
15
18
|
/** Renders a navigation link; inject your router's link component here. */
|
|
@@ -58,7 +61,18 @@ export interface SidebarProps {
|
|
|
58
61
|
/** Drawer state when the app container is under 900 px. Ignored above it, where the sidebar is always visible. */
|
|
59
62
|
open?: boolean;
|
|
60
63
|
onClose?: () => void;
|
|
64
|
+
/** Icons-only rail with the labels as tooltips. Ignored while the sidebar is a drawer. */
|
|
65
|
+
collapsed?: boolean;
|
|
61
66
|
className?: string;
|
|
67
|
+
/** Inline style of the root (for example `liquidStyle()` options). */
|
|
68
|
+
style?: CSSProperties;
|
|
69
|
+
/**
|
|
70
|
+
* Surface material. Omitted keeps the default for this layer (opaque, glass in the glass
|
|
71
|
+
* preset); `"glass"` and `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"`
|
|
72
|
+
* Liquid Glass, `"solid"` forces opaque. Liquid options go in `style` (`liquidStyle()` from
|
|
73
|
+
* `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
|
|
74
|
+
*/
|
|
75
|
+
material?: Material;
|
|
62
76
|
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
|
|
63
77
|
classNames?: ClassNames<SidebarPart>;
|
|
64
78
|
}
|
|
@@ -81,7 +95,10 @@ export function Sidebar({
|
|
|
81
95
|
renderLink = defaultRenderLink,
|
|
82
96
|
open = false,
|
|
83
97
|
onClose,
|
|
98
|
+
collapsed = false,
|
|
99
|
+
material,
|
|
84
100
|
className,
|
|
101
|
+
style,
|
|
85
102
|
classNames,
|
|
86
103
|
}: SidebarProps) {
|
|
87
104
|
const shell = useAppShell();
|
|
@@ -90,6 +107,7 @@ export function Sidebar({
|
|
|
90
107
|
const isMobile = shell ? shell.compact : parentCompact;
|
|
91
108
|
const closedOnMobile = isMobile && !open;
|
|
92
109
|
const openOnMobile = isMobile && open;
|
|
110
|
+
const rail = collapsed && !isMobile;
|
|
93
111
|
|
|
94
112
|
useEffect(() => {
|
|
95
113
|
if (!openOnMobile) return;
|
|
@@ -113,7 +131,8 @@ export function Sidebar({
|
|
|
113
131
|
aria-label={ariaLabel}
|
|
114
132
|
inert={closedOnMobile || undefined}
|
|
115
133
|
className={cn(
|
|
116
|
-
"fixed inset-y-0 left-0 z-45 flex h-screen
|
|
134
|
+
"fixed inset-y-0 left-0 z-45 flex h-screen flex-col gap-4.5 overflow-y-auto border-r-divider surface-side pt-3.5 pb-3 transition-transform duration-200",
|
|
135
|
+
rail ? "w-[4.5rem] px-2" : "w-side-width px-3",
|
|
117
136
|
// Inside AppShell the container query decides before any script runs (no flash on a
|
|
118
137
|
// narrow first paint); the measured state only drives inert, the scrim and focus.
|
|
119
138
|
shell
|
|
@@ -126,9 +145,11 @@ export function Sidebar({
|
|
|
126
145
|
closedOnMobile ? "-translate-x-full" : "translate-x-0",
|
|
127
146
|
),
|
|
128
147
|
openOnMobile && "shadow-overlay",
|
|
148
|
+
materialClass(material, "surface-solid [--surface-solid:var(--surface)]"),
|
|
129
149
|
classNames?.root,
|
|
130
150
|
className,
|
|
131
151
|
)}
|
|
152
|
+
style={style}
|
|
132
153
|
>
|
|
133
154
|
{header}
|
|
134
155
|
{groups.map((group) => (
|
|
@@ -137,7 +158,13 @@ export function Sidebar({
|
|
|
137
158
|
aria-label={group.label}
|
|
138
159
|
className={cn("flex flex-col gap-px", classNames?.group)}
|
|
139
160
|
>
|
|
140
|
-
<div
|
|
161
|
+
<div
|
|
162
|
+
className={cn(
|
|
163
|
+
"px-2.5 pb-1.5 text-overline text-ink-3",
|
|
164
|
+
rail && "sr-only",
|
|
165
|
+
classNames?.groupLabel,
|
|
166
|
+
)}
|
|
167
|
+
>
|
|
141
168
|
{group.label}
|
|
142
169
|
</div>
|
|
143
170
|
{group.items.map((item) => {
|
|
@@ -150,18 +177,37 @@ export function Sidebar({
|
|
|
150
177
|
{renderLink({
|
|
151
178
|
href: item.href,
|
|
152
179
|
"aria-current": item.active ? "page" : undefined,
|
|
180
|
+
title: rail ? item.label : undefined,
|
|
153
181
|
className: cn(
|
|
154
182
|
"flex items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
|
|
183
|
+
rail && "relative justify-center in-data-[density=touch]:min-h-11",
|
|
155
184
|
item.active && "bg-accent-soft font-bold text-accent-ink",
|
|
156
185
|
classNames?.link,
|
|
157
186
|
),
|
|
158
187
|
children: (
|
|
159
188
|
<>
|
|
160
189
|
{item.icon}
|
|
161
|
-
<span
|
|
190
|
+
<span
|
|
191
|
+
className={cn("min-w-0 truncate", rail && "sr-only", classNames?.label)}
|
|
192
|
+
>
|
|
162
193
|
{item.label}
|
|
163
194
|
</span>
|
|
164
|
-
{item.badge !== undefined ? (
|
|
195
|
+
{item.badge !== undefined && rail ? (
|
|
196
|
+
<>
|
|
197
|
+
<span
|
|
198
|
+
aria-hidden="true"
|
|
199
|
+
className={cn(
|
|
200
|
+
"absolute top-1 right-1 size-2 rounded-full ring-2 ring-surface",
|
|
201
|
+
item.badgeTone === "danger" ? "bg-danger" : "bg-accent",
|
|
202
|
+
classNames?.badge,
|
|
203
|
+
)}
|
|
204
|
+
/>
|
|
205
|
+
<span className="sr-only">
|
|
206
|
+
{item.badge}
|
|
207
|
+
{item.badgeLabel ? ` ${item.badgeLabel}` : null}
|
|
208
|
+
</span>
|
|
209
|
+
</>
|
|
210
|
+
) : item.badge !== undefined ? (
|
|
165
211
|
<span
|
|
166
212
|
className={cn(
|
|
167
213
|
"ml-auto shrink-0 rounded-chip px-1.5 py-0.75 text-count",
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
|
|
3
|
-
import { type ReactNode, type Ref, useEffect, useState } from "react";
|
|
3
|
+
import { type CSSProperties, type ReactNode, type Ref, useEffect, useState } from "react";
|
|
4
4
|
import { Menu, Search } from "../../icons/index.js";
|
|
5
5
|
import type { ClassNames } from "../../utils/class-names.js";
|
|
6
6
|
import { cn } from "../../utils/cn.js";
|
|
7
|
+
import { type Material, materialClass } from "../../utils/material.js";
|
|
7
8
|
|
|
8
9
|
function isApplePlatform(): boolean {
|
|
9
10
|
if (typeof navigator === "undefined") return false;
|
|
@@ -23,24 +24,34 @@ export type TopbarPart =
|
|
|
23
24
|
| "shortcut";
|
|
24
25
|
|
|
25
26
|
export interface TopbarProps {
|
|
26
|
-
/** Breadcrumb trail in order; the last entry is the current view. */
|
|
27
|
-
breadcrumbs
|
|
27
|
+
/** Breadcrumb trail in order; the last entry is the current view. Nothing renders when absent or empty. */
|
|
28
|
+
breadcrumbs?: string[];
|
|
28
29
|
/** Accessible name of the breadcrumb landmark. */
|
|
29
|
-
breadcrumbsLabel
|
|
30
|
+
breadcrumbsLabel?: string;
|
|
30
31
|
/** Menu button (shown when the `AppShell` container is under 900 px, matching the Sidebar drawer) that opens the sidebar drawer. Needs an `@container/app` ancestor, which `AppShell` provides. Omitted when not set. */
|
|
31
32
|
onOpenMenu?: () => void;
|
|
32
33
|
menuLabel?: string;
|
|
33
34
|
/** Ref to the menu button so the opener can restore focus when the drawer closes. */
|
|
34
35
|
menuButtonRef?: Ref<HTMLButtonElement>;
|
|
35
|
-
/** Called by the search trigger and by Cmd/Ctrl+K. */
|
|
36
|
-
onSearch
|
|
37
|
-
|
|
38
|
-
|
|
36
|
+
/** Called by the search trigger and by Cmd/Ctrl+K. The trigger and the shortcut are absent without it. */
|
|
37
|
+
onSearch?: () => void;
|
|
38
|
+
/** Accessible name of the search trigger; defaults to the placeholder. */
|
|
39
|
+
searchLabel?: string;
|
|
40
|
+
searchPlaceholder?: string;
|
|
39
41
|
/** Slot between the search trigger and the end block (status, notifications, primary action). */
|
|
40
42
|
actions?: ReactNode;
|
|
41
43
|
/** Slot at the far end (e.g. the account menu). */
|
|
42
44
|
end?: ReactNode;
|
|
43
45
|
className?: string;
|
|
46
|
+
/** Inline style of the root (for example `liquidStyle()` options). */
|
|
47
|
+
style?: CSSProperties;
|
|
48
|
+
/**
|
|
49
|
+
* Surface material. Omitted keeps the default for this layer (opaque, glass in the glass
|
|
50
|
+
* preset); `"glass"` and `"glass-clear"` are frosted glass, `"liquid"` and `"liquid-clear"`
|
|
51
|
+
* Liquid Glass, `"solid"` forces opaque. Liquid options go in `style` (`liquidStyle()` from
|
|
52
|
+
* `@jcsoftdev/ui/liquid`); the lens needs `<LiquidGlass />` mounted once.
|
|
53
|
+
*/
|
|
54
|
+
material?: Material;
|
|
44
55
|
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
|
|
45
56
|
classNames?: ClassNames<TopbarPart>;
|
|
46
57
|
}
|
|
@@ -56,6 +67,8 @@ export function Topbar({
|
|
|
56
67
|
searchPlaceholder,
|
|
57
68
|
actions,
|
|
58
69
|
end,
|
|
70
|
+
material,
|
|
71
|
+
style,
|
|
59
72
|
className,
|
|
60
73
|
classNames,
|
|
61
74
|
}: TopbarProps) {
|
|
@@ -66,25 +79,29 @@ export function Topbar({
|
|
|
66
79
|
}, []);
|
|
67
80
|
|
|
68
81
|
useEffect(() => {
|
|
82
|
+
if (!onSearch) return;
|
|
69
83
|
function onKeyDown(event: KeyboardEvent) {
|
|
70
84
|
if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "k") return;
|
|
71
85
|
event.preventDefault();
|
|
72
|
-
onSearch();
|
|
86
|
+
onSearch?.();
|
|
73
87
|
}
|
|
74
88
|
window.addEventListener("keydown", onKeyDown);
|
|
75
89
|
return () => window.removeEventListener("keydown", onKeyDown);
|
|
76
90
|
}, [onSearch]);
|
|
77
91
|
|
|
78
|
-
const
|
|
79
|
-
const
|
|
92
|
+
const trail = breadcrumbs ?? [];
|
|
93
|
+
const current = trail.at(-1);
|
|
94
|
+
const previous = trail.slice(0, -1);
|
|
80
95
|
|
|
81
96
|
return (
|
|
82
97
|
<header
|
|
83
98
|
className={cn(
|
|
84
|
-
"@container/topbar sticky top-0 z-30 h-top-height border-b-divider
|
|
99
|
+
"@container/topbar sticky top-0 z-30 h-top-height border-b-divider surface-nav",
|
|
100
|
+
materialClass(material, "surface-solid [--surface-solid:var(--bg)]"),
|
|
85
101
|
classNames?.root,
|
|
86
102
|
className,
|
|
87
103
|
)}
|
|
104
|
+
style={style}
|
|
88
105
|
>
|
|
89
106
|
<div
|
|
90
107
|
className={cn(
|
|
@@ -107,57 +124,63 @@ export function Topbar({
|
|
|
107
124
|
</button>
|
|
108
125
|
) : null}
|
|
109
126
|
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
{previous.map((crumb) => (
|
|
118
|
-
<span
|
|
119
|
-
key={crumb}
|
|
120
|
-
className={cn(
|
|
121
|
-
"flex items-center gap-2 @max-[560px]/topbar:hidden",
|
|
122
|
-
classNames?.crumb,
|
|
123
|
-
)}
|
|
124
|
-
>
|
|
125
|
-
<span>{crumb}</span>
|
|
126
|
-
<span aria-hidden="true" className={cn("text-line-control", classNames?.separator)}>
|
|
127
|
-
/
|
|
128
|
-
</span>
|
|
129
|
-
</span>
|
|
130
|
-
))}
|
|
131
|
-
<strong
|
|
132
|
-
aria-current="page"
|
|
133
|
-
className={cn("min-w-0 truncate font-semibold text-ink", classNames?.current)}
|
|
127
|
+
{trail.length > 0 ? (
|
|
128
|
+
<nav
|
|
129
|
+
aria-label={breadcrumbsLabel}
|
|
130
|
+
className={cn(
|
|
131
|
+
"flex min-w-0 shrink items-center gap-2 whitespace-nowrap text-ink-3 text-meta",
|
|
132
|
+
classNames?.breadcrumbs,
|
|
133
|
+
)}
|
|
134
134
|
>
|
|
135
|
-
{
|
|
136
|
-
|
|
137
|
-
|
|
135
|
+
{previous.map((crumb) => (
|
|
136
|
+
<span
|
|
137
|
+
key={crumb}
|
|
138
|
+
className={cn(
|
|
139
|
+
"flex items-center gap-2 @max-[560px]/topbar:hidden",
|
|
140
|
+
classNames?.crumb,
|
|
141
|
+
)}
|
|
142
|
+
>
|
|
143
|
+
<span>{crumb}</span>
|
|
144
|
+
<span aria-hidden="true" className={cn("text-line-control", classNames?.separator)}>
|
|
145
|
+
/
|
|
146
|
+
</span>
|
|
147
|
+
</span>
|
|
148
|
+
))}
|
|
149
|
+
<strong
|
|
150
|
+
aria-current="page"
|
|
151
|
+
className={cn("min-w-0 truncate font-semibold text-ink", classNames?.current)}
|
|
152
|
+
>
|
|
153
|
+
{current}
|
|
154
|
+
</strong>
|
|
155
|
+
</nav>
|
|
156
|
+
) : null}
|
|
138
157
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
"ml-auto flex h-8.5 w-[min(320px,38cqw)] shrink-0 items-center gap-2 rounded-input border-control bg-surface-control pr-2 pl-2.5 text-ink-3 text-meta @max-[700px]/topbar:w-8.5 @max-[700px]/topbar:justify-center @max-[700px]/topbar:px-0",
|
|
145
|
-
classNames?.search,
|
|
146
|
-
)}
|
|
147
|
-
>
|
|
148
|
-
<Search className="size-4 shrink-0" aria-hidden="true" />
|
|
149
|
-
<span className={cn("truncate @max-[700px]/topbar:hidden", classNames?.searchText)}>
|
|
150
|
-
{searchPlaceholder}
|
|
151
|
-
</span>
|
|
152
|
-
<span
|
|
158
|
+
{onSearch ? (
|
|
159
|
+
<button
|
|
160
|
+
type="button"
|
|
161
|
+
aria-label={searchLabel ?? searchPlaceholder}
|
|
162
|
+
onClick={onSearch}
|
|
153
163
|
className={cn(
|
|
154
|
-
"ml-auto rounded-
|
|
155
|
-
classNames?.
|
|
164
|
+
"ml-auto flex h-8.5 w-[min(320px,38cqw)] shrink-0 items-center gap-2 rounded-input border-control bg-surface-control pr-2 pl-2.5 text-ink-3 text-meta @max-[700px]/topbar:w-8.5 @max-[700px]/topbar:justify-center @max-[700px]/topbar:px-0",
|
|
165
|
+
classNames?.search,
|
|
156
166
|
)}
|
|
157
167
|
>
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
168
|
+
<Search className="size-4 shrink-0" aria-hidden="true" />
|
|
169
|
+
<span className={cn("truncate @max-[700px]/topbar:hidden", classNames?.searchText)}>
|
|
170
|
+
{searchPlaceholder}
|
|
171
|
+
</span>
|
|
172
|
+
<span
|
|
173
|
+
className={cn(
|
|
174
|
+
"ml-auto rounded-xs border-divider bg-surface-2 px-1.25 py-0.5 font-mono text-count text-ink-2 @max-[700px]/topbar:hidden",
|
|
175
|
+
classNames?.shortcut,
|
|
176
|
+
)}
|
|
177
|
+
>
|
|
178
|
+
{shortcut}
|
|
179
|
+
</span>
|
|
180
|
+
</button>
|
|
181
|
+
) : (
|
|
182
|
+
<span aria-hidden="true" className="ml-auto" />
|
|
183
|
+
)}
|
|
161
184
|
|
|
162
185
|
{actions}
|
|
163
186
|
{end}
|
|
@@ -8,14 +8,24 @@ export interface EmptyStateProps {
|
|
|
8
8
|
description?: ReactNode;
|
|
9
9
|
/** Primary call to action. */
|
|
10
10
|
action?: ReactNode;
|
|
11
|
+
/** `outlined` draws a dashed border around the state. */
|
|
12
|
+
variant?: "plain" | "outlined";
|
|
11
13
|
className?: string;
|
|
12
14
|
}
|
|
13
15
|
|
|
14
|
-
export function EmptyState({
|
|
16
|
+
export function EmptyState({
|
|
17
|
+
icon,
|
|
18
|
+
title,
|
|
19
|
+
description,
|
|
20
|
+
action,
|
|
21
|
+
variant = "plain",
|
|
22
|
+
className,
|
|
23
|
+
}: EmptyStateProps) {
|
|
15
24
|
return (
|
|
16
25
|
<div
|
|
17
26
|
className={cn(
|
|
18
27
|
"@container/empty flex min-w-0 flex-col items-center gap-2 px-4 py-8 text-center @min-[360px]/empty:px-6 @min-[360px]/empty:py-12",
|
|
28
|
+
variant === "outlined" && "rounded-card border border-line-control border-dashed",
|
|
19
29
|
className,
|
|
20
30
|
)}
|
|
21
31
|
>
|