swatchkit 0.10.0 → 0.11.0

package/build.js

@@ -182,6 +182,16 @@ function resolveSettings(cliOptions, fileConfig) {
 // Builds a list of all files that init manages.
 // Each entry maps a blueprint source to a project destination.
 // Used by both the actual init and the dry-run status report.
+// Returns the next available backup path for a file.
+// e.g. foo.css → foo.css.bak, then foo.css.bak2, foo.css.bak3, etc.
+function getBackupPath(filePath) {
+  const candidate = `${filePath}.bak`;
+  if (!fs.existsSync(candidate)) return candidate;
+  let i = 2;
+  while (fs.existsSync(`${filePath}.bak${i}`)) i++;
+  return `${filePath}.bak${i}`;
+}
+
 function buildInitManifest(settings) {
   const manifest = [];
   const blueprintsDir = path.join(__dirname, "src/blueprints");
@@ -364,6 +374,12 @@ function runInit(settings, options) {
     }
   }
 
+  // Files that are auto-generated by SwatchKit — never back these up
+  const swatchkitOwned = [
+    path.join(settings.cssDir, "global", "tokens.css"),
+    path.join(settings.cssDir, "utilities", "tokens.css"),
+  ];
+
   // Copy all manifest files
   const manifest = buildInitManifest(settings);
   for (const entry of manifest) {
@@ -375,6 +391,13 @@ function runInit(settings, options) {
         fs.mkdirSync(parentDir, { recursive: true });
       }
 
+      // Back up existing user-owned files before overwriting with --force
+      if (exists && options.force && !swatchkitOwned.includes(entry.dest)) {
+        const backupPath = getBackupPath(entry.dest);
+        fs.copyFileSync(entry.dest, backupPath);
+        console.log(`  ~ Backed up: ${path.relative(cwd, entry.dest)} → ${path.basename(backupPath)}`);
+      }
+
       let content = fs.readFileSync(entry.src, "utf-8");
       if (entry.transform) content = entry.transform(content);
       fs.writeFileSync(entry.dest, content);
@@ -863,7 +886,10 @@ Options:
   -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
+  -f, --force     Overwrite all blueprint files with latest SwatchKit versions.
+                  Your existing files are backed up as .bak/.bak2 etc. before
+                  overwriting. Only css/global/tokens.css and
+                  css/utilities/tokens.css are excluded (auto-generated).
       --dry-run   Show what init would create or change, without writing
   -h, --help      Show this help message
   -v, --version   Show version number`);

package/package.json

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