cloudflare-next-intl 0.10.28 → 0.10.29

package/README.md

@@ -167,17 +167,19 @@ export function Navigation() {
 ```
 
 `IntlProvider` sends the locale's messages to the client for `useTranslations`
-in client components. Set `clientMessages` in your config to shrink that
-payload: `false` sends none (server-only translations), an array such as
-`["Auth", "Common", "Categories*"]` sends only matching namespaces, or `"auto"`
-uses build-time AST scan via the `autoClientMessages` Vite plugin. Default: `true`.
+in client components. By default, `clientMessages: "auto"` and `autoClientMessages`
+Vite plugin are **enabled by default** with `{ onDynamic: "fallback", fallbackNamespaces: [] }`
+to automatically scan and ship only the namespaces your client components use.
+
+You can customize or disable either side:
+- Set `clientMessages: false` (server-only messages), `true` (all messages), or `["Auth", "Common", "Categories*"]` in intl config.
+- In `vite.config.ts`, pass `autoClientMessages: false` to disable scanning, or customize options:
 
 ```ts
-// vite.config.ts
+// vite.config.ts (optional customization — enabled by default)
 cloudflareNextIntl({
-    autoClientMessages: { fallbackNamespaces: ["Common"], onDynamic: "fallback", packages: ["@my/ui"] }
+    autoClientMessages: { fallbackNamespaces: ["Common"], packages: ["@my/ui"] }
 })
-// intl.config.ts -> setIntlConfig({ clientMessages: "auto", ... })
 ```
 
 > UI library packages can declare `"i18n": { "namespaces": ["Buttons"] }` in `package.json` for automatic inclusion.

package/dist/src/client_messages_scan/scan_project.js

@@ -19,7 +19,7 @@ function walk(dir, out, skipNodeModules) {
 }
 export function scanProject(opts) {
     const files = [];
-    for (const d of opts.dirs ?? ["src", "app", "components"]) {
+    for (const d of opts.dirs ?? ["src", "app", "components", "pages", "shared", "modules", "lib"]) {
         const full = join(opts.root, d);
         if (existsSync(full))
             walk(full, files, true);

package/dist/src/general/pick_client_messages.d.ts

@@ -1,2 +1,2 @@
 import type { TranslationObject } from "../types/types.js";
-export default function pickClientMessages(messages: TranslationObject, clientMessages: boolean | "auto" | readonly string[] | undefined, autoManifest?: string[] | true | undefined): TranslationObject;
+export default function pickClientMessages(messages: TranslationObject, clientMessages?: boolean | "auto" | readonly string[] | undefined, autoManifest?: string[] | true | undefined): TranslationObject;

package/dist/src/general/pick_client_messages.js

@@ -2,9 +2,9 @@ import { matchesNamespacePattern } from "../client_messages_scan/match_namespace
 function readAutoManifest() {
     return typeof __CFNI_CLIENT_MESSAGES__ === "undefined" ? undefined : __CFNI_CLIENT_MESSAGES__;
 }
-export default function pickClientMessages(messages, clientMessages, autoManifest = readAutoManifest()) {
+export default function pickClientMessages(messages, clientMessages = "auto", autoManifest = readAutoManifest()) {
     const list = clientMessages === "auto" ? autoManifest ?? true : clientMessages;
-    if (list === undefined || list === true)
+    if (list === true)
         return messages;
     const picked = {};
     if (list === false)

package/dist/src/vite/auto_client_messages_plugin.js

@@ -2,12 +2,17 @@ import { scanProject } from "../client_messages_scan/scan_project.js";
 const KEY = "__CFNI_CLIENT_MESSAGES__";
 const SOURCE = /\.(tsx?|jsx?|mjs)$/;
 export function autoClientMessagesPlugin(options = {}) {
+    const opts = {
+        onDynamic: "fallback",
+        fallbackNamespaces: [],
+        ...options,
+    };
     let last = "";
     const run = () => {
-        const manifest = scanProject({ ...options, root: options.root ?? process.cwd() });
+        const manifest = scanProject({ ...opts, root: opts.root ?? process.cwd() });
         for (const d of manifest.dynamicCalls)
             console.warn(`[cloudflare-next-intl] dynamic useTranslations: ${d.file}:${d.line} ${d.text}`);
-        if (options.strict && manifest.dynamicCalls.length > 0)
+        if (opts.strict && manifest.dynamicCalls.length > 0)
             throw new Error("[cloudflare-next-intl] Dynamic useTranslations namespaces found. Use literals, union types, or fallbackNamespaces with onDynamic: \"fallback\".");
         console.log(manifest.namespaces === true
             ? `[cloudflare-next-intl] client messages: sending all (root or dynamic access) from ${manifest.scannedFiles} files`

package/dist/src/vite/plugin.js

@@ -55,7 +55,7 @@ export function cloudflareNextIntl(options = {}) {
             ? { root: options.root, ...options.autoImageLoader }
             : { root: options.root }));
     }
-    if (options.autoClientMessages) {
+    if (options.autoClientMessages !== false) {
         plugins.push(autoClientMessagesPlugin(typeof options.autoClientMessages === "object"
             ? { root: options.root, ...options.autoClientMessages }
             : { root: options.root }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudflare-next-intl",
-  "version": "0.10.28",
+  "version": "0.10.29",
   "description": "Optimized Next Intl Package Special for App Router and Cloudflare",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",