@1337exp/taoui 5.22.0 → 5.23.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,11 +1,33 @@
1
1
  # Changelog
2
2
 
3
- ## 5.22.0
3
+ ## 5.23.1
4
+
5
+ Nothing to migrate; the defaults do not change.
6
+
7
+ - **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.
8
+
9
+ ## 5.23.0
4
10
 
5
11
  Nothing to migrate; the defaults do not change.
6
12
 
7
- - **`TaoPinCode` `bordered`.** `:bordered="false"` is a light style: the cells have a soft fill and no frame at all (the border stays in the box, so the cells do not jump). A state is told by the fill and the digit instead: a tint of the accent on the focus, of danger on an error, of success on a result.
13
+ - **`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.
14
+ - **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.
15
+ - **`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.
16
+ - **`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.
17
+ - **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.
18
+ - **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.
19
+ - **`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.
20
+ - **`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.
21
+ - **`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.)
22
+ - **`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.
23
+ - **`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.
8
24
  - **`TaoPinCode`: an error paints the digits red**, as a success always painted them green (`--tao-color-danger-text`).
25
+
26
+ ## 5.22.0
27
+
28
+ Nothing to migrate; the defaults do not change.
29
+
30
+ - **`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.
9
31
  - **`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.
10
32
  - **`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.
11
33
 
package/README.md CHANGED
@@ -1,3 +1,7 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark.svg" alt="Tao UI" width="96" height="94">
3
+ </p>
4
+
1
5
  <h1 align="center">Tao UI</h1>
2
6
 
3
7
  <p align="center">
@@ -28,7 +32,7 @@
28
32
 
29
33
  - **Tokens first.** Colours, radii, spacing and type come from CSS variables in three layers (primitives, semantic, theme). Re-theme the kit, or one panel of it, without touching a component. Size and density are contexts too: set them once on a panel and everything inside follows.
30
34
  - **Palettes.** Seven ready palettes built from four colours each, or your own at run time (`applyTaoPalette`). The status colours step away from the accent by themselves, and the charts recolour with the theme.
31
- - **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white. The showcase section **Contrast & keyboard** measures the page you are on, lets you build a palette from four stops with `applyTaoPalette()`, and lists what the keys do.
35
+ - **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white. The showcase section **Contrast & keyboard** measures the page you are on, lets you build a palette from four stops with `applyTaoPalette()`, and lists what the keys do. **Layers & theming** shows the real style files in the order the kit imports them and builds an own theme by hand.
32
36
  - **Adapts without JS.** `TaoNav` turns from a bottom bar into a rail and a side panel, the bento grid reflows, the main action moves with the navigation — by the width of their own container (container queries), not of the window. Nothing jumps after hydration.
33
37
  - **Keyboard and screen readers.** Menus, the menu bar, the toolbar, the tree and the navigation follow the WAI-ARIA patterns: one Tab stop and arrows inside (roving tabindex), `aria-pressed` toggles, `role="meter"`, focus traps in overlays.
34
38
  - **Charts the honest way.** Small `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` for cards and lines of text; for real charts `taoChartTheme()` hands the theme colours to Chart.js, ECharts or uPlot.
@@ -95,7 +99,7 @@
95
99
  - **TaoQuantity** — cart quantity: `− | field | +`, integers, stock; minus at the minimum can remove the row
96
100
  - **TaoTextarea** — autosizing multiline. `maxlength` caps input, `count` shows “entered / max”. `variant`: `bar` (default) / `outline` (frame like Input) / `filled` / `plain`; `readonly`; `align`; `blurOnEnter`
97
101
  - **TaoPinCode** — N cells. By default a click clears the cell and everything to the right (`clear-on="focus"`); `clear-on="input"` replaces the digit only when typing. `format="#-##-##"` draws visual separators (not part of the value; a paste in that shape or as a clean code is split into cells). The last cell blurs and emits `complete`; `status="success | error"` (set after `complete`) glows or shakes the cells and says it to a screen reader; `bordered="false"` is a light style with no frame
98
- - **TaoSlider** / **TaoRangeSlider** — one thumb (`v-model` is a number) or two (`[from, to]`, `minGap`). Mouse, touch, arrows. `marks` (ticks, numbers, `{ value, label }`), `discrete` for stepped scales, `vertical`, `flat`, `format`; `variant="thin"` is a thin track for seek / volume
102
+ - **TaoSlider** / **TaoRangeSlider** — one thumb (`v-model` is a number) or two (`[from, to]`, `minGap`). Mouse, touch, arrows. `marks` (ticks, numbers, `{ value, label }`), `discrete` for stepped scales, `vertical`, `flat`, `format`, `bubble` (the value in a bubble at the thumb, off by default), `zones` (the scale in colour, a dot where a zone ends, `reveal` to paint it as it fills); `variant="thin"` is a thin track for seek / volume
99
103
  - **TaoColorPicker** — saturation / brightness square, hue and opacity strips, swatches, eyedropper (where the browser has `EyeDropper`), HEX / RGB / HSL input modes. `v-model` is a hex string; `colorModel()` adapts your own colour storage
100
104
  - **TaoColorInput** — a field with a swatch and the hex text; the picker opens in a popover
101
105
  - **TaoFileDrop** — drop zone (drag & drop + click). File names listed under the zone, `v-model` is `File[]`. Clearing the whole batch is the parent’s job (`clear-request`); a file that does not fit `accept` comes back in `reject`
@@ -119,7 +123,7 @@
119
123
  - **TaoAlert** — inline page/form banner (success / error / warning / info); `collapsible` folds the body under the title (find-in-page still finds it)
120
124
  - **TaoProgress** — static bar (`progress` in %). Percent centered on top, or `showPercentage="right"`; `#left` / `#right` slots are captions, then the percent sits in parentheses on the right. `false` hides it. Width is `minWidth` / `maxWidth`, not the value domain
121
125
  - **TaoScrubber** — play / pause, a slider over time with event marks, a “time / length” label. Does not advance time by itself: drive `v-model` with your own clock
122
- - **TaoLoader** — four-dot spinner
126
+ - **TaoLoader** — the wait whose end is unknown: `variant` `dots` (default) / `ring` / `pulse`, `tone`, `size` (a number or small / medium / large), says "Loading" to a screen reader (`label`), breathes under reduced motion; `TaoButton loading` wears the same ring
123
127
  - **TaoImage** — `<img>` wrapper: fade-in and placeholder. `lazy` turns on native `loading="lazy"`
124
128
  - **TaoIcon** — SVG icons (40 built in, your own via `registerTaoIcons`) or an icon font (see Icons below)
125
129
 
@@ -162,6 +166,8 @@ Container lives on another axis — width: `width="wide" | "slim" | "ultra-slim"
162
166
  <html class="tao-density-auto">
163
167
  ```
164
168
 
169
+ **Frames** are the third context, for the decorative frames of panels: `tao-frames-soft` on a container (or on `<html>`) lets the frames of `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` and `TaoMenubar` go clear and holds the panel by its fill instead (an alert gets a little more tint); nothing moves, the 1px border stays in the box. `tao-frames-framed` puts them back inside a soft area, and `bordered` on a panel (`true` / `false`) overrides the context for that panel. The frame of a field, the focus ring and the lines between rows are not touched: they tell where a control is, and WCAG 1.4.11 asks 3:1 of them. Tokens `--tao-frame-alpha` / `--tao-frame-tint` / `--tao-frame-fill`.
170
+
165
171
 
166
172
  Surfaces — what a panel is made of: `flat` fill (default), `grain` (static film grain), `glass` (translucent, blurs what is
167
173
  behind). Use `surface` on TaoCard / TaoBlock or the class `tao-surface-grain` / `-glass` on any element — a game HUD, a
@@ -638,7 +644,7 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
638
644
  | `tokens/semantic.css` | Theme-independent roles: radii, shadows, type, motion | Rarely |
639
645
  | `themes/dark.css` | The colour roles of the default (dark) theme: `--tao-color-accent`, `--tao-color-surface`, … | **Yes — this is the theming API** |
640
646
  | `themes/light.css` | The same roles under `[data-tao-mode="light"]` (or the old `[data-tao-theme="light"]`) | Yes, as a sample |
641
- | `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` and `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: what a control reads to know its size, colour and material | Rarely |
647
+ | `contexts/size.css`, `tone.css`, `surface.css`, `frames.css` | `.tao-size-*` and `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`, `.tao-frames-*`: what a control reads to know its size, colour, material and how loud its frames are | Rarely |
642
648
  | `base.css` | Global reset (scrollbar, links, box-sizing) | Rarely |
643
649
 
644
650
  Everything comes in through `@1337exp/taoui/styles.css` (dark and light both: light turns on with `data-tao-mode="light"`).
package/README.ru.md CHANGED
@@ -1,3 +1,7 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/1337exp/taoui/master/showcase/public/logo/logo-mark.svg" alt="Tao UI" width="96" height="94">
3
+ </p>
4
+
1
5
  <h1 align="center">Tao UI</h1>
2
6
 
3
7
  <p align="center">
@@ -28,7 +32,7 @@
28
32
 
29
33
  - **Сначала токены.** Цвета, радиусы, отступы и шрифты — CSS-переменные в три слоя (примитивы, семантика, тема). Перекрасить набор или одну панель можно, не трогая компоненты. Размер и плотность — тоже контексты: задайте их один раз на панели, и всё внутри последует.
30
34
  - **Палитры.** Семь готовых палитр, каждая из четырёх цветов, или своя в рантайме (`applyTaoPalette`). Статусные цвета сами отходят от акцента, а графики перекрашиваются вместе с темой.
31
- - **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA. Раздел витрины **Контраст и клавиатура** измеряет страницу, на которой вы стоите, собирает палитру из четырёх стопов через `applyTaoPalette()` и перечисляет, что делают клавиши.
35
+ - **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA. Раздел витрины **Контраст и клавиатура** измеряет страницу, на которой вы стоите, собирает палитру из четырёх стопов через `applyTaoPalette()` и перечисляет, что делают клавиши. **Слои и темизация** показывает настоящие файлы стилей в том порядке, в каком набор их подключает, и собирает свою тему руками.
32
36
  - **Подстраивается без JS.** `TaoNav` превращается из нижней панели в рейку и боковую панель, bento-сетка перестраивается, главное действие переезжает вместе с навигацией — по ширине своего контейнера (container queries), а не окна. После гидратации ничего не прыгает.
33
37
  - **Клавиатура и скринридеры.** Меню, полоса меню, панель инструментов, дерево и навигация сделаны по шаблонам WAI-ARIA: одна остановка Tab и стрелки внутри (roving tabindex), переключатели с `aria-pressed`, `role="meter"`, ловушки фокуса в оверлеях.
34
38
  - **Графики по-честному.** Маленькие `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` для карточек и строк текста; для настоящих графиков `taoChartTheme()` отдаёт цвета темы в Chart.js, ECharts или uPlot.
@@ -95,7 +99,7 @@
95
99
  - **TaoQuantity** — количество в корзине: `− | поле | +`, целые штуки, сток, минус на минимуме может убрать строку
96
100
  - **TaoTextarea** — многострочное поле с авто-высотой. `maxlength` ограничивает ввод, `count` показывает «введено / максимум». `variant`: `bar` (по умолчанию) / `outline` (рамка как у Input) / `filled` / `plain`; `readonly`; `align`; `blurOnEnter`
97
101
  - **TaoPinCode** — пин-код из N полей. По умолчанию клик стирает ячейку и все справа (`clear-on="focus"`); `clear-on="input"` заменяет цифру только при вводе. `format="#-##-##"` рисует визуальные разделители (в значение не входят; вставка в таком виде или чистым кодом раскладывается по ячейкам). Последняя ячейка снимает фокус и эмитит `complete`; `status="success | error"` (после `complete`) подсвечивает или встряхивает ячейки и говорит об этом скринридеру; `bordered="false"` — лёгкий стиль без рамки
98
- - **TaoSlider** / **TaoRangeSlider** — один бегунок (`v-model` — число) или два (`[от, до]`, `minGap`). Мышь, тач, стрелки. `marks` (деления, числа, `{ value, label }`), `discrete` для ступенчатых шкал, `vertical`, `flat`, `format`; `variant="thin"` — тонкий трек для seek / громкости
102
+ - **TaoSlider** / **TaoRangeSlider** — один бегунок (`v-model` — число) или два (`[от, до]`, `minGap`). Мышь, тач, стрелки. `marks` (деления, числа, `{ value, label }`), `discrete` для ступенчатых шкал, `vertical`, `flat`, `format`, `bubble` (значение плашкой у ручки, по умолчанию выключена), `zones` (шкала цветом, точка там, где зона кончается, `reveal` — красить по мере заполнения); `variant="thin"` — тонкий трек для seek / громкости
99
103
  - **TaoColorPicker** — квадрат насыщенности и яркости, полосы тона и прозрачности, образцы, пипетка (где есть `EyeDropper`), режимы ввода HEX / RGB / HSL. `v-model` — строка hex; `colorModel()` подключает ваше собственное хранилище цвета
100
104
  - **TaoColorInput** — поле с образцом и hex-текстом; палитра открывается в поповере
101
105
  - **TaoFileDrop** — зона загрузки (drag & drop + клик). Список имён под зоной, `v-model` — `File[]`. Очистку всей пачки решает родитель (`clear-request`); файл, не подошедший под `accept`, приходит в `reject`
@@ -119,7 +123,7 @@
119
123
  - **TaoAlert** — инлайн-баннер страницы или ошибки формы (success / error / warning / info); `collapsible` сворачивает тело под заголовок (поиск по странице его всё равно находит)
120
124
  - **TaoProgress** — статичная полоса (`progress` в %). Проценты сверху по центру или `showPercentage="right"` справа; слоты `#left` / `#right` — подписи, тогда процент справа в скобках. `false` прячет. Ширина — `minWidth` / `maxWidth`, не диапазон значения
121
125
  - **TaoScrubber** — play / pause, слайдер по времени с метками событий, подпись «время / длина». Время сама не двигает: ведите `v-model` своими часами
122
- - **TaoLoader** — анимированный лоадер (четыре точки)
126
+ - **TaoLoader** — ожидание, конца которого не знаем: `variant` `dots` (по умолчанию) / `ring` / `pulse`, `tone`, `size` (число или small / medium / large), говорит «Загрузка» скринридеру (`label`), при «уменьшить движение» дышит; `TaoButton loading` носит то же кольцо
123
127
  - **TaoImage** — обёртка над `<img>`: fade-in и плейсхолдер. `lazy` включает нативный `loading="lazy"`
124
128
  - **TaoIcon** — SVG-иконки (40 встроенных, свои через `registerTaoIcons`) или icon-шрифт (см. раздел «Иконки» ниже)
125
129
 
@@ -162,6 +166,8 @@ Container живёт на другой оси — ширина: `width="wide" |
162
166
  <html class="tao-density-auto">
163
167
  ```
164
168
 
169
+ **Рамки** — третий контекст, для декоративных рамок панелей: `tao-frames-soft` на контейнере (или на `<html>`) делает прозрачными рамки `TaoAlert`, `TaoSpoiler`, `TaoTable`, `TaoList`, `TaoToolbar` и `TaoMenubar`, и панель держит заливка (у алерта чуть гуще тон); ничего не двигается, рамка в 1px остаётся в боксе. `tao-frames-framed` возвращает их внутри мягкой области, а `bordered` на панели (`true` / `false`) переопределяет контекст для неё. Рамки полей, кольцо фокуса и линии между рядами не затрагиваются: они показывают, где контрол, и WCAG 1.4.11 требует от них 3:1. Токены `--tao-frame-alpha` / `--tao-frame-tint` / `--tao-frame-fill`.
170
+
165
171
 
166
172
  Поверхности — из чего «сделана» панель: `flat` — заливка (по умолчанию), `grain` — статичное плёночное зерно, `glass` —
167
173
  полупрозрачное стекло с размытием того, что позади. Проп `surface` у TaoCard / TaoBlock или класс `tao-surface-grain` /
@@ -639,7 +645,7 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
639
645
  | `tokens/semantic.css` | Роли, не зависящие от темы: скругления, тени, шрифт, движение | Редко |
640
646
  | `themes/dark.css` | Цветовые роли темы по умолчанию (dark): `--tao-color-accent`, `--tao-color-surface`, ... | **Да — это и есть API темизации** |
641
647
  | `themes/light.css` | Те же роли под `[data-tao-mode="light"]` (или старым `[data-tao-theme="light"]`) | Да, как образец |
642
- | `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` и `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: что контрол читает, чтобы знать размер, цвет и материал | Редко |
648
+ | `contexts/size.css`, `tone.css`, `surface.css`, `frames.css` | `.tao-size-*` и `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`, `.tao-frames-*`: что контрол читает, чтобы знать размер, цвет, материал и насколько громки его рамки | Редко |
643
649
  | `base.css` | Глобальный reset (скроллбар, ссылки, box-sizing) | Редко |
644
650
 
645
651
  Всё подключается одним файлом `@1337exp/taoui/styles.css` (и dark, и light: light включается атрибутом `data-tao-mode="light"`).
package/dist/index.d.ts CHANGED
@@ -202,11 +202,14 @@ defaultOpen?: boolean;
202
202
  modelValue?: boolean;
203
203
  /** Ключ панели в `TaoSpoilerGroup`. Без группы не используется. */
204
204
  name?: string | number;
205
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`); `false`: the header fill alone sets the panel off. / Внешняя рамка; не задан — идёт за контекстом рамок; `false`: панель выделяет одна заливка шапки. */
206
+ bordered?: boolean;
205
207
  }>, {
206
208
  title: string;
207
209
  defaultOpen: boolean;
208
210
  modelValue: undefined;
209
211
  name: undefined;
212
+ bordered: undefined;
210
213
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
211
214
  change: (value: boolean) => void;
212
215
  "update:modelValue": (value: boolean) => void;
@@ -216,17 +219,21 @@ defaultOpen?: boolean;
216
219
  modelValue?: boolean;
217
220
  /** Ключ панели в `TaoSpoilerGroup`. Без группы не используется. */
218
221
  name?: string | number;
222
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`); `false`: the header fill alone sets the panel off. / Внешняя рамка; не задан — идёт за контекстом рамок; `false`: панель выделяет одна заливка шапки. */
223
+ bordered?: boolean;
219
224
  }>, {
220
225
  title: string;
221
226
  defaultOpen: boolean;
222
227
  modelValue: undefined;
223
228
  name: undefined;
229
+ bordered: undefined;
224
230
  }>>> & Readonly<{
225
231
  onChange?: ((value: boolean) => any) | undefined;
226
232
  "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
227
233
  }>, {
228
234
  name: string | number;
229
235
  title: string;
236
+ bordered: boolean;
230
237
  modelValue: boolean;
231
238
  defaultOpen: boolean;
232
239
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
@@ -963,10 +970,13 @@ size?: TaoSize;
963
970
  ariaLabel?: string;
964
971
  /** Close an open menu when the page scrolls (otherwise it follows its entry). / Закрывать меню при прокрутке (иначе оно едет за пунктом). */
965
972
  closeOnScroll?: boolean;
973
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
974
+ bordered?: boolean;
966
975
  }>, {
967
976
  size: undefined;
968
977
  ariaLabel: undefined;
969
978
  closeOnScroll: boolean;
979
+ bordered: undefined;
970
980
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
971
981
  select: (id: string) => void;
972
982
  }, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_34<__VLS_TypePropsToRuntimeProps_38<{
@@ -978,14 +988,18 @@ size?: TaoSize;
978
988
  ariaLabel?: string;
979
989
  /** Close an open menu when the page scrolls (otherwise it follows its entry). / Закрывать меню при прокрутке (иначе оно едет за пунктом). */
980
990
  closeOnScroll?: boolean;
991
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
992
+ bordered?: boolean;
981
993
  }>, {
982
994
  size: undefined;
983
995
  ariaLabel: undefined;
984
996
  closeOnScroll: boolean;
997
+ bordered: undefined;
985
998
  }>>> & Readonly<{
986
999
  onSelect?: ((id: string) => any) | undefined;
987
1000
  }>, {
988
1001
  size: TaoSize;
1002
+ bordered: boolean;
989
1003
  ariaLabel: string;
990
1004
  closeOnScroll: boolean;
991
1005
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
@@ -999,11 +1013,14 @@ size?: TaoSize;
999
1013
  orientation?: TaoToolbarOrientation;
1000
1014
  /** `panel` — a raised bar of its own; `plain` — only the layout, for a toolbar inside a header. */
1001
1015
  variant?: "panel" | "plain";
1016
+ /** The frame of a `panel`; not set, it follows the frames context (`.tao-frames-soft`). / Рамка `panel`; не задан — идёт за контекстом рамок. */
1017
+ bordered?: boolean;
1002
1018
  }>, {
1003
1019
  label: undefined;
1004
1020
  size: undefined;
1005
1021
  orientation: string;
1006
1022
  variant: string;
1023
+ bordered: undefined;
1007
1024
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_35<__VLS_TypePropsToRuntimeProps_39<{
1008
1025
  /** Accessible name: «Formatting», «Tools». / Доступное имя: «Форматирование», «Инструменты». */
1009
1026
  label?: string;
@@ -1013,14 +1030,18 @@ size?: TaoSize;
1013
1030
  orientation?: TaoToolbarOrientation;
1014
1031
  /** `panel` — a raised bar of its own; `plain` — only the layout, for a toolbar inside a header. */
1015
1032
  variant?: "panel" | "plain";
1033
+ /** The frame of a `panel`; not set, it follows the frames context (`.tao-frames-soft`). / Рамка `panel`; не задан — идёт за контекстом рамок. */
1034
+ bordered?: boolean;
1016
1035
  }>, {
1017
1036
  label: undefined;
1018
1037
  size: undefined;
1019
1038
  orientation: string;
1020
1039
  variant: string;
1040
+ bordered: undefined;
1021
1041
  }>>> & Readonly<{}>, {
1022
1042
  size: TaoSize;
1023
1043
  label: string;
1044
+ bordered: boolean;
1024
1045
  variant: "panel" | "plain";
1025
1046
  orientation: TaoToolbarOrientation;
1026
1047
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
@@ -1617,12 +1638,12 @@ paused: boolean;
1617
1638
  }>>> & Readonly<{}>, {
1618
1639
  text: string;
1619
1640
  speed: number;
1641
+ decorative: boolean;
1620
1642
  gap: number;
1621
1643
  paused: boolean;
1622
1644
  fade: number;
1623
1645
  pauseOnHover: boolean;
1624
1646
  roundPause: boolean;
1625
- decorative: boolean;
1626
1647
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
1627
1648
 
1628
1649
  declare const __VLS_component_46: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_46<__VLS_TypePropsToRuntimeProps_50<{
@@ -2362,6 +2383,11 @@ collapsible?: boolean;
2362
2383
  collapsed?: boolean;
2363
2384
  /** The toggle text when there is no title. / Текст переключателя, когда нет заголовка. */
2364
2385
  detailsLabel?: string;
2386
+ /**
2387
+ * Not set, it follows the frames context (`.tao-frames-soft`). `false` is a light style: no frame, a stronger tint of the tone instead (the border stays in the box, so nothing moves); `true` keeps the frame.
2388
+ * Не задан — идёт за контекстом рамок (`.tao-frames-soft`). `false` — лёгкий стиль: рамки нет, вместо неё гуще тон заливки (рамка остаётся в боксе); `true` — рамка остаётся.
2389
+ */
2390
+ bordered?: boolean;
2365
2391
  }>, {
2366
2392
  tone: string;
2367
2393
  title: string;
@@ -2369,6 +2395,7 @@ closable: boolean;
2369
2395
  collapsible: boolean;
2370
2396
  collapsed: undefined;
2371
2397
  detailsLabel: undefined;
2398
+ bordered: undefined;
2372
2399
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
2373
2400
  close: () => void;
2374
2401
  "update:collapsed": (value: boolean) => void;
@@ -2387,6 +2414,11 @@ collapsible?: boolean;
2387
2414
  collapsed?: boolean;
2388
2415
  /** The toggle text when there is no title. / Текст переключателя, когда нет заголовка. */
2389
2416
  detailsLabel?: string;
2417
+ /**
2418
+ * Not set, it follows the frames context (`.tao-frames-soft`). `false` is a light style: no frame, a stronger tint of the tone instead (the border stays in the box, so nothing moves); `true` keeps the frame.
2419
+ * Не задан — идёт за контекстом рамок (`.tao-frames-soft`). `false` — лёгкий стиль: рамки нет, вместо неё гуще тон заливки (рамка остаётся в боксе); `true` — рамка остаётся.
2420
+ */
2421
+ bordered?: boolean;
2390
2422
  }>, {
2391
2423
  tone: string;
2392
2424
  title: string;
@@ -2394,6 +2426,7 @@ closable: boolean;
2394
2426
  collapsible: boolean;
2395
2427
  collapsed: undefined;
2396
2428
  detailsLabel: undefined;
2429
+ bordered: undefined;
2397
2430
  }>>> & Readonly<{
2398
2431
  onClose?: (() => any) | undefined;
2399
2432
  "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
@@ -2404,6 +2437,7 @@ detailsLabel: string;
2404
2437
  tone: TaoTone;
2405
2438
  collapsible: boolean;
2406
2439
  collapsed: boolean;
2440
+ bordered: boolean;
2407
2441
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
2408
2442
 
2409
2443
  declare const __VLS_component_6: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_5<__VLS_TypePropsToRuntimeProps_6<{
@@ -2496,6 +2530,8 @@ maxHeight?: TaoLength;
2496
2530
  clickable?: boolean;
2497
2531
  sort?: TaoTableSort | null;
2498
2532
  caption?: string;
2533
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
2534
+ bordered?: boolean;
2499
2535
  }>, {
2500
2536
  rows: () => never[];
2501
2537
  rowKey: string;
@@ -2509,6 +2545,7 @@ maxHeight: string;
2509
2545
  clickable: boolean;
2510
2546
  sort: null;
2511
2547
  caption: string;
2548
+ bordered: undefined;
2512
2549
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
2513
2550
  change: (value: TaoTableSort | null) => void;
2514
2551
  "update:sort": (value: TaoTableSort | null) => void;
@@ -2534,6 +2571,8 @@ maxHeight?: TaoLength;
2534
2571
  clickable?: boolean;
2535
2572
  sort?: TaoTableSort | null;
2536
2573
  caption?: string;
2574
+ /** The outer frame; not set, it follows the frames context (`.tao-frames-soft`). / Внешняя рамка; не задан — идёт за контекстом рамок. */
2575
+ bordered?: boolean;
2537
2576
  }>, {
2538
2577
  rows: () => never[];
2539
2578
  rowKey: string;
@@ -2547,6 +2586,7 @@ maxHeight: string;
2547
2586
  clickable: boolean;
2548
2587
  sort: null;
2549
2588
  caption: string;
2589
+ bordered: undefined;
2550
2590
  }>>> & Readonly<{
2551
2591
  onChange?: ((value: TaoTableSort | null) => any) | undefined;
2552
2592
  "onUpdate:sort"?: ((value: TaoTableSort | null) => any) | undefined;
@@ -2556,6 +2596,7 @@ sort: TaoTableSort | null;
2556
2596
  caption: string;
2557
2597
  head: boolean;
2558
2598
  loading: boolean;
2599
+ bordered: boolean;
2559
2600
  hover: boolean;
2560
2601
  sticky: boolean;
2561
2602
  rows: Record<string, unknown>[];
@@ -2737,8 +2778,8 @@ ariaLabel: string;
2737
2778
  roving: boolean;
2738
2779
  }>>> & Readonly<{}>, {
2739
2780
  empty: boolean;
2740
- ariaLabel: string;
2741
2781
  bordered: boolean;
2782
+ ariaLabel: string;
2742
2783
  divided: boolean;
2743
2784
  roving: boolean;
2744
2785
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
@@ -2833,6 +2874,13 @@ showClose?: boolean;
2833
2874
  * `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
2834
2875
  */
2835
2876
  swipeToClose?: boolean;
2877
+ /**
2878
+ * How far a pulled sheet must go to close, as a share of its height (0.05–1). Default `0.5`: a touch that only grazes it
2879
+ * does not close it. A fast fling needs 15% of the height at least.
2880
+ * Как далеко надо утянуть лист, чтобы он закрылся, долей его высоты (0,05–1). По умолчанию `0.5`: случайное касание его
2881
+ * не закрывает. Быстрому рывку нужно не меньше 15% высоты.
2882
+ */
2883
+ swipeThreshold?: number;
2836
2884
  closeLabel?: string;
2837
2885
  }>, {
2838
2886
  title: string;
@@ -2841,6 +2889,7 @@ surface: string;
2841
2889
  closable: boolean;
2842
2890
  showClose: boolean;
2843
2891
  swipeToClose: boolean;
2892
+ swipeThreshold: number;
2844
2893
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
2845
2894
  close: (...args: any[]) => void;
2846
2895
  "update:modelValue": (...args: any[]) => void;
@@ -2878,6 +2927,13 @@ showClose?: boolean;
2878
2927
  * `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
2879
2928
  */
2880
2929
  swipeToClose?: boolean;
2930
+ /**
2931
+ * How far a pulled sheet must go to close, as a share of its height (0.05–1). Default `0.5`: a touch that only grazes it
2932
+ * does not close it. A fast fling needs 15% of the height at least.
2933
+ * Как далеко надо утянуть лист, чтобы он закрылся, долей его высоты (0,05–1). По умолчанию `0.5`: случайное касание его
2934
+ * не закрывает. Быстрому рывку нужно не меньше 15% высоты.
2935
+ */
2936
+ swipeThreshold?: number;
2881
2937
  closeLabel?: string;
2882
2938
  }>, {
2883
2939
  title: string;
@@ -2886,6 +2942,7 @@ surface: string;
2886
2942
  closable: boolean;
2887
2943
  showClose: boolean;
2888
2944
  swipeToClose: boolean;
2945
+ swipeThreshold: number;
2889
2946
  }>>> & Readonly<{
2890
2947
  onClose?: ((...args: any[]) => any) | undefined;
2891
2948
  "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
@@ -2896,6 +2953,7 @@ closable: boolean;
2896
2953
  side: "left" | "right" | "bottom";
2897
2954
  showClose: boolean;
2898
2955
  swipeToClose: boolean;
2956
+ swipeThreshold: number;
2899
2957
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
2900
2958
 
2901
2959
  declare const __VLS_component_66: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_72<__VLS_TypePropsToRuntimeProps_77<{
@@ -3711,6 +3769,15 @@ declare function __VLS_template_31(): Readonly<{
3711
3769
  mark: TaoSliderMark;
3712
3770
  active: boolean;
3713
3771
  }): unknown;
3772
+ /** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
3773
+ bubble?(props: {
3774
+ value: number;
3775
+ zone: {
3776
+ from: number;
3777
+ to: number;
3778
+ color: string;
3779
+ } | undefined;
3780
+ }): unknown;
3714
3781
  'pre-value'?(): unknown;
3715
3782
  'post-value'?(): unknown;
3716
3783
  }> & {
@@ -3719,6 +3786,15 @@ declare function __VLS_template_31(): Readonly<{
3719
3786
  mark: TaoSliderMark;
3720
3787
  active: boolean;
3721
3788
  }): unknown;
3789
+ /** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
3790
+ bubble?(props: {
3791
+ value: number;
3792
+ zone: {
3793
+ from: number;
3794
+ to: number;
3795
+ color: string;
3796
+ } | undefined;
3797
+ }): unknown;
3722
3798
  'pre-value'?(): unknown;
3723
3799
  'post-value'?(): unknown;
3724
3800
  };
@@ -3729,6 +3805,15 @@ declare function __VLS_template_32(): Readonly<{
3729
3805
  mark: TaoSliderMark;
3730
3806
  active: boolean;
3731
3807
  }): unknown;
3808
+ /** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
3809
+ bubble?(props: {
3810
+ value: number;
3811
+ zone: {
3812
+ from: number;
3813
+ to: number;
3814
+ color: string;
3815
+ } | undefined;
3816
+ }): unknown;
3732
3817
  'pre-value'?(): unknown;
3733
3818
  'post-value'?(): unknown;
3734
3819
  }> & {
@@ -3737,6 +3822,15 @@ declare function __VLS_template_32(): Readonly<{
3737
3822
  mark: TaoSliderMark;
3738
3823
  active: boolean;
3739
3824
  }): unknown;
3825
+ /** The bubble beside a thumb (with `bubble`): its text; `zone` is the zone the thumb stands in. / Плашка у ручки (с `bubble`): её текст; `zone` — зона, в которой стоит ручка. */
3826
+ bubble?(props: {
3827
+ value: number;
3828
+ zone: {
3829
+ from: number;
3830
+ to: number;
3831
+ color: string;
3832
+ } | undefined;
3833
+ }): unknown;
3740
3834
  'pre-value'?(): unknown;
3741
3835
  'post-value'?(): unknown;
3742
3836
  };
@@ -5941,9 +6035,23 @@ declare interface Props {
5941
6035
  }
5942
6036
 
5943
6037
  declare interface Props_10 {
5944
- color?: string;
6038
+ /** The look of the wait: `dots` (the four jumping dots), `ring` (a turning arc), `pulse` (a ripple). / Вид ожидания. */
6039
+ variant?: 'dots' | 'ring' | 'pulse';
6040
+ /**
6041
+ * The size: a number is px, `'40px'` works, or `small` / `medium` / `large` (24 / 40 / 64 px).
6042
+ * Without it: 80 for `dots` (as it always was), 40 for the others.
6043
+ * Размер: число — px, `'40px'` тоже, либо `small` / `medium` / `large` (24 / 40 / 64 px). Без него: 80 у `dots`, 40 у остальных.
6044
+ */
5945
6045
  size?: number | string;
6046
+ /** A colour role of the theme (default: the accent). / Роль цвета темы (по умолчанию акцент). */
6047
+ tone?: TaoToneName;
6048
+ /** Any CSS colour; wins over `tone`. `currentColor` takes the text colour around it. / Любой CSS-цвет; главнее `tone`. */
6049
+ color?: string;
5946
6050
  inline?: boolean;
6051
+ /** What a screen reader says (default: the text of the locale). / Что скажет скринридер (по умолчанию текст локали). */
6052
+ label?: string;
6053
+ /** Only a picture: hidden from a screen reader (the wait is said elsewhere, a button says it by itself). / Только картинка: скрыт от скринридера. */
6054
+ decorative?: boolean;
5947
6055
  }
5948
6056
 
5949
6057
  declare interface Props_11 {
@@ -6710,17 +6818,29 @@ export declare const TaoList: __VLS_WithTemplateSlots_63<typeof __VLS_component_
6710
6818
  export declare const TaoListItem: __VLS_WithTemplateSlots_64<typeof __VLS_component_64, ReturnType<typeof __VLS_template_64>>;
6711
6819
 
6712
6820
  export declare const TaoLoader: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_21<__VLS_TypePropsToRuntimeProps_23<Props_10>, {
6713
- color: string;
6714
- size: number;
6821
+ variant: string;
6822
+ size: undefined;
6823
+ tone: undefined;
6824
+ color: undefined;
6715
6825
  inline: boolean;
6826
+ label: undefined;
6827
+ decorative: boolean;
6716
6828
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_21<__VLS_TypePropsToRuntimeProps_23<Props_10>, {
6717
- color: string;
6718
- size: number;
6829
+ variant: string;
6830
+ size: undefined;
6831
+ tone: undefined;
6832
+ color: undefined;
6719
6833
  inline: boolean;
6834
+ label: undefined;
6835
+ decorative: boolean;
6720
6836
  }>>> & Readonly<{}>, {
6721
6837
  size: number | string;
6838
+ label: string;
6839
+ tone: TaoToneName;
6840
+ variant: "dots" | "ring" | "pulse";
6722
6841
  color: string;
6723
6842
  inline: boolean;
6843
+ decorative: boolean;
6724
6844
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
6725
6845
 
6726
6846
  /**
@@ -6781,6 +6901,9 @@ export declare interface TaoLocale {
6781
6901
  copyLabel: string;
6782
6902
  successText: string;
6783
6903
  };
6904
+ loader: {
6905
+ label: string;
6906
+ };
6784
6907
  date: {
6785
6908
  placeholder: string;
6786
6909
  todayText: string;
@@ -7233,12 +7356,12 @@ onActive?: ((el: HTMLInputElement | null, index: number) => any) | undefined;
7233
7356
  onComplete?: ((value: string) => any) | undefined;
7234
7357
  }>, {
7235
7358
  status: "idle" | "success" | "error";
7359
+ bordered: boolean;
7236
7360
  disabled: boolean;
7237
7361
  placeholder: string;
7238
7362
  error: boolean;
7239
7363
  modelValue: string;
7240
7364
  successText: string;
7241
- bordered: boolean;
7242
7365
  masked: boolean;
7243
7366
  numbersOnly: boolean;
7244
7367
  clearOn: "focus" | "input";
@@ -7351,6 +7474,22 @@ declare interface TaoSliderBaseProps {
7351
7474
  * Диапазон, сведённый в точку, показывает там короткий штрих.
7352
7475
  */
7353
7476
  flat?: boolean;
7477
+ /**
7478
+ * Zones of the scale in colour: `{ to, tone?, color?, dot? }`, each runs to its `to`. The bar shows them dimmed, the filled
7479
+ * part in full colour, and the thumb takes the colour of the zone it stands in.
7480
+ * Зоны шкалы цветом: `{ to, tone?, color?, dot? }`, каждая идёт до своего `to`. Полоса показывает их приглушённо,
7481
+ * закрашенная часть полным цветом, а ручка берёт цвет зоны, в которой стоит.
7482
+ */
7483
+ zones?: readonly TaoSliderZone[];
7484
+ /**
7485
+ * A bubble with the value beside the thumb, in the colour of its zone (the accent without zones). Off by default.
7486
+ * `true`: it shows while the thumb is dragged, hovered or has the keyboard focus; `'always'`: it stays. The text is the
7487
+ * `format` of the value, or the `#bubble` slot. Leave room for it above a horizontal bar (to the right of a vertical one).
7488
+ * Плашка со значением у ручки, цвета её зоны (без зон — акцент). По умолчанию выключена. `true`: видна, пока ручку тянут,
7489
+ * на неё наведён указатель или у неё фокус клавиатуры; `'always'`: видна всегда. Текст — `format` значения или слот `#bubble`.
7490
+ * Оставьте ей место над горизонтальной полосой (справа от вертикальной).
7491
+ */
7492
+ bubble?: boolean | 'always';
7354
7493
  /** Vertical: the maximum is at the top. / Вертикальный: максимум сверху. */
7355
7494
  vertical?: boolean;
7356
7495
  disabled?: boolean;
@@ -7375,6 +7514,30 @@ export declare interface TaoSliderMark {
7375
7514
  /** Значение слайдера: число (одна ручка) или пара [от, до] (диапазон). */
7376
7515
  export declare type TaoSliderValue = number | [number, number];
7377
7516
 
7517
+ /**
7518
+ * A zone of the scale: it runs from the end of the previous one to `to` (the first from `min`, the last to `max`), so zones
7519
+ * never overlap and leave no gap. / Зона шкалы: идёт от конца предыдущей до `to` (первая от `min`, последняя до `max`), поэтому
7520
+ * зоны не пересекаются и не оставляют дыр.
7521
+ */
7522
+ export declare interface TaoSliderZone {
7523
+ to: number;
7524
+ /** A colour role of the theme (default `accent`). / Роль цвета темы (по умолчанию `accent`). */
7525
+ tone?: TaoSliderZoneTone;
7526
+ /** Any CSS colour; wins over `tone`. Its contrast is yours to keep. / Любой CSS-цвет; главнее `tone`. Контраст — на вас. */
7527
+ color?: string;
7528
+ /** A dot on the scale where the zone ends (not at `max`). / Точка на шкале там, где зона кончается (не на `max`). */
7529
+ dot?: boolean;
7530
+ /**
7531
+ * The zone has no colour until the value reaches it: the bar looks plain and is painted as it fills; its dot shows when
7532
+ * the fill gets there. / У зоны нет цвета, пока значение до неё не дошло: полоса выглядит обычной и красится по мере
7533
+ * заполнения; её точка видна, когда заливка дошла.
7534
+ */
7535
+ reveal?: boolean;
7536
+ }
7537
+
7538
+ /** The colour roles a zone can wear. / Цветовые роли, в которые можно красить зону. */
7539
+ export declare type TaoSliderZoneTone = 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
7540
+
7378
7541
  export declare const TaoSpace: __VLS_WithTemplateSlots_18<typeof __VLS_component_18, ReturnType<typeof __VLS_template_18>>;
7379
7542
 
7380
7543
  export declare const TaoSparkline: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_37<__VLS_TypePropsToRuntimeProps_41<{