swatchkit 0.8.0 → 0.9.0

package/README.md

@@ -38,7 +38,10 @@ my-project/
 │       └── ...
 └── dist/
     └── swatchkit/          # Built pattern library
-        └── index.html
+        ├── index.html
+        ├── js/
+        │   └── swatches.js # Bundled swatch scripts
+        └── preview/        # Full-screen preview pages
 ```
 
 ---
@@ -220,6 +223,7 @@ Compiles your documentation site into `dist/swatchkit/`.
 2.  **Generates CSS**: Creates `css/tokens.css`. **Do not edit this file**; it is overwritten every build.
 3.  **Copies Assets**: Copies your `css/` folder (including your manually edited `global-styles.css` and `main.css`) to the output folder.
 4.  **Scans Patterns**: Finds all HTML files in `swatchkit/` and stitches them into the documentation site.
+5.  **Bundles JavaScript**: Collects any `.js` files from swatch folders (e.g., `swatchkit/carousel/script.js`) and section directories into a single `js/swatches.js` bundle. The default token display script (`swatchkit/tokens/script.js`) is included here — it shows computed CSS values alongside token documentation.
 
 ### Global Styles & Variables
 SwatchKit includes sensible defaults in `css/variables.css` and `css/global-styles.css`.
@@ -262,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
 

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.0",
+  "version": "0.9.0",
   "description": "A lightweight tool for creating HTML pattern libraries.",
   "main": "build.js",
   "bin": {