@better-i18n/cli 0.1.0

package/README.md

@@ -0,0 +1,218 @@
+# @better-i18n/cli
+
+> Detect hardcoded strings in your React/Next.js apps before they become i18n debt.
+
+[![npm version](https://img.shields.io/npm/v/@better-i18n/cli.svg)](https://www.npmjs.com/package/@better-i18n/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Why?
+
+Hardcoded strings slip into codebases easily. Finding them manually is tedious. This CLI automatically scans your React/Next.js code and reports untranslated text—before it ships to production.
+
+```tsx
+// ❌ These get flagged
+<h1>Welcome to our app</h1>
+<button>Click me</button>
+<input placeholder="Enter your name" />
+
+// ✅ These are fine
+<h1>{t('welcome')}</h1>
+<button>{t('actions.click')}</button>
+<input placeholder={t('form.namePlaceholder')} />
+```
+
+## Installation
+
+```bash
+# Global install
+npm install -g @better-i18n/cli
+
+# Or use with npx (no install)
+npx @better-i18n/cli scan
+
+# Or add to your project
+npm install -D @better-i18n/cli
+```
+
+## Quick Start
+
+```bash
+# Scan current directory
+better-i18n scan
+
+# That's it! The CLI auto-detects your i18n.config.ts
+```
+
+## Usage
+
+```bash
+# Scan specific directory
+better-i18n scan --dir ./src
+
+# JSON output (for CI/tooling)
+better-i18n scan --format json
+
+# CI mode (exit code 1 if issues found)
+better-i18n scan --ci
+
+# Only scan git staged files (for pre-commit hooks)
+better-i18n scan --staged
+
+# Verbose output
+better-i18n scan --verbose
+```
+
+## Example Output
+
+```
+$ better-i18n scan
+
+✓ Project: acme/web-app
+✓ Found 45 files
+
+src/components/Header.tsx
+  12:8   warning  "Welcome back"              i18n/jsx-text
+  15:18  warning  "Profile picture"           i18n/jsx-attribute
+
+src/pages/login.tsx
+  23:15  error    locale === 'en' ? ... : ... i18n/ternary-locale
+
+✖ 3 problems (1 error, 2 warnings)
+
+Scanned 45 files in 0.23s
+```
+
+## Detection Rules
+
+| Rule | Severity | What it catches |
+|------|----------|-----------------|
+| `jsx-text` | warning | Hardcoded text inside JSX elements |
+| `jsx-attribute` | warning | Hardcoded `title`, `alt`, `placeholder`, `aria-label` |
+| `ternary-locale` | error | `locale === 'en' ? 'Hello' : 'Hola'` anti-pattern |
+
+## Configuration
+
+The CLI automatically reads your `i18n.config.ts` file. No extra config needed!
+
+```ts
+// i18n.config.ts
+import { createI18n } from "@better-i18n/next";
+
+export const { useTranslation, I18nProvider } = createI18n({
+  project: "your-org/your-project",
+  defaultLocale: "en",
+  
+  // Optional: customize lint behavior
+  lint: {
+    include: ["src/**/*.tsx", "app/**/*.tsx"],
+    exclude: ["**/*.test.tsx", "**/*.stories.tsx"],
+    rules: {
+      "jsx-text": "warning",
+      "jsx-attribute": "warning",
+      "ternary-locale": "error",
+    },
+  },
+});
+```
+
+### Lint Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `include` | `string[]` | Glob patterns for files to scan |
+| `exclude` | `string[]` | Glob patterns for files to ignore |
+| `rules` | `object` | Rule severity: `"error"`, `"warning"`, or `"off"` |
+
+## CI/CD Integration
+
+### GitHub Actions
+
+```yaml
+# .github/workflows/i18n-lint.yml
+name: i18n Lint
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npx @better-i18n/cli scan --ci
+```
+
+### Pre-commit Hook
+
+With [Husky](https://typicode.github.io/husky/):
+
+```bash
+# .husky/pre-commit
+npx @better-i18n/cli scan --staged --ci
+```
+
+Or with [lint-staged](https://github.com/lint-staged/lint-staged):
+
+```json
+{
+  "lint-staged": {
+    "*.{tsx,jsx}": ["better-i18n scan --ci"]
+  }
+}
+```
+
+## JSON Output
+
+Use `--format json` for programmatic access:
+
+```bash
+better-i18n scan --format json
+```
+
+```json
+{
+  "project": {
+    "workspaceId": "acme",
+    "projectSlug": "web-app",
+    "defaultLocale": "en"
+  },
+  "files": 45,
+  "issues": [
+    {
+      "file": "src/components/Header.tsx",
+      "line": 12,
+      "column": 8,
+      "text": "Welcome back",
+      "type": "jsx-text",
+      "severity": "warning",
+      "message": "Hardcoded text in JSX"
+    }
+  ],
+  "duration": 234
+}
+```
+
+## What Gets Ignored
+
+The CLI is smart about ignoring non-translatable content:
+
+- ✅ CSS class names: `className="flex items-center"`
+- ✅ URLs: `href="https://example.com"`
+- ✅ Numbers and constants
+- ✅ Import paths
+- ✅ Code identifiers
+- ✅ Single characters and punctuation
+
+## Part of Better i18n
+
+This CLI is part of the [Better i18n](https://better-i18n.com) ecosystem:
+
+- **[@better-i18n/next](https://www.npmjs.com/package/@better-i18n/next)** - Next.js i18n SDK
+- **[@better-i18n/cli](https://www.npmjs.com/package/@better-i18n/cli)** - This CLI
+- **[Dashboard](https://better-i18n.com)** - Visual translation management
+
+## License
+
+MIT © [Better i18n](https://better-i18n.com)

package/dist/analyzer/file-collector.d.ts

@@ -0,0 +1,21 @@
+/**
+ * File collector
+ *
+ * Collect TypeScript/JavaScript files for analysis
+ */
+export interface CollectOptions {
+    rootDir: string;
+    include?: string[];
+    exclude?: string[];
+    extensions?: string[];
+    staged?: boolean;
+}
+/**
+ * Collect files to analyze
+ */
+export declare function collectFiles(options: CollectOptions): Promise<string[]>;
+/**
+ * Check if file matches exclude patterns
+ */
+export declare function shouldExcludeFile(filePath: string, patterns: string[]): boolean;
+//# sourceMappingURL=file-collector.d.ts.map

package/dist/analyzer/file-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-collector.d.ts","sourceRoot":"","sources":["../../src/analyzer/file-collector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyB7E;AA+BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAmBT"}

package/dist/analyzer/file-collector.js

@@ -0,0 +1,82 @@
+/**
+ * File collector
+ *
+ * Collect TypeScript/JavaScript files for analysis
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+const DEFAULT_INCLUDE = ["src", "app", "components", "pages"];
+const DEFAULT_EXCLUDE = [
+    "node_modules",
+    ".git",
+    ".next",
+    "dist",
+    "build",
+    "out",
+    "__tests__",
+    "__mocks__",
+];
+const DEFAULT_EXTENSIONS = [".tsx", ".jsx"];
+/**
+ * Collect files to analyze
+ */
+export async function collectFiles(options) {
+    const { rootDir, include = DEFAULT_INCLUDE, exclude = DEFAULT_EXCLUDE, extensions = DEFAULT_EXTENSIONS, } = options;
+    const files = [];
+    const excludeSet = new Set(exclude);
+    // Check which include directories exist
+    const existingDirs = include.filter((dir) => existsSync(join(rootDir, dir)));
+    // If no include dirs exist, scan root
+    const dirsToScan = existingDirs.length > 0 ? existingDirs : ["."];
+    for (const dir of dirsToScan) {
+        const fullDir = join(rootDir, dir);
+        collectFromDir(fullDir, rootDir, files, excludeSet, extensions);
+    }
+    return files;
+}
+function collectFromDir(dir, rootDir, files, excludeSet, extensions) {
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (excludeSet.has(entry.name))
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                collectFromDir(fullPath, rootDir, files, excludeSet, extensions);
+            }
+            else if (entry.isFile()) {
+                const ext = entry.name.slice(entry.name.lastIndexOf("."));
+                if (extensions.includes(ext)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore permission errors
+    }
+}
+/**
+ * Check if file matches exclude patterns
+ */
+export function shouldExcludeFile(filePath, patterns) {
+    const fileName = filePath.split("/").pop() || "";
+    for (const pattern of patterns) {
+        if (pattern.startsWith("**/*.")) {
+            const ext = pattern.slice(4);
+            if (fileName.endsWith(ext))
+                return true;
+        }
+        else if (pattern.includes("*")) {
+            // Simple glob matching
+            const regex = new RegExp("^" + pattern.replace(/\*/g, ".*").replace(/\?/g, ".") + "$");
+            if (regex.test(fileName))
+                return true;
+        }
+        else if (filePath.includes(pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=file-collector.js.map

package/dist/analyzer/file-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-collector.js","sourceRoot":"","sources":["../../src/analyzer/file-collector.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Main analyzer module
+ *
+ * Parses TypeScript/JSX files and applies detection rules
+ */
+import type { Issue, LintConfig } from "./types.js";
+/**
+ * Analyze a single file for hardcoded strings
+ */
+export declare function analyzeFile(filePath: string, config?: LintConfig): Promise<Issue[]>;
+/**
+ * Analyze source text (useful for testing)
+ */
+export declare function analyzeSourceText(sourceText: string, filePath: string, config?: LintConfig): Issue[];
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAEjE;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,UAAU,GAClB,KAAK,EAAE,CA2CT"}

package/dist/analyzer/index.js

@@ -0,0 +1,66 @@
+/**
+ * Main analyzer module
+ *
+ * Parses TypeScript/JSX files and applies detection rules
+ */
+import { readFileSync } from "node:fs";
+import ts from "typescript";
+import { checkJsxAttribute } from "./rules/jsx-attribute.js";
+import { checkJsxText } from "./rules/jsx-text.js";
+import { checkTernaryLocale } from "./rules/ternary-locale.js";
+/**
+ * Analyze a single file for hardcoded strings
+ */
+export async function analyzeFile(filePath, config) {
+    const sourceText = readFileSync(filePath, "utf-8");
+    return analyzeSourceText(sourceText, filePath, config);
+}
+/**
+ * Analyze source text (useful for testing)
+ */
+export function analyzeSourceText(sourceText, filePath, config) {
+    const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, getScriptKind(filePath));
+    const issues = [];
+    const ctx = { filePath, sourceFile };
+    // Check if rules are enabled
+    const rules = config?.rules || {};
+    const jsxTextEnabled = rules["jsx-text"] !== "off";
+    const jsxAttrEnabled = rules["jsx-attribute"] !== "off";
+    const ternaryEnabled = rules["ternary-locale"] !== "off";
+    function visit(node) {
+        // JSX Text
+        if (jsxTextEnabled && ts.isJsxText(node)) {
+            const issue = checkJsxText(node, ctx);
+            if (issue)
+                issues.push(issue);
+        }
+        // JSX Attribute
+        if (jsxAttrEnabled && ts.isJsxAttribute(node)) {
+            const issue = checkJsxAttribute(node, ctx);
+            if (issue)
+                issues.push(issue);
+        }
+        // Ternary with locale
+        if (ternaryEnabled && ts.isConditionalExpression(node)) {
+            const issue = checkTernaryLocale(node, ctx);
+            if (issue)
+                issues.push(issue);
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return issues;
+}
+/**
+ * Get TypeScript script kind based on file extension
+ */
+function getScriptKind(filePath) {
+    if (filePath.endsWith(".tsx"))
+        return ts.ScriptKind.TSX;
+    if (filePath.endsWith(".jsx"))
+        return ts.ScriptKind.JSX;
+    if (filePath.endsWith(".ts"))
+        return ts.ScriptKind.TS;
+    return ts.ScriptKind.JS;
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/rules/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rules index - exports all detection rules
+ */
+export { checkJsxAttribute } from "./jsx-attribute.js";
+export { checkJsxText } from "./jsx-text.js";
+export { checkTernaryLocale } from "./ternary-locale.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzer/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/analyzer/rules/index.js

@@ -0,0 +1,7 @@
+/**
+ * Rules index - exports all detection rules
+ */
+export { checkJsxAttribute } from "./jsx-attribute.js";
+export { checkJsxText } from "./jsx-text.js";
+export { checkTernaryLocale } from "./ternary-locale.js";
+//# sourceMappingURL=index.js.map

package/dist/analyzer/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/analyzer/rules/jsx-attribute.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSX Attribute detection rule
+ *
+ * Detects hardcoded strings in title, alt, placeholder, etc.
+ */
+import ts from "typescript";
+import type { Issue, RuleContext } from "../types.js";
+/**
+ * Check JSX attribute for hardcoded strings
+ */
+export declare function checkJsxAttribute(node: ts.JsxAttribute, ctx: RuleContext): Issue | null;
+//# sourceMappingURL=jsx-attribute.d.ts.map

package/dist/analyzer/rules/jsx-attribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-attribute.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/jsx-attribute.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA8BtD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,EAAE,CAAC,YAAY,EACrB,GAAG,EAAE,WAAW,GACf,KAAK,GAAG,IAAI,CA6Cd"}

package/dist/analyzer/rules/jsx-attribute.js

@@ -0,0 +1,78 @@
+/**
+ * JSX Attribute detection rule
+ *
+ * Detects hardcoded strings in title, alt, placeholder, etc.
+ */
+import ts from "typescript";
+import { generateKeyFromContext, truncate } from "../../utils/text.js";
+/**
+ * Attributes to check for hardcoded strings
+ */
+const CHECK_ATTRIBUTES = new Set([
+    "title",
+    "alt",
+    "placeholder",
+    "aria-label",
+    "label",
+]);
+/**
+ * Attributes to ignore (never flag these)
+ */
+const IGNORE_ATTRIBUTES = new Set([
+    "className",
+    "class",
+    "id",
+    "key",
+    "ref",
+    "data-testid",
+    "href",
+    "src",
+    "name",
+    "type",
+    "role",
+]);
+/**
+ * Check JSX attribute for hardcoded strings
+ */
+export function checkJsxAttribute(node, ctx) {
+    const attrName = node.name.getText();
+    // Skip ignored attributes
+    if (IGNORE_ATTRIBUTES.has(attrName))
+        return null;
+    // Only check specific attributes
+    if (!CHECK_ATTRIBUTES.has(attrName))
+        return null;
+    // Get the value
+    const value = node.initializer;
+    if (!value)
+        return null;
+    let text = null;
+    // String literal: title="Hello"
+    if (ts.isStringLiteral(value)) {
+        text = value.text;
+    }
+    // JSX expression with string: title={"Hello"}
+    if (ts.isJsxExpression(value) && value.expression) {
+        if (ts.isStringLiteral(value.expression)) {
+            text = value.expression.text;
+        }
+    }
+    // No text found or too short
+    if (!text || text.length <= 2)
+        return null;
+    // Skip URLs
+    if (text.startsWith("http") || text.startsWith("/"))
+        return null;
+    const pos = ctx.sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return {
+        file: ctx.filePath,
+        line: pos.line + 1,
+        column: pos.character + 1,
+        text,
+        type: "jsx-attribute",
+        severity: "warning",
+        message: `Hardcoded ${attrName}: "${truncate(text, 40)}"`,
+        suggestedKey: generateKeyFromContext(text, ctx.filePath),
+    };
+}
+//# sourceMappingURL=jsx-attribute.js.map

package/dist/analyzer/rules/jsx-attribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-attribute.js","sourceRoot":"","sources":["../../../src/analyzer/rules/jsx-attribute.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGvE;;GAEG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,OAAO;IACP,KAAK;IACL,aAAa;IACb,YAAY;IACZ,OAAO;CACR,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,WAAW;IACX,OAAO;IACP,IAAI;IACJ,KAAK;IACL,KAAK;IACL,aAAa;IACb,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAqB,EACrB,GAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAErC,0BAA0B;IAC1B,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,iCAAiC;IACjC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,gBAAgB;IAChB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,IAAI,GAAkB,IAAI,CAAC;IAE/B,gCAAgC;IAChC,IAAI,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,IAAI,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAClD,IAAI,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,YAAY;IACZ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE1E,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC;QACzB,IAAI;QACJ,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,aAAa,QAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG;QACzD,YAAY,EAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/analyzer/rules/jsx-text.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSX Text detection rule
+ *
+ * Detects hardcoded text content in JSX elements
+ */
+import ts from "typescript";
+import type { Issue, RuleContext } from "../types.js";
+/**
+ * Check JSX text node for hardcoded strings
+ */
+export declare function checkJsxText(node: ts.JsxText, ctx: RuleContext): Issue | null;
+//# sourceMappingURL=jsx-text.d.ts.map

package/dist/analyzer/rules/jsx-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-text.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/jsx-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAetD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,EAAE,CAAC,OAAO,EAChB,GAAG,EAAE,WAAW,GACf,KAAK,GAAG,IAAI,CAwBd"}

package/dist/analyzer/rules/jsx-text.js

@@ -0,0 +1,45 @@
+/**
+ * JSX Text detection rule
+ *
+ * Detects hardcoded text content in JSX elements
+ */
+import { generateKeyFromContext, truncate } from "../../utils/text.js";
+/**
+ * Default patterns to ignore
+ */
+const IGNORE_PATTERNS = [
+    /^[\s\n\r\t]+$/, // Whitespace only
+    /^[→←↑↓★•·\-–—\/\\|,;:.!?()[\]{}]+$/, // Symbols only
+    /^\d+[+%KkMm]?$/, // Numbers with optional suffix
+    /^[A-Z_]+$/, // SCREAMING_CASE
+    /^https?:\/\//, // URLs
+    /^\//, // Paths
+    /^[a-z-]+$/, // CSS-like (lowercase with hyphens only)
+];
+/**
+ * Check JSX text node for hardcoded strings
+ */
+export function checkJsxText(node, ctx) {
+    const text = node.text.trim();
+    // Skip empty or very short
+    if (!text || text.length <= 2)
+        return null;
+    // Skip ignored patterns
+    for (const pattern of IGNORE_PATTERNS) {
+        if (pattern.test(text))
+            return null;
+    }
+    // Get position
+    const pos = ctx.sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return {
+        file: ctx.filePath,
+        line: pos.line + 1,
+        column: pos.character + 1,
+        text,
+        type: "jsx-text",
+        severity: "warning",
+        message: `Hardcoded text: "${truncate(text, 40)}"`,
+        suggestedKey: generateKeyFromContext(text, ctx.filePath),
+    };
+}
+//# sourceMappingURL=jsx-text.js.map

package/dist/analyzer/rules/jsx-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-text.js","sourceRoot":"","sources":["../../../src/analyzer/rules/jsx-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGvE;;GAEG;AACH,MAAM,eAAe,GAAG;IACtB,eAAe,EAAE,kBAAkB;IACnC,oCAAoC,EAAE,eAAe;IACrD,gBAAgB,EAAE,+BAA+B;IACjD,WAAW,EAAE,iBAAiB;IAC9B,cAAc,EAAE,OAAO;IACvB,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,yCAAyC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,GAAgB;IAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAE9B,2BAA2B;IAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,wBAAwB;IACxB,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IAED,eAAe;IACf,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE1E,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC;QAClB,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC;QACzB,IAAI;QACJ,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,oBAAoB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG;QAClD,YAAY,EAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/analyzer/rules/ternary-locale.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ternary locale detection rule
+ *
+ * Detects anti-pattern: locale === 'en' ? 'Hello' : 'Merhaba'
+ */
+import ts from "typescript";
+import type { Issue, RuleContext } from "../types.js";
+/**
+ * Check conditional expression for locale-based ternary
+ */
+export declare function checkTernaryLocale(node: ts.ConditionalExpression, ctx: RuleContext): Issue | null;
+//# sourceMappingURL=ternary-locale.d.ts.map

package/dist/analyzer/rules/ternary-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ternary-locale.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/ternary-locale.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,EAAE,CAAC,qBAAqB,EAC9B,GAAG,EAAE,WAAW,GACf,KAAK,GAAG,IAAI,CA4Cd"}