@glimstone/solid 0.0.0-stage → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (127) hide show
  1. package/README.md +50 -2
  2. package/dist/AboutCard.d.ts +154 -0
  3. package/dist/Accordion.d.ts +15 -0
  4. package/dist/Accordion.js +45 -0
  5. package/dist/AngleSlider.d.ts +10 -0
  6. package/dist/AngleSlider.js +47 -0
  7. package/dist/Avatar.d.ts +11 -0
  8. package/dist/Avatar.js +50 -0
  9. package/dist/Badge-CC2mjBLM.js +116 -0
  10. package/dist/Badge.d.ts +52 -0
  11. package/dist/BusyRing.d.ts +13 -0
  12. package/dist/Button-DNSkNN0r.js +219 -0
  13. package/dist/Button.d.ts +56 -0
  14. package/dist/Card.d.ts +33 -0
  15. package/dist/Carousel.d.ts +18 -0
  16. package/dist/Carousel.js +88 -0
  17. package/dist/Checkbox.d.ts +14 -0
  18. package/dist/CoffeeDialog.d.ts +16 -0
  19. package/dist/Collapsible.d.ts +12 -0
  20. package/dist/Collapsible.js +27 -0
  21. package/dist/ColorPicker.d.ts +21 -0
  22. package/dist/Combobox.d.ts +16 -0
  23. package/dist/Combobox.js +64 -0
  24. package/dist/ConfirmDialog.d.ts +29 -0
  25. package/dist/ContextMenu.d.ts +27 -0
  26. package/dist/CopyField.d.ts +17 -0
  27. package/dist/CryptoDonateDialog.d.ts +35 -0
  28. package/dist/DatePicker.d.ts +17 -0
  29. package/dist/DatePicker.js +132 -0
  30. package/dist/DropdownListbox.d.ts +22 -0
  31. package/dist/EmptyState.d.ts +19 -0
  32. package/dist/FieldError.d.ts +8 -0
  33. package/dist/FieldRow.d.ts +20 -0
  34. package/dist/FieldRowGroup.d.ts +10 -0
  35. package/dist/FileUpload.d.ts +15 -0
  36. package/dist/FileUpload.js +68 -0
  37. package/dist/FloatingPanel.d.ts +14 -0
  38. package/dist/FloatingPanel.js +80 -0
  39. package/dist/Fortress.d.ts +101 -0
  40. package/dist/FortressAppCard.d.ts +39 -0
  41. package/dist/FortressPermissions.d.ts +23 -0
  42. package/dist/FortressStatusWindow.d.ts +25 -0
  43. package/dist/GlyphField.d.ts +16 -0
  44. package/dist/GlyphTile.d.ts +12 -0
  45. package/dist/HoverCard.d.ts +12 -0
  46. package/dist/HoverCard.js +55 -0
  47. package/dist/IconButton-Lzbq5Cst.js +42 -0
  48. package/dist/IconButton.d.ts +16 -0
  49. package/dist/IconTipButton-BojUYQWU.js +73 -0
  50. package/dist/IconTipButton.d.ts +20 -0
  51. package/dist/InfoBubble.d.ts +4 -0
  52. package/dist/InstanceCard.d.ts +25 -0
  53. package/dist/Kbd.d.ts +5 -0
  54. package/dist/Lift-CsM0IU9t.js +13 -0
  55. package/dist/Lift.d.ts +12 -0
  56. package/dist/ListRow.d.ts +16 -0
  57. package/dist/ListTable.d.ts +21 -0
  58. package/dist/Marquee.d.ts +16 -0
  59. package/dist/Marquee.js +59 -0
  60. package/dist/MenuBar.d.ts +17 -0
  61. package/dist/Meter.d.ts +18 -0
  62. package/dist/NumberField.d.ts +20 -0
  63. package/dist/Pagination.d.ts +14 -0
  64. package/dist/Pagination.js +77 -0
  65. package/dist/PasswordField.d.ts +17 -0
  66. package/dist/PathField.d.ts +28 -0
  67. package/dist/PaypalDialog.d.ts +51 -0
  68. package/dist/Pill.d.ts +12 -0
  69. package/dist/PinInput.d.ts +21 -0
  70. package/dist/PinInput.js +50 -0
  71. package/dist/Popover.d.ts +14 -0
  72. package/dist/ProgressBar.d.ts +14 -0
  73. package/dist/Rating.d.ts +15 -0
  74. package/dist/Rating.js +45 -0
  75. package/dist/ReadmeButton.d.ts +29 -0
  76. package/dist/RowMark.d.ts +5 -0
  77. package/dist/ScrollArea.d.ts +9 -0
  78. package/dist/ScrollArea.js +31 -0
  79. package/dist/Select.d.ts +48 -0
  80. package/dist/Select.js +548 -0
  81. package/dist/Selector.d.ts +76 -0
  82. package/dist/Sheet.d.ts +21 -0
  83. package/dist/SidebarRow.d.ts +28 -0
  84. package/dist/SignInCard.d.ts +40 -0
  85. package/dist/SignaturePad.d.ts +11 -0
  86. package/dist/SignaturePad.js +65 -0
  87. package/dist/SkeletonRow.d.ts +10 -0
  88. package/dist/Slider.d.ts +12 -0
  89. package/dist/Slider.js +34 -0
  90. package/dist/Splitter.d.ts +14 -0
  91. package/dist/Splitter.js +54 -0
  92. package/dist/Steps.d.ts +17 -0
  93. package/dist/Steps.js +112 -0
  94. package/dist/SubCard.d.ts +17 -0
  95. package/dist/Table.d.ts +14 -0
  96. package/dist/TagsInput.d.ts +15 -0
  97. package/dist/TagsInput.js +57 -0
  98. package/dist/TextField.d.ts +25 -0
  99. package/dist/Timer.d.ts +15 -0
  100. package/dist/Timer.js +98 -0
  101. package/dist/TipWrap.d.ts +12 -0
  102. package/dist/Toast.d.ts +27 -0
  103. package/dist/Toggle.d.ts +23 -0
  104. package/dist/Tour.d.ts +10 -0
  105. package/dist/Tour.js +83 -0
  106. package/dist/Tree.d.ts +20 -0
  107. package/dist/UnavailableNotice.d.ts +15 -0
  108. package/dist/Window.d.ts +30 -0
  109. package/dist/WindowBar.d.ts +25 -0
  110. package/dist/WindowFootRow.d.ts +25 -0
  111. package/dist/engines.d.ts +17 -0
  112. package/dist/fieldName-Bb6qW0oS.js +8 -0
  113. package/dist/fieldName.d.ts +5 -0
  114. package/dist/glyphs-xP5bYKa1.js +127 -0
  115. package/dist/glyphs.d.ts +36 -0
  116. package/dist/index.d.ts +65 -0
  117. package/dist/index.js +5279 -0
  118. package/dist/portalHue-CLVEiNTo.js +14 -0
  119. package/dist/portalHue.d.ts +10 -0
  120. package/dist/style-ByE-hij7.js +8 -0
  121. package/dist/style.d.ts +7 -0
  122. package/dist/useConfirm.d.ts +26 -0
  123. package/dist/useDragArmed.d.ts +6 -0
  124. package/dist/usePaypalButtons.d.ts +17 -0
  125. package/dist/useTipBubble-BJIYZw03.js +65 -0
  126. package/dist/useTipBubble.d.ts +25 -0
  127. package/package.json +148 -4
@@ -0,0 +1,51 @@
1
+ import { type JSX } from "solid-js";
2
+ import type { GiveFrequency } from "@glimstone/core";
3
+ export interface PaypalSelectorProps {
4
+ labelledBy: string;
5
+ options: {
6
+ value: string;
7
+ label: string;
8
+ }[];
9
+ /** Null when no segment is picked, as while a typed amount applies. */
10
+ value: string | null;
11
+ onChange: (value: string) => void;
12
+ }
13
+ export interface PaypalDialogProps {
14
+ text: {
15
+ title: string;
16
+ /** The app's appeal, the same in every giving window. */
17
+ appeal: string;
18
+ /** One sentence: the payment happens at PayPal, by account or by card. */
19
+ intro: string;
20
+ frequencyLabel: string;
21
+ frequencies: Record<GiveFrequency, string>;
22
+ amountLabel: string;
23
+ /** Placeholder and accessible name of the free amount. */
24
+ otherAmount: string;
25
+ loading: string;
26
+ thanks: string;
27
+ failed: string;
28
+ closeLabel: string;
29
+ };
30
+ frequency: GiveFrequency;
31
+ onFrequency: (frequency: GiveFrequency) => void;
32
+ /** The preset amounts, as whole numbers in the currency. */
33
+ amounts: string[];
34
+ currencySymbol: string;
35
+ /** The picked preset, or null while the free amount is in use. */
36
+ preset: string | null;
37
+ onPreset: (amount: string) => void;
38
+ typed: string;
39
+ /** Whether `typed` parses as an amount PayPal accepts. */
40
+ typedValid: boolean;
41
+ onTyped: (text: string) => void;
42
+ /** The app's own horizontal selector. */
43
+ renderSelector: (props: PaypalSelectorProps) => JSX.Element;
44
+ /** From usePaypalButtons. */
45
+ buttonsRef: (el: HTMLDivElement) => void;
46
+ status: "idle" | "done" | "failed";
47
+ onClose: () => void;
48
+ /** The window's own card, for the app's Escape handling and focus trap. */
49
+ ref?: HTMLDivElement | ((el: HTMLDivElement) => void);
50
+ }
51
+ export declare function PaypalDialog(props: PaypalDialogProps): JSX.Element;
package/dist/Pill.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ import { type JSX } from "solid-js";
2
+ import { type PillTone } from "@glimstone/core";
3
+ export type { PillTone } from "@glimstone/core";
4
+ export interface PillProps {
5
+ children: JSX.Element;
6
+ /** `state` lifts a word that says what the row is doing; the other three
7
+ * wash the pill in their state colour. */
8
+ tone?: PillTone;
9
+ /** Extra classes, such as `glim-num` for figures that line up in a column. */
10
+ class?: string;
11
+ }
12
+ export declare function Pill(props: PillProps): JSX.Element;
@@ -0,0 +1,21 @@
1
+ import { type PinInputText } from "@glimstone/core";
2
+ export type { PinInputText } from "@glimstone/core";
3
+ export interface PinInputProps {
4
+ label?: string;
5
+ /** The code as one string; an empty box is a missing character at its end. */
6
+ value: string;
7
+ onChange: (value: string) => void;
8
+ /** Called once every box holds a character. */
9
+ onComplete?: (value: string) => void;
10
+ length?: number;
11
+ /** What a box takes: digits by default. */
12
+ type?: "numeric" | "alphanumeric" | "alphabetic";
13
+ /** Draws dots instead of the characters, for a code that is a secret. */
14
+ mask?: boolean;
15
+ /** Offers the code the phone just received, as a one-time code. */
16
+ otp?: boolean;
17
+ invalid?: boolean;
18
+ disabled?: boolean;
19
+ text?: Partial<PinInputText>;
20
+ }
21
+ export declare function PinInput(raw: PinInputProps): import("solid-js").JSX.Element;
@@ -0,0 +1,50 @@
1
+ import { r as e } from "./fieldName-Bb6qW0oS.js";
2
+ import { createComponent as t, insert as n, mergeProps as r, spread as i, template as a } from "solid-js/web";
3
+ import { For as o, createMemo as s, createUniqueId as c, mergeProps as l } from "solid-js";
4
+ import { PIN_INPUT_TEXT as u, pinCells as d } from "@glimstone/core";
5
+ import { normalizeProps as f, useMachine as p } from "@zag-js/solid";
6
+ import * as m from "@zag-js/pin-input";
7
+ // src/PinInput.tsx
8
+ var h = /*#__PURE__*/ a("<div data-glim=PinInput><label></label><div></div><input>"), g = /*#__PURE__*/ a("<input>");
9
+ function _(a) {
10
+ let _ = l({
11
+ length: 6,
12
+ type: "numeric",
13
+ mask: !1,
14
+ otp: !1,
15
+ invalid: !1,
16
+ disabled: !1
17
+ }, a), v = e(() => _.label), y = () => ({
18
+ ...u,
19
+ ..._.text
20
+ }), b = c(), x = p(m.machine, () => ({
21
+ id: b,
22
+ dir: "ltr",
23
+ count: _.length,
24
+ value: d(_.value, _.length),
25
+ type: _.type,
26
+ mask: _.mask,
27
+ otp: _.otp,
28
+ invalid: _.invalid,
29
+ disabled: _.disabled,
30
+ placeholder: "",
31
+ onValueChange: (e) => _.onChange(e.valueAsString),
32
+ onValueComplete: (e) => _.onComplete?.(e.valueAsString),
33
+ translations: { inputLabel: (e, t) => y().cell(e + 1, t) }
34
+ })), S = s(() => m.connect(x, f));
35
+ return (() => {
36
+ var e = h(), a = e.firstChild, s = a.nextSibling, c = s.nextSibling;
37
+ return i(e, r(() => S().getRootProps(), { class: "glim-pin" }), !1, !0), i(a, r(() => S().getLabelProps(), { get class() {
38
+ return _.label === void 0 ? "glim-sr-only" : "glim-field-label";
39
+ } }), !1, !0), n(a, v), i(s, r(() => S().getControlProps(), { class: "glim-pin-control" }), !1, !0), n(s, t(o, {
40
+ get each() {
41
+ return S().items;
42
+ },
43
+ children: (e) => (() => {
44
+ var t = g();
45
+ return i(t, r(() => S().getInputProps({ index: e }), { class: "glim-input glim-pin-cell glim-num" }), !1, !1), t;
46
+ })()
47
+ })), i(c, r(() => S().getHiddenInputProps()), !1, !1), e;
48
+ })();
49
+ }
50
+ export { _ as PinInput };
@@ -0,0 +1,14 @@
1
+ import { type JSX } from "solid-js";
2
+ export interface PopoverProps {
3
+ /** Whether it shows. */
4
+ open: boolean;
5
+ /** The control it stands beside. */
6
+ anchor: HTMLElement | null;
7
+ /** Its accessible name. */
8
+ label: string;
9
+ /** Called when the browser closes it; the caller sets `open` back. */
10
+ onClose: () => void;
11
+ children: JSX.Element;
12
+ class?: string;
13
+ }
14
+ export declare function Popover(props: PopoverProps): JSX.Element;
@@ -0,0 +1,14 @@
1
+ export interface ProgressBarProps {
2
+ /** From 0 to 1. Without it the bar runs indeterminate, while the work has no measure yet. */
3
+ value?: number | null;
4
+ /** The accessible name, such as what is being copied. */
5
+ label: string;
6
+ /** The work waits: the fill takes the waiting tone and the sheen stops. */
7
+ paused?: boolean;
8
+ /** The work stopped on an error: the fill takes the fault colour. */
9
+ failed?: boolean;
10
+ /** The progress in words, such as "1.2 GB of 4 GB", read out instead of the percentage. */
11
+ valueText?: string;
12
+ class?: string;
13
+ }
14
+ export declare function ProgressBar(props: ProgressBarProps): import("solid-js").JSX.Element;
@@ -0,0 +1,15 @@
1
+ import { type RatingText } from "@glimstone/core";
2
+ export type { RatingText } from "@glimstone/core";
3
+ export interface RatingProps {
4
+ label?: string;
5
+ value: number;
6
+ onChange: (value: number) => void;
7
+ count?: number;
8
+ /** Takes half stars, from the pointer and from the arrows. */
9
+ allowHalf?: boolean;
10
+ /** Shows the value and takes no input, such as an average. */
11
+ readOnly?: boolean;
12
+ disabled?: boolean;
13
+ text?: Partial<RatingText>;
14
+ }
15
+ export declare function Rating(raw: RatingProps): import("solid-js").JSX.Element;
package/dist/Rating.js ADDED
@@ -0,0 +1,45 @@
1
+ import { r as e } from "./fieldName-Bb6qW0oS.js";
2
+ import { g as t } from "./glyphs-xP5bYKa1.js";
3
+ import { createComponent as n, insert as r, mergeProps as i, spread as a, template as o } from "solid-js/web";
4
+ import { For as s, createMemo as c, createUniqueId as l, mergeProps as u } from "solid-js";
5
+ import { RATING_TEXT as d, pageDir as f } from "@glimstone/core";
6
+ import { normalizeProps as p, useMachine as m } from "@zag-js/solid";
7
+ import * as h from "@zag-js/rating-group";
8
+ // src/Rating.tsx
9
+ var g = /*#__PURE__*/ o("<div data-glim=Rating><label></label><div></div><input>"), _ = /*#__PURE__*/ o("<span><span class=glim-rating-fill aria-hidden=true>");
10
+ function v(o) {
11
+ let v = u({
12
+ count: 5,
13
+ allowHalf: !1,
14
+ readOnly: !1,
15
+ disabled: !1
16
+ }, o), y = l(), b = e(() => v.label), x = () => ({
17
+ ...d,
18
+ ...v.text
19
+ }), S = m(h.machine, () => ({
20
+ id: y,
21
+ dir: f(),
22
+ value: v.value,
23
+ count: v.count,
24
+ allowHalf: v.allowHalf,
25
+ readOnly: v.readOnly,
26
+ disabled: v.disabled,
27
+ onValueChange: (e) => v.onChange(e.value),
28
+ translations: { ratingValueText: (e) => x().star(e, v.count) }
29
+ })), C = c(() => h.connect(S, p));
30
+ return (() => {
31
+ var e = g(), o = e.firstChild, c = o.nextSibling, l = c.nextSibling;
32
+ return a(e, i(() => C().getRootProps(), { class: "glim-rating" }), !1, !0), a(o, i(() => C().getLabelProps(), { get class() {
33
+ return v.label === void 0 ? "glim-sr-only" : "glim-field-label";
34
+ } }), !1, !0), r(o, b), a(c, i(() => C().getControlProps(), { class: "glim-rating-control" }), !1, !0), r(c, n(s, {
35
+ get each() {
36
+ return C().items;
37
+ },
38
+ children: (e) => (() => {
39
+ var o = _(), s = o.firstChild;
40
+ return a(o, i(() => C().getItemProps({ index: e }), { class: "glim-rating-star" }), !1, !0), r(o, n(t, {}), s), r(s, n(t, {})), o;
41
+ })()
42
+ })), a(l, i(() => C().getHiddenInputProps()), !1, !1), e;
43
+ })();
44
+ }
45
+ export { v as Rating };
@@ -0,0 +1,29 @@
1
+ import { type JSX } from "solid-js";
2
+ import { type ReadmeBrand, type ReadmePart } from "@glimstone/core";
3
+ export type { ReadmeBrand, ReadmePart } from "@glimstone/core";
4
+ export interface ReadmeButtonProps {
5
+ /** The brand whose colour the unit lights up in. */
6
+ brand: ReadmeBrand;
7
+ /** The button, then its segments. */
8
+ parts: [ReadmePart, ...ReadmePart[]];
9
+ mark?: JSX.Element;
10
+ /** The class that paints the mark at rest, such as `glim-windows-mark`. It
11
+ * sits on the mark's box, where the lit unit's ink can override it. */
12
+ markClass?: string;
13
+ /** A vendor's own button artwork, which replaces the first part's mark and words. */
14
+ art?: JSX.Element;
15
+ /** The "(i)" at the end of the unit, for what the name cannot say. */
16
+ hint?: string;
17
+ /** Holds the second lines in view while one reports what it did, such as "Copied". */
18
+ note?: boolean;
19
+ /** The second line of a unit whose first part has neither `href` nor `onClick`. */
20
+ soonLabel?: string;
21
+ /** Runs on a click on a part's link, for an app whose webview has no browser
22
+ * behind it to open the address in. */
23
+ onLinkClick?: (e: MouseEvent) => void;
24
+ }
25
+ export declare function ReadmeButton(props: ReadmeButtonProps): JSX.Element;
26
+ /** A vendor mark kept as its own markup, from appMarks.ts. */
27
+ export declare function BrandMark(props: {
28
+ svg: string;
29
+ }): JSX.Element;
@@ -0,0 +1,5 @@
1
+ export interface RowMarkProps {
2
+ on?: boolean;
3
+ class?: string;
4
+ }
5
+ export declare function RowMark(props: RowMarkProps): import("solid-js").JSX.Element;
@@ -0,0 +1,9 @@
1
+ import { type JSX } from "solid-js";
2
+ export interface ScrollAreaProps {
3
+ /** The region's accessible name. */
4
+ label: string;
5
+ /** How tall it grows before it scrolls, as a CSS length. */
6
+ maxHeight: string;
7
+ children: JSX.Element;
8
+ }
9
+ export declare function ScrollArea(props: ScrollAreaProps): JSX.Element;
@@ -0,0 +1,31 @@
1
+ import { insert as e, mergeProps as t, spread as n, template as r } from "solid-js/web";
2
+ import { createMemo as i, createUniqueId as a } from "solid-js";
3
+ import { pageDir as o } from "@glimstone/core";
4
+ import { normalizeProps as s, useMachine as c } from "@zag-js/solid";
5
+ import * as l from "@zag-js/scroll-area";
6
+ // src/ScrollArea.tsx
7
+ var u = /*#__PURE__*/ r("<div data-glim=ScrollArea><div><div></div></div><div><div></div></div><div><div></div></div><div>");
8
+ function d(r) {
9
+ let d = a(), f = c(l.machine, () => ({
10
+ id: d,
11
+ dir: o()
12
+ })), p = i(() => l.connect(f, s)), m = () => p().getViewportProps();
13
+ return (() => {
14
+ var i = u(), a = i.firstChild, o = a.firstChild, s = a.nextSibling, c = s.firstChild, l = s.nextSibling, d = l.firstChild, f = l.nextSibling;
15
+ return n(i, t(() => p().getRootProps(), { class: "glim-scroll" }), !1, !0), n(a, t(m, {
16
+ role: "region",
17
+ get "aria-label"() {
18
+ return r.label;
19
+ },
20
+ tabIndex: 0,
21
+ get style() {
22
+ return {
23
+ ...m().style,
24
+ "max-height": r.maxHeight
25
+ };
26
+ },
27
+ class: "glim-scroll-viewport"
28
+ }), !1, !0), n(o, t(() => p().getContentProps(), { class: "glim-scroll-content" }), !1, !0), e(o, () => r.children), n(s, t(() => p().getScrollbarProps({ orientation: "vertical" }), { class: "glim-scroll-bar" }), !1, !0), n(c, t(() => p().getThumbProps({ orientation: "vertical" }), { class: "glim-scroll-thumb" }), !1, !1), n(l, t(() => p().getScrollbarProps({ orientation: "horizontal" }), { class: "glim-scroll-bar" }), !1, !0), n(d, t(() => p().getThumbProps({ orientation: "horizontal" }), { class: "glim-scroll-thumb" }), !1, !1), n(f, t(() => p().getCornerProps(), { class: "glim-scroll-corner" }), !1, !1), i;
29
+ })();
30
+ }
31
+ export { d as ScrollArea };
@@ -0,0 +1,48 @@
1
+ import { type JSX } from "solid-js";
2
+ import { type SelectChoice, type SelectEntry as Entry, type SelectRows, type SelectRun, type SelectSize, type SelectSubmenu as Submenu, type SelectWidth } from "@glimstone/core";
3
+ type Glyph = () => JSX.Element;
4
+ export type SelectOption<T extends string = string> = SelectChoice<T, Glyph>;
5
+ export type SelectSubmenu<T extends string = string> = Submenu<T, Glyph>;
6
+ export type SelectEntry<T extends string = string> = Entry<T, Glyph>;
7
+ export type SelectGroup<T extends string = string> = SelectRun<T, Glyph>;
8
+ export type { SelectRows, SelectSize, SelectWidth } from "@glimstone/core";
9
+ export interface SelectProps<T extends string = string> {
10
+ /** The field's name, always the accessible name. Inside a FieldRow the row gives it and draws the words. */
11
+ label?: string;
12
+ /** Draw the label off screen, for a settings row that names the field at its start. */
13
+ hideLabel?: boolean;
14
+ /** Every choice, in list order, for a list without groups. */
15
+ options?: SelectOption<T>[];
16
+ /** The list in runs, with headings and submenus. The wheel steps through every option in list order. */
17
+ groups?: SelectGroup<T>[];
18
+ /** Null when there is no one value, such as over a selection whose rows disagree. */
19
+ value: T | null;
20
+ onChange: (value: T) => void;
21
+ /** Shown while the value is null. */
22
+ placeholder?: string;
23
+ /** Defaults to `fill` for a field and to `steady` for the smaller sizes and inside a FieldRow. */
24
+ width?: SelectWidth;
25
+ size?: SelectSize;
26
+ /** `menu` draws the open list with a context menu's rows, so an app with both shows one kind of menu row. */
27
+ rows?: SelectRows;
28
+ /** Lets a long value run onto a second line instead of ending in an ellipsis, for one whose end says as much as its start, such as a path. */
29
+ wrap?: boolean;
30
+ /** The trigger's id, for a `<label for>` outside the select. */
31
+ id?: string;
32
+ /** Attributes for the trigger, such as a data hook that says the value. */
33
+ triggerAttrs?: Record<string, string>;
34
+ /** The open list's id. */
35
+ listId?: string;
36
+ /** The trigger's own node, for a caller that hands it the focus. */
37
+ ref?: HTMLButtonElement | ((el: HTMLButtonElement) => void);
38
+ disabled?: boolean;
39
+ /** A choice is out and its answer not back yet: the trigger keeps its focus but takes no input. */
40
+ busy?: boolean;
41
+ /** A hover bubble, for a trigger with no label beside it whose value does not say what it picks. */
42
+ tip?: string;
43
+ /** The caller's failure counter. Each bump shakes the trigger once, as the value snaps back. */
44
+ shake?: number;
45
+ /** Classes for the trigger, for a size the call site needs. */
46
+ class?: string;
47
+ }
48
+ export declare function Select<T extends string = string>(props: SelectProps<T>): JSX.Element;