@lingo.dev/react-next 0.0.0

package/dist/chunk.cjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/lingo-head.cjs

@@ -0,0 +1,84 @@
+const require_chunk = require("./chunk.cjs");
+let _lingo_dev_react = require("@lingo.dev/react");
+let next_router = require("next/router");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let next_head = require("next/head");
+next_head = require_chunk.__toESM(next_head);
+//#region src/pages/with-lingo-app.tsx
+/**
+* HOC for _app.tsx. Wraps the app in LingoProvider and handles RTL direction.
+*
+* - SSR: injects a blocking <script> to set dir="rtl" before hydration (no flash)
+* - CSR: useEffect keeps dir in sync on locale change
+* - Dev mode: warns when a page is missing withLingoProps
+*/
+function withLingoApp(App) {
+	function LingoApp(props) {
+		const { locale, defaultLocale } = (0, next_router.useRouter)();
+		const resolvedLocale = locale ?? defaultLocale ?? "en";
+		const messages = props.pageProps?.__lingoMessages ?? {};
+		const { direction } = (0, _lingo_dev_react.createLingo)(resolvedLocale);
+		(0, react.useEffect)(() => {
+			document.documentElement.dir = direction;
+		}, [direction]);
+		if (process.env.NODE_ENV === "development" && !props.pageProps?.__lingoMessages) console.warn("[@lingo.dev/react-next] No __lingoMessages in pageProps. Add withLingoProps({ route: '...' }) to this page.");
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [direction === "rtl" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("script", { dangerouslySetInnerHTML: { __html: `document.documentElement.dir="rtl"` } }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_lingo_dev_react.LingoProvider, {
+			locale: resolvedLocale,
+			messages,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(App, { ...props })
+		})] });
+	}
+	LingoApp.displayName = `withLingoApp(${App.displayName || App.name || "App"})`;
+	return LingoApp;
+}
+//#endregion
+//#region src/pages/use-locale-switch.ts
+/**
+* Hook for locale switching. Sets NEXT_LOCALE cookie + navigates via router.
+*/
+function useLocaleSwitch() {
+	const router = (0, next_router.useRouter)();
+	return (0, react.useCallback)((locale) => {
+		document.cookie = `NEXT_LOCALE=${locale}; path=/; max-age=31536000; SameSite=Lax`;
+		router.push(router.asPath, router.asPath, { locale });
+	}, [router]);
+}
+//#endregion
+//#region src/pages/lingo-head.tsx
+/**
+* Generates <link rel="alternate" hreflang="..."> tags for SEO.
+* Auto-derives all locale variants from Next.js router config.
+*/
+function LingoHead({ baseUrl = "" }) {
+	const { locales, defaultLocale, asPath } = (0, next_router.useRouter)();
+	if (!locales) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(next_head.default, { children: [locales.map((l) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
+		rel: "alternate",
+		hrefLang: l,
+		href: `${baseUrl}${l === defaultLocale ? "" : `/${l}`}${asPath}`
+	}, l)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
+		rel: "alternate",
+		hrefLang: "x-default",
+		href: `${baseUrl}${asPath}`
+	})] });
+}
+//#endregion
+Object.defineProperty(exports, "LingoHead", {
+	enumerable: true,
+	get: function() {
+		return LingoHead;
+	}
+});
+Object.defineProperty(exports, "useLocaleSwitch", {
+	enumerable: true,
+	get: function() {
+		return useLocaleSwitch;
+	}
+});
+Object.defineProperty(exports, "withLingoApp", {
+	enumerable: true,
+	get: function() {
+		return withLingoApp;
+	}
+});

package/dist/lingo-head.d.cts

@@ -0,0 +1,34 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { ComponentType } from "react";
+import { AppProps } from "next/app";
+
+//#region src/pages/with-lingo-app.d.ts
+
+declare function withLingoApp<P extends AppProps>(App: ComponentType<P>): {
+  (props: P): react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+//# sourceMappingURL=with-lingo-app.d.ts.map
+//#endregion
+//#region src/pages/use-locale-switch.d.ts
+/**
+ * Hook for locale switching. Sets NEXT_LOCALE cookie + navigates via router.
+ */
+declare function useLocaleSwitch(): (locale: string) => void;
+//# sourceMappingURL=use-locale-switch.d.ts.map
+//#endregion
+//#region src/pages/lingo-head.d.ts
+/**
+ * Generates <link rel="alternate" hreflang="..."> tags for SEO.
+ * Auto-derives all locale variants from Next.js router config.
+ */
+type LingoHeadProps = {
+  /** Base URL for absolute hreflang hrefs (e.g., "https://example.com"). Recommended for production. */
+  baseUrl?: string;
+};
+declare function LingoHead({
+  baseUrl
+}: LingoHeadProps): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { useLocaleSwitch as n, withLingoApp as r, LingoHead as t };
+//# sourceMappingURL=lingo-head.d.cts.map

package/dist/lingo-head.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lingo-head.d.cts","names":[],"sources":["../src/pages/with-lingo-app.tsx","../src/pages/use-locale-switch.ts","../src/pages/lingo-head.tsx"],"sourcesContent":[],"mappings":";;;;;;AAasD,iBAAtC,YAAsC,CAAA,UAAf,QAAe,CAAA,CAAA,GAAA,EAAA,aAAA,CAAc,CAAd,CAAA,CAAA,EAAA;QAC3B,EAAA,CAAA,CAAA,EAAC,kBAAA,CAAA,GAAA,CAAA,OAAD;aAAC,EAAA,MAAA;CAAA;;;;;;;iBCPZ,eAAA,CAAA;;;;;;;;KCCX,cAAA;EFKW;EAAY,OAAA,CAAA,EAAA,MAAA;;AAAwC,iBEApD,SAAA,CFAoD;EAAA;AAAA,CAAA,EEAxB,cFAwB,CAAA,EEAV,kBAAA,CAAA,GAAA,CAAA,OAAA,GFAU,IAAA"}

package/dist/lingo-head.d.ts

@@ -0,0 +1,34 @@
+import { ComponentType } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { AppProps } from "next/app";
+
+//#region src/pages/with-lingo-app.d.ts
+
+declare function withLingoApp<P extends AppProps>(App: ComponentType<P>): {
+  (props: P): react_jsx_runtime0.JSX.Element;
+  displayName: string;
+};
+//# sourceMappingURL=with-lingo-app.d.ts.map
+//#endregion
+//#region src/pages/use-locale-switch.d.ts
+/**
+ * Hook for locale switching. Sets NEXT_LOCALE cookie + navigates via router.
+ */
+declare function useLocaleSwitch(): (locale: string) => void;
+//# sourceMappingURL=use-locale-switch.d.ts.map
+//#endregion
+//#region src/pages/lingo-head.d.ts
+/**
+ * Generates <link rel="alternate" hreflang="..."> tags for SEO.
+ * Auto-derives all locale variants from Next.js router config.
+ */
+type LingoHeadProps = {
+  /** Base URL for absolute hreflang hrefs (e.g., "https://example.com"). Recommended for production. */
+  baseUrl?: string;
+};
+declare function LingoHead({
+  baseUrl
+}: LingoHeadProps): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { useLocaleSwitch as n, withLingoApp as r, LingoHead as t };
+//# sourceMappingURL=lingo-head.d.ts.map

package/dist/lingo-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lingo-head.d.ts","names":[],"sources":["../src/pages/with-lingo-app.tsx","../src/pages/use-locale-switch.ts","../src/pages/lingo-head.tsx"],"sourcesContent":[],"mappings":";;;;;;AAasD,iBAAtC,YAAsC,CAAA,UAAf,QAAe,CAAA,CAAA,GAAA,EAAA,aAAA,CAAc,CAAd,CAAA,CAAA,EAAA;QAC3B,EAAA,CAAA,CAAA,EAAC,kBAAA,CAAA,GAAA,CAAA,OAAD;aAAC,EAAA,MAAA;CAAA;;;;;;;iBCPZ,eAAA,CAAA;;;;;;;;KCCX,cAAA;EFKW;EAAY,OAAA,CAAA,EAAA,MAAA;;AAAwC,iBEApD,SAAA,CFAoD;EAAA;AAAA,CAAA,EEAxB,cFAwB,CAAA,EEAV,kBAAA,CAAA,GAAA,CAAA,OAAA,GFAU,IAAA"}

package/dist/lingo-head.js

@@ -0,0 +1,67 @@
+import { LingoProvider, createLingo } from "@lingo.dev/react";
+import { useRouter } from "next/router";
+import { useCallback, useEffect } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import Head from "next/head";
+//#region src/pages/with-lingo-app.tsx
+/**
+* HOC for _app.tsx. Wraps the app in LingoProvider and handles RTL direction.
+*
+* - SSR: injects a blocking <script> to set dir="rtl" before hydration (no flash)
+* - CSR: useEffect keeps dir in sync on locale change
+* - Dev mode: warns when a page is missing withLingoProps
+*/
+function withLingoApp(App) {
+	function LingoApp(props) {
+		const { locale, defaultLocale } = useRouter();
+		const resolvedLocale = locale ?? defaultLocale ?? "en";
+		const messages = props.pageProps?.__lingoMessages ?? {};
+		const { direction } = createLingo(resolvedLocale);
+		useEffect(() => {
+			document.documentElement.dir = direction;
+		}, [direction]);
+		if (process.env.NODE_ENV === "development" && !props.pageProps?.__lingoMessages) console.warn("[@lingo.dev/react-next] No __lingoMessages in pageProps. Add withLingoProps({ route: '...' }) to this page.");
+		return /* @__PURE__ */ jsxs(Fragment, { children: [direction === "rtl" && /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: `document.documentElement.dir="rtl"` } }), /* @__PURE__ */ jsx(LingoProvider, {
+			locale: resolvedLocale,
+			messages,
+			children: /* @__PURE__ */ jsx(App, { ...props })
+		})] });
+	}
+	LingoApp.displayName = `withLingoApp(${App.displayName || App.name || "App"})`;
+	return LingoApp;
+}
+//#endregion
+//#region src/pages/use-locale-switch.ts
+/**
+* Hook for locale switching. Sets NEXT_LOCALE cookie + navigates via router.
+*/
+function useLocaleSwitch() {
+	const router = useRouter();
+	return useCallback((locale) => {
+		document.cookie = `NEXT_LOCALE=${locale}; path=/; max-age=31536000; SameSite=Lax`;
+		router.push(router.asPath, router.asPath, { locale });
+	}, [router]);
+}
+//#endregion
+//#region src/pages/lingo-head.tsx
+/**
+* Generates <link rel="alternate" hreflang="..."> tags for SEO.
+* Auto-derives all locale variants from Next.js router config.
+*/
+function LingoHead({ baseUrl = "" }) {
+	const { locales, defaultLocale, asPath } = useRouter();
+	if (!locales) return null;
+	return /* @__PURE__ */ jsxs(Head, { children: [locales.map((l) => /* @__PURE__ */ jsx("link", {
+		rel: "alternate",
+		hrefLang: l,
+		href: `${baseUrl}${l === defaultLocale ? "" : `/${l}`}${asPath}`
+	}, l)), /* @__PURE__ */ jsx("link", {
+		rel: "alternate",
+		hrefLang: "x-default",
+		href: `${baseUrl}${asPath}`
+	})] });
+}
+//#endregion
+export { useLocaleSwitch as n, withLingoApp as r, LingoHead as t };
+
+//# sourceMappingURL=lingo-head.js.map

package/dist/lingo-head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lingo-head.js","names":[],"sources":["../src/pages/with-lingo-app.tsx","../src/pages/use-locale-switch.ts","../src/pages/lingo-head.tsx"],"sourcesContent":["/**\n * HOC for _app.tsx. Wraps the app in LingoProvider and handles RTL direction.\n *\n * - SSR: injects a blocking <script> to set dir=\"rtl\" before hydration (no flash)\n * - CSR: useEffect keeps dir in sync on locale change\n * - Dev mode: warns when a page is missing withLingoProps\n */\n\nimport { LingoProvider, createLingo } from \"@lingo.dev/react\";\nimport { useRouter } from \"next/router\";\nimport { useEffect, type ComponentType } from \"react\";\nimport type { AppProps } from \"next/app\";\n\nexport function withLingoApp<P extends AppProps>(App: ComponentType<P>) {\n  function LingoApp(props: P) {\n    const { locale, defaultLocale } = useRouter();\n    const resolvedLocale = locale ?? defaultLocale ?? \"en\";\n    const messages = props.pageProps?.__lingoMessages ?? {};\n    const { direction } = createLingo(resolvedLocale);\n\n    useEffect(() => {\n      document.documentElement.dir = direction;\n    }, [direction]);\n\n    if (process.env.NODE_ENV === \"development\" && !props.pageProps?.__lingoMessages) {\n      console.warn(\n        \"[@lingo.dev/react-next] No __lingoMessages in pageProps. Add withLingoProps({ route: '...' }) to this page.\",\n      );\n    }\n\n    return (\n      <>\n        {direction === \"rtl\" && <script dangerouslySetInnerHTML={{ __html: `document.documentElement.dir=\"rtl\"` }} />}\n        <LingoProvider locale={resolvedLocale} messages={messages}>\n          <App {...props} />\n        </LingoProvider>\n      </>\n    );\n  }\n\n  LingoApp.displayName = `withLingoApp(${App.displayName || App.name || \"App\"})`;\n  return LingoApp;\n}\n","/**\n * Hook for locale switching. Sets NEXT_LOCALE cookie + navigates via router.\n */\n\nimport { useRouter } from \"next/router\";\nimport { useCallback } from \"react\";\n\nexport function useLocaleSwitch() {\n  const router = useRouter();\n  return useCallback(\n    (locale: string) => {\n      document.cookie = `NEXT_LOCALE=${locale}; path=/; max-age=31536000; SameSite=Lax`;\n      router.push(router.asPath, router.asPath, { locale });\n    },\n    [router],\n  );\n}\n","/**\n * Generates <link rel=\"alternate\" hreflang=\"...\"> tags for SEO.\n * Auto-derives all locale variants from Next.js router config.\n */\n\nimport Head from \"next/head\";\nimport { useRouter } from \"next/router\";\n\ntype LingoHeadProps = {\n  /** Base URL for absolute hreflang hrefs (e.g., \"https://example.com\"). Recommended for production. */\n  baseUrl?: string;\n};\n\nexport function LingoHead({ baseUrl = \"\" }: LingoHeadProps) {\n  const { locales, defaultLocale, asPath } = useRouter();\n\n  if (!locales) return null;\n\n  return (\n    <Head>\n      {locales.map((l) => (\n        <link key={l} rel=\"alternate\" hrefLang={l} href={`${baseUrl}${l === defaultLocale ? \"\" : `/${l}`}${asPath}`} />\n      ))}\n      <link rel=\"alternate\" hrefLang=\"x-default\" href={`${baseUrl}${asPath}`} />\n    </Head>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,aAAiC,KAAuB;CACtE,SAAS,SAAS,OAAU;EAC1B,MAAM,EAAE,QAAQ,kBAAkB,WAAW;EAC7C,MAAM,iBAAiB,UAAU,iBAAiB;EAClD,MAAM,WAAW,MAAM,WAAW,mBAAmB,EAAE;EACvD,MAAM,EAAE,cAAc,YAAY,eAAe;AAEjD,kBAAgB;AACd,YAAS,gBAAgB,MAAM;KAC9B,CAAC,UAAU,CAAC;AAEf,MAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,MAAM,WAAW,gBAC9D,SAAQ,KACN,8GACD;AAGH,SACE,qBAAA,UAAA,EAAA,UAAA,CACG,cAAc,SAAS,oBAAC,UAAD,EAAQ,yBAAyB,EAAE,QAAQ,sCAAsC,EAAI,CAAA,EAC7G,oBAAC,eAAD;GAAe,QAAQ;GAA0B;aAC/C,oBAAC,KAAD,EAAK,GAAI,OAAS,CAAA;GACJ,CAAA,CACf,EAAA,CAAA;;AAIP,UAAS,cAAc,gBAAgB,IAAI,eAAe,IAAI,QAAQ,MAAM;AAC5E,QAAO;;;;;;;AClCT,SAAgB,kBAAkB;CAChC,MAAM,SAAS,WAAW;AAC1B,QAAO,aACJ,WAAmB;AAClB,WAAS,SAAS,eAAe,OAAO;AACxC,SAAO,KAAK,OAAO,QAAQ,OAAO,QAAQ,EAAE,QAAQ,CAAC;IAEvD,CAAC,OAAO,CACT;;;;;;;;ACFH,SAAgB,UAAU,EAAE,UAAU,MAAsB;CAC1D,MAAM,EAAE,SAAS,eAAe,WAAW,WAAW;AAEtD,KAAI,CAAC,QAAS,QAAO;AAErB,QACE,qBAAC,MAAD,EAAA,UAAA,CACG,QAAQ,KAAK,MACZ,oBAAC,QAAD;EAAc,KAAI;EAAY,UAAU;EAAG,MAAM,GAAG,UAAU,MAAM,gBAAgB,KAAK,IAAI,MAAM;EAAY,EAApG,EAAoG,CAC/G,EACF,oBAAC,QAAD;EAAM,KAAI;EAAY,UAAS;EAAY,MAAM,GAAG,UAAU;EAAY,CAAA,CACrE,EAAA,CAAA"}

package/dist/pages/client.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_lingo_head = require("../lingo-head.cjs");
+exports.LingoHead = require_lingo_head.LingoHead;
+exports.useLocaleSwitch = require_lingo_head.useLocaleSwitch;
+exports.withLingoApp = require_lingo_head.withLingoApp;

package/dist/pages/client.d.cts

@@ -0,0 +1,2 @@
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.cjs";
+export { LingoHead, useLocaleSwitch, withLingoApp };

package/dist/pages/client.d.ts

@@ -0,0 +1,2 @@
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.js";
+export { LingoHead, useLocaleSwitch, withLingoApp };

package/dist/pages/client.js

@@ -0,0 +1,2 @@
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.js";
+export { LingoHead, useLocaleSwitch, withLingoApp };

package/dist/pages/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_with_lingo_paths = require("../with-lingo-paths.cjs");
+const require_lingo_head = require("../lingo-head.cjs");
+exports.LingoHead = require_lingo_head.LingoHead;
+exports.useLocaleSwitch = require_lingo_head.useLocaleSwitch;
+exports.withLingoApp = require_lingo_head.withLingoApp;
+exports.withLingoPaths = require_with_lingo_paths.withLingoPaths;
+exports.withLingoProps = require_with_lingo_paths.withLingoProps;

package/dist/pages/index.d.cts

@@ -0,0 +1,3 @@
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.cjs";
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.cjs";
+export { LingoHead, useLocaleSwitch, withLingoApp, withLingoPaths, withLingoProps };

package/dist/pages/index.d.ts

@@ -0,0 +1,3 @@
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.js";
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.js";
+export { LingoHead, useLocaleSwitch, withLingoApp, withLingoPaths, withLingoProps };

package/dist/pages/index.js

@@ -0,0 +1,3 @@
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.js";
+import { n as useLocaleSwitch, r as withLingoApp, t as LingoHead } from "../lingo-head.js";
+export { LingoHead, useLocaleSwitch, withLingoApp, withLingoPaths, withLingoProps };

package/dist/pages/server.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_with_lingo_paths = require("../with-lingo-paths.cjs");
+exports.withLingoPaths = require_with_lingo_paths.withLingoPaths;
+exports.withLingoProps = require_with_lingo_paths.withLingoProps;

package/dist/pages/server.d.cts

@@ -0,0 +1,2 @@
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.cjs";
+export { withLingoPaths, withLingoProps };

package/dist/pages/server.d.ts

@@ -0,0 +1,2 @@
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.js";
+export { withLingoPaths, withLingoProps };

package/dist/pages/server.js

@@ -0,0 +1,2 @@
+import { n as withLingoProps, t as withLingoPaths } from "../with-lingo-paths.js";
+export { withLingoPaths, withLingoProps };

package/dist/with-lingo-paths.cjs

@@ -0,0 +1,80 @@
+const require_chunk = require("./chunk.cjs");
+let _lingo_dev_spec = require("@lingo.dev/spec");
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
+//#region src/pages/load-messages.ts
+/**
+* Loads translated messages from JSONC locale files.
+* Internal module - used by withLingoProps, not exported publicly.
+*
+* Reads JSONC directly (no build step). Filters orphaned entries.
+* Splits messages by route using @src metadata from extraction.
+*/
+const MESSAGES_DIR = "locales";
+/**
+* Loads messages for a specific locale and route.
+* Returns page-specific messages + shared messages (components, lib, etc.).
+*/
+function loadMessages(locale, route) {
+	const filePath = node_path.default.resolve(process.cwd(), MESSAGES_DIR, `${locale}.jsonc`);
+	if (!node_fs.default.existsSync(filePath)) {
+		if (process.env.NODE_ENV === "development") console.warn(`[@lingo.dev/react-next] No locale file for "${locale}". Run "lingo extract && lingo localize".`);
+		return {};
+	}
+	return (0, _lingo_dev_spec.getActiveEntries)((0, _lingo_dev_spec.readLocaleFile)(node_fs.default.readFileSync(filePath, "utf8")).entries).filter((entry) => {
+		if (!entry.metadata.src) return true;
+		const srcRoute = entry.metadata.src.replace(/\.\w+:\d+$/, "");
+		if (srcRoute === route) return true;
+		return !srcRoute.startsWith("pages/") && !srcRoute.startsWith("src/pages/");
+	}).reduce((acc, entry) => {
+		acc[entry.key] = entry.value;
+		return acc;
+	}, {});
+}
+//#endregion
+//#region src/pages/with-lingo-props.ts
+function withLingoProps(config) {
+	return async (ctx) => {
+		const messages = loadMessages(ctx.locale ?? ctx.defaultLocale ?? "en", config.route);
+		if (!config.handler) return { props: { __lingoMessages: messages } };
+		const result = await config.handler(ctx);
+		if ("redirect" in result) return result;
+		if ("notFound" in result) return result;
+		return {
+			...result,
+			props: {
+				...result.props,
+				__lingoMessages: messages
+			}
+		};
+	};
+}
+//#endregion
+//#region src/pages/with-lingo-paths.ts
+function withLingoPaths(handler, options) {
+	return async (ctx) => {
+		const paths = await handler();
+		return {
+			paths: (ctx.locales ?? ["en"]).flatMap((locale) => paths.map((entry) => ({
+				...entry,
+				locale
+			}))),
+			fallback: options?.fallback ?? "blocking"
+		};
+	};
+}
+//#endregion
+Object.defineProperty(exports, "withLingoPaths", {
+	enumerable: true,
+	get: function() {
+		return withLingoPaths;
+	}
+});
+Object.defineProperty(exports, "withLingoProps", {
+	enumerable: true,
+	get: function() {
+		return withLingoProps;
+	}
+});

package/dist/with-lingo-paths.d.cts

@@ -0,0 +1,35 @@
+import * as next0 from "next";
+import { GetStaticPathsContext, GetStaticPathsResult, GetStaticPropsContext, GetStaticPropsResult } from "next";
+import { ParsedUrlQuery } from "node:querystring";
+
+//#region src/pages/with-lingo-props.d.ts
+type WithLingoPropsConfig<P extends Record<string, any>> = {
+  /** Page route for per-route message splitting (e.g., "pages/about"). */
+  route: string;
+  /** Optional handler for additional page data (custom props, revalidate, redirect, notFound). */
+  handler?: (ctx: GetStaticPropsContext) => Promise<GetStaticPropsResult<P>>;
+};
+type LingoPageProps = {
+  __lingoMessages: Record<string, string>;
+};
+declare function withLingoProps<P extends Record<string, any> = {}>(config: WithLingoPropsConfig<P>): (ctx: GetStaticPropsContext) => Promise<{
+  redirect: next0.Redirect;
+  revalidate?: number | boolean;
+} | {
+  notFound: true;
+  revalidate?: number | boolean;
+} | {
+  props: P & LingoPageProps;
+  revalidate?: number | boolean;
+}>;
+//#endregion
+//#region src/pages/with-lingo-paths.d.ts
+type PathEntry<P extends ParsedUrlQuery> = {
+  params: P;
+};
+declare function withLingoPaths<P extends ParsedUrlQuery>(handler: () => Promise<PathEntry<P>[]>, options?: {
+  fallback?: false | "blocking" | true;
+}): (ctx: GetStaticPathsContext) => Promise<GetStaticPathsResult<P>>;
+//#endregion
+export { withLingoProps as n, withLingoPaths as t };
+//# sourceMappingURL=with-lingo-paths.d.cts.map

package/dist/with-lingo-paths.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-lingo-paths.d.cts","names":[],"sources":["../src/pages/with-lingo-props.ts","../src/pages/with-lingo-paths.ts"],"sourcesContent":[],"mappings":";;;;;AAKwE,KAGnE,oBAAA,CAAA,UAA+B,MAAX,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;EAAA;OAAW,EAAA,MAAA;;SAIqC,CAAA,EAAA,CAAA,GAAA,EAAvD,qBAAuD,EAAA,GAA7B,OAA6B,CAArB,oBAAqB,CAAA,CAAA,CAAA,CAAA;;KAGpE,cAAA,GAHuC;EAAO,eAAA,EAGV,MAHU,CAAA,MAAA,EAAA,MAAA,CAAA;AAAA,CAAA;AAKnC,iBAAA,cAAc,CAAA,UAAW,MAAX,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,MAAA,EAA6C,oBAA7C,CAAkE,CAAlE,CAAA,CAAA,EAAA,CAAA,GAAA,EACT,qBADS,EAAA,GACY,OADZ,CAAA;EAAA,QAAA,EACY,KAAA,CAAA,QADZ;YAAW,CAAA,EAAA,MAAA,GAAA,OAAA;;UAAkC,EAAA,IAAA;YACtD,CAAA,EAAA,MAAA,GAAA,OAAA;;OAe0C,EAAA,CAAA,GAAI,cAAJ;YAAI,CAAA,EAAA,MAAA,GAAA,OAAA;;;;KCzB9D,SDAoB,CAAA,UCAA,cDAA,CAAA,GAAA;QAAW,ECAiB,CDAjB;;AAIqC,iBCFzD,cDEyD,CAAA,UCFhC,cDEgC,CAAA,CAAA,OAAA,EAAA,GAAA,GCDxD,ODCwD,CCDhD,SDCgD,CCDtC,CDCsC,CAAA,EAAA,CAAA,EAAA,QAAA,EAAA;UAArB,CAAA,EAAA,KAAA,GAAA,UAAA,GAAA,IAAA;QAAR,ECEvB,qBDFuB,EAAA,GCEC,ODFD,CCES,oBDFT,CCE8B,CDF9B,CAAA,CAAA"}

package/dist/with-lingo-paths.d.ts

@@ -0,0 +1,35 @@
+import * as next0 from "next";
+import { GetStaticPathsContext, GetStaticPathsResult, GetStaticPropsContext, GetStaticPropsResult } from "next";
+import { ParsedUrlQuery } from "node:querystring";
+
+//#region src/pages/with-lingo-props.d.ts
+type WithLingoPropsConfig<P extends Record<string, any>> = {
+  /** Page route for per-route message splitting (e.g., "pages/about"). */
+  route: string;
+  /** Optional handler for additional page data (custom props, revalidate, redirect, notFound). */
+  handler?: (ctx: GetStaticPropsContext) => Promise<GetStaticPropsResult<P>>;
+};
+type LingoPageProps = {
+  __lingoMessages: Record<string, string>;
+};
+declare function withLingoProps<P extends Record<string, any> = {}>(config: WithLingoPropsConfig<P>): (ctx: GetStaticPropsContext) => Promise<{
+  redirect: next0.Redirect;
+  revalidate?: number | boolean;
+} | {
+  notFound: true;
+  revalidate?: number | boolean;
+} | {
+  props: P & LingoPageProps;
+  revalidate?: number | boolean;
+}>;
+//#endregion
+//#region src/pages/with-lingo-paths.d.ts
+type PathEntry<P extends ParsedUrlQuery> = {
+  params: P;
+};
+declare function withLingoPaths<P extends ParsedUrlQuery>(handler: () => Promise<PathEntry<P>[]>, options?: {
+  fallback?: false | "blocking" | true;
+}): (ctx: GetStaticPathsContext) => Promise<GetStaticPathsResult<P>>;
+//#endregion
+export { withLingoProps as n, withLingoPaths as t };
+//# sourceMappingURL=with-lingo-paths.d.ts.map

package/dist/with-lingo-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-lingo-paths.d.ts","names":[],"sources":["../src/pages/with-lingo-props.ts","../src/pages/with-lingo-paths.ts"],"sourcesContent":[],"mappings":";;;;;AAKwE,KAGnE,oBAAA,CAAA,UAA+B,MAAX,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,GAAA;EAAA;OAAW,EAAA,MAAA;;SAIqC,CAAA,EAAA,CAAA,GAAA,EAAvD,qBAAuD,EAAA,GAA7B,OAA6B,CAArB,oBAAqB,CAAA,CAAA,CAAA,CAAA;;KAGpE,cAAA,GAHuC;EAAO,eAAA,EAGV,MAHU,CAAA,MAAA,EAAA,MAAA,CAAA;AAAA,CAAA;AAKnC,iBAAA,cAAc,CAAA,UAAW,MAAX,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,MAAA,EAA6C,oBAA7C,CAAkE,CAAlE,CAAA,CAAA,EAAA,CAAA,GAAA,EACT,qBADS,EAAA,GACY,OADZ,CAAA;EAAA,QAAA,EACY,KAAA,CAAA,QADZ;YAAW,CAAA,EAAA,MAAA,GAAA,OAAA;;UAAkC,EAAA,IAAA;YACtD,CAAA,EAAA,MAAA,GAAA,OAAA;;OAe0C,EAAA,CAAA,GAAI,cAAJ;YAAI,CAAA,EAAA,MAAA,GAAA,OAAA;;;;KCzB9D,SDAoB,CAAA,UCAA,cDAA,CAAA,GAAA;QAAW,ECAiB,CDAjB;;AAIqC,iBCFzD,cDEyD,CAAA,UCFhC,cDEgC,CAAA,CAAA,OAAA,EAAA,GAAA,GCDxD,ODCwD,CCDhD,SDCgD,CCDtC,CDCsC,CAAA,EAAA,CAAA,EAAA,QAAA,EAAA;UAArB,CAAA,EAAA,KAAA,GAAA,UAAA,GAAA,IAAA;QAAR,ECEvB,qBDFuB,EAAA,GCEC,ODFD,CCES,oBDFT,CCE8B,CDF9B,CAAA,CAAA"}

package/dist/with-lingo-paths.js

@@ -0,0 +1,68 @@
+import { getActiveEntries, readLocaleFile } from "@lingo.dev/spec";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/pages/load-messages.ts
+/**
+* Loads translated messages from JSONC locale files.
+* Internal module - used by withLingoProps, not exported publicly.
+*
+* Reads JSONC directly (no build step). Filters orphaned entries.
+* Splits messages by route using @src metadata from extraction.
+*/
+const MESSAGES_DIR = "locales";
+/**
+* Loads messages for a specific locale and route.
+* Returns page-specific messages + shared messages (components, lib, etc.).
+*/
+function loadMessages(locale, route) {
+	const filePath = path.resolve(process.cwd(), MESSAGES_DIR, `${locale}.jsonc`);
+	if (!fs.existsSync(filePath)) {
+		if (process.env.NODE_ENV === "development") console.warn(`[@lingo.dev/react-next] No locale file for "${locale}". Run "lingo extract && lingo localize".`);
+		return {};
+	}
+	return getActiveEntries(readLocaleFile(fs.readFileSync(filePath, "utf8")).entries).filter((entry) => {
+		if (!entry.metadata.src) return true;
+		const srcRoute = entry.metadata.src.replace(/\.\w+:\d+$/, "");
+		if (srcRoute === route) return true;
+		return !srcRoute.startsWith("pages/") && !srcRoute.startsWith("src/pages/");
+	}).reduce((acc, entry) => {
+		acc[entry.key] = entry.value;
+		return acc;
+	}, {});
+}
+//#endregion
+//#region src/pages/with-lingo-props.ts
+function withLingoProps(config) {
+	return async (ctx) => {
+		const messages = loadMessages(ctx.locale ?? ctx.defaultLocale ?? "en", config.route);
+		if (!config.handler) return { props: { __lingoMessages: messages } };
+		const result = await config.handler(ctx);
+		if ("redirect" in result) return result;
+		if ("notFound" in result) return result;
+		return {
+			...result,
+			props: {
+				...result.props,
+				__lingoMessages: messages
+			}
+		};
+	};
+}
+//#endregion
+//#region src/pages/with-lingo-paths.ts
+function withLingoPaths(handler, options) {
+	return async (ctx) => {
+		const paths = await handler();
+		return {
+			paths: (ctx.locales ?? ["en"]).flatMap((locale) => paths.map((entry) => ({
+				...entry,
+				locale
+			}))),
+			fallback: options?.fallback ?? "blocking"
+		};
+	};
+}
+//#endregion
+export { withLingoProps as n, withLingoPaths as t };
+
+//# sourceMappingURL=with-lingo-paths.js.map

package/dist/with-lingo-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-lingo-paths.js","names":[],"sources":["../src/pages/load-messages.ts","../src/pages/with-lingo-props.ts","../src/pages/with-lingo-paths.ts"],"sourcesContent":["/**\n * Loads translated messages from JSONC locale files.\n * Internal module - used by withLingoProps, not exported publicly.\n *\n * Reads JSONC directly (no build step). Filters orphaned entries.\n * Splits messages by route using @src metadata from extraction.\n */\n\nimport { readLocaleFile, getActiveEntries } from \"@lingo.dev/spec\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nconst MESSAGES_DIR = \"locales\";\n\n/**\n * Loads messages for a specific locale and route.\n * Returns page-specific messages + shared messages (components, lib, etc.).\n */\nexport function loadMessages(locale: string, route: string): Record<string, string> {\n  const filePath = path.resolve(process.cwd(), MESSAGES_DIR, `${locale}.jsonc`);\n\n  if (!fs.existsSync(filePath)) {\n    if (process.env.NODE_ENV === \"development\") {\n      console.warn(`[@lingo.dev/react-next] No locale file for \"${locale}\". Run \"lingo extract && lingo localize\".`);\n    }\n    return {};\n  }\n\n  const content = fs.readFileSync(filePath, \"utf8\");\n  const file = readLocaleFile(content);\n  const active = getActiveEntries(file.entries);\n\n  return active\n    .filter((entry) => {\n      if (!entry.metadata.src) return true; // no @src = shared\n      const srcRoute = entry.metadata.src.replace(/\\.\\w+:\\d+$/, \"\"); // strip \".tsx:42\"\n      if (srcRoute === route) return true; // exact page match\n      // Non-page files (components, lib, hooks, etc.) are shared across all pages\n      return !srcRoute.startsWith(\"pages/\") && !srcRoute.startsWith(\"src/pages/\");\n    })\n    .reduce(\n      (acc, entry) => {\n        acc[entry.key] = entry.value;\n        return acc;\n      },\n      {} as Record<string, string>,\n    );\n}\n","/**\n * Wraps getStaticProps/getServerSideProps to load route-specific messages.\n * Every page must use this - route is required for per-route splitting.\n */\n\nimport type { GetStaticPropsContext, GetStaticPropsResult } from \"next\";\nimport { loadMessages } from \"./load-messages\";\n\ntype WithLingoPropsConfig<P extends Record<string, any>> = {\n  /** Page route for per-route message splitting (e.g., \"pages/about\"). */\n  route: string;\n  /** Optional handler for additional page data (custom props, revalidate, redirect, notFound). */\n  handler?: (ctx: GetStaticPropsContext) => Promise<GetStaticPropsResult<P>>;\n};\n\ntype LingoPageProps = { __lingoMessages: Record<string, string> };\n\nexport function withLingoProps<P extends Record<string, any> = {}>(config: WithLingoPropsConfig<P>) {\n  return async (ctx: GetStaticPropsContext) => {\n    const locale = ctx.locale ?? ctx.defaultLocale ?? \"en\";\n    const messages = loadMessages(locale, config.route);\n\n    if (!config.handler) {\n      return { props: { __lingoMessages: messages } as P & LingoPageProps };\n    }\n\n    const result = await config.handler(ctx);\n\n    if (\"redirect\" in result) return result;\n    if (\"notFound\" in result) return result;\n\n    return {\n      ...result,\n      props: { ...result.props, __lingoMessages: messages } as P & LingoPageProps,\n    };\n  };\n}\n","/**\n * Wraps getStaticPaths to auto-expand paths across all configured locales.\n * Defaults to fallback: \"blocking\" for large locale x path combinations.\n */\n\nimport type { GetStaticPathsContext, GetStaticPathsResult } from \"next\";\nimport type { ParsedUrlQuery } from \"node:querystring\";\n\ntype PathEntry<P extends ParsedUrlQuery> = { params: P };\n\nexport function withLingoPaths<P extends ParsedUrlQuery>(\n  handler: () => Promise<PathEntry<P>[]>,\n  options?: { fallback?: false | \"blocking\" | true },\n) {\n  return async (ctx: GetStaticPathsContext): Promise<GetStaticPathsResult<P>> => {\n    const paths = await handler();\n    const locales = ctx.locales ?? [\"en\"];\n    return {\n      paths: locales.flatMap((locale) => paths.map((entry) => ({ ...entry, locale }))),\n      fallback: options?.fallback ?? \"blocking\",\n    };\n  };\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,eAAe;;;;;AAMrB,SAAgB,aAAa,QAAgB,OAAuC;CAClF,MAAM,WAAW,KAAK,QAAQ,QAAQ,KAAK,EAAE,cAAc,GAAG,OAAO,QAAQ;AAE7E,KAAI,CAAC,GAAG,WAAW,SAAS,EAAE;AAC5B,MAAI,QAAQ,IAAI,aAAa,cAC3B,SAAQ,KAAK,+CAA+C,OAAO,2CAA2C;AAEhH,SAAO,EAAE;;AAOX,QAFe,iBADF,eADG,GAAG,aAAa,UAAU,OAAO,CACb,CACC,QAAQ,CAG1C,QAAQ,UAAU;AACjB,MAAI,CAAC,MAAM,SAAS,IAAK,QAAO;EAChC,MAAM,WAAW,MAAM,SAAS,IAAI,QAAQ,cAAc,GAAG;AAC7D,MAAI,aAAa,MAAO,QAAO;AAE/B,SAAO,CAAC,SAAS,WAAW,SAAS,IAAI,CAAC,SAAS,WAAW,aAAa;GAC3E,CACD,QACE,KAAK,UAAU;AACd,MAAI,MAAM,OAAO,MAAM;AACvB,SAAO;IAET,EAAE,CACH;;;;AC7BL,SAAgB,eAAmD,QAAiC;AAClG,QAAO,OAAO,QAA+B;EAE3C,MAAM,WAAW,aADF,IAAI,UAAU,IAAI,iBAAiB,MACZ,OAAO,MAAM;AAEnD,MAAI,CAAC,OAAO,QACV,QAAO,EAAE,OAAO,EAAE,iBAAiB,UAAU,EAAwB;EAGvE,MAAM,SAAS,MAAM,OAAO,QAAQ,IAAI;AAExC,MAAI,cAAc,OAAQ,QAAO;AACjC,MAAI,cAAc,OAAQ,QAAO;AAEjC,SAAO;GACL,GAAG;GACH,OAAO;IAAE,GAAG,OAAO;IAAO,iBAAiB;IAAU;GACtD;;;;;ACxBL,SAAgB,eACd,SACA,SACA;AACA,QAAO,OAAO,QAAiE;EAC7E,MAAM,QAAQ,MAAM,SAAS;AAE7B,SAAO;GACL,QAFc,IAAI,WAAW,CAAC,KAAK,EAEpB,SAAS,WAAW,MAAM,KAAK,WAAW;IAAE,GAAG;IAAO;IAAQ,EAAE,CAAC;GAChF,UAAU,SAAS,YAAY;GAChC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@lingo.dev/react-next",
+  "version": "0.0.0",
+  "type": "module",
+  "exports": {
+    "./pages": {
+      "import": {
+        "types": "./dist/pages/index.d.ts",
+        "default": "./dist/pages/index.js"
+      },
+      "require": {
+        "types": "./dist/pages/index.d.cts",
+        "default": "./dist/pages/index.cjs"
+      }
+    },
+    "./pages/client": {
+      "import": {
+        "types": "./dist/pages/client.d.ts",
+        "default": "./dist/pages/client.js"
+      },
+      "require": {
+        "types": "./dist/pages/client.d.cts",
+        "default": "./dist/pages/client.cjs"
+      }
+    },
+    "./pages/server": {
+      "import": {
+        "types": "./dist/pages/server.d.ts",
+        "default": "./dist/pages/server.js"
+      },
+      "require": {
+        "types": "./dist/pages/server.d.cts",
+        "default": "./dist/pages/server.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "next": ">=13",
+    "react": "^18.0.0 || ^19.0.0",
+    "@lingo.dev/react": "1.0.0"
+  },
+  "dependencies": {
+    "@lingo.dev/spec": "1.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^27.4.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsdown": "^0.12.5",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.18",
+    "@lingo.dev/react": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}