@sebbro/paraglide-lite 0.1.0

package/dist/compiler/safe-module-id.js

@@ -0,0 +1,78 @@
+/**
+ * Turns an unsafe module id like `helloWorld🍌` into a safe one like `helloworld__`.
+ *
+ * Mainly exists to support https://github.com/opral/inlang-paraglide-js/issues/285
+ */
+export function toSafeModuleId(id) {
+    const result = id.toLowerCase().replace(/[^a-z0-9_]/g, "_");
+    const startsWithNumber = result[0]?.match(/[0-9]/);
+    if (startsWithNumber) {
+        return "_" + result;
+    }
+    else if (reservedJsKeywords.includes(result)) {
+        return "_" + result;
+    }
+    let numUppercase = 0;
+    for (const char of id) {
+        if (char.match(/[A-Z]/)) {
+            numUppercase++;
+        }
+    }
+    return result + (numUppercase > 0 ? `${numUppercase}` : "");
+}
+export function isSafeModuleId(id) {
+    return toSafeModuleId(id) === id;
+}
+const reservedJsKeywords = [
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "new",
+    "null",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    //Strict mode reserved keywords
+    "let",
+    "static",
+    "yield",
+    "await",
+    //Reserved keywords for future use
+    "enum",
+    "implements",
+    "interface",
+    "package",
+    "private",
+    "protected",
+    "public",
+    // https://github.com/opral/inlang-paraglide-js/issues/331
+    "then",
+];
+//# sourceMappingURL=safe-module-id.js.map

package/dist/compiler/safe-module-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-module-id.js","sourceRoot":"","sources":["../../src/compiler/safe-module-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACxC,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAE5D,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,gBAAgB,EAAE,CAAC;QACtB,OAAO,GAAG,GAAG,MAAM,CAAC;IACrB,CAAC;SAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,OAAO,GAAG,GAAG,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,YAAY,EAAE,CAAC;QAChB,CAAC;IACF,CAAC;IAED,OAAO,MAAM,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACxC,OAAO,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,kBAAkB,GAAG;IAC1B,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,KAAK;IACL,UAAU;IACV,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,KAAK;IACL,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IAEN,+BAA+B;IAC/B,KAAK;IACL,QAAQ;IACR,OAAO;IACP,OAAO;IAEP,kCAAkC;IAClC,MAAM;IACN,YAAY;IACZ,WAAW;IACX,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IAER,0DAA0D;IAC1D,MAAM;CACN,CAAC","sourcesContent":["/**\n * Turns an unsafe module id like `helloWorld🍌` into a safe one like `helloworld__`.\n *\n * Mainly exists to support https://github.com/opral/inlang-paraglide-js/issues/285\n */\nexport function toSafeModuleId(id: string): string {\n\tconst result = id.toLowerCase().replace(/[^a-z0-9_]/g, \"_\");\n\n\tconst startsWithNumber = result[0]?.match(/[0-9]/);\n\n\tif (startsWithNumber) {\n\t\treturn \"_\" + result;\n\t} else if (reservedJsKeywords.includes(result)) {\n\t\treturn \"_\" + result;\n\t}\n\n\tlet numUppercase = 0;\n\tfor (const char of id) {\n\t\tif (char.match(/[A-Z]/)) {\n\t\t\tnumUppercase++;\n\t\t}\n\t}\n\n\treturn result + (numUppercase > 0 ? `${numUppercase}` : \"\");\n}\n\nexport function isSafeModuleId(id: string): boolean {\n\treturn toSafeModuleId(id) === id;\n}\n\nconst reservedJsKeywords = [\n\t\"break\",\n\t\"case\",\n\t\"catch\",\n\t\"class\",\n\t\"const\",\n\t\"continue\",\n\t\"debugger\",\n\t\"default\",\n\t\"delete\",\n\t\"do\",\n\t\"else\",\n\t\"export\",\n\t\"extends\",\n\t\"false\",\n\t\"finally\",\n\t\"for\",\n\t\"function\",\n\t\"if\",\n\t\"import\",\n\t\"in\",\n\t\"instanceof\",\n\t\"new\",\n\t\"null\",\n\t\"return\",\n\t\"super\",\n\t\"switch\",\n\t\"this\",\n\t\"throw\",\n\t\"true\",\n\t\"try\",\n\t\"typeof\",\n\t\"var\",\n\t\"void\",\n\t\"while\",\n\t\"with\",\n\n\t//Strict mode reserved keywords\n\t\"let\",\n\t\"static\",\n\t\"yield\",\n\t\"await\",\n\n\t//Reserved keywords for future use\n\t\"enum\",\n\t\"implements\",\n\t\"interface\",\n\t\"package\",\n\t\"private\",\n\t\"protected\",\n\t\"public\",\n\n\t// https://github.com/opral/inlang-paraglide-js/issues/331\n\t\"then\",\n];\n"]}

package/dist/compiler/safe-module-id.test.d.ts

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

package/dist/compiler/safe-module-id.test.d.ts.map

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

package/dist/compiler/safe-module-id.test.js

@@ -0,0 +1,36 @@
+import { test, expect } from "vitest";
+import { toSafeModuleId } from "./safe-module-id.js";
+test("handles emojis (because why not)", () => {
+    expect(toSafeModuleId("helloWorld🍌")).toBe("helloworld__1");
+});
+// https://github.com/opral/inlang-paraglide-js/issues/395
+test("makes everything lowercase", () => {
+    expect(toSafeModuleId("HelloWorld")).toBe("helloworld2");
+});
+test('escapes "-" to "_"', () => {
+    expect(toSafeModuleId("de-DE-bavaria")).toBe("de_de_bavaria2");
+});
+test("prefixes with _ if it starts with a number", () => {
+    expect(toSafeModuleId("123")).toBe("_123");
+});
+test("handles $ signs", () => {
+    expect(toSafeModuleId("default_e$")).toBe("default_e_");
+});
+test("handles . dots", () => {
+    expect(toSafeModuleId("hello.world.nested")).toBe("hello_world_nested");
+});
+test("handles : colons", () => {
+    expect(toSafeModuleId("hello:world:nested")).toBe("hello_world_nested");
+});
+test("transforms js reserved keywords", async () => {
+    expect(toSafeModuleId("import")).toBe("_import");
+    expect(toSafeModuleId("let")).toBe("_let");
+    // https://github.com/opral/inlang-paraglide-js/issues/331
+    expect(toSafeModuleId("then")).toBe("_then");
+});
+test("adds an uppercase counter for de-duplication", async () => {
+    expect(toSafeModuleId("helloworld")).toBe("helloworld");
+    expect(toSafeModuleId("helloWorld")).toBe("helloworld1");
+    expect(toSafeModuleId("HelloWorld")).toBe("helloworld2");
+});
+//# sourceMappingURL=safe-module-id.test.js.map

package/dist/compiler/safe-module-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-module-id.test.js","sourceRoot":"","sources":["../../src/compiler/safe-module-id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC7C,MAAM,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,0DAA0D;AAC1D,IAAI,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACvC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAC/B,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACvD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC5B,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC3B,MAAM,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC7B,MAAM,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;IAClD,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;IAC/D,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzD,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC","sourcesContent":["import { test, expect } from \"vitest\";\nimport { toSafeModuleId } from \"./safe-module-id.js\";\n\ntest(\"handles emojis (because why not)\", () => {\n\texpect(toSafeModuleId(\"helloWorld🍌\")).toBe(\"helloworld__1\");\n});\n\n// https://github.com/opral/inlang-paraglide-js/issues/395\ntest(\"makes everything lowercase\", () => {\n\texpect(toSafeModuleId(\"HelloWorld\")).toBe(\"helloworld2\");\n});\n\ntest('escapes \"-\" to \"_\"', () => {\n\texpect(toSafeModuleId(\"de-DE-bavaria\")).toBe(\"de_de_bavaria2\");\n});\n\ntest(\"prefixes with _ if it starts with a number\", () => {\n\texpect(toSafeModuleId(\"123\")).toBe(\"_123\");\n});\n\ntest(\"handles $ signs\", () => {\n\texpect(toSafeModuleId(\"default_e$\")).toBe(\"default_e_\");\n});\n\ntest(\"handles . dots\", () => {\n\texpect(toSafeModuleId(\"hello.world.nested\")).toBe(\"hello_world_nested\");\n});\n\ntest(\"handles : colons\", () => {\n\texpect(toSafeModuleId(\"hello:world:nested\")).toBe(\"hello_world_nested\");\n});\n\ntest(\"transforms js reserved keywords\", async () => {\n\texpect(toSafeModuleId(\"import\")).toBe(\"_import\");\n\texpect(toSafeModuleId(\"let\")).toBe(\"_let\");\n\t// https://github.com/opral/inlang-paraglide-js/issues/331\n\texpect(toSafeModuleId(\"then\")).toBe(\"_then\");\n});\n\ntest(\"adds an uppercase counter for de-duplication\", async () => {\n\texpect(toSafeModuleId(\"helloworld\")).toBe(\"helloworld\");\n\texpect(toSafeModuleId(\"helloWorld\")).toBe(\"helloworld1\");\n\texpect(toSafeModuleId(\"HelloWorld\")).toBe(\"helloworld2\");\n});\n"]}

package/dist/compiler/seed-previous-compilation.d.ts

@@ -0,0 +1,7 @@
+import nodeFs from "node:fs/promises";
+import type { CompilationResult } from "./compile.js";
+export declare function seedPreviousCompilationFromOutdir(args: {
+    outdir: string;
+    fs?: typeof nodeFs;
+    cwd?: string;
+}): Promise<CompilationResult | undefined>;

package/dist/compiler/seed-previous-compilation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-previous-compilation.d.ts","sourceRoot":"","sources":["../../src/compiler/seed-previous-compilation.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAKzC"}

package/dist/compiler/seed-previous-compilation.js

@@ -0,0 +1,9 @@
+import path from "node:path";
+import nodeFs from "node:fs/promises";
+import { hashDirectory } from "../services/file-handling/write-output.js";
+export async function seedPreviousCompilationFromOutdir(args) {
+    const absoluteOutdir = path.resolve(args.cwd ?? process.cwd(), args.outdir);
+    const outputHashes = await hashDirectory(absoluteOutdir, args.fs ?? nodeFs);
+    return outputHashes ? { outputHashes, output: {} } : undefined;
+}
+//# sourceMappingURL=seed-previous-compilation.js.map

package/dist/compiler/seed-previous-compilation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-previous-compilation.js","sourceRoot":"","sources":["../../src/compiler/seed-previous-compilation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,IAIvD;IACA,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,CAAC;IAE5E,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC","sourcesContent":["import path from \"node:path\";\nimport nodeFs from \"node:fs/promises\";\nimport type { CompilationResult } from \"./compile.js\";\nimport { hashDirectory } from \"../services/file-handling/write-output.js\";\n\nexport async function seedPreviousCompilationFromOutdir(args: {\n\toutdir: string;\n\tfs?: typeof nodeFs;\n\tcwd?: string;\n}): Promise<CompilationResult | undefined> {\n\tconst absoluteOutdir = path.resolve(args.cwd ?? process.cwd(), args.outdir);\n\tconst outputHashes = await hashDirectory(absoluteOutdir, args.fs ?? nodeFs);\n\n\treturn outputHashes ? { outputHashes, output: {} } : undefined;\n}\n"]}

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

@@ -0,0 +1,12 @@
+import type { CompiledBundleWithMessages } from "../compile-bundle.js";
+import type { CompilerOptions } from "../compiler-options.js";
+/**
+ * Returns the code for the `runtime.js` module
+ */
+export declare function createServerFile(args: {
+    compiledBundles: CompiledBundleWithMessages[];
+    compilerOptions: {
+        experimentalMiddlewareLocaleSplitting: NonNullable<CompilerOptions["experimentalMiddlewareLocaleSplitting"]>;
+        disableAsyncLocalStorage: NonNullable<CompilerOptions["disableAsyncLocalStorage"]>;
+    };
+}): string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-server-file.d.ts","sourceRoot":"","sources":["../../../src/compiler/server/create-server-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACtC,eAAe,EAAE,0BAA0B,EAAE,CAAC;IAC9C,eAAe,EAAE;QAChB,qCAAqC,EAAE,WAAW,CACjD,eAAe,CAAC,uCAAuC,CAAC,CACxD,CAAC;QACF,wBAAwB,EAAE,WAAW,CACpC,eAAe,CAAC,0BAA0B,CAAC,CAC3C,CAAC;KACF,CAAC;CACF,GAAG,MAAM,CA0DT"}

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

@@ -0,0 +1,91 @@
+import fs from "node:fs";
+import { toSafeModuleId } from "../safe-module-id.js";
+/**
+ * Returns the code for the `runtime.js` module
+ */
+export function createServerFile(args) {
+    let code = `
+import * as runtime from "./runtime.js";
+
+${injectCode("./middleware.js")}
+`;
+    const asyncLocalStorageMarker = "// %async-local-storage";
+    const markerIndex = code.indexOf(asyncLocalStorageMarker);
+    if (markerIndex === -1) {
+        throw new Error("Expected a single %async-local-storage marker in server middleware.");
+    }
+    const lineStart = code.lastIndexOf("\n", markerIndex) + 1;
+    const indent = code.slice(lineStart, markerIndex).replace(/\t/g, "  ");
+    const innerIndent = `${indent}  `;
+    const asyncLocalStorageBlock = args.compilerOptions.disableAsyncLocalStorage
+        ? [
+            `${indent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,
+            `${indent}if (!requestAsyncLocalStorage) {`,
+            `${innerIndent}requestAsyncLocalStorage = createMockAsyncLocalStorage();`,
+            `${innerIndent}runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,
+            `${indent}}`,
+        ]
+        : [
+            `${indent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,
+            `${indent}if (!runtime.disableAsyncLocalStorage && !requestAsyncLocalStorage) {`,
+            `${innerIndent}const { AsyncLocalStorage } = await import("node:async_hooks");`,
+            `${innerIndent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,
+            `${innerIndent}if (!requestAsyncLocalStorage) {`,
+            `${innerIndent}  requestAsyncLocalStorage = new AsyncLocalStorage();`,
+            `${innerIndent}  runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,
+            `${innerIndent}}`,
+            `${indent}}`,
+            `${indent}if (!requestAsyncLocalStorage) {`,
+            `${innerIndent}requestAsyncLocalStorage = createMockAsyncLocalStorage();`,
+            `${innerIndent}runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,
+            `${indent}}`,
+        ];
+    const lineEnd = code.indexOf("\n", markerIndex);
+    const endOfMarkerLine = lineEnd === -1 ? code.length : lineEnd + 1;
+    code =
+        code.slice(0, lineStart) +
+            `${asyncLocalStorageBlock.join("\n")}\n` +
+            code.slice(endOfMarkerLine);
+    if (args.compilerOptions.experimentalMiddlewareLocaleSplitting) {
+        code = code.replace("const compiledBundles = {};", `const compiledBundles = ${JSON.stringify(createCompiledMessagesObject(args.compiledBundles))};`);
+    }
+    return code.replace(/\t/g, "  ");
+}
+function createCompiledMessagesObject(compiledBundles) {
+    const result = {};
+    for (const compiledBundle of compiledBundles) {
+        const bundleId = compiledBundle.bundle.node.id;
+        const safeModuleId = toSafeModuleId(bundleId);
+        if (result[bundleId] === undefined) {
+            result[bundleId] = {};
+        }
+        for (const [locale, compiledMessage] of Object.entries(compiledBundle.messages)) {
+            result[bundleId][locale] = compiledMessage.code
+                .replace(`export const ${safeModuleId} = `, "")
+                .replace(/;$/, "");
+        }
+    }
+    return result;
+}
+/**
+ * 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;
+    const sourceMapRegex = /\/\/# sourceMappingURL=.*$/gm;
+    const blockSourceMapRegex = /\/\*# sourceMappingURL=.*?\*\//g;
+    return code
+        .replace(importRegex, "")
+        .replace(sourceMapRegex, "")
+        .replace(blockSourceMapRegex, "")
+        .trim();
+}
+//# sourceMappingURL=create-server-file.js.map

package/dist/compiler/server/create-server-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server-file.js","sourceRoot":"","sources":["../../../src/compiler/server/create-server-file.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport type { CompiledBundleWithMessages } from \"../compile-bundle.js\";\nimport type { CompilerOptions } from \"../compiler-options.js\";\nimport { toSafeModuleId } from \"../safe-module-id.js\";\nimport type { Locale } from \"./runtime.d.ts\";\n\n/**\n * Returns the code for the `runtime.js` module\n */\nexport function createServerFile(args: {\n\tcompiledBundles: CompiledBundleWithMessages[];\n\tcompilerOptions: {\n\t\texperimentalMiddlewareLocaleSplitting: NonNullable<\n\t\t\tCompilerOptions[\"experimentalMiddlewareLocaleSplitting\"]\n\t\t>;\n\t\tdisableAsyncLocalStorage: NonNullable<\n\t\t\tCompilerOptions[\"disableAsyncLocalStorage\"]\n\t\t>;\n\t};\n}): string {\n\tlet code = `\nimport * as runtime from \"./runtime.js\";\n\n${injectCode(\"./middleware.js\")}\n`;\n\n\tconst asyncLocalStorageMarker = \"// %async-local-storage\";\n\tconst markerIndex = code.indexOf(asyncLocalStorageMarker);\n\tif (markerIndex === -1) {\n\t\tthrow new Error(\n\t\t\t\"Expected a single %async-local-storage marker in server middleware.\"\n\t\t);\n\t}\n\n\tconst lineStart = code.lastIndexOf(\"\\n\", markerIndex) + 1;\n\tconst indent = code.slice(lineStart, markerIndex).replace(/\\t/g, \"  \");\n\tconst innerIndent = `${indent}  `;\n\tconst asyncLocalStorageBlock = args.compilerOptions.disableAsyncLocalStorage\n\t\t? [\n\t\t\t\t`${indent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,\n\t\t\t\t`${indent}if (!requestAsyncLocalStorage) {`,\n\t\t\t\t`${innerIndent}requestAsyncLocalStorage = createMockAsyncLocalStorage();`,\n\t\t\t\t`${innerIndent}runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,\n\t\t\t\t`${indent}}`,\n\t\t\t]\n\t\t: [\n\t\t\t\t`${indent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,\n\t\t\t\t`${indent}if (!runtime.disableAsyncLocalStorage && !requestAsyncLocalStorage) {`,\n\t\t\t\t`${innerIndent}const { AsyncLocalStorage } = await import(\"node:async_hooks\");`,\n\t\t\t\t`${innerIndent}requestAsyncLocalStorage = runtime.getServerAsyncLocalStorage();`,\n\t\t\t\t`${innerIndent}if (!requestAsyncLocalStorage) {`,\n\t\t\t\t`${innerIndent}  requestAsyncLocalStorage = new AsyncLocalStorage();`,\n\t\t\t\t`${innerIndent}  runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,\n\t\t\t\t`${innerIndent}}`,\n\t\t\t\t`${indent}}`,\n\t\t\t\t`${indent}if (!requestAsyncLocalStorage) {`,\n\t\t\t\t`${innerIndent}requestAsyncLocalStorage = createMockAsyncLocalStorage();`,\n\t\t\t\t`${innerIndent}runtime.overwriteServerAsyncLocalStorage(requestAsyncLocalStorage);`,\n\t\t\t\t`${indent}}`,\n\t\t\t];\n\n\tconst lineEnd = code.indexOf(\"\\n\", markerIndex);\n\tconst endOfMarkerLine = lineEnd === -1 ? code.length : lineEnd + 1;\n\n\tcode =\n\t\tcode.slice(0, lineStart) +\n\t\t`${asyncLocalStorageBlock.join(\"\\n\")}\\n` +\n\t\tcode.slice(endOfMarkerLine);\n\n\tif (args.compilerOptions.experimentalMiddlewareLocaleSplitting) {\n\t\tcode = code.replace(\n\t\t\t\"const compiledBundles = {};\",\n\t\t\t`const compiledBundles = ${JSON.stringify(createCompiledMessagesObject(args.compiledBundles))};`\n\t\t);\n\t}\n\n\treturn code.replace(/\\t/g, \"  \");\n}\n\nfunction createCompiledMessagesObject(\n\tcompiledBundles: CompiledBundleWithMessages[]\n): Record<string, Record<Locale, string>> {\n\tconst result = {} as Record<string, Record<Locale, string>>;\n\n\tfor (const compiledBundle of compiledBundles) {\n\t\tconst bundleId = compiledBundle.bundle.node.id;\n\t\tconst safeModuleId = toSafeModuleId(bundleId);\n\t\tif (result[bundleId] === undefined) {\n\t\t\tresult[bundleId] = {};\n\t\t}\n\t\tfor (const [locale, compiledMessage] of Object.entries(\n\t\t\tcompiledBundle.messages\n\t\t)) {\n\t\t\tresult[bundleId][locale] = compiledMessage.code\n\t\t\t\t.replace(`export const ${safeModuleId} = `, \"\")\n\t\t\t\t.replace(/;$/, \"\");\n\t\t}\n\t}\n\treturn result;\n}\n\n/**\n * Load a file from the current directory.\n *\n * Prunes the imports on top of the file as the runtime is\n * self-contained.\n *\n * @param {string} path\n * @returns {string}\n */\nfunction injectCode(path: string): string {\n\tconst code = fs.readFileSync(new URL(path, import.meta.url), \"utf-8\");\n\t// Regex to match single-line and multi-line imports\n\tconst importRegex = /import\\s+[\\s\\S]*?from\\s+['\"][^'\"]+['\"]\\s*;?/g;\n\tconst sourceMapRegex = /\\/\\/# sourceMappingURL=.*$/gm;\n\tconst blockSourceMapRegex = /\\/\\*# sourceMappingURL=.*?\\*\\//g;\n\treturn code\n\t\t.replace(importRegex, \"\")\n\t\t.replace(sourceMapRegex, \"\")\n\t\t.replace(blockSourceMapRegex, \"\")\n\t\t.trim();\n}\n"]}

package/dist/compiler/server/create-server-file.test.d.ts

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

package/dist/compiler/server/create-server-file.test.d.ts.map

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

package/dist/compiler/server/create-server-file.test.js

@@ -0,0 +1,48 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { afterEach, expect, test } from "vitest";
+import { createServerFile } from "./create-server-file.js";
+const temporaryDirectories = [];
+afterEach(async () => {
+    await Promise.all(temporaryDirectories
+        .splice(0)
+        .map((directory) => rm(directory, { recursive: true, force: true })));
+});
+test("uses the initialized AsyncLocalStorage when an import interceptor snapshots the initial export", async () => {
+    const directory = await mkdtemp(join(tmpdir(), "paraglide-server-"));
+    temporaryDirectories.push(directory);
+    const serverCode = createServerFile({
+        compiledBundles: [],
+        compilerOptions: {
+            disableAsyncLocalStorage: false,
+            experimentalMiddlewareLocaleSplitting: false,
+        },
+    }).replace('"./runtime.js"', '"./runtime-wrapper.mjs"');
+    await writeFile(join(directory, "server.mjs"), serverCode);
+    await writeFile(join(directory, "runtime-real.mjs"), `export let serverAsyncLocalStorage;
+export const disableAsyncLocalStorage = false;
+export function overwriteServerAsyncLocalStorage(value) {
+  serverAsyncLocalStorage = value;
+}
+export function getServerAsyncLocalStorage() {
+  return serverAsyncLocalStorage;
+}
+export const baseLocale = "en";
+export function isExcludedByRouteStrategy() {
+  return true;
+}`);
+    await writeFile(join(directory, "runtime-wrapper.mjs"), `import * as runtime from "./runtime-real.mjs";
+export const serverAsyncLocalStorage = runtime.serverAsyncLocalStorage;
+export const disableAsyncLocalStorage = runtime.disableAsyncLocalStorage;
+export const overwriteServerAsyncLocalStorage = runtime.overwriteServerAsyncLocalStorage;
+export const getServerAsyncLocalStorage = runtime.getServerAsyncLocalStorage;
+export const baseLocale = runtime.baseLocale;
+export const isExcludedByRouteStrategy = runtime.isExcludedByRouteStrategy;`);
+    const server = await import(pathToFileURL(join(directory, "server.mjs")).href);
+    const response = await server.paraglideMiddleware(new Request("https://example.com/api/ready"), () => new Response("ready"));
+    expect(response.status).toBe(200);
+    expect(await response.text()).toBe("ready");
+});
+//# sourceMappingURL=create-server-file.test.js.map

package/dist/compiler/server/create-server-file.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server-file.test.js","sourceRoot":"","sources":["../../../src/compiler/server/create-server-file.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,oBAAoB,GAAa,EAAE,CAAC;AAE1C,SAAS,CAAC,KAAK,IAAI,EAAE;IACpB,MAAM,OAAO,CAAC,GAAG,CAChB,oBAAoB;SAClB,MAAM,CAAC,CAAC,CAAC;SACT,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CACrE,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gGAAgG,EAAE,KAAK,IAAI,EAAE;IACjH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACrE,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAErC,MAAM,UAAU,GAAG,gBAAgB,CAAC;QACnC,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE;YAChB,wBAAwB,EAAE,KAAK;YAC/B,qCAAqC,EAAE,KAAK;SAC5C;KACD,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;IAExD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,SAAS,CACd,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EACnC;;;;;;;;;;;EAWA,CACA,CAAC;IACF,MAAM,SAAS,CACd,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,EACtC;;;;;;4EAM0E,CAC1E,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAC1B,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CACjD,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAChD,IAAI,OAAO,CAAC,+BAA+B,CAAC,EAC5C,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAC3B,CAAC;IAEF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC","sourcesContent":["import { mkdtemp, rm, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { afterEach, expect, test } from \"vitest\";\nimport { createServerFile } from \"./create-server-file.js\";\n\nconst temporaryDirectories: string[] = [];\n\nafterEach(async () => {\n\tawait Promise.all(\n\t\ttemporaryDirectories\n\t\t\t.splice(0)\n\t\t\t.map((directory) => rm(directory, { recursive: true, force: true }))\n\t);\n});\n\ntest(\"uses the initialized AsyncLocalStorage when an import interceptor snapshots the initial export\", async () => {\n\tconst directory = await mkdtemp(join(tmpdir(), \"paraglide-server-\"));\n\ttemporaryDirectories.push(directory);\n\n\tconst serverCode = createServerFile({\n\t\tcompiledBundles: [],\n\t\tcompilerOptions: {\n\t\t\tdisableAsyncLocalStorage: false,\n\t\t\texperimentalMiddlewareLocaleSplitting: false,\n\t\t},\n\t}).replace('\"./runtime.js\"', '\"./runtime-wrapper.mjs\"');\n\n\tawait writeFile(join(directory, \"server.mjs\"), serverCode);\n\tawait writeFile(\n\t\tjoin(directory, \"runtime-real.mjs\"),\n\t\t`export let serverAsyncLocalStorage;\nexport const disableAsyncLocalStorage = false;\nexport function overwriteServerAsyncLocalStorage(value) {\n  serverAsyncLocalStorage = value;\n}\nexport function getServerAsyncLocalStorage() {\n  return serverAsyncLocalStorage;\n}\nexport const baseLocale = \"en\";\nexport function isExcludedByRouteStrategy() {\n  return true;\n}`\n\t);\n\tawait writeFile(\n\t\tjoin(directory, \"runtime-wrapper.mjs\"),\n\t\t`import * as runtime from \"./runtime-real.mjs\";\nexport const serverAsyncLocalStorage = runtime.serverAsyncLocalStorage;\nexport const disableAsyncLocalStorage = runtime.disableAsyncLocalStorage;\nexport const overwriteServerAsyncLocalStorage = runtime.overwriteServerAsyncLocalStorage;\nexport const getServerAsyncLocalStorage = runtime.getServerAsyncLocalStorage;\nexport const baseLocale = runtime.baseLocale;\nexport const isExcludedByRouteStrategy = runtime.isExcludedByRouteStrategy;`\n\t);\n\n\tconst server = await import(\n\t\tpathToFileURL(join(directory, \"server.mjs\")).href\n\t);\n\tconst response = await server.paraglideMiddleware(\n\t\tnew Request(\"https://example.com/api/ready\"),\n\t\t() => new Response(\"ready\")\n\t);\n\n\texpect(response.status).toBe(200);\n\texpect(await response.text()).toBe(\"ready\");\n});\n"]}

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

@@ -0,0 +1,98 @@
+/**
+ * Server middleware that handles locale-based routing and request processing.
+ *
+ * Configure `disableAsyncLocalStorage` when generating Paraglide with
+ * `paraglideVitePlugin()` or `compile()`, not when calling
+ * `paraglideMiddleware()`. Keep AsyncLocalStorage enabled by default and
+ * only disable it for runtimes that lack `AsyncLocalStorage` support and
+ * guarantee request isolation.
+ *
+ * This middleware performs several key functions:
+ *
+ * 1. Determines the locale for the incoming request using configured strategies
+ * 2. Handles URL localization and redirects (only for document requests)
+ * 3. Maintains locale state using AsyncLocalStorage to prevent request interference
+ *
+ * When URL strategy is used:
+ *
+ * - The locale is extracted from the URL for all request types
+ * - If URL doesn't match the determined locale, redirects to localized URL (only for document requests)
+ * - De-localizes URLs before passing to server (e.g., `/fr/about` → `/about`)
+ *
+ * @see https://paraglidejs.com/middleware
+ *
+ * @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. The callback receives:
+ *   - `request`: A modified request with a delocalized URL when the URL strategy is used (e.g., `/fr/about` → `/about`).
+ *      If your framework handles URL localization itself (e.g., TanStack Router's `rewrite` option), use the original
+ *      request instead to avoid redirect loops.
+ *   - `locale`: The determined locale for this request.
+ * @param {{
+ *   effectiveRequestUrl?: string | URL | ((request: Request) => string | URL),
+ *   onRedirect?: (response: Response) => void
+ * }} [options] - Options to control middleware behavior. `effectiveRequestUrl` sets the effective request URL used for route matching, URL-based locale detection, redirects, and `getUrlOrigin()`.
+ * @returns {Promise<Response>}
+ *
+ * @example
+ * ```typescript
+ * // Basic usage in metaframeworks like NextJS, SvelteKit, Astro, Nuxt, etc.
+ * export const handle = async ({ event, resolve }) => {
+ *   return paraglideMiddleware(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 paraglideMiddleware(req, ({ request, locale }) => {
+ *     // If a redirect happens this won't be called
+ *     return next(request);
+ *   });
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Usage with frameworks that handle URL localization/delocalization themselves
+ * //
+ * // Some frameworks like TanStack Router handle URL localization and delocalization
+ * // themselves via their own rewrite APIs (e.g., `rewrite.input`/`rewrite.output`).
+ * //
+ * // When the framework handles this, the middleware's URL delocalization is not needed.
+ * // Using the modified `request` from the callback would cause a redirect loop because
+ * // both the middleware and the framework would attempt to delocalize the URL.
+ * //
+ * // Solution: Pass the original request to the handler instead of the modified one.
+ * // The middleware still handles locale detection, cookies, and AsyncLocalStorage context.
+ * //
+ * // ❌ WRONG - causes redirect loop when framework handles URL rewriting:
+ * // paraglideMiddleware(req, ({ request }) => handler.fetch(request))
+ * //
+ * // ✅ CORRECT - use original request when framework handles URL localization:
+ * // paraglideMiddleware(req, () => handler.fetch(req))
+ *
+ * import { paraglideMiddleware } from './paraglide/server.js'
+ * import handler from '@tanstack/react-start/server-entry'
+ *
+ * export default {
+ *   fetch(req: Request): Promise<Response> {
+ *     // TanStack Router handles URL rewriting via deLocalizeUrl/localizeUrl
+ *     // so we pass the original `req` instead of the modified `request`
+ *     return paraglideMiddleware(req, () => handler.fetch(req))
+ *   },
+ * }
+ * ```
+ */
+export declare function paraglideMiddleware<T>(request: Request, resolve: (args: {
+    request: Request;
+    locale: import("./runtime.js").Locale;
+}) => T | Promise<T>, options?: {
+    effectiveRequestUrl?: string | URL | ((request: Request) => string | URL);
+    onRedirect?: (response: Response) => void;
+}): Promise<Response>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/compiler/server/middleware.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,wBAAsB,mBAAmB,CApE5B,CAAC,EAoE4B,OAAO,EAlEtC,OAkEsC,EAAE,OAAO,EAjE/C,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,cAAc,EAAE,MAAM,CAAA;CAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAiErC,EAAE,OAAO,AA5DhE,CAIA,EAJQ;IACN,mBAAmB,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,GAAG,CAAC,CAAC;IAC1E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAA;CA0DqB,GAxDtD,OAAO,CAAC,QAAQ,CAAC,CA6K7B"}