@techninja/clearstack 0.4.11 → 0.4.13

package/lib/spec-config.js

@@ -67,8 +67,9 @@ export const FAST_CHECKS = new Set(['lines', 'docs', 'imports', 'i18n', 'tests']
 
 /**
  * Build ext→keys map, merging EXT_DEFAULTS with `watchExts` declared on extension checks.
+ * Checks may also declare `watchPaths: string[]` to scope triggers to specific path prefixes.
  * @param {object[]} checks
- * @returns {(ext: string) => string[]}
+ * @returns {(ext: string, filepath?: string) => string[]}
  */
 export function makeExtMap(checks) {
   const map = new Map(Object.entries(EXT_DEFAULTS).map(([k, v]) => [k, new Set(v)]));
@@ -79,7 +80,17 @@ export function makeExtMap(checks) {
       map.get(ext).add(c.key);
     }
   }
-  return (ext) => [...(map.get(ext) ?? [])];
+  const pathScoped = checks.filter((c) => c.watchPaths?.length);
+  return (ext, filepath) => {
+    let keys = [...(map.get(ext) ?? [])];
+    if (filepath && pathScoped.length) {
+      keys = keys.filter((k) => {
+        const c = pathScoped.find((p) => p.key === k);
+        return !c || c.watchPaths.some((p) => filepath.startsWith(p));
+      });
+    }
+    return keys;
+  };
 }
 
 /**

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-lifecycle.js

@@ -37,7 +37,7 @@ export function setupLifecycle(ctx) {
 
   for (const dir of watchDirs) {
     watch(resolve(projectDir, dir), { recursive: true }, (_event, filename) => {
-      if (filename) schedule(extname(filename));
+      if (filename) schedule(extname(filename), filename);
     });
   }
 

package/lib/watch-runner.js

@@ -61,9 +61,9 @@ let fixing = false;
 /**
  *
  */
-export function schedule(specRows, ctx, pending, timers, run, checksForExt, ext) {
+export function schedule(specRows, ctx, pending, timers, run, checksForExt, ext, filepath) {
   if (fixing) return;
-  for (const k of checksForExt(ext)) {
+  for (const k of checksForExt(ext, filepath)) {
     const row = specRows.find((r) => r.key === k);
     if (row) row.pass = null;
     if (FAST_CHECKS.has(k)) pending.fast.add(k);

package/lib/watch.js

@@ -62,7 +62,7 @@ export async function startWatch(projectDir) {
 
   setupLifecycle({
     serverRow, specRows, projectDir, watchDirs,
-    schedule: (ext) => schedule(specRows, ctx, pending, timers, run, checksForExt, ext),
+    schedule: (ext, filepath) => schedule(specRows, ctx, pending, timers, run, checksForExt, ext, filepath),
     renderNote: () => renderNote(rows, lastCheck.value, watchDirs),
   });
 }

package/package.json

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