@ultralabs/glass 0.0.0-stage → 0.1.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.
Files changed (137) hide show
  1. package/CHANGELOG.md +318 -0
  2. package/DESIGN.md +682 -0
  3. package/LICENSE +21 -0
  4. package/README.md +690 -2
  5. package/dist/esm/index.js +20872 -0
  6. package/dist/types/src/charts/ULCartesianChart.d.ts +177 -0
  7. package/dist/types/src/charts/ULDonutChart.d.ts +65 -0
  8. package/dist/types/src/charts/ULFunnelChart.d.ts +64 -0
  9. package/dist/types/src/charts/ULHeatmapChart.d.ts +40 -0
  10. package/dist/types/src/charts/ULRadarChart.d.ts +19 -0
  11. package/dist/types/src/charts/ULRadialChart.d.ts +48 -0
  12. package/dist/types/src/charts/ULScatterChart.d.ts +49 -0
  13. package/dist/types/src/charts/core.d.ts +287 -0
  14. package/dist/types/src/charts/decimate.d.ts +8 -0
  15. package/dist/types/src/charts/nav.d.ts +368 -0
  16. package/dist/types/src/charts/quadtree.d.ts +9 -0
  17. package/dist/types/src/charts/scales.d.ts +59 -0
  18. package/dist/types/src/charts/timeseries.d.ts +56 -0
  19. package/dist/types/src/components/ULAnchoredSurface/ULAnchoredSurface.d.ts +72 -0
  20. package/dist/types/src/components/ULBatch2/carousel.d.ts +31 -0
  21. package/dist/types/src/components/ULBatch2/hovercard.d.ts +40 -0
  22. package/dist/types/src/components/ULBatch2/layout.d.ts +16 -0
  23. package/dist/types/src/components/ULBatch2/menubar.d.ts +29 -0
  24. package/dist/types/src/components/ULBatch2/navmenu.d.ts +51 -0
  25. package/dist/types/src/components/ULBatch2/resizable.d.ts +48 -0
  26. package/dist/types/src/components/ULBatch2/typography.d.ts +55 -0
  27. package/dist/types/src/components/ULButton/ULButton.d.ts +87 -0
  28. package/dist/types/src/components/ULContainers/ULCard.d.ts +54 -0
  29. package/dist/types/src/components/ULContainers/ULDialog.d.ts +57 -0
  30. package/dist/types/src/components/ULContainers/ULLayout.d.ts +81 -0
  31. package/dist/types/src/components/ULContainers/ULMenu.d.ts +99 -0
  32. package/dist/types/src/components/ULContainers/ULOverlays.d.ts +113 -0
  33. package/dist/types/src/components/ULContainers/contextTarget.d.ts +91 -0
  34. package/dist/types/src/components/ULData/ULData.d.ts +225 -0
  35. package/dist/types/src/components/ULData/ULKpi.d.ts +159 -0
  36. package/dist/types/src/components/ULField/ULField.d.ts +93 -0
  37. package/dist/types/src/components/ULForms/fieldContext.d.ts +39 -0
  38. package/dist/types/src/components/ULForms/forms.d.ts +143 -0
  39. package/dist/types/src/components/ULIsland/ULIsland.d.ts +39 -0
  40. package/dist/types/src/components/ULIsland/headerConfig.d.ts +43 -0
  41. package/dist/types/src/components/ULIsland/navIndicator.d.ts +26 -0
  42. package/dist/types/src/components/ULListbox/ULListbox.d.ts +75 -0
  43. package/dist/types/src/components/ULPickers/ULPickers.d.ts +141 -0
  44. package/dist/types/src/components/ULSegmented/ULSegmented.d.ts +50 -0
  45. package/dist/types/src/components/ULSelection/ULSelection.d.ts +71 -0
  46. package/dist/types/src/components/ULSlider/ULSlider.d.ts +43 -0
  47. package/dist/types/src/components/ULSpinner/ULSpinner.d.ts +8 -0
  48. package/dist/types/src/components/ULStructure/kbd.d.ts +22 -0
  49. package/dist/types/src/components/ULStructure/structure.d.ts +154 -0
  50. package/dist/types/src/components/ULTabs/ULTabs.d.ts +28 -0
  51. package/dist/types/src/components/ULTooltip/anchoredTooltip.d.ts +22 -0
  52. package/dist/types/src/components/actions/actions.d.ts +175 -0
  53. package/dist/types/src/components/actions/core.d.ts +346 -0
  54. package/dist/types/src/components/dashboard/blocks.d.ts +583 -0
  55. package/dist/types/src/components/dashboard/blocks2.d.ts +297 -0
  56. package/dist/types/src/components/dashboard/columnsDrag.d.ts +27 -0
  57. package/dist/types/src/components/shared/ULCheckMark.d.ts +9 -0
  58. package/dist/types/src/components/shared/dev.d.ts +13 -0
  59. package/dist/types/src/components/shared/icons.d.ts +23 -0
  60. package/dist/types/src/glass/ULGlass.d.ts +78 -0
  61. package/dist/types/src/glass/ULGlassGroup.d.ts +16 -0
  62. package/dist/types/src/glass/accent.d.ts +31 -0
  63. package/dist/types/src/glass/contrast.d.ts +78 -0
  64. package/dist/types/src/glass/engine.d.ts +177 -0
  65. package/dist/types/src/glass/glassDebug.d.ts +27 -0
  66. package/dist/types/src/glass/material.d.ts +49 -0
  67. package/dist/types/src/glass/radius.d.ts +2 -0
  68. package/dist/types/src/hooks/useAnchoredMorph.d.ts +20 -0
  69. package/dist/types/src/hooks/usePointerLight.d.ts +6 -0
  70. package/dist/types/src/hooks/useReducedMotion.d.ts +3 -0
  71. package/dist/types/src/index.d.ts +150 -0
  72. package/dist/types/src/island/sectionAccent.d.ts +18 -0
  73. package/dist/types/src/live/ULLiveStatus.d.ts +18 -0
  74. package/dist/types/src/live/liveQueue.d.ts +13 -0
  75. package/dist/types/src/live/liveSource.d.ts +149 -0
  76. package/dist/types/src/live/liveStore.d.ts +72 -0
  77. package/dist/types/src/motion/anchoredMorph.d.ts +163 -0
  78. package/dist/types/src/motion/goo.d.ts +3 -0
  79. package/dist/types/src/motion/lensBubble.d.ts +143 -0
  80. package/dist/types/src/motion/lensSelect.d.ts +31 -0
  81. package/dist/types/src/motion/overlayStack.d.ts +13 -0
  82. package/dist/types/src/motion/placement.d.ts +18 -0
  83. package/dist/types/src/motion/spring.d.ts +20 -0
  84. package/dist/types/src/motion/topLayer.d.ts +13 -0
  85. package/dist/types/src/motion/viewSwap.d.ts +33 -0
  86. package/dist/types/src/motion/virtualAnchor.d.ts +28 -0
  87. package/dist/ul-glass.css +10508 -0
  88. package/dist/ul-glass.js +20915 -0
  89. package/dist/ul-glass.min.js +14 -0
  90. package/dist/ul-glass.min.js.map +7 -0
  91. package/icons/arrow-up-down.svg +5 -0
  92. package/icons/bell.svg +3 -0
  93. package/icons/bold.svg +2 -0
  94. package/icons/calendar.svg +5 -0
  95. package/icons/check.svg +2 -0
  96. package/icons/chevron-down.svg +2 -0
  97. package/icons/chevron-left.svg +2 -0
  98. package/icons/chevron-right.svg +2 -0
  99. package/icons/chevrons-right.svg +3 -0
  100. package/icons/circle-check.svg +3 -0
  101. package/icons/circle-x.svg +4 -0
  102. package/icons/circle.svg +2 -0
  103. package/icons/copy.svg +3 -0
  104. package/icons/ellipsis.svg +4 -0
  105. package/icons/eye.svg +3 -0
  106. package/icons/filter.svg +2 -0
  107. package/icons/flags/LICENSE.md +2 -0
  108. package/icons/flags/cs.svg +1 -0
  109. package/icons/flags/de.svg +1 -0
  110. package/icons/flags/en.svg +1 -0
  111. package/icons/flags/sk.svg +1 -0
  112. package/icons/folder-kanban.svg +5 -0
  113. package/icons/icons.json +1 -0
  114. package/icons/inbox.svg +3 -0
  115. package/icons/info.svg +4 -0
  116. package/icons/layout-dashboard.svg +5 -0
  117. package/icons/layout-grid.svg +5 -0
  118. package/icons/loader-circle.svg +2 -0
  119. package/icons/lock.svg +3 -0
  120. package/icons/mail.svg +3 -0
  121. package/icons/menu.svg +4 -0
  122. package/icons/minus.svg +2 -0
  123. package/icons/panel-left-close.svg +4 -0
  124. package/icons/plus.svg +3 -0
  125. package/icons/refresh-cw.svg +5 -0
  126. package/icons/search.svg +3 -0
  127. package/icons/shield-check.svg +3 -0
  128. package/icons/shopping-bag.svg +4 -0
  129. package/icons/sparkles.svg +6 -0
  130. package/icons/trash-2.svg +6 -0
  131. package/icons/triangle-alert.svg +4 -0
  132. package/icons/upload.svg +4 -0
  133. package/icons/users.svg +5 -0
  134. package/icons/x.svg +3 -0
  135. package/package.json +62 -4
  136. package/tokens/tokens.css +799 -0
  137. package/tokens/tokens.json +1017 -0
@@ -0,0 +1,143 @@
1
+ import * as React from 'react';
2
+ import { fieldAria } from './fieldContext.js';
3
+ import { type Material } from '../../glass/material.js';
4
+ import './forms.css';
5
+ declare const T: {
6
+ en: {
7
+ optional: string;
8
+ clear: string;
9
+ count: string;
10
+ left: string;
11
+ errors: string;
12
+ };
13
+ sk: {
14
+ optional: string;
15
+ clear: string;
16
+ count: string;
17
+ left: string;
18
+ errors: string;
19
+ };
20
+ de: {
21
+ optional: string;
22
+ clear: string;
23
+ count: string;
24
+ left: string;
25
+ errors: string;
26
+ };
27
+ cs: {
28
+ optional: string;
29
+ clear: string;
30
+ count: string;
31
+ left: string;
32
+ errors: string;
33
+ };
34
+ };
35
+ export declare const formText: (k: keyof typeof T.en, locale?: string, vars?: Record<string, string | number>) => string;
36
+ export interface ULLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
37
+ /** Shows the required marker. Default false. */ required?: boolean;
38
+ /** true = localised "(optional)", or a custom string */
39
+ optional?: boolean | string;
40
+ /** "en" | "sk" | "de" | "cs" for built-in strings and formatting. Default "en". */ locale?: string;
41
+ /** render as <span> (for groups: radio sets, OTP) */
42
+ asSpan?: boolean;
43
+ }
44
+ export declare function ULLabel({ required, optional, locale, asSpan, className, children, ...rest }: ULLabelProps): React.JSX.Element;
45
+ export interface ULFieldErrorProps {
46
+ id?: string; /** Error text (alternative to `errors`). */
47
+ children?: React.ReactNode; /** List of messages; falsy entries are skipped, several render as a list. */
48
+ errors?: (string | null | undefined | false)[]; /** one line with ellipsis + tooltip; default false (wraps) */
49
+ truncate?: boolean; /** "en" | "sk" | "de" | "cs" for built-in strings and formatting. Default "en". */
50
+ locale?: string; /** Extra class on the root element. */
51
+ className?: string;
52
+ }
53
+ export declare function ULFieldError({ id, children, errors, truncate, locale, className }: ULFieldErrorProps): React.JSX.Element | null;
54
+ export type FieldControlProps = ReturnType<typeof fieldAria> & {
55
+ id: string; /** Id of the element that labels the control. */
56
+ 'aria-labelledby'?: string; /** Marks the control required (aria-required, required marker in the label). Default false. */
57
+ required?: boolean; /** Disables the control (not focusable, dimmed). Default false. */
58
+ disabled?: boolean;
59
+ };
60
+ export interface ULFieldProps {
61
+ /** Field label (owns the accessible name of the control inside). */ label: React.ReactNode;
62
+ /** Secondary text under the label (aria-describedby). */ description?: React.ReactNode;
63
+ /** string, node or a list (several messages). A new error is announced politely; focus never moves. */
64
+ error?: React.ReactNode | (string | null | undefined | false)[];
65
+ /** Marks the control required (aria-required, required marker in the label). Default false. */ required?: boolean;
66
+ /** Shows an "optional" marker (true = localised word, or a custom string). */ optional?: boolean | string;
67
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
68
+ /** "vertical" (default, label above) | "horizontal" (label beside, stacks below 480px). */ orientation?: 'vertical' | 'horizontal';
69
+ /** one-line error with tooltip */
70
+ truncateError?: boolean;
71
+ /** announce new errors through the shared polite live region. Default true. */
72
+ announceErrors?: boolean;
73
+ /** native element child: cloned with id + aria; function child: receives the props; UL controls read the context. */
74
+ children: React.ReactNode | ((p: FieldControlProps) => React.ReactNode);
75
+ /** Id of the control (labels and messages are linked to it). Default: generated. */ id?: string;
76
+ /** "en" | "sk" | "de" | "cs" for built-in strings and formatting. Default "en". */ locale?: string;
77
+ /** Extra class on the root element. */ className?: string;
78
+ /** Inline style on the root element. */ style?: React.CSSProperties;
79
+ }
80
+ export declare function ULField({ label, description, error, required, optional, disabled, orientation, truncateError, announceErrors, children, id, locale, className, style }: ULFieldProps): React.JSX.Element;
81
+ interface Layout {
82
+ orientation?: 'vertical' | 'horizontal'; /** number of columns at full width, or 'auto' (fill by --ul-fgroup-min). Collapses to one column below --ul-fgroup-collapse. */
83
+ columns?: number | 'auto';
84
+ gap?: 'sm' | 'md' | 'lg';
85
+ }
86
+ export interface ULFieldGroupProps extends Layout {
87
+ children: React.ReactNode; /** Extra class on the root element. */
88
+ className?: string; /** Inline style on the root element. */
89
+ style?: React.CSSProperties; /** Accessible name when there is no visible label. */
90
+ 'aria-label'?: string;
91
+ }
92
+ export declare function ULFieldGroup({ children, className, style, ...l }: ULFieldGroupProps): React.JSX.Element;
93
+ export interface ULFieldSetProps extends Layout {
94
+ legend: React.ReactNode; /** Secondary text under the label (aria-describedby). */
95
+ description?: React.ReactNode; /** Group-level error (e.g. "Pick at least one"); announced through announce(). */
96
+ error?: React.ReactNode; /** Marks the control required (aria-required, required marker in the label). Default false. */
97
+ required?: boolean; /** Shows an "optional" marker (true = localised word, or a custom string). */
98
+ optional?: boolean | string; /** Disables the control (not focusable, dimmed). Default false. */
99
+ disabled?: boolean; /** Controls of the group. */
100
+ children: React.ReactNode; /** "en" | "sk" | "de" | "cs" for built-in strings and formatting. Default "en". */
101
+ locale?: string; /** Extra class on the root element. */
102
+ className?: string; /** Inline style on the root element. */
103
+ style?: React.CSSProperties; /** Id of the control (labels and messages are linked to it). Default: generated. */
104
+ id?: string;
105
+ }
106
+ export declare function ULFieldSet({ legend, description, error, required, optional, disabled, children, locale, className, style, id, ...l }: ULFieldSetProps): React.JSX.Element;
107
+ export interface ULInputGroupProps {
108
+ /** ULInputGroupInput plus addons (ULInputAddon, ULSelect, ULCopyButton…) in one inset well. */ children: React.ReactNode;
109
+ /** leading addon(s): text, ULIcon, ULKbd … */
110
+ prefix?: React.ReactNode;
111
+ /** trailing addon(s) */
112
+ suffix?: React.ReactNode;
113
+ /** inline buttons at the end (ULCopyButton, ULButton variant plain, ULInputGroupButton) */
114
+ actions?: React.ReactNode;
115
+ /** Shows a spinner and sets aria-busy; the control stays focusable. Default false. */ loading?: boolean;
116
+ /** Shows a clear button while the input has a value. Default false. */ clearable?: boolean;
117
+ /** Called after the clear button empties the input. */ onClear?: () => void;
118
+ /** character counter (+ maxLength on the inner text control) */
119
+ maxLength?: number;
120
+ /** Shows the character count (with maxLength: "12 / 80"). Default false. */ showCount?: boolean;
121
+ /** "md" (default, 56px well) | "compact" (44px). */ size?: 'md' | 'compact';
122
+ /** "rounded" (default) | "capsule". */ shape?: 'rounded' | 'capsule';
123
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
124
+ /** Marks the well invalid (aria-invalid on the input). */ invalid?: boolean;
125
+ /** "en" | "sk" | "de" | "cs" for built-in strings and formatting. Default "en". */ locale?: string;
126
+ /** Extra class on the root element. */ className?: string;
127
+ /** Inline style on the root element. */ style?: React.CSSProperties;
128
+ /** "flat" | "glass" (inputs category); inner controls follow the group. @default undefined (resolved: "flat") */ material?: Material;
129
+ }
130
+ export declare function ULInputGroup({ children, prefix, suffix, actions, loading, clearable, onClear, maxLength, showCount, size, shape, disabled, invalid, locale, className, style, material }: ULInputGroupProps): React.JSX.Element;
131
+ /** Bare native input for ULInputGroup (no own border). Reads ULField + group context. */
132
+ export declare const ULInputGroupInput: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
133
+ onValueChange?: (v: string) => void;
134
+ } & React.RefAttributes<HTMLInputElement>>;
135
+ /** Plain icon button for ULInputGroup actions (44px hit area, flat). */
136
+ export declare function ULInputGroupButton({ label, icon, onClick, disabled, pressed }: {
137
+ label: string;
138
+ icon: string;
139
+ onClick: () => void;
140
+ disabled?: boolean;
141
+ pressed?: boolean;
142
+ }): React.JSX.Element;
143
+ export {};
@@ -0,0 +1,39 @@
1
+ import * as React from 'react';
2
+ import { type Accent, type AccentStrength } from '../../glass/accent.js';
3
+ import { type HeaderConfig } from './headerConfig.js';
4
+ import './ULIsland.css';
5
+ export type IslandState = 'compact' | 'expanded' | 'notification';
6
+ export interface ULIslandProps extends React.HTMLAttributes<HTMLDivElement> {
7
+ state?: IslandState;
8
+ /**
9
+ * Pill content in the compact state (and under an open notification).
10
+ * Alternatively pass children with data-slot="compact" | "expanded" | "notification" | "tools".
11
+ */
12
+ compact?: React.ReactNode;
13
+ /** Pill content in the expanded state (nav / menu). */
14
+ expanded?: React.ReactNode;
15
+ /** Surface that pours out of the pill in the notification state (shared anchored morph). */
16
+ notification?: React.ReactNode;
17
+ onDismiss?: () => void;
18
+ /** Round controls beside the pill (use ULIslandTool). */
19
+ tools?: React.ReactNode;
20
+ accent?: Accent | null;
21
+ /** Defaults to --ul-island-accent-strength (vivid) when an accent is set. */
22
+ accentStrength?: AccentStrength;
23
+ /** Accessible name for the pill (e.g. "Main"). */
24
+ label?: string;
25
+ /** Render the expanded face (leading, nav with floating indicator, CTA) and tools from one typed config. */
26
+ config?: HeaderConfig;
27
+ /** Current nav key (aria-current); the indicator rests on it when config.indicatorRest. */
28
+ current?: string;
29
+ }
30
+ export declare function ULIsland({ state, compact, expanded, notification, onDismiss, tools, accent, accentStrength, label, config, current, className, style, children, ...rest }: ULIslandProps): React.JSX.Element;
31
+ export interface ULIslandToolProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
32
+ active?: boolean;
33
+ /** Render as a real link (e.g. the Studio entry). */
34
+ href?: string;
35
+ /** Hover/focus tooltip via the shared anchored tooltip (no title attribute). */
36
+ tip?: string;
37
+ }
38
+ /** Round glass control beside the island (language, studio link). Elastic + pressable. */
39
+ export declare const ULIslandTool: React.ForwardRefExoticComponent<ULIslandToolProps & React.RefAttributes<HTMLElement>>;
@@ -0,0 +1,43 @@
1
+ /**
2
+ * One typed header config. ULIsland renders from it; the landing SiteHeader
3
+ * maps its `variant` to one of these. Pages only select a config, they never
4
+ * copy header markup.
5
+ */
6
+ import type { Accent } from '../../glass/accent.js';
7
+ export type HeaderPopper = 'lang';
8
+ /** The one app entry beside the island: a link to Studio (Studio handles its own sign-in redirect). */
9
+ export declare const STUDIO_URL = "https://studio.ultralabs.app";
10
+ export interface HeaderLeading {
11
+ kind: 'logo' | 'back';
12
+ href: string;
13
+ label: string;
14
+ }
15
+ export interface HeaderNavItem {
16
+ key: string;
17
+ label: string;
18
+ href?: string; /** opens a megamenu pane */
19
+ menu?: boolean;
20
+ }
21
+ export interface HeaderCta {
22
+ label: string;
23
+ href: string;
24
+ }
25
+ export interface HeaderConfig {
26
+ variant: string;
27
+ leading: HeaderLeading;
28
+ nav: HeaderNavItem[];
29
+ megamenu: boolean;
30
+ cta: HeaderCta | false;
31
+ poppers: HeaderPopper[];
32
+ accent: Accent | null;
33
+ sticky: boolean;
34
+ /** Let the floating indicator rest on the current page's item (default off). */
35
+ indicatorRest: boolean;
36
+ /** Overlay reading variant: 'high' = strong blur + worst-case backing. */
37
+ legibility: 'high' | 'normal';
38
+ /** Show the "Go to studio" link button next to the language button. */
39
+ studioLink: boolean;
40
+ }
41
+ export declare const HEADER_DEFAULTS: Omit<HeaderConfig, 'variant' | 'leading' | 'nav'>;
42
+ /** Merge a base variant with per-page overrides (undefined keys are ignored). */
43
+ export declare function resolveHeaderConfig(base: HeaderConfig, over?: Partial<HeaderConfig>): HeaderConfig;
@@ -0,0 +1,26 @@
1
+ export interface NavIndicatorOptions {
2
+ /** Positioned ancestor the lens is laid out in (usually the <nav>). */
3
+ container: HTMLElement;
4
+ /** The lens element (absolute, pointer-events: none, below the item text). */
5
+ lens: HTMLElement;
6
+ /** Selector for indicator targets inside `container`. Default: a, button. */
7
+ items?: string;
8
+ /** Element to rest on when nothing is hovered/focused (e.g. current page). Return null to hide. */
9
+ rest?: () => HTMLElement | null;
10
+ /**
11
+ * Large / live lists (table rows): watch only `root`'s direct children (no subtree, no per-item ResizeObserver).
12
+ * Cell text updates then never re-measure; inserts / removes do.
13
+ */
14
+ shallow?: HTMLElement;
15
+ }
16
+ export interface NavIndicator {
17
+ update(): void;
18
+ destroy(): void;
19
+ /**
20
+ * Layout-follow mode (container width / height morphs, e.g. a collapsing sidebar): the lens is RIGID and copies the
21
+ * target item's rect every frame (no spring, stretch, overshoot or lag). Turning it off hands over with zero velocity
22
+ * from the exact current rect, so there is no visible jump between modes.
23
+ */
24
+ setLayoutFollow(on: boolean): void;
25
+ }
26
+ export declare function createNavIndicator(o: NavIndicatorOptions): NavIndicator;
@@ -0,0 +1,75 @@
1
+ import * as React from 'react';
2
+ import type { Backdrop } from '../../glass/accent.js';
3
+ import { type Material } from '../../glass/material.js';
4
+ import './ULListbox.css';
5
+ export interface ListOption {
6
+ value: string;
7
+ label: string;
8
+ description?: string;
9
+ icon?: React.ReactNode;
10
+ disabled?: boolean;
11
+ }
12
+ export interface ULSelectProps {
13
+ /** Visible label (required for an accessible name unless inside ULField). */ label: string;
14
+ /** Options ({ value, label, disabled?, description? }). */ options: ListOption[];
15
+ /** Controlled selected value. */ value?: string;
16
+ /** Initial value when uncontrolled. */ defaultValue?: string;
17
+ /** Called with the picked value. */ onValueChange?: (v: string) => void;
18
+ /** Placeholder shown while empty. */ placeholder?: string;
19
+ /** Help text under the control (aria-describedby). */ helper?: React.ReactNode;
20
+ /** Error message; sets aria-invalid and replaces the helper. Inside ULField the field owns the message. */ error?: React.ReactNode;
21
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
22
+ /** Shows a spinner and sets aria-busy; the control stays focusable. Default false. */ loading?: boolean;
23
+ /** Text shown in the list while loading. Default localised "Loading…". */ loadingText?: string;
24
+ /** Text shown when there are no options. Default localised "No options". */ emptyText?: string;
25
+ /** Overlay contrast class. Default "light" (reading variant). */
26
+ backdrop?: Backdrop;
27
+ /** Stretch to the container width. Default false. */ fullWidth?: boolean;
28
+ /** Extra class on the root element. */ className?: string;
29
+ /** Inline style on the root element. */ style?: React.CSSProperties;
30
+ /** Id of the control (labels and messages are linked to it). Default: generated. */ id?: string;
31
+ /** Trigger material "flat" | "glass" (inputs category); the list popper stays an overlay (glass). @default undefined (resolved: "flat") */ material?: Material;
32
+ /** Native picker: 'mobile' = ULNativeSelect on coarse pointers (phones / tablets), 'always' = always native, 'never' (default) = the glass list. */
33
+ native?: 'never' | 'mobile' | 'always';
34
+ /** @internal */
35
+ forceState?: 'hover' | 'focus' | 'pressed' | (string & {});
36
+ }
37
+ export declare function ULSelect(props: ULSelectProps): React.JSX.Element;
38
+ export interface ULComboboxProps extends Omit<ULSelectProps, 'placeholder' | 'fullWidth'> {
39
+ /** Text in the input (controlled). */
40
+ inputValue?: string;
41
+ /** Called with the typed text (filter remote options here). */ onInputChange?: (text: string) => void;
42
+ /** Filter options by the typed text (accent- and case-insensitive). Default true; pass false when options come from a server. */
43
+ filter?: boolean;
44
+ /** Placeholder shown while empty. */ placeholder?: string;
45
+ }
46
+ /** Editable input + list. Focus stays in the input; the active option is announced via aria-activedescendant. */
47
+ export declare function ULCombobox({ label, options, value, defaultValue, onValueChange, inputValue, onInputChange, filter, helper, error, disabled, loading, loadingText, emptyText, backdrop, className, style, id, placeholder, forceState, material }: ULComboboxProps): React.JSX.Element;
48
+ export interface NativeOptGroup {
49
+ label: string;
50
+ options: ListOption[];
51
+ disabled?: boolean;
52
+ }
53
+ export interface ULNativeSelectProps {
54
+ /** Visible label (required for an accessible name unless inside ULField). */ label: string;
55
+ /** Options ({ value, label, disabled? }) rendered as native <option>s. */ options?: ListOption[];
56
+ /** Option groups (rendered as <optgroup>), after the plain options. */
57
+ groups?: NativeOptGroup[];
58
+ /** Controlled selected value. */ value?: string; /** Initial value when uncontrolled. */
59
+ defaultValue?: string; /** Called with the picked value (native change). */
60
+ onValueChange?: (v: string) => void;
61
+ /** Shown as a disabled first option while nothing is chosen. */
62
+ placeholder?: string;
63
+ /** Help text under the control (aria-describedby). */ helper?: React.ReactNode; /** Error message; sets aria-invalid and replaces the helper. Inside ULField the field owns the message. */
64
+ error?: React.ReactNode;
65
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean; /** Marks the control required (aria-required, required marker in the label). Default false. */
66
+ required?: boolean; /** Form field name (native form submission). */
67
+ name?: string;
68
+ /** Stretch to the container width. Default false. */ fullWidth?: boolean; /** Extra class on the root element. */
69
+ className?: string; /** Inline style on the root element. */
70
+ style?: React.CSSProperties; /** Id of the control (labels and messages are linked to it). Default: generated. */
71
+ id?: string;
72
+ /** "flat" | "glass" (inputs category). @default undefined (resolved: "flat") */ material?: Material;
73
+ }
74
+ /** A real <select> in the field well: the platform picker (wheel / sheet on phones), keyboard and form behaviour are native. Arrow = ULIcon. */
75
+ export declare function ULNativeSelect({ label, options, groups, value, defaultValue, onValueChange, placeholder, helper, error, disabled, required, name, fullWidth, className, style, id, material }: ULNativeSelectProps): React.JSX.Element;
@@ -0,0 +1,141 @@
1
+ import * as React from 'react';
2
+ import { type Backdrop } from '../../glass/accent.js';
3
+ import type { Material } from '../../glass/material.js';
4
+ import './ULPickers.css';
5
+ export type PickerLocale = 'en' | 'sk' | 'de' | 'cs' | (string & {});
6
+ export interface ULDatePickerProps {
7
+ /** Visible label (required for an accessible name unless inside ULField). */ label: string;
8
+ /** Controlled date; null = empty. */ value?: Date | null;
9
+ /** Initial date when uncontrolled. */ defaultValue?: Date | null;
10
+ /** Called with the picked date. */ onValueChange?: (d: Date) => void;
11
+ /** Calendar locale ("en" | "sk" | "de" | "cs"): month names, week start. Default "en". */ locale?: PickerLocale;
12
+ /** Earliest / lowest allowed value. */ min?: Date;
13
+ /** Latest / highest allowed value. */ max?: Date;
14
+ /** Return true to disable a date (e.g. weekends). Disabled dates are skipped by keyboard moves. */ isDateDisabled?: (d: Date) => boolean;
15
+ /** Placeholder shown while empty. */ placeholder?: string;
16
+ /** Help text under the control (aria-describedby). */ helper?: React.ReactNode;
17
+ /** Error message; sets aria-invalid and replaces the helper. Inside ULField the field owns the message. */ error?: React.ReactNode;
18
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
19
+ /** Backdrop hint for the glass: "dark" | "mid" | "light". Default "light" for pickers. */ backdrop?: Backdrop;
20
+ /** Extra class on the root element. */ className?: string;
21
+ /** Inline style on the root element. */ style?: React.CSSProperties;
22
+ /** Id of the control (labels and messages are linked to it). Default: generated. */ id?: string;
23
+ /** @internal open on mount (showcase). */
24
+ defaultOpen?: boolean;
25
+ /** Trigger material "flat" | "glass" (inputs category); the picker popover stays glass (overlays). @default undefined (resolved: "flat") */
26
+ material?: Material;
27
+ }
28
+ /**
29
+ * Grid keys: ← → ±1 day, ↑ ↓ ±1 week, PageUp / PageDown ±1 month (Shift: ±1 year), Home / End start / end of week,
30
+ * Enter / Space pick, Esc close (focus returns to the trigger). Disabled days are skipped.
31
+ */
32
+ export declare function ULDatePicker({ label, value, defaultValue, onValueChange, locale, min, max, isDateDisabled, placeholder, helper, error, disabled, backdrop, className, style, id, defaultOpen, material }: ULDatePickerProps): React.JSX.Element;
33
+ export interface DateRange {
34
+ start: Date;
35
+ end: Date;
36
+ }
37
+ export type PresetKey = 'today' | 'last7' | 'last30' | 'thisMonth' | 'lastMonth';
38
+ export interface ULDateRangePickerProps {
39
+ /** Visible label (required for an accessible name unless inside ULField). */ label: string;
40
+ /** Controlled range { start, end }; null = empty. */ value?: DateRange | null;
41
+ /** Initial range when uncontrolled. */ defaultValue?: DateRange | null;
42
+ /** Fires once per committed range (when the end is chosen, a preset is picked or the field is cleared). The hover / focus preview never changes the value. */
43
+ onValueChange?: (r: DateRange | null) => void;
44
+ /** Calendar locale ("en" | "sk" | "de" | "cs"): month names, week start. Default "en". */ locale?: PickerLocale;
45
+ /** Earliest / lowest allowed value. */ min?: Date;
46
+ /** Latest / highest allowed value. */ max?: Date;
47
+ /** Return true to disable a date (e.g. weekends). Disabled dates are skipped by keyboard moves. */ isDateDisabled?: (d: Date) => boolean;
48
+ /** Months side by side. Default 2; automatically 1 below 640px, where the popper becomes a bottom sheet. */
49
+ months?: 1 | 2;
50
+ /** Quick-range chips (true = all five, or a subset in order). */
51
+ presets?: boolean | PresetKey[];
52
+ /** Clear button in the trigger. Default true. */
53
+ clearable?: boolean;
54
+ /** Placeholder shown while empty. */ placeholder?: string;
55
+ /** Help text under the control (aria-describedby). */ helper?: React.ReactNode;
56
+ /** Error message; sets aria-invalid and replaces the helper. Inside ULField the field owns the message. */ error?: React.ReactNode;
57
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
58
+ /** Backdrop hint for the glass: "dark" | "mid" | "light". Default "light" for pickers. */ backdrop?: Backdrop;
59
+ /** Extra class on the root element. */ className?: string;
60
+ /** Inline style on the root element. */ style?: React.CSSProperties;
61
+ /** Id of the control (labels and messages are linked to it). Default: generated. */ id?: string;
62
+ /** @internal */
63
+ defaultOpen?: boolean;
64
+ /** Trigger material "flat" | "glass" (inputs category); the picker popover stays glass (overlays). @default undefined (resolved: "flat") */
65
+ material?: Material;
66
+ }
67
+ /**
68
+ * Range selection: first click sets the start (a flattened lens bead grows on it), hover / focus previews the band, the
69
+ * second click sets the end (band firms up, the days in between ripple, the end gets its bead; earlier than the start =
70
+ * swapped). A click on a complete range starts a new one (old band fades). Esc while picking cancels and restores the
71
+ * previous range; otherwise Esc closes. onValueChange fires once per commit.
72
+ * Glass inside the popper: the two beads and ONE shared hover / focus lens. Day cells are flat buttons.
73
+ */
74
+ export declare function ULDateRangePicker({ label, value, defaultValue, onValueChange, locale, min, max, isDateDisabled, months, presets, clearable, placeholder, helper, error, disabled, backdrop, className, style, id, defaultOpen, material }: ULDateRangePickerProps): React.JSX.Element;
75
+ export interface ULColorPickerProps {
76
+ /** Visible label (required for an accessible name unless inside ULField). */ label: string;
77
+ /** A preset name (ice, violet, …) or a hex color. */
78
+ value?: string;
79
+ /** Initial colour (accent name or #hex) when uncontrolled. */ defaultValue?: string;
80
+ /** Called with the picked accent name or #hex (custom colours go through guardAccent). */ onValueChange?: (v: string) => void;
81
+ /** Preset names (ice, violet, …) or objects; `{ value, disabled: true }` shows a preset that cannot be picked (skipped by arrow keys). */
82
+ presets?: readonly (string | ULColorPreset)[];
83
+ /** "Custom color" expander (2D field, hue, hex, eyedropper). Default true. */
84
+ allowCustom?: boolean;
85
+ /** Names for presets / UI text. */
86
+ names?: Partial<Record<string, string>>;
87
+ /** Calendar locale ("en" | "sk" | "de" | "cs"): month names, week start. Default "en". */ locale?: PickerLocale;
88
+ /** Label of the hex input. Default: localised ("Hex" in English). */ hexLabel?: string;
89
+ /** Message for an invalid hex value. Default localised. */ invalidHex?: string;
90
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
91
+ /** Backdrop hint for the glass: "dark" | "mid" | "light". Default "light" for pickers. */ backdrop?: Backdrop;
92
+ /** Extra class on the root element. */ className?: string;
93
+ /** Inline style on the root element. */ style?: React.CSSProperties;
94
+ /** Id of the control (labels and messages are linked to it). Default: generated. */ id?: string;
95
+ /** @internal */
96
+ defaultOpen?: boolean;
97
+ /** @internal open with the custom panel expanded */
98
+ defaultExpanded?: boolean;
99
+ /** Trigger material "flat" | "glass" (inputs category); the picker popover stays glass (overlays). @default undefined (resolved: "flat") */
100
+ material?: Material;
101
+ }
102
+ export interface ULColorPreset {
103
+ value: string;
104
+ disabled?: boolean;
105
+ label?: string;
106
+ }
107
+ /**
108
+ * Presets as a radio group (arrow keys) plus a "Custom color" button that EXPANDS the same surface (height morphs to the
109
+ * measured content size, content fades + slides in; reverse on collapse). Esc: first collapses, second closes.
110
+ * Custom colours go through the contrast guard: if one would break the target it is clamped into the safe OKLCH range and
111
+ * a note shows chosen vs applied (the applied one is what onValueChange receives).
112
+ */
113
+ export declare function ULColorPicker({ label, value, defaultValue, onValueChange, presets, allowCustom, names, locale, hexLabel, invalidHex, disabled, backdrop, className, style, id, defaultOpen, defaultExpanded, material }: ULColorPickerProps): React.JSX.Element;
114
+ type CalMode = 'single' | 'multiple' | 'range';
115
+ export interface ULCalendarProps {
116
+ /** "single" (default) | "multiple" | "range". */ mode?: CalMode;
117
+ /** single: Date | null · multiple: Date[] · range: DateRange | null */
118
+ value?: Date | null | Date[] | DateRange;
119
+ /** Initial value when uncontrolled (Date, Date[] or { start, end } per mode). */ defaultValue?: Date | null | Date[] | DateRange;
120
+ /** Called with the new value (shape per mode). */ onValueChange?: (v: Date | Date[] | DateRange | null) => void;
121
+ /** Calendar locale ("en" | "sk" | "de" | "cs"): month names, week start. Default "en". */ locale?: PickerLocale;
122
+ /** Earliest / lowest allowed value. */ min?: Date; /** Latest / highest allowed value. */
123
+ max?: Date;
124
+ /** Return true to disable a date (e.g. weekends). Disabled dates are skipped by keyboard moves. */ isDateDisabled?: (d: Date) => boolean;
125
+ /** Month shown first (default: the value, else today). */
126
+ defaultMonth?: Date;
127
+ /** Month / year jump selects in the header. Default true. Years: min..max, else ±10 around today. */
128
+ jump?: boolean;
129
+ /** Accessible name of the calendar group. */
130
+ label?: string;
131
+ /** Extra class on the root element. */ className?: string; /** Inline style on the root element. */
132
+ style?: React.CSSProperties; /** Id of the control (labels and messages are linked to it). Default: generated. */
133
+ id?: string;
134
+ }
135
+ /**
136
+ * Inline calendar on CalendarGrid: single, multiple and range. Same keyboard as the pickers (arrows, Home / End, PageUp / Down,
137
+ * Shift+PageUp / Down for years, Enter / Space pick); the tab stop is always an enabled date (enabledNear). Range: first pick = start,
138
+ * hover / focus previews, second pick = end (swapped if earlier); band = one element per week row and layer (Bands). Flat paint, no glass.
139
+ */
140
+ export declare function ULCalendar({ mode, value, defaultValue, onValueChange, locale, min, max, isDateDisabled, defaultMonth, jump, label, className, style, id }: ULCalendarProps): React.JSX.Element;
141
+ export {};
@@ -0,0 +1,50 @@
1
+ import * as React from 'react';
2
+ import { type Accent, type Backdrop } from '../../glass/accent.js';
3
+ import '../shared/lens.css';
4
+ import './ULSegmented.css';
5
+ export interface SegmentOption {
6
+ value: string;
7
+ label?: React.ReactNode;
8
+ icon?: React.ReactNode;
9
+ disabled?: boolean;
10
+ 'aria-label'?: string;
11
+ }
12
+ export interface ULSegmentedControlProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
13
+ /** Options ({ value, label?, icon?, disabled?, aria-label? }). */ options: SegmentOption[];
14
+ /** Controlled selected value. */ value?: string;
15
+ /** Initial value when uncontrolled. */ defaultValue?: string;
16
+ /** Called with the selected value. */ onValueChange?: (v: string) => void;
17
+ /** "md" (default) | "sm". */ size?: 'sm' | 'md';
18
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
19
+ /** Stretch to the container width; items share the width equally. Default false. */ fullWidth?: boolean;
20
+ /** Accent colour: accent name ("violet", "ice", "emerald", "amber", "rose") or a CSS colour (checked by guardAccent). */ accent?: Accent;
21
+ /** Backdrop hint for the glass: "dark" | "mid" | "light". */ backdrop?: Backdrop;
22
+ /** Lens bubble on press / drag / selection changes. Default true. */
23
+ lens?: boolean;
24
+ /** Required unless aria-labelledby is set. */
25
+ 'aria-label'?: string;
26
+ }
27
+ export declare function ULSegmentedControl({ options, value, defaultValue, onValueChange, size, disabled, fullWidth, accent, backdrop, lens: lensOn, className, ...rest }: ULSegmentedControlProps): React.JSX.Element;
28
+ export interface StepItem {
29
+ label: React.ReactNode;
30
+ description?: React.ReactNode;
31
+ }
32
+ export interface ULStepperProps extends React.HTMLAttributes<HTMLElement> {
33
+ /** Steps ({ label, description?, state?: "done" | "current" | "todo" }); done steps are buttons when onStep is set. */ steps: StepItem[];
34
+ /** 0-based index of the current step. */
35
+ current: number;
36
+ /** "Step 2 of 4" — localize here. */
37
+ countLabel?: (current: number, total: number) => string;
38
+ /** Screen-reader state words. Default English. */
39
+ stateLabels?: {
40
+ done: string;
41
+ current: string;
42
+ todo: string;
43
+ };
44
+ /** "horizontal" (default) | "vertical"; arrow keys follow it. */ orientation?: 'horizontal' | 'vertical';
45
+ /** Lets users jump back to completed steps. */
46
+ onStepSelect?: (index: number) => void;
47
+ /** Accent colour: accent name ("violet", "ice", "emerald", "amber", "rose") or a CSS colour (checked by guardAccent). */ accent?: Accent;
48
+ /** Accessible name when there is no visible label. */ 'aria-label'?: string;
49
+ }
50
+ export declare function ULStepper({ steps, current, countLabel, stateLabels, orientation, onStepSelect, accent, className, ...rest }: ULStepperProps): React.JSX.Element;
@@ -0,0 +1,71 @@
1
+ import * as React from 'react';
2
+ import { type Material } from '../../glass/material.js';
3
+ import '../shared/lens.css';
4
+ import type { Accent } from '../../glass/accent.js';
5
+ import './ULSelection.css';
6
+ type Force = 'hover' | 'focus' | 'pressed' | (string & {});
7
+ interface ChoiceBase extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'> {
8
+ label?: React.ReactNode;
9
+ /** Secondary line under the label. */
10
+ description?: React.ReactNode;
11
+ /** Error message (sets aria-invalid). */
12
+ error?: React.ReactNode;
13
+ loading?: boolean;
14
+ accent?: Accent;
15
+ /** @internal showcase / visual tests. */
16
+ forceState?: Force;
17
+ }
18
+ export interface ULCheckboxProps extends ChoiceBase {
19
+ /** Mixed state (aria-checked="mixed"). */
20
+ indeterminate?: boolean;
21
+ /** Called with the next checked state. The inherited native `onChange` (DOM event) is still forwarded (documented native wrapper). */
22
+ onCheckedChange?: (checked: boolean) => void;
23
+ }
24
+ /** Checkbox with a glass box: subtle when off, vivid accent when on or mixed. Space toggles. */
25
+ export declare const ULCheckbox: React.ForwardRefExoticComponent<ULCheckboxProps & React.RefAttributes<HTMLInputElement>>;
26
+ export interface ULRadioProps extends ChoiceBase {
27
+ value: string;
28
+ }
29
+ /** One option of a ULRadioGroup. Native radios: arrow keys move and select, one tab stop per group. */
30
+ export declare const ULRadio: React.ForwardRefExoticComponent<ULRadioProps & React.RefAttributes<HTMLInputElement>>;
31
+ export interface ULRadioGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
32
+ /** Visible group label (or pass aria-label). */
33
+ label?: React.ReactNode;
34
+ /** Form field name (native radios share it). Default: generated. */ name?: string;
35
+ /** Controlled selected value. */ value?: string;
36
+ /** Initial value when uncontrolled. */ defaultValue?: string;
37
+ /** Called with the chosen radio's value. */ onValueChange?: (v: string) => void;
38
+ /** "horizontal" (default) | "vertical"; arrow keys follow it. */ orientation?: 'vertical' | 'horizontal';
39
+ /** Disables the control (not focusable, dimmed). Default false. */ disabled?: boolean;
40
+ /** Error message; sets aria-invalid and replaces the helper. */ error?: React.ReactNode;
41
+ /** Help text under the group (aria-describedby). */ helper?: React.ReactNode;
42
+ /** Accent colour: accent name ("violet", "ice", "emerald", "amber", "rose") or a CSS colour (checked by guardAccent). */ accent?: Accent;
43
+ /** ULRadio items. */ children?: React.ReactNode;
44
+ }
45
+ export declare function ULRadioGroup({ label, name, value, defaultValue, onValueChange, orientation, disabled, error, helper, accent, className, children, ...rest }: ULRadioGroupProps): React.JSX.Element;
46
+ export interface ULSwitchProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'type'> {
47
+ /** Visible label / accessible name. */ label?: React.ReactNode;
48
+ /** Secondary text (aria-describedby). */ description?: React.ReactNode;
49
+ /** "glass" | "flat" (controls category); flat keeps the lens geometry and timing as a flat pill. @default undefined (resolved: "glass") */ material?: Material;
50
+ /** Controlled on / off state (role="switch"). */ checked?: boolean;
51
+ /** Initial state when uncontrolled. Default false. */ defaultChecked?: boolean;
52
+ /** Called with the next state (click, Space / Enter, thumb drag). */ onCheckedChange?: (on: boolean) => void;
53
+ /** Shows a spinner and sets aria-busy; stays focusable. Default false. */ loading?: boolean;
54
+ /** Error message; sets aria-invalid and replaces the helper. */ error?: React.ReactNode;
55
+ /** Accent colour: accent name ("violet", "ice", "emerald", "amber", "rose") or a CSS colour (checked by guardAccent). */ accent?: Accent;
56
+ /** Glass lens bubble while pressed / travelling. Default true. */
57
+ lens?: boolean;
58
+ /** @internal */
59
+ forceState?: Force;
60
+ }
61
+ /**
62
+ * Switch: inset track + flat capsule thumb (width = height × --ul-switch-thumb-ratio, concentric with the track).
63
+ * Drag to set: on press the shared lens bubble grows on the thumb; while held it follows the pointer along the track
64
+ * (rubber band past the ends, elastic two-edge model). The state is decided ON RELEASE from the bubble centre
65
+ * (+ flick projection): past the midpoint = on. A press without moving beyond --ul-switch-drag-threshold is a click and
66
+ * toggles. aria-checked / onCheckedChange change only on release, exactly once, never if unchanged. Esc / pointercancel
67
+ * restore. During the drag the fill previews the position (--ul-switch-p) without changing aria-checked.
68
+ * Space / Enter toggle (native button) through the same bubble path, shortened.
69
+ */
70
+ export declare const ULSwitch: React.ForwardRefExoticComponent<ULSwitchProps & React.RefAttributes<HTMLButtonElement>>;
71
+ export {};
@@ -0,0 +1,43 @@
1
+ import * as React from 'react';
2
+ import type { Accent } from '../../glass/accent.js';
3
+ import '../shared/lens.css';
4
+ import './ULSlider.css';
5
+ interface SliderBase {
6
+ label?: React.ReactNode;
7
+ 'aria-label'?: string;
8
+ min?: number;
9
+ max?: number;
10
+ step?: number;
11
+ disabled?: boolean;
12
+ /** Formats the visible value, tooltip and aria-valuetext. */
13
+ format?: (v: number) => string;
14
+ helper?: React.ReactNode;
15
+ accent?: Accent;
16
+ className?: string;
17
+ style?: React.CSSProperties;
18
+ /** Hide the value next to the label. */
19
+ hideValue?: boolean;
20
+ /** horizontal (default) | vertical (length = --ul-selection-slider-length). */
21
+ orientation?: 'horizontal' | 'vertical';
22
+ /** Glass lens bubble while pressed / moving. Default true. */
23
+ lens?: boolean;
24
+ /** @internal */
25
+ forceState?: 'hover' | 'focus' | 'pressed' | (string & {});
26
+ }
27
+ export interface ULSliderProps extends SliderBase {
28
+ value?: number; /** Initial value when uncontrolled. Default min (0 when min is not set). */
29
+ defaultValue?: number; /** Called with the new value while dragging (one call per frame) and on keys. */
30
+ onValueChange?: (v: number) => void;
31
+ }
32
+ export interface ULRangeSliderProps extends SliderBase {
33
+ /** Controlled [low, high]. */ value?: [number, number]; /** Initial [low, high] when uncontrolled. */
34
+ defaultValue?: [number, number]; /** Called with [low, high]; thumbs never cross (minimum gap = step). */
35
+ onValueChange?: (v: [number, number]) => void;
36
+ /** Accessible names of the two thumbs. Default "Minimum" / "Maximum". */
37
+ thumbLabels?: [string, string];
38
+ }
39
+ /** Single-value slider. */
40
+ export declare function ULSlider({ value, defaultValue, onValueChange, ...o }: ULSliderProps): React.JSX.Element;
41
+ /** Two-thumb range slider. Thumbs never cross. */
42
+ export declare function ULRangeSlider({ value, defaultValue, onValueChange, thumbLabels, ...o }: ULRangeSliderProps): React.JSX.Element;
43
+ export {};