@katerynakhar/i18n-keeper 0.16.0

package/dist/scan.js

@@ -0,0 +1,250 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { basename, join, relative, resolve, sep } from 'node:path';
+import { FormatError } from './formats/error.js';
+import { readJsonLocale } from './formats/json.js';
+import { readPhpLocale } from './formats/php.js';
+import { readPoLocale } from './formats/po.js';
+import { readYamlLocale } from './formats/yaml.js';
+import { DEFAULT_RULES, } from './types.js';
+import { DEFAULT_SYNTAXES } from './placeholders.js';
+const CANDIDATE_DIRS = [
+    'locales',
+    'src/locales',
+    'public/locales',
+    'app/locales',
+    'i18n',
+    'src/i18n',
+    'lang',
+    'resources/lang',
+    'translations',
+    'src/translations',
+    'config/locales',
+    'locale',
+    'po',
+];
+/** Formats we can read, longest extension first so stripping is unambiguous. */
+const EXTENSIONS = ['.json', '.yaml', '.php', '.yml', '.pot', '.po'];
+function readerFor(file) {
+    if (file.endsWith('.php'))
+        return readPhpLocale;
+    if (file.endsWith('.po') || file.endsWith('.pot'))
+        return readPoLocale;
+    if (file.endsWith('.yml') || file.endsWith('.yaml'))
+        return readYamlLocale;
+    return readJsonLocale;
+}
+function stripExtension(name) {
+    for (const ext of EXTENSIONS) {
+        if (name.endsWith(ext))
+            return name.slice(0, -ext.length);
+    }
+    return null;
+}
+const LOCALE_CODE = /^[a-z]{2,3}(?:[-_][A-Za-z0-9]{2,8})*$/;
+export class ScanError extends Error {
+}
+function isDir(p) {
+    try {
+        return statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Finds the directory holding locale files, or throws with the paths it tried. */
+export function findLocalesDir(root, explicit) {
+    if (explicit) {
+        const dir = resolve(root, explicit);
+        if (!isDir(dir))
+            throw new ScanError(`Locales directory not found: ${dir}`);
+        return dir;
+    }
+    for (const candidate of CANDIDATE_DIRS) {
+        const dir = resolve(root, candidate);
+        if (isDir(dir) && listLocales(dir).locales.length > 0)
+            return dir;
+    }
+    throw new ScanError(`No locales directory found under ${root}.\nTried: ${CANDIDATE_DIRS.join(', ')}\nPass one explicitly with --locales <path>.`);
+}
+/** `locales/en.json` is flat; `locales/en/common.json` is nested. */
+export function listLocales(dir) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const nested = entries
+        .filter((e) => e.isDirectory() && LOCALE_CODE.test(e.name))
+        .map((e) => e.name);
+    if (nested.length > 0)
+        return { layout: 'nested', locales: nested.sort() };
+    const flat = entries
+        .filter((e) => e.isFile())
+        .map((e) => stripExtension(e.name))
+        .filter((name) => name !== null && LOCALE_CODE.test(name));
+    return { layout: 'flat', locales: [...new Set(flat)].sort() };
+}
+function collectLocaleFiles(dir, acc = []) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            collectLocaleFiles(full, acc);
+        else if (entry.isFile() && stripExtension(entry.name) !== null)
+            acc.push(full);
+    }
+    return acc;
+}
+/**
+ * Whether a bundle's source text comes from msgid rather than from the locale
+ * itself. In gettext every catalogue carries the untranslated string, so the
+ * locale named as the source only supplies the keys.
+ */
+export function sourceIsMsgid(bundle) {
+    return bundle.files.length > 0 && bundle.files.every((f) => f.endsWith('.po') || f.endsWith('.pot'));
+}
+export function loadBundle(config, locale) {
+    const target = {
+        skipped: [],
+        leaves: new Map(),
+        containers: new Set(),
+        plurals: new Map(),
+        nplurals: null,
+    };
+    const files = [];
+    const unreadable = [];
+    const isSource = locale === config.sourceLocale;
+    /**
+     * A malformed file is reported, not thrown. A project with a hundred
+     * locales and one bad file should still be checked; refusing to read any
+     * of it is how a linter becomes something people stop running.
+     */
+    const read = (file, namespace) => {
+        try {
+            readerFor(file)(file, namespace, locale, isSource, target);
+        }
+        catch (err) {
+            if (!(err instanceof FormatError))
+                throw err;
+            unreadable.push({ file, message: err.message });
+        }
+    };
+    if (config.layout === 'flat') {
+        // A locale may be en.json or en.php; both are read when both exist.
+        for (const ext of EXTENSIONS) {
+            const file = join(config.localesDir, `${locale}${ext}`);
+            if (!existsSync(file))
+                continue;
+            files.push(file);
+            read(file, '');
+        }
+        if (files.length === 0) {
+            throw new ScanError(`No locale file for "${locale}" in ${config.localesDir}`);
+        }
+    }
+    else {
+        const localeRoot = join(config.localesDir, locale);
+        for (const file of collectLocaleFiles(localeRoot).sort()) {
+            // lang/en/shop/pricing.php -> "shop.pricing";
+            // locale/fr/LC_MESSAGES/messages.po -> "messages", since the gettext
+            // directory is layout, not namespace.
+            const relativePath = relative(localeRoot, file);
+            const namespace = (stripExtension(relativePath) ?? relativePath)
+                .split(sep)
+                .filter((part) => part !== 'LC_MESSAGES')
+                .join('.');
+            files.push(file);
+            read(file, namespace);
+        }
+    }
+    return {
+        locale,
+        files,
+        skipped: target.skipped,
+        unreadable,
+        leaves: target.leaves,
+        containers: target.containers,
+        plurals: target.plurals,
+        nplurals: target.nplurals,
+    };
+}
+export function detectProject(root, opts = {}) {
+    const resolvedRoot = resolve(root);
+    if (!existsSync(resolvedRoot))
+        throw new ScanError(`Path not found: ${resolvedRoot}`);
+    const localesDir = findLocalesDir(resolvedRoot, opts.localesDir);
+    const { layout, locales } = listLocales(localesDir);
+    if (locales.length === 0)
+        throw new ScanError(`No locale files in ${localesDir}`);
+    let sourceLocale = opts.sourceLocale ?? '';
+    if (sourceLocale && !locales.includes(sourceLocale)) {
+        throw new ScanError(`Source locale "${sourceLocale}" not among: ${locales.join(', ')}`);
+    }
+    // Laravel's :name is off by default because it false-positives on prose,
+    // but in a PHP project it is the interpolation syntax actually in use — and
+    // Laravel keeps string-keyed translations in JSON, so the file extension
+    // alone is not the signal. A composer.json or a lang/ directory is.
+    const syntaxes = [...DEFAULT_SYNTAXES];
+    if (usesLaravelPlaceholders(resolvedRoot, localesDir, layout, locales))
+        syntaxes.push('laravel');
+    const config = {
+        root: resolvedRoot,
+        localesDir,
+        sourceLocale: sourceLocale || locales[0],
+        locales,
+        layout,
+        placeholderSyntaxes: syntaxes,
+        ignoreIdentical: [],
+        rules: { ...DEFAULT_RULES },
+    };
+    if (!sourceLocale) {
+        // Plain `en` first; then a single regional English, which is the source in
+        // a project that spells it en-US. Several of them means none is: Sphinx
+        // carries en_DE and en_GB purely for date formats, so there the most
+        // complete catalogue is the better guess than whichever sorts first.
+        const english = locales.filter((l) => /^en([-_]|$)/.test(l));
+        config.sourceLocale =
+            locales.find((l) => l === 'en') ??
+                (english.length === 1 ? english[0] : mostComplete(config, locales));
+    }
+    return config;
+}
+/** The locale with the most keys, which in practice is the one others follow. */
+function mostComplete(config, locales) {
+    let best = locales[0];
+    let bestCount = -1;
+    for (const locale of locales) {
+        let count = 0;
+        try {
+            count = loadBundle({ ...config, sourceLocale: locale }, locale).leaves.size;
+        }
+        catch {
+            continue; // an unreadable locale simply cannot be the source
+        }
+        if (count > bestCount) {
+            best = locale;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+function hasPhpLocales(localesDir, layout, locales) {
+    if (layout === 'flat') {
+        return locales.some((locale) => existsSync(join(localesDir, `${locale}.php`)));
+    }
+    return locales.some((locale) => {
+        const dir = join(localesDir, locale);
+        return isDir(dir) && collectLocaleFiles(dir).some((file) => file.endsWith('.php'));
+    });
+}
+/**
+ * Whether this project interpolates the PHP way.
+ *
+ * Tying it to the .php extension missed every Laravel app that keeps its
+ * string-keyed translations in lang/xx.json — which is Laravel's own
+ * convention, so the placeholders went unchecked in exactly the projects the
+ * syntax exists for.
+ */
+function usesLaravelPlaceholders(root, localesDir, layout, locales) {
+    if (hasPhpLocales(localesDir, layout, locales))
+        return true;
+    if (existsSync(join(root, 'composer.json')))
+        return true;
+    return basename(localesDir) === 'lang';
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

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

package/dist/translate.d.ts

@@ -0,0 +1,93 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { type Glossary } from './glossary.js';
+import { type Limits } from './lengths.js';
+import type { Config, Finding, LocaleBundle } from './types.js';
+/**
+ * The one part of this tool that needs a network and cannot be verified by
+ * reading the output. So it is not trusted: every proposal is put back through
+ * the same deterministic checks the linter already applies, and anything that
+ * fails is rejected rather than written.
+ */
+export declare const DEFAULT_MODEL = "claude-opus-5";
+export declare const DEFAULT_BATCH = 20;
+export declare const DEFAULT_CAP = 50;
+export type JobKind = 'fill' | 'repair' | 'refresh';
+export declare const JOB_KINDS: readonly JobKind[];
+/**
+ * Defects worth handing back to the model.
+ *
+ * A rule belongs here only if `validate` can confirm the repair afterwards.
+ * That is the whole selection principle: a fix the gate cannot check is a fix
+ * nobody can trust, so those findings are left for a human.
+ *
+ * It excludes `identical_to_source` (often correct — "Email" is "Email" in
+ * French, and forcing a change would make it worse), `plural_extra_category`
+ * and `plural_selector_lost` (the single-string validator does not check for
+ * either, so a repair could not be verified).
+ */
+export declare const REPAIRABLE_RULES: Set<string>;
+export interface Job {
+    locale: string;
+    key: string;
+    source: string;
+    kind: JobKind;
+    /** The translation being replaced: broken for a repair, outdated for a refresh. */
+    previous: string | null;
+    /** For a repair, exactly what the linter found wrong. */
+    problems: string[];
+    placeholders: string[];
+    glossary: Array<{
+        term: string;
+        accepted: string[];
+    }>;
+    doNotTranslate: string[];
+    maxWidth: number | null;
+    isIcuPlural: boolean;
+}
+export interface Proposal {
+    locale: string;
+    key: string;
+    kind: JobKind;
+    source: string;
+    value: string;
+    accepted: boolean;
+    /** Deterministic checks the proposal failed, if any. */
+    rejections: string[];
+    attempts: number;
+}
+/** Turns a lint report into a work list. */
+export declare function collectJobs(config: Config, findings: Finding[], source: LocaleBundle, glossary: Glossary | null, limits: Limits | null, locales?: string[], kinds?: JobKind[]): Job[];
+/** What `validate` needs to judge a string; a full Job satisfies it. */
+export type Constraints = Pick<Job, 'source' | 'locale' | 'maxWidth'>;
+/** The same rules the linter enforces, applied to one proposed string. */
+export declare function validate(config: Config, job: Constraints, proposed: string, glossary: Glossary | null): string[];
+export interface TranslateOptions {
+    model: string;
+    effort: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    client?: Anthropic;
+}
+/** The model declined one batch on content grounds; other batches may still run. */
+export declare class TranslationRefused extends Error {
+}
+/** One request for one locale's batch. Returns text keyed by job index. */
+export declare function requestBatch(jobs: Job[], locale: string, options: TranslateOptions, feedback?: Map<number, string[]>): Promise<Map<number, string>>;
+export interface TranslationRun {
+    proposals: Proposal[];
+    /**
+     * Why the run stopped early, if it did. Anything that is not a content
+     * refusal — no credentials, a rate limit, a network failure — will hit every
+     * remaining batch the same way, so the run stops instead of reporting the
+     * same infrastructure error once per string.
+     */
+    aborted: string | null;
+}
+export interface RunOptions extends TranslateOptions {
+    batchSize: number;
+    /** Called before each request so the caller can report progress. */
+    onBatch?: (locale: string, size: number, attempt: number) => void;
+}
+/**
+ * Translates a work list, validating every proposal and retrying once with the
+ * specific failures handed back to the model.
+ */
+export declare function runTranslation(config: Config, jobs: Job[], glossary: Glossary | null, options: RunOptions): Promise<TranslationRun>;