react-intl 4.2.0 → 4.3.1

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [4.3.1](https://github.com/formatjs/react-intl/compare/v4.3.0...v4.3.1) (2020-03-28)
+
+
+### Bug Fixes
+
+* tweak FormatXMLElementFn ([a914dc0](https://github.com/formatjs/react-intl/commit/a914dc059cc8d0c04baec6a63513cb686ff6dad3))
+
+## [4.3.0](https://github.com/formatjs/react-intl/compare/v4.2.2...v4.3.0) (2020-03-26)
+
+
+### Features
+
+* **react-intl:** store original message descriptor in the error ([22531bd](https://github.com/formatjs/react-intl/commit/22531bde78e0f3846b583b5bf0e4115e872f9a54))
+
+### [4.2.2](https://github.com/formatjs/react-intl/compare/v4.2.1...v4.2.2) (2020-03-21)
+
+
+### Bug Fixes
+
+* turn on preserveConstEnums so we export ReactIntlErrorCode ([8e00610](https://github.com/formatjs/react-intl/commit/8e006105a7286aba0efdb985eb588d03597b186b))
+
+### [4.2.1](https://github.com/formatjs/react-intl/compare/v4.2.0...v4.2.1) (2020-03-21)
+
+
+### Bug Fixes
+
+* include intl-displaynames types in bundled react-intl.d.ts ([77ef36c](https://github.com/formatjs/react-intl/commit/77ef36cb2f522587c454469241d9a4974963ccb8))
+
 ## [4.2.0](https://github.com/formatjs/react-intl/compare/v4.1.1...v4.2.0) (2020-03-21)
 
 

package/dist/components/message.d.ts

@@ -6,7 +6,7 @@ export interface Props<V extends Record<string, any> = Record<string, React.Reac
     tagName?: React.ElementType<any>;
     children?(...nodes: React.ReactNodeArray): React.ReactNode;
 }
-declare class FormattedMessage<T = React.ReactNode, V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T>>> extends React.Component<Props<V>> {
+declare class FormattedMessage<V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<React.ReactNode, React.ReactNode>>> extends React.Component<Props<V>> {
     static displayName: string;
     static defaultProps: {
         values: {};

package/dist/error.d.ts

@@ -1,3 +1,4 @@
+import { MessageDescriptor } from "./types";
 export declare const enum ReactIntlErrorCode {
     FORMAT_ERROR = "FORMAT_ERROR",
     UNSUPPORTED_FORMATTER = "UNSUPPORTED_FORMATTER",
@@ -6,6 +7,7 @@ export declare const enum ReactIntlErrorCode {
     MISSING_TRANSLATION = "MISSING_TRANSLATION"
 }
 export declare class ReactIntlError extends Error {
-    code: ReactIntlErrorCode;
-    constructor(code: ReactIntlErrorCode, message: string, exception?: Error);
+    readonly code: ReactIntlErrorCode;
+    readonly descriptor?: MessageDescriptor;
+    constructor(code: ReactIntlErrorCode, message: string, descriptor?: MessageDescriptor, exception?: Error);
 }

package/dist/error.js

@@ -13,11 +13,20 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+var ReactIntlErrorCode;
+(function (ReactIntlErrorCode) {
+    ReactIntlErrorCode["FORMAT_ERROR"] = "FORMAT_ERROR";
+    ReactIntlErrorCode["UNSUPPORTED_FORMATTER"] = "UNSUPPORTED_FORMATTER";
+    ReactIntlErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ReactIntlErrorCode["MISSING_DATA"] = "MISSING_DATA";
+    ReactIntlErrorCode["MISSING_TRANSLATION"] = "MISSING_TRANSLATION";
+})(ReactIntlErrorCode = exports.ReactIntlErrorCode || (exports.ReactIntlErrorCode = {}));
 var ReactIntlError = /** @class */ (function (_super) {
     __extends(ReactIntlError, _super);
-    function ReactIntlError(code, message, exception) {
+    function ReactIntlError(code, message, descriptor, exception) {
         var _this = _super.call(this, "[React Intl Error " + code + "] " + message + " " + (exception ? "\n" + exception.stack : '')) || this;
         _this.code = code;
+        _this.descriptor = descriptor;
         if (typeof Error.captureStackTrace === 'function') {
             Error.captureStackTrace(_this, ReactIntlError);
         }

package/dist/formatters/displayName.js

@@ -14,7 +14,7 @@ function formatDisplayName(_a, getDisplayNames, value, options) {
     if (options === void 0) { options = {}; }
     var DisplayNames = Intl.DisplayNames;
     if (!DisplayNames) {
-        onError(new intl_messageformat_1.FormatError("Intl.DisplayNames is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-displaynames\"\n", 2 /* MISSING_INTL_API */));
+        onError(new intl_messageformat_1.FormatError("Intl.DisplayNames is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-displaynames\"\n", "MISSING_INTL_API" /* MISSING_INTL_API */));
     }
     var filteredOptions = utils_1.filterProps(options, DISPLAY_NAMES_OPTONS);
     try {

package/dist/formatters/list.js

@@ -17,7 +17,7 @@ function formatList(_a, getListFormat, values, options) {
     if (options === void 0) { options = {}; }
     var ListFormat = Intl.ListFormat;
     if (!ListFormat) {
-        onError(new intl_messageformat_1.FormatError("Intl.ListFormat is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-listformat\"\n", 2 /* MISSING_INTL_API */));
+        onError(new intl_messageformat_1.FormatError("Intl.ListFormat is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-listformat\"\n", "MISSING_INTL_API" /* MISSING_INTL_API */));
     }
     var filteredOptions = utils_1.filterProps(options, LIST_FORMAT_OPTIONS);
     try {

package/dist/formatters/message.js

@@ -70,7 +70,7 @@ function formatMessage(_a, state, messageDescriptor, values) {
         }
         catch (e) {
             onError(new error_1.ReactIntlError("FORMAT_ERROR" /* FORMAT_ERROR */, "Error formatting message: \"" + id + "\" for locale: \"" + locale + "\"" +
-                (defaultMessage ? ', using default message as fallback.' : ''), e));
+                (defaultMessage ? ', using default message as fallback.' : ''), messageDescriptor, e));
         }
     }
     else if (!defaultMessage ||
@@ -79,7 +79,7 @@ function formatMessage(_a, state, messageDescriptor, values) {
         // when no `messages` are passed into the <IntlProvider> for the
         // default locale.
         onError(new error_1.ReactIntlError("MISSING_TRANSLATION" /* MISSING_TRANSLATION */, "Missing message: \"" + id + "\" for locale: \"" + locale + "\"" +
-            (defaultMessage ? ', using default message as fallback.' : '')));
+            (defaultMessage ? ', using default message as fallback.' : ''), messageDescriptor));
     }
     if (!formattedMessageParts && defaultMessage) {
         try {
@@ -87,12 +87,12 @@ function formatMessage(_a, state, messageDescriptor, values) {
             formattedMessageParts = formatter.format(values);
         }
         catch (e) {
-            onError(new error_1.ReactIntlError("FORMAT_ERROR" /* FORMAT_ERROR */, "Error formatting the default message for: \"" + id + "\"", e));
+            onError(new error_1.ReactIntlError("FORMAT_ERROR" /* FORMAT_ERROR */, "Error formatting the default message for: \"" + id + "\"", messageDescriptor, e));
         }
     }
     if (!formattedMessageParts) {
         onError(new error_1.ReactIntlError("FORMAT_ERROR" /* FORMAT_ERROR */, "Cannot format message: \"" + id + "\", " +
-            ("using message " + (message || defaultMessage ? 'source' : 'id') + " as fallback.")));
+            ("using message " + (message || defaultMessage ? 'source' : 'id') + " as fallback."), messageDescriptor));
         if (typeof message === 'string') {
             return message || defaultMessage || String(id);
         }

package/dist/formatters/plural.js

@@ -11,7 +11,7 @@ function formatPlural(_a, getPluralRules, value, options) {
     var locale = _a.locale, onError = _a.onError;
     if (options === void 0) { options = {}; }
     if (!Intl.PluralRules) {
-        onError(new intl_messageformat_1.FormatError("Intl.PluralRules is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-pluralrules\"\n", 2 /* MISSING_INTL_API */));
+        onError(new intl_messageformat_1.FormatError("Intl.PluralRules is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-pluralrules\"\n", "MISSING_INTL_API" /* MISSING_INTL_API */));
     }
     var filteredOptions = utils_1.filterProps(options, PLURAL_FORMAT_OPTIONS);
     try {

package/dist/formatters/relativeTime.js

@@ -22,7 +22,7 @@ function formatRelativeTime(config, getRelativeTimeFormat, value, unit, options)
     }
     var RelativeTimeFormat = Intl.RelativeTimeFormat;
     if (!RelativeTimeFormat) {
-        config.onError(new intl_messageformat_1.FormatError("Intl.RelativeTimeFormat is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-relativetimeformat\"\n", 2 /* MISSING_INTL_API */));
+        config.onError(new intl_messageformat_1.FormatError("Intl.RelativeTimeFormat is not available in this environment.\nTry polyfilling it using \"@formatjs/intl-relativetimeformat\"\n", "MISSING_INTL_API" /* MISSING_INTL_API */));
     }
     try {
         return getFormatter(config, getRelativeTimeFormat, options).format(value, unit);

package/dist/index.js

@@ -34,3 +34,4 @@ var utils_1 = require("./utils");
 exports.createIntlCache = utils_1.createIntlCache;
 var error_1 = require("./error");
 exports.ReactIntlError = error_1.ReactIntlError;
+exports.ReactIntlErrorCode = error_1.ReactIntlErrorCode;

package/dist/react-intl.api.md

@@ -4,9 +4,6 @@
 
 ```ts
 
-import { DisplayNames } from '@formatjs/intl-displaynames';
-import { DisplayNamesOptions } from '@formatjs/intl-displaynames';
-import { DisplayNamesOptions as DisplayNamesOptions_2 } from '@formatjs/intl-displaynames/lib';
 import * as React from 'react';
 
 // Warning: (ae-forgotten-export) The symbol "OptionalIntlConfig" needs to be exported by the entry point index.d.ts
@@ -39,6 +36,8 @@ export function defineMessages<T, U extends Record<string, T>>(msgs: U): U;
 // @public (undocumented)
 export type FormatDateOptions = Exclude<Intl.DateTimeFormatOptions, 'localeMatcher'> & CustomFormatConfig;
 
+// Warning: (ae-forgotten-export) The symbol "DisplayNamesOptions" needs to be exported by the entry point index.d.ts
+//
 // @public (undocumented)
 export type FormatDisplayNameOptions = Exclude<DisplayNamesOptions, 'localeMatcher'>;
 
@@ -70,7 +69,7 @@ export const FormattedDateParts: React.FC<Intl.DateTimeFormatOptions & CustomFor
 }>;
 
 // @public (undocumented)
-export const FormattedDisplayName: React.FC<DisplayNamesOptions_2 & {
+export const FormattedDisplayName: React.FC<DisplayNamesOptions & {
     value: string | number | object;
 }>;
 
@@ -84,7 +83,7 @@ export const FormattedList: React.FC<IntlListFormatOptions & {
 // Warning: (ae-forgotten-export) The symbol "Props" needs to be exported by the entry point index.d.ts
 //
 // @public (undocumented)
-export class FormattedMessage<T = React.ReactNode, V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T>>> extends React.Component<Props_3<V>> {
+export class FormattedMessage<V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<React.ReactNode, React.ReactNode>>> extends React.Component<Props_3<V>> {
     // (undocumented)
     static defaultProps: {
         values: {};
@@ -162,6 +161,8 @@ export const FormattedTimeParts: React.FC<Intl.DateTimeFormatOptions & CustomFor
 export interface Formatters {
     // (undocumented)
     getDateTimeFormat(...args: ConstructorParameters<typeof Intl.DateTimeFormat>): Intl.DateTimeFormat;
+    // Warning: (ae-forgotten-export) The symbol "DisplayNames" needs to be exported by the entry point index.d.ts
+    //
     // (undocumented)
     getDisplayNames(...args: ConstructorParameters<typeof DisplayNames>): DisplayNames;
     // Warning: (ae-forgotten-export) The symbol "ListFormat" needs to be exported by the entry point index.d.ts
@@ -242,7 +243,7 @@ export interface IntlConfig {
 export const IntlContext: React.Context<IntlShape>;
 
 // @public (undocumented)
-export interface IntlFormatters<T = React.ReactNode> {
+export interface IntlFormatters<T = React.ReactNode, R = T> {
     // (undocumented)
     formatDate(value: Parameters<Intl.DateTimeFormat['format']>[0] | string, opts?: FormatDateOptions): string;
     // (undocumented)
@@ -256,7 +257,7 @@ export interface IntlFormatters<T = React.ReactNode> {
     // (undocumented)
     formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType>): string;
     // (undocumented)
-    formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T>>): string | React.ReactNodeArray;
+    formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T, R>>): string | React.ReactNodeArray;
     // (undocumented)
     formatNumber(value: Parameters<Intl.NumberFormat['format']>[0], opts?: FormatNumberOptions): string;
     // (undocumented)
@@ -311,9 +312,11 @@ export const RawIntlProvider: React.Provider<IntlShape>;
 
 // @public (undocumented)
 export class ReactIntlError extends Error {
-    constructor(code: ReactIntlErrorCode, message: string, exception?: Error);
+    constructor(code: ReactIntlErrorCode, message: string, descriptor?: MessageDescriptor, exception?: Error);
+    // (undocumented)
+    readonly code: ReactIntlErrorCode;
     // (undocumented)
-    code: ReactIntlErrorCode;
+    readonly descriptor?: MessageDescriptor;
 }
 
 // @public (undocumented)

package/dist/react-intl.d.ts

@@ -1,6 +1,3 @@
-import { DisplayNames } from '@formatjs/intl-displaynames';
-import { DisplayNamesOptions } from '@formatjs/intl-displaynames';
-import { DisplayNamesOptions as DisplayNamesOptions_2 } from '@formatjs/intl-displaynames/lib';
 import * as React from 'react';
 
 declare type ArgumentElement = BaseElement<TYPE.argument>;
@@ -20,6 +17,8 @@ export declare function createIntl(config: OptionalIntlConfig, cache?: IntlCache
 
 export declare function createIntlCache(): IntlCache;
 
+declare type CurrencyCode = string;
+
 export declare interface CustomFormatConfig {
     format?: string;
 }
@@ -40,15 +39,84 @@ declare const DEFAULT_INTL_CONFIG: Pick<IntlConfig, 'formats' | 'messages' | 'ti
 
 export declare function defineMessages<T, U extends Record<string, T>>(msgs: U): U;
 
+declare class DisplayNames {
+    constructor(locales?: string | string[], options?: DisplayNamesOptions);
+    static supportedLocalesOf(locales?: string | string[], options?: Pick<DisplayNamesOptions, 'localeMatcher'>): string[];
+    static __addLocaleData(...data: DisplayNamesLocaleData[]): void;
+    of(code: string | number | object): string | undefined;
+    resolvedOptions(): DisplayNamesResolvedOptions;
+    static localeData: Record<string, DisplayNamesData>;
+    private static availableLocales;
+    private static __defaultLocale;
+    private static getDefaultLocale;
+    static readonly polyfilled = true;
+}
+
+declare interface DisplayNamesData {
+    /**
+     * Note that for style fields, `short` and `narrow` might not exist.
+     * At runtime, the fallback order will be narrow -> short -> long.
+     */
+    types: {
+        /**
+         * Maps language subtag like `zh-CN` to their display names.
+         */
+        language: {
+            narrow: Record<LanguageTag, string>;
+            short: Record<LanguageTag, string>;
+            long: Record<LanguageTag, string>;
+        };
+        region: {
+            narrow: Record<RegionCode, string>;
+            short: Record<RegionCode, string>;
+            long: Record<RegionCode, string>;
+        };
+        script: {
+            narrow: Record<ScriptCode, string>;
+            short: Record<ScriptCode, string>;
+            long: Record<ScriptCode, string>;
+        };
+        currency: {
+            narrow: Record<CurrencyCode, string>;
+            short: Record<CurrencyCode, string>;
+            long: Record<CurrencyCode, string>;
+        };
+    };
+    /**
+     * Not in spec, but we need this to display both language and region in display name.
+     * e.g. zh-Hans-SG + "{0}（{1}）" -> 简体中文（新加坡）
+     * Here {0} is replaced by language display name and {1} is replaced by region display name.
+     */
+    patterns: {
+        locale: string;
+    };
+}
+
+declare type DisplayNamesLocaleData = LocaleData<DisplayNamesData>;
+
+declare interface DisplayNamesOptions {
+    localeMatcher?: 'lookup' | 'best fit';
+    style?: 'narrow' | 'short' | 'long';
+    type?: 'language' | 'region' | 'script' | 'currency';
+    fallback?: 'code' | 'none';
+}
+
+declare interface DisplayNamesResolvedOptions {
+    locale: string;
+    style: NonNullable<DisplayNamesOptions['style']>;
+    type: NonNullable<DisplayNamesOptions['type']>;
+    fallback: NonNullable<DisplayNamesOptions['fallback']>;
+}
+
 declare interface ElementPart {
     type: 'element';
     value: string;
 }
 
 declare const enum ErrorCode {
-    MISSING_VALUE = 0,
-    INVALID_VALUE = 1,
-    MISSING_INTL_API = 2
+    MISSING_VALUE = "MISSING_VALUE",
+    INVALID_VALUE = "INVALID_VALUE",
+    MISSING_INTL_API = "MISSING_INTL_API"
 }
 
 declare interface FieldData {
@@ -69,7 +137,15 @@ export declare type FormatDisplayNameOptions = Exclude<DisplayNamesOptions, 'loc
 
 declare class FormatError extends Error {
     readonly code: ErrorCode;
-    constructor(msg: string, code: ErrorCode);
+    /**
+     * Original message we're trying to format
+     * `undefined` if we're only dealing w/ AST
+     *
+     * @type {(string | undefined)}
+     * @memberof FormatError
+     */
+    readonly originalMessage: string | undefined;
+    constructor(msg: string, code: ErrorCode, originalMessage?: string);
     toString(): string;
 }
 
@@ -98,7 +174,7 @@ export declare const FormattedDateParts: React.FC<Intl.DateTimeFormatOptions & C
     children(val: Intl.DateTimeFormatPart[]): React.ReactElement<any, string | ((props: any) => React.ReactElement<any, string | any | (new (props: any) => React.Component<any, any, any>)> | null) | (new (props: any) => React.Component<any, any, any>)> | null;
 }>;
 
-export declare const FormattedDisplayName: React.FC<DisplayNamesOptions_2 & {
+export declare const FormattedDisplayName: React.FC<DisplayNamesOptions & {
     value: string | number | object;
 }>;
 
@@ -106,7 +182,7 @@ export declare const FormattedList: React.FC<IntlListFormatOptions & {
     value: React.ReactNode[];
 }>;
 
-export declare class FormattedMessage<T = React.ReactNode, V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T>>> extends React.Component<Props_3<V>> {
+export declare class FormattedMessage<V extends Record<string, any> = Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<React.ReactNode, React.ReactNode>>> extends React.Component<Props_3<V>> {
     static displayName: string;
     static defaultProps: {
         values: {};
@@ -177,7 +253,7 @@ declare interface Formatters_2 {
     getPluralRules(...args: ConstructorParameters<typeof Intl.PluralRules>): Intl.PluralRules;
 }
 
-declare type FormatXMLElementFn<T> = (...args: Array<string | T>) => string | Array<string | T>;
+declare type FormatXMLElementFn<T, R = string | Array<string | T>> = (...args: Array<string | T>) => R;
 
 export declare function injectIntl<IntlPropName extends string, P extends WrappedComponentProps<IntlPropName> = WrappedComponentProps<any>>(WrappedComponent: React.ComponentType<P>, options?: Opts<IntlPropName, false>): React.FC<WithIntlProps<P>> & {
     WrappedComponent: React.ComponentType<P>;
@@ -211,7 +287,7 @@ export declare interface IntlConfig {
 
 export declare const IntlContext: React.Context<IntlShape>;
 
-export declare interface IntlFormatters<T = React.ReactNode> {
+export declare interface IntlFormatters<T = React.ReactNode, R = T> {
     formatDate(value: Parameters<Intl.DateTimeFormat['format']>[0] | string, opts?: FormatDateOptions): string;
     formatTime(value: Parameters<Intl.DateTimeFormat['format']>[0] | string, opts?: FormatDateOptions): string;
     formatDateToParts(value: Parameters<Intl.DateTimeFormat['format']>[0] | string, opts?: FormatDateOptions): Intl.DateTimeFormatPart[];
@@ -221,7 +297,7 @@ export declare interface IntlFormatters<T = React.ReactNode> {
     formatNumberToParts(value: Parameters<Intl.NumberFormat['format']>[0], opts?: FormatNumberOptions): Intl.NumberFormatPart[];
     formatPlural(value: Parameters<Intl.PluralRules['select']>[0], opts?: FormatPluralOptions): ReturnType<Intl.PluralRules['select']>;
     formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType>): string;
-    formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T>>): string | React.ReactNodeArray;
+    formatMessage(descriptor: MessageDescriptor, values?: Record<string, PrimitiveType | React.ReactElement | FormatXMLElementFn<T, R>>): string | React.ReactNodeArray;
     formatList(values: Array<string>, opts?: FormatListOptions): string;
     formatList(values: Array<string | React.ReactNode>, opts?: FormatListOptions): React.ReactNode;
     formatDisplayName(value: Parameters<DisplayNames['of']>[0], opts?: FormatDisplayNameOptions): string | undefined;
@@ -261,8 +337,8 @@ declare class IntlMessageFormat {
     private readonly message;
     private readonly formatterCache;
     constructor(message: string | MessageFormatElement[], locales?: string | string[], overrideFormats?: Partial<Formats>, opts?: Options);
-    format: <T = void>(values?: Record<string, string | number | boolean | Date | T | FormatXMLElementFn<T> | null | undefined> | undefined) => string | T | (string | T)[];
-    formatToParts: <T>(values?: Record<string, string | number | boolean | Date | T | FormatXMLElementFn<T> | null | undefined> | undefined) => MessageFormatPart<T>[];
+    format: <T = void>(values?: Record<string, string | number | boolean | Date | T | FormatXMLElementFn<T, string | (string | T)[]> | null | undefined> | undefined) => string | T | (string | T)[];
+    formatToParts: <T>(values?: Record<string, string | number | boolean | Date | T | FormatXMLElementFn<T, string | (string | T)[]> | null | undefined> | undefined) => MessageFormatPart<T>[];
     resolvedOptions: () => {
         locale: string;
     };
@@ -373,6 +449,8 @@ declare interface IParseOptions {
     [key: string]: any;
 }
 
+declare type LanguageTag = string;
+
 declare type LDMLPluralRule = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
 
 declare class ListFormat {
@@ -573,8 +651,9 @@ declare interface Props_3<V extends Record<string, any> = Record<string, React.R
 export declare const RawIntlProvider: React.Provider<IntlShape>;
 
 export declare class ReactIntlError extends Error {
-    code: ReactIntlErrorCode;
-    constructor(code: ReactIntlErrorCode, message: string, exception?: Error);
+    readonly code: ReactIntlErrorCode;
+    readonly descriptor?: MessageDescriptor;
+    constructor(code: ReactIntlErrorCode, message: string, descriptor?: MessageDescriptor, exception?: Error);
 }
 
 export declare const enum ReactIntlErrorCode {
@@ -585,6 +664,8 @@ export declare const enum ReactIntlErrorCode {
     MISSING_TRANSLATION = "MISSING_TRANSLATION"
 }
 
+declare type RegionCode = string;
+
 declare type RelativeTimeData = {
     [u in LDMLPluralRule]?: string;
 };
@@ -656,6 +737,8 @@ declare interface ResolvedIntlRelativeTimeFormatOptions extends Pick<IntlRelativ
     numberingSystem: string;
 }
 
+declare type ScriptCode = string;
+
 declare interface SelectElement extends BaseElement<TYPE.select> {
     options: Record<string, PluralOrSelectOption>;
 }