@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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1337exp/taoui",
3
- "version": "5.8.3",
3
+ "version": "5.9.0",
4
4
  "description": "Design-token driven Vue 3 / Nuxt component library: palettes with tested contrast, accessible menus and toolbars, navigation that adapts without JS, small charts, built-in locales.",
5
5
  "keywords": [
6
6
  "vue",
@@ -82,7 +82,8 @@ choose a text colour, WCAG 2 to promise a number.
82
82
  `TaoRangeSlider`, `TaoPinCode` (`status="success | error"` after `complete`), `TaoColorInput` / `TaoColorPicker`,
83
83
  `TaoFileDrop`. A form is a plain `<form>`; there is no TaoForm.
84
84
  - Attributes given to a field (`aria-label`, `name`, `autocomplete`, `inputmode`, `data-*`, listeners) reach its control
85
- (the input, the trigger button, the checkbox); `class` and `style` stay on its wrapper.
85
+ (the input, the trigger button, the checkbox); `class` and `style` stay on its wrapper. On `TaoColorInput` the
86
+ `aria-label` is followed by the colour («Background: #ff8800»); `TaoColorPicker` is a group it names.
86
87
 
87
88
  ## Overlays and feedback
88
89
 
@@ -111,7 +112,8 @@ choose a text colour, WCAG 2 to promise a number.
111
112
  `TaoScrollTop`, `TaoAnimatedBorder`, `TaoIcon`.
112
113
 
113
114
  Small charts only: `TaoSparkline` (a trend), `TaoMeter` (a value in a range, `low` / `high` / `optimum`), `TaoDonut`
114
- (`segments` or `value` of `max`). Series colours `--tao-color-chart-1…6`. For a real chart (axes, tooltips) use a chart
115
+ (`segments` or `value` of `max`), `TaoHeatmap` (`values` by `rows` × `cols`, threshold `steps` with a legend, a grid the
116
+ arrows move through). Series colours `--tao-color-chart-1…6`. For a real chart (axes, tooltips) use a chart
115
117
  library and feed it `taoChartTheme()` / `watchTaoChartTheme(apply)`; do not build axes by hand.
116
118
 
117
119
  ## Icons
@@ -574,6 +574,27 @@ Showcase section: `#charts`
574
574
 
575
575
  **Slots, events, notes.** default — the middle of the ring (a number, a word). taoChartTheme(el?) returns the theme colours as rgb() for a chart library: colors (6 series), text, textMuted, grid, axis, background, tooltip, tooltipText, danger / success / warning, fontFamily; watchTaoChartTheme(apply, el?) calls it now and on every theme, mode or palette change, and returns stop().
576
576
 
577
+ ## TaoHeatmap
578
+
579
+ Showcase section: `#charts`
580
+
581
+ | Prop | Type | Default | Notes |
582
+ |---|---|---|---|
583
+ | `values` | `(number \| null)[][]` | — | One array per row, one value per column; null is no data |
584
+ | `rows / cols` | `string[]` | — | The names of the rows («Mon») and the columns («12 am») |
585
+ | `steps` | `number[]` | by the data | The thresholds, ascending: a cell takes the colour of the highest one it reaches, below the first it is empty. By default round numbers at 10–80% of the largest value |
586
+ | `tone` | `TaoToneName` | 'accent' | The colour of the levels: from faint to the full tone |
587
+ | `label` | `string` | — | The accessible name of the grid |
588
+ | `legend` | `boolean` | true | The thresholds with their colours («500+») under the map |
589
+ | `hatch` | `number` | 1 | How many of the lowest levels are striped, so they read apart from empty cells without colour too |
590
+ | `labelEvery` | `number` | 1 | Show every n-th column name; all of them are still read |
591
+ | `colLabels` | `'top' \| 'bottom'` | 'bottom' | Where the column names stand |
592
+ | `cellHeight` | `number` | — | The cell height, px; square cells by default |
593
+ | `gap` | `number` | 3 | The gap between cells, px |
594
+ | `format` | `(value) => string` | by the locale | How a number is written in the tip, the cells and the legend |
595
+
596
+ **Slots, events, notes.** tip { row, col, value, text } — the tip over a cell. role="grid": one cell is in the tab order, the arrows, Home / End (Ctrl for the corners) and PageUp / PageDown move it; a screen reader reads the row, the column and the number. The map fits the width of its container.
597
+
577
598
  ## TaoTable
578
599
 
579
600
  Showcase section: `#table`