@1337exp/taoui 5.8.3 → 5.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # Changelog
2
2
 
3
+ ## 5.9.0
4
+
5
+ A new component; nothing to migrate.
6
+
7
+ - **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).
8
+ - Showcase: «Orders by time» in the charts section.
9
+
10
+ ## 5.8.4
11
+
12
+ A fix; nothing to migrate.
13
+
14
+ - **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).
15
+
3
16
  ## 5.8.3
4
17
 
5
18
  A fix; nothing to migrate.
package/README.md CHANGED
@@ -31,7 +31,7 @@
31
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.
32
32
  - **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
33
  - **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
- - **Charts the honest way.** Small `TaoSparkline` / `TaoMeter` / `TaoDonut` for cards and lines of text; for real charts `taoChartTheme()` hands the theme colours to Chart.js, ECharts or uPlot.
34
+ - **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.
35
35
  - **Built-in languages.** Placeholders, dates and aria labels in English and Russian, switchable at runtime without a reload.
36
36
  - **Nuxt and plain Vue.** `TaoLink` picks `NuxtLink`, `RouterLink` or `<a>` by itself. Fully typed ESM, every component tested for server rendering.
37
37
  - **Ready for AI assistants.** The package ships a skill with a reference of every component, generated from these docs, so an assistant writes Tao UI code instead of guessing.
@@ -104,6 +104,7 @@
104
104
 
105
105
  - **TaoTable** — simple table: columns, empty, loading, sort via `v-model:sort`. `head` tints the header, `lines` draws row rules (both on by default). `striped` starts on the first row; `striped="even"` starts on the second. Not a datagrid.
106
106
  - **TaoSparkline** / **TaoMeter** / **TaoDonut** — small charts for a card or a line of text: a trend (`values` with `null` gaps, `area`, `dot`), a measured value in a range (`role="meter"`, coloured by `low` / `high` / `optimum` as the HTML `<meter>`), a share of a whole (`segments`, or one `value` of `max`, `legend`, a centre slot). The series colours are the roles `--tao-color-chart-1…6` (the first is the accent, so palettes recolour them). For axes and tooltips use a chart library: `taoChartTheme()` gives it the theme colours as `rgb()`, `watchTaoChartTheme(apply)` re-applies them on a theme or palette change
107
+ - **TaoHeatmap** — a value for each pair of two things (orders by weekday and hour): `values` by `rows` × `cols`, the colour by thresholds (`steps`, round numbers by default) that the legend names («500+»), the faint levels striped, a tip with the exact number. A `role="grid"` the arrows move through, a screen reader reads the row, the column and the number; it fits its container and shows the column names as often as they fit
107
108
  - **TaoPagination** — pages with ellipsis. Clicking “…” jumps `jump` pages (5 by default). `pageSizes` adds a «Per page» choice (`v-model:page-size`); the first row on screen stays on screen
108
109
  - **TaoEmpty** — empty list, no results, no access
109
110
  - **TaoList** / **TaoListItem** — list row: icon, title, caption, hover action. Not Select, not a table
package/README.ru.md CHANGED
@@ -31,7 +31,7 @@
31
31
  - **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA.
32
32
  - **Подстраивается без JS.** `TaoNav` превращается из нижней панели в рейку и боковую панель, bento-сетка перестраивается, главное действие переезжает вместе с навигацией — по ширине своего контейнера (container queries), а не окна. После гидратации ничего не прыгает.
33
33
  - **Клавиатура и скринридеры.** Меню, полоса меню, панель инструментов, дерево и навигация сделаны по шаблонам WAI-ARIA: одна остановка Tab и стрелки внутри (roving tabindex), переключатели с `aria-pressed`, `role="meter"`, ловушки фокуса в оверлеях.
34
- - **Графики по-честному.** Маленькие `TaoSparkline` / `TaoMeter` / `TaoDonut` для карточек и строк текста; для настоящих графиков `taoChartTheme()` отдаёт цвета темы в Chart.js, ECharts или uPlot.
34
+ - **Графики по-честному.** Маленькие `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` для карточек и строк текста; для настоящих графиков `taoChartTheme()` отдаёт цвета темы в Chart.js, ECharts или uPlot.
35
35
  - **Встроенные языки.** Плейсхолдеры, даты и aria-подписи на русском и английском, переключаются на лету без перезагрузки.
36
36
  - **Nuxt и чистый Vue.** `TaoLink` сам выбирает `NuxtLink`, `RouterLink` или `<a>`. Полные типы, ESM, рендер каждого компонента на сервере проверен тестами.
37
37
  - **Готов для ИИ-ассистентов.** В пакете есть skill со справочником всех компонентов, он генерируется из этой документации, поэтому ассистент пишет код на Tao UI, а не угадывает.
@@ -104,6 +104,7 @@
104
104
 
105
105
  - **TaoTable** — простая таблица: колонки, empty, loading, сортировка через `v-model:sort`. `head` — подсветка шапки, `lines` — линии между рядами (оба по умолчанию включены). `striped` — зебра с первой строки, `striped="even"` — со второй. Не datagrid.
106
106
  - **TaoSparkline** / **TaoMeter** / **TaoDonut** — маленькие графики для карточки или строки текста: тренд (`values` с разрывами `null`, `area`, `dot`), измеренное значение в диапазоне (`role="meter"`, цвет по `low` / `high` / `optimum`, как у HTML `<meter>`), доля целого (`segments` или одно `value` из `max`, `legend`, слот в центре). Цвета серий — роли `--tao-color-chart-1…6` (первый — акцент, поэтому палитры их перекрашивают). Для осей и подсказок берите библиотеку графиков: `taoChartTheme()` отдаёт ей цвета темы в `rgb()`, `watchTaoChartTheme(apply)` применяет их заново при смене темы или палитры
107
+ - **TaoHeatmap** — значение для каждой пары (заказы по дню недели и часу): `values` по `rows` × `cols`, цвет по порогам (`steps`, по умолчанию круглые числа), которые называет легенда («500+»), бледные уровни в полоску, подсказка с точным числом. `role="grid"`, по которому ходят стрелками; скринридер читает строку, столбец и число; занимает ширину контейнера и показывает имена столбцов так часто, как они помещаются
107
108
  - **TaoPagination** — страницы с многоточием. Клик по «…» прыгает на `jump` страниц (5 по умолчанию). `pageSizes` добавляет выбор «На странице» (`v-model:page-size`); первая видимая строка остаётся на экране
108
109
  - **TaoEmpty** — пустой список, нет результатов, нет прав
109
110
  - **TaoList** / **TaoListItem** — строка списка: иконка, заголовок, подпись, действие по ховеру. Не Select и не таблица