@localeguard/core 0.1.0

package/dist/src/json/parse.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * A small recursive-descent JSON parser.
+ *
+ * `JSON.parse` silently keeps the last value when a key is duplicated and
+ * gives no location information. LocaleGuard needs both, so this parser:
+ *   - reports the 1-based line/column of syntax errors, and
+ *   - records duplicate keys (per object) with their location.
+ *
+ * It implements the JSON grammar from RFC 8259.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonParseError = void 0;
+exports.parseJson = parseJson;
+class JsonParseError extends Error {
+    line;
+    column;
+    constructor(message, line, column) {
+        super(message);
+        this.line = line;
+        this.column = column;
+        this.name = "JsonParseError";
+    }
+}
+exports.JsonParseError = JsonParseError;
+const ESCAPES = {
+    '"': '"',
+    "\\": "\\",
+    "/": "/",
+    b: "\b",
+    f: "\f",
+    n: "\n",
+    r: "\r",
+    t: "\t",
+};
+class Parser {
+    text;
+    pos = 0;
+    line = 1;
+    col = 1;
+    keyLines = new Map();
+    duplicates = [];
+    constructor(text) {
+        this.text = text;
+    }
+    parse() {
+        this.skipWhitespace();
+        const value = this.parseValue("");
+        this.skipWhitespace();
+        if (this.pos < this.text.length) {
+            throw this.error(`Unexpected token ${JSON.stringify(this.peek())}`);
+        }
+        return value;
+    }
+    error(message) {
+        return new JsonParseError(message, this.line, this.col);
+    }
+    peek() {
+        return this.text[this.pos] ?? "";
+    }
+    advance() {
+        const ch = this.text[this.pos] ?? "";
+        this.pos++;
+        if (ch === "\n") {
+            this.line++;
+            this.col = 1;
+        }
+        else {
+            this.col++;
+        }
+        return ch;
+    }
+    skipWhitespace() {
+        while (this.pos < this.text.length) {
+            const ch = this.peek();
+            if (ch === " " || ch === "\t" || ch === "\n" || ch === "\r") {
+                this.advance();
+            }
+            else {
+                break;
+            }
+        }
+    }
+    expect(ch) {
+        if (this.peek() !== ch) {
+            throw this.error(`Expected ${JSON.stringify(ch)} but found ${JSON.stringify(this.peek() || "<eof>")}`);
+        }
+        this.advance();
+    }
+    parseValue(path) {
+        const ch = this.peek();
+        switch (ch) {
+            case "{":
+                return this.parseObject(path);
+            case "[":
+                return this.parseArray(path);
+            case '"':
+                return this.parseString();
+            case "t":
+            case "f":
+                return this.parseBoolean();
+            case "n":
+                return this.parseNull();
+            default:
+                if (ch === "-" || (ch >= "0" && ch <= "9")) {
+                    return this.parseNumber();
+                }
+                throw this.error(`Unexpected token ${JSON.stringify(ch || "<eof>")}`);
+        }
+    }
+    parseObject(path) {
+        this.expect("{");
+        const obj = {};
+        const seen = new Set();
+        this.skipWhitespace();
+        if (this.peek() === "}") {
+            this.advance();
+            return obj;
+        }
+        for (;;) {
+            this.skipWhitespace();
+            if (this.peek() !== '"') {
+                throw this.error("Expected string key in object");
+            }
+            const keyLine = this.line;
+            const key = this.parseString();
+            const childPath = path ? `${path}.${key}` : key;
+            this.skipWhitespace();
+            this.expect(":");
+            this.skipWhitespace();
+            const value = this.parseValue(childPath);
+            if (seen.has(key)) {
+                this.duplicates.push({ path: childPath, line: keyLine });
+            }
+            else {
+                seen.add(key);
+            }
+            this.keyLines.set(childPath, keyLine);
+            obj[key] = value;
+            this.skipWhitespace();
+            const next = this.peek();
+            if (next === ",") {
+                this.advance();
+                continue;
+            }
+            if (next === "}") {
+                this.advance();
+                return obj;
+            }
+            throw this.error(`Expected ',' or '}' but found ${JSON.stringify(next || "<eof>")}`);
+        }
+    }
+    parseArray(path) {
+        this.expect("[");
+        const arr = [];
+        this.skipWhitespace();
+        if (this.peek() === "]") {
+            this.advance();
+            return arr;
+        }
+        for (let index = 0;; index++) {
+            this.skipWhitespace();
+            const childPath = path ? `${path}.${index}` : String(index);
+            const value = this.parseValue(childPath);
+            this.keyLines.set(childPath, this.line);
+            arr.push(value);
+            this.skipWhitespace();
+            const next = this.peek();
+            if (next === ",") {
+                this.advance();
+                continue;
+            }
+            if (next === "]") {
+                this.advance();
+                return arr;
+            }
+            throw this.error(`Expected ',' or ']' but found ${JSON.stringify(next || "<eof>")}`);
+        }
+    }
+    parseString() {
+        this.expect('"');
+        let out = "";
+        for (;;) {
+            const ch = this.advance();
+            if (ch === "") {
+                throw this.error("Unterminated string");
+            }
+            if (ch === '"') {
+                return out;
+            }
+            if (ch === "\\") {
+                const esc = this.advance();
+                if (esc === "u") {
+                    let hex = "";
+                    for (let i = 0; i < 4; i++) {
+                        const h = this.advance();
+                        if (!/[0-9a-fA-F]/.test(h)) {
+                            throw this.error("Invalid unicode escape");
+                        }
+                        hex += h;
+                    }
+                    out += String.fromCharCode(parseInt(hex, 16));
+                }
+                else if (esc in ESCAPES) {
+                    out += ESCAPES[esc];
+                }
+                else {
+                    throw this.error(`Invalid escape \\${esc}`);
+                }
+            }
+            else if (ch.charCodeAt(0) < 0x20) {
+                throw this.error("Control character in string");
+            }
+            else {
+                out += ch;
+            }
+        }
+    }
+    parseNumber() {
+        const start = this.pos;
+        if (this.peek() === "-")
+            this.advance();
+        while (/[0-9]/.test(this.peek()))
+            this.advance();
+        if (this.peek() === ".") {
+            this.advance();
+            while (/[0-9]/.test(this.peek()))
+                this.advance();
+        }
+        if (this.peek() === "e" || this.peek() === "E") {
+            this.advance();
+            if (this.peek() === "+" || this.peek() === "-")
+                this.advance();
+            while (/[0-9]/.test(this.peek()))
+                this.advance();
+        }
+        const raw = this.text.slice(start, this.pos);
+        const num = Number(raw);
+        if (Number.isNaN(num)) {
+            throw this.error(`Invalid number ${JSON.stringify(raw)}`);
+        }
+        return num;
+    }
+    parseKeyword(word) {
+        for (const expected of word) {
+            if (this.advance() !== expected) {
+                throw this.error(`Invalid literal, expected ${JSON.stringify(word)}`);
+            }
+        }
+    }
+    parseBoolean() {
+        if (this.peek() === "t") {
+            this.parseKeyword("true");
+            return true;
+        }
+        this.parseKeyword("false");
+        return false;
+    }
+    parseNull() {
+        this.parseKeyword("null");
+        return null;
+    }
+}
+function parseJson(text) {
+    const parser = new Parser(text);
+    const value = parser.parse();
+    return { value, keyLines: parser.keyLines, duplicates: parser.duplicates };
+}
+//# sourceMappingURL=parse.js.map

package/dist/src/json/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/json/parse.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAuQH,8BAIC;AAvQD,MAAa,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,MAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AATD,wCASC;AAUD,MAAM,OAAO,GAA2B;IACtC,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,GAAG;IACR,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,MAAM,MAAM;IAOmB;IANrB,GAAG,GAAG,CAAC,CAAC;IACR,IAAI,GAAG,CAAC,CAAC;IACT,GAAG,GAAG,CAAC,CAAC;IACP,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,UAAU,GAAqC,EAAE,CAAC;IAE3D,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK;QACH,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAe;QAC3B,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAEO,OAAO;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC5D,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,EAAU;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChC,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5B,KAAK,GAAG,CAAC;YACT,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7B,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B;gBACE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;oBAC3C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC5B,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,GAAG,GAAiC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,GAAG,CAAC;QACb,CAAC;QACD,SAAS,CAAC;YACR,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC;YACb,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,GAAG,GAAgB,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC;YACb,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,SAAS,CAAC;YACR,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACd,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC;YACb,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC3B,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;oBAChB,IAAI,GAAG,GAAG,EAAE,CAAC;oBACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;wBACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;4BAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;wBAC7C,CAAC;wBACD,GAAG,IAAI,CAAC,CAAC;oBACX,CAAC;oBACD,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChD,CAAC;qBAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;iBAAM,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,GAAG,IAAI,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG;gBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACnD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,KAAK,CAAC,6BAA6B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7E,CAAC"}

package/dist/src/key-comparator/compare.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Compare the key sets of two locales.
+ */
+export interface KeyDiff {
+    /** Keys present in the source but absent from the target. */
+    missing: string[];
+    /** Keys present in the target but absent from the source. */
+    extra: string[];
+    /** Keys present in both (candidates for placeholder validation). */
+    shared: string[];
+}
+export declare function compareKeys(sourceKeys: Iterable<string>, targetKeys: Iterable<string>): KeyDiff;
+//# sourceMappingURL=compare.d.ts.map

package/dist/src/key-comparator/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/key-comparator/compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAyB/F"}

package/dist/src/key-comparator/compare.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Compare the key sets of two locales.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareKeys = compareKeys;
+function compareKeys(sourceKeys, targetKeys) {
+    const source = sourceKeys instanceof Set ? sourceKeys : new Set(sourceKeys);
+    const target = targetKeys instanceof Set ? targetKeys : new Set(targetKeys);
+    const missing = [];
+    const shared = [];
+    for (const key of source) {
+        if (target.has(key)) {
+            shared.push(key);
+        }
+        else {
+            missing.push(key);
+        }
+    }
+    const extra = [];
+    for (const key of target) {
+        if (!source.has(key)) {
+            extra.push(key);
+        }
+    }
+    missing.sort();
+    extra.sort();
+    shared.sort();
+    return { missing, extra, shared };
+}
+//# sourceMappingURL=compare.js.map

package/dist/src/key-comparator/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/key-comparator/compare.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,kCAyBC;AAzBD,SAAgB,WAAW,CAAC,UAA4B,EAAE,UAA4B;IACpF,MAAM,MAAM,GAAG,UAAU,YAAY,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,UAAU,YAAY,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAE5E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,EAAE,CAAC;IACf,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/dist/src/locale-parser/load.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Load a locale from disk into a flat key map.
+ *
+ * Two on-disk layouts are supported:
+ *   - single file:   `<localesPath>/<locale>.json`
+ *   - per-namespace: `<localesPath>/<locale>/<namespace>.json`
+ *
+ * When namespaces are used, keys are qualified as `namespace:key` so they stay
+ * distinct across files.
+ */
+import type { LoadedLocale } from "../types";
+export interface LoadOptions {
+    /** Absolute project root; reported file paths are relative to this. */
+    rootDir: string;
+    /** Locales directory, relative to `rootDir`. */
+    localesPath: string;
+}
+export declare function loadLocale(locale: string, opts: LoadOptions): LoadedLocale;
+//# sourceMappingURL=load.d.ts.map

package/dist/src/locale-parser/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/locale-parser/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAS,YAAY,EAAe,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AA+BD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY,CAiE1E"}

package/dist/src/locale-parser/load.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Load a locale from disk into a flat key map.
+ *
+ * Two on-disk layouts are supported:
+ *   - single file:   `<localesPath>/<locale>.json`
+ *   - per-namespace: `<localesPath>/<locale>/<namespace>.json`
+ *
+ * When namespaces are used, keys are qualified as `namespace:key` so they stay
+ * distinct across files.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLocale = loadLocale;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const flatten_1 = require("../flatten");
+const parse_1 = require("../json/parse");
+const types_1 = require("../types");
+function listLocaleFiles(locale, opts) {
+    const base = path.resolve(opts.rootDir, opts.localesPath);
+    const files = [];
+    const singleFile = path.join(base, `${locale}.json`);
+    if (isFile(singleFile)) {
+        files.push({ absPath: singleFile, namespace: null });
+    }
+    const dir = path.join(base, locale);
+    if (isDirectory(dir)) {
+        for (const entry of fs.readdirSync(dir).sort()) {
+            if (entry.endsWith(".json")) {
+                files.push({
+                    absPath: path.join(dir, entry),
+                    namespace: entry.slice(0, -".json".length),
+                });
+            }
+        }
+    }
+    return files;
+}
+function loadLocale(locale, opts) {
+    const files = listLocaleFiles(locale, opts);
+    const entries = new Map();
+    const issues = [];
+    for (const { absPath, namespace } of files) {
+        const relPath = path.relative(opts.rootDir, absPath) || absPath;
+        let text;
+        try {
+            text = fs.readFileSync(absPath, "utf8");
+        }
+        catch (err) {
+            issues.push({
+                type: "invalid-json",
+                severity: types_1.SEVERITY_BY_TYPE["invalid-json"],
+                locale,
+                namespace: namespace ?? undefined,
+                file: relPath,
+                message: `Could not read locale file: ${err.message}`,
+            });
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = (0, parse_1.parseJson)(text);
+        }
+        catch (err) {
+            const pe = err;
+            issues.push({
+                type: "invalid-json",
+                severity: types_1.SEVERITY_BY_TYPE["invalid-json"],
+                locale,
+                namespace: namespace ?? undefined,
+                file: relPath,
+                line: pe.line,
+                message: `Invalid JSON: ${pe.message}`,
+                suggestion: "Fix the JSON syntax so the locale can be parsed.",
+            });
+            continue;
+        }
+        for (const dup of parsed.duplicates) {
+            issues.push({
+                type: "duplicate-key",
+                severity: types_1.SEVERITY_BY_TYPE["duplicate-key"],
+                locale,
+                namespace: namespace ?? undefined,
+                key: qualify(namespace, dup.path),
+                file: relPath,
+                line: dup.line,
+                message: `Duplicate key "${dup.path}"`,
+                suggestion: "Remove the duplicate; only the last value is kept.",
+            });
+        }
+        for (const [flatKey, value] of (0, flatten_1.flatten)(parsed.value)) {
+            const fqKey = qualify(namespace, flatKey);
+            entries.set(fqKey, {
+                value,
+                file: relPath,
+                line: parsed.keyLines.get(flatKey) ?? 1,
+            });
+        }
+    }
+    return { locale, entries, issues, found: files.length > 0 };
+}
+function qualify(namespace, key) {
+    return namespace ? `${namespace}:${key}` : key;
+}
+function isFile(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/src/locale-parser/load.js.map

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

package/dist/src/placeholder-validator/placeholder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Interpolation-variable extraction and comparison.
+ *
+ * Supports the two most common styles:
+ *   - i18next double-brace: `{{userName}}`, `{{count, number}}`
+ *   - ICU / react-intl single-brace: `{userName}`, `{count, number}`
+ *
+ * Note: extraction is intentionally a heuristic. For parity checks this is
+ * safe — a placeholder that is captured identically in both the source and
+ * target value cancels out, so only genuine divergences are reported.
+ */
+import type { JsonPrimitive } from "../types";
+export declare function extractPlaceholders(value: JsonPrimitive): Set<string>;
+export interface PlaceholderDiff {
+    /** Variables in the source value that are absent from the target. */
+    missing: string[];
+    /** Variables in the target value that are absent from the source. */
+    extra: string[];
+}
+/**
+ * Compare interpolation variables between a source and target value.
+ * Returns `null` when the variable sets match.
+ */
+export declare function comparePlaceholders(sourceValue: JsonPrimitive, targetValue: JsonPrimitive): PlaceholderDiff | null;
+//# sourceMappingURL=placeholder.d.ts.map

package/dist/src/placeholder-validator/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../../src/placeholder-validator/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAM9C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAuBrE;AA0CD,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,aAAa,EAC1B,WAAW,EAAE,aAAa,GACzB,eAAe,GAAG,IAAI,CAaxB"}

package/dist/src/placeholder-validator/placeholder.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Interpolation-variable extraction and comparison.
+ *
+ * Supports the two most common styles:
+ *   - i18next double-brace: `{{userName}}`, `{{count, number}}`
+ *   - ICU / react-intl single-brace: `{userName}`, `{count, number}`
+ *
+ * Note: extraction is intentionally a heuristic. For parity checks this is
+ * safe — a placeholder that is captured identically in both the source and
+ * target value cancels out, so only genuine divergences are reported.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPlaceholders = extractPlaceholders;
+exports.comparePlaceholders = comparePlaceholders;
+const DOUBLE_BRACE = /\{\{\s*([\w$.\-]+)[\s\S]*?\}\}/g;
+const SINGLE_BRACE = /\{\s*([\w$.\-]+)\s*(?:,[^{}]*)?\}/g;
+const ICU_HEAD = /^\s*([A-Za-z_]\w*)\s*,\s*(?:plural|select|selectordinal)\b/;
+function extractPlaceholders(value) {
+    const names = new Set();
+    if (typeof value !== "string") {
+        return names;
+    }
+    // Remove ICU plural/select/selectordinal blocks first (matching braces),
+    // recording only their argument name. This stops their sub-message bodies —
+    // e.g. `{He}` in `{gender, select, male {He} ...}` — from being misread as
+    // interpolation variables, which would otherwise be a false positive.
+    const withoutIcu = stripIcuBlocks(value, names);
+    // i18next double-brace: {{userName}}, {{date, datetime}}.
+    const cleaned = withoutIcu.replace(DOUBLE_BRACE, (_match, name) => {
+        names.add(name);
+        return " ";
+    });
+    // ICU / react-intl single-brace: {userName}, {count, number}, {0}.
+    for (const match of cleaned.matchAll(SINGLE_BRACE)) {
+        names.add(match[1]);
+    }
+    return names;
+}
+function stripIcuBlocks(input, names) {
+    let out = "";
+    let i = 0;
+    while (i < input.length) {
+        if (input[i] !== "{") {
+            out += input[i];
+            i += 1;
+            continue;
+        }
+        const end = matchingBrace(input, i);
+        if (end === -1) {
+            out += input[i];
+            i += 1;
+            continue;
+        }
+        const inner = input.slice(i + 1, end);
+        const head = ICU_HEAD.exec(inner);
+        if (head) {
+            names.add(head[1]); // record the ICU argument, drop sub-messages
+        }
+        else {
+            out += input.slice(i, end + 1); // not ICU — leave for brace-based scanning
+        }
+        i = end + 1;
+    }
+    return out;
+}
+/** Index of the `}` matching the `{` at `start`, or -1 if unbalanced. */
+function matchingBrace(s, start) {
+    let depth = 0;
+    for (let i = start; i < s.length; i += 1) {
+        if (s[i] === "{")
+            depth += 1;
+        else if (s[i] === "}") {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Compare interpolation variables between a source and target value.
+ * Returns `null` when the variable sets match.
+ */
+function comparePlaceholders(sourceValue, targetValue) {
+    // Only meaningful when both sides are strings.
+    if (typeof sourceValue !== "string" || typeof targetValue !== "string") {
+        return null;
+    }
+    const source = extractPlaceholders(sourceValue);
+    const target = extractPlaceholders(targetValue);
+    const missing = [...source].filter((name) => !target.has(name)).sort();
+    const extra = [...target].filter((name) => !source.has(name)).sort();
+    if (missing.length === 0 && extra.length === 0) {
+        return null;
+    }
+    return { missing, extra };
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/src/placeholder-validator/placeholder.js.map

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

package/dist/src/reporters/json.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Machine-readable JSON reporter, suitable for piping into other tooling.
+ */
+import type { CheckResult } from "../types";
+export declare function formatJson(result: CheckResult): string;
+//# sourceMappingURL=json.d.ts.map