@inlang/paraglide-js 2.0.0-beta.21 → 2.0.0-beta.23

package/README.md

@@ -1,63 +1,5 @@
 [![Inlang-ecosystem compatibility badge](https://cdn.jsdelivr.net/gh/opral/monorepo@main/inlang/assets/md-badges/inlang.svg)](https://inlang.com)
 
-# Getting started
+A compiler-based i18n library that emits tree-shakable message functions. This means that only the messages you actually use are loaded without asynchronous waterfalls.
 
-To auto setup Paraglide JS, run the following command:
-
-```bash
-npx @inlang/paraglide-js@latest init
-```
-
-This will:
-
-- Create an [inlang project](https://inlang.com/documentation/concept/project)
-- Install necessary dependencies
-- Generate a `messages/` folder where your translation files live
-
-## Adding and editing Messages
-
-Messages are stored in `messages/{locale}.json` as key-value pairs. You can add parameters with curly braces.
-
-```diff
-// messages/en.json
-{
-+ 	"greeting": "Hello {name}!"
-}
-```
-
-Run the compiler via the CLI to generate the message functions.
-
-```bash
-npx @inlang/paraglide-js compile --project ./project.inlang --outdir ./src/paraglide
-```
-
-_If you are using a Bundler use one of the [Bundler Plugins](usage#usage-with-a-bundler) to recompile automatically._
-
-## Using messages in code
-
-After running the compiler import the messages with `import { m } from "./paraglide/messages"`. By convention, a wildcard import is used.
-
-```js
-import { m } from "./paraglide/messages.js";
-
-m.greeting({ name: "Samuel" }); // Hello Samuel!
-```
-
-## Changing the locale 
-
-To change the locale, use the `setLocale` function. 
-
-```js
-import { setLocale } from "./paraglide/runtime.js";
-import { m } from "./paraglide/messages.js";
-
-m.greeting({ name: "Samuel" }); // Hello Samuel!
-
-setLocale("de");
-
-m.greeting({ name: "Samuel" }); // Guten Tag Samuel!
-```
-
-## Define your strategy 
-
-In the last step, you need to define what strategy you want to use to resolve the locale. Visit the [strategy documentation](https://inlang.com/m/gerre34r/library-inlang-paraglideJs/strategy) to learn more.
+Visit https://inlang.com/m/gerre34r/library-inlang-paraglideJs to learn more.

package/dist/bundler-plugins/esbuild.d.ts

@@ -0,0 +1,2 @@
+export declare const paraglideEsbuildPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").EsbuildPlugin;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/bundler-plugins/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/esbuild.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,sFAAuC,CAAC"}

package/dist/bundler-plugins/esbuild.js

@@ -0,0 +1,3 @@
+import { createEsbuildPlugin } from "unplugin";
+import { unpluginFactory } from "./unplugin.js";
+export const paraglideEsbuildPlugin = createEsbuildPlugin(unpluginFactory);

package/dist/bundler-plugins/index.d.ts

@@ -1,4 +1,7 @@
-export { paraglideVitePlugin } from "./vite.js";
+export { paraglideEsbuildPlugin } from "./esbuild.js";
+export { paraglideRolldownPlugin } from "./rolldown.js";
 export { paraglideRollupPlugin } from "./rollup.js";
+export { paraglideRspackPlugin } from "./rspack.js";
+export { paraglideVitePlugin } from "./vite.js";
 export { paraglideWebpackPlugin } from "./webpack.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/bundler-plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/bundler-plugins/index.js

@@ -1,3 +1,6 @@
-export { paraglideVitePlugin } from "./vite.js";
+export { paraglideEsbuildPlugin } from "./esbuild.js";
+export { paraglideRolldownPlugin } from "./rolldown.js";
 export { paraglideRollupPlugin } from "./rollup.js";
+export { paraglideRspackPlugin } from "./rspack.js";
+export { paraglideVitePlugin } from "./vite.js";
 export { paraglideWebpackPlugin } from "./webpack.js";

package/dist/bundler-plugins/rolldown.d.ts

@@ -0,0 +1,2 @@
+export declare const paraglideRolldownPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").RolldownPlugin<any> | import("unplugin").RolldownPlugin<any>[];
+//# sourceMappingURL=rolldown.d.ts.map

package/dist/bundler-plugins/rolldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rolldown.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,uIAAwC,CAAC"}

package/dist/bundler-plugins/rolldown.js

@@ -0,0 +1,3 @@
+import { createRolldownPlugin } from "unplugin";
+import { unpluginFactory } from "./unplugin.js";
+export const paraglideRolldownPlugin = createRolldownPlugin(unpluginFactory);

package/dist/bundler-plugins/rollup.d.ts

@@ -1,2 +1,2 @@
-export declare const paraglideRollupPlugin: (options: import("../index.js").CompilerOptions) => import("rollup").Plugin<any> | import("rollup").Plugin<any>[];
+export declare const paraglideRollupPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").RollupPlugin<any> | import("unplugin").RollupPlugin<any>[];
 //# sourceMappingURL=rollup.d.ts.map

package/dist/bundler-plugins/rollup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rollup.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,mHAAsC,CAAC"}
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rollup.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,mIAAsC,CAAC"}

package/dist/bundler-plugins/rspack.d.ts

@@ -0,0 +1,2 @@
+export declare const paraglideRspackPlugin: (options: import("../index.js").CompilerOptions) => RspackPluginInstance;
+//# sourceMappingURL=rspack.d.ts.map

package/dist/bundler-plugins/rspack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspack.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rspack.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,0EAAsC,CAAC"}

package/dist/bundler-plugins/rspack.js

@@ -0,0 +1,3 @@
+import { createRspackPlugin } from "unplugin";
+import { unpluginFactory } from "./unplugin.js";
+export const paraglideRspackPlugin = createRspackPlugin(unpluginFactory);

package/dist/bundler-plugins/webpack.d.ts

@@ -1,2 +1,2 @@
-export declare const paraglideWebpackPlugin: (options: import("../index.js").CompilerOptions) => WebpackPluginInstance;
+export declare const paraglideWebpackPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").WebpackPluginInstance;
 //# sourceMappingURL=webpack.d.ts.map

package/dist/bundler-plugins/webpack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/webpack.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,2EAAuC,CAAC"}
+{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/webpack.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,8FAAuC,CAAC"}

package/dist/compiler/compile-bundle.js

@@ -38,7 +38,7 @@ const compileBundleFunction = (args) => {
 * ${jsDocBundleFunctionTypes({ inputs, locales: args.availableLocales })}
 */
 /* @__NO_SIDE_EFFECTS__ */
-${isSafeBundleId ? "export" : ""} const ${safeBundleId} = (inputs${hasInputs ? "" : "= {}"}, options = {}) => {
+${isSafeBundleId ? "export " : ""}const ${safeBundleId} = (inputs${hasInputs ? "" : " = {}"}, options = {}) => {
 	const locale = options.locale ?? getLocale()
 	${args.availableLocales
         .map((locale, index) => `${index > 0 ? "	" : ""}if (locale === "${locale}") return ${toSafeModuleId(locale)}.${safeBundleId}(inputs)`)

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

@@ -60,6 +60,32 @@ test("emitPrettierIgnore", async () => {
     expect(_true).toHaveProperty(".prettierignore");
     expect(_false).not.toHaveProperty(".prettierignore");
 });
+test("handles message bundles with a : in the id", async () => {
+    const project = await loadProjectInMemory({
+        blob: await newProject({
+            settings: {
+                locales: ["en", "de"],
+                baseLocale: "en",
+            },
+        }),
+    });
+    await insertBundleNested(project.db, createBundleNested({
+        id: "hello:world",
+        messages: [
+            {
+                locale: "en",
+                variants: [{ pattern: [{ type: "text", value: "Hello world!" }] }],
+            },
+        ],
+    }));
+    const output = await compileProject({
+        project,
+    });
+    const code = await bundleCode(output, `export * as m from "./paraglide/messages.js"
+		 export * as runtime from "./paraglide/runtime.js"`);
+    const { m } = await importCode(code);
+    expect(m["hello:world"]()).toBe("Hello world!");
+});
 // https://github.com/opral/inlang-paraglide-js/issues/347
 test("can emit message bundles with more than 255 characters", async () => {
     const project = await loadProjectInMemory({
@@ -464,10 +490,12 @@ describe.each([
 		m.sad_penguin_bundle({}, { locale: "---" })
   `);
         const program = project.createProgram();
-        const diagnostics = ts
-            .getPreEmitDiagnostics(program)
-            // runtime type here makes issues because of the path-to-regexp import
-            .filter((d) => !d.file?.fileName.includes("runtime.js"));
+        const diagnostics = ts.getPreEmitDiagnostics(program).filter((d) => {
+            // async_hooks is a node module that is not available in the browser
+            return !d.messageText
+                .toString()
+                .includes("Cannot find module 'async_hooks'");
+        });
         for (const diagnostic of diagnostics) {
             console.error(diagnostic.messageText, diagnostic.file?.fileName);
         }

package/dist/compiler/compile.test.js

@@ -27,7 +27,7 @@ test("loads a project and compiles it", async () => {
     });
     const files = await fs.promises.readdir("/output");
     //runtime.js and messages.js are always compiled with the default options
-    expect(files).toEqual(expect.arrayContaining(["runtime.js", "messages.js"]));
+    expect(files).toEqual(expect.arrayContaining(["runtime.js", "server.js", "messages.js"]));
 });
 test("loads a local account from app data if exists", async () => {
     const accountPath = getAccountFilePath();
@@ -180,7 +180,12 @@ test("emits additional files", async () => {
     });
     const outputDir = await fs.promises.readdir("/output");
     const adapterDir = await fs.promises.readdir("/output/adapter");
-    expect(outputDir).toEqual(expect.arrayContaining(["runtime.js", "messages.js", "adapter.js"]));
+    expect(outputDir).toEqual(expect.arrayContaining([
+        "runtime.js",
+        "server.js",
+        "messages.js",
+        "adapter.js",
+    ]));
     expect(adapterDir).toEqual(["component.svelte"]);
 });
 test("includes eslint-disable comment", async () => {

package/dist/compiler/compiler-options.d.ts

@@ -146,7 +146,10 @@ export type CompilerOptions = {
      *
      * **`locale-modules`**
      *
-     * Messages are bundled in a per locale module. Bundlers sometimes struggle tree-shaking this structure.
+     * Messages are bundled in a per locale module. Bundlers often struggle with tree-shaking this structure,
+     * which can lead to more inefficient tree-shaking and larger bundle sizes compared to `message-modules`.
+     *
+     * The benefit are substantially fewer files which is needed in large projects.
      *
      * ```diff
      *   - outdir/

package/dist/compiler/compiler-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler-options.d.ts","sourceRoot":"","sources":["../../src/compiler/compiler-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;CAOU,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;OAUG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;OAUG;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;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACvD;;;;OAIG;IACH,EAAE,CAAC,EAAE,GAAG,CAAC;CACT,CAAC"}
+{"version":3,"file":"compiler-options.d.ts","sourceRoot":"","sources":["../../src/compiler/compiler-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;CAOU,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;;;;;;OAUG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;OAUG;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;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IACvD;;;;OAIG;IACH,EAAE,CAAC,EAAE,GAAG,CAAC;CACT,CAAC"}

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;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,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,CA2DxB"}
+{"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;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,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,CA4DxB"}

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

@@ -1,6 +1,7 @@
 import { createRuntimeFile } from "../runtime/create-runtime.js";
 import { createRegistry } from "../registry.js";
 import { toSafeModuleId } from "../safe-module-id.js";
+import { createServerFile } from "../server/create-server-file.js";
 export function generateLocaleModules(compiledBundles, settings, fallbackMap, compilerOptions) {
     const indexFile = [
         `import { getLocale } from "../runtime.js"`,
@@ -15,6 +16,7 @@ export function generateLocaleModules(compiledBundles, settings, fallbackMap, co
             locales: settings.locales,
             compilerOptions,
         }),
+        ["server.js"]: createServerFile(),
         ["registry.js"]: createRegistry(),
         ["messages/_index.js"]: indexFile,
         ["messages.js"]: [

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;AAIvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,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,CAoFxB"}
+{"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;AAIvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,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,CAqFxB"}

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

@@ -2,6 +2,7 @@ import { createRuntimeFile } from "../runtime/create-runtime.js";
 import { createRegistry } from "../registry.js";
 import { escapeForSingleQuoteString } from "../../services/codegen/escape.js";
 import { toSafeModuleId } from "../safe-module-id.js";
+import { createServerFile } from "../server/create-server-file.js";
 export function generateMessageModules(compiledBundles, settings, fallbackMap, compilerOptions) {
     const output = {
         ["runtime.js"]: createRuntimeFile({
@@ -9,6 +10,7 @@ export function generateMessageModules(compiledBundles, settings, fallbackMap, c
             locales: settings.locales,
             compilerOptions,
         }),
+        ["server.js"]: createServerFile(),
         ["registry.js"]: createRegistry(),
     };
     // all messages index file

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

@@ -1,5 +1,6 @@
 import type { Runtime } from "./type.js";
 import { type CompilerOptions } from "../compiler-options.js";
+import type { ServerRuntime } from "../server/type.js";
 /**
  * Returns the code for the `runtime.js` module
  */
@@ -25,5 +26,5 @@ export declare function createRuntimeForTesting(args: {
     baseLocale: string;
     locales: string[];
     compilerOptions?: Omit<CompilerOptions, "outdir" | "project" | "fs">;
-}): Promise<Runtime>;
+}): Promise<Runtime & ServerRuntime>;
 //# 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":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,wBAAwB,CAAC;AAEhC;;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,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;KAC7C,CAAC;CACF,GAAG,MAAM,CAiGT;AAkBD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CACrE,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBnB"}
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/create-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;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,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;KAC7C,CAAC;CACF,GAAG,MAAM,CA+FT;AAkBD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CACrE,GAAG,OAAO,CAAC,OAAO,GAAG,aAAa,CAAC,CA0BnC"}

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

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import { defaultCompilerOptions, } from "../compiler-options.js";
+import { createServerFile } from "../server/create-server-file.js";
 /**
  * Returns the code for the `runtime.js` module
  */
@@ -53,8 +54,6 @@ ${injectCode("./localize-url.js")}
 
 ${injectCode("./localize-href.js")}
 
-${injectCode("./server-middleware.js")}
-
 // ------ TYPES ------
 
 /**
@@ -94,7 +93,7 @@ function injectCode(path) {
  *   })
  */
 export async function createRuntimeForTesting(args) {
-    const file = createRuntimeFile({
+    const clientSideRuntime = createRuntimeFile({
         baseLocale: args.baseLocale,
         locales: args.locales,
         compilerOptions: {
@@ -104,7 +103,12 @@ export async function createRuntimeForTesting(args) {
     })
         // remove the polyfill import statement to avoid module resolution logic in testing
         .replace(`import "@inlang/paraglide-js/urlpattern-polyfill";`, "");
+    // remove the server-side runtime import statement to avoid module resolution logic in testing
+    const serverSideRuntime = createServerFile()
+        .replace(`import * as runtime from "./runtime.js";`, "")
+        // the runtime functions are bundles, hence remove the runtime namespace
+        .replaceAll("runtime.", "");
     await import("urlpattern-polyfill");
     return await import("data:text/javascript;base64," +
-        Buffer.from(file, "utf-8").toString("base64"));
+        Buffer.from(clientSideRuntime + serverSideRuntime, "utf-8").toString("base64"));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"get-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-locale.js"],"names":[],"mappings":"AAwBA;;;;;;;;;;;GAWG;AACH,sBAFU,MAAM,MAAM,CAgDpB;AA4BF;;;;;;;;;;;;;;GAcG;AACH,iCAFU,CAAC,EAAE,EAAE,MAAM,MAAM,KAAK,IAAI,CAIlC"}
+{"version":3,"file":"get-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-locale.js"],"names":[],"mappings":"AAyBA;;;;;;;;;;;GAWG;AACH,sBAFU,MAAM,MAAM,CAgDpB;AA4BF;;;;;;;;;;;;;;GAcG;AACH,iCAFU,CAAC,EAAE,EAAE,MAAM,MAAM,KAAK,IAAI,CAIlC"}

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

@@ -1,6 +1,6 @@
 import { assertIsLocale } from "./assert-is-locale.js";
 import { isLocale } from "./is-locale.js";
-import { baseLocale, strategy, TREE_SHAKE_COOKIE_STRATEGY_USED, TREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED, TREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED, TREE_SHAKE_URL_STRATEGY_USED, } from "./variables.js";
+import { baseLocale, strategy, serverAsyncLocalStorage, TREE_SHAKE_COOKIE_STRATEGY_USED, TREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED, TREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED, TREE_SHAKE_URL_STRATEGY_USED, } from "./variables.js";
 import { extractLocaleFromCookie } from "./extract-locale-from-cookie.js";
 import { extractLocaleFromUrl } from "./extract-locale-from-url.js";
 /**
@@ -30,8 +30,8 @@ export let getLocale = () => {
     let locale;
     // if running in a server-side rendering context
     // retrieve the locale from the async local storage
-    if (serverMiddlewareAsyncStorage) {
-        const locale = serverMiddlewareAsyncStorage?.getStore()?.locale;
+    if (serverAsyncLocalStorage) {
+        const locale = serverAsyncLocalStorage?.getStore()?.locale;
         if (locale) {
             return locale;
         }

package/dist/compiler/runtime/get-url-origin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-url-origin.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-url-origin.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,yBAFU,MAAM,MAAM,CAWpB;AAEF;;;;;;;GAOG;AACH,kCAFU,CAAC,EAAE,EAAE,MAAM,MAAM,KAAK,IAAI,CAIlC"}
+{"version":3,"file":"get-url-origin.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-url-origin.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,yBAFU,MAAM,MAAM,CASpB;AAEF;;;;;;;GAOG;AACH,kCAFU,CAAC,EAAE,EAAE,MAAM,MAAM,KAAK,IAAI,CAIlC"}

package/dist/compiler/runtime/get-url-origin.js

@@ -1,3 +1,4 @@
+import { serverAsyncLocalStorage } from "./variables.js";
 /**
  * The origin of the current URL.
  *
@@ -8,8 +9,8 @@
  * @type {() => string}
  */
 export let getUrlOrigin = () => {
-    if (serverMiddlewareAsyncStorage) {
-        return (serverMiddlewareAsyncStorage.getStore()?.origin ?? "http://fallback.com");
+    if (serverAsyncLocalStorage) {
+        return serverAsyncLocalStorage.getStore()?.origin ?? "http://fallback.com";
     }
     else if (typeof window !== "undefined") {
         return window.location.origin;

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

@@ -0,0 +1,5 @@
+/**
+ * Returns the code for the `runtime.js` module
+ */
+export declare function createServerRuntimeFile(): string;
+//# sourceMappingURL=create-server-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-server-runtime.d.ts","sourceRoot":"","sources":["../../../../src/compiler/runtime/server/create-server-runtime.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD"}

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

@@ -0,0 +1,27 @@
+import fs from "node:fs";
+/**
+ * Returns the code for the `runtime.js` module
+ */
+export function createServerRuntimeFile() {
+    const code = `
+import * as runtime from "./runtime.js";
+
+${injectCode("./server-middleware.js")}
+`;
+    return code;
+}
+/**
+ * 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");
+    // Regex to match single-line and multi-line imports
+    const importRegex = /import\s+[\s\S]*?from\s+['"][^'"]+['"]\s*;?/g;
+    return code.replace(importRegex, "").trim();
+}

package/dist/compiler/runtime/server/server-middleware.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Server middleware that handles locale-based routing and request processing.
+ *
+ * This middleware performs several key functions:
+ *
+ * 1. Determines the locale for the incoming request using configured strategies
+ * 2. Handles URL localization and redirects
+ * 3. Maintains locale state using AsyncLocalStorage to prevent request interference
+ *
+ * When URL strategy is used:
+ *
+ * - If URL doesn't match the determined locale, redirects to localized URL
+ * - De-localizes URLs before passing to server (e.g., `/fr/about` → `/about`)
+ *
+ * @template T - The return type of the resolve function
+ *
+ * @param {Request} request - The incoming request object
+ * @param {(args: { request: Request, locale: import("./runtime.js").Locale }) => T | Promise<T>} resolve - Function to handle the request
+ * @param {Object} [options] - Optional configuration for the middleware
+ * @param {boolean} [options.disableAsyncLocalStorage=false] - If true, disables AsyncLocalStorage usage.
+ *                                                           ⚠️ WARNING: This should ONLY be used in serverless environments
+ *                                                           like Cloudflare Workers. Disabling AsyncLocalStorage in traditional
+ *                                                           server environments risks cross-request pollution where state from
+ *                                                           one request could leak into another concurrent request.
+ *
+ * @returns {Promise<Response | any>} Returns either:
+ * - A `Response` object (302 redirect) if URL localization is needed
+ * - The result of the resolve function if no redirect is required
+ *
+ * @example
+ * ```typescript
+ * // Basic usage in metaframeworks like NextJS, SvelteKit, Astro, Nuxt, etc.
+ * export const handle = async ({ event, resolve }) => {
+ *   return serverMiddleware(event.request, ({ request, locale }) => {
+ *     // let the framework further resolve the request
+ *     return resolve(request);
+ *   });
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Usage in a framework like Express JS or Hono
+ * app.use(async (req, res, next) => {
+ *   const result = await serverMiddleware(req, ({ request, locale }) => {
+ *     // If a redirect happens this won't be called
+ *     return next(request);
+ *   });
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Usage in serverless environments like Cloudflare Workers
+ * // ⚠️ WARNING: This should ONLY be used in serverless environments like Cloudflare Workers.
+ * // Disabling AsyncLocalStorage in traditional server environments risks cross-request pollution where state from
+ * // one request could leak into another concurrent request.
+ * export default {
+ *   fetch: async (request) => {
+ *     return serverMiddleware(
+ *       request,
+ *       ({ request, locale }) => handleRequest(request, locale),
+ *       { disableAsyncLocalStorage: true }
+ *     );
+ *   }
+ * };
+ * ```
+ */
+export function serverMiddleware<T>(request: Request, resolve: (args: {
+    request: Request;
+    locale: import("./runtime.js").Locale;
+}) => T | Promise<T>, options?: {
+    disableAsyncLocalStorage?: boolean | undefined;
+}): Promise<Response | any>;
+//# sourceMappingURL=server-middleware.d.ts.map

package/dist/compiler/runtime/server/server-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-middleware.d.ts","sourceRoot":"","sources":["../../../../src/compiler/runtime/server/server-middleware.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,iCAtDa,CAAC,WAEH,OAAO,WACP,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,cAAc,EAAE,MAAM,CAAA;CAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,YAE7F;IAA0B,wBAAwB;CAMlD,GAAU,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,CAgGnC"}