@edx/frontend-platform 4.0.2 → 4.1.0

package/i18n/scripts/README.md

@@ -1,25 +1,29 @@
 # i18n/scripts
 
-This directory contains the `transifex-utils.js` file which is shared across all micro-frontends.
+This directory contains the `transifex-utils.js` and `intl-imports.js` files which are shared across all micro-frontends.
 
-The package.json of `frontend-platform` includes the following section:
+The package.json of `frontend-platform` includes the following sections:
 
 ```
   "bin": {
+    "intl-imports.js": "i18n/scripts/intl-imports.js"
     "transifex-utils.js": "i18n/scripts/transifex-utils.js"
   },
 ```
 
-This config block causes `transifex-utils.js` to be copied to the following path when `frontend-platform` is installed as a dependency of an micro-frontend:
+This config block causes boths scripts to be copied to the following path when `frontend-platform` is installed as a 
+dependency of a micro-frontend:
 
 ```
+/node_modules/.bin/intl-imports.js
 /node_modules/.bin/transifex-utils.js
 ```
 
-All micro-frontends have a `Makefile` with a line that loads `transifex-utils.js` from the above path:
+All micro-frontends have a `Makefile` with a line that loads the scripts from the above path:
 
 ```
+intl_imports = ./node_modules/.bin/intl-imports.js
 transifex_utils = ./node_modules/.bin/transifex-utils.js
 ```
 
-So if you delete `transifex-utils.js` or the `scripts` directory, you'll break all micro-frontend builds.  Happy coding!
+So if you delete either of the files or the `scripts` directory, you'll break all micro-frontend builds. Happy coding!

package/i18n/scripts/intl-imports.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+var scriptHelpDocument = "\nNAME\n  intl-imports.js \u2014 Script to generate the src/i18n/index.js file that exports messages from all the languages for Micro-frontends.\n\nSYNOPSIS\n  intl-imports.js [DIRECTORY ...]\n\nDESCRIPTION\n  This script is intended to run after 'atlas' has pulled the files.\n  \n  This expects to run inside a Micro-frontend root directory with the following structure:\n  \n    frontend-app-learning $ tree src/i18n/\n    src/i18n/\n    \u251C\u2500\u2500 index.js\n    \u2514\u2500\u2500 messages\n        \u251C\u2500\u2500 frontend-app-example\n        \u2502   \u251C\u2500\u2500 ar.json\n        \u2502   \u251C\u2500\u2500 es_419.json\n        \u2502   \u2514\u2500\u2500 zh_CN.json\n        \u251C\u2500\u2500 frontend-component-footer\n        \u2502   \u251C\u2500\u2500 ar.json\n        \u2502   \u251C\u2500\u2500 es_419.json\n        \u2502   \u2514\u2500\u2500 zh_CN.json\n        \u2514\u2500\u2500 frontend-component-header (empty directory)\n  \n  \n  \n  With the structure above it's expected to run with the following command in Makefile:\n  \n    \n    $ node_modules/.bin/intl-imports.js frontend-component-footer frontend-component-header frontend-app-example\n  \n  \n  It will generate two type of files:\n  \n   - Main src/i18n/index.js which overrides the Micro-frontend provided with a sample output of:\n      \n      \"\"\"\n      import messagesFromFrontendComponentFooter from './messages/frontend-component-footer';\n      // Skipped import due to missing './messages/frontend-component-footer/index.js' likely due to empty translations.\n      import messagesFromFrontendAppExample from './messages/frontend-app-example';\n   \n      export default [\n        messagesFromFrontendComponentFooter,\n        messagesFromFrontendAppExample,\n      ];\n      \"\"\"\n  \n   - Each sub-directory has src/i18n/messages/frontend-component-header/index.js which is imported by the main file.:\n   \n      \"\"\"\n      import messagesOfArLanguage from './ar.json';\n      import messagesOfDeLanguage from './de.json';\n      import messagesOfEs419Language from './es_419.json';\n      export default {\n        'ar': messagesOfArLanguage,\n        'de': messagesOfDeLanguage,\n        'es-419': messagesOfEs419Language,\n      };\n     \"\"\"\n";
+var fs = require('fs');
+var path = require('path');
+var camelCase = require('lodash.camelcase');
+var loggingPrefix = path.basename("".concat(__filename)); // the name of this JS file
+
+// Header note for generated src/i18n/index.js file
+var filesCodeGeneratorNoticeHeader = "// This file is generated by the openedx/frontend-platform's \"intl-import.js\" script.\n//\n// Refer to the i18n documents in https://docs.openedx.org/en/latest/developers/references/i18n.html to update\n// the file and use the Micro-frontend i18n pattern in new repositories.\n//\n";
+
+/**
+ * Create frontend-app-example/index.js file with proper imports.
+ *
+ * @param directory - a directory name containing .json files from Transifex e.g. "frontend-app-example".
+ * @param log - Mockable process.stdout.write
+ * @param writeFileSync - Mockable fs.writeFileSync
+ * @param i18nDir - Path to `src/i18n` directory
+ *
+ * @return object - An object containing directory name and whether its "index.js" file was successfully written.
+ */
+function generateSubdirectoryMessageFile(_ref) {
+  var directory = _ref.directory,
+    log = _ref.log,
+    writeFileSync = _ref.writeFileSync,
+    i18nDir = _ref.i18nDir;
+  var importLines = [];
+  var messagesLines = [];
+  var counter = {
+    nonEmptyLanguages: 0
+  };
+  var messagesDir = "".concat(i18nDir, "/messages"); // The directory of Micro-frontend i18n messages
+
+  try {
+    var files = fs.readdirSync("".concat(messagesDir, "/").concat(directory), {
+      withFileTypes: true
+    });
+    files.sort(); // Sorting ensures a consistent generated `index.js` order of imports cross-platforms.
+
+    var jsonFiles = files.filter(function (file) {
+      return file.isFile() && file.name.endsWith('.json');
+    });
+    if (!jsonFiles.length) {
+      log("".concat(loggingPrefix, ": Not creating '").concat(directory, "/index.js' because no .json translation files were found.\n"));
+      return {
+        directory: directory,
+        isWritten: false
+      };
+    }
+    jsonFiles.forEach(function (file) {
+      var filename = file.name;
+      // Gets `fr_CA` from `fr_CA.json`
+      var languageCode = filename.replace(/\.json$/, '');
+      // React-friendly language code fr_CA --> fr-ca
+      var reactIntlLanguageCode = languageCode.toLowerCase().replace(/_/g, '-');
+      // camelCase variable name
+      var messagesCamelCaseVar = camelCase("messages_Of_".concat(languageCode, "_Language"));
+      var filePath = "".concat(messagesDir, "/").concat(directory, "/").concat(filename);
+      try {
+        var entries = JSON.parse(fs.readFileSync(filePath, {
+          encoding: 'utf8'
+        }));
+        if (!Object.keys(entries).length) {
+          importLines.push("// Note: Skipped empty '".concat(filename, "' messages file."));
+          return; // Skip the language
+        }
+      } catch (e) {
+        importLines.push("// Error: unable to parse '".concat(filename, "' messages file."));
+        log("".concat(loggingPrefix, ": NOTICE: Skipping '").concat(directory, "/").concat(filename, "' due to error: ").concat(e, ".\n"));
+        return; // Skip the language
+      }
+
+      counter.nonEmptyLanguages += 1;
+      importLines.push("import ".concat(messagesCamelCaseVar, " from './").concat(filename, "';"));
+      messagesLines.splice(1, 0, "  '".concat(reactIntlLanguageCode, "': ").concat(messagesCamelCaseVar, ","));
+    });
+    if (counter.nonEmptyLanguages) {
+      // See the help message above for sample output.
+      var messagesFileContent = [filesCodeGeneratorNoticeHeader, importLines.join('\n'), '\nexport default {', messagesLines.join('\n'), '};\n'].join('\n');
+      writeFileSync("".concat(messagesDir, "/").concat(directory, "/index.js"), messagesFileContent);
+      return {
+        directory: directory,
+        isWritten: true
+      };
+    }
+    log("".concat(loggingPrefix, ": Skipping '").concat(directory, "' because no languages were found.\n"));
+  } catch (e) {
+    log("".concat(loggingPrefix, ": NOTICE: Skipping '").concat(directory, "' due to error: ").concat(e, ".\n"));
+  }
+  return {
+    directory: directory,
+    isWritten: false
+  };
+}
+
+/**
+ * Create main `src/i18n/index.js` messages import file.
+ *
+ *
+ * @param processedDirectories - List of directories with a boolean flag whether its "index.js" file is written
+ *                               The format is "[\{ directory: "frontend-component-example", isWritten: false \}, ...]"
+ * @param log - Mockable process.stdout.write
+ * @param writeFileSync - Mockable fs.writeFileSync
+ * @param i18nDir` - Path to `src/i18n` directory
+ */
+function generateMainMessagesFile(_ref2) {
+  var processedDirectories = _ref2.processedDirectories,
+    log = _ref2.log,
+    writeFileSync = _ref2.writeFileSync,
+    i18nDir = _ref2.i18nDir;
+  var importLines = [];
+  var exportLines = [];
+  processedDirectories.forEach(function (processedDirectory) {
+    var directory = processedDirectory.directory,
+      isWritten = processedDirectory.isWritten;
+    if (isWritten) {
+      var moduleCamelCaseVariableName = camelCase("messages_from_".concat(directory));
+      importLines.push("import ".concat(moduleCamelCaseVariableName, " from './messages/").concat(directory, "';"));
+      exportLines.push("  ".concat(moduleCamelCaseVariableName, ","));
+    } else {
+      var skipMessage = "Skipped import due to missing '".concat(directory, "/index.js' likely due to empty translations.");
+      importLines.push("// ".concat(skipMessage, "."));
+      log("".concat(loggingPrefix, ": ").concat(skipMessage, "\n"));
+    }
+  });
+
+  // See the help message above for sample output.
+  var indexFileContent = [filesCodeGeneratorNoticeHeader, importLines.join('\n'), '\nexport default [', exportLines.join('\n'), '];\n'].join('\n');
+  writeFileSync("".concat(i18nDir, "/index.js"), indexFileContent);
+}
+
+/*
+ * Main function of the file.
+ */
+function main(_ref3) {
+  var directories = _ref3.directories,
+    log = _ref3.log,
+    writeFileSync = _ref3.writeFileSync,
+    pwd = _ref3.pwd;
+  var i18nDir = "".concat(pwd, "/src/i18n"); // The Micro-frontend i18n root directory
+
+  if (directories.includes('--help') || directories.includes('-h')) {
+    log(scriptHelpDocument);
+  } else if (!directories.length) {
+    log(scriptHelpDocument);
+    log("".concat(loggingPrefix, ": Error: A list of directories is required.\n"));
+  } else if (!fs.existsSync(i18nDir) || !fs.lstatSync(i18nDir).isDirectory()) {
+    log(scriptHelpDocument);
+    log("".concat(loggingPrefix, ": Error: src/i18n directory was not found.\n"));
+  } else {
+    var processedDirectories = directories.map(function (directory) {
+      return generateSubdirectoryMessageFile({
+        directory: directory,
+        log: log,
+        writeFileSync: writeFileSync,
+        i18nDir: i18nDir
+      });
+    });
+    generateMainMessagesFile({
+      processedDirectories: processedDirectories,
+      log: log,
+      writeFileSync: writeFileSync,
+      i18nDir: i18nDir
+    });
+  }
+}
+if (require.main === module) {
+  // Run the main() function if called from the command line.
+  main({
+    directories: process.argv.slice(2),
+    log: function log(text) {
+      return process.stdout.write(text);
+    },
+    writeFileSync: fs.writeFileSync,
+    pwd: process.env.PWD
+  });
+}
+module.exports.main = main; // Allow tests to use the main function.
+//# sourceMappingURL=intl-imports.js.map

package/i18n/scripts/intl-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-imports.js","names":["scriptHelpDocument","fs","require","path","camelCase","loggingPrefix","basename","concat","__filename","filesCodeGeneratorNoticeHeader","generateSubdirectoryMessageFile","_ref","directory","log","writeFileSync","i18nDir","importLines","messagesLines","counter","nonEmptyLanguages","messagesDir","files","readdirSync","withFileTypes","sort","jsonFiles","filter","file","isFile","name","endsWith","length","isWritten","forEach","filename","languageCode","replace","reactIntlLanguageCode","toLowerCase","messagesCamelCaseVar","filePath","entries","JSON","parse","readFileSync","encoding","Object","keys","push","e","splice","messagesFileContent","join","generateMainMessagesFile","_ref2","processedDirectories","exportLines","processedDirectory","moduleCamelCaseVariableName","skipMessage","indexFileContent","main","_ref3","directories","pwd","includes","existsSync","lstatSync","isDirectory","map","module","process","argv","slice","text","stdout","write","env","PWD","exports"],"sources":["../../../src/i18n/scripts/intl-imports.js"],"sourcesContent":["#!/usr/bin/env node\n\nconst scriptHelpDocument = `\nNAME\n  intl-imports.js — Script to generate the src/i18n/index.js file that exports messages from all the languages for Micro-frontends.\n\nSYNOPSIS\n  intl-imports.js [DIRECTORY ...]\n\nDESCRIPTION\n  This script is intended to run after 'atlas' has pulled the files.\n  \n  This expects to run inside a Micro-frontend root directory with the following structure:\n  \n    frontend-app-learning $ tree src/i18n/\n    src/i18n/\n    ├── index.js\n    └── messages\n        ├── frontend-app-example\n        │   ├── ar.json\n        │   ├── es_419.json\n        │   └── zh_CN.json\n        ├── frontend-component-footer\n        │   ├── ar.json\n        │   ├── es_419.json\n        │   └── zh_CN.json\n        └── frontend-component-header (empty directory)\n  \n  \n  \n  With the structure above it's expected to run with the following command in Makefile:\n  \n    \n    $ node_modules/.bin/intl-imports.js frontend-component-footer frontend-component-header frontend-app-example\n  \n  \n  It will generate two type of files:\n  \n   - Main src/i18n/index.js which overrides the Micro-frontend provided with a sample output of:\n      \n      \"\"\"\n      import messagesFromFrontendComponentFooter from './messages/frontend-component-footer';\n      // Skipped import due to missing './messages/frontend-component-footer/index.js' likely due to empty translations.\n      import messagesFromFrontendAppExample from './messages/frontend-app-example';\n   \n      export default [\n        messagesFromFrontendComponentFooter,\n        messagesFromFrontendAppExample,\n      ];\n      \"\"\"\n  \n   - Each sub-directory has src/i18n/messages/frontend-component-header/index.js which is imported by the main file.:\n   \n      \"\"\"\n      import messagesOfArLanguage from './ar.json';\n      import messagesOfDeLanguage from './de.json';\n      import messagesOfEs419Language from './es_419.json';\n      export default {\n        'ar': messagesOfArLanguage,\n        'de': messagesOfDeLanguage,\n        'es-419': messagesOfEs419Language,\n      };\n     \"\"\"\n`;\n\nconst fs = require('fs');\nconst path = require('path');\nconst camelCase = require('lodash.camelcase');\n\nconst loggingPrefix = path.basename(`${__filename}`); // the name of this JS file\n\n// Header note for generated src/i18n/index.js file\nconst filesCodeGeneratorNoticeHeader = `// This file is generated by the openedx/frontend-platform's \"intl-import.js\" script.\n//\n// Refer to the i18n documents in https://docs.openedx.org/en/latest/developers/references/i18n.html to update\n// the file and use the Micro-frontend i18n pattern in new repositories.\n//\n`;\n\n/**\n * Create frontend-app-example/index.js file with proper imports.\n *\n * @param directory - a directory name containing .json files from Transifex e.g. \"frontend-app-example\".\n * @param log - Mockable process.stdout.write\n * @param writeFileSync - Mockable fs.writeFileSync\n * @param i18nDir - Path to `src/i18n` directory\n *\n * @return object - An object containing directory name and whether its \"index.js\" file was successfully written.\n */\nfunction generateSubdirectoryMessageFile({\n  directory,\n  log,\n  writeFileSync,\n  i18nDir,\n}) {\n  const importLines = [];\n  const messagesLines = [];\n  const counter = { nonEmptyLanguages: 0 };\n  const messagesDir = `${i18nDir}/messages`; // The directory of Micro-frontend i18n messages\n\n  try {\n    const files = fs.readdirSync(`${messagesDir}/${directory}`, { withFileTypes: true });\n    files.sort(); // Sorting ensures a consistent generated `index.js` order of imports cross-platforms.\n\n    const jsonFiles = files.filter(file => file.isFile() && file.name.endsWith('.json'));\n\n    if (!jsonFiles.length) {\n      log(`${loggingPrefix}: Not creating '${directory}/index.js' because no .json translation files were found.\\n`);\n      return {\n        directory,\n        isWritten: false,\n      };\n    }\n\n    jsonFiles.forEach((file) => {\n      const filename = file.name;\n      // Gets `fr_CA` from `fr_CA.json`\n      const languageCode = filename.replace(/\\.json$/, '');\n      // React-friendly language code fr_CA --> fr-ca\n      const reactIntlLanguageCode = languageCode.toLowerCase().replace(/_/g, '-');\n      // camelCase variable name\n      const messagesCamelCaseVar = camelCase(`messages_Of_${languageCode}_Language`);\n      const filePath = `${messagesDir}/${directory}/${filename}`;\n\n      try {\n        const entries = JSON.parse(fs.readFileSync(filePath, { encoding: 'utf8' }));\n\n        if (!Object.keys(entries).length) {\n          importLines.push(`// Note: Skipped empty '${filename}' messages file.`);\n          return; // Skip the language\n        }\n      } catch (e) {\n        importLines.push(`// Error: unable to parse '${filename}' messages file.`);\n        log(`${loggingPrefix}: NOTICE: Skipping '${directory}/${filename}' due to error: ${e}.\\n`);\n        return; // Skip the language\n      }\n\n      counter.nonEmptyLanguages += 1;\n      importLines.push(`import ${messagesCamelCaseVar} from './${filename}';`);\n      messagesLines.splice(1, 0, `  '${reactIntlLanguageCode}': ${messagesCamelCaseVar},`);\n    });\n\n    if (counter.nonEmptyLanguages) {\n      // See the help message above for sample output.\n      const messagesFileContent = [\n        filesCodeGeneratorNoticeHeader,\n        importLines.join('\\n'),\n        '\\nexport default {',\n        messagesLines.join('\\n'),\n        '};\\n',\n      ].join('\\n');\n\n      writeFileSync(`${messagesDir}/${directory}/index.js`, messagesFileContent);\n      return {\n        directory,\n        isWritten: true,\n      };\n    }\n    log(`${loggingPrefix}: Skipping '${directory}' because no languages were found.\\n`);\n  } catch (e) {\n    log(`${loggingPrefix}: NOTICE: Skipping '${directory}' due to error: ${e}.\\n`);\n  }\n\n  return {\n    directory,\n    isWritten: false,\n  };\n}\n\n/**\n * Create main `src/i18n/index.js` messages import file.\n *\n *\n * @param processedDirectories - List of directories with a boolean flag whether its \"index.js\" file is written\n *                               The format is \"[\\{ directory: \"frontend-component-example\", isWritten: false \\}, ...]\"\n * @param log - Mockable process.stdout.write\n * @param writeFileSync - Mockable fs.writeFileSync\n * @param i18nDir` - Path to `src/i18n` directory\n */\nfunction generateMainMessagesFile({\n  processedDirectories,\n  log,\n  writeFileSync,\n  i18nDir,\n}) {\n  const importLines = [];\n  const exportLines = [];\n\n  processedDirectories.forEach(processedDirectory => {\n    const { directory, isWritten } = processedDirectory;\n    if (isWritten) {\n      const moduleCamelCaseVariableName = camelCase(`messages_from_${directory}`);\n      importLines.push(`import ${moduleCamelCaseVariableName} from './messages/${directory}';`);\n      exportLines.push(`  ${moduleCamelCaseVariableName},`);\n    } else {\n      const skipMessage = `Skipped import due to missing '${directory}/index.js' likely due to empty translations.`;\n      importLines.push(`// ${skipMessage}.`);\n      log(`${loggingPrefix}: ${skipMessage}\\n`);\n    }\n  });\n\n  // See the help message above for sample output.\n  const indexFileContent = [\n    filesCodeGeneratorNoticeHeader,\n    importLines.join('\\n'),\n    '\\nexport default [',\n    exportLines.join('\\n'),\n    '];\\n',\n  ].join('\\n');\n\n  writeFileSync(`${i18nDir}/index.js`, indexFileContent);\n}\n\n/*\n * Main function of the file.\n */\nfunction main({\n  directories,\n  log,\n  writeFileSync,\n  pwd,\n}) {\n  const i18nDir = `${pwd}/src/i18n`; // The Micro-frontend i18n root directory\n\n  if (directories.includes('--help') || directories.includes('-h')) {\n    log(scriptHelpDocument);\n  } else if (!directories.length) {\n    log(scriptHelpDocument);\n    log(`${loggingPrefix}: Error: A list of directories is required.\\n`);\n  } else if (!fs.existsSync(i18nDir) || !fs.lstatSync(i18nDir).isDirectory()) {\n    log(scriptHelpDocument);\n    log(`${loggingPrefix}: Error: src/i18n directory was not found.\\n`);\n  } else {\n    const processedDirectories = directories.map(directory => generateSubdirectoryMessageFile({\n      directory,\n      log,\n      writeFileSync,\n      i18nDir,\n    }));\n    generateMainMessagesFile({\n      processedDirectories,\n      log,\n      writeFileSync,\n      i18nDir,\n    });\n  }\n}\n\nif (require.main === module) {\n  // Run the main() function if called from the command line.\n  main({\n    directories: process.argv.slice(2),\n    log: text => process.stdout.write(text),\n    writeFileSync: fs.writeFileSync,\n    pwd: process.env.PWD,\n  });\n}\n\nmodule.exports.main = main; // Allow tests to use the main function.\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edx/frontend-platform",
-  "version": "4.0.2",
+  "version": "4.1.0",
   "description": "Foundational application framework for Open edX micro-frontend applications.",
   "main": "index.js",
   "publishConfig": {
@@ -18,6 +18,7 @@
     "test:watch": "npm run test -- --watch"
   },
   "bin": {
+    "intl-imports.js": "i18n/scripts/intl-imports.js",
     "transifex-utils.js": "i18n/scripts/transifex-utils.js"
   },
   "repository": {
@@ -34,7 +35,7 @@
     "@edx/brand": "npm:@edx/brand-openedx@1.2.0",
     "@edx/browserslist-config": "1.1.1",
     "@edx/frontend-build": "12.7.0",
-    "@edx/paragon": "20.28.5",
+    "@edx/paragon": "^20.30.1",
     "@testing-library/react-hooks": "^8.0.1",
     "axios-mock-adapter": "^1.21.3",
     "core-js": "3.29.1",
@@ -75,8 +76,8 @@
   "peerDependencies": {
     "@edx/paragon": ">= 10.0.0 < 21.0.0",
     "prop-types": "^15.7.2",
-    "react": "^16.9.0",
-    "react-dom": "^16.9.0",
+    "react": "^16.9.0 || ^17.0.0",
+    "react-dom": "^16.9.0 || ^17.0.0",
     "react-redux": "^7.1.1",
     "react-router-dom": "^5.0.1",
     "redux": "^4.0.4"