Add translation sorting script.

Author: VillePihlava

package.json

@@ -31,10 +31,16 @@
     "test:update-all-desktop-snapshots": "CONFIG=hsl yarn test:update-snapshots && CONFIG=tampere yarn test:update-snapshots && CONFIG=matka yarn test:update-snapshots",
     "test:update-all-mobile-snapshots": "MOBILE=true CONFIG=hsl yarn test:update-snapshots && MOBILE=true CONFIG=tampere yarn test:update-snapshots && MOBILE=true CONFIG=matka yarn test:update-snapshots",
     "test:update-all-snapshots": "yarn test:update-all-desktop-snapshots && yarn test:update-all-mobile-snapshots",
+    "lint": "yarn run sort-translations-check && yarn run es-lint && yarn run prettier-styles && yarn run stylelint",
+    "format": "yarn run sort-translations-fix && yarn run es-lint-fix && yarn run prettier-styles-fix && yarn run stylelint-fix",
+    "sort-translations-check": "node scripts/sort-translations.js --check",
+    "sort-translations-fix": "node scripts/sort-translations.js --fix",
     "es-lint": "eslint .",
-    "lint": "yarn run es-lint && yarn run prettier-styles && yarn run stylelint",
-    "prettier-styles": "prettier sass/**/*.scss app/**/*.scss digitransit-component/**/*.scss --fix --write",
+    "es-lint-fix": "eslint . --fix",
+    "prettier-styles": "prettier sass/**/*.scss app/**/*.scss digitransit-component/**/*.scss --check",
+    "prettier-styles-fix": "prettier sass/**/*.scss app/**/*.scss digitransit-component/**/*.scss --write",
     "stylelint": "stylelint sass/**/*.scss app/**/*.scss digitransit-component/**/*.scss",
+    "stylelint-fix": "stylelint sass/**/*.scss app/**/*.scss digitransit-component/**/*.scss --fix",
     "build": "NODE_OPTIONS=--openssl-legacy-provider && NODE_ENV=production && yarn prebuild && node --max_old_space_size=4096 node_modules/.bin/webpack --progress --color",
     "build-workspaces": "yarn build-components && yarn build-search-utils && yarn build-store",
     "start": "NODE_ENV=production node $NODE_OPTS server/server",

scripts/README.md

@@ -1,12 +1,19 @@
-# Using scripts
+# Scripts
+
+## Using `sort-translations.js`
+
+This script sorts [`app/translations.js`](/app/translations.js).
+See the `sort-translations` and `format` scripts in [`package.json`](/package.json).
+
+## Using `ui.sh`
 
 See the `themeMap` in `app/configurations/config.default.js` for configuration options.
 
-## Before using
+### Before using
 ```
 source ui.sh
 ```
-## Usage examples
+### Usage examples
 
 Using remote instance of OTP with subscription key:
 ```

scripts/sort-translations.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+const fs = require('fs');
+const path = require('path');
+
+const TRANSLATIONS_FILE = path.resolve(__dirname, '../app/translations.js');
+const PRINT_WIDTH = 80;
+const VALID_FLAGS = new Set(['--check', '--fix']);
+
+function needsQuoting(key) {
+  return !/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key);
+}
+
+function formatKey(key) {
+  return needsQuoting(key) ? `'${key}'` : key;
+}
+
+function formatValue(value) {
+  const escaped = value
+    .replace(/\\/g, '\\\\')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t');
+  // Use double quotes when value contains a single quote to avoid escaping
+  if (escaped.includes("'")) {
+    return `"${escaped.replace(/"/g, '\\"')}"`;
+  }
+  return `'${escaped}'`;
+}
+
+function sortedTranslationsFileContent(translations) {
+  const lines = [];
+  lines.push('/* eslint sort-keys: "error" */');
+  lines.push('const translations = {');
+
+  const sortedLangs = Object.keys(translations).sort();
+  for (let i = 0; i < sortedLangs.length; i++) {
+    const lang = sortedLangs[i];
+    lines.push(`  ${formatKey(lang)}: {`);
+
+    const keys = Object.keys(translations[lang]).sort();
+    for (let j = 0; j < keys.length; j++) {
+      const key = keys[j];
+      const formattedKey = formatKey(key);
+      const formattedValue = formatValue(translations[lang][key]);
+      const singleLine = `    ${formattedKey}: ${formattedValue},`;
+      if (singleLine.length <= PRINT_WIDTH) {
+        lines.push(singleLine);
+      } else {
+        lines.push(`    ${formattedKey}:`);
+        lines.push(`      ${formattedValue},`);
+      }
+    }
+    lines.push('  },');
+  }
+
+  lines.push('};');
+  lines.push('');
+  lines.push('export default translations;');
+  lines.push('');
+
+  return lines.join('\n');
+}
+
+async function main() {
+  try {
+    console.log('---------- Running sort-translations.js script ----------');
+    const flag = process.argv[2];
+    if (!VALID_FLAGS.has(flag)) {
+      console.error(
+        'Missing or invalid mode. Use --check to verify sorting or --fix to write sorted translations.',
+      );
+      process.exitCode = 1;
+      return;
+    }
+
+    const translations = (await import(TRANSLATIONS_FILE)).default;
+    const current = fs.readFileSync(TRANSLATIONS_FILE, 'utf-8');
+    const sorted = sortedTranslationsFileContent(translations);
+
+    if (flag === '--check') {
+      if (current === sorted) {
+        console.log('CHECK mode - Translations are sorted:', TRANSLATIONS_FILE);
+      } else {
+        console.error(
+          'CHECK mode - Translations are not sorted:',
+          TRANSLATIONS_FILE,
+        );
+        process.exitCode = 1;
+      }
+      return;
+    }
+
+    try {
+      fs.writeFileSync(TRANSLATIONS_FILE, sorted, 'utf-8');
+      console.log(
+        'FIX mode - Sorted translations written to',
+        TRANSLATIONS_FILE,
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(
+        `FIX - Failed to write sorted translations to ${TRANSLATIONS_FILE}: ${message}`,
+      );
+      process.exitCode = 1;
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Failed to process translations: ${message}`);
+    process.exitCode = 1;
+  }
+}
+
+main();