@equal-experts/kuat-vue 0.14.0-beta.0 → 0.14.0-beta.2

package/README.md

@@ -117,50 +117,49 @@ import { KuatCarousel } from '@equal-experts/kuat-vue';
 
 ## Recommended setup
 
-### 1. Tailwind
+### 1. Tailwind v4 + Kuat tokens (CSS-first)
 
-```typescript
-// tailwind.config.ts
-import type { Config } from 'tailwindcss';
-import kuatPreset from '@equal-experts/kuat-core';
-
-export default {
-  presets: [kuatPreset],
-  content: [
-    './src/**/*.{vue,js,ts}',
-    './node_modules/@equal-experts/kuat-vue/**/*.{vue,js,ts}',
-  ],
-} satisfies Config;
-```
-
-### 2. Tailwind runtime stylesheet (required for Tailwind v4)
-
-Create a global stylesheet and load Tailwind:
+Add the Tailwind v4 plugin to your build (e.g. `@tailwindcss/vite`), then create
+a global stylesheet that imports Tailwind and the Kuat tokens. The tokens must
+be pulled in **through Tailwind** (a CSS `@import`) so the `@theme` block in
+`variables.css` is processed and the token utilities (`bg-primary`,
+`text-foreground`, `rounded-lg`, …) are generated:
 
 ```css
-/* src/tailwind.css */
+/* src/index.css */
+@import "@equal-experts/kuat-core/fonts.css"; /* fonts; or a <link> — see kuat-core README */
 @import "tailwindcss";
+@import "@equal-experts/kuat-core/variables.css";
 ```
 
-### 3. Design tokens and Kuat styles
+> A plain JS `import "@equal-experts/kuat-core/variables.css"` loads the raw
+> variables but does **not** feed the `@theme` block to Tailwind, so the token
+> utilities never generate (with no error). Always `@import` the tokens through
+> Tailwind, as above.
+>
+> The legacy JS preset (`presets: [kuatPreset]`) is **deprecated** and is not
+> auto-loaded by Tailwind v4 — don't use it. See the kuat-core README.
+
+### 2. Component styles (once per app entrypoint)
+
+Kuat component CSS is pre-compiled, so a JS import is correct here:
 
 ```typescript
 // main.ts
-import '@equal-experts/kuat-core/variables.css';
-import '@equal-experts/kuat-vue/styles';
-import './tailwind.css';
+import '@equal-experts/kuat-vue/styles'; // pre-compiled component CSS
+import './index.css';                     // Tailwind + Kuat tokens (from step 1)
 ```
 
 If you scaffolded from a starter template (for example Vite), remove or neutralize template CSS that resets fonts/layout globally (for example `src/style.css` with `:root { font: ... }`, `body { ... }`, `#app { ... }`). These rules can override Kuat typography and spacing.
 
-### 4. shadcn-vue for gaps
+### 3. shadcn-vue for gaps
 
 ```bash
 npx shadcn-vue@latest init
 npx shadcn-vue@latest add dialog dropdown-menu
 ```
 
-### 5. Use Kuat + shadcn-vue together
+### 4. Use Kuat + shadcn-vue together
 
 ```vue
 <script setup lang="ts">
@@ -228,6 +227,8 @@ Use this quick smoke test after installation to verify imports, styles, and Tail
 import {
   Button,
   Field,
+  FieldLabel,
+  Input,
   KuatCarousel,
   KuatCarouselContent,
   KuatCarouselItem,
@@ -241,8 +242,8 @@ import {
     <h1 class="text-4xl font-bold">Kuat install smoke test</h1>
 
     <Field>
-      <label for="name">Name</label>
-      <input id="name" placeholder="Test input" />
+      <FieldLabel for="name">Name</FieldLabel>
+      <Input id="name" placeholder="Test input" />
     </Field>
 
     <Button variant="primary">Primary action</Button>

package/agent-docs/AGENTS.md

@@ -4,7 +4,7 @@ Rules for this install live under `agent-docs/` in `@equal-experts/kuat-core`, `
 
 1. Run `ensure-rules.sh` from kuat-agent-docs skills (symlinked) — expect `RULES_SOURCE=package` when cwd has node_modules.
 2. Load `agent-docs/rules/LOADING-consumer.md`.
-3. Load component guides via `agent-docs/components.manifest.json`.
+3. Load component guides via `agent-docs/components/components.manifest.json`.
 4. Skills: `kuat-review`, `kuat-create` from [kuat-agent-docs](https://github.com/equalexperts/kuat-agent-docs).
 
-**Version:** 0.14.0-beta.0 · **Rules snapshot:** 538afc80d437
+**Version:** 0.14.0-beta.2 · **Rules snapshot:** 9b0e773d809b

package/agent-docs/README.md

@@ -14,4 +14,4 @@ Curated agent docs bundled with `@equal-experts/kuat-core`, `@equal-experts/kuat
 node scripts/agent-docs/bundle-for-core.mjs
 ```
 
-Built against upstream ref: `538afc80d437`
+Built against upstream ref: `9b0e773d809b`

package/agent-docs/manifest.json

@@ -1,8 +1,8 @@
 {
-  "packageVersion": "0.14.0-beta.0",
+  "packageVersion": "0.14.0-beta.2",
   "rules": {
-    "snapshotRef": "538afc80d4372a6c6cdcd75c4d35782b5988a664",
-    "snapshotDate": "2026-06-24T13:14:10.590Z",
+    "snapshotRef": "9b0e773d809beedff9cd663ecddc2b6be0b69897",
+    "snapshotDate": "2026-07-01T10:17:20.202Z",
     "sourceRepo": "equalexperts/kuat-agent-docs",
     "loadingPath": "agent-docs/rules/LOADING-consumer.md"
   }

package/agent-docs/rules/LOADING-consumer.md

@@ -2,7 +2,7 @@
 
 **Package:** @equal-experts/kuat-core (and mirrored in kuat-react / kuat-vue agent-docs)
 
-**Snapshot:** 538afc80d437
+**Snapshot:** 9b0e773d809b
 
 ## Default load (web product / marketing UI)