@sebbro/paraglide-lite 0.1.0

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

@@ -0,0 +1,295 @@
+import { expect, test, vi } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+test("matching by strategy works", async () => {
+    const baseLocale = "en";
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["cookie", "baseLocale"],
+        cookieName: "PARAGLIDE_LOCALE",
+    });
+    // @ts-expect-error - global variable definition
+    globalThis.document = {};
+    globalThis.document.cookie = "OTHER_COOKIE=blaba;";
+    const locale = runtime.getLocale();
+    expect(locale).toBe(baseLocale);
+});
+test("experimentalStaticLocale overrides runtime strategies", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["cookie", "baseLocale"],
+        experimentalStaticLocale: JSON.stringify("de"),
+    });
+    expect(runtime.getLocale()).toBe("de");
+});
+test("invalid experimentalStaticLocale throws during runtime creation", async () => {
+    await expect(createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["cookie", "baseLocale"],
+        experimentalStaticLocale: JSON.stringify("fr"),
+    })).rejects.toThrow("Invalid locale: fr. Expected one of: en, de");
+});
+test("throws if variable is used without baseLocale as fallback strategy", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["globalVariable"],
+    });
+    expect(() => runtime.getLocale()).toThrow();
+    runtime.setLocale("de");
+    expect(runtime.getLocale()).toBe("de");
+});
+test("retrieves the locale for a url pattern", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+        isServer: "false",
+        urlPatterns: [
+            {
+                pattern: "https://example.:tld/:path*",
+                localized: [
+                    ["en", "https://example.com/:path*"],
+                    ["de", "https://example.de/:path*"],
+                ],
+            },
+        ],
+    });
+    globalThis.window = { location: { href: "https://example.com/page" } };
+    expect(runtime.getLocale()).toBe("en");
+    globalThis.window = { location: { href: "https://example.de/page" } };
+    expect(runtime.getLocale()).toBe("de");
+});
+test("url pattern strategy doesn't throw during SSR", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url", "baseLocale"],
+        urlPatterns: [
+            {
+                pattern: "https://example.:tld/:path*",
+                localized: [
+                    ["en", "https://example.com/:path*"],
+                    ["de", "https://example.de/:path*"],
+                ],
+            },
+        ],
+    });
+    expect(() => runtime.getLocale()).not.toThrow();
+});
+test("doesn't throw for an old cookie locale", async () => {
+    const baseLocale = "en";
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["cookie", "baseLocale"],
+        cookieName: "PARAGLIDE_LOCALE",
+    });
+    // @ts-expect-error - global variable definition
+    globalThis.document = {};
+    globalThis.document.cookie = "PARAGLIDE_LOCALE=fr;";
+    const locale = runtime.getLocale();
+    expect(locale).toBe(baseLocale);
+});
+test("returns the preferred locale from navigator.languages", async () => {
+    const originalNavigator = globalThis.navigator;
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        isServer: "false",
+        strategy: ["preferredLanguage"],
+    });
+    // Mock navigator.languages
+    Object.defineProperty(globalThis, "navigator", {
+        value: {
+            languages: ["fr-FR", "en-US", "de"],
+        },
+        configurable: true,
+    });
+    expect(runtime.getLocale()).toBe("fr");
+    // Restore original navigator
+    Object.defineProperty(globalThis, "navigator", {
+        value: originalNavigator,
+        configurable: true,
+    });
+});
+test("returns the locale from local storage", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["localStorage"],
+        localStorageKey: "PARAGLIDE_LOCALE",
+        isServer: "false",
+    });
+    // @ts-expect-error - global variable definition
+    globalThis.localStorage = {
+        setItem: vi.fn(),
+        getItem: vi.fn(() => "de"),
+    };
+    expect(runtime.getLocale()).toBe("de");
+});
+test("initially sets the locale after resolving it for the first time", async () => {
+    // Create runtime with multiple strategies
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        strategy: ["url", "cookie"],
+        isServer: "false",
+        cookieName: "PARAGLIDE_LOCALE",
+        urlPatterns: [
+            {
+                pattern: "https://example.com/:path*",
+                localized: [
+                    ["en", "https://example.com/en/:path*"],
+                    ["de", "https://example.com/de/:path*"],
+                    ["fr", "https://example.com/fr/:path*"],
+                ],
+            },
+        ],
+    });
+    // Setup global objects for URL strategy
+    globalThis.window = {
+        // @ts-expect-error - global variable definition
+        location: {
+            hostname: "example.com",
+            href: "https://example.com/de/page",
+        },
+    };
+    // Create a spy on the internal _locale variable to verify it was set
+    // We can do this by checking if setLocale works without explicitly setting it first
+    // @ts-expect-error - global variable definition
+    globalThis.document = { cookie: "" };
+    // First call to getLocale should resolve and set the locale
+    expect(runtime.getLocale()).toBe("de");
+    // Cookie should be set, proving that the locale was initially set
+    expect(globalThis.document.cookie).toBe("PARAGLIDE_LOCALE=de; path=/; max-age=34560000");
+    expect(globalThis.window.location.href).toBe("https://example.com/de/page");
+});
+test("returns locale from custom strategy", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        strategy: ["custom-client", "baseLocale"],
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-client", {
+        getLocale: () => "fr",
+        setLocale: () => { },
+    });
+    const locale = runtime.getLocale();
+    expect(locale).toBe("fr");
+});
+test("falls back to next strategy when custom strategy returns undefined", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr"],
+        strategy: ["custom-undefined", "baseLocale"],
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-undefined", {
+        getLocale: () => undefined,
+        setLocale: () => { },
+    });
+    const locale = runtime.getLocale();
+    expect(locale).toBe("en"); // Should fall back to baseLocale
+});
+test("throws error if custom strategy returns invalid locale", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr"],
+        strategy: ["custom-invalid", "baseLocale"],
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-invalid", {
+        getLocale: () => "invalid-locale",
+        setLocale: () => { },
+    });
+    expect(() => runtime.getLocale()).toThrow();
+});
+test("custom strategy takes precedence over built-in strategies in getLocale", async () => {
+    // @ts-expect-error - global variable definition
+    globalThis.document = { cookie: "PARAGLIDE_LOCALE=fr" };
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        strategy: ["custom-priority", "cookie", "baseLocale"],
+        cookieName: "PARAGLIDE_LOCALE",
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-priority", {
+        getLocale: () => "de",
+        setLocale: () => { },
+    });
+    const locale = runtime.getLocale();
+    expect(locale).toBe("de"); // Should use custom strategy, not cookie
+});
+test("multiple custom strategies work in order in getLocale", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        strategy: ["custom-first", "custom-second", "baseLocale"],
+        isServer: "false",
+    });
+    // Define two custom strategies
+    runtime.defineCustomClientStrategy("custom-first", {
+        getLocale: () => undefined, // This one returns undefined
+        setLocale: () => { },
+    });
+    runtime.defineCustomClientStrategy("custom-second", {
+        getLocale: () => "fr", // This one returns a locale
+        setLocale: () => { },
+    });
+    const locale = runtime.getLocale();
+    expect(locale).toBe("fr"); // Should use second custom strategy
+});
+test("custom strategy works with session storage simulation", async () => {
+    // Simulate a custom strategy that reads from session storage
+    let sessionData = "de";
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        strategy: ["custom-session", "baseLocale"],
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-session", {
+        getLocale: () => sessionData,
+        setLocale: (locale) => {
+            sessionData = locale;
+        },
+    });
+    const locale = runtime.getLocale();
+    expect(locale).toBe("de");
+});
+test("custom strategy integrates with locale initialization", async () => {
+    // @ts-expect-error - global variable definition
+    globalThis.window = {};
+    // Define a custom strategy that tracks if it was called
+    let getLocaleCalled = false;
+    let setLocaleCalled = false;
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "fr", "de"],
+        strategy: ["custom-tracking"],
+        isServer: "false",
+    });
+    runtime.defineCustomClientStrategy("custom-tracking", {
+        getLocale: () => {
+            getLocaleCalled = true;
+            return "fr";
+        },
+        setLocale: () => {
+            setLocaleCalled = true;
+        },
+    });
+    // First call should trigger the custom strategy
+    const locale = runtime.getLocale();
+    expect(locale).toBe("fr");
+    expect(getLocaleCalled).toBe(true);
+    // Setting the locale should also call the custom strategy
+    runtime.setLocale("de");
+    // The locale should be set internally after first resolution
+    expect(setLocaleCalled).toBe(true);
+});
+//# sourceMappingURL=get-locale.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-locale.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-locale.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test, vi } from \"vitest\";\nimport { createParaglide } from \"../create-paraglide.js\";\n\ntest(\"matching by strategy works\", async () => {\n\tconst baseLocale = \"en\";\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"cookie\", \"baseLocale\"],\n\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t});\n\n\t// @ts-expect-error - global variable definition\n\tglobalThis.document = {};\n\tglobalThis.document.cookie = \"OTHER_COOKIE=blaba;\";\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(baseLocale);\n});\n\ntest(\"experimentalStaticLocale overrides runtime strategies\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"cookie\", \"baseLocale\"],\n\t\texperimentalStaticLocale: JSON.stringify(\"de\"),\n\t});\n\n\texpect(runtime.getLocale()).toBe(\"de\");\n});\n\ntest(\"invalid experimentalStaticLocale throws during runtime creation\", async () => {\n\tawait expect(\n\t\tcreateParaglide({\n\t\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\t\tstrategy: [\"cookie\", \"baseLocale\"],\n\t\t\texperimentalStaticLocale: JSON.stringify(\"fr\"),\n\t\t})\n\t).rejects.toThrow(\"Invalid locale: fr. Expected one of: en, de\");\n});\n\ntest(\"throws if variable is used without baseLocale as fallback strategy\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"globalVariable\"],\n\t});\n\n\texpect(() => runtime.getLocale()).toThrow();\n\n\truntime.setLocale(\"de\");\n\n\texpect(runtime.getLocale()).toBe(\"de\");\n});\n\ntest(\"retrieves the locale for a url pattern\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"url\"],\n\t\tisServer: \"false\",\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"https://example.:tld/:path*\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"https://example.com/:path*\"],\n\t\t\t\t\t[\"de\", \"https://example.de/:path*\"],\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\tglobalThis.window = { location: { href: \"https://example.com/page\" } } as any;\n\n\texpect(runtime.getLocale()).toBe(\"en\");\n\n\tglobalThis.window = { location: { href: \"https://example.de/page\" } } as any;\n\n\texpect(runtime.getLocale()).toBe(\"de\");\n});\n\ntest(\"url pattern strategy doesn't throw during SSR\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"url\", \"baseLocale\"],\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"https://example.:tld/:path*\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"https://example.com/:path*\"],\n\t\t\t\t\t[\"de\", \"https://example.de/:path*\"],\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\texpect(() => runtime.getLocale()).not.toThrow();\n});\n\ntest(\"doesn't throw for an old cookie locale\", async () => {\n\tconst baseLocale = \"en\";\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"cookie\", \"baseLocale\"],\n\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t});\n\n\t// @ts-expect-error - global variable definition\n\tglobalThis.document = {};\n\tglobalThis.document.cookie = \"PARAGLIDE_LOCALE=fr;\";\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(baseLocale);\n});\n\ntest(\"returns the preferred locale from navigator.languages\", async () => {\n\tconst originalNavigator = globalThis.navigator;\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tisServer: \"false\",\n\t\tstrategy: [\"preferredLanguage\"],\n\t});\n\n\t// Mock navigator.languages\n\tObject.defineProperty(globalThis, \"navigator\", {\n\t\tvalue: {\n\t\t\tlanguages: [\"fr-FR\", \"en-US\", \"de\"],\n\t\t},\n\t\tconfigurable: true,\n\t});\n\n\texpect(runtime.getLocale()).toBe(\"fr\");\n\n\t// Restore original navigator\n\tObject.defineProperty(globalThis, \"navigator\", {\n\t\tvalue: originalNavigator,\n\t\tconfigurable: true,\n\t});\n});\n\ntest(\"returns the locale from local storage\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"localStorage\"],\n\t\tlocalStorageKey: \"PARAGLIDE_LOCALE\",\n\t\tisServer: \"false\",\n\t});\n\n\t// @ts-expect-error - global variable definition\n\tglobalThis.localStorage = {\n\t\tsetItem: vi.fn(),\n\t\tgetItem: vi.fn(() => \"de\"),\n\t};\n\n\texpect(runtime.getLocale()).toBe(\"de\");\n});\n\ntest(\"initially sets the locale after resolving it for the first time\", async () => {\n\t// Create runtime with multiple strategies\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\tstrategy: [\"url\", \"cookie\"],\n\t\tisServer: \"false\",\n\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"https://example.com/:path*\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"https://example.com/en/:path*\"],\n\t\t\t\t\t[\"de\", \"https://example.com/de/:path*\"],\n\t\t\t\t\t[\"fr\", \"https://example.com/fr/:path*\"],\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\t// Setup global objects for URL strategy\n\tglobalThis.window = {\n\t\t// @ts-expect-error - global variable definition\n\t\tlocation: {\n\t\t\thostname: \"example.com\",\n\t\t\thref: \"https://example.com/de/page\",\n\t\t},\n\t};\n\n\t// Create a spy on the internal _locale variable to verify it was set\n\t// We can do this by checking if setLocale works without explicitly setting it first\n\t// @ts-expect-error - global variable definition\n\tglobalThis.document = { cookie: \"\" };\n\n\t// First call to getLocale should resolve and set the locale\n\texpect(runtime.getLocale()).toBe(\"de\");\n\t// Cookie should be set, proving that the locale was initially set\n\texpect(globalThis.document.cookie).toBe(\n\t\t\"PARAGLIDE_LOCALE=de; path=/; max-age=34560000\"\n\t);\n\texpect(globalThis.window.location.href).toBe(\"https://example.com/de/page\");\n});\n\ntest(\"returns locale from custom strategy\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tstrategy: [\"custom-client\", \"baseLocale\"],\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-client\", {\n\t\tgetLocale: () => \"fr\",\n\t\tsetLocale: () => {},\n\t});\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"fr\");\n});\n\ntest(\"falls back to next strategy when custom strategy returns undefined\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\"],\n\t\tstrategy: [\"custom-undefined\", \"baseLocale\"],\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-undefined\", {\n\t\tgetLocale: () => undefined,\n\t\tsetLocale: () => {},\n\t});\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"en\"); // Should fall back to baseLocale\n});\n\ntest(\"throws error if custom strategy returns invalid locale\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\"],\n\t\tstrategy: [\"custom-invalid\", \"baseLocale\"],\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-invalid\", {\n\t\tgetLocale: () => \"invalid-locale\",\n\t\tsetLocale: () => {},\n\t});\n\n\texpect(() => runtime.getLocale()).toThrow();\n});\n\ntest(\"custom strategy takes precedence over built-in strategies in getLocale\", async () => {\n\t// @ts-expect-error - global variable definition\n\tglobalThis.document = { cookie: \"PARAGLIDE_LOCALE=fr\" };\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tstrategy: [\"custom-priority\", \"cookie\", \"baseLocale\"],\n\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-priority\", {\n\t\tgetLocale: () => \"de\",\n\t\tsetLocale: () => {},\n\t});\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"de\"); // Should use custom strategy, not cookie\n});\n\ntest(\"multiple custom strategies work in order in getLocale\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tstrategy: [\"custom-first\", \"custom-second\", \"baseLocale\"],\n\t\tisServer: \"false\",\n\t});\n\n\t// Define two custom strategies\n\truntime.defineCustomClientStrategy(\"custom-first\", {\n\t\tgetLocale: () => undefined, // This one returns undefined\n\t\tsetLocale: () => {},\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-second\", {\n\t\tgetLocale: () => \"fr\", // This one returns a locale\n\t\tsetLocale: () => {},\n\t});\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"fr\"); // Should use second custom strategy\n});\n\ntest(\"custom strategy works with session storage simulation\", async () => {\n\t// Simulate a custom strategy that reads from session storage\n\tlet sessionData = \"de\";\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tstrategy: [\"custom-session\", \"baseLocale\"],\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-session\", {\n\t\tgetLocale: () => sessionData,\n\t\tsetLocale: (locale) => {\n\t\t\tsessionData = locale;\n\t\t},\n\t});\n\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"de\");\n});\n\ntest(\"custom strategy integrates with locale initialization\", async () => {\n\t// @ts-expect-error - global variable definition\n\tglobalThis.window = {};\n\n\t// Define a custom strategy that tracks if it was called\n\tlet getLocaleCalled = false;\n\tlet setLocaleCalled = false;\n\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"fr\", \"de\"],\n\t\tstrategy: [\"custom-tracking\"],\n\t\tisServer: \"false\",\n\t});\n\n\truntime.defineCustomClientStrategy(\"custom-tracking\", {\n\t\tgetLocale: () => {\n\t\t\tgetLocaleCalled = true;\n\t\t\treturn \"fr\";\n\t\t},\n\t\tsetLocale: () => {\n\t\t\tsetLocaleCalled = true;\n\t\t},\n\t});\n\n\t// First call should trigger the custom strategy\n\tconst locale = runtime.getLocale();\n\texpect(locale).toBe(\"fr\");\n\texpect(getLocaleCalled).toBe(true);\n\n\t// Setting the locale should also call the custom strategy\n\truntime.setLocale(\"de\");\n\n\t// The locale should be set internally after first resolution\n\texpect(setLocaleCalled).toBe(true);\n});\n"]}

package/dist/compiler/runtime/get-text-direction.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get writing direction for a locale.
+ *
+ * Uses `Intl.Locale` text info when available and falls back to a
+ * language-based RTL check for runtimes without `getTextInfo()`.
+ *
+ * @example
+ *   getTextDirection(); // "ltr" or "rtl" for current locale
+ *   getTextDirection("ar"); // "rtl"
+ *   getTextDirection("en"); // "ltr"
+ *
+ * @param {string} [locale] - Target locale. If not provided, uses `getLocale()`
+ * @returns {"ltr" | "rtl"}
+ */
+export declare function getTextDirection(locale?: string): "ltr" | "rtl";

package/dist/compiler/runtime/get-text-direction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-text-direction.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-text-direction.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,AAHpC,CACA,EADQ,MAG0C,GAFxC,KAAK,GAAG,KAAK,CAoBzB"}

package/dist/compiler/runtime/get-text-direction.js

@@ -0,0 +1,46 @@
+import { getLocale } from "./get-locale.js";
+const rtlLanguages = new Set([
+    "ar",
+    "dv",
+    "fa",
+    "he",
+    "ks",
+    "ku",
+    "ps",
+    "sd",
+    "ug",
+    "ur",
+    "yi",
+]);
+/**
+ * Get writing direction for a locale.
+ *
+ * Uses `Intl.Locale` text info when available and falls back to a
+ * language-based RTL check for runtimes without `getTextInfo()`.
+ *
+ * @example
+ *   getTextDirection(); // "ltr" or "rtl" for current locale
+ *   getTextDirection("ar"); // "rtl"
+ *   getTextDirection("en"); // "ltr"
+ *
+ * @param {string} [locale] - Target locale. If not provided, uses `getLocale()`
+ * @returns {"ltr" | "rtl"}
+ */
+export function getTextDirection(locale = getLocale()) {
+    try {
+        const intlLocale = /** @type {Intl.Locale & {
+            getTextInfo?: () => { direction?: string };
+            textInfo?: { direction?: string };
+        }} */ (new Intl.Locale(locale));
+        const direction = intlLocale.getTextInfo?.().direction ?? intlLocale.textInfo?.direction;
+        if (direction === "ltr" || direction === "rtl") {
+            return direction;
+        }
+    }
+    catch {
+        // Ignore Intl.Locale parsing/runtime errors and use fallback below.
+    }
+    const language = locale.split("-")[0]?.toLowerCase();
+    return rtlLanguages.has(language ?? "") ? "rtl" : "ltr";
+}
+//# sourceMappingURL=get-text-direction.js.map

package/dist/compiler/runtime/get-text-direction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-text-direction.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-text-direction.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC5B,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACJ,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAM,GAAG,SAAS,EAAE;IACpD,IAAI,CAAC;QACJ,MAAM,UAAU,GAAG;;;aAGd,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,MAAM,SAAS,GACd,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,SAAS,IAAI,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;QAExE,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,oEAAoE;IACrE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACrD,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC","sourcesContent":["import { getLocale } from \"./get-locale.js\";\n\nconst rtlLanguages = new Set([\n\t\"ar\",\n\t\"dv\",\n\t\"fa\",\n\t\"he\",\n\t\"ks\",\n\t\"ku\",\n\t\"ps\",\n\t\"sd\",\n\t\"ug\",\n\t\"ur\",\n\t\"yi\",\n]);\n\n/**\n * Get writing direction for a locale.\n *\n * Uses `Intl.Locale` text info when available and falls back to a\n * language-based RTL check for runtimes without `getTextInfo()`.\n *\n * @example\n *   getTextDirection(); // \"ltr\" or \"rtl\" for current locale\n *   getTextDirection(\"ar\"); // \"rtl\"\n *   getTextDirection(\"en\"); // \"ltr\"\n *\n * @param {string} [locale] - Target locale. If not provided, uses `getLocale()`\n * @returns {\"ltr\" | \"rtl\"}\n */\nexport function getTextDirection(locale = getLocale()) {\n\ttry {\n\t\tconst intlLocale = /** @type {Intl.Locale & {\n\t\t\tgetTextInfo?: () => { direction?: string };\n\t\t\ttextInfo?: { direction?: string };\n\t\t}} */ (new Intl.Locale(locale));\n\t\tconst direction =\n\t\t\tintlLocale.getTextInfo?.().direction ?? intlLocale.textInfo?.direction;\n\n\t\tif (direction === \"ltr\" || direction === \"rtl\") {\n\t\t\treturn direction;\n\t\t}\n\t} catch {\n\t\t// Ignore Intl.Locale parsing/runtime errors and use fallback below.\n\t}\n\n\tconst language = locale.split(\"-\")[0]?.toLowerCase();\n\treturn rtlLanguages.has(language ?? \"\") ? \"rtl\" : \"ltr\";\n}\n"]}

package/dist/compiler/runtime/get-text-direction.test.d.ts

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

package/dist/compiler/runtime/get-text-direction.test.d.ts.map

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

package/dist/compiler/runtime/get-text-direction.test.js

@@ -0,0 +1,40 @@
+import { expect, test } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+const runtime = await createParaglide({
+    baseLocale: "en",
+    locales: ["en", "ar"],
+});
+test("returns direction for a provided locale", () => {
+    expect(runtime.getTextDirection("en")).toBe("ltr");
+    expect(runtime.getTextDirection("ar")).toBe("rtl");
+});
+test("uses current locale when no locale is provided", () => {
+    runtime.setLocale("ar", { reload: false });
+    expect(runtime.getTextDirection()).toBe("rtl");
+    runtime.setLocale("en", { reload: false });
+    expect(runtime.getTextDirection()).toBe("ltr");
+});
+test("falls back when Intl.Locale text info is unavailable", () => {
+    const OriginalLocale = Intl.Locale;
+    class MockLocale {
+        constructor(_locale) { }
+    }
+    Object.defineProperty(Intl, "Locale", {
+        value: MockLocale,
+        configurable: true,
+    });
+    try {
+        expect(runtime.getTextDirection("ar")).toBe("rtl");
+        expect(runtime.getTextDirection("ug")).toBe("rtl");
+        expect(runtime.getTextDirection("sd")).toBe("rtl");
+        expect(runtime.getTextDirection("ks")).toBe("rtl");
+        expect(runtime.getTextDirection("en")).toBe("ltr");
+    }
+    finally {
+        Object.defineProperty(Intl, "Locale", {
+            value: OriginalLocale,
+            configurable: true,
+        });
+    }
+});
+//# sourceMappingURL=get-text-direction.test.js.map

package/dist/compiler/runtime/get-text-direction.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-text-direction.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-text-direction.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;IACrC,UAAU,EAAE,IAAI;IACf,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;CACtB,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACpD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC3D,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACjE,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IAEnC,MAAM,UAAU;QACf,YAAY,OAAe,IAAG,CAAC;KAC/B;IAED,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE;QACrC,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,IAAI,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE;YACrC,KAAK,EAAE,cAAc;YACrB,YAAY,EAAE,IAAI;SAClB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC,CAAC,CAAC","sourcesContent":["import { expect, test } from \"vitest\";\nimport { createParaglide } from \"../create-paraglide.js\";\n\nconst runtime = await createParaglide({\n\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"ar\"],\n});\n\ntest(\"returns direction for a provided locale\", () => {\n\texpect(runtime.getTextDirection(\"en\")).toBe(\"ltr\");\n\texpect(runtime.getTextDirection(\"ar\")).toBe(\"rtl\");\n});\n\ntest(\"uses current locale when no locale is provided\", () => {\n\truntime.setLocale(\"ar\", { reload: false });\n\texpect(runtime.getTextDirection()).toBe(\"rtl\");\n\truntime.setLocale(\"en\", { reload: false });\n\texpect(runtime.getTextDirection()).toBe(\"ltr\");\n});\n\ntest(\"falls back when Intl.Locale text info is unavailable\", () => {\n\tconst OriginalLocale = Intl.Locale;\n\n\tclass MockLocale {\n\t\tconstructor(_locale: string) {}\n\t}\n\n\tObject.defineProperty(Intl, \"Locale\", {\n\t\tvalue: MockLocale,\n\t\tconfigurable: true,\n\t});\n\n\ttry {\n\t\texpect(runtime.getTextDirection(\"ar\")).toBe(\"rtl\");\n\t\texpect(runtime.getTextDirection(\"ug\")).toBe(\"rtl\");\n\t\texpect(runtime.getTextDirection(\"sd\")).toBe(\"rtl\");\n\t\texpect(runtime.getTextDirection(\"ks\")).toBe(\"rtl\");\n\t\texpect(runtime.getTextDirection(\"en\")).toBe(\"ltr\");\n\t} finally {\n\t\tObject.defineProperty(Intl, \"Locale\", {\n\t\t\tvalue: OriginalLocale,\n\t\t\tconfigurable: true,\n\t\t});\n\t}\n});\n"]}

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

@@ -0,0 +1,19 @@
+/**
+ * The origin of the current URL.
+ *
+ * Defaults to "http://example.com" in non-browser environments. If this
+ * behavior is not desired, the implementation can be overwritten
+ * by `overwriteGetUrlOrigin()`.
+ *
+ * @type {() => string}
+ */
+export declare let getUrlOrigin: () => string;
+/**
+ * Overwrite the getUrlOrigin function.
+ *
+ * Use this function in server environments to
+ * define how the URL origin is resolved.
+ *
+ * @param {() => string} fn - The new implementation for `getUrlOrigin()`.
+ */
+export declare let overwriteGetUrlOrigin: (fn: () => string) => void;

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-url-origin.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-url-origin.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,IAAI,YAAY,EAFb,MAAM,MASf,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,IAAI,qBAAqB,OAFrB,MAAM,MAAM,SAItB,CAAC"}

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

@@ -0,0 +1,31 @@
+import { serverAsyncLocalStorage } from "./variables.js";
+/**
+ * The origin of the current URL.
+ *
+ * Defaults to "http://example.com" in non-browser environments. If this
+ * behavior is not desired, the implementation can be overwritten
+ * by `overwriteGetUrlOrigin()`.
+ *
+ * @type {() => string}
+ */
+export let getUrlOrigin = () => {
+    if (serverAsyncLocalStorage) {
+        return serverAsyncLocalStorage.getStore()?.origin ?? "http://fallback.com";
+    }
+    else if (typeof window !== "undefined") {
+        return window.location.origin;
+    }
+    return "http://fallback.com";
+};
+/**
+ * Overwrite the getUrlOrigin function.
+ *
+ * Use this function in server environments to
+ * define how the URL origin is resolved.
+ *
+ * @param {() => string} fn - The new implementation for `getUrlOrigin()`.
+ */
+export let overwriteGetUrlOrigin = (fn) => {
+    getUrlOrigin = fn;
+};
+//# sourceMappingURL=get-url-origin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-url-origin.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-url-origin.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,CAAC,IAAI,YAAY,GAAG,GAAG,EAAE;IAC9B,IAAI,uBAAuB,EAAE,CAAC;QAC7B,OAAO,uBAAuB,CAAC,QAAQ,EAAE,EAAE,MAAM,IAAI,qBAAqB,CAAC;IAC5E,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,IAAI,qBAAqB,GAAG,CAAC,EAAE,EAAE,EAAE;IACzC,YAAY,GAAG,EAAE,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import { serverAsyncLocalStorage } from \"./variables.js\";\n\n/**\n * The origin of the current URL.\n *\n * Defaults to \"http://example.com\" in non-browser environments. If this\n * behavior is not desired, the implementation can be overwritten\n * by `overwriteGetUrlOrigin()`.\n *\n * @type {() => string}\n */\nexport let getUrlOrigin = () => {\n\tif (serverAsyncLocalStorage) {\n\t\treturn serverAsyncLocalStorage.getStore()?.origin ?? \"http://fallback.com\";\n\t} else if (typeof window !== \"undefined\") {\n\t\treturn window.location.origin;\n\t}\n\treturn \"http://fallback.com\";\n};\n\n/**\n * Overwrite the getUrlOrigin function.\n *\n * Use this function in server environments to\n * define how the URL origin is resolved.\n *\n * @param {() => string} fn - The new implementation for `getUrlOrigin()`.\n */\nexport let overwriteGetUrlOrigin = (fn) => {\n\tgetUrlOrigin = fn;\n};\n"]}

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

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

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

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

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

@@ -0,0 +1,18 @@
+import { test, expect } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+test("returns a placeholder in server environment as placeholder to make dependent apis work", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    expect(runtime.getUrlOrigin()).toBeDefined();
+});
+test("returns the window.location.origin if available", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    globalThis.window = { location: { origin: "https://example.com" } };
+    expect(runtime.getUrlOrigin()).toBe("https://example.com");
+});
+//# sourceMappingURL=get-url-origin.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-url-origin.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-url-origin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,IAAI,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;IACzG,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;IAClE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KACrB,CAAC,CAAC;IAEH,UAAU,CAAC,MAAM,GAAG,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAS,CAAC;IAE3E,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC","sourcesContent":["import { test, expect } from \"vitest\";\nimport { createParaglide } from \"../create-paraglide.js\";\n\ntest(\"returns a placeholder in server environment as placeholder to make dependent apis work\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t});\n\n\texpect(runtime.getUrlOrigin()).toBeDefined();\n});\n\ntest(\"returns the window.location.origin if available\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t});\n\n\tglobalThis.window = { location: { origin: \"https://example.com\" } } as any;\n\n\texpect(runtime.getUrlOrigin()).toBe(\"https://example.com\");\n});\n"]}

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

@@ -0,0 +1,28 @@
+export type HostRoutingRuleResolved = {
+    baseLocale: string;
+    locales: string[];
+};
+/**
+ * @typedef {{ baseLocale: string, locales: string[] }} HostRoutingRuleResolved
+ */
+/**
+ * @param {string} hostname
+ * @returns {HostRoutingRuleResolved}
+ */
+export declare function getRoutingRule(hostname: string): HostRoutingRuleResolved;
+/**
+ * @param {string | URL} url
+ * @returns {Locale}
+ */
+export declare function extractLocaleFromUrlHostRouting(url: string | URL): Locale;
+/**
+ * @param {string | URL} url
+ * @param {Locale} locale
+ * @returns {URL}
+ */
+export declare function localizeUrlHostRouting(url: string | URL, locale: Locale): URL;
+/**
+ * @param {string | URL} url
+ * @returns {URL}
+ */
+export declare function deLocalizeUrlHostRouting(url: string | URL): URL;

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-routing.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/host-routing.js"],"names":[],"mappings":"AAQG,YAAqD,uBAAuB,GAAlE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAyB;AAD/E;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAH5B,MAG4B,GAF1B,uBAAuB,CAUnC;AAkBD;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAHxC,MAAM,GAAG,GAG+B,GAFtC,MAAM,CAQlB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAJ/B,MAAM,GAAG,GAIsB,EAAE,MAAM,EAHvC,MAGuC,GAFrC,GAAG,CAqBf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAHjC,MAAM,GAAG,GAGwB,GAF/B,GAAG,CAcf"}