next-intl 3.26.1 → 3.26.3

package/dist/development/react-client/useLocale.js

@@ -6,6 +6,7 @@ var navigation = require('next/navigation');
 var _useLocale = require('use-intl/_useLocale');
 var constants = require('../shared/constants.js');
 
+let hasWarnedForParams = false;
 function useLocale() {
   // The types aren't entirely correct here. Outside of Next.js
   // `useParams` can be called, but the return type is `null`.
@@ -17,6 +18,10 @@ function useLocale() {
     locale = _useLocale.useLocale();
   } catch (error) {
     if (typeof (params === null || params === void 0 ? void 0 : params[constants.LOCALE_SEGMENT_NAME]) === 'string') {
+      if (!hasWarnedForParams) {
+        console.warn('Deprecation warning: `useLocale` has returned a default from `useParams().locale` since no `NextIntlClientProvider` ancestor was found for the calling component. This behavior will be removed in the next major version. Please ensure all Client Components that use `next-intl` are wrapped in a `NextIntlClientProvider`.');
+        hasWarnedForParams = true;
+      }
       locale = params[constants.LOCALE_SEGMENT_NAME];
     } else {
       throw error;

package/dist/development/server/react-server/getConfig.js

@@ -13,6 +13,9 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var getRuntimeConfig__default = /*#__PURE__*/_interopDefault(getRuntimeConfig);
 
+let hasWarnedForMissingReturnedLocale = false;
+let hasWarnedForAccessedLocaleParam = false;
+
 // Make sure `now` is consistent across the request in case none was configured
 function getDefaultNowImpl() {
   return new Date();
@@ -34,6 +37,10 @@ async function receiveRuntimeConfigImpl(getConfig, localeOverride) {
     // `locale` (either in a single-language workflow or because the locale is
     // read from the user settings), don't attempt to read the request locale.
     get locale() {
+      if (!hasWarnedForAccessedLocaleParam) {
+        console.warn("\nThe `locale` parameter in `getRequestConfig` is deprecated, please switch to `await requestLocale`. See https://next-intl.dev/blog/next-intl-3-22#await-request-locale\n");
+        hasWarnedForAccessedLocaleParam = true;
+      }
       return localeOverride || RequestLocaleLegacy.getRequestLocale();
     },
     get requestLocale() {
@@ -44,12 +51,19 @@ async function receiveRuntimeConfigImpl(getConfig, localeOverride) {
   if (result instanceof Promise) {
     result = await result;
   }
-  const locale = result.locale || (await params.requestLocale);
+  let locale = result.locale;
   if (!locale) {
-    {
-      console.error("\nUnable to find `next-intl` locale because the middleware didn't run on this request and no `locale` was returned in `getRequestConfig`. See https://next-intl.dev/docs/routing/middleware#unable-to-find-locale. The `notFound()` function will be called as a result.\n");
+    if (!hasWarnedForMissingReturnedLocale) {
+      console.error("\nA `locale` is expected to be returned from `getRequestConfig`, but none was returned. This will be an error in the next major version of next-intl.\n\nSee: https://next-intl.dev/blog/next-intl-3-22#await-request-locale\n");
+      hasWarnedForMissingReturnedLocale = true;
+    }
+    locale = await params.requestLocale;
+    if (!locale) {
+      {
+        console.error("\nUnable to find `next-intl` locale because the middleware didn't run on this request and no `locale` was returned in `getRequestConfig`. See https://next-intl.dev/docs/routing/middleware#unable-to-find-locale. The `notFound()` function will be called as a result.\n");
+      }
+      navigation.notFound();
     }
-    navigation.notFound();
   }
   return {
     ...result,

package/dist/esm/react-client/useLocale.js

@@ -1 +1 @@
-import{useParams as t}from"next/navigation";import{useLocale as o}from"use-intl/_useLocale";import{LOCALE_SEGMENT_NAME as r}from"../shared/constants.js";function e(){const e=t();let n;try{n=o()}catch(t){if("string"!=typeof(null==e?void 0:e[r]))throw t;n=e[r]}return n}export{e as default};
+import{useParams as e}from"next/navigation";import{useLocale as t}from"use-intl/_useLocale";import{LOCALE_SEGMENT_NAME as n}from"../shared/constants.js";let o=!1;function r(){const r=e();let a;try{a=t()}catch(e){if("string"!=typeof(null==r?void 0:r[n]))throw e;o||(console.warn("Deprecation warning: `useLocale` has returned a default from `useParams().locale` since no `NextIntlClientProvider` ancestor was found for the calling component. This behavior will be removed in the next major version. Please ensure all Client Components that use `next-intl` are wrapped in a `NextIntlClientProvider`."),o=!0),a=r[n]}return a}export{r as default};

package/dist/esm/server/react-server/getConfig.js

@@ -1 +1 @@
-import{notFound as e}from"next/navigation";import{cache as t}from"react";import{_createIntlFormatters as n,_createCache as o,initializeConfig as r}from"use-intl/core";import{getRequestLocale as i}from"./RequestLocale.js";import{getRequestLocale as a}from"./RequestLocaleLegacy.js";import s from"next-intl/config";const c=t((function(){return new Date}));const l=t((function(){return Intl.DateTimeFormat().resolvedOptions().timeZone}));const u=t((async function(t,n){if("function"!=typeof t)throw new Error("Invalid i18n request configuration detected.\n\nPlease verify that:\n1. In case you've specified a custom location in your Next.js config, make sure that the path is correct.\n2. You have a default export in your i18n request configuration file.\n\nSee also: https://next-intl.dev/docs/usage/configuration#i18n-request\n");const o={get locale(){return n||a()},get requestLocale(){return n?Promise.resolve(n):i()}};let r=t(o);r instanceof Promise&&(r=await r);const s=r.locale||await o.requestLocale;return s||(console.error("\nUnable to find `next-intl` locale because the middleware didn't run on this request and no `locale` was returned in `getRequestConfig`. See https://next-intl.dev/docs/routing/middleware#unable-to-find-locale. The `notFound()` function will be called as a result.\n"),e()),{...r,locale:s,now:r.now||c(),timeZone:r.timeZone||l()}})),f=t(n),m=t(o);const d=t((async function(e){const t=await u(s,e);return{...r(t),_formatters:f(m())}}));export{d as default};
+import{notFound as e}from"next/navigation";import{cache as t}from"react";import{_createIntlFormatters as n,_createCache as o,initializeConfig as r}from"use-intl/core";import{getRequestLocale as i}from"./RequestLocale.js";import{getRequestLocale as a}from"./RequestLocaleLegacy.js";import l from"next-intl/config";let s=!1,c=!1;const u=t((function(){return new Date}));const f=t((function(){return Intl.DateTimeFormat().resolvedOptions().timeZone}));const d=t((async function(t,n){if("function"!=typeof t)throw new Error("Invalid i18n request configuration detected.\n\nPlease verify that:\n1. In case you've specified a custom location in your Next.js config, make sure that the path is correct.\n2. You have a default export in your i18n request configuration file.\n\nSee also: https://next-intl.dev/docs/usage/configuration#i18n-request\n");const o={get locale(){return c||(console.warn("\nThe `locale` parameter in `getRequestConfig` is deprecated, please switch to `await requestLocale`. See https://next-intl.dev/blog/next-intl-3-22#await-request-locale\n"),c=!0),n||a()},get requestLocale(){return n?Promise.resolve(n):i()}};let r=t(o);r instanceof Promise&&(r=await r);let l=r.locale;return l||(s||(console.error("\nA `locale` is expected to be returned from `getRequestConfig`, but none was returned. This will be an error in the next major version of next-intl.\n\nSee: https://next-intl.dev/blog/next-intl-3-22#await-request-locale\n"),s=!0),l=await o.requestLocale,l||(console.error("\nUnable to find `next-intl` locale because the middleware didn't run on this request and no `locale` was returned in `getRequestConfig`. See https://next-intl.dev/docs/routing/middleware#unable-to-find-locale. The `notFound()` function will be called as a result.\n"),e())),{...r,locale:l,now:r.now||u(),timeZone:r.timeZone||f()}})),m=t(n),g=t(o);const p=t((async function(e){const t=await d(l,e);return{...r(t),_formatters:m(g())}}));export{p as default};

package/dist/production/server/react-server/getConfig.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("next/navigation"),t=require("react"),n=require("use-intl/core"),r=require("./RequestLocale.js"),o=require("./RequestLocaleLegacy.js");function c(e){return e&&e.__esModule?e:{default:e}}var a=c(require("next-intl/config"));const i=t.cache((function(){return new Date}));const u=t.cache((function(){return Intl.DateTimeFormat().resolvedOptions().timeZone}));const s=t.cache((async function(t,n){const c={get locale(){return n||o.getRequestLocale()},get requestLocale(){return n?Promise.resolve(n):r.getRequestLocale()}};let a=t(c);a instanceof Promise&&(a=await a);const s=a.locale||await c.requestLocale;return s||e.notFound(),{...a,locale:s,now:a.now||i(),timeZone:a.timeZone||u()}})),l=t.cache(n._createIntlFormatters),f=t.cache(n._createCache);const q=t.cache((async function(e){const t=await s(a.default,e);return{...n.initializeConfig(t),_formatters:l(f())}}));exports.default=q;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("next/navigation"),t=require("react"),n=require("use-intl/core"),r=require("./RequestLocale.js"),o=require("./RequestLocaleLegacy.js");function c(e){return e&&e.__esModule?e:{default:e}}var a=c(require("next-intl/config"));const i=t.cache((function(){return new Date}));const u=t.cache((function(){return Intl.DateTimeFormat().resolvedOptions().timeZone}));const s=t.cache((async function(t,n){const c={get locale(){return n||o.getRequestLocale()},get requestLocale(){return n?Promise.resolve(n):r.getRequestLocale()}};let a=t(c);a instanceof Promise&&(a=await a);let s=a.locale;return s||(s=await c.requestLocale,s||e.notFound()),{...a,locale:s,now:a.now||i(),timeZone:a.timeZone||u()}})),l=t.cache(n._createIntlFormatters),f=t.cache(n._createCache);const q=t.cache((async function(e){const t=await s(a.default,e);return{...n.initializeConfig(t),_formatters:l(f())}}));exports.default=q;

package/dist/types/src/server/react-server/getRequestConfig.d.ts

@@ -1,14 +1,7 @@
 import type { IntlConfig } from 'use-intl/core';
 export type RequestConfig = Omit<IntlConfig, 'locale'> & {
     /**
-     * Instead of reading a `requestLocale` from the argument that's passed to the
-     * function within `getRequestConfig`, you can include a locale as part of the
-     * returned request configuration.
-     *
-     * This can be helpful for the following use cases:
-     * - Apps that only support a single language
-     * - Apps where the locale should be read from user settings instead of the pathname
-     * - Providing a fallback locale in case the locale was not matched by the middleware
+     * @see https://next-intl.dev/docs/usage/configuration#i18n-request
      **/
     locale?: IntlConfig['locale'];
 };

package/dist/types/src/server/react-server/getTranslations.d.ts

@@ -87,6 +87,15 @@ declare function getTranslations<NestedKey extends NamespaceKeys<IntlMessages, N
     }, [
         NestedKey
     ] extends [never] ? '!' : `!.${NestedKey}`>>>>(key: TargetKey): any;
+    has<TargetKey extends MessageKeys<NestedValueOf<{
+        '!': IntlMessages;
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>, NestedKeyOf<NestedValueOf<{
+        '!': IntlMessages;
+    }, [
+        NestedKey
+    ] extends [never] ? '!' : `!.${NestedKey}`>>>>(key: [TargetKey] extends [never] ? string : TargetKey): boolean;
 }>;
 declare const _default: typeof getTranslations;
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-intl",
-  "version": "3.26.1",
+  "version": "3.26.3",
   "sideEffects": false,
   "author": "Jan Amann <jan@amann.work>",
   "funding": [
@@ -88,11 +88,11 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.5.4",
     "negotiator": "^1.0.0",
-    "use-intl": "^3.26.1"
+    "use-intl": "^3.26.3"
   },
   "peerDependencies": {
     "next": "^10.0.0 || ^11.0.0 || ^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0",
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || >=19.0.0-rc <19.0.0 || ^19.0.0"
   },
-  "gitHead": "33cae85fcf6421f076358f9db26b5e137e83e543"
+  "gitHead": "0b484fbbe5123eb03fa4e1d4244c4a8c20e6dec4"
 }