css-is-awesome 1.12.1 → 1.13.1

package/AGENTS.md

@@ -323,6 +323,8 @@ Two ways to run it — prefer the dedicated `npx css-is-awesome-mcp` package (ze
 }
 ```
 
+No install step needed — `npx` fetches it on first run. To pin an exact version instead, `npm install css-is-awesome-mcp` first; `npx` then uses that local copy.
+
 Or run this in-repo copy directly — needs its SDK peer deps installed manually first (`npm install -D @modelcontextprotocol/sdk zod` in the client project, since they're optional peers):
 
 ```json

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.13.1](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.13.0...v1.13.1) (2026-09-11)
+
+
+### Bug Fixes
+
+* **themes:** import a single :root theme file into BOTH modes, not just the active tab ([96a860a](https://github.com/Jerry2d3d/css-is-awesome/commit/96a860a1482db67d5bbe9a8b7426308b24250ca6)), closes [#F7F3EA](https://github.com/Jerry2d3d/css-is-awesome/issues/F7F3EA) [#1A1815](https://github.com/Jerry2d3d/css-is-awesome/issues/1A1815)
+
+# [1.13.0](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.12.1...v1.13.0) (2026-09-11)
+
+
+### Features
+
+* **mcp:** add derive-theme:<base> intent to assemble_prompt ([576dfcb](https://github.com/Jerry2d3d/css-is-awesome/commit/576dfcb80363f281d13ecf0c9218de8915de6595))
+
 ## [1.12.1](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.12.0...v1.12.1) (2026-09-11)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm](https://img.shields.io/npm/v/css-is-awesome?logo=npm&color=cb3837)](https://www.npmjs.com/package/css-is-awesome) [![CI](https://github.com/Jerry2d3d/css-is-awesome/actions/workflows/ci.yml/badge.svg)](https://github.com/Jerry2d3d/css-is-awesome/actions/workflows/ci.yml) [![Node](https://img.shields.io/badge/node-%E2%89%A520-43853d?logo=node.js&logoColor=white)](./package.json) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE) [![semantic-release](https://img.shields.io/badge/semantic--release-enabled-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
 
-**Bring your own selectors. We bring the design system.** One CSS file per theme — drop it in and the page restyles, no markup change. 24 themes. Zero JavaScript in the npm package. Six browser-native interactive components. Small enough to read in an afternoon.
+**Bring your own components. Bring your own selectors. We bring the design system.** No component library to fight, in React, Vue, Angular, Svelte, Web Components, Razor, SharePoint, or plain HTML — cia styles the markup you already own. One CSS file per theme — drop it in and the page restyles, no markup change. 24 themes. Zero JavaScript in the npm package. Six browser-native interactive components. Small enough to read in an afternoon.
 
 **Docs:** [cssisawesome.com](https://cssisawesome.com/) · **Install:** `npm install css-is-awesome`
 
@@ -16,22 +16,18 @@
 
 **Then connect the MCP server** and stop guessing at signatures. It answers from the real source — 30 tools covering themes, mixins, functions, tokens, recipes and components.
 
-```bash
-npm install -D @modelcontextprotocol/sdk zod   # required — npm will NOT install these for you
-```
-
 ```json
 {
   "mcpServers": {
     "css-is-awesome": {
-      "command": "node",
-      "args": ["node_modules/css-is-awesome/mcp/server.cjs"]
+      "command": "npx",
+      "args": ["css-is-awesome-mcp"]
     }
   }
 }
 ```
 
-The SDK and `zod` are declared as *optional* peer dependencies, so a plain `npm install css-is-awesome` skips them and this in-repo copy exits with `@modelcontextprotocol/sdk is not installed`. Install both — or skip this entirely and run `npx css-is-awesome-mcp` instead, the dedicated zero-install package (see the MCP section below), which ships the SDK as a real dependency.
+That's the whole setup — [`css-is-awesome-mcp`](https://www.npmjs.com/package/css-is-awesome-mcp) is a dedicated zero-install package, no manual dependency step. `npx` fetches and caches it on first run with no install command needed; if you'd rather pin an exact version in your own `package.json`/lockfile, `npm install css-is-awesome-mcp` works too — `npx` then uses the locally installed copy instead of fetching. (The in-repo copy at `mcp/server.cjs` still works too, if you'd rather not add a second package — see the MCP section below for that path, which needs `npm install -D @modelcontextprotocol/sdk zod` first since those are optional peers here.)
 
 Why it matters more here than for older frameworks: no model has memorised cia's API the way it has memorised Tailwind's class names. Without `llm.txt` or MCP, an agent will confidently invent a Tailwind-shaped API. With them, it reads the real thing. Details at [`/docs/mcp`](https://cssisawesome.com/docs/mcp/).
 
@@ -313,6 +309,12 @@ cia ships a Model Context Protocol stdio server (JSON-RPC over stdio, protocol `
 }
 ```
 
+No install command required — `npx` fetches and caches the package the first time your MCP client runs it. Prefer a pinned version in your own lockfile instead? `npm install css-is-awesome-mcp` works the same way as any other dependency; `npx` then runs the locally installed copy rather than fetching one:
+
+```bash
+npm install css-is-awesome-mcp
+```
+
 **Alternative — the copy already in your `node_modules`:** cia's own `files` manifest ships [`mcp/server.cjs`](./mcp/server.cjs) too, for anyone who'd rather not add a second package. This copy needs its SDK peer deps installed manually first, since they're declared as *optional* peers (so a plain `npm install css-is-awesome` doesn't pull JS into a CSS-only install):
 
 ```bash
@@ -406,7 +408,7 @@ Full detail: [`/docs/testing`](https://cssisawesome.com/docs/testing/).
 
 **Stable, [published on npm](https://www.npmjs.com/package/css-is-awesome)** (first published 2026-09-01). The mixin API, functions, token contract, and theme architecture are stable and under strict SemVer — breaking changes require a major bump. See [`VERSIONING.md`](./VERSIONING.md) for the policy.
 
-The 1.0 surface is the v0.8 mixin-first reframe — twelve mixin renames, theme system collapsed to 8 single-file theme families, six zero-JS components, intrinsic-layout vocabulary, opt-in utilities — plus the recipes book, the Tailwind/Bootstrap migration on-ramp, print/PDF support, and the 30-tool MCP server. The npm package ships ZERO JavaScript by hard rule.
+The 1.0 surface is the v0.8 mixin-first reframe — twelve mixin renames, theme system collapsed to 8 single-file theme families, six zero-JS components, intrinsic-layout vocabulary, opt-in utilities — plus the recipes book, the Tailwind/Bootstrap migration on-ramp, print/PDF support, and the 30-tool MCP server (now also available zero-install via the companion [`css-is-awesome-mcp`](https://www.npmjs.com/package/css-is-awesome-mcp) package). The npm package ships ZERO JavaScript by hard rule.
 
 See [CHANGELOG.md](./CHANGELOG.md) for the full history and [MIGRATION.md](./MIGRATION.md) for the v0.7 → v0.8 upgrade path.
 

package/llm.txt

@@ -142,6 +142,9 @@ SDK ships as a real dependency, no separate peer-install step:
   }
 }
 ```
+No install command needed — `npx` fetches it on first run. To pin an exact
+version in a lockfile instead, `npm install css-is-awesome-mcp` works the same
+as any other dependency; `npx` then uses that local copy.
 
 Alternative: the copy already in `node_modules` (this repo's own `mcp/server.cjs`).
 **Two dependencies are required and npm will NOT install them for you** for this

package/mcp/server.cjs

@@ -1136,6 +1136,40 @@ const handlers = {
         }
         break;
       }
+      case 'derive-theme': {
+        if (!target) throw new Error('assemble_prompt: intent "derive-theme:" requires a base theme name');
+        const base = handlers.get_theme({ name: target });
+        const themeMixin = handlers.get_mixin({ name: 'theme' });
+        const tk = getTokens();
+        banner(`css-is-awesome — deriving a new theme from ${base.name}`);
+        sub('Base theme — copy this, then edit only what should change');
+        lines.push('```scss');
+        lines.push(base.raw_scss);
+        lines.push('```');
+        lines.push('');
+        sub('The `theme()` wrapper contract');
+        lines.push('```scss');
+        lines.push(themeMixin.signature);
+        lines.push('```');
+        if (themeMixin.doc) { lines.push(''); lines.push(themeMixin.doc); }
+        lines.push('');
+        sub('Required + optional tokens (must all still be present)');
+        lines.push(`Required: ${tk.required.length}. Optional: ${tk.optional.length}.`);
+        lines.push('');
+        const dtCats = Object.keys(tk.byCategory).sort();
+        for (const cat of dtCats) {
+          lines.push(`### ${cat} (${tk.byCategory[cat].length})`);
+          lines.push('');
+          for (const name of tk.byCategory[cat].sort()) lines.push(`- ${name}`);
+          lines.push('');
+        }
+        sub('Rules');
+        lines.push('1. This server never writes files. Build the new theme file\'s content from the above, then write it yourself with your own file tools — ask the user where it should go if it isn\'t obvious.');
+        lines.push('2. Keep the `:root, :root[data-theme="<new-name>"]` shape (the base theme above already has it) unless you are deliberately building a multi-theme-bundle entry, where `$standalone: false` applies instead.');
+        lines.push('3. Only change values that should actually differ for the new design — copy everything else from the base theme unchanged, including tokens you don\'t recognize.');
+        lines.push('4. Before calling it done: every required token listed above must still be present in the new file. If this repo is available locally, `node scripts/theme-validator.js <path-to-new-theme.css>` confirms it.');
+        break;
+      }
       case 'animations': {
         const a = getAnimations();
         banner('css-is-awesome — animations');
@@ -1175,7 +1209,7 @@ const handlers = {
         break;
       }
       default:
-        throw new Error(`assemble_prompt: unknown intent "${intent}". Try overview | mixin:<name> | component:<name> | theme:<name> | tokens | animations | recipe:<name>.`);
+        throw new Error(`assemble_prompt: unknown intent "${intent}". Try overview | mixin:<name> | component:<name> | theme:<name> | derive-theme:<base> | tokens | animations | recipe:<name>.`);
     }
 
     if (args && typeof args === 'string' && args.trim()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "css-is-awesome",
-  "version": "1.12.1",
+  "version": "1.13.1",
   "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": {