@techninja/clearstack 0.2.7 → 0.2.16

package/lib/check.js

@@ -20,7 +20,7 @@ function loadConfig(projectDir) {
     docsMax: parseInt(env.SPEC_DOCS_MAX_LINES) || 500,
     codeExt: (env.SPEC_CODE_EXTENSIONS || '.js,.css').split(','),
     docsExt: (env.SPEC_DOCS_EXTENSIONS || '.md').split(','),
-    ignore: (env.SPEC_IGNORE_DIRS || 'node_modules,public/vendor,.git,.configs').split(','),
+    ignore: (env.SPEC_IGNORE_DIRS || 'node_modules,src/public/vendor,.git,.configs').split(','),
   };
 }
 

package/lib/package-gen.js

@@ -20,9 +20,11 @@ export async function writePackageJson(dest, vars, existing) {
     ...(isFullstack ? {
       start: 'node src/server.js',
       dev: 'node --watch --env-file=.env src/server.js',
-    } : {}),
-    postinstall: 'node scripts/vendor-deps.js && node scripts/build-icons.js',
-    test: 'node --test tests/*.test.js src/utils/*.test.js src/store/*.test.js',
+    } : {
+      dev: 'npx serve src',
+    }),
+    postinstall: 'node scripts/setup.js',
+    test: 'node scripts/test.js',
     spec: 'clearstack',
   };
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@techninja/clearstack",
-  "version": "0.2.7",
+  "version": "0.2.16",
   "type": "module",
   "description": "A no-build web component framework specification — scaffold, validate, and evolve spec-compliant projects",
   "bin": {
-    "clearstack": "./bin/cli.js"
+    "clearstack": "bin/cli.js"
   },
   "files": [
     "bin/",
@@ -28,6 +28,9 @@
     "release": "node scripts/release.js",
     "prepublishOnly": "node scripts/sync-docs.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "web-components",
     "no-build",

package/templates/fullstack/src/server.js

@@ -10,16 +10,16 @@ import { eventsRouter } from './api/events.js';
 const app = express();
 
 app.use(express.json());
-app.use(express.static('public'));
-app.use('/src', express.static('src'));
 
 app.use('/api', eventsRouter);
 app.use('/api', entityRouter);
 
+app.use(express.static('src'));
+
 // SPA fallback
 app.use((req, res, next) => {
-  if (req.method === 'GET' && !req.path.includes('.')) {
-    return res.sendFile('index.html', { root: 'public' });
+  if (req.method === 'GET' && !req.path.includes('.') && !req.path.startsWith('/api')) {
+    return res.sendFile('index.html', { root: 'src/public' });
   }
   next();
 });

package/templates/shared/.configs/eslint.config.js

@@ -58,7 +58,7 @@ export default [
     },
   },
   {
-    ignores: ['node_modules/', 'public/vendor/'],
+    ignores: ['node_modules/', 'src/public/vendor/'],
   },
   prettier,
 ];

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

@@ -19,7 +19,7 @@
   ],
   "exclude": [
     "../node_modules",
-    "../public/vendor",
+    "../src/public/vendor",
     "../**/*.test.js"
   ]
 }

package/templates/shared/.env

@@ -3,7 +3,7 @@ SPEC_CODE_MAX_LINES=150
 SPEC_DOCS_MAX_LINES=500
 SPEC_CODE_EXTENSIONS=.js,.css
 SPEC_DOCS_EXTENSIONS=.md
-SPEC_IGNORE_DIRS=node_modules,public/vendor,.git,.configs
+SPEC_IGNORE_DIRS=node_modules,src/public/vendor,.git,.configs
 
 # Server
 PORT={{port}}

package/templates/shared/.github/workflows/spec.yml

@@ -12,9 +12,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v5
         with:
           node-version: 20
           cache: npm

package/templates/shared/gitignore

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

package/templates/shared/scripts/build-icons.js

@@ -12,7 +12,7 @@ import { fileURLToPath } from 'node:url';
 
 const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const ICONS_DIR = resolve(ROOT, 'node_modules/lucide-static/icons');
-const OUT = resolve(ROOT, 'public/icons.json');
+const OUT = resolve(ROOT, 'src/public/icons.json');
 
 /** Icons used in the app — lucide name → app name */
 const ICON_MAP = {
@@ -83,4 +83,4 @@ for (const [lucideName, appName] of Object.entries(ICON_MAP)) {
 }
 
 writeFileSync(OUT, JSON.stringify(icons, null, 2));
-console.log(`✓ Built ${count} icons → public/icons.json`);
+console.log(`✓ Built ${count} icons → src/public/icons.json`);

package/templates/shared/scripts/setup.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install setup — vendors dependencies and builds icon sprite.
+ * @module scripts/setup
+ */
+
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+
+await import(resolve(ROOT, 'scripts/vendor-deps.js'));
+await import(resolve(ROOT, 'scripts/build-icons.js'));

package/templates/shared/scripts/test.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+/**
+ * Test runner — finds and executes all .test.js files.
+ * @module scripts/test
+ */
+
+import { execSync } from 'node:child_process';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readdirSync, statSync } from 'node:fs';
+
+const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+
+/** @param {string} dir @returns {string[]} */
+function findTests(dir) {
+  const results = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = resolve(dir, entry.name);
+    if (entry.name === 'node_modules' || entry.name === 'public') continue;
+    if (entry.isDirectory()) results.push(...findTests(full));
+    else if (entry.name.endsWith('.test.js')) results.push(full);
+  }
+  return results;
+}
+
+const files = findTests(ROOT);
+if (files.length === 0) {
+  console.log('No test files found.');
+  process.exit(0);
+}
+
+try {
+  execSync(`node --test ${files.join(' ')}`, { cwd: ROOT, stdio: 'inherit' });
+} catch {
+  process.exit(1);
+}

package/templates/shared/scripts/vendor-deps.js

@@ -10,7 +10,7 @@ import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
-const VENDOR_DIR = resolve(ROOT, 'public/vendor');
+const VENDOR_DIR = resolve(ROOT, 'src/public/vendor');
 
 /** @type {{ name: string, src: string }[]} */
 const DEPS = [{ name: 'hybrids', src: 'node_modules/hybrids/src' }];
@@ -21,5 +21,5 @@ for (const dep of DEPS) {
   const src = resolve(ROOT, dep.src);
   const dest = resolve(VENDOR_DIR, dep.name);
   cpSync(src, dest, { recursive: true });
-  console.log(`✓ Vendored: ${dep.name} → public/vendor/${dep.name}/`);
+  console.log(`✓ Vendored: ${dep.name} → src/public/vendor/${dep.name}/`);
 }

package/templates/shared/src/public/index.html

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{name}}</title>
+  <link rel="stylesheet" href="/styles/reset.css">
+  <link rel="stylesheet" href="/styles/tokens.css">
+  <link rel="stylesheet" href="/styles/shared.css">
+  <link rel="stylesheet" href="/styles/buttons.css">
+  <link rel="stylesheet" href="/styles/forms.css">
+  <link rel="stylesheet" href="/styles/components.css">
+
+  <script type="importmap">
+  {
+    "imports": {
+      "hybrids": "/public/vendor/hybrids/index.js"
+    }
+  }
+  </script>
+</head>
+<body>
+  <app-router></app-router>
+  <script type="module" src="/router/index.js"></script>
+</body>
+</html>

package/templates/shared/public/index.html

@@ -1,26 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>{{name}}</title>
-  <link rel="stylesheet" href="/src/styles/reset.css">
-  <link rel="stylesheet" href="/src/styles/tokens.css">
-  <link rel="stylesheet" href="/src/styles/shared.css">
-  <link rel="stylesheet" href="/src/styles/buttons.css">
-  <link rel="stylesheet" href="/src/styles/forms.css">
-  <link rel="stylesheet" href="/src/styles/components.css">
-
-  <script type="importmap">
-  {
-    "imports": {
-      "hybrids": "/vendor/hybrids/index.js"
-    }
-  }
-  </script>
-</head>
-<body>
-  <app-router></app-router>
-  <script type="module" src="/src/router/index.js"></script>
-</body>
-</html>