@openedx/frontend-base 1.0.0-alpha.21 → 1.0.0-alpha.22

package/dist/runtime/i18n/index.d.ts

@@ -1,3 +1,3 @@
 export { default as injectIntl } from "./injectIntlWithShim";
 export { createIntl, defineMessages, FormattedDate, FormattedMessage, FormattedNumber, FormattedPlural, FormattedRelativeTime, FormattedTime, IntlProvider, useIntl } from "react-intl";
-export { addAppMessages, configureI18n, getLocale, getLocalizedLanguageName, getMessages, getPrimaryLanguageSubtag, getSupportedLanguageList, handleRtl, intlShape, isRtl, LOCALE_CHANGED, LOCALE_TOPIC, mergeMessages, updateLocale } from "./lib";
+export { configureI18n, getLocale, getLocalizedLanguageName, getMessages, getPrimaryLanguageSubtag, getSupportedLanguageList, handleRtl, intlShape, isRtl, LOCALE_CHANGED, LOCALE_TOPIC, mergeMessages, updateLocale } from "./lib";

package/dist/runtime/i18n/index.js

@@ -73,6 +73,6 @@
  * @see {@link https://formatjs.io/docs/react-intl/api#useIntl Intl}
  */
 export { createIntl, defineMessages, FormattedDate, FormattedMessage, FormattedNumber, FormattedPlural, FormattedRelativeTime, FormattedTime, IntlProvider, useIntl } from 'react-intl';
-export { addAppMessages, configureI18n, getLocale, getLocalizedLanguageName, getMessages, getPrimaryLanguageSubtag, getSupportedLanguageList, handleRtl, intlShape, isRtl, LOCALE_CHANGED, LOCALE_TOPIC, mergeMessages, updateLocale } from './lib';
+export { configureI18n, getLocale, getLocalizedLanguageName, getMessages, getPrimaryLanguageSubtag, getSupportedLanguageList, handleRtl, intlShape, isRtl, LOCALE_CHANGED, LOCALE_TOPIC, mergeMessages, updateLocale } from './lib';
 export { default as injectIntl } from './injectIntlWithShim';
 //# sourceMappingURL=index.js.map

package/dist/runtime/i18n/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../runtime/i18n/index.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,wBAAwB,EACxB,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,SAAS,EACT,SAAS,EACT,KAAK,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,OAAO,IAAI,UAAU,EACtB,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * #### Import members from **@openedx/frontend-base**\n * The i18n module relies on react-intl and re-exports all of that package's exports.\n *\n * For each locale we want to support, react-intl needs 1) the locale-data, which includes\n * information about how to format numbers, handle plurals, etc., and 2) the translations, as an\n * object holding message id / translated string pairs.  A locale string and the messages object are\n * passed into the IntlProvider element that wraps your element hierarchy.\n *\n * Note that react-intl has no way of checking if the translations you give it actually have\n * anything to do with the locale you pass it; it will happily use whatever messages object you pass\n * in.  However, if the locale data for the locale you passed into the IntlProvider was not\n * correctly installed with addLocaleData, all of your translations will fall back to the default\n * (in our case English), *even if you gave IntlProvider the correct messages object for that\n * locale*.\n *\n * Messages are provided to this module via the configureI18n() function below.\n *\n *\n * @module Internationalization\n * @see {@link https://github.com/openedx/frontend-base/blob/master/docs/how_tos/i18n.rst}\n * @see {@link https://formatjs.io/docs/react-intl/components/ Intl} for components exported from this module.\n *\n */\n\n/**\n * @name createIntl\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#createIntl Intl}\n */\n\n/**\n * @name FormattedDate\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formatteddate Intl}\n */\n\n/**\n * @name FormattedTime\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedtime Intl}\n */\n\n/**\n * @name FormattedRelativeTime\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedrelativetime Intl}\n */\n\n/**\n * @name FormattedNumber\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattednumber Intl}\n */\n\n/**\n * @name FormattedPlural\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedplural Intl}\n */\n\n/**\n * @name FormattedMessage\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedmessage Intl}\n */\n\n/**\n * @name IntlProvider\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#intlprovider Intl}\n */\n\n/**\n * @name defineMessages\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#definemessagesdefinemessage Intl}\n */\n\n/**\n * @name useIntl\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#useIntl Intl}\n */\n\nexport {\n  createIntl,\n  defineMessages,\n  FormattedDate,\n  FormattedMessage,\n  FormattedNumber,\n  FormattedPlural,\n  FormattedRelativeTime,\n  FormattedTime,\n  IntlProvider,\n  useIntl\n} from 'react-intl';\n\nexport {\n  addAppMessages,\n  configureI18n,\n  getLocale,\n  getLocalizedLanguageName,\n  getMessages,\n  getPrimaryLanguageSubtag,\n  getSupportedLanguageList,\n  handleRtl,\n  intlShape,\n  isRtl,\n  LOCALE_CHANGED,\n  LOCALE_TOPIC,\n  mergeMessages,\n  updateLocale\n} from './lib';\n\nexport {\n  default as injectIntl\n} from './injectIntlWithShim';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../runtime/i18n/index.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,SAAS,EACT,wBAAwB,EACxB,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,SAAS,EACT,SAAS,EACT,KAAK,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,OAAO,IAAI,UAAU,EACtB,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * #### Import members from **@openedx/frontend-base**\n * The i18n module relies on react-intl and re-exports all of that package's exports.\n *\n * For each locale we want to support, react-intl needs 1) the locale-data, which includes\n * information about how to format numbers, handle plurals, etc., and 2) the translations, as an\n * object holding message id / translated string pairs.  A locale string and the messages object are\n * passed into the IntlProvider element that wraps your element hierarchy.\n *\n * Note that react-intl has no way of checking if the translations you give it actually have\n * anything to do with the locale you pass it; it will happily use whatever messages object you pass\n * in.  However, if the locale data for the locale you passed into the IntlProvider was not\n * correctly installed with addLocaleData, all of your translations will fall back to the default\n * (in our case English), *even if you gave IntlProvider the correct messages object for that\n * locale*.\n *\n * Messages are provided to this module via the configureI18n() function below.\n *\n *\n * @module Internationalization\n * @see {@link https://github.com/openedx/frontend-base/blob/master/docs/how_tos/i18n.rst}\n * @see {@link https://formatjs.io/docs/react-intl/components/ Intl} for components exported from this module.\n *\n */\n\n/**\n * @name createIntl\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#createIntl Intl}\n */\n\n/**\n * @name FormattedDate\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formatteddate Intl}\n */\n\n/**\n * @name FormattedTime\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedtime Intl}\n */\n\n/**\n * @name FormattedRelativeTime\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedrelativetime Intl}\n */\n\n/**\n * @name FormattedNumber\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattednumber Intl}\n */\n\n/**\n * @name FormattedPlural\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedplural Intl}\n */\n\n/**\n * @name FormattedMessage\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#formattedmessage Intl}\n */\n\n/**\n * @name IntlProvider\n * @kind class\n * @see {@link https://formatjs.io/docs/react-intl/components/#intlprovider Intl}\n */\n\n/**\n * @name defineMessages\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#definemessagesdefinemessage Intl}\n */\n\n/**\n * @name useIntl\n * @kind function\n * @see {@link https://formatjs.io/docs/react-intl/api#useIntl Intl}\n */\n\nexport {\n  createIntl,\n  defineMessages,\n  FormattedDate,\n  FormattedMessage,\n  FormattedNumber,\n  FormattedPlural,\n  FormattedRelativeTime,\n  FormattedTime,\n  IntlProvider,\n  useIntl\n} from 'react-intl';\n\nexport {\n  configureI18n,\n  getLocale,\n  getLocalizedLanguageName,\n  getMessages,\n  getPrimaryLanguageSubtag,\n  getSupportedLanguageList,\n  handleRtl,\n  intlShape,\n  isRtl,\n  LOCALE_CHANGED,\n  LOCALE_TOPIC,\n  mergeMessages,\n  updateLocale\n} from './lib';\n\nexport {\n  default as injectIntl\n} from './injectIntlWithShim';\n"]}

package/dist/runtime/i18n/lib.d.ts

@@ -96,12 +96,6 @@ export declare function handleRtl(): void;
  * @memberof module:Internationalization
  */
 export declare function mergeMessages(newMessages?: {}): Record<string, Record<string, string> | Record<string, MessageFormatElement[]> | undefined>;
-/**
- * Adds all the messages found in the loaded apps.
- *
- * @memberof module:Internationalization
- */
-export declare function addAppMessages(): void;
 interface ConfigureI18nOptions {
     messages: LocalizedMessages[] | LocalizedMessages;
 }

package/dist/runtime/i18n/lib.js

@@ -206,19 +206,6 @@ export function mergeMessages(newMessages = {}) {
     messages = merge(messages, msgs);
     return messages;
 }
-/**
- * Adds all the messages found in the loaded apps.
- *
- * @memberof module:Internationalization
- */
-export function addAppMessages() {
-    const { apps } = getSiteConfig();
-    if (apps) {
-        apps.forEach((app) => {
-            mergeMessages(app.messages);
-        });
-    }
-}
 /**
  * Configures the i18n library with messages for your application.
  *

package/dist/runtime/i18n/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../../runtime/i18n/lib.ts"],"names":[],"mappings":"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","sourcesContent":["import merge from 'lodash.merge';\nimport PropTypes from 'prop-types';\nimport { MessageFormatElement } from 'react-intl';\nimport Cookies from 'universal-cookie';\n\nimport { LocalizedMessages } from '../../types';\nimport { getSiteConfig } from '../config';\nimport { publish } from '../subscriptions';\n\nconst cookies = new Cookies();\n\n// This list is based on https://help.smartling.com/hc/en-us/articles/1260802028830-Right-to-left-RTL-Languages\n// There are very few resources available online outlining the locale codes for RTL languages;\n// If this list is inaccurate, we should change it.\nconst rtlLocales = [\n  'ar', // Arabic (International)\n  'ar-ae', // Arabic (United Arab Emirates)\n  'ar-bh', // Arabic (Bahrain)\n  'ar-dj', // Arabic (Djibouti)\n  'ar-dz', // Arabic (Algeria)\n  'ar-eg', // Arabic (Egypt)\n  'ar-iq', // Arabic (Iraq)\n  'ar-jo', // Arabic (Jordan)\n  'ar-kw', // Arabic (Kuwait)\n  'ar-lb', // Arabic (Lebanon)\n  'ar-ly', // Arabic (Libya)\n  'ar-ma', // Arabic (Morocco)\n  'ar-om', // Arabic (Oman)\n  'ar-qa', // Arabic (Qatar)\n  'ar-sa', // Arabic (Saudi Arabia)\n  'ar-sd', // Arabic (Sudan)\n  'ar-sy', // Arabic (Syria)\n  'ar-tn', // Arabic (Tunisia)\n  'ar-ye', // Arabic (Yemen)\n  'fa', // Persian\n  'fa-af', // Dari/Persian (Afghanistan)\n  'fa-ir', // Persian (Iran)\n  'he', // Hebrew (he)\n  'he-il', // Hebrew\n  'iw', // Hebrew (iw)\n  'kd', // Kurdish (Sorani) RTL\n  'pk-pk', // Panjabi-Shahmuki (Pakistan)\n  'ps', // Pushto; Pashto\n  'ug', // Uighur; Uyghur\n  'ur', // Urdu\n  'ur-in', // Urdu (India)\n  'ur-pk', // Urdu (Pakistan)\n  'yi', // Yiddish\n  'yi-us', // Yiddish (United States)\n];\n\nlet messages: Record<string, Record<string, string> | Record<string, MessageFormatElement[]> | undefined>;\n\n/**\n * @memberof module:Internationalization\n *\n * Prior versions of react-intl (our primary implementation of the i18n service) included a\n * PropTypes-based 'shape' for its `intl` object.  This has since been removed.  For legacy\n * compatibility, we include an `intlShape` export that is set to PropTypes.object.  Usage of this\n * export is deprecated.\n *\n * @deprecated\n */\nexport const intlShape = PropTypes.object;\n\n/**\n * @memberof module:Internationalization\n */\nexport const LOCALE_TOPIC = 'LOCALE';\n\n/**\n * @memberof module:Internationalization\n */\nexport const LOCALE_CHANGED = `${LOCALE_TOPIC}.CHANGED`;\n\n/**\n *\n * @memberof module:Internationalization\n * @returns {Cookies}\n */\nexport function getCookies() {\n  return cookies;\n}\n\n/**\n * Some of our dependencies function on primary language subtags, rather than full locales.\n * This function strips a locale down to that first subtag.  Depending on the code, this\n * may be 2 or more characters.\n *\n * @param {string} code\n * @memberof module:Internationalization\n */\nexport function getPrimaryLanguageSubtag(code) {\n  return code.split('-')[0];\n}\n\n/**\n * Finds the closest supported locale to the one provided.  This is done in three steps:\n *\n * 1. Returning the locale itself if its exact language code is supported.\n * 2. Returning the primary language subtag of the language code if it is supported (ar for ar-eg,\n * for instance).\n * 3. Returning 'en' if neither of the above produce a supported locale.\n *\n * @param {string} locale\n * @returns {string}\n * @memberof module:Internationalization\n */\nexport function findSupportedLocale(locale) {\n  if (messages === undefined) {\n    throw new Error('findSupportedLocale called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  if (messages[locale] !== undefined) {\n    return locale;\n  }\n\n  if (messages[getPrimaryLanguageSubtag(locale)] !== undefined) {\n    return getPrimaryLanguageSubtag(locale);\n  }\n\n  return 'en';\n}\n\n/**\n * Get the locale from the cookie or, failing that, the browser setting.\n * Gracefully fall back to a more general primary language subtag or to English (en)\n * if we don't support that language.\n *\n * @param {string|undefined} locale If a locale is provided, returns the closest supported locale. Optional.\n * @throws An error if i18n has not yet been configured.\n * @returns {string}\n * @memberof module:Internationalization\n */\nexport function getLocale(locale?: string) {\n  if (messages === null) {\n    throw new Error('getLocale called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  // 1. Explicit application request\n  if (locale !== undefined) {\n    return findSupportedLocale(locale);\n  }\n  // 2. User setting in cookie\n\n  const { languagePreferenceCookieName } = getSiteConfig();\n  if (languagePreferenceCookieName) {\n    const languagePreference = cookies.get(languagePreferenceCookieName);\n    if (languagePreference) {\n      return findSupportedLocale(languagePreference.toLowerCase());\n    }\n  }\n\n  // 3. Browser language (default)\n  // Note that some browers prefer upper case for the region part of the locale, while others don't.\n  // Thus the toLowerCase, for consistency.\n  // https://developer.mozilla.org/en-US/docs/Web/API/NavigatorLanguage/language\n  return findSupportedLocale(globalThis.navigator.language.toLowerCase());\n}\n\nexport function getLocalizedLanguageName(locale) {\n  const localizedName = (new Intl.DisplayNames([locale], { type: 'language' })).of(locale);\n\n  if (localizedName === undefined) {\n    throw new Error(`Unsupported locale: ${locale}`);\n  }\n\n  return `${localizedName.charAt(0).toLocaleUpperCase(locale)}${localizedName.slice(1)}`;\n}\n\nexport function getSupportedLanguageList() {\n  const locales = Object.keys(messages);\n  locales.push('en'); // 'en' is not in the messages object because it's the default.\n  locales.sort();\n\n  return locales.map((locale) => ({\n    code: locale,\n    name: getLocalizedLanguageName(locale),\n  }));\n}\n\nexport function updateLocale() {\n  handleRtl();\n  publish(LOCALE_CHANGED);\n}\n\n/**\n * Returns messages for the provided locale, or the user's preferred locale if no argument is\n * provided.\n *\n * @param {string} [locale=getLocale()]\n * @memberof module:Internationalization\n */\nexport function getMessages(locale = getLocale()) {\n  if (messages === undefined) {\n    throw new Error('getMessages called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  return messages[locale];\n}\n\n/**\n * Determines if the provided locale is a right-to-left language.\n *\n * @param {string} locale\n * @memberof module:Internationalization\n */\nexport function isRtl(locale) {\n  return rtlLocales.includes(locale);\n}\n\n/**\n * Handles applying the RTL stylesheet and \"dir=rtl\" attribute to the html tag if the current locale\n * is a RTL language.\n *\n * @memberof module:Internationalization\n */\nexport function handleRtl() {\n  if (isRtl(getLocale())) {\n    globalThis.document.getElementsByTagName('html')[0].setAttribute('dir', 'rtl');\n  } else {\n    globalThis.document.getElementsByTagName('html')[0].setAttribute('dir', 'ltr');\n  }\n}\n\n/**\n *\n *\n * @param {Object} newMessages\n * @returns {Object}\n * @memberof module:Internationalization\n */\nexport function mergeMessages(newMessages = {}) {\n  const msgs = Array.isArray(newMessages) ? merge({}, ...newMessages) : newMessages;\n  messages = merge(messages, msgs);\n\n  return messages;\n}\n\n/**\n * Adds all the messages found in the loaded apps.\n *\n * @memberof module:Internationalization\n */\nexport function addAppMessages() {\n  const { apps } = getSiteConfig();\n  if (apps) {\n    apps.forEach((app) => {\n      mergeMessages(app.messages);\n    });\n  }\n}\n\ninterface ConfigureI18nOptions {\n  messages: LocalizedMessages[] | LocalizedMessages,\n}\n\n/**\n * Configures the i18n library with messages for your application.\n *\n * Logs a warning if it detects a locale it doesn't expect (as defined by the supportedLocales list\n * above), or if an expected locale is not provided.\n *\n * @param {Object} options\n * @param {Object} options.messages\n * @memberof module:Internationalization\n */\nexport function configureI18n(options: ConfigureI18nOptions) {\n  messages = Array.isArray(options.messages) ? merge({}, ...options.messages) : options.messages;\n\n  handleRtl();\n}\n"]}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../../runtime/i18n/lib.ts"],"names":[],"mappings":"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","sourcesContent":["import merge from 'lodash.merge';\nimport PropTypes from 'prop-types';\nimport { MessageFormatElement } from 'react-intl';\nimport Cookies from 'universal-cookie';\n\nimport { LocalizedMessages } from '../../types';\nimport { getSiteConfig } from '../config';\nimport { publish } from '../subscriptions';\n\nconst cookies = new Cookies();\n\n// This list is based on https://help.smartling.com/hc/en-us/articles/1260802028830-Right-to-left-RTL-Languages\n// There are very few resources available online outlining the locale codes for RTL languages;\n// If this list is inaccurate, we should change it.\nconst rtlLocales = [\n  'ar', // Arabic (International)\n  'ar-ae', // Arabic (United Arab Emirates)\n  'ar-bh', // Arabic (Bahrain)\n  'ar-dj', // Arabic (Djibouti)\n  'ar-dz', // Arabic (Algeria)\n  'ar-eg', // Arabic (Egypt)\n  'ar-iq', // Arabic (Iraq)\n  'ar-jo', // Arabic (Jordan)\n  'ar-kw', // Arabic (Kuwait)\n  'ar-lb', // Arabic (Lebanon)\n  'ar-ly', // Arabic (Libya)\n  'ar-ma', // Arabic (Morocco)\n  'ar-om', // Arabic (Oman)\n  'ar-qa', // Arabic (Qatar)\n  'ar-sa', // Arabic (Saudi Arabia)\n  'ar-sd', // Arabic (Sudan)\n  'ar-sy', // Arabic (Syria)\n  'ar-tn', // Arabic (Tunisia)\n  'ar-ye', // Arabic (Yemen)\n  'fa', // Persian\n  'fa-af', // Dari/Persian (Afghanistan)\n  'fa-ir', // Persian (Iran)\n  'he', // Hebrew (he)\n  'he-il', // Hebrew\n  'iw', // Hebrew (iw)\n  'kd', // Kurdish (Sorani) RTL\n  'pk-pk', // Panjabi-Shahmuki (Pakistan)\n  'ps', // Pushto; Pashto\n  'ug', // Uighur; Uyghur\n  'ur', // Urdu\n  'ur-in', // Urdu (India)\n  'ur-pk', // Urdu (Pakistan)\n  'yi', // Yiddish\n  'yi-us', // Yiddish (United States)\n];\n\nlet messages: Record<string, Record<string, string> | Record<string, MessageFormatElement[]> | undefined>;\n\n/**\n * @memberof module:Internationalization\n *\n * Prior versions of react-intl (our primary implementation of the i18n service) included a\n * PropTypes-based 'shape' for its `intl` object.  This has since been removed.  For legacy\n * compatibility, we include an `intlShape` export that is set to PropTypes.object.  Usage of this\n * export is deprecated.\n *\n * @deprecated\n */\nexport const intlShape = PropTypes.object;\n\n/**\n * @memberof module:Internationalization\n */\nexport const LOCALE_TOPIC = 'LOCALE';\n\n/**\n * @memberof module:Internationalization\n */\nexport const LOCALE_CHANGED = `${LOCALE_TOPIC}.CHANGED`;\n\n/**\n *\n * @memberof module:Internationalization\n * @returns {Cookies}\n */\nexport function getCookies() {\n  return cookies;\n}\n\n/**\n * Some of our dependencies function on primary language subtags, rather than full locales.\n * This function strips a locale down to that first subtag.  Depending on the code, this\n * may be 2 or more characters.\n *\n * @param {string} code\n * @memberof module:Internationalization\n */\nexport function getPrimaryLanguageSubtag(code) {\n  return code.split('-')[0];\n}\n\n/**\n * Finds the closest supported locale to the one provided.  This is done in three steps:\n *\n * 1. Returning the locale itself if its exact language code is supported.\n * 2. Returning the primary language subtag of the language code if it is supported (ar for ar-eg,\n * for instance).\n * 3. Returning 'en' if neither of the above produce a supported locale.\n *\n * @param {string} locale\n * @returns {string}\n * @memberof module:Internationalization\n */\nexport function findSupportedLocale(locale) {\n  if (messages === undefined) {\n    throw new Error('findSupportedLocale called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  if (messages[locale] !== undefined) {\n    return locale;\n  }\n\n  if (messages[getPrimaryLanguageSubtag(locale)] !== undefined) {\n    return getPrimaryLanguageSubtag(locale);\n  }\n\n  return 'en';\n}\n\n/**\n * Get the locale from the cookie or, failing that, the browser setting.\n * Gracefully fall back to a more general primary language subtag or to English (en)\n * if we don't support that language.\n *\n * @param {string|undefined} locale If a locale is provided, returns the closest supported locale. Optional.\n * @throws An error if i18n has not yet been configured.\n * @returns {string}\n * @memberof module:Internationalization\n */\nexport function getLocale(locale?: string) {\n  if (messages === null) {\n    throw new Error('getLocale called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  // 1. Explicit application request\n  if (locale !== undefined) {\n    return findSupportedLocale(locale);\n  }\n  // 2. User setting in cookie\n\n  const { languagePreferenceCookieName } = getSiteConfig();\n  if (languagePreferenceCookieName) {\n    const languagePreference = cookies.get(languagePreferenceCookieName);\n    if (languagePreference) {\n      return findSupportedLocale(languagePreference.toLowerCase());\n    }\n  }\n\n  // 3. Browser language (default)\n  // Note that some browers prefer upper case for the region part of the locale, while others don't.\n  // Thus the toLowerCase, for consistency.\n  // https://developer.mozilla.org/en-US/docs/Web/API/NavigatorLanguage/language\n  return findSupportedLocale(globalThis.navigator.language.toLowerCase());\n}\n\nexport function getLocalizedLanguageName(locale) {\n  const localizedName = (new Intl.DisplayNames([locale], { type: 'language' })).of(locale);\n\n  if (localizedName === undefined) {\n    throw new Error(`Unsupported locale: ${locale}`);\n  }\n\n  return `${localizedName.charAt(0).toLocaleUpperCase(locale)}${localizedName.slice(1)}`;\n}\n\nexport function getSupportedLanguageList() {\n  const locales = Object.keys(messages);\n  locales.push('en'); // 'en' is not in the messages object because it's the default.\n  locales.sort();\n\n  return locales.map((locale) => ({\n    code: locale,\n    name: getLocalizedLanguageName(locale),\n  }));\n}\n\nexport function updateLocale() {\n  handleRtl();\n  publish(LOCALE_CHANGED);\n}\n\n/**\n * Returns messages for the provided locale, or the user's preferred locale if no argument is\n * provided.\n *\n * @param {string} [locale=getLocale()]\n * @memberof module:Internationalization\n */\nexport function getMessages(locale = getLocale()) {\n  if (messages === undefined) {\n    throw new Error('getMessages called before configuring i18n. Call configureI18n with messages first.');\n  }\n\n  return messages[locale];\n}\n\n/**\n * Determines if the provided locale is a right-to-left language.\n *\n * @param {string} locale\n * @memberof module:Internationalization\n */\nexport function isRtl(locale) {\n  return rtlLocales.includes(locale);\n}\n\n/**\n * Handles applying the RTL stylesheet and \"dir=rtl\" attribute to the html tag if the current locale\n * is a RTL language.\n *\n * @memberof module:Internationalization\n */\nexport function handleRtl() {\n  if (isRtl(getLocale())) {\n    globalThis.document.getElementsByTagName('html')[0].setAttribute('dir', 'rtl');\n  } else {\n    globalThis.document.getElementsByTagName('html')[0].setAttribute('dir', 'ltr');\n  }\n}\n\n/**\n *\n *\n * @param {Object} newMessages\n * @returns {Object}\n * @memberof module:Internationalization\n */\nexport function mergeMessages(newMessages = {}) {\n  const msgs = Array.isArray(newMessages) ? merge({}, ...newMessages) : newMessages;\n  messages = merge(messages, msgs);\n\n  return messages;\n}\n\ninterface ConfigureI18nOptions {\n  messages: LocalizedMessages[] | LocalizedMessages,\n}\n\n/**\n * Configures the i18n library with messages for your application.\n *\n * Logs a warning if it detects a locale it doesn't expect (as defined by the supportedLocales list\n * above), or if an expected locale is not provided.\n *\n * @param {Object} options\n * @param {Object} options.messages\n * @memberof module:Internationalization\n */\nexport function configureI18n(options: ConfigureI18nOptions) {\n  messages = Array.isArray(options.messages) ? merge({}, ...options.messages) : options.messages;\n\n  handleRtl();\n}\n"]}

package/dist/shell/dev/devHome/app.js

@@ -1,5 +1,4 @@
 import HomePage from './HomePage';
-import messages from './i18n';
 const app = {
     appId: 'org.openedx.frontend.app.dev.home',
     routes: [{
@@ -10,7 +9,6 @@ const app = {
                 role: 'org.openedx.frontend.role.devHome'
             }
         }],
-    messages,
 };
 export default app;
 //# sourceMappingURL=app.js.map

package/dist/shell/dev/devHome/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../shell/dev/devHome/app.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,QAAQ,MAAM,QAAQ,CAAC;AAE9B,MAAM,GAAG,GAAQ;IACf,KAAK,EAAE,mCAAmC;IAC1C,MAAM,EAAE,CAAC;YACP,IAAI,EAAE,GAAG;YACT,EAAE,EAAE,qCAAqC;YACzC,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,mCAAmC;aAC1C;SACF,CAAC;IACF,QAAQ;CACT,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '../../../types';\nimport HomePage from './HomePage';\nimport messages from './i18n';\n\nconst app: App = {\n  appId: 'org.openedx.frontend.app.dev.home',\n  routes: [{\n    path: '/',\n    id: 'org.openedx.frontend.route.dev.home',\n    Component: HomePage,\n    handle: {\n      role: 'org.openedx.frontend.role.devHome'\n    }\n  }],\n  messages,\n};\n\nexport default app;\n"]}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../shell/dev/devHome/app.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC,MAAM,GAAG,GAAQ;IACf,KAAK,EAAE,mCAAmC;IAC1C,MAAM,EAAE,CAAC;YACP,IAAI,EAAE,GAAG;YACT,EAAE,EAAE,qCAAqC;YACzC,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,mCAAmC;aAC1C;SACF,CAAC;CACH,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '../../../types';\nimport HomePage from './HomePage';\n\nconst app: App = {\n  appId: 'org.openedx.frontend.app.dev.home',\n  routes: [{\n    path: '/',\n    id: 'org.openedx.frontend.route.dev.home',\n    Component: HomePage,\n    handle: {\n      role: 'org.openedx.frontend.role.devHome'\n    }\n  }],\n};\n\nexport default app;\n"]}

package/dist/shell/site.js

@@ -14,14 +14,12 @@ import { RouterProvider } from 'react-router-dom';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { SITE_INIT_ERROR, SITE_READY, initialize, subscribe } from '../runtime';
 import { addAppConfigs } from '../runtime/config';
-import { addAppMessages } from '../runtime/i18n';
-import messages from './i18n';
+import messages from 'site.i18n';
 import createRouter from './router/createRouter';
 subscribe(SITE_READY, () => __awaiter(void 0, void 0, void 0, function* () {
     const queryClient = new QueryClient();
     const router = createRouter();
     addAppConfigs();
-    addAppMessages();
     const root = createRoot(document.getElementById('root'));
     root.render(_jsx(StrictMode, { children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(RouterProvider, { router: router }) }) }));
 }));

package/dist/shell/site.js.map

@@ -1 +1 @@
-{"version":3,"file":"site.js","sourceRoot":"","sources":["../../shell/site.tsx"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,QAAQ,MAAM,QAAQ,CAAC;AAC9B,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD,SAAS,CAAC,UAAU,EAAE,GAAS,EAAE;IAC/B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,CAAC;IAEjB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAgB,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CACT,KAAC,UAAU,cACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,GACd,GACX,CACd,CAAC;AACJ,CAAC,CAAA,CAAC,CAAC;AAEH,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;IACnC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAgB,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,wBAAM,KAAK,CAAC,OAAO,GAAO,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,QAAQ;CACT,CAAC,CAAC","sourcesContent":["import { StrictMode } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { RouterProvider } from 'react-router-dom';\nimport { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n\nimport {\n  SITE_INIT_ERROR,\n  SITE_READY,\n  initialize,\n  subscribe\n} from '../runtime';\nimport { addAppConfigs } from '../runtime/config';\nimport { addAppMessages } from '../runtime/i18n';\nimport messages from './i18n';\nimport createRouter from './router/createRouter';\n\nsubscribe(SITE_READY, async () => {\n  const queryClient = new QueryClient();\n  const router = createRouter();\n\n  addAppConfigs();\n  addAppMessages();\n\n  const root = createRoot(document.getElementById('root') as HTMLElement);\n  root.render(\n    <StrictMode>\n      <QueryClientProvider client={queryClient}>\n        <RouterProvider router={router} />\n      </QueryClientProvider>\n    </StrictMode>\n  );\n});\n\nsubscribe(SITE_INIT_ERROR, (error) => {\n  const root = createRoot(document.getElementById('root') as HTMLElement);\n  root.render(<div>{error.message}</div>);\n});\n\ninitialize({\n  messages,\n});\n"]}
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../shell/site.tsx"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,YAAY,MAAM,uBAAuB,CAAC;AAEjD,SAAS,CAAC,UAAU,EAAE,GAAS,EAAE;IAC/B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,aAAa,EAAE,CAAC;IAEhB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAgB,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CACT,KAAC,UAAU,cACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,GACd,GACX,CACd,CAAC;AACJ,CAAC,CAAA,CAAC,CAAC;AAEH,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;IACnC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAgB,CAAC,CAAC;IACxE,IAAI,CAAC,MAAM,CAAC,wBAAM,KAAK,CAAC,OAAO,GAAO,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC;IACT,QAAQ;CACT,CAAC,CAAC","sourcesContent":["import { StrictMode } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { RouterProvider } from 'react-router-dom';\nimport { QueryClient, QueryClientProvider } from '@tanstack/react-query';\n\nimport {\n  SITE_INIT_ERROR,\n  SITE_READY,\n  initialize,\n  subscribe\n} from '../runtime';\nimport { addAppConfigs } from '../runtime/config';\nimport messages from 'site.i18n';\nimport createRouter from './router/createRouter';\n\nsubscribe(SITE_READY, async () => {\n  const queryClient = new QueryClient();\n  const router = createRouter();\n\n  addAppConfigs();\n\n  const root = createRoot(document.getElementById('root') as HTMLElement);\n  root.render(\n    <StrictMode>\n      <QueryClientProvider client={queryClient}>\n        <RouterProvider router={router} />\n      </QueryClientProvider>\n    </StrictMode>\n  );\n});\n\nsubscribe(SITE_INIT_ERROR, (error) => {\n  const root = createRoot(document.getElementById('root') as HTMLElement);\n  root.render(<div>{error.message}</div>);\n});\n\ninitialize({\n  messages,\n});\n"]}

package/dist/tools/cli/commands/translations.d.ts

@@ -0,0 +1,2 @@
+export declare function runPrepare(): void;
+export declare function runPull(): void;

package/dist/tools/cli/commands/translations.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPrepare = runPrepare;
+exports.runPull = runPull;
+const child_process_1 = __importDefault(require("child_process"));
+const translations_1 = require("../utils/translations");
+function runPrepare() {
+    (0, translations_1.prepare)({ siteRoot: process.cwd() });
+}
+function runPull() {
+    (0, translations_1.pull)({
+        siteRoot: process.cwd(),
+        execFileSync: (file, args) => child_process_1.default.execFileSync(file, args, { stdio: 'inherit' }),
+        shouldPrepare: !process.argv.includes('--no-prepare'),
+        atlasOptions: process.argv.find(a => a.startsWith('--atlas-options='))?.slice('--atlas-options='.length),
+    });
+}

package/dist/tools/cli/openedx.js

@@ -95,6 +95,12 @@ switch (commandName) {
     case types_1.CommandTypes.SERVE:
         require('./commands/serve');
         break;
+    case types_1.CommandTypes.TRANSLATIONS_PULL:
+        require('./commands/translations').runPull();
+        break;
+    case types_1.CommandTypes.TRANSLATIONS_PREPARE:
+        require('./commands/translations').runPrepare();
+        break;
     case types_1.CommandTypes.HELP:
         (0, printUsage_1.default)();
         break;

package/dist/tools/cli/utils/printUsage.js

@@ -35,5 +35,13 @@ function printUsage() {
     console.group();
     console.log(`Serves the dist folder with an express server.  Used to locally test production assets.\n`);
     console.groupEnd();
+    console.log(`${chalk_1.default.bold('translations:pull')}\n`);
+    console.group();
+    console.log(`Pulls translations for all installed apps using atlas, then runs translations:prepare. Reads atlasTranslations config from package.json. Pass ${chalk_1.default.bold('--no-prepare')} to skip the prepare step.\n`);
+    console.groupEnd();
+    console.log(`${chalk_1.default.bold('translations:prepare')}\n`);
+    console.group();
+    console.log(`Generates TypeScript modules from pulled translation JSON files in src/i18n/messages/ and src/i18n/site-messages/.\n`);
+    console.groupEnd();
     console.groupEnd();
 }

package/dist/tools/cli/utils/translations/index.d.ts

@@ -0,0 +1,2 @@
+export { prepare } from './prepare';
+export { pull } from './pull';

package/dist/tools/cli/utils/translations/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pull = exports.prepare = void 0;
+var prepare_1 = require("./prepare");
+Object.defineProperty(exports, "prepare", { enumerable: true, get: function () { return prepare_1.prepare; } });
+var pull_1 = require("./pull");
+Object.defineProperty(exports, "pull", { enumerable: true, get: function () { return pull_1.pull; } });

package/dist/tools/cli/utils/translations/messagesObject.d.ts

@@ -0,0 +1,26 @@
+export interface LocaleImport {
+    localeName: string;
+    filename: string;
+}
+export interface LocaleEntry {
+    key: string;
+    varName: string;
+}
+export interface MessagesObject {
+    imports: LocaleImport[];
+    entries: LocaleEntry[];
+}
+/**
+ * Reads all locale JSON files in a directory and returns the data needed to
+ * render a messages object ({ 'ar': ar, 'es-419': es_419 }).
+ * Returns null if no non-empty JSON files are found.
+ */
+export declare function generateMessagesObject(dirPath: string): MessagesObject | null;
+export declare function renderImportLine({ localeName, filename }: LocaleImport): string;
+export declare function renderImportsBlock(messagesObject: MessagesObject): string;
+export declare function renderExportLine({ key, varName }: LocaleEntry): string;
+export declare function renderExportBlock(messagesObject: MessagesObject): string;
+/**
+ * Renders a MessagesObject and writes it to an index.ts file in the given directory.
+ */
+export declare function writeMessagesObjectToFile(dirPath: string, messagesObject: MessagesObject): void;

package/dist/tools/cli/utils/translations/messagesObject.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMessagesObject = generateMessagesObject;
+exports.renderImportLine = renderImportLine;
+exports.renderImportsBlock = renderImportsBlock;
+exports.renderExportLine = renderExportLine;
+exports.renderExportBlock = renderExportBlock;
+exports.writeMessagesObjectToFile = writeMessagesObjectToFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Reads all locale JSON files in a directory and returns the data needed to
+ * render a messages object ({ 'ar': ar, 'es-419': es_419 }).
+ * Returns null if no non-empty JSON files are found.
+ */
+function generateMessagesObject(dirPath) {
+    const dirEntries = fs_1.default.readdirSync(dirPath, { withFileTypes: true });
+    const jsonFiles = dirEntries
+        .filter(e => e.isFile() && e.name.endsWith('.json'))
+        .map(e => e.name);
+    const imports = [];
+    const entries = [];
+    for (const filename of jsonFiles) {
+        const localeName = filename.replace(/\.json$/, '');
+        const key = localeName.toLowerCase().replace(/_/g, '-');
+        const filePath = path_1.default.join(dirPath, filename);
+        try {
+            const parsed = JSON.parse(fs_1.default.readFileSync(filePath, { encoding: 'utf8' }));
+            if (!Object.keys(parsed).length) {
+                continue; // skip empty files
+            }
+        }
+        catch {
+            continue;
+        }
+        imports.push({ localeName, filename });
+        entries.push({ key, varName: localeName });
+    }
+    if (!imports.length) {
+        return null;
+    }
+    return { imports, entries };
+}
+function renderImportLine({ localeName, filename }) {
+    return `import ${localeName} from './${filename}';`;
+}
+function renderImportsBlock(messagesObject) {
+    return messagesObject.imports.map(renderImportLine).join('\n');
+}
+function renderExportLine({ key, varName }) {
+    return `  '${key}': ${varName},`;
+}
+function renderExportBlock(messagesObject) {
+    const lines = messagesObject.entries.map(renderExportLine).join('\n');
+    return `export default {\n${lines}\n};\n`;
+}
+/**
+ * Renders a MessagesObject and writes it to an index.ts file in the given directory.
+ */
+function writeMessagesObjectToFile(dirPath, messagesObject) {
+    const content = `${renderImportsBlock(messagesObject)}\n\n${renderExportBlock(messagesObject)}`;
+    fs_1.default.writeFileSync(path_1.default.join(dirPath, 'index.ts'), content);
+}

package/dist/tools/cli/utils/translations/prepare.d.ts

@@ -0,0 +1,5 @@
+export declare function prepareAllPackageMessages(messagesDir: string): [string[], string[]];
+export declare function prepareSiteMessages(siteMessagesDir: string): [string[], string[]];
+export declare function prepare({ siteRoot }: {
+    siteRoot: string;
+}): void;

package/dist/tools/cli/utils/translations/prepare.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareAllPackageMessages = prepareAllPackageMessages;
+exports.prepareSiteMessages = prepareSiteMessages;
+exports.prepare = prepare;
+const fs_1 = __importDefault(require("fs"));
+const lodash_camelcase_1 = __importDefault(require("lodash.camelcase"));
+const path_1 = __importDefault(require("path"));
+const messagesObject_1 = require("./messagesObject");
+function packageVarName(packagePath) {
+    const name = packagePath.split('/').pop();
+    return `${(0, lodash_camelcase_1.default)(name)}Messages`;
+}
+function getPackageMessages(messagesDir, packagePath) {
+    return (0, messagesObject_1.generateMessagesObject)(path_1.default.join(messagesDir, packagePath));
+}
+function getPackagePaths(messagesDir) {
+    const directoryEntries = fs_1.default.readdirSync(messagesDir, { withFileTypes: true })
+        .filter(e => e.isDirectory());
+    const packagePaths = [];
+    for (const entry of directoryEntries) {
+        const directory = fs_1.default.readdirSync(path_1.default.join(messagesDir, entry.name), { withFileTypes: true });
+        if (!directory.some(e => e.isDirectory())) {
+            // no subdirectories, this is a package dir
+            packagePaths.push(entry.name);
+            continue;
+        }
+        // this is a scope dir, subdirs are packages
+        const packageDirs = directory.filter(e => e.isDirectory());
+        for (const pkg of packageDirs) {
+            packagePaths.push(`${entry.name}/${pkg.name}`);
+        }
+    }
+    return packagePaths;
+}
+function getAllPackageMessages(messagesDir) {
+    if (!fs_1.default.existsSync(messagesDir)) {
+        // directory doesn't exist
+        return new Map();
+    }
+    const directory = fs_1.default.readdirSync(messagesDir, { withFileTypes: true });
+    if (!directory.some(e => e.isDirectory())) {
+        // directory exists but has no subdirectories
+        return new Map();
+    }
+    const packagePaths = getPackagePaths(messagesDir);
+    const result = new Map();
+    for (const packagePath of packagePaths) {
+        const messagesObject = getPackageMessages(messagesDir, packagePath);
+        if (messagesObject) {
+            result.set(packagePath, messagesObject);
+        }
+    }
+    return result;
+}
+function prepareAllPackageMessages(messagesDir) {
+    const packageMessages = getAllPackageMessages(messagesDir);
+    const importLines = [];
+    const exportItems = [];
+    for (const [packagePath, messagesObject] of packageMessages) {
+        (0, messagesObject_1.writeMessagesObjectToFile)(path_1.default.join(messagesDir, packagePath), messagesObject);
+        const varName = packageVarName(packagePath);
+        importLines.push(`import ${varName} from './messages/${packagePath}';`);
+        exportItems.push(`  ${varName},`);
+    }
+    return [importLines, exportItems];
+}
+function prepareSiteMessages(siteMessagesDir) {
+    const siteMessages = fs_1.default.existsSync(siteMessagesDir)
+        ? (0, messagesObject_1.generateMessagesObject)(siteMessagesDir)
+        : null;
+    if (!siteMessages) {
+        return [[], []];
+    }
+    (0, messagesObject_1.writeMessagesObjectToFile)(siteMessagesDir, siteMessages);
+    return [
+        [`import siteMessages from './site-messages';`],
+        [`  siteMessages,`],
+    ];
+}
+function prepare({ siteRoot }) {
+    const i18nDir = path_1.default.join(siteRoot, 'src', 'i18n');
+    const messagesDir = path_1.default.join(i18nDir, 'messages');
+    const siteMessagesDir = path_1.default.join(i18nDir, 'site-messages');
+    const [packageImportLines, packageExportItems] = prepareAllPackageMessages(messagesDir);
+    const [siteImportLines, siteExportItems] = prepareSiteMessages(siteMessagesDir);
+    const importLines = [...packageImportLines, ...siteImportLines];
+    const exportItems = [...packageExportItems, ...siteExportItems];
+    const hasMessages = importLines.length > 0 && exportItems.length > 0;
+    const messagesContent = hasMessages
+        ? `${importLines.join('\n')}\n\nexport default [\n${exportItems.join('\n')}\n];\n`
+        : 'export default [];\n';
+    fs_1.default.mkdirSync(i18nDir, { recursive: true });
+    fs_1.default.writeFileSync(path_1.default.join(i18nDir, 'messages.ts'), messagesContent);
+}

package/dist/tools/cli/utils/translations/pull.d.ts

@@ -0,0 +1,6 @@
+export declare function pull({ siteRoot, execFileSync, shouldPrepare, atlasOptions, }: {
+    siteRoot: string;
+    execFileSync: (file: string, args: string[]) => void;
+    shouldPrepare: boolean;
+    atlasOptions?: string;
+}): void;

package/dist/tools/cli/utils/translations/pull.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pull = pull;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prepare_1 = require("./prepare");
+function validateSiteTranslationsConfig(siteRoot) {
+    const pkgJsonPath = path_1.default.join(siteRoot, 'package.json');
+    let config;
+    try {
+        config = JSON.parse(fs_1.default.readFileSync(pkgJsonPath, { encoding: 'utf8' }));
+    }
+    catch {
+        throw new Error(`translations:pull: Could not read ${pkgJsonPath}`);
+    }
+    if (!config.atlasTranslations) {
+        throw new Error(`translations:pull: No atlasTranslations field in ${pkgJsonPath}. `
+            + 'Add an atlasTranslations config to enable translation pulling.');
+    }
+    if (config.atlasTranslations.path && !config.name) {
+        throw new Error(`translations:pull: atlasTranslations.path is set in ${pkgJsonPath} but there is no name field. `
+            + 'A name field is required to identify this package as a translation source.');
+    }
+}
+function readTranslationsConfig(pkgJsonPath, nodeModulesBase) {
+    const packageName = path_1.default.relative(nodeModulesBase, path_1.default.dirname(pkgJsonPath));
+    if (!fs_1.default.existsSync(pkgJsonPath)) {
+        console.warn(`translations:pull: Package ${packageName} not found in node_modules, skipping.`);
+        return null;
+    }
+    let config;
+    try {
+        config = JSON.parse(fs_1.default.readFileSync(pkgJsonPath, { encoding: 'utf8' }));
+    }
+    catch {
+        console.warn(`translations:pull: Error reading package.json for ${packageName}, skipping.`);
+        return null;
+    }
+    const resolvedPackageName = config.name ?? packageName;
+    if (!config.atlasTranslations) {
+        console.warn(`translations:pull: No atlasTranslations config in ${resolvedPackageName}, skipping.`);
+        return null;
+    }
+    return { packageName: resolvedPackageName, config };
+}
+function resolveTranslationMappings(pkgJsonPath, nodeModulesBase) {
+    const visited = new Set();
+    function resolve(pkgJsonPath, ancestors) {
+        const read = readTranslationsConfig(pkgJsonPath, nodeModulesBase);
+        if (!read)
+            return [];
+        const { packageName, config } = read;
+        if (ancestors.includes(packageName)) {
+            console.warn(`translations:pull: Circular dependency detected: ${[...ancestors, packageName].join(' → ')}, skipping.`);
+            return [];
+        }
+        if (visited.has(packageName)) {
+            return [];
+        }
+        visited.add(packageName);
+        const results = [];
+        const mapping = config.atlasTranslations?.path
+            ? { from: config.atlasTranslations.path, to: packageName }
+            : null;
+        if (mapping) {
+            results.push(mapping);
+        }
+        const dependencies = config.atlasTranslations?.dependencies ?? [];
+        for (const dep of dependencies) {
+            results.push(...resolve(path_1.default.join(nodeModulesBase, dep, 'package.json'), [...ancestors, packageName]));
+        }
+        return results;
+    }
+    return resolve(pkgJsonPath, []);
+}
+function clearMessages(messagesDir) {
+    if (fs_1.default.existsSync(messagesDir)) {
+        fs_1.default.rmSync(messagesDir, { recursive: true });
+    }
+    fs_1.default.mkdirSync(messagesDir, { recursive: true });
+}
+function pull({ siteRoot, execFileSync, shouldPrepare, atlasOptions = '', }) {
+    validateSiteTranslationsConfig(siteRoot);
+    // only interact with messages dir, not site-messages
+    const messagesDir = path_1.default.join(siteRoot, 'src', 'i18n', 'messages');
+    const nodeModulesBase = path_1.default.join(siteRoot, 'node_modules');
+    clearMessages(messagesDir);
+    const mappings = resolveTranslationMappings(path_1.default.join(siteRoot, 'package.json'), nodeModulesBase);
+    if (!mappings.length) {
+        if (shouldPrepare)
+            (0, prepare_1.prepare)({ siteRoot });
+        return;
+    }
+    const atlasOptionsArgs = atlasOptions.trim().split(/\s+/).filter(Boolean);
+    const atlasMappingArgs = mappings.map(m => `${m.from}:src/i18n/messages/${m.to}`);
+    execFileSync('atlas', ['pull', ...atlasOptionsArgs, ...atlasMappingArgs]);
+    if (shouldPrepare)
+        (0, prepare_1.prepare)({ siteRoot });
+}

package/dist/tools/types.d.ts

@@ -14,5 +14,7 @@ export declare enum CommandTypes {
     DEV = "dev",
     FORMAT_JS = "formatjs",
     SERVE = "serve",
+    TRANSLATIONS_PULL = "translations:pull",
+    TRANSLATIONS_PREPARE = "translations:prepare",
     HELP = "help"
 }

package/dist/tools/types.js

@@ -19,5 +19,7 @@ var CommandTypes;
     CommandTypes["DEV"] = "dev";
     CommandTypes["FORMAT_JS"] = "formatjs";
     CommandTypes["SERVE"] = "serve";
+    CommandTypes["TRANSLATIONS_PULL"] = "translations:pull";
+    CommandTypes["TRANSLATIONS_PREPARE"] = "translations:prepare";
     CommandTypes["HELP"] = "help";
 })(CommandTypes || (exports.CommandTypes = CommandTypes = {}));

package/dist/tools/webpack/common-config/index.d.ts

@@ -4,3 +4,4 @@ export { default as getImageMinimizer } from './all/getImageMinimizer';
 export { default as getStylesheetRule } from './all/getStylesheetRule';
 export { default as getDevServer } from './dev/getDevServer';
 export { default as getHtmlWebpackPlugin } from './site/getHtmlWebpackPlugin';
+export { default as getI18nMessagesFallbackPlugin } from './site/getI18nMessagesFallbackPlugin';

package/dist/tools/webpack/common-config/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHtmlWebpackPlugin = exports.getDevServer = exports.getStylesheetRule = exports.getImageMinimizer = exports.getFileLoaderRules = exports.getCodeRules = void 0;
+exports.getI18nMessagesFallbackPlugin = exports.getHtmlWebpackPlugin = exports.getDevServer = exports.getStylesheetRule = exports.getImageMinimizer = exports.getFileLoaderRules = exports.getCodeRules = void 0;
 var getCodeRules_1 = require("./all/getCodeRules");
 Object.defineProperty(exports, "getCodeRules", { enumerable: true, get: function () { return __importDefault(getCodeRules_1).default; } });
 var getFileLoaderRules_1 = require("./all/getFileLoaderRules");
@@ -16,3 +16,5 @@ var getDevServer_1 = require("./dev/getDevServer");
 Object.defineProperty(exports, "getDevServer", { enumerable: true, get: function () { return __importDefault(getDevServer_1).default; } });
 var getHtmlWebpackPlugin_1 = require("./site/getHtmlWebpackPlugin");
 Object.defineProperty(exports, "getHtmlWebpackPlugin", { enumerable: true, get: function () { return __importDefault(getHtmlWebpackPlugin_1).default; } });
+var getI18nMessagesFallbackPlugin_1 = require("./site/getI18nMessagesFallbackPlugin");
+Object.defineProperty(exports, "getI18nMessagesFallbackPlugin", { enumerable: true, get: function () { return __importDefault(getI18nMessagesFallbackPlugin_1).default; } });

package/dist/tools/webpack/common-config/site/getI18nMessagesFallbackPlugin/emptyI18n.d.ts

@@ -0,0 +1,2 @@
+declare const _default: never[];
+export default _default;

package/dist/tools/webpack/common-config/site/getI18nMessagesFallbackPlugin/emptyI18n.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = [];

package/dist/tools/webpack/common-config/site/getI18nMessagesFallbackPlugin/index.d.ts

@@ -0,0 +1,2 @@
+import webpack from 'webpack';
+export default function getI18nMessagesFallbackPlugin(): webpack.NormalModuleReplacementPlugin;