@techninja/clearstack 0.4.1 → 0.4.3

package/bin/cli.js

@@ -62,7 +62,7 @@ async function run(action) {
   } else if (action === 'check') {
     const subs = args.filter((a) => a !== cmd && !a.startsWith('-'));
     const { check } = await import('../lib/check.js');
-    await check(process.cwd(), subs.join(' ') || undefined);
+    await check(process.cwd(), subs.join(' ') || undefined, { verbose: !!flags.verbose });
   } else if (action === 'report') {
     const { report } = await import('../lib/report.js');
     report(process.cwd(), { json: !!flags.json });

package/lib/check.js

@@ -14,7 +14,7 @@ export { checkFileLines, runCmd, countFiles, findFiles, elapsed, checkImports }
 export { checkI18n } from './spec-i18n.js';
 export { loadConfig, buildCmds, detectRunner } from './spec-config.js';
 
-/** @typedef {{ key: string, name: string, parent?: string, run: () => boolean }} Check */
+/** @typedef {{ key: string, name: string, parent?: string, run: (opts?: object) => boolean }} Check */
 
 /** Find all jsconfig.json files — main config + subdirectories. */
 function findTypeConfigs(dir, runner) {
@@ -53,7 +53,7 @@ export function buildChecks(dir, cfg, cmds) {
     { key: 'lines', name: `Code (max ${cfg.codeMax} lines)`, parent: 'code',
       run: () => checkFileLines(dir, cfg.codeExt, cfg.codeMax, cfg.ignore, `Code (max ${cfg.codeMax} lines)`, { exclude: cfg.testPattern }).pass },
     { key: 'i18n', name: 'i18n readiness', parent: 'code',
-      run: () => checkI18n(dir, cfg.ignore, 'i18n readiness').pass },
+      run: (runOpts) => checkI18n(dir, cfg.ignore, 'i18n readiness', runOpts).pass },
     { key: 'tests', name: `Tests (max ${cfg.testMax} lines)`,
       run: () => checkFileLines(dir, cfg.codeExt, cfg.testMax, cfg.ignore, `Tests (max ${cfg.testMax} lines)`, { include: cfg.testPattern }).pass },
     { key: 'docs', name: `Docs (max ${cfg.docsMax} lines)`,
@@ -85,7 +85,7 @@ export function parentKeys(checks) {
 }
 
 /** Run the full spec compliance check (used by clearstack CLI and scripts/spec.js). */
-export async function check(projectDir, scope) {
+export async function check(projectDir, scope, opts) {
   const cfg = loadConfig(projectDir);
   const cmds = buildCmds(projectDir);
   const checks = buildChecks(projectDir, cfg, cmds);
@@ -98,13 +98,13 @@ export async function check(projectDir, scope) {
       console.log(`Available: ${[...tops, ...parentKeys(checks)].join(', ')}`);
       process.exit(1);
     }
-    const ok = matched.every((c) => c.run());
+    const ok = matched.every((c) => c.run(opts));
     if (!ok) process.exit(1);
     return;
   }
 
   console.log('🔍 Clearstack compliance checking now... 💙\n');
-  const results = checks.map((c) => c.run());
+  const results = checks.map((c) => c.run(opts));
   const passed = results.filter(Boolean).length;
   console.log(`\n${'='.repeat(40)}`);
   console.log(`${passed}/${results.length} checks passed.`);

package/lib/spec-i18n.js

@@ -17,12 +17,15 @@ const LOC_RE = /\blocalize\s*\(/;
 const INIT_RE = /loadLocale|localize\s*\(/;
 const TPL_RE = /html`[\s\S]*?`/g;
 
+/** Strip leading > and trailing <$ from a prose match, trim. */
+const cleanHit = (h) => h.replace(/^>\s*/, '').replace(/\s*[<$]$/, '').trim();
+
 /**
  * Check i18n readiness — informational, always passes.
  * @param {string} root
  * @param {string[]} ignoreDirs
  * @param {string} label
- * @param {{ quiet?: boolean }} [opts]
+ * @param {{ quiet?: boolean, verbose?: boolean }} [opts]
  * @returns {CheckResult}
  */
 export function checkI18n(root, ignoreDirs, label, opts) {
@@ -41,6 +44,8 @@ export function checkI18n(root, ignoreDirs, label, opts) {
     hasInit = false,
     hardcodedHits = 0,
     templateFiles = 0;
+  /** @type {Array<{file: string, text: string, line: number}>} */
+  const verboseHits = [];
 
   for (const file of srcFiles) {
     const src = readFileSync(resolve(root, file), 'utf-8');
@@ -53,7 +58,17 @@ export function checkI18n(root, ignoreDirs, label, opts) {
       templateFiles++;
       for (const tpl of templates) {
         const hits = tpl.match(PROSE_RE);
-        if (hits) hardcodedHits += hits.length;
+        if (hits) {
+          hardcodedHits += hits.length;
+          if (opts?.verbose) {
+            for (const h of hits) {
+              const text = cleanHit(h);
+              const idx = src.indexOf(text);
+              const line = idx >= 0 ? src.slice(0, idx).split('\n').length : 0;
+              verboseHits.push({ file, text, line });
+            }
+          }
+        }
       }
     }
   }
@@ -71,19 +86,33 @@ export function checkI18n(root, ignoreDirs, label, opts) {
   const hasOverrides = localesDir ? existsSync(resolve(localesDir, 'overrides.json')) : false;
 
   const patternParts = [
-    usesT ? `t() ×${usesT}` : '',
-    usesMsg ? `msg\` ×${usesMsg}` : '',
-    usesLocalize ? `localize() ×${usesLocalize}` : '',
+    usesT ? `t() \u00d7${usesT}` : '',
+    usesMsg ? `msg\` \u00d7${usesMsg}` : '',
+    usesLocalize ? `localize() \u00d7${usesLocalize}` : '',
   ].filter(Boolean);
 
   const time = elapsed(start);
   if (!opts?.quiet) {
-    const icon = patternParts.length ? '✅' : '⚠️ ';
+    const icon = patternParts.length ? '\u2705' : '\u26a0\ufe0f ';
     const pattern = patternParts.length ? patternParts.join(', ') : 'none detected';
     const langs = languages.length ? languages.join(', ') : 'en only';
-    const init = `${hasInit ? 'yes' : 'not detected'} · Overrides: ${hasOverrides ? 'yes' : 'no'} · Languages: ${langs}`;
+    const init = `${hasInit ? 'yes' : 'not detected'} \u00b7 Overrides: ${hasOverrides ? 'yes' : 'no'} \u00b7 Languages: ${langs}`;
     const unwrapped = hardcodedHits > 0 ? `\n     Unwrapped: ~${hardcodedHits} prose strings across ${templateFiles} template files` : '';
     console.log(`  ${icon} ${label} (${time})\n     Pattern:   ${pattern}\n     Init:      ${init}${unwrapped}`);
+    if (opts?.verbose && verboseHits.length) {
+      console.log('');
+      const byFile = {};
+      for (const v of verboseHits) {
+        (byFile[v.file] ||= []).push(v);
+      }
+      for (const [file, entries] of Object.entries(byFile)) {
+        console.log(`     ${file}`);
+        for (const e of entries) {
+          const truncated = e.text.length > 60 ? e.text.slice(0, 60) + '\u2026' : e.text;
+          console.log(`       L${e.line || '?'} ${truncated}`);
+        }
+      }
+    }
   }
 
   return { pass: true, label, time };

package/package.json

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