@equal-experts/kuat-vue 0.9.1 → 0.10.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/README.md CHANGED
@@ -30,6 +30,22 @@ Vue 3 components and blocks for the Kuat Design System: **localized primitives**
30
30
  pnpm add vue @equal-experts/kuat-core @equal-experts/kuat-vue
31
31
  ```
32
32
 
33
+ ### Agent Guardrails
34
+
35
+ Add this to your project `AGENTS.md` (or `.cursorrules`) so agent workflows stay Kuat-first:
36
+
37
+ ```markdown
38
+ ## Kuat UX and UI Decision Rules
39
+ 1. Load bundled rules entrypoints from `@equal-experts/kuat-core`:
40
+ - `node_modules/@equal-experts/kuat-core/agent-docs/kuat-docs/rules/README.md`
41
+ - `node_modules/@equal-experts/kuat-core/agent-docs/external/kuat-agent-rules/kuat-docs/rules/LOADING.md`
42
+ 2. Use bundled Equal Experts foundations and web rules for wider UX/UI decisions (layout, navigation, hierarchy, spacing, typography, content, accessibility), not just component choice (`.../external/kuat-agent-rules/.../foundations/*` and `.../types/web/*`).
43
+ 3. For implementation, read `kuat-docs/setup/choosing-components.md` before building UI.
44
+ 4. Choose component sources in order: Kuat blocks -> Kuat components -> shadcn-vue gaps -> custom.
45
+ 5. Verify exports in `@equal-experts/kuat-vue` before implementing.
46
+ 6. Document both design decision rationale and chosen component source in PR notes.
47
+ ```
48
+
33
49
  ### Peer dependencies
34
50
 
35
51
  Install peers for the components you use before running `dev` or `build`.
@@ -85,11 +101,13 @@ import { Switch } from '@equal-experts/kuat-vue/switch';
85
101
 
86
102
  See `package.json` `exports` and [public-api-inventory.md](https://github.com/equalexperts/kuat-mono/blob/master/kuat-docs/setup/public-api-inventory.md).
87
103
 
88
- `KuatCarousel` is currently exported from the root barrel:
104
+ `KuatCarousel` is exported from both the root barrel and subpath:
89
105
 
90
106
  ```vue
91
107
  <script setup lang="ts">
92
108
  import { KuatCarousel } from '@equal-experts/kuat-vue';
109
+ // or
110
+ // import { KuatCarousel } from '@equal-experts/kuat-vue/kuat-carousel';
93
111
  </script>
94
112
  ```
95
113
 
@@ -253,7 +271,7 @@ pnpm dev
253
271
  - Pass: `Button`, `Field`, and `KuatCarousel` render with Kuat styles (not plain browser defaults).
254
272
  - Pass: typography uses Kuat font stack (Lexend for sans) rather than template defaults.
255
273
  - Fail: any need to import internal `dist/*.css` files manually.
256
- - Fail: using `@equal-experts/kuat-vue/carousel` instead of root barrel import for carousel.
274
+ - Fail: selecting custom/shadcn-vue carousel without documenting why `@equal-experts/kuat-vue` carousel exports were not used.
257
275
 
258
276
  ---
259
277