v2.7.0

.github/workflows/crowdin.yml

@@ -0,0 +1,113 @@
+name: crowdin
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - labeled
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  format:
+    name: Format Translations
+    if: |
+      contains(github.event.pull_request.labels.*.name, 'translations') &&
+      startsWith(github.event.pull_request.head.ref, 'l10n_') &&
+      github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Get files
+        id: files
+        run: |
+          git fetch origin "${{ github.event.pull_request.base.ref }}"
+
+          git diff \
+            --name-only \
+            "origin/${{ github.event.pull_request.base.ref }}...HEAD" \
+            -- '*.json' > files.txt
+
+          cat files.txt
+
+      - name: Format translation files
+        run: |
+          cat > fix.js <<'EOF'
+          const fs = require('fs');
+
+          function clean(value) {
+            if (typeof value === 'string') {
+              return value === '' ? undefined : value;
+            }
+
+            if (Array.isArray(value)) {
+              const arr = value.map(clean).filter(v => v !== undefined);
+              return arr.length ? arr : undefined;
+            }
+
+            if (value && typeof value === 'object') {
+              const result = {};
+
+              for (const [key, val] of Object.entries(value)) {
+                const cleaned = clean(val);
+
+                if (cleaned !== undefined) {
+                  result[key] = cleaned;
+                }
+              }
+
+              return Object.keys(result).length ? result : undefined;
+            }
+
+            return value;
+          }
+
+          const files = fs.readFileSync('files.txt', 'utf8')
+            .split('\n')
+            .map(f => f.trim())
+            .filter(Boolean);
+
+          for (const file of files) {
+            try {
+              const json = JSON.parse(fs.readFileSync(file, 'utf8'));
+              const cleaned = clean(json) ?? {};
+
+              fs.writeFileSync(file, JSON.stringify(cleaned), 'utf8');
+
+              console.log(`Processed ${file}`);
+            } catch (err) {
+              console.warn(`Skipping ${file}: ${err.message}`);
+            }
+          }
+          EOF
+
+          node fix.js
+
+      - name: Commit changes
+        run: |
+          if git diff --quiet; then
+            echo "No changes."
+            exit 0
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          git add $(cat files.txt)
+          git commit -m "Format Crowdin translation exports"
+          git push

.github/workflows/eslint.yml

@@ -1,29 +1,23 @@
 name: lint
 on:
   pull_request:
-    branches: 
-        - "*"
-  push: 
-    branches:
-        - '*'
+  push:
 jobs:
-  build:
+  lint:
     name: Run Linters
     runs-on: ubuntu-latest
 
     steps:
-      - name: Check out Git repo
-        uses: actions/checkout@v3
-        with: 
-          node-version: 16.11.0
-
-      - name: Set up node.js
-        uses: actions/setup-node@v1
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          node-version: '18.x'
-      
-      - name: Install node.js deps
-        run: npm i eslint --save-dev
-        
-      - name: Run lint
-        run: npx eslint --fix ./src/**/*.ts
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npx eslint ./src/**/*.ts

.github/workflows/tsc.yml

@@ -1,29 +1,23 @@
 name: tsc
 on:
   pull_request:
-    branches: 
-        - "*"
-  push: 
-    branches:
-        - '*'
+  push:
 jobs:
-  build:
+  tsc:
     name: Run tsc
     runs-on: ubuntu-latest
 
     steps:
-      - name: Check out Git repo
-        uses: actions/checkout@v3
-        with: 
-          node-version: 16.11.0
-
-      - name: Set up node.js
-        uses: actions/setup-node@v1
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
         with:
-          node-version: '18.x'
-      
-      - name: Install node.js deps
-        run: npm i eslint typescript --save-dev
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm ci
 
       - name: Run tsc
-        run: npx tsc 
+        run: npx tsc

.npmignore

@@ -10,6 +10,8 @@ EXTENSIONS.md
 .env
 tsconfig.json
 tsconfig.build.json
+eslint.config.js
 .eslintrc.json
 .prettierrc
-.prettierignore
+.prettierignore
+crowdin.yml

.vscode/settings.json

@@ -1,3 +1,4 @@
 {
-    "editor.wordBasedSuggestions": "off"
+    "editor.wordBasedSuggestions": "off",
+    "compilets.autoStart": false
 }

README.md

@@ -117,5 +117,5 @@ The previous way to register commands can fill our index file with a lot of junk
 </summary>
 
 There's currently no known limitation.
-> <img align="top" src="https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Warning.svg/156px-Warning.svg.png" alt="image" width="25" height="auto"> Note this library reads codes from **TOP** to **BOTTOM**, and never the opposite.
+> ⚠️ Note this library reads codes from **TOP** to **BOTTOM**, and never the opposite.
 </details>

crowdin.yml

@@ -0,0 +1,8 @@
+pull_request_title: Crowdin Translations
+pull_request_labels:
+  - translations
+pull_request_assignees:
+  - xNickyDev
+files:
+  - source: /metadata/translations/en.json
+    translation: /metadata/translations/%locale%.json