@1337exp/taoui 4.0.1 → 5.0.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 +314 -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 +2009 -701
  6. package/dist/{index.mjs → index.js} +3867 -2808
  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 +1105 -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
package/CHANGELOG.md CHANGED
@@ -1,220 +1,314 @@
1
- # Changelog
2
-
3
- ## 4.0.1
4
-
5
- - **TaoScrollTop:** the ripple is gone. It painted the wave in a tint that disappeared on the accent fill, so it was practically invisible and cost a DOM node, a timer and an `overflow: hidden` clip. The button now has the same 1px press as `TaoButton`.
6
-
7
- ## 4.0.0
8
-
9
- ### Breaking: English is the default language
10
-
11
- - **Built-in texts are English by default** (they were Russian): placeholders, “Clear”, aria labels, `toast` / `confirm()` defaults, calendar captions. The date helpers (`formatTaoDateLabel` and friends) default to `en-US` instead of `ru-RU`, and `TaoDate` / `TaoDateRange` follow the active locale as before.
12
- - **To stay on Russian**, pass the locale once: `app.use(TaoUI, { locale: localeRu })`, or `setTaoLocale(localeRu)` without the plugin. `localeRu` and `localeEn` are both still exported, nothing else changed in the locale API.
13
- - `setTaoLocale(overrides)` now merges on top of English (it merged on top of Russian). Pass `setTaoLocale(overrides, localeRu)` to keep the old base.
14
-
15
- ### Minimum width
16
-
17
- - **`TaoButton` `minWidth`** (number = px, or any CSS length) and the **`--tao-button-min-width`** variable; default `0`, so nothing changes until you set it. Set the variable on one button, on a container or on `:root`.
18
- - **`TaoSegmented` `minWidth`** and **`--tao-segmented-option-min-width`**: the minimum width of every option, including in `block` mode.
19
-
20
- ## 3.4.1
21
-
22
- - **Fix:** `TaoScrollTop` `variant="text"` could not be shown without a caption: `label=""` now hides it, leaving just the arrow button (the accessible name stays).
23
-
24
- ## 3.4.0
25
-
26
- ### TaoScrollTop
27
-
28
- - **`variant`:** `solid` (default, as before), `ghost` (a light circle on a raised surface with a hairline border) and `text` (a bare uppercase caption with an arrow, always visible).
29
- - **`label`:** a caption that appears beside the button on mouse hover (`@media (hover: hover) and (pointer: fine)`, so never on touch) and on keyboard focus. For `text` it is always shown and defaults to the locale text.
30
- - **`side`** (`left` / `right`) picks the page edge, **`offset`** is the distance from it (`right` stays as its older name). **`labelSide`** puts the caption left or right of the button; by default it is the side opposite to `side`, so it opens towards the page, and an explicit value wins.
31
- - **Fix:** the button had no accessible name unless `ariaLabel` was passed; it now falls back to `label`, then to the locale text.
32
- - **Fix:** `size`, `bottom` and `zIndex` react to prop changes (they were read once at setup).
33
- - The root is now a positioning wrapper around the button: fall-through attributes (`class`, `data-*`, …) still land on the button, but a `style` that moves the button should go to `bottom` / `offset` props instead.
34
-
35
- ## 3.3.2
36
-
37
- - **Fix:** the focus trap of Modal, Drawer and `confirm()` no longer lets focus escape in Safari on macOS, where Tab skips buttons and links by default. After a Tab the trap checks that focus is still inside the dialog and pulls it back if not.
38
-
39
- ## 3.3.0
40
-
41
- ### Presentation
42
-
43
- - **Showcase in English and Russian:** language switch in the header, `?lang=`, built-in component texts follow the page. English is the default.
44
- - **Static showcase build** with relative paths (`npm run showcase:build`), ready for any folder such as `/sandbox/taoui/`.
45
- - Repository polish: `LICENSE` (MIT), `CONTRIBUTING.md` (with the colour-token rules), `SECURITY.md`, CI, issue / PR templates, a media pipeline (`npm run media`) that captures the screenshots and clips in `docs/media`.
46
-
47
- ### Light theme
48
-
49
- - **Light theme has its own palette** (taken from the original 666.io site) instead of a copy of the dark one: rose accent `#ff227a` (hover `#e60f66`, active `#c70a55`), black links that turn `#dc4679` on hover, white text on accent. New primitives `--tao-pink-400 … 700`.
50
- - **Text on a solid danger fill is white in every theme** (new token `--tao-color-on-danger`); it used to follow `text-strong`, which is near-black in the light theme (danger Button, Avatar count).
51
- - Light theme: idle text of Segmented and Tabs (`--tao-color-text-subtle`) is darker (`gray-600`).
52
- - **Fix:** `TaoInputNumber` ± buttons no longer overflow in the `small` size.
53
- - New optional token `--tao-button-primary-text-shadow` (none by default; the light theme sets a soft one).
54
- - The light theme no longer inherits the dark theme's glowing link shadow.
55
-
56
- ### Status colours as text
57
-
58
- - **New tokens `--tao-color-{danger,success,warning,info}-text` and `-text-hover`** for status colours used as text. The plain tokens are the solid-fill shades (white text on top); as text on a dark page they were dim (danger about 4:1). The text tokens use lighter shades in the dark theme and darker ones in the light theme (new primitives `green-700`, `yellow-700`, `blue-700`), at least 4.5:1 on the page and on raised surfaces, enforced by `tests/tokens.test.ts`.
59
- - Used by `text` / `ghost` / `secondary` Button tones, Tag, Stages, FileDrop, FormField and the error text of Input and Textarea. Fills, borders and toasts are unchanged.
60
-
61
- ### Feedback
62
-
63
- - **toast():** a light shadow hugging the edge (hook `--tao-toast-shadow`) instead of the large overlay shadow, which showed as a wide smear on stacked toasts.
64
- - **`TaoButton` `tone="neutral"`** for `ghost` and `text`: strong text colour with the soft accent wash on hover.
65
- - **confirm():** the cancel button is `ghost` with `tone="neutral"`, so the primary action stands out and the dialog feels lighter.
66
-
67
- ## 3.2.1
68
-
69
- - **TaoColorPicker:** the HEX label sits above the field, like the labels over the RGB / HSL channels, so the row keeps its height in every mode.
70
-
71
- ## 3.2.0
72
-
73
- - **TaoPinCode `format`:** `format="#-##-##"` draws visual separators between cells. They are not part of the value; a paste in that shape, or as a clean code, is split into cells.
74
- - **TaoColorPicker:** fixed width, so switching HEX / RGB / HSL no longer resizes the popover.
75
-
76
- ## 3.1.1
77
-
78
- - **Popovers close on an outside press in the capture phase**, so a component that stops propagation can no longer keep a popover open.
79
- - **TaoColorPicker:** text is centred in the HEX, RGB and HSL fields.
80
-
81
- ## 3.1.0
82
-
83
- ### Colour
84
-
85
- - **New `TaoColorPicker`**: square of saturation and brightness, hue and opacity strips, a hex field, swatches, the eyedropper where the browser has `EyeDropper`. `v-model` is a hex string (`#rrggbb`, with `alpha` also `#rrggbbaa`); keyboard: arrows move the cursor (Shift is ten times bigger).
86
- - **Input modes**: HEX, RGB and HSL numbers, switched under the square (`modes` limits them, `v-model:mode` remembers the choice). Opacity is a percent field in RGB and HSL. `parseColor` reads `hsl()` and `hsla()` too; `rgbToHsl` and `hslToRgb` are exported.
87
- - **New `TaoColorInput`**: a field with a swatch and the hex text; the picker opens in a popover.
88
- - **`colorModel(source, options)`** turns your own colour storage (object, array, css string; 0…255 or 0…1; sRGB or linear) into a writable hex string for `v-model`. The pure helpers (`parseColor`, `toHex`, `rgbaToHsva`, `srgbToLinear`, ...) are exported too.
89
- - `TaoSlider`: `ariaLabel` prop and CSS hooks `--tao-slider-track-bg`, `--tao-slider-fill-bg`, `--tao-slider-thumb-bg` (the picker colours its strips with them).
90
- - Locale section `colorPicker`.
91
-
92
- ## 3.0.0
93
-
94
- Cleaner slider family. Breaking changes are allowed in this major: quality over compatibility.
95
-
96
- ### Slider
97
-
98
- - **New `TaoRangeSlider`**: two thumbs, `v-model` is a `[from, to]` pair, `minGap` keeps the thumbs apart.
99
- - **`TaoSlider` and `TaoRangeSlider` share props:** `marks` (`true` for automatic ticks, numbers, or `{ value, label? }`),
100
- `discrete` (the value only sits on marks: stepped scales with captions), `format`, `vertical`, plus the old
101
- `min / max / step / variant / size / showValue / disabled / error / wheel`. Clicking a mark caption moves the nearest thumb.
102
- Slot `#mark="{ mark, active }"` draws a custom caption.
103
- - **`marksSide`** (`'end'` by default, or `'start'`) puts the marks above a horizontal slider / left of a vertical one.
104
- - **`flat`** hides the round thumbs (a plain filled bar); they stay in the markup for keyboard and screen readers.
105
- - **Pure logic in `src/slider.ts`** (value ↔ position, steps without float tails, nearest thumb, marks) with unit tests.
106
-
107
- ### Fixes
108
-
109
- - **TaoSlider takes focus on press** (it used to keep it in a text field). The field blurs first and commits its text, then the slider
110
- sets the value.
111
- - **TaoInputNumber:** a value changed from outside (a slider, another field) now replaces the draft of a focused field, so blur does not
112
- write the stale text over it. Typing is not affected: the echo of the field's own value does not overwrite the draft.
113
-
114
- - **A range collapsed into one point can be pulled apart again:** pressing exactly on the point decides the thumb by the direction of the
115
- first move (right: the upper one, left: the lower one). With `flat` such a range shows a small dash instead of disappearing.
116
-
117
- - **No focus ring after a mouse press:** the ring is for the keyboard; it comes back on the first key press.
118
-
119
- ### Timeline
120
-
121
- - **New `TaoTimeline`**: play / pause and «to start» buttons, a slider over time with event marks, a «time / length» label.
122
- `v-model` is the time, `v-model:playing` the play state; `pauseOnScrub` pauses when the user grabs the slider; `marks`, `marksSide`,
123
- `format`, `showRestart`, `showTime`, `variant`, `size`, slots `#mark` and `#time`. It does not advance the time itself: drive it with
124
- anything (for example `usePlayback` from `@1337exp/taoux/playback`). New locale section `timeline` (`playLabel`, `pauseLabel`, `restartLabel`).
125
-
126
- ### Breaking
127
-
128
- - `TaoSlider` `v-model` is a **number** now; the `number | string` form is gone.
129
- - **Right-click to type a value is gone** (with the `placeholder` prop): use `TaoInputNumber` next to the slider.
130
- - **Markup:** the root is a `group`; each thumb is its own focusable `role="slider"` (keys go to the thumb, `id` for labels is on the first thumb).
131
- The pointer area is `.tao-slider__rail`; the root also holds the marks.
132
- - `wheel` works for a single thumb only.
133
-
134
- ## 2.0.0
135
-
136
- One size scale, one API standard, built-in texts in any language. Old prop and event names keep working
137
- as deprecated aliases and print a warning in development builds; they will be removed in 3.0.
138
-
139
- ### Breaking
140
-
141
- - **Size modifier classes are gone.** Sizes now come from CSS variables set by `.tao-size-small` / `-medium` / `-large`.
142
- If your CSS targeted these classes, switch to `.tao-size-*` or the variables:
143
- `tao-button--small|medium|large`, `tao-select--small|large`, `tao-combobox--small|large`,
144
- `tao-select__panel--*`, `tao-combobox__panel--*`, `tao-segmented--*`, `tao-segmented-option--small|medium|large`,
145
- `tao-pagination--small`, `tao-table--compact`, `tao-list--*`, `tao-list-item--s|m|l`, `tao-file-drop__zone--*`,
146
- `tao-slider--small` (now `tao-slider--thin`), `tao-textarea--no-border` / `--center`
147
- (now `--filled` / `--plain` / `--align-center`).
148
- - **`size` has no default any more — it inherits.** A control without `size` takes the size of its ancestors,
149
- `medium` at the root, so pages without `.tao-size-*` look the same.
150
- - **`--tao-field-height` is now an alias of `--tao-control-height`** and follows the current size.
151
- Overriding it no longer changes field height — override `--tao-control-height-medium` instead.
152
- - **TaoSlider `size="small"` is a smaller bar now, not the thin track.** Use `variant="thin"` for seek / volume.
153
- - **Small visual changes:**
154
- - Pagination `small` buttons 28 → 26px;
155
- - List rows `small` 32 → 26px, `large` 48 → 44px, titles 12 / 14 / 16px;
156
- - Table `size="small"` (old `compact`) cell text 13 → 12px;
157
- - Tag is 20px in medium with or without the close button (was 19 / 22);
158
- - Tabs tab 37 → 36px (Button height);
159
- - icon-only Segmented options are square;
160
- - Textarea min-height equals the control height;
161
- - Select / Combobox `large`: the clear and empty rows are 14px;
162
- - Textarea `dummy` no longer shows a red bar.
163
- - **TaoCarousel on mouse / trackpad** scrolls freely and settles on a whole slide after it stops
164
- (CSS snap stays only on touch screens). A mouse drag keeps its momentum.
165
-
166
- ### Added
167
-
168
- - **Sizes.** `TaoSize` (`small | medium | large`) on Button, Input, InputNumber, Quantity, Textarea, Select, Combobox,
169
- Date, DateRange, Segmented, Checkbox, Radio / RadioGroup, Switch, Tag, Tabs, Pagination, FileDrop, Slider, Table,
170
- List, PinCode, InputGroup and FormField. `class="tao-size-small"` on any element sizes the whole block.
171
- Tokens: `--tao-control-height` / `-padding-x` / `-padding-y` / `-font-size` / `-font-size-secondary`,
172
- `--tao-button-padding-x`, `--tao-indicator-size`, `--tao-tag-height` / `-padding-x` / `-font-size`.
173
- - **Locale.** `app.use(TaoUI, { locale: localeEn })`, `setTaoLocale()`, `localeRu` (default), `localeEn`,
174
- types `TaoLocale`, `TaoLocaleOverrides`, `TaoUIOptions`. Pass a few keys to change single texts.
175
- Switching at runtime updates components already on the page.
176
- - **Surfaces.** `surface` on TaoCard / TaoBlock (`flat | grain | glass`, type `TaoSurface`) and classes
177
- `.tao-surface-grain` / `-glass` for any element. Theme tokens `--tao-surface-grain-image` / `-size`,
178
- `--tao-glass-fill` / `-border` / `-blur`. Toast and confirm are glass by default (`surface` in their defaults, options
179
- and builders; `'flat'` turns it off). Glass falls back to a solid panel without blur support or with
180
- `prefers-reduced-transparency`.
181
- - **`error`** on InputNumber, Quantity, Switch, Segmented, Radio, RadioGroup, Slider and PinCode.
182
- - **`change`** on Slider, Split (on release), Spoiler, Tabs; FileDrop and Table got `change` too.
183
- - **PinCode** `disabled`, `size`, `masked`. **Textarea** `variant` (`bar | outline | filled | plain`), `readonly`,
184
- `align`, `autofocus`, `blurOnEnter`. **Checkbox** `checked`. **Container** `width`. **Link** `newTab`.
185
- **ScrollTop** `outline`. **Space / Stages** `direction`. **Copy** `successText`. **Tabs** `items`.
186
- - **Types** `TaoTone`, `TaoLength` (number → px, string → CSS), `TaoTabItem`.
187
- - Length props accept both numbers and strings: Block / Card `padding` and `radius`, Flex / Grid `gap`,
188
- Grid `min`, List / Table `maxHeight`.
189
- - Dev-only warnings for deprecated props, events and values (once per component and name).
190
- - Tests (`npm test`, Vitest).
191
-
192
- ### Fixed
193
-
194
- - Textarea `noSpace` also strips spaces from pasted text.
195
- - Textarea `borderInverse` turns red on error.
196
- - Slider is marked invalid inside an invalid TaoFormField.
197
-
198
- ### Deprecated → use instead
199
-
200
- | Component | Deprecated | Use |
201
- |---|---|---|
202
- | Alert, Tag | `type` | `tone` |
203
- | Tag | `pointer` | `clickable` |
204
- | Input | `label`, `errorMessage` | `label` / `error` of TaoFormField |
205
- | Textarea | `noBorder`, `noBackground` | `variant="filled"`, `variant="plain"` |
206
- | Textarea | `dummy`, `textCenter`, `autoFocus`, `submitOnEnter`, `borderInverse` | `readonly`, `align="center"`, `autofocus`, `blurOnEnter`, `variant` |
207
- | Table | `compact`, event `sort` | `size="small"`, event `change` |
208
- | FileDrop | event `files` | event `change` |
209
- | DropdownMenu | event `selected` | event `select` |
210
- | Tabs | `tabs`, item `key` | `items`, item `value` |
211
- | Checkbox | `value` (boolean) | `checked` or v-model |
212
- | PinCode | `hidden` | `masked` |
213
- | Copy | `successMessage` | `successText` |
214
- | ScrollTop | `hasOutline`, `tabindex` prop | `outline`, plain `tabindex` attribute |
215
- | Link | `asNewTab` | `newTab` |
216
- | Space, Stages | `vertical` | `direction` |
217
- | Container | `size` | `width` |
218
- | Avatar | `size="s"` / `"m"` / `"l"` | `small` / `medium` / `large` |
219
- | Divider | `size="big"` | `size="large"` |
220
- | — | `TaoSegmentedSize` | `TaoSize` |
1
+ # Changelog
2
+
3
+ ## 5.0.0
4
+
5
+ A foundation release: shared mechanisms instead of per-component copies, and a clean API. Everything deprecated since 2.0 is removed, so read [MIGRATION-5.md](MIGRATION-5.md) first. Why and how: `docs/v5-plan.md`.
6
+
7
+ In numbers: the tarball is 329 KB (560 KB before the ESM-only build), 451 tests (183 before), one floating-panel engine instead of eight copies, 27 built-in icons instead of three icon mechanisms, one tone mechanism instead of six. TaoUX 0.2.0 and taofx follow it.
8
+
9
+ ### Breaking
10
+
11
+ - **Every name deprecated since 2.0 is removed**, with the tone alias `error` (Alert, Tag, Avatar `dot`, `toast`). The table old → new is in [MIGRATION-5.md](MIGRATION-5.md).
12
+ - `TaoTabItem` is a plain `{ value, label, disabled? }`; `TaoSegmentedSize` and `TaoListSize` are gone (use `TaoSize`); `--tao-field-height` and `--tao-color-text-on-accent` are gone.
13
+
14
+ ### Palettes
15
+
16
+ - **White labels on light-mode fills:** the text colour on a fill is picked by APCA (`apcaContrast` and `contrastRatio` are exported; README «Contrast: WCAG 2 and APCA» explains both), the contrast model of the coming WCAG 3, instead of the larger WCAG 2 ratio, which overrates black on mid-tones (on `#2ea85c` WCAG 2 says black 6.4 vs white 3.1, the eye and APCA say white Lc 62 vs black 47). In light mode every palette now puts a white label on its accent and statuses, the fill moved a little deeper to keep 4.5:1 (Pinheiro `#27997a` → `#008567`); dark mode keeps its light accents with a dark label. A status is now measured against the accent after it is fitted for its label, so a deeper status cannot come close to the accent. The default light theme follows: success / warning / info are `green-700` / `yellow-700` / `blue-600` with a white label (they had a dark one).
17
+ - **Seven ready palettes** (`sunset`, `marple`, `violet-dusk`, `ocean-blue`, `pinheiro`, `tokyo-night`, `lagoon`), each with a dark and a light mode: `import '@1337exp/taoui/palettes.css'`, then `data-tao-theme="sunset"` (+ `data-tao-mode="light"`). They are separate opt-in files, the core stylesheet did not grow.
18
+ - **A palette is four colours.** The accent is picked by lightness and moved only along lightness until it is seen (3:1), carries text (4.5:1) and reads as text (4.5:1); the surfaces are a tint of the palette's deepest hue; the statuses keep their hue sector but share the palette's lightness and chroma, and are pushed away from the accent when they would be mistaken for it. A palette can name its accent stop or a status colour when the automatic choice is not right.
19
+ - **`applyTaoPalette(def, mode, el?)`** puts the same roles on the page (or an element) at run time, for your own palette or a colour a user picked; `taoPaletteCss(def)` returns the CSS; `taoPalettes` is the list for a picker. The code is `src/palette.ts` (OKLCH maths, no dependencies); the preset files are generated from it (`npm run palettes`) and a test keeps them equal.
20
+ - **New roles** in both default themes: `--tao-color-accent-2`, `--tao-glow`, `--tao-gradient`, `--tao-bg-atmosphere`, and the class `.tao-atmosphere` (a static glow behind the page, no blur). `data-tao-mode="light" | "dark"` works next to `data-tao-theme`.
21
+ - 150 palette tests: contrast of the accent, its text and every status in both modes of every palette, statuses told apart from the accent, hue sectors, no invented roles, the files equal the generator.
22
+ - The showcase has a palette picker (with the four colours of the chosen one) next to the dark / light switch; the choice is remembered.
23
+
24
+ ### Packaging
25
+
26
+ - **A skill for AI assistants** ships in the package: `skills/taoui/SKILL.md` (setup, rules, themes and contexts, layout, forms, overlays, mistakes to avoid) and `references/components.md`, generated from the showcase prop tables by `npm run skill`. `tests/skill.test.ts` keeps the reference generated and the skill naming every exported component, every palette and only tokens that exist. The repository has its own `.claude/skills/taoui-dev` for working on TaoUI.
27
+ - **ESM only.** The CommonJS build and its source map are gone (`dist/index.js`, `index.d.ts`, `styles.css`, one map): the tarball is smaller and there is one way to load the library. `require()` users switch to `import()`.
28
+ - `package.json`: `exports` with `types` + `default`, `sideEffects: ["**/*.css"]`, `files` include `MIGRATION-5.md`, `browserslist` (Chrome / Edge 111, Safari 16.4, Firefox 128; the build targets the same), the unused `nuxt` peer is removed.
29
+ - **Style files are laid out by layer:** `tokens/` (primitives, theme-independent semantic roles), `themes/` (`dark.css` holds the colour roles, `light.css`), `contexts/` (size, tone, surface), `base.css`. `styles.css` is the same bundle (dark and light).
30
+ - `npm run lint:package` (`publint` + `attw`) and the consumer smoke test run in CI; README has a "Browser support" section.
31
+
32
+ ### Components
33
+
34
+ - **New `TaoMarquee`** (from the home page's MarqueeText): one line that runs round only when it does not fit, with fading edges (the left one in a padding outside the text, so at rest the line stands in place) and a pause at the start of every round; only `transform` moves. It stops on hover (`pauseOnHover`), on focus (a running line is a tab stop) and on a tap, and `paused` stops it from the app (WCAG 2.2.2); with `prefers-reduced-motion` it wraps. The second round is `aria-hidden` and `inert`, so a link in the slot stays one tab stop. `text` or the default slot, `speed`, `gap`, `fade`; `measure()`.
35
+ - **Fixed: a `TaoCard` with only `#media` stretches its picture over the whole card again** (a mosaic tile): the stylesheet still named the old `tao-card--cover-only` class after the `cover` → `media` rename.
36
+ - **Adaptive bento in `TaoGrid`:** `cols`, and `col` / `row` / the new `order` of `TaoGridItem`, take a number or a value per width class of the grid itself (`compact` < 600px, `medium` < 840px, `expanded`, as TaoNav), mobile first; `col: 'full'` is the whole row, and a span never runs past the columns there are. `rowHeight` sets the height of every row (a mosaic keeps its proportions). **Fixed:** the narrow-grid rule never applied (a container query cannot ask an element about its own width): a narrow grid kept its columns and only lost the spans; the grid now has an outer element that measures and an inner `.tao-grid__cells` that lays out. A plain number still means one column on a phone, at 600px instead of 560px.
37
+ - **Crisp plus and minus:** an icon of only straight lines through the middle (`grid: true` in `TaoIconDef`; `tao-plus`, `tao-minus`) is drawn 2 screen pixels wide and snapped to the pixel grid. Scaled to 14–16px its 1.2px line used to fall between two pixels and go soft (4 solid pixels and 32 half-transparent ones at 14px, 28 / 8 now). Your own icons can set `grid` too.
38
+ - **Button labels are not selected** with the text around them: `user-select: none` on TaoButton, the tabs of TaoTabs, the entries of TaoMenubar and TaoNav, the TaoCopy button and the TaoSpoiler header (the rest already had it).
39
+ - **`TaoPinCode` `status`** (`idle | success | error`), set by the app after `complete`: `error` shakes the group once and paints the cells red (`aria-invalid`), `success` runs a soft glow over the cells from the left and paints them green; a hidden `role="status"` says it in words (`successText` / `errorText`). `play()` repeats the animation for a second wrong code; no motion with `prefers-reduced-motion`.
40
+ - **`TaoAlert` `collapsible`** with `v-model:collapsed`: the title becomes the disclosure button (`aria-expanded`, `aria-controls`), the tone stays; the folded body keeps its text in the DOM with `hidden="until-found"`, so find-in-page and links to text open the alert (`beforematch`). Without a title the toggle says «Details» (`detailsLabel`). The message is a `<div>` now (it was a `<p>`), so it can hold lists and blocks.
41
+ - **`stripe` on `TaoCard` and `TaoBlock`**: a coloured stripe on one side (`top | left | bottom`), `stripeTone` = a tone (accent by default) or `gradient` from the palette, so it follows the theme. It is a layer with the panel's own radius: the corners clip it, over a picture in `#media` too and with `overflow`. Token `--tao-stripe-width` (4px); the classes `.tao-stripe-*` work on any `.tao-panel`.
42
+ - **A checked box shows a tick** (TaoCheckbox, TaoChecklist, TaoTree): the square inside an accent box read as an empty frame at a glance. The shape is in percentages of the box, the same in every size; a mixed box is still a dash.
43
+ - **New `TaoTimeline`, a vertical event feed** (the name of the old player, now `TaoScrubber`): `TaoTimelineItem` with `title`, `time` + `datetime` (`<time>`), `description`, `icon`, `tone`. `active` makes it a progress (the line filled up to the current event, `aria-current="step"`, the next ones upcoming), without it a log of the past. `align="alternate"` puts the events on both sides and folds into one side below 480px of its own width (a container query). Slots `#marker`, `#title`, `#content` with `{ item, index, state, active }`.
44
+ - **New `TaoChecklist`**: checkboxes with one model, the checked values in the order of the items (`TaoChecklistItem`: `value`, `label`, `description`, `disabled`). `selectAll` with a mixed state (it leaves a disabled item alone), `counter` «3 of 5» (`aria-live`), `strike` for a to-do list (the whole text of a done item, its description too). A fieldset with a legend; in a `TaoFormField` the group takes the id, the label and the error, the checkboxes inside keep ids of their own.
45
+ - **New `TaoTree`**: a tree of files or objects (`TaoTreeNode`: `id`, `label`, `icon`, `children`, `hasChildren`, `disabled`). `v-model:expanded`, `selection` `none | single | multiple` with `v-model:selected`, `checkable` with `v-model:checked` (the model holds the nodes without children; parents are checked / mixed by them, a click toggles a whole branch), lazy children through `load(node)` with a spinner, `aria-busy` and `load-error`. The ARIA tree keyboard (one tab stop, ↑ ↓, → / ←, Home / End, `*`, type-ahead); a flat list with `aria-level`. Slots `#icon`, `#label`, `#actions`. Two new built-in icons, `tao-folder` and `tao-file` (29 in all).
46
+ - **`TaoInputNumber` stepper icons** follow the height of the field (`0.28 ×` the control height: 10px at medium), instead of the text size that almost touched the border, and keep a crisp 1.5px line (`vector-effect: non-scaling-stroke`, `shape-rendering: crispEdges`) instead of a soft 0.8px one.
47
+ - **`TaoPagination` `pageInput`**: a field to type a page in, `true` always or a number of pages from which it shows (`false` by default). Enter or leaving the field goes there, clamped to the range; Esc drops it; the current page is the placeholder.
48
+ - **New `TaoNav`**: navigation between the sections of an app (`TaoNavItem`: `id`, `label`, `icon`, `href`, `badge`, `disabled`; `v-model`). Three looks from one list: `bar` (bottom bar, «More» with a menu over `maxBarItems`), `rail`, `drawer`; `auto` chooses by the width of TaoNav itself with container queries, so it is right on the server and inside a `TaoSplit` pane. The default slot holds the page, TaoNav lays it out (sticky bar with `env(safe-area-inset-bottom)`, sticky side list). Links carry `aria-current="page"`; `select(id, event)` can `preventDefault()` for a router.
49
+ - **`TaoTimeline` → `TaoScrubber`** (play / pause + a time slider). The name `TaoTimeline` is kept for a vertical event feed later.
50
+ - **`TaoCalendar`**: an inline month calendar, one date or a range, with the keyboard of `TaoDate`. `TaoDate` and `TaoDateRange` are now a field plus a popup around it (they shared 13 of 13 functions; ~1000 lines became ~460 + the calendar).
51
+ - **`TaoCarousel`: a filling mark for autoplay.** `indicator="dots" | "bars" | "progress"` replaces the boolean `dots`; with `autoplay` the current mark fills over the interval and the slide changes when it is full. The fill is a CSS animation and the only clock (no JS timer), so what you see is what counts. It pauses on hover, keyboard focus, touch / drag, a hidden tab and a pause button (`pausable`, with `pauseLabel` / `playLabel`: autoplay that moves for more than 5 seconds must be stoppable); with `prefers-reduced-motion` autoplay is off. Without autoplay `progress` shows the position. A custom `#dots` slot still gets its time from an invisible fill.
52
+ - **`TaoCard`**: slots `media` (was `cover`), `header`, `title`, `sub`, `footer`, `overlay` and the new `corner`; `closable` + `close`. `headerTitle` and `headerSecondary` are gone (use `header`).
53
+ - **`TaoAnimatedBorder`**: `variant="tone"` + `tone` follows the theme, `colors` for your own list, `radius` with concentric corners, a still gradient with `prefers-reduced-motion`. The rainbow is the token `--tao-gradient-rainbow`.
54
+ - **`TaoTabs` `justify`** is typed (`TaoJustify`, as in `TaoFlex`). The `TaoGrid` breakpoint lives in one file.
55
+ - **Language is SSR-safe:** on the server `app.use(TaoUI, { locale })` no longer changes the process-wide language, so one request cannot leak its language into another. `provideTaoLocale(locale)` gives a subtree its own language.
56
+ - **`useField`**: the plumbing every form control took from `TaoFormField` (id, `aria-describedby`, invalid) was copied into 15 components; it is one function now, covered by tests.
57
+
58
+ ### Icons
59
+
60
+ - **27 built-in SVG icons** (`tao-check`, `tao-close`, `tao-chevron-*`, `tao-play`, …) on `currentColor`, under the reserved prefix `tao-`. `registerTaoIcons()` adds your own; any other name is still the `icon-<name>` class of an external font. `taoIconNames` lists the built-ins.
61
+ - Every text glyph (`× ✕ ‹ › ▶ ❚❚ ⏮ ⋮ + −`) and every hand-drawn inline `<svg>` in the components is replaced by `TaoIcon`: one look, the same on every platform (`▶` and `⏮` can turn into colour emoji on some). A test keeps new glyphs and inline svgs out.
62
+ - **`TaoButton`:** `icon` is an icon name now (it was a text node), new `iconEnd`; a button with only an icon is a square and asks for `aria-label` in development. `TaoSegmentedOption` `icon` likewise.
63
+
64
+ ### Overlays: one engine
65
+
66
+ - **Opening a menu never scrolls the page:** the position is written to the panel at once (a `focus()` right after it used to see the panel where it stood the previous time, and after the page layout changed the browser scrolled there), a closed panel forgets its place, and panels take the focus with `preventScroll`.
67
+ - **Floating panels no longer trail a smooth scroll:** a panel is `position: absolute` in document coordinates and scrolls together with the page; `fixed` only when its anchor is pinned to the screen (a `fixed` / `sticky` ancestor, the context menu point). Before, a `fixed` panel was moved from the `scroll` event, which comes a frame after the page has moved.
68
+ - **One shape for every floating panel:** Menu, Select, Combobox, Popover and the date panel take `--tao-radius-panel` (8px), their items the concentric radius `panel − padding` (4px), the same as the entries of `TaoMenubar`. Before, the menu items came out square (4 − 4) and the Select options stuck out of their panel corners.
69
+
70
+ - **One positioning, dismiss and layer engine** instead of eight copies: `computePosition` (pure, tested) and `useFloating` (follows scroll and resize), `useDismiss` (outside press, capture phase), `useLayer` (a stack of open layers: **Escape goes to the top one only**, page scroll lock, focus return), `useListNav` (arrows, Home / End, type-ahead, disabled items skipped). Popover, Tooltip, Select, Combobox, Date, DateRange, the Copy tip, Modal, Drawer and `confirm()` use them.
71
+ - **New `TaoMenu`** and a rebuilt **`TaoDropdownMenu`** on it: a data tree `items` with submenus, checkboxes, radios, group labels, separators, shortcuts (a ready string to show), disabled items; `aria-activedescendant`, type-ahead, `→` / `←`, Tab closes. Types `TaoMenuItem`, `TaoPlacement`.
72
+ - **New `TaoMenubar`** (an ARIA menubar: one tab stop, `←` / `→` with wrap, Home / End, `↓` / Enter / Space open, with a menu open `←` / `→` and the pointer switch to the neighbour menu, Esc gives the focus back to the entry; a top entry without `items` is a plain action) and **`TaoContextMenu`** (a menu at the pointer on the right click, the Menu key / Shift+F10 open it at the element; `display: contents`, so the layout does not change; closes when the page scrolls). **`closeOnScroll`** is on every menu: `TaoMenu`, `TaoDropdownMenu` and `TaoMenubar` (off: the menu follows its button), `TaoContextMenu` (on: the point it opened for moves away); a new close reason `'scroll'` and `menuReturnsFocus(reason)` for your own shells. The menus take the density of their anchor and pad their items with the control tokens, so `comfortable` gives finger-sized rows in them too. `TaoMenu` emits `edge` for `←` / `→` that have nowhere to go inside it.
73
+ - **`placement`** (`top` / `bottom` / `left` / `right` plus `-start` / `-end`) replaces `position` on Popover, Tooltip and ColorInput.
74
+ - A Select inside a Modal no longer closes the Modal on Escape.
75
+
76
+ ### Tone
77
+
78
+ - **One mechanism for every status colour.** `.tao-tone-<name>` (accent, neutral, success, danger, warning, info) sets `--tao-tone`, `-hover`, `-on`, `-text`, `-text-hover`, `-subtle`, `-wash`; Button, Alert, Tag, toast, confirm and the Avatar dot read only those. The tokens do not inherit, so a Button inside a red Alert stays an accent button. New `toneClass()` helper and `TaoToneName` type.
79
+ - **`TaoButton`: `tone` works on every `variant`** (it only painted ghost and text before); `variant="danger"` is gone (use `tone="danger"`); about 30 hand-written selectors became 8.
80
+ - New role tokens: `--tao-color-accent-text(-hover)` and `--tao-color-on-success|warning|info`. The light theme's ghost / text Button label is now readable (5.8:1 instead of 3.6:1).
81
+ - Tests hold every `on-*` colour to 4.5:1 (the light accent's white-on-rose, 3.64:1, is the one documented exception) and every tone's text to 4.5:1.
82
+
83
+ ### Tokens
84
+
85
+ - **Typography layer** (`styles/typography.css`, in `styles.css`, opt-in by class): a heading scale from `--tao-text-base` (16px) and `--tao-text-ratio` (1.25) → `--tao-heading-1…6` (49 / 39 / 31 / 25 / 20 / 16), recomputed wherever the ratio is set; h1 / h2 fluid on a narrow screen. `.tao-prose` styles the text inside a wrapper (`:where()` rules, roles for colours, spacing from the text size), `.tao-heading-1…6` gives any tag the look of a level. `--tao-line-height-body` / `-heading`, `--tao-font-family-mono`.
86
+ - **Density, a second axis of the controls:** `.tao-density-compact` / `-comfortable` / `-auto` (and `-default` to reset) on any container change the height and the padding of every size, not the font: comfortable 34 / 44 / 52px, compact 22 / 32 / 40px, auto = comfortable on `pointer: coarse`. Size and density combine anywhere in the tree (the current tokens are recomputed wherever either changes); Select and Combobox carry the density into their teleported panels. Tokens `--tao-density-*`, type `TaoDensity`; the showcase header has a switch.
87
+ - **Dark theme: `--tao-color-text-disabled` is `gray-500`** (it was `gray-300`, brighter than `text-muted`, so disabled items stood out instead of fading).
88
+ - **z-index scale** `--tao-z-modal | popup | tooltip | toast | confirm`; no component writes a literal any more.
89
+ - **`--tao-transition-base` no longer animates `all`**: colours, shadow, opacity and transform only.
90
+ - **Panel contract:** Card / Block default radius and padding come from tokens; a panel (class `.tao-panel`) publishes `--tao-radius`, `--tao-pad` and `--tao-radius-inner` for concentric corners.
91
+
92
+ ### Internal
93
+
94
+ - `deprecationWarning` / `warnDeprecated` take the version that removes the name (`removeIn`), no longer a hard-coded "3.0".
95
+ - New tests: behaviour of the overlay family, server-side rendering of every component, public entry and token contract; `npm run smoke` installs the packed tarball into a clean Vite project.
96
+
97
+ ## 4.0.1
98
+
99
+ - **TaoScrollTop:** the ripple is gone. It painted the wave in a tint that disappeared on the accent fill, so it was practically invisible and cost a DOM node, a timer and an `overflow: hidden` clip. The button now has the same 1px press as `TaoButton`.
100
+
101
+ ## 4.0.0
102
+
103
+ ### Breaking: English is the default language
104
+
105
+ - **Built-in texts are English by default** (they were Russian): placeholders, “Clear”, aria labels, `toast` / `confirm()` defaults, calendar captions. The date helpers (`formatTaoDateLabel` and friends) default to `en-US` instead of `ru-RU`, and `TaoDate` / `TaoDateRange` follow the active locale as before.
106
+ - **To stay on Russian**, pass the locale once: `app.use(TaoUI, { locale: localeRu })`, or `setTaoLocale(localeRu)` without the plugin. `localeRu` and `localeEn` are both still exported, nothing else changed in the locale API.
107
+ - `setTaoLocale(overrides)` now merges on top of English (it merged on top of Russian). Pass `setTaoLocale(overrides, localeRu)` to keep the old base.
108
+
109
+ ### Minimum width
110
+
111
+ - **`TaoButton` `minWidth`** (number = px, or any CSS length) and the **`--tao-button-min-width`** variable; default `0`, so nothing changes until you set it. Set the variable on one button, on a container or on `:root`.
112
+ - **`TaoSegmented` `minWidth`** and **`--tao-segmented-option-min-width`**: the minimum width of every option, including in `block` mode.
113
+
114
+ ## 3.4.1
115
+
116
+ - **Fix:** `TaoScrollTop` `variant="text"` could not be shown without a caption: `label=""` now hides it, leaving just the arrow button (the accessible name stays).
117
+
118
+ ## 3.4.0
119
+
120
+ ### TaoScrollTop
121
+
122
+ - **`variant`:** `solid` (default, as before), `ghost` (a light circle on a raised surface with a hairline border) and `text` (a bare uppercase caption with an arrow, always visible).
123
+ - **`label`:** a caption that appears beside the button on mouse hover (`@media (hover: hover) and (pointer: fine)`, so never on touch) and on keyboard focus. For `text` it is always shown and defaults to the locale text.
124
+ - **`side`** (`left` / `right`) picks the page edge, **`offset`** is the distance from it (`right` stays as its older name). **`labelSide`** puts the caption left or right of the button; by default it is the side opposite to `side`, so it opens towards the page, and an explicit value wins.
125
+ - **Fix:** the button had no accessible name unless `ariaLabel` was passed; it now falls back to `label`, then to the locale text.
126
+ - **Fix:** `size`, `bottom` and `zIndex` react to prop changes (they were read once at setup).
127
+ - The root is now a positioning wrapper around the button: fall-through attributes (`class`, `data-*`, …) still land on the button, but a `style` that moves the button should go to `bottom` / `offset` props instead.
128
+
129
+ ## 3.3.2
130
+
131
+ - **Fix:** the focus trap of Modal, Drawer and `confirm()` no longer lets focus escape in Safari on macOS, where Tab skips buttons and links by default. After a Tab the trap checks that focus is still inside the dialog and pulls it back if not.
132
+
133
+ ## 3.3.0
134
+
135
+ ### Presentation
136
+
137
+ - **Showcase in English and Russian:** language switch in the header, `?lang=`, built-in component texts follow the page. English is the default.
138
+ - **Static showcase build** with relative paths (`npm run showcase:build`), ready for any folder such as `/sandbox/taoui/`.
139
+ - Repository polish: `LICENSE` (MIT), `CONTRIBUTING.md` (with the colour-token rules), `SECURITY.md`, CI, issue / PR templates, a media pipeline (`npm run media`) that captures the screenshots and clips in `docs/media`.
140
+
141
+ ### Light theme
142
+
143
+ - **Light theme has its own palette** (taken from the original 666.io site) instead of a copy of the dark one: rose accent `#ff227a` (hover `#e60f66`, active `#c70a55`), black links that turn `#dc4679` on hover, white text on accent. New primitives `--tao-pink-400 … 700`.
144
+ - **Text on a solid danger fill is white in every theme** (new token `--tao-color-on-danger`); it used to follow `text-strong`, which is near-black in the light theme (danger Button, Avatar count).
145
+ - Light theme: idle text of Segmented and Tabs (`--tao-color-text-subtle`) is darker (`gray-600`).
146
+ - **Fix:** `TaoInputNumber` ± buttons no longer overflow in the `small` size.
147
+ - New optional token `--tao-button-primary-text-shadow` (none by default; the light theme sets a soft one).
148
+ - The light theme no longer inherits the dark theme's glowing link shadow.
149
+
150
+ ### Status colours as text
151
+
152
+ - **New tokens `--tao-color-{danger,success,warning,info}-text` and `-text-hover`** for status colours used as text. The plain tokens are the solid-fill shades (white text on top); as text on a dark page they were dim (danger about 4:1). The text tokens use lighter shades in the dark theme and darker ones in the light theme (new primitives `green-700`, `yellow-700`, `blue-700`), at least 4.5:1 on the page and on raised surfaces, enforced by `tests/tokens.test.ts`.
153
+ - Used by `text` / `ghost` / `secondary` Button tones, Tag, Stages, FileDrop, FormField and the error text of Input and Textarea. Fills, borders and toasts are unchanged.
154
+
155
+ ### Feedback
156
+
157
+ - **toast():** a light shadow hugging the edge (hook `--tao-toast-shadow`) instead of the large overlay shadow, which showed as a wide smear on stacked toasts.
158
+ - **`TaoButton` `tone="neutral"`** for `ghost` and `text`: strong text colour with the soft accent wash on hover.
159
+ - **confirm():** the cancel button is `ghost` with `tone="neutral"`, so the primary action stands out and the dialog feels lighter.
160
+
161
+ ## 3.2.1
162
+
163
+ - **TaoColorPicker:** the HEX label sits above the field, like the labels over the RGB / HSL channels, so the row keeps its height in every mode.
164
+
165
+ ## 3.2.0
166
+
167
+ - **TaoPinCode `format`:** `format="#-##-##"` draws visual separators between cells. They are not part of the value; a paste in that shape, or as a clean code, is split into cells.
168
+ - **TaoColorPicker:** fixed width, so switching HEX / RGB / HSL no longer resizes the popover.
169
+
170
+ ## 3.1.1
171
+
172
+ - **Popovers close on an outside press in the capture phase**, so a component that stops propagation can no longer keep a popover open.
173
+ - **TaoColorPicker:** text is centred in the HEX, RGB and HSL fields.
174
+
175
+ ## 3.1.0
176
+
177
+ ### Colour
178
+
179
+ - **New `TaoColorPicker`**: square of saturation and brightness, hue and opacity strips, a hex field, swatches, the eyedropper where the browser has `EyeDropper`. `v-model` is a hex string (`#rrggbb`, with `alpha` also `#rrggbbaa`); keyboard: arrows move the cursor (Shift is ten times bigger).
180
+ - **Input modes**: HEX, RGB and HSL numbers, switched under the square (`modes` limits them, `v-model:mode` remembers the choice). Opacity is a percent field in RGB and HSL. `parseColor` reads `hsl()` and `hsla()` too; `rgbToHsl` and `hslToRgb` are exported.
181
+ - **New `TaoColorInput`**: a field with a swatch and the hex text; the picker opens in a popover.
182
+ - **`colorModel(source, options)`** turns your own colour storage (object, array, css string; 0…255 or 0…1; sRGB or linear) into a writable hex string for `v-model`. The pure helpers (`parseColor`, `toHex`, `rgbaToHsva`, `srgbToLinear`, ...) are exported too.
183
+ - `TaoSlider`: `ariaLabel` prop and CSS hooks `--tao-slider-track-bg`, `--tao-slider-fill-bg`, `--tao-slider-thumb-bg` (the picker colours its strips with them).
184
+ - Locale section `colorPicker`.
185
+
186
+ ## 3.0.0
187
+
188
+ Cleaner slider family. Breaking changes are allowed in this major: quality over compatibility.
189
+
190
+ ### Slider
191
+
192
+ - **New `TaoRangeSlider`**: two thumbs, `v-model` is a `[from, to]` pair, `minGap` keeps the thumbs apart.
193
+ - **`TaoSlider` and `TaoRangeSlider` share props:** `marks` (`true` for automatic ticks, numbers, or `{ value, label? }`),
194
+ `discrete` (the value only sits on marks: stepped scales with captions), `format`, `vertical`, plus the old
195
+ `min / max / step / variant / size / showValue / disabled / error / wheel`. Clicking a mark caption moves the nearest thumb.
196
+ Slot `#mark="{ mark, active }"` draws a custom caption.
197
+ - **`marksSide`** (`'end'` by default, or `'start'`) puts the marks above a horizontal slider / left of a vertical one.
198
+ - **`flat`** hides the round thumbs (a plain filled bar); they stay in the markup for keyboard and screen readers.
199
+ - **Pure logic in `src/slider.ts`** (value ↔ position, steps without float tails, nearest thumb, marks) with unit tests.
200
+
201
+ ### Fixes
202
+
203
+ - **TaoSlider takes focus on press** (it used to keep it in a text field). The field blurs first and commits its text, then the slider
204
+ sets the value.
205
+ - **TaoInputNumber:** a value changed from outside (a slider, another field) now replaces the draft of a focused field, so blur does not
206
+ write the stale text over it. Typing is not affected: the echo of the field's own value does not overwrite the draft.
207
+
208
+ - **A range collapsed into one point can be pulled apart again:** pressing exactly on the point decides the thumb by the direction of the
209
+ first move (right: the upper one, left: the lower one). With `flat` such a range shows a small dash instead of disappearing.
210
+
211
+ - **No focus ring after a mouse press:** the ring is for the keyboard; it comes back on the first key press.
212
+
213
+ ### Timeline
214
+
215
+ - **New `TaoTimeline`**: play / pause and «to start» buttons, a slider over time with event marks, a «time / length» label.
216
+ `v-model` is the time, `v-model:playing` the play state; `pauseOnScrub` pauses when the user grabs the slider; `marks`, `marksSide`,
217
+ `format`, `showRestart`, `showTime`, `variant`, `size`, slots `#mark` and `#time`. It does not advance the time itself: drive it with
218
+ anything (for example `usePlayback` from `@1337exp/taoux/playback`). New locale section `timeline` (`playLabel`, `pauseLabel`, `restartLabel`).
219
+
220
+ ### Breaking
221
+
222
+ - `TaoSlider` `v-model` is a **number** now; the `number | string` form is gone.
223
+ - **Right-click to type a value is gone** (with the `placeholder` prop): use `TaoInputNumber` next to the slider.
224
+ - **Markup:** the root is a `group`; each thumb is its own focusable `role="slider"` (keys go to the thumb, `id` for labels is on the first thumb).
225
+ The pointer area is `.tao-slider__rail`; the root also holds the marks.
226
+ - `wheel` works for a single thumb only.
227
+
228
+ ## 2.0.0
229
+
230
+ One size scale, one API standard, built-in texts in any language. Old prop and event names keep working
231
+ as deprecated aliases and print a warning in development builds; they will be removed in 3.0.
232
+
233
+ ### Breaking
234
+
235
+ - **Size modifier classes are gone.** Sizes now come from CSS variables set by `.tao-size-small` / `-medium` / `-large`.
236
+ If your CSS targeted these classes, switch to `.tao-size-*` or the variables:
237
+ `tao-button--small|medium|large`, `tao-select--small|large`, `tao-combobox--small|large`,
238
+ `tao-select__panel--*`, `tao-combobox__panel--*`, `tao-segmented--*`, `tao-segmented-option--small|medium|large`,
239
+ `tao-pagination--small`, `tao-table--compact`, `tao-list--*`, `tao-list-item--s|m|l`, `tao-file-drop__zone--*`,
240
+ `tao-slider--small` (now `tao-slider--thin`), `tao-textarea--no-border` / `--center`
241
+ (now `--filled` / `--plain` / `--align-center`).
242
+ - **`size` has no default any more — it inherits.** A control without `size` takes the size of its ancestors,
243
+ `medium` at the root, so pages without `.tao-size-*` look the same.
244
+ - **`--tao-field-height` is now an alias of `--tao-control-height`** and follows the current size.
245
+ Overriding it no longer changes field height — override `--tao-control-height-medium` instead.
246
+ - **TaoSlider `size="small"` is a smaller bar now, not the thin track.** Use `variant="thin"` for seek / volume.
247
+ - **Small visual changes:**
248
+ - Pagination `small` buttons 28 → 26px;
249
+ - List rows `small` 32 → 26px, `large` 48 → 44px, titles 12 / 14 / 16px;
250
+ - Table `size="small"` (old `compact`) cell text 13 → 12px;
251
+ - Tag is 20px in medium with or without the close button (was 19 / 22);
252
+ - Tabs tab 37 → 36px (Button height);
253
+ - icon-only Segmented options are square;
254
+ - Textarea min-height equals the control height;
255
+ - Select / Combobox `large`: the clear and empty rows are 14px;
256
+ - Textarea `dummy` no longer shows a red bar.
257
+ - **TaoCarousel on mouse / trackpad** scrolls freely and settles on a whole slide after it stops
258
+ (CSS snap stays only on touch screens). A mouse drag keeps its momentum.
259
+
260
+ ### Added
261
+
262
+ - **Sizes.** `TaoSize` (`small | medium | large`) on Button, Input, InputNumber, Quantity, Textarea, Select, Combobox,
263
+ Date, DateRange, Segmented, Checkbox, Radio / RadioGroup, Switch, Tag, Tabs, Pagination, FileDrop, Slider, Table,
264
+ List, PinCode, InputGroup and FormField. `class="tao-size-small"` on any element sizes the whole block.
265
+ Tokens: `--tao-control-height` / `-padding-x` / `-padding-y` / `-font-size` / `-font-size-secondary`,
266
+ `--tao-button-padding-x`, `--tao-indicator-size`, `--tao-tag-height` / `-padding-x` / `-font-size`.
267
+ - **Locale.** `app.use(TaoUI, { locale: localeEn })`, `setTaoLocale()`, `localeRu` (default), `localeEn`,
268
+ types `TaoLocale`, `TaoLocaleOverrides`, `TaoUIOptions`. Pass a few keys to change single texts.
269
+ Switching at runtime updates components already on the page.
270
+ - **Surfaces.** `surface` on TaoCard / TaoBlock (`flat | grain | glass`, type `TaoSurface`) and classes
271
+ `.tao-surface-grain` / `-glass` for any element. Theme tokens `--tao-surface-grain-image` / `-size`,
272
+ `--tao-glass-fill` / `-border` / `-blur`. Toast and confirm are glass by default (`surface` in their defaults, options
273
+ and builders; `'flat'` turns it off). Glass falls back to a solid panel without blur support or with
274
+ `prefers-reduced-transparency`.
275
+ - **`error`** on InputNumber, Quantity, Switch, Segmented, Radio, RadioGroup, Slider and PinCode.
276
+ - **`change`** on Slider, Split (on release), Spoiler, Tabs; FileDrop and Table got `change` too.
277
+ - **PinCode** `disabled`, `size`, `masked`. **Textarea** `variant` (`bar | outline | filled | plain`), `readonly`,
278
+ `align`, `autofocus`, `blurOnEnter`. **Checkbox** `checked`. **Container** `width`. **Link** `newTab`.
279
+ **ScrollTop** `outline`. **Space / Stages** `direction`. **Copy** `successText`. **Tabs** `items`.
280
+ - **Types** `TaoTone`, `TaoLength` (number → px, string → CSS), `TaoTabItem`.
281
+ - Length props accept both numbers and strings: Block / Card `padding` and `radius`, Flex / Grid `gap`,
282
+ Grid `min`, List / Table `maxHeight`.
283
+ - Dev-only warnings for deprecated props, events and values (once per component and name).
284
+ - Tests (`npm test`, Vitest).
285
+
286
+ ### Fixed
287
+
288
+ - Textarea `noSpace` also strips spaces from pasted text.
289
+ - Textarea `borderInverse` turns red on error.
290
+ - Slider is marked invalid inside an invalid TaoFormField.
291
+
292
+ ### Deprecated → use instead
293
+
294
+ | Component | Deprecated | Use |
295
+ |---|---|---|
296
+ | Alert, Tag | `type` | `tone` |
297
+ | Tag | `pointer` | `clickable` |
298
+ | Input | `label`, `errorMessage` | `label` / `error` of TaoFormField |
299
+ | Textarea | `noBorder`, `noBackground` | `variant="filled"`, `variant="plain"` |
300
+ | Textarea | `dummy`, `textCenter`, `autoFocus`, `submitOnEnter`, `borderInverse` | `readonly`, `align="center"`, `autofocus`, `blurOnEnter`, `variant` |
301
+ | Table | `compact`, event `sort` | `size="small"`, event `change` |
302
+ | FileDrop | event `files` | event `change` |
303
+ | DropdownMenu | event `selected` | event `select` |
304
+ | Tabs | `tabs`, item `key` | `items`, item `value` |
305
+ | Checkbox | `value` (boolean) | `checked` or v-model |
306
+ | PinCode | `hidden` | `masked` |
307
+ | Copy | `successMessage` | `successText` |
308
+ | ScrollTop | `hasOutline`, `tabindex` prop | `outline`, plain `tabindex` attribute |
309
+ | Link | `asNewTab` | `newTab` |
310
+ | Space, Stages | `vertical` | `direction` |
311
+ | Container | `size` | `width` |
312
+ | Avatar | `size="s"` / `"m"` / `"l"` | `small` / `medium` / `large` |
313
+ | Divider | `size="big"` | `size="large"` |
314
+ | — | `TaoSegmentedSize` | `TaoSize` |