First translation sync

.github/workflows/build.yml

@@ -36,7 +36,7 @@ jobs:
       - run: npm ci
         env:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - run: npm install --no-save @microbit-foundation/[email protected].58 @microbit-foundation/[email protected] @microbit-foundation/[email protected]
+      - run: npm install --no-save @microbit-foundation/[email protected].60 @microbit-foundation/[email protected] @microbit-foundation/[email protected]
         if: github.repository_owner == 'microbit-foundation'
         env:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

bin/update-translations.cjs

@@ -0,0 +1,89 @@
+/**
+ * Update translations for CreateAI tool. To ensure translations for ML
+ * MakeCode blocks are consistent, translated strings are taken from
+ * pxt-microbit-ml machine-learning-strings.json. See CodeViewDefaultBlock.tsx
+ * to see where they are used.
+ *
+ * To update all translations, pass 2 arguments:
+ * 1. Path to CreateAI tool translation strings directory.
+ * 2. Path to machine-learning-strings.json translation strings directory.
+ *
+ * To only update MakeCode block translations, pass path to
+ * machine-learning-strings.json translation strings directory as an argument.
+ *
+ * Manually run `npm run i18n:compile` after.
+ *
+ * To add a language, add below and then update for all translations.
+ */
+const fs = require("fs");
+
+const okExitStatus = 0;
+const errExitStatus = 2;
+
+const languages = ["en", "es-ES", "ja", "ko", "nl", "pl", "pt-br", "zh-tw"];
+const enMessagesToAdd = {
+  "ml.onStart|block": {
+    defaultMessage: "on ML $event start",
+    description: "This string should be a Crowdin duplicate of the MakeCode extension block with the same text and use the same translation.",
+  },
+};
+
+const getMessagesToAdd = (mlStrings, langMessages) => {
+  return Object.keys(enMessagesToAdd).reduce((acc, k) => {
+    // Add or update with translated strings.
+    if (mlStrings[k]) {
+      return {
+        ...acc,
+        [k]: { ...enMessagesToAdd[k], defaultMessage: mlStrings[k] },
+      };
+    }
+    // Fallback to en messages if no translation.
+    if (!langMessages[k]) {
+      return { ...acc, [k]: { ...enMessagesToAdd[k] } };
+    }
+    return { ...acc, [k]: { ...enMessagesToAdd[k], defaultMessage: acc[k].defaultMessage } };
+  }, {});
+};
+const getFileJSONContent = (filepath) => JSON.parse(fs.readFileSync(filepath));
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args.length > 2) {
+  console.log(`Error: 2 arguments needed. 
+    1. Path to CreateAI tool translation strings directory.
+    2. Path to machine-learning-strings.json translation strings directory. `);
+  process.exit(errExitStatus);
+}
+
+const [createAiTranslationsFilepath, mlTranslationsFilepath] =
+  args.length === 1 ? [null, args[0]] : args;
+
+languages.forEach((language) => {
+  const lowerLang = language.toLowerCase();
+  const outputFilepath = `lang/ui.${lowerLang}.json`;
+
+  if (language === "en") {
+    // Assumes that lang/ui.en.json exists and directly adds enMessagesToAdd.
+    const langMessages = getFileJSONContent(outputFilepath);
+    fs.writeFileSync(
+      outputFilepath,
+      JSON.stringify({ ...langMessages, ...enMessagesToAdd })
+    );
+    return;
+  }
+
+  const srcLangFilepath = !createAiTranslationsFilepath
+    ? `lang/ui.${lowerLang}.json`
+    : `${createAiTranslationsFilepath}/${language}/ui.en.json`;
+  const langMessages = getFileJSONContent(srcLangFilepath);
+
+  const mlFilepath = `${mlTranslationsFilepath}/${language}/machine-learning-strings.json`;
+  const mlStrings = getFileJSONContent(mlFilepath);
+
+  const messagesToAdd = getMessagesToAdd(mlStrings, langMessages);
+  fs.writeFileSync(
+    outputFilepath,
+    JSON.stringify({ ...langMessages, ...messagesToAdd })
+  );
+});
+
+process.exit(okExitStatus);

lang/ui.en.json

@@ -763,6 +763,10 @@
     "defaultMessage": "Help & support",
     "description": "Link or menu item link to support site"
   },
+  "help-translate": {
+    "defaultMessage": "Help translate",
+    "description": "Help translate  menu option text"
+  },
   "home-action": {
     "defaultMessage": "Home",
     "description": "Home button text"
@@ -1055,22 +1059,14 @@
     "defaultMessage": "Left arrow icon for MakeCode back",
     "description": "Testing model page title"
   },
-  "makecode-block-default-alt": {
-    "defaultMessage": "MakeCode block: on ML {actionName} start, show icon {iconName}",
-    "description": "Makecode default block alt text"
-  },
-  "makecode-block-on-ML": {
-    "defaultMessage": "on ML",
-    "description": "Makecode block text. The translation should match MakeCode translations."
+  "makecode-block-alt-prefix": {
+    "defaultMessage": "MakeCode block:",
+    "description": "Makecode block alt text prefix"
   },
   "makecode-block-show-icon": {
     "defaultMessage": "show icon",
     "description": "Makecode block text. The translation should match MakeCode translations."
   },
-  "makecode-block-start": {
-    "defaultMessage": "start",
-    "description": "Makecode block text. The translation should match MakeCode translations."
-  },
   "makecode-load-error-dialog-body": {
     "defaultMessage": "{appNameFull} has failed to load MakeCode. Please check your internet connection, reload the page then try again.",
     "description": "Content of MakeCode load error dialog"
@@ -1083,6 +1079,10 @@
     "defaultMessage": "Your micro:bit is not connected",
     "description": "Live graph disconnected micro:bit status message"
   },
+  "ml.onStart|block": {
+    "defaultMessage": "on ML $event start",
+    "description": "This string should be a Crowdin duplicate of the MakeCode extension block with the same text and use the same translation."
+  },
   "more-edit-in-makecode-options": {
     "defaultMessage": "More edit in MakeCode options",
     "description": "Aria label for the additional actions menu to the right of the Edit in MakeCode button"