@better-i18n/cli 0.1.1 → 0.1.3

package/README.md

@@ -27,7 +27,7 @@ Hardcoded strings slip into codebases easily. Finding them manually is tedious.
 # Global install
 npm install -g @better-i18n/cli
 
-# Or use with npx (no install)
+# Or use with npx (no install needed)
 npx @better-i18n/cli scan
 
 # Or add to your project
@@ -43,93 +43,256 @@ better-i18n scan
 # That's it! The CLI auto-detects your i18n.config.ts
 ```
 
-## Usage
+## Features
+
+- ✅ **Auto-config detection** - Reads your existing `i18n.config.ts`
+- ✅ **Smart filtering** - Ignores CSS classes, URLs, constants, HTML entities
+- ✅ **Glob patterns** - Exclude test files, stories, UI components
+- ✅ **Clickable output** - File paths are Cmd+clickable in VS Code terminal
+- ✅ **CI/CD ready** - JSON output, exit codes, staged files support
+- ✅ **Fast** - Scans 100+ files in <100ms
+
+## Example Output
+
+```
+$ better-i18n scan
+
+✓ Project: better-i18n/landing
+✓ Found 57 files
+
+components/sign-up.tsx (11)
+  24:13  missing  "Create an account"  i18n/jsx-text
+  32:22  missing  "Name"  i18n/jsx-text
+  40:22  missing  "Email"  i18n/jsx-text
+
+components/contact.tsx (9)
+  24:59  missing  "Contact us"  i18n/jsx-text
+  31:22  missing  "Message"  i18n/jsx-text
+
+✖ 87 problems (87 missing translations)
+
+Scanned 57 files in 0.07s
+```
+
+**Cmd+Click** on any file path to jump directly to the issue in VS Code!
+
+## Commands & Options
+
+### `better-i18n scan`
+
+Scan your codebase for hardcoded strings.
 
 ```bash
+# Basic usage
+better-i18n scan
+
 # Scan specific directory
 better-i18n scan --dir ./src
 
-# JSON output (for CI/tooling)
-better-i18n scan --format json
+# Output formats
+better-i18n scan --format json    # JSON output for CI/tooling
+better-i18n scan --format eslint  # Human-readable (default)
+
+# CI/CD integration
+better-i18n scan --ci             # Exit with code 1 if issues found
+better-i18n scan --staged         # Only scan git staged files
+
+# Debug
+better-i18n scan --verbose        # Show detailed output
+```
+
+### `better-i18n extract-keys`
+
+Extract all translation keys used in your codebase (t() function calls).
+
+```bash
+# Extract all translation keys
+better-i18n extract-keys
+
+# Compare with remote keys from CDN
+better-i18n extract-keys --compare
 
-# CI mode (exit code 1 if issues found)
-better-i18n scan --ci
+# Compare with specific locale
+better-i18n extract-keys --compare --locale tr
 
-# Only scan git staged files (for pre-commit hooks)
-better-i18n scan --staged
+# JSON output (default)
+better-i18n extract-keys --format json
 
-# Verbose output
-better-i18n scan --verbose
+# Show detailed output
+better-i18n extract-keys --verbose
 ```
 
-## Example Output
+**Output format (JSON):**
 
+```json
+{
+  "localKeys": {
+    "project": "better-i18n/landing",
+    "namespaces": {
+      "auth": ["auth.login", "auth.register", "auth.forgot"],
+      "nav": ["nav.home", "nav.about"],
+      "hero": ["hero.title", "hero.description"]
+    },
+    "totalCount": 6,
+    "filesScanned": 42
+  }
+}
 ```
-$ better-i18n scan
 
-✓ Project: acme/web-app
-✓ Found 45 files
+**With `--compare`:**
+
+```json
+{
+  "comparison": {
+    "localKeys": { ... },
+    "remoteKeys": {
+      "namespaces": { ... },
+      "totalCount": 150
+    },
+    "missingKeys": {
+      "hero": ["hero.cta", "hero.benefits"]
+    },
+    "unusedKeys": {
+      "old": ["old.section"]
+    },
+    "coverage": {
+      "local": 85,
+      "remote": 96
+    }
+  }
+}
+```
 
-src/components/Header.tsx
-  12:8   warning  "Welcome back"              i18n/jsx-text
-  15:18  warning  "Profile picture"           i18n/jsx-attribute
+**Human-readable output with `--compare`:**
 
-src/pages/login.tsx
-  23:15  error    locale === 'en' ? ... : ... i18n/ternary-locale
+```
+✓ Project: better-i18n/landing
+✓ Found 57 files
+✓ Fetched 12 namespaces from CDN
+
+📊 Translation Keys Comparison
+
+Coverage:
+  Local → Remote: 85%
+  Remote Used: 96%
+
+❌ Missing in Remote (2 keys):
+hero: 2 keys
+  • hero.cta
+  • hero.benefits
 
-✖ 3 problems (1 error, 2 warnings)
+⚠️  Unused in Code (1 key):
+old: 1 key
+  • old.section
 
-Scanned 45 files in 0.23s
+Scanned 57 files in 0.12s
+✓ Comparison complete
 ```
 
 ## 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 |
+| Rule             | Severity | What it catches        | Example                           |
+| ---------------- | -------- | ---------------------- | --------------------------------- |
+| `jsx-text`       | missing  | Hardcoded text in JSX  | `<h1>Hello</h1>`                  |
+| `jsx-attribute`  | missing  | Hardcoded attributes   | `<img alt="Logo" />`              |
+| `ternary-locale` | error    | Locale-based ternaries | `locale === 'en' ? 'Hi' : 'Hola'` |
+
+### Automatically Ignored
+
+- HTML entities: `&quot;`, `&amp;`, `&#39;`
+- CSS classes: `className="flex items-center"`
+- URLs: `href="https://example.com"`
+- Paths: `/api/users`
+- Numbers: `42`, `3.14`, `100%`
+- Constants: `SCREAMING_CASE`
+- Symbols: `→`, `•`, `...`
 
 ## Configuration
 
-The CLI automatically reads your `i18n.config.ts` file. No extra config needed!
+Create or update your `i18n.config.ts`:
 
 ```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
+export const project = "your-org/your-project";
+export const defaultLocale = "en";
+
+export const i18nWorkspaceConfig = {
+  project,
+  defaultLocale,
   lint: {
+    // Files to scan (defaults: ["src", "app", "components", "pages"])
     include: ["src/**/*.tsx", "app/**/*.tsx"],
-    exclude: ["**/*.test.tsx", "**/*.stories.tsx"],
+
+    // Files to ignore (automatically merges with defaults)
+    exclude: [
+      "**/skeletons.tsx", // Mock/demo components
+      "**/*.stories.tsx", // Storybook files
+      "**/*.test.tsx", // Test files
+      "**/components/ui/**", // UI library components
+    ],
+
+    // Rule configuration (optional)
     rules: {
       "jsx-text": "warning",
       "jsx-attribute": "warning",
       "ternary-locale": "error",
     },
   },
-});
+};
 ```
 
-### Lint Options
+### Config Options
+
+| Option    | Type       | Description                                                                        |
+| --------- | ---------- | ---------------------------------------------------------------------------------- |
+| `include` | `string[]` | Glob patterns for files to scan (default: `["src", "app", "components", "pages"]`) |
+| `exclude` | `string[]` | Glob patterns to ignore (merges with defaults: `node_modules`, `.next`, etc.)      |
+| `rules`   | `object`   | Set severity: `"error"` \| `"warning"` \| `"off"`                                  |
+
+## Usage Scenarios
 
-| 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"` |
+### 1. Local Development
 
-## CI/CD Integration
+Add to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "next lint && better-i18n scan --ci",
+    "lint:i18n": "better-i18n scan"
+  }
+}
+```
 
-### GitHub Actions
+Run before commits:
+
+```bash
+npm run lint:i18n
+```
+
+### 2. Pre-commit Hook
+
+Install [Husky](https://typicode.github.io/husky/):
+
+```bash
+npx husky init
+echo "npx @better-i18n/cli scan --staged --ci" > .husky/pre-commit
+```
+
+Or with [lint-staged](https://github.com/lint-staged/lint-staged):
+
+```json
+{
+  "lint-staged": {
+    "*.{tsx,jsx}": ["better-i18n scan --ci"]
+  }
+}
+```
+
+### 3. GitHub Actions CI
 
 ```yaml
-# .github/workflows/i18n-lint.yml
-name: i18n Lint
+# .github/workflows/i18n-check.yml
+name: i18n Check
 
 on: [push, pull_request]
 
@@ -140,78 +303,193 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: '20'
-      - run: npx @better-i18n/cli scan --ci
+          node-version: "20"
+      - run: npx @better-i18n/cli scan --ci --format json
 ```
 
-### Pre-commit Hook
-
-With [Husky](https://typicode.github.io/husky/):
-
-```bash
-# .husky/pre-commit
-npx @better-i18n/cli scan --staged --ci
-```
+### 4. VS Code Integration
 
-Or with [lint-staged](https://github.com/lint-staged/lint-staged):
+Add to `.vscode/tasks.json`:
 
 ```json
 {
-  "lint-staged": {
-    "*.{tsx,jsx}": ["better-i18n scan --ci"]
-  }
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "i18n: Check translations",
+      "type": "shell",
+      "command": "npx @better-i18n/cli scan",
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    }
+  ]
 }
 ```
 
+Run with: `Cmd+Shift+P` → `Tasks: Run Task` → `i18n: Check translations`
+
+### 5. Monorepo Usage
+
+```bash
+# Scan specific package
+cd packages/web-app
+better-i18n scan
+
+# Or from root with --dir
+better-i18n scan --dir packages/web-app
+```
+
+Each package can have its own `i18n.config.ts`.
+
 ## JSON Output
 
-Use `--format json` for programmatic access:
+Use `--format json` for programmatic integration:
 
 ```bash
-better-i18n scan --format json
+better-i18n scan --format json > i18n-report.json
 ```
 
 ```json
 {
   "project": {
-    "workspaceId": "acme",
-    "projectSlug": "web-app",
+    "workspaceId": "better-i18n",
+    "projectSlug": "landing",
     "defaultLocale": "en"
   },
-  "files": 45,
+  "files": 57,
   "issues": [
     {
-      "file": "src/components/Header.tsx",
-      "line": 12,
-      "column": 8,
-      "text": "Welcome back",
+      "file": "components/sign-up.tsx",
+      "line": 24,
+      "column": 13,
+      "text": "Create an account",
       "type": "jsx-text",
       "severity": "warning",
-      "message": "Hardcoded text in JSX"
+      "message": "Hardcoded text: \"Create an account\"",
+      "suggestedKey": "signUp.createAnAccount"
     }
   ],
-  "duration": 234
+  "duration": 67
 }
 ```
 
-## What Gets Ignored
+### JSON Schema
+
+```ts
+interface ScanResult {
+  project?: {
+    workspaceId: string;
+    projectSlug: string;
+    defaultLocale: string;
+  };
+  files: number;
+  issues: Issue[];
+  duration: number;
+}
 
-The CLI is smart about ignoring non-translatable content:
+interface Issue {
+  file: string; // Relative path
+  line: number; // Line number
+  column: number; // Column number
+  text: string; // Hardcoded text
+  type: "jsx-text" | "jsx-attribute" | "ternary-locale";
+  severity: "error" | "warning";
+  message: string; // Human-readable message
+  suggestedKey?: string; // Auto-generated translation key
+}
+```
 
-- ✅ CSS class names: `className="flex items-center"`
-- ✅ URLs: `href="https://example.com"`
-- ✅ Numbers and constants
-- ✅ Import paths
-- ✅ Code identifiers
-- ✅ Single characters and punctuation
+## Advanced Usage
+
+### Custom Scripts
+
+```bash
+# Count missing translations
+better-i18n scan --format json | jq '.issues | length'
+
+# Get unique files with issues
+better-i18n scan --format json | jq -r '.issues[].file' | sort -u
+
+# Filter only errors
+better-i18n scan --format json | jq '.issues[] | select(.severity == "error")'
+```
+
+### Combine with Other Tools
+
+```bash
+# Run with TypeScript checks
+tsc --noEmit && better-i18n scan --ci
+
+# Run with ESLint
+eslint . && better-i18n scan --ci
+
+# Parallel execution
+npm-run-all --parallel typecheck lint:eslint lint:i18n
+```
+
+## Troubleshooting
+
+### Config not detected
+
+Make sure your `i18n.config.ts` exports either:
+
+- `export const project = "org/slug"`
+- `export const i18nWorkspaceConfig = { project: "org/slug" }`
+
+### Too many false positives
+
+Add exclusions to your config:
+
+```ts
+exclude: ["**/*.stories.tsx", "**/demo/**", "**/examples/**"];
+```
+
+### Clickable links not working
+
+Make sure you're using VS Code's integrated terminal. External terminals may not support clickable file paths.
+
+## Part of Better i18n Ecosystem
+
+This CLI is one component of the **Better i18n translation management platform**:
+
+### Platform Components
+
+- **[@better-i18n/cli](https://www.npmjs.com/package/@better-i18n/cli)** - This CLI tool (detect hardcoded strings, extract keys)
+- **[@better-i18n/next](https://www.npmjs.com/package/@better-i18n/next)** - Next.js SDK for runtime translation
+- **[@better-i18n/app](https://dash.better-i18n.com)** - Web dashboard for translation management
+- `@better-i18n/mcp`: Model Context Protocol server for AI assistants.
+
+### Platform Features
+
+- **GitHub Integration** - Sync translations with your repositories
+- **Real-time Collaboration** - Team workflows on translations
+- **CDN Delivery** - Serve translations globally from edge locations
+- **Multi-language Editor** - Manage all languages in one interface
+- **REST API** - Programmatic access for CI/CD automation
+- **AI Context Analysis** - Automatically extract terminology from websites
+- **Namespace Organization** - Organize translations by feature/module
+
+### How This CLI Fits In
+
+```
+Developer Workflow:
+├─ Write code with hardcoded strings
+├─ Run: better-i18n scan → Detect hardcoded strings ⚠️
+├─ Run: better-i18n extract-keys → Extract used keys
+├─ Review in Better i18n Dashboard
+├─ GitHub Hook: better-i18n scan --staged → Pre-commit check
+├─ CI/CD: better-i18n scan --ci → Fail build if strings found
+└─ Dashboard: Manage translations, sync with GitHub
+```
 
-## Part of Better i18n
+The CLI works **in your local development** to catch issues before they ship, while the platform handles the translation management workflow.
 
-This CLI is part of the [Better i18n](https://better-i18n.com) ecosystem:
+## Contributing
 
-- **[@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
+Found a bug or have a feature request? [Open an issue](https://github.com/better-i18n/better-i18n/issues).
 
 ## License
 

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,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,CAiDT"}

package/dist/analyzer/index.js

@@ -5,9 +5,7 @@
  */
 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";
+import { checkJsxAttribute, checkJsxText, checkTernaryLocale, checkTranslationFunction, } from "./rules/index.js";
 /**
  * Analyze a single file for hardcoded strings
  */
@@ -46,6 +44,12 @@ export function analyzeSourceText(sourceText, filePath, config) {
             if (issue)
                 issues.push(issue);
         }
+        // Translation function calls
+        if (ts.isCallExpression(node)) {
+            const issue = checkTranslationFunction(node, ctx);
+            if (issue)
+                issues.push(issue);
+        }
         ts.forEachChild(node, visit);
     }
     visit(sourceFile);

package/dist/analyzer/index.js.map

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

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/analyzer/rules/index.js

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

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzer/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

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

@@ -1 +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"}
+{"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,CAgDd"}

package/dist/analyzer/rules/ternary-locale.js

@@ -4,7 +4,7 @@
  * Detects anti-pattern: locale === 'en' ? 'Hello' : 'Merhaba'
  */
 import ts from "typescript";
-import { truncate } from "../../utils/text.js";
+import { generateKeyFromContext, truncate } from "../../utils/text.js";
 /**
  * Check conditional expression for locale-based ternary
  */
@@ -35,6 +35,9 @@ export function checkTernaryLocale(node, ctx) {
     const text = hasStringTrue
         ? node.whenTrue.text
         : node.whenFalse.text;
+    // Ignore empty strings (common in URL construction: locale === 'en' ? '' : locale + '/')
+    if (text.trim() === "")
+        return null;
     const pos = ctx.sourceFile.getLineAndCharacterOfPosition(node.getStart());
     return {
         file: ctx.filePath,
@@ -44,6 +47,7 @@ export function checkTernaryLocale(node, ctx) {
         type: "ternary-locale",
         severity: "error", // This is an anti-pattern, so error
         message: `Locale ternary pattern detected: "${truncate(text, 30)}"`,
+        suggestedKey: generateKeyFromContext(text, ctx.filePath),
     };
 }
 //# sourceMappingURL=ternary-locale.js.map

package/dist/analyzer/rules/ternary-locale.js.map

@@ -1 +1 @@
-{"version":3,"file":"ternary-locale.js","sourceRoot":"","sources":["../../../src/analyzer/rules/ternary-locale.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA8B,EAC9B,GAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAEjC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,iCAAiC;IACjC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAC5B,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,qCAAqC;IACrC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAClE,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvE,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAErC,8CAA8C;IAC9C,MAAM,aAAa,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC,aAAa,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEnD,uBAAuB;IACvB,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAE,IAAI,CAAC,QAA6B,CAAC,IAAI;QAC1C,CAAC,CAAE,IAAI,CAAC,SAA8B,CAAC,IAAI,CAAC;IAE9C,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,gBAAgB;QACtB,QAAQ,EAAE,OAAO,EAAE,oCAAoC;QACvD,OAAO,EAAE,qCAAqC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG;KACpE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ternary-locale.js","sourceRoot":"","sources":["../../../src/analyzer/rules/ternary-locale.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,UAAU,kBAAkB,CAChC,IAA8B,EAC9B,GAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAEjC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,iCAAiC;IACjC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAC5B,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,qCAAqC;IACrC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAClE,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvE,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAErC,8CAA8C;IAC9C,MAAM,aAAa,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC,aAAa,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEnD,uBAAuB;IACvB,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAE,IAAI,CAAC,QAA6B,CAAC,IAAI;QAC1C,CAAC,CAAE,IAAI,CAAC,SAA8B,CAAC,IAAI,CAAC;IAE9C,yFAAyF;IACzF,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEpC,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,gBAAgB;QACtB,QAAQ,EAAE,OAAO,EAAE,oCAAoC;QACvD,OAAO,EAAE,qCAAqC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG;QACnE,YAAY,EAAE,sBAAsB,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC"}