feat: auto-merge all Nitro config .example files with missing key detection

package.json

@@ -55,6 +55,7 @@
     "@inertiajs/react": "^3.2.0",
     "@vitejs/plugin-react": "^6.0.2",
     "flowbite": "2.5.2",
+    "json5": "^2.2.3",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
     "sass": "1.83.4",

scripts/merge-config.cjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const json5 = require('json5');
+
+const [srcFile, destFile] = process.argv.slice(2);
+
+if (!srcFile || !destFile) {
+    console.error('Usage: merge-config.js <source.example> <dest.json>');
+    process.exit(1);
+}
+
+function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+        if (!(key in target)) {
+            target[key] = source[key];
+        } else if (typeof source[key] === 'object' && !Array.isArray(source[key]) &&
+                   typeof target[key] === 'object' && !Array.isArray(target[key])) {
+            deepMerge(target[key], source[key]);
+        }
+    }
+    return target;
+}
+
+function getTargetName(exampleFile) {
+    let name = exampleFile.replace(/\.example$/, '');
+    const ext = path.extname(name);
+    if (!ext || ext === '.example') {
+        name += '.json';
+    }
+    return name;
+}
+
+const srcContent = fs.readFileSync(srcFile, 'utf8');
+let srcData;
+try {
+    srcData = json5.parse(srcContent);
+} catch (e) {
+    console.error(`--> [SKIP] Could not parse ${srcFile}: ${e.message}`);
+    process.exit(0);
+}
+
+if (typeof srcData !== 'object' || Array.isArray(srcData)) {
+    console.error(`--> [SKIP] ${srcFile} is not a JSON object, copying directly`);
+    fs.copyFileSync(srcFile, destFile);
+    process.exit(0);
+}
+
+let destData = {};
+let existingKeys = [];
+if (fs.existsSync(destFile)) {
+    try {
+        const destContent = fs.readFileSync(destFile, 'utf8');
+        destData = json5.parse(destContent);
+        existingKeys = Object.keys(destData);
+    } catch (e) {
+        console.error(`--> Warning: could not parse ${destFile}, overwriting from example`);
+    }
+}
+
+const merged = deepMerge(destData, srcData);
+
+const newKeys = Object.keys(merged).filter(k => !existingKeys.includes(k));
+if (newKeys.length > 0) {
+    console.log(`--> Added ${newKeys.length} new key(s) to ${path.basename(destFile)}`);
+}
+
+fs.writeFileSync(destFile, JSON.stringify(merged, null, 4) + '\n');
+console.log(`--> [OK] ${path.basename(destFile)} is up to date`);

update-Nitrov3.sh

@@ -134,23 +134,21 @@ yarn build
 echo "--> Synchronizing Gamedata configurations..."
 mkdir -p "$GAMEDATA_CONF_DIR"
 
-# --- Renderer Config Sync (always from latest example) ---
+MERGE_SCRIPT="$(dirname "$0")/scripts/merge-config.cjs"
-if [ -f "$NITRO_SRC_DIR/renderer-config.example" ]; then
-    echo "--> Updating renderer-config.json from latest example..."
-    cp "$NITRO_SRC_DIR/renderer-config.example" "$GAMEDATA_CONF_DIR/renderer-config.json"
-fi
 
-# --- UI Config Sync (always from latest example) ---
+echo "--> Merging Nitro config examples into Gamedata/config..."
-if [ -f "$NITRO_SRC_DIR/ui-config.json.example" ]; then
+for example_file in "$NITRO_SRC_DIR"/*.example; do
-    echo "--> Updating ui-config.json from latest example..."
+    [ -f "$example_file" ] || continue
-    cp "$NITRO_SRC_DIR/ui-config.json.example" "$GAMEDATA_CONF_DIR/ui-config.json"
+    base=$(basename "$example_file")
-fi
+    target_name="${base%.example}"
-
+    case "$target_name" in
-# --- UITexts Sync (always from latest example) ---
+        *.*) ;;  # already has extension (e.g., .json, .json5)
-if [ -f "$NITRO_SRC_DIR/UITexts.json5.example" ]; then
+        *) target_name="$target_name.json" ;;  # no extension -> add .json
-    echo "--> Updating UITexts.json5 from latest example..."
+    esac
-    cp "$NITRO_SRC_DIR/UITexts.json5.example" "$GAMEDATA_CONF_DIR/UITexts.json5"
+    target_path="$GAMEDATA_CONF_DIR/$target_name"
-fi
+    echo "--> Processing $base -> $target_name..."
+    node "$MERGE_SCRIPT" "$example_file" "$target_path"
+done
 
 
 # ----------------------------------------

yarn.lock

@@ -2195,6 +2195,11 @@ json-stable-stringify-without-jsonify@^1.0.1:
   resolved "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz"
   integrity sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==
 
+json5@^2.2.3:
+  version "2.2.3"
+  resolved "https://registry.yarnpkg.com/json5/-/json5-2.2.3.tgz#78cd6f1a19bdc12b73db5ad0c61efd66c1e29283"
+  integrity sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==
+
 keyv@^4.5.4:
   version "4.5.4"
   resolved "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz"