@katerynakhar/i18n-keeper 0.16.0

package/dist/formats/php.js

@@ -0,0 +1,356 @@
+import { readFileSync } from 'node:fs';
+import { FormatError } from './error.js';
+import { flattenValue } from './flatten.js';
+/**
+ * Parses the `<?php return [...];` subset that Laravel language files use.
+ *
+ * Deliberately a parser and not an evaluator: locale files come from the
+ * repository being linted, so running them would mean executing untrusted code,
+ * and it would force PHP onto every machine running the linter. Anything
+ * outside the literal subset is a clear error rather than a guess.
+ */
+export class PhpParseError extends FormatError {
+    constructor(file, line, message) {
+        super(file, message, line);
+    }
+}
+const IDENT_START = /[A-Za-z_\x80-￿]/;
+class Parser {
+    text;
+    file;
+    pos = 0;
+    layout = { values: new Map(), arrays: new Map() };
+    constructor(text, file) {
+        this.text = text;
+        this.file = file;
+    }
+    /** The indentation of the line `at` sits on. */
+    indentAt(at) {
+        const lineStart = this.text.lastIndexOf('\n', at - 1) + 1;
+        const match = /^[ \t]*/.exec(this.text.slice(lineStart, at));
+        return match ? match[0] : '';
+    }
+    lineAt(pos) {
+        let line = 1;
+        for (let i = 0; i < pos && i < this.text.length; i++) {
+            if (this.text[i] === '\n')
+                line++;
+        }
+        return line;
+    }
+    error(message, pos = this.pos) {
+        throw new PhpParseError(this.file, this.lineAt(pos), message);
+    }
+    atEnd() {
+        return this.pos >= this.text.length;
+    }
+    /** Whitespace and all three PHP comment styles. */
+    skipTrivia() {
+        for (;;) {
+            while (!this.atEnd() && /\s/.test(this.text[this.pos]))
+                this.pos++;
+            if (this.text.startsWith('//', this.pos) || this.text.startsWith('#', this.pos)) {
+                const nl = this.text.indexOf('\n', this.pos);
+                this.pos = nl === -1 ? this.text.length : nl + 1;
+                continue;
+            }
+            if (this.text.startsWith('/*', this.pos)) {
+                const end = this.text.indexOf('*/', this.pos + 2);
+                if (end === -1)
+                    this.error('Unterminated block comment');
+                this.pos = end + 2;
+                continue;
+            }
+            return;
+        }
+    }
+    eat(token) {
+        this.skipTrivia();
+        if (this.text.startsWith(token, this.pos)) {
+            this.pos += token.length;
+            return true;
+        }
+        return false;
+    }
+    eatKeyword(word) {
+        this.skipTrivia();
+        const slice = this.text.slice(this.pos, this.pos + word.length);
+        if (slice.toLowerCase() !== word)
+            return false;
+        const next = this.text[this.pos + word.length];
+        if (next !== undefined && /[\w]/.test(next))
+            return false;
+        this.pos += word.length;
+        return true;
+    }
+    expect(token, what = token) {
+        if (!this.eat(token))
+            this.error(`Expected ${what}`);
+    }
+    parseFile() {
+        const open = this.text.indexOf('<?php');
+        if (open === -1)
+            this.error('Missing <?php opening tag', 0);
+        this.pos = open + '<?php'.length;
+        // `declare(strict_types=1);` and similar preamble statements.
+        while (this.eatKeyword('declare')) {
+            const close = this.text.indexOf(')', this.pos);
+            if (close === -1)
+                this.error('Unterminated declare()');
+            this.pos = close + 1;
+            this.eat(';');
+        }
+        if (!this.eatKeyword('return')) {
+            this.error('Expected `return` — a language file must return an array');
+        }
+        const value = this.parseValue('');
+        this.expect(';');
+        this.skipTrivia();
+        if (this.eat('?>'))
+            this.skipTrivia();
+        if (!this.atEnd())
+            this.error('Unexpected content after the returned array');
+        return value;
+    }
+    parseValue(path) {
+        this.skipTrivia();
+        if (this.atEnd())
+            this.error('Unexpected end of file');
+        const ch = this.text[this.pos];
+        if (ch === '[') {
+            this.pos++;
+            return this.parseArrayBody(']', path);
+        }
+        if (this.eatKeyword('array')) {
+            this.expect('(', '( after array');
+            return this.parseArrayBody(')', path);
+        }
+        if (ch === "'")
+            return this.parseSingleQuoted();
+        if (ch === '"')
+            return this.parseDoubleQuoted();
+        if (this.eatKeyword('true'))
+            return true;
+        if (this.eatKeyword('false'))
+            return false;
+        if (this.eatKeyword('null'))
+            return null;
+        if (/[-+\d.]/.test(ch))
+            return this.parseNumber();
+        if (ch === '$')
+            this.error('Variables are not supported in language files');
+        if (this.text.startsWith('<<<', this.pos)) {
+            this.error('Heredoc/nowdoc strings are not supported');
+        }
+        if (IDENT_START.test(ch))
+            this.error('Constants and function calls are not supported');
+        this.error(`Unexpected character ${JSON.stringify(ch)}`);
+    }
+    parseArrayBody(closing, path) {
+        const entries = [];
+        let nextIndex = 0;
+        let sawStringKey = false;
+        const afterOpen = this.pos;
+        let indent = '';
+        let lastValueEnd = afterOpen;
+        let hasTrailingComma = false;
+        for (;;) {
+            this.skipTrivia();
+            if (this.eat(closing))
+                break;
+            if (this.atEnd())
+                this.error(`Unterminated array, expected ${closing}`);
+            const start = this.pos;
+            if (indent === '')
+                indent = this.indentAt(start);
+            const first = this.parseValue(path);
+            if (this.eat('=>')) {
+                let key;
+                if (typeof first === 'string') {
+                    sawStringKey = true;
+                    key = first;
+                }
+                else if (typeof first === 'number' && Number.isInteger(first)) {
+                    nextIndex = Math.max(nextIndex, first + 1);
+                    key = first;
+                }
+                else {
+                    this.error('Array keys must be strings or integers', start);
+                }
+                entries.push([key, this.recordValue(path, String(key))]);
+            }
+            else {
+                const key = nextIndex++;
+                // A list entry's value was already consumed as `first`; its span runs
+                // from where the entry started to where parsing left off.
+                this.layout.values.set(join(path, String(key)), { start, end: this.pos });
+                entries.push([key, first]);
+            }
+            lastValueEnd = this.pos;
+            this.skipTrivia();
+            if (this.eat(',')) {
+                hasTrailingComma = true;
+                // Past the comma, so an inserted entry lands after it rather than
+                // between the value and its separator.
+                lastValueEnd = this.pos;
+                continue;
+            }
+            hasTrailingComma = false;
+            this.expect(closing, `, or ${closing}`);
+            break;
+        }
+        this.layout.arrays.set(path, {
+            style: closing === ')' ? 'array' : 'bracket',
+            insertAt: entries.length === 0 ? afterOpen : lastValueEnd,
+            indent: indent || '    ',
+            hasTrailingComma,
+            empty: entries.length === 0,
+        });
+        // PHP arrays are ordered maps; a purely sequential one is a JS array.
+        const sequential = !sawStringKey && entries.every(([key], i) => typeof key === 'number' && key === i);
+        if (sequential)
+            return entries.map(([, value]) => value);
+        const object = {};
+        for (const [key, value] of entries)
+            object[String(key)] = value;
+        return object;
+    }
+    recordValue(path, key) {
+        this.skipTrivia();
+        const start = this.pos;
+        const value = this.parseValue(join(path, key));
+        this.layout.values.set(join(path, key), { start, end: this.pos });
+        return value;
+    }
+    parseNumber() {
+        this.skipTrivia();
+        const match = /^[-+]?(?:\d[\d_]*\.?[\d_]*|\.\d[\d_]*)(?:[eE][-+]?\d+)?/.exec(this.text.slice(this.pos));
+        if (!match || match[0] === '')
+            this.error('Malformed number');
+        this.pos += match[0].length;
+        return Number(match[0].replace(/_/g, ''));
+    }
+    /** Single quotes escape only \' and \\; everything else is literal. */
+    parseSingleQuoted() {
+        const start = this.pos;
+        this.pos++;
+        let out = '';
+        while (!this.atEnd()) {
+            const ch = this.text[this.pos];
+            if (ch === '\\') {
+                const next = this.text[this.pos + 1];
+                if (next === "'" || next === '\\') {
+                    out += next;
+                    this.pos += 2;
+                    continue;
+                }
+                out += ch;
+                this.pos++;
+                continue;
+            }
+            if (ch === "'") {
+                this.pos++;
+                return out;
+            }
+            out += ch;
+            this.pos++;
+        }
+        this.error('Unterminated string', start);
+    }
+    parseDoubleQuoted() {
+        const start = this.pos;
+        this.pos++;
+        let out = '';
+        while (!this.atEnd()) {
+            const ch = this.text[this.pos];
+            if (ch === '"') {
+                this.pos++;
+                return out;
+            }
+            if (ch === '$') {
+                const next = this.text[this.pos + 1];
+                if (next !== undefined && (IDENT_START.test(next) || next === '{')) {
+                    this.error('Variable interpolation is not supported in language files');
+                }
+                out += ch;
+                this.pos++;
+                continue;
+            }
+            if (ch === '{' && this.text[this.pos + 1] === '$') {
+                this.error('Variable interpolation is not supported in language files');
+            }
+            if (ch === '\\') {
+                out += this.readEscape();
+                continue;
+            }
+            out += ch;
+            this.pos++;
+        }
+        this.error('Unterminated string', start);
+    }
+    readEscape() {
+        const next = this.text[this.pos + 1];
+        if (next === undefined)
+            this.error('Unterminated escape sequence');
+        const simple = {
+            n: '\n',
+            r: '\r',
+            t: '\t',
+            v: '\v',
+            f: '\f',
+            e: '\x1b',
+            '\\': '\\',
+            $: '$',
+            '"': '"',
+        };
+        if (next in simple) {
+            this.pos += 2;
+            return simple[next];
+        }
+        if (next === 'x') {
+            const match = /^[0-9A-Fa-f]{1,2}/.exec(this.text.slice(this.pos + 2));
+            if (match) {
+                this.pos += 2 + match[0].length;
+                return String.fromCharCode(Number.parseInt(match[0], 16));
+            }
+        }
+        if (next === 'u' && this.text[this.pos + 2] === '{') {
+            const close = this.text.indexOf('}', this.pos + 3);
+            const hex = close === -1 ? '' : this.text.slice(this.pos + 3, close);
+            if (close !== -1 && /^[0-9A-Fa-f]+$/.test(hex)) {
+                this.pos = close + 1;
+                return String.fromCodePoint(Number.parseInt(hex, 16));
+            }
+            this.error('Malformed \\u{...} escape');
+        }
+        const octal = /^[0-7]{1,3}/.exec(this.text.slice(this.pos + 1));
+        if (octal) {
+            this.pos += 1 + octal[0].length;
+            return String.fromCharCode(Number.parseInt(octal[0], 8) & 0xff);
+        }
+        // PHP keeps an unrecognised escape as a literal backslash plus the character.
+        this.pos += 1;
+        return '\\';
+    }
+}
+function join(path, key) {
+    return path ? `${path}.${key}` : key;
+}
+export function parsePhp(text, file) {
+    return new Parser(text, file).parseFile();
+}
+/** Parses and also reports where every value and array sits in the text. */
+export function parsePhpLayout(text, file) {
+    const parser = new Parser(text, file);
+    const value = parser.parseFile();
+    return { value, layout: parser.layout };
+}
+export function readPhpLocale(file, namespace, _locale, _isSource, target) {
+    const parsed = parsePhp(readFileSync(file, 'utf8'), file);
+    if (Array.isArray(parsed)) {
+        target.skipped.push({ file, reason: 'the file holds a list, not keyed translations' });
+        return;
+    }
+    flattenValue(parsed, namespace, file, target.leaves, target.containers);
+}
+//# sourceMappingURL=php.js.map

package/dist/formats/php.js.map

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

package/dist/formats/po-write.d.ts

@@ -0,0 +1,3 @@
+import type { Edit, WriteOutcome } from './write.js';
+export declare function poString(value: string): string;
+export declare function writePoLocale(content: string, file: string, _locale: string, edits: Edit[]): WriteOutcome;

package/dist/formats/po-write.js

@@ -0,0 +1,200 @@
+import { poKey, parsePo } from './po.js';
+/**
+ * gettext catalogues, edited line by line.
+ *
+ * One deliberate choice beyond preserving the file: a translation written here
+ * is marked `#, fuzzy`. That flag is gettext's own word for "not reviewed by a
+ * person yet", which is exactly what this tool records as `reviewed: false` in
+ * the memory. Leaving it off would claim a human had approved the string.
+ * It does mean `check` then reports those entries as stale — correctly.
+ */
+const ESCAPES = new Map([
+    [0x0a, '\\n'],
+    [0x0d, '\\r'],
+    [0x09, '\\t'],
+]);
+export function poString(value) {
+    let out = '';
+    for (const ch of value) {
+        const cp = ch.codePointAt(0);
+        if (ch === '\\' || ch === '"')
+            out += `\\${ch}`;
+        else if (cp < 0x20)
+            out += ESCAPES.get(cp) ?? `\\x${cp.toString(16).padStart(2, '0')}`;
+        else
+            out += ch;
+    }
+    return `"${out}"`;
+}
+const KEYWORD = /^(msgctxt|msgid_plural|msgid|msgstr)(?:\[(\d+)\])?(.*)$/;
+const EMPTY_STRING = /^\s*""\s*$/;
+/**
+ * Lines up each entry in the text with the key the parser resolved for it.
+ *
+ * The parser drops the header entry, so the scanner has to drop it too or every
+ * key lands one entry early — which is exactly the bug this shape prevents.
+ */
+function scan(content, file) {
+    const lines = content.split(/\r?\n/);
+    const keysInOrder = parsePo(content, file).entries.map(poKey);
+    const blocks = new Map();
+    let current = null;
+    let msgidEmpty = true;
+    let inMsgid = false;
+    let lastMsgstr = null;
+    let obsolete = false;
+    let entryIndex = 0;
+    const close = () => {
+        if (current && current.msgstr.size > 0 && !obsolete) {
+            current.headerLike = msgidEmpty;
+            if (!msgidEmpty) {
+                const key = keysInOrder[entryIndex];
+                if (key !== undefined)
+                    blocks.set(key, current);
+                entryIndex++;
+            }
+        }
+        current = null;
+        msgidEmpty = true;
+        inMsgid = false;
+        lastMsgstr = null;
+        obsolete = false;
+    };
+    for (const [index, raw] of lines.entries()) {
+        const line = raw.trim();
+        if (line === '') {
+            close();
+            continue;
+        }
+        if (line.startsWith('#~')) {
+            obsolete = true;
+            continue;
+        }
+        if (line.startsWith('#')) {
+            if (line.startsWith('#,')) {
+                current ??= { flagLine: null, headLine: index, msgstr: new Map(), headerLike: false };
+                current.flagLine = index;
+            }
+            continue;
+        }
+        const match = KEYWORD.exec(line);
+        if (match) {
+            if (!current)
+                current = { flagLine: null, headLine: index, msgstr: new Map(), headerLike: false };
+            else if (current.msgstr.size === 0 && current.flagLine === null) {
+                current.headLine = Math.min(current.headLine, index);
+            }
+            if (match[1] === 'msgstr') {
+                const at = match[2] === undefined ? 0 : Number.parseInt(match[2], 10);
+                current.msgstr.set(at, { start: index, end: index + 1 });
+                lastMsgstr = at;
+                inMsgid = false;
+            }
+            else {
+                if (match[1] === 'msgid') {
+                    inMsgid = true;
+                    msgidEmpty = EMPTY_STRING.test(match[3] ?? '');
+                }
+                else {
+                    inMsgid = false;
+                }
+                lastMsgstr = null;
+            }
+            continue;
+        }
+        if (line.startsWith('"') && current) {
+            if (lastMsgstr !== null) {
+                current.msgstr.get(lastMsgstr).end = index + 1;
+            }
+            else if (inMsgid && !EMPTY_STRING.test(line)) {
+                // A msgid spelled across continuation lines is not the empty header.
+                msgidEmpty = false;
+            }
+        }
+    }
+    close();
+    return { lines, blocks };
+}
+function splitForm(key) {
+    const match = /^(.*)\.(\d+)$/.exec(key);
+    return match
+        ? { base: match[1], form: Number.parseInt(match[2], 10) }
+        : { base: key, form: null };
+}
+/**
+ * A new entry has to be spelled back out as msgctxt + msgid. The key format
+ * joins them with `|`, which a msgid could itself contain; splitting at the
+ * first one matches how the key was built and is wrong only for a contextless
+ * msgid that happens to contain a pipe.
+ */
+function appendEntry(key, value) {
+    const pipe = key.indexOf('|');
+    const head = pipe > 0
+        ? [`msgctxt ${poString(key.slice(0, pipe))}`, `msgid ${poString(key.slice(pipe + 1))}`]
+        : [`msgid ${poString(key)}`];
+    return ['', '#, fuzzy', ...head, `msgstr ${poString(value)}`];
+}
+export function writePoLocale(content, file, _locale, edits) {
+    const { lines, blocks } = scan(content, file);
+    const skipped = [];
+    // line index -> replacement lines, or null to drop the line.
+    const replaced = new Map();
+    const needFuzzy = new Set();
+    const appended = [];
+    for (const edit of edits) {
+        let block = blocks.get(edit.key);
+        let form = 0;
+        if (!block) {
+            const split = splitForm(edit.key);
+            if (split.form !== null) {
+                const candidate = blocks.get(split.base);
+                if (candidate) {
+                    block = candidate;
+                    form = split.form;
+                }
+            }
+        }
+        if (!block) {
+            appended.push(...appendEntry(edit.key, edit.value));
+            continue;
+        }
+        const span = block.msgstr.get(form);
+        if (!span) {
+            skipped.push({ key: edit.key, reason: `the entry has no msgstr[${form}]` });
+            continue;
+        }
+        const label = block.msgstr.size > 1 ? `msgstr[${form}]` : 'msgstr';
+        replaced.set(span.start, [`${label} ${poString(edit.value)}`]);
+        for (let line = span.start + 1; line < span.end; line++)
+            replaced.set(line, null);
+        needFuzzy.add(block);
+    }
+    for (const block of needFuzzy) {
+        if (block.flagLine !== null) {
+            const flags = lines[block.flagLine];
+            if (!/\bfuzzy\b/.test(flags))
+                replaced.set(block.flagLine, [`${flags}, fuzzy`]);
+            continue;
+        }
+        const head = replaced.get(block.headLine) ?? [lines[block.headLine]];
+        replaced.set(block.headLine, ['#, fuzzy', ...head]);
+    }
+    const out = [];
+    for (const [index, line] of lines.entries()) {
+        const replacement = replaced.get(index);
+        if (replacement === undefined)
+            out.push(line);
+        else if (replacement !== null)
+            out.push(...replacement);
+    }
+    if (appended.length > 0) {
+        while (out.length > 0 && out[out.length - 1] === '')
+            out.pop();
+        out.push(...appended, '');
+    }
+    // A catalogue checked out on Windows may use CRLF; writing back with bare
+    // newlines would leave the file mixed.
+    const newline = content.includes('\r\n') ? '\r\n' : '\n';
+    return { content: out.join(newline), skipped };
+}
+//# sourceMappingURL=po-write.js.map

package/dist/formats/po-write.js.map

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

package/dist/formats/po.d.ts

@@ -0,0 +1,30 @@
+import type { ReadTarget } from '../types.js';
+import { FormatError } from './error.js';
+/**
+ * gettext .po / .pot.
+ *
+ * Two things make this format different from the others: the msgid *is* the
+ * source text, so a .pot with empty translations is a usable source locale; and
+ * the format already has a notion of an outdated translation — the fuzzy flag —
+ * which maps onto the same rule the translation memory feeds.
+ */
+export declare class PoParseError extends FormatError {
+    constructor(file: string, line: number, message: string);
+}
+export interface PoEntry {
+    context: string | null;
+    msgid: string;
+    msgidPlural: string | null;
+    msgstr: string[];
+    fuzzy: boolean;
+    line: number;
+}
+export interface PoFile {
+    entries: PoEntry[];
+    /** From the header's Plural-Forms, when present. */
+    nplurals: number | null;
+}
+export declare function parsePo(text: string, file: string): PoFile;
+/** msgctxt disambiguates an otherwise identical msgid. */
+export declare function poKey(entry: PoEntry): string;
+export declare function readPoLocale(file: string, namespace: string, _locale: string, isSource: boolean, target: ReadTarget): void;