translint 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# i18n-checker
+
+Premium i18n quality tooling for modern projects. Detect missing keys, unused translations,
+placeholder mismatches, and generate a premium HTML report your team will actually want to open.
+
+## Why i18n-checker
+
+Most translation checks are brittle or noisy. This tool focuses on **real issues**, **clean output**,
+and **useful reports** that can be used in CI and shared with teams.
+
+What you get:
+- Missing, extra, unused keys
+- Empty/null values, same-as-key values
+- Placeholder mismatches and structural inconsistencies
+- Dynamic key warnings
+- Quality score with breakdowns
+- Premium standalone HTML audit report
+- Auto-fix and sync modes for safe remediation
+
+## Quickstart
+
+### Run with npx
+
+```bash
+npx -y i18n-checker check
+```
+
+### Install
+
+```bash
+npm install -D i18n-checker
+```
+
+### Setup wizard (recommended)
+
+```bash
+npx -y i18n-checker init
+```
+
+The wizard auto-detects your project structure, asks the right questions, and generates
+`i18n-checker.config.js`.
+
+## CLI Commands
+
+### `check`
+
+Analyze and print issues.
+
+```bash
+i18n-checker check --format json --fail-on-error
+```
+
+### `report`
+
+Generate a premium HTML report.
+
+```bash
+i18n-checker report --output i18n-report.html --open
+```
+
+### `score`
+
+Compute and print the quality score.
+
+```bash
+i18n-checker score
+```
+
+### `fix`
+
+Apply safe fixes (add missing keys, optionally remove unused).
+
+```bash
+i18n-checker fix --source-lang en --strategy todo --sort
+```
+
+### `sync`
+
+Synchronize all locales from the source language.
+
+```bash
+i18n-checker sync --source-lang en --strategy source
+```
+
+## Common Options (all commands)
+
+- `--config <path>`: Path to config file
+- `--src <path>`: Source directory or glob (repeatable)
+- `--locales <path>`: Locales root directory
+- `--source-lang <code>`: Reference language
+- `--ignore <pattern>`: Ignore glob (repeatable)
+- `--verbose`: Verbose output
+
+### Check-specific options
+
+- `--format <pretty|json>`
+- `--fail-on-error`
+- `--framework <auto|i18next|next-intl|react-intl|angular>`
+- `--include-dynamic-warnings`
+
+### Report-specific options
+
+- `--output <path>`
+- `--open`
+
+### Fix/Sync options
+
+- `--strategy <empty|source|todo>`
+- `--dry-run`
+- `--sort`
+- `--remove-unused` (fix only)
+
+## Configuration
+
+Config file: `i18n-checker.config.js` (or `.json`, `.ts`)
+
+```js
+module.exports = {
+  projectRoot: process.cwd(),
+  source: ['src'],
+  locales: {
+    dir: 'src/i18n',
+    extension: '.json',
+    fileName: 'trad',
+    sourceLang: 'en',
+  },
+  patterns: {
+    prefix: 'trad.',
+    functions: ['t', 'i18n.t', 'translate.instant', 'this.translate.instant'],
+  },
+  ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**', '**/coverage/**'],
+  rules: {
+    detectEmpty: true,
+    detectNull: true,
+    detectSameAsKey: true,
+    detectUnused: true,
+    detectDuplicateTranslations: true,
+    detectPlaceholderMismatch: true,
+    detectStructureMismatch: true,
+  },
+  report: {
+    title: 'i18n Quality Report',
+    darkMode: true,
+  },
+  fix: {
+    strategy: 'todo',
+    placeholder: 'TODO_TRANSLATE',
+    sort: true,
+  },
+};
+```
+
+If you decide not to auto-load config during `init`, run:
+
+```bash
+i18n-checker check --config path/to/i18n-checker.config.js
+```
+
+## AST Coverage
+
+Currently supported call patterns:
+- `t('key')`
+- `i18n.t('key')`
+- `translate.instant('key')`
+- `this.translate.instant('key')`
+
+Literal `trad.*` strings are also detected.
+
+## Report Output
+
+The HTML report is a single, portable file with:
+- KPI cards
+- Score ring
+- Severity badges
+- Detailed issues table
+- Recommendations
+
+## CI Example
+
+```bash
+i18n-checker check --format json --fail-on-error
+```
+
+## Roadmap
+
+- Framework adapters (Next.js, react-intl, angular templates)
+- Pluralization consistency
+- Richer dynamic key inference
+- Report theming and branding
+
+## License
+
+MIT

package/bin/translint.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/cli.js');