@techninja/clearstack 0.2.4 → 0.2.6

package/lib/copy.js

@@ -3,11 +3,17 @@
  * @module lib/copy
  */
 
-import { readdirSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 
 const TEMPLATE_RE = /\{\{(\w+)\}\}/g;
 
+/** Files renamed during copy (npm strips .gitignore from packages). */
+const RENAME = { gitignore: '.gitignore' };
+
+/** Files that merge (append missing lines) instead of overwriting. */
+const MERGE = new Set(['.gitignore']);
+
 /**
  * Recursively copy a template directory, replacing {{vars}} in file contents.
  * @param {string} templateRoot - Root templates/ directory
@@ -29,7 +35,8 @@ async function copyDir(src, dest, vars) {
   mkdirSync(dest, { recursive: true });
   for (const entry of readdirSync(src, { withFileTypes: true })) {
     const srcPath = join(src, entry.name);
-    const destPath = join(dest, entry.name);
+    const destName = RENAME[entry.name] || entry.name;
+    const destPath = join(dest, destName);
     if (entry.isDirectory()) {
       await copyDir(srcPath, destPath, vars);
     } else {
@@ -37,7 +44,27 @@ async function copyDir(src, dest, vars) {
       const replaced = content.replace(TEMPLATE_RE, (_, key) =>
         vars[key] !== undefined ? String(vars[key]) : `{{${key}}}`,
       );
-      writeFileSync(destPath, replaced);
+      if (MERGE.has(destName) && existsSync(destPath)) {
+        mergeLines(destPath, replaced);
+      } else {
+        writeFileSync(destPath, replaced);
+      }
     }
   }
 }
+
+/**
+ * Append lines from source that don't already exist in the destination file.
+ * @param {string} destPath
+ * @param {string} newContent
+ */
+function mergeLines(destPath, newContent) {
+  const existing = readFileSync(destPath, 'utf-8');
+  const existingLines = new Set(existing.split('\n').map((l) => l.trim()));
+  const toAdd = newContent.split('\n')
+    .filter((l) => l.trim() && !existingLines.has(l.trim()));
+  if (toAdd.length > 0) {
+    const sep = existing.endsWith('\n') ? '' : '\n';
+    writeFileSync(destPath, existing + sep + toAdd.join('\n') + '\n');
+  }
+}

package/lib/package-gen.js

@@ -43,6 +43,7 @@ export async function writePackageJson(dest, vars, existing) {
 
   const specDevDeps = {
     '@techninja/clearstack': '^0.2.0',
+    '@types/node': '^22.0.0',
     '@open-wc/testing': '^4.0.0',
     '@web/test-runner': '^0.20.0',
     '@web/test-runner-playwright': '^0.11.0',

package/lib/update.js

@@ -57,6 +57,22 @@ export async function update(pkgRoot) {
     '.configs',
   );
 
+  // Merge .gitignore (append missing lines, never remove user entries)
+  const gitignoreSrc = resolve(templateShared, 'gitignore');
+  if (existsSync(gitignoreSrc)) {
+    const destPath = resolve(process.cwd(), '.gitignore');
+    const srcLines = readFileSync(gitignoreSrc, 'utf-8').split('\n').filter((l) => l.trim());
+    const existing = existsSync(destPath) ? readFileSync(destPath, 'utf-8') : '';
+    const existingSet = new Set(existing.split('\n').map((l) => l.trim()));
+    const toAdd = srcLines.filter((l) => !existingSet.has(l.trim()));
+    if (toAdd.length > 0) {
+      const sep = existing.endsWith('\n') ? '' : '\n';
+      writeFileSync(destPath, existing + sep + toAdd.join('\n') + '\n');
+      console.log(`  ✓ Merged: .gitignore (+${toAdd.length} entries)`);
+      total++;
+    }
+  }
+
   // Write spec version marker
   const pkg = JSON.parse(readFileSync(resolve(pkgRoot, 'package.json'), 'utf-8'));
   const versionPath = resolve(process.cwd(), 'docs/clearstack/.specversion');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techninja/clearstack",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "description": "A no-build web component framework specification — scaffold, validate, and evolve spec-compliant projects",
   "bin": {

package/templates/shared/.configs/jsconfig.json

@@ -8,6 +8,7 @@
     "noEmit": true,
     "strict": false,
     "skipLibCheck": true,
+    "types": ["node"],
     "paths": {
       "hybrids": ["../node_modules/hybrids/types/index.d.ts"]
     }

package/templates/shared/gitignore

@@ -0,0 +1,5 @@
+node_modules/
+public/vendor/
+public/icons.json
+data/db.json
+.env.local

package/templates/static/src/pages/home/home-view.js

@@ -26,7 +26,8 @@ export default define({
       <div class="home-view">
         <h1>{{name}}</h1>
         <p>Your Clearstack project is ready. Start building!</p>
-        ${store.ready(state) && html`
+        ${store.ready(state) &&
+        html`
           <p>Count: ${state.count}</p>
           <button class="btn btn-primary" onclick="${increment}">Increment</button>
           <p class="hint">State persists in localStorage — refresh to verify.</p>