@sebbro/paraglide-lite 0.1.0

package/dist/compiler/runtime/generate-static-localized-urls.test.js

@@ -0,0 +1,159 @@
+import { test, expect } from "vitest";
+import { createParaglide } from "../create-paraglide.js";
+test("generates localized URLs using default URL pattern", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        strategy: ["url"],
+        // undefined creates the default pattern
+        urlPatterns: undefined,
+    });
+    const urls = runtime.generateStaticLocalizedUrls([
+        "http://example.com/about",
+        "http://example.com/blog/post-1",
+        "http://example.com/contact",
+    ]);
+    const pathnames = urls.map((url) => url.pathname).sort();
+    expect(pathnames).toEqual([
+        "/about",
+        "/blog/post-1",
+        "/contact",
+        "/de/about",
+        "/de/blog/post-1",
+        "/de/contact",
+        "/fr/about",
+        "/fr/blog/post-1",
+        "/fr/contact",
+    ]);
+    // All URLs should be URL objects
+    expect(urls.every((url) => url instanceof URL)).toBe(true);
+});
+test("generates localized URLs using custom URL patterns", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+        urlPatterns: [
+            {
+                pattern: "/store/item/:id",
+                localized: [
+                    ["en", "/store/item/:id"],
+                    ["de", "/laden/artikel/:id"],
+                ],
+            },
+            {
+                pattern: "/blog/:slug",
+                localized: [
+                    ["en", "/blog/:slug"],
+                    ["de", "/blog/:slug"], // Same pattern for both locales
+                ],
+            },
+        ],
+    });
+    const urls = runtime.generateStaticLocalizedUrls([
+        "https://example.com/store/item/123",
+        "https://example.com/store/item/456",
+        "https://example.com/blog/my-post",
+    ]);
+    const pathnames = urls.map((url) => url.pathname).sort();
+    expect(pathnames).toEqual([
+        "/blog/my-post",
+        "/laden/artikel/123",
+        "/laden/artikel/456",
+        "/store/item/123",
+        "/store/item/456",
+    ]);
+    // All URLs should be URL objects
+    expect(urls.every((url) => url instanceof URL)).toBe(true);
+});
+test("handles paths that don't match any pattern by including them", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+        urlPatterns: [
+            {
+                pattern: "https://example.com/store/:path*",
+                localized: [
+                    ["en", "https://example.com/store/:path*"],
+                    ["de", "https://example.com/laden/:path*"],
+                ],
+            },
+        ],
+    });
+    const urls = runtime.generateStaticLocalizedUrls([
+        "https://example.com/store/item/123", // Should match pattern
+        "https://example.com/about", // Should not match pattern
+        "https://example.com/contact", // Should not match pattern
+    ]);
+    const pathnames = urls.map((url) => url.pathname).sort();
+    expect(pathnames).toEqual([
+        "/about",
+        "/contact",
+        "/laden/item/123",
+        "/store/item/123",
+    ]);
+    // All URLs should be URL objects
+    expect(urls.every((url) => url instanceof URL)).toBe(true);
+});
+test("handles URL objects as input", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+        strategy: ["url"],
+        urlPatterns: [
+            {
+                pattern: "/store/:path*",
+                localized: [
+                    ["en", "/store/:path*"],
+                    ["de", "/laden/:path*"],
+                ],
+            },
+        ],
+    });
+    const urls = runtime.generateStaticLocalizedUrls([
+        new URL("https://example.com/store/item/123?color=blue#reviews"),
+        new URL("https://example.com/store/cart"),
+        new URL("https://example.com/about"), // Should not match pattern
+    ]);
+    const pathnames = urls.map((url) => url.pathname).sort();
+    expect(pathnames).toEqual([
+        "/about",
+        "/laden/cart",
+        "/laden/item/123",
+        "/store/cart",
+        "/store/item/123",
+    ]);
+    // Verify search params and hash fragments are preserve
+    // All URLs should be URL objects
+    expect(urls.every((url) => url instanceof URL)).toBe(true);
+});
+test("generates localized URLs from paths", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        strategy: ["url"],
+        // undefined creates the default pattern
+        urlPatterns: undefined,
+    });
+    const urls = runtime.generateStaticLocalizedUrls([
+        "/about",
+        "/blog/post-1",
+        "/contact",
+    ]);
+    const pathnames = urls.map((url) => url.pathname).sort();
+    expect(pathnames).toEqual([
+        "/about",
+        "/blog/post-1",
+        "/contact",
+        "/de/about",
+        "/de/blog/post-1",
+        "/de/contact",
+        "/fr/about",
+        "/fr/blog/post-1",
+        "/fr/contact",
+    ]);
+    // All URLs should be URL objects
+    expect(urls.every((url) => url instanceof URL)).toBe(true);
+});
+//# sourceMappingURL=generate-static-localized-urls.test.js.map

package/dist/compiler/runtime/generate-static-localized-urls.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-static-localized-urls.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/generate-static-localized-urls.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,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACrE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAC3B,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,wCAAwC;QACxC,WAAW,EAAE,SAAS;KACtB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;QAChD,0BAA0B;QAC1B,gCAAgC;QAChC,4BAA4B;KAC5B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACzB,QAAQ;QACR,cAAc;QACd,UAAU;QACV,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,WAAW;QACX,iBAAiB;QACjB,aAAa;KACb,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACrE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,WAAW,EAAE;YACZ;gBACC,OAAO,EAAE,iBAAiB;gBAC1B,SAAS,EAAE;oBACV,CAAC,IAAI,EAAE,iBAAiB,CAAC;oBACzB,CAAC,IAAI,EAAE,oBAAoB,CAAC;iBAC5B;aACD;YACD;gBACC,OAAO,EAAE,aAAa;gBACtB,SAAS,EAAE;oBACV,CAAC,IAAI,EAAE,aAAa,CAAC;oBACrB,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,gCAAgC;iBACvD;aACD;SACD;KACD,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;QAChD,oCAAoC;QACpC,oCAAoC;QACpC,kCAAkC;KAClC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACzB,eAAe;QACf,oBAAoB;QACpB,oBAAoB;QACpB,iBAAiB;QACjB,iBAAiB;KACjB,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;IAC/E,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,WAAW,EAAE;YACZ;gBACC,OAAO,EAAE,kCAAkC;gBAC3C,SAAS,EAAE;oBACV,CAAC,IAAI,EAAE,kCAAkC,CAAC;oBAC1C,CAAC,IAAI,EAAE,kCAAkC,CAAC;iBAC1C;aACD;SACD;KACD,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;QAChD,oCAAoC,EAAE,uBAAuB;QAC7D,2BAA2B,EAAE,2BAA2B;QACxD,6BAA6B,EAAE,2BAA2B;KAC1D,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACzB,QAAQ;QACR,UAAU;QACV,iBAAiB;QACjB,iBAAiB;KACjB,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;IAC/C,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,WAAW,EAAE;YACZ;gBACC,OAAO,EAAE,eAAe;gBACxB,SAAS,EAAE;oBACV,CAAC,IAAI,EAAE,eAAe,CAAC;oBACvB,CAAC,IAAI,EAAE,eAAe,CAAC;iBACvB;aACD;SACD;KACD,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;QAChD,IAAI,GAAG,CAAC,uDAAuD,CAAC;QAChE,IAAI,GAAG,CAAC,gCAAgC,CAAC;QACzC,IAAI,GAAG,CAAC,2BAA2B,CAAC,EAAE,2BAA2B;KACjE,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACzB,QAAQ;QACR,aAAa;QACb,iBAAiB;QACjB,aAAa;QACb,iBAAiB;KACjB,CAAC,CAAC;IAEH,uDAAuD;IACvD,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;IACtD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QAC3B,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,wCAAwC;QACxC,WAAW,EAAE,SAAS;KACtB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;QAChD,QAAQ;QACR,cAAc;QACd,UAAU;KACV,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzD,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;QACzB,QAAQ;QACR,cAAc;QACd,UAAU;QACV,WAAW;QACX,iBAAiB;QACjB,aAAa;QACb,WAAW;QACX,iBAAiB;QACjB,aAAa;KACb,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC","sourcesContent":["import { test, expect } from \"vitest\";\nimport { createParaglide } from \"../create-paraglide.js\";\n\ntest(\"generates localized URLs using default URL pattern\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\tstrategy: [\"url\"],\n\t\t// undefined creates the default pattern\n\t\turlPatterns: undefined,\n\t});\n\n\tconst urls = runtime.generateStaticLocalizedUrls([\n\t\t\"http://example.com/about\",\n\t\t\"http://example.com/blog/post-1\",\n\t\t\"http://example.com/contact\",\n\t]);\n\tconst pathnames = urls.map((url) => url.pathname).sort();\n\n\texpect(pathnames).toEqual([\n\t\t\"/about\",\n\t\t\"/blog/post-1\",\n\t\t\"/contact\",\n\t\t\"/de/about\",\n\t\t\"/de/blog/post-1\",\n\t\t\"/de/contact\",\n\t\t\"/fr/about\",\n\t\t\"/fr/blog/post-1\",\n\t\t\"/fr/contact\",\n\t]);\n\n\t// All URLs should be URL objects\n\texpect(urls.every((url) => url instanceof URL)).toBe(true);\n});\n\ntest(\"generates localized URLs using custom URL patterns\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"url\"],\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"/store/item/:id\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"/store/item/:id\"],\n\t\t\t\t\t[\"de\", \"/laden/artikel/:id\"],\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tpattern: \"/blog/:slug\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"/blog/:slug\"],\n\t\t\t\t\t[\"de\", \"/blog/:slug\"], // Same pattern for both locales\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\tconst urls = runtime.generateStaticLocalizedUrls([\n\t\t\"https://example.com/store/item/123\",\n\t\t\"https://example.com/store/item/456\",\n\t\t\"https://example.com/blog/my-post\",\n\t]);\n\n\tconst pathnames = urls.map((url) => url.pathname).sort();\n\n\texpect(pathnames).toEqual([\n\t\t\"/blog/my-post\",\n\t\t\"/laden/artikel/123\",\n\t\t\"/laden/artikel/456\",\n\t\t\"/store/item/123\",\n\t\t\"/store/item/456\",\n\t]);\n\n\t// All URLs should be URL objects\n\texpect(urls.every((url) => url instanceof URL)).toBe(true);\n});\n\ntest(\"handles paths that don't match any pattern by including them\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"url\"],\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"https://example.com/store/:path*\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"https://example.com/store/:path*\"],\n\t\t\t\t\t[\"de\", \"https://example.com/laden/:path*\"],\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\tconst urls = runtime.generateStaticLocalizedUrls([\n\t\t\"https://example.com/store/item/123\", // Should match pattern\n\t\t\"https://example.com/about\", // Should not match pattern\n\t\t\"https://example.com/contact\", // Should not match pattern\n\t]);\n\n\tconst pathnames = urls.map((url) => url.pathname).sort();\n\n\texpect(pathnames).toEqual([\n\t\t\"/about\",\n\t\t\"/contact\",\n\t\t\"/laden/item/123\",\n\t\t\"/store/item/123\",\n\t]);\n\n\t// All URLs should be URL objects\n\texpect(urls.every((url) => url instanceof URL)).toBe(true);\n});\n\ntest(\"handles URL objects as input\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t\tstrategy: [\"url\"],\n\t\turlPatterns: [\n\t\t\t{\n\t\t\t\tpattern: \"/store/:path*\",\n\t\t\t\tlocalized: [\n\t\t\t\t\t[\"en\", \"/store/:path*\"],\n\t\t\t\t\t[\"de\", \"/laden/:path*\"],\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t});\n\n\tconst urls = runtime.generateStaticLocalizedUrls([\n\t\tnew URL(\"https://example.com/store/item/123?color=blue#reviews\"),\n\t\tnew URL(\"https://example.com/store/cart\"),\n\t\tnew URL(\"https://example.com/about\"), // Should not match pattern\n\t]);\n\n\tconst pathnames = urls.map((url) => url.pathname).sort();\n\n\texpect(pathnames).toEqual([\n\t\t\"/about\",\n\t\t\"/laden/cart\",\n\t\t\"/laden/item/123\",\n\t\t\"/store/cart\",\n\t\t\"/store/item/123\",\n\t]);\n\n\t// Verify search params and hash fragments are preserve\n\t// All URLs should be URL objects\n\texpect(urls.every((url) => url instanceof URL)).toBe(true);\n});\n\ntest(\"generates localized URLs from paths\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\tstrategy: [\"url\"],\n\t\t// undefined creates the default pattern\n\t\turlPatterns: undefined,\n\t});\n\n\tconst urls = runtime.generateStaticLocalizedUrls([\n\t\t\"/about\",\n\t\t\"/blog/post-1\",\n\t\t\"/contact\",\n\t]);\n\n\tconst pathnames = urls.map((url) => url.pathname).sort();\n\n\texpect(pathnames).toEqual([\n\t\t\"/about\",\n\t\t\"/blog/post-1\",\n\t\t\"/contact\",\n\t\t\"/de/about\",\n\t\t\"/de/blog/post-1\",\n\t\t\"/de/contact\",\n\t\t\"/fr/about\",\n\t\t\"/fr/blog/post-1\",\n\t\t\"/fr/contact\",\n\t]);\n\n\t// All URLs should be URL objects\n\texpect(urls.every((url) => url instanceof URL)).toBe(true);\n});\n"]}

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

@@ -0,0 +1,42 @@
+/**
+ * Get the current locale.
+ *
+ * The locale is resolved using your configured strategies (URL, cookie, localStorage, etc.)
+ * in the order they are defined. In SSR contexts, the locale is retrieved from AsyncLocalStorage
+ * which is set by the `paraglideMiddleware()`.
+ *
+ * @see https://paraglidejs.com/strategy - Configure locale detection strategies
+ *
+ * @example
+ *   if (getLocale() === 'de') {
+ *     console.log('Germany 🇩🇪');
+ *   } else if (getLocale() === 'nl') {
+ *     console.log('Netherlands 🇳🇱');
+ *   }
+ *
+ * @returns {Locale} The current locale.
+ */
+export declare let getLocale: () => Locale;
+/**
+ * Resolve locale for a given URL using route-aware strategies.
+ *
+ * @param {string | URL} url
+ * @returns {Locale}
+ */
+export declare function getLocaleForUrl(url: string | URL): Locale;
+/**
+ * Overwrite the `getLocale()` function.
+ *
+ * Use this function to overwrite how the locale is resolved. This is useful
+ * for custom locale resolution or advanced use cases like SSG with concurrent rendering.
+ *
+ * @see https://paraglidejs.com/strategy
+ *
+ * @example
+ *   overwriteGetLocale(() => {
+ *     return Cookies.get('locale') ?? baseLocale
+ *   });
+ *
+ * @param {() => Locale} fn - The new implementation for `getLocale()`.
+ */
+export declare const overwriteGetLocale: (fn: () => Locale) => void;

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-locale.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/get-locale.js"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,IAAI,SAAS,QAFP,MAsCZ,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAHxB,MAAM,GAAG,GAGe,GAFtB,MAAM,CAmBlB;AAiED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,OAFpB,MAAM,MAAM,SAItB,CAAC"}

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

@@ -0,0 +1,158 @@
+import { assertIsLocale, toLocale } from "./check-locale.js";
+import { extractLocaleFromCookie } from "./extract-locale-from-cookie.js";
+import { extractLocaleFromNavigator } from "./extract-locale-from-navigator.js";
+import { extractLocaleFromUrl } from "./extract-locale-from-url.js";
+import { getStrategyForUrl } from "./route-strategy.js";
+import { setLocale } from "./set-locale.js";
+import { customClientStrategies, isCustomStrategy } from "./strategy.js";
+import { baseLocale, isServer, localStorageKey, serverAsyncLocalStorage, experimentalStaticLocale, strategy, TREE_SHAKE_COOKIE_STRATEGY_USED, TREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED, TREE_SHAKE_LOCAL_STORAGE_STRATEGY_USED, TREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED, TREE_SHAKE_URL_STRATEGY_USED, } from "./variables.js";
+/**
+ * This is a fallback to get started with a custom
+ * strategy and avoid type errors.
+ *
+ * The implementation is overwritten
+ * by `overwriteGetLocale()` and `defineSetLocale()`.
+ *
+ * @type {Locale | undefined}
+ */
+let _locale;
+let localeInitiallySet = false;
+/**
+ * Get the current locale.
+ *
+ * The locale is resolved using your configured strategies (URL, cookie, localStorage, etc.)
+ * in the order they are defined. In SSR contexts, the locale is retrieved from AsyncLocalStorage
+ * which is set by the `paraglideMiddleware()`.
+ *
+ * @see https://paraglidejs.com/strategy - Configure locale detection strategies
+ *
+ * @example
+ *   if (getLocale() === 'de') {
+ *     console.log('Germany 🇩🇪');
+ *   } else if (getLocale() === 'nl') {
+ *     console.log('Netherlands 🇳🇱');
+ *   }
+ *
+ * @returns {Locale} The current locale.
+ */
+export let getLocale = () => {
+    if (experimentalStaticLocale !== undefined) {
+        return experimentalStaticLocale;
+    }
+    // if running in a server-side rendering context
+    // retrieve the locale from the async local storage
+    if (serverAsyncLocalStorage) {
+        const locale = serverAsyncLocalStorage?.getStore()?.locale;
+        if (locale) {
+            return locale;
+        }
+    }
+    let strategyToUse = strategy;
+    if (!isServer && typeof window !== "undefined" && window.location?.href) {
+        strategyToUse = getStrategyForUrl(window.location.href);
+    }
+    const resolved = resolveLocaleWithStrategies(strategyToUse, typeof window !== "undefined" ? window.location?.href : undefined);
+    if (resolved) {
+        if (!localeInitiallySet) {
+            _locale = resolved;
+            // https://github.com/opral/inlang-paraglide-js/issues/455
+            localeInitiallySet = true;
+            setLocale(resolved, { reload: false });
+        }
+        return resolved;
+    }
+    throw new Error("No locale found. Read the docs https://paraglidejs.com/errors#no-locale-found");
+};
+/**
+ * Resolve locale for a given URL using route-aware strategies.
+ *
+ * @param {string | URL} url
+ * @returns {Locale}
+ */
+export function getLocaleForUrl(url) {
+    if (experimentalStaticLocale !== undefined) {
+        return experimentalStaticLocale;
+    }
+    const strategyToUse = getStrategyForUrl(url);
+    const resolved = resolveLocaleWithStrategies(strategyToUse, typeof url === "string" ? url : url.href);
+    if (resolved) {
+        return resolved;
+    }
+    throw new Error("No locale found. Read the docs https://paraglidejs.com/errors#no-locale-found");
+}
+/**
+ * @param {typeof strategy} strategyToUse
+ * @param {string | undefined} urlForUrlStrategy
+ * @returns {Locale | undefined}
+ */
+function resolveLocaleWithStrategies(strategyToUse, urlForUrlStrategy) {
+    /** @type {string | undefined} */
+    let locale;
+    for (const strat of strategyToUse) {
+        if (TREE_SHAKE_COOKIE_STRATEGY_USED && strat === "cookie") {
+            locale = extractLocaleFromCookie();
+        }
+        else if (strat === "baseLocale") {
+            locale = baseLocale;
+        }
+        else if (TREE_SHAKE_URL_STRATEGY_USED &&
+            strat === "url" &&
+            !isServer &&
+            typeof urlForUrlStrategy === "string") {
+            locale = extractLocaleFromUrl(urlForUrlStrategy);
+        }
+        else if (TREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED &&
+            strat === "globalVariable" &&
+            _locale !== undefined) {
+            locale = _locale;
+        }
+        else if (TREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED &&
+            strat === "preferredLanguage" &&
+            !isServer) {
+            locale = extractLocaleFromNavigator();
+        }
+        else if (TREE_SHAKE_LOCAL_STORAGE_STRATEGY_USED &&
+            strat === "localStorage" &&
+            !isServer) {
+            locale = localStorage.getItem(localStorageKey) ?? undefined;
+        }
+        else if (isCustomStrategy(strat) && customClientStrategies.has(strat)) {
+            const handler = customClientStrategies.get(strat);
+            if (handler) {
+                const result = handler.getLocale();
+                // Handle both sync and async results - skip async in sync getLocale
+                if (result instanceof Promise) {
+                    // Can't await in sync function, skip async strategies
+                    continue;
+                }
+                if (result !== undefined) {
+                    return assertIsLocale(result);
+                }
+            }
+        }
+        const matchedLocale = toLocale(locale);
+        if (matchedLocale) {
+            return matchedLocale;
+        }
+    }
+    return undefined;
+}
+/**
+ * Overwrite the `getLocale()` function.
+ *
+ * Use this function to overwrite how the locale is resolved. This is useful
+ * for custom locale resolution or advanced use cases like SSG with concurrent rendering.
+ *
+ * @see https://paraglidejs.com/strategy
+ *
+ * @example
+ *   overwriteGetLocale(() => {
+ *     return Cookies.get('locale') ?? baseLocale
+ *   });
+ *
+ * @param {() => Locale} fn - The new implementation for `getLocale()`.
+ */
+export const overwriteGetLocale = (fn) => {
+    getLocale = fn;
+};
+//# sourceMappingURL=get-locale.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-locale.js","sourceRoot":"","sources":["../../../src/compiler/runtime/get-locale.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACN,UAAU,EACV,QAAQ,EACR,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,QAAQ,EACR,+BAA+B,EAC/B,wCAAwC,EACxC,sCAAsC,EACtC,2CAA2C,EAC3C,4BAA4B,GAC5B,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;GAQG;AACH,IAAI,OAAO,CAAC;AAEZ,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,IAAI,SAAS,GAAG,GAAG,EAAE;IAC3B,IAAI,wBAAwB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,wBAAwB,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,mDAAmD;IACnD,IAAI,uBAAuB,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,uBAAuB,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC;QAC3D,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO,MAAM,CAAC;QACf,CAAC;IACF,CAAC;IAED,IAAI,aAAa,GAAG,QAAQ,CAAC;IAC7B,IAAI,CAAC,QAAQ,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzE,aAAa,GAAG,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,2BAA2B,CAC3C,aAAa,EACb,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CACjE,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACzB,OAAO,GAAG,QAAQ,CAAC;YACnB,0DAA0D;YAC1D,kBAAkB,GAAG,IAAI,CAAC;YAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,KAAK,CACd,+EAA+E,CAC/E,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAG;IAClC,IAAI,wBAAwB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,wBAAwB,CAAC;IACjC,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,2BAA2B,CAC3C,aAAa,EACb,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CACxC,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,KAAK,CACd,+EAA+E,CAC/E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B,CAAC,aAAa,EAAE,iBAAiB;IACpE,iCAAiC;IACjC,IAAI,MAAM,CAAC;IAEX,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,+BAA+B,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,GAAG,uBAAuB,EAAE,CAAC;QACpC,CAAC;aAAM,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YACnC,MAAM,GAAG,UAAU,CAAC;QACrB,CAAC;aAAM,IACN,4BAA4B;YAC5B,KAAK,KAAK,KAAK;YACf,CAAC,QAAQ;YACT,OAAO,iBAAiB,KAAK,QAAQ,EACpC,CAAC;YACF,MAAM,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QAClD,CAAC;aAAM,IACN,wCAAwC;YACxC,KAAK,KAAK,gBAAgB;YAC1B,OAAO,KAAK,SAAS,EACpB,CAAC;YACF,MAAM,GAAG,OAAO,CAAC;QAClB,CAAC;aAAM,IACN,2CAA2C;YAC3C,KAAK,KAAK,mBAAmB;YAC7B,CAAC,QAAQ,EACR,CAAC;YACF,MAAM,GAAG,0BAA0B,EAAE,CAAC;QACvC,CAAC;aAAM,IACN,sCAAsC;YACtC,KAAK,KAAK,cAAc;YACxB,CAAC,QAAQ,EACR,CAAC;YACF,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC;QAC7D,CAAC;aAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,OAAO,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBACnC,oEAAoE;gBACpE,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC/B,sDAAsD;oBACtD,SAAS;gBACV,CAAC;gBACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;QACF,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,aAAa,EAAE,CAAC;YACnB,OAAO,aAAa,CAAC;QACtB,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAE,EAAE,EAAE;IACxC,SAAS,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC","sourcesContent":["import { assertIsLocale, toLocale } from \"./check-locale.js\";\nimport { extractLocaleFromCookie } from \"./extract-locale-from-cookie.js\";\nimport { extractLocaleFromNavigator } from \"./extract-locale-from-navigator.js\";\nimport { extractLocaleFromUrl } from \"./extract-locale-from-url.js\";\nimport { getStrategyForUrl } from \"./route-strategy.js\";\nimport { setLocale } from \"./set-locale.js\";\nimport { customClientStrategies, isCustomStrategy } from \"./strategy.js\";\nimport {\n\tbaseLocale,\n\tisServer,\n\tlocalStorageKey,\n\tserverAsyncLocalStorage,\n\texperimentalStaticLocale,\n\tstrategy,\n\tTREE_SHAKE_COOKIE_STRATEGY_USED,\n\tTREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED,\n\tTREE_SHAKE_LOCAL_STORAGE_STRATEGY_USED,\n\tTREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED,\n\tTREE_SHAKE_URL_STRATEGY_USED,\n} from \"./variables.js\";\n\n/**\n * This is a fallback to get started with a custom\n * strategy and avoid type errors.\n *\n * The implementation is overwritten\n * by `overwriteGetLocale()` and `defineSetLocale()`.\n *\n * @type {Locale | undefined}\n */\nlet _locale;\n\nlet localeInitiallySet = false;\n\n/**\n * Get the current locale.\n *\n * The locale is resolved using your configured strategies (URL, cookie, localStorage, etc.)\n * in the order they are defined. In SSR contexts, the locale is retrieved from AsyncLocalStorage\n * which is set by the `paraglideMiddleware()`.\n *\n * @see https://paraglidejs.com/strategy - Configure locale detection strategies\n *\n * @example\n *   if (getLocale() === 'de') {\n *     console.log('Germany 🇩🇪');\n *   } else if (getLocale() === 'nl') {\n *     console.log('Netherlands 🇳🇱');\n *   }\n *\n * @returns {Locale} The current locale.\n */\nexport let getLocale = () => {\n\tif (experimentalStaticLocale !== undefined) {\n\t\treturn experimentalStaticLocale;\n\t}\n\n\t// if running in a server-side rendering context\n\t// retrieve the locale from the async local storage\n\tif (serverAsyncLocalStorage) {\n\t\tconst locale = serverAsyncLocalStorage?.getStore()?.locale;\n\t\tif (locale) {\n\t\t\treturn locale;\n\t\t}\n\t}\n\n\tlet strategyToUse = strategy;\n\tif (!isServer && typeof window !== \"undefined\" && window.location?.href) {\n\t\tstrategyToUse = getStrategyForUrl(window.location.href);\n\t}\n\n\tconst resolved = resolveLocaleWithStrategies(\n\t\tstrategyToUse,\n\t\ttypeof window !== \"undefined\" ? window.location?.href : undefined\n\t);\n\tif (resolved) {\n\t\tif (!localeInitiallySet) {\n\t\t\t_locale = resolved;\n\t\t\t// https://github.com/opral/inlang-paraglide-js/issues/455\n\t\t\tlocaleInitiallySet = true;\n\t\t\tsetLocale(resolved, { reload: false });\n\t\t}\n\t\treturn resolved;\n\t}\n\n\tthrow new Error(\n\t\t\"No locale found. Read the docs https://paraglidejs.com/errors#no-locale-found\"\n\t);\n};\n\n/**\n * Resolve locale for a given URL using route-aware strategies.\n *\n * @param {string | URL} url\n * @returns {Locale}\n */\nexport function getLocaleForUrl(url) {\n\tif (experimentalStaticLocale !== undefined) {\n\t\treturn experimentalStaticLocale;\n\t}\n\n\tconst strategyToUse = getStrategyForUrl(url);\n\tconst resolved = resolveLocaleWithStrategies(\n\t\tstrategyToUse,\n\t\ttypeof url === \"string\" ? url : url.href\n\t);\n\tif (resolved) {\n\t\treturn resolved;\n\t}\n\n\tthrow new Error(\n\t\t\"No locale found. Read the docs https://paraglidejs.com/errors#no-locale-found\"\n\t);\n}\n\n/**\n * @param {typeof strategy} strategyToUse\n * @param {string | undefined} urlForUrlStrategy\n * @returns {Locale | undefined}\n */\nfunction resolveLocaleWithStrategies(strategyToUse, urlForUrlStrategy) {\n\t/** @type {string | undefined} */\n\tlet locale;\n\n\tfor (const strat of strategyToUse) {\n\t\tif (TREE_SHAKE_COOKIE_STRATEGY_USED && strat === \"cookie\") {\n\t\t\tlocale = extractLocaleFromCookie();\n\t\t} else if (strat === \"baseLocale\") {\n\t\t\tlocale = baseLocale;\n\t\t} else if (\n\t\t\tTREE_SHAKE_URL_STRATEGY_USED &&\n\t\t\tstrat === \"url\" &&\n\t\t\t!isServer &&\n\t\t\ttypeof urlForUrlStrategy === \"string\"\n\t\t) {\n\t\t\tlocale = extractLocaleFromUrl(urlForUrlStrategy);\n\t\t} else if (\n\t\t\tTREE_SHAKE_GLOBAL_VARIABLE_STRATEGY_USED &&\n\t\t\tstrat === \"globalVariable\" &&\n\t\t\t_locale !== undefined\n\t\t) {\n\t\t\tlocale = _locale;\n\t\t} else if (\n\t\t\tTREE_SHAKE_PREFERRED_LANGUAGE_STRATEGY_USED &&\n\t\t\tstrat === \"preferredLanguage\" &&\n\t\t\t!isServer\n\t\t) {\n\t\t\tlocale = extractLocaleFromNavigator();\n\t\t} else if (\n\t\t\tTREE_SHAKE_LOCAL_STORAGE_STRATEGY_USED &&\n\t\t\tstrat === \"localStorage\" &&\n\t\t\t!isServer\n\t\t) {\n\t\t\tlocale = localStorage.getItem(localStorageKey) ?? undefined;\n\t\t} else if (isCustomStrategy(strat) && customClientStrategies.has(strat)) {\n\t\t\tconst handler = customClientStrategies.get(strat);\n\t\t\tif (handler) {\n\t\t\t\tconst result = handler.getLocale();\n\t\t\t\t// Handle both sync and async results - skip async in sync getLocale\n\t\t\t\tif (result instanceof Promise) {\n\t\t\t\t\t// Can't await in sync function, skip async strategies\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (result !== undefined) {\n\t\t\t\t\treturn assertIsLocale(result);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tconst matchedLocale = toLocale(locale);\n\t\tif (matchedLocale) {\n\t\t\treturn matchedLocale;\n\t\t}\n\t}\n\n\treturn undefined;\n}\n\n/**\n * Overwrite the `getLocale()` function.\n *\n * Use this function to overwrite how the locale is resolved. This is useful\n * for custom locale resolution or advanced use cases like SSG with concurrent rendering.\n *\n * @see https://paraglidejs.com/strategy\n *\n * @example\n *   overwriteGetLocale(() => {\n *     return Cookies.get('locale') ?? baseLocale\n *   });\n *\n * @param {() => Locale} fn - The new implementation for `getLocale()`.\n */\nexport const overwriteGetLocale = (fn) => {\n\tgetLocale = fn;\n};\n"]}

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

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

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

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