@devground/ui-conventions 0.1.0 → 0.2.0

package/lib/copy-guarded.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+/**
+ * Copies a directory tree, never overwriting a file that already exists at the
+ * destination.
+ *
+ * This guard is the package's core promise: re-running the installer after an
+ * upgrade pulls in new files without clobbering local edits to a skill. It lives
+ * in its own module (rather than inline in `setup.js`) so it can be tested —
+ * `setup.js` runs its work at import time, so anything defined there is
+ * untestable without executing the installer.
+ *
+ * @param {string} src Source directory.
+ * @param {string} dst Destination directory (created if missing).
+ * @returns {{ written: number, skipped: number }} Files copied vs. left alone.
+ */
+function copyDirGuarded(src, dst) {
+  fs.mkdirSync(dst, { recursive: true });
+  let written = 0;
+  let skipped = 0;
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const dstPath = path.join(dst, entry.name);
+
+    if (entry.isDirectory()) {
+      const sub = copyDirGuarded(srcPath, dstPath);
+      written += sub.written;
+      skipped += sub.skipped;
+    } else if (entry.isFile()) {
+      if (fs.existsSync(dstPath)) {
+        skipped++;
+      } else {
+        fs.copyFileSync(srcPath, dstPath);
+        written++;
+      }
+    }
+  }
+
+  return { written, skipped };
+}
+
+module.exports = { copyDirGuarded };

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@devground/ui-conventions",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "UI convention skill for Claude Code — loads a project's frontend conventions (own components vs browser primitives, es-CL input formatting for RUT/phone/currency, accessibility and focus, error/loading states, microinteractions) as context BEFORE generating or editing UI, with an optional per-project overlay.",
   "bin": {
     "devground-ui-conventions": "./setup.js"
   },
   "files": [
     "setup.js",
-    "skills/"
+    "skills/",
+    "lib/",
+    "!lib/*.test.js"
   ],
   "keywords": [
     "ui",
@@ -37,5 +39,19 @@
   "bugs": {
     "url": "https://github.com/elkisdm/devground/issues"
   },
-  "scripts": {}
+  "devground": {
+    "status": "supported",
+    "graduatedBy": "ADR-0032",
+    "graduatedAt": "2026-09-07"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "@devground/vitest-config": "0.3.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
 }

package/setup.js

@@ -26,29 +26,7 @@ function info(msg) {
   console.log(`  \x1b[36m→\x1b[0m ${msg}`);
 }
 
-/** Copies a tree, skipping files that already exist at the destination. */
-function copyDirGuarded(src, dst) {
-  fs.mkdirSync(dst, { recursive: true });
-  let written = 0;
-  let skipped = 0;
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const dstPath = path.join(dst, entry.name);
-    if (entry.isDirectory()) {
-      const sub = copyDirGuarded(srcPath, dstPath);
-      written += sub.written;
-      skipped += sub.skipped;
-    } else if (entry.isFile()) {
-      if (fs.existsSync(dstPath)) {
-        skipped++;
-      } else {
-        fs.copyFileSync(srcPath, dstPath);
-        written++;
-      }
-    }
-  }
-  return { written, skipped };
-}
+const { copyDirGuarded } = require('./lib/copy-guarded.js');
 
 const global = process.argv.includes('--global');
 const baseDir = global ? os.homedir() : process.cwd();