@sebbro/paraglide-lite 0.1.0

package/dist/compiler/runtime/host-routing.js

@@ -0,0 +1,79 @@
+import { toLocale } from "./check-locale.js";
+import { baseLocale, locales, routing, } from "./variables.js";
+/**
+ * @typedef {{ baseLocale: string, locales: string[] }} HostRoutingRuleResolved
+ */
+/**
+ * @param {string} hostname
+ * @returns {HostRoutingRuleResolved}
+ */
+export function getRoutingRule(hostname) {
+    return (routing[hostname] ??
+        routing["*"] ?? {
+        baseLocale,
+        locales: /** @type {string[]} */ ([...locales]),
+    });
+}
+/**
+ * @param {string[]} segments
+ * @param {HostRoutingRuleResolved} rule
+ * @returns {Locale | undefined}
+ */
+function localeFromFirstSegment(segments, rule) {
+    if (segments.length === 0) {
+        return undefined;
+    }
+    const canonical = toLocale(segments[0]);
+    if (canonical && rule.locales.includes(canonical)) {
+        return canonical;
+    }
+    return undefined;
+}
+/**
+ * @param {string | URL} url
+ * @returns {Locale}
+ */
+export function extractLocaleFromUrlHostRouting(url) {
+    const urlObj = typeof url === "string" ? new URL(url, "http://localhost") : url;
+    const rule = getRoutingRule(urlObj.hostname);
+    const segments = urlObj.pathname.split("/").filter(Boolean);
+    return localeFromFirstSegment(segments, rule) ?? rule.baseLocale;
+}
+/**
+ * @param {string | URL} url
+ * @param {Locale} locale
+ * @returns {URL}
+ */
+export function localizeUrlHostRouting(url, locale) {
+    const urlObj = typeof url === "string" ? new URL(url) : new URL(url.href);
+    const rule = getRoutingRule(urlObj.hostname);
+    const segments = urlObj.pathname.split("/").filter(Boolean);
+    if (localeFromFirstSegment(segments, rule)) {
+        segments.shift();
+    }
+    if (locale === rule.baseLocale) {
+        urlObj.pathname = "/" + segments.join("/");
+    }
+    else if (segments.length === 0) {
+        urlObj.pathname = "/" + locale;
+    }
+    else {
+        urlObj.pathname = "/" + locale + "/" + segments.join("/");
+    }
+    return urlObj;
+}
+/**
+ * @param {string | URL} url
+ * @returns {URL}
+ */
+export function deLocalizeUrlHostRouting(url) {
+    const urlObj = typeof url === "string" ? new URL(url) : new URL(url.href);
+    const rule = getRoutingRule(urlObj.hostname);
+    const segments = urlObj.pathname.split("/").filter(Boolean);
+    if (localeFromFirstSegment(segments, rule)) {
+        segments.shift();
+        urlObj.pathname = "/" + segments.join("/");
+    }
+    return urlObj;
+}
+//# sourceMappingURL=host-routing.js.map

package/dist/compiler/runtime/host-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-routing.js","sourceRoot":"","sources":["../../../src/compiler/runtime/host-routing.js"],"names":[],"mappings":"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","sourcesContent":["import { toLocale } from \"./check-locale.js\";\nimport {\n\tbaseLocale,\n\tlocales,\n\trouting,\n} from \"./variables.js\";\n\n/**\n * @typedef {{ baseLocale: string, locales: string[] }} HostRoutingRuleResolved\n */\n\n/**\n * @param {string} hostname\n * @returns {HostRoutingRuleResolved}\n */\nexport function getRoutingRule(hostname) {\n\treturn (\n\t\trouting[hostname] ??\n\t\trouting[\"*\"] ?? {\n\t\t\tbaseLocale,\n\t\t\tlocales: /** @type {string[]} */ ([...locales]),\n\t\t}\n\t);\n}\n\n/**\n * @param {string[]} segments\n * @param {HostRoutingRuleResolved} rule\n * @returns {Locale | undefined}\n */\nfunction localeFromFirstSegment(segments, rule) {\n\tif (segments.length === 0) {\n\t\treturn undefined;\n\t}\n\tconst canonical = toLocale(segments[0]);\n\tif (canonical && rule.locales.includes(canonical)) {\n\t\treturn canonical;\n\t}\n\treturn undefined;\n}\n\n/**\n * @param {string | URL} url\n * @returns {Locale}\n */\nexport function extractLocaleFromUrlHostRouting(url) {\n\tconst urlObj =\n\t\ttypeof url === \"string\" ? new URL(url, \"http://localhost\") : url;\n\tconst rule = getRoutingRule(urlObj.hostname);\n\tconst segments = urlObj.pathname.split(\"/\").filter(Boolean);\n\treturn localeFromFirstSegment(segments, rule) ?? rule.baseLocale;\n}\n\n/**\n * @param {string | URL} url\n * @param {Locale} locale\n * @returns {URL}\n */\nexport function localizeUrlHostRouting(url, locale) {\n\tconst urlObj =\n\t\ttypeof url === \"string\" ? new URL(url) : new URL(url.href);\n\tconst rule = getRoutingRule(urlObj.hostname);\n\tconst segments = urlObj.pathname.split(\"/\").filter(Boolean);\n\n\tif (localeFromFirstSegment(segments, rule)) {\n\t\tsegments.shift();\n\t}\n\n\tif (locale === rule.baseLocale) {\n\t\turlObj.pathname = \"/\" + segments.join(\"/\");\n\t} else if (segments.length === 0) {\n\t\turlObj.pathname = \"/\" + locale;\n\t} else {\n\t\turlObj.pathname = \"/\" + locale + \"/\" + segments.join(\"/\");\n\t}\n\n\treturn urlObj;\n}\n\n/**\n * @param {string | URL} url\n * @returns {URL}\n */\nexport function deLocalizeUrlHostRouting(url) {\n\tconst urlObj =\n\t\ttypeof url === \"string\" ? new URL(url) : new URL(url.href);\n\tconst rule = getRoutingRule(urlObj.hostname);\n\tconst segments = urlObj.pathname.split(\"/\").filter(Boolean);\n\n\tif (localeFromFirstSegment(segments, rule)) {\n\t\tsegments.shift();\n\t\turlObj.pathname = \"/\" + segments.join(\"/\");\n\t}\n\n\treturn urlObj;\n}\n"]}

package/dist/compiler/runtime/host-routing.test.d.ts

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

package/dist/compiler/runtime/host-routing.test.d.ts.map

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

package/dist/compiler/runtime/host-routing.test.js

@@ -0,0 +1,128 @@
+import { test, expect } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+import { createRuntimeFile, normalizeRouting } from "./create-runtime.js";
+test("normalizeRouting fills * fallback and resolves defaults", () => {
+    const resolved = normalizeRouting({
+        routing: {
+            "fin.example.com": { baseLocale: "fi" },
+            "app.example.com": {
+                baseLocale: "sv",
+                locales: ["sv", "en", "pt-PT"],
+            },
+        },
+        locales: ["en", "fi", "sv", "pt-PT", "de"],
+        baseLocale: "en",
+    });
+    expect(resolved).toEqual({
+        "fin.example.com": {
+            baseLocale: "fi",
+            locales: ["en", "fi", "sv", "pt-PT", "de"],
+        },
+        "app.example.com": {
+            baseLocale: "sv",
+            locales: ["sv", "en", "pt-PT"],
+        },
+        "*": {
+            baseLocale: "en",
+            locales: ["en", "fi", "sv", "pt-PT", "de"],
+        },
+    });
+});
+test("normalizeRouting rejects unknown locales", () => {
+    expect(() => normalizeRouting({
+        routing: {
+            "fin.example.com": { baseLocale: "nope" },
+        },
+        locales: ["en", "fi"],
+        baseLocale: "en",
+    })).toThrow(/Invalid baseLocale "nope"/);
+});
+test("createRuntimeFile rejects routing + urlPatterns together", () => {
+    expect(() => createRuntimeFile({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        compilerOptions: {
+            strategy: ["url", "baseLocale"],
+            cookieName: "PARAGLIDE_LOCALE",
+            cookieMaxAge: 100,
+            cookieDomain: "",
+            localStorageKey: "PARAGLIDE_LOCALE",
+            isServer: "typeof window === 'undefined'",
+            experimentalMiddlewareLocaleSplitting: false,
+            disableAsyncLocalStorage: false,
+            routing: { "*": { baseLocale: "en" } },
+            urlPatterns: [
+                {
+                    pattern: "/:path(.*)?",
+                    localized: [
+                        ["en", "/:path(.*)?"],
+                        ["de", "/de/:path(.*)?"],
+                    ],
+                },
+            ],
+        },
+    })).toThrow(/Cannot set both "routing" and "urlPatterns"/);
+});
+test("per-host baseLocale: bare path is host default, /en is english", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fi", "sv", "de"],
+        strategy: ["url", "baseLocale"],
+        routing: {
+            "fin.example.com": { baseLocale: "fi" },
+            "app.example.com": { baseLocale: "sv" },
+            "*": { baseLocale: "en" },
+        },
+    });
+    expect(runtime.extractLocaleFromUrl("https://fin.example.com/")).toBe("fi");
+    expect(runtime.extractLocaleFromUrl("https://fin.example.com/about")).toBe("fi");
+    expect(runtime.extractLocaleFromUrl("https://fin.example.com/en")).toBe("en");
+    expect(runtime.extractLocaleFromUrl("https://fin.example.com/en/about")).toBe("en");
+    expect(runtime.extractLocaleFromUrl("https://app.example.com/")).toBe("sv");
+    expect(runtime.extractLocaleFromUrl("https://other.example.com/de/x")).toBe("de");
+    expect(runtime.localizeUrl("https://fin.example.com/about", { locale: "en" }).href).toBe("https://fin.example.com/en/about");
+    expect(runtime.localizeUrl("https://fin.example.com/en/about", { locale: "fi" })
+        .href).toBe("https://fin.example.com/about");
+    expect(runtime.localizeUrl("https://fin.example.com/about", { locale: "fi" }).href).toBe("https://fin.example.com/about");
+    expect(runtime.deLocalizeUrl("https://fin.example.com/en/about").href).toBe("https://fin.example.com/about");
+    expect(runtime.deLocalizeUrl("https://fin.example.com/about").href).toBe("https://fin.example.com/about");
+});
+test("host locales restrict which prefixes are recognized", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "sv", "pt-PT", "de"],
+        strategy: ["url", "baseLocale"],
+        routing: {
+            "app.example.com": {
+                baseLocale: "sv",
+                locales: ["sv", "en", "pt-PT"],
+            },
+        },
+    });
+    expect(runtime.extractLocaleFromUrl("https://app.example.com/pt-PT/shop")).toBe("pt-PT");
+    // de is a project locale but not allowed on this host → treated as path
+    expect(runtime.extractLocaleFromUrl("https://app.example.com/de/shop")).toBe("sv");
+    expect(runtime.localizeUrl("https://app.example.com/shop", { locale: "pt-PT" })
+        .href).toBe("https://app.example.com/pt-PT/shop");
+});
+test("localizeHref works with host routing under ALS origin", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fi"],
+        strategy: ["url", "baseLocale"],
+        routing: {
+            "fin.example.com": { baseLocale: "fi" },
+        },
+    });
+    runtime.overwriteServerAsyncLocalStorage({
+        getStore: () => ({
+            locale: "fi",
+            origin: "https://fin.example.com",
+        }),
+        run: () => undefined,
+    });
+    expect(runtime.localizeHref("/about")).toBe("/about");
+    expect(runtime.localizeHref("/about", { locale: "en" })).toBe("/en/about");
+    expect(runtime.localizeHref("/en/about", { locale: "fi" })).toBe("/about");
+});
+//# sourceMappingURL=host-routing.test.js.map

package/dist/compiler/runtime/host-routing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-routing.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/host-routing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACpE,MAAM,QAAQ,GAAG,gBAAgB,CAAC;QACjC,OAAO,EAAE;YACR,iBAAiB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACvC,iBAAiB,EAAE;gBAClB,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;aAC9B;SACD;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QAC1C,UAAU,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QACxB,iBAAiB,EAAE;YAClB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;SAC1C;QACD,iBAAiB,EAAE;YAClB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;SAC9B;QACD,GAAG,EAAE;YACJ,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;SAC1C;KACD,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,CAAC,GAAG,EAAE,CACX,gBAAgB,CAAC;QAChB,OAAO,EAAE;YACR,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;SACzC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,UAAU,EAAE,IAAI;KAChB,CAAC,CACF,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACrE,MAAM,CAAC,GAAG,EAAE,CACX,iBAAiB,CAAC;QACjB,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,eAAe,EAAE;YAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;YAC/B,UAAU,EAAE,kBAAkB;YAC9B,YAAY,EAAE,GAAG;YACjB,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,kBAAkB;YACnC,QAAQ,EAAE,+BAA+B;YACzC,qCAAqC,EAAE,KAAK;YAC5C,wBAAwB,EAAE,KAAK;YAC/B,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;YACtC,WAAW,EAAE;gBACZ;oBACC,OAAO,EAAE,aAAa;oBACtB,SAAS,EAAE;wBACV,CAAC,IAAI,EAAE,aAAa,CAAC;wBACrB,CAAC,IAAI,EAAE,gBAAgB,CAAC;qBACxB;iBACD;aACD;SACD;KACD,CAAC,CACF,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;IACjF,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;QAC/B,OAAO,EAAE;YACR,iBAAiB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACvC,iBAAiB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YACvC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACzB;KACD,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CACzE,IAAI,CACJ,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,CACL,OAAO,CAAC,oBAAoB,CAAC,kCAAkC,CAAC,CAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,gCAAgC,CAAC,CAAC,CAAC,IAAI,CAC1E,IAAI,CACJ,CAAC;IAEF,MAAM,CACL,OAAO,CAAC,WAAW,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC3E,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC3C,MAAM,CACL,OAAO,CAAC,WAAW,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SACvE,IAAI,CACN,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACxC,MAAM,CACL,OAAO,CAAC,WAAW,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC3E,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAExC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,kCAAkC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAC1E,+BAA+B,CAC/B,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CACvE,+BAA+B,CAC/B,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;IACtE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;QAC/B,OAAO,EAAE;YACR,iBAAiB,EAAE;gBAClB,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;aAC9B;SACD;KACD,CAAC,CAAC;IAEH,MAAM,CACL,OAAO,CAAC,oBAAoB,CAAC,oCAAoC,CAAC,CAClE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAC3E,IAAI,CACJ,CAAC;IACF,MAAM,CACL,OAAO,CAAC,WAAW,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;SACtE,IAAI,CACN,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;IACxE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;QAC/B,OAAO,EAAE;YACR,iBAAiB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;SACvC;KACD,CAAC,CAAC;IAEH,OAAO,CAAC,gCAAgC,CAAC;QACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YAChB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,yBAAyB;SACjC,CAAC;QACF,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC","sourcesContent":["import { test, expect } from \"vitest\";\nimport { createParaglide } from \"../create-paraglide.js\";\nimport { createRuntimeFile, normalizeRouting } from \"./create-runtime.js\";\n\ntest(\"normalizeRouting fills * fallback and resolves defaults\", () => {\n\tconst resolved = normalizeRouting({\n\t\trouting: {\n\t\t\t\"fin.example.com\": { baseLocale: \"fi\" },\n\t\t\t\"app.example.com\": {\n\t\t\t\tbaseLocale: \"sv\",\n\t\t\t\tlocales: [\"sv\", \"en\", \"pt-PT\"],\n\t\t\t},\n\t\t},\n\t\tlocales: [\"en\", \"fi\", \"sv\", \"pt-PT\", \"de\"],\n\t\tbaseLocale: \"en\",\n\t});\n\n\texpect(resolved).toEqual({\n\t\t\"fin.example.com\": {\n\t\t\tbaseLocale: \"fi\",\n\t\t\tlocales: [\"en\", \"fi\", \"sv\", \"pt-PT\", \"de\"],\n\t\t},\n\t\t\"app.example.com\": {\n\t\t\tbaseLocale: \"sv\",\n\t\t\tlocales: [\"sv\", \"en\", \"pt-PT\"],\n\t\t},\n\t\t\"*\": {\n\t\t\tbaseLocale: \"en\",\n\t\t\tlocales: [\"en\", \"fi\", \"sv\", \"pt-PT\", \"de\"],\n\t\t},\n\t});\n});\n\ntest(\"normalizeRouting rejects unknown locales\", () => {\n\texpect(() =>\n\t\tnormalizeRouting({\n\t\t\trouting: {\n\t\t\t\t\"fin.example.com\": { baseLocale: \"nope\" },\n\t\t\t},\n\t\t\tlocales: [\"en\", \"fi\"],\n\t\t\tbaseLocale: \"en\",\n\t\t})\n\t).toThrow(/Invalid baseLocale \"nope\"/);\n});\n\ntest(\"createRuntimeFile rejects routing + urlPatterns together\", () => {\n\texpect(() =>\n\t\tcreateRuntimeFile({\n\t\t\tbaseLocale: \"en\",\n\t\t\tlocales: [\"en\", \"de\"],\n\t\t\tcompilerOptions: {\n\t\t\t\tstrategy: [\"url\", \"baseLocale\"],\n\t\t\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t\t\t\tcookieMaxAge: 100,\n\t\t\t\tcookieDomain: \"\",\n\t\t\t\tlocalStorageKey: \"PARAGLIDE_LOCALE\",\n\t\t\t\tisServer: \"typeof window === 'undefined'\",\n\t\t\t\texperimentalMiddlewareLocaleSplitting: false,\n\t\t\t\tdisableAsyncLocalStorage: false,\n\t\t\t\trouting: { \"*\": { baseLocale: \"en\" } },\n\t\t\t\turlPatterns: [\n\t\t\t\t\t{\n\t\t\t\t\t\tpattern: \"/:path(.*)?\",\n\t\t\t\t\t\tlocalized: [\n\t\t\t\t\t\t\t[\"en\", \"/:path(.*)?\"],\n\t\t\t\t\t\t\t[\"de\", \"/de/:path(.*)?\"],\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t})\n\t).toThrow(/Cannot set both \"routing\" and \"urlPatterns\"/);\n});\n\ntest(\"per-host baseLocale: bare path is host default, /en is english\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fi\", \"sv\", \"de\"],\n\t\tstrategy: [\"url\", \"baseLocale\"],\n\t\trouting: {\n\t\t\t\"fin.example.com\": { baseLocale: \"fi\" },\n\t\t\t\"app.example.com\": { baseLocale: \"sv\" },\n\t\t\t\"*\": { baseLocale: \"en\" },\n\t\t},\n\t});\n\n\texpect(runtime.extractLocaleFromUrl(\"https://fin.example.com/\")).toBe(\"fi\");\n\texpect(runtime.extractLocaleFromUrl(\"https://fin.example.com/about\")).toBe(\n\t\t\"fi\"\n\t);\n\texpect(runtime.extractLocaleFromUrl(\"https://fin.example.com/en\")).toBe(\"en\");\n\texpect(\n\t\truntime.extractLocaleFromUrl(\"https://fin.example.com/en/about\")\n\t).toBe(\"en\");\n\texpect(runtime.extractLocaleFromUrl(\"https://app.example.com/\")).toBe(\"sv\");\n\texpect(runtime.extractLocaleFromUrl(\"https://other.example.com/de/x\")).toBe(\n\t\t\"de\"\n\t);\n\n\texpect(\n\t\truntime.localizeUrl(\"https://fin.example.com/about\", { locale: \"en\" }).href\n\t).toBe(\"https://fin.example.com/en/about\");\n\texpect(\n\t\truntime.localizeUrl(\"https://fin.example.com/en/about\", { locale: \"fi\" })\n\t\t\t.href\n\t).toBe(\"https://fin.example.com/about\");\n\texpect(\n\t\truntime.localizeUrl(\"https://fin.example.com/about\", { locale: \"fi\" }).href\n\t).toBe(\"https://fin.example.com/about\");\n\n\texpect(runtime.deLocalizeUrl(\"https://fin.example.com/en/about\").href).toBe(\n\t\t\"https://fin.example.com/about\"\n\t);\n\texpect(runtime.deLocalizeUrl(\"https://fin.example.com/about\").href).toBe(\n\t\t\"https://fin.example.com/about\"\n\t);\n});\n\ntest(\"host locales restrict which prefixes are recognized\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"sv\", \"pt-PT\", \"de\"],\n\t\tstrategy: [\"url\", \"baseLocale\"],\n\t\trouting: {\n\t\t\t\"app.example.com\": {\n\t\t\t\tbaseLocale: \"sv\",\n\t\t\t\tlocales: [\"sv\", \"en\", \"pt-PT\"],\n\t\t\t},\n\t\t},\n\t});\n\n\texpect(\n\t\truntime.extractLocaleFromUrl(\"https://app.example.com/pt-PT/shop\")\n\t).toBe(\"pt-PT\");\n\t// de is a project locale but not allowed on this host → treated as path\n\texpect(runtime.extractLocaleFromUrl(\"https://app.example.com/de/shop\")).toBe(\n\t\t\"sv\"\n\t);\n\texpect(\n\t\truntime.localizeUrl(\"https://app.example.com/shop\", { locale: \"pt-PT\" })\n\t\t\t.href\n\t).toBe(\"https://app.example.com/pt-PT/shop\");\n});\n\ntest(\"localizeHref works with host routing under ALS origin\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fi\"],\n\t\tstrategy: [\"url\", \"baseLocale\"],\n\t\trouting: {\n\t\t\t\"fin.example.com\": { baseLocale: \"fi\" },\n\t\t},\n\t});\n\n\truntime.overwriteServerAsyncLocalStorage({\n\t\tgetStore: () => ({\n\t\t\tlocale: \"fi\",\n\t\t\torigin: \"https://fin.example.com\",\n\t\t}),\n\t\trun: () => undefined,\n\t});\n\n\texpect(runtime.localizeHref(\"/about\")).toBe(\"/about\");\n\texpect(runtime.localizeHref(\"/about\", { locale: \"en\" })).toBe(\"/en/about\");\n\texpect(runtime.localizeHref(\"/en/about\", { locale: \"fi\" })).toBe(\"/about\");\n});\n"]}

package/dist/compiler/runtime/localize-href.d.ts

@@ -0,0 +1,84 @@
+/**
+ * High-level URL localization function optimized for client-side UI usage.
+ *
+ * This is a convenience wrapper around `localizeUrl()` that provides features
+ * needed in UI:
+ *
+ * - Accepts relative paths (e.g., "/about")
+ * - Returns relative paths when possible
+ * - Automatically detects current locale if not specified
+ * - Handles string input/output instead of URL objects
+ *
+ * @see https://paraglidejs.com/i18n-routing
+ *
+ * @example
+ * ```typescript
+ * // In a React/Vue/Svelte component
+ * const NavLink = ({ href }) => {
+ *   // Automatically uses current locale, keeps path relative
+ *   return <a href={localizeHref(href)}>...</a>;
+ * };
+ *
+ * // Examples:
+ * localizeHref("/about")
+ * // => "/de/about" (if current locale is "de")
+ * localizeHref("/store", { locale: "fr" })
+ * // => "/fr/store" (explicit locale)
+ *
+ * // Cross-origin links remain absolute
+ * localizeHref("https://other-site.com/about")
+ * // => "https://other-site.com/de/about"
+ * ```
+ *
+ * For server-side URL localization (e.g., in middleware), use `localizeUrl()`
+ * which provides more precise control over URL handling.
+ *
+ * @param {string} href - The href to localize (can be relative or absolute)
+ * @param {object} [options] - Options for localization
+ * @param {Locale} [options.locale] - Target locale. If not provided, uses `getLocale()`
+ * @returns {string} The localized href, relative if input was relative
+ */
+export declare function localizeHref(href: string, options?: {
+    locale?: Locale;
+}): string;
+/**
+ * High-level URL de-localization function optimized for client-side UI usage.
+ *
+ * This is a convenience wrapper around `deLocalizeUrl()` that provides features
+ * needed in the UI:
+ *
+ * - Accepts relative paths (e.g., "/de/about")
+ * - Returns relative paths when possible
+ * - Handles string input/output instead of URL objects
+ *
+ * @see https://paraglidejs.com/i18n-routing
+ *
+ * @example
+ * ```typescript
+ * // In a React/Vue/Svelte component
+ * const LocaleSwitcher = ({ href }) => {
+ *   // Remove locale prefix before switching
+ *   const baseHref = deLocalizeHref(href);
+ *   return locales.map(locale =>
+ *     <a href={localizeHref(baseHref, { locale })}>
+ *       Switch to {locale}
+ *     </a>
+ *   );
+ * };
+ *
+ * // Examples:
+ * deLocalizeHref("/de/about")  // => "/about"
+ * deLocalizeHref("/fr/store")  // => "/store"
+ *
+ * // Cross-origin links remain absolute
+ * deLocalizeHref("https://example.com/de/about")
+ * // => "https://example.com/about"
+ * ```
+ *
+ * For server-side URL de-localization (e.g., in middleware), use `deLocalizeUrl()`
+ * which provides more precise control over URL handling.
+ *
+ * @param {string} href - The href to de-localize (can be relative or absolute)
+ * @returns {string} The de-localized href, relative if input was relative
+ */
+export declare function deLocalizeHref(href: string): string;

package/dist/compiler/runtime/localize-href.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-href.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/localize-href.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,YAAY,CAAC,IAAI,EALtB,MAKsB,EAAE,OAAO,AAJvC,CAEA,EADA;IAAyB,MAAM,AAA/B,CACA,EADQ,MAAM,CACd;CAEuC,GAF7B,MAAM,CAyBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAHxB,MAGwB,GAFtB,MAAM,CAclB"}

package/dist/compiler/runtime/localize-href.js

@@ -0,0 +1,115 @@
+import { getLocale } from "./get-locale.js";
+import { getUrlOrigin } from "./get-url-origin.js";
+import { deLocalizeUrl, localizeUrl } from "./localize-url.js";
+/**
+ * High-level URL localization function optimized for client-side UI usage.
+ *
+ * This is a convenience wrapper around `localizeUrl()` that provides features
+ * needed in UI:
+ *
+ * - Accepts relative paths (e.g., "/about")
+ * - Returns relative paths when possible
+ * - Automatically detects current locale if not specified
+ * - Handles string input/output instead of URL objects
+ *
+ * @see https://paraglidejs.com/i18n-routing
+ *
+ * @example
+ * ```typescript
+ * // In a React/Vue/Svelte component
+ * const NavLink = ({ href }) => {
+ *   // Automatically uses current locale, keeps path relative
+ *   return <a href={localizeHref(href)}>...</a>;
+ * };
+ *
+ * // Examples:
+ * localizeHref("/about")
+ * // => "/de/about" (if current locale is "de")
+ * localizeHref("/store", { locale: "fr" })
+ * // => "/fr/store" (explicit locale)
+ *
+ * // Cross-origin links remain absolute
+ * localizeHref("https://other-site.com/about")
+ * // => "https://other-site.com/de/about"
+ * ```
+ *
+ * For server-side URL localization (e.g., in middleware), use `localizeUrl()`
+ * which provides more precise control over URL handling.
+ *
+ * @param {string} href - The href to localize (can be relative or absolute)
+ * @param {object} [options] - Options for localization
+ * @param {Locale} [options.locale] - Target locale. If not provided, uses `getLocale()`
+ * @returns {string} The localized href, relative if input was relative
+ */
+export function localizeHref(href, options) {
+    const currentLocale = getLocale();
+    const locale = options?.locale ?? currentLocale;
+    const url = new URL(href, getUrlOrigin());
+    const localized = localizeUrl(url, { locale });
+    // if the origin is identical and the href is relative,
+    // return the relative path
+    if (href.startsWith("/") && url.origin === localized.origin) {
+        // check for cross origin localization in which case an absolute URL must be returned.
+        if (locale !== currentLocale) {
+            const localizedCurrentLocale = localizeUrl(url, {
+                locale: currentLocale,
+            });
+            if (localizedCurrentLocale.origin !== localized.origin) {
+                return localized.href;
+            }
+        }
+        return localized.pathname + localized.search + localized.hash;
+    }
+    return localized.href;
+}
+/**
+ * High-level URL de-localization function optimized for client-side UI usage.
+ *
+ * This is a convenience wrapper around `deLocalizeUrl()` that provides features
+ * needed in the UI:
+ *
+ * - Accepts relative paths (e.g., "/de/about")
+ * - Returns relative paths when possible
+ * - Handles string input/output instead of URL objects
+ *
+ * @see https://paraglidejs.com/i18n-routing
+ *
+ * @example
+ * ```typescript
+ * // In a React/Vue/Svelte component
+ * const LocaleSwitcher = ({ href }) => {
+ *   // Remove locale prefix before switching
+ *   const baseHref = deLocalizeHref(href);
+ *   return locales.map(locale =>
+ *     <a href={localizeHref(baseHref, { locale })}>
+ *       Switch to {locale}
+ *     </a>
+ *   );
+ * };
+ *
+ * // Examples:
+ * deLocalizeHref("/de/about")  // => "/about"
+ * deLocalizeHref("/fr/store")  // => "/store"
+ *
+ * // Cross-origin links remain absolute
+ * deLocalizeHref("https://example.com/de/about")
+ * // => "https://example.com/about"
+ * ```
+ *
+ * For server-side URL de-localization (e.g., in middleware), use `deLocalizeUrl()`
+ * which provides more precise control over URL handling.
+ *
+ * @param {string} href - The href to de-localize (can be relative or absolute)
+ * @returns {string} The de-localized href, relative if input was relative
+ */
+export function deLocalizeHref(href) {
+    const url = new URL(href, getUrlOrigin());
+    const deLocalized = deLocalizeUrl(url);
+    // If the origin is identical and the href is relative,
+    // return the relative path instead of the full URL.
+    if (href.startsWith("/") && url.origin === deLocalized.origin) {
+        return deLocalized.pathname + deLocalized.search + deLocalized.hash;
+    }
+    return deLocalized.href;
+}
+//# sourceMappingURL=localize-href.js.map

package/dist/compiler/runtime/localize-href.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-href.js","sourceRoot":"","sources":["../../../src/compiler/runtime/localize-href.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,YAAY,CAAC,IAAI,EAAE,OAAO;IACzC,MAAM,aAAa,GAAG,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE/C,uDAAuD;IACvD,2BAA2B;IAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7D,sFAAsF;QACtF,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YAC9B,MAAM,sBAAsB,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC/C,MAAM,EAAE,aAAa;aACrB,CAAC,CAAC;YACH,IAAI,sBAAsB,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;gBACxD,OAAO,SAAS,CAAC,IAAI,CAAC;YACvB,CAAC;QACF,CAAC;QACD,OAAO,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC;IAC/D,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,cAAc,CAAC,IAAI;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAE1C,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAEvC,uDAAuD;IACvD,oDAAoD;IACpD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QAC/D,OAAO,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC;IACrE,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,CAAC;AACzB,CAAC","sourcesContent":["import { getLocale } from \"./get-locale.js\";\nimport { getUrlOrigin } from \"./get-url-origin.js\";\nimport { deLocalizeUrl, localizeUrl } from \"./localize-url.js\";\n\n/**\n * High-level URL localization function optimized for client-side UI usage.\n *\n * This is a convenience wrapper around `localizeUrl()` that provides features\n * needed in UI:\n *\n * - Accepts relative paths (e.g., \"/about\")\n * - Returns relative paths when possible\n * - Automatically detects current locale if not specified\n * - Handles string input/output instead of URL objects\n *\n * @see https://paraglidejs.com/i18n-routing\n *\n * @example\n * ```typescript\n * // In a React/Vue/Svelte component\n * const NavLink = ({ href }) => {\n *   // Automatically uses current locale, keeps path relative\n *   return <a href={localizeHref(href)}>...</a>;\n * };\n *\n * // Examples:\n * localizeHref(\"/about\")\n * // => \"/de/about\" (if current locale is \"de\")\n * localizeHref(\"/store\", { locale: \"fr\" })\n * // => \"/fr/store\" (explicit locale)\n *\n * // Cross-origin links remain absolute\n * localizeHref(\"https://other-site.com/about\")\n * // => \"https://other-site.com/de/about\"\n * ```\n *\n * For server-side URL localization (e.g., in middleware), use `localizeUrl()`\n * which provides more precise control over URL handling.\n *\n * @param {string} href - The href to localize (can be relative or absolute)\n * @param {object} [options] - Options for localization\n * @param {Locale} [options.locale] - Target locale. If not provided, uses `getLocale()`\n * @returns {string} The localized href, relative if input was relative\n */\nexport function localizeHref(href, options) {\n\tconst currentLocale = getLocale();\n\tconst locale = options?.locale ?? currentLocale;\n\tconst url = new URL(href, getUrlOrigin());\n\n\tconst localized = localizeUrl(url, { locale });\n\n\t// if the origin is identical and the href is relative,\n\t// return the relative path\n\tif (href.startsWith(\"/\") && url.origin === localized.origin) {\n\t\t// check for cross origin localization in which case an absolute URL must be returned.\n\t\tif (locale !== currentLocale) {\n\t\t\tconst localizedCurrentLocale = localizeUrl(url, {\n\t\t\t\tlocale: currentLocale,\n\t\t\t});\n\t\t\tif (localizedCurrentLocale.origin !== localized.origin) {\n\t\t\t\treturn localized.href;\n\t\t\t}\n\t\t}\n\t\treturn localized.pathname + localized.search + localized.hash;\n\t}\n\n\treturn localized.href;\n}\n\n/**\n * High-level URL de-localization function optimized for client-side UI usage.\n *\n * This is a convenience wrapper around `deLocalizeUrl()` that provides features\n * needed in the UI:\n *\n * - Accepts relative paths (e.g., \"/de/about\")\n * - Returns relative paths when possible\n * - Handles string input/output instead of URL objects\n *\n * @see https://paraglidejs.com/i18n-routing\n *\n * @example\n * ```typescript\n * // In a React/Vue/Svelte component\n * const LocaleSwitcher = ({ href }) => {\n *   // Remove locale prefix before switching\n *   const baseHref = deLocalizeHref(href);\n *   return locales.map(locale =>\n *     <a href={localizeHref(baseHref, { locale })}>\n *       Switch to {locale}\n *     </a>\n *   );\n * };\n *\n * // Examples:\n * deLocalizeHref(\"/de/about\")  // => \"/about\"\n * deLocalizeHref(\"/fr/store\")  // => \"/store\"\n *\n * // Cross-origin links remain absolute\n * deLocalizeHref(\"https://example.com/de/about\")\n * // => \"https://example.com/about\"\n * ```\n *\n * For server-side URL de-localization (e.g., in middleware), use `deLocalizeUrl()`\n * which provides more precise control over URL handling.\n *\n * @param {string} href - The href to de-localize (can be relative or absolute)\n * @returns {string} The de-localized href, relative if input was relative\n */\nexport function deLocalizeHref(href) {\n\tconst url = new URL(href, getUrlOrigin());\n\n\tconst deLocalized = deLocalizeUrl(url);\n\n\t// If the origin is identical and the href is relative,\n\t// return the relative path instead of the full URL.\n\tif (href.startsWith(\"/\") && url.origin === deLocalized.origin) {\n\t\treturn deLocalized.pathname + deLocalized.search + deLocalized.hash;\n\t}\n\n\treturn deLocalized.href;\n}\n"]}

package/dist/compiler/runtime/localize-href.test.d.ts

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

package/dist/compiler/runtime/localize-href.test.d.ts.map

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

package/dist/compiler/runtime/localize-href.test.js

@@ -0,0 +1,139 @@
+import { test, expect } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+test("uses the locale from getLocale() if no locale is provided", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url", "globalVariable", "baseLocale"],
+        urlPatterns: [
+            {
+                pattern: "http://:domain(.*)/:locale(de|en)?/:path(.*)?",
+                localized: [
+                    ["de", "http://:domain(.*)/de/:path(.*)?"],
+                    ["en", "http://:domain(.*)/:path(.*)?"],
+                ],
+            },
+        ],
+    });
+    runtime.overwriteGetLocale(() => "de");
+    expect(runtime.localizeHref("/hello")).toBe("/de/hello");
+    expect(runtime.deLocalizeHref("/de/hello")).toBe("/hello");
+});
+test("returns an absolute href if the provided href is absolute", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url", "globalVariable", "baseLocale"],
+        urlPatterns: [
+            {
+                pattern: "http://:domain(.*)/:locale(de|en)?/:path(.*)?",
+                localized: [
+                    ["de", "http://:domain(.*)/de/:path(.*)?"],
+                    ["en", "http://:domain(.*)/:path(.*)?"],
+                ],
+            },
+        ],
+    });
+    expect(runtime.localizeHref("http://example.com/hello", { locale: "de" })).toBe("http://example.com/de/hello");
+    expect(runtime.deLocalizeHref("http://example.com/de/hello")).toBe("http://example.com/hello");
+});
+// useful if domain based localization is used for example
+test("returns an absolute href if the provided href is relative but the origin of the localized href differs", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url", "globalVariable", "baseLocale"],
+        urlPatterns: [
+            {
+                pattern: "http://example.com/:path(.*)?",
+                localized: [
+                    ["de", "http://de.example.com/:path(.*)?"],
+                    ["en", "http://example.com/:path(.*)?"],
+                ],
+            },
+        ],
+    });
+    // simulating routing from current en page to de page
+    runtime.overwriteGetLocale(() => "en");
+    runtime.overwriteGetUrlOrigin(() => "http://example.com");
+    expect(runtime.localizeHref("/hello", { locale: "de" })).toBe("http://de.example.com/hello");
+    expect(runtime.deLocalizeHref("http://de.example.com/hello")).toBe("http://example.com/hello");
+    // simulating routing from current de page to en page
+    runtime.overwriteGetLocale(() => "de");
+    expect(runtime.localizeHref("/hello", { locale: "en" })).toBe("http://example.com/hello");
+    expect(runtime.deLocalizeHref("http://example.com/hello")).toBe("http://example.com/hello");
+});
+// https://github.com/opral/inlang-paraglide-js/issues/362
+test("adding a base path", async () => {
+    const base = "shop";
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+        urlPatterns: [
+            {
+                pattern: `/{${base}/}?:path(.*)?`,
+                localized: [
+                    ["de", `/{${base}/}?de/:path(.*)?`],
+                    ["en", `/{${base}/}?:path(.*)?`],
+                ],
+            },
+        ],
+    });
+    // simulating the current locale to be en
+    runtime.overwriteGetLocale(() => "en");
+    expect(runtime.localizeHref("/about")).toBe("/shop/about");
+    expect(runtime.deLocalizeHref("/about")).toBe("/shop/about");
+    // simulating current locale to be de
+    runtime.overwriteGetLocale(() => "de");
+    expect(runtime.localizeHref("/about")).toBe("/shop/de/about");
+    expect(runtime.deLocalizeHref("/de/about")).toBe("/shop/about");
+});
+test("default url patterns to improve out of the box experience", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        isServer: "false",
+        strategy: ["url"],
+        urlPatterns: undefined,
+    });
+    // polyfilling window
+    globalThis.window = { location: new URL("http://example.com") };
+    expect(runtime.urlPatterns).toStrictEqual([
+        {
+            pattern: ":protocol://:domain(.*)::port?/:path(.*)?",
+            localized: [
+                ["de", ":protocol://:domain(.*)::port?/de/:path(.*)?"],
+                ["fr", ":protocol://:domain(.*)::port?/fr/:path(.*)?"],
+                ["en", ":protocol://:domain(.*)::port?/:path(.*)?"],
+            ],
+        },
+    ]);
+    // expecting the baseLocale to not be included in the url
+    expect(runtime.localizeHref("/about", { locale: "en" })).toBe("/about");
+    expect(runtime.localizeHref("/about", { locale: "de" })).toBe("/de/about");
+    // expecting root path to work
+    expect(runtime.localizeHref("/", { locale: "en" })).toBe("/");
+    expect(runtime.localizeHref("/", { locale: "de" })).toBe("/de/");
+    // expecting de-localization to work
+    expect(runtime.deLocalizeHref("/de/")).toBe("/");
+    expect(runtime.deLocalizeHref("/de/about")).toBe("/about");
+    expect(runtime.deLocalizeHref("/about")).toBe("/about");
+    // expecting localhost to work (for development)
+    expect(runtime.localizeHref("http://localhost:5173/", { locale: "de" })).toBe("http://localhost:5173/de/");
+    // de-localizing localhost
+    expect(runtime.deLocalizeHref("http://localhost:5173/de")).toBe("http://localhost:5173/");
+    // pathnames
+    expect(runtime.localizeHref("http://localhost:5173/about", { locale: "de" })).toBe("http://localhost:5173/de/about");
+    expect(runtime.deLocalizeHref("http://localhost:5173/de/about")).toBe("http://localhost:5173/about");
+});
+test("normalizes mixed-case explicit locales in localizeHref", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+    });
+    expect(runtime.localizeHref("/about", { locale: "DE" })).toBe("/de/about");
+    expect(runtime.localizeHref("/de/about", { locale: "EN" })).toBe("/about");
+});
+//# sourceMappingURL=localize-href.test.js.map