@kirana-ui/solid 0.1.0 → 0.1.1

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 (159) hide show
  1. package/dom/autocomplete.js +2 -0
  2. package/dom/autosize.js +19 -0
  3. package/dom/calendar.js +141 -0
  4. package/dom/carousel.js +83 -0
  5. package/dom/checkbox.js +2 -1
  6. package/dom/combobox.js +281 -0
  7. package/dom/command.js +129 -0
  8. package/dom/context-menu.js +2 -0
  9. package/dom/date-field.js +86 -0
  10. package/dom/date-picker.js +103 -0
  11. package/dom/dialog.js +28 -0
  12. package/dom/drawer.js +2 -0
  13. package/dom/hover-popup.js +17 -2
  14. package/dom/index.js +26 -1
  15. package/dom/input.js +26 -0
  16. package/dom/label.js +18 -0
  17. package/dom/listbox.js +114 -0
  18. package/dom/menu.js +261 -0
  19. package/dom/menubar-context.js +3 -0
  20. package/dom/menubar.js +33 -0
  21. package/dom/message-scroller.js +56 -0
  22. package/dom/navigation-menu.js +150 -0
  23. package/dom/number-field.js +82 -0
  24. package/dom/otp.js +95 -0
  25. package/dom/pagination.js +74 -0
  26. package/dom/popover.js +2 -0
  27. package/dom/qr-code.js +48 -0
  28. package/dom/radio-group.js +2 -1
  29. package/dom/resizable.js +65 -0
  30. package/dom/runtime.js +36 -2
  31. package/dom/scroll-area.js +99 -0
  32. package/dom/select.js +69 -5
  33. package/dom/slider.js +1 -1
  34. package/dom/switch.js +2 -1
  35. package/dom/toast.js +113 -0
  36. package/dom/toggle-group.js +37 -0
  37. package/dom/toggle.js +11 -3
  38. package/dom/toolbar-context.js +5 -0
  39. package/dom/toolbar.js +71 -0
  40. package/llms.txt +1838 -0
  41. package/package.json +220 -2
  42. package/server/autocomplete.js +2 -0
  43. package/server/autosize.js +19 -0
  44. package/server/calendar.js +140 -0
  45. package/server/carousel.js +83 -0
  46. package/server/checkbox.js +2 -1
  47. package/server/combobox.js +281 -0
  48. package/server/command.js +129 -0
  49. package/server/context-menu.js +2 -0
  50. package/server/date-field.js +86 -0
  51. package/server/date-picker.js +103 -0
  52. package/server/dialog.js +28 -0
  53. package/server/drawer.js +2 -0
  54. package/server/hover-popup.js +17 -2
  55. package/server/index.js +26 -1
  56. package/server/input.js +26 -0
  57. package/server/label.js +18 -0
  58. package/server/listbox.js +114 -0
  59. package/server/menu.js +261 -0
  60. package/server/menubar-context.js +3 -0
  61. package/server/menubar.js +33 -0
  62. package/server/message-scroller.js +56 -0
  63. package/server/navigation-menu.js +144 -0
  64. package/server/number-field.js +81 -0
  65. package/server/otp.js +94 -0
  66. package/server/pagination.js +74 -0
  67. package/server/popover.js +2 -0
  68. package/server/qr-code.js +48 -0
  69. package/server/radio-group.js +2 -1
  70. package/server/resizable.js +65 -0
  71. package/server/runtime.js +35 -1
  72. package/server/scroll-area.js +99 -0
  73. package/server/select.js +69 -5
  74. package/server/slider.js +1 -1
  75. package/server/switch.js +2 -1
  76. package/server/toast.js +113 -0
  77. package/server/toggle-group.js +37 -0
  78. package/server/toggle.js +11 -3
  79. package/server/toolbar-context.js +5 -0
  80. package/server/toolbar.js +71 -0
  81. package/src/autocomplete.jsx +2 -0
  82. package/src/autosize.jsx +8 -0
  83. package/src/calendar.jsx +104 -0
  84. package/src/carousel.jsx +51 -0
  85. package/src/checkbox.jsx +2 -0
  86. package/src/combobox.jsx +179 -0
  87. package/src/command.jsx +81 -0
  88. package/src/context-menu.js +2 -0
  89. package/src/date-field.jsx +67 -0
  90. package/src/date-picker.jsx +72 -0
  91. package/src/dialog.jsx +20 -0
  92. package/src/drawer.js +2 -0
  93. package/src/hover-popup.jsx +10 -2
  94. package/src/index.js +26 -1
  95. package/src/input.jsx +17 -0
  96. package/src/label.jsx +9 -0
  97. package/src/listbox.jsx +81 -0
  98. package/src/menu.jsx +164 -0
  99. package/src/menubar-context.js +3 -0
  100. package/src/menubar.jsx +21 -0
  101. package/src/message-scroller.jsx +27 -0
  102. package/src/navigation-menu.jsx +95 -0
  103. package/src/number-field.jsx +75 -0
  104. package/src/otp.jsx +73 -0
  105. package/src/pagination.jsx +60 -0
  106. package/src/popover.jsx +2 -0
  107. package/src/qr-code.jsx +25 -0
  108. package/src/radio-group.jsx +2 -0
  109. package/src/resizable.jsx +46 -0
  110. package/src/runtime.jsx +33 -2
  111. package/src/scroll-area.jsx +53 -0
  112. package/src/select.jsx +49 -5
  113. package/src/slider.jsx +2 -0
  114. package/src/switch.jsx +2 -0
  115. package/src/toast.jsx +58 -0
  116. package/src/toggle-group.jsx +32 -0
  117. package/src/toggle.jsx +8 -2
  118. package/src/toolbar-context.js +5 -0
  119. package/src/toolbar.jsx +43 -0
  120. package/types/autocomplete.d.ts +1 -0
  121. package/types/autosize.d.ts +8 -0
  122. package/types/calendar.d.ts +40 -0
  123. package/types/carousel.d.ts +26 -0
  124. package/types/checkbox.d.ts +1 -0
  125. package/types/combobox.d.ts +106 -0
  126. package/types/command.d.ts +45 -0
  127. package/types/context-menu.d.ts +1 -0
  128. package/types/date-field.d.ts +23 -0
  129. package/types/date-picker.d.ts +49 -0
  130. package/types/dialog.d.ts +21 -0
  131. package/types/drawer.d.ts +1 -0
  132. package/types/hover-card.d.ts +4 -1
  133. package/types/hover-popup.d.ts +4 -1
  134. package/types/index.d.ts +27 -1
  135. package/types/input.d.ts +12 -0
  136. package/types/label.d.ts +4 -0
  137. package/types/listbox.d.ts +38 -0
  138. package/types/menu.d.ts +91 -0
  139. package/types/menubar-context.d.ts +3 -0
  140. package/types/menubar.d.ts +10 -0
  141. package/types/message-scroller.d.ts +16 -0
  142. package/types/navigation-menu.d.ts +44 -0
  143. package/types/number-field.d.ts +15 -0
  144. package/types/otp.d.ts +32 -0
  145. package/types/pagination.d.ts +23 -0
  146. package/types/popover.d.ts +4 -1
  147. package/types/qr-code.d.ts +14 -0
  148. package/types/radio-group.d.ts +1 -0
  149. package/types/resizable.d.ts +24 -0
  150. package/types/runtime.d.ts +18 -0
  151. package/types/scroll-area.d.ts +20 -0
  152. package/types/select.d.ts +25 -1
  153. package/types/switch.d.ts +1 -0
  154. package/types/toast.d.ts +33 -0
  155. package/types/toggle-group.d.ts +14 -0
  156. package/types/toggle.d.ts +2 -0
  157. package/types/toolbar-context.d.ts +6 -0
  158. package/types/toolbar.d.ts +23 -0
  159. package/types/tooltip.d.ts +4 -1
package/llms.txt ADDED
@@ -0,0 +1,1838 @@
1
+ # @kirana-ui/solid
2
+
3
+ > Kirana UI Primitives for Solid: headless, accessible components with no styles of their own. The same components, parts, attributes and behaviour as on the other four frameworks, from one core.
4
+
5
+ Generated from the library's own definitions (`bun scripts/llms.ts`): what is here is what the components do.
6
+
7
+ ## Using it
8
+
9
+ - Each component is a namespace of parts: `<Dialog.Root>`, `<Dialog.Trigger>`. A component with one part is the component: `<Button>`.
10
+ - A part renders its own element and takes that element's attributes (`class`, not `className`). `as="a"` draws another element.
11
+ - Controlled: `value={value()}` with `onValueChange`. Uncontrolled: `defaultValue`.
12
+ - A part that draws a list gives each entry to its function child: `{(segment) => …}`.
13
+ - No CSS is shipped and no styles are injected. A part is styled by its element, its `class`, and the attributes and CSS variables listed for it below.
14
+ - A boolean state is an attribute that is present or absent (`[data-open]`), never `="false"`.
15
+ - An entrance starts from `[data-starting-style]` and an exit ends at `[data-ending-style]`: write the hidden style under both and transition between. A part leaves the page when its own motion has ended.
16
+ - A popup is drawn in a portal at the end of `<body>` and placed by its `Positioner`, which carries `--anchor-width`, `--available-height`, `--transform-origin` and `data-side`.
17
+ - Every change callback is `(value, details)`: `details.reason`, `details.event`, `details.source` (mouse, touch, pen, keyboard, virtual, programmatic, agent), and `details.cancel()` to keep the value as it was.
18
+ - A value is controlled when it is given (`value`) and the component's own when it is not (`defaultValue`). `open`/`defaultOpen` and the others pair the same way.
19
+ - A control with a `name` is submitted with the form around it and follows the form's reset. Inside a `Field` it is the field's control.
20
+ - `PortalProvider` (`container`) says where the popups inside it are drawn, in place of the end of `<body>`: a shadow root's host, a full-screen element.
21
+ - An agent can read and use a page built with these: `createAgent()` from `@kirana-ui/core/agent` gives `snapshot()`, `act({ steps })` and `query()`; what it changes reaches the same callbacks with `details.source === "agent"`. Mark what needs a person with `data-agent-confirm`, what an agent must not see with `data-agent-hidden`, and a value it must not read with `data-agent-secret`. `history()`, `undo()` and `redo()` keep what it changed and take it back.
22
+
23
+ ## Components
24
+
25
+ ### Accordion
26
+
27
+ ```
28
+ import { Accordion } from "@kirana-ui/solid/accordion"
29
+ ```
30
+
31
+ Parts: `<Accordion.Root>`, `<Accordion.Item>`, `<Accordion.Header>`, `<Accordion.Trigger>`, `<Accordion.Panel>`.
32
+
33
+ Props of its root:
34
+
35
+ - `value?: readonly Value[]`: The values of the open items.
36
+ - `defaultValue?: readonly Value[]`: Read once.
37
+ - `onValueChange?: ((value: Value[], details: ChangeDetails) => void)`
38
+ - `multiple?: boolean`: Whether several items can be open at once. Default `false`: opening one closes the others.
39
+ - `disabled?: boolean`
40
+ - `orientation?: Orientation`: The way the arrows move between triggers. Default `vertical`.
41
+ - `loop?: boolean`: Whether the arrows wrap from the last trigger to the first. Default `true`.
42
+
43
+ Attributes and CSS variables, by part:
44
+
45
+ - root: Groups the items.
46
+ - `data-orientation="horizontal | vertical"`: The way the items are laid out, and the arrows that move between their triggers.
47
+ - `data-disabled`: Present when it is disabled.
48
+ - item: One section: a header with its trigger, and a panel.
49
+ - `data-open`: Present when the item is open.
50
+ - `data-disabled`: Present when it is disabled.
51
+ - header: The heading that holds the trigger.
52
+ - `data-open`: Present when the item is open.
53
+ - `data-disabled`: Present when it is disabled.
54
+ - trigger: The button that opens and closes the item's panel.
55
+ - `data-panel-open`: Present when the item's panel is open.
56
+ - `data-disabled`: Present when it is disabled.
57
+ - panel: The item's content. In the page while open, and through its exit's motion.
58
+ - `data-open`: Present when it is open.
59
+ - `data-closed`: Present when it is closed.
60
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
61
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
62
+ - `data-disabled`: Present when it is disabled.
63
+ - `data-orientation="horizontal | vertical"`: The way the items are laid out, and the arrows that move between their triggers.
64
+ - `--accordion-panel-height`: The panel's content height while it opens or closes, `auto` once it is open.
65
+ - `--accordion-panel-width`: The panel's content width while it opens or closes, `auto` once it is open.
66
+
67
+ ### AlertDialog
68
+
69
+ ```
70
+ import { AlertDialog } from "@kirana-ui/solid/alert-dialog"
71
+ ```
72
+
73
+ Parts: `<AlertDialog.Root>`, `<AlertDialog.Trigger>`, `<AlertDialog.Portal>`, `<AlertDialog.Backdrop>`, `<AlertDialog.Popup>`, `<AlertDialog.Title>`, `<AlertDialog.Description>`, `<AlertDialog.Close>`.
74
+
75
+ Attributes and CSS variables, by part:
76
+
77
+ - trigger: The button that opens the dialog.
78
+ - `data-popup-open`: Present when the dialog is open.
79
+ - backdrop: The layer over the page behind the dialog.
80
+ - `data-open`: Present when it is open.
81
+ - `data-closed`: Present when it is closed.
82
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
83
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
84
+ - popup: The dialog itself.
85
+ - `data-open`: Present when it is open.
86
+ - `data-closed`: Present when it is closed.
87
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
88
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
89
+ - `data-nested-dialog-open`: Present when another dialog is open above this one.
90
+ - `--nested-dialogs`: How many dialogs are open above this one.
91
+
92
+ ### Autocomplete
93
+
94
+ ```
95
+ import { Autocomplete } from "@kirana-ui/solid/autocomplete"
96
+ ```
97
+
98
+ Parts: `<Autocomplete.Root>`, `<Autocomplete.Input>`, `<Autocomplete.Trigger>`, `<Autocomplete.Clear>`, `<Autocomplete.Portal>`, `<Autocomplete.Positioner>`, `<Autocomplete.Popup>`, `<Autocomplete.Group>`, `<Autocomplete.GroupLabel>`, `<Autocomplete.Separator>`, `<Autocomplete.Item>`, `<Autocomplete.Empty>`.
99
+
100
+ Props of its root:
101
+
102
+ - `value?: string`: What the input says: the text is the value.
103
+ - `defaultValue?: string`
104
+ - `onValueChange?: ((value: string, details: ChangeDetails) => void)`
105
+ - `open?: boolean`
106
+ - `defaultOpen?: boolean`
107
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
108
+ - `mode?: "list" | "none"`: `"list"` (the default): the suggestions are filtered by what is typed. `"none"`: they are as the caller draws them.
109
+ - `filter?: ((label: string, query: string) => boolean) | null`: Whether a suggestion is shown for what was typed; `null` shows every one.
110
+ - `openOnInputClick?: boolean`: Whether a press on the input opens the list. Default: it opens when something is typed.
111
+ - `disabled?: boolean`
112
+ - `required?: boolean`
113
+ - `name?: string`: The input's name in the form around it.
114
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
115
+ - `virtualized?: ListCollection`: Every row, when only some are in the page: each item is then given its `index`.
116
+
117
+ Attributes and CSS variables, by part:
118
+
119
+ - input: The text input: its text is the value, and what is typed asks for suggestions.
120
+ - `data-popup-open`: Present when the list is open.
121
+ - `data-disabled`: Present when it is disabled.
122
+ - trigger: A button that opens and closes the list.
123
+ - `data-popup-open`: Present when the list is open.
124
+ - `data-disabled`: Present when it is disabled.
125
+ - positioner: Places the list against the input. It carries the geometry.
126
+ - `data-open`: Present when it is open.
127
+ - `data-closed`: Present when it is closed.
128
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
129
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
130
+ - `--anchor-width`: The anchor's width.
131
+ - `--anchor-height`: The anchor's height.
132
+ - `--available-width`: The width between the anchor and the edge of the viewport.
133
+ - `--available-height`: The height between the anchor and the edge of the viewport.
134
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
135
+ - popup: The list of items.
136
+ - `data-open`: Present when it is open.
137
+ - `data-closed`: Present when it is closed.
138
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
139
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
140
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
141
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
142
+ - `data-empty`: Present when no item is shown for what was typed.
143
+ - item: One suggestion: chosen, its text is written into the input.
144
+ - `data-selected`: Present on the chosen item.
145
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
146
+ - `data-disabled`: Present when it is disabled.
147
+ - clear: A button that empties the input and the value.
148
+ - `data-disabled`: Present when it is disabled.
149
+
150
+ ### Autosize
151
+
152
+ ```
153
+ import { Autosize } from "@kirana-ui/solid/autosize"
154
+ ```
155
+
156
+ Parts: `<Autosize.Textarea>`.
157
+
158
+ Props of its root:
159
+
160
+ - `value?: unknown`: The text, when the caller holds it: a change that no key made (a form filled by code) is then measured too.
161
+
162
+ ### Avatar
163
+
164
+ ```
165
+ import { Avatar } from "@kirana-ui/solid/avatar"
166
+ ```
167
+
168
+ Parts: `<Avatar.Root>`, `<Avatar.Image>`, `<Avatar.Fallback>`.
169
+
170
+ ### Button
171
+
172
+ ```
173
+ import { Button } from "@kirana-ui/solid/button"
174
+ ```
175
+
176
+ Props:
177
+
178
+ - `disabled?: boolean`
179
+ - `focusableWhenDisabled?: boolean`: Keeps a disabled button in the tab order, so what it would do can still be read.
180
+ - `nativeButton?: boolean`: `false` when the element is not a `<button>`: it is given a button's role and keyboard.
181
+
182
+ Attributes and CSS variables, by part:
183
+
184
+ - root: The button.
185
+ - `data-disabled`: Present when it is disabled.
186
+
187
+ ### Calendar
188
+
189
+ ```
190
+ import { Calendar } from "@kirana-ui/solid/calendar"
191
+ ```
192
+
193
+ Parts: `<Calendar.Root>`, `<Calendar.Heading>`, `<Calendar.Previous>`, `<Calendar.Next>`, `<Calendar.Grid>`, `<Calendar.Weekdays>`, `<Calendar.HeadCell>`, `<Calendar.Weeks>`, `<Calendar.Cell>`, `<Calendar.Day>`.
194
+
195
+ Props of its root:
196
+
197
+ - `value?: CalendarValue`: One day, or with `mode: "range"` a first and a last day; `null` for none.
198
+ - `defaultValue?: CalendarValue`
199
+ - `onValueChange?: ((value: CalendarValue, details: ChangeDetails) => void)`
200
+ - `mode?: "single" | "range"`: Whether one day is chosen (the default) or a first and a last.
201
+ - `defaultFocusedValue?: IsoDate`: The day it opens on, when it has no value: its month is the one shown.
202
+ - `onMonthChange?: ((month: IsoDate) => void)`: Heard when another month is shown: its first day.
203
+ - `locale?: string`: The language and region its names, numbers, first day of the week and calendar follow (`"en-US"`, `"fa-IR"`). Give it: a server does not know the reader's.
204
+ - `calendarSystem?: CalendarSystem`: The calendar its months are laid out in, when it is not the Gregorian one: an instance from `@internationalized/date` (`new PersianCalendar()`). Given, not found from the locale: a page then carries only the calendars it uses.
205
+ - `min?: IsoDate`: The first and the last day that can be chosen.
206
+ - `max?: IsoDate`
207
+ - `isDateUnavailable?: ((date: IsoDate) => boolean)`: Days that cannot be chosen, though they can be reached: a day off, a day taken.
208
+ - `disabled?: boolean`
209
+ - `readOnly?: boolean`
210
+ - `fixedWeeks?: boolean`: Always six rows, so the calendar is one height in every month.
211
+
212
+ Attributes and CSS variables, by part:
213
+
214
+ - root: The calendar.
215
+ - `data-disabled`: Present when it is disabled.
216
+ - `data-readonly`: Present when its value cannot be changed.
217
+ - previous: Shows the month before.
218
+ - `data-disabled`: Present when it is disabled.
219
+ - next: Shows the month after.
220
+ - `data-disabled`: Present when it is disabled.
221
+ - cell: A day's cell.
222
+ - `data-selected`: Present on a chosen day, and on every day of a chosen range.
223
+ - `data-today`: Present on today.
224
+ - `data-outside-month`: Present on the days of the month before and after that fill the first and last weeks.
225
+ - `data-disabled`: Present when it is disabled.
226
+ - `data-unavailable`: Present on a day that cannot be chosen.
227
+ - `data-range-start`: Present on the first day of a range.
228
+ - `data-range-end`: Present on the last day of a range.
229
+ - day: The button for a day.
230
+ - `data-selected`: Present on a chosen day, and on every day of a chosen range.
231
+ - `data-today`: Present on today.
232
+ - `data-outside-month`: Present on the days of the month before and after that fill the first and last weeks.
233
+ - `data-disabled`: Present when it is disabled.
234
+ - `data-unavailable`: Present on a day that cannot be chosen.
235
+ - `data-range-start`: Present on the first day of a range.
236
+ - `data-range-end`: Present on the last day of a range.
237
+
238
+ ### Carousel
239
+
240
+ ```
241
+ import { Carousel } from "@kirana-ui/solid/carousel"
242
+ ```
243
+
244
+ Parts: `<Carousel.Root>`, `<Carousel.Viewport>`, `<Carousel.Item>`, `<Carousel.Previous>`, `<Carousel.Next>`, `<Carousel.Indicator>`.
245
+
246
+ Props of its root:
247
+
248
+ - `index?: number`: Which slide is at the start of the view, from 0.
249
+ - `defaultIndex?: number`
250
+ - `onIndexChange?: ((index: number, details: ChangeDetails) => void)`
251
+ - `orientation?: Orientation`: Whether the slides go across (the default) or down.
252
+ - `loop?: boolean`: Whether going on from the last slide comes round to the first.
253
+
254
+ Attributes and CSS variables, by part:
255
+
256
+ - root: The carousel: a region, named by the caller.
257
+ - `data-orientation="horizontal | vertical"`: Whether the slides go across or down.
258
+ - viewport: What scrolls. The slides are its children; the design snaps them (`scroll-snap-type`) and says whether a step glides (`scroll-behavior`).
259
+ - `data-orientation="horizontal | vertical"`: Whether the slides go across or down.
260
+ - item: One slide.
261
+ - `data-orientation="horizontal | vertical"`: Whether the slides go across or down.
262
+ - `data-current`: Present on the slide the view is at, and on its button.
263
+ - previous: Goes back a slide.
264
+ - `data-disabled`: Present when it is disabled.
265
+ - next: Goes on a slide.
266
+ - `data-disabled`: Present when it is disabled.
267
+ - indicator: A button for one slide.
268
+ - `data-current`: Present on the slide the view is at, and on its button.
269
+
270
+ ### Checkbox
271
+
272
+ ```
273
+ import { Checkbox } from "@kirana-ui/solid/checkbox"
274
+ ```
275
+
276
+ Parts: `<Checkbox.Root>`, `<Checkbox.Indicator>`.
277
+
278
+ Props of its root:
279
+
280
+ - `checked?: boolean`
281
+ - `defaultChecked?: boolean`: Read once.
282
+ - `onCheckedChange?: ((checked: boolean, details: ChangeDetails) => void)`
283
+ - `disabled?: boolean`
284
+ - `readOnly?: boolean`: Shown as it is, focusable, not changeable.
285
+ - `required?: boolean`
286
+ - `name?: string`: With a name, the control is submitted with the form around it when it is checked.
287
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
288
+ - `value?: string`: What is submitted. Default `"on"`, as a native checkbox's.
289
+ - `indeterminate?: boolean`: Neither checked nor unchecked: a parent of boxes that disagree.
290
+
291
+ Attributes and CSS variables, by part:
292
+
293
+ - root: The box. It holds a hidden native checkbox, which a form and a label reach.
294
+ - `data-checked`: Present when it is checked.
295
+ - `data-unchecked`: Present when it is not checked.
296
+ - `data-indeterminate`: Present when it is neither checked nor unchecked.
297
+ - `data-disabled`: Present when it is disabled.
298
+ - `data-readonly`: Present when it can be read but not changed.
299
+ - `data-required`: Present when the form needs it.
300
+ - indicator: The mark. In the page while the box is checked or indeterminate.
301
+ - `data-checked`: Present when it is checked.
302
+ - `data-unchecked`: Present when it is not checked.
303
+ - `data-indeterminate`: Present when it is neither checked nor unchecked.
304
+ - `data-disabled`: Present when it is disabled.
305
+ - `data-readonly`: Present when it can be read but not changed.
306
+ - `data-required`: Present when the form needs it.
307
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
308
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
309
+
310
+ ### Collapsible
311
+
312
+ ```
313
+ import { Collapsible } from "@kirana-ui/solid/collapsible"
314
+ ```
315
+
316
+ Parts: `<Collapsible.Root>`, `<Collapsible.Trigger>`, `<Collapsible.Panel>`.
317
+
318
+ Props of its root:
319
+
320
+ - `open?: boolean`
321
+ - `defaultOpen?: boolean`: Read once.
322
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
323
+ - `disabled?: boolean`
324
+
325
+ Attributes and CSS variables, by part:
326
+
327
+ - root: Groups the trigger and the panel.
328
+ - `data-open`: Present when it is open.
329
+ - `data-closed`: Present when it is closed.
330
+ - `data-disabled`: Present when it is disabled.
331
+ - trigger: The button that opens and closes the panel.
332
+ - `data-panel-open`: Present when the panel is open.
333
+ - `data-disabled`: Present when it is disabled.
334
+ - panel: The content. In the page while open, and through its exit's motion.
335
+ - `data-open`: Present when it is open.
336
+ - `data-closed`: Present when it is closed.
337
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
338
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
339
+ - `--collapsible-panel-height`: The panel's content height while it opens or closes, `auto` once it is open.
340
+ - `--collapsible-panel-width`: The panel's content width while it opens or closes, `auto` once it is open.
341
+
342
+ ### Combobox
343
+
344
+ ```
345
+ import { Combobox } from "@kirana-ui/solid/combobox"
346
+ ```
347
+
348
+ Parts: `<Combobox.Root>`, `<Combobox.Input>`, `<Combobox.Trigger>`, `<Combobox.Clear>`, `<Combobox.Chips>`, `<Combobox.Chip>`, `<Combobox.ChipRemove>`, `<Combobox.Portal>`, `<Combobox.Positioner>`, `<Combobox.Popup>`, `<Combobox.Group>`, `<Combobox.GroupLabel>`, `<Combobox.Separator>`, `<Combobox.Item>`, `<Combobox.ItemIndicator>`, `<Combobox.Empty>`.
349
+
350
+ Props of its root:
351
+
352
+ - `value?: Value | null`: The chosen value; `null` is "none".
353
+ - `defaultValue?: Value | null`
354
+ - `onValueChange?: ((value: Value | null, details: ChangeDetails) => void)`
355
+ - `inputValue?: string`: What the input says.
356
+ - `defaultInputValue?: string`
357
+ - `onInputValueChange?: ((value: string, details: ChangeDetails) => void)`
358
+ - `open?: boolean`
359
+ - `defaultOpen?: boolean`
360
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
361
+ - `disabled?: boolean`
362
+ - `name?: string`: With a name, the value is submitted with the form around it.
363
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
364
+ - `items?: readonly { value: Value; label: string }[]`: The labels of the values, for the input to show a value before the list has ever been opened. Not needed for the list itself: its items are read from the markup.
365
+ - `filter?: ((label: string, query: string) => boolean) | null`: Whether an item is shown for what was typed. Default: its label holds the text, without regard to case. `null`: every item is shown, and the caller draws the ones it wants.
366
+ - `multiple?: boolean`: Several values, each shown as a chip beside the input: an item chosen is added, chosen again taken away, and the list stays open. The values are `values`, not `value`.
367
+ - `values?: readonly Value[]`
368
+ - `defaultValues?: readonly Value[]`
369
+ - `onValuesChange?: ((values: Value[], details: ChangeDetails) => void)`
370
+ - `required?: boolean`: In a field, "none" is then wrong.
371
+ - `inline?: boolean`: The list is always in the page, under the input, with no popup: a command palette. An item chosen is told to the caller, and the input keeps what was typed.
372
+ - `virtualized?: ListCollection`: Every row, when only some are in the page (a virtualizer draws the ones in view). The caller then filters: the collection is what is left, and each item is given its `index`.
373
+
374
+ Attributes and CSS variables, by part:
375
+
376
+ - input: The text input. What is typed filters the list, which is placed against it.
377
+ - `data-popup-open`: Present when the list is open.
378
+ - `data-disabled`: Present when it is disabled.
379
+ - trigger: A button that opens and closes the list.
380
+ - `data-popup-open`: Present when the list is open.
381
+ - `data-disabled`: Present when it is disabled.
382
+ - positioner: Places the list against the input. It carries the geometry.
383
+ - `data-open`: Present when it is open.
384
+ - `data-closed`: Present when it is closed.
385
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
386
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
387
+ - `--anchor-width`: The anchor's width.
388
+ - `--anchor-height`: The anchor's height.
389
+ - `--available-width`: The width between the anchor and the edge of the viewport.
390
+ - `--available-height`: The height between the anchor and the edge of the viewport.
391
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
392
+ - popup: The list of items.
393
+ - `data-open`: Present when it is open.
394
+ - `data-closed`: Present when it is closed.
395
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
396
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
397
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
398
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
399
+ - `data-empty`: Present when no item is shown for what was typed.
400
+ - item: One choice in the list.
401
+ - `data-selected`: Present on the chosen item.
402
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
403
+ - `data-disabled`: Present when it is disabled.
404
+ - clear: A button that empties the input and the value.
405
+ - `data-disabled`: Present when it is disabled.
406
+ - chipRemove: A chip's button that takes its value away.
407
+ - `data-disabled`: Present when it is disabled.
408
+
409
+ ### Command
410
+
411
+ ```
412
+ import { Command } from "@kirana-ui/solid/command"
413
+ ```
414
+
415
+ Parts: `<Command.Root>`, `<Command.Input>`, `<Command.List>`, `<Command.Empty>`, `<Command.Group>`, `<Command.GroupHeading>`, `<Command.Item>`, `<Command.Separator>`.
416
+
417
+ Props of its root:
418
+
419
+ - `inputValue?: string`: What the input says.
420
+ - `defaultInputValue?: string`
421
+ - `onInputValueChange?: ((value: string, details: ChangeDetails) => void)`
422
+ - `onSelect?: ((value: string, details: ChangeDetails) => void)`: An item was chosen: pressed, or Enter while it was highlighted.
423
+ - `filter?: ((label: string, query: string, keywords: readonly string[]) => boolean) | null`: Whether an item is shown for what was typed. Default: its label or one of its keywords holds the text, without regard to case. `null`: every item is shown, and the caller draws the ones it wants.
424
+ - `loop?: boolean`: Whether a step past an end of the list goes round to the other.
425
+ - `disabled?: boolean`
426
+
427
+ Attributes and CSS variables, by part:
428
+
429
+ - root: A list of commands with the input that filters it.
430
+ - `data-disabled`: Present when it is disabled.
431
+ - input: The text input. What is typed filters the list; focus stays in it.
432
+ - `data-disabled`: Present when it is disabled.
433
+ - list: The commands.
434
+ - `data-empty`: Present when no item is shown for what was typed.
435
+ - item: One command.
436
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
437
+ - `data-disabled`: Present when it is disabled.
438
+
439
+ ### ContextMenu
440
+
441
+ ```
442
+ import { ContextMenu } from "@kirana-ui/solid/context-menu"
443
+ ```
444
+
445
+ Parts: `<ContextMenu.Root>`, `<ContextMenu.Trigger>`, `<ContextMenu.Portal>`, `<ContextMenu.Positioner>`, `<ContextMenu.Popup>`, `<ContextMenu.Arrow>`, `<ContextMenu.Item>`, `<ContextMenu.LinkItem>`, `<ContextMenu.Group>`, `<ContextMenu.GroupLabel>`, `<ContextMenu.Separator>`, `<ContextMenu.CheckboxItem>`, `<ContextMenu.CheckboxItemIndicator>`, `<ContextMenu.RadioGroup>`, `<ContextMenu.RadioItem>`, `<ContextMenu.RadioItemIndicator>`, `<ContextMenu.SubmenuRoot>`, `<ContextMenu.SubmenuTrigger>`.
446
+
447
+ Props of its root:
448
+
449
+ - `open?: boolean`
450
+ - `defaultOpen?: boolean`
451
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
452
+ - `disabled?: boolean`: The trigger cannot be pressed; a submenu's is passed over.
453
+ - `loop?: boolean`: Whether the arrows go round from the last item to the first. Default: they do.
454
+ - `modal?: boolean`: Holds the page while the menu is open: its scroll is locked, and a press outside closes the menu and reaches nothing. Default: it does not. Not for a submenu.
455
+
456
+ Attributes and CSS variables, by part:
457
+
458
+ - trigger: The area a secondary press, or a long press on a touch screen, opens the menu in.
459
+ - `data-popup-open`: Present when the menu is open.
460
+ - positioner: Places the menu against its trigger. It carries the geometry.
461
+ - `data-open`: Present when it is open.
462
+ - `data-closed`: Present when it is closed.
463
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
464
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
465
+ - `--anchor-width`: The anchor's width.
466
+ - `--anchor-height`: The anchor's height.
467
+ - `--available-width`: The width between the anchor and the edge of the viewport.
468
+ - `--available-height`: The height between the anchor and the edge of the viewport.
469
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
470
+ - popup: The menu itself: the list of items.
471
+ - `data-open`: Present when it is open.
472
+ - `data-closed`: Present when it is closed.
473
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
474
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
475
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
476
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
477
+ - arrow: An element that points at the trigger.
478
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
479
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
480
+ - `data-uncentered`: Present when the arrow cannot sit at the trigger's centre.
481
+ - item: An action. Choosing it closes the menu.
482
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
483
+ - `data-disabled`: Present when it is disabled.
484
+ - linkItem: An item that is a link. Choosing it follows the link and closes the menu.
485
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
486
+ - `data-disabled`: Present when it is disabled.
487
+ - checkboxItem: An item that is checked or not. Choosing it leaves the menu open.
488
+ - `data-checked`: Present when it is checked.
489
+ - `data-unchecked`: Present when it is not checked.
490
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
491
+ - `data-disabled`: Present when it is disabled.
492
+ - checkboxItemIndicator: A mark a checkbox item shows while it is checked.
493
+ - `data-checked`: Present when it is checked.
494
+ - `data-unchecked`: Present when it is not checked.
495
+ - radioGroup: Radio items of which one is chosen.
496
+ - `data-disabled`: Present when it is disabled.
497
+ - radioItem: One choice of a radio group. Choosing it leaves the menu open.
498
+ - `data-checked`: Present when it is checked.
499
+ - `data-unchecked`: Present when it is not checked.
500
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
501
+ - `data-disabled`: Present when it is disabled.
502
+ - radioItemIndicator: A mark a radio item shows while it is the chosen one.
503
+ - `data-checked`: Present when it is checked.
504
+ - `data-unchecked`: Present when it is not checked.
505
+ - submenuTrigger: An item that opens a menu beside it.
506
+ - `data-popup-open`: Present when its menu is open.
507
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
508
+ - `data-disabled`: Present when it is disabled.
509
+
510
+ ### DateField
511
+
512
+ ```
513
+ import { DateField } from "@kirana-ui/solid/date-field"
514
+ ```
515
+
516
+ Parts: `<DateField.Root>`, `<DateField.Segments>`, `<DateField.Segment>`, `<DateField.Input>`.
517
+
518
+ Props of its root:
519
+
520
+ - `value?: IsoDate | null`: The day typed, once all of it is; `null` until then.
521
+ - `defaultValue?: IsoDate | null`
522
+ - `onValueChange?: ((value: IsoDate | null, details: ChangeDetails) => void)`
523
+ - `locale?: string`: The language and region that order the day, the month and the year and put what stands between them (`"en-US"`: month/day/year). Give it: a server does not know the reader's.
524
+ - `min?: IsoDate`: The first and the last day it takes: outside them it says it is invalid.
525
+ - `max?: IsoDate`
526
+ - `placeholders?: Partial<Record<DateUnit, string>>`: What an empty part shows. Default: `dd`, `mm`, `yyyy`.
527
+ - `disabled?: boolean`
528
+ - `readOnly?: boolean`
529
+ - `required?: boolean`
530
+ - `name?: string`: The name it is submitted under, by its hidden input.
531
+ - `form?: string`: The id of the form it belongs to, when it is not inside it.
532
+
533
+ Attributes and CSS variables, by part:
534
+
535
+ - root: The field: a group of the date's parts.
536
+ - `data-disabled`: Present when it is disabled.
537
+ - `data-readonly`: Present when its value cannot be changed.
538
+ - `data-invalid`: Present when the date is outside what it takes, or is asked for and half typed.
539
+ - segment: One piece of the date: a part that is typed, or what stands between two.
540
+ - `data-segment="day | month | year | literal"`: Which piece it is.
541
+ - `data-placeholder`: Present on a part that is empty.
542
+ - `data-disabled`: Present when it is disabled.
543
+ - `data-invalid`: Present when the date is outside what it takes, or is asked for and half typed.
544
+
545
+ ### DatePicker
546
+
547
+ ```
548
+ import { DatePicker } from "@kirana-ui/solid/date-picker"
549
+ ```
550
+
551
+ Parts: `<DatePicker.Root>`, `<DatePicker.Field>`, `<DatePicker.Segments>`, `<DatePicker.Segment>`, `<DatePicker.Input>`, `<DatePicker.Trigger>`, `<DatePicker.Portal>`, `<DatePicker.Positioner>`, `<DatePicker.Popup>`, `<DatePicker.Calendar>`, `<DatePicker.Heading>`, `<DatePicker.Previous>`, `<DatePicker.Next>`, `<DatePicker.Grid>`, `<DatePicker.Weekdays>`, `<DatePicker.HeadCell>`, `<DatePicker.Weeks>`, `<DatePicker.Cell>`, `<DatePicker.Day>`.
552
+
553
+ Props of its root:
554
+
555
+ - `value?: IsoDate | null`: The day, typed or picked; `null` for none.
556
+ - `defaultValue?: IsoDate | null`
557
+ - `onValueChange?: ((value: IsoDate | null, details: ChangeDetails) => void)`
558
+ - `open?: boolean`
559
+ - `defaultOpen?: boolean`
560
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
561
+ - `locale?: string`: The language and region of the field and the calendar. Give it: a server does not know.
562
+ - `min?: IsoDate`: The first and the last day that can be typed or picked.
563
+ - `max?: IsoDate`
564
+ - `isDateUnavailable?: CalendarProps["isDateUnavailable"]`: Days that cannot be picked in the calendar.
565
+ - `calendarSystem?: CalendarProps["calendarSystem"]`: The calendar its months are laid out in, when it is not the Gregorian one.
566
+ - `fixedWeeks?: boolean`: Always six rows of days.
567
+ - `placeholders?: DateFieldProps["placeholders"]`: What an empty part of the field shows.
568
+ - `disabled?: boolean`
569
+ - `readOnly?: boolean`
570
+ - `required?: boolean`
571
+ - `name?: string`: The name it is submitted under.
572
+ - `form?: string`: The id of the form it belongs to, when it is not inside it.
573
+
574
+ Attributes and CSS variables, by part:
575
+
576
+ - field: The field: a group of the date's parts.
577
+ - `data-disabled`: Present when it is disabled.
578
+ - `data-readonly`: Present when its value cannot be changed.
579
+ - `data-invalid`: Present when the date is outside what it takes, or is asked for and half typed.
580
+ - segment: One piece of the date: a part that is typed, or what stands between two.
581
+ - `data-segment="day | month | year | literal"`: Which piece it is.
582
+ - `data-placeholder`: Present on a part that is empty.
583
+ - `data-disabled`: Present when it is disabled.
584
+ - `data-invalid`: Present when the date is outside what it takes, or is asked for and half typed.
585
+ - trigger: The button that opens the popover, and what it is placed against.
586
+ - `data-popup-open`: Present when the popover is open.
587
+ - positioner: Places the popup against the trigger. It carries the geometry.
588
+ - `data-open`: Present when it is open.
589
+ - `data-closed`: Present when it is closed.
590
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
591
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
592
+ - `--anchor-width`: The anchor's width.
593
+ - `--anchor-height`: The anchor's height.
594
+ - `--available-width`: The width between the anchor and the edge of the viewport.
595
+ - `--available-height`: The height between the anchor and the edge of the viewport.
596
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
597
+ - popup: The popover itself.
598
+ - `data-open`: Present when it is open.
599
+ - `data-closed`: Present when it is closed.
600
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
601
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
602
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
603
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
604
+ - calendar: The calendar.
605
+ - `data-disabled`: Present when it is disabled.
606
+ - `data-readonly`: Present when its value cannot be changed.
607
+ - previous: Shows the month before.
608
+ - `data-disabled`: Present when it is disabled.
609
+ - next: Shows the month after.
610
+ - `data-disabled`: Present when it is disabled.
611
+ - cell: A day's cell.
612
+ - `data-selected`: Present on a chosen day, and on every day of a chosen range.
613
+ - `data-today`: Present on today.
614
+ - `data-outside-month`: Present on the days of the month before and after that fill the first and last weeks.
615
+ - `data-disabled`: Present when it is disabled.
616
+ - `data-unavailable`: Present on a day that cannot be chosen.
617
+ - `data-range-start`: Present on the first day of a range.
618
+ - `data-range-end`: Present on the last day of a range.
619
+ - day: The button for a day.
620
+ - `data-selected`: Present on a chosen day, and on every day of a chosen range.
621
+ - `data-today`: Present on today.
622
+ - `data-outside-month`: Present on the days of the month before and after that fill the first and last weeks.
623
+ - `data-disabled`: Present when it is disabled.
624
+ - `data-unavailable`: Present on a day that cannot be chosen.
625
+ - `data-range-start`: Present on the first day of a range.
626
+ - `data-range-end`: Present on the last day of a range.
627
+
628
+ ### Dialog
629
+
630
+ ```
631
+ import { Dialog } from "@kirana-ui/solid/dialog"
632
+ ```
633
+
634
+ Parts: `<Dialog.Root>`, `<Dialog.Trigger>`, `<Dialog.Portal>`, `<Dialog.Backdrop>`, `<Dialog.Popup>`, `<Dialog.Title>`, `<Dialog.Description>`, `<Dialog.Close>`.
635
+
636
+ Props of its root:
637
+
638
+ - `open?: boolean`
639
+ - `defaultOpen?: boolean`
640
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
641
+ - `modal?: boolean`: Blocks the page behind it and traps focus. Default `true`.
642
+ - `dismissible?: boolean`: Whether a press outside closes it. Default `true`.
643
+
644
+ Attributes and CSS variables, by part:
645
+
646
+ - trigger: The button that opens the dialog.
647
+ - `data-popup-open`: Present when the dialog is open.
648
+ - backdrop: The layer over the page behind the dialog.
649
+ - `data-open`: Present when it is open.
650
+ - `data-closed`: Present when it is closed.
651
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
652
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
653
+ - popup: The dialog itself.
654
+ - `data-open`: Present when it is open.
655
+ - `data-closed`: Present when it is closed.
656
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
657
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
658
+ - `data-nested-dialog-open`: Present when another dialog is open above this one.
659
+ - `--nested-dialogs`: How many dialogs are open above this one.
660
+
661
+ ### DirectionProvider
662
+
663
+ ```
664
+ import { DirectionProvider } from "@kirana-ui/solid/direction-provider"
665
+ ```
666
+
667
+ ### Drawer
668
+
669
+ ```
670
+ import { Drawer } from "@kirana-ui/solid/drawer"
671
+ ```
672
+
673
+ Parts: `<Drawer.Root>`, `<Drawer.Trigger>`, `<Drawer.Portal>`, `<Drawer.Backdrop>`, `<Drawer.Popup>`, `<Drawer.Title>`, `<Drawer.Description>`, `<Drawer.Close>`.
674
+
675
+ Props of its root:
676
+
677
+ - `open?: boolean`
678
+ - `defaultOpen?: boolean`
679
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
680
+ - `modal?: boolean`: Blocks the page behind it and traps focus. Default `true`.
681
+ - `dismissible?: boolean`: Whether a press outside closes it. Default `true`.
682
+ - `swipeDirection?: DrawerSide`: The way it is dragged to close it: the edge it came from. Default: `"down"`.
683
+ - `snapPoints?: readonly DrawerSnapPoint[]`: Places it rests at, each how much of itself shows: a share (`0.4`, or `"40%"`) or a length (`"148px"`, `"20rem"`). `[0.4, 1]` is a drawer that opens two fifths shown and is dragged up to the whole. Without any, it is whole.
684
+ - `snapPoint?: DrawerSnapPoint`: Which of them it rests at, as it was given.
685
+ - `defaultSnapPoint?: DrawerSnapPoint`: Where it opens. Default: the smallest.
686
+ - `onSnapPointChange?: ((snapPoint: DrawerSnapPoint, details: ChangeDetails) => void)`
687
+
688
+ Attributes and CSS variables, by part:
689
+
690
+ - trigger: The button that opens the dialog.
691
+ - `data-popup-open`: Present when the dialog is open.
692
+ - backdrop: The layer over the page behind the dialog.
693
+ - `data-open`: Present when it is open.
694
+ - `data-closed`: Present when it is closed.
695
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
696
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
697
+ - `data-swiping`: Present while the drawer is dragged.
698
+ - `--drawer-swipe-movement-x`: How far it has been dragged across.
699
+ - `--drawer-swipe-movement-y`: How far it has been dragged up or down.
700
+ - `--drawer-swipe-progress`: How far it has been dragged, of its own size: 0 to 1.
701
+ - `--drawer-snap-point-offset`: How far from whole it rests, towards the edge it closes at: 0px at its largest snap point.
702
+ - popup: The drawer. A design moves it by what it says of the drag, and gives it `touch-action: none` where a finger drags it.
703
+ - `data-open`: Present when it is open.
704
+ - `data-closed`: Present when it is closed.
705
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
706
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
707
+ - `data-nested-dialog-open`: Present when another dialog is open above this one.
708
+ - `data-swiping`: Present while the drawer is dragged.
709
+ - `data-swipe-direction="up | down | left | right"`: The way it is dragged to close it.
710
+ - `data-swipe-dismiss`: Present once a drag has closed it.
711
+ - `data-expanded`: Present while it rests whole, of several snap points.
712
+ - `data-nested-drawer-open`: Present while another drawer is open over it.
713
+ - `data-nested-drawer-swiping`: Present while a drawer over it is dragged.
714
+ - `--nested-dialogs`: How many dialogs are open above this one.
715
+ - `--drawer-swipe-movement-x`: How far it has been dragged across.
716
+ - `--drawer-swipe-movement-y`: How far it has been dragged up or down.
717
+ - `--drawer-swipe-progress`: How far it has been dragged, of its own size: 0 to 1.
718
+ - `--drawer-snap-point-offset`: How far from whole it rests, towards the edge it closes at: 0px at its largest snap point.
719
+ - `--drawer-height`: Its height.
720
+ - `--nested-drawers`: How many drawers are open over it.
721
+ - `--drawer-frontmost-height`: The height of the drawer in front of every other, while this one is open.
722
+ - `--drawer-swipe-strength`: Once let go: 0.1 to 1, the share of the design's own time it should take to come to rest. A drawer thrown hard arrives sooner.
723
+ - `--drawer-width`: Its width.
724
+
725
+ ### Field
726
+
727
+ ```
728
+ import { Field } from "@kirana-ui/solid/field"
729
+ ```
730
+
731
+ Parts: `<Field.Root>`, `<Field.Label>`, `<Field.Control>`, `<Field.Description>`, `<Field.Error>`, `<Field.Validity>`.
732
+
733
+ Props of its root:
734
+
735
+ - `name?: string`: The control's name in the form.
736
+ - `disabled?: boolean`
737
+ - `invalid?: boolean`: Invalid whatever the value: an error known from elsewhere.
738
+ - `validate?: | (( value: string ) => string | readonly string[] | null | Promise<string | readonly string[] | null>)`: The field's own check, after the browser's: a message or several when the value is wrong, `null` when it is right. It may answer later, with a promise.
739
+ - `validationMode?: ValidationMode`: When the value is checked; the form's by default, else `"onSubmit"`.
740
+ - `validationDebounceTime?: number`: With `"onChange"`, how long the value must rest before it is checked, in milliseconds.
741
+
742
+ Attributes and CSS variables, by part:
743
+
744
+ - root: A control with its label, its description and its errors.
745
+ - `data-disabled`: Present when it is disabled.
746
+ - `data-touched`: Present once focus has left the control.
747
+ - `data-dirty`: Present while the value is not the one it started with.
748
+ - `data-filled`: Present while the control has a value.
749
+ - `data-focused`: Present while the control has focus.
750
+ - `data-valid`: Present once the value has been checked and found right.
751
+ - `data-invalid`: Present while the value is wrong.
752
+ - label: The control's name: a press on it reaches the control.
753
+ - `data-disabled`: Present when it is disabled.
754
+ - `data-touched`: Present once focus has left the control.
755
+ - `data-dirty`: Present while the value is not the one it started with.
756
+ - `data-filled`: Present while the control has a value.
757
+ - `data-focused`: Present while the control has focus.
758
+ - `data-valid`: Present once the value has been checked and found right.
759
+ - `data-invalid`: Present while the value is wrong.
760
+ - control: The control: an input, a textarea or a select.
761
+ - `data-disabled`: Present when it is disabled.
762
+ - `data-touched`: Present once focus has left the control.
763
+ - `data-dirty`: Present while the value is not the one it started with.
764
+ - `data-filled`: Present while the control has a value.
765
+ - `data-focused`: Present while the control has focus.
766
+ - `data-valid`: Present once the value has been checked and found right.
767
+ - `data-invalid`: Present while the value is wrong.
768
+ - description: More about the control, said after its name.
769
+ - `data-disabled`: Present when it is disabled.
770
+ - `data-touched`: Present once focus has left the control.
771
+ - `data-dirty`: Present while the value is not the one it started with.
772
+ - `data-filled`: Present while the control has a value.
773
+ - `data-focused`: Present while the control has focus.
774
+ - `data-valid`: Present once the value has been checked and found right.
775
+ - `data-invalid`: Present while the value is wrong.
776
+ - error: What is wrong with the value. In the page while it applies.
777
+ - `data-disabled`: Present when it is disabled.
778
+ - `data-touched`: Present once focus has left the control.
779
+ - `data-dirty`: Present while the value is not the one it started with.
780
+ - `data-filled`: Present while the control has a value.
781
+ - `data-focused`: Present while the control has focus.
782
+ - `data-valid`: Present once the value has been checked and found right.
783
+ - `data-invalid`: Present while the value is wrong.
784
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
785
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
786
+
787
+ ### Fieldset
788
+
789
+ ```
790
+ import { Fieldset } from "@kirana-ui/solid/fieldset"
791
+ ```
792
+
793
+ Parts: `<Fieldset.Root>`, `<Fieldset.Legend>`.
794
+
795
+ Props of its root:
796
+
797
+ - `disabled?: boolean`: Disables every field inside.
798
+
799
+ Attributes and CSS variables, by part:
800
+
801
+ - root: The group of fields.
802
+ - `data-disabled`: Present when it is disabled.
803
+ - legend: The group's name.
804
+ - `data-disabled`: Present when it is disabled.
805
+
806
+ ### Form
807
+
808
+ ```
809
+ import { Form } from "@kirana-ui/solid/form"
810
+ ```
811
+
812
+ Props:
813
+
814
+ - `errors?: FormErrors`: Errors from outside the page (a server's), by field name. A field shows its own until its value changes.
815
+ - `onClearErrors?: ((errors: FormErrors) => void)`: A field's value changed while it showed an error from `errors`: what is left of them.
816
+ - `onFormSubmit?: ((values: FormValues, details: ChangeDetails) => void)`: Every field is valid. Given this, the page is not left: the values come as an object. Without it, the form submits as a form does.
817
+ - `validationMode?: ValidationMode`: When the form's fields check their values, unless a field says otherwise. Default `"onSubmit"`.
818
+
819
+ ### HoverCard
820
+
821
+ ```
822
+ import { HoverCard } from "@kirana-ui/solid/hover-card"
823
+ ```
824
+
825
+ Parts: `<HoverCard.Root>`, `<HoverCard.Trigger>`, `<HoverCard.Portal>`, `<HoverCard.Positioner>`, `<HoverCard.Popup>`, `<HoverCard.Arrow>`.
826
+
827
+ Props of its root:
828
+
829
+ - `open?: boolean`
830
+ - `defaultOpen?: boolean`
831
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
832
+ - `delay?: number`: How long the pointer rests on the trigger before the popup opens, in milliseconds.
833
+ - `closeDelay?: number`: How long after the pointer leaves the popup closes, in milliseconds.
834
+ - `disabled?: boolean`
835
+
836
+ Attributes and CSS variables, by part:
837
+
838
+ - trigger: The link the card previews.
839
+ - `data-popup-open`: Present when the card is open.
840
+ - positioner: Places the popup against the trigger. It carries the geometry.
841
+ - `data-open`: Present when it is open.
842
+ - `data-closed`: Present when it is closed.
843
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
844
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
845
+ - `--anchor-width`: The anchor's width.
846
+ - `--anchor-height`: The anchor's height.
847
+ - `--available-width`: The width between the anchor and the edge of the viewport.
848
+ - `--available-height`: The height between the anchor and the edge of the viewport.
849
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
850
+ - popup: The card itself.
851
+ - `data-open`: Present when it is open.
852
+ - `data-closed`: Present when it is closed.
853
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
854
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
855
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
856
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
857
+ - `data-instant="delay | focus | dismiss"`: Present when it opened or closed without its usual wait, for a design that skips the motion then.
858
+ - arrow: An element that points at the trigger, placed along the popup's edge.
859
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
860
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
861
+ - `data-uncentered`: Present when the popup was pushed along its edge, so the arrow is not at the trigger's centre.
862
+
863
+ ### Input
864
+
865
+ ```
866
+ import { Input } from "@kirana-ui/solid/input"
867
+ ```
868
+
869
+ Props:
870
+
871
+ - `disabled?: boolean`
872
+ - `onValueChange?: ((value: string, details: ChangeDetails) => void)`: What was typed, as text, each time it changes.
873
+
874
+ Attributes and CSS variables, by part:
875
+
876
+ - input: A text input. Inside a field it is the field's control.
877
+ - `data-disabled`: Present when it is disabled.
878
+ - `data-touched`: Present once focus has left the input.
879
+ - `data-dirty`: Present while the value is not the one it started with.
880
+ - `data-filled`: Present while the input has a value.
881
+ - `data-focused`: Present while the input has focus.
882
+ - `data-valid`: In a field: present once the value was checked and found right.
883
+ - `data-invalid`: In a field: present while the value is wrong.
884
+
885
+ ### Label
886
+
887
+ ```
888
+ import { Label } from "@kirana-ui/solid/label"
889
+ ```
890
+
891
+ Attributes and CSS variables, by part:
892
+
893
+ - label: A control's name. Inside a field it is the field's label, with its states.
894
+ - `data-disabled`: Present when it is disabled.
895
+ - `data-touched`: Present once focus has left the control.
896
+ - `data-dirty`: Present while the value is not the one it started with.
897
+ - `data-filled`: Present while the control has a value.
898
+ - `data-focused`: Present while the control has focus.
899
+ - `data-valid`: Present once the value has been checked and found right.
900
+ - `data-invalid`: Present while the value is wrong.
901
+
902
+ ### Listbox
903
+
904
+ ```
905
+ import { Listbox } from "@kirana-ui/solid/listbox"
906
+ ```
907
+
908
+ Parts: `<Listbox.Root>`, `<Listbox.Item>`, `<Listbox.ItemIndicator>`, `<Listbox.Group>`, `<Listbox.GroupLabel>`.
909
+
910
+ Props of its root:
911
+
912
+ - `value?: readonly Value[]`: The chosen values: none, one, or with `multiple` several.
913
+ - `defaultValue?: readonly Value[]`
914
+ - `onValueChange?: ((value: Value[], details: ChangeDetails) => void)`
915
+ - `multiple?: boolean`: Whether more than one can be chosen: a press then adds or takes away.
916
+ - `disabled?: boolean`
917
+ - `loop?: boolean`: Whether the arrows go round from the last item to the first. Default: they do not.
918
+ - `name?: string`: With a name, the chosen values are submitted with the form around the list.
919
+ - `form?: string`: The id of the form the list belongs to, when it is not inside it.
920
+ - `virtualized?: ListCollection`: Every row, when only some are in the page (a virtualizer draws the ones in view): how many there are, their names, and how to bring one into the page. Each item is then given its `index`.
921
+
922
+ Attributes and CSS variables, by part:
923
+
924
+ - root: The list. It is one stop for Tab.
925
+ - `data-disabled`: Present when it is disabled.
926
+ - item: One choice in the list.
927
+ - `data-selected`: Present on a chosen item.
928
+ - `data-highlighted`: Present on the item the keyboard is on.
929
+ - `data-disabled`: Present when it is disabled.
930
+ - itemIndicator: A mark an item shows while it is chosen.
931
+ - `data-selected`: Present on a chosen item.
932
+
933
+ ### Menu
934
+
935
+ ```
936
+ import { Menu } from "@kirana-ui/solid/menu"
937
+ ```
938
+
939
+ Parts: `<Menu.Root>`, `<Menu.Trigger>`, `<Menu.Portal>`, `<Menu.Positioner>`, `<Menu.Popup>`, `<Menu.Arrow>`, `<Menu.Item>`, `<Menu.LinkItem>`, `<Menu.Group>`, `<Menu.GroupLabel>`, `<Menu.Separator>`, `<Menu.CheckboxItem>`, `<Menu.CheckboxItemIndicator>`, `<Menu.RadioGroup>`, `<Menu.RadioItem>`, `<Menu.RadioItemIndicator>`, `<Menu.SubmenuRoot>`, `<Menu.SubmenuTrigger>`.
940
+
941
+ Props of its root:
942
+
943
+ - `open?: boolean`
944
+ - `defaultOpen?: boolean`
945
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
946
+ - `disabled?: boolean`: The trigger cannot be pressed; a submenu's is passed over.
947
+ - `loop?: boolean`: Whether the arrows go round from the last item to the first. Default: they do.
948
+ - `modal?: boolean`: Holds the page while the menu is open: its scroll is locked, and a press outside closes the menu and reaches nothing. Default: it does not. Not for a submenu.
949
+
950
+ Attributes and CSS variables, by part:
951
+
952
+ - trigger: The button that opens the menu, and what it is placed against.
953
+ - `data-popup-open`: Present when the menu is open.
954
+ - `data-disabled`: Present when it is disabled.
955
+ - positioner: Places the menu against its trigger. It carries the geometry.
956
+ - `data-open`: Present when it is open.
957
+ - `data-closed`: Present when it is closed.
958
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
959
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
960
+ - `--anchor-width`: The anchor's width.
961
+ - `--anchor-height`: The anchor's height.
962
+ - `--available-width`: The width between the anchor and the edge of the viewport.
963
+ - `--available-height`: The height between the anchor and the edge of the viewport.
964
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
965
+ - popup: The menu itself: the list of items.
966
+ - `data-open`: Present when it is open.
967
+ - `data-closed`: Present when it is closed.
968
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
969
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
970
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
971
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
972
+ - arrow: An element that points at the trigger.
973
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
974
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
975
+ - `data-uncentered`: Present when the arrow cannot sit at the trigger's centre.
976
+ - item: An action. Choosing it closes the menu.
977
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
978
+ - `data-disabled`: Present when it is disabled.
979
+ - linkItem: An item that is a link. Choosing it follows the link and closes the menu.
980
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
981
+ - `data-disabled`: Present when it is disabled.
982
+ - checkboxItem: An item that is checked or not. Choosing it leaves the menu open.
983
+ - `data-checked`: Present when it is checked.
984
+ - `data-unchecked`: Present when it is not checked.
985
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
986
+ - `data-disabled`: Present when it is disabled.
987
+ - checkboxItemIndicator: A mark a checkbox item shows while it is checked.
988
+ - `data-checked`: Present when it is checked.
989
+ - `data-unchecked`: Present when it is not checked.
990
+ - radioGroup: Radio items of which one is chosen.
991
+ - `data-disabled`: Present when it is disabled.
992
+ - radioItem: One choice of a radio group. Choosing it leaves the menu open.
993
+ - `data-checked`: Present when it is checked.
994
+ - `data-unchecked`: Present when it is not checked.
995
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
996
+ - `data-disabled`: Present when it is disabled.
997
+ - radioItemIndicator: A mark a radio item shows while it is the chosen one.
998
+ - `data-checked`: Present when it is checked.
999
+ - `data-unchecked`: Present when it is not checked.
1000
+ - submenuTrigger: An item that opens a menu beside it.
1001
+ - `data-popup-open`: Present when its menu is open.
1002
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
1003
+ - `data-disabled`: Present when it is disabled.
1004
+
1005
+ ### Menubar
1006
+
1007
+ ```
1008
+ import { Menubar } from "@kirana-ui/solid/menubar"
1009
+ ```
1010
+
1011
+ Props:
1012
+
1013
+ - `loop?: boolean`: Whether the arrows go round from the last menu to the first. Default: they do.
1014
+ - `disabled?: boolean`: No menu of the bar opens.
1015
+ - `orientation?: Orientation`: A row (the default) or a column of menus. In a column a menu opens beside its trigger.
1016
+
1017
+ Attributes and CSS variables, by part:
1018
+
1019
+ - root: The row of menus. A menu inside it is one of its items.
1020
+ - `data-disabled`: Present when it is disabled.
1021
+ - `data-orientation="horizontal | vertical"`: Whether its menus are in a row or a column.
1022
+
1023
+ ### MessageScroller
1024
+
1025
+ ```
1026
+ import { MessageScroller } from "@kirana-ui/solid/message-scroller"
1027
+ ```
1028
+
1029
+ Parts: `<MessageScroller.Root>`, `<MessageScroller.Viewport>`, `<MessageScroller.Content>`, `<MessageScroller.Button>`.
1030
+
1031
+ Props of its root:
1032
+
1033
+ - `initial?: "bottom" | "top"`: Where it begins: at the newest message (the default), or at the first.
1034
+ - `threshold?: number`: How near the end counts as at it, in pixels. Default: 24.
1035
+ - `onAtBottomChange?: ((atBottom: boolean, details: ChangeDetails) => void)`: Heard when it comes to the end or leaves it.
1036
+
1037
+ Attributes and CSS variables, by part:
1038
+
1039
+ - root: What holds the conversation and its button.
1040
+ - `data-at-bottom`: Present while the newest message is in view.
1041
+ - viewport: What scrolls: a log, reached by the keyboard.
1042
+ - `data-at-bottom`: Present while the newest message is in view.
1043
+ - button: Goes to the newest message. Inert while that is in view.
1044
+ - `data-at-bottom`: Present while the newest message is in view.
1045
+
1046
+ ### Meter
1047
+
1048
+ ```
1049
+ import { Meter } from "@kirana-ui/solid/meter"
1050
+ ```
1051
+
1052
+ Parts: `<Meter.Root>`, `<Meter.Track>`, `<Meter.Indicator>`, `<Meter.Value>`, `<Meter.Label>`.
1053
+
1054
+ ### NavigationMenu
1055
+
1056
+ ```
1057
+ import { NavigationMenu } from "@kirana-ui/solid/navigation-menu"
1058
+ ```
1059
+
1060
+ Parts: `<NavigationMenu.Root>`, `<NavigationMenu.List>`, `<NavigationMenu.Item>`, `<NavigationMenu.Trigger>`, `<NavigationMenu.Icon>`, `<NavigationMenu.Content>`, `<NavigationMenu.Link>`, `<NavigationMenu.Portal>`, `<NavigationMenu.Positioner>`, `<NavigationMenu.Popup>`, `<NavigationMenu.Viewport>`, `<NavigationMenu.Arrow>`, `<NavigationMenu.Backdrop>`.
1061
+
1062
+ Props of its root:
1063
+
1064
+ - `value?: Value | null`: The item whose content is shown; `null` is "none".
1065
+ - `defaultValue?: Value | null`
1066
+ - `onValueChange?: ((value: Value | null, details: ChangeDetails) => void)`
1067
+ - `delay?: number`: How long the pointer rests on a trigger before its content shows, in milliseconds.
1068
+ - `closeDelay?: number`: How long after the pointer leaves the content goes, in milliseconds.
1069
+ - `orientation?: Orientation`
1070
+
1071
+ Attributes and CSS variables, by part:
1072
+
1073
+ - root: The navigation.
1074
+ - `data-orientation="horizontal | vertical"`: Whether the list is a row or a column.
1075
+ - list: The row of items.
1076
+ - `data-orientation="horizontal | vertical"`: Whether the list is a row or a column.
1077
+ - trigger: The button that shows an item's content.
1078
+ - `data-popup-open`: Present while the item's content is shown.
1079
+ - icon: A mark on a trigger that shows whether its content is open.
1080
+ - `data-popup-open`: Present while the item's content is shown.
1081
+ - content: What an item shows. It is drawn in the viewport every item shares.
1082
+ - `data-open`: Present when it is open.
1083
+ - `data-closed`: Present when it is closed.
1084
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1085
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1086
+ - `data-activation-direction="left | right"`: Which way it came from: the item before it, or after.
1087
+ - link: A link, in the list or in an item's content.
1088
+ - `data-active`: Present on the link of the page the reader is on.
1089
+ - positioner: Places the popup against the open item's trigger. It carries the geometry.
1090
+ - `data-open`: Present when it is open.
1091
+ - `data-closed`: Present when it is closed.
1092
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1093
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1094
+ - `--anchor-width`: The anchor's width.
1095
+ - `--anchor-height`: The anchor's height.
1096
+ - `--available-width`: The width between the anchor and the edge of the viewport.
1097
+ - `--available-height`: The height between the anchor and the edge of the viewport.
1098
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
1099
+ - `--positioner-width`: The open content's width.
1100
+ - `--positioner-height`: The open content's height.
1101
+ - popup: The panel every item's content is shown in.
1102
+ - `data-open`: Present when it is open.
1103
+ - `data-closed`: Present when it is closed.
1104
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1105
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1106
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1107
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1108
+ - `--popup-width`: The open content's width.
1109
+ - `--popup-height`: The open content's height.
1110
+ - arrow: An element that points at the open item's trigger.
1111
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1112
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1113
+ - `data-uncentered`: Present when the arrow cannot sit at the trigger's centre.
1114
+ - backdrop: An element behind the popup, for a design that dims the page.
1115
+ - `data-open`: Present when it is open.
1116
+ - `data-closed`: Present when it is closed.
1117
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1118
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1119
+
1120
+ ### NumberField
1121
+
1122
+ ```
1123
+ import { NumberField } from "@kirana-ui/solid/number-field"
1124
+ ```
1125
+
1126
+ Parts: `<NumberField.Root>`, `<NumberField.Group>`, `<NumberField.Input>`, `<NumberField.Increment>`, `<NumberField.Decrement>`.
1127
+
1128
+ Props of its root:
1129
+
1130
+ - `value?: number | null`: The number; `null` is "none".
1131
+ - `defaultValue?: number | null`
1132
+ - `onValueChange?: ((value: number | null, details: ChangeDetails) => void)`
1133
+ - `onValueCommitted?: ((value: number | null, details: ChangeDetails) => void)`: Heard once a change is done: focus left the input, a key or a button stepped it.
1134
+ - `min?: number`
1135
+ - `max?: number`
1136
+ - `step?: number`: What the buttons and the arrows move by. Default 1.
1137
+ - `smallStep?: number`: With Alt held. Default 0.1.
1138
+ - `largeStep?: number`: With Shift held. Default 10.
1139
+ - `snapOnStep?: boolean`: A step lands on a multiple of the step, counted from `min`.
1140
+ - `allowWheelScrub?: boolean`: The wheel steps it while the pointer is over the input and focus is in it.
1141
+ - `format?: Intl.NumberFormatOptions`: How the number is written.
1142
+ - `locale?: string`: The language it is written in; the page's by default.
1143
+ - `disabled?: boolean`
1144
+ - `readOnly?: boolean`
1145
+ - `required?: boolean`
1146
+ - `name?: string`: With a name, the number is submitted with the form around it.
1147
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
1148
+
1149
+ Attributes and CSS variables, by part:
1150
+
1151
+ - root: Groups the number field's parts.
1152
+ - `data-disabled`: Present when it is disabled.
1153
+ - `data-readonly`: Present when the number cannot be changed.
1154
+ - `data-required`: Present when a number must be given.
1155
+ - `data-touched`: Present once focus has left the input.
1156
+ - `data-dirty`: Present while the number is not the one it started with.
1157
+ - `data-filled`: Present while there is a number.
1158
+ - `data-focused`: Present while the input has focus.
1159
+ - `data-valid`: In a field: present once the number was checked and found right.
1160
+ - `data-invalid`: In a field: present while the number is wrong.
1161
+ - group: What holds the input and its buttons, as one control.
1162
+ - `data-disabled`: Present when it is disabled.
1163
+ - `data-readonly`: Present when the number cannot be changed.
1164
+ - `data-required`: Present when a number must be given.
1165
+ - `data-touched`: Present once focus has left the input.
1166
+ - `data-dirty`: Present while the number is not the one it started with.
1167
+ - `data-filled`: Present while there is a number.
1168
+ - `data-focused`: Present while the input has focus.
1169
+ - `data-valid`: In a field: present once the number was checked and found right.
1170
+ - `data-invalid`: In a field: present while the number is wrong.
1171
+ - input: The text input: it takes what its locale writes a number with.
1172
+ - `data-disabled`: Present when it is disabled.
1173
+ - `data-readonly`: Present when the number cannot be changed.
1174
+ - `data-required`: Present when a number must be given.
1175
+ - `data-touched`: Present once focus has left the input.
1176
+ - `data-dirty`: Present while the number is not the one it started with.
1177
+ - `data-filled`: Present while there is a number.
1178
+ - `data-focused`: Present while the input has focus.
1179
+ - `data-valid`: In a field: present once the number was checked and found right.
1180
+ - `data-invalid`: In a field: present while the number is wrong.
1181
+ - increment: A button that steps the number up. Held, it goes on.
1182
+ - `data-disabled`: Present when it is disabled.
1183
+ - `data-readonly`: Present when the number cannot be changed.
1184
+ - `data-required`: Present when a number must be given.
1185
+ - `data-touched`: Present once focus has left the input.
1186
+ - `data-dirty`: Present while the number is not the one it started with.
1187
+ - `data-filled`: Present while there is a number.
1188
+ - `data-focused`: Present while the input has focus.
1189
+ - `data-valid`: In a field: present once the number was checked and found right.
1190
+ - `data-invalid`: In a field: present while the number is wrong.
1191
+ - decrement: A button that steps the number down. Held, it goes on.
1192
+ - `data-disabled`: Present when it is disabled.
1193
+ - `data-readonly`: Present when the number cannot be changed.
1194
+ - `data-required`: Present when a number must be given.
1195
+ - `data-touched`: Present once focus has left the input.
1196
+ - `data-dirty`: Present while the number is not the one it started with.
1197
+ - `data-filled`: Present while there is a number.
1198
+ - `data-focused`: Present while the input has focus.
1199
+ - `data-valid`: In a field: present once the number was checked and found right.
1200
+ - `data-invalid`: In a field: present while the number is wrong.
1201
+
1202
+ ### Otp
1203
+
1204
+ ```
1205
+ import { Otp } from "@kirana-ui/solid/otp"
1206
+ ```
1207
+
1208
+ Parts: `<Otp.Root>`, `<Otp.Input>`, `<Otp.Group>`, `<Otp.Slot>`, `<Otp.Separator>`, `<Otp.Caret>`.
1209
+
1210
+ Props of its root:
1211
+
1212
+ - `length?: number`: How many characters the code has. Default: 6.
1213
+ - `value?: string`
1214
+ - `defaultValue?: string`
1215
+ - `onValueChange?: ((value: string, details: ChangeDetails) => void)`
1216
+ - `onComplete?: ((value: string) => void)`: Every character is in: the moment to send the code.
1217
+ - `mode?: "numeric" | "alphanumeric" | "text"`: What a character may be. Default: `numeric`.
1218
+ - `disabled?: boolean`
1219
+ - `name?: string`: With a name, the code is submitted with the form around it.
1220
+ - `form?: string`: The id of the form the input belongs to, when it is not inside it.
1221
+
1222
+ Attributes and CSS variables, by part:
1223
+
1224
+ - root: The code: the input and its cells.
1225
+ - `data-disabled`: Present when it is disabled.
1226
+ - `data-focused`: Present while the input has focus.
1227
+ - `data-complete`: Present when every character is in.
1228
+ - input: The one input the code is typed in. A design lays it over the cells, unseen.
1229
+ - `data-disabled`: Present when it is disabled.
1230
+ - slot: One cell of the code.
1231
+ - `data-index`: The cell's place, from 0.
1232
+ - `data-active`: Present on the cell the next character goes in, or that is selected.
1233
+ - `data-filled`: Present when the cell has its character.
1234
+ - `data-disabled`: Present when it is disabled.
1235
+
1236
+ ### Pagination
1237
+
1238
+ ```
1239
+ import { Pagination } from "@kirana-ui/solid/pagination"
1240
+ ```
1241
+
1242
+ Parts: `<Pagination.Root>`, `<Pagination.Items>`, `<Pagination.Item>`, `<Pagination.Ellipsis>`, `<Pagination.Previous>`, `<Pagination.Next>`.
1243
+
1244
+ Props of its root:
1245
+
1246
+ - `page?: number`: The page shown, from 1.
1247
+ - `defaultPage?: number`
1248
+ - `onPageChange?: ((page: number, details: ChangeDetails) => void)`
1249
+ - `count: number`: How many items there are in all.
1250
+ - `pageSize?: number`: How many items a page holds. Default 10.
1251
+ - `siblingCount?: number`: How many pages are listed each side of the one shown. Default 1.
1252
+ - `boundaryCount?: number`: How many pages are always listed at each end. Default 1.
1253
+ - `disabled?: boolean`
1254
+
1255
+ Attributes and CSS variables, by part:
1256
+
1257
+ - root: The pages of a list, as a navigation.
1258
+ - `data-disabled`: Present when it is disabled.
1259
+ - item: A page: pressed, it is the one shown.
1260
+ - `data-selected`: Present on the page that is shown.
1261
+ - `data-disabled`: Present when it is disabled.
1262
+ - previous: Goes to the page before.
1263
+ - `data-disabled`: Present when it is disabled.
1264
+ - next: Goes to the page after.
1265
+ - `data-disabled`: Present when it is disabled.
1266
+
1267
+ ### Popover
1268
+
1269
+ ```
1270
+ import { Popover } from "@kirana-ui/solid/popover"
1271
+ ```
1272
+
1273
+ Parts: `<Popover.Root>`, `<Popover.Trigger>`, `<Popover.Portal>`, `<Popover.Positioner>`, `<Popover.Popup>`, `<Popover.Title>`, `<Popover.Description>`, `<Popover.Close>`.
1274
+
1275
+ Props of its root:
1276
+
1277
+ - `open?: boolean`
1278
+ - `defaultOpen?: boolean`
1279
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
1280
+
1281
+ Attributes and CSS variables, by part:
1282
+
1283
+ - trigger: The button that opens the popover, and what it is placed against.
1284
+ - `data-popup-open`: Present when the popover is open.
1285
+ - positioner: Places the popup against the trigger. It carries the geometry.
1286
+ - `data-open`: Present when it is open.
1287
+ - `data-closed`: Present when it is closed.
1288
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1289
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1290
+ - `--anchor-width`: The anchor's width.
1291
+ - `--anchor-height`: The anchor's height.
1292
+ - `--available-width`: The width between the anchor and the edge of the viewport.
1293
+ - `--available-height`: The height between the anchor and the edge of the viewport.
1294
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
1295
+ - popup: The popover itself.
1296
+ - `data-open`: Present when it is open.
1297
+ - `data-closed`: Present when it is closed.
1298
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1299
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1300
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1301
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1302
+
1303
+ ### PortalProvider
1304
+
1305
+ ```
1306
+ import { PortalProvider } from "@kirana-ui/solid/portal-provider"
1307
+ ```
1308
+
1309
+ ### Progress
1310
+
1311
+ ```
1312
+ import { Progress } from "@kirana-ui/solid/progress"
1313
+ ```
1314
+
1315
+ Parts: `<Progress.Root>`, `<Progress.Track>`, `<Progress.Indicator>`, `<Progress.Value>`, `<Progress.Label>`.
1316
+
1317
+ Props of its root:
1318
+
1319
+ - `value: number | null`: The value. For a progress bar, `null` is "under way, how far is not known".
1320
+ - `min?: number`: Default 0.
1321
+ - `max?: number`: Default 100.
1322
+ - `format?: Intl.NumberFormatOptions`: How the value is written; a percentage of the range by default.
1323
+ - `locale?: string`: The language the value is written in; the page's by default.
1324
+ - `getAriaValueText?: ((text: string | undefined, value: number | null) => string)`: What assistive technology reads for the value, when the written value is not enough.
1325
+
1326
+ Attributes and CSS variables, by part:
1327
+
1328
+ - root: The progress bar: it says the value to assistive technology.
1329
+ - `data-progressing`: Present while the task is under way.
1330
+ - `data-complete`: Present once the value has reached the end of the range.
1331
+ - `data-indeterminate`: Present while how far the task has come is not known.
1332
+ - track: The whole range.
1333
+ - `data-progressing`: Present while the task is under way.
1334
+ - `data-complete`: Present once the value has reached the end of the range.
1335
+ - `data-indeterminate`: Present while how far the task has come is not known.
1336
+ - indicator: The filled part: its width is the value's share of the range.
1337
+ - `data-progressing`: Present while the task is under way.
1338
+ - `data-complete`: Present once the value has reached the end of the range.
1339
+ - `data-indeterminate`: Present while how far the task has come is not known.
1340
+ - value: The value, written.
1341
+ - `data-progressing`: Present while the task is under way.
1342
+ - `data-complete`: Present once the value has reached the end of the range.
1343
+ - `data-indeterminate`: Present while how far the task has come is not known.
1344
+ - label: The bar's name.
1345
+ - `data-progressing`: Present while the task is under way.
1346
+ - `data-complete`: Present once the value has reached the end of the range.
1347
+ - `data-indeterminate`: Present while how far the task has come is not known.
1348
+
1349
+ ### QrCode
1350
+
1351
+ ```
1352
+ import { QrCode } from "@kirana-ui/solid/qr-code"
1353
+ ```
1354
+
1355
+ Parts: `<QrCode.Root>`, `<QrCode.Frame>`, `<QrCode.Pattern>`.
1356
+
1357
+ Props of its root:
1358
+
1359
+ - `value: string`: What the code says: a link, a text. Written as UTF-8.
1360
+ - `correction?: QrCorrection`: How much of it may be lost and still be read. Default: `"M"`.
1361
+
1362
+ Attributes and CSS variables, by part:
1363
+
1364
+ - root: What holds the code.
1365
+ - `data-invalid`: Present when the value is longer than a code holds.
1366
+
1367
+ ### RadioGroup
1368
+
1369
+ ```
1370
+ import { RadioGroup } from "@kirana-ui/solid/radio-group"
1371
+ ```
1372
+
1373
+ Parts: `<RadioGroup.Root>`, `<RadioGroup.Item>`, `<RadioGroup.Indicator>`.
1374
+
1375
+ Props of its root:
1376
+
1377
+ - `value?: Value | null`: The chosen value; `null` is "none".
1378
+ - `defaultValue?: Value | null`
1379
+ - `onValueChange?: ((value: Value | null, details: ChangeDetails) => void)`: `null` only when a form's reset takes the group back to "none".
1380
+ - `disabled?: boolean`
1381
+ - `readOnly?: boolean`
1382
+ - `required?: boolean`
1383
+ - `name?: string`: With a name, the chosen value is submitted with the form around the group.
1384
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
1385
+
1386
+ Attributes and CSS variables, by part:
1387
+
1388
+ - root: Groups the items: one of them is chosen at most.
1389
+ - `data-disabled`: Present when it is disabled.
1390
+ - `data-readonly`: Present when it can be read but not changed.
1391
+ - `data-required`: Present when the form needs it.
1392
+ - item: One choice. It holds a hidden native radio, which a form and a label reach.
1393
+ - `data-checked`: Present when it is checked.
1394
+ - `data-unchecked`: Present when it is not checked.
1395
+ - `data-disabled`: Present when it is disabled.
1396
+ - `data-readonly`: Present when it can be read but not changed.
1397
+ - `data-required`: Present when the form needs it.
1398
+ - indicator: The mark. In the page while its item is the chosen one.
1399
+ - `data-checked`: Present when it is checked.
1400
+ - `data-unchecked`: Present when it is not checked.
1401
+ - `data-disabled`: Present when it is disabled.
1402
+ - `data-readonly`: Present when it can be read but not changed.
1403
+ - `data-required`: Present when the form needs it.
1404
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1405
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1406
+
1407
+ ### Resizable
1408
+
1409
+ ```
1410
+ import { Resizable } from "@kirana-ui/solid/resizable"
1411
+ ```
1412
+
1413
+ Parts: `<Resizable.Group>`, `<Resizable.Panel>`, `<Resizable.Handle>`.
1414
+
1415
+ Props of its root:
1416
+
1417
+ - `orientation?: Orientation`: Whether the panels are side by side (the default) or one over the other.
1418
+ - `onSizesChange?: ((sizes: number[], details: ChangeDetails) => void)`: Heard as the panels are resized: each panel's share, in the page's order, summing to 100.
1419
+ - `keyboardStep?: number`: How far an arrow key moves a handle, in hundredths of the group. Default: 10.
1420
+ - `disabled?: boolean`
1421
+
1422
+ Attributes and CSS variables, by part:
1423
+
1424
+ - group: The panels and the bars between them. A design lays it out as a flex box.
1425
+ - `data-orientation="horizontal | vertical"`: Whether the panels are side by side or one over the other.
1426
+ - `data-disabled`: Present when it is disabled.
1427
+ - panel: One panel. It carries its share of the group.
1428
+ - `data-orientation="horizontal | vertical"`: Whether the panels are side by side or one over the other.
1429
+ - `--panel-size`: The panel's share, in hundredths of the group.
1430
+ - handle: The bar between two panels: dragged, or moved with the arrows.
1431
+ - `data-orientation="horizontal | vertical"`: Whether the panels are side by side or one over the other.
1432
+ - `data-dragging`: Present while the bar is dragged.
1433
+ - `data-disabled`: Present when it is disabled.
1434
+
1435
+ ### ScrollArea
1436
+
1437
+ ```
1438
+ import { ScrollArea } from "@kirana-ui/solid/scroll-area"
1439
+ ```
1440
+
1441
+ Parts: `<ScrollArea.Root>`, `<ScrollArea.Viewport>`, `<ScrollArea.Content>`, `<ScrollArea.Scrollbar>`, `<ScrollArea.Thumb>`, `<ScrollArea.Corner>`.
1442
+
1443
+ Attributes and CSS variables, by part:
1444
+
1445
+ - root: The area. It holds the viewport and the scrollbars.
1446
+ - `data-has-overflow-x`: Present when there is more to see sideways.
1447
+ - `data-has-overflow-y`: Present when there is more to see up or down.
1448
+ - `data-scrolling`: Present while it is being scrolled, and a moment after.
1449
+ - `data-hovering`: Present while the pointer is over the area.
1450
+ - `--scroll-area-corner-width`: The width of the corner: the vertical scrollbar's.
1451
+ - `--scroll-area-corner-height`: The height of the corner: the horizontal scrollbar's.
1452
+ - viewport: The element that scrolls.
1453
+ - `data-has-overflow-x`: Present when there is more to see sideways.
1454
+ - `data-has-overflow-y`: Present when there is more to see up or down.
1455
+ - `data-scrolling`: Present while it is being scrolled, and a moment after.
1456
+ - scrollbar: A scrollbar's track. In the page while there is something to scroll its way.
1457
+ - `data-orientation="horizontal | vertical"`: Which way the scrollbar scrolls.
1458
+ - `data-hovering`: Present while the pointer is over the area.
1459
+ - `data-scrolling`: Present while the area is scrolled its way.
1460
+ - thumb: The part of a scrollbar that shows where the view is, and can be dragged.
1461
+ - `data-orientation="horizontal | vertical"`: Which way the scrollbar scrolls.
1462
+ - `--scroll-area-thumb-height`: A vertical thumb's height.
1463
+ - `--scroll-area-thumb-width`: A horizontal thumb's width.
1464
+
1465
+ ### Select
1466
+
1467
+ ```
1468
+ import { Select } from "@kirana-ui/solid/select"
1469
+ ```
1470
+
1471
+ Parts: `<Select.Root>`, `<Select.Trigger>`, `<Select.Value>`, `<Select.Portal>`, `<Select.Positioner>`, `<Select.Popup>`, `<Select.List>`, `<Select.ScrollUpArrow>`, `<Select.ScrollDownArrow>`, `<Select.Group>`, `<Select.GroupLabel>`, `<Select.Separator>`, `<Select.Item>`, `<Select.ItemText>`, `<Select.ItemIndicator>`.
1472
+
1473
+ Props of its root:
1474
+
1475
+ - `value?: Value | null`: The chosen value; `null` is "none".
1476
+ - `defaultValue?: Value | null`
1477
+ - `onValueChange?: ((value: Value | null, details: ChangeDetails) => void)`
1478
+ - `open?: boolean`
1479
+ - `defaultOpen?: boolean`
1480
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
1481
+ - `disabled?: boolean`
1482
+ - `required?: boolean`: In a field, "none" is then wrong.
1483
+ - `name?: string`: With a name, the value is submitted with the form around it.
1484
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
1485
+ - `items?: readonly { value: Value; label: string }[]`: The labels of the values, for the trigger to show before the list has ever been opened. Not needed for the list itself: its items are read from the markup.
1486
+ - `virtualized?: ListCollection`: Every row, when only some are in the page (a virtualizer draws the ones in view). Each item is then given its `index`.
1487
+
1488
+ Attributes and CSS variables, by part:
1489
+
1490
+ - trigger: The button that shows the value and opens the list.
1491
+ - `data-popup-open`: Present when the list is open.
1492
+ - `data-placeholder`: Present while nothing is chosen.
1493
+ - `data-disabled`: Present when it is disabled.
1494
+ - value: The chosen value's label, or the placeholder.
1495
+ - `data-placeholder`: Present while nothing is chosen.
1496
+ - positioner: Places the list against the trigger. It carries the geometry.
1497
+ - `data-open`: Present when it is open.
1498
+ - `data-closed`: Present when it is closed.
1499
+ - `data-side="top | right | bottom | left | none"`: The side of the trigger it is on, after any flip; `none` when it lies over the trigger.
1500
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1501
+ - `--anchor-width`: The anchor's width.
1502
+ - `--anchor-height`: The anchor's height.
1503
+ - `--available-width`: The width between the anchor and the edge of the viewport.
1504
+ - `--available-height`: The height between the anchor and the edge of the viewport.
1505
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
1506
+ - scrollUpArrow: In the page while there is more of the list above: it scrolls the list while the pointer moves over it.
1507
+ - `data-direction="up | down"`: The way it scrolls the list.
1508
+ - `data-visible`: Present while there is more of the list its way.
1509
+ - `data-side="top | right | bottom | left | none"`: The side of the trigger the list is on; `none` when it lies over the trigger.
1510
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1511
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1512
+ - scrollDownArrow: In the page while there is more of the list below: it scrolls the list while the pointer moves over it.
1513
+ - `data-direction="up | down"`: The way it scrolls the list.
1514
+ - `data-visible`: Present while there is more of the list its way.
1515
+ - `data-side="top | right | bottom | left | none"`: The side of the trigger the list is on; `none` when it lies over the trigger.
1516
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1517
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1518
+ - popup: The list of items.
1519
+ - `data-open`: Present when it is open.
1520
+ - `data-closed`: Present when it is closed.
1521
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1522
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1523
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1524
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1525
+ - item: One choice in the list.
1526
+ - `data-selected`: Present on the chosen item.
1527
+ - `data-highlighted`: Present on the item the pointer or the keyboard is on.
1528
+ - `data-disabled`: Present when it is disabled.
1529
+
1530
+ ### Separator
1531
+
1532
+ ```
1533
+ import { Separator } from "@kirana-ui/solid/separator"
1534
+ ```
1535
+
1536
+ Props:
1537
+
1538
+ - `orientation?: Orientation`
1539
+
1540
+ Attributes and CSS variables, by part:
1541
+
1542
+ - root: The line.
1543
+ - `data-orientation="horizontal | vertical"`: The way the line runs.
1544
+
1545
+ ### Slider
1546
+
1547
+ ```
1548
+ import { Slider } from "@kirana-ui/solid/slider"
1549
+ ```
1550
+
1551
+ Parts: `<Slider.Root>`, `<Slider.Value>`, `<Slider.Control>`, `<Slider.Track>`, `<Slider.Indicator>`, `<Slider.Thumb>`.
1552
+
1553
+ Props of its root:
1554
+
1555
+ - `value?: SliderValue`
1556
+ - `defaultValue?: SliderValue`: Read once. Default `min`.
1557
+ - `onValueChange?: ((value: number | number[], details: SliderChangeDetails) => void)`: Each step of a drag and each key.
1558
+ - `onValueCommitted?: ((value: number | number[], details: SliderChangeDetails) => void)`: When the pointer lets go, and after each key: the value to save.
1559
+ - `min?: number`: Default 0.
1560
+ - `max?: number`: Default 100.
1561
+ - `step?: number`: Default 1.
1562
+ - `largeStep?: number`: What Page Up, Page Down and an arrow with Shift move by. Default 10.
1563
+ - `minStepsBetweenValues?: number`: How many steps two thumbs of a range stay apart. Default 0.
1564
+ - `orientation?: Orientation`
1565
+ - `thumbAlignment?: "center" | "edge" | "edge-client-only"`: Where a thumb is at the ends of its range. `"center"` (the default): its centre on the control's edge, so half of it lies outside. `"edge"`: its edge on the control's edge, so it stays inside. `"edge-client-only"` is the same here: nothing waits for the browser.
1566
+ - `disabled?: boolean`
1567
+ - `name?: string`: With a name, each thumb's value is submitted with the form around the slider.
1568
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
1569
+ - `format?: Intl.NumberFormatOptions`: How a value is written.
1570
+ - `locale?: string`: The language a value is written in; the page's by default.
1571
+ - `getAriaValueText?: ((text: string, value: number, index: number) => string)`: What assistive technology reads for a thumb, when the written value is not enough.
1572
+
1573
+ Attributes and CSS variables, by part:
1574
+
1575
+ - root: Groups the slider's parts.
1576
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1577
+ - `data-disabled`: Present when it is disabled.
1578
+ - `data-dragging`: Present while a pointer holds a thumb.
1579
+ - value: The value, written.
1580
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1581
+ - `data-disabled`: Present when it is disabled.
1582
+ - `data-dragging`: Present while a pointer holds a thumb.
1583
+ - control: What a pointer presses and drags on. It holds the track and the thumbs.
1584
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1585
+ - `data-disabled`: Present when it is disabled.
1586
+ - `data-dragging`: Present while a pointer holds a thumb.
1587
+ - track: The whole range.
1588
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1589
+ - `data-disabled`: Present when it is disabled.
1590
+ - `data-dragging`: Present while a pointer holds a thumb.
1591
+ - indicator: The filled part: up to the thumb, or from the first thumb to the last. Its place and length are written on it.
1592
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1593
+ - `data-disabled`: Present when it is disabled.
1594
+ - `data-dragging`: Present while a pointer holds a thumb.
1595
+ - `--start-position`: With thumbs that stay inside the control: where the filled part starts, or with one thumb where it ends.
1596
+ - `--relative-size`: With thumbs that stay inside the control and a range: the filled part's length.
1597
+ - thumb: What is dragged, and what the keyboard moves: a slider to assistive technology. Its place on the track is written on it. It holds a hidden input, which a form reads.
1598
+ - `data-orientation="horizontal | vertical"`: The way the track runs.
1599
+ - `data-disabled`: Present when it is disabled.
1600
+ - `data-dragging`: Present while a pointer holds a thumb.
1601
+ - `data-index`: Which thumb it is, from 0.
1602
+ - `--position`: With thumbs that stay inside the control: where the thumb's centre is.
1603
+
1604
+ ### Switch
1605
+
1606
+ ```
1607
+ import { Switch } from "@kirana-ui/solid/switch"
1608
+ ```
1609
+
1610
+ Parts: `<Switch.Root>`, `<Switch.Thumb>`.
1611
+
1612
+ Props of its root:
1613
+
1614
+ - `checked?: boolean`
1615
+ - `defaultChecked?: boolean`: Read once.
1616
+ - `onCheckedChange?: ((checked: boolean, details: ChangeDetails) => void)`
1617
+ - `disabled?: boolean`
1618
+ - `readOnly?: boolean`: Shown as it is, focusable, not changeable.
1619
+ - `required?: boolean`
1620
+ - `name?: string`: With a name, the control is submitted with the form around it when it is checked.
1621
+ - `form?: string`: The id of the form the control belongs to, when it is not inside it.
1622
+ - `value?: string`: What is submitted. Default `"on"`, as a native checkbox's.
1623
+
1624
+ Attributes and CSS variables, by part:
1625
+
1626
+ - root: The track. It holds a hidden native checkbox, which a form and a label reach.
1627
+ - `data-checked`: Present when it is checked.
1628
+ - `data-unchecked`: Present when it is not checked.
1629
+ - `data-disabled`: Present when it is disabled.
1630
+ - `data-readonly`: Present when it can be read but not changed.
1631
+ - `data-required`: Present when the form needs it.
1632
+ - thumb: The knob that moves along the track.
1633
+ - `data-checked`: Present when it is checked.
1634
+ - `data-unchecked`: Present when it is not checked.
1635
+ - `data-disabled`: Present when it is disabled.
1636
+ - `data-readonly`: Present when it can be read but not changed.
1637
+ - `data-required`: Present when the form needs it.
1638
+
1639
+ ### Tabs
1640
+
1641
+ ```
1642
+ import { Tabs } from "@kirana-ui/solid/tabs"
1643
+ ```
1644
+
1645
+ Parts: `<Tabs.Root>`, `<Tabs.List>`, `<Tabs.Tab>`, `<Tabs.Indicator>`, `<Tabs.Panel>`.
1646
+
1647
+ Props of its root:
1648
+
1649
+ - `value?: Value | null`: The active tab's value; `null` is "none".
1650
+ - `defaultValue?: Value | null`: Read once. Without one, the first tab that can be chosen is, once the page is there.
1651
+ - `onValueChange?: ((value: Value, details: ChangeDetails) => void)`
1652
+ - `orientation?: Orientation`
1653
+
1654
+ Attributes and CSS variables, by part:
1655
+
1656
+ - root: Groups the tabs and their panels.
1657
+ - `data-orientation="horizontal | vertical"`: The way the tabs are laid out.
1658
+ - `data-activation-direction="left | right | up | down | none"`: Where the newly active tab is from the one before, for a panel or a mark that slides.
1659
+ - list: The row of tabs. The arrows move between them.
1660
+ - `data-orientation="horizontal | vertical"`: The way the tabs are laid out.
1661
+ - `data-activation-direction="left | right | up | down | none"`: Where the newly active tab is from the one before, for a panel or a mark that slides.
1662
+ - tab: A button that shows its panel.
1663
+ - `data-active`: Present on the tab whose panel is shown.
1664
+ - `data-disabled`: Present when it is disabled.
1665
+ - `data-orientation="horizontal | vertical"`: The way the tabs are laid out.
1666
+ - indicator: A mark for the active tab: it carries that tab's position and size.
1667
+ - `data-orientation="horizontal | vertical"`: The way the tabs are laid out.
1668
+ - `data-activation-direction="left | right | up | down | none"`: Where the newly active tab is from the one before, for a panel or a mark that slides.
1669
+ - `--active-tab-left`: The active tab's distance from the list's left edge.
1670
+ - `--active-tab-right`: The active tab's distance from the list's right edge.
1671
+ - `--active-tab-top`: The active tab's distance from the list's top edge.
1672
+ - `--active-tab-bottom`: The active tab's distance from the list's bottom edge.
1673
+ - `--active-tab-width`: The active tab's width.
1674
+ - `--active-tab-height`: The active tab's height.
1675
+ - panel: A tab's content. In the page while its tab is active, and through its exit.
1676
+ - `data-hidden`: Present while its tab is not the active one.
1677
+ - `data-orientation="horizontal | vertical"`: The way the tabs are laid out.
1678
+ - `data-activation-direction="left | right | up | down | none"`: Where the newly active tab is from the one before, for a panel or a mark that slides.
1679
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1680
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1681
+
1682
+ ### Toast
1683
+
1684
+ ```
1685
+ import { Toast } from "@kirana-ui/solid/toast"
1686
+ ```
1687
+
1688
+ Parts: `<Toast.Viewport>`, `<Toast.List>`, `<Toast.Root>`, `<Toast.Content>`, `<Toast.Title>`, `<Toast.Description>`, `<Toast.Close>`, `<Toast.Action>`.
1689
+
1690
+ Props of its root:
1691
+
1692
+ - `toaster: Toaster`
1693
+ - `label?: string`: What the region of toasts is called, for assistive technology.
1694
+ - `hotkey?: string`: The key that takes focus to the toasts. Default: `"F6"`.
1695
+ - `swipeDirection?: "left" | "right" | "up" | "down"`: The way a toast is dragged to close it. Default: `"right"`.
1696
+
1697
+ Attributes and CSS variables, by part:
1698
+
1699
+ - viewport: Where the toasts are drawn: a region that is always in the page.
1700
+ - `data-expanded`: Present while the pointer or focus is on the stack: the toasts are spread out, and wait.
1701
+ - `--toast-frontmost-height`: The height of the newest toast.
1702
+ - root: One toast.
1703
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1704
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1705
+ - `data-expanded`: Present while the pointer or focus is on the stack: the toasts are spread out, and wait.
1706
+ - `data-type`: The kind the toast was added as.
1707
+ - `data-limited`: Present on a toast behind as many as are shown at once.
1708
+ - `data-swiping`: Present while the toast is dragged.
1709
+ - `data-swipe-direction="left | right | up | down"`: The way the toast was dragged out, once it has been.
1710
+ - `--toast-index`: Its place in the stack: 0 for the newest.
1711
+ - `--toast-height`: Its height.
1712
+ - `--toast-offset-y`: The height of the toasts in front of it.
1713
+ - `--toast-swipe-movement-x`: How far it has been dragged across.
1714
+ - `--toast-swipe-movement-y`: How far it has been dragged up or down.
1715
+ - content: What holds a toast's contents, when the design sizes the toast itself.
1716
+ - `data-behind`: Present on a toast that is behind the newest.
1717
+ - `data-expanded`: Present while the pointer or focus is on the stack: the toasts are spread out, and wait.
1718
+
1719
+ ### Toggle
1720
+
1721
+ ```
1722
+ import { Toggle } from "@kirana-ui/solid/toggle"
1723
+ ```
1724
+
1725
+ Props:
1726
+
1727
+ - `pressed?: boolean`
1728
+ - `defaultPressed?: boolean`: Read once.
1729
+ - `onPressedChange?: ((pressed: boolean, details: ChangeDetails) => void)`
1730
+ - `disabled?: boolean`
1731
+ - `value?: unknown`: In a toggle group: what the group's value holds while this one is pressed.
1732
+
1733
+ Attributes and CSS variables, by part:
1734
+
1735
+ - root: The button. It stays pressed until it is pressed again.
1736
+ - `data-pressed`: Present while it is pressed.
1737
+ - `data-disabled`: Present when it is disabled.
1738
+
1739
+ ### ToggleGroup
1740
+
1741
+ ```
1742
+ import { ToggleGroup } from "@kirana-ui/solid/toggle-group"
1743
+ ```
1744
+
1745
+ Props:
1746
+
1747
+ - `value?: readonly Value[]`: The values of the pressed toggles: none, one, or with `multiple` several.
1748
+ - `defaultValue?: readonly Value[]`
1749
+ - `onValueChange?: ((value: Value[], details: ChangeDetails) => void)`
1750
+ - `multiple?: boolean`: Whether more than one can be pressed at a time.
1751
+ - `disabled?: boolean`
1752
+ - `orientation?: Orientation`
1753
+ - `loop?: boolean`: Whether the arrows go round from the last toggle to the first. Default: they do.
1754
+
1755
+ Attributes and CSS variables, by part:
1756
+
1757
+ - root: The group. A toggle inside it with a `value` is one of its toggles.
1758
+ - `data-orientation="horizontal | vertical"`: Whether its toggles are in a row or a column.
1759
+ - `data-multiple`: Present when several can be pressed at a time.
1760
+ - `data-disabled`: Present when it is disabled.
1761
+
1762
+ ### Toolbar
1763
+
1764
+ ```
1765
+ import { Toolbar } from "@kirana-ui/solid/toolbar"
1766
+ ```
1767
+
1768
+ Parts: `<Toolbar.Root>`, `<Toolbar.Button>`, `<Toolbar.Link>`, `<Toolbar.Input>`, `<Toolbar.Group>`, `<Toolbar.Separator>`.
1769
+
1770
+ Props of its root:
1771
+
1772
+ - `orientation?: Orientation`
1773
+ - `loop?: boolean`: Whether the arrows go round from the last item to the first. Default: they do.
1774
+ - `disabled?: boolean`
1775
+
1776
+ Attributes and CSS variables, by part:
1777
+
1778
+ - root: The toolbar. It is one stop for Tab.
1779
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1780
+ - `data-disabled`: Present when it is disabled.
1781
+ - button: A button of the toolbar.
1782
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1783
+ - `data-disabled`: Present when it is disabled.
1784
+ - link: A link of the toolbar.
1785
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1786
+ - `data-disabled`: Present when it is disabled.
1787
+ - input: A text input of the toolbar. The arrows are its own until the caret is at an end.
1788
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1789
+ - `data-disabled`: Present when it is disabled.
1790
+ - group: Items that belong together.
1791
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1792
+ - `data-disabled`: Present when it is disabled.
1793
+ - separator: A line between items, across the toolbar.
1794
+ - `data-orientation="horizontal | vertical"`: Whether the toolbar is a row or a column.
1795
+
1796
+ ### Tooltip
1797
+
1798
+ ```
1799
+ import { Tooltip } from "@kirana-ui/solid/tooltip"
1800
+ ```
1801
+
1802
+ Parts: `<Tooltip.Root>`, `<Tooltip.Trigger>`, `<Tooltip.Portal>`, `<Tooltip.Positioner>`, `<Tooltip.Popup>`, `<Tooltip.Arrow>`.
1803
+
1804
+ Props of its root:
1805
+
1806
+ - `open?: boolean`
1807
+ - `defaultOpen?: boolean`
1808
+ - `onOpenChange?: ((open: boolean, details: ChangeDetails) => void)`
1809
+ - `delay?: number`: How long the pointer rests on the trigger before the popup opens, in milliseconds.
1810
+ - `closeDelay?: number`: How long after the pointer leaves the popup closes, in milliseconds.
1811
+ - `disabled?: boolean`
1812
+
1813
+ Attributes and CSS variables, by part:
1814
+
1815
+ - trigger: The element the tooltip describes.
1816
+ - `data-popup-open`: Present when the tooltip is open.
1817
+ - positioner: Places the popup against the trigger. It carries the geometry.
1818
+ - `data-open`: Present when it is open.
1819
+ - `data-closed`: Present when it is closed.
1820
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1821
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1822
+ - `--anchor-width`: The anchor's width.
1823
+ - `--anchor-height`: The anchor's height.
1824
+ - `--available-width`: The width between the anchor and the edge of the viewport.
1825
+ - `--available-height`: The height between the anchor and the edge of the viewport.
1826
+ - `--transform-origin`: The point of the popup nearest its anchor, to scale from.
1827
+ - popup: The tooltip itself.
1828
+ - `data-open`: Present when it is open.
1829
+ - `data-closed`: Present when it is closed.
1830
+ - `data-starting-style`: Present for the first style of its entrance: what it animates in from.
1831
+ - `data-ending-style`: Present through its exit: what it animates out to. It leaves the page when the motion ends.
1832
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1833
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1834
+ - `data-instant="delay | focus | dismiss"`: Present when it opened or closed without its usual wait, for a design that skips the motion then.
1835
+ - arrow: An element that points at the trigger, placed along the popup's edge.
1836
+ - `data-side="top | right | bottom | left"`: The side of the anchor it is on, after any flip.
1837
+ - `data-align="start | center | end"`: How it is aligned with the anchor.
1838
+ - `data-uncentered`: Present when the popup was pushed along its edge, so the arrow is not at the trigger's centre.