swatchkit 0.8.1 → 0.9.1

package/README.md

@@ -266,6 +266,8 @@ swatchkit [command] [options]
 | `--outDir`  | `-o`  | Output directory (Default: `dist/swatchkit`).                   |
 | `--force`   | `-f`  | Overwrite all init-managed files with latest blueprints.        |
 | `--dry-run` |       | Show what init would create or change, without writing anything.|
+| `--help`    | `-h`  | Show help message.                                              |
+| `--version` | `-v`  | Show version number.                                            |
 
 ## Configuration
 
@@ -379,6 +381,10 @@ In watch mode, SwatchKit detects when its output directory is deleted by an exte
 
 SwatchKit only ever writes inside its own output subdirectory — it will never modify or delete other files in `dist/`.
 
+### Watch mode and file watchers
+
+SwatchKit generates files into your source tree during each build — CSS token files (`css/global/tokens.css`, `css/utilities/tokens.css`) and token documentation HTML (`swatchkit/tokens/*.html`). To avoid triggering external file watchers unnecessarily, SwatchKit compares generated content against the existing file and **skips the write when nothing has changed**. This means most rebuilds (e.g., editing an HTML swatch) won't touch your CSS directory at all, preventing infinite rebuild loops when running alongside tools like `onchange`, `chokidar`, or framework dev servers that watch `src/`.
+
 ## Acknowledgements
 
 The CSS compositions included by default in SwatchKit are adapted from [Every Layout](https://every-layout.dev/) by Heydon Pickering and Andy Bell. Highly recommend their documentation for a deep dive into their brilliant CSS techniques.

package/build.js

@@ -28,6 +28,10 @@ function parseArgs(args) {
       options.command = "init";
     } else if (arg === "-w" || arg === "--watch") {
       options.watch = true;
+    } else if (arg === "-h" || arg === "--help") {
+      options.command = "help";
+    } else if (arg === "-v" || arg === "--version") {
+      options.command = "version";
     } else if (arg === "-f" || arg === "--force") {
       options.force = true;
     } else if (arg === "--dry-run") {
@@ -838,9 +842,46 @@ function watch(settings) {
   }, 2000);
 }
 
+// --- 7. Help & Version ---
+function printVersion() {
+  const pkg = require(path.join(__dirname, "package.json"));
+  console.log(pkg.version);
+}
+
+function printHelp() {
+  const pkg = require(path.join(__dirname, "package.json"));
+  console.log(`SwatchKit v${pkg.version}
+
+Usage: swatchkit [command] [options]
+
+Commands:
+  (default)    Build the pattern library
+  init         Scaffold layout, tokens, and CSS blueprints
+
+Options:
+  -w, --watch     Watch files and rebuild on change
+  -c, --config    Path to config file
+  -i, --input     Pattern directory (default: swatchkit/)
+  -o, --outDir    Output directory (default: dist/swatchkit)
+  -f, --force     Overwrite all init-managed files with latest blueprints
+      --dry-run   Show what init would create or change, without writing
+  -h, --help      Show this help message
+  -v, --version   Show version number`);
+}
+
 // --- Main Execution ---
 try {
   const cliOptions = parseArgs(process.argv);
+
+  if (cliOptions.command === "help") {
+    printHelp();
+    process.exit(0);
+  }
+  if (cliOptions.command === "version") {
+    printVersion();
+    process.exit(0);
+  }
+
   const fileConfig = loadConfig(cliOptions.config);
   const settings = resolveSettings(cliOptions, fileConfig);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swatchkit",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "A lightweight tool for creating HTML pattern libraries.",
   "main": "build.js",
   "bin": {