use-intl 2.11.0-alpha.2 → 2.11.0-useFormatter-alpha.1

package/dist/src/core/createIntl.js

@@ -1,126 +1,11 @@
-import IntlError, { IntlErrorCode } from './IntlError';
-import { defaultOnError } from './defaults';
-const MINUTE = 60;
-const HOUR = MINUTE * 60;
-const DAY = HOUR * 24;
-const WEEK = DAY * 7;
-const MONTH = DAY * (365 / 12); // Approximation
-const YEAR = DAY * 365;
-function getRelativeTimeFormatConfig(seconds) {
-    const absValue = Math.abs(seconds);
-    let value, unit;
-    // We have to round the resulting values, as `Intl.RelativeTimeFormat`
-    // will include fractions like '2.1 hours ago'.
-    if (absValue < MINUTE) {
-        unit = 'second';
-        value = Math.round(seconds);
-    }
-    else if (absValue < HOUR) {
-        unit = 'minute';
-        value = Math.round(seconds / MINUTE);
-    }
-    else if (absValue < DAY) {
-        unit = 'hour';
-        value = Math.round(seconds / HOUR);
-    }
-    else if (absValue < WEEK) {
-        unit = 'day';
-        value = Math.round(seconds / DAY);
-    }
-    else if (absValue < MONTH) {
-        unit = 'week';
-        value = Math.round(seconds / WEEK);
-    }
-    else if (absValue < YEAR) {
-        unit = 'month';
-        value = Math.round(seconds / MONTH);
-    }
-    else {
-        unit = 'year';
-        value = Math.round(seconds / YEAR);
-    }
-    return { value, unit };
-}
-export default function createIntl({ formats, locale, now: globalNow, onError = defaultOnError, timeZone }) {
-    function resolveFormatOrOptions(typeFormats, formatOrOptions) {
-        let options;
-        if (typeof formatOrOptions === 'string') {
-            const formatName = formatOrOptions;
-            options = typeFormats?.[formatName];
-            if (!options) {
-                const error = new IntlError(IntlErrorCode.MISSING_FORMAT, process.env.NODE_ENV !== 'production'
-                    ? `Format \`${formatName}\` is not available. You can configure it on the provider or provide custom options.`
-                    : undefined);
-                onError(error);
-                throw error;
-            }
-        }
-        else {
-            options = formatOrOptions;
-        }
-        return options;
-    }
-    function getFormattedValue(value, formatOrOptions, typeFormats, formatter) {
-        let options;
-        try {
-            options = resolveFormatOrOptions(typeFormats, formatOrOptions);
-        }
-        catch (error) {
-            return String(value);
-        }
-        try {
-            return formatter(options);
-        }
-        catch (error) {
-            onError(new IntlError(IntlErrorCode.FORMATTING_ERROR, error.message));
-            return String(value);
-        }
-    }
-    function formatDateTime(
-    /** If a number is supplied, this is interpreted as a UTC timestamp. */
-    value, 
-    /** If a time zone is supplied, the `value` is converted to that time zone.
-     * Otherwise the user time zone will be used. */
-    formatOrOptions) {
-        return getFormattedValue(value, formatOrOptions, formats?.dateTime, (options) => {
-            if (timeZone && !options?.timeZone) {
-                options = { ...options, timeZone };
-            }
-            return new Intl.DateTimeFormat(locale, options).format(value);
-        });
-    }
-    function formatNumber(value, formatOrOptions) {
-        return getFormattedValue(value, formatOrOptions, formats?.number, (options) => new Intl.NumberFormat(locale, options).format(value));
-    }
-    function formatRelativeTime(
-    /** The date time that needs to be formatted. */
-    date, 
-    /** The reference point in time to which `date` will be formatted in relation to.  */
-    now) {
-        try {
-            if (!now) {
-                if (globalNow) {
-                    now = globalNow;
-                }
-                else {
-                    throw new Error(process.env.NODE_ENV !== 'production'
-                        ? `The \`now\` parameter wasn't provided to \`formatRelativeTime\` and there was no global fallback configured on the provider.`
-                        : undefined);
-                }
-            }
-            const dateDate = date instanceof Date ? date : new Date(date);
-            const nowDate = now instanceof Date ? now : new Date(now);
-            const seconds = (dateDate.getTime() - nowDate.getTime()) / 1000;
-            const { unit, value } = getRelativeTimeFormatConfig(seconds);
-            return new Intl.RelativeTimeFormat(locale, {
-                numeric: 'auto'
-            }).format(value, unit);
-        }
-        catch (error) {
-            onError(new IntlError(IntlErrorCode.FORMATTING_ERROR, error.message));
-            return String(date);
-        }
-    }
-    return { formatDateTime, formatNumber, formatRelativeTime };
+import createFormatter from './createFormatter';
+/** @deprecated Switch to `createFormatter` */
+export default function createIntl(...args) {
+    const formatter = createFormatter(...args);
+    return {
+        formatDateTime: formatter.dateTime,
+        formatNumber: formatter.number,
+        formatRelativeTime: formatter.relativeTime
+    };
 }
 //# sourceMappingURL=createIntl.js.map

package/dist/src/core/createIntl.js.map

@@ -1 +1 @@
-{"version":3,"file":"createIntl.js","sourceRoot":"","sources":["../../../src/core/createIntl.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"createIntl.js","sourceRoot":"","sources":["../../../src/core/createIntl.tsx"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,8CAA8C;AAC9C,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,GAAG,IAAwC;IAE3C,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,OAAO;QACL,cAAc,EAAE,SAAS,CAAC,QAAQ;QAClC,YAAY,EAAE,SAAS,CAAC,MAAM;QAC9B,kBAAkB,EAAE,SAAS,CAAC,YAAY;KAC3C,CAAC;AACJ,CAAC"}

package/dist/src/core/index.d.ts

@@ -5,4 +5,5 @@ export { default as DateTimeFormatOptions } from './DateTimeFormatOptions';
 export { default as NumberFormatOptions } from './NumberFormatOptions';
 export { default as IntlError, IntlErrorCode } from './IntlError';
 export { default as createTranslator } from './createTranslator';
+export { default as createFormatter } from './createFormatter';
 export { default as createIntl } from './createIntl';

package/dist/src/core/index.js

@@ -1,4 +1,6 @@
 export { default as IntlError, IntlErrorCode } from './IntlError';
 export { default as createTranslator } from './createTranslator';
+export { default as createFormatter } from './createFormatter';
+// TODO: Remove in next major version
 export { default as createIntl } from './createIntl';
 //# sourceMappingURL=index.js.map

package/dist/src/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAC,OAAO,IAAI,SAAS,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAChE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAC,OAAO,IAAI,SAAS,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAChE,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAE7D,qCAAqC;AACrC,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,cAAc,CAAC"}

package/dist/src/react/IntlContext.d.ts

@@ -1,4 +1,21 @@
 /// <reference types="react" />
-import IntlContextValue from './IntlContextValue';
-declare const IntlContext: import("react").Context<IntlContextValue | undefined>;
+import AbstractIntlMessages from '../core/AbstractIntlMessages';
+import Formats from '../core/Formats';
+import IntlError from '../core/IntlError';
+import { RichTranslationValues } from '../core/TranslationValues';
+export declare type IntlContextShape = {
+    messages?: AbstractIntlMessages;
+    locale: string;
+    formats?: Partial<Formats>;
+    timeZone?: string;
+    onError(error: IntlError): void;
+    getMessageFallback(info: {
+        error: IntlError;
+        key: string;
+        namespace?: string;
+    }): string;
+    now?: Date;
+    defaultTranslationValues?: RichTranslationValues;
+};
+declare const IntlContext: import("react").Context<IntlContextShape | undefined>;
 export default IntlContext;

package/dist/src/react/IntlContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"IntlContext.js","sourceRoot":"","sources":["../../../src/react/IntlContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AAGpC,MAAM,WAAW,GAAG,aAAa,CAA+B,SAAS,CAAC,CAAC;AAE3E,eAAe,WAAW,CAAC"}
+{"version":3,"file":"IntlContext.js","sourceRoot":"","sources":["../../../src/react/IntlContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AAqBpC,MAAM,WAAW,GAAG,aAAa,CAA+B,SAAS,CAAC,CAAC;AAE3E,eAAe,WAAW,CAAC"}

package/dist/src/react/IntlProvider.d.ts

@@ -1,2 +1,16 @@
-import IntlProviderProps from './IntlProviderProps';
-export default function IntlProvider({ children, ...props }: IntlProviderProps): JSX.Element;
+import { ReactNode } from 'react';
+import { AbstractIntlMessages } from '../core';
+import IntlConfiguration from '../core/IntlConfiguration';
+import { RichTranslationValues } from '../core/TranslationValues';
+declare type Props = IntlConfiguration & {
+    /** All components that use the provided hooks should be within this tree. */
+    children: ReactNode;
+    /** Global default values for translation values and rich text elements.
+     * Can be used for consistent usage or styling of rich text elements.
+     * Defaults will be overidden by locally provided values. */
+    defaultTranslationValues?: RichTranslationValues;
+    /** All messages that will be available in your components. */
+    messages?: AbstractIntlMessages;
+};
+export default function IntlProvider({ children, onError, getMessageFallback, messages, ...contextValues }: Props): JSX.Element;
+export {};

package/dist/src/react/IntlProvider.js

@@ -1,7 +1,16 @@
-import React from 'react';
+import React, { useEffect } from 'react';
+import { defaultGetMessageFallback, defaultOnError } from '../core/defaults';
+import validateMessages from '../core/validateMessages';
 import IntlContext from './IntlContext';
-import getIntlContextValue from './getIntlContextValue';
-export default function IntlProvider({ children, ...props }) {
-    return (React.createElement(IntlContext.Provider, { value: getIntlContextValue(props) }, children));
+export default function IntlProvider({ children, onError = defaultOnError, getMessageFallback = defaultGetMessageFallback, messages, ...contextValues }) {
+    if (process.env.NODE_ENV !== 'production') {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        useEffect(() => {
+            if (messages) {
+                validateMessages(messages, onError);
+            }
+        }, [messages, onError]);
+    }
+    return (React.createElement(IntlContext.Provider, { value: { ...contextValues, messages, onError, getMessageFallback } }, children));
 }
 //# sourceMappingURL=IntlProvider.js.map

package/dist/src/react/IntlProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"IntlProvider.js","sourceRoot":"","sources":["../../../src/react/IntlProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,WAAW,MAAM,eAAe,CAAC;AAExC,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAC,QAAQ,EAAE,GAAG,KAAK,EAAoB;IAC1E,OAAO,CACL,oBAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,IACpD,QAAQ,CACY,CACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"IntlProvider.js","sourceRoot":"","sources":["../../../src/react/IntlProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAY,SAAS,EAAC,MAAM,OAAO,CAAC;AAIlD,OAAO,EAAC,yBAAyB,EAAE,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAC3E,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AACxD,OAAO,WAAW,MAAM,eAAe,CAAC;AAaxC,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EACnC,QAAQ,EACR,OAAO,GAAG,cAAc,EACxB,kBAAkB,GAAG,yBAAyB,EAC9C,QAAQ,EACR,GAAG,aAAa,EACV;IACN,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE;QACzC,sDAAsD;QACtD,SAAS,CAAC,GAAG,EAAE;YACb,IAAI,QAAQ,EAAE;gBACZ,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;aACrC;QACH,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;KACzB;IAED,OAAO,CACL,oBAAC,WAAW,CAAC,QAAQ,IACnB,KAAK,EAAE,EAAC,GAAG,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAC,IAE/D,QAAQ,CACY,CACxB,CAAC;AACJ,CAAC"}

package/dist/src/react/index.d.ts

@@ -1,6 +1,7 @@
 export { default as IntlProvider } from './IntlProvider';
 export { default as useTranslations } from './useTranslations';
-export { default as useIntl } from './useIntl';
 export { default as useLocale } from './useLocale';
 export { default as useNow } from './useNow';
 export { default as useTimeZone } from './useTimeZone';
+export { default as useFormatter } from './useFormatter';
+export { default as useIntl } from './useIntl';

package/dist/src/react/index.js

@@ -1,7 +1,9 @@
 export { default as IntlProvider } from './IntlProvider';
 export { default as useTranslations } from './useTranslations';
-export { default as useIntl } from './useIntl';
 export { default as useLocale } from './useLocale';
 export { default as useNow } from './useNow';
 export { default as useTimeZone } from './useTimeZone';
+export { default as useFormatter } from './useFormatter';
+// TODO: Remove in next major version
+export { default as useIntl } from './useIntl';
 //# sourceMappingURL=index.js.map

package/dist/src/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAC,OAAO,IAAI,SAAS,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,eAAe,CAAC;AACrD,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEvD,qCAAqC;AACrC,OAAO,EAAC,OAAO,IAAI,OAAO,EAAC,MAAM,WAAW,CAAC"}

package/dist/src/react/useFormatter.d.ts

@@ -0,0 +1,5 @@
+export default function useFormatter(): {
+    dateTime: (value: number | Date, formatOrOptions?: string | import("../core/DateTimeFormatOptions").default | undefined) => string;
+    number: (value: number, formatOrOptions?: string | import("@formatjs/ecma402-abstract").NumberFormatOptions | undefined) => string;
+    relativeTime: (date: number | Date, now?: number | Date | undefined) => string;
+};

package/dist/src/react/useFormatter.js

@@ -0,0 +1,14 @@
+import { useMemo } from 'react';
+import createFormatter from '../core/createFormatter';
+import useIntlContext from './useIntlContext';
+export default function useFormatter() {
+    const { formats, locale, now: globalNow, onError, timeZone } = useIntlContext();
+    return useMemo(() => createFormatter({
+        formats,
+        locale,
+        now: globalNow,
+        onError,
+        timeZone
+    }), [formats, globalNow, locale, onError, timeZone]);
+}
+//# sourceMappingURL=useFormatter.js.map

package/dist/src/react/useFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormatter.js","sourceRoot":"","sources":["../../../src/react/useFormatter.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAC9B,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,OAAO,UAAU,YAAY;IAClC,MAAM,EAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAC,GAAG,cAAc,EAAE,CAAC;IAE9E,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,eAAe,CAAC;QACd,OAAO;QACP,MAAM;QACN,GAAG,EAAE,SAAS;QACd,OAAO;QACP,QAAQ;KACT,CAAC,EACJ,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAChD,CAAC;AACJ,CAAC"}

package/dist/src/react/useIntl.d.ts

@@ -1,3 +1,4 @@
+/** @deprecated  Switch to `useFormatter` */
 export default function useIntl(): {
     formatDateTime: (value: number | Date, formatOrOptions?: string | import("../core/DateTimeFormatOptions").default | undefined) => string;
     formatNumber: (value: number, formatOrOptions?: string | import("@formatjs/ecma402-abstract").NumberFormatOptions | undefined) => string;

package/dist/src/react/useIntl.js

@@ -1,8 +1,14 @@
 import { useMemo } from 'react';
 import createIntl from '../core/createIntl';
 import useIntlContext from './useIntlContext';
+let hasWarned = false;
+/** @deprecated  Switch to `useFormatter` */
 export default function useIntl() {
     const { formats, locale, now: globalNow, onError, timeZone } = useIntlContext();
+    if (!hasWarned) {
+        hasWarned = true;
+        console.warn('`useIntl()` is deprecated and will be removed in the next major version. Please switch to `useFormatter()`.');
+    }
     return useMemo(() => createIntl({
         formats,
         locale,

package/dist/src/react/useIntl.js.map

@@ -1 +1 @@
-{"version":3,"file":"useIntl.js","sourceRoot":"","sources":["../../../src/react/useIntl.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,OAAO,UAAU,OAAO;IAC7B,MAAM,EAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAC,GAAG,cAAc,EAAE,CAAC;IAE9E,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,UAAU,CAAC;QACT,OAAO;QACP,MAAM;QACN,GAAG,EAAE,SAAS;QACd,OAAO;QACP,QAAQ;KACT,CAAC,EACJ,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useIntl.js","sourceRoot":"","sources":["../../../src/react/useIntl.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,4CAA4C;AAC5C,MAAM,CAAC,OAAO,UAAU,OAAO;IAC7B,MAAM,EAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAC,GAAG,cAAc,EAAE,CAAC;IAE9E,IAAI,CAAC,SAAS,EAAE;QACd,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,CAAC,IAAI,CACV,6GAA6G,CAC9G,CAAC;KACH;IAED,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,UAAU,CAAC;QACT,OAAO;QACP,MAAM;QACN,GAAG,EAAE,SAAS;QACd,OAAO;QACP,QAAQ;KACT,CAAC,EACJ,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAChD,CAAC;AACJ,CAAC"}

package/dist/src/react/useIntlContext.d.ts

@@ -1 +1 @@
-export default function useIntlContext(): import("./IntlContextValue").default;
+export default function useIntlContext(): import("./IntlContext").IntlContextShape;

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

@@ -323,7 +323,15 @@ function createBaseTranslator(_ref2) {
     }
 
     var messages = messagesOrError;
-    var cacheKey = [namespace, key].filter(function (part) {
+    var message;
+
+    try {
+      message = resolvePath(messages, key, namespace);
+    } catch (error) {
+      return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
+    }
+
+    var cacheKey = [namespace, key, message].filter(function (part) {
       return part != null;
     }).join('.');
     var messageFormat;
@@ -331,14 +339,6 @@ function createBaseTranslator(_ref2) {
     if (cachedFormatsByLocale != null && (_cachedFormatsByLocal = cachedFormatsByLocale[locale]) != null && _cachedFormatsByLocal[cacheKey]) {
       messageFormat = cachedFormatsByLocale == null ? void 0 : cachedFormatsByLocale[locale][cacheKey];
     } else {
-      var message;
-
-      try {
-        message = resolvePath(messages, key, namespace);
-      } catch (error) {
-        return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.MISSING_MESSAGE, error.message);
-      }
-
       if (typeof message === 'object') {
         return getFallbackFromErrorAndNotify(key, exports.IntlErrorCode.INSUFFICIENT_PATH, "Insufficient path specified for `" + key + "` in `" + (namespace ? "`" + namespace + "`" : 'messages') + "`." );
       }
@@ -427,13 +427,13 @@ function resolveNamespace(namespace, namespacePrefix) {
   return namespace === namespacePrefix ? undefined : namespace.slice((namespacePrefix + '.').length);
 }
 
-var _excluded$3 = ["getMessageFallback", "messages", "namespace", "onError"];
+var _excluded$2 = ["getMessageFallback", "messages", "namespace", "onError"];
 function createTranslatorImpl(_ref, namespacePrefix) {
   var getMessageFallback = _ref.getMessageFallback,
       messages = _ref.messages,
       namespace = _ref.namespace,
       onError = _ref.onError,
-      rest = _objectWithoutPropertiesLoose(_ref, _excluded$3);
+      rest = _objectWithoutPropertiesLoose(_ref, _excluded$2);
 
   // The `namespacePrefix` is part of the type system.
   // See the comment in the function invocation.
@@ -479,7 +479,7 @@ function createTranslatorImpl(_ref, namespacePrefix) {
   return base;
 }
 
-var _excluded$2 = ["onError", "getMessageFallback", "messages", "namespace"];
+var _excluded$1 = ["onError", "getMessageFallback", "messages", "namespace"];
 /**
  * Translates messages from the given namespace by using the ICU syntax.
  * See https://formatjs.io/docs/core-concepts/icu-syntax.
@@ -496,7 +496,7 @@ function createTranslator(_ref) {
       getMessageFallback = _ref$getMessageFallba === void 0 ? defaultGetMessageFallback : _ref$getMessageFallba,
       messages = _ref.messages,
       namespace = _ref.namespace,
-      rest = _objectWithoutPropertiesLoose(_ref, _excluded$2);
+      rest = _objectWithoutPropertiesLoose(_ref, _excluded$1);
 
   // We have to wrap the actual function so the type inference for the optional
   // namespace works correctly. See https://stackoverflow.com/a/71529575/343045
@@ -554,7 +554,7 @@ function getRelativeTimeFormatConfig(seconds) {
   };
 }
 
-function createIntl(_ref) {
+function createFormatter(_ref) {
   var formats = _ref.formats,
       locale = _ref.locale,
       globalNow = _ref.now,
@@ -598,7 +598,7 @@ function createIntl(_ref) {
     }
   }
 
-  function formatDateTime(
+  function dateTime(
   /** If a number is supplied, this is interpreted as a UTC timestamp. */
   value,
   /** If a time zone is supplied, the `value` is converted to that time zone.
@@ -617,13 +617,13 @@ function createIntl(_ref) {
     });
   }
 
-  function formatNumber(value, formatOrOptions) {
+  function number(value, formatOrOptions) {
     return getFormattedValue(value, formatOrOptions, formats == null ? void 0 : formats.number, function (options) {
       return new Intl.NumberFormat(locale, options).format(value);
     });
   }
 
-  function formatRelativeTime(
+  function relativeTime(
   /** The date time that needs to be formatted. */
   date,
   /** The reference point in time to which `date` will be formatted in relation to.  */
@@ -633,7 +633,7 @@ function createIntl(_ref) {
         if (globalNow) {
           now = globalNow;
         } else {
-          throw new Error("development" !== 'production' ? "The `now` parameter wasn't provided to `formatRelativeTime` and there was no global fallback configured on the provider." : undefined);
+          throw new Error("development" !== 'production' ? "The `now` parameter wasn't provided and there was no global fallback configured on the provider." : undefined);
         }
       }
 
@@ -655,13 +655,22 @@ function createIntl(_ref) {
   }
 
   return {
-    formatDateTime: formatDateTime,
-    formatNumber: formatNumber,
-    formatRelativeTime: formatRelativeTime
+    dateTime: dateTime,
+    number: number,
+    relativeTime: relativeTime
   };
 }
 
-var IntlContext = /*#__PURE__*/React.createContext(undefined);
+/** @deprecated Switch to `createFormatter` */
+
+function createIntl() {
+  var formatter = createFormatter.apply(void 0, arguments);
+  return {
+    formatDateTime: formatter.dateTime,
+    formatNumber: formatter.number,
+    formatRelativeTime: formatter.relativeTime
+  };
+}
 
 function validateMessagesSegment(messages, invalidKeyLabels, parentPath) {
   Object.entries(messages).forEach(function (_ref) {
@@ -691,40 +700,33 @@ function validateMessages(messages, onError) {
   }
 }
 
-var _excluded$1 = ["getMessageFallback", "messages", "onError"];
-/**
- * Enhances the incoming props with defaults.
- */
+var IntlContext = /*#__PURE__*/React.createContext(undefined);
 
-function getIntlContextValue(_ref) {
-  var getMessageFallback = _ref.getMessageFallback,
+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,
-      onError = _ref.onError,
-      rest = _objectWithoutPropertiesLoose(_ref, _excluded$1);
-
-  var finalOnError = onError || defaultOnError;
-  var finalGetMessageFallback = getMessageFallback || defaultGetMessageFallback;
+      contextValues = _objectWithoutPropertiesLoose(_ref, _excluded);
 
   {
-    if (messages) {
-      validateMessages(messages, finalOnError);
-    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    React.useEffect(function () {
+      if (messages) {
+        validateMessages(messages, onError);
+      }
+    }, [messages, onError]);
   }
 
-  return _extends({}, rest, {
-    messages: messages,
-    onError: finalOnError,
-    getMessageFallback: finalGetMessageFallback
-  });
-}
-
-var _excluded = ["children"];
-function IntlProvider(_ref) {
-  var children = _ref.children,
-      props = _objectWithoutPropertiesLoose(_ref, _excluded);
-
   return React__default["default"].createElement(IntlContext.Provider, {
-    value: getIntlContextValue(props)
+    value: _extends({}, contextValues, {
+      messages: messages,
+      onError: onError,
+      getMessageFallback: getMessageFallback
+    })
   }, children);
 }
 
@@ -796,25 +798,6 @@ function useTranslations(namespace) {
   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;
 }
@@ -868,10 +851,58 @@ function useTimeZone() {
   return useIntlContext().timeZone;
 }
 
+function useFormatter() {
+  var _useIntlContext = useIntlContext(),
+      formats = _useIntlContext.formats,
+      locale = _useIntlContext.locale,
+      globalNow = _useIntlContext.now,
+      onError = _useIntlContext.onError,
+      timeZone = _useIntlContext.timeZone;
+
+  return React.useMemo(function () {
+    return createFormatter({
+      formats: formats,
+      locale: locale,
+      now: globalNow,
+      onError: onError,
+      timeZone: timeZone
+    });
+  }, [formats, globalNow, locale, onError, timeZone]);
+}
+
+var hasWarned = false;
+/** @deprecated  Switch to `useFormatter` */
+
+function useIntl() {
+  var _useIntlContext = useIntlContext(),
+      formats = _useIntlContext.formats,
+      locale = _useIntlContext.locale,
+      globalNow = _useIntlContext.now,
+      onError = _useIntlContext.onError,
+      timeZone = _useIntlContext.timeZone;
+
+  if (!hasWarned) {
+    hasWarned = true;
+    console.warn('`useIntl()` is deprecated and will be removed in the next major version. Please switch to `useFormatter()`.');
+  }
+
+  return React.useMemo(function () {
+    return createIntl({
+      formats: formats,
+      locale: locale,
+      now: globalNow,
+      onError: onError,
+      timeZone: timeZone
+    });
+  }, [formats, globalNow, locale, onError, timeZone]);
+}
+
 exports.IntlError = IntlError;
 exports.IntlProvider = IntlProvider;
+exports.createFormatter = createFormatter;
 exports.createIntl = createIntl;
 exports.createTranslator = createTranslator;
+exports.useFormatter = useFormatter;
 exports.useIntl = useIntl;
 exports.useLocale = useLocale;
 exports.useNow = useNow;