@enya-learning/nova 0.5.0 → 0.6.0

package/README.md

@@ -53,28 +53,26 @@ Import order matters — `@enya-learning/nova/styles` must come before
 
 ## Styles architecture
 
-Nova's CSS is split across three files with distinct responsibilities:
+Nova's CSS is split across two files with distinct responsibilities:
 
-| File               | Role                                                                                                                                                                                                         |
-| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `nova-binding.css` | Registers the raw palette into Tailwind's `@theme` — every `nova-*` colour stop and utilities like `--ease-bounce`. This is what makes `bg-nova-sky-500` work as a class.                                    |
-| `theme-nova.css`   | Semantic tokens — maps palette stops to _meaning_ (`--color-nova-brand`, `--color-nova-success`, etc.) with `light-dark()` for automatic light/dark switching.                                               |
-| `nova.css`         | The single entry point — boots Tailwind, loads fonts, imports nova-binding and theme-nova, wires Tailwind's `@theme inline` colour classes, defines the `dark` variant, and applies base body/border styles. |
+| File               | Role                                                                                                                                                                                                                      |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `nova-binding.css` | Registers the raw palette into Tailwind's `@theme` — every colour stop and utilities like `--ease-bounce`. This is what makes `bg-sky-500` work as a class.                                                               |
+| `nova.css`         | The single entry point — boots Tailwind, loads fonts, imports nova-binding, defines the semantic tokens (`--color-primary`, `--color-success`, etc. via `light-dark()`), the `dark` variant, and base body/border styles. |
 
 **Import chain:**
 
 ```
-nova.css → nova-binding.css → theme-nova.css
+nova.css → nova-binding.css
 ```
 
 **Where to make changes:**
 
 - Adding a new colour stop → `nova-binding.css`
-- Adding or changing what a colour _means_ (e.g. a new `nova-brand-subtle`
-  surface) → `theme-nova.css`
+- Adding or changing what a colour _means_ (e.g. a new `brand-subtle` surface) →
+  `nova.css`'s semantic `@theme` block
 - Swapping which palette scale powers a semantic role (e.g. changing the brand
   variant) → `nova-binding.css` brand alias block
-- Mapping a new shadcn variable to nova → `nova.css`
 
 ---