ai-i18n-tools 1.0.0

package/docs/ai-i18n-tools-context.md

@@ -0,0 +1,481 @@
+# ai-i18n-tools: AI Agent Context 
+
+This document gives an AI agent the mental model, key decisions, and patterns needed to work effectively with `ai-i18n-tools` without consulting every other doc first. Read this before making code or config changes.
+
+<!-- DOCTOC SKIP -->
+
+---
+
+## What this package does
+
+`ai-i18n-tools` is a CLI + library that automates internationalization for JavaScript/TypeScript projects. It:
+
+1. **Extracts** UI strings from source code (`t("…")` calls) into a master catalog.
+2. **Translates** that catalog and documentation files via LLMs (through OpenRouter).
+3. **Writes** locale-ready JSON files for i18next, plus translated markdown, Docusaurus JSON labels, and standalone SVG assets.
+4. **Exports runtime helpers** for wiring i18next, RTL support, and language selection in any JS environment.
+
+Everything is driven by a single config file: `ai-i18n-tools.config.json`.
+
+---
+
+## Two independent workflows
+
+| | Workflow 1 - UI Strings | Workflow 2 - Documents |
+|---|---|---|
+| **Input** | JS/TS source files with `t("…")` calls | `.md`, `.mdx`, Docusaurus JSON label files |
+| **Output** | `strings.json` (catalog) + per-locale flat JSON files (`de.json`, etc.) | Translated copies of those files at configured output paths |
+| **Cache** | `strings.json` itself (existing translations are preserved) | SQLite database (`cacheDir`) - only new/changed segments go to LLM |
+| **Key command** | `translate-ui` | `translate-docs` |
+| **Sync command** | `sync` | `sync` |
+| **Feature flags** | `extractUIStrings`, `translateUIStrings` | `translateMarkdown`, `translateJSON`, `translateSVG` |
+
+They can be used independently or together in the same config. `sync` runs, in order: `extract` (if enabled), `translate-ui` (if enabled, unless `--no-ui`), `translate-svg` when `features.translateSVG` is true and `config.svg` is set (unless `--no-svg`), then `translate-docs` (unless `--no-docs`). Standalone SVG translation requires the **`translateSVG`** feature plus the top-level **`svg`** block (paths and layout). See the [CLI cheat sheet](#cli-commands-cheat-sheet) for flags.
+
+---
+
+## Config file quick reference
+
+File: `ai-i18n-tools.config.json` (default location - override with `-c <path>`)
+
+```json
+{
+  "sourceLocale": "en-GB",
+  "targetLocales": "src/locales/ui-languages.json",
+
+  "openrouter": {
+    "translationModels": [
+      "qwen/qwen3-235b-a22b-2507",
+      "openai/gpt-4o-mini",
+      "deepseek/deepseek-v3.2",
+      "anthropic/claude-3-haiku",
+      "qwen/qwen3.6-plus",
+      "anthropic/claude-3.5-haiku",
+      "openai/gpt-5.3-codex",
+      "anthropic/claude-sonnet-4.6",
+      "google/gemini-3-flash-preview"
+    ],
+    "maxTokens": 8192,
+    "temperature": 0.2
+  },
+
+  "features": {
+    "extractUIStrings": true,
+    "translateUIStrings": true,
+    "translateMarkdown": true,
+    "translateJSON": false,
+    "translateSVG": true
+  },
+
+  "ui": {
+    "sourceRoots": ["src/"],
+    "stringsJson": "src/locales/strings.json",
+    "flatOutputDir": "src/locales/",
+    "preferredModel": "anthropic/claude-3.5-haiku",
+    "reactExtractor": {
+      "funcNames": ["t", "i18n.t"],
+      "extensions": [".js", ".jsx", ".ts", ".tsx"]
+    }
+  },
+
+  "cacheDir": ".translation-cache",
+  "documentations": [
+    {
+      "contentPaths": ["docs/"],
+      "outputDir": "i18n/",
+      "targetLocales": ["de", "fr"],
+      "jsonSource": "i18n/en",
+      "markdownOutput": {
+        "style": "docusaurus",
+        "docsRoot": "docs"
+      }
+    }
+  ],
+
+  "svg": {
+    "sourcePath": "images",
+    "outputDir": "public/assets",
+    "style": "flat"
+  },
+
+  "glossary": {
+    "uiGlossary": "src/locales/strings.json",
+    "userGlossary": "glossary-user.csv"
+  }
+}
+```
+
+### Key constraints
+
+- `sourceLocale` **must exactly match** the `SOURCE_LOCALE` constant exported from the runtime i18n setup file (`src/i18n.ts` / `src/i18n.js`).
+- `targetLocales` can be a string path to a `ui-languages.json` manifest OR an array of BCP-47 codes.
+- `uiLanguagesPath` is optional, but useful when `targetLocales` is an explicit array and you still want manifest-driven labels and locale filtering.
+- `documentations[].description` is optional text for maintainers (what the block is for); it does not affect translation. When set, it is included in the `translate-docs` headline and `status` headers.
+- `documentations[].targetLocales` limits that block to a subset; effective documentation locales are the **union** across blocks (useful when different trees need different locale sets).
+- `documentations[].markdownOutput.postProcessing` can adjust translated markdown after reassembly, for example by rewriting screenshot paths or rebuilding a language list block.
+- All paths are relative to cwd (where the CLI is invoked).
+- `OPENROUTER_API_KEY` must be set in the environment or a `.env` file.
+
+---
+
+## The `ui-languages.json` manifest
+
+When `targetLocales` is a file path, that file must be a JSON array of this shape:
+
+```json
+[
+  { "code": "en-GB", "label": "English (UK)", "englishName": "English (UK)" },
+  { "code": "de",    "label": "Deutsch",       "englishName": "German" },
+  { "code": "ar",    "label": "العربية",        "englishName": "Arabic" }
+]
+```
+
+- `code` - BCP-47 locale code used in file names and by i18next.
+- `label` - native name shown in language pickers.
+- `englishName` - English name used for display helpers and translation prompts.
+
+This file drives both the translation pipeline and the runtime language-switcher UI. Keep it as the single source of truth for supported locales.
+
+---
+
+## CLI commands cheat sheet
+
+```
+npx ai-i18n-tools init [-t ui-markdown|ui-docusaurus]
+    Write a starter config file. ui-markdown = React/UI-only template.
+    ui-docusaurus = combined UI + docs template.
+
+npx ai-i18n-tools extract
+    Scan source for t("…") calls, write/merge strings.json.
+    Safe to re-run - preserves existing translations.
+
+npx ai-i18n-tools translate-ui [--locale <code>] [--force] [--dry-run] [-j <n>]
+    Translate UI strings only. Reads strings.json, writes flatOutputDir/de.json etc.
+    --force: re-translate all entries per locale. --dry-run: no writes, no API calls. -j: max parallel locales.
+
+npx ai-i18n-tools translate-docs [--locale <code>] [--force | --force-update] …
+    Translate markdown and JSON under documentation paths. Default: skip unchanged files + use segment SQLite cache.
+    --force-update: re-run every file output; segment cache still used (no API for unchanged text).
+    --force: clear file tracking and ignore segment cache reads (full re-translation); new results still write to cache.
+    --stats: print cache stats and exit. --clear-cache [locale]: wipe cache (all or one locale) and exit.
+    --prompt-format xml|json-array|json-object: batch wire format to the model (default xml); does not change validation or cache.
+    Do not combine --force with --force-update (when the docs step runs).
+
+npx ai-i18n-tools translate-svg [--locale <code>] [--force | --force-update] [--no-cache] …
+    Standalone SVG assets from config.svg. Requires features.translateSVG. --no-cache: skip SQLite reads/writes for this run only.
+
+npx ai-i18n-tools sync [--locale <code>] [--force | --force-update] [--no-ui] [--no-svg] [--no-docs] …
+    extract (if enabled), translate-ui (unless --no-ui), translate-svg when features.translateSVG and config.svg (unless --no-svg),
+    translate-docs (unless --no-docs). --force / --force-update apply to the docs step only; if --no-docs, both can be passed without conflict.
+
+npx ai-i18n-tools status
+    Show markdown translation coverage per file × locale.
+
+npx ai-i18n-tools editor
+    Launch a local web editor for the SQLite cache, strings.json, and glossary.
+
+npx ai-i18n-tools cleanup [--dry-run] [--no-backup] [--backup <path>]
+    Runs sync --force-update first, then maintains the SQLite cache: stale segment rows; orphaned file_tracking keys (doc-block:, svg-assets:, …);
+    orphaned translation rows whose filepath metadata points at a missing file.
+    Backs up cache.db under the cache dir before modifications unless --no-backup.
+
+npx ai-i18n-tools glossary-generate
+    Write an empty glossary-user.csv template.
+```
+
+Global flags: `-c <config>` (config path), `-v` (verbose/debug output), `-w` / `--write-logs [path]` (tee console output to a log file; default path: under `cacheDir`).
+
+---
+
+## Workflow 1 - UI strings: how data flows
+
+```
+source files (JS/TS)
+    │  i18next-scanner Parser finds t("literal") and i18n.t("literal")
+    ▼
+strings.json  - master catalog
+    {
+      "<md5-8-hex>": {
+        "source": "The English string",
+        "translated": { "de": "Der deutsche Text", "pt-BR": "O texto em português" },
+        "models": { "de": "…", "pt-BR": "…" }
+      }
+    }
+    │  translate-ui reads this, sends batches to OpenRouter, fills missing locales and records model ids per locale
+    ▼
+src/locales/de.json    - flat map: source string → translation
+    { "The English string": "Der deutsche Text", "Save": "Speichern" }
+src/locales/pt-BR.json
+    ...
+```
+
+**Only literal strings are extractable.** Variables, expressions, or template literals as the key are not found:
+
+```js
+t('Save')                   // ✓ extracted
+t('Hello {{name}}', {name}) // ✓ extracted as "Hello {{name}}"
+t(labelVar)                 // ✗ not extracted - variable key
+t(`Hello ${name}`)          // ✗ not extracted - template literal
+```
+
+i18next uses the key-as-default model: missing translations fall back to the key itself (the English source string). The `parseMissingKeyHandler` in `defaultI18nInitOptions` handles this.
+
+---
+
+## Workflow 2 - Document translation: how data flows
+
+```
+source files (md/mdx/json)
+    │  Extractor produces typed segments with SHA-256 hash
+    ▼
+PlaceholderHandler  - replaces URLs, admonitions, anchors with opaque tokens
+    ▼
+TranslationCache lookup (SQLite)
+    │  cache hit → use stored translation
+    │  cache miss → send batch to OpenRouter
+    ▼
+PlaceholderHandler.restore  - tokens replaced back with original syntax
+    ▼
+resolveDocumentationOutputPath  → write to output file
+```
+
+**Cache key**: SHA-256 first 16 hex chars of whitespace-normalized segment content × locale. The cache lives under root `cacheDir` (a `cache.db` SQLite file), shared by all `documentations` blocks. Each row stores the `model` that last translated the segment; saving an edit in the `editor` sets `model` to `user-edited` (same sentinel as UI `strings.json` `models`).
+
+**CLI**: `--force-update` bypasses only the *file-level* skip (rebuild outputs) while still using segment cache. `--force` clears per-file tracking and skips segment cache reads for API calls. See the getting started guide for the full flag table.
+
+**Standalone SVGs**: handled by `translate-svg` when `features.translateSVG` is true and the top-level `svg` config block is set. They use the same OpenRouter/cache ideas, but not the `documentations` pipeline.
+
+**Output styles** (`markdownOutput.style`):
+
+| Style | Example |
+|---|---|
+| `"nested"` (default) | `docs/guide.md` → `i18n/de/docs/guide.md` |
+| `"docusaurus"` | `docs/guide.md` → `i18n/de/docusaurus-plugin-content-docs/current/guide.md` |
+| `"flat"` | `docs/guide.md` → `i18n/guide.de.md` |
+| custom `pathTemplate` | any layout using `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`, `{docsRoot}`, `{relativeToDocsRoot}` |
+
+Flat-style output auto-rewrites relative links between pages (e.g. `[Guide](./guide.md)` → `guide.de.md`).
+
+---
+
+## Runtime integration - wiring i18next
+
+The package exports helpers from `'ai-i18n-tools/runtime'` that remove boilerplate. The minimal setup:
+
+```ts
+// src/i18n.ts  - import this at the top of your entry point
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import uiLanguages from './locales/ui-languages.json';
+import {
+  defaultI18nInitOptions,
+  wrapI18nWithKeyTrim,
+  makeLoadLocale,
+  applyDirection,
+} from 'ai-i18n-tools/runtime';
+
+// Must match sourceLocale in ai-i18n-tools.config.json exactly
+export const SOURCE_LOCALE = 'en-GB';
+
+void i18n.use(initReactI18next).init(defaultI18nInitOptions(SOURCE_LOCALE));
+wrapI18nWithKeyTrim(i18n);
+i18n.on('languageChanged', applyDirection);
+applyDirection(i18n.language);
+
+// Dynamic imports for non-source locales
+const localeLoaders = Object.fromEntries(
+  uiLanguages
+    .filter(({ code }) => code !== SOURCE_LOCALE)
+    .map(({ code }) => [code, () => import(`./locales/${code}.json`)])
+);
+
+export const loadLocale = makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);
+export default i18n;
+```
+
+**Loading a locale on demand** (e.g. when user switches language):
+
+```ts
+await loadLocale(code);
+i18n.changeLanguage(code);
+```
+
+`loadLocale` is a no-op for the source locale - it only fetches non-source locales.
+
+---
+
+## Runtime helpers reference
+
+All exported from `'ai-i18n-tools/runtime'`. Work in any JS environment (browser, Node.js, Edge, Deno). No i18next peer dependency required.
+
+| Export | Signature | Purpose |
+|---|---|---|
+| `defaultI18nInitOptions` | `(sourceLocale?: string) => i18nextInitOptions` | Standard i18next init for key-as-default setup |
+| `wrapI18nWithKeyTrim` | `(i18n: I18nLike) => void` | Trim keys before lookup and apply `{{var}}` interpolation for the source locale (where `parseMissingKeyHandler` returns the raw key) |
+| `makeLoadLocale` | `(i18n, loaders, sourceLocale?) => (lang: string) => Promise<void>` | Factory for async locale loading |
+| `getTextDirection` | `(lng: string) => 'ltr' \| 'rtl'` | RTL detection by BCP-47 code |
+| `applyDirection` | `(lng: string, element?: Element) => void` | Set `dir` on `document.documentElement` (no-op in Node.js) |
+| `getUILanguageLabel` | `(lang: UiLanguageEntry, t: TranslateFn) => string` | Translated label for settings-page dropdowns |
+| `getUILanguageLabelNative` | `(lang: UiLanguageEntry) => string` | Native label for header menus (no `t()` call) |
+| `interpolateTemplate` | `(str: string, vars: Record<string, string \| number \| boolean>) => string` | Low-level `{{var}}` substitution on a plain string (used internally by `wrapI18nWithKeyTrim`; rarely needed in app code) |
+| `flipUiArrowsForRtl` | `(text, isRtl: boolean) => string` | Flip `→` to `←` for RTL layouts |
+| `RTL_LANGS` | `ReadonlySet<string>` | Set of BCP-47 codes treated as RTL |
+
+---
+
+## Programmatic API
+
+Import from `'ai-i18n-tools'`. Useful when you need to call translation steps from a build script or CI pipeline.
+
+```ts
+import {
+  loadI18nConfigFromFile,
+  runTranslateUI,
+} from 'ai-i18n-tools';
+
+const config = loadI18nConfigFromFile('ai-i18n-tools.config.json');
+const summary = await runTranslateUI(config, {
+  cwd: process.cwd(),
+  locales: config.targetLocales,
+  force: false,
+  dryRun: false,
+  verbose: false,
+});
+// summary.stringsUpdated - number of newly translated strings
+// summary.localesTouched - locale codes processed
+```
+
+Other useful exports for custom pipelines:
+
+| Export | Use when |
+|---|---|
+| `loadI18nConfigFromFile(path, cwd?)` | Load and validate the config |
+| `parseI18nConfig(rawObject)` | Validate a config object you built in code |
+| `TranslationCache` | Direct SQLite cache access |
+| `UIStringExtractor` | Extract `t("…")` calls from JS/TS files |
+| `MarkdownExtractor` | Parse markdown into translatable segments |
+| `JsonExtractor` | Parse Docusaurus JSON label files |
+| `SvgExtractor` | Parse SVG text elements |
+| `OpenRouterClient` | Make translation requests directly |
+| `PlaceholderHandler` | Protect/restore markdown syntax around translation |
+| `splitTranslatableIntoBatches` | Group segments into LLM-sized batches |
+| `validateTranslation` | Structural checks after a translation call |
+| `resolveDocumentationOutputPath` | Compute the output file path for a translated document |
+| `Glossary` / `GlossaryMatcher` | Load and apply a translation glossary |
+
+---
+
+## Glossary
+
+The glossary ensures consistent terminology across translations.
+
+- **Auto-built glossary** (`glossary.uiGlossary`): reads `strings.json` and uses existing translations as a hint source. No CSV needed.
+- **User glossary** (`glossary.userGlossary`): a CSV file with columns `Original language string`, `locale`, `Translation` (or `en`, `locale`, `Translation`). Generate an empty template with `npx ai-i18n-tools glossary-generate`.
+
+Glossary hints are injected into the LLM system prompt - they are suggestions, not hard replacements.
+
+---
+
+## Extension points
+
+### Custom function names
+
+```json
+{ "ui": { "reactExtractor": { "funcNames": ["t", "i18n.t", "translate"] } } }
+```
+
+### Custom extractor
+
+```ts
+import { BaseExtractor, type Segment } from 'ai-i18n-tools';
+
+class MyExtractor extends BaseExtractor {
+  readonly name = 'my-format';
+  canHandle(filepath: string) { return filepath.endsWith('.myext'); }
+  extract(content: string): Segment[] { /* return typed segments */ }
+  reassemble(segments: Segment[], translations: Map<string, string>): string { /* rebuild file */ }
+}
+```
+
+### Custom output path
+
+```json
+{
+  "documentations": [
+    {
+      "markdownOutput": {
+        "pathTemplate": "{outputDir}/{locale}/{relativeToDocsRoot}"
+      }
+    }
+  ]
+}
+```
+
+Available placeholders: `{outputDir}`, `{locale}`, `{LOCALE}`, `{relPath}`, `{stem}`, `{basename}`, `{extension}`, `{docsRoot}`, `{relativeToDocsRoot}`.
+
+---
+
+## Common tasks and what to do
+
+| Task | What to run / change |
+|---|---|
+| Add a new locale | Add it to `ui-languages.json` (or `targetLocales` array), then run `translate-docs` / `translate-ui` / `sync` |
+| Translate only one locale | `npx ai-i18n-tools translate-docs --locale de` (or `translate-ui`, `sync`) |
+| Add a new UI string | Write `t('My new string')` in source, then run `extract` then `translate-ui` |
+| Update a translation manually | Edit `strings.json` directly (`translated`), or use `editor` (sets `models[locale]` to `user-edited`). `translate-ui` skips locales that already have text unless you use `--force` |
+| Translate new/updated docs only | Run `translate-docs` - file + segment cache skips unchanged work automatically |
+| Rebuild doc outputs without re-calling the API for unchanged segments | `npx ai-i18n-tools sync  --force-update` |
+| Full doc re-translation (ignore segment cache) | `npx ai-i18n-tools translate-docs --force` |
+| Free up cache space | `npx ai-i18n-tools cleanup` or `translate-docs --clear-cache` |
+| Inspect what is untranslated | `npx ai-i18n-tools status` |
+| Change the translation model | Edit `openrouter.translationModels` (first is primary, rest are fallbacks). For **UI only**, optional `ui.preferredModel` is tried before that list. |
+| Wire i18next in a new project | See [Runtime integration](#runtime-integration---wiring-i18next) above |
+| Translate docs to fewer locales than UI | Set `documentations[].targetLocales` on the relevant block(s), or use a smaller union |
+| Run extract + UI + SVG + docs in one command | `npx ai-i18n-tools sync` (SVG runs when `features.translateSVG` and `svg` are set) - use `--no-ui`, `--no-svg`, or `--no-docs` to skip a stage (e.g. UI + SVG only: `--no-docs`) |
+
+---
+
+## Environment variables
+
+| Variable | Effect |
+|---|---|
+| `OPENROUTER_API_KEY` | **Required.** Your OpenRouter API key. |
+| `OPENROUTER_BASE_URL` | Override the API base URL. |
+| `I18N_SOURCE_LOCALE` | Override `sourceLocale` at runtime. |
+| `I18N_TARGET_LOCALES` | Comma-separated locale codes to override `targetLocales`. |
+| `I18N_LOG_LEVEL` | Logger level (`debug`, `info`, `warn`, `error`, `silent`). |
+| `NO_COLOR` | When `1`, disable ANSI colours in log output. |
+| `I18N_LOG_SESSION_MAX` | Max lines kept per log session (default `5000`). |
+
+---
+
+## Files generated / maintained by the tool
+
+| File | Owned by | Notes |
+|---|---|---|
+| `ai-i18n-tools.config.json` | You | Main config. Edit manually. |
+| `ui-languages.json` (wherever configured) | You | Locale manifest. Edit manually to add/remove locales. |
+| `strings.json` (wherever configured) | Tool (`extract` / `translate-ui` / `editor`) | Master UI catalog: `source`, `translated`, optional `models` (per locale: OpenRouter model id or `user-edited`), optional `locations`. Safe to edit `translated`; do not rename keys. |
+| `{flatOutputDir}/de.json`, etc. | Tool (`translate-ui`) | Per-locale flat maps (source → translation only, no `models`). Do not edit — regenerated on each `translate-ui`. |
+| `{cacheDir}/*.db` | Tool | SQLite translation cache (per-segment `model` metadata; `user-edited` after manual saves in `editor`). Do not edit directly; use `editor` or `cleanup`. |
+| `glossary-user.csv` | You | Term overrides. Generate template with `glossary-generate`. |
+
+---
+
+## Source layout summary
+
+```
+src/
+├── index.ts               Public API (all programmatic exports)
+├── cli/                   CLI command implementations
+├── core/                  Config loading, types (Zod), SQLite cache, prompt builder, output paths
+├── extractors/            Segment extractors: JS/TS, Markdown, JSON, SVG
+├── processors/            Placeholder protection, batch splitting, post-translation validation, link rewriting
+├── api/openrouter.ts      HTTP client for OpenRouter with model fallback and rate-limit handling
+├── glossary/              Glossary loading (CSV + auto from strings.json) and term matching
+├── runtime/               i18next helpers, RTL helpers, display helpers (no i18next import)
+├── server/                Local Express web editor for cache/glossary
+└── utils/                 Logger, SHA-256 hash, .translate-ignore parser
+```
+
+The entry point for all public types and functions is `src/index.ts`.

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "ai-i18n-tools",
+  "version": "1.0.0",
+  "description": "Unified internationalization toolkit for Node.js apps and documentation with AI translation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    }
+  },
+  "bin": {
+    "ai-i18n-tools": "dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "docs/",
+    "translated-docs/",
+    "LICENSE"
+  ],
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "translation",
+    "react",
+    "docusaurus",
+    "openrouter",
+    "localization",
+    "multilingual",
+    "cache",
+    "cli"
+  ],
+  "author": "Waldemar Scudeller Jr.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wsj-br/ai-i18n-tools.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wsj-br/ai-i18n-tools/issues"
+  },
+  "homepage": "https://github.com/wsj-br/ai-i18n-tools#readme",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "csv-parse": "^6.2.1",
+    "express": "^5.2.1",
+    "gray-matter-es": "^0.2.1",
+    "i18next-scanner": "^4.6.0",
+    "ignore": "^7.0.5",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "micromark-extension-gfm": "^3.0.0",
+    "unist-util-visit": "^5.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/express": "^5.0.6",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^25.6.0",
+    "@types/unist": "^3.0.3",
+    "@vitest/coverage-v8": "^4.1.4",
+    "eslint": "^10.2.0",
+    "github-slugger": "^2.0.0",
+    "globals": "^17.4.0",
+    "prettier": "^3.8.2",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.1",
+    "vitest": "^4.1.4"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.16.0",
+    "pnpm": ">=10.33.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "glob": "^13.0.6",
+    "test-exclude": "^8.0.0"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-edit-cache-app.mjs",
+    "dev": "node scripts/copy-edit-cache-app.mjs && tsc --watch",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "clean": "rm -rf dist/",
+    "i18n:extract": "ai-i18n-tools extract",
+    "i18n:sync": "ai-i18n-tools sync",
+    "i18n:translate": "ai-i18n-tools translate-docs",
+    "i18n:cleanup": "ai-i18n-tools cleanup",
+    "update-all": "pnpm build && ai-i18n-tools cleanup && cd examples/console-app && ai-i18n-tools cleanup && cd ../nextjs-app && ai-i18n-tools cleanup",
+    "clean-temp": "find . \\( -name '*.log' -o -name 'cache.db.backup*.sqlite' \\) -print && read -p '\nDelete these files? (y/n) ' ans && [ \"$ans\" = \"y\" ] && find . \\( -name '*.log' -o -name 'cache.db.backup*.sqlite' \\) -delete"
+  }
+}