@fluentic/i18n-nextjs 0.1.0-beta.1 → 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.
Files changed (45) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +7 -5
  3. package/dist/client.d.ts +18 -0
  4. package/dist/client.mjs +27 -1
  5. package/dist/client.mjs.map +1 -0
  6. package/{src/config.ts → dist/config.d.ts} +4 -6
  7. package/dist/cookie-client.d.ts +8 -0
  8. package/dist/cookie-client.mjs +21 -0
  9. package/dist/cookie-client.mjs.map +1 -0
  10. package/dist/cookie-server.d.ts +21 -0
  11. package/dist/cookie-server.mjs +38 -0
  12. package/dist/cookie-server.mjs.map +1 -0
  13. package/dist/language.d.ts +15 -0
  14. package/dist/language.mjs +19 -0
  15. package/dist/language.mjs.map +1 -0
  16. package/dist/request.d.ts +3 -0
  17. package/dist/request.mjs +1 -1
  18. package/dist/request.mjs.map +1 -1
  19. package/dist/server.d.ts +30 -0
  20. package/dist/server.mjs +21 -14
  21. package/dist/server.mjs.map +1 -1
  22. package/dist/unavailable.d.ts +1 -0
  23. package/dist/url-client.d.ts +6 -0
  24. package/dist/url-client.mjs +21 -0
  25. package/dist/url-client.mjs.map +1 -0
  26. package/dist/url-proxy.d.ts +8 -0
  27. package/dist/url-proxy.mjs +58 -0
  28. package/dist/url-proxy.mjs.map +1 -0
  29. package/dist/url-server.d.ts +9 -0
  30. package/dist/url-server.mjs +18 -0
  31. package/dist/url-server.mjs.map +1 -0
  32. package/package.json +61 -17
  33. package/dist/client.d.mts +0 -4
  34. package/dist/config.d.mts +0 -11
  35. package/dist/plugin.d.mts +0 -10
  36. package/dist/plugin.mjs +0 -60
  37. package/dist/plugin.mjs.map +0 -1
  38. package/dist/request.d.mts +0 -5
  39. package/dist/server.d.mts +0 -29
  40. package/dist/unavailable.d.mts +0 -2
  41. package/src/client.ts +0 -10
  42. package/src/plugin.ts +0 -40
  43. package/src/request.ts +0 -5
  44. package/src/server.ts +0 -87
  45. package/src/unavailable.ts +0 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # @fluentic/i18n-nextjs
2
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
+
3
11
  ## 0.1.0-beta.1
4
12
 
5
13
  ### Minor Changes
package/README.md CHANGED
@@ -1,12 +1,14 @@
1
1
  # @fluentic/i18n-nextjs
2
2
 
3
- Next.js App Router adapter with conditional RSC/client exports. The app supplies current language and loader through `defineRequestConfig`; routing stays application-owned.
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
4
 
5
- - `/plugin`: one Next config wrapper for webpack and Turbopack.
6
5
  - `/config`: `defineRequestConfig` and request types.
7
- - `/server`: `ready`, `resolveI18n`, `runWithI18n`, and server provider.
8
- - Root entry: server or client `I18nProvider`; client state and renderer binding.
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.
9
11
 
10
- Both `t.text` and `t.jsx` remain synchronous. Await `ready()` in each independent server execution path before rendering. Use request snapshots for hydration, and `runWithI18n` for explicit async scopes in Node route handlers/actions. No process-global locale is changed per request. Edge runtime support is not included.
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.
11
13
 
12
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';
package/dist/client.mjs CHANGED
@@ -1,2 +1,28 @@
1
1
  'use client';
2
- export { I18nManager, I18nProvider, I18nState, createI18nManager, defineTranslationLoader, useI18nRenderer, useI18nRuntime } from "@fluentic/i18n/react";
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"}
@@ -1,10 +1,8 @@
1
1
  import type { Formats, I18nManagerOptions, TranslationData, TranslationLoader } from '@fluentic/i18n/adapter';
2
2
  export type RequestConfig = I18nManagerOptions & {
3
- translationLoader?: TranslationLoader;
4
- translations?: TranslationData;
5
- formats?: Partial<Formats>;
3
+ translationLoader?: TranslationLoader;
4
+ translations?: TranslationData;
5
+ formats?: Partial<Formats>;
6
6
  };
7
7
  export type RequestConfigFactory = () => RequestConfig | Promise<RequestConfig>;
8
- export function defineRequestConfig<T extends RequestConfigFactory>(factory: T): T {
9
- return factory;
10
- }
8
+ export declare function defineRequestConfig<T extends RequestConfigFactory>(factory: T): T;
@@ -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;
package/dist/request.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
 
2
2
  // src/request.ts
3
3
  const missing = () => {
4
- throw new Error("[i18n] configure @fluentic/i18n-nextjs/plugin with requestConfig pointing to your request module");
4
+ throw new Error("[i18n] configure @fluentic/i18n-compiler/nextjs with requestConfig pointing to your request module");
5
5
  };
6
6
  export { missing as default };
7
7
 
@@ -1 +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-nextjs/plugin with requestConfig pointing to your request module');\n};\nexport default missing;\n"],"mappings":";;AACA,MAAM,gBAAsC;CAC1C,MAAM,IAAI,MAAM,kGAAkG;AACpH"}
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';
package/dist/server.mjs CHANGED
@@ -1,11 +1,13 @@
1
1
 
2
+ import { defineLanguages } from "./language.mjs";
2
3
  import { I18nProvider as I18nProvider$1 } from "./client.mjs";
3
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";
4
8
  import "server-only";
5
9
  import requestConfig from "@fluentic/i18n-nextjs/request";
6
- import { createI18nManager, createI18nManager as createI18nManager$1, defineTranslationLoader, setRuntimeResolver, withRuntime } from "@fluentic/i18n/adapter";
7
10
  import { AsyncLocalStorage } from "node:async_hooks";
8
- import React, { cache } from "react";
9
11
  // src/server.ts
10
12
  const explicitScope = new AsyncLocalStorage();
11
13
  function createServerManaged() {
@@ -29,15 +31,23 @@ async function initialize(managed, config) {
29
31
  const getRequestManaged = cache(async () => initialize(getManaged(), await requestConfig()));
30
32
  /** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */
31
33
  async function ready() {
32
- return (explicitScope.getStore() ?? await getRequestManaged()).manager.getSnapshot();
34
+ const current = explicitScope.getStore() ?? await getRequestManaged();
35
+ return getSnapshot(current);
33
36
  }
34
37
  async function resolveI18n(config) {
35
- return (await initialize(createServerManaged(), config)).manager.getSnapshot();
38
+ return getSnapshot(await initialize(createServerManaged(), config));
36
39
  }
37
40
  /** Route handlers, server actions: isolate the entire async operation explicitly. */
38
41
  async function runWithI18n(config, fn) {
39
42
  const managed = await initialize(createServerManaged(), config);
40
- return explicitScope.run(managed, fn);
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;
41
51
  }
42
52
  function ServerMessage({ render }) {
43
53
  const runtime = (explicitScope.getStore() ?? getManaged()).runtime;
@@ -46,24 +56,21 @@ function ServerMessage({ render }) {
46
56
  async function I18nProvider({ children, snapshot }) {
47
57
  return React.createElement(I18nProvider$1, { snapshot: snapshot ?? await ready() }, children);
48
58
  }
49
- const I18nManager = new Proxy({}, { get(_target, key) {
59
+ new Proxy({}, { get(_target, key) {
50
60
  return (...args) => {
51
61
  const manager = (explicitScope.getStore() ?? getManaged()).manager;
52
62
  return Reflect.apply(manager[key], manager, args);
53
63
  };
54
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
+ } };
55
69
  const I18nState = {
56
70
  get: () => (explicitScope.getStore() ?? getManaged()).state.get(),
57
71
  subscribe: (_listener) => () => {},
58
72
  use: () => (explicitScope.getStore() ?? getManaged()).state.get()
59
73
  };
60
- function useI18nRuntime() {
61
- return (explicitScope.getStore() ?? getManaged()).runtime;
62
- }
63
- function useI18nRenderer(renderer) {
64
- const runtime = useI18nRuntime();
65
- return ((...args) => withRuntime(runtime, () => renderer(...args)));
66
- }
67
- export { I18nManager, I18nProvider, I18nState, createI18nManager, defineRequestConfig, defineTranslationLoader, ready, resolveI18n, runWithI18n, useI18nRenderer, useI18nRuntime };
74
+ export { I18nManager, I18nProvider, I18nState, createI18nManager, defineLanguages, defineRequestConfig, defineTranslationLoader, i18nFn, ready, resolveI18n, runWithI18n };
68
75
 
69
76
  //# sourceMappingURL=server.mjs.map
@@ -1 +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 {\n createI18nManager,\n type I18nSnapshot,\n type ManagedI18n,\n type PartsRenderer,\n setRuntimeResolver,\n withRuntime,\n} from '@fluentic/i18n/adapter';\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport React, { cache } from 'react';\nimport { I18nProvider as ClientProvider } from './client';\nimport type { RequestConfig } from './config';\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 current.manager.getSnapshot();\n}\nexport async function resolveI18n(config: RequestConfig): Promise<I18nSnapshot> {\n return (await initialize(createServerManaged(), config)).manager.getSnapshot();\n}\n/** Route handlers, server actions: isolate the entire async operation explicitly. */\nexport async function runWithI18n<T>(config: RequestConfig, fn: () => T | Promise<T>): Promise<T> {\n const managed = await initialize(createServerManaged(), config);\n return explicitScope.run(managed, fn);\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.\nexport const I18nManager: ManagedI18n['manager'] = 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 I18nState = {\n get: () => (explicitScope.getStore() ?? getManaged()).state.get(),\n subscribe: (_listener: () => void) => () => {},\n use: () => (explicitScope.getStore() ?? getManaged()).state.get(),\n};\nexport function useI18nRuntime() {\n return (explicitScope.getStore() ?? getManaged()).runtime;\n}\nexport function useI18nRenderer<F extends (...args: any[]) => any>(renderer: F): F {\n const runtime = useI18nRuntime();\n return ((...args: Parameters<F>) => withRuntime(runtime, () => renderer(...args))) as F;\n}\nexport { createI18nManager, defineTranslationLoader } from '@fluentic/i18n/adapter';\n"],"mappings":";;;;;;;;;AAgBA,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;CAEnD,QADgB,cAAc,SAAS,KAAK,MAAM,kBAAkB,EAAA,CACrD,QAAQ,YAAY;AACrC;AACA,eAAsB,YAAY,QAA8C;CAC9E,QAAQ,MAAM,WAAW,oBAAoB,GAAG,MAAM,EAAA,CAAG,QAAQ,YAAY;AAC/E;;AAEA,eAAsB,YAAe,QAAuB,IAAsC;CAChG,MAAM,UAAU,MAAM,WAAW,oBAAoB,GAAG,MAAM;CAC9D,OAAO,cAAc,IAAI,SAAS,EAAE;AACtC;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;AAEA,MAAa,cAAsC,IAAI,MAAM,CAAC,GAA6B,EACzF,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,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;AACA,SAAgB,iBAAiB;CAC/B,QAAQ,cAAc,SAAS,KAAK,WAAW,EAAA,CAAG;AACpD;AACA,SAAgB,gBAAmD,UAAgB;CACjF,MAAM,UAAU,eAAe;CAC/B,SAAS,GAAG,SAAwB,YAAY,eAAe,SAAS,GAAG,IAAI,CAAC;AAClF"}
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
+ 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,6 @@
1
1
  {
2
2
  "name": "@fluentic/i18n-nextjs",
3
- "version": "0.1.0-beta.1",
3
+ "version": "0.1.0-beta.2",
4
4
  "description": "Next.js App Router and React Server Component bindings for Fluentic i18n.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -18,7 +18,6 @@
18
18
  },
19
19
  "files": [
20
20
  "dist",
21
- "src",
22
21
  "README.md",
23
22
  "CHANGELOG.md",
24
23
  "LICENSE"
@@ -28,48 +27,93 @@
28
27
  ],
29
28
  "exports": {
30
29
  ".": {
31
- "types": "./src/client.ts",
30
+ "types": "./dist/client.d.ts",
32
31
  "react-server": "./dist/server.mjs",
33
32
  "default": "./dist/client.mjs"
34
33
  },
35
34
  "./server": {
36
- "types": "./src/server.ts",
35
+ "types": "./dist/server.d.ts",
37
36
  "react-server": "./dist/server.mjs",
38
37
  "node": "./dist/server.mjs",
39
38
  "default": "./dist/unavailable.mjs"
40
39
  },
41
40
  "./config": {
42
- "types": "./src/config.ts",
41
+ "types": "./dist/config.d.ts",
43
42
  "default": "./dist/config.mjs"
44
43
  },
44
+ "./language": {
45
+ "types": "./dist/language.d.ts",
46
+ "default": "./dist/language.mjs"
47
+ },
45
48
  "./request": {
46
- "types": "./src/request.ts",
49
+ "types": "./dist/request.d.ts",
47
50
  "default": "./dist/request.mjs"
48
51
  },
49
- "./plugin": {
50
- "types": "./src/plugin.ts",
51
- "default": "./dist/plugin.mjs"
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"
52
95
  }
53
96
  },
54
97
  "dependencies": {
55
98
  "server-only": "^0.0.1"
56
99
  },
57
100
  "peerDependencies": {
58
- "react": ">=19",
101
+ "@fluentic/i18n": ">=0.1.0-beta.2 <0.2.0",
59
102
  "next": ">=15",
60
- "@fluentic/i18n": "0.1.0-beta.1"
103
+ "react": ">=19"
61
104
  },
62
105
  "devDependencies": {
63
- "react": "^19.2.0",
64
- "@types/react": "^19.2.14",
65
106
  "@types/node": "^22.15.0",
66
- "next": "^16.0.0",
107
+ "@types/react": "^19.2.14",
108
+ "next": "^16.4.6",
109
+ "react": "^19.2.0",
67
110
  "tsdown": "^0.22.1",
68
- "typescript": "^5.9.3",
69
- "@fluentic/i18n": "0.1.0-beta.1"
111
+ "typescript": "^7.0.2",
112
+ "@fluentic/i18n": "0.1.0-beta.2"
70
113
  },
71
114
  "scripts": {
72
- "build": "tsdown",
115
+ "build": "tsdown && tsc -p tsconfig.build.json",
116
+ "test": "pnpm build && node --test test/*.test.mjs",
73
117
  "typecheck": "tsc --noEmit"
74
118
  }
75
119
  }
package/dist/client.d.mts DELETED
@@ -1,4 +0,0 @@
1
-
2
- import { I18nManager, I18nProvider, I18nState, createI18nManager, defineTranslationLoader, useI18nRenderer, useI18nRuntime } from "@fluentic/i18n/react";
3
- import { I18nSnapshot, ManagedI18n } from "@fluentic/i18n/adapter";
4
- export { I18nManager, I18nProvider, type I18nSnapshot, I18nState, type ManagedI18n, createI18nManager, defineTranslationLoader, useI18nRenderer, useI18nRuntime };
package/dist/config.d.mts DELETED
@@ -1,11 +0,0 @@
1
-
2
- import { Formats, I18nManagerOptions, TranslationData, TranslationLoader } from "@fluentic/i18n/adapter";
3
- type RequestConfig = I18nManagerOptions & {
4
- translationLoader?: TranslationLoader;
5
- translations?: TranslationData;
6
- formats?: Partial<Formats>;
7
- };
8
- type RequestConfigFactory = () => RequestConfig | Promise<RequestConfig>;
9
- declare function defineRequestConfig<T extends RequestConfigFactory>(factory: T): T;
10
- export { RequestConfig, RequestConfigFactory, defineRequestConfig };
11
- //# sourceMappingURL=config.d.mts.map
package/dist/plugin.d.mts DELETED
@@ -1,10 +0,0 @@
1
-
2
- type NextPluginOptions = {
3
- requestConfig: string;
4
- config?: string;
5
- compiled?: boolean;
6
- };
7
- /** One Next integration; preserves the application's existing webpack hook/rules. */
8
- declare function withFluentic(options: NextPluginOptions): (nextConfig?: any) => any;
9
- export { NextPluginOptions, withFluentic as default };
10
- //# sourceMappingURL=plugin.d.mts.map
package/dist/plugin.mjs DELETED
@@ -1,60 +0,0 @@
1
-
2
- import { createRequire } from "node:module";
3
- import FluenticPlugin from "@fluentic/i18n/plugin/webpack";
4
- import { relative, resolve } from "node:path";
5
- // src/plugin.ts
6
- const require = createRequire(import.meta.url);
7
- /** One Next integration; preserves the application's existing webpack hook/rules. */
8
- function withFluentic(options) {
9
- const request = resolve(options.requestConfig);
10
- const loader = require.resolve("@fluentic/i18n/plugin/webpack-loader");
11
- const compilerOptions = {
12
- ...options.config ? { config: resolve(options.config) } : {},
13
- ...options.compiled !== void 0 ? { compiled: options.compiled } : {}
14
- };
15
- return (nextConfig = {}) => ({
16
- ...nextConfig,
17
- turbopack: {
18
- ...nextConfig.turbopack,
19
- resolveAlias: {
20
- ...nextConfig.turbopack?.resolveAlias,
21
- "@fluentic/i18n-nextjs/request": "./" + relative(process.cwd(), request).replace(/\\/g, "/")
22
- },
23
- rules: {
24
- ...nextConfig.turbopack?.rules,
25
- ...Object.fromEntries([
26
- "*.js",
27
- "*.jsx",
28
- "*.ts",
29
- "*.tsx",
30
- "*.mjs",
31
- "*.mts"
32
- ].map((pattern) => [pattern, [...nextConfig.turbopack?.rules?.[pattern] ? [nextConfig.turbopack.rules[pattern]].flat() : [], {
33
- condition: { not: "foreign" },
34
- loaders: [{
35
- loader,
36
- options: compilerOptions
37
- }]
38
- }]])),
39
- "*.jsonl": {
40
- loaders: [{
41
- loader,
42
- options: compilerOptions
43
- }],
44
- as: "*.js"
45
- }
46
- }
47
- },
48
- webpack(config, context) {
49
- config.resolve ??= {};
50
- config.resolve.alias ??= {};
51
- config.resolve.alias["@fluentic/i18n-nextjs/request$"] = request;
52
- config.plugins ??= [];
53
- config.plugins.push(new FluenticPlugin(compilerOptions));
54
- return nextConfig.webpack ? nextConfig.webpack(config, context) : config;
55
- }
56
- });
57
- }
58
- export { withFluentic as default };
59
-
60
- //# sourceMappingURL=plugin.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"plugin.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import FluenticPlugin from '@fluentic/i18n/plugin/webpack';\nimport { createRequire } from 'node:module';\nimport { relative, resolve } from 'node:path';\nconst require = createRequire(import.meta.url);\nexport type NextPluginOptions = { requestConfig: string; config?: string; compiled?: boolean; };\n/** One Next integration; preserves the application's existing webpack hook/rules. */\nexport default function withFluentic(options: NextPluginOptions) {\n const request = resolve(options.requestConfig);\n const loader = require.resolve('@fluentic/i18n/plugin/webpack-loader');\n const compilerOptions = {\n ...(options.config ? { config: resolve(options.config) } : {}),\n ...(options.compiled !== undefined ? { compiled: options.compiled } : {}),\n };\n return (nextConfig: any = {}) => ({\n ...nextConfig,\n turbopack: {\n ...nextConfig.turbopack,\n resolveAlias: {\n ...nextConfig.turbopack?.resolveAlias,\n '@fluentic/i18n-nextjs/request': './' + relative(process.cwd(), request).replace(/\\\\/g, '/'),\n },\n rules: {\n ...nextConfig.turbopack?.rules,\n ...Object.fromEntries(['*.js', '*.jsx', '*.ts', '*.tsx', '*.mjs', '*.mts'].map((pattern) => [pattern, [\n ...(nextConfig.turbopack?.rules?.[pattern] ? [nextConfig.turbopack.rules[pattern]].flat() : []),\n { condition: { not: 'foreign' }, loaders: [{ loader, options: compilerOptions }] },\n ]])),\n '*.jsonl': { loaders: [{ loader, options: compilerOptions }], as: '*.js' },\n },\n },\n webpack(config: any, context: any) {\n config.resolve ??= {};\n config.resolve.alias ??= {};\n config.resolve.alias['@fluentic/i18n-nextjs/request$'] = request;\n config.plugins ??= [];\n config.plugins.push(new FluenticPlugin(compilerOptions));\n return nextConfig.webpack ? nextConfig.webpack(config, context) : config;\n },\n });\n}\n"],"mappings":";;;;;AAGA,MAAM,UAAU,cAAc,YAAY,GAAG;;AAG7C,SAAwB,aAAa,SAA4B;CAC/D,MAAM,UAAU,QAAQ,QAAQ,aAAa;CAC7C,MAAM,SAAS,QAAQ,QAAQ,sCAAsC;CACrE,MAAM,kBAAkB;EACtB,GAAI,QAAQ,SAAS,EAAE,QAAQ,QAAQ,QAAQ,MAAM,EAAE,IAAI,CAAC;EAC5D,GAAI,QAAQ,aAAa,KAAA,IAAY,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;CACzE;CACA,QAAQ,aAAkB,CAAC,OAAO;EAChC,GAAG;EACH,WAAW;GACT,GAAG,WAAW;GACd,cAAc;IACZ,GAAG,WAAW,WAAW;IACzB,iCAAiC,OAAO,SAAS,QAAQ,IAAI,GAAG,OAAO,CAAC,CAAC,QAAQ,OAAO,GAAG;GAC7F;GACA,OAAO;IACL,GAAG,WAAW,WAAW;IACzB,GAAG,OAAO,YAAY;KAAC;KAAQ;KAAS;KAAQ;KAAS;KAAS;IAAO,CAAC,CAAC,KAAK,YAAY,CAAC,SAAS,CACpG,GAAI,WAAW,WAAW,QAAQ,WAAW,CAAC,WAAW,UAAU,MAAM,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,GAC7F;KAAE,WAAW,EAAE,KAAK,UAAU;KAAG,SAAS,CAAC;MAAE;MAAQ,SAAS;KAAgB,CAAC;IAAE,CACnF,CAAC,CAAC,CAAC;IACH,WAAW;KAAE,SAAS,CAAC;MAAE;MAAQ,SAAS;KAAgB,CAAC;KAAG,IAAI;IAAO;GAC3E;EACF;EACA,QAAQ,QAAa,SAAc;GACjC,OAAO,YAAY,CAAC;GACpB,OAAO,QAAQ,UAAU,CAAC;GAC1B,OAAO,QAAQ,MAAM,oCAAoC;GACzD,OAAO,YAAY,CAAC;GACpB,OAAO,QAAQ,KAAK,IAAI,eAAe,eAAe,CAAC;GACvD,OAAO,WAAW,UAAU,WAAW,QAAQ,QAAQ,OAAO,IAAI;EACpE;CACF;AACF"}
@@ -1,5 +0,0 @@
1
-
2
- import { RequestConfigFactory } from "./config.mjs";
3
- declare const missing: RequestConfigFactory;
4
- export { missing as default };
5
- //# sourceMappingURL=request.d.mts.map
package/dist/server.d.mts DELETED
@@ -1,29 +0,0 @@
1
-
2
- import { RequestConfig, RequestConfigFactory, defineRequestConfig } from "./config.mjs";
3
- import "server-only";
4
- import { I18nSnapshot, ManagedI18n, createI18nManager, defineTranslationLoader } from "@fluentic/i18n/adapter";
5
- import React from "react";
6
- /** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */
7
- declare function ready(): Promise<I18nSnapshot>;
8
- declare function resolveI18n(config: RequestConfig): Promise<I18nSnapshot>;
9
- /** Route handlers, server actions: isolate the entire async operation explicitly. */
10
- declare function runWithI18n<T>(config: RequestConfig, fn: () => T | Promise<T>): Promise<T>;
11
- declare function I18nProvider({ children, snapshot }: {
12
- children?: React.ReactNode;
13
- snapshot?: I18nSnapshot;
14
- }): Promise<React.FunctionComponentElement<{
15
- children?: React.ReactNode;
16
- snapshot?: I18nSnapshot;
17
- instance?: ManagedI18n;
18
- lineBreak?: React.ReactNode;
19
- }>>;
20
- declare const I18nManager: ManagedI18n['manager'];
21
- declare const I18nState: {
22
- get: () => import("@fluentic/i18n/adapter").StateData;
23
- subscribe: (_listener: () => void) => () => void;
24
- use: () => import("@fluentic/i18n/adapter").StateData;
25
- };
26
- declare function useI18nRuntime(): import("@fluentic/i18n/adapter").Runtime;
27
- declare function useI18nRenderer<F extends (...args: any[]) => any>(renderer: F): F;
28
- export { I18nManager, I18nProvider, I18nState, type RequestConfig, type RequestConfigFactory, createI18nManager, defineRequestConfig, defineTranslationLoader, ready, resolveI18n, runWithI18n, useI18nRenderer, useI18nRuntime };
29
- //# sourceMappingURL=server.d.mts.map
@@ -1,2 +0,0 @@
1
-
2
- export {}
package/src/client.ts DELETED
@@ -1,10 +0,0 @@
1
- export type { I18nSnapshot, ManagedI18n } from '@fluentic/i18n/adapter';
2
- export {
3
- createI18nManager,
4
- defineTranslationLoader,
5
- I18nManager,
6
- I18nProvider,
7
- I18nState,
8
- useI18nRenderer,
9
- useI18nRuntime,
10
- } from '@fluentic/i18n/react';
package/src/plugin.ts DELETED
@@ -1,40 +0,0 @@
1
- import FluenticPlugin from '@fluentic/i18n/plugin/webpack';
2
- import { createRequire } from 'node:module';
3
- import { relative, resolve } from 'node:path';
4
- const require = createRequire(import.meta.url);
5
- export type NextPluginOptions = { requestConfig: string; config?: string; compiled?: boolean; };
6
- /** One Next integration; preserves the application's existing webpack hook/rules. */
7
- export default function withFluentic(options: NextPluginOptions) {
8
- const request = resolve(options.requestConfig);
9
- const loader = require.resolve('@fluentic/i18n/plugin/webpack-loader');
10
- const compilerOptions = {
11
- ...(options.config ? { config: resolve(options.config) } : {}),
12
- ...(options.compiled !== undefined ? { compiled: options.compiled } : {}),
13
- };
14
- return (nextConfig: any = {}) => ({
15
- ...nextConfig,
16
- turbopack: {
17
- ...nextConfig.turbopack,
18
- resolveAlias: {
19
- ...nextConfig.turbopack?.resolveAlias,
20
- '@fluentic/i18n-nextjs/request': './' + relative(process.cwd(), request).replace(/\\/g, '/'),
21
- },
22
- rules: {
23
- ...nextConfig.turbopack?.rules,
24
- ...Object.fromEntries(['*.js', '*.jsx', '*.ts', '*.tsx', '*.mjs', '*.mts'].map((pattern) => [pattern, [
25
- ...(nextConfig.turbopack?.rules?.[pattern] ? [nextConfig.turbopack.rules[pattern]].flat() : []),
26
- { condition: { not: 'foreign' }, loaders: [{ loader, options: compilerOptions }] },
27
- ]])),
28
- '*.jsonl': { loaders: [{ loader, options: compilerOptions }], as: '*.js' },
29
- },
30
- },
31
- webpack(config: any, context: any) {
32
- config.resolve ??= {};
33
- config.resolve.alias ??= {};
34
- config.resolve.alias['@fluentic/i18n-nextjs/request$'] = request;
35
- config.plugins ??= [];
36
- config.plugins.push(new FluenticPlugin(compilerOptions));
37
- return nextConfig.webpack ? nextConfig.webpack(config, context) : config;
38
- },
39
- });
40
- }
package/src/request.ts DELETED
@@ -1,5 +0,0 @@
1
- import type { RequestConfigFactory } from './config';
2
- const missing: RequestConfigFactory = () => {
3
- throw new Error('[i18n] configure @fluentic/i18n-nextjs/plugin with requestConfig pointing to your request module');
4
- };
5
- export default missing;
package/src/server.ts DELETED
@@ -1,87 +0,0 @@
1
- import 'server-only';
2
- import requestConfig from '@fluentic/i18n-nextjs/request';
3
- import {
4
- createI18nManager,
5
- type I18nSnapshot,
6
- type ManagedI18n,
7
- type PartsRenderer,
8
- setRuntimeResolver,
9
- withRuntime,
10
- } from '@fluentic/i18n/adapter';
11
- import { AsyncLocalStorage } from 'node:async_hooks';
12
- import React, { cache } from 'react';
13
- import { I18nProvider as ClientProvider } from './client';
14
- import type { RequestConfig } from './config';
15
- export { defineRequestConfig } from './config';
16
- export type { RequestConfig, RequestConfigFactory } from './config';
17
- const explicitScope = new AsyncLocalStorage<ManagedI18n>();
18
- function createServerManaged() {
19
- const managed = createI18nManager();
20
- managed.runtime.jsxHandler = (_options, render) => React.createElement(ServerMessage, { render });
21
- managed.runtime.tagElement = (element) => {
22
- if (!React.isValidElement(element)) throw new TypeError('[i18n] t.tag expects a React element or handler');
23
- return (chunks) => React.cloneElement(element, undefined, ...chunks as React.ReactNode[]);
24
- };
25
- return managed;
26
- }
27
- const getManaged = cache(createServerManaged);
28
- setRuntimeResolver(() => (explicitScope.getStore() ?? getManaged()).runtime);
29
- async function initialize(managed: ManagedI18n, config: RequestConfig) {
30
- managed.manager.configure(config);
31
- if (config.formats) managed.runtime.formats = config.formats;
32
- managed.manager.setTranslationLoader(
33
- config.translationLoader ?? (({ languageId }) => languageId === config.languageId ? config.translations ?? [] : []),
34
- );
35
- await managed.manager.init();
36
- return managed;
37
- }
38
- const getRequestManaged = cache(async () => initialize(getManaged(), await requestConfig()));
39
- /** Await in the execution path that uses synchronous t.text; layouts do not order siblings. */
40
- export async function ready(): Promise<I18nSnapshot> {
41
- const current = explicitScope.getStore() ?? await getRequestManaged();
42
- return current.manager.getSnapshot();
43
- }
44
- export async function resolveI18n(config: RequestConfig): Promise<I18nSnapshot> {
45
- return (await initialize(createServerManaged(), config)).manager.getSnapshot();
46
- }
47
- /** Route handlers, server actions: isolate the entire async operation explicitly. */
48
- export async function runWithI18n<T>(config: RequestConfig, fn: () => T | Promise<T>): Promise<T> {
49
- const managed = await initialize(createServerManaged(), config);
50
- return explicitScope.run(managed, fn);
51
- }
52
- function ServerMessage({ render }: { render: PartsRenderer; }) {
53
- const runtime = (explicitScope.getStore() ?? getManaged()).runtime;
54
- // t.jsx is synchronous. The caller/provider must initialize before actual rendering.
55
- return React.createElement(
56
- React.Fragment,
57
- null,
58
- ...render(runtime).map((part, index) =>
59
- React.createElement(React.Fragment, { key: index }, part as React.ReactNode)
60
- ),
61
- );
62
- }
63
- export async function I18nProvider({ children, snapshot }: { children?: React.ReactNode; snapshot?: I18nSnapshot; }) {
64
- return React.createElement(ClientProvider, { snapshot: snapshot ?? await ready() }, children);
65
- }
66
- // Resolve at invocation time, never capture a request in a module-level singleton.
67
- export const I18nManager: ManagedI18n['manager'] = new Proxy({} as ManagedI18n['manager'], {
68
- get(_target, key: keyof ManagedI18n['manager']) {
69
- return (...args: unknown[]) => {
70
- const manager = (explicitScope.getStore() ?? getManaged()).manager;
71
- return Reflect.apply(manager[key], manager, args);
72
- };
73
- },
74
- });
75
- export const I18nState = {
76
- get: () => (explicitScope.getStore() ?? getManaged()).state.get(),
77
- subscribe: (_listener: () => void) => () => {},
78
- use: () => (explicitScope.getStore() ?? getManaged()).state.get(),
79
- };
80
- export function useI18nRuntime() {
81
- return (explicitScope.getStore() ?? getManaged()).runtime;
82
- }
83
- export function useI18nRenderer<F extends (...args: any[]) => any>(renderer: F): F {
84
- const runtime = useI18nRuntime();
85
- return ((...args: Parameters<F>) => withRuntime(runtime, () => renderer(...args))) as F;
86
- }
87
- export { createI18nManager, defineTranslationLoader } from '@fluentic/i18n/adapter';
@@ -1,2 +0,0 @@
1
- throw new Error('[i18n] @fluentic/i18n-nextjs/server is only available on the server');
2
- export {};