@techninja/clearstack 0.4.12 → 0.4.14

package/lib/check.js

@@ -98,7 +98,8 @@ export async function check(projectDir, scope, opts) {
     return;
   }
   console.log('🔍 Clearstack compliance checking now... 💙\n');
-  const results = await Promise.all(checks.map((c) => c.run(opts)));
+  const runnable = checks.filter((c) => !c.keyBinding);
+  const results = await Promise.all(runnable.map((c) => c.run(opts)));
   const passed = results.filter((r) => typeof r === 'boolean' ? r : r.pass).length;
   console.log(`\n${'='.repeat(40)}`);
   console.log(`${passed}/${results.length} checks passed.`);

package/lib/spec-scan.js

@@ -37,20 +37,25 @@ export function countFiles(root, extensions, ignoreDirs) {
   return findFiles(root, extensions, ignoreDirs, root).length;
 }
 
+/** @param {string} f @param {string | string[]} pat */
+function matchesPat(f, pat) {
+  return Array.isArray(pat) ? pat.some((p) => f.includes(p) || f.endsWith(p)) : f.endsWith(pat);
+}
+
 /**
  * @param {string} root
  * @param {string[]} extensions
  * @param {number} max
  * @param {string[]} ignoreDirs
  * @param {string} label
- * @param {{ exclude?: string, include?: string, localeMax?: number, quiet?: boolean }} [filter]
+ * @param {{ exclude?: string | string[], include?: string | string[], localeMax?: number, quiet?: boolean }} [filter]
  * @returns {CheckResult & { violations?: LineViolation[] }}
  */
 export function checkFileLines(root, extensions, max, ignoreDirs, label, filter) {
   const start = performance.now();
   let files = findFiles(root, extensions, ignoreDirs, root);
-  if (filter?.exclude) files = files.filter((f) => !f.endsWith(filter.exclude));
-  if (filter?.include) files = files.filter((f) => f.endsWith(filter.include));
+  if (filter?.exclude) files = files.filter((f) => !matchesPat(f, filter.exclude));
+  if (filter?.include) files = files.filter((f) => matchesPat(f, filter.include));
   const localeMax = filter?.localeMax || max * 5;
   const violations = [];
   for (const file of files) {
@@ -74,13 +79,15 @@ export function checkFileLines(root, extensions, max, ignoreDirs, label, filter)
  * @param {string} root
  * @param {string[]} ignoreDirs
  * @param {string} label
- * @param {{ quiet?: boolean }} [opts]
+ * @param {{ quiet?: boolean, ignore?: string[] }} [opts]
  * @returns {CheckResult & { violations?: ImportViolation[] }}
  */
 export function checkImports(root, ignoreDirs, label, opts) {
   const start = performance.now();
+  const extraIgnore = opts?.ignore ?? [];
   const files = findFiles(root, ['.js'], ignoreDirs, root)
-    .filter((f) => f.startsWith('src/') && !f.includes('vendor/') && !f.includes('api/') && !f.endsWith('.test.js') && !f.endsWith('server.js'));
+    .filter((f) => f.startsWith('src/') && !f.includes('vendor/') && !f.includes('api/') && !f.endsWith('.test.js') && !f.endsWith('server.js'))
+    .filter((f) => !extraIgnore.some((p) => f.includes(p)));
   const violations = [];
   const importRe = /(?:^|\n)\s*import\s.*?from\s+['"](\.\.[^'"]*)['"]/g;
   for (const file of files) {

package/lib/watch-widgets.js

@@ -61,6 +61,15 @@ export const setOnCopyNote = (fn) => { _onCopyNote = fn; };
 let _onFix = () => {};
 export const setOnFix = (fn) => { _onFix = fn; };
 
+/** @type {Array<{ key: string, label: string, fn: () => void }>} */
+let _keyCommands = [];
+export const setKeyCommands = (cmds) => {
+  _keyCommands = cmds;
+  for (const { key, fn } of cmds) screen.key([key], fn);
+  const extra = cmds.map(({ key, label }) => `  ${key} ${label}`).join('  ');
+  outer.setLabel(` {blue-fg}♥{/blue-fg} Clearstack Spec Watch  q quit  ↑↓ scroll  c copy  f fix${extra} `);
+};
+
 screen.key(['C-c', 'q'], () => _quit());
 screen.key(['pageup', 'up'], () => { logBox.scroll(-1); screen.render(); });
 screen.key(['pagedown', 'down'], () => { logBox.scroll(1); screen.render(); });

package/lib/watch.js

@@ -12,6 +12,7 @@ import { render, renderNote } from './watch-ui.js';
 import { spawnServer, detectServerCmd } from './server-proc.js';
 import { setupLifecycle } from './watch-lifecycle.js';
 import { runKeys, schedule, setupFix } from './watch-runner.js';
+import { screen, outer } from './watch-widgets.js';
 
 /**
  *
@@ -45,6 +46,16 @@ export async function startWatch(projectDir) {
 
   const run = (keys) => runKeys(specRows, keys, ctx);
 
+  // Wire keyBinding checks — project checks can declare keyBinding: 'd' etc.
+  const keyBound = specRows.filter((r) => r.keyBinding);
+  if (keyBound.length) {
+    const extra = keyBound.map(({ keyBinding, name }) => `  ${keyBinding} ${name.replace(/\s*\(.*\)/, '')}`).join('  ');
+    outer.setLabel(` {blue-fg}\u2665{/blue-fg} Clearstack Spec Watch  q quit  \u2191\u2193 scroll  c copy  f fix${extra} `);
+    for (const row of keyBound) {
+      screen.key([row.keyBinding], () => run(new Set([row.key])));
+    }
+  }
+
   if (serverCmd) {
     const proc = spawnServer(serverCmd, projectDir, cfg.rawEnv, () => {
       serverRow.status = proc.status;
@@ -56,7 +67,7 @@ export async function startWatch(projectDir) {
   }
 
   render(rows, lastCheck.value, watchDirs, currentViolations.value);
-  run(new Set(specRows.map((r) => r.key)));
+  run(new Set(specRows.filter((r) => !r.keyBinding).map((r) => r.key)));
 
   setupFix(specRows, cmds, ctx, pending, timers, run);
 

package/package.json

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