css-is-awesome 1.13.1 → 1.14.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.14.0](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.13.2...v1.14.0) (2026-09-11)
+
+
+### Features
+
+* **mcp:** add validate_theme tool — the real validator, exposed as a tool call ([7a8b497](https://github.com/Jerry2d3d/css-is-awesome/commit/7a8b4971640f6fd6b13148f05288e9e3e76ade10))
+
+## [1.13.2](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.13.1...v1.13.2) (2026-09-11)
+
+
+### Bug Fixes
+
+* **themes:** fix theme-editor import losing the other mode's data (take 2) ([2d90aa9](https://github.com/Jerry2d3d/css-is-awesome/commit/2d90aa9cadfaae9ca285bcfbc8e668d81744b573))
+
 ## [1.13.1](https://github.com/Jerry2d3d/css-is-awesome/compare/v1.13.0...v1.13.1) (2026-09-11)
 
 

package/mcp/server.cjs

@@ -685,6 +685,19 @@ const handlers = {
     return { total: matches.length, items: matches };
   },
 
+  // Validates ANY theme CSS against the real token contract + a11y audit —
+  // not scoped to cia's own shipped themes. Works on cia's themes, a fully
+  // custom one built by an agent (e.g. via the derive-theme assemble_prompt
+  // intent), anything — whatever CSS text is passed in. Reuses the same
+  // validateText() the CLI (`npm run validate-themes`) calls, so a pass/fail
+  // here is exactly what `node scripts/theme-validator.js` would report,
+  // not a reimplementation that could quietly drift from it.
+  validate_theme({ css, label } = {}) {
+    if (!css || typeof css !== 'string') throw new Error('validate_theme: css is required');
+    const { validateText, loadContract } = require(path.join(SCRIPTS_DIR, 'theme-validator.js'));
+    return validateText(css, loadContract(), { label: label || undefined });
+  },
+
   // ─── Mixins ────────────────────────────────────────────────────────────
 
   list_mixins({ category, component, limit = 500, offset = 0 } = {}) {
@@ -1327,6 +1340,20 @@ async function startServer() {
     },
   }, async (a) => ok(handlers.search_themes(a || {})));
 
+  server.registerTool('validate_theme', {
+    description:
+      'Validate ANY theme CSS against cia\'s real token contract and WCAG contrast audit — the same check ' +
+      '`npm run validate-themes` runs, exposed as a tool call. Not scoped to cia\'s own themes: works on a ' +
+      'fully custom theme you (or another agent) just built, e.g. via the derive-theme assemble_prompt intent. ' +
+      'Pass compiled CSS (a :root or [data-theme="..."] block) — this does not compile Sass, so give it the ' +
+      'output, not .scss source. Returns missing required tokens (if any, mode "per-file" or "consolidated" ' +
+      'depending on shape) and a11y warnings per contrast pair.',
+    inputSchema: {
+      css: z.string().describe('Compiled theme CSS to validate — the :root/[data-theme] block(s), not .scss source.'),
+      label: z.string().optional().describe('Optional name for the result (e.g. the intended theme name); purely cosmetic.'),
+    },
+  }, async (a) => ok(handlers.validate_theme(a || {})));
+
   // Mixins
   server.registerTool('list_mixins', {
     description: `List all ${MIXIN_COUNT} public @mixins across core, layout, animation, icons, generator, per-component and recipe sources. Filter by category (core/layout/animation/icons/generator/component/recipe) or component name.`,

package/package.json

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

package/scripts/theme-validator.js

@@ -338,15 +338,22 @@ function validateTokenSet(declared, contract) {
 }
 
 // -----------------------------------------------------------
-// Validate a single file. Auto-detects per-file vs consolidated.
+// Validate raw CSS text. Auto-detects per-file vs consolidated.
 // Returns a unified result shape with either a flat pass/fail
 // (per-file) or a list of per-theme pass/fails (consolidated).
+//
+// `options.label` names the result (shown as `result.file`) and, in the
+// legacy per-file branch, seeds the a11y report's inferred theme name —
+// there's no real file path when validating text handed over directly
+// (e.g. from an MCP tool call), so callers that have one should pass it
+// as label; callers that don't get '(pasted CSS)'.
 // -----------------------------------------------------------
-function validateFile(filePath, contract, options) {
+function validateText(text, contract, options) {
   const opts = options || {};
   const wantA11y = opts.a11y !== false;
+  const label = opts.label || '(pasted CSS)';
   const result = {
-    file: filePath,
+    file: label,
     mode: 'per-file',
     ok: false,
     declaredCount: 0,
@@ -356,14 +363,6 @@ function validateFile(filePath, contract, options) {
     error: null,
   };
 
-  let text;
-  try {
-    text = fs.readFileSync(filePath, 'utf8');
-  } catch (err) {
-    result.error = err.message;
-    return result;
-  }
-
   if (isConsolidated(text)) {
     result.mode = 'consolidated';
     const blocks = extractDataThemeBlocks(text);
@@ -409,12 +408,33 @@ function validateFile(filePath, contract, options) {
   result.missing = v.missing;
   result.ok = v.ok;
   if (wantA11y) {
-    const inferredName = path.basename(path.dirname(filePath)) || path.basename(filePath, '.css');
+    const inferredName = label !== '(pasted CSS)' ? (path.basename(path.dirname(label)) || path.basename(label, '.css')) : 'theme';
     result.a11y = a11y.auditThemeTokens({ name: inferredName, values: root.values });
   }
   return result;
 }
 
+// Reads a file and delegates to validateText, with the file path as the
+// result's label (and a11y's inferred-name source in the legacy branch).
+function validateFile(filePath, contract, options) {
+  let text;
+  try {
+    text = fs.readFileSync(filePath, 'utf8');
+  } catch (err) {
+    return {
+      file: filePath,
+      mode: 'per-file',
+      ok: false,
+      declaredCount: 0,
+      missing: [],
+      themes: null,
+      a11y: null,
+      error: err.message,
+    };
+  }
+  return validateText(text, contract, Object.assign({}, options, { label: filePath }));
+}
+
 // -----------------------------------------------------------
 // Reporter
 // -----------------------------------------------------------
@@ -665,6 +685,7 @@ module.exports = {
   extractDataThemeBlocks,
   isConsolidated,
   validateFile,
+  validateText,
   loadContract,
   a11y: a11y,
 };