@csszyx/mcp-server 0.10.3 → 0.10.5

package/llms-full.txt

@@ -3588,10 +3588,11 @@ Helper build-time/runtime:
   class not already in the built CSS.
 
 Safelist requires a statically analyzable position (a literal sz, or a szv config
-literal). File-discovery gap: the prescan only scans files containing `sz=`/`sz:`,
-so a standalone szv-config file (no JSX) is skipped → co-locate szv in the
-component file that has a `sz=` usage. For a sibling workspace package, opt it in
-with `compilePackages: ['name']`.
+literal). File discovery: the prescan scans any file containing `sz=`/`sz:` or a
+`szv(` declaration, so a standalone szv-config file (no JSX) is still scanned.
+Co-locating szv in the component file is the recommended layout (tree-shaking
+unit). For a sibling workspace package, opt it in with
+`compileSources: ['packages/name']`.
 
 Tree-shaking is content-presence (same as Tailwind), not import-graph. Co-locating
 szv makes the component the shaking unit.
@@ -3707,16 +3708,22 @@ Or exclude the file from csszyx processing entirely before parsing:
 ...csszyx({ exclude: ['src/generated/**', /icon-dump\.tsx$/] })
 ```
 
-## Monorepo Workspace Packages (compilePackages)
+## Monorepo Workspace Sources (compileSources)
 
 `/packages/` is hard-ignored by default (a published library ships pre-extracted
-CSS). To compile `sz` in a monorepo workspace package you author, opt it in by
-directory name — only `/packages/` is relaxed, `node_modules`/`.next` stay ignored:
+CSS) and only the build root is pre-scanned. To compile `sz`/`szv` in a monorepo
+design-system you author — under `/packages/` or a sibling outside the build root
+— opt it in BY PATH. Paths resolve like Vite config paths (relative to
+`config.root`); pnpm symlinks matched after realpath; `node_modules`/`.next` stay
+ignored unless a path points into them:
 
 ```js
-...csszyx({ compilePackages: ['vui'] }) // compiles sz in /packages/vui/**
+...csszyx({ compileSources: ['packages/vui', '../libs/ui'] })
 ```
 
+A non-`/packages/` lib INSIDE the build root needs no config (compiled + scanned
+automatically); `compileSources` is for `/packages/` or sources OUTSIDE the root.
+
 A `/packages/` file with `sz` that is not opted in is skipped silently (no CSS);
 csszyx warns at build end and lists those files.
 
@@ -3761,10 +3768,25 @@ npx @csszyx/cli migrate src/           # migrate all JSX/TSX/HTML under src/
 npx @csszyx/cli migrate --dry-run      # preview changes without writing files
 npx @csszyx/cli migrate --ignore "**/*.test.tsx,**/fixtures/**"
 npx @csszyx/cli migrate --pattern "src/components/**/*.tsx"
+npx @csszyx/cli migrate --keys-only    # upgrade existing csszyx code: normalize sz KEYS only, leave className untouched
 ```
 
 Migration logs are written to `.csszyx/logs/`. Add `.csszyx/` to `.gitignore`.
 
+### `--keys-only` — upgrade existing csszyx code (not a Tailwind→sz migration)
+
+Plain `migrate` converts Tailwind `className` strings into `sz` props — for
+adopting csszyx. If you ALREADY use csszyx and are bumping a version that renamed
+sz-prop keys to their canonical form (e.g. the 0.9.10 → 0.10.0 key normalization),
+use `--keys-only`: it rewrites legacy sz-prop keys to canonical inside `sz={...}`
+and leaves `className` (and everything else) completely untouched. It only edits
+JSX/TSX (HTML has no sz objects). This is the safe, surgical upgrade path — it
+won't touch your hand-written classes.
+
+```bash
+npx @csszyx/cli migrate --keys-only --dry-run   # preview the key rewrites first
+```
+
 ### Audit — discover unrecognized classes
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csszyx/mcp-server",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "Model Context Protocol (MCP) server for csszyx — enables AI agents to understand and generate sz props",
   "license": "MIT",
   "type": "module",
@@ -30,9 +30,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.8",
-    "@csszyx/compiler": "0.10.3",
-    "@csszyx/cli": "0.10.3",
-    "@csszyx/unplugin": "0.10.3"
+    "@csszyx/cli": "0.10.5",
+    "@csszyx/unplugin": "0.10.5",
+    "@csszyx/compiler": "0.10.5"
   },
   "devDependencies": {
     "typescript": "^6.0.3",