css-is-awesome 1.9.0 → 1.9.2

package/AGENTS.md

@@ -337,10 +337,14 @@ The SDK is an optional peer dep — `npm install -D @modelcontextprotocol/sdk zo
 
 ## Other tooling (shipped)
 
-- **`cia` CLI** — ships as `bin/cia.cjs`, exposed as the `cia` bin. The migration
-  on-ramp is live: `npx cia migrate tailwind [path]` and `npx cia migrate bootstrap [path]`
-  parse another system's config and dump a cia theme. Run either with `--help` for
-  full options. (`cia init` / `cia add` remain post-1.0.)
+- **`cia` CLI** — ships as `bin/cia.cjs`, exposed as the `cia` bin. Three verbs:
+  `npx cia migrate tailwind|bootstrap [path]` parses another system's config and
+  dumps a cia theme; `npx cia add <recipe>` (`--list` to browse) copies a recipe
+  from the book into the project — own the pattern; `npx cia analyze [path]`
+  audits a project's stylesheets against the installed API — dead `cia.*` symbols,
+  the `space()` 1–9 scale trap, hard-coded hex colors, BEM chains — with a health
+  score and CI-ready exit codes. Run any verb with `--help`. (`cia init` remains
+  planned.)
 - **JSON token export** — DTCG-format token list in `figma-tokens/`.
 - **`llm.txt`** — at the repo root and served from the docs site; single-fetch
   summary for any AI agent. Also readable over MCP via `read_llm_txt`.

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [1.9.2](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.9.1...v1.9.2) (2026-09-06)
+
+
+### Bug Fixes
+
+* **site:** fs-free track module - client import of blog.ts panicked Turbopack ([8017dec](https://github.com/Jerry2d3d/css-is-awesome/commit/8017dec6279bb37f936be5e3c11a13c46b4c6775))
+
+
+### Features
+
+* **site:** blog explorer - grouping chips + search, extensible tracks ([72ca3f5](https://github.com/Jerry2d3d/css-is-awesome/commit/72ca3f5ee6f9ff28de6cf12ccf5ff070c45691b6))
+
+## [1.9.1](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.9.0...v1.9.1) (2026-09-06)
+
+
+### Features
+
+* **site:** the blog becomes two tracks - engineering + CSS discoveries (EPIC-06) ([dc4319f](https://github.com/Jerry2d3d/css-is-awesome/commit/dc4319ff106b6885247a67c738752a79d7228022))
+
 # [1.9.0](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.8.2...v1.9.0) (2026-09-05)
 
 

package/bin/README.md

@@ -7,7 +7,7 @@ cia's CLI entry points. **These are the only JavaScript files cia ships** — th
 | Bin | File | What it does |
 |---|---|---|
 | `css-is-awesome-mcp` | `../mcp/server.cjs` | MCP stdio server for AI agents (themes, mixins, recipes, etc.) |
-| `cia` | `./cia.cjs` | The CLI — currently supports `migrate tailwind`; more subcommands planned |
+| `cia` | `./cia.cjs` | The CLI router — `migrate` (tailwind/bootstrap), `add` (recipe registry), `analyze` (design-system health) |
 
 Invoke either via `npx` from a consumer project that has cia installed:
 
@@ -15,6 +15,8 @@ Invoke either via `npx` from a consumer project that has cia installed:
 npx css-is-awesome-mcp        # MCP server (stdio; configure via .mcp.json)
 npx cia --help                # CLI help
 npx cia migrate tailwind ./tailwind.config.js
+npx cia add bottom-nav        # copy a recipe into the project — own the pattern
+npx cia analyze src/styles    # health check: dead symbols, space() trap, hex, BEM
 ```
 
 ## Subcommand files

package/dist/tokens.d.ts

@@ -1,4 +1,4 @@
-// Generated from scripts/theme-contract.json on 2026-09-05.
+// Generated from scripts/theme-contract.json on 2026-09-06.
 // Do not edit by hand. Run `npm run build:token-types` to regenerate.
 
 /** Every CSS custom property cia themes are required to declare. */

package/llm.txt

@@ -48,6 +48,7 @@ silent.
 - **Mixins** — `cia.btn`, `cia.card`, `cia.accordion`, `cia.modal`, `cia.tooltip`, `cia.dropdown`, `cia.tabs`, `cia.copy-button`, `cia.hamburger`, `cia.drawer`, `cia.sheet`, `cia.dock`, `cia.stepper`, `cia.progress`, `cia.wizard-shell`, `cia.sidebar`, `cia.toolbar`, `cia.stack`, `cia.cluster`, `cia.switcher`, `cia.cover`, `cia.frame`, `cia.media`, `cia.contain`, `cia.focus-ring`, `cia.sr-only`, `cia.print`, `cia.print-base`, `cia.print-hidden`, `cia.print-only`, `cia.color`, `cia.space`, `cia.radius`, `cia.shadow`, `cia.font`, `cia.transition`, `cia.animate`, plus many more.
 - **24 themes / 8 families** — boilerplate, sketchbook, press, prism, cupertino, glass, graphite, terminal. Each family ships three files: an unsuffixed dual-mode base (both modes via `light-dark()`) plus pinned `-light` and `-dark` single-mode variants for `<link media>` pairing. Every one has exactly one SCSS source under `scss/themes/`; `public/themes/<name>/theme.css` is BUILD OUTPUT and is gated against its source by `npm run check:theme-drift` — never hand-edit it. MCP `list_themes` returns **24**. Say **24 themes across 8 families** when you need one number.
 - **6 zero-JS interactive components** — accordion (`<details name>`), modal (`<dialog>`), tooltip (`popover="hint"`), dropdown (`[popover]` — the mixin re-asserts the UA's closed state and restores `display: flex` only under `:popover-open`, so menus never render permanently open on popover markup), tabs (radio + `:has()`), copy-button (Clipboard API via consumer-wired JS).
+- **CLI** (`npx cia`) — `migrate tailwind|bootstrap` (config → cia theme), `add <recipe>` (copy a recipe from the book into the project), `analyze [path]` (audit stylesheets against the installed API: dead `cia.*` symbols, the `space()` 1–9 trap, hard-coded hex, BEM; health score, CI exit codes).
 - **Mobile navigation family** — `cia.hamburger` / `cia.drawer` / `cia.sheet` / `cia.dock` ride `[popover]` + CSS Grid, zero JS; recipes `mobile-nav` (hamburger + drawer) and `bottom-nav` (dock + sheets). House rule: **on phones things take the space they're in** — a `cia.dropdown` menu opens 1px under its full-width trigger at the trigger's exact width via CSS anchor positioning (`position-try-fallbacks: flip-block` flips it above at the screen bottom; set `width: auto` at `&[popover]` specificity or the UA's `[popover] { width: fit-content }` and the mixin's inset reset win). Full spec: AGENTS.md quick decision #8 and `/docs/mobile`.
 - **163 contract tokens — 127 required + 36 optional** — surfaces, ink, lines, colors, type, radius, shadow, blur, glow, motion, z-index, spacing, semantic aliases.
 - **Spacing is themeable, and the numbered scale is the knob.** Themes declare `--space-0` … `--space-9` (contract-required). The t-shirt names (`--space-md`, `--space-lg` …) are contract-OPTIONAL and emitted by the library as `var()` aliases onto the numbered steps. `space(4)` compiles to `var(--space-4)`, so **theme the numbered step, never the alias** — setting `--space-md` alone leaves every component untouched. Library defaults emit under `:where(:root)` (specificity 0,0,0) so any theme declaration outranks them regardless of load order.
@@ -101,6 +102,7 @@ Newspaper by day, hacker terminal by night. Most design systems give you dark mo
 | Mixin reference (every public mixin) | `src/app/docs/mixins/page.tsx` |
 | Component examples | `src/app/docs/components/*/page.tsx` (6 components) |
 | Mobile playbook (layouts, dropdown doctrine, lessons) | `src/app/docs/mobile/page.tsx` |
+| Browser support matrix (Baseline floor + progressive tiers) | `src/app/docs/browser-support/page.tsx` |
 | Theme authoring (full walkthrough) | `src/app/docs/authoring/themes/page.tsx` |
 | Theme contract (127 required + 36 optional, machine-readable) | `scripts/theme-contract.json` |
 | Theme pairing (`<link media>` recipe) | `src/app/docs/themes/pairing/page.tsx` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "css-is-awesome",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "A token-driven SCSS design system with light/dark theming, semantic color tokens, and a 800+ LOC mixin API.",
   "homepage": "https://github.com/Jerry2d3d/css-is-awesome#readme",
   "bugs": {