@docusaurus/theme-translations 2.0.0-beta.11 → 2.0.0-beta.15

package/lib/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export declare function codeTranslationLocalesToTry(locale: string): string[];
+export declare function readDefaultCodeTranslationMessages({ dirPath, locale, name, }: {
+    dirPath?: string;
+    locale: string;
+    name: string;
+}): Promise<Record<string, string>>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBpE;AAGD,wBAAsB,kCAAkC,CAAC,EACvD,OAAoC,EACpC,MAAM,EACN,IAAI,GACL,EAAE;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgBlC"}

package/lib/index.js

@@ -11,22 +11,21 @@ const tslib_1 = require("tslib");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 function getDefaultLocalesDirPath() {
-    const parentDirPath = path_1.default.join(__dirname, '..');
-    const pkg = JSON.parse(fs_extra_1.default.readFileSync(path_1.default.join(parentDirPath, 'package.json'), 'utf8'));
-    return path_1.default.join(parentDirPath, pkg.files[0]);
+    return path_1.default.join(__dirname, '../locales');
 }
 // Return an ordered list of locales we should try
 function codeTranslationLocalesToTry(locale) {
-    const intlLocale = Intl.Locale ? new Intl.Locale(locale) : undefined;
-    if (!intlLocale) {
-        return [locale];
-    }
+    const intlLocale = new Intl.Locale(locale);
     // if locale is just a simple language like "pt", we want to fallback to pt-BR (not pt-PT!)
     // see https://github.com/facebook/docusaurus/pull/4536#issuecomment-810088783
     if (intlLocale.language === locale) {
         const maximizedLocale = intlLocale.maximize(); // pt-Latn-BR`
-        // ["pt","pt-BR"]
-        return [locale, `${maximizedLocale.language}-${maximizedLocale.region}`];
+        // ["pt","pt-BR"]; ["zh", "zh-Hans"]
+        return [
+            locale,
+            `${maximizedLocale.language}-${maximizedLocale.region}`,
+            `${maximizedLocale.language}-${maximizedLocale.script}`,
+        ];
     }
     // if locale is like "pt-BR", we want to fallback to "pt"
     else {
@@ -50,3 +49,4 @@ async function readDefaultCodeTranslationMessages({ dirPath = getDefaultLocalesD
     return {};
 }
 exports.readDefaultCodeTranslationMessages = readDefaultCodeTranslationMessages;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,6DAAwB;AACxB,qEAA0B;AAE1B,SAAS,wBAAwB;IAC/B,OAAO,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,kDAAkD;AAClD,SAAgB,2BAA2B,CAAC,MAAc;IACxD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,2FAA2F;IAC3F,8EAA8E;IAC9E,IAAI,UAAU,CAAC,QAAQ,KAAK,MAAM,EAAE;QAClC,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc;QAC7D,oCAAoC;QACpC,OAAO;YACL,MAAM;YACN,GAAG,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,MAAM,EAAE;YACvD,GAAG,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,MAAM,EAAE;SACxD,CAAC;KACH;IACD,yDAAyD;SACpD;QACH,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,QAAS,CAAC,CAAC;KACvC;AACH,CAAC;AAjBD,kEAiBC;AAED,oEAAoE;AAC7D,KAAK,UAAU,kCAAkC,CAAC,EACvD,OAAO,GAAG,wBAAwB,EAAE,EACpC,MAAM,EACN,IAAI,GAKL;IACC,MAAM,YAAY,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEzD,kDAAkD;IAClD,mCAAmC;IACnC,gDAAgD;IAChD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE;QACtC,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QAEpE,IAAI,MAAM,kBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;YACjC,MAAM,WAAW,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;SAChC;KACF;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAxBD,gFAwBC"}

package/locales/ar/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/base/plugin-ideal-image.json

@@ -0,0 +1,12 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.404error___DESCRIPTION": "When the image is not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.error___DESCRIPTION": "When the image fails to load for unknown error",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.load___DESCRIPTION": "To prompt users to load the full image. sizeMessage is a parenthesized size figure.",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.loading___DESCRIPTION": "When the full-scale image is loading",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded",
+  "theme.IdealImageMessage.offline___DESCRIPTION": "When the user is viewing an offline document"
+}

package/locales/bn/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/cs/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/da/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/de/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/es/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/fa/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/fil/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/fr/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/he/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/hi/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/it/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/it/plugin-pwa.json

@@ -0,0 +1,5 @@
+{
+  "theme.PwaReloadPopup.closeButtonAriaLabel": "Chiudi",
+  "theme.PwaReloadPopup.info": "Nuova versione disponibile",
+  "theme.PwaReloadPopup.refreshButtonText": "Aggiorna"
+}

package/locales/it/theme-common.json

@@ -0,0 +1,51 @@
+{
+  "theme.AnnouncementBar.closeButtonAriaLabel": "Chiudi",
+  "theme.BackToTopButton.buttonAriaLabel": "Torna indietro all'inizio",
+  "theme.CodeBlock.copied": "Copiato",
+  "theme.CodeBlock.copy": "Copia",
+  "theme.CodeBlock.copyButtonAriaLabel": "Copia il codice negli appunti",
+  "theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel": "Attiva/disattiva la categoria '{label}' della barra laterale collassabile",
+  "theme.ErrorPageContent.title": "Questa pagina è andata in crash.",
+  "theme.ErrorPageContent.tryAgain": "Prova di nuovo",
+  "theme.NotFound.p1": "Non siamo riusciti a trovare quello che stavi cercando.",
+  "theme.NotFound.p2": "Contatta il proprietario del sito che ti ha collegato all'URL originale e fagli sapere che il loro collegamento è interrotto.",
+  "theme.NotFound.title": "Pagina non trovata",
+  "theme.TOCCollapsible.toggleButtonLabel": "Su questa pagina",
+  "theme.blog.archive.description": "Archivio",
+  "theme.blog.archive.title": "Archivio",
+  "theme.blog.paginator.navAriaLabel": "Navigazione nella pagina dei post del blog ",
+  "theme.blog.paginator.newerEntries": "Post più recenti",
+  "theme.blog.paginator.olderEntries": "Post più vecchi",
+  "theme.blog.post.paginator.navAriaLabel": "Navigazione nella pagina dei post del blog ",
+  "theme.blog.post.paginator.newerPost": "Post più recente",
+  "theme.blog.post.paginator.olderPost": "Post più vecchio",
+  "theme.blog.post.plurals": "Un post|{count} post",
+  "theme.blog.post.readMore": "Leggi di più",
+  "theme.blog.post.readingTime.plurals": "Lettura di 1 minuto|{readingTime} minuti di lettura",
+  "theme.blog.sidebar.navAriaLabel": "Navigazione dei post recenti del blog",
+  "theme.blog.tagTitle": "{nPosts} etichettati con \"{tagName}\"",
+  "theme.common.editThisPage": "Modifica questa pagina",
+  "theme.common.headingLinkTitle": "Link diretto all'intestazione",
+  "theme.common.skipToMainContent": "Passa al contenuto principale",
+  "theme.docs.paginator.navAriaLabel": "Navigazione delle pagine dei documenti",
+  "theme.docs.paginator.next": "Successivo",
+  "theme.docs.paginator.previous": "Precedente",
+  "theme.docs.sidebar.collapseButtonAriaLabel": "Collassa la barra laterale",
+  "theme.docs.sidebar.collapseButtonTitle": "Collassa la barra laterale",
+  "theme.docs.sidebar.expandButtonAriaLabel": "Espandi la barra laterale",
+  "theme.docs.sidebar.expandButtonTitle": "Espandi la barra laterale",
+  "theme.docs.tagDocListPageTitle": "{nDocsTagged} con \"{tagName}\"",
+  "theme.docs.tagDocListPageTitle.nDocsTagged": "Un documento etichettato|{count} documenti etichettati",
+  "theme.docs.versions.latestVersionLinkLabel": "ultima versione",
+  "theme.docs.versions.latestVersionSuggestionLabel": "Per la documentazione aggiornata, guarda la {latestVersionLink} ({versionLabel}).",
+  "theme.docs.versions.unmaintainedVersionLabel": "Questa è la documentazione per {siteTitle} {versionLabel}, che non è più attivamente mantenuta.",
+  "theme.docs.versions.unreleasedVersionLabel": "Questa è documentazione inedita per {siteTitle} versione {versionLabel}.",
+  "theme.lastUpdated.atDate": " il {date}",
+  "theme.lastUpdated.byUser": " da {user}",
+  "theme.lastUpdated.lastUpdatedAtBy": "Ultimo aggiornamento{atDate}{byUser}",
+  "theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": "← Indietro al menu principale",
+  "theme.navbar.mobileVersionsDropdown.label": "Versioni",
+  "theme.tags.tagsListLabel": "Etichette:",
+  "theme.tags.tagsPageLink": "Guarda tutte le etichette",
+  "theme.tags.tagsPageTitle": "Etichette"
+}

package/locales/it/theme-live-codeblock.json

@@ -0,0 +1,4 @@
+{
+  "theme.Playground.liveEditor": "Live Editor",
+  "theme.Playground.result": "Risultato"
+}

package/locales/it/theme-search-algolia.json

@@ -0,0 +1,11 @@
+{
+  "theme.SearchBar.label": "Cerca",
+  "theme.SearchPage.algoliaLabel": "Ricerca tramite Algolia",
+  "theme.SearchPage.documentsFound.plurals": "Un documento trovato|{count} documenti trovati",
+  "theme.SearchPage.emptyResultsTitle": "Cerca nella documentazione",
+  "theme.SearchPage.existingResultsTitle": "Risultati di ricerca per \"{query}\"",
+  "theme.SearchPage.fetchingNewResults": "Recuperando nuovi risultati...",
+  "theme.SearchPage.inputLabel": "Cerca",
+  "theme.SearchPage.inputPlaceholder": "Digita qui la tua ricerca",
+  "theme.SearchPage.noResultsText": "Nessun risultato trovato"
+}

package/locales/ja/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/ko/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/pl/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/pt-BR/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/pt-PT/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/ru/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/sr/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/tr/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/vi/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "404. Image not found",
+  "theme.IdealImageMessage.error": "Error. Click to reload",
+  "theme.IdealImageMessage.load": "Click to load{sizeMessage}",
+  "theme.IdealImageMessage.loading": "Loading...",
+  "theme.IdealImageMessage.offline": "Your browser is offline. Image not loaded"
+}

package/locales/zh-Hans/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "未找到图片",
+  "theme.IdealImageMessage.error": "出现错误，点击重试",
+  "theme.IdealImageMessage.load": "点击加载图片{sizeMessage}",
+  "theme.IdealImageMessage.loading": "加载中……",
+  "theme.IdealImageMessage.offline": "你的浏览器处于离线状态。图片未加载"
+}

package/locales/zh-Hant/plugin-ideal-image.json

@@ -0,0 +1,7 @@
+{
+  "theme.IdealImageMessage.404error": "未找到圖片",
+  "theme.IdealImageMessage.error": "出現錯誤，點擊重試",
+  "theme.IdealImageMessage.load": "點擊以加載{sizeMessage}",
+  "theme.IdealImageMessage.loading": "加載中...",
+  "theme.IdealImageMessage.offline": "你的瀏覽器處於離線狀態。圖片未加載"
+}

package/package.json

@@ -1,12 +1,9 @@
 {
   "name": "@docusaurus/theme-translations",
-  "version": "2.0.0-beta.11",
+  "version": "2.0.0-beta.15",
   "description": "Docusaurus theme translations.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
-  "files": [
-    "locales"
-  ],
   "publishConfig": {
     "access": "public"
   },
@@ -19,18 +16,19 @@
   "scripts": {
     "build": "tsc",
     "watch": "tsc --watch",
-    "update": "node -e 'require(\"./update.js\").run()'"
+    "update": "node ./update.js"
   },
   "dependencies": {
     "fs-extra": "^10.0.0",
     "tslib": "^2.3.1"
   },
   "devDependencies": {
-    "chalk": "^4.1.2",
+    "@docusaurus/core": "2.0.0-beta.15",
+    "@docusaurus/logger": "2.0.0-beta.15",
     "lodash": "^4.17.20"
   },
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "1cb6cdfb78c0bfc681bce9a9339270abb9a06215"
+  "gitHead": "9a8acb2a87250368427ad80258350d630e7ae2f5"
 }

package/src/index.ts

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import path from 'path';
+import fs from 'fs-extra';
+
+function getDefaultLocalesDirPath(): string {
+  return path.join(__dirname, '../locales');
+}
+
+// Return an ordered list of locales we should try
+export function codeTranslationLocalesToTry(locale: string): string[] {
+  const intlLocale = new Intl.Locale(locale);
+  // if locale is just a simple language like "pt", we want to fallback to pt-BR (not pt-PT!)
+  // see https://github.com/facebook/docusaurus/pull/4536#issuecomment-810088783
+  if (intlLocale.language === locale) {
+    const maximizedLocale = intlLocale.maximize(); // pt-Latn-BR`
+    // ["pt","pt-BR"]; ["zh", "zh-Hans"]
+    return [
+      locale,
+      `${maximizedLocale.language}-${maximizedLocale.region}`,
+      `${maximizedLocale.language}-${maximizedLocale.script}`,
+    ];
+  }
+  // if locale is like "pt-BR", we want to fallback to "pt"
+  else {
+    return [locale, intlLocale.language!];
+  }
+}
+
+// Useful to implement getDefaultCodeTranslationMessages() in themes
+export async function readDefaultCodeTranslationMessages({
+  dirPath = getDefaultLocalesDirPath(),
+  locale,
+  name,
+}: {
+  dirPath?: string;
+  locale: string;
+  name: string;
+}): Promise<Record<string, string>> {
+  const localesToTry = codeTranslationLocalesToTry(locale);
+
+  // Return the content of the first file that match
+  // fr_FR.json => fr.json => nothing
+  // eslint-disable-next-line no-restricted-syntax
+  for (const localeToTry of localesToTry) {
+    const filePath = path.resolve(dirPath, localeToTry, `${name}.json`);
+
+    if (await fs.pathExists(filePath)) {
+      const fileContent = await fs.readFile(filePath, 'utf8');
+      return JSON.parse(fileContent);
+    }
+  }
+
+  return {};
+}