@csszyx/cli 0.10.10 → 0.10.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +42 -1
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -2,7 +2,8 @@
2
2
 
3
3
  > Command-line tools for CSSzyx.
4
4
 
5
- Review usage stats, diagnose issues, and initialize projects.
5
+ Initialize projects, migrate Tailwind classNames to `sz`, diagnose configuration
6
+ and mangling issues, and maintain the Next.js Turbopack safelist.
6
7
 
7
8
  ## Installation
8
9
 
@@ -30,6 +31,46 @@ Diagnose configuration and mangling issues.
30
31
  npx csszyx doctor
31
32
  ```
32
33
 
34
+ ### `check`
35
+
36
+ Scan the whole project for unknown or aliased `sz` keys — CI-friendly (non-zero
37
+ exit on findings).
38
+
39
+ ```bash
40
+ npx csszyx check
41
+ ```
42
+
43
+ ### `explain`
44
+
45
+ Print the Tailwind className an sz object compiles to — quick one-off checks
46
+ without a build.
47
+
48
+ ```bash
49
+ npx csszyx explain '{ p: 4, hover: { bg: "blue-500" } }'
50
+ # → p-4 hover:bg-blue-500
51
+ ```
52
+
53
+ ### `scan-collisions`
54
+
55
+ Find app-owned class names that could collide with a production mangle token
56
+ (short names like `x`, `y` in hand-written CSS of a hybrid Tailwind setup).
57
+ Feed the results to `production.mangleExclude`.
58
+
59
+ ```bash
60
+ npx csszyx scan-collisions --pattern "src/**/*.css"
61
+ ```
62
+
63
+ ### `next-prebuild` / `next-watch`
64
+
65
+ Maintain the Tailwind `@source` safelist for the Next.js Turbopack dev path:
66
+ `next-prebuild` seeds it before `next build --turbopack`; `next-watch` runs
67
+ beside `next dev --turbo` and keeps it fresh as sources change.
68
+
69
+ ```bash
70
+ npx csszyx next-prebuild
71
+ npx csszyx next-watch
72
+ ```
73
+
33
74
  ### `audit`
34
75
 
35
76
  View performance statistics and mangle compression rates.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@csszyx/cli",
3
- "version": "0.10.10",
3
+ "version": "0.10.12",
4
4
  "description": "Command-line tools for csszyx",
5
5
  "keywords": [
6
6
  "csszyx",
@@ -49,9 +49,9 @@
49
49
  "picocolors": "^1.0.0",
50
50
  "prompts": "^2.4.2",
51
51
  "tailwindcss": "^3.4.1",
52
- "@csszyx/compiler": "0.10.10",
53
- "@csszyx/unplugin": "0.10.10",
54
- "@csszyx/types": "0.10.10"
52
+ "@csszyx/types": "0.10.12",
53
+ "@csszyx/compiler": "0.10.12",
54
+ "@csszyx/unplugin": "0.10.12"
55
55
  },
56
56
  "devDependencies": {
57
57
  "@types/fs-extra": "^11.0.4",