Fix: Documentation and build errors requiring Node.js 24.15+ for frontend builds

README.md

@@ -171,7 +171,7 @@ dotnet publish src/MyApp/MyApp.csproj -t:InfiniFrameSingleFile -r win-x64 -c Rel
 
 Requirements:
 
-- `Node.js`/`npm` (required)
+- `Node.js` 24.15+ and `npm`
 
 Run:
 

badges/python-coverage.json

@@ -1,6 +1,6 @@
 {
     "schemaVersion": 1,
     "label": "Python coverage",
-    "message": "88.8%",
+    "message": "87.2%",
     "color": "brightgreen"
 }

scripts/js-buildfrontend.mjs

@@ -32,6 +32,12 @@ if (!appDirectoryArg || !stampFileArg || outputFileArgs.length === 0) {
     process.exit(1);
 }
 
+const [nodeMajor, nodeMinor, nodePatch] = process.versions.node.split('.').map(Number);
+if (nodeMajor < 24 || (nodeMajor === 24 && (nodeMinor < 15 || (nodeMinor === 15 && nodePatch < 0)))) {
+    console.error(`InfiniFrame frontend builds require Node.js 24.15.0 or newer; found ${process.versions.node}.`);
+    process.exit(1);
+}
+
 const appDirectory = path.resolve(appDirectoryArg);
 const stampFile = path.resolve(stampFileArg);
 const outputFiles = outputFileArgs.map(outputFileArg => path.resolve(outputFileArg));

src/InfiniFrame.Js/package.json

@@ -5,6 +5,9 @@
     "author": "InfiniLore",
     "license": "Apache-2.0",
     "keywords": ["infiniframe", "blazor", "interop", "webview", "desktop"],
+    "engines": {
+        "node": ">=24.15.0"
+    },
     "scripts": {
         "typecheck": "tsc --noEmit",
         "build": "npm run typecheck && vite build --config vite.config.prod.ts && vite build --config vite.config.dev.ts",

src/InfiniFrame.NativeBridge/Native/.cmake/NativeDependencies.cmake

@@ -192,7 +192,10 @@ function(infiniframe_resolve_webview2_base_dir webview2_version out_var)
     endforeach ()
     _infiniframe_resolve_base_dir(_base_dir "include/WebView2.h" ${_candidates})
     if (NOT _base_dir)
-        message(FATAL_ERROR "WebView2 headers not found")
+        message(FATAL_ERROR
+                "WebView2 headers not found for version ${webview2_version}. "
+                "Run 'dotnet restore src/InfiniFrame.NativeBridge/InfiniFrame.NativeBridge.csproj' "
+                "before configuring CMake, or set NUGET_PACKAGES/INFINIFRAME_NUGET_PACKAGES_ROOT to the NuGet cache.")
     endif ()
     set(${out_var} "${_base_dir}" PARENT_SCOPE)
 endfunction()

src/InfiniFrame.NativeBridge/Native/README.md

@@ -77,8 +77,16 @@ See [BUILDING.md](BUILDING.md) for build performance tips.
 
 - CMake 4.0+
 - C++23 compiler (MSVC 17+ on Windows, GCC 13+ on Linux, Clang 17+ on macOS)
+- Node.js 24.15+ and npm
 - Platform SDKs: WebView2 (Windows), WebKit2GTK 4.1 (Linux), macOS SDK (macOS)
 
+On Windows, restore the NativeBridge project before configuring CMake. The C++ build consumes the WebView2 and WIL
+headers from the NuGet global package cache:
+
+```powershell
+dotnet restore src/InfiniFrame.NativeBridge/InfiniFrame.NativeBridge.csproj
+```
+
 ### Build
 
 ```bash