@inlang/paraglide-js 2.0.0-beta.14 → 2.0.0-beta.15

package/dist/compiler/compile-message.js

@@ -56,9 +56,8 @@ function compileMessageWithMultipleVariants(declarations, message, variants, reg
             continue;
         compiledVariants.push(`if (${conditions.join(" && ")}) return ${compiledPattern.code};`);
     }
-    const code = `
-		export const ${message.bundleId} = (i) => {
-				${compiledVariants.join("\n\n")}
-		}`;
+    const code = `export const ${message.bundleId} = (i) => {
+	${compiledVariants.join("\n\t")}
+}`;
     return { code, node: message };
 }

package/dist/compiler/compile-project.d.ts

@@ -12,7 +12,7 @@ import { type CompilerOptions } from "./compile.js";
  */
 export declare const compileProject: (args: {
     project: InlangProject;
-    compilerOptions?: Pick<CompilerOptions, "emitGitIgnore" | "emitPrettierIgnore" | "outputStructure">;
+    compilerOptions?: Omit<CompilerOptions, "fs" | "project" | "outdir">;
 }) => Promise<Record<string, string>>;
 export declare function getFallbackMap<T extends string>(locales: T[], baseLocale: NoInfer<T>): Record<T, T | undefined>;
 //# sourceMappingURL=compile-project.d.ts.map

package/dist/compiler/compile-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile-project.d.ts","sourceRoot":"","sources":["../../src/compiler/compile-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAgB;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,IAAI,CACrB,eAAe,EACf,eAAe,GAAG,oBAAoB,GAAG,iBAAiB,CAC1D,CAAC;CACF,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuDjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAY1B"}
+{"version":3,"file":"compile-project.d.ts","sourceRoot":"","sources":["../../src/compiler/compile-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAgB;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;CACrE,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoEjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAY1B"}

package/dist/compiler/compile-project.js

@@ -32,11 +32,11 @@ export const compileProject = async (args) => {
     }));
     const output = {};
     if (optionsWithDefaults.outputStructure === "locale-modules") {
-        const regularOutput = generateLocaleModules(compiledBundles, settings, fallbackMap);
+        const regularOutput = generateLocaleModules(compiledBundles, settings, fallbackMap, optionsWithDefaults);
         Object.assign(output, regularOutput);
     }
     if (optionsWithDefaults.outputStructure === "message-modules") {
-        const messageModuleOutput = generateMessageModules(compiledBundles, settings, fallbackMap);
+        const messageModuleOutput = generateMessageModules(compiledBundles, settings, fallbackMap, optionsWithDefaults);
         Object.assign(output, messageModuleOutput);
     }
     if (optionsWithDefaults.emitGitIgnore) {
@@ -45,9 +45,17 @@ export const compileProject = async (args) => {
     if (optionsWithDefaults.emitPrettierIgnore) {
         output[".prettierignore"] = ignoreDirectory;
     }
-    for (const file in output) {
-        if (file.endsWith(".js") || file.endsWith(".ts")) {
-            output[file] = `// @ts-nocheck\n${output[file]}`;
+    for (const [filename, content] of Object.entries(optionsWithDefaults.additionalFiles ?? {})) {
+        output[filename] = content;
+    }
+    for (const [filename, content] of Object.entries(output)) {
+        if (filename.endsWith(".js") || filename.endsWith(".ts")) {
+            output[filename] = `// @ts-nocheck\n${output[filename]}`;
+        }
+        if (optionsWithDefaults.includeEslintDisableComment) {
+            if (filename.endsWith(".js")) {
+                output[filename] = `// eslint-disable\n${content}`;
+            }
         }
     }
     return output;

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

@@ -8,6 +8,12 @@ beforeEach(() => {
     // reset the imports to make sure that the runtime is reloaded
     vi.resetModules();
     vi.clearAllMocks();
+    // mocking DOM globals
+    // @ts-expect-error - global variable definition
+    globalThis.window = {};
+    // @ts-expect-error - global variable definition
+    globalThis.window.location = {};
+    globalThis.window.location.reload = () => { };
 });
 test("emitGitignore", async () => {
     const project = await loadProjectInMemory({
@@ -61,9 +67,11 @@ describe.each([
     // useTsImports must be true to test emitTs. Otherwise, rolldown can't resolve the imports
     {
         outputStructure: "locale-modules",
+        strategy: ["variable", "baseLocale"],
     },
     {
         outputStructure: "message-modules",
+        strategy: ["variable", "baseLocale"],
     },
 ])("options", async (compilerOptions) => {
     const output = await compileProject({ project, compilerOptions });
@@ -280,6 +288,7 @@ describe.each([
                 strict: true,
             },
         });
+        console.log(output["runtime.js"]);
         for (const [fileName, code] of Object.entries(output)) {
             if (fileName.endsWith(".js") || fileName.endsWith(".ts")) {
                 project.createSourceFile(fileName, code);
@@ -375,11 +384,6 @@ describe.each([
 async function bundleCode(output, file) {
     const bundle = await rolldown({
         input: ["main.js"],
-        resolve: {
-            extensionAlias: {
-                ".js": [".ts", ".js"],
-            },
-        },
         plugins: [
             // @ts-expect-error - rollup types are not up to date
             virtual({

package/dist/compiler/compile.d.ts

@@ -1,8 +1,11 @@
+import type { Runtime } from "./runtime/type.js";
 export declare const defaultCompilerOptions: {
     readonly outputStructure: "message-modules";
     readonly emitGitIgnore: true;
     readonly includeEslintDisableComment: true;
     readonly emitPrettierIgnore: true;
+    readonly strategy: ["cookie", "variable", "baseLocale"];
+    readonly cookieName: "PARAGLIDE_LOCALE";
 };
 export type CompilerOptions = {
     /**
@@ -19,6 +22,28 @@ export type CompilerOptions = {
      *   './src/paraglide'
      */
     outdir: string;
+    /**
+     * The strategy to use for getting the locale.
+     *
+     * The order of the strategy defines the precendence of matches.
+     *
+     * For example, in `['pathname', 'cookie', 'baseLocale']`, the locale will be
+     * first tried to be detected in the pathname, then in a cookie, and finally
+     * fallback to the base locale.
+     *
+     * The default ensures that the browser takes a cookie approach,
+     * server-side takes the variable (because cookie is unvailable),
+     * whereas both fallback to the base locale if not available.
+     *
+     * @default ["cookie", "variable", "baseLocale"]
+     */
+    strategy?: Runtime["strategy"];
+    /**
+     * The name of the cookie to use for the cookie strategy.
+     *
+     * @default 'PARAGLIDE_LOCALE'
+     */
+    cookieName?: string;
     /**
      * Additional files that should be emmited in the outdir.
      *

package/dist/compiler/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compiler/compile.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,sBAAsB;;;;;CAKU,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACvD;;;;OAIG;IACH,EAAE,CAAC,EAAE,cAAc,SAAS,CAAC,CAAC;CAC9B,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DrE"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compiler/compile.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;CAOU,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACvD;;;;OAIG;IACH,EAAE,CAAC,EAAE,cAAc,SAAS,CAAC,CAAC;CAC9B,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CrE"}

package/dist/compiler/compile.js

@@ -9,6 +9,8 @@ export const defaultCompilerOptions = {
     emitGitIgnore: true,
     includeEslintDisableComment: true,
     emitPrettierIgnore: true,
+    strategy: ["cookie", "variable", "baseLocale"],
+    cookieName: "PARAGLIDE_LOCALE",
 };
 // This is a workaround to prevent multiple compilations from running at the same time.
 // https://github.com/opral/inlang-paraglide-js/issues/320#issuecomment-2596951222
@@ -45,19 +47,9 @@ export async function compile(options) {
             appId: ENV_VARIABLES.PARJS_APP_ID,
         });
         const output = await compileProject({
-            ...withDefaultOptions,
+            compilerOptions: withDefaultOptions,
             project,
         });
-        for (const [filename, content] of Object.entries(withDefaultOptions.additionalFiles ?? {})) {
-            output[filename] = content;
-        }
-        if (withDefaultOptions.includeEslintDisableComment) {
-            for (const [filename, content] of Object.entries(output)) {
-                if (filename.endsWith(".js")) {
-                    output[filename] = `// eslint-disable-next-line\n${content}`;
-                }
-            }
-        }
         await writeOutput(absoluteOutdir, output, fs.promises);
         if (!localAccount) {
             const activeAccount = await project.lix.db

package/dist/compiler/compile.test.js

@@ -1,7 +1,7 @@
 import { loadProjectInMemory, newProject, saveProjectToDirectory, } from "@inlang/sdk";
 import { memfs } from "memfs";
 import { test, expect, vi } from "vitest";
-import { compile } from "./compile.js";
+import { compile, defaultCompilerOptions } from "./compile.js";
 import { getAccountFilePath } from "../services/account/index.js";
 test("loads a project and compiles it", async () => {
     const project = await loadProjectInMemory({
@@ -183,7 +183,7 @@ test("includes eslint-disable comment", async () => {
         fs: fs,
     });
     const messages = await fs.promises.readFile("/output/messages.js", "utf8");
-    expect(messages).toContain("// eslint-disable-next-line");
+    expect(messages).toContain("// eslint-disable");
     await compile({
         project: "/project.inlang",
         outdir: "/output",
@@ -191,5 +191,13 @@ test("includes eslint-disable comment", async () => {
         fs: fs,
     });
     const messagesWithoutComment = await fs.promises.readFile("/output/messages.js", "utf8");
-    expect(messagesWithoutComment).not.toContain("// eslint-disable-next-line");
+    expect(messagesWithoutComment).not.toContain("// eslint-disable");
+});
+test("default compiler options should include 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()`
+    // without getting an error slammed in their face saying "define your strategy".
+    //
+    // instead, make the apis work out of the box and once the developer is convinced that
+    // paraglide js is the right tool for them, they can then define their own strategy.
+    expect(defaultCompilerOptions.strategy).toEqual(expect.arrayContaining(["variable", "baseLocale"]));
 });

package/dist/compiler/output-structure/locale-modules.d.ts

@@ -1,4 +1,8 @@
 import type { ProjectSettings } from "@inlang/sdk";
 import type { CompiledBundleWithMessages } from "../compile-bundle.js";
-export declare function generateLocaleModules(compiledBundles: CompiledBundleWithMessages[], settings: Pick<ProjectSettings, "locales" | "baseLocale">, fallbackMap: Record<string, string | undefined>): Record<string, string>;
+import { type CompilerOptions } from "../compile.js";
+export declare function generateLocaleModules(compiledBundles: CompiledBundleWithMessages[], settings: Pick<ProjectSettings, "locales" | "baseLocale">, fallbackMap: Record<string, string | undefined>, compilerOptions: {
+    strategy: NonNullable<CompilerOptions["strategy"]>;
+    cookieName: NonNullable<CompilerOptions["cookieName"]>;
+}): Record<string, string>;
 //# sourceMappingURL=locale-modules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"locale-modules.d.ts","sourceRoot":"","sources":["../../../src/compiler/output-structure/locale-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAKvE,wBAAgB,qBAAqB,CACpC,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,CAsDxB"}
+{"version":3,"file":"locale-modules.d.ts","sourceRoot":"","sources":["../../../src/compiler/output-structure/locale-modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAIvE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAgB,qBAAqB,CACpC,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,EAC/C,eAAe,EAAE;IAChB,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;CACvD,GACC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0DxB"}

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

@@ -1,7 +1,8 @@
 import { jsIdentifier } from "../../services/codegen/identifier.js";
-import { createRuntime } from "../runtime/create-runtime.js";
+import { createRuntimeFile } from "../runtime/create-runtime.js";
 import { createRegistry } from "../registry.js";
-export function generateLocaleModules(compiledBundles, settings, fallbackMap) {
+import {} from "../compile.js";
+export function generateLocaleModules(compiledBundles, settings, fallbackMap, compilerOptions) {
     const fileExt = "js";
     const importExt = "js";
     const indexFile = [
@@ -12,7 +13,11 @@ export function generateLocaleModules(compiledBundles, settings, fallbackMap) {
         compiledBundles.map(({ bundle }) => bundle.code).join("\n"),
     ].join("\n");
     const output = {
-        ["runtime." + fileExt]: createRuntime(settings),
+        ["runtime." + fileExt]: createRuntimeFile({
+            baseLocale: settings.baseLocale,
+            locales: settings.locales,
+            compilerOptions,
+        }),
         ["registry." + fileExt]: createRegistry(),
         ["messages." + fileExt]: indexFile,
     };

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

@@ -1,5 +1,6 @@
 import { test, expect } from "vitest";
 import { generateLocaleModules } from "./locale-modules.js";
+import { defaultCompilerOptions } from "../compile.js";
 test("should emit per locale message files", () => {
     const bundles = [
         {
@@ -29,7 +30,7 @@ test("should emit per locale message files", () => {
         en: "de",
         de: "en",
     };
-    const output = generateLocaleModules(bundles, settings, fallbackMap);
+    const output = generateLocaleModules(bundles, settings, fallbackMap, defaultCompilerOptions);
     expect(output).toHaveProperty("messages.js");
     expect(output).toHaveProperty("messages/en.js");
     expect(output).toHaveProperty("messages/de.js");
@@ -55,7 +56,7 @@ test("the files should include files for each locale, even if there are no messa
         en: "de",
         de: "en",
     };
-    const output = generateLocaleModules(bundles, settings, fallbackMap);
+    const output = generateLocaleModules(bundles, settings, fallbackMap, defaultCompilerOptions);
     expect(output).toHaveProperty("messages.js");
     expect(output).toHaveProperty("messages/en.js");
     expect(output).toHaveProperty("messages/de.js");

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

@@ -1,4 +1,8 @@
 import type { ProjectSettings } from "@inlang/sdk";
 import type { CompiledBundleWithMessages } from "../compile-bundle.js";
-export declare function generateMessageModules(compiledBundles: CompiledBundleWithMessages[], settings: Pick<ProjectSettings, "locales" | "baseLocale">, fallbackMap: Record<string, string | undefined>): Record<string, string>;
+import type { CompilerOptions } from "../compile.js";
+export declare function generateMessageModules(compiledBundles: CompiledBundleWithMessages[], settings: Pick<ProjectSettings, "locales" | "baseLocale">, fallbackMap: Record<string, string | undefined>, compilerOptions: {
+    strategy: NonNullable<CompilerOptions["strategy"]>;
+    cookieName: NonNullable<CompilerOptions["cookieName"]>;
+}): Record<string, string>;
 //# sourceMappingURL=message-modules.d.ts.map

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;AAMvE,wBAAgB,sBAAsB,CACrC,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,CAyDxB"}
+{"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,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,wBAAgB,sBAAsB,CACrC,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,EAC/C,eAAe,EAAE;IAChB,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;CACvD,GACC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkExB"}

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

@@ -1,10 +1,14 @@
-import { createRuntime } from "../runtime/create-runtime.js";
+import { createRuntimeFile } from "../runtime/create-runtime.js";
 import { createRegistry } from "../registry.js";
 import { jsIdentifier } from "../../services/codegen/identifier.js";
 import { escapeForSingleQuoteString } from "../../services/codegen/escape.js";
-export function generateMessageModules(compiledBundles, settings, fallbackMap) {
+export function generateMessageModules(compiledBundles, settings, fallbackMap, compilerOptions) {
     const output = {
-        ["runtime.js"]: createRuntime(settings),
+        ["runtime.js"]: createRuntimeFile({
+            baseLocale: settings.baseLocale,
+            locales: settings.locales,
+            compilerOptions,
+        }),
         ["registry.js"]: createRegistry(),
     };
     // messages index file
@@ -15,7 +19,6 @@ export function generateMessageModules(compiledBundles, settings, fallbackMap) {
     for (const compiledBundle of compiledBundles) {
         const filename = `messages/${compiledBundle.bundle.node.id}/index.js`;
         const code = [
-            `import * as registry from '../../registry.js'`,
             settings.locales
                 .map((locale) => `import * as ${jsIdentifier(locale)} from "./${locale}.js"`)
                 .join("\n"),
@@ -27,7 +30,7 @@ export function generateMessageModules(compiledBundles, settings, fallbackMap) {
     }
     for (const locale of settings.locales) {
         for (const compiledBundle of compiledBundles) {
-            let file = [`import * as registry from '../../registry.js'`].join("\n");
+            let file = "";
             const compiledMessage = compiledBundle.messages[locale];
             const id = jsIdentifier(compiledBundle.bundle.node.id);
             if (!compiledMessage) {
@@ -45,6 +48,11 @@ export function generateMessageModules(compiledBundles, settings, fallbackMap) {
             else {
                 file += `\n${compiledMessage.code}`;
             }
+            // Add the registry import to the message file
+            // if registry is used
+            if (file.includes("registry.")) {
+                file = `import { registry } from '../../registry.js'\n` + file;
+            }
             output[`messages/${compiledBundle.bundle.node.id}/${locale}.js`] = file;
         }
     }

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

@@ -1,5 +1,6 @@
 import { test, expect } from "vitest";
 import { generateMessageModules } from "./message-modules.js";
+import { defaultCompilerOptions } from "../compile.js";
 test("should emit per locale message files", () => {
     const resources = [
         {
@@ -29,7 +30,7 @@ test("should emit per locale message files", () => {
         en: "de",
         de: "en",
     };
-    const output = generateMessageModules(resources, settings, fallbackMap);
+    const output = generateMessageModules(resources, settings, fallbackMap, defaultCompilerOptions);
     expect(output).not.toHaveProperty("messages/en.js");
     expect(output).not.toHaveProperty("messages/de.js");
     expect(output).toHaveProperty("messages/happy_elephant/en.js");

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":"AAAA;;;;;;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":"AAGA;;;;;;GAMG;AACH,sCAJW,GAAG,GACD,MAAM,CAUlB"}

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

@@ -1,3 +1,5 @@
+import { isLocale } from "./is-locale.js";
+import { locales } from "./locales.js";
 /**
  * Asserts that the input is a locale.
  *

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

@@ -1,18 +1,25 @@
-import { assertIsLocale } from "./assert-is-locale.js";
 import { test, expect } from "vitest";
-import { mockRuntime } from "./mock-runtime.js";
-mockRuntime({
-    baseLocale: "en",
-    locales: ["en", "de", "fr"],
+import { createRuntimeForTesting } from "./create-runtime.js";
+test("throws if the locale is not available", async () => {
+    const runtime = await createRuntimeForTesting({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    expect(() => runtime.assertIsLocale("es")).toThrow();
 });
-test("throws if the locale is not available", () => {
-    expect(() => assertIsLocale("es")).toThrow();
+test("passes if the locale is available", async () => {
+    const runtime = await createRuntimeForTesting({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    expect(() => runtime.assertIsLocale("en")).not.toThrow();
 });
-test("passes if the locale is available", () => {
-    expect(() => assertIsLocale("en")).not.toThrow();
-});
-test("the return value is a Locale", () => {
-    const locale = assertIsLocale("en");
+test("the return value is a Locale", async () => {
+    const runtime = await createRuntimeForTesting({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    const locale = runtime.assertIsLocale("en");
     // a bit of a wacky test given that locale is `any`
     // in the ambient type definition
     locale;

package/dist/compiler/runtime/base-locale.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The project's base locale.
+ *
+ * @example
+ *   if (locale === baseLocale) {
+ *     // do something
+ *   }
+ */
+export const baseLocale: "<base-locale>";
+//# sourceMappingURL=base-locale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/base-locale.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,yBAA0B,eAAe,CAAC"}

package/dist/compiler/runtime/base-locale.js

@@ -0,0 +1,9 @@
+/**
+ * The project's base locale.
+ *
+ * @example
+ *   if (locale === baseLocale) {
+ *     // do something
+ *   }
+ */
+export const baseLocale = "<base-locale>";

package/dist/compiler/runtime/cookie-name.d.ts

@@ -0,0 +1,3 @@
+/** @type {string} */
+export const cookieName: string;
+//# sourceMappingURL=cookie-name.d.ts.map

package/dist/compiler/runtime/cookie-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-name.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/cookie-name.js"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,yBADW,MAAM,CACyB"}

package/dist/compiler/runtime/cookie-name.js

@@ -0,0 +1,2 @@
+/** @type {string} */
+export const cookieName = "<cookie-name>";

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

@@ -1,6 +1,31 @@
-import type { ProjectSettings } from "@inlang/sdk";
+import { type CompilerOptions } from "../compile.js";
+import type { Runtime } from "./type.js";
 /**
  * Returns the code for the `runtime.js` module
  */
-export declare function createRuntime(settings: Pick<ProjectSettings, "baseLocale" | "locales">): string;
+export declare function createRuntimeFile(args: {
+    baseLocale: string;
+    locales: string[];
+    compilerOptions: {
+        strategy: NonNullable<CompilerOptions["strategy"]>;
+        cookieName: NonNullable<CompilerOptions["cookieName"]>;
+    };
+}): string;
+/**
+ * Returns the runtime module as an object for testing purposes.
+ *
+ * @example
+ *   const runtime = await createRuntime({
+ *      baseLocale: "en",
+ *      locales: ["en", "de"],
+ *   })
+ */
+export declare function createRuntimeForTesting(args: {
+    baseLocale: string;
+    locales: string[];
+    compilerOptions?: {
+        strategy?: CompilerOptions["strategy"];
+        cookieName?: CompilerOptions["cookieName"];
+    };
+}): Promise<Runtime>;
 //# sourceMappingURL=create-runtime.d.ts.map

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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;GAEG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,SAAS,CAAC,GACvD,MAAM,CAQR"}
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/create-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;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;KACvD,CAAC;CACF,GAAG,MAAM,CA+ET;AAgBD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;QACvC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;KAC3C,CAAC;CACF,GAAG,OAAO,CAAC,OAAO,CAAC,CAcnB"}

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

@@ -1,11 +1,120 @@
-import { jsdocRuntime } from "./jsdoc-runtime.js";
+import fs from "node:fs";
+import { defaultCompilerOptions } from "../compile.js";
 /**
  * Returns the code for the `runtime.js` module
  */
-export function createRuntime(settings) {
-    return (jsdocRuntime
-        // replace the locales first
-        .replace('["<replace>"]', JSON.stringify(settings.locales))
-        // then the base locale
-        .replace('"<replace>"', JSON.stringify(settings.baseLocale)));
+export function createRuntimeFile(args) {
+    return `
+
+${injectCode("./base-locale.js").replace(`<base-locale>`, `${args.baseLocale}`)}
+
+${injectCode("./locales.js").replace(`["<base-locale>"]`, `["${args.locales.join('", "')}"]`)}
+
+${injectCode("./strategy.js").replace(`["variable"]`, `["${args.compilerOptions.strategy.join('", "')}"]`)}
+
+${injectCode("./cookie-name.js").replace(`<cookie-name>`, `${args.compilerOptions.cookieName}`)}
+
+/**
+ * Define the \`getLocale()\` function.
+ *
+ * Use this function to define how the locale is resolved. For example,
+ * you can resolve the locale from the browser's preferred language,
+ * a cookie, env variable, or a user's preference.
+ *
+ * @example
+ *   defineGetLocale(() => {
+ *     // resolve the locale from a cookie. fallback to the base locale.
+ *     return Cookies.get('locale') ?? baseLocale
+ *   }
+ *
+ * @param {() => Locale} fn
+ * @type {(fn: () => Locale) => void}
+ */
+export const defineGetLocale = (fn) => {
+	getLocale = fn;
+};
+
+/**
+ * Define the \`setLocale()\` function.
+ *
+ * Use this function to define how the locale is set. For example,
+ * modify a cookie, env variable, or a user's preference.
+ *
+ * @example
+ *   defineSetLocale((newLocale) => {
+ *     // set the locale in a cookie
+ *     return Cookies.set('locale', newLocale)
+ *   });
+ *
+ * @param {(newLocale: Locale) => void} fn
+ */
+export const defineSetLocale = (fn) => {
+	setLocale = fn;
+};
+
+${injectCode("./get-locale.js")} 
+
+${injectCode("./set-locale.js")}
+
+${injectCode("./is-locale.js")}
+
+${injectCode("./assert-is-locale.js")}
+
+${injectCode("./localize-path.js")}
+
+${injectCode("./de-localize-path.js")}
+
+${injectCode("./extract-locale-from-pathname.js")}
+
+${injectCode("./extract-locale-from-request.js")}
+
+${injectCode("./extract-locale-from-cookie.js")}
+
+// ------ TYPES ------
+
+/**
+ * A locale that is available in the project.
+ *
+ * @example
+ *   setLocale(request.locale as Locale)
+ *
+ * @typedef {(typeof locales)[number]} Locale
+ */
+
+`;
+}
+/**
+ * Load a file from the current directory.
+ *
+ * Prunes the imports on top of the file as the runtime is
+ * self-contained.
+ *
+ * @param {string} path
+ * @returns {string}
+ */
+function injectCode(path) {
+    const code = fs.readFileSync(new URL(path, import.meta.url), "utf-8");
+    return code.replace(/import\s+.*?;?\n/g, "");
+}
+/**
+ * Returns the runtime module as an object for testing purposes.
+ *
+ * @example
+ *   const runtime = await createRuntime({
+ *      baseLocale: "en",
+ *      locales: ["en", "de"],
+ *   })
+ */
+export async function createRuntimeForTesting(args) {
+    const file = createRuntimeFile({
+        baseLocale: args.baseLocale,
+        locales: args.locales,
+        compilerOptions: {
+            ...defaultCompilerOptions,
+            strategy: ["variable"],
+            ...args.compilerOptions,
+        },
+    });
+    return await import("data:text/javascript;base64," +
+        Buffer.from(file, "utf-8").toString("base64"));
 }

package/dist/compiler/runtime/de-localize-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de-localize-path.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/de-localize-path.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qCAHW,MAAM,GACJ,MAAM,CAQlB"}
+{"version":3,"file":"de-localize-path.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/de-localize-path.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qCAHW,MAAM,GACJ,MAAM,CAQlB"}