@katerynakhar/i18n-keeper 0.16.0

package/dist/formats/flatten.js

@@ -0,0 +1,26 @@
+function kindOf(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'number')
+        return 'number';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    return 'string';
+}
+/** Flattens a parsed locale value into dot-notation keys, shared by every format. */
+export function flattenValue(node, prefix, file, leaves, containers) {
+    if (node !== null && typeof node === 'object') {
+        if (prefix)
+            containers.add(prefix);
+        const entries = Array.isArray(node)
+            ? node.map((v, i) => [String(i), v])
+            : Object.entries(node);
+        for (const [k, v] of entries) {
+            flattenValue(v, prefix ? `${prefix}.${k}` : k, file, leaves, containers);
+        }
+        return;
+    }
+    const value = node;
+    leaves.set(prefix, { value: value === null ? '' : String(value), kind: kindOf(value), file });
+}
+//# sourceMappingURL=flatten.js.map

package/dist/formats/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../src/formats/flatten.ts"],"names":[],"mappings":"AAUA,SAAS,MAAM,CAAC,KAAuC;IACrD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,MAAc,EACd,IAAY,EACZ,MAAyB,EACzB,UAAuB;IAEvB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,MAAM;YAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7B,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAwC,CAAC;IACvD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAChG,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { Edit, WriteOutcome } from './write.js';
+/**
+ * JSON is the one format that can be re-serialised without losing anything —
+ * it has no comments, no anchors and no styles to preserve. Key order is kept
+ * because setting an existing key leaves it where it is, and new keys append.
+ */
+export declare function writeJsonLocale(content: string, file: string, _locale: string, edits: Edit[]): WriteOutcome;

package/dist/formats/json-write.js

@@ -0,0 +1,55 @@
+import { FormatError } from './error.js';
+/**
+ * JSON is the one format that can be re-serialised without losing anything —
+ * it has no comments, no anchors and no styles to preserve. Key order is kept
+ * because setting an existing key leaves it where it is, and new keys append.
+ */
+export function writeJsonLocale(content, file, _locale, edits) {
+    let root = {};
+    if (content.trim() !== '') {
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch (err) {
+            throw new FormatError(file, err instanceof Error ? err.message : String(err));
+        }
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new FormatError(file, 'expected an object at the top level');
+        }
+        root = parsed;
+    }
+    const skipped = [];
+    for (const edit of edits) {
+        const path = edit.key.split('.');
+        let node = root;
+        let blocked = null;
+        for (const [index, segment] of path.entries()) {
+            if (index === path.length - 1) {
+                const existing = node[segment];
+                if (existing !== undefined && typeof existing === 'object' && existing !== null) {
+                    blocked = `${segment} holds a collection, not a string`;
+                    break;
+                }
+                node[segment] = edit.value;
+                break;
+            }
+            const next = node[segment];
+            if (next === undefined) {
+                const created = {};
+                node[segment] = created;
+                node = created;
+                continue;
+            }
+            if (typeof next !== 'object' || next === null || Array.isArray(next)) {
+                blocked = `${segment} already holds a value`;
+                break;
+            }
+            node = next;
+        }
+        if (blocked)
+            skipped.push({ key: edit.key, reason: blocked });
+    }
+    return { content: `${JSON.stringify(root, null, 2)}\n`, skipped };
+}
+//# sourceMappingURL=json-write.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-write.js","sourceRoot":"","sources":["../../src/formats/json-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,IAAY,EACZ,OAAe,EACf,KAAa;IAEb,IAAI,IAAI,GAA4B,EAAE,CAAC;IAEvC,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,qCAAqC,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,GAAG,MAAiC,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAA2C,EAAE,CAAC;IAE3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,OAAO,GAAkB,IAAI,CAAC;QAElC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC/B,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBAChF,OAAO,GAAG,GAAG,OAAO,mCAAmC,CAAC;oBACxD,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC3B,MAAM;YACR,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,OAAO,GAA4B,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;gBACxB,IAAI,GAAG,OAAO,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrE,OAAO,GAAG,GAAG,OAAO,wBAAwB,CAAC;gBAC7C,MAAM;YACR,CAAC;YACD,IAAI,GAAG,IAA+B,CAAC;QACzC,CAAC;QAED,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/dist/formats/json.d.ts

@@ -0,0 +1,6 @@
+import type { ReadTarget } from '../types.js';
+import { FormatError } from './error.js';
+export declare class ParseError extends FormatError {
+}
+/** Flattens one JSON locale file into dot-notation keys under an optional namespace. */
+export declare function readJsonLocale(file: string, namespace: string, _locale: string, _isSource: boolean, target: ReadTarget): void;

package/dist/formats/json.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+import { FormatError } from './error.js';
+import { flattenValue } from './flatten.js';
+export class ParseError extends FormatError {
+}
+/** Flattens one JSON locale file into dot-notation keys under an optional namespace. */
+export function readJsonLocale(file, namespace, _locale, _isSource, target) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        throw new ParseError(file, err instanceof Error ? err.message : String(err));
+    }
+    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=json.js.map

package/dist/formats/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/formats/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,OAAO,UAAW,SAAQ,WAAW;CAAG;AAE9C,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,SAAiB,EACjB,OAAe,EACf,SAAkB,EAClB,MAAkB;IAElB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IACD,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC1E,CAAC"}

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

@@ -0,0 +1,16 @@
+import { type Edit, type WriteOutcome } from './write.js';
+/**
+ * A PHP string literal for an arbitrary value.
+ *
+ * Single quotes are preferred because nothing interpolates inside them: `$` and
+ * Laravel's `:name` stay literal, which is exactly what a language file wants.
+ * Control characters have no single-quoted spelling, so those fall back to
+ * double quotes with escapes.
+ */
+export declare function phpLiteral(value: string): string;
+/**
+ * An empty language file shaped like the one it is being translated from, so a
+ * project written with `array()` does not suddenly gain a file that is not.
+ */
+export declare function blankPhpFile(sourceContent: string | null): string;
+export declare function writePhpLocale(content: string, file: string, _locale: string, edits: Edit[]): WriteOutcome;

package/dist/formats/php-write.js

@@ -0,0 +1,130 @@
+import { parsePhpLayout } from './php.js';
+import { spliceAll } from './write.js';
+/** Nested levels that have to be created get this much extra indentation. */
+const INDENT_STEP = '    ';
+const SHORT_ESCAPES = new Map([
+    [0x0a, '\\n'],
+    [0x0d, '\\r'],
+    [0x09, '\\t'],
+    [0x0b, '\\v'],
+    [0x0c, '\\f'],
+    [0x1b, '\\e'],
+]);
+function hasControlCharacter(value) {
+    for (const ch of value) {
+        if (ch.codePointAt(0) < 0x20)
+            return true;
+    }
+    return false;
+}
+/**
+ * A PHP string literal for an arbitrary value.
+ *
+ * Single quotes are preferred because nothing interpolates inside them: `$` and
+ * Laravel's `:name` stay literal, which is exactly what a language file wants.
+ * Control characters have no single-quoted spelling, so those fall back to
+ * double quotes with escapes.
+ */
+export function phpLiteral(value) {
+    if (!hasControlCharacter(value)) {
+        return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    }
+    let out = '';
+    for (const ch of value) {
+        const cp = ch.codePointAt(0);
+        if (cp >= 0x20) {
+            if (ch === '\\' || ch === '"' || ch === '$')
+                out += `\\${ch}`;
+            else
+                out += ch;
+            continue;
+        }
+        out += SHORT_ESCAPES.get(cp) ?? `\\x${cp.toString(16).padStart(2, '0')}`;
+    }
+    return `"${out}"`;
+}
+const OPEN = { bracket: '[', array: 'array(' };
+const CLOSE = { bracket: ']', array: ')' };
+/** `'a' => ['b' => 'value'],` for however many levels are missing. */
+function nestedEntry(keys, value, indent, style) {
+    const [head, ...rest] = keys;
+    if (rest.length === 0)
+        return `${indent}${phpLiteral(head)} => ${phpLiteral(value)},`;
+    return [
+        `${indent}${phpLiteral(head)} => ${OPEN[style]}`,
+        nestedEntry(rest, value, indent + INDENT_STEP, style),
+        `${indent}${CLOSE[style]},`,
+    ].join('\n');
+}
+/**
+ * An empty language file shaped like the one it is being translated from, so a
+ * project written with `array()` does not suddenly gain a file that is not.
+ */
+export function blankPhpFile(sourceContent) {
+    let style = 'bracket';
+    if (sourceContent !== null) {
+        try {
+            style = parsePhpLayout(sourceContent, '<source>').layout.arrays.get('')?.style ?? 'bracket';
+        }
+        catch {
+            // An unreadable source is no reason to refuse to create the target.
+        }
+    }
+    return `<?php\n\nreturn ${OPEN[style]}\n${CLOSE[style]};\n`;
+}
+/** The deepest array that already exists on the way to `key`. */
+function parentFor(arrays, key) {
+    const parts = key.split('.');
+    for (let depth = parts.length - 1; depth >= 0; depth--) {
+        const slot = arrays.get(parts.slice(0, depth).join('.'));
+        if (slot)
+            return { slot, remaining: parts.slice(depth) };
+    }
+    return null;
+}
+export function writePhpLocale(content, file, _locale, edits) {
+    const { layout } = parsePhpLayout(content, file);
+    const skipped = [];
+    const splices = [];
+    // Several new keys can belong in the same array and share one insertion
+    // point, so they are collected and emitted together, in order.
+    const insertions = new Map();
+    for (const edit of edits) {
+        const span = layout.values.get(edit.key);
+        if (span) {
+            splices.push({ start: span.start, end: span.end, text: phpLiteral(edit.value) });
+            continue;
+        }
+        if (layout.arrays.has(edit.key)) {
+            skipped.push({ key: edit.key, reason: 'the key holds an array, not a string' });
+            continue;
+        }
+        const parent = parentFor(layout.arrays, edit.key);
+        if (!parent) {
+            skipped.push({ key: edit.key, reason: 'no array to insert into' });
+            continue;
+        }
+        const entry = nestedEntry(parent.remaining, edit.value, parent.slot.indent, parent.slot.style);
+        const bucket = insertions.get(parent.slot.insertAt);
+        if (bucket)
+            bucket.lines.push(entry);
+        else
+            insertions.set(parent.slot.insertAt, { slot: parent.slot, lines: [entry] });
+    }
+    for (const [at, { slot, lines }] of insertions) {
+        const body = lines.join('\n');
+        // An empty array usually already has a newline before its closing bracket;
+        // adding a second one would leave a blank line in the file.
+        const closingOnNextLine = content.slice(at).startsWith('\n');
+        const text = slot.empty
+            ? closingOnNextLine
+                ? `\n${body}`
+                : `\n${body}\n`
+            : slot.hasTrailingComma
+                ? `\n${body}`
+                : `,\n${body}`;
+        splices.push({ start: at, end: at, text });
+    }
+    return { content: spliceAll(content, splices), skipped };
+}
+//# sourceMappingURL=php-write.js.map

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

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

package/dist/formats/php.d.ts

@@ -0,0 +1,44 @@
+import type { ReadTarget } from '../types.js';
+import { FormatError } from './error.js';
+import { type PlainValue } 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 declare class PhpParseError extends FormatError {
+    constructor(file: string, line: number, message: string);
+}
+/** Where a value sits in the source text, so it can be replaced in place. */
+export interface ValueSpan {
+    start: number;
+    end: number;
+}
+/** `array(...)` still turns up in older projects; new entries should match. */
+export type ArrayStyle = 'bracket' | 'array';
+/** Where a new entry can be inserted into an existing array. */
+export interface ArraySlot {
+    style: ArrayStyle;
+    /** Just past the last entry's value, or just past the opening bracket. */
+    insertAt: number;
+    /** Indentation the entries use, so an inserted one lines up. */
+    indent: string;
+    hasTrailingComma: boolean;
+    empty: boolean;
+}
+export interface PhpLayout {
+    /** Dot path -> the span of its value expression. */
+    values: Map<string, ValueSpan>;
+    /** Dot path of every array ('' for the returned one) -> where to insert. */
+    arrays: Map<string, ArraySlot>;
+}
+export declare function parsePhp(text: string, file: string): PlainValue;
+/** Parses and also reports where every value and array sits in the text. */
+export declare function parsePhpLayout(text: string, file: string): {
+    value: PlainValue;
+    layout: PhpLayout;
+};
+export declare function readPhpLocale(file: string, namespace: string, _locale: string, _isSource: boolean, target: ReadTarget): void;