@1337exp/taoui 4.0.1 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/CHANGELOG.md +321 -220
  2. package/MIGRATION-5.md +133 -0
  3. package/README.md +828 -682
  4. package/README.ru.md +828 -687
  5. package/dist/index.d.ts +2026 -701
  6. package/dist/{index.mjs → index.js} +3908 -2844
  7. package/dist/index.js.map +1 -0
  8. package/dist/styles.css +1 -1
  9. package/package.json +100 -90
  10. package/skills/taoui/SKILL.md +131 -0
  11. package/skills/taoui/references/components.md +1106 -0
  12. package/src/styles/base.css +81 -81
  13. package/src/styles/contexts/atmosphere.css +29 -0
  14. package/src/styles/contexts/size.css +125 -0
  15. package/src/styles/{surface.css → contexts/surface.css} +68 -4
  16. package/src/styles/contexts/tone.css +118 -0
  17. package/src/styles/date-popup.css +2 -2
  18. package/src/styles/index.css +12 -5
  19. package/src/styles/palettes/index.css +11 -0
  20. package/src/styles/palettes/lagoon.css +105 -0
  21. package/src/styles/palettes/marple.css +105 -0
  22. package/src/styles/palettes/ocean-blue.css +105 -0
  23. package/src/styles/palettes/pinheiro.css +105 -0
  24. package/src/styles/palettes/sunset.css +105 -0
  25. package/src/styles/palettes/tokyo-night.css +105 -0
  26. package/src/styles/palettes/violet-dusk.css +105 -0
  27. package/src/styles/{semantic.css → themes/dark.css} +95 -93
  28. package/src/styles/themes/light.css +86 -74
  29. package/src/styles/{primitives.css → tokens/primitives.css} +162 -139
  30. package/src/styles/tokens/semantic.css +33 -0
  31. package/src/styles/typography.css +220 -0
  32. package/dist/index.cjs +0 -10572
  33. package/dist/index.cjs.map +0 -1
  34. package/dist/index.mjs.map +0 -1
  35. package/src/styles/size.css +0 -57
@@ -0,0 +1,1106 @@
1
+ # TaoUI components: props, events, slots
2
+
3
+ Generated from the showcase prop tables by `npm run skill`; do not edit by hand.
4
+ A default "inherited" means the value comes from a context class on an ancestor (size, density).
5
+
6
+ ## TaoBlock
7
+
8
+ Showcase section: `#block`
9
+
10
+ | Prop | Type | Default | Notes |
11
+ |---|---|---|---|
12
+ | `padding` | `number \| string \| (…)[]` | 16 | Inner padding. A number is px, a string is any CSS length. An array works like CSS padding (1–4 values) |
13
+ | `radius` | `number \| string` | 8 | Corner radius. A number is px, a string is CSS |
14
+ | `shadow` | `boolean` | true | Panel shadow |
15
+ | `hover` | `boolean` | false | Stronger shadow on hover, pointer cursor |
16
+ | `surface` | `'flat' \| 'grain' \| 'glass'` | 'flat' | What the block is made of: fill / grain / glass. See “Surfaces” |
17
+ | `stripe` | `'top' \| 'left' \| 'bottom'` | — | A coloured stripe on one side; the corners clip it (over a picture in #media too) |
18
+ | `stripeTone` | `tone \| 'gradient'` | 'accent' | The stripe colour: accent, success / danger / warning / info / neutral, or the palette gradient. Say a status in the text as well |
19
+
20
+ **Slots, events, notes.** default — the block content.
21
+
22
+ ## TaoButton
23
+
24
+ Showcase section: `#button`
25
+
26
+ | Prop | Type | Default | Notes |
27
+ |---|---|---|---|
28
+ | `type` | `'button' \| 'submit' \| 'reset'` | 'button' | The native button type |
29
+ | `variant` | `'primary' \| 'secondary' \| 'ghost' \| 'text'` | 'primary' | Shape. The colour is tone |
30
+ | `tone` | `'accent' \| 'neutral' \| 'success' \| 'danger' \| 'warning' \| 'info'` | 'accent' | The colour, on any variant. accent is the theme accent. neutral keeps the text strong and only the hover wash takes the theme colour: the quiet action next to a primary one |
31
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size. Without it — the size of the ancestors (the tao-size-* class or size on FormField / InputGroup), otherwise medium |
32
+ | `disabled` | `boolean` | false | Disabled |
33
+ | `loading` | `boolean` | false | A spinner, the click is swallowed |
34
+ | `block` | `boolean` | false | 100% width |
35
+ | `minWidth` | `number \| string` | — | Minimum width (number = px); the --tao-button-min-width variable |
36
+ | `icon` | `string` | '' | An icon before the text: a name for TaoIcon (tao-plus, your own or a font one). Without text and slot the button is a square of the control height and needs aria-label |
37
+ | `iconEnd` | `string` | '' | An icon after the text |
38
+
39
+ **Slots, events, notes.** default — the button caption.
40
+
41
+ ## .tao-prose / .tao-heading-*
42
+
43
+ Showcase section: `#typography`
44
+
45
+ | Prop | Type | Default | Notes |
46
+ |---|---|---|---|
47
+ | `--tao-text-base` | `length` | 16px | The text size and h6; the scale is counted from it |
48
+ | `--tao-text-ratio` | `number` | 1.25 | The step of the scale: each level up is multiplied by it (1.2 calmer, 1.333 bolder). Set it on any element and the scale under it follows |
49
+ | `--tao-heading-1…6` | `length` | 49 / 39 / 31 / 25 / 20 / 16 | The steps, ready for your own rules; h1 and h2 in .tao-prose shrink on a narrow screen (not below h3 / h4) |
50
+ | `--tao-line-height-body / -heading` | `number` | 1.6 / 1.25 | Line height of text and headings |
51
+ | `--tao-font-family-mono` | `font` | ui-monospace… | The code font in .tao-prose |
52
+
53
+ **Slots, events, notes.** .tao-prose on a wrapper: headings, paragraphs, lists, quotes, code, hr, links (the theme link colour), images; spacing by proximity. Every rule inside is :where(), your CSS wins. .tao-heading-1…6 — the look of a level on any tag (h2 class="tao-heading-5").
54
+
55
+ ## Classes and tokens
56
+
57
+ Showcase section: `#surface`
58
+
59
+ | Prop | Type | Default | Notes |
60
+ |---|---|---|---|
61
+ | `.tao-surface-grain` | `class` | — | Static film grain. Any element |
62
+ | `.tao-surface-glass` | `class` | — | A translucent fill + background blur. Without blur support, or with prefers-reduced-transparency, it is solid |
63
+ | `--tao-surface-grain-image / -size` | `image / length` | SVG / 160px | Your own grain texture |
64
+ | `--tao-glass-fill / -border / -blur` | `color / color / length` | 55% / white 8% / 16px | Glass |
65
+
66
+ **Slots, events, notes.** A surface belongs to a single element: nested panels do not inherit it. Toast and confirm are glass by default: toast.defaults({ surface: 'flat' }) / confirm.defaults({ surface: 'flat' }) turn it off.
67
+
68
+ ## TaoCard
69
+
70
+ Showcase section: `#card`
71
+
72
+ | Prop | Type | Default | Notes |
73
+ |---|---|---|---|
74
+ | `padding` | `number \| string \| (…)[]` | var(--tao-space-5) | Padding of the card body. A number is px, a string is CSS. With flush — 0. Published as --tao-pad |
75
+ | `radius` | `number \| string` | var(--tao-radius-panel) | Corner radius. A number is px, a string is CSS. Published as --tao-radius; children get --tao-radius-inner |
76
+ | `shadow` | `boolean` | true | The regular shadow. Off with flush |
77
+ | `shadowBottomOnly` | `boolean` | false | A line at the bottom of the card, not a scrim over the photo |
78
+ | `flush` | `boolean` | false | A tile: no padding and no shadow, cover/body fill the whole cell |
79
+ | `hover` | `boolean` | false | An accent outline on hover |
80
+ | `surface` | `'flat' \| 'grain' \| 'glass'` | 'flat' | What the card is made of: fill / grain / glass. See “Surfaces” |
81
+ | `stripe` | `'top' \| 'left' \| 'bottom'` | — | A coloured stripe on one side; the corners clip it (over a picture in #media too) |
82
+ | `stripeTone` | `tone \| 'gradient'` | 'accent' | The stripe colour: accent, success / danger / warning / info / neutral, or the palette gradient. Say a status in the text as well |
83
+ | `active` | `boolean` | false | The selected state |
84
+ | `overflow` | `boolean` | false | Do not clip the content (media / carousel) |
85
+ | `closable` | `boolean` | false | A close button in the top right corner; the parent removes the card on the close event |
86
+ | `closeLabel` | `string` | 'Close' | aria-label of the close button |
87
+
88
+ **Slots, events, notes.** default — the body. #media (a photo or a carousel on top), #overlay (a scrim over the media or the whole tile), #header (the top row: laid out as you like), #title, #sub, #footer, #corner (the top right corner: a tag, a menu button; the title leaves room for it, the width is the variable --tao-card-corner-size). The close event — the cross was pressed.
89
+
90
+ ## TaoMarquee
91
+
92
+ Showcase section: `#marquee`
93
+
94
+ | Prop | Type | Default | Notes |
95
+ |---|---|---|---|
96
+ | `text` | `string` | '' | The line; or anything inline in the slot (a link, an icon, bold text) |
97
+ | `speed` | `number` | 40 | Speed, pixels per second |
98
+ | `gap` | `number` | 48 | The gap between the end of the line and its next round, px |
99
+ | `fade` | `number` | 22 | The width of the fading edges, px. The left fade lives in a padding outside the text: at rest the line stands where it would, but the parent needs that much room on the left (its padding, or a smaller fade; 0 for none) or the running text shows past its edge |
100
+ | `pauseOnHover` | `boolean` | true | Stop on hover |
101
+ | `paused` | `boolean` | false | Stopped by the app |
102
+
103
+ **Slots, events, notes.** default — the content of the line; its copies for the second round are hidden from a screen reader and inert. It runs only when it does not fit; it stops on hover, on focus (a running line is a tab stop) and on a tap; with «reduce motion» it wraps. measure() — measure again by hand.
104
+
105
+ ## TaoCopy
106
+
107
+ Showcase section: `#copy`
108
+
109
+ | Prop | Type | Default | Notes |
110
+ |---|---|---|---|
111
+ | `text` | `string` | — | The string for the clipboard. Required |
112
+ | `successText` | `string` | 'Copied!' | The tooltip text after the click |
113
+ | `copyLabel` | `string` | 'Copy' | aria-label of the button |
114
+ | `tip` | `boolean` | true | Show a tooltip above the button after copying |
115
+
116
+ ## TaoInput
117
+
118
+ Showcase section: `#input`
119
+
120
+ | Prop | Type | Default | Notes |
121
+ |---|---|---|---|
122
+ | `v-model` | `string \| number` | '' | The field value |
123
+ | `type` | `'text' \| 'password' \| 'email' \| 'number' \| 'tel'` | 'text' | The native input type |
124
+ | `placeholder` | `string` | '' | The hint inside |
125
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
126
+ | `disabled` | `boolean` | false | Disabled |
127
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
128
+ | `id` | `string` | auto | The input id; otherwise taken from FormField or useId |
129
+
130
+ **Slots, events, notes.** #prefix and #suffix — inside the frame, left/right (an icon, text).
131
+
132
+ ## TaoInputGroup
133
+
134
+ Showcase section: `#input`
135
+
136
+ | Prop | Type | Default | Notes |
137
+ |---|---|---|---|
138
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The size of the whole group: addons, the field and buttons inside |
139
+
140
+ **Slots, events, notes.** default — the field itself (TaoInput etc.). #before / #after — a protocol, a unit, a button. Glues addon + field + addon into one frame.
141
+
142
+ ## TaoInputNumber
143
+
144
+ Showcase section: `#input-number`
145
+
146
+ | Prop | Type | Default | Notes |
147
+ |---|---|---|---|
148
+ | `v-model` | `number \| null` | null | A number. An empty field is null, not 0 and not a string |
149
+ | `min / max` | `number` | — | The bounds. If not set — no limit |
150
+ | `step` | `number` | 1 | The step of ± and the arrows |
151
+ | `precision` | `number` | — | Digits after the decimal point |
152
+ | `@commit` | `number \| null` | — | Edit finished: blur, Enter, ±, arrow key (once per action; v-model fires per keystroke). |
153
+ | `controls` | `boolean` | true | ± buttons on the right |
154
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
155
+ | `disabled` | `boolean` | false | Disabled |
156
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
157
+ | `placeholder` | `string` | '' | The hint when null |
158
+
159
+ ## TaoQuantity
160
+
161
+ Showcase section: `#quantity`
162
+
163
+ | Prop | Type | Default | Notes |
164
+ |---|---|---|---|
165
+ | `v-model` | `number` | 1 | A whole quantity. Never empty |
166
+ | `min` | `number` | 1 | The lower bound |
167
+ | `max` | `number` | — | Stock. If not set — no ceiling |
168
+ | `allowRemove` | `boolean` | true | The minus at min stays alive and fires dec — the parent may remove the row |
169
+ | `forceMaxLimit` | `boolean` | true | Clamp the input to max on blur and when more than the stock arrives |
170
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
171
+ | `disabled` | `boolean` | false | Disabled |
172
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
173
+
174
+ **Slots, events, notes.** #decrement-icon / #increment-icon — the button icons.
175
+
176
+ ## TaoTextarea
177
+
178
+ Showcase section: `#textarea`
179
+
180
+ | Prop | Type | Default | Notes |
181
+ |---|---|---|---|
182
+ | `v-model` | `string` | '' | Text |
183
+ | `placeholder` | `string` | '' | Hint |
184
+ | `rows` | `number` | 3 | The initial height |
185
+ | `maxlength` | `number` | — | Cuts the input |
186
+ | `count` | `boolean` | false | Show “typed / maximum” (together with maxlength) |
187
+ | `resize` | `boolean` | true | Can be dragged by the corner |
188
+ | `variant` | `'bar' \| 'outline' \| 'filled' \| 'plain'` | 'bar' | A stripe on the left / a frame like TaoInput / a fill only / nothing |
189
+ | `readonly` | `boolean` | false | Can be read and selected, but not edited |
190
+ | `noSpace` | `boolean` | false | A space cannot be typed — neither from the keyboard nor by pasting |
191
+ | `align` | `'start' \| 'center' \| 'end'` | 'start' | Text alignment |
192
+ | `autofocus` | `boolean` | false | Focus on mount |
193
+ | `blurOnEnter` | `boolean` | false | Enter drops the focus instead of inserting a line break (Shift+Enter inserts it); keydown goes out first |
194
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
195
+ | `disabled` | `boolean` | false | Disabled |
196
+ | `error` | `boolean` | false | A red border |
197
+
198
+ ## TaoChecklist
199
+
200
+ Showcase section: `#checklist`
201
+
202
+ | Prop | Type | Default | Notes |
203
+ |---|---|---|---|
204
+ | `items` | `TaoChecklistItem[]` | — | { value, label, description?, disabled? } |
205
+ | `v-model` | `(string \| number)[]` | [] | The checked values, in the order of the items |
206
+ | `legend` | `string` | — | The group caption (legend). In a TaoFormField the field gives it |
207
+ | `selectAll` | `boolean` | false | «Select all» on top: mixed when some are checked; toggles every enabled item |
208
+ | `counter` | `boolean` | false | «3 of 5» next to the caption, announced politely |
209
+ | `strike` | `boolean` | false | Strike the checked items through (a to-do list). A look only: the checkbox tells the state |
210
+ | `disabled` | `boolean` | false | The whole group is disabled |
211
+ | `error` | `boolean` | false | Red frames; the message goes to error of TaoFormField |
212
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size of the checkboxes |
213
+ | `selectAllLabel` | `string` | 'Select all' | The «Select all» label |
214
+ | `counterText` | `string` | '{checked} of {total}' | The counter text |
215
+
216
+ **Slots, events, notes.** #item — { item, checked }: your own item text. Events update:modelValue, change. «Select all» leaves a disabled item alone. A fieldset: in a TaoFormField the group takes the id, the label and the error of the field, the checkboxes inside keep ids of their own.
217
+
218
+ ## TaoCheckbox
219
+
220
+ Showcase section: `#checkbox`
221
+
222
+ | Prop | Type | Default | Notes |
223
+ |---|---|---|---|
224
+ | `v-model` | `boolean` | — | Checked / not |
225
+ | `checked` | `boolean` | — | The state without v-model |
226
+ | `label` | `string` | '' | The caption on the right |
227
+ | `indeterminate` | `boolean` | false | A dash instead of the tick. A click sets checked, the parent works out the mixed state |
228
+ | `disabled` | `boolean` | false | Disabled |
229
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | A 14 / 18 / 22 square and the caption font size. Without it — the size of the ancestors |
230
+ | `error` | `boolean` | false | A red accent. The error text goes through TaoFormField |
231
+
232
+ ## TaoSelect
233
+
234
+ Showcase section: `#select`
235
+
236
+ | Prop | Type | Default | Notes |
237
+ |---|---|---|---|
238
+ | `v-model` | `string \| number \| null` | null | value of the selected option. Clearing → null |
239
+ | `options` | `TaoSelectOption[]` | [] | { value, label, disabled? } |
240
+ | `placeholder` | `string` | 'Choose' | When the model is null |
241
+ | `disabled` | `boolean` | false | Disabled |
242
+ | `error` | `boolean` | false | A red border |
243
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, as TaoButton; also scales the opened list. Without it — the size of the ancestors |
244
+ | `clearable` | `boolean` | true | Clear row and Delete / Backspace. Turn off when null is not valid. |
245
+ | `clearText` | `string` | 'Clear' | Label of the clear row. |
246
+
247
+ **Slots, events, notes.** #clear: content of the clear row (icon, markup), replaces clearText. #chevron: custom arrow.
248
+
249
+ ## TaoSwitch
250
+
251
+ Showcase section: `#select`
252
+
253
+ | Prop | Type | Default | Notes |
254
+ |---|---|---|---|
255
+ | `v-model` | `boolean` | false | On / off. role="switch" |
256
+ | `label` | `string` | '' | The caption on the right |
257
+ | `disabled` | `boolean` | false | Disabled |
258
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The track is 28 / 36 / 44 px wide, and the caption font size. Without it — the size of the ancestors |
259
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
260
+ | `loading` | `boolean` | false | The change is being applied: a spinner on the thumb, a click does nothing, not greyed out; aria-busy |
261
+
262
+ ## TaoRadio / TaoRadioGroup
263
+
264
+ Showcase section: `#select`
265
+
266
+ | Prop | Type | Default | Notes |
267
+ |---|---|---|---|
268
+ | `value` | `string \| number \| boolean` | — | Radio: the value of this point. Required |
269
+ | `v-model` | `the same` | — | Group holds the selection. A Radio without a group holds its own |
270
+ | `legend` | `string` | — | Group: the group caption |
271
+ | `direction` | `'row' \| 'column'` | 'row' | Group: in a row or in a column |
272
+ | `disabled` | `boolean` | false | A single point or the whole group |
273
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
274
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | A 14 / 18 / 22 circle and the caption font size. On a group — for all the radios inside |
275
+ | `label / name` | `string` | '' | Radio: the caption and name, if there is no group |
276
+
277
+ ## TaoFormField
278
+
279
+ Showcase section: `#select`
280
+
281
+ | Prop | Type | Default | Notes |
282
+ |---|---|---|---|
283
+ | `label` | `string` | — | A shared caption above the control |
284
+ | `hint` | `string` | — | A hint under the field |
285
+ | `error` | `string` | — | The error text; if present, the field is invalid |
286
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The size of the control inside |
287
+
288
+ **Slots, events, notes.** default — the control itself (Input, Select, Switch…).
289
+
290
+ ## TaoSegmented
291
+
292
+ Showcase section: `#segmented`
293
+
294
+ | Prop | Type | Default | Notes |
295
+ |---|---|---|---|
296
+ | `v-model` | `string \| number \| boolean` | — | value of the selected option |
297
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The segment height, the same scale as TaoButton. Without it — the size of the ancestors |
298
+ | `block` | `boolean` | false | Stretch to the parent width |
299
+ | `minWidth` | `number \| string` | — | Minimum width of every option (number = px); the --tao-segmented-option-min-width variable |
300
+ | `legend` | `string` | — | The accessible name of the group |
301
+ | `disabled` | `boolean` | false | The whole group |
302
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
303
+ | `name` | `string` | auto | name for the radio inputs inside |
304
+
305
+ **Slots, events, notes.** default — a set of TaoSegmentedOption.
306
+
307
+ ## TaoSegmentedOption
308
+
309
+ Showcase section: `#segmented`
310
+
311
+ | Prop | Type | Default | Notes |
312
+ |---|---|---|---|
313
+ | `value` | `string \| number \| boolean` | — | The option value. Required |
314
+ | `label` | `string` | '' | The text. Or the default slot |
315
+ | `icon` | `string` | '' | A TaoIcon name on the left |
316
+ | `count` | `number \| string` | — | A number on the right (a badge) |
317
+ | `disabled` | `boolean` | false | This option |
318
+
319
+ ## TaoCombobox
320
+
321
+ Showcase section: `#combobox`
322
+
323
+ | Prop | Type | Default | Notes |
324
+ |---|---|---|---|
325
+ | `v-model` | `string \| number \| null` | null | value of an option, or an arbitrary string with allow-create |
326
+ | `options` | `TaoSelectOption[]` | [] | { value, label, disabled? }. The list is not mutated by the component |
327
+ | `placeholder` | `string` | 'Start typing' | The empty field |
328
+ | `allowCreate` | `boolean` | false | A value that is not in the list can be kept |
329
+ | `emptyText` | `string` | 'Nothing found' | An empty filter |
330
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, as TaoButton and TaoSelect; also scales the opened list. Without it — the size of the ancestors |
331
+ | `clearable` | `boolean` | true | Clear row in the list. Turn off when null is not valid. |
332
+ | `clearText` | `string` | 'Clear' | Label of the clear row; slot #clear replaces it. |
333
+ | `disabled / error` | `boolean` | false | Disabled / a red border |
334
+
335
+ **Slots, events, notes.** create — an event when a new value is typed: the parent extends options itself.
336
+
337
+ ## TypeaheadPlayground
338
+
339
+ Showcase section: `#typeahead`
340
+
341
+ | Prop | Type | Default | Notes |
342
+ |---|---|---|---|
343
+ | `v-model` | `object \| null` | null | The selected hit { id, name, city, role } or null |
344
+
345
+ **Slots, events, notes.** #item="{ hit, active }" — a list row. #empty — nothing found. Not part of the npm package, lives in showcase/demo.
346
+
347
+ ## TaoDate
348
+
349
+ Showcase section: `#date`
350
+
351
+ | Prop | Type | Default | Notes |
352
+ |---|---|---|---|
353
+ | `v-model` | `string \| null` | null | A single day YYYY-MM-DD, with no time and no time zone |
354
+ | `min / max` | `string` | — | The bounds in the same format |
355
+ | `placeholder` | `string` | 'Date' | The empty field |
356
+ | `locale` | `string` | 'en-US' | The calendar captions |
357
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
358
+ | `disabled / error` | `boolean` | false | Disabled / a red border |
359
+ | `todayText / clearText` | `string` | 'Today' / 'Clear' | The buttons at the bottom of the popup |
360
+
361
+ **Slots, events, notes.** #icon, #prev-icon, #next-icon — the icons of the field and of the month arrows.
362
+
363
+ ## TaoDateRange
364
+
365
+ Showcase section: `#date`
366
+
367
+ | Prop | Type | Default | Notes |
368
+ |---|---|---|---|
369
+ | `v-model` | `{ start, end } \| null` | null | A period YYYY-MM-DD. An incomplete choice is not written to the model |
370
+ | `min / max` | `string` | — | The bounds |
371
+ | `placeholder` | `string` | 'Period' | While null |
372
+ | `locale` | `string` | 'en-US' | The calendar captions |
373
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size, the same scale as TaoButton. Without it — the size of the ancestors (tao-size-* or size on FormField / InputGroup), otherwise medium |
374
+ | `disabled / error` | `boolean` | false | Disabled / a red border |
375
+
376
+ **Slots, events, notes.** The first click is start, the second is end (they swap if end is earlier).
377
+
378
+ ## TaoPinCode
379
+
380
+ Showcase section: `#pincode`
381
+
382
+ | Prop | Type | Default | Notes |
383
+ |---|---|---|---|
384
+ | `length` | `number` | — | The number of cells. Not needed with format: it is counted from the mask |
385
+ | `format` | `string` | — | A mask with separators: # is a cell, the rest is a separator (#-##-## gives 0-00-00). Separators are not part of the value |
386
+ | `v-model` | `string` | '' | The cells glued into a string |
387
+ | `numbersOnly` | `boolean` | false | Digits only |
388
+ | `masked` | `boolean` | false | Dots instead of characters |
389
+ | `disabled` | `boolean` | false | Disabled |
390
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
391
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Cells 40×46 / 50×56 / 58×64. Without it — the size of the ancestors |
392
+ | `clearOn` | `'focus' \| 'input'` | 'focus' | focus — a click clears the cell and everything to the right; input — changes only on typing |
393
+ | `status` | `'idle' \| 'success' \| 'error'` | 'idle' | The result of the check, set by the app (on complete): error shakes the cells and paints them red, success runs a glow and paints them green; a screen reader hears it. Set idle again when the user edits; play() repeats the animation |
394
+ | `successText / errorText` | `string` | 'The code is correct' / 'Wrong code' | What a screen reader hears |
395
+ | `placeholder` | `string` | '' | The character in an empty cell |
396
+
397
+ **Slots, events, notes.** The complete event — the last cell was typed (it blurs).
398
+
399
+ ## TaoProgress
400
+
401
+ Showcase section: `#slider`
402
+
403
+ | Prop | Type | Default | Notes |
404
+ |---|---|---|---|
405
+ | `progress` | `number` | 0 | The fill 0–100, not the bar width |
406
+ | `minWidth / maxWidth` | `number` | 200 / — | The bar width in px |
407
+ | `height` | `number` | 8 | The thickness in px |
408
+ | `showPercentage` | `boolean \| 'top' \| 'right'` | true | true/top — above the bar, right — on the right, false — hide |
409
+ | `animated` | `boolean` | true | Smooth filling |
410
+
411
+ **Slots, events, notes.** #left / #right — captions. If #right is present, the percentage goes on the right in brackets.
412
+
413
+ ## TaoSlider
414
+
415
+ Showcase section: `#slider`
416
+
417
+ | Prop | Type | Default | Notes |
418
+ |---|---|---|---|
419
+ | `v-model` | `number` | — | The current value. Required. Two handles: TaoRangeSlider with a [from, to] pair |
420
+ | `min / max / step` | `number` | 0 / 100 / 1 | The range and the step |
421
+ | `marks` | `boolean \| (number \| { value, label? })[]` | — | Scale marks: true — automatic divisions, an array of numbers or objects with a caption. A click on a caption moves the handle |
422
+ | `marksSide` | `'start' \| 'end'` | 'end' | The marks side: end — under a horizontal slider and to the right of a vertical one, start — above and to the left |
423
+ | `discrete` | `boolean` | false | The value only on the marks (a stepped scale); the arrows follow the marks |
424
+ | `format` | `(value: number) => string` | — | Number text: the captions of automatic marks and the value on the bar |
425
+ | `flat` | `boolean` | false | No round handles: a flat bar with a fill. Keyboard and focus work |
426
+ | `vertical` | `boolean` | false | Vertical: the maximum on top, marks on the right. Length — --tao-slider-length (10rem) |
427
+ | `variant` | `'bar' \| 'thin'` | 'bar' | bar — a thick track, a form control; thin — a thin one (seek / volume). It used to be size="small" |
428
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The scale of the track and the thumb (the thumb is 16 / 20 / 24). Without it — the size of the ancestors |
429
+ | `showValue` | `boolean` | false | The value over the bar |
430
+ | `disabled` | `boolean` | false | Disabled |
431
+ | `error` | `boolean` | false | A red outline of the track. The error text is error on TaoFormField |
432
+ | `wheel` | `number` | 0 | The change step for the mouse wheel (a single handle). 0 — disabled |
433
+ | `@change` | `value` | — | Finished changing: released, a key, the wheel, a click on a mark. v-model fires on every move |
434
+ | `#mark` | `{ mark, active }` | — | A custom mark caption |
435
+
436
+ ## TaoRangeSlider
437
+
438
+ Showcase section: `#slider`
439
+
440
+ | Prop | Type | Default | Notes |
441
+ |---|---|---|---|
442
+ | `v-model` | `[number, number]` | — | A [from, to] pair. Required |
443
+ | `minGap` | `number` | 0 | The smallest distance between the handles; the handles do not jump over each other |
444
+ | `…` | `` | | The rest as in TaoSlider: min / max / step, marks, discrete, format, vertical, variant, size, showValue, disabled, error |
445
+
446
+ ## TaoScrubber
447
+
448
+ Showcase section: `#slider`
449
+
450
+ | Prop | Type | Default | Notes |
451
+ |---|---|---|---|
452
+ | `v-model` | `number` | — | The current time. Required |
453
+ | `v-model:playing` | `boolean` | false | Whether playback is running (the look of the button). The component does not keep time itself |
454
+ | `length` | `number` | — | The length; the slider goes from 0 to it. Required |
455
+ | `step` | `number` | 0.01 | The slider step |
456
+ | `marks` | `(number \| { value, label? })[]` | — | Event marks on the scale |
457
+ | `marksSide` | `'start' \| 'end'` | 'end' | The marks above the slider or below it |
458
+ | `format` | `(time: number) => string` | toFixed(2) | The time text in the marks and the caption |
459
+ | `pauseOnScrub` | `boolean` | true | Pause while the user holds the slider |
460
+ | `showRestart / showTime` | `boolean` | true | The “to the start” button; the “time / length” caption |
461
+ | `variant` | `'bar' \| 'thin'` | 'thin' | The track thickness |
462
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Size; without it — the size of the ancestors |
463
+ | `disabled` | `boolean` | false | Disabled |
464
+ | `playLabel / pauseLabel / restartLabel` | `string` | from the locale | Button captions for screen readers |
465
+ | `@restart` | `—` | — | The “to the start” button (the time is already set to 0) |
466
+ | `@seek` | `time` | — | Finished seeking: the slider was released or a key was pressed |
467
+ | `#mark / #time` | `{ mark, active } / { time, length, text }` | — | A custom mark caption; a custom time caption |
468
+
469
+ ## TaoColorPicker
470
+
471
+ Showcase section: `#color`
472
+
473
+ | Prop | Type | Default | Notes |
474
+ |---|---|---|---|
475
+ | `v-model` | `string` | — | The colour as a hex string: #rrggbb, with alpha also #rrggbbaa. rgb()/rgba() is accepted on input too. Required |
476
+ | `alpha` | `boolean` | false | The opacity bar and #rrggbbaa |
477
+ | `swatches` | `string[]` | — | Ready colours under the palette; the selected one is marked |
478
+ | `modes` | `('hex' \| 'rgb' \| 'hsl')[]` | ['hex', 'rgb', 'hsl'] | Colour input modes; a single mode hides the switch |
479
+ | `v-model:mode` | `'hex' \| 'rgb' \| 'hsl'` | the first of modes | The current input mode; v-model:mode remembers the choice between openings |
480
+ | `eyedropper` | `boolean` | true | An eyedropper (only where the browser supports EyeDropper) |
481
+ | `disabled` | `boolean` | false | Disabled |
482
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The field size; without it — the size of the ancestors |
483
+ | `areaLabel / hueLabel / alphaLabel / hexLabel / swatchesLabel / eyedropperLabel` | `string` | from the locale | Captions for screen readers (the colorPicker locale) |
484
+ | `@change` | `hex` | — | Finished editing: the square or a bar was released, a key, the hex field, a swatch. v-model fires on every move |
485
+
486
+ ## TaoColorInput
487
+
488
+ Showcase section: `#color`
489
+
490
+ | Prop | Type | Default | Notes |
491
+ |---|---|---|---|
492
+ | `v-model` | `string` | — | The colour as a hex string. Required |
493
+ | `alpha / swatches / modes / v-model:mode / eyedropper / size` | `` | | As in TaoColorPicker |
494
+ | `placement` | `TaoPlacement` | 'bottom-start' | Side and alignment: top / bottom / left / right and -start / -end. Flips at the screen edge |
495
+ | `error` | `boolean` | false | A red border. The error text is error on TaoFormField |
496
+ | `disabled` | `boolean` | false | Disabled |
497
+
498
+ ## colorModel(source, options)
499
+
500
+ Showcase section: `#color`
501
+
502
+ | Prop | Type | Default | Notes |
503
+ |---|---|---|---|
504
+ | `source` | `Ref<T>` | — | Your colour storage. Returns a writable hex string for v-model |
505
+ | `format` | `'object' \| 'array' \| 'css'` | 'object' | { r, g, b, a }, [r, g, b, a] or an rgb(r g b / a) string |
506
+ | `range` | `255 \| 1` | 255 | The range of r, g, b; opacity is always 0…1 |
507
+ | `space` | `'srgb' \| 'linear'` | 'srgb' | The space of r, g, b; linear only with range: 1 (rendering, the TaoFX gradient) |
508
+ | `alpha` | `boolean` | false | Store opacity; without it a hex #rrggbb |
509
+ | `precision` | `number` | 5 | Digits of fractional values (range 1); for a linear colour fewer give steps in the dark |
510
+
511
+ ## TaoFileDrop
512
+
513
+ Showcase section: `#filedrop`
514
+
515
+ | Prop | Type | Default | Notes |
516
+ |---|---|---|---|
517
+ | `v-model` | `File[]` | [] | The list of files. The component does not accumulate it — only what the parent gave |
518
+ | `multiple` | `boolean` | false | Several files |
519
+ | `accept` | `string` | '*' | As in <input type="file"> |
520
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The height of the zone and of the file rows. Without it — the size of the ancestors |
521
+ | `list` | `boolean` | true | Names under the zone. Removing a file goes straight to v-model |
522
+ | `showClear` | `boolean` | false | The “clear all” button. It does not clear by itself — it fires clear-request |
523
+
524
+ **Slots, events, notes.** default — the zone text. The change event — files were added or removed. clear-request: the parent decides whether to reset at once or after confirm().
525
+
526
+ ## TaoTable
527
+
528
+ Showcase section: `#table`
529
+
530
+ | Prop | Type | Default | Notes |
531
+ |---|---|---|---|
532
+ | `columns` | `TaoTableColumn[]` | — | Required. { key, label, sortable?, align?, width? } |
533
+ | `rows` | `object[]` | [] | The data |
534
+ | `v-model:sort` | `{ key, dir } \| null` | null | Sorting. dir: asc \| desc |
535
+ | `loading` | `boolean` | false | The loading overlay |
536
+ | `emptyText` | `string` | 'No data' | If rows is empty and not loading |
537
+ | `striped` | `boolean \| 'odd' \| 'even'` | false | Zebra. true/odd — from the first row, even — from the second |
538
+ | `hover` | `boolean` | true | Highlight the row on hover |
539
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Paddings and text of cells (small = the former compact), and the size of controls in cells too |
540
+ | `head` | `boolean` | true | Highlight the header |
541
+ | `lines` | `boolean` | true | Lines between rows |
542
+ | `sticky` | `boolean` | false | A sticky header (needs maxHeight) |
543
+ | `rowKey` | `string \| fn` | 'id' | The row key |
544
+ | `maxHeight` | `number \| string` | — | Scroll. A number is px |
545
+
546
+ **Slots, events, notes.** Cell: #cell-{key}="{ row, value }". Events: change — the sorting changed, row-click, if clickable.
547
+
548
+ ## TaoPagination
549
+
550
+ Showcase section: `#pagination`
551
+
552
+ | Prop | Type | Default | Notes |
553
+ |---|---|---|---|
554
+ | `v-model:page` | `number` | 1 | The current page |
555
+ | `total` | `number` | 0 | Total records (not pages) |
556
+ | `pageSize` | `number` | 10 | Records per page |
557
+ | `jump` | `number` | 5 | A click on “…” jumps this many pages. 0 — “…” is decorative |
558
+ | `pageInput` | `boolean \| number` | false | A field to type a page in: true — always, a number — from this many pages on. Enter or leaving the field goes there (clamped to the range), Esc drops it |
559
+ | `siblingCount` | `number` | 1 | How many numbers around the current one |
560
+ | `showTotal` | `boolean` | true | The “1–10 of N” caption |
561
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Buttons 26 / 36 / 44, like TaoButton. Without it — the size of the ancestors |
562
+ | `disabled` | `boolean` | false | Disabled |
563
+
564
+ ## TaoEmpty
565
+
566
+ Showcase section: `#empty`
567
+
568
+ | Prop | Type | Default | Notes |
569
+ |---|---|---|---|
570
+ | `title` | `string` | 'Nothing here' | The empty state title |
571
+
572
+ **Slots, events, notes.** default — an explanation. #icon — a picture/icon. #action — a button.
573
+
574
+ ## TaoTree
575
+
576
+ Showcase section: `#tree`
577
+
578
+ | Prop | Type | Default | Notes |
579
+ |---|---|---|---|
580
+ | `nodes` | `TaoTreeNode[]` | — | { id, label, icon?, children?, hasChildren?, disabled? }. hasChildren without children — the children come from load when it opens |
581
+ | `v-model:expanded` | `string[]` | own | Ids of the expanded nodes. Without a model the tree keeps them itself |
582
+ | `selection` | `'none' \| 'single' \| 'multiple'` | 'single' | Selection mode. none — a click on a folder toggles it |
583
+ | `v-model:selected` | `string \| string[] \| null` | own | An id (single) or a list of ids (multiple) |
584
+ | `checkable` | `boolean` | false | Checkboxes. A parent is checked, unchecked or mixed by its leaves; a click on a parent toggles the whole branch |
585
+ | `v-model:checked` | `string[]` | own | Ids of the checked nodes without children (leaves and folders not loaded yet). A checked lazy folder hands its check to its children once loaded |
586
+ | `load` | `(node) => Promise<TaoTreeNode[]>` | — | Loads the children of a node with hasChildren; a spinner and aria-busy meanwhile |
587
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Row height, as for the controls; the density works too |
588
+ | `ariaLabel` | `string` | 'Tree' | Accessible name of the tree |
589
+ | `loadingLabel` | `string` | 'Loading…' | The hint of the spinner |
590
+
591
+ **Slots, events, notes.** #icon, #label, #actions — { node, level, expanded, selected }; the actions show on hover and focus (always on a touch screen). Events: update:expanded / selected / checked, select(node) — a click, Enter, Space without checkboxes; load-error(node, error) — the node stays closed. Keys: ↑ ↓, → opens or goes in, ← closes or goes to the parent, Home / End, * opens the siblings, letters search, Enter selects, Space checks.
592
+
593
+ ## TaoList
594
+
595
+ Showcase section: `#list`
596
+
597
+ | Prop | Type | Default | Notes |
598
+ |---|---|---|---|
599
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Row height 26 / 36 / 44. An Item without its own size takes it from here |
600
+ | `bordered` | `boolean` | true | A border around the list |
601
+ | `divided` | `boolean` | true | Lines between rows |
602
+ | `maxHeight` | `number \| string` | — | Scroll. A number is pixels |
603
+ | `empty` | `boolean` | false | Show #empty instead of rows |
604
+ | `ariaLabel` | `string` | '' | The list name |
605
+
606
+ **Slots, events, notes.** default — TaoListItem. #empty — if empty.
607
+
608
+ ## TaoListItem
609
+
610
+ Showcase section: `#list`
611
+
612
+ | Prop | Type | Default | Notes |
613
+ |---|---|---|---|
614
+ | `title` | `string` | '' | The title. The default slot replaces it |
615
+ | `description` | `string` | '' | A caption under the title |
616
+ | `selected` | `boolean` | false | The selected row |
617
+ | `disabled` | `boolean` | false | Disabled |
618
+ | `active` | `boolean` | false | Highlight without selected |
619
+ | `clickable` | `boolean` | false | A button row, fires click |
620
+ | `size` | `'small' \| 'medium' \| 'large'` | from the list | Override the list size |
621
+ | `actionAlways` | `boolean` | false | #action is always visible, not only on hover |
622
+
623
+ **Slots, events, notes.** default — the title. #prefix, #description, #suffix, #action (on hover; always on touch).
624
+
625
+ ## TaoTimeline
626
+
627
+ Showcase section: `#timeline`
628
+
629
+ | Prop | Type | Default | Notes |
630
+ |---|---|---|---|
631
+ | `items` | `TaoTimelineItem[]` | — | { id, title, time?, datetime?, description?, icon?, tone? }. time is shown, datetime goes to <time datetime> |
632
+ | `active` | `string` | — | The id of the current event: the line is filled up to it, the next ones wait, it gets aria-current="step". Without active the feed is a log of the past |
633
+ | `align` | `'start' \| 'alternate'` | 'start' | alternate — the events on both sides of the line; below 480px of its own width it folds into start |
634
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The marker and the text on the control scale; the density works too |
635
+
636
+ **Slots, events, notes.** #marker, #title, #content — { item, index, state, active }; state: done / current / upcoming. A marker tone: success / danger / warning / info / neutral, the accent without one. An <ol>: a screen reader hears the order, the line and the markers are hidden from it.
637
+
638
+ ## TaoStages
639
+
640
+ Showcase section: `#stages`
641
+
642
+ | Prop | Type | Default | Notes |
643
+ |---|---|---|---|
644
+ | `items` | `TaoStageItem[]` | [] | { key, label?, status?: wait \| work \| ok \| bad } |
645
+ | `direction` | `'row' \| 'column'` | 'column' | column — top to bottom, row — in a row. As in TaoFlex |
646
+ | `ariaLabel` | `string` | 'Stages' | The list name |
647
+
648
+ **Slots, events, notes.** default / #icon="{ item, index, status }" — replace the step text or icon.
649
+
650
+ ## TaoSkeleton
651
+
652
+ Showcase section: `#skeleton`
653
+
654
+ | Prop | Type | Default | Notes |
655
+ |---|---|---|---|
656
+ | `variant` | `'text' \| 'title' \| 'circle' \| 'rect'` | 'text' | The placeholder shape |
657
+ | `lines` | `number` | 1 | How many lines (text) |
658
+ | `width / height` | `string` | '' | A CSS size, if it has to be set explicitly |
659
+
660
+ ## TaoCounter
661
+
662
+ Showcase section: `#counter`
663
+
664
+ | Prop | Type | Default | Notes |
665
+ |---|---|---|---|
666
+ | `value` | `number` | 0 | A number on display. Not an input |
667
+ | `maxDigits` | `number` | 9 | The minimum width in digits (leading zeros are hidden visually) |
668
+
669
+ ## TaoCarousel
670
+
671
+ Showcase section: `#carousel`
672
+
673
+ | Prop | Type | Default | Notes |
674
+ |---|---|---|---|
675
+ | `v-model` | `number` | 0 | The index of the current snap |
676
+ | `perView` | `number` | 1 | How many slides are in the frame. 5 — a product strip |
677
+ | `peek` | `number` | 0 | How many px of the next card are visible on the right |
678
+ | `autoplay` | `number` | 0 | Time per slide in ms. 0 — off. The current indicator fills over this time and the slide changes when it is full (the clock is a CSS animation). Pauses on hover / keyboard focus / touch and drag / a hidden tab; off with prefers-reduced-motion |
679
+ | `loop` | `boolean` | false | Loop round in a circle |
680
+ | `indicator` | `'dots' \| 'bars' \| 'progress'` | — | Marks under the strip: dots (the current one stretches into a pill) / equal bars / one bar (the fill of the slide, the position without autoplay) |
681
+ | `pausable` | `boolean` | true | With autoplay: a button that stops and resumes it (autoplay that moves for more than 5 seconds must be stoppable) |
682
+ | `pauseLabel / playLabel` | `string` | 'Pause autoplay' / 'Start autoplay' | aria-label of the button |
683
+ | `controls` | `boolean` | true | Arrows. false hides both |
684
+
685
+ **Slots, events, notes.** default — slides. #prev / #next="{ go, disabled }" — custom buttons. #prev-icon / #next-icon — the icon only. #dots="{ index, count, go }" — your own indicator as a whole (an invisible fill then keeps the time), #dot — your own mark.
686
+
687
+ ## TaoContainer
688
+
689
+ Showcase section: `#container`
690
+
691
+ | Prop | Type | Default | Notes |
692
+ |---|---|---|---|
693
+ | `width` | `'wide' \| 'slim' \| 'ultra-slim'` | 'wide' | max-width: 1120 / 500 / 400 |
694
+ | `free` | `boolean` | false | No horizontal auto-centring |
695
+
696
+ **Slots, events, notes.** default — the content.
697
+
698
+ ## TaoFlex
699
+
700
+ Showcase section: `#flex`
701
+
702
+ | Prop | Type | Default | Notes |
703
+ |---|---|---|---|
704
+ | `justify` | `flex justify-content` | 'flex-start' | flex-start, center, space-between, space-around, space-evenly, flex-end, normal |
705
+ | `align` | `flex align-items` | 'stretch' | stretch, flex-start, center, flex-end, baseline |
706
+ | `direction` | `flex-direction` | 'row' | row, column and reverse |
707
+ | `wrap` | `flex-wrap` | 'nowrap' | nowrap, wrap, wrap-reverse |
708
+ | `gap` | `number \| string` | '0px' | The gap. A number is px, a string is CSS |
709
+ | `tag` | `string` | 'div' | Which HTML tag to render |
710
+
711
+ ## TaoSpace
712
+
713
+ Showcase section: `#flex`
714
+
715
+ | Prop | Type | Default | Notes |
716
+ |---|---|---|---|
717
+ | `direction` | `'row' \| 'column'` | 'row' | As in TaoFlex |
718
+ | `block` | `boolean` | false | display: flex without wrap |
719
+ | `expand` | `boolean` | false | 100% width |
720
+
721
+ **Slots, events, notes.** default — children with an even gap.
722
+
723
+ ## TaoGrid
724
+
725
+ Showcase section: `#grid`
726
+
727
+ | Prop | Type | Default | Notes |
728
+ |---|---|---|---|
729
+ | `min` | `string` | '220px' | The minimum tile width (auto-fill). A catalogue. Ignored with cols |
730
+ | `cols` | `number \| { compact, medium, expanded }` | 0 | Fixed columns (bento). A number: one column on compact, the number from medium on. An object: per width class of the grid itself (compact < 600px, medium < 840px, expanded), a missing class takes the smaller one. 0 — the min mode |
731
+ | `gap` | `number \| string` | token space-4 | The gap between cells. A number is px, a string is CSS |
732
+ | `rowHeight` | `number \| string` | — | The height of every row, as a mosaic wants: the grid keeps its proportions, a picture in a tile is cropped. Without it the rows follow the content |
733
+
734
+ **Slots, events, notes.** default — cards or TaoGridItem. Not masonry: the row follows the tallest. The width classes follow the width of the grid, not of the window (inside a TaoSplit pane too).
735
+
736
+ ## TaoGridItem
737
+
738
+ Showcase section: `#grid`
739
+
740
+ | Prop | Type | Default | Notes |
741
+ |---|---|---|---|
742
+ | `col` | `number \| 'full' \| { compact, medium, expanded }` | 1 | How many columns to take; 'full' is the whole row. Never more than there are. For cols, not for min |
743
+ | `row` | `number \| { compact, medium, expanded }` | 1 | How many rows to take. A number: 1 on compact, the number from medium on |
744
+ | `order` | `number \| { compact, medium, expanded }` | 0 | The place in the flow: { compact: 9 } sends a side block to the end on a phone |
745
+
746
+ **Slots, events, notes.** default — a tile. In a catalogue it can go without the wrapper.
747
+
748
+ ## TaoDivider
749
+
750
+ Showcase section: `#divider`
751
+
752
+ | Prop | Type | Default | Notes |
753
+ |---|---|---|---|
754
+ | `variant` | `'solid' \| 'dashed' \| 'colored' \| 'gap'` | 'solid' | solid — a regular border, dashed — dashes, colored — accent, gap — a gap |
755
+ | `text` | `string` | '' | An optional caption in the middle. Works with any variant |
756
+ | `fade` | `boolean` | false | Soft line edges. Does not affect gap |
757
+ | `size` | `'small' \| 'medium' \| 'large'` | 'medium' | For gap only — the height of the gap. Not inherited. |
758
+
759
+ **Slots, events, notes.** default — the same as text. If there is a slot, it wins over the prop.
760
+
761
+ ## TaoSplit
762
+
763
+ Showcase section: `#split`
764
+
765
+ | Prop | Type | Default | Notes |
766
+ |---|---|---|---|
767
+ | `v-model` | `number` | 50 | The size of the start pane in unit |
768
+ | `direction` | `'row' \| 'column'` | 'row' | As in Flex |
769
+ | `unit` | `'%' \| 'px'` | '%' | Percent or pixels |
770
+ | `min / max` | `number` | 0 / — | The bounds of the start pane |
771
+ | `minEnd` | `number` | 0 | The minimum of the second pane |
772
+ | `resizable` | `boolean` | true | false — the bar is there, but cannot be dragged |
773
+ | `step` | `number` | 1% or 8px | The arrow step when the bar is focused |
774
+ | `@change` | `value` | — | Finished dragging or an arrow was pressed. v-model fires on every move |
775
+
776
+ **Slots, events, notes.** #start and #end — the two panes. Three columns = two nested splits.
777
+
778
+ ## TaoFieldset
779
+
780
+ Showcase section: `#fieldset`
781
+
782
+ | Prop | Type | Default | Notes |
783
+ |---|---|---|---|
784
+ | `legend` | `string` | '' | A caption on the top frame |
785
+ | `align` | `'start' \| 'center' \| 'end'` | 'start' | Where to shift the legend |
786
+
787
+ **Slots, events, notes.** default — the fields. #legend — if the caption is not a string.
788
+
789
+ ## TaoAnimatedBorder
790
+
791
+ Showcase section: `#animated-border`
792
+
793
+ | Prop | Type | Default | Notes |
794
+ |---|---|---|---|
795
+ | `variant` | `'rainbow' \| 'tone'` | 'rainbow' | What the border is made of: the rainbow or the colours of a tone |
796
+ | `tone` | `TaoToneName` | 'accent' | The tone for variant="tone"; the theme accent without it |
797
+ | `colors` | `string[]` | — | Your own colours (any CSS colour), they win over variant |
798
+ | `radius` | `number \| string` | var(--tao-radius-panel) | Corner radius of the content; the border outside is that plus its width |
799
+ | `borderWidth` | `number` | 3 | The outline thickness in px |
800
+ | `speed` | `number` | 6 | The duration of one turn in seconds |
801
+ | `light` | `boolean` | false | A soft glow around the frame |
802
+ | `glow` | `number` | 16 | The glow radius in px. Makes sense with light |
803
+
804
+ **Slots, events, notes.** default — the content inside the frame. With prefers-reduced-motion the gradient stands still.
805
+
806
+ ## TaoModal
807
+
808
+ Showcase section: `#modal`
809
+
810
+ | Prop | Type | Default | Notes |
811
+ |---|---|---|---|
812
+ | `v-model` | `boolean` | — | Open. Required |
813
+ | `title` | `string` | '' | The title in the header |
814
+ | `closable` | `boolean` | true | The cross, Esc, a click on the backdrop |
815
+ | `closeLabel` | `string` | 'Close' | aria-label of the cross |
816
+
817
+ **Slots, events, notes.** default — the body. #footer — buttons. #close-icon — the cross icon.
818
+
819
+ ## TaoDrawer
820
+
821
+ Showcase section: `#drawer`
822
+
823
+ | Prop | Type | Default | Notes |
824
+ |---|---|---|---|
825
+ | `v-model` | `boolean` | — | Open. Required |
826
+ | `title` | `string` | '' | The title |
827
+ | `side` | `'left' \| 'right'` | 'right' | Where it slides in from |
828
+ | `closable` | `boolean` | true | Esc, the backdrop, the cross |
829
+ | `closeLabel` | `string` | 'Close' | aria-label of the cross |
830
+
831
+ **Slots, events, notes.** default — the body. #footer — buttons. #close-icon — the cross icon.
832
+
833
+ ## confirm()
834
+
835
+ Showcase section: `#confirm`
836
+
837
+ | Prop | Type | Default | Notes |
838
+ |---|---|---|---|
839
+ | `confirm()` | `() => Promise<boolean>` | | A chain in a single tick. true — ok, false — cancel / Esc / backdrop |
840
+ | `confirm(message)` | `(string) => Promise<boolean>` | | A short call with a text |
841
+ | `.title / .message` | `(string) => builder` | | The title and text |
842
+ | `.ok / .cancel` | `(label) => builder` | | Button captions |
843
+ | `.danger()` | `() => builder` | | A red confirm button |
844
+ | `confirm.defaults` | `({ ok, cancel })` | | Default captions for the whole app |
845
+
846
+ ## TaoTooltip
847
+
848
+ Showcase section: `#tooltip`
849
+
850
+ | Prop | Type | Default | Notes |
851
+ |---|---|---|---|
852
+ | `content` | `string` | — | The hint text. Required |
853
+ | `placement` | `TaoPlacement` | 'top' | Side and alignment: top / bottom / left / right and -start / -end. Flips at the screen edge |
854
+
855
+ **Slots, events, notes.** default — the trigger (a button, an icon…).
856
+
857
+ ## TaoPopover
858
+
859
+ Showcase section: `#popover`
860
+
861
+ | Prop | Type | Default | Notes |
862
+ |---|---|---|---|
863
+ | `v-model` | `boolean` | uncontrolled | Open state. Without v-model it holds its own |
864
+ | `placement` | `TaoPlacement` | 'bottom-start' | Side and alignment of the panel: top / bottom / left / right and -start / -end. Flips at the edge |
865
+ | `disabled` | `boolean` | false | Does not open |
866
+
867
+ **Slots, events, notes.** #trigger — the button. default — the panel content. Not a tooltip and not an action menu.
868
+
869
+ ## TaoDropdownMenu
870
+
871
+ Showcase section: `#dropdown`
872
+
873
+ | Prop | Type | Default | Notes |
874
+ |---|---|---|---|
875
+ | `items` | `TaoMenuItem[]` | [] | Entries: plain { id, label, icon?, shortcut?, disabled?, items? }, checkboxes { type: "checkbox", checked }, radios { type: "radio", group, checked }, { type: "label" }, { type: "separator" }. items inside an entry is a submenu |
876
+ | `placement` | `TaoPlacement` | 'bottom-end' | Where the list opens. Flips at the screen edge |
877
+ | `menuLabel` | `string` | 'Menu' | aria-label of the button and of the menu |
878
+ | `closeOnScroll` | `boolean` | false | Close when the page scrolls. Off: the menu follows its button |
879
+
880
+ **Slots, events, notes.** #icon — the trigger icon, #button — the whole button content, #item="{ item, id, label, icon }" — your own item face. The select event — the item id. shortcut is a ready string to show: the menu neither parses nor listens to it.
881
+
882
+ ## TaoMenu
883
+
884
+ Showcase section: `#dropdown`
885
+
886
+ | Prop | Type | Default | Notes |
887
+ |---|---|---|---|
888
+ | `items` | `TaoMenuItem[]` | | The same entries |
889
+ | `open` | `boolean` | | Whether it is open. The owner closes it on the close event |
890
+ | `anchor` | `HTMLElement \| null` | | What the panel hangs from |
891
+ | `placement` | `TaoPlacement` | 'bottom-end' | Side and alignment |
892
+ | `label` | `string` | — | Accessible name of the menu |
893
+
894
+ **Slots, events, notes.** Event select — the item id, close(reason) — the menu asks to be closed (escape / select / outside / tab). The panel for your own shells: a button, a context menu, a menu bar.
895
+
896
+ ## TaoMenubar
897
+
898
+ Showcase section: `#menubar`
899
+
900
+ | Prop | Type | Default | Notes |
901
+ |---|---|---|---|
902
+ | `items` | `TaoMenuItem[]` | — | The top entries: { id, label, items } is a menu, { id, label } a plain action. Inside a menu, everything TaoMenu can do (submenus, checkboxes, radios, shortcuts). Separators and labels at the top level are ignored |
903
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The height of the bar, as for the controls |
904
+ | `ariaLabel` | `string` | 'Menu bar' | Accessible name of the bar |
905
+ | `closeOnScroll` | `boolean` | false | Close an open menu when the page scrolls. Off: it follows its entry |
906
+
907
+ **Slots, events, notes.** The select event — the id of the picked item (in a menu or a plain top entry). #item — your own item face in the menus. Keys: Tab enters the bar, ← → walk it, Home / End, ↓ / Enter / Space open, with a menu open ← → move to the neighbour menu, Esc closes and gives the focus back. No folding of entries into “…” on a narrow bar yet.
908
+
909
+ ## TaoContextMenu
910
+
911
+ Showcase section: `#menubar`
912
+
913
+ | Prop | Type | Default | Notes |
914
+ |---|---|---|---|
915
+ | `items` | `TaoMenuItem[]` | — | The entries, as in TaoMenu |
916
+ | `disabled` | `boolean` | false | Leave the browser menu alone |
917
+ | `menuLabel` | `string` | 'Context menu' | Accessible name of the menu |
918
+ | `closeOnScroll` | `boolean` | true | Close when the page or a scroll container scrolls (the point moves away from under the menu). false keeps it at the screen point. Scrolling inside the menu never closes it |
919
+
920
+ **Slots, events, notes.** default — the area where the right click (or the Menu key / Shift+F10) opens the menu; the wrapper does not take part in the layout (display: contents). #item — your own item face. Events select — the item id, open({ x, y }) — where it opened. On iOS a long press sends no contextmenu: give it a button there.
921
+
922
+ ## TaoSpoiler
923
+
924
+ Showcase section: `#spoiler`
925
+
926
+ | Prop | Type | Default | Notes |
927
+ |---|---|---|---|
928
+ | `v-model` | `boolean` | uncontrolled | Open / closed. Without a model — defaultOpen |
929
+ | `title` | `string` | '' | The button title |
930
+ | `name` | `string \| number` | — | The panel key inside TaoSpoilerGroup |
931
+ | `defaultOpen` | `boolean` | false | The initial state, if there is no v-model |
932
+ | `@change` | `value` | — | The user opened or closed it |
933
+
934
+ **Slots, events, notes.** default — the body. Neighbours do not close each other.
935
+
936
+ ## TaoSpoilerGroup
937
+
938
+ Showcase section: `#spoiler`
939
+
940
+ | Prop | Type | Default | Notes |
941
+ |---|---|---|---|
942
+ | `v-model` | `string \| number \| null` | uncontrolled | The key of the open panel. null — all closed. Without a model the group remembers the key itself |
943
+
944
+ **Slots, events, notes.** default — a set of TaoSpoiler with name.
945
+
946
+ ## TaoNav
947
+
948
+ Showcase section: `#tao-nav`
949
+
950
+ | Prop | Type | Default | Notes |
951
+ |---|---|---|---|
952
+ | `items` | `TaoNavItem[]` | — | { id, label, icon?, href?, badge?, disabled? }. With href the item is an <a> link, without it a button. badge: a number or a string is a count, true a dot |
953
+ | `v-model` | `string` | — | The id of the current section: aria-current="page" and the active look |
954
+ | `layout` | `'auto' \| 'bar' \| 'rail' \| 'drawer'` | 'auto' | bar — a bottom bar, rail — a rail with icons, drawer — a side panel with labels. auto — by the width of TaoNav itself: bar below 600px, rail below 840px, drawer from 840px (container queries, no JS) |
955
+ | `maxBarItems` | `number` | 5 | How many fit the bar. With more items maxBarItems − 1 stay, the rest go into «More» with a menu |
956
+ | `ariaLabel` | `string` | 'Navigation' | Accessible name of the navigation |
957
+ | `moreLabel` | `string` | 'More' | The label of «More» |
958
+
959
+ **Slots, events, notes.** default — the page: TaoNav lays it out next to the navigation (the bar sticks to the bottom, on the side the list sticks to the top; env(safe-area-inset-bottom) is kept). Without the slot it is a standalone panel with a border. #label — your own item label ({ item, active }). Events: update:modelValue, select(id, event) — event.preventDefault() keeps a link from navigating, to route it yourself.
960
+
961
+ ## TaoTabs
962
+
963
+ Showcase section: `#tabs`
964
+
965
+ | Prop | Type | Default | Notes |
966
+ |---|---|---|---|
967
+ | `v-model` | `string` | — | value of the active tab. Required |
968
+ | `items` | `TaoTabItem[]` | — | { value, label, disabled? } — like Select options |
969
+ | `@change` | `value` | — | The user picked another tab |
970
+ | `justify` | `TaoJustify` | — | Where the tabs sit in the row, as in TaoFlex: flex-start, center, flex-end, space-between, space-around, space-evenly. Without it, at the left |
971
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | The tab height as TaoButton (26 / 36 / 44). Without it — the size of the ancestors |
972
+
973
+ **Slots, events, notes.** default="{ key }" — the content of the active panel.
974
+
975
+ ## TaoBreadcrumb
976
+
977
+ Showcase section: `#breadcrumb`
978
+
979
+ | Prop | Type | Default | Notes |
980
+ |---|---|---|---|
981
+ | `items` | `{ label, to? }[]` | — | The crumbs. The last one is the current page, without a link. Required |
982
+ | `ariaLabel` | `string` | 'Breadcrumb' | The navigation name |
983
+
984
+ ## TaoLink
985
+
986
+ Showcase section: `#link`
987
+
988
+ | Prop | Type | Default | Notes |
989
+ |---|---|---|---|
990
+ | `to` | `string \| object` | — | The address. NuxtLink → RouterLink → <a> |
991
+ | `newTab` | `boolean` | false | target=_blank + rel=noopener |
992
+ | `private` | `boolean` | false | rel=noopener noreferrer |
993
+ | `exactPath` | `boolean` | false | An exact path match for active (vue-router) |
994
+
995
+ **Slots, events, notes.** default — the link text.
996
+
997
+ ## TaoScrollTop
998
+
999
+ Showcase section: `#scrolltop`
1000
+
1001
+ | Prop | Type | Default | Notes |
1002
+ |---|---|---|---|
1003
+ | `variant` | `'solid' \| 'ghost' \| 'text'` | 'solid' | The look: a filled circle, a light circle or a caption with an arrow |
1004
+ | `side` | `'left' \| 'right'` | 'right' | Which edge of the page the button sits on |
1005
+ | `offset` | `number \| string` | 24 | The offset from that edge (older name: right) |
1006
+ | `label` | `string` | — | The caption: on mouse hover (not touch) for solid / ghost, always visible for text (the locale text by default); an empty string hides it |
1007
+ | `labelSide` | `'left' \| 'right'` | — | Which side the caption goes; opposite to side by default |
1008
+ | `boundary` | `number` | 300 | The threshold in px: it appears on a reverse scroll after it |
1009
+ | `size` | `number` | 40 | The button size in px |
1010
+ | `bottom` | `number \| string` | 24 | The offset from the bottom edge |
1011
+ | `zIndex` | `number` | 1000 | The layer |
1012
+ | `ariaLabel` | `string` | 'Back to top' | The accessible name |
1013
+ | `outline` | `boolean` | true | The focus outline |
1014
+
1015
+ ## toast()
1016
+
1017
+ Showcase section: `#toast`
1018
+
1019
+ | Prop | Type | Default | Notes |
1020
+ |---|---|---|---|
1021
+ | `toast()` | `() => builder` | | A chain in a single tick, shown on the next one |
1022
+ | `toast.success(msg)` | `(string, options?) => builder` | | A short call. Also error / warning / info / show |
1023
+ | `.success() / .danger() / …` | `() => builder` | | The type. show() is neutral |
1024
+ | `.title / .message` | `(string) => builder` | | The title and text |
1025
+ | `.short() / .timeout(ms)` | `() => builder` | | 1 s or your own time |
1026
+ | `.byBottomRight() / …` | `() => builder` | | The corner: top/bottom + left/right/center |
1027
+ | `.action(label, fn)` | `(string, fn) => builder` | | A button in the toast |
1028
+ | `toast.defaults` | `(partial) => toast` | | Position, timeout, closeLabel for the whole app |
1029
+
1030
+ ## TaoAlert
1031
+
1032
+ Showcase section: `#alert`
1033
+
1034
+ | Prop | Type | Default | Notes |
1035
+ |---|---|---|---|
1036
+ | `tone` | `'success' \| 'danger' \| 'warning' \| 'info' \| 'neutral'` | 'info' | The status colour, as TaoButton |
1037
+ | `title` | `string` | '' | The title. Can be omitted |
1038
+ | `closable` | `boolean` | false | The cross. It does not unmount itself — it fires close |
1039
+ | `closeLabel` | `string` | 'Close' | aria-label of the cross |
1040
+ | `collapsible` | `boolean` | false | The body folds under the title (the title is the toggle, aria-expanded); the tone stays. Folded text stays in the DOM, find-in-page opens it |
1041
+ | `v-model:collapsed` | `boolean` | own | Folded or not; v-model:collapsed="true" starts folded. Better open for an error |
1042
+ | `detailsLabel` | `string` | 'Details' | The toggle text when there is no title |
1043
+
1044
+ **Slots, events, notes.** default — the text. #close-icon. v-if + @close — to hide it.
1045
+
1046
+ ## TaoTag
1047
+
1048
+ Showcase section: `#tag`
1049
+
1050
+ | Prop | Type | Default | Notes |
1051
+ |---|---|---|---|
1052
+ | `tone` | `'neutral' \| 'success' \| 'danger' \| 'warning' \| 'info' \| ''` | '' | The status colour, as TaoButton |
1053
+ | `flat` | `boolean` | false | No border, the fill stays |
1054
+ | `size` | `'small' \| 'medium' \| 'large'` | inherited | Height 18 / 20 / 24. Without it — the size of the ancestors |
1055
+ | `closable` | `boolean` | false | The cross. Fires close, does not touch the array itself |
1056
+ | `clickable` | `boolean` | false | A pointer cursor (a clickable chip), as TaoListItem / TaoTable |
1057
+ | `color / background / borderColor` | `string` | — | Override the tokens by hand |
1058
+
1059
+ **Slots, events, notes.** default — the text. #prefix — an avatar or an icon on the left.
1060
+
1061
+ ## TaoLoader
1062
+
1063
+ Showcase section: `#loader`
1064
+
1065
+ | Prop | Type | Default | Notes |
1066
+ |---|---|---|---|
1067
+ | `size` | `number \| string` | 80 | The size. A number is px |
1068
+ | `color` | `string` | accent token | The dot colour |
1069
+ | `inline` | `boolean` | false | Inline, without block centring |
1070
+
1071
+ ## TaoImage
1072
+
1073
+ Showcase section: `#image`
1074
+
1075
+ | Prop | Type | Default | Notes |
1076
+ |---|---|---|---|
1077
+ | `src` | `string` | '' | The image address |
1078
+ | `alt` | `string` | '' | The alternative text |
1079
+ | `lazy` | `boolean` | false | The native loading="lazy" |
1080
+ | `pixelated` | `boolean` | false | image-rendering: pixelated |
1081
+ | `placeholderText` | `string` | 'No image available' | The text if src is empty or fails |
1082
+
1083
+ ## TaoAvatar
1084
+
1085
+ Showcase section: `#avatar`
1086
+
1087
+ | Prop | Type | Default | Notes |
1088
+ |---|---|---|---|
1089
+ | `src` | `string` | '' | A photo. If empty — initials from name |
1090
+ | `name` | `string` | '' | For the initials and alt |
1091
+ | `size` | `'small' \| 'medium' \| 'large'` | 'medium' | 24 / 32 / 48px. Content, does not inherit the size of ancestors. |
1092
+ | `dot` | `boolean \| tone` | false | The status dot. true = success |
1093
+ | `count` | `number \| string` | — | A badge. 0 and empty are not drawn, >99 → 99+ |
1094
+
1095
+ ## TaoIcon
1096
+
1097
+ Showcase section: `#icon`
1098
+
1099
+ | Prop | Type | Default | Notes |
1100
+ |---|---|---|---|
1101
+ | `name` | `string` | — | tao-… is a built-in SVG; a name from registerTaoIcons; any other name is the class icon-{name} of your font. Required |
1102
+ | `size` | `number` | — | Pixels. Without it an SVG icon is 1em (follows the font size) |
1103
+ | `margin` | `string` | '0px' | The outer margin |
1104
+ | `invert` | `boolean` | false | Invert the colour |
1105
+
1106
+ **Slots, events, notes.** #prefix / #postfix — next to the icon. registerTaoIcons({ name: { body, viewBox? } }) adds your own SVGs; the prefix tao- is reserved.