@1337exp/taoui 5.28.0 → 5.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,698 +1,707 @@
1
- # Changelog
2
-
3
- ## 5.28.0
4
-
5
- Nothing to migrate; the defaults do not change.
6
-
7
- - **New `TaoStretchedLink`: a whole card, row or tile as one link.** A `TaoLink` (so `NuxtLink` / `RouterLink` / `<a>` by itself, with `to`, `newTab`, `private`, `exactPath`) whose layer is stretched over the container: a click anywhere on it goes to the link, and the buttons inside it still work on their own. The link stays where it is in the markup (the title, a "View" button); the container gets `tao-stretched` (it is `position: relative`), and a control that must stay clickable by itself gets `tao-stretched-raise`. The keyboard sees one link and its focus ring goes round the whole container, inside its edge, with the corners from `--tao-stretched-radius` (the radius of a panel by default). The class `tao-stretched-link` works on any `<a>`. It is a context like `tao-frames-soft`: `styles/contexts/stretch.css`, no JavaScript. **One rule, written in the showcase, the README and the stylesheet:** never put `filter`, `transform`, `perspective`, `will-change: transform` or `contain` on the link (on `:hover` too). Such a property makes the link the containing block of its own layer, the layer shrinks to the link, the pointer is no longer over it, the property goes, the layer stretches back, and so on every frame: the cursor flickers between a hand and a text bar. Light the link with a colour, or put the effect on an inner element (on the container it is fine); a test keeps the context itself clear of these properties. Why a component and not a recipe: every site that makes a card clickable meets this, and it is found only by the flicker.
8
- - **confirm(): a button no longer jumps a pixel under the pointer.** A confirm with a message (the danger one, for example) stood on a fraction of a pixel: its text had fractional line heights (16 x 1.3, 14 x 1.45), so the panel was 143.09px high, and centred in a box where the room left over was odd it started at 351.45. A button on such a fraction is drawn one way at first and snapped to whole pixels when it is repainted under the pointer, so it moved down a little. The line heights are whole pixels at the default sizes now (16 x 1.25 = 20, 14 x 1.5 = 21), and a centred panel with an odd room left over gets a margin of 1px, which moves it by half a pixel onto a whole one (`centringNudge`, when the confirm opens and when the window is resized). No layer is forced (a `will-change` made the text blurry). `TaoModal` had the same fault in a window of the other parity (its panel started at 314.5, and with it the close button, the text and the footer button): its title was `line-height: normal`, which is fractional, and the panel was not nudged. The title is as high as the close button now (24px at the default size) and a centred `TaoModal` is nudged the same way. The nudge is one composable, `useWholePixelPanel` (it also looks again when the content changes size), used by both. `showcase/lab/subpixel.html` measures this for `confirm()`, `TaoModal`, `TaoDrawer`, `toast()` and `TaoTooltip`.
9
- - **Floating panels start on whole pixels.** The position of every panel placed by `useFloating` (Tooltip, Popover, Select, Combobox, Date, DropdownMenu, the tip of TaoCopy…) came from the anchor and the size of the panel and was often a fraction: a tooltip centred over a button with an odd width stood on a half pixel. Text and buttons on a fraction are drawn one way at first and snapped to whole pixels when they are repainted, so a button in a popover could jump when the pointer came to it. `computePosition` rounds `top` and `left` (after the flip and the clamp into the window), and the arrow is worked out from the rounded position, so it still points at the middle of the anchor. `showcase/lab/subpixel.html` now also measures `TaoPopover` and `TaoSelect`.
10
- - **TaoCounter: a digit no longer jumps a pixel when it starts to roll.** A digit became a layer of its own only when its `transform` and `blur` began, and the text was then redrawn on whole pixels: in Chromium it moved a little to the left at the start (and back at the end). The digit is a layer from the start now (`will-change`), so it is drawn the same before, during and after. The geometry was never off: the cells and the centre of the text stay put to a hundredth of a pixel.
11
-
12
- ## 5.27.0
13
-
14
- Nothing to migrate; the defaults do not change (a plain string in a locale works as before).
15
-
16
- - **Plural forms in locale texts.** A text that depends on a number may now be written as forms, `{ one, few, many, other }` (as `Intl.PluralRules` names the categories; only `other` is required, a missing form falls back to it), chosen by the number (`count`, or `n`) and the `code` of the locale. A plain string is still accepted and is the same for every number, so nobody has to write forms. The built-in texts that count have them now, in English and Russian: the badge of `TaoAvatar` ("1 notification", "2 уведомления", "5 уведомлений") and the jump buttons of `TaoPagination`. `formatTaoText(text, values, code?)` is exported for your own texts; the types are `TaoText` and `TaoPluralForms`.
17
- - **`detectTaoLanguage(supported, { fallback?, requested? })`.** The one of your languages that the user would like most, by `navigator.languages` (a server passes `requested`, e.g. `parseAcceptLanguage(header)`); `ru-RU` fits `ru`, `en` is answered by `en-GB`. It only answers: it does not set the language and does not remember it (`saved ?? detectTaoLanguage(['en', 'ru'])`). `matchTaoLanguage(requested, supported, fallback?)` is the pure core.
18
- - **TaoColorInput: an empty value says it is not set.** For an optional colour (`''`) the field showed an empty frame. Now it says "Not set" (`placeholder`, the text comes from the locale: `colorPicker.placeholder`, "Не задан" in Russian) in a muted voice, the swatch is crossed out, and a screen reader hears it ("Choose color: Not set"). With `clearable` the colour can be taken away again: a Clear row at the foot of the palette, after a divider, as in Select (`colorPicker.clearText` in the locale; it is always there and disabled while there is nothing to clear, so nobody has to guess it exists) and Delete / Backspace on the field; it gives `''`.
19
- - **Scrollbars: four hooks and a class.** `--tao-scrollbar-size` (5px by default, so the thin scrollbar stays; the rule used `max-width`, which could never make it thicker than the browser's own 15px, now it is `width`), `--tao-scrollbar-thumb` (the accent), `--tao-scrollbar-track` (transparent) and `--tao-scrollbar-width` (`thin` | `auto` | `none`, for Firefox). Set them on `:root`, on a block or on a component; the colours are read where the scroll is, so a block with another theme gets its own accent. The class `tao-native-scrollbars` on `<html>`, or on any block, gives the browser's own scrollbars back for everything inside it. Firefox, which has no `::-webkit-scrollbar`, now gets the same look through `scrollbar-width` and `scrollbar-color` (only there: Chrome 121+ understands them too and would ignore the rules above): a thin scrollbar with the accent thumb, like the other browsers; `tao-native-scrollbars` or `--tao-scrollbar-width: auto` turns it off. The showcase has a panel with sliders under «Layers and theming».
20
- - **Showcase: the keys of the locale are browsable.** The sections of the locale are buttons: one shows its keys in English and Russian, built from the real `localeEn` / `localeRu`, so the page cannot differ from the library; a template to translate can be copied. New there: plural forms and the language of the user, both live. `showcase/lab/rtl.html` is a probe of the same components left to right and right to left (the status of RTL is in the README of the lab).
21
-
22
- ## 5.26.0
23
-
24
- Nothing to migrate; the defaults do not change.
25
-
26
- - **TaoLoader `variant="diamonds"`.** Four diamonds on two axes, which flow into each other. On each axis a hollow diamond crosses to a filled one; the filled one shrinks as it comes (from half way) and is gone when the hollow one lands; the new filled one grows at the place the hollow one left, before the old one is quite gone; then it goes back the other way. The second axis is the same pair turned a quarter and a fifth of the cycle behind, so the two pass the middle one after the other. Sized, toned and named like the other looks (`size`, `tone`, `color`, `label`), hidden from a screen reader as a picture; under reduced motion it stands and breathes. `showcase/lab/` is a bench for working on such an animation frame by frame (not part of the package).
27
- - **Showcase: a «Localization» section.** The same components with no text given by hand in three columns, each with a language of its own (`provideTaoLocale`): English, Russian and a third made of a few German keys on top of English (its `code` `de-DE` makes the date read the German way). How to set it (`app.use`, `setTaoLocale`, a subtree), your own language, a prop that wins, what is translated (every section of the locale with its count of texts), and what to know (`<html lang>`, no plural forms).
28
-
29
- ## 5.25.0
30
-
31
- Nothing to migrate; the defaults do not change.
32
-
33
- - **TaoTour: a guided tour of the page.** The page goes dim, the target stays lit (the lit window glides from one target to the next), a card with an arrow says what it is, with Back / Next / Skip, the dots and "Step 2 of 5". A step is `{ id, target?, title?, text?, placement? }`: `target` is a selector, an element or a function; without it (or when it is not on the page) the step is a card in the middle. `interactive` lets the user press the target itself while the rest of the page stays shut. Escape skips, the arrows move on, Tab stays in the card, focus goes back where it was. The step scrolls its target into view (calmly under reduced motion). TaoTour only draws: the state is yours, or `useTour` from TaoUX `tour`, which jumps over steps whose target is gone and remembers that the tour was seen. `useFloating` takes `fixed: true` for a panel inside a layer that is itself fixed. It renders on the server without touching `window` (the lit window is drawn on the client).
34
- ## 5.24.0
35
-
36
- Nothing to migrate; the defaults do not change.
37
-
38
- - **TaoThemeToggle: the light / dark switch as one icon button.** Until now the kit had no switch of its own, only text in the showcase. The icon is the theme a click leads to (a sun while the page is dark, a moon while it is light), the `aria-label` says the same in words (`toLightLabel` / `toDarkLabel`, in both locales). By default it reads `data-tao-mode` of `<html>`, flips it on a click and follows it when somebody else changes it; a palette keeps its name, the old `data-tao-theme="dark"` spelling follows the mode. For your own storage: `v-model` with `:apply="false"`. New icons `tao-sun` and `tao-moon`; `readTaoMode(el)` and `applyTaoMode(el, mode)` are exported. The `#icon` slot (`{ mode, next }`) puts your own glyph in the button, which stays a square with its label. The mode control of the showcase bar is this button now.
39
-
40
- ## 5.23.2
41
-
42
- Nothing to migrate; the defaults do not change.
43
-
44
- - **TaoCopy: the arrow of the tip points at the button at the edge of the window.** When the tip was pushed in from the viewport edge, its arrow stayed in the middle of the tip and no longer pointed at the trigger. It now takes its place from where the trigger falls on the tip (kept off the rounded corners), and it moves to the top edge when the tip flips below the button.
45
-
46
- ## 5.23.1
47
-
48
- Nothing to migrate; the defaults do not change.
49
-
50
- - **The mark in the README now reads on any background.** npm has its own dark / light switch that does not follow `prefers-color-scheme`, so the `<picture>` of 5.23.0 handed a dark-on-dark mark to a dark npm page and the logo vanished. `showcase/public/logo/logo-mark.svg` is a neutral one: a white T and a yellow arrow with a thin dark outline, which reads on light, on dark and on any colour; the READMEs use it with a plain `<img>`. `logo-mark-dark.svg` and `logo-mark-light.svg` stay for the showcase, where the theme is ours.
51
-
52
- ## 5.23.0
53
-
54
- Nothing to migrate; the defaults do not change.
55
-
56
- - **`TaoPinCode` `bordered=false` has no frame in any state.** In 5.22.0 the plain cells still showed a frame for focus and result; now the focus, an error and a success are told by the fill and the digit only (an accent / danger / success tint), and the cells do not jump.
57
- - **Showcase: a section "Layers & theming".** The real files of the kit (`primitives` → `semantic` → `themes` → `contexts` → `base`) in the order `src/styles/index.css` imports them, each with a note whether it is yours to touch (only the themes are), taken from the source by `?raw`, so the page cannot drift from the library. Below it an own theme by hand: an accent, a page and the corners make a `[data-tao-theme]` file, a preview wears it, and the ratios are rated with the promises of the palettes. `tests/showcase.layers.test.ts` keeps the order equal to `index.css` and the theme's roles real.
58
- - **`TaoSlider` / `TaoRangeSlider` `zones`: the scale in colour.** `:zones="[{ to: 40, tone: 'info', dot: true }, { to: 70, tone: 'warning', dot: true }, { to: 100, tone: 'danger' }]"`. Each zone runs to its `to` (the first from `min`, the last to `max`), so there are no gaps and no overlaps. `tone` is a colour role of the theme, `color` any CSS colour (it wins; its contrast is yours to keep), `dot` puts a bead where the zone ends, `reveal` keeps the zone clear until the value gets there (the field looks plain and is painted as it fills; its dot shows once the fill has reached it). The bar shows the zones dimmed, the filled part in full colour, and the thumb wears the colour of the zone it stands in. Works with `vertical`, `flat`, `variant="thin"` and a range; marks and `discrete` are untouched. Colour is not a message: say the state in words too. The logic is `normalizeZones` / `zoneAt` / `zoneGradient` in `src/slider.ts`; the types `TaoSliderZone` and `TaoSliderZoneTone` are exported.
59
- - **`TaoDrawer` (bottom sheet): a graze no longer closes it.** The sheet closed at 30% of its height, or on any flick faster than 0.5 px/ms that went 24 px: a finger that touched it by accident was enough. Now it closes when pulled half of its height, or flung hard (1.2 px/ms or more, a light swipe is not enough: 0.8 px/ms closed it before) after a path of at least 15% of the height; otherwise it comes back. `swipeThreshold` (0.05–1, default `0.5`) sets the share for your sheet. The backdrop already lets go as the sheet is pulled, so the finger sees what releasing now will do.
60
- - **The mark of the project, and a settings bar in the showcase.** `showcase/public/logo/`: `logo-mark-dark.svg` (a white T for a dark background), `logo-mark-light.svg` (a dark T for a light one) and `favicon.svg` (a tile, with no road markings: at 16px they are only noise), drawn as paths from the design layout; the yellow is `--tao-orange-300`. The READMEs show it with `<picture>`, so GitHub picks the file by its own theme. The showcase wears it in its title as the T of the word, «Tao UI» with the arrow over the `ao` (it follows the mode; the heading keeps its name for a screen reader) and as a favicon. The options of the header moved into a one-line bar that sticks to the top while you scroll, made of the kit itself: language, palette and mode are inline (`TaoSegmented`, `TaoSelect`), the rare ones, density and frames, sit in a «View» popover (`TaoPopover`) whose button shows a dot while one of them is off the default. The brand, with the version tag of the build, shows in the bar once it has stuck, the section list sits below it, and on a phone it scrolls away with the page.
61
- - **A third context: frames (`.tao-frames-soft`).** A light look for the whole app, or for one panel, with one class. `tao-frames-soft` on `<html>` or a container lets the decorative frames of `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` and `TaoMenubar` go clear, and the panel is held by its fill: an alert gets a little more tint, a table sits on the raised fill. Nothing moves, the 1px border stays in the box, only unseen. `tao-frames-framed` puts the frames back inside a soft area. `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoToolbar` and `TaoMenubar` get `bordered` (not set: follows the context; `true` / `false`: for this panel); `TaoList` keeps its own `bordered`. Not touched on purpose: the frame of a field, the focus ring, and the lines between rows: they say where a control is and what belongs together, and WCAG 1.4.11 asks 3:1 of them. The tokens are `--tao-frame-alpha`, `--tao-frame-tint` and `--tao-frame-fill` (`src/styles/contexts/frames.css`, a new file in the layer order). The showcase has a switch «Frames» in the header. Fields have `variant="filled"` already; its fill is gentle (about 1.1:1 with the page), so use it knowing that.
62
- - **`TaoScrollTop`: the caption has an outline.** The hover caption (`label`, and the text mode) over a page of text kept only a soft halo, and the words under it still showed through. It now has a crisp outline in the page colour as well (`-webkit-text-stroke` with `paint-order: stroke fill`, so only the outer half of the stroke shows and the letters stay whole): the text under the caption is cut clear, in both themes, with no backing and no colour. Where `paint-order` is not supported for HTML text (before Chrome 123) the halo is all there is, as before; `@supports` keeps a stroke from eating the letters there.
63
- - **`TaoStages`: the icons stand on the middle of the label, and the spinner turns about its own centre.** The icon box was a block span, so the svg sat on the text baseline and the box grew by the line gap under it (14 px became 17): every icon was 1.5 px above the middle of its label, and the `work` mark turned about the centre of that taller box and wobbled. The box is now exactly the svg. A test keeps the mark from becoming a block again.
64
- - **`TaoCarousel`: the track keeps the browser's own cursor.** The `grab` / `grabbing` cursors are gone: system cursors differ much between browsers (Opera showed a big black arrow), and which cursor a carousel wants is the app's decision, set on `.tao-carousel__track`. The drag itself is unchanged. (`TaoSplit` keeps its resize cursors and `TaoColorPicker` its crosshair: there the cursor is part of the meaning.)
65
- - **`TaoSlider` / `TaoRangeSlider` `bubble`: the value in a bubble at the thumb.** Off by default, so nothing that exists changes. `bubble`: it shows while the thumb is dragged, hovered or has the keyboard focus (a touch drag shows it above the finger); `bubble="always"`: it stays. The text is `format` of the value, or the `#bubble="{ value, zone }"` slot (an icon, a word). It wears the colour of the zone the thumb stands in (the accent without zones) with a label that reads on it: the `on-` role of the tone, black or white by contrast for a colour of your own, the browser picks for a colour the script cannot read. A screen reader already has `aria-valuetext`, so the bubble is `aria-hidden`. It sits above a horizontal bar and to the right of a vertical one: leave room for it.
66
- - **`TaoLoader`: three looks, a voice, a colour role.** `variant`: `dots` (the four dots, still the default, same size and motion), `ring` (a turning arc) and `pulse` (ripples from a core). `tone` is a colour role of the theme (`color` stays and wins; `currentColor` takes the text around it), `size` is a number or `small` / `medium` / `large`, the sizes come from one number in CSS. It is a `role="status"` with a text for a screen reader (`label`, «Loading» / «Загрузка» from the locale), or `decorative` when the wait is said elsewhere. Under «reduce motion» nothing travels or turns: the picture breathes. `TaoButton loading` wears the same ring in its text colour and says `aria-busy` by itself. The showcase gets «Which wait to choose»: loader, skeleton or progress.
67
- - **`TaoPinCode`: an error paints the digits red**, as a success always painted them green (`--tao-color-danger-text`).
68
-
69
- ## 5.22.0
70
-
71
- Nothing to migrate; the defaults do not change.
72
-
73
- - **`TaoPinCode` `bordered`.** `:bordered="false"` is a light style: the cells have a soft fill and no frame at rest. The frame is still in the box (the cells do not jump) and is only clear; focus, the active cell, an error and a result paint it, so a state is never left to a fill colour alone.
74
- - **`TaoDrawer`: the pull of a sheet no longer selects the title.** While the sheet is in the hand the panel has `user-select: none`, and it is given back at the end.
75
- - **`TaoDrawer`: a pointer that vanishes lets go.** The blur of the window, a tab that goes to the background, `pagehide` and a taken capture (`lostpointercapture`) end the pull as a cancel: the sheet settles back and does not close, and the next pull starts clean. The same guard `TaoCarousel` has had.
76
-
77
- ## 5.21.0
78
-
79
- Nothing to migrate; the defaults do not change.
80
-
81
- - **`TaoMarquee` `decorative`: a line that is only a picture.** For a marquee used as a design feature, in the background. A ghost: `aria-hidden` and `inert` (not a tab stop, nothing to select, no reaction to a cursor or a tap), `pointer-events: none`, and it runs round without a pause, like a looped GIF. Under «reduce motion» it stands still and is clipped, it does not wrap. Use it only for text nobody needs to read: the stop that WCAG 2.2.2 asks of moving content does not apply to pure decoration, and a screen reader will not see it.
82
- - **`TaoMarquee` `roundPause`.** The rest at the start of every round can be turned off for any line (`:round-pause="false"`): the round is one line plus the gap and the loop has no seam. Not set, it follows `decorative` (no rest) and an ordinary line keeps its rest.
83
-
84
- ## 5.20.1
85
-
86
- Nothing to migrate; the defaults do not change.
87
-
88
- - **`TaoMarquee`: `pauseOnHover="false"` is a background line now.** The prop was there, but a line used as a design feature still stopped for a tap and could be selected while it ran. With `pauseOnHover` off a cursor or a finger passing by does not stop it, and the running text has `user-select: none`. Focus still stops it and a running line stays a tab stop, so the keyboard keeps its way to stop moving content (WCAG 2.2.2). The showcase has a background line.
89
- - Showcase: the numbers promised by the palettes sit under the palette lab, with the other colour blocks of the section.
90
-
91
- ## 5.20.0
92
-
93
- Nothing to migrate; the library does not change.
94
-
95
- - **Showcase: a section "Contrast & keyboard".** What the README only promised can be tried now. A live look reads the colour roles of this very page from the computed styles and judges every pair with `contrastRatio()` and `apcaContrast()` (the numbers follow the palette and the mode in the header). A pair picker shows the two questions on one colour, with the well-known green `#2ea85c` where WCAG 2 and the eye disagree. A palette lab turns four stops into a whole theme with `applyTaoPalette()` on a preview (or on the page, and takes it off again) and rates the roles it made. A key map lists what the keys do in toolbars, menus, trees and lists, and the numbers the palettes are tested for. Every key line is one a test of the component or its code shows.
96
- - The section is a frame (`showcase/components/DemoA11y.vue`); each block and its data live apart in `showcase/a11y/`, and `tests/showcase.a11y.test.ts` keeps the roles it reads real and its promises equal to the palette constants.
97
-
98
- ## 5.19.3
99
-
100
- A fix; nothing to migrate.
101
-
102
- - **`TaoCounter`: a fast run of increments no longer leaves empty and half-rolled slots.** A new value that came while the digits were still rolling cut the roll short and piled several digits in one slot. Now the wheels take the next value only when the last digit has landed: the parent already holds the sum of the increments, so the counter rolls once to the latest value, and again if more came during that roll. `aria-label` tells the real value at once. The gate is `createRollGate` in `src/counterRoll.ts`.
103
-
104
- ## 5.19.2
105
-
106
- A polish; nothing to migrate.
107
-
108
- - **`TaoCounter`: the digits roll in turn, not all at once.** All the digits that changed started at the same moment, and `+1337` looked like four wheels jerked together. Now the one on the right goes first and the others follow to the left, 55 ms apart, so they land one after another like an odometer. Only the digits that change take a turn: `1000 → 2000` does not wait for the three that stay. `--tao-counter-stagger` sets the step (`0` brings the old all-at-once back). With `prefers-reduced-motion` the digits change at once. The order is `src/counterRoll.ts`.
109
-
110
- ## 5.19.1
111
-
112
- A fix; nothing to migrate.
113
-
114
- - **`toast()` has no accent bar on the left.** The 5.17.2 bar kept away from the rounded corners, and that left a gap between it and the progress line in the lower left corner. The bar told nothing the icon, the tinted background and the progress line do not: it is gone, and `.tao-toast__accent` with it. The progress line keeps its distance from the corners (`--tao-toast-edge`).
115
- - Showcase: the buttons in the header of the comments sheet use `icon` (a square of the control height), not an icon in the slot, so the icons sit in the middle.
116
-
117
- ## 5.19.0
118
-
119
- Nothing to migrate.
120
-
121
- - **`TaoDrawer` as a bottom sheet of your own.** A sheet (`side="bottom"`) is pulled down by its grip and header now (`swipeToClose`, on by default): it closes when pulled a third of its height or flung, comes back otherwise, and the backdrop lets go as it goes. The pull starts only from the grip and the header, never from a button or a field in it, so the content still scrolls. It needs `closable`, and if the parent keeps `v-model` open the sheet returns.
122
- - **`show-close="false"` hides only the cross.** `closable="false"` still means that only the parent closes it (no cross, no backdrop, no Escape, no pull); `showClose` is just the cross, the rest keeps working: a sheet with no cross that is pulled down.
123
- - **`#header="{ close }"` replaces the whole header** (a title with a counter, a filter, a cross of your own). Name the panel for a screen reader with `aria-label`. The showcase has the comments of a video built from this, with `#footer` as the line to type in.
124
- - The pull-down is plain pointer events, no dependency on TaoUX; the maths is `src/sheetDrag.ts`.
125
-
126
- ## 5.18.0
127
-
128
- One visible change on a phone: a tap no longer flashes.
129
-
130
- - **No system flash on a tap.** Phone browsers paint a blue (or grey) square over a tapped link or button, and it differs by the shell and fights the theme. `styles.css` sets `-webkit-tap-highlight-color` from the new token `--tao-tap-highlight` (`transparent`) on `<html>`; the property is inherited, so every element gets it. A colour in the token brings a flash of your own back, anywhere in the tree. The kit gives a tap its own feedback instead of leaving it to the system; a row of `TaoList` has none yet, it is next.
131
-
132
- ## 5.17.2
133
-
134
- A fix; nothing to migrate.
135
-
136
- - **`toast()`: a loading toast turns into its result smoothly.** The tone changed at once when the work finished: the bar, the icon and the tinted background jumped from the accent to green or red. Now the colours follow in 0.3 s, the ring gives way to the result icon that comes in, and with `prefers-reduced-motion` nothing is animated.
137
- - **`toast()`: the accent bar and the progress line are not cut by a large radius.** With `--tao-radius-panel` of 20px and more the curve of the corners cut both marks down to a hair. They keep away from the corners now by 60% of the radius (up to 24px) and have rounded ends, so they lie on the straight part with any radius. `--tao-toast-edge` sets the distance (`0` brings the flush look back). `TaoCard` `stripe` stays clipped by the corners: it is a decoration, the toast marks tell the tone and the time.
138
-
139
- ## 5.17.1
140
-
141
- A fix; nothing to migrate.
142
-
143
- - **`TaoTree` does not loop on a repeated id.** An id is unique in the whole tree. When `load(node)` answered with the same ids at every level (the showcase did: opening `vue` under `node_modules` handed back a `vue`), the node inside its own ancestor sent the walk round in a circle: `RangeError: Maximum call stack size exceeded`. A node whose id is already one of its ancestors is a leaf now. The showcase `load` gives path ids.
144
- - Inside the repository: `docs/v5-plan.md` (the ideas journal of the 5.0 design) is removed; MIGRATION-5.md no longer points to it.
145
-
146
- ## 5.17.0
147
-
148
- Nothing to migrate.
149
-
150
- - **`TaoFileDrop` `reject` event.** A file that did not pass `accept` was dropped without a word: no `change`, no sign, and the user saw nothing happen. Now `reject` brings the refused files (`File[]`); they are still not in `v-model`, and in a mixed batch the good files go to `change` as before. Say why in your own words (the zone does not guess a message). The `accept` matching moved to `src/fileAccept.ts` with tests. Found by Next Up.
151
-
152
- ## 5.16.3
153
-
154
- A fix; nothing to migrate.
155
-
156
- - **`TaoDivider` follows the theme.** The solid and dashed line read the primitive `--tao-gray-300`, the one thing a component must not read, so a theme or a palette could not recolour it. It reads `--tao-color-text-muted` now (the same grey in the dark theme, a little darker in the light one), at the same 20% opacity.
157
- - Inside the repository: `tests/component-styles.test.ts` holds that a component reads roles and not primitives, writes no colour of its own, and adds no spacing pixels beyond the recorded ones; the rules in `CONTRIBUTING.md` are regrouped (colour, then component rules).
158
-
159
- ## 5.16.2
160
-
161
- A fix; nothing to migrate.
162
-
163
- - **A light-theme field is the same surface as its neighbours.** `--tao-color-input-bg` is the sunken surface (`--tao-color-surface-sunken`) in the light theme now, as it already was in the dark one, so a field and the segmented track next to it, a switch or a tab bar come out of one role and not of two close greys. It was white in 5.16.0 and translucent white in 5.16.1, and it still stood off its neighbours. The disabled field takes a translucent grey tone, as in the dark theme, because `gray-50` is the field itself now. The text stays at 18:1. The framed fields keep their border.
164
-
165
- ## 5.16.1
166
-
167
- A fix; nothing to migrate.
168
-
169
- - **A field follows the panel under it in the light theme.** `--tao-color-input-bg` was pure white (`--tao-gray-0`) whatever it lay on, while in the dark theme it is a translucent tone that follows the surface. On a window or a drawer painted another colour (`--tao-surface-fill`, a darker panel, a tinted palette surface) the light `TaoInput`, `TaoSelect`, `TaoTextarea`, `TaoDate` and the other fields stood out white against components that take their colour from the surface scale. Now it is white at 65% opacity: on a plain page it is still white, on a tinted or darker panel it takes the panel's tone. The text stays at 19:1.
170
-
171
- ## 5.16.0
172
-
173
- Nothing to migrate; the one visible change is the current `TaoNav` item, which is bolder now.
174
-
175
- - **`TaoNav`: the current item is told apart by weight as well as colour.** It was the accent colour on its own tint, and that is thin for a person who does not tell colours apart (WCAG 1.4.1: do not rely on colour alone); in the light theme the text on the tint is also close to the 4.5:1 edge. The label is `font-weight: 600` now. `--tao-nav-active-weight` sets another weight (`400` brings the old look back). `indicator="line"` has its line as the second mark already and takes the same weight.
176
-
177
- ## 5.15.0
178
-
179
- `TaoModal` and `TaoDrawer` put your `class`, `style` and other attributes on the dialog panel now, not on the overlay or the layer around it: if you styled the overlay through a class on the component, move that rule to `.tao-modal-overlay` / `.tao-drawer`.
180
-
181
- - **`TaoModal` scrolls its content, not itself.** The whole dialog scrolled, so the `#footer` went away with the text and an app drew its own sticky bar (in the page colour, with a dark edge round the buttons). Now the content scrolls and the header and the footer stay, as they already did in `fullscreen`. `--tao-modal-bg` is the panel colour, for a bar of your own that sticks inside.
182
- - **`TaoModal` and `TaoDrawer` take `surface`:** `grain` (a film grain over a solid fill) or `glass`, as on TaoCard, TaoBlock and TaoNav; with the attributes on the panel, `class="tao-surface-grain"` works too. `--tao-drawer-bg` is the drawer panel colour.
183
- - **The grain goes when more contrast is asked** (`prefers-contrast: more`): the fill stays solid and clean.
184
- - **`TaoNav` `badgeTone`:** `neutral` makes the counters grey with the accent on the current item only, so the eye is not pulled round the menu; a dot (`badge: true`) stays the accent. The docs say what is what: `.tao-nav` is the whole layout (navigation and page), `.tao-nav__panel` the navigation, `.tao-nav__content` the page.
185
- - **`TaoDropdownMenu` `size` and `tabbable`:** `size` makes the button a square of that control height (a compact kebab in a list row); `:tabbable="false"` takes it out of the Tab order when the row has its own menu key.
186
- - Showcase: a grain modal with a long text, a compact kebab, neutral counters in the TaoNav demo.
187
-
188
- ## 5.14.0
189
-
190
- Nothing to migrate.
191
-
192
- - **`TaoList` `roving`.** One Tab stop for the whole list: the arrows move between the rows, Home / End to the first and the last, disabled rows are skipped, and Tab comes back to the row it left (the selected one the first time). The stop of a row is its button (`clickable`) or the row itself, with the focus ring of a clickable row. Rows added or removed are followed; a key pressed in a row's own control (an input, a menu) stays with it. An app no longer writes its own roving tabindex for a list of records.
193
- - **`TaoListItem` focus ring round the whole row.** On a `clickable` row the ring was drawn on its button, inside the row's padding, so it stood off the edges while the highlight ran the full width. It goes round the row now (`:has()`; older browsers keep the ring on the button).
194
- - Showcase: the «People» list is roving.
195
-
196
- ## 5.13.0
197
-
198
- Nothing to migrate.
199
-
200
- - **Hidden inputs no longer stretch the page.** `TaoSwitch`, `TaoCheckbox`, `TaoRadio`, `TaoFileDrop` and `TaoPinCode` keep a visually hidden input (or a status) that is `position: absolute`, and their root was not positioned: the hidden element stood against the page, not the field, so a scrolling container did not clip it and the document grew (a long form in a `overflow: auto` block scrolled the whole page). Each root is `position: relative` now.
201
- - **`TaoNav` `#footer`:** a small line under the items in the rail and the side panel (the version, «About», a link); the bar has no room for it and does not show it.
202
- - Showcase: the TaoNav demo has a footer.
203
-
204
- ## 5.12.0
205
-
206
- Nothing to migrate.
207
-
208
- - **`TaoTextarea` `maxHeight`.** The field grew with its text up to 500px, written into the component. Now `maxHeight` sets it: a number is px, a string any CSS length (`50vh`, `20rem`), `none` — no limit; 500 stays the default. Dragging the corner stops there too. A framed field (`variant="outline"`) no longer scrolls by 2px: the height counts its border.
209
-
210
- ## 5.11.1
211
-
212
- A fix; nothing to migrate.
213
-
214
- - **Secondary text reads in the dark theme.** `--tao-color-text-muted` (labels, hints, legends, the names in TaoNav and the charts) was `#666`: 3.2:1 on the page and 2.9:1 on a card, below the 4.5:1 of normal text, in every dark palette. It was the grey of the neutral fill too, where a white label needs it dark. The two are apart now: the new `--tao-color-neutral` keeps `#666` for `tone="neutral"` (its white label stays 5.7:1), and muted text is `#8a8a8a` (`--tao-gray-350`): 5.3:1 on the page and 4.8:1 on a card. The light theme was fine (5.7:1) and does not change. The carousel dots and the knob of a switch that is off take the muted grey too and are a little lighter. A test now holds muted text at 4.5:1 on the page and on a card in both themes.
215
- - **`TaoHeatmap` stripes, even.** The hatched levels were one gradient over the whole cell with 1.5px lines, and the browser drew them thicker and thinner by turns. Now a 6px tile repeats, so every stripe is the same: about 1px, 4px apart, at 135°, and lighter (45% of the tone), so they do not ripple.
216
- - Showcase: the «Orders by time» caption stands off the map.
217
-
218
- ## 5.11.0
219
-
220
- Nothing to migrate.
221
-
222
- - **`TaoButton` `shortcut`:** `shortcut="N"` shows the key at the end of the button, in a small chip of the button's own text colour, so it fits any variant and tone; in a wide button it goes to the far edge. It is given as `aria-keyshortcuts` and the chip itself is not read twice. It only shows the key: listening to it is the app's job.
223
- - **`TaoNav` labels fit the rail.** An item with the icon over its label (the rail, the bar) kept 12px on each side, so the rail left 47px for a label and «Settings» or «Calendar» in Russian were cut. Now it keeps 4px, and the label has about 63px. The side panel is unchanged.
224
- - **`TaoNav` widths are public:** `--tao-nav-rail-width` (80px), `--tao-nav-drawer-width` (240px) and `--tao-nav-action-radius`, set on `:root` or any wrapper, for an app whose labels are longer still.
225
- - **`TaoNav` action in the side panel:** the button keeps its own corners, like the items under it, instead of a pill (`--tao-nav-action-radius: var(--tao-radius-full)` brings the pill back), and stands off the top edge. A `shortcut` on it shows in the side panel and hides with the label when the button is round.
226
- - **`TaoNav` side panel, lighter.** Its rows were 48px, the finger size of the bar, with 4px around the panel. With a mouse they are now a little taller than a control (40px at the medium size, and they follow the size and the density), and the panel keeps 12px from its edges, so the action and the items stand off them like a list in a card. On a touch screen (`pointer: coarse`) the rows stay 48px. The bar and the rail do not change.
227
- - **`TaoNav` `surface`:** `flat` (the default), `glass` or `grain`, as on TaoCard. `glass` lets the page show blurred through the bar while it scrolls under it, the floating pill included; where blur is not supported or less transparency is asked, the panel is solid.
228
- - Showcase: buttons with a shortcut; the TaoNav action shows `N` and switches the surface, with something bright under the bar.
229
-
230
- ## 5.10.0
231
-
232
- Nothing to migrate.
233
-
234
- - **`variant` on the text fields:** `TaoInput`, `TaoInputNumber` and `TaoCombobox` take `outline` (the frame, the default), `filled` (a fill only) and `plain` (no frame, no fill, no inset), the names `TaoTextarea` already uses. On a plain `TaoInputNumber` the ± buttons lose their lines too. A `plain` field reads as text, for an item of a list being edited: the caret shows the focus, and an error is a red line under the text, so the text does not move. The height is the same in all three. `filled` takes a fill of the text colour, so it shows on a page, a card or glass alike.
235
- - A test now fails for any field whose control takes the field id (`:id="controlId"`) but does not split its attributes with `useControlAttrs`, so a new field cannot put its `aria-label` on the wrapper again.
236
- - Showcase: the variants in the TaoInput section.
237
-
238
- ## 5.9.0
239
-
240
- A new component; nothing to migrate.
241
-
242
- - **TaoHeatmap.** A value for each pair of two things: orders by weekday and hour, visits by week and day. `values` by `rows` × `cols` (`null` is no data); a cell takes the colour of the highest threshold it reaches (`steps`, round numbers at 10–80% of the largest value by default), from faint to the full `tone`, and the legend names them («200+, 500+, 1 000+»). The `hatch` lowest levels are striped, so they read apart from the empty cells without colour too. A tip over the cell gives the row, the column and the number (`format`, by the locale by default; a `tip` slot for your own), kept on whole pixels inside the map. It is a `role="grid"`: one cell is in the tab order, the arrows, Home / End and PageUp / PageDown move it, and a screen reader reads the row, the column and the number. It fits the width of its container, and the column names show as often as they fit (`labelEvery` to choose).
243
- - Showcase: «Orders by time» in the charts section.
244
-
245
- ## 5.8.4
246
-
247
- A fix; nothing to migrate.
248
-
249
- - **The rest of the fields get their name too.** `TaoQuantity` and `TaoFileDrop` pass their attributes to their control (the number input, the file input), like the fields in 5.8.3. `TaoColorInput` passes them to its trigger button, and an `aria-label` you give names it while the colour still follows: «Background: #ff8800» (without one, the locale's «Choose a colour»). `TaoColorPicker` is a `group`, so its `aria-label` names something. Each `TaoPinCode` cell says which character it is: «Character 2 of 6», from the new optional locale key `pinCode.cellLabel` (a locale written before still type-checks, English stands in).
250
-
251
- ## 5.8.3
252
-
253
- A fix; nothing to migrate.
254
-
255
- - **A field's attributes reach its control.** `TaoInput`, `TaoTextarea`, `TaoInputNumber`, `TaoCombobox`, `TaoSelect`, `TaoDate`, `TaoDateRange`, `TaoSwitch`, `TaoCheckbox` and `TaoRadio` are a wrapper around their control, and Vue put every attribute you gave them on the wrapper: an `aria-label` named nothing there (a screen reader read the field without its name), and `name`, `autocomplete`, `inputmode`, `data-*` and listeners such as `@focus` missed the control too. Now `class` and `style` stay on the wrapper and everything else goes to the control (the input, the textarea, the trigger button, the checkbox). If you relied on an attribute or a listener landing on the wrapper, put it on an element around the field instead.
256
- - Showcase: the search field has its own `aria-label`.
257
-
258
- ## 5.8.2
259
-
260
- No change to the library: the showcase writes the chosen section into the address (`#section`) and opens a `#section` link, and the `taoui-dev` skill is up to date.
261
-
262
- ## 5.8.1
263
-
264
- Fixes after 5.8.0; nothing to migrate.
265
-
266
- - **TaoTag is centred as in 5.6.2 again.** The optical centring of 5.7.0 (`text-box`, the letters themselves in the middle) brought the tall letters too close to the top border; the line of 5.6.2 centres the text on a whole pixel, and that is what a tag does now. The horizontal centring of a wide tag stays.
267
- - **A snackbar has no cross unless you ask.** A toast with no title and an action has no close button by default: next to the action it is a mistap waiting to happen, and the toast goes by itself. `.closable(true)` brings it back; toasts with a title keep the default.
268
- - **The snackbar action no longer jumps on the first hover.** A toast at the bottom or in the centre stood on a fractional pixel (lines of 1.45 × 14px are 20.3px), and when the first hover repainted the action its text snapped a pixel down. The toast's lines are whole pixels now (`round()`, with the plain value for older browsers), and in a snackbar the text and the action share a baseline instead of being centred half a pixel apart. Across, a centred toast stood on half a pixel in a window of odd width (Chrome shifted the text sideways): the centred areas and the toast are an even number of pixels wide now, so the middle is a whole pixel.
269
- - **The toast's bounce is no longer clipped.** Since the fade moved onto the toast (5.8.0) its slot clipped it, and the slight growth of the bounce and the shadow were cut at the edges. The slot clips only while its row folds away.
270
- - Showcase: a **Backgrounds** section: plain, grain, the glow of the palette, the gradient, glow and grain, each one line of CSS from the roles and classes the kit has.
271
-
272
- ## 5.8.0
273
-
274
- A toast for work in progress; nothing to migrate.
275
-
276
- - **`toast().loading()`**: a spinner instead of the icon, no timeout, `aria-busy`. Finish it with a toast of the same `id` and `replace()`.
277
- - **`toast.promise(promise, { loading, success, error })`**: loading while the promise runs, then success or error in the same place (`success` / `error` may be functions of the result / the error); it returns the same promise.
278
- - **A glass toast keeps its blur while it fades.** The fade ran on the toast's wrapper, and an ancestor below opacity 1 cuts a `backdrop-filter` off from what is behind it (Chrome): the blur waited for the fade in and then popped in, and went out at once on the fade out. The fade now runs on the toast itself.
279
- - **A snackbar is one line.** A toast with no title and an action puts the text and the action on one line, the action at the end as a text button, as phones do (Material, iOS); a long text wraps and the action goes under it, still at the end. With a title the actions stay below as buttons. A neutral toast (`show()`) has no icon of its own now; an icon you give, a status and the spinner still show.
280
- - Showcase: a snackbar example, «Note deleted · Undo» at the bottom.
281
- - **`replace()` changes a toast where it stands.** It used to drop the old one and add the new one at the end of the stack (a leave and an enter, a jump); now it takes the place and the id of the one it replaces, and the item restarts its timer for the new content.
282
-
283
- ## 5.7.0
284
-
285
- Two options and the visual fixes made after 5.6.0; nothing to migrate.
286
-
287
- - **`TaoPagination pageSizes`** (`[10, 20, 50, 100]`): a «Per page» choice next to the total, `v-model:page-size`. A new size moves the page so the first row on screen stays on screen (rows 41–60 at 20 a page are page 1 at 50). The caption is the locale key `perPageText` (optional, so a locale written before still type-checks) and labels the list for a screen reader.
288
- - **`TaoNav indicator="line"`**: the current section in the accent colour with a short line instead of a tint, under the item in the bar look and along its start edge in the rail and the side panel; `auto` moves it with the look. `pill` stays the default.
289
- - **No flash on a field that opens a list.** TaoSelect, TaoDate and TaoDateRange lit their frame on the press (focus) and dropped it at once when the list opened (the focus moves into the list): now the field stays lit while its list is open.
290
- - **The hover shows on any fill.** Rows and controls under the pointer (menus, the menu bar, Select / Combobox options, the tree, the nav, lists, the table, pagination, the calendar, secondary buttons) take the new role `--tao-color-hover`, a see-through wash of the strong text, instead of the solid `--tao-color-surface-hover`. It shows on a grain or glass panel too, and the default dark theme gets a hover you can see (1.27:1 against the raised surface, gray-700 on gray-800 was 1.09:1; palettes 1.16 → 1.25). `surface-hover` stays the solid colour (the colour inputs' checkerboard uses it).
291
- - **The neutral fill under the pointer is a step, not a jump.** It went to the text colour: near-white in the dark themes, so the white label was lost on it, and near-black in the light one. The new role `--tao-color-neutral-hover` steps it a little darker in the dark themes and a little towards the strong text in the light one; the label stays about 7.6:1.
292
- - **TaoTag** centres its text when it is wider than the text (a grid, a fixed width), and centres the letters themselves: a font keeps more room above its letters than below (Segoe UI, Roboto), so with the line box centred the lowercase sat about half a pixel low. Where `text-box` is supported (Chrome 133+, Safari 18.2+) the text is trimmed to the x-height and the baseline, with padding that gives the ascenders and descenders their room back, and the offset is rounded to a whole pixel, so the fix of 5.6.2 (no jumping text) holds; a tag with an avatar keeps the plain centring; elsewhere it is as it was.
293
- - Showcase: the sparkline cards show a trend tag in the `#corner` of TaoCard.
294
-
295
- ## 5.6.2
296
-
297
- Two pixel-level fixes; nothing to migrate.
298
-
299
- - **`TaoTag`: the text no longer jumps from one tag to the next.** The line was `1.25` (15px in a 16px inside, so the text stood 1.5px from the edge). On a fractional position of the page the box and the text rounded to different pixels, and in a list of cards the text of one tag sat a pixel higher than in another. The line is as tall as the inside of the tag now (`calc(var(--tao-tag-height) - 2px)`), the text stands a whole pixel from the edge in every size.
300
- - **The cross of `TaoDrawer`, `TaoModal` and `TaoAlert` is in the middle of its button.** In a flex button Chrome keeps the icon's span `inline-flex`, and `align-items: center` put the icon 2px above the middle (next to the title it looked high). The button is `inline-grid` with `place-items: center` now; it is still `1em x 1em` (5.6.1).
301
-
302
- ## 5.6.1
303
-
304
- - **Fixed: the cross of TaoDrawer, TaoModal and TaoAlert was 24 x 28 px, so its focus ring was a rectangle.** The cross is an inline SVG icon (since 5.0), but the button was still sized as a text glyph: a block that is a text line tall, with the gap under the baseline below a 24px icon. The button is a flex box of exactly the icon's size (`1em x 1em`) now, and the ring is square. Nothing to migrate.
305
-
306
- ## 5.6.0
307
-
308
- Typing a date, as Next Up's old app did; nothing to migrate.
309
-
310
- - **`TaoDate editable`**: a text field you type the date into, with the calendar on a button next to it (or ↓). The text is read in the locale's order of day and month: `5` is the 5th of this month, `5.3` the 5th of March (`3/5` in en-US), `05.03.26` and `5.3.2026` full dates, digits alone split as `0503` / `050326`, ISO works too; a two-digit year goes to the nearest century. Enter or leaving the field applies it; a text that is not a date, or a date outside `min` / `max`, puts the value back; Esc drops the typing (and only then the next Esc reaches a dialog around it); an empty field is `null`. The field shows the date in numbers as the locale writes it (`05.03.2026`, `03/05/2026`). `parse` and `format` take your own rules («tomorrow»), `calendarLabel` names the button (an optional key of the locale, so a locale written before still type-checks). Without `editable` TaoDate is the button it was.
311
- - **Exported:** `parseTaoDateInput(text, { locale, reference })`, `formatTaoDateShort(iso, locale)`, `taoDateOrder(locale)`.
312
- - **Docs:** the default `locale` of TaoDate and TaoDateRange is the app locale (`setTaoLocale`), not `'en-US'` as the prop table said.
313
-
314
- ## 5.5.0
315
-
316
- What a phone interface needs, asked for by an app built on TaoUI (Next Up); nothing to migrate.
317
-
318
- - **`TaoDrawer side="bottom"`**: a bottom sheet. It rises from the bottom edge, as wide as the screen up to 640px (centred on a computer), as tall as its content up to 90% of the screen, with rounded top corners, a grip and its last line above the safe area. Esc, the backdrop and the focus trap as before.
319
- - **`TaoModal fullscreen`**: `true` is the whole screen, square corners, the header and the footer stay while the content scrolls, the safe areas kept; `'narrow'` does that only on a screen narrower than 600px, so one modal is a dialog on a computer and a page on a phone.
320
- - **Eight app icons**: `tao-settings`, `tao-edit`, `tao-trash`, `tao-bell`, `tao-tag`, `tao-repeat`, `tao-undo`, `tao-redo`. 40 built-in icons now (the docs still said 29, though the alignment icons of 5.2 had made it 32).
321
- - **Showcase:** on a phone the page no longer scrolls sideways (the carousel demo widened it to its slide track, and the theme switchers did not wrap), so a sheet or a fixed bar is not cut at the edge.
322
-
323
- ## 5.4.5
324
-
325
- - **The slider has one cursor, the pointing finger**, over the rail, over the thumb and for the whole drag (TaoSlider, TaoRangeSlider, TaoScrubber). It was `grab` over the thumb, `grabbing` while pressed and, once the pointer moved, the rail's finger (the rail holds the pointer capture): three shapes flickered in one gesture, and Opera on Windows draws `grab` / `grabbing` as the four-way move arrows and an up arrow. The finger looks the same in every browser.
326
-
327
- ## 5.4.4
328
-
329
- Visual fixes, nothing to migrate.
330
-
331
- - **TaoNav does not move when the page scrolls.** The side column (the action and the items of the rail and the side panel) stuck at `top: 0` although it stands below the panel's 4px padding, so the first 4px of scrolling lifted it against the edge; it now sticks where it stands. The floating bar jumped up a fraction of a pixel with the content at the very end of the scroll (the page height is often fractional and the scroll end is rounded up): its bottom margin is now 1px short of its sticky offset, so it stays stuck.
332
- - **TaoAlert folds with a slide**, as TaoSpoiler does: the body's row closes from `1fr` to `0fr`, and the text gets `hidden="until-found"` when the slide has ended, so find-in-page still opens it. With reduced motion it folds at once.
333
- - **Series colours stand further apart.** In the dark theme chart-4 (violet) sat next to the info blue of chart-2 (colour distance 0.092): it is a deeper violet now (`--tao-violet-400` `#9d5cff`, 0.189). In the light theme chart-4 is a purple (`--tao-violet-600` `#b03ad1`) and chart-6 orange (`--tao-tangerine-600`, new), because teal sat on the dark success green (0.093). A test keeps every pair of both themes at least 0.11 apart and 3:1 on the page. `--tao-teal-600`, added in 5.3.0 for that teal, is gone.
334
-
335
- ## 5.4.3
336
-
337
- - **Fixed: the bottom bar of TaoNav rose under the content on a page shorter than the window** (an empty list, a short settings page). The root had no height of its own and the grid inside only shared the height of the content. The root is now a flex column and the shell fills it, so a min-height / height given to TaoNav (min-height: 100dvh for a whole-window app) keeps the bar at the bottom, and the rail and the side panel run the full height. Nothing to migrate: without a height it behaves as before.
338
-
339
- ## 5.4.2
340
-
341
- - **Fixed: a toast in a centred position stuck to the left edge.** `topCenter` (the default), `bottomCenter` and `center` span the whole width, and the stack inside was `width: 100%`, so there was nothing to centre. The stack now shrinks to its widest toast in those three positions and `justify-content: center` centres it. Corner positions are unchanged. Nothing to migrate.
342
-
343
- ## 5.4.1
344
-
345
- - **Fixed: a striped `TaoCard` / `TaoBlock` painted over a sticky `TaoNav` bar.** The stripe layer (`::after`) and the Card `#corner` use `z-index: 1`, but a panel did not form a stacking context, so they joined the page's layer and tied with the bar (`z-index: 1`, earlier in the DOM): the coloured stripe ran across the bottom bar while a card scrolled under it. `.tao-panel` is now `isolation: isolate`. Nothing to migrate.
346
-
347
- ## 5.4.0
348
-
349
- One slot, nothing to migrate.
350
-
351
- - **`TaoNav` `#action`:** the main action of a screen (Compose, New) moves with the navigation instead of staying in a far corner of a wide screen. Pass a `TaoButton` with `icon` and its text in `<span class="tao-nav__action-label">`. The bar look puts it round above itself at the end side, 12px off like the pill (with `floating` it lines up with the pill's edge, so it follows a centred pill); the rail puts it round at the top, above the items; the side panel puts it at the top, full width, with the text (an extended button). In the round looks the text is visually hidden and stays the button's name. CSS places it from the same `--_*` variables as the rest, so `layout="auto"` switches it by container queries without JS; that is also why the slot has no props: only CSS knows the look in `auto`. The hand-placed round button of the 5.2 showcase is gone.
352
-
353
- ## 5.3.0
354
-
355
- Small charts and a bridge to chart libraries; nothing to migrate.
356
-
357
- - **`TaoSparkline`**: a trend for a card, a table cell or a line of text. `values` (a `null` is a gap that splits the line), `area`, `dot` on the last value, `tone`, a fixed `min` / `max` to compare several. With `label` it is an image with that name, without it a decoration.
358
- - **`TaoMeter`**: a measured value in a range (`role="meter"`): disk space, a battery, a score. With `low` / `high` / `optimum` it colours itself as the HTML `<meter>` does: the region of the optimum is success, the next one warning, the far one danger. `label`, `valueText` (a number or your own text, read as `aria-valuetext`). The progress of a task stays `TaoProgress`.
359
- - **`TaoDonut`**: a share of a whole, from `segments` (`{ label, value, tone?, color? }`) or a single `value` of `max`. `legend`, a centre slot, `size` / `thickness`; a screen reader hears the label and every part with its share.
360
- - **Series colours** `--tao-color-chart-1…6`: the accent first, then the info, success and warning roles (so a palette moves them away from its accent), a violet and, last, pink in the dark theme or teal in the light one, whose accent is pink. Red is left out: it reads as «bad». Palettes re-declare the series built on roles and give their second stop to chart-4. New primitives `--tao-violet-400 / -600`, `--tao-teal-600`.
361
- - **`taoChartTheme(el?)`** returns the theme colours for Chart.js, ECharts, uPlot and the like, resolved where the element is (its palette, its mode) and converted to `rgb()` / `rgba()`: the roles are often `color-mix()`, which canvas libraries do not parse. **`watchTaoChartTheme(apply, el?)`** calls it now and on every theme, mode or palette change. TaoUI will not grow axes, tooltips or zoom: that is a chart library's work.
362
-
363
- ## 5.2.0
364
-
365
- New components and options, nothing to migrate.
366
-
367
- - **`TaoToolbar`**, **`TaoToolbarGroup`**, **`TaoToolbarSeparator`**: a bar of tools (`role="toolbar"`). It is one Tab stop with a roving tabindex: `←` / `→` (`↑` / `↓` with `orientation="vertical"`) walk the items and wrap, Home / End go to the ends, disabled items are skipped, and the bar remembers the last item. The items are found in the DOM, so any control fits: inside a `TaoSegmented` the arrows pick the option and move on from its edge, a text field keeps its arrows. A thin line across the bar splits the groups; `inset` puts a sunken pill behind a group. `variant="panel | plain"`, `size`.
368
- - **`TaoButton` `v-model:pressed`:** a toggle button (Bold, a filter). It says `aria-pressed` and, while pressed, wears a wash of its tone's text colour (every variant but `primary`). Without the prop the button is unchanged.
369
- - **`TaoNav` `floating`:** in the bar look the panel is a detached pill above the page, inset from the edges and above the safe area, with a shadow and a pill for the active item; 520px at most, centred. The rail and the side panel do not change, in `auto` too. The main action of a screen belongs beside it as your own round button (see the showcase), not in a notch of the bar.
370
- - **Icons** `tao-align-left`, `tao-align-center`, `tao-align-right`.
371
-
372
- ## 5.1.1
373
-
374
- Visual fixes, nothing to migrate.
375
-
376
- - **Dark theme tone fills:** the neutral button had a dark label on its grey fill (3.4:1), it is white now (5.7:1) through a new role `--tao-color-on-neutral` (white in both themes). Success and info are a step lighter (`green-400`, the new `blue-300`) so they read as buttons on a dark page with their dark label, and **warning leans to orange** (`--tao-tangerine-400`, `#ff8f3d`): the amber accent keeps yellow, so the two are not mistaken for each other (colour distance 0.037 → 0.114 for the text, as fill and as text). The light theme and the palettes are unchanged.
377
- - **Hover is twice as quick:** `--tao-transition-base` runs on the new `--tao-duration-hover` (0.1s instead of 0.2s), so a state follows the pointer instead of trailing behind it; other motion keeps its durations. Rows the pointer sweeps across (TaoMenu items, TaoMenubar entries, TaoTree rows) change at once, as in a system menu.
378
- - **TaoSplit cursors** are the matching pair `ew-resize` / `ns-resize` (`col-resize` / `row-resize` are drawn as two different shapes on Windows).
379
-
380
- ## 5.1.0
381
-
382
- Two small additions, nothing to migrate.
383
-
384
- - **`TaoSwitch` `loading`**: the change is being applied (a request is on its way). A spinner runs on the thumb, a click does nothing and the box stays as the model says, the switch is not greyed out like a disabled one, and `aria-busy` tells a screen reader.
385
- - **A contact patch on the slider thumb** (`TaoSlider`, `TaoRangeSlider`, `TaoScrubber`): a soft ring of the thumb's own colour around the dot, wider under the pointer and widest while dragging, as if a finger pressed it. A shadow, so the layout and the hit area stay the same; none on `flat` and disabled sliders; the keyboard focus ring moves outside it.
386
-
387
- ## 5.0.0
388
-
389
- 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.
390
-
391
- 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.
392
-
393
- ### Breaking
394
-
395
- - **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).
396
- - `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.
397
-
398
- ### Palettes
399
-
400
- - **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).
401
- - **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.
402
- - **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.
403
- - **`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.
404
- - **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`.
405
- - 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.
406
- - The showcase has a palette picker (with the four colours of the chosen one) next to the dark / light switch; the choice is remembered.
407
-
408
- ### Packaging
409
-
410
- - **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.
411
- - **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()`.
412
- - `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.
413
- - **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).
414
- - `npm run lint:package` (`publint` + `attw`) and the consumer smoke test run in CI; README has a "Browser support" section.
415
-
416
- ### Components
417
-
418
- - **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()`.
419
- - **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.
420
- - **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.
421
- - **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.
422
- - **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).
423
- - **`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`.
424
- - **`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.
425
- - **`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`.
426
- - **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.
427
- - **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 }`.
428
- - **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.
429
- - **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).
430
- - **`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.
431
- - **`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.
432
- - **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.
433
- - **`TaoTimeline` → `TaoScrubber`** (play / pause + a time slider). The name `TaoTimeline` is kept for a vertical event feed later.
434
- - **`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).
435
- - **`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.
436
- - **`TaoCard`**: slots `media` (was `cover`), `header`, `title`, `sub`, `footer`, `overlay` and the new `corner`; `closable` + `close`. `headerTitle` and `headerSecondary` are gone (use `header`).
437
- - **`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`.
438
- - **`TaoTabs` `justify`** is typed (`TaoJustify`, as in `TaoFlex`). The `TaoGrid` breakpoint lives in one file.
439
- - **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.
440
- - **`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.
441
-
442
- ### Icons
443
-
444
- - **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.
445
- - 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.
446
- - **`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.
447
-
448
- ### Overlays: one engine
449
-
450
- - **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`.
451
- - **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.
452
- - **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.
453
-
454
- - **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.
455
- - **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`.
456
- - **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.
457
- - **`placement`** (`top` / `bottom` / `left` / `right` plus `-start` / `-end`) replaces `position` on Popover, Tooltip and ColorInput.
458
- - A Select inside a Modal no longer closes the Modal on Escape.
459
-
460
- ### Tone
461
-
462
- - **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.
463
- - **`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.
464
- - 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).
465
- - 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.
466
-
467
- ### Tokens
468
-
469
- - **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`.
470
- - **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.
471
- - **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).
472
- - **z-index scale** `--tao-z-modal | popup | tooltip | toast | confirm`; no component writes a literal any more.
473
- - **`--tao-transition-base` no longer animates `all`**: colours, shadow, opacity and transform only.
474
- - **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.
475
-
476
- ### Internal
477
-
478
- - `deprecationWarning` / `warnDeprecated` take the version that removes the name (`removeIn`), no longer a hard-coded "3.0".
479
- - 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.
480
-
481
- ## 4.0.1
482
-
483
- - **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`.
484
-
485
- ## 4.0.0
486
-
487
- ### Breaking: English is the default language
488
-
489
- - **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.
490
- - **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.
491
- - `setTaoLocale(overrides)` now merges on top of English (it merged on top of Russian). Pass `setTaoLocale(overrides, localeRu)` to keep the old base.
492
-
493
- ### Minimum width
494
-
495
- - **`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`.
496
- - **`TaoSegmented` `minWidth`** and **`--tao-segmented-option-min-width`**: the minimum width of every option, including in `block` mode.
497
-
498
- ## 3.4.1
499
-
500
- - **Fix:** `TaoScrollTop` `variant="text"` could not be shown without a caption: `label=""` now hides it, leaving just the arrow button (the accessible name stays).
501
-
502
- ## 3.4.0
503
-
504
- ### TaoScrollTop
505
-
506
- - **`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).
507
- - **`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.
508
- - **`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.
509
- - **Fix:** the button had no accessible name unless `ariaLabel` was passed; it now falls back to `label`, then to the locale text.
510
- - **Fix:** `size`, `bottom` and `zIndex` react to prop changes (they were read once at setup).
511
- - 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.
512
-
513
- ## 3.3.2
514
-
515
- - **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.
516
-
517
- ## 3.3.0
518
-
519
- ### Presentation
520
-
521
- - **Showcase in English and Russian:** language switch in the header, `?lang=`, built-in component texts follow the page. English is the default.
522
- - **Static showcase build** with relative paths (`npm run showcase:build`), ready for any folder such as `/sandbox/taoui/`.
523
- - 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`.
524
-
525
- ### Light theme
526
-
527
- - **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`.
528
- - **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).
529
- - Light theme: idle text of Segmented and Tabs (`--tao-color-text-subtle`) is darker (`gray-600`).
530
- - **Fix:** `TaoInputNumber` ± buttons no longer overflow in the `small` size.
531
- - New optional token `--tao-button-primary-text-shadow` (none by default; the light theme sets a soft one).
532
- - The light theme no longer inherits the dark theme's glowing link shadow.
533
-
534
- ### Status colours as text
535
-
536
- - **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`.
537
- - 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.
538
-
539
- ### Feedback
540
-
541
- - **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.
542
- - **`TaoButton` `tone="neutral"`** for `ghost` and `text`: strong text colour with the soft accent wash on hover.
543
- - **confirm():** the cancel button is `ghost` with `tone="neutral"`, so the primary action stands out and the dialog feels lighter.
544
-
545
- ## 3.2.1
546
-
547
- - **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.
548
-
549
- ## 3.2.0
550
-
551
- - **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.
552
- - **TaoColorPicker:** fixed width, so switching HEX / RGB / HSL no longer resizes the popover.
553
-
554
- ## 3.1.1
555
-
556
- - **Popovers close on an outside press in the capture phase**, so a component that stops propagation can no longer keep a popover open.
557
- - **TaoColorPicker:** text is centred in the HEX, RGB and HSL fields.
558
-
559
- ## 3.1.0
560
-
561
- ### Colour
562
-
563
- - **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).
564
- - **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.
565
- - **New `TaoColorInput`**: a field with a swatch and the hex text; the picker opens in a popover.
566
- - **`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.
567
- - `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).
568
- - Locale section `colorPicker`.
569
-
570
- ## 3.0.0
571
-
572
- Cleaner slider family. Breaking changes are allowed in this major: quality over compatibility.
573
-
574
- ### Slider
575
-
576
- - **New `TaoRangeSlider`**: two thumbs, `v-model` is a `[from, to]` pair, `minGap` keeps the thumbs apart.
577
- - **`TaoSlider` and `TaoRangeSlider` share props:** `marks` (`true` for automatic ticks, numbers, or `{ value, label? }`),
578
- `discrete` (the value only sits on marks: stepped scales with captions), `format`, `vertical`, plus the old
579
- `min / max / step / variant / size / showValue / disabled / error / wheel`. Clicking a mark caption moves the nearest thumb.
580
- Slot `#mark="{ mark, active }"` draws a custom caption.
581
- - **`marksSide`** (`'end'` by default, or `'start'`) puts the marks above a horizontal slider / left of a vertical one.
582
- - **`flat`** hides the round thumbs (a plain filled bar); they stay in the markup for keyboard and screen readers.
583
- - **Pure logic in `src/slider.ts`** (value ↔ position, steps without float tails, nearest thumb, marks) with unit tests.
584
-
585
- ### Fixes
586
-
587
- - **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
588
- sets the value.
589
- - **TaoInputNumber:** a value changed from outside (a slider, another field) now replaces the draft of a focused field, so blur does not
590
- write the stale text over it. Typing is not affected: the echo of the field's own value does not overwrite the draft.
591
-
592
- - **A range collapsed into one point can be pulled apart again:** pressing exactly on the point decides the thumb by the direction of the
593
- first move (right: the upper one, left: the lower one). With `flat` such a range shows a small dash instead of disappearing.
594
-
595
- - **No focus ring after a mouse press:** the ring is for the keyboard; it comes back on the first key press.
596
-
597
- ### Timeline
598
-
599
- - **New `TaoTimeline`**: play / pause and «to start» buttons, a slider over time with event marks, a «time / length» label.
600
- `v-model` is the time, `v-model:playing` the play state; `pauseOnScrub` pauses when the user grabs the slider; `marks`, `marksSide`,
601
- `format`, `showRestart`, `showTime`, `variant`, `size`, slots `#mark` and `#time`. It does not advance the time itself: drive it with
602
- anything (for example `usePlayback` from `@1337exp/taoux/playback`). New locale section `timeline` (`playLabel`, `pauseLabel`, `restartLabel`).
603
-
604
- ### Breaking
605
-
606
- - `TaoSlider` `v-model` is a **number** now; the `number | string` form is gone.
607
- - **Right-click to type a value is gone** (with the `placeholder` prop): use `TaoInputNumber` next to the slider.
608
- - **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).
609
- The pointer area is `.tao-slider__rail`; the root also holds the marks.
610
- - `wheel` works for a single thumb only.
611
-
612
- ## 2.0.0
613
-
614
- One size scale, one API standard, built-in texts in any language. Old prop and event names keep working
615
- as deprecated aliases and print a warning in development builds; they will be removed in 3.0.
616
-
617
- ### Breaking
618
-
619
- - **Size modifier classes are gone.** Sizes now come from CSS variables set by `.tao-size-small` / `-medium` / `-large`.
620
- If your CSS targeted these classes, switch to `.tao-size-*` or the variables:
621
- `tao-button--small|medium|large`, `tao-select--small|large`, `tao-combobox--small|large`,
622
- `tao-select__panel--*`, `tao-combobox__panel--*`, `tao-segmented--*`, `tao-segmented-option--small|medium|large`,
623
- `tao-pagination--small`, `tao-table--compact`, `tao-list--*`, `tao-list-item--s|m|l`, `tao-file-drop__zone--*`,
624
- `tao-slider--small` (now `tao-slider--thin`), `tao-textarea--no-border` / `--center`
625
- (now `--filled` / `--plain` / `--align-center`).
626
- - **`size` has no default any more — it inherits.** A control without `size` takes the size of its ancestors,
627
- `medium` at the root, so pages without `.tao-size-*` look the same.
628
- - **`--tao-field-height` is now an alias of `--tao-control-height`** and follows the current size.
629
- Overriding it no longer changes field height — override `--tao-control-height-medium` instead.
630
- - **TaoSlider `size="small"` is a smaller bar now, not the thin track.** Use `variant="thin"` for seek / volume.
631
- - **Small visual changes:**
632
- - Pagination `small` buttons 28 → 26px;
633
- - List rows `small` 32 → 26px, `large` 48 → 44px, titles 12 / 14 / 16px;
634
- - Table `size="small"` (old `compact`) cell text 13 → 12px;
635
- - Tag is 20px in medium with or without the close button (was 19 / 22);
636
- - Tabs tab 37 → 36px (Button height);
637
- - icon-only Segmented options are square;
638
- - Textarea min-height equals the control height;
639
- - Select / Combobox `large`: the clear and empty rows are 14px;
640
- - Textarea `dummy` no longer shows a red bar.
641
- - **TaoCarousel on mouse / trackpad** scrolls freely and settles on a whole slide after it stops
642
- (CSS snap stays only on touch screens). A mouse drag keeps its momentum.
643
-
644
- ### Added
645
-
646
- - **Sizes.** `TaoSize` (`small | medium | large`) on Button, Input, InputNumber, Quantity, Textarea, Select, Combobox,
647
- Date, DateRange, Segmented, Checkbox, Radio / RadioGroup, Switch, Tag, Tabs, Pagination, FileDrop, Slider, Table,
648
- List, PinCode, InputGroup and FormField. `class="tao-size-small"` on any element sizes the whole block.
649
- Tokens: `--tao-control-height` / `-padding-x` / `-padding-y` / `-font-size` / `-font-size-secondary`,
650
- `--tao-button-padding-x`, `--tao-indicator-size`, `--tao-tag-height` / `-padding-x` / `-font-size`.
651
- - **Locale.** `app.use(TaoUI, { locale: localeEn })`, `setTaoLocale()`, `localeRu` (default), `localeEn`,
652
- types `TaoLocale`, `TaoLocaleOverrides`, `TaoUIOptions`. Pass a few keys to change single texts.
653
- Switching at runtime updates components already on the page.
654
- - **Surfaces.** `surface` on TaoCard / TaoBlock (`flat | grain | glass`, type `TaoSurface`) and classes
655
- `.tao-surface-grain` / `-glass` for any element. Theme tokens `--tao-surface-grain-image` / `-size`,
656
- `--tao-glass-fill` / `-border` / `-blur`. Toast and confirm are glass by default (`surface` in their defaults, options
657
- and builders; `'flat'` turns it off). Glass falls back to a solid panel without blur support or with
658
- `prefers-reduced-transparency`.
659
- - **`error`** on InputNumber, Quantity, Switch, Segmented, Radio, RadioGroup, Slider and PinCode.
660
- - **`change`** on Slider, Split (on release), Spoiler, Tabs; FileDrop and Table got `change` too.
661
- - **PinCode** `disabled`, `size`, `masked`. **Textarea** `variant` (`bar | outline | filled | plain`), `readonly`,
662
- `align`, `autofocus`, `blurOnEnter`. **Checkbox** `checked`. **Container** `width`. **Link** `newTab`.
663
- **ScrollTop** `outline`. **Space / Stages** `direction`. **Copy** `successText`. **Tabs** `items`.
664
- - **Types** `TaoTone`, `TaoLength` (number → px, string → CSS), `TaoTabItem`.
665
- - Length props accept both numbers and strings: Block / Card `padding` and `radius`, Flex / Grid `gap`,
666
- Grid `min`, List / Table `maxHeight`.
667
- - Dev-only warnings for deprecated props, events and values (once per component and name).
668
- - Tests (`npm test`, Vitest).
669
-
670
- ### Fixed
671
-
672
- - Textarea `noSpace` also strips spaces from pasted text.
673
- - Textarea `borderInverse` turns red on error.
674
- - Slider is marked invalid inside an invalid TaoFormField.
675
-
676
- ### Deprecated → use instead
677
-
678
- | Component | Deprecated | Use |
679
- |---|---|---|
680
- | Alert, Tag | `type` | `tone` |
681
- | Tag | `pointer` | `clickable` |
682
- | Input | `label`, `errorMessage` | `label` / `error` of TaoFormField |
683
- | Textarea | `noBorder`, `noBackground` | `variant="filled"`, `variant="plain"` |
684
- | Textarea | `dummy`, `textCenter`, `autoFocus`, `submitOnEnter`, `borderInverse` | `readonly`, `align="center"`, `autofocus`, `blurOnEnter`, `variant` |
685
- | Table | `compact`, event `sort` | `size="small"`, event `change` |
686
- | FileDrop | event `files` | event `change` |
687
- | DropdownMenu | event `selected` | event `select` |
688
- | Tabs | `tabs`, item `key` | `items`, item `value` |
689
- | Checkbox | `value` (boolean) | `checked` or v-model |
690
- | PinCode | `hidden` | `masked` |
691
- | Copy | `successMessage` | `successText` |
692
- | ScrollTop | `hasOutline`, `tabindex` prop | `outline`, plain `tabindex` attribute |
693
- | Link | `asNewTab` | `newTab` |
694
- | Space, Stages | `vertical` | `direction` |
695
- | Container | `size` | `width` |
696
- | Avatar | `size="s"` / `"m"` / `"l"` | `small` / `medium` / `large` |
697
- | Divider | `size="big"` | `size="large"` |
698
- | — | `TaoSegmentedSize` | `TaoSize` |
1
+ # Changelog
2
+
3
+ ## 5.29.1
4
+
5
+ - **`TaoSlider` `editable`: the field is opaque.** Its background was the translucent input colour, so over the filled part of the bar the accent showed through it and the typed number was unreadable. The field now lies on the page background first.
6
+
7
+ ## 5.29.0
8
+
9
+ Nothing to migrate; the defaults do not change (`editable` is off, a slider that does not pass it works as before).
10
+
11
+ - **`TaoSlider` / `TaoRangeSlider`: `editable`, the value can be typed.** The number over the bar (`show-value`) was only a label, and there was no way to say "exactly 37": the thumb had to be dragged to it. With `editable` a **right click** or a **double click** on the bar (a long press on a touch screen), or **Enter / F2** on a thumb (so the keyboard reaches it too), opens a field over the middle of the bar, where the value text stands. Enter or leaving the field sets the value, snapped to the step (or to the nearest mark with `discrete`) and kept in `min`…`max`, exactly like a value picked with the pointer; a comma works as the decimal point; Esc drops the edit; text that is not a decimal number changes nothing. On a range it edits the thumb nearest to the click (the focused one for the keyboard), and `minGap` still holds. `change` fires once, when the value is set. The field is named by `editLabel`, else by `ariaLabel`, else by the locale (`slider.editLabel`, "Value" / "Значение"); the thumbs advertise `aria-keyshortcuts="Enter F2"`. Off by default, so a slider that is not `editable` keeps its browser context menu.
12
+ ## 5.28.0
13
+
14
+ Nothing to migrate; the defaults do not change.
15
+
16
+ - **New `TaoStretchedLink`: a whole card, row or tile as one link.** A `TaoLink` (so `NuxtLink` / `RouterLink` / `<a>` by itself, with `to`, `newTab`, `private`, `exactPath`) whose layer is stretched over the container: a click anywhere on it goes to the link, and the buttons inside it still work on their own. The link stays where it is in the markup (the title, a "View" button); the container gets `tao-stretched` (it is `position: relative`), and a control that must stay clickable by itself gets `tao-stretched-raise`. The keyboard sees one link and its focus ring goes round the whole container, inside its edge, with the corners from `--tao-stretched-radius` (the radius of a panel by default). The class `tao-stretched-link` works on any `<a>`. It is a context like `tao-frames-soft`: `styles/contexts/stretch.css`, no JavaScript. **One rule, written in the showcase, the README and the stylesheet:** never put `filter`, `transform`, `perspective`, `will-change: transform` or `contain` on the link (on `:hover` too). Such a property makes the link the containing block of its own layer, the layer shrinks to the link, the pointer is no longer over it, the property goes, the layer stretches back, and so on every frame: the cursor flickers between a hand and a text bar. Light the link with a colour, or put the effect on an inner element (on the container it is fine); a test keeps the context itself clear of these properties. Why a component and not a recipe: every site that makes a card clickable meets this, and it is found only by the flicker.
17
+ - **confirm(): a button no longer jumps a pixel under the pointer.** A confirm with a message (the danger one, for example) stood on a fraction of a pixel: its text had fractional line heights (16 x 1.3, 14 x 1.45), so the panel was 143.09px high, and centred in a box where the room left over was odd it started at 351.45. A button on such a fraction is drawn one way at first and snapped to whole pixels when it is repainted under the pointer, so it moved down a little. The line heights are whole pixels at the default sizes now (16 x 1.25 = 20, 14 x 1.5 = 21), and a centred panel with an odd room left over gets a margin of 1px, which moves it by half a pixel onto a whole one (`centringNudge`, when the confirm opens and when the window is resized). No layer is forced (a `will-change` made the text blurry). `TaoModal` had the same fault in a window of the other parity (its panel started at 314.5, and with it the close button, the text and the footer button): its title was `line-height: normal`, which is fractional, and the panel was not nudged. The title is as high as the close button now (24px at the default size) and a centred `TaoModal` is nudged the same way. The nudge is one composable, `useWholePixelPanel` (it also looks again when the content changes size), used by both. `showcase/lab/subpixel.html` measures this for `confirm()`, `TaoModal`, `TaoDrawer`, `toast()` and `TaoTooltip`.
18
+ - **Floating panels start on whole pixels.** The position of every panel placed by `useFloating` (Tooltip, Popover, Select, Combobox, Date, DropdownMenu, the tip of TaoCopy…) came from the anchor and the size of the panel and was often a fraction: a tooltip centred over a button with an odd width stood on a half pixel. Text and buttons on a fraction are drawn one way at first and snapped to whole pixels when they are repainted, so a button in a popover could jump when the pointer came to it. `computePosition` rounds `top` and `left` (after the flip and the clamp into the window), and the arrow is worked out from the rounded position, so it still points at the middle of the anchor. `showcase/lab/subpixel.html` now also measures `TaoPopover` and `TaoSelect`.
19
+ - **TaoCounter: a digit no longer jumps a pixel when it starts to roll.** A digit became a layer of its own only when its `transform` and `blur` began, and the text was then redrawn on whole pixels: in Chromium it moved a little to the left at the start (and back at the end). The digit is a layer from the start now (`will-change`), so it is drawn the same before, during and after. The geometry was never off: the cells and the centre of the text stay put to a hundredth of a pixel.
20
+
21
+ ## 5.27.0
22
+
23
+ Nothing to migrate; the defaults do not change (a plain string in a locale works as before).
24
+
25
+ - **Plural forms in locale texts.** A text that depends on a number may now be written as forms, `{ one, few, many, other }` (as `Intl.PluralRules` names the categories; only `other` is required, a missing form falls back to it), chosen by the number (`count`, or `n`) and the `code` of the locale. A plain string is still accepted and is the same for every number, so nobody has to write forms. The built-in texts that count have them now, in English and Russian: the badge of `TaoAvatar` ("1 notification", "2 уведомления", "5 уведомлений") and the jump buttons of `TaoPagination`. `formatTaoText(text, values, code?)` is exported for your own texts; the types are `TaoText` and `TaoPluralForms`.
26
+ - **`detectTaoLanguage(supported, { fallback?, requested? })`.** The one of your languages that the user would like most, by `navigator.languages` (a server passes `requested`, e.g. `parseAcceptLanguage(header)`); `ru-RU` fits `ru`, `en` is answered by `en-GB`. It only answers: it does not set the language and does not remember it (`saved ?? detectTaoLanguage(['en', 'ru'])`). `matchTaoLanguage(requested, supported, fallback?)` is the pure core.
27
+ - **TaoColorInput: an empty value says it is not set.** For an optional colour (`''`) the field showed an empty frame. Now it says "Not set" (`placeholder`, the text comes from the locale: `colorPicker.placeholder`, "Не задан" in Russian) in a muted voice, the swatch is crossed out, and a screen reader hears it ("Choose color: Not set"). With `clearable` the colour can be taken away again: a Clear row at the foot of the palette, after a divider, as in Select (`colorPicker.clearText` in the locale; it is always there and disabled while there is nothing to clear, so nobody has to guess it exists) and Delete / Backspace on the field; it gives `''`.
28
+ - **Scrollbars: four hooks and a class.** `--tao-scrollbar-size` (5px by default, so the thin scrollbar stays; the rule used `max-width`, which could never make it thicker than the browser's own 15px, now it is `width`), `--tao-scrollbar-thumb` (the accent), `--tao-scrollbar-track` (transparent) and `--tao-scrollbar-width` (`thin` | `auto` | `none`, for Firefox). Set them on `:root`, on a block or on a component; the colours are read where the scroll is, so a block with another theme gets its own accent. The class `tao-native-scrollbars` on `<html>`, or on any block, gives the browser's own scrollbars back for everything inside it. Firefox, which has no `::-webkit-scrollbar`, now gets the same look through `scrollbar-width` and `scrollbar-color` (only there: Chrome 121+ understands them too and would ignore the rules above): a thin scrollbar with the accent thumb, like the other browsers; `tao-native-scrollbars` or `--tao-scrollbar-width: auto` turns it off. The showcase has a panel with sliders under «Layers and theming».
29
+ - **Showcase: the keys of the locale are browsable.** The sections of the locale are buttons: one shows its keys in English and Russian, built from the real `localeEn` / `localeRu`, so the page cannot differ from the library; a template to translate can be copied. New there: plural forms and the language of the user, both live. `showcase/lab/rtl.html` is a probe of the same components left to right and right to left (the status of RTL is in the README of the lab).
30
+
31
+ ## 5.26.0
32
+
33
+ Nothing to migrate; the defaults do not change.
34
+
35
+ - **TaoLoader `variant="diamonds"`.** Four diamonds on two axes, which flow into each other. On each axis a hollow diamond crosses to a filled one; the filled one shrinks as it comes (from half way) and is gone when the hollow one lands; the new filled one grows at the place the hollow one left, before the old one is quite gone; then it goes back the other way. The second axis is the same pair turned a quarter and a fifth of the cycle behind, so the two pass the middle one after the other. Sized, toned and named like the other looks (`size`, `tone`, `color`, `label`), hidden from a screen reader as a picture; under reduced motion it stands and breathes. `showcase/lab/` is a bench for working on such an animation frame by frame (not part of the package).
36
+ - **Showcase: a «Localization» section.** The same components with no text given by hand in three columns, each with a language of its own (`provideTaoLocale`): English, Russian and a third made of a few German keys on top of English (its `code` `de-DE` makes the date read the German way). How to set it (`app.use`, `setTaoLocale`, a subtree), your own language, a prop that wins, what is translated (every section of the locale with its count of texts), and what to know (`<html lang>`, no plural forms).
37
+
38
+ ## 5.25.0
39
+
40
+ Nothing to migrate; the defaults do not change.
41
+
42
+ - **TaoTour: a guided tour of the page.** The page goes dim, the target stays lit (the lit window glides from one target to the next), a card with an arrow says what it is, with Back / Next / Skip, the dots and "Step 2 of 5". A step is `{ id, target?, title?, text?, placement? }`: `target` is a selector, an element or a function; without it (or when it is not on the page) the step is a card in the middle. `interactive` lets the user press the target itself while the rest of the page stays shut. Escape skips, the arrows move on, Tab stays in the card, focus goes back where it was. The step scrolls its target into view (calmly under reduced motion). TaoTour only draws: the state is yours, or `useTour` from TaoUX `tour`, which jumps over steps whose target is gone and remembers that the tour was seen. `useFloating` takes `fixed: true` for a panel inside a layer that is itself fixed. It renders on the server without touching `window` (the lit window is drawn on the client).
43
+ ## 5.24.0
44
+
45
+ Nothing to migrate; the defaults do not change.
46
+
47
+ - **TaoThemeToggle: the light / dark switch as one icon button.** Until now the kit had no switch of its own, only text in the showcase. The icon is the theme a click leads to (a sun while the page is dark, a moon while it is light), the `aria-label` says the same in words (`toLightLabel` / `toDarkLabel`, in both locales). By default it reads `data-tao-mode` of `<html>`, flips it on a click and follows it when somebody else changes it; a palette keeps its name, the old `data-tao-theme="dark"` spelling follows the mode. For your own storage: `v-model` with `:apply="false"`. New icons `tao-sun` and `tao-moon`; `readTaoMode(el)` and `applyTaoMode(el, mode)` are exported. The `#icon` slot (`{ mode, next }`) puts your own glyph in the button, which stays a square with its label. The mode control of the showcase bar is this button now.
48
+
49
+ ## 5.23.2
50
+
51
+ Nothing to migrate; the defaults do not change.
52
+
53
+ - **TaoCopy: the arrow of the tip points at the button at the edge of the window.** When the tip was pushed in from the viewport edge, its arrow stayed in the middle of the tip and no longer pointed at the trigger. It now takes its place from where the trigger falls on the tip (kept off the rounded corners), and it moves to the top edge when the tip flips below the button.
54
+
55
+ ## 5.23.1
56
+
57
+ Nothing to migrate; the defaults do not change.
58
+
59
+ - **The mark in the README now reads on any background.** npm has its own dark / light switch that does not follow `prefers-color-scheme`, so the `<picture>` of 5.23.0 handed a dark-on-dark mark to a dark npm page and the logo vanished. `showcase/public/logo/logo-mark.svg` is a neutral one: a white T and a yellow arrow with a thin dark outline, which reads on light, on dark and on any colour; the READMEs use it with a plain `<img>`. `logo-mark-dark.svg` and `logo-mark-light.svg` stay for the showcase, where the theme is ours.
60
+
61
+ ## 5.23.0
62
+
63
+ Nothing to migrate; the defaults do not change.
64
+
65
+ - **`TaoPinCode` `bordered=false` has no frame in any state.** In 5.22.0 the plain cells still showed a frame for focus and result; now the focus, an error and a success are told by the fill and the digit only (an accent / danger / success tint), and the cells do not jump.
66
+ - **Showcase: a section "Layers & theming".** The real files of the kit (`primitives` → `semantic` → `themes` → `contexts` → `base`) in the order `src/styles/index.css` imports them, each with a note whether it is yours to touch (only the themes are), taken from the source by `?raw`, so the page cannot drift from the library. Below it an own theme by hand: an accent, a page and the corners make a `[data-tao-theme]` file, a preview wears it, and the ratios are rated with the promises of the palettes. `tests/showcase.layers.test.ts` keeps the order equal to `index.css` and the theme's roles real.
67
+ - **`TaoSlider` / `TaoRangeSlider` `zones`: the scale in colour.** `:zones="[{ to: 40, tone: 'info', dot: true }, { to: 70, tone: 'warning', dot: true }, { to: 100, tone: 'danger' }]"`. Each zone runs to its `to` (the first from `min`, the last to `max`), so there are no gaps and no overlaps. `tone` is a colour role of the theme, `color` any CSS colour (it wins; its contrast is yours to keep), `dot` puts a bead where the zone ends, `reveal` keeps the zone clear until the value gets there (the field looks plain and is painted as it fills; its dot shows once the fill has reached it). The bar shows the zones dimmed, the filled part in full colour, and the thumb wears the colour of the zone it stands in. Works with `vertical`, `flat`, `variant="thin"` and a range; marks and `discrete` are untouched. Colour is not a message: say the state in words too. The logic is `normalizeZones` / `zoneAt` / `zoneGradient` in `src/slider.ts`; the types `TaoSliderZone` and `TaoSliderZoneTone` are exported.
68
+ - **`TaoDrawer` (bottom sheet): a graze no longer closes it.** The sheet closed at 30% of its height, or on any flick faster than 0.5 px/ms that went 24 px: a finger that touched it by accident was enough. Now it closes when pulled half of its height, or flung hard (1.2 px/ms or more, a light swipe is not enough: 0.8 px/ms closed it before) after a path of at least 15% of the height; otherwise it comes back. `swipeThreshold` (0.05–1, default `0.5`) sets the share for your sheet. The backdrop already lets go as the sheet is pulled, so the finger sees what releasing now will do.
69
+ - **The mark of the project, and a settings bar in the showcase.** `showcase/public/logo/`: `logo-mark-dark.svg` (a white T for a dark background), `logo-mark-light.svg` (a dark T for a light one) and `favicon.svg` (a tile, with no road markings: at 16px they are only noise), drawn as paths from the design layout; the yellow is `--tao-orange-300`. The READMEs show it with `<picture>`, so GitHub picks the file by its own theme. The showcase wears it in its title as the T of the word, «Tao UI» with the arrow over the `ao` (it follows the mode; the heading keeps its name for a screen reader) and as a favicon. The options of the header moved into a one-line bar that sticks to the top while you scroll, made of the kit itself: language, palette and mode are inline (`TaoSegmented`, `TaoSelect`), the rare ones, density and frames, sit in a «View» popover (`TaoPopover`) whose button shows a dot while one of them is off the default. The brand, with the version tag of the build, shows in the bar once it has stuck, the section list sits below it, and on a phone it scrolls away with the page.
70
+ - **A third context: frames (`.tao-frames-soft`).** A light look for the whole app, or for one panel, with one class. `tao-frames-soft` on `<html>` or a container lets the decorative frames of `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` and `TaoMenubar` go clear, and the panel is held by its fill: an alert gets a little more tint, a table sits on the raised fill. Nothing moves, the 1px border stays in the box, only unseen. `tao-frames-framed` puts the frames back inside a soft area. `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoToolbar` and `TaoMenubar` get `bordered` (not set: follows the context; `true` / `false`: for this panel); `TaoList` keeps its own `bordered`. Not touched on purpose: the frame of a field, the focus ring, and the lines between rows: they say where a control is and what belongs together, and WCAG 1.4.11 asks 3:1 of them. The tokens are `--tao-frame-alpha`, `--tao-frame-tint` and `--tao-frame-fill` (`src/styles/contexts/frames.css`, a new file in the layer order). The showcase has a switch «Frames» in the header. Fields have `variant="filled"` already; its fill is gentle (about 1.1:1 with the page), so use it knowing that.
71
+ - **`TaoScrollTop`: the caption has an outline.** The hover caption (`label`, and the text mode) over a page of text kept only a soft halo, and the words under it still showed through. It now has a crisp outline in the page colour as well (`-webkit-text-stroke` with `paint-order: stroke fill`, so only the outer half of the stroke shows and the letters stay whole): the text under the caption is cut clear, in both themes, with no backing and no colour. Where `paint-order` is not supported for HTML text (before Chrome 123) the halo is all there is, as before; `@supports` keeps a stroke from eating the letters there.
72
+ - **`TaoStages`: the icons stand on the middle of the label, and the spinner turns about its own centre.** The icon box was a block span, so the svg sat on the text baseline and the box grew by the line gap under it (14 px became 17): every icon was 1.5 px above the middle of its label, and the `work` mark turned about the centre of that taller box and wobbled. The box is now exactly the svg. A test keeps the mark from becoming a block again.
73
+ - **`TaoCarousel`: the track keeps the browser's own cursor.** The `grab` / `grabbing` cursors are gone: system cursors differ much between browsers (Opera showed a big black arrow), and which cursor a carousel wants is the app's decision, set on `.tao-carousel__track`. The drag itself is unchanged. (`TaoSplit` keeps its resize cursors and `TaoColorPicker` its crosshair: there the cursor is part of the meaning.)
74
+ - **`TaoSlider` / `TaoRangeSlider` `bubble`: the value in a bubble at the thumb.** Off by default, so nothing that exists changes. `bubble`: it shows while the thumb is dragged, hovered or has the keyboard focus (a touch drag shows it above the finger); `bubble="always"`: it stays. The text is `format` of the value, or the `#bubble="{ value, zone }"` slot (an icon, a word). It wears the colour of the zone the thumb stands in (the accent without zones) with a label that reads on it: the `on-` role of the tone, black or white by contrast for a colour of your own, the browser picks for a colour the script cannot read. A screen reader already has `aria-valuetext`, so the bubble is `aria-hidden`. It sits above a horizontal bar and to the right of a vertical one: leave room for it.
75
+ - **`TaoLoader`: three looks, a voice, a colour role.** `variant`: `dots` (the four dots, still the default, same size and motion), `ring` (a turning arc) and `pulse` (ripples from a core). `tone` is a colour role of the theme (`color` stays and wins; `currentColor` takes the text around it), `size` is a number or `small` / `medium` / `large`, the sizes come from one number in CSS. It is a `role="status"` with a text for a screen reader (`label`, «Loading» / «Загрузка» from the locale), or `decorative` when the wait is said elsewhere. Under «reduce motion» nothing travels or turns: the picture breathes. `TaoButton loading` wears the same ring in its text colour and says `aria-busy` by itself. The showcase gets «Which wait to choose»: loader, skeleton or progress.
76
+ - **`TaoPinCode`: an error paints the digits red**, as a success always painted them green (`--tao-color-danger-text`).
77
+
78
+ ## 5.22.0
79
+
80
+ Nothing to migrate; the defaults do not change.
81
+
82
+ - **`TaoPinCode` `bordered`.** `:bordered="false"` is a light style: the cells have a soft fill and no frame at rest. The frame is still in the box (the cells do not jump) and is only clear; focus, the active cell, an error and a result paint it, so a state is never left to a fill colour alone.
83
+ - **`TaoDrawer`: the pull of a sheet no longer selects the title.** While the sheet is in the hand the panel has `user-select: none`, and it is given back at the end.
84
+ - **`TaoDrawer`: a pointer that vanishes lets go.** The blur of the window, a tab that goes to the background, `pagehide` and a taken capture (`lostpointercapture`) end the pull as a cancel: the sheet settles back and does not close, and the next pull starts clean. The same guard `TaoCarousel` has had.
85
+
86
+ ## 5.21.0
87
+
88
+ Nothing to migrate; the defaults do not change.
89
+
90
+ - **`TaoMarquee` `decorative`: a line that is only a picture.** For a marquee used as a design feature, in the background. A ghost: `aria-hidden` and `inert` (not a tab stop, nothing to select, no reaction to a cursor or a tap), `pointer-events: none`, and it runs round without a pause, like a looped GIF. Under «reduce motion» it stands still and is clipped, it does not wrap. Use it only for text nobody needs to read: the stop that WCAG 2.2.2 asks of moving content does not apply to pure decoration, and a screen reader will not see it.
91
+ - **`TaoMarquee` `roundPause`.** The rest at the start of every round can be turned off for any line (`:round-pause="false"`): the round is one line plus the gap and the loop has no seam. Not set, it follows `decorative` (no rest) and an ordinary line keeps its rest.
92
+
93
+ ## 5.20.1
94
+
95
+ Nothing to migrate; the defaults do not change.
96
+
97
+ - **`TaoMarquee`: `pauseOnHover="false"` is a background line now.** The prop was there, but a line used as a design feature still stopped for a tap and could be selected while it ran. With `pauseOnHover` off a cursor or a finger passing by does not stop it, and the running text has `user-select: none`. Focus still stops it and a running line stays a tab stop, so the keyboard keeps its way to stop moving content (WCAG 2.2.2). The showcase has a background line.
98
+ - Showcase: the numbers promised by the palettes sit under the palette lab, with the other colour blocks of the section.
99
+
100
+ ## 5.20.0
101
+
102
+ Nothing to migrate; the library does not change.
103
+
104
+ - **Showcase: a section "Contrast & keyboard".** What the README only promised can be tried now. A live look reads the colour roles of this very page from the computed styles and judges every pair with `contrastRatio()` and `apcaContrast()` (the numbers follow the palette and the mode in the header). A pair picker shows the two questions on one colour, with the well-known green `#2ea85c` where WCAG 2 and the eye disagree. A palette lab turns four stops into a whole theme with `applyTaoPalette()` on a preview (or on the page, and takes it off again) and rates the roles it made. A key map lists what the keys do in toolbars, menus, trees and lists, and the numbers the palettes are tested for. Every key line is one a test of the component or its code shows.
105
+ - The section is a frame (`showcase/components/DemoA11y.vue`); each block and its data live apart in `showcase/a11y/`, and `tests/showcase.a11y.test.ts` keeps the roles it reads real and its promises equal to the palette constants.
106
+
107
+ ## 5.19.3
108
+
109
+ A fix; nothing to migrate.
110
+
111
+ - **`TaoCounter`: a fast run of increments no longer leaves empty and half-rolled slots.** A new value that came while the digits were still rolling cut the roll short and piled several digits in one slot. Now the wheels take the next value only when the last digit has landed: the parent already holds the sum of the increments, so the counter rolls once to the latest value, and again if more came during that roll. `aria-label` tells the real value at once. The gate is `createRollGate` in `src/counterRoll.ts`.
112
+
113
+ ## 5.19.2
114
+
115
+ A polish; nothing to migrate.
116
+
117
+ - **`TaoCounter`: the digits roll in turn, not all at once.** All the digits that changed started at the same moment, and `+1337` looked like four wheels jerked together. Now the one on the right goes first and the others follow to the left, 55 ms apart, so they land one after another like an odometer. Only the digits that change take a turn: `1000 → 2000` does not wait for the three that stay. `--tao-counter-stagger` sets the step (`0` brings the old all-at-once back). With `prefers-reduced-motion` the digits change at once. The order is `src/counterRoll.ts`.
118
+
119
+ ## 5.19.1
120
+
121
+ A fix; nothing to migrate.
122
+
123
+ - **`toast()` has no accent bar on the left.** The 5.17.2 bar kept away from the rounded corners, and that left a gap between it and the progress line in the lower left corner. The bar told nothing the icon, the tinted background and the progress line do not: it is gone, and `.tao-toast__accent` with it. The progress line keeps its distance from the corners (`--tao-toast-edge`).
124
+ - Showcase: the buttons in the header of the comments sheet use `icon` (a square of the control height), not an icon in the slot, so the icons sit in the middle.
125
+
126
+ ## 5.19.0
127
+
128
+ Nothing to migrate.
129
+
130
+ - **`TaoDrawer` as a bottom sheet of your own.** A sheet (`side="bottom"`) is pulled down by its grip and header now (`swipeToClose`, on by default): it closes when pulled a third of its height or flung, comes back otherwise, and the backdrop lets go as it goes. The pull starts only from the grip and the header, never from a button or a field in it, so the content still scrolls. It needs `closable`, and if the parent keeps `v-model` open the sheet returns.
131
+ - **`show-close="false"` hides only the cross.** `closable="false"` still means that only the parent closes it (no cross, no backdrop, no Escape, no pull); `showClose` is just the cross, the rest keeps working: a sheet with no cross that is pulled down.
132
+ - **`#header="{ close }"` replaces the whole header** (a title with a counter, a filter, a cross of your own). Name the panel for a screen reader with `aria-label`. The showcase has the comments of a video built from this, with `#footer` as the line to type in.
133
+ - The pull-down is plain pointer events, no dependency on TaoUX; the maths is `src/sheetDrag.ts`.
134
+
135
+ ## 5.18.0
136
+
137
+ One visible change on a phone: a tap no longer flashes.
138
+
139
+ - **No system flash on a tap.** Phone browsers paint a blue (or grey) square over a tapped link or button, and it differs by the shell and fights the theme. `styles.css` sets `-webkit-tap-highlight-color` from the new token `--tao-tap-highlight` (`transparent`) on `<html>`; the property is inherited, so every element gets it. A colour in the token brings a flash of your own back, anywhere in the tree. The kit gives a tap its own feedback instead of leaving it to the system; a row of `TaoList` has none yet, it is next.
140
+
141
+ ## 5.17.2
142
+
143
+ A fix; nothing to migrate.
144
+
145
+ - **`toast()`: a loading toast turns into its result smoothly.** The tone changed at once when the work finished: the bar, the icon and the tinted background jumped from the accent to green or red. Now the colours follow in 0.3 s, the ring gives way to the result icon that comes in, and with `prefers-reduced-motion` nothing is animated.
146
+ - **`toast()`: the accent bar and the progress line are not cut by a large radius.** With `--tao-radius-panel` of 20px and more the curve of the corners cut both marks down to a hair. They keep away from the corners now by 60% of the radius (up to 24px) and have rounded ends, so they lie on the straight part with any radius. `--tao-toast-edge` sets the distance (`0` brings the flush look back). `TaoCard` `stripe` stays clipped by the corners: it is a decoration, the toast marks tell the tone and the time.
147
+
148
+ ## 5.17.1
149
+
150
+ A fix; nothing to migrate.
151
+
152
+ - **`TaoTree` does not loop on a repeated id.** An id is unique in the whole tree. When `load(node)` answered with the same ids at every level (the showcase did: opening `vue` under `node_modules` handed back a `vue`), the node inside its own ancestor sent the walk round in a circle: `RangeError: Maximum call stack size exceeded`. A node whose id is already one of its ancestors is a leaf now. The showcase `load` gives path ids.
153
+ - Inside the repository: `docs/v5-plan.md` (the ideas journal of the 5.0 design) is removed; MIGRATION-5.md no longer points to it.
154
+
155
+ ## 5.17.0
156
+
157
+ Nothing to migrate.
158
+
159
+ - **`TaoFileDrop` `reject` event.** A file that did not pass `accept` was dropped without a word: no `change`, no sign, and the user saw nothing happen. Now `reject` brings the refused files (`File[]`); they are still not in `v-model`, and in a mixed batch the good files go to `change` as before. Say why in your own words (the zone does not guess a message). The `accept` matching moved to `src/fileAccept.ts` with tests. Found by Next Up.
160
+
161
+ ## 5.16.3
162
+
163
+ A fix; nothing to migrate.
164
+
165
+ - **`TaoDivider` follows the theme.** The solid and dashed line read the primitive `--tao-gray-300`, the one thing a component must not read, so a theme or a palette could not recolour it. It reads `--tao-color-text-muted` now (the same grey in the dark theme, a little darker in the light one), at the same 20% opacity.
166
+ - Inside the repository: `tests/component-styles.test.ts` holds that a component reads roles and not primitives, writes no colour of its own, and adds no spacing pixels beyond the recorded ones; the rules in `CONTRIBUTING.md` are regrouped (colour, then component rules).
167
+
168
+ ## 5.16.2
169
+
170
+ A fix; nothing to migrate.
171
+
172
+ - **A light-theme field is the same surface as its neighbours.** `--tao-color-input-bg` is the sunken surface (`--tao-color-surface-sunken`) in the light theme now, as it already was in the dark one, so a field and the segmented track next to it, a switch or a tab bar come out of one role and not of two close greys. It was white in 5.16.0 and translucent white in 5.16.1, and it still stood off its neighbours. The disabled field takes a translucent grey tone, as in the dark theme, because `gray-50` is the field itself now. The text stays at 18:1. The framed fields keep their border.
173
+
174
+ ## 5.16.1
175
+
176
+ A fix; nothing to migrate.
177
+
178
+ - **A field follows the panel under it in the light theme.** `--tao-color-input-bg` was pure white (`--tao-gray-0`) whatever it lay on, while in the dark theme it is a translucent tone that follows the surface. On a window or a drawer painted another colour (`--tao-surface-fill`, a darker panel, a tinted palette surface) the light `TaoInput`, `TaoSelect`, `TaoTextarea`, `TaoDate` and the other fields stood out white against components that take their colour from the surface scale. Now it is white at 65% opacity: on a plain page it is still white, on a tinted or darker panel it takes the panel's tone. The text stays at 19:1.
179
+
180
+ ## 5.16.0
181
+
182
+ Nothing to migrate; the one visible change is the current `TaoNav` item, which is bolder now.
183
+
184
+ - **`TaoNav`: the current item is told apart by weight as well as colour.** It was the accent colour on its own tint, and that is thin for a person who does not tell colours apart (WCAG 1.4.1: do not rely on colour alone); in the light theme the text on the tint is also close to the 4.5:1 edge. The label is `font-weight: 600` now. `--tao-nav-active-weight` sets another weight (`400` brings the old look back). `indicator="line"` has its line as the second mark already and takes the same weight.
185
+
186
+ ## 5.15.0
187
+
188
+ `TaoModal` and `TaoDrawer` put your `class`, `style` and other attributes on the dialog panel now, not on the overlay or the layer around it: if you styled the overlay through a class on the component, move that rule to `.tao-modal-overlay` / `.tao-drawer`.
189
+
190
+ - **`TaoModal` scrolls its content, not itself.** The whole dialog scrolled, so the `#footer` went away with the text and an app drew its own sticky bar (in the page colour, with a dark edge round the buttons). Now the content scrolls and the header and the footer stay, as they already did in `fullscreen`. `--tao-modal-bg` is the panel colour, for a bar of your own that sticks inside.
191
+ - **`TaoModal` and `TaoDrawer` take `surface`:** `grain` (a film grain over a solid fill) or `glass`, as on TaoCard, TaoBlock and TaoNav; with the attributes on the panel, `class="tao-surface-grain"` works too. `--tao-drawer-bg` is the drawer panel colour.
192
+ - **The grain goes when more contrast is asked** (`prefers-contrast: more`): the fill stays solid and clean.
193
+ - **`TaoNav` `badgeTone`:** `neutral` makes the counters grey with the accent on the current item only, so the eye is not pulled round the menu; a dot (`badge: true`) stays the accent. The docs say what is what: `.tao-nav` is the whole layout (navigation and page), `.tao-nav__panel` the navigation, `.tao-nav__content` the page.
194
+ - **`TaoDropdownMenu` `size` and `tabbable`:** `size` makes the button a square of that control height (a compact kebab in a list row); `:tabbable="false"` takes it out of the Tab order when the row has its own menu key.
195
+ - Showcase: a grain modal with a long text, a compact kebab, neutral counters in the TaoNav demo.
196
+
197
+ ## 5.14.0
198
+
199
+ Nothing to migrate.
200
+
201
+ - **`TaoList` `roving`.** One Tab stop for the whole list: the arrows move between the rows, Home / End to the first and the last, disabled rows are skipped, and Tab comes back to the row it left (the selected one the first time). The stop of a row is its button (`clickable`) or the row itself, with the focus ring of a clickable row. Rows added or removed are followed; a key pressed in a row's own control (an input, a menu) stays with it. An app no longer writes its own roving tabindex for a list of records.
202
+ - **`TaoListItem` focus ring round the whole row.** On a `clickable` row the ring was drawn on its button, inside the row's padding, so it stood off the edges while the highlight ran the full width. It goes round the row now (`:has()`; older browsers keep the ring on the button).
203
+ - Showcase: the «People» list is roving.
204
+
205
+ ## 5.13.0
206
+
207
+ Nothing to migrate.
208
+
209
+ - **Hidden inputs no longer stretch the page.** `TaoSwitch`, `TaoCheckbox`, `TaoRadio`, `TaoFileDrop` and `TaoPinCode` keep a visually hidden input (or a status) that is `position: absolute`, and their root was not positioned: the hidden element stood against the page, not the field, so a scrolling container did not clip it and the document grew (a long form in a `overflow: auto` block scrolled the whole page). Each root is `position: relative` now.
210
+ - **`TaoNav` `#footer`:** a small line under the items in the rail and the side panel (the version, «About», a link); the bar has no room for it and does not show it.
211
+ - Showcase: the TaoNav demo has a footer.
212
+
213
+ ## 5.12.0
214
+
215
+ Nothing to migrate.
216
+
217
+ - **`TaoTextarea` `maxHeight`.** The field grew with its text up to 500px, written into the component. Now `maxHeight` sets it: a number is px, a string any CSS length (`50vh`, `20rem`), `none` — no limit; 500 stays the default. Dragging the corner stops there too. A framed field (`variant="outline"`) no longer scrolls by 2px: the height counts its border.
218
+
219
+ ## 5.11.1
220
+
221
+ A fix; nothing to migrate.
222
+
223
+ - **Secondary text reads in the dark theme.** `--tao-color-text-muted` (labels, hints, legends, the names in TaoNav and the charts) was `#666`: 3.2:1 on the page and 2.9:1 on a card, below the 4.5:1 of normal text, in every dark palette. It was the grey of the neutral fill too, where a white label needs it dark. The two are apart now: the new `--tao-color-neutral` keeps `#666` for `tone="neutral"` (its white label stays 5.7:1), and muted text is `#8a8a8a` (`--tao-gray-350`): 5.3:1 on the page and 4.8:1 on a card. The light theme was fine (5.7:1) and does not change. The carousel dots and the knob of a switch that is off take the muted grey too and are a little lighter. A test now holds muted text at 4.5:1 on the page and on a card in both themes.
224
+ - **`TaoHeatmap` stripes, even.** The hatched levels were one gradient over the whole cell with 1.5px lines, and the browser drew them thicker and thinner by turns. Now a 6px tile repeats, so every stripe is the same: about 1px, 4px apart, at 135°, and lighter (45% of the tone), so they do not ripple.
225
+ - Showcase: the «Orders by time» caption stands off the map.
226
+
227
+ ## 5.11.0
228
+
229
+ Nothing to migrate.
230
+
231
+ - **`TaoButton` `shortcut`:** `shortcut="N"` shows the key at the end of the button, in a small chip of the button's own text colour, so it fits any variant and tone; in a wide button it goes to the far edge. It is given as `aria-keyshortcuts` and the chip itself is not read twice. It only shows the key: listening to it is the app's job.
232
+ - **`TaoNav` labels fit the rail.** An item with the icon over its label (the rail, the bar) kept 12px on each side, so the rail left 47px for a label and «Settings» or «Calendar» in Russian were cut. Now it keeps 4px, and the label has about 63px. The side panel is unchanged.
233
+ - **`TaoNav` widths are public:** `--tao-nav-rail-width` (80px), `--tao-nav-drawer-width` (240px) and `--tao-nav-action-radius`, set on `:root` or any wrapper, for an app whose labels are longer still.
234
+ - **`TaoNav` action in the side panel:** the button keeps its own corners, like the items under it, instead of a pill (`--tao-nav-action-radius: var(--tao-radius-full)` brings the pill back), and stands off the top edge. A `shortcut` on it shows in the side panel and hides with the label when the button is round.
235
+ - **`TaoNav` side panel, lighter.** Its rows were 48px, the finger size of the bar, with 4px around the panel. With a mouse they are now a little taller than a control (40px at the medium size, and they follow the size and the density), and the panel keeps 12px from its edges, so the action and the items stand off them like a list in a card. On a touch screen (`pointer: coarse`) the rows stay 48px. The bar and the rail do not change.
236
+ - **`TaoNav` `surface`:** `flat` (the default), `glass` or `grain`, as on TaoCard. `glass` lets the page show blurred through the bar while it scrolls under it, the floating pill included; where blur is not supported or less transparency is asked, the panel is solid.
237
+ - Showcase: buttons with a shortcut; the TaoNav action shows `N` and switches the surface, with something bright under the bar.
238
+
239
+ ## 5.10.0
240
+
241
+ Nothing to migrate.
242
+
243
+ - **`variant` on the text fields:** `TaoInput`, `TaoInputNumber` and `TaoCombobox` take `outline` (the frame, the default), `filled` (a fill only) and `plain` (no frame, no fill, no inset), the names `TaoTextarea` already uses. On a plain `TaoInputNumber` the ± buttons lose their lines too. A `plain` field reads as text, for an item of a list being edited: the caret shows the focus, and an error is a red line under the text, so the text does not move. The height is the same in all three. `filled` takes a fill of the text colour, so it shows on a page, a card or glass alike.
244
+ - A test now fails for any field whose control takes the field id (`:id="controlId"`) but does not split its attributes with `useControlAttrs`, so a new field cannot put its `aria-label` on the wrapper again.
245
+ - Showcase: the variants in the TaoInput section.
246
+
247
+ ## 5.9.0
248
+
249
+ A new component; nothing to migrate.
250
+
251
+ - **TaoHeatmap.** A value for each pair of two things: orders by weekday and hour, visits by week and day. `values` by `rows` × `cols` (`null` is no data); a cell takes the colour of the highest threshold it reaches (`steps`, round numbers at 10–80% of the largest value by default), from faint to the full `tone`, and the legend names them («200+, 500+, 1 000+»). The `hatch` lowest levels are striped, so they read apart from the empty cells without colour too. A tip over the cell gives the row, the column and the number (`format`, by the locale by default; a `tip` slot for your own), kept on whole pixels inside the map. It is a `role="grid"`: one cell is in the tab order, the arrows, Home / End and PageUp / PageDown move it, and a screen reader reads the row, the column and the number. It fits the width of its container, and the column names show as often as they fit (`labelEvery` to choose).
252
+ - Showcase: «Orders by time» in the charts section.
253
+
254
+ ## 5.8.4
255
+
256
+ A fix; nothing to migrate.
257
+
258
+ - **The rest of the fields get their name too.** `TaoQuantity` and `TaoFileDrop` pass their attributes to their control (the number input, the file input), like the fields in 5.8.3. `TaoColorInput` passes them to its trigger button, and an `aria-label` you give names it while the colour still follows: «Background: #ff8800» (without one, the locale's «Choose a colour»). `TaoColorPicker` is a `group`, so its `aria-label` names something. Each `TaoPinCode` cell says which character it is: «Character 2 of 6», from the new optional locale key `pinCode.cellLabel` (a locale written before still type-checks, English stands in).
259
+
260
+ ## 5.8.3
261
+
262
+ A fix; nothing to migrate.
263
+
264
+ - **A field's attributes reach its control.** `TaoInput`, `TaoTextarea`, `TaoInputNumber`, `TaoCombobox`, `TaoSelect`, `TaoDate`, `TaoDateRange`, `TaoSwitch`, `TaoCheckbox` and `TaoRadio` are a wrapper around their control, and Vue put every attribute you gave them on the wrapper: an `aria-label` named nothing there (a screen reader read the field without its name), and `name`, `autocomplete`, `inputmode`, `data-*` and listeners such as `@focus` missed the control too. Now `class` and `style` stay on the wrapper and everything else goes to the control (the input, the textarea, the trigger button, the checkbox). If you relied on an attribute or a listener landing on the wrapper, put it on an element around the field instead.
265
+ - Showcase: the search field has its own `aria-label`.
266
+
267
+ ## 5.8.2
268
+
269
+ No change to the library: the showcase writes the chosen section into the address (`#section`) and opens a `#section` link, and the `taoui-dev` skill is up to date.
270
+
271
+ ## 5.8.1
272
+
273
+ Fixes after 5.8.0; nothing to migrate.
274
+
275
+ - **TaoTag is centred as in 5.6.2 again.** The optical centring of 5.7.0 (`text-box`, the letters themselves in the middle) brought the tall letters too close to the top border; the line of 5.6.2 centres the text on a whole pixel, and that is what a tag does now. The horizontal centring of a wide tag stays.
276
+ - **A snackbar has no cross unless you ask.** A toast with no title and an action has no close button by default: next to the action it is a mistap waiting to happen, and the toast goes by itself. `.closable(true)` brings it back; toasts with a title keep the default.
277
+ - **The snackbar action no longer jumps on the first hover.** A toast at the bottom or in the centre stood on a fractional pixel (lines of 1.45 × 14px are 20.3px), and when the first hover repainted the action its text snapped a pixel down. The toast's lines are whole pixels now (`round()`, with the plain value for older browsers), and in a snackbar the text and the action share a baseline instead of being centred half a pixel apart. Across, a centred toast stood on half a pixel in a window of odd width (Chrome shifted the text sideways): the centred areas and the toast are an even number of pixels wide now, so the middle is a whole pixel.
278
+ - **The toast's bounce is no longer clipped.** Since the fade moved onto the toast (5.8.0) its slot clipped it, and the slight growth of the bounce and the shadow were cut at the edges. The slot clips only while its row folds away.
279
+ - Showcase: a **Backgrounds** section: plain, grain, the glow of the palette, the gradient, glow and grain, each one line of CSS from the roles and classes the kit has.
280
+
281
+ ## 5.8.0
282
+
283
+ A toast for work in progress; nothing to migrate.
284
+
285
+ - **`toast().loading()`**: a spinner instead of the icon, no timeout, `aria-busy`. Finish it with a toast of the same `id` and `replace()`.
286
+ - **`toast.promise(promise, { loading, success, error })`**: loading while the promise runs, then success or error in the same place (`success` / `error` may be functions of the result / the error); it returns the same promise.
287
+ - **A glass toast keeps its blur while it fades.** The fade ran on the toast's wrapper, and an ancestor below opacity 1 cuts a `backdrop-filter` off from what is behind it (Chrome): the blur waited for the fade in and then popped in, and went out at once on the fade out. The fade now runs on the toast itself.
288
+ - **A snackbar is one line.** A toast with no title and an action puts the text and the action on one line, the action at the end as a text button, as phones do (Material, iOS); a long text wraps and the action goes under it, still at the end. With a title the actions stay below as buttons. A neutral toast (`show()`) has no icon of its own now; an icon you give, a status and the spinner still show.
289
+ - Showcase: a snackbar example, «Note deleted · Undo» at the bottom.
290
+ - **`replace()` changes a toast where it stands.** It used to drop the old one and add the new one at the end of the stack (a leave and an enter, a jump); now it takes the place and the id of the one it replaces, and the item restarts its timer for the new content.
291
+
292
+ ## 5.7.0
293
+
294
+ Two options and the visual fixes made after 5.6.0; nothing to migrate.
295
+
296
+ - **`TaoPagination pageSizes`** (`[10, 20, 50, 100]`): a «Per page» choice next to the total, `v-model:page-size`. A new size moves the page so the first row on screen stays on screen (rows 41–60 at 20 a page are page 1 at 50). The caption is the locale key `perPageText` (optional, so a locale written before still type-checks) and labels the list for a screen reader.
297
+ - **`TaoNav indicator="line"`**: the current section in the accent colour with a short line instead of a tint, under the item in the bar look and along its start edge in the rail and the side panel; `auto` moves it with the look. `pill` stays the default.
298
+ - **No flash on a field that opens a list.** TaoSelect, TaoDate and TaoDateRange lit their frame on the press (focus) and dropped it at once when the list opened (the focus moves into the list): now the field stays lit while its list is open.
299
+ - **The hover shows on any fill.** Rows and controls under the pointer (menus, the menu bar, Select / Combobox options, the tree, the nav, lists, the table, pagination, the calendar, secondary buttons) take the new role `--tao-color-hover`, a see-through wash of the strong text, instead of the solid `--tao-color-surface-hover`. It shows on a grain or glass panel too, and the default dark theme gets a hover you can see (1.27:1 against the raised surface, gray-700 on gray-800 was 1.09:1; palettes 1.16 → 1.25). `surface-hover` stays the solid colour (the colour inputs' checkerboard uses it).
300
+ - **The neutral fill under the pointer is a step, not a jump.** It went to the text colour: near-white in the dark themes, so the white label was lost on it, and near-black in the light one. The new role `--tao-color-neutral-hover` steps it a little darker in the dark themes and a little towards the strong text in the light one; the label stays about 7.6:1.
301
+ - **TaoTag** centres its text when it is wider than the text (a grid, a fixed width), and centres the letters themselves: a font keeps more room above its letters than below (Segoe UI, Roboto), so with the line box centred the lowercase sat about half a pixel low. Where `text-box` is supported (Chrome 133+, Safari 18.2+) the text is trimmed to the x-height and the baseline, with padding that gives the ascenders and descenders their room back, and the offset is rounded to a whole pixel, so the fix of 5.6.2 (no jumping text) holds; a tag with an avatar keeps the plain centring; elsewhere it is as it was.
302
+ - Showcase: the sparkline cards show a trend tag in the `#corner` of TaoCard.
303
+
304
+ ## 5.6.2
305
+
306
+ Two pixel-level fixes; nothing to migrate.
307
+
308
+ - **`TaoTag`: the text no longer jumps from one tag to the next.** The line was `1.25` (15px in a 16px inside, so the text stood 1.5px from the edge). On a fractional position of the page the box and the text rounded to different pixels, and in a list of cards the text of one tag sat a pixel higher than in another. The line is as tall as the inside of the tag now (`calc(var(--tao-tag-height) - 2px)`), the text stands a whole pixel from the edge in every size.
309
+ - **The cross of `TaoDrawer`, `TaoModal` and `TaoAlert` is in the middle of its button.** In a flex button Chrome keeps the icon's span `inline-flex`, and `align-items: center` put the icon 2px above the middle (next to the title it looked high). The button is `inline-grid` with `place-items: center` now; it is still `1em x 1em` (5.6.1).
310
+
311
+ ## 5.6.1
312
+
313
+ - **Fixed: the cross of TaoDrawer, TaoModal and TaoAlert was 24 x 28 px, so its focus ring was a rectangle.** The cross is an inline SVG icon (since 5.0), but the button was still sized as a text glyph: a block that is a text line tall, with the gap under the baseline below a 24px icon. The button is a flex box of exactly the icon's size (`1em x 1em`) now, and the ring is square. Nothing to migrate.
314
+
315
+ ## 5.6.0
316
+
317
+ Typing a date, as Next Up's old app did; nothing to migrate.
318
+
319
+ - **`TaoDate editable`**: a text field you type the date into, with the calendar on a button next to it (or ↓). The text is read in the locale's order of day and month: `5` is the 5th of this month, `5.3` the 5th of March (`3/5` in en-US), `05.03.26` and `5.3.2026` full dates, digits alone split as `0503` / `050326`, ISO works too; a two-digit year goes to the nearest century. Enter or leaving the field applies it; a text that is not a date, or a date outside `min` / `max`, puts the value back; Esc drops the typing (and only then the next Esc reaches a dialog around it); an empty field is `null`. The field shows the date in numbers as the locale writes it (`05.03.2026`, `03/05/2026`). `parse` and `format` take your own rules («tomorrow»), `calendarLabel` names the button (an optional key of the locale, so a locale written before still type-checks). Without `editable` TaoDate is the button it was.
320
+ - **Exported:** `parseTaoDateInput(text, { locale, reference })`, `formatTaoDateShort(iso, locale)`, `taoDateOrder(locale)`.
321
+ - **Docs:** the default `locale` of TaoDate and TaoDateRange is the app locale (`setTaoLocale`), not `'en-US'` as the prop table said.
322
+
323
+ ## 5.5.0
324
+
325
+ What a phone interface needs, asked for by an app built on TaoUI (Next Up); nothing to migrate.
326
+
327
+ - **`TaoDrawer side="bottom"`**: a bottom sheet. It rises from the bottom edge, as wide as the screen up to 640px (centred on a computer), as tall as its content up to 90% of the screen, with rounded top corners, a grip and its last line above the safe area. Esc, the backdrop and the focus trap as before.
328
+ - **`TaoModal fullscreen`**: `true` is the whole screen, square corners, the header and the footer stay while the content scrolls, the safe areas kept; `'narrow'` does that only on a screen narrower than 600px, so one modal is a dialog on a computer and a page on a phone.
329
+ - **Eight app icons**: `tao-settings`, `tao-edit`, `tao-trash`, `tao-bell`, `tao-tag`, `tao-repeat`, `tao-undo`, `tao-redo`. 40 built-in icons now (the docs still said 29, though the alignment icons of 5.2 had made it 32).
330
+ - **Showcase:** on a phone the page no longer scrolls sideways (the carousel demo widened it to its slide track, and the theme switchers did not wrap), so a sheet or a fixed bar is not cut at the edge.
331
+
332
+ ## 5.4.5
333
+
334
+ - **The slider has one cursor, the pointing finger**, over the rail, over the thumb and for the whole drag (TaoSlider, TaoRangeSlider, TaoScrubber). It was `grab` over the thumb, `grabbing` while pressed and, once the pointer moved, the rail's finger (the rail holds the pointer capture): three shapes flickered in one gesture, and Opera on Windows draws `grab` / `grabbing` as the four-way move arrows and an up arrow. The finger looks the same in every browser.
335
+
336
+ ## 5.4.4
337
+
338
+ Visual fixes, nothing to migrate.
339
+
340
+ - **TaoNav does not move when the page scrolls.** The side column (the action and the items of the rail and the side panel) stuck at `top: 0` although it stands below the panel's 4px padding, so the first 4px of scrolling lifted it against the edge; it now sticks where it stands. The floating bar jumped up a fraction of a pixel with the content at the very end of the scroll (the page height is often fractional and the scroll end is rounded up): its bottom margin is now 1px short of its sticky offset, so it stays stuck.
341
+ - **TaoAlert folds with a slide**, as TaoSpoiler does: the body's row closes from `1fr` to `0fr`, and the text gets `hidden="until-found"` when the slide has ended, so find-in-page still opens it. With reduced motion it folds at once.
342
+ - **Series colours stand further apart.** In the dark theme chart-4 (violet) sat next to the info blue of chart-2 (colour distance 0.092): it is a deeper violet now (`--tao-violet-400` `#9d5cff`, 0.189). In the light theme chart-4 is a purple (`--tao-violet-600` `#b03ad1`) and chart-6 orange (`--tao-tangerine-600`, new), because teal sat on the dark success green (0.093). A test keeps every pair of both themes at least 0.11 apart and 3:1 on the page. `--tao-teal-600`, added in 5.3.0 for that teal, is gone.
343
+
344
+ ## 5.4.3
345
+
346
+ - **Fixed: the bottom bar of TaoNav rose under the content on a page shorter than the window** (an empty list, a short settings page). The root had no height of its own and the grid inside only shared the height of the content. The root is now a flex column and the shell fills it, so a min-height / height given to TaoNav (min-height: 100dvh for a whole-window app) keeps the bar at the bottom, and the rail and the side panel run the full height. Nothing to migrate: without a height it behaves as before.
347
+
348
+ ## 5.4.2
349
+
350
+ - **Fixed: a toast in a centred position stuck to the left edge.** `topCenter` (the default), `bottomCenter` and `center` span the whole width, and the stack inside was `width: 100%`, so there was nothing to centre. The stack now shrinks to its widest toast in those three positions and `justify-content: center` centres it. Corner positions are unchanged. Nothing to migrate.
351
+
352
+ ## 5.4.1
353
+
354
+ - **Fixed: a striped `TaoCard` / `TaoBlock` painted over a sticky `TaoNav` bar.** The stripe layer (`::after`) and the Card `#corner` use `z-index: 1`, but a panel did not form a stacking context, so they joined the page's layer and tied with the bar (`z-index: 1`, earlier in the DOM): the coloured stripe ran across the bottom bar while a card scrolled under it. `.tao-panel` is now `isolation: isolate`. Nothing to migrate.
355
+
356
+ ## 5.4.0
357
+
358
+ One slot, nothing to migrate.
359
+
360
+ - **`TaoNav` `#action`:** the main action of a screen (Compose, New) moves with the navigation instead of staying in a far corner of a wide screen. Pass a `TaoButton` with `icon` and its text in `<span class="tao-nav__action-label">`. The bar look puts it round above itself at the end side, 12px off like the pill (with `floating` it lines up with the pill's edge, so it follows a centred pill); the rail puts it round at the top, above the items; the side panel puts it at the top, full width, with the text (an extended button). In the round looks the text is visually hidden and stays the button's name. CSS places it from the same `--_*` variables as the rest, so `layout="auto"` switches it by container queries without JS; that is also why the slot has no props: only CSS knows the look in `auto`. The hand-placed round button of the 5.2 showcase is gone.
361
+
362
+ ## 5.3.0
363
+
364
+ Small charts and a bridge to chart libraries; nothing to migrate.
365
+
366
+ - **`TaoSparkline`**: a trend for a card, a table cell or a line of text. `values` (a `null` is a gap that splits the line), `area`, `dot` on the last value, `tone`, a fixed `min` / `max` to compare several. With `label` it is an image with that name, without it a decoration.
367
+ - **`TaoMeter`**: a measured value in a range (`role="meter"`): disk space, a battery, a score. With `low` / `high` / `optimum` it colours itself as the HTML `<meter>` does: the region of the optimum is success, the next one warning, the far one danger. `label`, `valueText` (a number or your own text, read as `aria-valuetext`). The progress of a task stays `TaoProgress`.
368
+ - **`TaoDonut`**: a share of a whole, from `segments` (`{ label, value, tone?, color? }`) or a single `value` of `max`. `legend`, a centre slot, `size` / `thickness`; a screen reader hears the label and every part with its share.
369
+ - **Series colours** `--tao-color-chart-1…6`: the accent first, then the info, success and warning roles (so a palette moves them away from its accent), a violet and, last, pink in the dark theme or teal in the light one, whose accent is pink. Red is left out: it reads as «bad». Palettes re-declare the series built on roles and give their second stop to chart-4. New primitives `--tao-violet-400 / -600`, `--tao-teal-600`.
370
+ - **`taoChartTheme(el?)`** returns the theme colours for Chart.js, ECharts, uPlot and the like, resolved where the element is (its palette, its mode) and converted to `rgb()` / `rgba()`: the roles are often `color-mix()`, which canvas libraries do not parse. **`watchTaoChartTheme(apply, el?)`** calls it now and on every theme, mode or palette change. TaoUI will not grow axes, tooltips or zoom: that is a chart library's work.
371
+
372
+ ## 5.2.0
373
+
374
+ New components and options, nothing to migrate.
375
+
376
+ - **`TaoToolbar`**, **`TaoToolbarGroup`**, **`TaoToolbarSeparator`**: a bar of tools (`role="toolbar"`). It is one Tab stop with a roving tabindex: `←` / `→` (`↑` / `↓` with `orientation="vertical"`) walk the items and wrap, Home / End go to the ends, disabled items are skipped, and the bar remembers the last item. The items are found in the DOM, so any control fits: inside a `TaoSegmented` the arrows pick the option and move on from its edge, a text field keeps its arrows. A thin line across the bar splits the groups; `inset` puts a sunken pill behind a group. `variant="panel | plain"`, `size`.
377
+ - **`TaoButton` `v-model:pressed`:** a toggle button (Bold, a filter). It says `aria-pressed` and, while pressed, wears a wash of its tone's text colour (every variant but `primary`). Without the prop the button is unchanged.
378
+ - **`TaoNav` `floating`:** in the bar look the panel is a detached pill above the page, inset from the edges and above the safe area, with a shadow and a pill for the active item; 520px at most, centred. The rail and the side panel do not change, in `auto` too. The main action of a screen belongs beside it as your own round button (see the showcase), not in a notch of the bar.
379
+ - **Icons** `tao-align-left`, `tao-align-center`, `tao-align-right`.
380
+
381
+ ## 5.1.1
382
+
383
+ Visual fixes, nothing to migrate.
384
+
385
+ - **Dark theme tone fills:** the neutral button had a dark label on its grey fill (3.4:1), it is white now (5.7:1) through a new role `--tao-color-on-neutral` (white in both themes). Success and info are a step lighter (`green-400`, the new `blue-300`) so they read as buttons on a dark page with their dark label, and **warning leans to orange** (`--tao-tangerine-400`, `#ff8f3d`): the amber accent keeps yellow, so the two are not mistaken for each other (colour distance 0.037 → 0.114 for the text, as fill and as text). The light theme and the palettes are unchanged.
386
+ - **Hover is twice as quick:** `--tao-transition-base` runs on the new `--tao-duration-hover` (0.1s instead of 0.2s), so a state follows the pointer instead of trailing behind it; other motion keeps its durations. Rows the pointer sweeps across (TaoMenu items, TaoMenubar entries, TaoTree rows) change at once, as in a system menu.
387
+ - **TaoSplit cursors** are the matching pair `ew-resize` / `ns-resize` (`col-resize` / `row-resize` are drawn as two different shapes on Windows).
388
+
389
+ ## 5.1.0
390
+
391
+ Two small additions, nothing to migrate.
392
+
393
+ - **`TaoSwitch` `loading`**: the change is being applied (a request is on its way). A spinner runs on the thumb, a click does nothing and the box stays as the model says, the switch is not greyed out like a disabled one, and `aria-busy` tells a screen reader.
394
+ - **A contact patch on the slider thumb** (`TaoSlider`, `TaoRangeSlider`, `TaoScrubber`): a soft ring of the thumb's own colour around the dot, wider under the pointer and widest while dragging, as if a finger pressed it. A shadow, so the layout and the hit area stay the same; none on `flat` and disabled sliders; the keyboard focus ring moves outside it.
395
+
396
+ ## 5.0.0
397
+
398
+ 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.
399
+
400
+ 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.
401
+
402
+ ### Breaking
403
+
404
+ - **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).
405
+ - `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.
406
+
407
+ ### Palettes
408
+
409
+ - **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).
410
+ - **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.
411
+ - **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.
412
+ - **`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.
413
+ - **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`.
414
+ - 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.
415
+ - The showcase has a palette picker (with the four colours of the chosen one) next to the dark / light switch; the choice is remembered.
416
+
417
+ ### Packaging
418
+
419
+ - **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.
420
+ - **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()`.
421
+ - `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.
422
+ - **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).
423
+ - `npm run lint:package` (`publint` + `attw`) and the consumer smoke test run in CI; README has a "Browser support" section.
424
+
425
+ ### Components
426
+
427
+ - **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()`.
428
+ - **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.
429
+ - **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.
430
+ - **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.
431
+ - **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).
432
+ - **`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`.
433
+ - **`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.
434
+ - **`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`.
435
+ - **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.
436
+ - **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 }`.
437
+ - **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.
438
+ - **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).
439
+ - **`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.
440
+ - **`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.
441
+ - **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.
442
+ - **`TaoTimeline` → `TaoScrubber`** (play / pause + a time slider). The name `TaoTimeline` is kept for a vertical event feed later.
443
+ - **`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).
444
+ - **`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.
445
+ - **`TaoCard`**: slots `media` (was `cover`), `header`, `title`, `sub`, `footer`, `overlay` and the new `corner`; `closable` + `close`. `headerTitle` and `headerSecondary` are gone (use `header`).
446
+ - **`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`.
447
+ - **`TaoTabs` `justify`** is typed (`TaoJustify`, as in `TaoFlex`). The `TaoGrid` breakpoint lives in one file.
448
+ - **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.
449
+ - **`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.
450
+
451
+ ### Icons
452
+
453
+ - **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.
454
+ - 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.
455
+ - **`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.
456
+
457
+ ### Overlays: one engine
458
+
459
+ - **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`.
460
+ - **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.
461
+ - **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.
462
+
463
+ - **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.
464
+ - **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`.
465
+ - **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.
466
+ - **`placement`** (`top` / `bottom` / `left` / `right` plus `-start` / `-end`) replaces `position` on Popover, Tooltip and ColorInput.
467
+ - A Select inside a Modal no longer closes the Modal on Escape.
468
+
469
+ ### Tone
470
+
471
+ - **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.
472
+ - **`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.
473
+ - 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).
474
+ - 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.
475
+
476
+ ### Tokens
477
+
478
+ - **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`.
479
+ - **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.
480
+ - **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).
481
+ - **z-index scale** `--tao-z-modal | popup | tooltip | toast | confirm`; no component writes a literal any more.
482
+ - **`--tao-transition-base` no longer animates `all`**: colours, shadow, opacity and transform only.
483
+ - **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.
484
+
485
+ ### Internal
486
+
487
+ - `deprecationWarning` / `warnDeprecated` take the version that removes the name (`removeIn`), no longer a hard-coded "3.0".
488
+ - 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.
489
+
490
+ ## 4.0.1
491
+
492
+ - **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`.
493
+
494
+ ## 4.0.0
495
+
496
+ ### Breaking: English is the default language
497
+
498
+ - **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.
499
+ - **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.
500
+ - `setTaoLocale(overrides)` now merges on top of English (it merged on top of Russian). Pass `setTaoLocale(overrides, localeRu)` to keep the old base.
501
+
502
+ ### Minimum width
503
+
504
+ - **`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`.
505
+ - **`TaoSegmented` `minWidth`** and **`--tao-segmented-option-min-width`**: the minimum width of every option, including in `block` mode.
506
+
507
+ ## 3.4.1
508
+
509
+ - **Fix:** `TaoScrollTop` `variant="text"` could not be shown without a caption: `label=""` now hides it, leaving just the arrow button (the accessible name stays).
510
+
511
+ ## 3.4.0
512
+
513
+ ### TaoScrollTop
514
+
515
+ - **`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).
516
+ - **`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.
517
+ - **`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.
518
+ - **Fix:** the button had no accessible name unless `ariaLabel` was passed; it now falls back to `label`, then to the locale text.
519
+ - **Fix:** `size`, `bottom` and `zIndex` react to prop changes (they were read once at setup).
520
+ - 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.
521
+
522
+ ## 3.3.2
523
+
524
+ - **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.
525
+
526
+ ## 3.3.0
527
+
528
+ ### Presentation
529
+
530
+ - **Showcase in English and Russian:** language switch in the header, `?lang=`, built-in component texts follow the page. English is the default.
531
+ - **Static showcase build** with relative paths (`npm run showcase:build`), ready for any folder such as `/sandbox/taoui/`.
532
+ - 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`.
533
+
534
+ ### Light theme
535
+
536
+ - **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`.
537
+ - **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).
538
+ - Light theme: idle text of Segmented and Tabs (`--tao-color-text-subtle`) is darker (`gray-600`).
539
+ - **Fix:** `TaoInputNumber` ± buttons no longer overflow in the `small` size.
540
+ - New optional token `--tao-button-primary-text-shadow` (none by default; the light theme sets a soft one).
541
+ - The light theme no longer inherits the dark theme's glowing link shadow.
542
+
543
+ ### Status colours as text
544
+
545
+ - **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`.
546
+ - 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.
547
+
548
+ ### Feedback
549
+
550
+ - **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.
551
+ - **`TaoButton` `tone="neutral"`** for `ghost` and `text`: strong text colour with the soft accent wash on hover.
552
+ - **confirm():** the cancel button is `ghost` with `tone="neutral"`, so the primary action stands out and the dialog feels lighter.
553
+
554
+ ## 3.2.1
555
+
556
+ - **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.
557
+
558
+ ## 3.2.0
559
+
560
+ - **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.
561
+ - **TaoColorPicker:** fixed width, so switching HEX / RGB / HSL no longer resizes the popover.
562
+
563
+ ## 3.1.1
564
+
565
+ - **Popovers close on an outside press in the capture phase**, so a component that stops propagation can no longer keep a popover open.
566
+ - **TaoColorPicker:** text is centred in the HEX, RGB and HSL fields.
567
+
568
+ ## 3.1.0
569
+
570
+ ### Colour
571
+
572
+ - **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).
573
+ - **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.
574
+ - **New `TaoColorInput`**: a field with a swatch and the hex text; the picker opens in a popover.
575
+ - **`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.
576
+ - `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).
577
+ - Locale section `colorPicker`.
578
+
579
+ ## 3.0.0
580
+
581
+ Cleaner slider family. Breaking changes are allowed in this major: quality over compatibility.
582
+
583
+ ### Slider
584
+
585
+ - **New `TaoRangeSlider`**: two thumbs, `v-model` is a `[from, to]` pair, `minGap` keeps the thumbs apart.
586
+ - **`TaoSlider` and `TaoRangeSlider` share props:** `marks` (`true` for automatic ticks, numbers, or `{ value, label? }`),
587
+ `discrete` (the value only sits on marks: stepped scales with captions), `format`, `vertical`, plus the old
588
+ `min / max / step / variant / size / showValue / disabled / error / wheel`. Clicking a mark caption moves the nearest thumb.
589
+ Slot `#mark="{ mark, active }"` draws a custom caption.
590
+ - **`marksSide`** (`'end'` by default, or `'start'`) puts the marks above a horizontal slider / left of a vertical one.
591
+ - **`flat`** hides the round thumbs (a plain filled bar); they stay in the markup for keyboard and screen readers.
592
+ - **Pure logic in `src/slider.ts`** (value ↔ position, steps without float tails, nearest thumb, marks) with unit tests.
593
+
594
+ ### Fixes
595
+
596
+ - **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
597
+ sets the value.
598
+ - **TaoInputNumber:** a value changed from outside (a slider, another field) now replaces the draft of a focused field, so blur does not
599
+ write the stale text over it. Typing is not affected: the echo of the field's own value does not overwrite the draft.
600
+
601
+ - **A range collapsed into one point can be pulled apart again:** pressing exactly on the point decides the thumb by the direction of the
602
+ first move (right: the upper one, left: the lower one). With `flat` such a range shows a small dash instead of disappearing.
603
+
604
+ - **No focus ring after a mouse press:** the ring is for the keyboard; it comes back on the first key press.
605
+
606
+ ### Timeline
607
+
608
+ - **New `TaoTimeline`**: play / pause and «to start» buttons, a slider over time with event marks, a «time / length» label.
609
+ `v-model` is the time, `v-model:playing` the play state; `pauseOnScrub` pauses when the user grabs the slider; `marks`, `marksSide`,
610
+ `format`, `showRestart`, `showTime`, `variant`, `size`, slots `#mark` and `#time`. It does not advance the time itself: drive it with
611
+ anything (for example `usePlayback` from `@1337exp/taoux/playback`). New locale section `timeline` (`playLabel`, `pauseLabel`, `restartLabel`).
612
+
613
+ ### Breaking
614
+
615
+ - `TaoSlider` `v-model` is a **number** now; the `number | string` form is gone.
616
+ - **Right-click to type a value is gone** (with the `placeholder` prop): use `TaoInputNumber` next to the slider.
617
+ - **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).
618
+ The pointer area is `.tao-slider__rail`; the root also holds the marks.
619
+ - `wheel` works for a single thumb only.
620
+
621
+ ## 2.0.0
622
+
623
+ One size scale, one API standard, built-in texts in any language. Old prop and event names keep working
624
+ as deprecated aliases and print a warning in development builds; they will be removed in 3.0.
625
+
626
+ ### Breaking
627
+
628
+ - **Size modifier classes are gone.** Sizes now come from CSS variables set by `.tao-size-small` / `-medium` / `-large`.
629
+ If your CSS targeted these classes, switch to `.tao-size-*` or the variables:
630
+ `tao-button--small|medium|large`, `tao-select--small|large`, `tao-combobox--small|large`,
631
+ `tao-select__panel--*`, `tao-combobox__panel--*`, `tao-segmented--*`, `tao-segmented-option--small|medium|large`,
632
+ `tao-pagination--small`, `tao-table--compact`, `tao-list--*`, `tao-list-item--s|m|l`, `tao-file-drop__zone--*`,
633
+ `tao-slider--small` (now `tao-slider--thin`), `tao-textarea--no-border` / `--center`
634
+ (now `--filled` / `--plain` / `--align-center`).
635
+ - **`size` has no default any more — it inherits.** A control without `size` takes the size of its ancestors,
636
+ `medium` at the root, so pages without `.tao-size-*` look the same.
637
+ - **`--tao-field-height` is now an alias of `--tao-control-height`** and follows the current size.
638
+ Overriding it no longer changes field height — override `--tao-control-height-medium` instead.
639
+ - **TaoSlider `size="small"` is a smaller bar now, not the thin track.** Use `variant="thin"` for seek / volume.
640
+ - **Small visual changes:**
641
+ - Pagination `small` buttons 28 → 26px;
642
+ - List rows `small` 32 → 26px, `large` 48 → 44px, titles 12 / 14 / 16px;
643
+ - Table `size="small"` (old `compact`) cell text 13 → 12px;
644
+ - Tag is 20px in medium with or without the close button (was 19 / 22);
645
+ - Tabs tab 37 → 36px (Button height);
646
+ - icon-only Segmented options are square;
647
+ - Textarea min-height equals the control height;
648
+ - Select / Combobox `large`: the clear and empty rows are 14px;
649
+ - Textarea `dummy` no longer shows a red bar.
650
+ - **TaoCarousel on mouse / trackpad** scrolls freely and settles on a whole slide after it stops
651
+ (CSS snap stays only on touch screens). A mouse drag keeps its momentum.
652
+
653
+ ### Added
654
+
655
+ - **Sizes.** `TaoSize` (`small | medium | large`) on Button, Input, InputNumber, Quantity, Textarea, Select, Combobox,
656
+ Date, DateRange, Segmented, Checkbox, Radio / RadioGroup, Switch, Tag, Tabs, Pagination, FileDrop, Slider, Table,
657
+ List, PinCode, InputGroup and FormField. `class="tao-size-small"` on any element sizes the whole block.
658
+ Tokens: `--tao-control-height` / `-padding-x` / `-padding-y` / `-font-size` / `-font-size-secondary`,
659
+ `--tao-button-padding-x`, `--tao-indicator-size`, `--tao-tag-height` / `-padding-x` / `-font-size`.
660
+ - **Locale.** `app.use(TaoUI, { locale: localeEn })`, `setTaoLocale()`, `localeRu` (default), `localeEn`,
661
+ types `TaoLocale`, `TaoLocaleOverrides`, `TaoUIOptions`. Pass a few keys to change single texts.
662
+ Switching at runtime updates components already on the page.
663
+ - **Surfaces.** `surface` on TaoCard / TaoBlock (`flat | grain | glass`, type `TaoSurface`) and classes
664
+ `.tao-surface-grain` / `-glass` for any element. Theme tokens `--tao-surface-grain-image` / `-size`,
665
+ `--tao-glass-fill` / `-border` / `-blur`. Toast and confirm are glass by default (`surface` in their defaults, options
666
+ and builders; `'flat'` turns it off). Glass falls back to a solid panel without blur support or with
667
+ `prefers-reduced-transparency`.
668
+ - **`error`** on InputNumber, Quantity, Switch, Segmented, Radio, RadioGroup, Slider and PinCode.
669
+ - **`change`** on Slider, Split (on release), Spoiler, Tabs; FileDrop and Table got `change` too.
670
+ - **PinCode** `disabled`, `size`, `masked`. **Textarea** `variant` (`bar | outline | filled | plain`), `readonly`,
671
+ `align`, `autofocus`, `blurOnEnter`. **Checkbox** `checked`. **Container** `width`. **Link** `newTab`.
672
+ **ScrollTop** `outline`. **Space / Stages** `direction`. **Copy** `successText`. **Tabs** `items`.
673
+ - **Types** `TaoTone`, `TaoLength` (number → px, string → CSS), `TaoTabItem`.
674
+ - Length props accept both numbers and strings: Block / Card `padding` and `radius`, Flex / Grid `gap`,
675
+ Grid `min`, List / Table `maxHeight`.
676
+ - Dev-only warnings for deprecated props, events and values (once per component and name).
677
+ - Tests (`npm test`, Vitest).
678
+
679
+ ### Fixed
680
+
681
+ - Textarea `noSpace` also strips spaces from pasted text.
682
+ - Textarea `borderInverse` turns red on error.
683
+ - Slider is marked invalid inside an invalid TaoFormField.
684
+
685
+ ### Deprecated → use instead
686
+
687
+ | Component | Deprecated | Use |
688
+ |---|---|---|
689
+ | Alert, Tag | `type` | `tone` |
690
+ | Tag | `pointer` | `clickable` |
691
+ | Input | `label`, `errorMessage` | `label` / `error` of TaoFormField |
692
+ | Textarea | `noBorder`, `noBackground` | `variant="filled"`, `variant="plain"` |
693
+ | Textarea | `dummy`, `textCenter`, `autoFocus`, `submitOnEnter`, `borderInverse` | `readonly`, `align="center"`, `autofocus`, `blurOnEnter`, `variant` |
694
+ | Table | `compact`, event `sort` | `size="small"`, event `change` |
695
+ | FileDrop | event `files` | event `change` |
696
+ | DropdownMenu | event `selected` | event `select` |
697
+ | Tabs | `tabs`, item `key` | `items`, item `value` |
698
+ | Checkbox | `value` (boolean) | `checked` or v-model |
699
+ | PinCode | `hidden` | `masked` |
700
+ | Copy | `successMessage` | `successText` |
701
+ | ScrollTop | `hasOutline`, `tabindex` prop | `outline`, plain `tabindex` attribute |
702
+ | Link | `asNewTab` | `newTab` |
703
+ | Space, Stages | `vertical` | `direction` |
704
+ | Container | `size` | `width` |
705
+ | Avatar | `size="s"` / `"m"` / `"l"` | `small` / `medium` / `large` |
706
+ | Divider | `size="big"` | `size="large"` |
707
+ | — | `TaoSegmentedSize` | `TaoSize` |