@inlang/paraglide-js 2.3.2 → 2.5.0

package/dist/cli/steps/update-ts-config.d.ts

@@ -11,4 +11,17 @@ export declare const maybeUpdateTsConfigAllowJs: CliStep<{
     fs: typeof import("node:fs/promises");
     logger: Logger;
 }, unknown>;
+/**
+ * Recursively checks whether allowJs is enabled in the provided tsconfig or any
+ * referenced configuration files.
+ *
+ * @param tsconfigPath The path to the tsconfig to inspect.
+ * @param fs The file system used to read the configs.
+ * @param visited A set of already inspected files to avoid circular lookups.
+ * @example
+ * ```ts
+ * await hasAllowJsEnabled("./tsconfig.json", fs);
+ * ```
+ */
+export declare const hasAllowJsEnabled: (tsconfigPath: string, fs: typeof import("node:fs/promises"), visited?: Set<string>) => Promise<boolean>;
 //# sourceMappingURL=update-ts-config.d.ts.map

package/dist/cli/steps/update-ts-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-ts-config.d.ts","sourceRoot":"","sources":["../../../src/cli/steps/update-ts-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAM7D,eAAO,MAAM,mBAAmB,EAAE,OAAO,CACxC;IAAE,EAAE,EAAE,cAAc,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,OAAO,CAKP,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAC/C;IAAE,EAAE,EAAE,cAAc,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,OAAO,CA4DP,CAAC"}
+{"version":3,"file":"update-ts-config.d.ts","sourceRoot":"","sources":["../../../src/cli/steps/update-ts-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAS7D,eAAO,MAAM,mBAAmB,EAAE,OAAO,CACxC;IAAE,EAAE,EAAE,cAAc,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,OAAO,CAKP,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAC/C;IAAE,EAAE,EAAE,cAAc,kBAAkB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,OAAO,CA6CP,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,GAC7B,cAAc,MAAM,EACpB,IAAI,cAAc,kBAAkB,CAAC,EACrC,UAAS,GAAG,CAAC,MAAM,CAAa,KAC9B,OAAO,CAAC,OAAO,CA4CjB,CAAC"}

package/dist/cli/steps/update-ts-config.js

@@ -1,7 +1,9 @@
 import { prompt } from "../utils.js";
 import JSON5 from "json5";
 import { pathExists } from "../../services/file-handling/exists.js";
-// import nodePath from "node:path";
+import nodePath from "node:path";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
 export const maybeUpdateTsConfig = async (ctx) => {
     const ctx1 = await maybeUpdateTsConfigAllowJs(ctx);
     return ctx1;
@@ -14,10 +16,7 @@ export const maybeUpdateTsConfigAllowJs = async (ctx) => {
     if ((await pathExists("./tsconfig.json", ctx.fs)) === false) {
         return ctx;
     }
-    const file = await ctx.fs.readFile("./tsconfig.json", { encoding: "utf-8" });
-    // tsconfig allows comments ... FML
-    let tsconfig = JSON5.parse(file);
-    if (tsconfig.compilerOptions?.allowJs === true) {
+    if (await hasAllowJsEnabled("./tsconfig.json", ctx.fs)) {
         // all clear, allowJs is already set to true
         return ctx;
     }
@@ -38,17 +37,7 @@ export const maybeUpdateTsConfigAllowJs = async (ctx) => {
             ctx.logger.warn("Continuing without adjusting the tsconfig.json. This may lead to type errors.");
             return ctx;
         }
-        // don't re-ask the question if there is an `extends` present in the tsconfig
-        // just trust that it's correct.
-        if (tsconfig.extends) {
-            isValid = true;
-            return ctx;
-        }
-        const file = await ctx.fs.readFile("./tsconfig.json", {
-            encoding: "utf-8",
-        });
-        tsconfig = JSON5.parse(file);
-        if (tsconfig?.compilerOptions?.allowJs === true) {
+        if (await hasAllowJsEnabled("./tsconfig.json", ctx.fs)) {
             isValid = true;
             return ctx;
         }
@@ -58,6 +47,132 @@ export const maybeUpdateTsConfigAllowJs = async (ctx) => {
     }
     return ctx;
 };
+/**
+ * Recursively checks whether allowJs is enabled in the provided tsconfig or any
+ * referenced configuration files.
+ *
+ * @param tsconfigPath The path to the tsconfig to inspect.
+ * @param fs The file system used to read the configs.
+ * @param visited A set of already inspected files to avoid circular lookups.
+ * @example
+ * ```ts
+ * await hasAllowJsEnabled("./tsconfig.json", fs);
+ * ```
+ */
+export const hasAllowJsEnabled = async (tsconfigPath, fs, visited = new Set()) => {
+    const normalizedPath = normalizeConfigPath(tsconfigPath);
+    if (visited.has(normalizedPath)) {
+        return false;
+    }
+    visited.add(normalizedPath);
+    const file = await fs.readFile(normalizedPath, { encoding: "utf-8" });
+    const tsconfig = JSON5.parse(file);
+    if (tsconfig?.compilerOptions?.allowJs === true) {
+        return true;
+    }
+    const baseDir = nodePath.dirname(normalizedPath);
+    const extendCandidates = Array.isArray(tsconfig?.extends)
+        ? tsconfig.extends
+        : tsconfig?.extends
+            ? [tsconfig.extends]
+            : [];
+    for (const candidate of extendCandidates) {
+        if (typeof candidate !== "string")
+            continue;
+        const resolved = await resolveExtendedConfig(candidate, baseDir, fs);
+        if (resolved && (await hasAllowJsEnabled(resolved, fs, visited))) {
+            return true;
+        }
+    }
+    if (Array.isArray(tsconfig?.references)) {
+        for (const reference of tsconfig.references) {
+            const referencePath = reference?.path;
+            if (typeof referencePath !== "string")
+                continue;
+            const resolved = await resolveReferenceConfig(referencePath, baseDir, fs);
+            if (resolved && (await hasAllowJsEnabled(resolved, fs, visited))) {
+                return true;
+            }
+        }
+    }
+    return false;
+};
+/**
+ * Normalizes a tsconfig path to an absolute path.
+ */
+const normalizeConfigPath = (configPath) => {
+    return nodePath.isAbsolute(configPath)
+        ? configPath
+        : nodePath.resolve(process.cwd(), configPath);
+};
+/**
+ * Resolves the extended tsconfig path relative to the base config.
+ */
+const resolveExtendedConfig = async (extendsSpecifier, baseDir, fs) => {
+    const candidates = new Set();
+    const resolvedBase = nodePath.isAbsolute(extendsSpecifier)
+        ? extendsSpecifier
+        : nodePath.resolve(baseDir, extendsSpecifier);
+    candidates.add(resolvedBase);
+    if (nodePath.extname(resolvedBase) === "") {
+        candidates.add(`${resolvedBase}.json`);
+        candidates.add(nodePath.join(resolvedBase, "tsconfig.json"));
+    }
+    for (const candidate of candidates) {
+        if (await pathExists(candidate, fs)) {
+            return candidate;
+        }
+    }
+    try {
+        return require.resolve(extendsSpecifier, { paths: [baseDir] });
+    }
+    catch {
+        if (extendsSpecifier.endsWith(".json") === false) {
+            try {
+                return require.resolve(`${extendsSpecifier}.json`, {
+                    paths: [baseDir],
+                });
+            }
+            catch {
+                return undefined;
+            }
+        }
+    }
+    return undefined;
+};
+/**
+ * Resolves the tsconfig referenced through the `references` property.
+ */
+const resolveReferenceConfig = async (referenceSpecifier, baseDir, fs) => {
+    const candidates = new Set();
+    const resolvedBase = nodePath.isAbsolute(referenceSpecifier)
+        ? referenceSpecifier
+        : nodePath.resolve(baseDir, referenceSpecifier);
+    candidates.add(resolvedBase);
+    if (nodePath.extname(resolvedBase) === "") {
+        candidates.add(`${resolvedBase}.json`);
+        candidates.add(nodePath.join(resolvedBase, "tsconfig.json"));
+    }
+    for (const candidate of candidates) {
+        if (await pathExists(candidate, fs)) {
+            try {
+                const stats = await fs.stat(candidate);
+                if (stats.isDirectory()) {
+                    const directoryConfig = nodePath.join(candidate, "tsconfig.json");
+                    if (await pathExists(directoryConfig, fs)) {
+                        return directoryConfig;
+                    }
+                    continue;
+                }
+            }
+            catch {
+                // ignore, we'll continue checking other candidates
+            }
+            return candidate;
+        }
+    }
+    return undefined;
+};
 // /**
 //  * Ensures that the moduleResolution compiler option is set to "bundler" or similar in the tsconfig.json.
 //  *

package/dist/cli/steps/update-ts-config.test.d.ts

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

package/dist/cli/steps/update-ts-config.test.d.ts.map

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

package/dist/cli/steps/update-ts-config.test.js

@@ -0,0 +1,59 @@
+import { expect, test, vi } from "vitest";
+import { memfs } from "memfs";
+import { maybeUpdateTsConfigAllowJs } from "./update-ts-config.js";
+import { Logger } from "../../services/logger/index.js";
+const setCwd = (cwd) => {
+    const original = process.cwd;
+    process.cwd = (() => cwd);
+    return () => {
+        process.cwd = original;
+    };
+};
+// Regression coverage for https://github.com/opral/inlang-paraglide-js/issues/560
+test("skips prompting when allowJs is set in a referenced tsconfig", async () => {
+    const fs = memfs({
+        "/tsconfig.json": JSON.stringify({
+            references: [{ path: "./tsconfig.app.json" }],
+        }),
+        "/tsconfig.app.json": JSON.stringify({
+            compilerOptions: { allowJs: true },
+        }),
+    }).fs;
+    const restoreCwd = setCwd("/");
+    const logger = new Logger({ silent: true, prefix: false });
+    const infoSpy = vi.spyOn(logger, "info");
+    try {
+        await maybeUpdateTsConfigAllowJs({
+            fs: fs.promises,
+            logger,
+        });
+        expect(infoSpy).not.toHaveBeenCalled();
+    }
+    finally {
+        restoreCwd();
+    }
+});
+// Regression coverage for https://github.com/opral/inlang-paraglide-js/issues/560
+test("skips prompting when allowJs is provided via extends", async () => {
+    const fs = memfs({
+        "/tsconfig.json": JSON.stringify({
+            extends: "./tsconfig.base.json",
+        }),
+        "/tsconfig.base.json": JSON.stringify({
+            compilerOptions: { allowJs: true },
+        }),
+    }).fs;
+    const restoreCwd = setCwd("/");
+    const logger = new Logger({ silent: true, prefix: false });
+    const infoSpy = vi.spyOn(logger, "info");
+    try {
+        await maybeUpdateTsConfigAllowJs({
+            fs: fs.promises,
+            logger,
+        });
+        expect(infoSpy).not.toHaveBeenCalled();
+    }
+    finally {
+        restoreCwd();
+    }
+});

package/dist/compiler/compile-project.js

@@ -69,7 +69,7 @@ export const compileProject = async (args) => {
     for (const [filename, content] of Object.entries(output)) {
         if (optionsWithDefaults.includeEslintDisableComment) {
             if (filename.endsWith(".js")) {
-                output[filename] = `// eslint-disable\n${content}`;
+                output[filename] = `/* eslint-disable */\n${content}`;
             }
         }
     }

package/dist/compiler/compile-project.test.js

@@ -70,7 +70,7 @@ test("handles message bundles with a : in the id", async () => {
             },
         }),
     });
-    await insertBundleNested(project.db, createBundleNested({
+    await insertBundleNested(project, createBundleNested({
         id: "hello:world",
         messages: [
             {
@@ -97,7 +97,7 @@ test("can emit message bundles with more than 255 characters", async () => {
             },
         }),
     });
-    await insertBundleNested(project.db, createBundleNested({
+    await insertBundleNested(project, createBundleNested({
         // 300 characters long id
         id: "a".repeat(300),
         messages: [
@@ -199,7 +199,7 @@ describe.each([
                 settings: { locales: ["en", "de"], baseLocale: "en" },
             }),
         });
-        await insertBundleNested(project.db, createBundleNested({
+        await insertBundleNested(project, createBundleNested({
             id: "plural_test",
             declarations: [
                 { type: "input-variable", name: "count" },
@@ -333,7 +333,7 @@ describe.each([
                     settings: { locales: ["en", "de", "en-US"], baseLocale: "en" },
                 }),
             });
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "missingInGerman",
                 messages: [
                     {
@@ -363,7 +363,7 @@ describe.each([
                 }),
             });
             // Add test messages
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "greeting",
                 messages: [
                     {
@@ -380,7 +380,7 @@ describe.each([
                     },
                 ],
             }));
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "farewell",
                 messages: [
                     {
@@ -473,7 +473,7 @@ describe.each([
                     settings: { locales: ["en", "de"], baseLocale: "en" },
                 }),
             });
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "$502.23-hello_world",
                 messages: [
                     {
@@ -499,7 +499,7 @@ describe.each([
                     settings: { locales: ["en", "en-US"], baseLocale: "en" },
                 }),
             });
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "exists_in_both",
                 messages: [
                     {
@@ -523,7 +523,7 @@ describe.each([
                     },
                 ],
             }));
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "missing_in_en_US",
                 messages: [
                     {
@@ -552,7 +552,7 @@ describe.each([
                     settings: { locales: ["en"], baseLocale: "en" },
                 }),
             });
-            await insertBundleNested(project.db, createBundleNested({
+            await insertBundleNested(project, createBundleNested({
                 id: "happy🍌",
                 messages: [
                     {
@@ -578,7 +578,7 @@ describe.each([
             }),
         });
         // Create two bundles with the same name but different case
-        await insertBundleNested(project.db, createBundleNested({
+        await insertBundleNested(project, createBundleNested({
             id: "Helloworld",
             messages: [
                 {
@@ -593,7 +593,7 @@ describe.each([
                 },
             ],
         }));
-        await insertBundleNested(project.db, createBundleNested({
+        await insertBundleNested(project, createBundleNested({
             id: "helloworld",
             messages: [
                 {
@@ -883,7 +883,7 @@ const mockBundles = [
     },
 ];
 for (const bundle of mockBundles) {
-    await insertBundleNested(project.db, bundle);
+    await insertBundleNested(project, bundle);
 }
 function createBundleNested(args) {
     return {

package/dist/compiler/compile.test.js

@@ -237,7 +237,7 @@ test("includes eslint-disable comment", async () => {
         fs: fs,
     });
     const messages = await fs.promises.readFile("/output/messages.js", "utf8");
-    expect(messages).toContain("// eslint-disable");
+    expect(messages).toContain("/* eslint-disable */");
     await compile({
         project: "/project.inlang",
         outdir: "/output",
@@ -245,7 +245,7 @@ test("includes eslint-disable comment", async () => {
         fs: fs,
     });
     const messagesWithoutComment = await fs.promises.readFile("/output/messages.js", "utf8");
-    expect(messagesWithoutComment).not.toContain("// eslint-disable");
+    expect(messagesWithoutComment).not.toContain("/* eslint-disable */");
 });
 test("default compiler options should include cookied, variable and baseLocale to ensure easy try out of paraglide js, working both in server and browser environemnts", () => {
     // someone trying out paraglide js should be able to call `getLocale()` and `setLocale()`
@@ -298,16 +298,29 @@ test("emits warnings for modules that couldn't be imported via http", async () =
     const mock = vi.fn();
     consola.mockTypes(() => mock);
     const fs = memfs().fs;
+    const fetchMock = vi.fn().mockRejectedValue(new TypeError("network error"));
+    vi.stubGlobal("fetch", fetchMock);
+    const errorsSpy = vi.spyOn(project.errors, "get").mockResolvedValue([
+        {
+            message: "Failed to import module https://example.com/non-existent-paraglide-plugin.js",
+        },
+    ]);
     // save project to directory to test loading
     await saveProjectToDirectory({
         project,
         path: "/project.inlang",
         fs: fs.promises,
     });
-    await compile({
-        project: "/project.inlang",
-        outdir: "/output",
-        fs: fs,
-    });
+    try {
+        await compile({
+            project: "/project.inlang",
+            outdir: "/output",
+            fs: fs,
+        });
+    }
+    finally {
+        vi.unstubAllGlobals();
+        errorsSpy.mockRestore();
+    }
     expect(mock).toHaveBeenCalled();
 });

package/dist/compiler/output-file.d.ts

@@ -0,0 +1,6 @@
+export type OutputFile = {
+    filename: string;
+    contents: string;
+};
+export type EmitOutputFile = (file: OutputFile) => void | Promise<void>;
+//# sourceMappingURL=output-file.d.ts.map

package/dist/compiler/output-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-file.d.ts","sourceRoot":"","sources":["../../src/compiler/output-file.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/compiler/output-file.js

@@ -0,0 +1 @@
+export {};

package/dist/compiler/output-structure/message-modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-modules.d.ts","sourceRoot":"","sources":["../../../src/compiler/output-structure/message-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAKvE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAE1E;AAED,wBAAgB,cAAc,CAC7B,eAAe,EAAE,0BAA0B,EAAE,EAC7C,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,YAAY,CAAC,EACzD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkFxB"}
+{"version":3,"file":"message-modules.d.ts","sourceRoot":"","sources":["../../../src/compiler/output-structure/message-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAKvE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAE1E;AAED,wBAAgB,cAAc,CAC7B,eAAe,EAAE,0BAA0B,EAAE,EAC7C,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,YAAY,CAAC,EACzD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+GxB"}

package/dist/compiler/output-structure/message-modules.js

@@ -31,19 +31,41 @@ export function generateOutput(compiledBundles, settings, fallbackMap) {
         }
         // add the fallbacks (needs to be done after the messages to avoid referencing
         // the message before they are defined)
-        for (const locale of needsFallback) {
-            // add fallback
+        const needsFallbackSet = new Set(needsFallback);
+        const emittedFallbacks = new Set();
+        const emittingFallbacks = new Set();
+        /**
+         * Emits the fallback definition for a locale ensuring that dependent fallbacks
+         * are declared beforehand.
+         *
+         * @example
+         * emitFallback("fr-ca");
+         */
+        const emitFallback = (locale) => {
+            if (emittedFallbacks.has(locale))
+                return;
+            if (emittingFallbacks.has(locale))
+                return;
+            emittingFallbacks.add(locale);
             const safeLocale = toSafeModuleId(locale);
             const fallbackLocale = fallbackMap[locale];
+            if (fallbackLocale &&
+                needsFallbackSet.has(fallbackLocale) &&
+                !compiledBundle.messages[fallbackLocale]) {
+                emitFallback(fallbackLocale);
+            }
             if (fallbackLocale) {
                 const safeFallbackLocale = toSafeModuleId(fallbackLocale);
-                // take the fallback locale
                 messages.push(`/** @type {(inputs: ${inputsType(inputs)}) => string} */\nconst ${safeLocale}_${safeModuleId} = ${safeFallbackLocale}_${safeModuleId};`);
             }
             else {
-                // fallback to just the bundle id
                 messages.push(`/** @type {(inputs: ${inputsType(inputs)}) => string} */\nconst ${safeLocale}_${safeModuleId} = () => '${escapeForSingleQuoteString(bundleId)}'`);
             }
+            emittingFallbacks.delete(locale);
+            emittedFallbacks.add(locale);
+        };
+        for (const locale of needsFallback) {
+            emitFallback(locale);
         }
         output[filename] = messages.join("\n\n") + "\n\n" + output[filename];
         // add the imports

package/dist/compiler/output-structure/message-modules.test.js

@@ -75,3 +75,45 @@ test("handles case senstivity by creating directories and files only in lowercas
     expect(output).toHaveProperty("messages/happyelephant2.js");
     expect(output).not.toHaveProperty("messages/HappyElephant.js");
 });
+// Regression test for https://github.com/opral/inlang-paraglide-js/issues/507
+test("emits fallback definitions after their dependencies", () => {
+    const resources = [
+        {
+            bundle: {
+                code: "export const admin_tasks = (inputs) => inputs;",
+                node: {
+                    id: "admin_tasks",
+                    declarations: [],
+                },
+            },
+            messages: {
+                en: {
+                    code: '/** @type {(inputs: {}) => string} */ () => "admin"',
+                    node: {},
+                },
+            },
+        },
+    ];
+    const settings = {
+        locales: ["fr-ca", "fr", "en"],
+        baseLocale: "en",
+    };
+    const fallbackMap = {
+        "fr-ca": "fr",
+        fr: "en",
+        en: undefined,
+    };
+    const output = generateOutput(resources, settings, fallbackMap);
+    const file = output["messages/admin_tasks.js"];
+    expect(file).toBeDefined();
+    if (!file) {
+        throw new Error("messages/admin_tasks.js should have been generated");
+    }
+    expect(file).toContain("const fr_admin_tasks = en_admin_tasks;");
+    expect(file).toContain("const fr_ca_admin_tasks = fr_admin_tasks;");
+    const frIndex = file.indexOf("const fr_admin_tasks");
+    const frCaIndex = file.indexOf("const fr_ca_admin_tasks");
+    expect(frIndex).toBeGreaterThan(-1);
+    expect(frCaIndex).toBeGreaterThan(-1);
+    expect(frIndex).toBeLessThan(frCaIndex);
+});

package/dist/compiler/runtime/assert-is-locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-is-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/assert-is-locale.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,sCAJW,GAAG,GACD,MAAM,CAUlB"}
+{"version":3,"file":"assert-is-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/assert-is-locale.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,sCAJW,GAAG,GACD,MAAM,CAiBlB"}

package/dist/compiler/runtime/assert-is-locale.js

@@ -1,4 +1,3 @@
-import { isLocale } from "./is-locale.js";
 import { locales } from "./variables.js";
 /**
  * Asserts that the input is a locale.
@@ -8,8 +7,13 @@ import { locales } from "./variables.js";
  * @throws {Error} If the input is not a locale.
  */
 export function assertIsLocale(input) {
-    if (isLocale(input) === false) {
+    if (typeof input !== "string") {
+        throw new Error(`Invalid locale: ${input}. Expected a string.`);
+    }
+    const lowerInput = input.toLowerCase();
+    const matchedLocale = locales.find((item) => item.toLowerCase() === lowerInput);
+    if (!matchedLocale) {
         throw new Error(`Invalid locale: ${input}. Expected one of: ${locales.join(", ")}`);
     }
-    return input;
+    return matchedLocale;
 }

package/dist/compiler/runtime/assert-is-locale.test.js

@@ -1,6 +1,6 @@
-import { test, expect } from "vitest";
-import { createParaglide } from "../create-paraglide.js";
 import { newProject } from "@inlang/sdk";
+import { expect, test } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
 test("throws if the locale is not available", async () => {
     const runtime = await createParaglide({
         blob: await newProject({
@@ -12,6 +12,21 @@ test("throws if the locale is not available", async () => {
     });
     expect(() => runtime.assertIsLocale("es")).toThrow();
 });
+test("throws for non-string inputs", async () => {
+    const runtime = await createParaglide({
+        blob: await newProject({
+            settings: {
+                baseLocale: "en",
+                locales: ["en", "de"],
+            },
+        }),
+    });
+    expect(() => runtime.assertIsLocale(null)).toThrow();
+    expect(() => runtime.assertIsLocale(undefined)).toThrow();
+    expect(() => runtime.assertIsLocale(123)).toThrow();
+    expect(() => runtime.assertIsLocale({})).toThrow();
+    expect(() => runtime.assertIsLocale([])).toThrow();
+});
 test("passes if the locale is available", async () => {
     const runtime = await createParaglide({
         blob: await newProject({
@@ -37,3 +52,19 @@ test("the return value is a Locale", async () => {
     // in the ambient type definition
     locale;
 });
+test("is case-insensitive", async () => {
+    const runtime = await createParaglide({
+        blob: await newProject({
+            settings: {
+                baseLocale: "en",
+                locales: ["en", "pt-BR", "de-ch"],
+            },
+        }),
+    });
+    expect(() => runtime.assertIsLocale("EN")).not.toThrow();
+    expect(() => runtime.assertIsLocale("pt-br")).not.toThrow();
+    expect(() => runtime.assertIsLocale("de-CH")).not.toThrow();
+    expect(runtime.assertIsLocale("EN")).toBe("en");
+    expect(runtime.assertIsLocale("pT-bR")).toBe("pt-BR");
+    expect(runtime.assertIsLocale("de-CH")).toBe("de-ch");
+});

package/dist/compiler/runtime/create-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/create-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE;QAChB,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QACvD,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3D,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;QAC9C,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;QAC7C,qCAAqC,EAAE,eAAe,CAAC,uCAAuC,CAAC,CAAC;QAChG,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;QACtC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACpD,wBAAwB,EAAE,WAAW,CACpC,eAAe,CAAC,0BAA0B,CAAC,CAC3C,CAAC;KACF,CAAC;CACF,GAAG,MAAM,CA0IT"}
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/create-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE;QAChB,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;QACvD,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3D,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;QAC9C,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;QAC7C,qCAAqC,EAAE,eAAe,CAAC,uCAAuC,CAAC,CAAC;QAChG,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;QACtC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;QACpD,wBAAwB,EAAE,WAAW,CACpC,eAAe,CAAC,0BAA0B,CAAC,CAC3C,CAAC;KACF,CAAC;CACF,GAAG,MAAM,CA4IT"}

package/dist/compiler/runtime/create-runtime.js

@@ -74,6 +74,8 @@ ${injectCode("./extract-locale-from-url.js")}
 
 ${injectCode("./localize-url.js")}
 
+${injectCode("./should-redirect.js")}
+
 ${injectCode("./localize-href.js")}
 
 ${injectCode("./track-message-call.js")}

package/dist/compiler/runtime/is-locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/is-locale.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,iCAHW,GAAG,GACD,MAAM,IAAI,MAAM,CAI5B"}
+{"version":3,"file":"is-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/is-locale.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,iCAHW,GAAG,GACD,MAAM,IAAI,MAAM,CAO5B"}