@techninja/clearstack 0.4.25 → 0.4.26

package/lib/check.js

@@ -12,7 +12,7 @@ import { checkI18n } from './spec-i18n.js';
 import { loadConfig, buildCmds, detectRunner } from './spec-config.js';
 import { findTypeConfigs } from './spec-types.js';
 
-export { runCmd, elapsed } from './spec-utils.js';
+export { runCmd, runExtCmd, elapsed } from './spec-utils.js';
 export { findFiles, countFiles, checkFileLines, checkImports } from './spec-scan.js';
 export { checkI18n } from './spec-i18n.js';
 export { loadConfig, buildCmds, detectRunner } from './spec-config.js';

package/lib/spec-utils.js

@@ -49,3 +49,43 @@ export function runCmd(label, cmd, cwd, stats, opts) {
     return { pass: false, label, time: elapsed(start), errors: display };
   }
 }
+
+/**
+ * Run an arbitrary shell command for a custom extension check.
+ * Handles timing, output filtering, and consistent ✅/❌ printing.
+ * Ignores lines matching node_modules or any paths in `ignorePaths`.
+ * Use this in clearstack.spec.js extensions instead of execSync directly.
+ *
+ * @param {string} label - Display name for the check
+ * @param {string} cmd - Shell command to run
+ * @param {{ quiet?: boolean, cwd?: string, ignorePaths?: string[] }} [opts]
+ * @returns {CheckResult}
+ */
+export function runExtCmd(label, cmd, opts = {}) {
+  const start = performance.now();
+  const cwd = opts.cwd ?? process.cwd();
+  const suffix = () => ` (${elapsed(start)})`;
+  const ignoreRe = [
+    /[/\\]node_modules[/\\]/,
+    ...(opts.ignorePaths ?? []).map((p) => new RegExp(p.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))),
+  ];
+  try {
+    execSync(cmd, { cwd, stdio: 'pipe', encoding: 'utf-8' });
+    if (!opts.quiet) console.log(`  ✅ ${label}${suffix()}`);
+    return { pass: true, label, time: elapsed(start) };
+  } catch (err) {
+    const out = ((err.stdout || '') + (err.stderr || '')).trim();
+    const errors = out.split('\n')
+      .filter((l) => l.trim())
+      .filter((l) => !ignoreRe.some((re) => re.test(l)));
+    if (errors.length === 0) {
+      if (!opts.quiet) console.log(`  ✅ ${label}${suffix()}`);
+      return { pass: true, label, time: elapsed(start) };
+    }
+    if (!opts.quiet) {
+      console.log(`  ❌ ${label}${suffix()}`);
+      for (const line of errors) console.log(`     ${line}`);
+    }
+    return { pass: false, label, time: elapsed(start), errors };
+  }
+}

package/package.json

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