@liam-public/node-i18n-lint 0.1.0 → 0.2.0

package/README.md

@@ -21,6 +21,21 @@ src/pages/sources/SourcesPage.tsx:42:14  [jsx-text]  "No sources found."
 src/components/AddSourceDialog.tsx:31:20  [jsx-attribute:placeholder]  "https://example.com/feed.xml"
 ```
 
+## Baseline (adopt on a large codebase without fixing everything first)
+
+Lock in the existing backlog so CI only fails on **new** hardcoded strings:
+
+```bash
+# 1. record the current findings (run once, commit the file)
+i18n-lint --update-baseline --baseline .i18n-lint-baseline.json src
+
+# 2. in CI — passes unless a NEW string is introduced; baselined ones reduce as you fix them
+i18n-lint --baseline .i18n-lint-baseline.json src
+```
+
+The baseline keys findings by `path :: text` (not line/column), so it survives edits. Fixing a
+string and re-running `--update-baseline` shrinks the baseline — the backlog only goes down.
+
 ## Programmatic
 
 ```ts

package/dist/chunk-4NCNMJLG.js

@@ -0,0 +1,66 @@
+// src/scan.ts
+import ts from "typescript";
+var USER_FACING_ATTRS = /* @__PURE__ */ new Set([
+  "placeholder",
+  "title",
+  "alt",
+  "aria-label",
+  "aria-placeholder",
+  "aria-description",
+  "label"
+]);
+function findingKey(relativePath, finding) {
+  return `${relativePath} :: ${finding.text}`;
+}
+var hasLetters = (s) => /\p{L}/u.test(s);
+function isTranslatable(raw) {
+  const s = raw.trim();
+  if (!s) return false;
+  if (!hasLetters(s)) return false;
+  if (/^https?:\/\//i.test(s)) return false;
+  if (/^[a-z][a-zA-Z0-9]*$/.test(s) && s.length <= 2) return false;
+  if (/^[#.][\w-]+$/.test(s)) return false;
+  return true;
+}
+function scanSource(fileName, code) {
+  const sf = ts.createSourceFile(fileName, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+  const findings = [];
+  const ignoredLines = /* @__PURE__ */ new Set();
+  code.split("\n").forEach((lineText, i) => {
+    if (lineText.includes("i18n-ignore")) {
+      ignoredLines.add(i + 1);
+      ignoredLines.add(i + 2);
+    }
+  });
+  const at = (node) => {
+    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    return { line: line + 1, column: character + 1 };
+  };
+  const push = (node, text, kind, attribute) => {
+    const loc = at(node);
+    if (ignoredLines.has(loc.line)) return;
+    findings.push({ ...loc, text: text.trim(), kind, attribute });
+  };
+  const visit = (node) => {
+    if (ts.isJsxText(node)) {
+      if (isTranslatable(node.text)) push(node, node.text, "jsx-text");
+    } else if (ts.isJsxAttribute(node) && node.initializer && ts.isStringLiteral(node.initializer)) {
+      const name = node.name.getText(sf);
+      if (USER_FACING_ATTRS.has(name) && isTranslatable(node.initializer.text)) {
+        push(node.initializer, node.initializer.text, "jsx-attribute", name);
+      }
+    } else if (ts.isJsxExpression(node) && node.expression && ts.isStringLiteralLike(node.expression) && isTranslatable(node.expression.text)) {
+      push(node.expression, node.expression.text, "jsx-expression");
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  return findings;
+}
+
+export {
+  findingKey,
+  isTranslatable,
+  scanSource
+};
+//# sourceMappingURL=chunk-4NCNMJLG.js.map

package/dist/chunk-4NCNMJLG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scan.ts"],"sourcesContent":["import ts from 'typescript'\n\nexport type FindingKind = 'jsx-text' | 'jsx-attribute' | 'jsx-expression'\n\nexport interface Finding {\n  /** 1-based line. */\n  readonly line: number\n  /** 1-based column. */\n  readonly column: number\n  readonly text: string\n  readonly kind: FindingKind\n  /** Attribute name (for `jsx-attribute`). */\n  readonly attribute?: string\n}\n\n/** Attributes whose string-literal values are shown to users. */\nconst USER_FACING_ATTRS = new Set([\n  'placeholder',\n  'title',\n  'alt',\n  'aria-label',\n  'aria-placeholder',\n  'aria-description',\n  'label',\n])\n\n/**\n * A stable identity for a finding, independent of line/column (which shift on edits).\n * Used to baseline a known backlog so CI only fails on NEW strings.\n */\nexport function findingKey(relativePath: string, finding: Finding): string {\n  return `${relativePath} :: ${finding.text}`\n}\n\nconst hasLetters = (s: string): boolean => /\\p{L}/u.test(s)\n\n/** Decide whether a literal is human-facing copy worth translating (vs. a token/number/url). */\nexport function isTranslatable(raw: string): boolean {\n  const s = raw.trim()\n  if (!s) return false\n  if (!hasLetters(s)) return false // numbers, punctuation, symbols only\n  if (/^https?:\\/\\//i.test(s)) return false // urls\n  if (/^[a-z][a-zA-Z0-9]*$/.test(s) && s.length <= 2) return false // tiny identifiers like \"px\"\n  if (/^[#.][\\w-]+$/.test(s)) return false // css selectors / hex-ish\n  return true\n}\n\n/** Scan a single TSX/JSX source string for hardcoded, untranslated strings. */\nexport function scanSource(fileName: string, code: string): Finding[] {\n  const sf = ts.createSourceFile(fileName, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX)\n  const findings: Finding[] = []\n\n  // Lines carrying an `i18n-ignore` directive are skipped.\n  const ignoredLines = new Set<number>()\n  code.split('\\n').forEach((lineText, i) => {\n    if (lineText.includes('i18n-ignore')) {\n      ignoredLines.add(i + 1)\n      ignoredLines.add(i + 2) // also the line after the comment\n    }\n  })\n\n  const at = (node: ts.Node) => {\n    const { line, character } = sf.getLineAndCharacterOfPosition(node.getStart(sf))\n    return { line: line + 1, column: character + 1 }\n  }\n  const push = (node: ts.Node, text: string, kind: FindingKind, attribute?: string) => {\n    const loc = at(node)\n    if (ignoredLines.has(loc.line)) return\n    findings.push({ ...loc, text: text.trim(), kind, attribute })\n  }\n\n  const visit = (node: ts.Node) => {\n    if (ts.isJsxText(node)) {\n      if (isTranslatable(node.text)) push(node, node.text, 'jsx-text')\n    } else if (ts.isJsxAttribute(node) && node.initializer && ts.isStringLiteral(node.initializer)) {\n      const name = node.name.getText(sf)\n      if (USER_FACING_ATTRS.has(name) && isTranslatable(node.initializer.text)) {\n        push(node.initializer, node.initializer.text, 'jsx-attribute', name)\n      }\n    } else if (\n      ts.isJsxExpression(node) &&\n      node.expression &&\n      ts.isStringLiteralLike(node.expression) &&\n      isTranslatable(node.expression.text)\n    ) {\n      // a bare string literal placed directly in JSX, e.g. {'Save'} or {`Hello`}\n      push(node.expression, node.expression.text, 'jsx-expression')\n    }\n    ts.forEachChild(node, visit)\n  }\n  visit(sf)\n  return findings\n}\n"],"mappings":";AAAA,OAAO,QAAQ;AAgBf,IAAM,oBAAoB,oBAAI,IAAI;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAMM,SAAS,WAAW,cAAsB,SAA0B;AACzE,SAAO,GAAG,YAAY,OAAO,QAAQ,IAAI;AAC3C;AAEA,IAAM,aAAa,CAAC,MAAuB,SAAS,KAAK,CAAC;AAGnD,SAAS,eAAe,KAAsB;AACnD,QAAM,IAAI,IAAI,KAAK;AACnB,MAAI,CAAC,EAAG,QAAO;AACf,MAAI,CAAC,WAAW,CAAC,EAAG,QAAO;AAC3B,MAAI,gBAAgB,KAAK,CAAC,EAAG,QAAO;AACpC,MAAI,sBAAsB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAG,QAAO;AAC3D,MAAI,eAAe,KAAK,CAAC,EAAG,QAAO;AACnC,SAAO;AACT;AAGO,SAAS,WAAW,UAAkB,MAAyB;AACpE,QAAM,KAAK,GAAG,iBAAiB,UAAU,MAAM,GAAG,aAAa,QAAQ,MAAM,GAAG,WAAW,GAAG;AAC9F,QAAM,WAAsB,CAAC;AAG7B,QAAM,eAAe,oBAAI,IAAY;AACrC,OAAK,MAAM,IAAI,EAAE,QAAQ,CAAC,UAAU,MAAM;AACxC,QAAI,SAAS,SAAS,aAAa,GAAG;AACpC,mBAAa,IAAI,IAAI,CAAC;AACtB,mBAAa,IAAI,IAAI,CAAC;AAAA,IACxB;AAAA,EACF,CAAC;AAED,QAAM,KAAK,CAAC,SAAkB;AAC5B,UAAM,EAAE,MAAM,UAAU,IAAI,GAAG,8BAA8B,KAAK,SAAS,EAAE,CAAC;AAC9E,WAAO,EAAE,MAAM,OAAO,GAAG,QAAQ,YAAY,EAAE;AAAA,EACjD;AACA,QAAM,OAAO,CAAC,MAAe,MAAc,MAAmB,cAAuB;AACnF,UAAM,MAAM,GAAG,IAAI;AACnB,QAAI,aAAa,IAAI,IAAI,IAAI,EAAG;AAChC,aAAS,KAAK,EAAE,GAAG,KAAK,MAAM,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAAA,EAC9D;AAEA,QAAM,QAAQ,CAAC,SAAkB;AAC/B,QAAI,GAAG,UAAU,IAAI,GAAG;AACtB,UAAI,eAAe,KAAK,IAAI,EAAG,MAAK,MAAM,KAAK,MAAM,UAAU;AAAA,IACjE,WAAW,GAAG,eAAe,IAAI,KAAK,KAAK,eAAe,GAAG,gBAAgB,KAAK,WAAW,GAAG;AAC9F,YAAM,OAAO,KAAK,KAAK,QAAQ,EAAE;AACjC,UAAI,kBAAkB,IAAI,IAAI,KAAK,eAAe,KAAK,YAAY,IAAI,GAAG;AACxE,aAAK,KAAK,aAAa,KAAK,YAAY,MAAM,iBAAiB,IAAI;AAAA,MACrE;AAAA,IACF,WACE,GAAG,gBAAgB,IAAI,KACvB,KAAK,cACL,GAAG,oBAAoB,KAAK,UAAU,KACtC,eAAe,KAAK,WAAW,IAAI,GACnC;AAEA,WAAK,KAAK,YAAY,KAAK,WAAW,MAAM,gBAAgB;AAAA,IAC9D;AACA,OAAG,aAAa,MAAM,KAAK;AAAA,EAC7B;AACA,QAAM,EAAE;AACR,SAAO;AACT;","names":[]}

package/dist/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import {
+  findingKey,
   scanSource
-} from "./chunk-47SPJKTR.js";
+} from "./chunk-4NCNMJLG.js";
 
 // src/cli.ts
-import { readFileSync, readdirSync, statSync } from "fs";
-import { extname, join } from "path";
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
+import { extname, join, relative } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "coverage", ".git"]);
 var EXTS = /* @__PURE__ */ new Set([".tsx", ".jsx"]);
 function collect(path, out = []) {
@@ -20,24 +21,53 @@ function collect(path, out = []) {
   }
   return out;
 }
+function parseArgs(argv) {
+  let baseline;
+  let updateBaseline = false;
+  const roots = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--update-baseline") updateBaseline = true;
+    else if (a === "--baseline") baseline = argv[++i];
+    else if (a.startsWith("--baseline=")) baseline = a.slice("--baseline=".length);
+    else roots.push(a);
+  }
+  return { baseline, updateBaseline, roots: roots.length ? roots : ["."] };
+}
 function main() {
-  const args = process.argv.slice(2);
-  const roots = args.length ? args : ["."];
+  const { baseline, updateBaseline, roots } = parseArgs(process.argv.slice(2));
   const files = roots.flatMap((root) => collect(root));
-  let total = 0;
-  for (const file of files) {
-    const findings = scanSource(file, readFileSync(file, "utf8"));
-    for (const f of findings) {
-      const attr = f.attribute ? `:${f.attribute}` : "";
-      process.stdout.write(`${file}:${f.line}:${f.column}  [${f.kind}${attr}]  ${JSON.stringify(f.text)}
+  const all = files.flatMap((file) => {
+    const rel = relative(process.cwd(), file);
+    return scanSource(file, readFileSync(file, "utf8")).map((f) => ({ file, rel, finding: f }));
+  });
+  if (updateBaseline) {
+    const target = baseline ?? ".i18n-lint-baseline.json";
+    const keys = [...new Set(all.map((x) => findingKey(x.rel, x.finding)))].sort();
+    writeFileSync(target, JSON.stringify(keys, null, 2) + "\n");
+    process.stderr.write(`Wrote baseline: ${keys.length} known string(s) \u2192 ${target}
 `);
-    }
-    total += findings.length;
+    process.exit(0);
   }
-  process.stderr.write(`
-${total} untranslated string(s) across ${files.length} file(s)
+  const baselineKeys = baseline && existsSync(baseline) ? new Set(JSON.parse(readFileSync(baseline, "utf8"))) : null;
+  const reported = baselineKeys ? all.filter((x) => !baselineKeys.has(findingKey(x.rel, x.finding))) : all;
+  for (const { rel, finding: f } of reported) {
+    const attr = f.attribute ? `:${f.attribute}` : "";
+    process.stdout.write(`${rel}:${f.line}:${f.column}  [${f.kind}${attr}]  ${JSON.stringify(f.text)}
 `);
-  process.exit(total > 0 ? 1 : 0);
+  }
+  if (baselineKeys) {
+    process.stderr.write(
+      `
+${reported.length} new untranslated string(s); ${all.length - reported.length} baselined (${files.length} file(s))
+`
+    );
+  } else {
+    process.stderr.write(`
+${reported.length} untranslated string(s) across ${files.length} file(s)
+`);
+  }
+  process.exit(reported.length > 0 ? 1 : 0);
 }
 main();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync, readdirSync, statSync } from 'node:fs'\nimport { extname, join } from 'node:path'\nimport { scanSource } from './scan.js'\n\nconst SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'coverage', '.git'])\nconst EXTS = new Set(['.tsx', '.jsx'])\n\nfunction collect(path: string, out: string[] = []): string[] {\n  const stat = statSync(path)\n  if (stat.isDirectory()) {\n    for (const entry of readdirSync(path)) {\n      if (SKIP_DIRS.has(entry) || entry.startsWith('.')) continue\n      collect(join(path, entry), out)\n    }\n  } else if (EXTS.has(extname(path)) && !path.endsWith('.test.tsx')) {\n    out.push(path)\n  }\n  return out\n}\n\nfunction main(): void {\n  const args = process.argv.slice(2)\n  const roots = args.length ? args : ['.']\n  const files = roots.flatMap((root) => collect(root))\n\n  let total = 0\n  for (const file of files) {\n    const findings = scanSource(file, readFileSync(file, 'utf8'))\n    for (const f of findings) {\n      const attr = f.attribute ? `:${f.attribute}` : ''\n      process.stdout.write(`${file}:${f.line}:${f.column}  [${f.kind}${attr}]  ${JSON.stringify(f.text)}\\n`)\n    }\n    total += findings.length\n  }\n\n  process.stderr.write(`\\n${total} untranslated string(s) across ${files.length} file(s)\\n`)\n  process.exit(total > 0 ? 1 : 0)\n}\n\nmain()\n"],"mappings":";;;;;;AACA,SAAS,cAAc,aAAa,gBAAgB;AACpD,SAAS,SAAS,YAAY;AAG9B,IAAM,YAAY,oBAAI,IAAI,CAAC,gBAAgB,QAAQ,SAAS,YAAY,MAAM,CAAC;AAC/E,IAAM,OAAO,oBAAI,IAAI,CAAC,QAAQ,MAAM,CAAC;AAErC,SAAS,QAAQ,MAAc,MAAgB,CAAC,GAAa;AAC3D,QAAM,OAAO,SAAS,IAAI;AAC1B,MAAI,KAAK,YAAY,GAAG;AACtB,eAAW,SAAS,YAAY,IAAI,GAAG;AACrC,UAAI,UAAU,IAAI,KAAK,KAAK,MAAM,WAAW,GAAG,EAAG;AACnD,cAAQ,KAAK,MAAM,KAAK,GAAG,GAAG;AAAA,IAChC;AAAA,EACF,WAAW,KAAK,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,WAAW,GAAG;AACjE,QAAI,KAAK,IAAI;AAAA,EACf;AACA,SAAO;AACT;AAEA,SAAS,OAAa;AACpB,QAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,QAAM,QAAQ,KAAK,SAAS,OAAO,CAAC,GAAG;AACvC,QAAM,QAAQ,MAAM,QAAQ,CAAC,SAAS,QAAQ,IAAI,CAAC;AAEnD,MAAI,QAAQ;AACZ,aAAW,QAAQ,OAAO;AACxB,UAAM,WAAW,WAAW,MAAM,aAAa,MAAM,MAAM,CAAC;AAC5D,eAAW,KAAK,UAAU;AACxB,YAAM,OAAO,EAAE,YAAY,IAAI,EAAE,SAAS,KAAK;AAC/C,cAAQ,OAAO,MAAM,GAAG,IAAI,IAAI,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,EAAE,IAAI,GAAG,IAAI,MAAM,KAAK,UAAU,EAAE,IAAI,CAAC;AAAA,CAAI;AAAA,IACvG;AACA,aAAS,SAAS;AAAA,EACpB;AAEA,UAAQ,OAAO,MAAM;AAAA,EAAK,KAAK,kCAAkC,MAAM,MAAM;AAAA,CAAY;AACzF,UAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC;AAChC;AAEA,KAAK;","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs'\nimport { extname, join, relative } from 'node:path'\nimport { scanSource, findingKey } from './scan.js'\n\nconst SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'coverage', '.git'])\nconst EXTS = new Set(['.tsx', '.jsx'])\n\nfunction collect(path: string, out: string[] = []): string[] {\n  const stat = statSync(path)\n  if (stat.isDirectory()) {\n    for (const entry of readdirSync(path)) {\n      if (SKIP_DIRS.has(entry) || entry.startsWith('.')) continue\n      collect(join(path, entry), out)\n    }\n  } else if (EXTS.has(extname(path)) && !path.endsWith('.test.tsx')) {\n    out.push(path)\n  }\n  return out\n}\n\nfunction parseArgs(argv: string[]) {\n  let baseline: string | undefined\n  let updateBaseline = false\n  const roots: string[] = []\n  for (let i = 0; i < argv.length; i++) {\n    const a = argv[i]\n    if (a === '--update-baseline') updateBaseline = true\n    else if (a === '--baseline') baseline = argv[++i]\n    else if (a.startsWith('--baseline=')) baseline = a.slice('--baseline='.length)\n    else roots.push(a)\n  }\n  return { baseline, updateBaseline, roots: roots.length ? roots : ['.'] }\n}\n\nfunction main(): void {\n  const { baseline, updateBaseline, roots } = parseArgs(process.argv.slice(2))\n  const files = roots.flatMap((root) => collect(root))\n\n  const all = files.flatMap((file) => {\n    const rel = relative(process.cwd(), file)\n    return scanSource(file, readFileSync(file, 'utf8')).map((f) => ({ file, rel, finding: f }))\n  })\n\n  // Write/refresh the baseline of known findings, then exit.\n  if (updateBaseline) {\n    const target = baseline ?? '.i18n-lint-baseline.json'\n    const keys = [...new Set(all.map((x) => findingKey(x.rel, x.finding)))].sort()\n    writeFileSync(target, JSON.stringify(keys, null, 2) + '\\n')\n    process.stderr.write(`Wrote baseline: ${keys.length} known string(s) → ${target}\\n`)\n    process.exit(0)\n  }\n\n  const baselineKeys =\n    baseline && existsSync(baseline)\n      ? new Set<string>(JSON.parse(readFileSync(baseline, 'utf8')) as string[])\n      : null\n\n  const reported = baselineKeys\n    ? all.filter((x) => !baselineKeys.has(findingKey(x.rel, x.finding)))\n    : all\n\n  for (const { rel, finding: f } of reported) {\n    const attr = f.attribute ? `:${f.attribute}` : ''\n    process.stdout.write(`${rel}:${f.line}:${f.column}  [${f.kind}${attr}]  ${JSON.stringify(f.text)}\\n`)\n  }\n\n  if (baselineKeys) {\n    process.stderr.write(\n      `\\n${reported.length} new untranslated string(s); ${all.length - reported.length} baselined (${files.length} file(s))\\n`,\n    )\n  } else {\n    process.stderr.write(`\\n${reported.length} untranslated string(s) across ${files.length} file(s)\\n`)\n  }\n  process.exit(reported.length > 0 ? 1 : 0)\n}\n\nmain()\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -9,9 +9,14 @@ interface Finding {
     /** Attribute name (for `jsx-attribute`). */
     readonly attribute?: string;
 }
+/**
+ * A stable identity for a finding, independent of line/column (which shift on edits).
+ * Used to baseline a known backlog so CI only fails on NEW strings.
+ */
+declare function findingKey(relativePath: string, finding: Finding): string;
 /** Decide whether a literal is human-facing copy worth translating (vs. a token/number/url). */
 declare function isTranslatable(raw: string): boolean;
 /** Scan a single TSX/JSX source string for hardcoded, untranslated strings. */
 declare function scanSource(fileName: string, code: string): Finding[];
 
-export { type Finding, type FindingKind, isTranslatable, scanSource };
+export { type Finding, type FindingKind, findingKey, isTranslatable, scanSource };

package/dist/index.js

@@ -1,8 +1,10 @@
 import {
+  findingKey,
   isTranslatable,
   scanSource
-} from "./chunk-47SPJKTR.js";
+} from "./chunk-4NCNMJLG.js";
 export {
+  findingKey,
   isTranslatable,
   scanSource
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liam-public/node-i18n-lint",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Detect hardcoded, untranslated strings in JSX/TSX — JSX text, user-facing attributes, and bare string literals — so you can wrap them in t().",
   "type": "module",
   "liamCompatibility": {