Merge pull request #279 from gilbsgilbs/update-deps

V1

.github/workflows/main.yml

@@ -4,7 +4,7 @@ name: CI
 on: [push, pull_request]
 
 env:
-  MAIN_NODE_VERSION: "16"
+  MAIN_NODE_VERSION: "22"
 
 jobs:
   static-checks:
@@ -26,7 +26,7 @@ jobs:
     name: Run tests
     strategy:
       matrix:
-        node: ["18", "20", "21"]
+        node: ["18", "20", "22", "23"]
     steps:
       - uses: actions/checkout@v4
       - name: Setup node

CONTRIBUTING.md

@@ -112,7 +112,7 @@ informed that you're working on it.
 - `exporters/`: contains code related to exporting extracted translations to files.
     - `commons.ts`: Types and exceptions definitions for extractors.
     - `index.ts`: Entrypoint for exporters. Calls and uses the proper extractor implementation
-      (only JSONv3 and JSONv4 at the moment).
+      (only JSONv4).
     - `json.ts`: [JSONv4](https://www.i18next.com/misc/json-format#i18next-json-v4) extractor
       implementation.
 - `comments.ts` parses the comment hints.

docs/generateDocs.js

@@ -1,46 +1,46 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-const path = require('path');
+/* eslint-disable @typescript-eslint/no-require-imports */
+const path = require("path");
 
-const fs = require('fs-extra');
-const yaml = require('js-yaml');
-const nunjucks = require('nunjucks');
-/* eslint-enable @typescript-eslint/no-var-requires */
+const fs = require("fs-extra");
+const yaml = require("js-yaml");
+const nunjucks = require("nunjucks");
+/* eslint-enable @typescript-eslint/no-require-imports */
 
-const OUTPUT_PATH = './_build';
-const TEMPLATES_PATH = './templates';
-const ASSETS_PATH = './assets';
+const OUTPUT_PATH = "./_build";
+const TEMPLATES_PATH = "./templates";
+const ASSETS_PATH = "./assets";
 
 // Remove and recreate output directory
 fs.removeSync(OUTPUT_PATH);
 try {
   fs.mkdirSync(OUTPUT_PATH);
 } catch (err) {
-  if (err.code !== 'EEXIST') {
+  if (err.code !== "EEXIST") {
     throw err;
   }
 }
 fs.copySync(ASSETS_PATH, OUTPUT_PATH);
 
-const env = new nunjucks.Environment(new nunjucks.FileSystemLoader('.'), {
+const env = new nunjucks.Environment(new nunjucks.FileSystemLoader("."), {
   autoescape: false,
 });
-env.addGlobal('includeFile', (src, ctx) => {
+env.addGlobal("includeFile", (src, ctx) => {
   return env.renderString(
     fs
-      .readFileSync(src, 'utf-8')
+      .readFileSync(src, "utf-8")
       // Substitute documentation links
       .replace(
         /\(\s*https:\/\/i18next-extract\.netlify\.com\/(?:#\/)?([^)]+)\s*\)/gm,
-        '($1)',
+        "($1)",
       )
-      .replace(/\(\s*(?:\.\/|\/)?docs\/assets\/([^)]+)\s*\)/gm, '($1)'),
+      .replace(/\(\s*(?:\.\/|\/)?docs\/assets\/([^)]+)\s*\)/gm, "($1)"),
     ctx,
   );
 });
 
 const templatePaths = fs
   .readdirSync(TEMPLATES_PATH)
-  .filter((s) => s.endsWith('.md') || s.endsWith('.html'));
+  .filter((s) => s.endsWith(".md") || s.endsWith(".html"));
 
 for (const templatePath of templatePaths) {
   console.log(`Rendering ${templatePath}.`);
@@ -49,17 +49,17 @@ for (const templatePath of templatePaths) {
 
   let ctx = {};
   try {
-    ctx = yaml.load(fs.readFileSync(filePath + '.yml'));
+    ctx = yaml.load(fs.readFileSync(filePath + ".yml"));
   } catch (err) {
-    if (err.code !== 'ENOENT') {
+    if (err.code !== "ENOENT") {
       throw err;
     }
   }
 
   const tpl =
-    '<!-- THIS FILE WAS GENERATED FROM A TEMPLATE. DO NOT EDIT IT MANUALLY. -->\n' +
-    '<!-- Read CONTRIBUTING.md for more information. -->\n\n' +
-    fs.readFileSync(filePath, 'utf-8');
+    "<!-- THIS FILE WAS GENERATED FROM A TEMPLATE. DO NOT EDIT IT MANUALLY. -->\n" +
+    "<!-- Read CONTRIBUTING.md for more information. -->\n\n" +
+    fs.readFileSync(filePath, "utf-8");
   fs.writeFileSync(
     path.join(OUTPUT_PATH, templatePath),
     env.renderString(tpl, ctx),

docs/package.json

@@ -10,5 +10,5 @@
     "nodemon": "^3.0.1",
     "nunjucks": "^3.2.4"
   },
-  "packageManager": "yarn@4.0.2"
+  "packageManager": "yarn@4.5.3+sha512.3003a14012e2987072d244c720506549c1aab73ee728208f1b2580a9fd67b92d61ba6b08fe93f6dce68fd771e3af1e59a0afa28dd242dd0940d73b95fedd4e90"
 }

docs/templates/configuration.md.yml

@@ -43,12 +43,10 @@ configOptions:
       https://react.i18next.com/latest/trans-component#additional-options-on-i-18-next-init).
     defaultValue: "['br', 'strong', 'i', 'p']"
   - name: compatibilityJSON
-    type: '"v3" | "v4"'
+    type: '"v4"|null'
     description: |
-      Compatibility mode of the output JSON file. This option only changes the way plurals are exported.
-
-      See [JSONv* format documentation](https://www.i18next.com/misc/json-format#i18next-json-v4) and [why this option exists](https://www.i18next.com/misc/migration-guide#json-format-v4-pluralization).
-    defaultValue: '"v3"'
+      Compatibility mode of the output JSON file. As i18next has dropped support for JSONv3, this option is a no-op in practice.
+    defaultValue: 'null'
   - name: i18nextInstanceNames
     type: "string[]"
     description: |
@@ -333,15 +331,6 @@ configOptions:
     type: "number"
     description: Number of indentation space to use in extracted JSON files.
     defaultValue: "2"
-  - name: enableExperimentalIcu
-    type: "boolean"
-    description: |
-      Enable experimental support for [ICU message syntax](
-      http://userguide.icu-project.org/formatparse/messages). Only plurals and JSONv4 are supported for now.
-
-      ☠️  *This feature is incomplete and might change or move into an third-party module in the
-      future. Stay tuned.* ☠️
-    defaultValue: "false"
   - name: excludes
     type: "string[]"
     description: |