@fluentic/i18n-nextjs 0.0.0-stage → 0.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,21 @@
1
+ # @fluentic/i18n-nextjs
2
+
3
+ ## 0.1.0-beta.2
4
+
5
+ ### Patch Changes
6
+
7
+ - Add validated cookie and URL-prefix language strategies with client handlers, Proxy integration, and Node/Edge request isolation.
8
+ - Keep hydration internal to the Next.js provider while the core SPA manager stays client-focused.
9
+ - Publish built declarations and require the beta.2 core runtime.
10
+
11
+ ## 0.1.0-beta.1
12
+
13
+ ### Minor Changes
14
+
15
+ - Publish the first public beta of the Next.js App Router and React Server Component bindings.
16
+ - Add request-scoped server state, client hydration, configuration helpers, and source-compilation integration.
17
+
18
+ ### Patch Changes
19
+
20
+ - Updated dependencies
21
+ - @fluentic/i18n@0.1.0-beta.1
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Fluentic
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,14 @@
1
- # Temporary Holding Version
1
+ # @fluentic/i18n-nextjs
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Next.js App Router adapter with conditional RSC/client exports, a single hydrated browser runtime, and built-in cookie or URL-prefix language handling.
4
+
5
+ - `/config`: `defineRequestConfig` and request types.
6
+ - `/language`: shared language definitions and handler contracts.
7
+ - `/server`: `ready`, generic `i18nFn`, low-level `runWithI18n`, and the server provider.
8
+ - `/handler/cookie/server` and `/handler/cookie/client`: cookie resolution, mutation endpoint, and stateless switching handler.
9
+ - `/handler/url/server` and `/handler/url/client`: prefix Proxy, request resolution, and stateless navigation handler.
10
+ - Root entry: the hydration boundary, read-only state, and navigation-backed manager facade.
11
+
12
+ Both `t.text` and `t.jsx` remain synchronous and work directly in Server and Client Components. The Next compiler generates the provider binding needed by client `t.text()` calls, so application source does not use a renderer hook. Await `ready()` in each independent server execution path. Language changes remain server-owned: the cookie handler posts the new ID and reloads, while the URL handler performs a full navigation to the localized path. Neither handler reads React or i18n state. Wrap any translated server function with `i18nFn`; `runWithI18n` remains the configurable low-level primitive. The async scope is tested in both Next Node and Edge Route Handlers, and no process-global server locale is changed per request. Next 16.4 warns that its Edge Runtime is deprecated in favor of Node.js.
13
+
14
+ See [integration guide](../../docs/docs/runtime/nextjs.md) and `examples/nextjs`.
@@ -0,0 +1,18 @@
1
+ import { type I18nSnapshot } from '@fluentic/i18n/hydration';
2
+ import { I18nState } from '@fluentic/i18n/react';
3
+ import React from 'react';
4
+ import type { NextI18nManager } from './language';
5
+ /** Hydrates the document runtime. Next.js remains the source of truth for language changes. */
6
+ export declare function I18nProvider({ children, snapshot }: {
7
+ children?: React.ReactNode;
8
+ snapshot?: I18nSnapshot;
9
+ }): React.FunctionComponentElement<{
10
+ children?: React.ReactNode;
11
+ instance?: import("@fluentic/i18n/adapter").ManagedI18n;
12
+ lineBreak?: React.ReactNode;
13
+ }>;
14
+ export declare const I18nManager: NextI18nManager;
15
+ export { I18nState };
16
+ export type { I18nSnapshot } from '@fluentic/i18n/hydration';
17
+ export { defineLanguages } from './language';
18
+ export type { LanguageChangeHandler, LanguageChangeOptions, LanguageDefinition, NextI18nManager } from './language';
@@ -0,0 +1,28 @@
1
+ 'use client';
2
+ import { defineLanguages } from "./language.mjs";
3
+ import { createI18nManager } from "@fluentic/i18n/adapter";
4
+ import { hydrate } from "@fluentic/i18n/hydration";
5
+ import { I18nProvider as I18nProvider$1, I18nState } from "@fluentic/i18n/react";
6
+ import React from "react";
7
+ // src/client.ts
8
+ /** Hydrates the document runtime. Next.js remains the source of truth for language changes. */
9
+ function I18nProvider({ children, snapshot }) {
10
+ const ref = React.useRef(null);
11
+ if (!snapshot) throw new Error("[i18n] the client hydration boundary requires a server snapshot");
12
+ if (!ref.current || ref.current.snapshot !== snapshot) {
13
+ const instance = createI18nManager();
14
+ hydrate(instance, snapshot);
15
+ ref.current = {
16
+ snapshot,
17
+ instance
18
+ };
19
+ }
20
+ return React.createElement(I18nProvider$1, { instance: ref.current.instance }, children);
21
+ }
22
+ const I18nManager = { setLanguageId(languageId, handler, options) {
23
+ if (!handler) throw new Error("[i18n] Next.js language changes require a URL or cookie language handler");
24
+ return handler(languageId, options);
25
+ } };
26
+ export { I18nManager, I18nProvider, I18nState, defineLanguages };
27
+
28
+ //# sourceMappingURL=client.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.mjs","names":["ReactProvider"],"sources":["../src/client.ts"],"sourcesContent":["import { createI18nManager } from '@fluentic/i18n/adapter';\nimport { hydrate, type I18nSnapshot } from '@fluentic/i18n/hydration';\nimport { I18nProvider as ReactProvider, I18nState } from '@fluentic/i18n/react';\nimport React from 'react';\nimport type { LanguageChangeHandler, LanguageChangeOptions, NextI18nManager } from './language';\n\n/** Hydrates the document runtime. Next.js remains the source of truth for language changes. */\nexport function I18nProvider(\n { children, snapshot }: { children?: React.ReactNode; snapshot?: I18nSnapshot; },\n) {\n const ref = React.useRef<{ snapshot: I18nSnapshot; instance: ReturnType<typeof createI18nManager>; } | null>(null);\n\n if (!snapshot) throw new Error('[i18n] the client hydration boundary requires a server snapshot');\n\n if (!ref.current || ref.current.snapshot !== snapshot) {\n const instance = createI18nManager();\n hydrate(instance, snapshot);\n ref.current = { snapshot, instance };\n }\n\n return React.createElement(ReactProvider, { instance: ref.current.instance }, children);\n}\n\nexport const I18nManager: NextI18nManager = {\n setLanguageId<LanguageId extends string>(\n languageId: LanguageId,\n handler: LanguageChangeHandler<LanguageId>,\n options?: LanguageChangeOptions,\n ) {\n if (!handler) {\n throw new Error('[i18n] Next.js language changes require a URL or cookie language handler');\n }\n\n return handler(languageId, options);\n },\n};\n\nexport { I18nState };\nexport type { I18nSnapshot } from '@fluentic/i18n/hydration';\nexport { defineLanguages } from './language';\nexport type { LanguageChangeHandler, LanguageChangeOptions, LanguageDefinition, NextI18nManager } from './language';\n"],"mappings":";;;;;;;;AAOA,SAAgB,aACd,EAAE,UAAU,YACZ;CACA,MAAM,MAAM,MAAM,OAA2F,IAAI;CAEjH,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,iEAAiE;CAEhG,IAAI,CAAC,IAAI,WAAW,IAAI,QAAQ,aAAa,UAAU;EACrD,MAAM,WAAW,kBAAkB;EACnC,QAAQ,UAAU,QAAQ;EAC1B,IAAI,UAAU;GAAE;GAAU;EAAS;CACrC;CAEA,OAAO,MAAM,cAAcA,gBAAe,EAAE,UAAU,IAAI,QAAQ,SAAS,GAAG,QAAQ;AACxF;AAEA,MAAa,cAA+B,EAC1C,cACE,YACA,SACA,SACA;CACA,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,0EAA0E;CAG5F,OAAO,QAAQ,YAAY,OAAO;AACpC,EACF"}
@@ -0,0 +1,8 @@
1
+ import type { Formats, I18nManagerOptions, TranslationData, TranslationLoader } from '@fluentic/i18n/adapter';
2
+ export type RequestConfig = I18nManagerOptions & {
3
+ translationLoader?: TranslationLoader;
4
+ translations?: TranslationData;
5
+ formats?: Partial<Formats>;
6
+ };
7
+ export type RequestConfigFactory = () => RequestConfig | Promise<RequestConfig>;
8
+ export declare function defineRequestConfig<T extends RequestConfigFactory>(factory: T): T;
@@ -0,0 +1,8 @@
1
+
2
+ // src/config.ts
3
+ function defineRequestConfig(factory) {
4
+ return factory;
5
+ }
6
+ export { defineRequestConfig };
7
+
8
+ //# sourceMappingURL=config.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { Formats, I18nManagerOptions, TranslationData, TranslationLoader } from '@fluentic/i18n/adapter';\nexport type RequestConfig = I18nManagerOptions & {\n translationLoader?: TranslationLoader;\n translations?: TranslationData;\n formats?: Partial<Formats>;\n};\nexport type RequestConfigFactory = () => RequestConfig | Promise<RequestConfig>;\nexport function defineRequestConfig<T extends RequestConfigFactory>(factory: T): T {\n return factory;\n}\n"],"mappings":";;AAOA,SAAgB,oBAAoD,SAAe;CACjF,OAAO;AACT"}
@@ -0,0 +1,8 @@
1
+ import { type LanguageChangeHandler, type LanguageDefinition } from './language';
2
+ export type CookieClientOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {
3
+ endpoint?: string;
4
+ };
5
+ export declare function createClientHandler<LanguageId extends string>(options: CookieClientOptions<LanguageId>): {
6
+ handler: LanguageChangeHandler<LanguageId>;
7
+ };
8
+ export { createClientHandler as createCookieClientHandler };
@@ -0,0 +1,21 @@
1
+ 'use client';
2
+ import { requireLanguageId } from "./language.mjs";
3
+ // src/cookie-client.ts
4
+ function createClientHandler(options) {
5
+ const endpoint = options.endpoint ?? "/api/language";
6
+ const handler = async (value) => {
7
+ const languageId = requireLanguageId(options, value);
8
+ const response = await fetch(endpoint, {
9
+ method: "POST",
10
+ headers: { "content-type": "text/plain;charset=UTF-8" },
11
+ body: languageId
12
+ });
13
+ if (!response.ok) throw new Error(`[i18n] language update failed (${response.status})`);
14
+ if (typeof window === "undefined") throw new Error("[i18n] the cookie client handler can only navigate in a browser");
15
+ window.location.reload();
16
+ };
17
+ return { handler };
18
+ }
19
+ export { createClientHandler, createClientHandler as createCookieClientHandler };
20
+
21
+ //# sourceMappingURL=cookie-client.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie-client.mjs","names":[],"sources":["../src/cookie-client.ts"],"sourcesContent":["import { type LanguageChangeHandler, type LanguageDefinition, requireLanguageId } from './language';\n\nexport type CookieClientOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {\n endpoint?: string;\n};\n\nexport function createClientHandler<LanguageId extends string>(\n options: CookieClientOptions<LanguageId>,\n): { handler: LanguageChangeHandler<LanguageId>; } {\n const endpoint = options.endpoint ?? '/api/language';\n\n const handler: LanguageChangeHandler<LanguageId> = async (value) => {\n const languageId = requireLanguageId(options, value);\n const response = await fetch(endpoint, {\n method: 'POST',\n headers: { 'content-type': 'text/plain;charset=UTF-8' },\n body: languageId,\n });\n if (!response.ok) throw new Error(`[i18n] language update failed (${response.status})`);\n if (typeof window === 'undefined') {\n throw new Error('[i18n] the cookie client handler can only navigate in a browser');\n }\n\n window.location.reload();\n };\n\n return { handler };\n}\n\nexport { createClientHandler as createCookieClientHandler };\n"],"mappings":";;;AAMA,SAAgB,oBACd,SACiD;CACjD,MAAM,WAAW,QAAQ,YAAY;CAErC,MAAM,UAA6C,OAAO,UAAU;EAClE,MAAM,aAAa,kBAAkB,SAAS,KAAK;EACnD,MAAM,WAAW,MAAM,MAAM,UAAU;GACrC,QAAQ;GACR,SAAS,EAAE,gBAAgB,2BAA2B;GACtD,MAAM;EACR,CAAC;EACD,IAAI,CAAC,SAAS,IAAI,MAAM,IAAI,MAAM,kCAAkC,SAAS,OAAO,EAAE;EACtF,IAAI,OAAO,WAAW,aACpB,MAAM,IAAI,MAAM,iEAAiE;EAGnF,OAAO,SAAS,OAAO;CACzB;CAEA,OAAO,EAAE,QAAQ;AACnB"}
@@ -0,0 +1,21 @@
1
+ import 'server-only';
2
+ import { type LanguageDefinition } from './language';
3
+ export type LanguageCookieOptions = {
4
+ name?: string;
5
+ domain?: string;
6
+ expires?: Date;
7
+ httpOnly?: boolean;
8
+ maxAge?: number;
9
+ path?: string;
10
+ sameSite?: boolean | 'lax' | 'strict' | 'none';
11
+ secure?: boolean;
12
+ };
13
+ export type CookieServerOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {
14
+ cookie?: LanguageCookieOptions;
15
+ };
16
+ export declare function createServerHandler<LanguageId extends string>(options: CookieServerOptions<LanguageId>): {
17
+ getLanguageId: () => Promise<LanguageId>;
18
+ setLanguageId: (value: LanguageId) => Promise<void>;
19
+ POST: (request: Request) => Promise<Response>;
20
+ };
21
+ export { createServerHandler as createCookieServerHandler };
@@ -0,0 +1,38 @@
1
+
2
+ import { requireLanguageId, resolveLanguageId } from "./language.mjs";
3
+ import "server-only";
4
+ import { cookies } from "next/headers.js";
5
+ // src/cookie-server.ts
6
+ function createServerHandler(options) {
7
+ const { name = "fluentic-language", ...configuredCookie } = options.cookie ?? {};
8
+ const cookieOptions = {
9
+ httpOnly: true,
10
+ sameSite: "lax",
11
+ secure: process.env.NODE_ENV === "production",
12
+ path: "/",
13
+ ...configuredCookie
14
+ };
15
+ const getLanguageId = async () => {
16
+ const value = (await cookies()).get(name)?.value;
17
+ return resolveLanguageId(options, value) ?? options.defaultLanguageId;
18
+ };
19
+ const setLanguageId = async (value) => {
20
+ const languageId = requireLanguageId(options, value);
21
+ (await cookies()).set(name, languageId, cookieOptions);
22
+ };
23
+ const POST = async (request) => {
24
+ const value = await request.text();
25
+ const languageId = resolveLanguageId(options, value);
26
+ if (!languageId) return new Response("Unsupported language", { status: 400 });
27
+ await setLanguageId(languageId);
28
+ return new Response(null, { status: 204 });
29
+ };
30
+ return {
31
+ getLanguageId,
32
+ setLanguageId,
33
+ POST
34
+ };
35
+ }
36
+ export { createServerHandler as createCookieServerHandler, createServerHandler };
37
+
38
+ //# sourceMappingURL=cookie-server.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie-server.mjs","names":[],"sources":["../src/cookie-server.ts"],"sourcesContent":["import 'server-only';\nimport { cookies } from 'next/headers';\nimport { type LanguageDefinition, requireLanguageId, resolveLanguageId } from './language';\n\nexport type LanguageCookieOptions = {\n name?: string;\n domain?: string;\n expires?: Date;\n httpOnly?: boolean;\n maxAge?: number;\n path?: string;\n sameSite?: boolean | 'lax' | 'strict' | 'none';\n secure?: boolean;\n};\n\nexport type CookieServerOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {\n cookie?: LanguageCookieOptions;\n};\n\nexport function createServerHandler<LanguageId extends string>(\n options: CookieServerOptions<LanguageId>,\n) {\n const { name = 'fluentic-language', ...configuredCookie } = options.cookie ?? {};\n const cookieOptions = {\n httpOnly: true,\n sameSite: 'lax' as const,\n secure: process.env.NODE_ENV === 'production',\n path: '/',\n ...configuredCookie,\n };\n\n const getLanguageId = async (): Promise<LanguageId> => {\n const value = (await cookies()).get(name)?.value;\n\n return resolveLanguageId(options, value) ?? options.defaultLanguageId;\n };\n const setLanguageId = async (value: LanguageId): Promise<void> => {\n const languageId = requireLanguageId(options, value);\n (await cookies()).set(name, languageId, cookieOptions);\n };\n const POST = async (request: Request): Promise<Response> => {\n const value = await request.text();\n const languageId = resolveLanguageId(options, value);\n if (!languageId) return new Response('Unsupported language', { status: 400 });\n await setLanguageId(languageId);\n\n return new Response(null, { status: 204 });\n };\n\n return { getLanguageId, setLanguageId, POST };\n}\n\nexport { createServerHandler as createCookieServerHandler };\n"],"mappings":";;;;;AAmBA,SAAgB,oBACd,SACA;CACA,MAAM,EAAE,OAAO,qBAAqB,GAAG,qBAAqB,QAAQ,UAAU,CAAC;CAC/E,MAAM,gBAAgB;EACpB,UAAU;EACV,UAAU;EACV,QAAQ,QAAQ,IAAI,aAAa;EACjC,MAAM;EACN,GAAG;CACL;CAEA,MAAM,gBAAgB,YAAiC;EACrD,MAAM,SAAS,MAAM,QAAQ,EAAA,CAAG,IAAI,IAAI,CAAC,EAAE;EAE3C,OAAO,kBAAkB,SAAS,KAAK,KAAK,QAAQ;CACtD;CACA,MAAM,gBAAgB,OAAO,UAAqC;EAChE,MAAM,aAAa,kBAAkB,SAAS,KAAK;EACnD,CAAC,MAAM,QAAQ,EAAA,CAAG,IAAI,MAAM,YAAY,aAAa;CACvD;CACA,MAAM,OAAO,OAAO,YAAwC;EAC1D,MAAM,QAAQ,MAAM,QAAQ,KAAK;EACjC,MAAM,aAAa,kBAAkB,SAAS,KAAK;EACnD,IAAI,CAAC,YAAY,OAAO,IAAI,SAAS,wBAAwB,EAAE,QAAQ,IAAI,CAAC;EAC5E,MAAM,cAAc,UAAU;EAE9B,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CAC3C;CAEA,OAAO;EAAE;EAAe;EAAe;CAAK;AAC9C"}
@@ -0,0 +1,15 @@
1
+ export type LanguageDefinition<LanguageId extends string = string> = {
2
+ languages: readonly LanguageId[];
3
+ defaultLanguageId: LanguageId;
4
+ };
5
+ export type LanguageChangeOptions = {
6
+ replace?: boolean;
7
+ scroll?: boolean;
8
+ };
9
+ export type LanguageChangeHandler<LanguageId extends string = string> = (languageId: LanguageId, options?: LanguageChangeOptions) => Promise<void>;
10
+ export type NextI18nManager = {
11
+ setLanguageId<LanguageId extends string>(languageId: LanguageId, handler: LanguageChangeHandler<LanguageId>, options?: LanguageChangeOptions): Promise<void>;
12
+ };
13
+ export declare function defineLanguages<const LanguageId extends string>(definition: LanguageDefinition<LanguageId>): LanguageDefinition<LanguageId>;
14
+ export declare function resolveLanguageId<LanguageId extends string>(definition: LanguageDefinition<LanguageId>, value: string | null | undefined): LanguageId | null;
15
+ export declare function requireLanguageId<LanguageId extends string>(definition: LanguageDefinition<LanguageId>, value: string): LanguageId;
@@ -0,0 +1,19 @@
1
+
2
+ // src/language.ts
3
+ function defineLanguages(definition) {
4
+ if (!definition.languages.length) throw new Error("[i18n] configure at least one language");
5
+ if (new Set(definition.languages).size !== definition.languages.length) throw new Error("[i18n] configured languages must be unique");
6
+ if (!definition.languages.includes(definition.defaultLanguageId)) throw new Error("[i18n] defaultLanguageId must be included in languages");
7
+ return definition;
8
+ }
9
+ function resolveLanguageId(definition, value) {
10
+ return value && definition.languages.includes(value) ? value : null;
11
+ }
12
+ function requireLanguageId(definition, value) {
13
+ const languageId = resolveLanguageId(definition, value);
14
+ if (!languageId) throw new RangeError(`[i18n] unsupported language: ${value}`);
15
+ return languageId;
16
+ }
17
+ export { defineLanguages, requireLanguageId, resolveLanguageId };
18
+
19
+ //# sourceMappingURL=language.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"language.mjs","names":[],"sources":["../src/language.ts"],"sourcesContent":["export type LanguageDefinition<LanguageId extends string = string> = {\n languages: readonly LanguageId[];\n defaultLanguageId: LanguageId;\n};\n\nexport type LanguageChangeOptions = {\n replace?: boolean;\n scroll?: boolean;\n};\n\nexport type LanguageChangeHandler<LanguageId extends string = string> = (\n languageId: LanguageId,\n options?: LanguageChangeOptions,\n) => Promise<void>;\n\nexport type NextI18nManager = {\n setLanguageId<LanguageId extends string>(\n languageId: LanguageId,\n handler: LanguageChangeHandler<LanguageId>,\n options?: LanguageChangeOptions,\n ): Promise<void>;\n};\n\nexport function defineLanguages<const LanguageId extends string>(\n definition: LanguageDefinition<LanguageId>,\n): LanguageDefinition<LanguageId> {\n if (!definition.languages.length) throw new Error('[i18n] configure at least one language');\n if (new Set(definition.languages).size !== definition.languages.length) {\n throw new Error('[i18n] configured languages must be unique');\n }\n if (!definition.languages.includes(definition.defaultLanguageId)) {\n throw new Error('[i18n] defaultLanguageId must be included in languages');\n }\n\n return definition;\n}\n\nexport function resolveLanguageId<LanguageId extends string>(\n definition: LanguageDefinition<LanguageId>,\n value: string | null | undefined,\n): LanguageId | null {\n return value && definition.languages.includes(value as LanguageId) ? value as LanguageId : null;\n}\n\nexport function requireLanguageId<LanguageId extends string>(\n definition: LanguageDefinition<LanguageId>,\n value: string,\n): LanguageId {\n const languageId = resolveLanguageId(definition, value);\n if (!languageId) throw new RangeError(`[i18n] unsupported language: ${value}`);\n\n return languageId;\n}\n"],"mappings":";;AAuBA,SAAgB,gBACd,YACgC;CAChC,IAAI,CAAC,WAAW,UAAU,QAAQ,MAAM,IAAI,MAAM,wCAAwC;CAC1F,IAAI,IAAI,IAAI,WAAW,SAAS,CAAC,CAAC,SAAS,WAAW,UAAU,QAC9D,MAAM,IAAI,MAAM,4CAA4C;CAE9D,IAAI,CAAC,WAAW,UAAU,SAAS,WAAW,iBAAiB,GAC7D,MAAM,IAAI,MAAM,wDAAwD;CAG1E,OAAO;AACT;AAEA,SAAgB,kBACd,YACA,OACmB;CACnB,OAAO,SAAS,WAAW,UAAU,SAAS,KAAmB,IAAI,QAAsB;AAC7F;AAEA,SAAgB,kBACd,YACA,OACY;CACZ,MAAM,aAAa,kBAAkB,YAAY,KAAK;CACtD,IAAI,CAAC,YAAY,MAAM,IAAI,WAAW,gCAAgC,OAAO;CAE7E,OAAO;AACT"}
@@ -0,0 +1,3 @@
1
+ import type { RequestConfigFactory } from './config';
2
+ declare const missing: RequestConfigFactory;
3
+ export default missing;
@@ -0,0 +1,8 @@
1
+
2
+ // src/request.ts
3
+ const missing = () => {
4
+ throw new Error("[i18n] configure @fluentic/i18n-compiler/nextjs with requestConfig pointing to your request module");
5
+ };
6
+ export { missing as default };
7
+
8
+ //# sourceMappingURL=request.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request.mjs","names":[],"sources":["../src/request.ts"],"sourcesContent":["import type { RequestConfigFactory } from './config';\nconst missing: RequestConfigFactory = () => {\n throw new Error('[i18n] configure @fluentic/i18n-compiler/nextjs with requestConfig pointing to your request module');\n};\nexport default missing;\n"],"mappings":";;AACA,MAAM,gBAAsC;CAC1C,MAAM,IAAI,MAAM,oGAAoG;AACtH"}
@@ -0,0 +1,30 @@
1
+ import 'server-only';
2
+ import { type I18nSnapshot } from '@fluentic/i18n/hydration';
3
+ import React from 'react';
4
+ import type { RequestConfig } from './config';
5
+ import type { NextI18nManager } from './language';
6
+ export { defineRequestConfig } from './config';
7
+ export type { RequestConfig, RequestConfigFactory } from './config';
8
+ /** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */
9
+ export declare function ready(): Promise<I18nSnapshot>;
10
+ export declare function resolveI18n(config: RequestConfig): Promise<I18nSnapshot>;
11
+ /** Route handlers, server actions: isolate the entire async operation explicitly. */
12
+ export declare function runWithI18n<T>(config: RequestConfig, fn: () => T): Promise<Awaited<T>>;
13
+ /** Wrap any server function with the application request config and an isolated i18n scope. */
14
+ export declare function i18nFn<Arguments extends unknown[], Result>(fn: (...args: Arguments) => Result): (...args: Arguments) => Promise<Awaited<Result>>;
15
+ export declare function I18nProvider({ children, snapshot }: {
16
+ children?: React.ReactNode;
17
+ snapshot?: I18nSnapshot;
18
+ }): Promise<React.FunctionComponentElement<{
19
+ children?: React.ReactNode;
20
+ snapshot?: I18nSnapshot;
21
+ }>>;
22
+ export declare const I18nManager: NextI18nManager;
23
+ export declare const I18nState: {
24
+ get: () => import("@fluentic/i18n/adapter").StateData;
25
+ subscribe: (_listener: () => void) => () => void;
26
+ use: () => import("@fluentic/i18n/adapter").StateData;
27
+ };
28
+ export { createI18nManager, defineTranslationLoader } from '@fluentic/i18n/adapter';
29
+ export { defineLanguages } from './language';
30
+ export type { LanguageChangeHandler, LanguageChangeOptions, LanguageDefinition, NextI18nManager } from './language';
@@ -0,0 +1,76 @@
1
+
2
+ import { defineLanguages } from "./language.mjs";
3
+ import { I18nProvider as I18nProvider$1 } from "./client.mjs";
4
+ import { defineRequestConfig } from "./config.mjs";
5
+ import { createI18nManager, createI18nManager as createI18nManager$1, defineTranslationLoader, setRuntimeResolver } from "@fluentic/i18n/adapter";
6
+ import { getSnapshot } from "@fluentic/i18n/hydration";
7
+ import React, { cache } from "react";
8
+ import "server-only";
9
+ import requestConfig from "@fluentic/i18n-nextjs/request";
10
+ import { AsyncLocalStorage } from "node:async_hooks";
11
+ // src/server.ts
12
+ const explicitScope = new AsyncLocalStorage();
13
+ function createServerManaged() {
14
+ const managed = createI18nManager$1();
15
+ managed.runtime.jsxHandler = (_options, render) => React.createElement(ServerMessage, { render });
16
+ managed.runtime.tagElement = (element) => {
17
+ if (!React.isValidElement(element)) throw new TypeError("[i18n] t.tag expects a React element or handler");
18
+ return (chunks) => React.cloneElement(element, void 0, ...chunks);
19
+ };
20
+ return managed;
21
+ }
22
+ const getManaged = cache(createServerManaged);
23
+ setRuntimeResolver(() => (explicitScope.getStore() ?? getManaged()).runtime);
24
+ async function initialize(managed, config) {
25
+ managed.manager.configure(config);
26
+ if (config.formats) managed.runtime.formats = config.formats;
27
+ managed.manager.setTranslationLoader(config.translationLoader ?? (({ languageId }) => languageId === config.languageId ? config.translations ?? [] : []));
28
+ await managed.manager.init();
29
+ return managed;
30
+ }
31
+ const getRequestManaged = cache(async () => initialize(getManaged(), await requestConfig()));
32
+ /** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */
33
+ async function ready() {
34
+ const current = explicitScope.getStore() ?? await getRequestManaged();
35
+ return getSnapshot(current);
36
+ }
37
+ async function resolveI18n(config) {
38
+ return getSnapshot(await initialize(createServerManaged(), config));
39
+ }
40
+ /** Route handlers, server actions: isolate the entire async operation explicitly. */
41
+ async function runWithI18n(config, fn) {
42
+ const managed = await initialize(createServerManaged(), config);
43
+ return await explicitScope.run(managed, fn);
44
+ }
45
+ /** Wrap any server function with the application request config and an isolated i18n scope. */
46
+ function i18nFn(fn) {
47
+ const wrapped = async (...args) => {
48
+ return await runWithI18n(await requestConfig(), () => fn(...args));
49
+ };
50
+ return wrapped;
51
+ }
52
+ function ServerMessage({ render }) {
53
+ const runtime = (explicitScope.getStore() ?? getManaged()).runtime;
54
+ return React.createElement(React.Fragment, null, ...render(runtime).map((part, index) => React.createElement(React.Fragment, { key: index }, part)));
55
+ }
56
+ async function I18nProvider({ children, snapshot }) {
57
+ return React.createElement(I18nProvider$1, { snapshot: snapshot ?? await ready() }, children);
58
+ }
59
+ new Proxy({}, { get(_target, key) {
60
+ return (...args) => {
61
+ const manager = (explicitScope.getStore() ?? getManaged()).manager;
62
+ return Reflect.apply(manager[key], manager, args);
63
+ };
64
+ } });
65
+ const I18nManager = { setLanguageId(languageId, handler, options) {
66
+ if (!handler) throw new Error("[i18n] Next.js language changes require a URL or cookie language handler");
67
+ return handler(languageId, options);
68
+ } };
69
+ const I18nState = {
70
+ get: () => (explicitScope.getStore() ?? getManaged()).state.get(),
71
+ subscribe: (_listener) => () => {},
72
+ use: () => (explicitScope.getStore() ?? getManaged()).state.get()
73
+ };
74
+ export { I18nManager, I18nProvider, I18nState, createI18nManager, defineLanguages, defineRequestConfig, defineTranslationLoader, i18nFn, ready, resolveI18n, runWithI18n };
75
+
76
+ //# sourceMappingURL=server.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.mjs","names":["createI18nManager","ClientProvider"],"sources":["../src/server.ts"],"sourcesContent":["import 'server-only';\nimport requestConfig from '@fluentic/i18n-nextjs/request';\nimport { createI18nManager, type ManagedI18n, type PartsRenderer, setRuntimeResolver } from '@fluentic/i18n/adapter';\nimport { getSnapshot, type I18nSnapshot } from '@fluentic/i18n/hydration';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport React, { cache } from 'react';\nimport { I18nProvider as ClientProvider } from './client';\nimport type { RequestConfig } from './config';\nimport type { LanguageChangeHandler, LanguageChangeOptions, NextI18nManager } from './language';\nexport { defineRequestConfig } from './config';\nexport type { RequestConfig, RequestConfigFactory } from './config';\nconst explicitScope = new AsyncLocalStorage<ManagedI18n>();\nfunction createServerManaged() {\n const managed = createI18nManager();\n managed.runtime.jsxHandler = (_options, render) => React.createElement(ServerMessage, { render });\n managed.runtime.tagElement = (element) => {\n if (!React.isValidElement(element)) throw new TypeError('[i18n] t.tag expects a React element or handler');\n return (chunks) => React.cloneElement(element, undefined, ...chunks as React.ReactNode[]);\n };\n return managed;\n}\nconst getManaged = cache(createServerManaged);\nsetRuntimeResolver(() => (explicitScope.getStore() ?? getManaged()).runtime);\nasync function initialize(managed: ManagedI18n, config: RequestConfig) {\n managed.manager.configure(config);\n if (config.formats) managed.runtime.formats = config.formats;\n managed.manager.setTranslationLoader(\n config.translationLoader ?? (({ languageId }) => languageId === config.languageId ? config.translations ?? [] : []),\n );\n await managed.manager.init();\n return managed;\n}\nconst getRequestManaged = cache(async () => initialize(getManaged(), await requestConfig()));\n/** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */\nexport async function ready(): Promise<I18nSnapshot> {\n const current = explicitScope.getStore() ?? await getRequestManaged();\n return getSnapshot(current);\n}\nexport async function resolveI18n(config: RequestConfig): Promise<I18nSnapshot> {\n return getSnapshot(await initialize(createServerManaged(), config));\n}\n/** Route handlers, server actions: isolate the entire async operation explicitly. */\nexport async function runWithI18n<T>(config: RequestConfig, fn: () => T): Promise<Awaited<T>> {\n const managed = await initialize(createServerManaged(), config);\n return await explicitScope.run(managed, fn);\n}\n\n/** Wrap any server function with the application request config and an isolated i18n scope. */\nexport function i18nFn<Arguments extends unknown[], Result>(\n fn: (...args: Arguments) => Result,\n): (...args: Arguments) => Promise<Awaited<Result>> {\n const wrapped = async (...args: Arguments) => {\n const result = await runWithI18n(await requestConfig(), () => fn(...args));\n\n return result;\n };\n\n return wrapped as (...args: Arguments) => Promise<Awaited<Result>>;\n}\nfunction ServerMessage({ render }: { render: PartsRenderer; }) {\n const runtime = (explicitScope.getStore() ?? getManaged()).runtime;\n // t.jsx is synchronous. The caller/provider must initialize before actual rendering.\n return React.createElement(\n React.Fragment,\n null,\n ...render(runtime).map((part, index) =>\n React.createElement(React.Fragment, { key: index }, part as React.ReactNode)\n ),\n );\n}\nexport async function I18nProvider({ children, snapshot }: { children?: React.ReactNode; snapshot?: I18nSnapshot; }) {\n return React.createElement(ClientProvider, { snapshot: snapshot ?? await ready() }, children);\n}\n// Resolve at invocation time, never capture a request in a module-level singleton.\nconst requestManager = new Proxy({} as ManagedI18n['manager'], {\n get(_target, key: keyof ManagedI18n['manager']) {\n return (...args: unknown[]) => {\n const manager = (explicitScope.getStore() ?? getManaged()).manager;\n return Reflect.apply(manager[key], manager, args);\n };\n },\n});\nexport const I18nManager: NextI18nManager = {\n setLanguageId<LanguageId extends string>(\n languageId: LanguageId,\n handler: LanguageChangeHandler<LanguageId>,\n options?: LanguageChangeOptions,\n ) {\n if (!handler) throw new Error('[i18n] Next.js language changes require a URL or cookie language handler');\n\n return handler(languageId, options);\n },\n};\nexport const I18nState = {\n get: () => (explicitScope.getStore() ?? getManaged()).state.get(),\n subscribe: (_listener: () => void) => () => {},\n use: () => (explicitScope.getStore() ?? getManaged()).state.get(),\n};\nexport { createI18nManager, defineTranslationLoader } from '@fluentic/i18n/adapter';\nexport { defineLanguages } from './language';\nexport type { LanguageChangeHandler, LanguageChangeOptions, LanguageDefinition, NextI18nManager } from './language';\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,gBAAgB,IAAI,kBAA+B;AACzD,SAAS,sBAAsB;CAC7B,MAAM,UAAUA,oBAAkB;CAClC,QAAQ,QAAQ,cAAc,UAAU,WAAW,MAAM,cAAc,eAAe,EAAE,OAAO,CAAC;CAChG,QAAQ,QAAQ,cAAc,YAAY;EACxC,IAAI,CAAC,MAAM,eAAe,OAAO,GAAG,MAAM,IAAI,UAAU,iDAAiD;EACzG,QAAQ,WAAW,MAAM,aAAa,SAAS,KAAA,GAAW,GAAG,MAA2B;CAC1F;CACA,OAAO;AACT;AACA,MAAM,aAAa,MAAM,mBAAmB;AAC5C,0BAA0B,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG,OAAO;AAC3E,eAAe,WAAW,SAAsB,QAAuB;CACrE,QAAQ,QAAQ,UAAU,MAAM;CAChC,IAAI,OAAO,SAAS,QAAQ,QAAQ,UAAU,OAAO;CACrD,QAAQ,QAAQ,qBACd,OAAO,uBAAuB,EAAE,iBAAiB,eAAe,OAAO,aAAa,OAAO,gBAAgB,CAAC,IAAI,CAAC,EACnH;CACA,MAAM,QAAQ,QAAQ,KAAK;CAC3B,OAAO;AACT;AACA,MAAM,oBAAoB,MAAM,YAAY,WAAW,WAAW,GAAG,MAAM,cAAc,CAAC,CAAC;;AAE3F,eAAsB,QAA+B;CACnD,MAAM,UAAU,cAAc,SAAS,KAAK,MAAM,kBAAkB;CACpE,OAAO,YAAY,OAAO;AAC5B;AACA,eAAsB,YAAY,QAA8C;CAC9E,OAAO,YAAY,MAAM,WAAW,oBAAoB,GAAG,MAAM,CAAC;AACpE;;AAEA,eAAsB,YAAe,QAAuB,IAAkC;CAC5F,MAAM,UAAU,MAAM,WAAW,oBAAoB,GAAG,MAAM;CAC9D,OAAO,MAAM,cAAc,IAAI,SAAS,EAAE;AAC5C;;AAGA,SAAgB,OACd,IACkD;CAClD,MAAM,UAAU,OAAO,GAAG,SAAoB;EAG5C,OAAO,MAFc,YAAY,MAAM,cAAc,SAAS,GAAG,GAAG,IAAI,CAAC;CAG3E;CAEA,OAAO;AACT;AACA,SAAS,cAAc,EAAE,UAAsC;CAC7D,MAAM,WAAW,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG;CAE3D,OAAO,MAAM,cACX,MAAM,UACN,MACA,GAAG,OAAO,OAAO,CAAC,CAAC,KAAK,MAAM,UAC5B,MAAM,cAAc,MAAM,UAAU,EAAE,KAAK,MAAM,GAAG,IAAuB,CAC7E,CACF;AACF;AACA,eAAsB,aAAa,EAAE,UAAU,YAAsE;CACnH,OAAO,MAAM,cAAcC,gBAAgB,EAAE,UAAU,YAAY,MAAM,MAAM,EAAE,GAAG,QAAQ;AAC9F;AAEuB,IAAI,MAAM,CAAC,GAA6B,EAC7D,IAAI,SAAS,KAAmC;CAC9C,QAAQ,GAAG,SAAoB;EAC7B,MAAM,WAAW,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG;EAC3D,OAAO,QAAQ,MAAM,QAAQ,MAAM,SAAS,IAAI;CAClD;AACF,EACF,CAAC;AACD,MAAa,cAA+B,EAC1C,cACE,YACA,SACA,SACA;CACA,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,0EAA0E;CAExG,OAAO,QAAQ,YAAY,OAAO;AACpC,EACF;AACA,MAAa,YAAY;CACvB,YAAY,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG,MAAM,IAAI;CAChE,YAAY,oBAAgC,CAAC;CAC7C,YAAY,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG,MAAM,IAAI;AAClE"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,6 @@
1
+
2
+ // src/unavailable.ts
3
+ throw new Error("[i18n] @fluentic/i18n-nextjs/server is only available on the server");
4
+ export {};
5
+
6
+ //# sourceMappingURL=unavailable.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unavailable.mjs","names":[],"sources":["../src/unavailable.ts"],"sourcesContent":["throw new Error('[i18n] @fluentic/i18n-nextjs/server is only available on the server');\nexport {};\n"],"mappings":";;AAAA,MAAM,IAAI,MAAM,qEAAqE"}
@@ -0,0 +1,6 @@
1
+ import { type LanguageChangeHandler, type LanguageDefinition } from './language';
2
+ export declare function localizePathname<LanguageId extends string>(pathname: string, languageId: LanguageId, definition: LanguageDefinition<LanguageId>): string;
3
+ export declare function createClientHandler<LanguageId extends string>(options: LanguageDefinition<LanguageId>): {
4
+ handler: LanguageChangeHandler<LanguageId>;
5
+ };
6
+ export { createClientHandler as createUrlClientHandler };
@@ -0,0 +1,21 @@
1
+ 'use client';
2
+ import { requireLanguageId } from "./language.mjs";
3
+ // src/url-client.ts
4
+ function localizePathname(pathname, languageId, definition) {
5
+ requireLanguageId(definition, languageId);
6
+ const segments = pathname.split("/").filter(Boolean);
7
+ if (definition.languages.includes(segments[0])) segments.shift();
8
+ return "/" + [encodeURIComponent(languageId), ...segments].join("/");
9
+ }
10
+ function createClientHandler(options) {
11
+ const handler = async (value, change = {}) => {
12
+ const languageId = requireLanguageId(options, value);
13
+ if (typeof window === "undefined") throw new Error("[i18n] the URL client handler can only navigate in a browser");
14
+ const href = localizePathname(window.location.pathname, languageId, options) + window.location.search + window.location.hash;
15
+ window.location[change.replace ? "replace" : "assign"](href);
16
+ };
17
+ return { handler };
18
+ }
19
+ export { createClientHandler, createClientHandler as createUrlClientHandler, localizePathname };
20
+
21
+ //# sourceMappingURL=url-client.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-client.mjs","names":[],"sources":["../src/url-client.ts"],"sourcesContent":["import { type LanguageChangeHandler, type LanguageDefinition, requireLanguageId } from './language';\n\nexport function localizePathname<LanguageId extends string>(\n pathname: string,\n languageId: LanguageId,\n definition: LanguageDefinition<LanguageId>,\n): string {\n requireLanguageId(definition, languageId);\n const segments = pathname.split('/').filter(Boolean);\n if (definition.languages.includes(segments[0] as LanguageId)) segments.shift();\n\n return '/' + [encodeURIComponent(languageId), ...segments].join('/');\n}\n\nexport function createClientHandler<LanguageId extends string>(\n options: LanguageDefinition<LanguageId>,\n): { handler: LanguageChangeHandler<LanguageId>; } {\n const handler: LanguageChangeHandler<LanguageId> = async (value, change = {}) => {\n const languageId = requireLanguageId(options, value);\n if (typeof window === 'undefined') {\n throw new Error('[i18n] the URL client handler can only navigate in a browser');\n }\n const href = localizePathname(window.location.pathname, languageId, options) +\n window.location.search +\n window.location.hash;\n\n window.location[change.replace ? 'replace' : 'assign'](href);\n };\n\n return { handler };\n}\n\nexport { createClientHandler as createUrlClientHandler };\n"],"mappings":";;;AAEA,SAAgB,iBACd,UACA,YACA,YACQ;CACR,kBAAkB,YAAY,UAAU;CACxC,MAAM,WAAW,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;CACnD,IAAI,WAAW,UAAU,SAAS,SAAS,EAAgB,GAAG,SAAS,MAAM;CAE7E,OAAO,MAAM,CAAC,mBAAmB,UAAU,GAAG,GAAG,QAAQ,CAAC,CAAC,KAAK,GAAG;AACrE;AAEA,SAAgB,oBACd,SACiD;CACjD,MAAM,UAA6C,OAAO,OAAO,SAAS,CAAC,MAAM;EAC/E,MAAM,aAAa,kBAAkB,SAAS,KAAK;EACnD,IAAI,OAAO,WAAW,aACpB,MAAM,IAAI,MAAM,8DAA8D;EAEhF,MAAM,OAAO,iBAAiB,OAAO,SAAS,UAAU,YAAY,OAAO,IACzE,OAAO,SAAS,SAChB,OAAO,SAAS;EAElB,OAAO,SAAS,OAAO,UAAU,YAAY,SAAS,CAAC,IAAI;CAC7D;CAEA,OAAO,EAAE,QAAQ;AACnB"}
@@ -0,0 +1,8 @@
1
+ import { type NextRequest, NextResponse } from 'next/server';
2
+ import { type LanguageDefinition } from './language';
3
+ export type UrlProxyOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {
4
+ detectLanguage?: boolean;
5
+ headerName?: string;
6
+ rememberCookie?: false | string;
7
+ };
8
+ export declare function createUrlProxyHandler<LanguageId extends string>(options: UrlProxyOptions<LanguageId>): (request: NextRequest) => NextResponse;
@@ -0,0 +1,58 @@
1
+
2
+ import { resolveLanguageId } from "./language.mjs";
3
+ import { NextResponse } from "next/server.js";
4
+ // src/url-proxy.ts
5
+ function decodePathSegment(value) {
6
+ try {
7
+ return decodeURIComponent(value);
8
+ } catch {
9
+ return null;
10
+ }
11
+ }
12
+ function preferredLanguage(request, options) {
13
+ const remembered = options.rememberCookie && request.cookies.get(options.rememberCookie)?.value;
14
+ const fromCookie = resolveLanguageId(options, remembered || null);
15
+ if (fromCookie) return fromCookie;
16
+ if (options.detectLanguage !== false) {
17
+ const requested = (request.headers.get("accept-language") ?? "").split(",").map((entry) => {
18
+ const [id, q] = entry.trim().split(";q=");
19
+ return {
20
+ id,
21
+ quality: q === void 0 ? 1 : Number(q) || 0
22
+ };
23
+ }).sort((a, b) => b.quality - a.quality);
24
+ for (const candidate of requested) {
25
+ const exact = resolveLanguageId(options, candidate.id);
26
+ if (exact) return exact;
27
+ const base = options.languages.find((id) => id.split("-")[0] === candidate.id.split("-")[0]);
28
+ if (base) return base;
29
+ }
30
+ }
31
+ return options.defaultLanguageId;
32
+ }
33
+ function createUrlProxyHandler(options) {
34
+ const headerName = options.headerName ?? "x-fluentic-language";
35
+ return function proxy(request) {
36
+ const segments = request.nextUrl.pathname.split("/");
37
+ const languageId = resolveLanguageId(options, decodePathSegment(segments[1] ?? ""));
38
+ if (!languageId) {
39
+ const destination = request.nextUrl.clone();
40
+ const selected = preferredLanguage(request, options);
41
+ destination.pathname = `/${encodeURIComponent(selected)}${destination.pathname === "/" ? "" : destination.pathname}`;
42
+ return NextResponse.redirect(destination);
43
+ }
44
+ const requestHeaders = new Headers(request.headers);
45
+ requestHeaders.set(headerName, languageId);
46
+ const response = NextResponse.next({ request: { headers: requestHeaders } });
47
+ if (options.rememberCookie) response.cookies.set(options.rememberCookie, languageId, {
48
+ httpOnly: true,
49
+ sameSite: "lax",
50
+ secure: process.env.NODE_ENV === "production",
51
+ path: "/"
52
+ });
53
+ return response;
54
+ };
55
+ }
56
+ export { createUrlProxyHandler };
57
+
58
+ //# sourceMappingURL=url-proxy.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-proxy.mjs","names":[],"sources":["../src/url-proxy.ts"],"sourcesContent":["import { type NextRequest, NextResponse } from 'next/server';\nimport { type LanguageDefinition, resolveLanguageId } from './language';\n\nexport type UrlProxyOptions<LanguageId extends string> = LanguageDefinition<LanguageId> & {\n detectLanguage?: boolean;\n headerName?: string;\n rememberCookie?: false | string;\n};\n\nfunction decodePathSegment(value: string): string | null {\n try {\n return decodeURIComponent(value);\n } catch {\n return null;\n }\n}\n\nfunction preferredLanguage<LanguageId extends string>(\n request: NextRequest,\n options: UrlProxyOptions<LanguageId>,\n): LanguageId {\n const remembered = options.rememberCookie && request.cookies.get(options.rememberCookie)?.value;\n const fromCookie = resolveLanguageId(options, remembered || null);\n if (fromCookie) return fromCookie;\n if (options.detectLanguage !== false) {\n const requested = (request.headers.get('accept-language') ?? '')\n .split(',')\n .map((entry) => {\n const [id, q] = entry.trim().split(';q=');\n return { id, quality: q === undefined ? 1 : Number(q) || 0 };\n })\n .sort((a, b) => b.quality - a.quality);\n\n for (const candidate of requested) {\n const exact = resolveLanguageId(options, candidate.id);\n if (exact) return exact;\n const base = options.languages.find((id) => id.split('-')[0] === candidate.id.split('-')[0]);\n if (base) return base;\n }\n }\n\n return options.defaultLanguageId;\n}\n\nexport function createUrlProxyHandler<LanguageId extends string>(\n options: UrlProxyOptions<LanguageId>,\n) {\n const headerName = options.headerName ?? 'x-fluentic-language';\n\n return function proxy(request: NextRequest): NextResponse {\n const segments = request.nextUrl.pathname.split('/');\n const languageId = resolveLanguageId(options, decodePathSegment(segments[1] ?? ''));\n\n if (!languageId) {\n const destination = request.nextUrl.clone();\n const selected = preferredLanguage(request, options);\n destination.pathname = `/${encodeURIComponent(selected)}${\n destination.pathname === '/' ? '' : destination.pathname\n }`;\n\n return NextResponse.redirect(destination);\n }\n\n const requestHeaders = new Headers(request.headers);\n requestHeaders.set(headerName, languageId);\n const response = NextResponse.next({ request: { headers: requestHeaders } });\n if (options.rememberCookie) {\n response.cookies.set(options.rememberCookie, languageId, {\n httpOnly: true,\n sameSite: 'lax',\n secure: process.env.NODE_ENV === 'production',\n path: '/',\n });\n }\n\n return response;\n };\n}\n"],"mappings":";;;;AASA,SAAS,kBAAkB,OAA8B;CACvD,IAAI;EACF,OAAO,mBAAmB,KAAK;CACjC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,kBACP,SACA,SACY;CACZ,MAAM,aAAa,QAAQ,kBAAkB,QAAQ,QAAQ,IAAI,QAAQ,cAAc,CAAC,EAAE;CAC1F,MAAM,aAAa,kBAAkB,SAAS,cAAc,IAAI;CAChE,IAAI,YAAY,OAAO;CACvB,IAAI,QAAQ,mBAAmB,OAAO;EACpC,MAAM,aAAa,QAAQ,QAAQ,IAAI,iBAAiB,KAAK,GAAA,CAC1D,MAAM,GAAG,CAAC,CACV,KAAK,UAAU;GACd,MAAM,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK;GACxC,OAAO;IAAE;IAAI,SAAS,MAAM,KAAA,IAAY,IAAI,OAAO,CAAC,KAAK;GAAE;EAC7D,CAAC,CAAC,CACD,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO;EAEvC,KAAK,MAAM,aAAa,WAAW;GACjC,MAAM,QAAQ,kBAAkB,SAAS,UAAU,EAAE;GACrD,IAAI,OAAO,OAAO;GAClB,MAAM,OAAO,QAAQ,UAAU,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,OAAO,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,EAAE;GAC3F,IAAI,MAAM,OAAO;EACnB;CACF;CAEA,OAAO,QAAQ;AACjB;AAEA,SAAgB,sBACd,SACA;CACA,MAAM,aAAa,QAAQ,cAAc;CAEzC,OAAO,SAAS,MAAM,SAAoC;EACxD,MAAM,WAAW,QAAQ,QAAQ,SAAS,MAAM,GAAG;EACnD,MAAM,aAAa,kBAAkB,SAAS,kBAAkB,SAAS,MAAM,EAAE,CAAC;EAElF,IAAI,CAAC,YAAY;GACf,MAAM,cAAc,QAAQ,QAAQ,MAAM;GAC1C,MAAM,WAAW,kBAAkB,SAAS,OAAO;GACnD,YAAY,WAAW,IAAI,mBAAmB,QAAQ,IACpD,YAAY,aAAa,MAAM,KAAK,YAAY;GAGlD,OAAO,aAAa,SAAS,WAAW;EAC1C;EAEA,MAAM,iBAAiB,IAAI,QAAQ,QAAQ,OAAO;EAClD,eAAe,IAAI,YAAY,UAAU;EACzC,MAAM,WAAW,aAAa,KAAK,EAAE,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;EAC3E,IAAI,QAAQ,gBACV,SAAS,QAAQ,IAAI,QAAQ,gBAAgB,YAAY;GACvD,UAAU;GACV,UAAU;GACV,QAAQ,QAAQ,IAAI,aAAa;GACjC,MAAM;EACR,CAAC;EAGH,OAAO;CACT;AACF"}
@@ -0,0 +1,9 @@
1
+ import { type UrlProxyOptions } from './url-proxy';
2
+ export type UrlServerOptions<LanguageId extends string> = UrlProxyOptions<LanguageId>;
3
+ export declare function createServerHandler<LanguageId extends string>(options: UrlServerOptions<LanguageId>): {
4
+ getLanguageId: () => Promise<LanguageId>;
5
+ proxy: (request: import("next/server").NextRequest) => import("next/server").NextResponse;
6
+ };
7
+ export { createServerHandler as createUrlServerHandler };
8
+ export { createUrlProxyHandler } from './url-proxy';
9
+ export type { UrlProxyOptions } from './url-proxy';
@@ -0,0 +1,18 @@
1
+
2
+ import { resolveLanguageId } from "./language.mjs";
3
+ import { createUrlProxyHandler } from "./url-proxy.mjs";
4
+ import { headers } from "next/headers.js";
5
+ // src/url-server.ts
6
+ function createServerHandler(options) {
7
+ const headerName = options.headerName ?? "x-fluentic-language";
8
+ const getLanguageId = async () => {
9
+ return resolveLanguageId(options, (await headers()).get(headerName)) ?? options.defaultLanguageId;
10
+ };
11
+ return {
12
+ getLanguageId,
13
+ proxy: createUrlProxyHandler(options)
14
+ };
15
+ }
16
+ export { createServerHandler, createServerHandler as createUrlServerHandler, createUrlProxyHandler };
17
+
18
+ //# sourceMappingURL=url-server.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"url-server.mjs","names":[],"sources":["../src/url-server.ts"],"sourcesContent":["import { headers } from 'next/headers';\nimport { resolveLanguageId } from './language';\nimport { createUrlProxyHandler, type UrlProxyOptions } from './url-proxy';\n\nexport type UrlServerOptions<LanguageId extends string> = UrlProxyOptions<LanguageId>;\n\nexport function createServerHandler<LanguageId extends string>(\n options: UrlServerOptions<LanguageId>,\n) {\n const headerName = options.headerName ?? 'x-fluentic-language';\n const getLanguageId = async (): Promise<LanguageId> => {\n return resolveLanguageId(options, (await headers()).get(headerName)) ?? options.defaultLanguageId;\n };\n const proxy = createUrlProxyHandler(options);\n\n return { getLanguageId, proxy };\n}\n\nexport { createServerHandler as createUrlServerHandler };\n\nexport { createUrlProxyHandler } from './url-proxy';\nexport type { UrlProxyOptions } from './url-proxy';\n"],"mappings":";;;;;AAMA,SAAgB,oBACd,SACA;CACA,MAAM,aAAa,QAAQ,cAAc;CACzC,MAAM,gBAAgB,YAAiC;EACrD,OAAO,kBAAkB,UAAU,MAAM,QAAQ,EAAA,CAAG,IAAI,UAAU,CAAC,KAAK,QAAQ;CAClF;CAGA,OAAO;EAAE;EAAe,OAFV,sBAAsB,OAER;CAAE;AAChC"}
package/package.json CHANGED
@@ -1,6 +1,119 @@
1
1
  {
2
2
  "name": "@fluentic/i18n-nextjs",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.0-beta.2",
4
+ "description": "Next.js App Router and React Server Component bindings for Fluentic i18n.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/fluentic-dev/i18n.git",
10
+ "directory": "packages/nextjs"
11
+ },
12
+ "homepage": "https://fluenticstack.com/i18n/",
13
+ "bugs": {
14
+ "url": "https://github.com/fluentic-dev/i18n/issues"
15
+ },
16
+ "publishConfig": {
17
+ "access": "public"
18
+ },
19
+ "files": [
20
+ "dist",
21
+ "README.md",
22
+ "CHANGELOG.md",
23
+ "LICENSE"
24
+ ],
25
+ "sideEffects": [
26
+ "./dist/server.mjs"
27
+ ],
28
+ "exports": {
29
+ ".": {
30
+ "types": "./dist/client.d.ts",
31
+ "react-server": "./dist/server.mjs",
32
+ "default": "./dist/client.mjs"
33
+ },
34
+ "./server": {
35
+ "types": "./dist/server.d.ts",
36
+ "react-server": "./dist/server.mjs",
37
+ "node": "./dist/server.mjs",
38
+ "default": "./dist/unavailable.mjs"
39
+ },
40
+ "./config": {
41
+ "types": "./dist/config.d.ts",
42
+ "default": "./dist/config.mjs"
43
+ },
44
+ "./language": {
45
+ "types": "./dist/language.d.ts",
46
+ "default": "./dist/language.mjs"
47
+ },
48
+ "./request": {
49
+ "types": "./dist/request.d.ts",
50
+ "default": "./dist/request.mjs"
51
+ },
52
+ "./handler/cookie/client": {
53
+ "types": "./dist/cookie-client.d.ts",
54
+ "default": "./dist/cookie-client.mjs"
55
+ },
56
+ "./handler/cookie/server": {
57
+ "types": "./dist/cookie-server.d.ts",
58
+ "react-server": "./dist/cookie-server.mjs",
59
+ "node": "./dist/cookie-server.mjs",
60
+ "default": "./dist/unavailable.mjs"
61
+ },
62
+ "./handler/url/client": {
63
+ "types": "./dist/url-client.d.ts",
64
+ "default": "./dist/url-client.mjs"
65
+ },
66
+ "./handler/url/server": {
67
+ "types": "./dist/url-server.d.ts",
68
+ "react-server": "./dist/url-server.mjs",
69
+ "node": "./dist/url-server.mjs",
70
+ "default": "./dist/url-server.mjs"
71
+ },
72
+ "./cookie/client": {
73
+ "types": "./dist/cookie-client.d.ts",
74
+ "default": "./dist/cookie-client.mjs"
75
+ },
76
+ "./cookie/server": {
77
+ "types": "./dist/cookie-server.d.ts",
78
+ "react-server": "./dist/cookie-server.mjs",
79
+ "node": "./dist/cookie-server.mjs",
80
+ "default": "./dist/unavailable.mjs"
81
+ },
82
+ "./url/client": {
83
+ "types": "./dist/url-client.d.ts",
84
+ "default": "./dist/url-client.mjs"
85
+ },
86
+ "./url/proxy": {
87
+ "types": "./dist/url-proxy.d.ts",
88
+ "default": "./dist/url-proxy.mjs"
89
+ },
90
+ "./url/server": {
91
+ "types": "./dist/url-server.d.ts",
92
+ "react-server": "./dist/url-server.mjs",
93
+ "node": "./dist/url-server.mjs",
94
+ "default": "./dist/unavailable.mjs"
95
+ }
96
+ },
97
+ "dependencies": {
98
+ "server-only": "^0.0.1"
99
+ },
100
+ "peerDependencies": {
101
+ "@fluentic/i18n": ">=0.1.0-beta.2 <0.2.0",
102
+ "next": ">=15",
103
+ "react": ">=19"
104
+ },
105
+ "devDependencies": {
106
+ "@types/node": "^22.15.0",
107
+ "@types/react": "^19.2.14",
108
+ "next": "^16.4.6",
109
+ "react": "^19.2.0",
110
+ "tsdown": "^0.22.1",
111
+ "typescript": "^7.0.2",
112
+ "@fluentic/i18n": "0.1.0-beta.2"
113
+ },
114
+ "scripts": {
115
+ "build": "tsdown && tsc -p tsconfig.build.json",
116
+ "test": "pnpm build && node --test test/*.test.mjs",
117
+ "typecheck": "tsc --noEmit"
118
+ }
6
119
  }