@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
|
@@ -0,0 +1,306 @@
|
|
|
1
|
+
import type { CSSProperties } from "react";
|
|
2
|
+
|
|
3
|
+
/** How the lens bends the backdrop. See {@link LiquidGlassOptions.profile}. */
|
|
4
|
+
export type LiquidProfile = "rim" | "full" | "dome" | "crystal";
|
|
5
|
+
|
|
6
|
+
/** What the surface does under the pointer. See {@link LiquidGlassOptions.interactive}. */
|
|
7
|
+
export type LiquidInteractive = "none" | "press" | "drag";
|
|
8
|
+
|
|
9
|
+
/** Named spring of the surface motion, or `false` for none. See {@link LiquidGlassOptions.motion}. */
|
|
10
|
+
export type LiquidMotion = false | "snappy" | "smooth" | "soft" | "jelly";
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Everything that shapes a Liquid Glass surface. Every field is optional and maps to one
|
|
14
|
+
* `--liquid-*` custom property (see {@link liquidStyle}), so the same configuration can come from
|
|
15
|
+
* a prop, a scope (`style`, a class) or the theme (`:root { --liquid-frost: 3px }`): the lens
|
|
16
|
+
* engine and the CSS read the same variables, and they inherit.
|
|
17
|
+
*
|
|
18
|
+
* Omitted fields keep the theme's look ({@link LIQUID_DEFAULTS}). The contrast guarantee of the
|
|
19
|
+
* kit (ink 4.5:1 over the supported backdrops) holds for the defaults only: a lower `opacity`, a
|
|
20
|
+
* `tint`, `grain` or a thinner `frost` can leave text without it.
|
|
21
|
+
*/
|
|
22
|
+
export interface LiquidGlassOptions {
|
|
23
|
+
/**
|
|
24
|
+
* Strength of the bend, 0 to 1, as a fraction of the strongest offset that cannot fold the
|
|
25
|
+
* backdrop back on itself. `0` is flat glass. Default 1. With `profile: "crystal"` the range is
|
|
26
|
+
* 0 to 2: a minifying lens cannot fold, so it can be pushed further (1.67 is a thick lens).
|
|
27
|
+
*/
|
|
28
|
+
refraction?: number;
|
|
29
|
+
/**
|
|
30
|
+
* Thickness of the glass edge in px. For `profile: "rim"` it is the width of the refracting
|
|
31
|
+
* band; for `"full"` and `"dome"` it caps the largest offset. Default: derived from the corner
|
|
32
|
+
* radius and the size (up to 24 px for the whole-surface profiles).
|
|
33
|
+
*/
|
|
34
|
+
bevelWidth?: number;
|
|
35
|
+
/**
|
|
36
|
+
* `"full"` (default): a superellipse dome over the whole surface. `"dome"`: a rounder,
|
|
37
|
+
* elliptical drop that is flatter in the middle. `"rim"`: only a bevel along the edge, the
|
|
38
|
+
* middle shows the backdrop undisplaced. `"crystal"`: a thick convex lens that minifies the
|
|
39
|
+
* backdrop (it shows a wider area than the surface covers), bending steeply towards the rim;
|
|
40
|
+
* meant to be clear (`frost: 0`, `opacity: 0`) and has no contrast guarantee.
|
|
41
|
+
*/
|
|
42
|
+
profile?: LiquidProfile;
|
|
43
|
+
/** Chromatic dispersion, 0 to 0.2: how far apart the colour channels are pulled. Default 0. Small surfaces only. */
|
|
44
|
+
dispersion?: number;
|
|
45
|
+
/** Backdrop blur (frost) in px. Default 2 (regular), 0.6 (clear). */
|
|
46
|
+
frost?: number;
|
|
47
|
+
/** Backdrop saturation, 1 is unchanged. Default 1.5. */
|
|
48
|
+
saturation?: number;
|
|
49
|
+
/** Backdrop brightness, 1 is unchanged. Default 1. */
|
|
50
|
+
brightness?: number;
|
|
51
|
+
/** A colour laid over the glass: `amount` (0 to 1, default 0.2) is its opacity. */
|
|
52
|
+
tint?: { color: string; amount?: number };
|
|
53
|
+
/** Strength of the edge highlight (the lit and the opposite rim), 0 to 2. Default 1. */
|
|
54
|
+
rim?: number;
|
|
55
|
+
/** The highlight on the walls facing the light. `angle` is degrees clockwise from +x (default -120, upper left). */
|
|
56
|
+
specular?: { intensity?: number; angle?: number };
|
|
57
|
+
/** Extra glow that grows towards the edge, 0 to 1. Default 0. */
|
|
58
|
+
fresnel?: number;
|
|
59
|
+
/** Film grain over the glass, 0 to 1. Default 0. */
|
|
60
|
+
grain?: number;
|
|
61
|
+
/** Corner radius in px. Default: the component's own. */
|
|
62
|
+
radius?: number;
|
|
63
|
+
/**
|
|
64
|
+
* Opacity of the legibility veil, 0 to 1. Default 1. Lower values let the backdrop through and
|
|
65
|
+
* drop the contrast guarantee.
|
|
66
|
+
*/
|
|
67
|
+
opacity?: number;
|
|
68
|
+
/** Outer shadow: `opacity` multiplies its colour, `spread` adds to its blur (px), `offsetY` drops it (px). */
|
|
69
|
+
shadow?: { opacity?: number; spread?: number; offsetY?: number };
|
|
70
|
+
/**
|
|
71
|
+
* Pointer behaviour. `"press"`: the lens deepens and the surface swells while pressed.
|
|
72
|
+
* `"drag"`: the surface can also be dragged (rubber-banded) and squashes with the speed.
|
|
73
|
+
* `"none"`: static. Default: `"press"` on buttons, links and `data-glass-interactive`
|
|
74
|
+
* elements, `"none"` elsewhere.
|
|
75
|
+
*/
|
|
76
|
+
interactive?: LiquidInteractive;
|
|
77
|
+
/** Spring of the motion above, or `false` to turn it off. Default `"snappy"`. */
|
|
78
|
+
motion?: LiquidMotion;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** What each field resolves to when nothing sets it. `undefined` means "derived at run time". */
|
|
82
|
+
export const LIQUID_DEFAULTS = {
|
|
83
|
+
refraction: 1,
|
|
84
|
+
bevelWidth: undefined,
|
|
85
|
+
profile: "full",
|
|
86
|
+
dispersion: 0,
|
|
87
|
+
frost: 2,
|
|
88
|
+
saturation: 1.5,
|
|
89
|
+
brightness: 1,
|
|
90
|
+
tint: { color: "transparent", amount: 0.2 },
|
|
91
|
+
rim: 1,
|
|
92
|
+
specular: { intensity: 1, angle: -120 },
|
|
93
|
+
fresnel: 0,
|
|
94
|
+
grain: 0,
|
|
95
|
+
radius: undefined,
|
|
96
|
+
opacity: 1,
|
|
97
|
+
shadow: { opacity: 1, spread: 0, offsetY: 10 },
|
|
98
|
+
interactive: undefined,
|
|
99
|
+
motion: "snappy",
|
|
100
|
+
} as const satisfies LiquidGlassOptions;
|
|
101
|
+
|
|
102
|
+
/** Names of the `data-glass` presets. */
|
|
103
|
+
export type LiquidPresetName = "clear" | "regular" | "thick" | "crystal";
|
|
104
|
+
|
|
105
|
+
/** The `clear` preset (`data-glass="liquid-clear"`): thin, lighter frost and veil. */
|
|
106
|
+
export const LIQUID_PRESET_CLEAR: LiquidGlassOptions = {
|
|
107
|
+
frost: 0.6,
|
|
108
|
+
opacity: 0.75,
|
|
109
|
+
refraction: 0.9,
|
|
110
|
+
shadow: { opacity: 0.7 },
|
|
111
|
+
specular: { intensity: 1.1 },
|
|
112
|
+
};
|
|
113
|
+
|
|
114
|
+
/** The `regular` preset: the theme's look. */
|
|
115
|
+
export const LIQUID_PRESET_REGULAR: LiquidGlassOptions = {};
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* The `crystal` preset: a thick, fully clear convex lens. The backdrop is minified and bent hard
|
|
119
|
+
* towards the rim, the colour channels split at the edge, no frost, no veil, a thin bright rim.
|
|
120
|
+
* Over busy content text is not legible: there is no contrast guarantee, put short bold labels
|
|
121
|
+
* with a text shadow on it. On a lensed surface it loads the crystal and dispersion parts.
|
|
122
|
+
*/
|
|
123
|
+
export const LIQUID_PRESET_CRYSTAL: LiquidGlassOptions = {
|
|
124
|
+
profile: "crystal",
|
|
125
|
+
refraction: 1.67,
|
|
126
|
+
dispersion: 0.05,
|
|
127
|
+
frost: 0,
|
|
128
|
+
saturation: 1,
|
|
129
|
+
opacity: 0,
|
|
130
|
+
tint: { color: "transparent", amount: 0 },
|
|
131
|
+
rim: 0.6,
|
|
132
|
+
specular: { intensity: 0 },
|
|
133
|
+
fresnel: 1,
|
|
134
|
+
shadow: { opacity: 0.8 },
|
|
135
|
+
};
|
|
136
|
+
|
|
137
|
+
/** The `thick` preset (`data-glass="liquid-thick"`): a wide bevel, more frost, a deeper shadow. */
|
|
138
|
+
export const LIQUID_PRESET_THICK: LiquidGlassOptions = {
|
|
139
|
+
bevelWidth: 32,
|
|
140
|
+
frost: 3,
|
|
141
|
+
refraction: 1,
|
|
142
|
+
rim: 1.25,
|
|
143
|
+
fresnel: 0.35,
|
|
144
|
+
shadow: { opacity: 1.2, spread: 12, offsetY: 16 },
|
|
145
|
+
};
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* The same presets that `data-glass="liquid-clear|liquid-regular|liquid-thick"` selects in
|
|
149
|
+
* `base.css`. `regular` is the theme's look.
|
|
150
|
+
*/
|
|
151
|
+
export const LIQUID_PRESETS: Record<LiquidPresetName, LiquidGlassOptions> = {
|
|
152
|
+
clear: LIQUID_PRESET_CLEAR,
|
|
153
|
+
regular: LIQUID_PRESET_REGULAR,
|
|
154
|
+
crystal: LIQUID_PRESET_CRYSTAL,
|
|
155
|
+
thick: LIQUID_PRESET_THICK,
|
|
156
|
+
};
|
|
157
|
+
|
|
158
|
+
const clamp = (value: number, min: number, max: number) => Math.min(Math.max(value, min), max);
|
|
159
|
+
const round = (value: number) => Math.round(value * 1000) / 1000;
|
|
160
|
+
const finite = (value: unknown): value is number =>
|
|
161
|
+
typeof value === "number" && Number.isFinite(value);
|
|
162
|
+
|
|
163
|
+
/** Names of the motion springs, in the order a control lists them. */
|
|
164
|
+
export const LIQUID_MOTIONS = ["snappy", "smooth", "soft", "jelly"] as const;
|
|
165
|
+
|
|
166
|
+
/** Merges a preset under explicit options (one level deep for the grouped fields). */
|
|
167
|
+
export function mergeLiquid(
|
|
168
|
+
base: LiquidGlassOptions | undefined,
|
|
169
|
+
over: LiquidGlassOptions | undefined,
|
|
170
|
+
): LiquidGlassOptions {
|
|
171
|
+
const out: LiquidGlassOptions = { ...base, ...over };
|
|
172
|
+
if (base?.specular || over?.specular) out.specular = { ...base?.specular, ...over?.specular };
|
|
173
|
+
if (base?.shadow || over?.shadow) out.shadow = { ...base?.shadow, ...over?.shadow };
|
|
174
|
+
if (base?.tint || over?.tint)
|
|
175
|
+
out.tint = { ...base?.tint, ...over?.tint } as LiquidGlassOptions["tint"];
|
|
176
|
+
return out;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** Highlight alphas are themed tokens (`--liquid-rim-lit|back|ring`); this scales them. */
|
|
180
|
+
export function liquidRim(strength = 1, angle = -120, fresnel = 0): string {
|
|
181
|
+
const radians = (angle * Math.PI) / 180;
|
|
182
|
+
const x = round(-Math.cos(radians) * 2);
|
|
183
|
+
const y = round(-Math.sin(radians) * 2);
|
|
184
|
+
const s = round(clamp(strength, 0, 2));
|
|
185
|
+
const white = (alpha: string) =>
|
|
186
|
+
`color-mix(in srgb, white min(100%, calc(${alpha} * 100%)), transparent)`;
|
|
187
|
+
const layers = [
|
|
188
|
+
`inset ${x}px ${y}px 0 -.5px ${white(`var(--liquid-rim-lit, .95) * ${s}`)}`,
|
|
189
|
+
`inset ${-x}px ${-y}px 0 -.5px ${white(`var(--liquid-rim-back, .7) * ${s}`)}`,
|
|
190
|
+
`inset 0 0 0 1px ${white(`var(--liquid-rim-ring, .5) * ${s}`)}`,
|
|
191
|
+
];
|
|
192
|
+
const f = clamp(fresnel, 0, 1);
|
|
193
|
+
if (f > 0) layers.push(`inset 0 0 18px ${white(String(round(f * 0.4)))}`);
|
|
194
|
+
return layers.join(", ");
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* The outer shadow of a surface. Its blur and drop scale with `--liquid-size`, which the lens
|
|
199
|
+
* engine sets from the size of the surface (a bigger piece of glass is thicker, so its shadow is
|
|
200
|
+
* deeper); without the engine the variable is 1. What is not configured comes from the themed
|
|
201
|
+
* tokens (`--liquid-shadow-drop`, `-blur`, `-contact`, `-ink`, `-alpha`), so the shadow the
|
|
202
|
+
* engine paints is the one the theme's `--liquid-shadow` describes, in light and in dark.
|
|
203
|
+
*/
|
|
204
|
+
export function liquidShadow({
|
|
205
|
+
opacity = 1,
|
|
206
|
+
spread,
|
|
207
|
+
offsetY,
|
|
208
|
+
}: NonNullable<LiquidGlassOptions["shadow"]> = {}): string {
|
|
209
|
+
const a = round(clamp(opacity, 0, 2));
|
|
210
|
+
const alpha = "var(--liquid-shadow-alpha, .2)";
|
|
211
|
+
const ink = (factor: string) =>
|
|
212
|
+
`color-mix(in srgb, var(--liquid-shadow-ink, black) min(100%, calc(${alpha} * ${factor} * 100%)), transparent)`;
|
|
213
|
+
const k = "var(--liquid-size, 1)";
|
|
214
|
+
const drop = offsetY === undefined ? "var(--liquid-shadow-drop, 10px)" : `${round(offsetY)}px`;
|
|
215
|
+
const blur = spread === undefined ? "var(--liquid-shadow-blur, 30px)" : `${round(30 + spread)}px`;
|
|
216
|
+
return [
|
|
217
|
+
`0 calc(${drop} * ${k}) calc(${blur} * ${k}) -6px ${ink(String(a))}`,
|
|
218
|
+
`0 calc(2px * ${k}) calc(6px * ${k}) ${ink(`${a} * var(--liquid-shadow-contact, .4)`)}`,
|
|
219
|
+
].join(", ");
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/** A tiling film-grain image for `--glass-noise`: white speckle whose opacity follows `amount`. */
|
|
223
|
+
export function liquidGrain(amount: number): string {
|
|
224
|
+
const a = round(clamp(amount, 0, 1) * 0.5);
|
|
225
|
+
const svg =
|
|
226
|
+
`<svg xmlns='http://www.w3.org/2000/svg' width='160' height='160'><filter id='n'>` +
|
|
227
|
+
`<feTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2' stitchTiles='stitch'/>` +
|
|
228
|
+
`<feColorMatrix values='0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 ${a} 0 0 0 0'/></filter>` +
|
|
229
|
+
`<rect width='100%' height='100%' filter='url(#n)'/></svg>`;
|
|
230
|
+
return `url("data:image/svg+xml,${encodeURIComponent(svg)}")`;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
type Vars = Record<string, string>;
|
|
234
|
+
|
|
235
|
+
/**
|
|
236
|
+
* The custom properties of a configuration, only for the fields that are set. Spread them into a
|
|
237
|
+
* `style` prop (or a class, or `:root`). The numeric ones are what the lens engine reads; the
|
|
238
|
+
* composite ones (`--liquid-rim-custom`, `--liquid-shadow-custom`, `--glass-noise`) are what the
|
|
239
|
+
* CSS utilities paint.
|
|
240
|
+
*/
|
|
241
|
+
export function liquidVars(options: LiquidGlassOptions = {}): Vars {
|
|
242
|
+
const out: Vars = {};
|
|
243
|
+
const set = (name: string, value: string | number | undefined) => {
|
|
244
|
+
if (value !== undefined) out[`--liquid-${name}`] = String(value);
|
|
245
|
+
};
|
|
246
|
+
const num = (value: unknown, min: number, max: number) =>
|
|
247
|
+
finite(value) ? round(clamp(value, min, max)) : undefined;
|
|
248
|
+
set("refraction", num(options.refraction, 0, 2));
|
|
249
|
+
const bevel = num(options.bevelWidth, 0, 120);
|
|
250
|
+
if (bevel !== undefined) set("bevel", `${bevel}px`);
|
|
251
|
+
if (options.profile) set("profile", options.profile);
|
|
252
|
+
set("dispersion", num(options.dispersion, 0, 0.2));
|
|
253
|
+
const frost = num(options.frost, 0, 40);
|
|
254
|
+
if (frost !== undefined) set("frost", `${frost}px`);
|
|
255
|
+
set("saturation", num(options.saturation, 0, 4));
|
|
256
|
+
const brightness = num(options.brightness, 0, 3);
|
|
257
|
+
set("brightness", brightness);
|
|
258
|
+
// The filter takes the whole function so that an unset option leaves no `brightness(1)` behind.
|
|
259
|
+
if (brightness !== undefined) set("brightness-fn", `brightness(${brightness})`);
|
|
260
|
+
if (options.tint) {
|
|
261
|
+
set("tint-color", options.tint.color);
|
|
262
|
+
set("tint-amount", num(options.tint.amount ?? LIQUID_DEFAULTS.tint.amount, 0, 1));
|
|
263
|
+
}
|
|
264
|
+
const rim = num(options.rim, 0, 2);
|
|
265
|
+
set("rim-strength", rim);
|
|
266
|
+
const intensity = num(options.specular?.intensity, 0, 2);
|
|
267
|
+
set("specular", intensity);
|
|
268
|
+
const angle = finite(options.specular?.angle) ? round(options.specular.angle) : undefined;
|
|
269
|
+
set("specular-angle", angle);
|
|
270
|
+
const fresnel = num(options.fresnel, 0, 1);
|
|
271
|
+
set("fresnel", fresnel);
|
|
272
|
+
if (rim !== undefined || angle !== undefined || fresnel !== undefined)
|
|
273
|
+
set("rim-custom", liquidRim(rim ?? 1, angle ?? -120, fresnel ?? 0));
|
|
274
|
+
const grain = num(options.grain, 0, 1);
|
|
275
|
+
set("grain", grain);
|
|
276
|
+
if (grain) out["--glass-noise"] = liquidGrain(grain);
|
|
277
|
+
const radius = num(options.radius, 0, 999);
|
|
278
|
+
if (radius !== undefined) set("radius", `${radius}px`);
|
|
279
|
+
set("opacity", num(options.opacity, 0, 1));
|
|
280
|
+
if (options.shadow) {
|
|
281
|
+
const { opacity, spread, offsetY } = options.shadow;
|
|
282
|
+
set("shadow-opacity", num(opacity, 0, 2));
|
|
283
|
+
set("shadow-spread", num(spread, 0, 80));
|
|
284
|
+
set("shadow-offset", num(offsetY, -40, 80));
|
|
285
|
+
set(
|
|
286
|
+
"shadow-custom",
|
|
287
|
+
liquidShadow({
|
|
288
|
+
opacity: num(opacity, 0, 2),
|
|
289
|
+
spread: num(spread, 0, 80),
|
|
290
|
+
offsetY: num(offsetY, -40, 80),
|
|
291
|
+
}),
|
|
292
|
+
);
|
|
293
|
+
}
|
|
294
|
+
if (options.interactive) set("interactive", options.interactive);
|
|
295
|
+
if (options.motion !== undefined)
|
|
296
|
+
set("motion", options.motion === false ? "off" : options.motion);
|
|
297
|
+
return out;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/** {@link liquidVars} as a `style` object (adds `border-radius` when `radius` is set). */
|
|
301
|
+
export function liquidStyle(options: LiquidGlassOptions = {}): CSSProperties {
|
|
302
|
+
const vars = liquidVars(options);
|
|
303
|
+
if (vars["--liquid-radius"])
|
|
304
|
+
return { ...vars, borderRadius: "var(--liquid-radius)" } as CSSProperties;
|
|
305
|
+
return vars as CSSProperties;
|
|
306
|
+
}
|