@1337exp/taoui 5.28.0 → 5.30.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.28.0",
3
+ "version": "5.30.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,7 @@
82
82
  "prepublishOnly": "npm run type-check && npm run test && npm run build && npm run lint:package",
83
83
  "lint:package": "publint && attw --pack . --profile esm-only --exclude-entrypoints styles.css palettes.css",
84
84
  "palettes": "node scripts/generate-palettes.mjs",
85
- "skill": "node scripts/generate-skill.mjs"
85
+ "skill": "node scripts/generate-skill.mjs && node scripts/generate-patterns.mjs"
86
86
  },
87
87
  "peerDependencies": {
88
88
  "vue": "^3.4.0"
@@ -8,7 +8,9 @@ description: Build Vue 3 interfaces with @1337exp/taoui 5 (TaoUI) — setup, the
8
8
  A Vue 3 component kit on design tokens. Components read **roles** (CSS custom properties `--tao-*`), never colours, so a
9
9
  theme, a palette or a context class changes every component under it. The props of every component, with types and
10
10
  defaults, are in [references/components.md](references/components.md); read the section you need before writing a
11
- component you have not used yet.
11
+ component you have not used yet. **How to put them together** (the accent budget, choosing a size: small / medium / large and
12
+ density, a toolbar, the footer of a form, a destructive action: what to use when, with a do and a don't) is in [references/patterns.md](references/patterns.md); read
13
+ it before you compose a screen.
12
14
 
13
15
  ## Setup
14
16
 
@@ -143,12 +145,16 @@ Which language to start with: `detectTaoLanguage(['en', 'ru'], { fallback?, requ
143
145
  ## Mistakes to avoid
144
146
 
145
147
  - Writing hex colours or `rgba()` in app CSS instead of roles; inventing token names (check `styles.css`).
146
- - Passing `size` to every control instead of one `tao-size-*` / `tao-density-*` class on the container.
148
+ - Passing `size` to every control instead of one `tao-size-*` / `tao-density-*` class on the container; worse, to some of them
149
+ only (the rest stay medium and the row comes out uneven), or pinning `--tao-control-height` on one (patterns.md, "Controls
150
+ side by side").
147
151
  - Styling `.tao-grid` as a grid (it is `.tao-grid__cells`); expecting `rowHeight` to be a minimum (it is exact).
148
152
  - Putting `TaoMarquee` in a parent without left room: the left fade takes `fade` px (22) left of the text.
149
153
  - Using colour alone for a status; forgetting `aria-label` on an icon-only button (`TaoButton icon="tao-plus"` needs one).
150
154
  - Global `h1 { … }` styles fighting `.tao-prose` (its rules are `:where()`, so yours win by design).
151
155
  - Expecting `variant="danger"` on a button: the colour is `tone="danger"`, the shape is `variant`.
156
+ - A `ghost` or `text` button without `tone` is accent-coloured (amber): in a toolbar, a row or a header it must be
157
+ `tone="neutral"`. The accent is for the one main action, the selected item and the focus (patterns.md, the accent budget).
152
158
  - Importing from deep paths (`@1337exp/taoui/dist/...`); only the package root, `styles.css`, `palettes.css` and
153
159
  `styles/*` are public.
154
160