use-intl 2.7.5 → 2.7.7-alpha.0

package/dist/use-intl.cjs.development.js

@@ -2,11 +2,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var IntlMessageFormat = require('intl-messageformat');
 var React = require('react');
-var intlMessageformat = require('intl-messageformat');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
+var IntlMessageFormat__default = /*#__PURE__*/_interopDefaultLegacy(IntlMessageFormat);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 function _extends() {
@@ -133,8 +134,6 @@ function _objectWithoutPropertiesLoose(source, excluded) {
   return target;
 }
 
-var IntlContext = /*#__PURE__*/React.createContext(undefined);
-
 exports.IntlErrorCode = void 0;
 
 (function (IntlErrorCode) {
@@ -173,36 +172,6 @@ var IntlError = /*#__PURE__*/function (_Error) {
   return IntlError;
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 
-function validateMessagesSegment(messages, invalidKeyLabels, parentPath) {
-  Object.entries(messages).forEach(function (_ref) {
-    var key = _ref[0],
-        messageOrMessages = _ref[1];
-
-    if (key.includes('.')) {
-      var keyLabel = key;
-      if (parentPath) keyLabel += " (at " + parentPath + ")";
-      invalidKeyLabels.push(keyLabel);
-    }
-
-    if (messageOrMessages != null && typeof messageOrMessages === 'object') {
-      validateMessagesSegment(messageOrMessages, invalidKeyLabels, [parentPath, key].filter(function (part) {
-        return part != null;
-      }).join('.'));
-    }
-  });
-}
-
-function validateMessages(messages, onError) {
-  var invalidKeyLabels = [];
-  validateMessagesSegment(messages, invalidKeyLabels);
-
-  if (invalidKeyLabels.length > 0) {
-    onError(new IntlError(exports.IntlErrorCode.INVALID_KEY, "Namespace keys can not contain the character \".\" as this is used to express nesting. Please remove it or replace it with another character.\n\nInvalid " + (invalidKeyLabels.length === 1 ? 'key' : 'keys') + ": " + invalidKeyLabels.join(', ')));
-  }
-}
-
-var _excluded = ["children", "onError", "getMessageFallback", "messages"];
-
 function defaultGetMessageFallback(_ref) {
   var key = _ref.key,
       namespace = _ref.namespace;
@@ -210,48 +179,10 @@ function defaultGetMessageFallback(_ref) {
     return part != null;
   }).join('.');
 }
-
 function defaultOnError(error) {
   console.error(error);
 }
 
-function IntlProvider(_ref2) {
-  var children = _ref2.children,
-      _ref2$onError = _ref2.onError,
-      onError = _ref2$onError === void 0 ? defaultOnError : _ref2$onError,
-      _ref2$getMessageFallb = _ref2.getMessageFallback,
-      getMessageFallback = _ref2$getMessageFallb === void 0 ? defaultGetMessageFallback : _ref2$getMessageFallb,
-      messages = _ref2.messages,
-      contextValues = _objectWithoutPropertiesLoose(_ref2, _excluded);
-
-  {
-    // eslint-disable-next-line react-hooks/rules-of-hooks
-    React.useEffect(function () {
-      if (messages) {
-        validateMessages(messages, onError);
-      }
-    }, [messages, onError]);
-  }
-
-  return React__default["default"].createElement(IntlContext.Provider, {
-    value: _extends({}, contextValues, {
-      messages: messages,
-      onError: onError,
-      getMessageFallback: getMessageFallback
-    })
-  }, children);
-}
-
-function useIntlContext() {
-  var context = React.useContext(IntlContext);
-
-  if (!context) {
-    throw new Error('No intl context found. Have you configured the provider?' );
-  }
-
-  return context;
-}
-
 function setTimeZoneInFormats(formats, timeZone) {
   if (!formats) return formats; // The only way to set a time zone with `intl-messageformat` is to merge it into the formats
   // https://github.com/formatjs/formatjs/blob/8256c5271505cf2606e48e3c97ecdd16ede4f1b5/packages/intl/src/message.ts#L15
@@ -282,17 +213,17 @@ function convertFormatsToIntlMessageFormat(formats, timeZone) {
   });
 }
 
-function resolvePath(messages, idPath, namespace) {
+function resolvePath(messages, key, namespace) {
   if (!messages) {
     throw new Error("No messages available at `" + namespace + "`." );
   }
 
   var message = messages;
-  idPath.split('.').forEach(function (part) {
+  key.split('.').forEach(function (part) {
     var next = message[part];
 
     if (part == null || next == null) {
-      throw new Error("Could not resolve `" + idPath + "` in " + (namespace ? "`" + namespace + "`" : 'messages') + "." );
+      throw new Error("Could not resolve `" + key + "` in " + (namespace ? "`" + namespace + "`" : 'messages') + "." );
     }
 
     message = next;
@@ -310,8 +241,8 @@ function prepareTranslationValues(values) {
     var transformed;
 
     if (typeof value === 'function') {
-      transformed = function transformed(children) {
-        var result = value(children);
+      transformed = function transformed(chunks) {
+        var result = value(chunks);
         return React.isValidElement(result) ? React.cloneElement(result, {
           key: key + index++
         }) : result;
@@ -325,167 +256,229 @@ function prepareTranslationValues(values) {
   return transformedValues;
 }
 
-function useTranslationsImpl(allMessages, namespace, namespacePrefix) {
-  var _useIntlContext = useIntlContext(),
-      defaultTranslationValues = _useIntlContext.defaultTranslationValues,
-      globalFormats = _useIntlContext.formats,
-      getMessageFallback = _useIntlContext.getMessageFallback,
-      locale = _useIntlContext.locale,
-      onError = _useIntlContext.onError,
-      timeZone = _useIntlContext.timeZone; // The `namespacePrefix` is part of the type system.
-  // See the comment in the hook invocation.
+function getMessagesOrError(_ref) {
+  var messages = _ref.messages,
+      namespace = _ref.namespace,
+      _ref$onError = _ref.onError,
+      onError = _ref$onError === void 0 ? defaultOnError : _ref$onError;
 
+  try {
+    if (!messages) {
+      throw new Error("development" !== "production" ? "No messages were configured on the provider." : undefined);
+    }
 
-  allMessages = allMessages[namespacePrefix];
-  namespace = namespace === namespacePrefix ? undefined : namespace.slice((namespacePrefix + '.').length);
-  var cachedFormatsByLocaleRef = React.useRef({});
-  var messagesOrError = React.useMemo(function () {
-    try {
-      if (!allMessages) {
-        throw new Error("development" !== "production" ? "No messages were configured on the provider." : undefined);
-      }
+    var retrievedMessages = namespace ? resolvePath(messages, namespace) : messages;
 
-      var retrievedMessages = namespace ? resolvePath(allMessages, namespace) : allMessages;
+    if (!retrievedMessages) {
+      throw new Error("development" !== "production" ? "No messages for namespace `" + namespace + "` found." : undefined);
+    }
 
-      if (!retrievedMessages) {
-        throw new Error("development" !== "production" ? "No messages for namespace `" + namespace + "` found." : undefined);
-      }
+    return retrievedMessages;
+  } catch (error) {
+    var intlError = new IntlError(exports.IntlErrorCode.MISSING_MESSAGE, error.message);
+    onError(intlError);
+    return intlError;
+  }
+}
+function createBaseTranslator(_ref2) {
+  var cachedFormatsByLocale = _ref2.cachedFormatsByLocale,
+      defaultTranslationValues = _ref2.defaultTranslationValues,
+      globalFormats = _ref2.formats,
+      _ref2$getMessageFallb = _ref2.getMessageFallback,
+      getMessageFallback = _ref2$getMessageFallb === void 0 ? defaultGetMessageFallback : _ref2$getMessageFallb,
+      locale = _ref2.locale,
+      messagesOrError = _ref2.messagesOrError,
+      namespace = _ref2.namespace,
+      onError = _ref2.onError,
+      timeZone = _ref2.timeZone;
+
+  function getFallbackFromErrorAndNotify(key, code, message) {
+    var error = new IntlError(code, message);
+    onError(error);
+    return getMessageFallback({
+      error: error,
+      key: key,
+      namespace: namespace
+    });
+  }
 
-      return retrievedMessages;
-    } catch (error) {
-      var intlError = new IntlError(exports.IntlErrorCode.MISSING_MESSAGE, error.message);
-      onError(intlError);
-      return intlError;
-    }
-  }, [allMessages, namespace, onError]);
-  var translate = React.useMemo(function () {
-    function getFallbackFromErrorAndNotify(key, code, message) {
-      var error = new IntlError(code, message);
-      onError(error);
+  function translateBaseFn(
+  /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
+  key,
+  /** Key value pairs for values to interpolate into the message. */
+  values,
+  /** Provide custom formats for numbers, dates and times. */
+  formats) {
+    var _cachedFormatsByLocal;
+
+    if (messagesOrError instanceof IntlError) {
+      // We have already warned about this during render
       return getMessageFallback({
-        error: error,
+        error: messagesOrError,
         key: key,
         namespace: namespace
       });
     }
 
-    function translateBaseFn(
-    /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
-    key,
-    /** Key value pairs for values to interpolate into the message. */
-    values,
-    /** Provide custom formats for numbers, dates and times. */
-    formats) {
-      var _cachedFormatsByLocal;
-
-      var cachedFormatsByLocale = cachedFormatsByLocaleRef.current;
-
-      if (messagesOrError instanceof IntlError) {
-        // We have already warned about this during render
-        return getMessageFallback({
-          error: messagesOrError,
-          key: key,
-          namespace: namespace
-        });
-      }
+    var messages = messagesOrError;
+    var cacheKey = [namespace, key].filter(function (part) {
+      return part != null;
+    }).join('.');
+    var messageFormat;
 
-      var messages = messagesOrError;
-      var cacheKey = [namespace, key].filter(function (part) {
-        return part != null;
-      }).join('.');
-      var messageFormat;
-
-      if ((_cachedFormatsByLocal = cachedFormatsByLocale[locale]) != null && _cachedFormatsByLocal[cacheKey]) {
-        messageFormat = cachedFormatsByLocale[locale][cacheKey];
-      } else {
-        var message;
-
-        try {
-          message = resolvePath(messages, key, namespace);
-        } catch (error) {
-          return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
-        }
+    if (cachedFormatsByLocale != null && (_cachedFormatsByLocal = cachedFormatsByLocale[locale]) != null && _cachedFormatsByLocal[cacheKey]) {
+      messageFormat = cachedFormatsByLocale == null ? void 0 : cachedFormatsByLocale[locale][cacheKey];
+    } else {
+      var message;
 
-        if (typeof message === 'object') {
-          return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INSUFFICIENT_PATH, "Insufficient path specified for `" + key + "` in `" + (namespace ? "`" + namespace + "`" : 'messages') + "`." );
-        }
+      try {
+        message = resolvePath(messages, key, namespace);
+      } catch (error) {
+        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
+      }
 
-        try {
-          messageFormat = new intlMessageformat.IntlMessageFormat(message, locale, convertFormatsToIntlMessageFormat(_extends({}, globalFormats, formats), timeZone));
-        } catch (error) {
-          return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INVALID_MESSAGE, error.message);
-        }
+      if (typeof message === 'object') {
+        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INSUFFICIENT_PATH, "Insufficient path specified for `" + key + "` in `" + (namespace ? "`" + namespace + "`" : 'messages') + "`." );
+      }
+
+      try {
+        messageFormat = new IntlMessageFormat__default["default"](message, locale, convertFormatsToIntlMessageFormat(_extends({}, globalFormats, formats), timeZone));
+      } catch (error) {
+        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INVALID_MESSAGE, error.message);
+      }
 
+      if (cachedFormatsByLocale) {
         if (!cachedFormatsByLocale[locale]) {
           cachedFormatsByLocale[locale] = {};
         }
 
         cachedFormatsByLocale[locale][cacheKey] = messageFormat;
       }
+    }
 
-      try {
-        var formattedMessage = messageFormat.format( // @ts-ignore `intl-messageformat` expects a different format
-        // for rich text elements since a recent minor update. This
-        // needs to be evaluated in detail, possibly also in regards
-        // to be able to format to parts.
-        prepareTranslationValues(_extends({}, defaultTranslationValues, values)));
+    try {
+      var formattedMessage = messageFormat.format( // @ts-ignore `intl-messageformat` expects a different format
+      // for rich text elements since a recent minor update. This
+      // needs to be evaluated in detail, possibly also in regards
+      // to be able to format to parts.
+      prepareTranslationValues(_extends({}, defaultTranslationValues, values)));
 
-        if (formattedMessage == null) {
-          throw new Error("development" !== "production" ? "Unable to format `" + key + "` in " + (namespace ? "namespace `" + namespace + "`" : 'messages') : undefined);
-        } // Limit the function signature to return strings or React elements
+      if (formattedMessage == null) {
+        throw new Error("development" !== "production" ? "Unable to format `" + key + "` in " + (namespace ? "namespace `" + namespace + "`" : 'messages') : undefined);
+      } // Limit the function signature to return strings or React elements
 
 
-        return React.isValidElement(formattedMessage) || // Arrays of React elements
-        Array.isArray(formattedMessage) || typeof formattedMessage === 'string' ? formattedMessage : String(formattedMessage);
-      } catch (error) {
-        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.FORMATTING_ERROR, error.message);
-      }
+      return React.isValidElement(formattedMessage) || // Arrays of React elements
+      Array.isArray(formattedMessage) || typeof formattedMessage === 'string' ? formattedMessage : String(formattedMessage);
+    } catch (error) {
+      return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.FORMATTING_ERROR, error.message);
     }
+  }
 
-    function translateFn(
-    /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
-    key,
-    /** Key value pairs for values to interpolate into the message. */
-    values,
-    /** Provide custom formats for numbers, dates and times. */
-    formats) {
-      var message = translateBaseFn(key, values, formats);
-
-      if (typeof message !== 'string') {
-        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INVALID_MESSAGE, "The message `" + key + "` in " + (namespace ? "namespace `" + namespace + "`" : 'messages') + " didn't resolve to a string. If you want to format rich text, use `t.rich` instead." );
-      }
+  function translateFn(
+  /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
+  key,
+  /** Key value pairs for values to interpolate into the message. */
+  values,
+  /** Provide custom formats for numbers, dates and times. */
+  formats) {
+    var result = translateBaseFn(key, values, formats);
+
+    if (typeof result !== 'string') {
+      return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INVALID_MESSAGE, "The message `" + key + "` in " + (namespace ? "namespace `" + namespace + "`" : 'messages') + " didn't resolve to a string. If you want to format rich text, use `t.rich` instead." );
+    }
 
-      return message;
+    return result;
+  }
+
+  translateFn.rich = translateBaseFn;
+
+  translateFn.raw = function (
+  /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
+  key) {
+    if (messagesOrError instanceof IntlError) {
+      // We have already warned about this during render
+      return getMessageFallback({
+        error: messagesOrError,
+        key: key,
+        namespace: namespace
+      });
     }
 
-    translateFn.rich = translateBaseFn;
-
-    translateFn.raw = function (
-    /** Use a dot to indicate a level of nesting (e.g. `namespace.nestedLabel`). */
-    key) {
-      if (messagesOrError instanceof IntlError) {
-        // We have already warned about this during render
-        return getMessageFallback({
-          error: messagesOrError,
-          key: key,
-          namespace: namespace
-        });
-      }
+    var messages = messagesOrError;
 
-      var messages = messagesOrError;
+    try {
+      return resolvePath(messages, key, namespace);
+    } catch (error) {
+      return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
+    }
+  };
 
-      try {
-        return resolvePath(messages, key, namespace);
-      } catch (error) {
-        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
-      }
-    };
+  return translateFn;
+}
 
-    return translateFn;
-  }, [onError, getMessageFallback, namespace, messagesOrError, locale, globalFormats, timeZone, defaultTranslationValues]);
-  return translate;
+/**
+ * For the strictly typed messages to work we have to wrap the namespace into
+ * a mandatory prefix. See https://stackoverflow.com/a/71529575/343045
+ */
+function resolveNamespace(namespace, namespacePrefix) {
+  return namespace === namespacePrefix ? undefined : namespace.slice((namespacePrefix + '.').length);
 }
 
+var _excluded$2 = ["messages", "namespace", "onError", "getMessageFallback"];
+function createTranslatorImpl(_ref, namespacePrefix) {
+  var messages = _ref.messages,
+      namespace = _ref.namespace,
+      _ref$onError = _ref.onError,
+      onError = _ref$onError === void 0 ? defaultOnError : _ref$onError,
+      _ref$getMessageFallba = _ref.getMessageFallback,
+      getMessageFallback = _ref$getMessageFallba === void 0 ? defaultGetMessageFallback : _ref$getMessageFallba,
+      rest = _objectWithoutPropertiesLoose(_ref, _excluded$2);
+
+  // The `namespacePrefix` is part of the type system.
+  // See the comment in the function invocation.
+  messages = messages[namespacePrefix];
+  namespace = resolveNamespace(namespace, namespacePrefix);
+  var translator = createBaseTranslator(_extends({}, rest, {
+    onError: onError,
+    messagesOrError: getMessagesOrError({
+      messages: messages,
+      namespace: namespace,
+      onError: onError
+    })
+  }));
+  var originalRich = translator.rich;
+
+  function base() {
+    return translator.apply(void 0, arguments);
+  } // Augment `t.rich` to return plain strings
+
+
+  base.rich = function (key,
+  /** Key value pairs for values to interpolate into the message. */
+  values, formats) {
+    // `chunks` is returned as a string when no React element
+    // is used, therefore it's safe to cast this type.
+    var result = originalRich(key, values, formats); // When only string chunks are provided to the parser, only strings should be returned here.
+
+    if (typeof result !== 'string') {
+      var error = new IntlError(exports.IntlErrorCode.FORMATTING_ERROR, "`createTranslator` only accepts functions for rich text formatting that receive and return strings.\n\nE.g. t.rich('rich', {b: (chunks) => `<b>${chunks}</b>`})" );
+      onError(error);
+      return getMessageFallback({
+        error: error,
+        key: key,
+        namespace: namespace
+      });
+    }
+
+    return result;
+  };
+
+  base.raw = translator.raw;
+  return base;
+}
+
+var _excluded$1 = ["messages", "namespace"];
 /**
  * Translates messages from the given namespace by using the ICU syntax.
  * See https://formatjs.io/docs/core-concepts/icu-syntax.
@@ -495,16 +488,21 @@ function useTranslationsImpl(allMessages, namespace, namespacePrefix) {
  * (e.g. `namespace.Component`).
  */
 
-function useTranslations(namespace) {
-  var context = useIntlContext();
-  var messages = context.messages; // We have to wrap the actual hook so the type inference for the optional
-  // namespace works correctly. See https://stackoverflow.com/a/71529575/343045
-  // The prefix ("!"") is arbitrary, but we have to use some.
+function createTranslator(_ref) {
+  var messages = _ref.messages,
+      namespace = _ref.namespace,
+      rest = _objectWithoutPropertiesLoose(_ref, _excluded$1);
 
-  return useTranslationsImpl({
-    '!': messages
-  }, // @ts-ignore
-  namespace ? "!." + namespace : '!', '!');
+  // We have to wrap the actual function so the type inference for the optional
+  // namespace works correctly. See https://stackoverflow.com/a/71529575/343045
+  // The prefix ("!") is arbitrary.
+  return createTranslatorImpl(_extends({}, rest, {
+    messages: {
+      '!': messages
+    },
+    // @ts-ignore
+    namespace: namespace ? "!." + namespace : '!'
+  }), '!');
 }
 
 var MINUTE = 60;
@@ -549,13 +547,13 @@ function getRelativeTimeFormatConfig(seconds) {
   };
 }
 
-function useIntl() {
-  var _useIntlContext = useIntlContext(),
-      formats = _useIntlContext.formats,
-      locale = _useIntlContext.locale,
-      globalNow = _useIntlContext.now,
-      onError = _useIntlContext.onError,
-      timeZone = _useIntlContext.timeZone;
+function createIntl(_ref) {
+  var formats = _ref.formats,
+      locale = _ref.locale,
+      globalNow = _ref.now,
+      _ref$onError = _ref.onError,
+      onError = _ref$onError === void 0 ? defaultOnError : _ref$onError,
+      timeZone = _ref.timeZone;
 
   function resolveFormatOrOptions(typeFormats, formatOrOptions) {
     var options;
@@ -656,6 +654,151 @@ function useIntl() {
   };
 }
 
+function validateMessagesSegment(messages, invalidKeyLabels, parentPath) {
+  Object.entries(messages).forEach(function (_ref) {
+    var key = _ref[0],
+        messageOrMessages = _ref[1];
+
+    if (key.includes('.')) {
+      var keyLabel = key;
+      if (parentPath) keyLabel += " (at " + parentPath + ")";
+      invalidKeyLabels.push(keyLabel);
+    }
+
+    if (messageOrMessages != null && typeof messageOrMessages === 'object') {
+      validateMessagesSegment(messageOrMessages, invalidKeyLabels, [parentPath, key].filter(function (part) {
+        return part != null;
+      }).join('.'));
+    }
+  });
+}
+
+function validateMessages(messages, onError) {
+  var invalidKeyLabels = [];
+  validateMessagesSegment(messages, invalidKeyLabels);
+
+  if (invalidKeyLabels.length > 0) {
+    onError(new IntlError(exports.IntlErrorCode.INVALID_KEY, "Namespace keys can not contain the character \".\" as this is used to express nesting. Please remove it or replace it with another character.\n\nInvalid " + (invalidKeyLabels.length === 1 ? 'key' : 'keys') + ": " + invalidKeyLabels.join(', ')));
+  }
+}
+
+var IntlContext = /*#__PURE__*/React.createContext(undefined);
+
+var _excluded = ["children", "onError", "getMessageFallback", "messages"];
+function IntlProvider(_ref) {
+  var children = _ref.children,
+      _ref$onError = _ref.onError,
+      onError = _ref$onError === void 0 ? defaultOnError : _ref$onError,
+      _ref$getMessageFallba = _ref.getMessageFallback,
+      getMessageFallback = _ref$getMessageFallba === void 0 ? defaultGetMessageFallback : _ref$getMessageFallba,
+      messages = _ref.messages,
+      contextValues = _objectWithoutPropertiesLoose(_ref, _excluded);
+
+  {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    React.useEffect(function () {
+      if (messages) {
+        validateMessages(messages, onError);
+      }
+    }, [messages, onError]);
+  }
+
+  return React__default["default"].createElement(IntlContext.Provider, {
+    value: _extends({}, contextValues, {
+      messages: messages,
+      onError: onError,
+      getMessageFallback: getMessageFallback
+    })
+  }, children);
+}
+
+function useIntlContext() {
+  var context = React.useContext(IntlContext);
+
+  if (!context) {
+    throw new Error('No intl context found. Have you configured the provider?' );
+  }
+
+  return context;
+}
+
+function useTranslationsImpl(allMessages, namespace, namespacePrefix) {
+  var _useIntlContext = useIntlContext(),
+      defaultTranslationValues = _useIntlContext.defaultTranslationValues,
+      globalFormats = _useIntlContext.formats,
+      getMessageFallback = _useIntlContext.getMessageFallback,
+      locale = _useIntlContext.locale,
+      onError = _useIntlContext.onError,
+      timeZone = _useIntlContext.timeZone; // The `namespacePrefix` is part of the type system.
+  // See the comment in the hook invocation.
+
+
+  allMessages = allMessages[namespacePrefix];
+  namespace = resolveNamespace(namespace, namespacePrefix);
+  var cachedFormatsByLocaleRef = React.useRef({});
+  var messagesOrError = React.useMemo(function () {
+    return getMessagesOrError({
+      messages: allMessages,
+      namespace: namespace,
+      onError: onError
+    });
+  }, [allMessages, namespace, onError]);
+  var translate = React.useMemo(function () {
+    return createBaseTranslator({
+      cachedFormatsByLocale: cachedFormatsByLocaleRef.current,
+      getMessageFallback: getMessageFallback,
+      messagesOrError: messagesOrError,
+      defaultTranslationValues: defaultTranslationValues,
+      namespace: namespace,
+      onError: onError,
+      formats: globalFormats,
+      locale: locale,
+      timeZone: timeZone
+    });
+  }, [getMessageFallback, messagesOrError, defaultTranslationValues, namespace, onError, globalFormats, locale, timeZone]);
+  return translate;
+}
+
+/**
+ * Translates messages from the given namespace by using the ICU syntax.
+ * See https://formatjs.io/docs/core-concepts/icu-syntax.
+ *
+ * If no namespace is provided, all available messages are returned.
+ * The namespace can also indicate nesting by using a dot
+ * (e.g. `namespace.Component`).
+ */
+
+function useTranslations(namespace) {
+  var context = useIntlContext();
+  var messages = context.messages; // We have to wrap the actual hook so the type inference for the optional
+  // namespace works correctly. See https://stackoverflow.com/a/71529575/343045
+  // The prefix ("!") is arbitrary.
+
+  return useTranslationsImpl({
+    '!': messages
+  }, // @ts-ignore
+  namespace ? "!." + namespace : '!', '!');
+}
+
+function useIntl() {
+  var _useIntlContext = useIntlContext(),
+      formats = _useIntlContext.formats,
+      locale = _useIntlContext.locale,
+      globalNow = _useIntlContext.now,
+      onError = _useIntlContext.onError,
+      timeZone = _useIntlContext.timeZone;
+
+  return React.useMemo(function () {
+    return createIntl({
+      formats: formats,
+      locale: locale,
+      now: globalNow,
+      onError: onError,
+      timeZone: timeZone
+    });
+  }, [formats, globalNow, locale, onError, timeZone]);
+}
+
 function useLocale() {
   return useIntlContext().locale;
 }
@@ -711,6 +854,8 @@ function useTimeZone() {
 
 exports.IntlError = IntlError;
 exports.IntlProvider = IntlProvider;
+exports.createIntl = createIntl;
+exports.createTranslator = createTranslator;
 exports.useIntl = useIntl;
 exports.useLocale = useLocale;
 exports.useNow = useNow;