@prosopo/locale 3.2.9 → 3.3.1

package/dist/tests/loadI18next.unit.test.js

@@ -0,0 +1,270 @@
+import { afterEach, describe, expect, test, vi } from "vitest";
+const asI18n = (fake) => fake;
+const install = (module, options = {}) => {
+    const instance = {
+        language: options.language ?? "en",
+        changeLanguage: options.changeLanguage ??
+            (async (lng) => {
+                instance.language = lng;
+                return undefined;
+            }),
+    };
+    const initialize = vi.fn((callback) => {
+        const fire = options.fire ?? "async";
+        if (fire === "sync") {
+            callback?.(asI18n(instance));
+        }
+        else if (fire === "async") {
+            queueMicrotask(() => callback?.(asI18n(instance)));
+        }
+        return asI18n(instance);
+    });
+    vi.doMock(module, () => ({ default: initialize }));
+    return { instance, initialize };
+};
+const loadModule = async () => {
+    const imported = await import("../loadI18next.js");
+    return imported.default;
+};
+afterEach(() => {
+    vi.useRealTimers();
+    vi.resetModules();
+    vi.doUnmock("../i18nBackend.js");
+    vi.doUnmock("../i18nFrontend.js");
+    vi.restoreAllMocks();
+});
+describe("loadI18next, backend", () => {
+    test("initialises once and resolves with the instance", async () => {
+        const { instance, initialize } = install("../i18nBackend.js");
+        const loadI18next = await loadModule();
+        const resolved = await loadI18next(true);
+        expect(initialize).toHaveBeenCalledTimes(1);
+        expect(resolved).toBe(asI18n(instance));
+    });
+    test("resolves from the callback, not from the return value", async () => {
+        const { initialize } = install("../i18nBackend.js", { fire: "never" });
+        const loadI18next = await loadModule();
+        let settled = false;
+        void loadI18next(true).then(() => {
+            settled = true;
+        });
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        expect(initialize).toHaveBeenCalledTimes(1);
+        expect(settled).toBe(false);
+    });
+    test("reuses the singleton on a second call without re-initialising", async () => {
+        const { instance, initialize } = install("../i18nBackend.js");
+        const loadI18next = await loadModule();
+        const first = await loadI18next(true);
+        const second = await loadI18next(true);
+        expect(initialize).toHaveBeenCalledTimes(1);
+        expect(second).toBe(first);
+        expect(second).toBe(asI18n(instance));
+    });
+    test("ignores lng on the backend path — the server detects per request", async () => {
+        const { instance, initialize } = install("../i18nBackend.js", {
+            language: "en",
+        });
+        const loadI18next = await loadModule();
+        await loadI18next(true, "fr");
+        expect(initialize.mock.calls[0]?.[1]).toBeUndefined();
+        expect(instance.language).toBe("en");
+    });
+    test("rejects, rather than hanging, when the module fails to load", async () => {
+        vi.doMock("../i18nBackend.js", () => {
+            throw new Error("backend module blew up");
+        });
+        const loadI18next = await loadModule();
+        await expect(loadI18next(true)).rejects.toThrow();
+    });
+});
+describe("loadI18next, frontend", () => {
+    test("initialises once and resolves with the instance", async () => {
+        const { instance, initialize } = install("../i18nFrontend.js");
+        const loadI18next = await loadModule();
+        const resolved = await loadI18next(false);
+        expect(initialize).toHaveBeenCalledTimes(1);
+        expect(resolved).toBe(asI18n(instance));
+    });
+    test("passes lng straight into init so browser detection is skipped", async () => {
+        const { initialize } = install("../i18nFrontend.js", { language: "fr" });
+        const loadI18next = await loadModule();
+        await loadI18next(false, "fr");
+        expect(initialize.mock.calls[0]?.[1]).toBe("fr");
+    });
+    test("does not call changeLanguage when init already produced the target", async () => {
+        const changeLanguage = vi.fn(async () => undefined);
+        install("../i18nFrontend.js", { language: "fr", changeLanguage });
+        const loadI18next = await loadModule();
+        await loadI18next(false, "fr");
+        expect(changeLanguage).not.toHaveBeenCalled();
+    });
+    test("does not call changeLanguage when no language was requested", async () => {
+        const changeLanguage = vi.fn(async () => undefined);
+        install("../i18nFrontend.js", { language: "de", changeLanguage });
+        const loadI18next = await loadModule();
+        await loadI18next(false);
+        expect(changeLanguage).not.toHaveBeenCalled();
+    });
+    test("reconciles when init settled on a different language", async () => {
+        const changeLanguage = vi.fn(async () => undefined);
+        install("../i18nFrontend.js", { language: "en", changeLanguage });
+        const loadI18next = await loadModule();
+        await loadI18next(false, "fr");
+        expect(changeLanguage).toHaveBeenCalledWith("fr");
+    });
+    test("reconciles a pre-existing singleton before resolving", async () => {
+        const { instance, initialize } = install("../i18nFrontend.js", {
+            language: "en",
+        });
+        const loadI18next = await loadModule();
+        await loadI18next(false);
+        const second = await loadI18next(false, "fr");
+        expect(initialize).toHaveBeenCalledTimes(1);
+        expect(instance.language).toBe("fr");
+        expect(second).toBe(asI18n(instance));
+    });
+    test("resolves the cached singleton unchanged when lng is omitted", async () => {
+        const changeLanguage = vi.fn(async () => undefined);
+        install("../i18nFrontend.js", { language: "de", changeLanguage });
+        const loadI18next = await loadModule();
+        await loadI18next(false);
+        await loadI18next(false);
+        expect(changeLanguage).not.toHaveBeenCalled();
+    });
+    test("rejects, rather than hanging, when the module fails to load", async () => {
+        vi.doMock("../i18nFrontend.js", () => {
+            throw new Error("frontend module blew up");
+        });
+        const loadI18next = await loadModule();
+        await expect(loadI18next(false)).rejects.toThrow();
+    });
+    test("rejects when changeLanguage fails during first-load reconciliation", async () => {
+        install("../i18nFrontend.js", {
+            language: "en",
+            changeLanguage: async () => {
+                throw new Error("resource fetch failed");
+            },
+        });
+        const loadI18next = await loadModule();
+        await expect(loadI18next(false, "fr")).rejects.toThrow("resource fetch failed");
+    });
+    test("rejects when changeLanguage fails while reconciling the singleton", async () => {
+        let failing = false;
+        install("../i18nFrontend.js", {
+            language: "en",
+            changeLanguage: async () => {
+                if (failing) {
+                    throw new Error("resource fetch failed");
+                }
+                return undefined;
+            },
+        });
+        const loadI18next = await loadModule();
+        await loadI18next(false);
+        failing = true;
+        await expect(loadI18next(false, "fr")).rejects.toThrow("resource fetch failed");
+    });
+});
+describe("loadI18next, timeout", () => {
+    test("resolves with the degraded instance when `loaded` never fires", async () => {
+        vi.useFakeTimers();
+        const { instance } = install("../i18nBackend.js", { fire: "never" });
+        const loadI18next = await loadModule();
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        const pending = loadI18next(true);
+        await vi.advanceTimersByTimeAsync(I18N_LOAD_TIMEOUT_MS);
+        await expect(pending).resolves.toBe(asI18n(instance));
+    });
+    test("does not fire early — the instance is not handed back before the deadline", async () => {
+        vi.useFakeTimers();
+        install("../i18nBackend.js", { fire: "never" });
+        const loadI18next = await loadModule();
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        let settled = false;
+        void loadI18next(true).then(() => {
+            settled = true;
+        });
+        await vi.advanceTimersByTimeAsync(I18N_LOAD_TIMEOUT_MS - 1);
+        expect(settled).toBe(false);
+    });
+    test("rejects on timeout when no instance was ever created", async () => {
+        vi.useFakeTimers();
+        vi.doMock("../i18nBackend.js", () => new Promise(() => undefined));
+        const loadI18next = await loadModule();
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        const assertion = expect(loadI18next(true)).rejects.toThrow(/did not load within/);
+        await vi.advanceTimersByTimeAsync(I18N_LOAD_TIMEOUT_MS);
+        await assertion;
+    });
+    test("a normal load clears the timer, so a late event cannot re-settle it", async () => {
+        vi.useFakeTimers();
+        let fire;
+        const instance = {
+            language: "en",
+            changeLanguage: async () => undefined,
+        };
+        const initialize = vi.fn((callback) => {
+            fire = callback;
+            return asI18n(instance);
+        });
+        vi.doMock("../i18nBackend.js", () => ({ default: initialize }));
+        const loadI18next = await loadModule();
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        const pending = loadI18next(true);
+        await vi.advanceTimersByTimeAsync(0);
+        fire?.(asI18n(instance));
+        await expect(pending).resolves.toBe(asI18n(instance));
+        fire?.(asI18n(instance));
+        await vi.advanceTimersByTimeAsync(I18N_LOAD_TIMEOUT_MS * 2);
+        await expect(pending).resolves.toBe(asI18n(instance));
+    });
+    test("a failure arriving after the timeout cannot turn a resolved promise into a rejection", async () => {
+        vi.useFakeTimers();
+        let fire;
+        const instance = {
+            language: "en",
+            changeLanguage: async () => {
+                throw new Error("resource fetch failed");
+            },
+        };
+        const initialize = vi.fn((callback) => {
+            fire = callback;
+            return asI18n(instance);
+        });
+        vi.doMock("../i18nFrontend.js", () => ({ default: initialize }));
+        const loadI18next = await loadModule();
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        const pending = loadI18next(false, "fr");
+        await vi.advanceTimersByTimeAsync(I18N_LOAD_TIMEOUT_MS);
+        await expect(pending).resolves.toBe(asI18n(instance));
+        fire?.(asI18n(instance));
+        await vi.advanceTimersByTimeAsync(0);
+        await expect(pending).resolves.toBe(asI18n(instance));
+    });
+    test("the deadline is long enough not to trip a healthy cold start", async () => {
+        const { I18N_LOAD_TIMEOUT_MS } = await import("../loadI18next.js");
+        expect(I18N_LOAD_TIMEOUT_MS).toBeGreaterThanOrEqual(5_000);
+    });
+});
+describe("loadI18next, singleton shared across both paths", () => {
+    test("a frontend call after a backend call reuses the backend instance", async () => {
+        const backend = install("../i18nBackend.js", { language: "en" });
+        const frontend = install("../i18nFrontend.js", { language: "de" });
+        const loadI18next = await loadModule();
+        const first = await loadI18next(true);
+        const second = await loadI18next(false);
+        expect(backend.initialize).toHaveBeenCalledTimes(1);
+        expect(frontend.initialize).not.toHaveBeenCalled();
+        expect(second).toBe(first);
+    });
+    test("the later caller's language still wins via reconciliation", async () => {
+        const backend = install("../i18nBackend.js", { language: "en" });
+        install("../i18nFrontend.js");
+        const loadI18next = await loadModule();
+        await loadI18next(true);
+        await loadI18next(false, "fr");
+        expect(backend.instance.language).toBe("fr");
+    });
+});
+//# sourceMappingURL=loadI18next.unit.test.js.map

package/dist/tests/loadI18next.unit.test.js.map

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

package/dist/tests/locale.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=locale.test-d.d.ts.map

package/dist/tests/locale.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.test-d.d.ts","sourceRoot":"","sources":["../../src/tests/locale.test-d.ts"],"names":[],"mappings":""}

package/dist/tests/locale.test-d.js

@@ -0,0 +1,88 @@
+import { assertType, describe, expectTypeOf, it } from "vitest";
+import { LanguageSchema, Languages, TranslationKeysSchema, i18nMiddleware, isClientSide, loadI18next, useTranslation, } from "../index.js";
+describe("Languages", () => {
+    it("is a frozen const map of name to code, not a widened record", () => {
+        expectTypeOf(Languages.english).toEqualTypeOf();
+        expectTypeOf(Languages.chinese).toEqualTypeOf();
+    });
+    it("rejects assignment to a code", () => {
+        Languages.english = "fr";
+    });
+    it("has no member for a language that is not shipped", () => {
+        Languages.klingon;
+    });
+});
+describe("LanguageSchema", () => {
+    it("parses to a string", () => {
+        expectTypeOf(LanguageSchema.parse("en")).toEqualTypeOf();
+    });
+    it("exposes .enum as a lookup of codes", () => {
+        expectTypeOf(LanguageSchema.enum).toExtend();
+    });
+    it("accepts unknown input at the parse boundary", () => {
+        expectTypeOf(LanguageSchema.parse).toBeCallableWith("anything");
+    });
+});
+describe("TranslationKey", () => {
+    it("is inferred from the schema", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("accepts a key literal, so error call sites need no cast", () => {
+        assertType("API.UNKNOWN");
+    });
+    it("exposes the derived keys as an array of options", () => {
+        expectTypeOf(TranslationKeysSchema.options).toExtend();
+    });
+});
+describe("isClientSide", () => {
+    it("takes no arguments and returns a boolean", () => {
+        expectTypeOf(isClientSide).parameters.toEqualTypeOf();
+        expectTypeOf(isClientSide).returns.toEqualTypeOf();
+    });
+});
+describe("loadI18next", () => {
+    it("requires the backend flag", () => {
+        expectTypeOf(loadI18next).toBeCallableWith(true);
+        expectTypeOf(loadI18next).toBeCallableWith(false, "fr");
+    });
+    it("rejects a call with no arguments", () => {
+        loadI18next();
+    });
+    it("rejects a non-boolean first argument", () => {
+        loadI18next("fr");
+    });
+    it("resolves to the i18next instance type the package re-exports", () => {
+        expectTypeOf(loadI18next).returns.toEqualTypeOf();
+    });
+});
+describe("Ti18n", () => {
+    it("carries the i18next surface consumers need", () => {
+        expectTypeOf().toHaveProperty("t");
+        expectTypeOf().toHaveProperty("language");
+        expectTypeOf().toHaveProperty("changeLanguage");
+    });
+});
+describe("i18nMiddleware", () => {
+    it("takes handler options and resolves to an express handler", () => {
+        expectTypeOf(i18nMiddleware).toBeCallableWith({});
+        expectTypeOf(i18nMiddleware).returns.toExtend();
+    });
+    it("rejects an unknown option", () => {
+        i18nMiddleware({ notAnOption: true });
+    });
+    it("rejects being called with no options", () => {
+        i18nMiddleware();
+    });
+});
+describe("useTranslation", () => {
+    it("is callable with no options", () => {
+        expectTypeOf(useTranslation).toBeCallableWith();
+    });
+    it("returns a t function", () => {
+        expectTypeOf(useTranslation).returns.toHaveProperty("t");
+    });
+    it("rejects an unknown option", () => {
+        useTranslation({ notAnOption: 1 });
+    });
+});
+//# sourceMappingURL=locale.test-d.js.map

package/dist/tests/locale.test-d.js.map

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

package/dist/tests/process.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process.unit.test.d.ts.map

package/dist/tests/process.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/process.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/process.unit.test.js

@@ -0,0 +1,14 @@
+import { describe, expect, test } from "vitest";
+import { getProcess } from "../process.js";
+describe("getProcess", () => {
+    test("returns the process global when one exists", () => {
+        expect(getProcess()).toBe(process);
+    });
+    test("exposes env, which is the only member consumers use", () => {
+        expect(getProcess()?.env).toBe(process.env);
+    });
+    test("is stable across calls rather than returning a copy", () => {
+        expect(getProcess()).toBe(getProcess());
+    });
+});
+//# sourceMappingURL=process.unit.test.js.map

package/dist/tests/process.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.unit.test.js","sourceRoot":"","sources":["../../src/tests/process.unit.test.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAI3B,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/tests/translationKey.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=translationKey.unit.test.d.ts.map

package/dist/tests/translationKey.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translationKey.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/translationKey.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/translationKey.unit.test.js

@@ -0,0 +1,108 @@
+import { describe, expect, test } from "vitest";
+import translationEn from "../locales/en/translation.json" with {
+    type: "json"
+};
+import { TranslationKeysSchema, getLeafFieldPath, } from "../translationKey.js";
+describe("getLeafFieldPath", () => {
+    test("returns no paths for a bare string, which is a leaf and not a container", () => {
+        expect(getLeafFieldPath("a string")).toEqual([]);
+    });
+    test("returns no paths for the empty string", () => {
+        expect(getLeafFieldPath("")).toEqual([]);
+    });
+    test("emits a top-level string value under its own key", () => {
+        expect(getLeafFieldPath({ topLevel: "value" })).toEqual(["topLevel"]);
+    });
+    test("emits section.key for a one-level-deep section", () => {
+        expect(getLeafFieldPath({ section: { key: "value" } })).toEqual([
+            "section.key",
+        ]);
+    });
+    test("emits every key of a section, in insertion order", () => {
+        expect(getLeafFieldPath({ section: { first: "1", second: "2", third: "3" } })).toEqual(["section.first", "section.second", "section.third"]);
+    });
+    test("recurses to arbitrary depth, joining each level with a dot", () => {
+        expect(getLeafFieldPath({ a: { b: { c: { d: "leaf" } } } })).toEqual([
+            "a.b.c.d",
+        ]);
+    });
+    test("handles sibling branches of differing depth", () => {
+        expect(getLeafFieldPath({
+            shallow: { key: "v" },
+            deep: { nested: { key: "v" } },
+        })).toEqual(["shallow.key", "deep.nested.key"]);
+    });
+    test("returns no paths for an empty object", () => {
+        expect(getLeafFieldPath({})).toEqual([]);
+    });
+    test("drops an empty nested section rather than erroring", () => {
+        expect(getLeafFieldPath({ section: {} })).toEqual([]);
+    });
+    test("keeps populated siblings when one section is empty", () => {
+        expect(getLeafFieldPath({ empty: {}, full: { key: "v" } })).toEqual([
+            "full.key",
+        ]);
+    });
+    test("throws on an explicitly undefined value, naming the offending key", () => {
+        const node = {
+            section: { broken: undefined },
+        };
+        expect(() => getLeafFieldPath(node)).toThrow("Undefined value for key broken");
+    });
+    test("throws before emitting any of the sibling keys of the broken one", () => {
+        const node = {
+            section: { ok: "v", broken: undefined },
+        };
+        expect(() => getLeafFieldPath(node)).toThrow(/Undefined value/);
+    });
+    test("does not mutate the input", () => {
+        const node = { section: { key: "value" } };
+        const snapshot = JSON.stringify(node);
+        getLeafFieldPath(node);
+        expect(JSON.stringify(node)).toBe(snapshot);
+    });
+});
+describe("TranslationKeysSchema", () => {
+    const keys = getLeafFieldPath(translationEn);
+    test("is non-empty — an empty z.enum would throw at module load", () => {
+        expect(keys.length).toBeGreaterThan(0);
+    });
+    test("accepts every key derived from the English translation", () => {
+        for (const key of keys) {
+            expect(TranslationKeysSchema.parse(key)).toBe(key);
+        }
+    });
+    test("rejects a key that is not in the English translation", () => {
+        expect(() => TranslationKeysSchema.parse("no.such.key")).toThrow();
+    });
+    test("rejects the empty string", () => {
+        expect(() => TranslationKeysSchema.parse("")).toThrow();
+    });
+    test("rejects a section name on its own — only leaves are valid keys", () => {
+        const [firstKey] = keys;
+        expect(firstKey).toBeDefined();
+        const section = String(firstKey).split(".")[0];
+        expect(() => TranslationKeysSchema.parse(section)).toThrow();
+    });
+    test("rejects non-string input", () => {
+        expect(() => TranslationKeysSchema.parse(42)).toThrow();
+        expect(() => TranslationKeysSchema.parse(null)).toThrow();
+        expect(() => TranslationKeysSchema.parse(undefined)).toThrow();
+    });
+    test("safeParse reports failure without throwing", () => {
+        const result = TranslationKeysSchema.safeParse("no.such.key");
+        expect(result.success).toBe(false);
+    });
+    test("is case sensitive", () => {
+        const [firstKey] = keys;
+        expect(firstKey).toBeDefined();
+        const upper = String(firstKey).toUpperCase();
+        if (upper !== firstKey) {
+            expect(() => TranslationKeysSchema.parse(upper)).toThrow();
+        }
+    });
+    test("exposes exactly the derived keys as enum options", () => {
+        expect(new Set(TranslationKeysSchema.options)).toEqual(new Set(keys));
+    });
+});
+//# sourceMappingURL=translationKey.unit.test.js.map

package/dist/tests/translationKey.unit.test.js.map

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

package/dist/tests/translations.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=translations.unit.test.d.ts.map

package/dist/tests/translations.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.unit.test.d.ts","sourceRoot":"","sources":["../../src/tests/translations.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/translations.unit.test.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, test } from "vitest";
+import { LanguageSchema, Languages } from "../translations.js";
+const codes = Object.values(Languages);
+describe("Languages", () => {
+    test("is non-empty", () => {
+        expect(codes.length).toBeGreaterThan(0);
+    });
+    test("maps English language names to BCP 47 codes", () => {
+        expect(Languages.english).toBe("en");
+        expect(Languages.chinese).toBe("zh-CN");
+        expect(Languages.portugeseBrazil).toBe("pt-BR");
+    });
+    test("includes the fallback language", () => {
+        expect(codes).toContain("en");
+    });
+    test("has no duplicate codes", () => {
+        expect(new Set(codes).size).toBe(codes.length);
+    });
+    test("every code is a well-formed, lowercase-primary language tag", () => {
+        for (const code of codes) {
+            expect(code).toMatch(/^[a-z]{2}(-[A-Z]{2})?$/);
+        }
+    });
+    test("every code has a locales directory containing translation.json", () => {
+        for (const code of codes) {
+            const file = path.resolve(`./src/locales/${code}/translation.json`);
+            expect(fs.existsSync(file), `missing ${code}`).toBe(true);
+        }
+    });
+    test("every locales directory is claimed by a code — no orphans", () => {
+        const dirs = fs.readdirSync(path.resolve("./src/locales"));
+        for (const dir of dirs) {
+            expect(codes, `orphan locale directory ${dir}`).toContain(dir);
+        }
+    });
+});
+describe("LanguageSchema", () => {
+    test("accepts every declared code", () => {
+        for (const code of codes) {
+            expect(LanguageSchema.parse(code)).toBe(code);
+        }
+    });
+    test("exposes each code on .enum for use as a constant", () => {
+        expect(LanguageSchema.enum.en).toBe("en");
+    });
+    test("rejects an undeclared language code", () => {
+        expect(() => LanguageSchema.parse("xx")).toThrow();
+    });
+    test("rejects the empty string", () => {
+        expect(() => LanguageSchema.parse("")).toThrow();
+    });
+    test("rejects a regional variant of a supported language", () => {
+        expect(() => LanguageSchema.parse("en-GB")).toThrow();
+    });
+    test("is case sensitive — `EN` is not `en`", () => {
+        expect(() => LanguageSchema.parse("EN")).toThrow();
+    });
+    test("rejects non-string input", () => {
+        expect(() => LanguageSchema.parse(1)).toThrow();
+        expect(() => LanguageSchema.parse(null)).toThrow();
+        expect(() => LanguageSchema.parse(undefined)).toThrow();
+        expect(() => LanguageSchema.parse(["en"])).toThrow();
+    });
+    test("safeParse reports failure without throwing", () => {
+        expect(LanguageSchema.safeParse("xx").success).toBe(false);
+        expect(LanguageSchema.safeParse("en").success).toBe(true);
+    });
+    test("its options are exactly the declared codes", () => {
+        expect(new Set(LanguageSchema.options)).toEqual(new Set(codes));
+    });
+});
+//# sourceMappingURL=translations.unit.test.js.map

package/dist/tests/translations.unit.test.js.map

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