svelteesp32 2.0.0 → 2.1.0

package/README.md

@@ -25,7 +25,7 @@
 - **Smart Caching** — Built-in SHA256 ETags deliver HTTP 304 responses, slashing bandwidth on constrained devices.
 - **CI/CD Ready** — Simple npm package that slots into any build pipeline.
 - **Zero Runtime Overhead** — Data served directly from flash. No filesystem reads, no RAM allocation.
-- **3 Web Server Engines** — PsychicHttpServer, ESPAsyncWebServer, and native ESP-IDF supported.
+- **4 Web Server Engines** — PsychicHttpServer V2, ESPAsyncWebServer, Arduino WebServer, and native ESP-IDF supported.
 
 ---
 
@@ -79,6 +79,8 @@ void setup() {
 
 ## What's New
 
+- **v2.1.0** — New Arduino WebServer engine (`-e webserver`), dependency updates
+- **v2.0.1** — Dependency updates (ESLint v10, eslint-plugin-unicorn 63), improved error cause chaining
 - **v2.0.0** — **BREAKING**: PsychicHttpServer V2 is now the default `psychic` engine. The `psychic2` engine has been removed. Dry run mode, C++ identifier validation, improved MIME type warnings
 - **v1.16.0** — Size budget constraints (`--maxsize`, `--maxgzipsize`)
 - **v1.15.0** — `--basepath` for multiple frontends (e.g., `/admin`, `/app`)
@@ -115,6 +117,9 @@ npx svelteesp32 -e psychic -s ./dist -o ./esp32/svelteesp32.h --etag=true
 # ESPAsyncWebServer (ESP32 + ESP8266)
 npx svelteesp32 -e async -s ./dist -o ./esp32/svelteesp32.h --etag=true
 
+# Arduino WebServer (ESP32, synchronous, no dependencies)
+npx svelteesp32 -e webserver -s ./dist -o ./esp32/svelteesp32.h --etag=true
+
 # Native ESP-IDF
 npx svelteesp32 -e espidf -s ./dist -o ./esp32/svelteesp32.h --etag=true
 ```
@@ -170,6 +175,24 @@ void setup() {
 }
 ```
 
+**Arduino WebServer (built-in, no dependencies)**
+
+```c
+#include <WebServer.h>
+#include "svelteesp32.h"
+
+WebServer server(80);
+
+void setup() {
+    initSvelteStaticFiles(&server);
+    server.begin();
+}
+
+void loop() {
+    server.handleClient();
+}
+```
+
 **Native ESP-IDF**
 
 ```c
@@ -258,11 +281,12 @@ void initSvelteStaticFiles(PsychicHttpServer * server) {
 
 ## Supported Web Server Engines
 
-| Engine                   | Flag         | Best For                     | Platform        |
-| ------------------------ | ------------ | ---------------------------- | --------------- |
-| **PsychicHttpServer V2** | `-e psychic` | Maximum performance          | ESP32 only      |
-| **ESPAsyncWebServer**    | `-e async`   | Cross-platform compatibility | ESP32 + ESP8266 |
-| **Native ESP-IDF**       | `-e espidf`  | Pure ESP-IDF projects        | ESP32 only      |
+| Engine                   | Flag           | Best For                     | Platform        |
+| ------------------------ | -------------- | ---------------------------- | --------------- |
+| **PsychicHttpServer V2** | `-e psychic`   | Maximum performance          | ESP32 only      |
+| **ESPAsyncWebServer**    | `-e async`     | Cross-platform compatibility | ESP32 + ESP8266 |
+| **Arduino WebServer**    | `-e webserver` | No dependencies, simplicity  | ESP32 only      |
+| **Native ESP-IDF**       | `-e espidf`    | Pure ESP-IDF projects        | ESP32 only      |
 
 **Recommendation:** For ESP32-only projects, use PsychicHttpServer V2 (`-e psychic`) for the fastest, most stable experience.
 
@@ -287,7 +311,7 @@ Reduce bandwidth dramatically with HTTP 304 "Not Modified" responses. When a bro
 - **Minimal overhead** — adds ~1-3% code size for significant bandwidth savings
 - **Compiler mode** — use `--etag=compiler` and control via `-D SVELTEESP32_ENABLE_ETAG`
 
-All three engines support full ETag validation.
+All four engines support full ETag validation.
 
 ### Browser Cache Control
 
@@ -401,25 +425,25 @@ Called for every response (200 = content served, 304 = cache hit).
 
 ## CLI Reference
 
-| Option           | Description                                      | Default                 |
-| ---------------- | ------------------------------------------------ | ----------------------- |
-| `-s`             | Source folder with compiled web files            | (required)              |
-| `-e`             | Web server engine (psychic/async/espidf)         | `psychic`               |
-| `-o`             | Output header file path                          | `svelteesp32.h`         |
-| `--etag`         | ETag caching (true/false/compiler)               | `false`                 |
-| `--gzip`         | Gzip compression (true/false/compiler)           | `true`                  |
-| `--exclude`      | Exclude files by glob pattern                    | System files            |
-| `--basepath`     | URL prefix for all routes                        | (none)                  |
-| `--maxsize`      | Max total uncompressed size (e.g., `400k`, `1m`) | (none)                  |
-| `--maxgzipsize`  | Max total gzip size (e.g., `150k`, `500k`)       | (none)                  |
-| `--cachetime`    | Cache-Control max-age in seconds                 | `0`                     |
-| `--version`      | Version string in header                         | (none)                  |
-| `--define`       | C++ define prefix                                | `SVELTEESP32`           |
-| `--espmethod`    | Init function name                               | `initSvelteStaticFiles` |
-| `--config`       | Custom RC file path                              | `.svelteesp32rc.json`   |
-| `--dryrun`       | Show summary without writing output              | `false`                 |
-| `--noindexcheck` | Skip index.html validation                       | `false`                 |
-| `-h`             | Show help                                        |                         |
+| Option           | Description                                        | Default                 |
+| ---------------- | -------------------------------------------------- | ----------------------- |
+| `-s`             | Source folder with compiled web files              | (required)              |
+| `-e`             | Web server engine (psychic/async/espidf/webserver) | `psychic`               |
+| `-o`             | Output header file path                            | `svelteesp32.h`         |
+| `--etag`         | ETag caching (true/false/compiler)                 | `false`                 |
+| `--gzip`         | Gzip compression (true/false/compiler)             | `true`                  |
+| `--exclude`      | Exclude files by glob pattern                      | System files            |
+| `--basepath`     | URL prefix for all routes                          | (none)                  |
+| `--maxsize`      | Max total uncompressed size (e.g., `400k`, `1m`)   | (none)                  |
+| `--maxgzipsize`  | Max total gzip size (e.g., `150k`, `500k`)         | (none)                  |
+| `--cachetime`    | Cache-Control max-age in seconds                   | `0`                     |
+| `--version`      | Version string in header                           | (none)                  |
+| `--define`       | C++ define prefix                                  | `SVELTEESP32`           |
+| `--espmethod`    | Init function name                                 | `initSvelteStaticFiles` |
+| `--config`       | Custom RC file path                                | `.svelteesp32rc.json`   |
+| `--dryrun`       | Show summary without writing output                | `false`                 |
+| `--noindexcheck` | Skip index.html validation                         | `false`                 |
+| `-h`             | Show help                                          |                         |
 
 ---
 

package/dist/commandLine.d.ts

@@ -1,5 +1,5 @@
 interface ICopyFilesArguments {
-    engine: 'psychic' | 'async' | 'espidf';
+    engine: 'psychic' | 'async' | 'espidf' | 'webserver';
     sourcepath: string;
     outputfile: string;
     espmethod: string;
@@ -18,7 +18,7 @@ interface ICopyFilesArguments {
     help?: boolean;
 }
 interface IRcFileConfig {
-    engine?: 'psychic' | 'async' | 'espidf';
+    engine?: 'psychic' | 'async' | 'espidf' | 'webserver';
     sourcepath?: string;
     outputfile?: string;
     espmethod?: string;

package/dist/commandLine.js

@@ -24,7 +24,7 @@ Configuration:
 
 Options:
   -e, --engine <value>       The engine for which the include file is created
-                             (psychic|async|espidf) (default: "psychic")
+                             (psychic|async|espidf|webserver) (default: "psychic")
   -s, --sourcepath <path>    Source dist folder contains compiled web files (required)
   -o, --outputfile <path>    Generated output file with path (default: "svelteesp32.h")
   --etag <value>             Use ETAG header for cache (true|false|compiler) (default: "false")
@@ -66,7 +66,7 @@ RC File:
     process.exit(0);
 }
 function validateEngine(value) {
-    if (value === 'psychic' || value === 'async' || value === 'espidf')
+    if (value === 'psychic' || value === 'async' || value === 'espidf' || value === 'webserver')
         return value;
     console.error((0, errorMessages_1.getInvalidEngineError)(value));
     process.exit(1);
@@ -151,7 +151,9 @@ function parsePackageJson(packageJsonPath) {
         return JSON.parse(content);
     }
     catch (error) {
-        throw new Error(`Failed to parse package.json at ${packageJsonPath}: ${error.message}`);
+        throw new Error(`Failed to parse package.json at ${packageJsonPath}: ${error.message}`, {
+            cause: error
+        });
     }
 }
 function getNpmPackageVariable(packageJson, variableName) {
@@ -242,7 +244,7 @@ function loadRcFile(rcPath) {
     }
     catch (error) {
         if (error instanceof SyntaxError)
-            throw new Error(`Invalid JSON in RC file ${rcPath}: ${error.message}`);
+            throw new Error(`Invalid JSON in RC file ${rcPath}: ${error.message}`, { cause: error });
         throw error;
     }
 }

package/dist/cppCode.js

@@ -492,6 +492,205 @@ void {{methodName}}(AsyncWebServer * server) {
   });
   {{/if}}
 
+{{/each}}
+}`;
+const webserverTemplate = `
+//engine:   Arduino WebServer
+//config:   {{{config}}}
+{{#if created }}
+//created:  {{now}}
+{{/if}}
+//
+${commonHeaderSection}
+
+//
+#include <Arduino.h>
+#include <WebServer.h>
+
+//
+${dataArraysSection(true)}
+
+//
+${etagArraysSection}
+
+//
+${manifestSection}
+
+//
+${hookSection}
+
+//
+// Chunked send helper for PROGMEM data
+static inline void {{definePrefix}}_sendChunked(WebServer * server, const uint8_t * data, size_t len) {
+  const size_t chunkSize = 4096;
+  for (size_t offset = 0; offset < len; offset += chunkSize) {
+    size_t remaining = len - offset;
+    size_t toSend = remaining < chunkSize ? remaining : chunkSize;
+    server->sendContent_P((const char *)(data + offset), toSend);
+  }
+}
+
+//
+// Http Handlers
+void {{methodName}}(WebServer * server) {
+{{#each sources}}
+//
+// {{this.filename}}
+  server->on("{{../basePath}}/{{this.filename}}", HTTP_GET, [server]() {
+
+{{#switch ../etag}}
+{{#case "true"}}
+    if (server->hasHeader("If-None-Match") && server->header("If-None-Match").equals(etag_{{this.dataname}})) {
+      server->send(304);
+      {{../definePrefix}}_onFileServed("{{../basePath}}/{{this.filename}}", 304);
+      return;
+    }
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_ETAG
+    if (server->hasHeader("If-None-Match") && server->header("If-None-Match").equals(etag_{{this.dataname}})) {
+      server->send(304);
+      {{../definePrefix}}_onFileServed("{{../basePath}}/{{this.filename}}", 304);
+      return;
+    }
+  #endif
+{{/case}}
+{{/switch}}
+
+{{#switch ../etag}}
+{{#case "true"}}
+{{#../cacheTime}}
+    server->sendHeader("Cache-Control", "max-age={{value}}");
+{{/../cacheTime}}
+{{^../cacheTime}}
+    server->sendHeader("Cache-Control", "no-cache");
+{{/../cacheTime}}
+    server->sendHeader("ETag", etag_{{this.dataname}});
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_ETAG
+{{#../cacheTime}}
+    server->sendHeader("Cache-Control", "max-age={{value}}");
+{{/../cacheTime}}
+{{^../cacheTime}}
+    server->sendHeader("Cache-Control", "no-cache");
+{{/../cacheTime}}
+    server->sendHeader("ETag", etag_{{this.dataname}});
+  #endif
+{{/case}}
+{{/switch}}
+
+{{#switch ../gzip}}
+{{#case "true"}}
+{{#if this.isGzip}}
+    server->sendHeader("Content-Encoding", "gzip");
+{{/if}}
+    server->setContentLength({{this.lengthGzip}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, datagzip_{{this.dataname}}, {{this.lengthGzip}});
+{{/case}}
+{{#case "false"}}
+    server->setContentLength({{this.length}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, data_{{this.dataname}}, {{this.length}});
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_GZIP
+{{#if this.isGzip}}
+    server->sendHeader("Content-Encoding", "gzip");
+{{/if}}
+    server->setContentLength({{this.lengthGzip}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, datagzip_{{this.dataname}}, {{this.lengthGzip}});
+  #else
+    server->setContentLength({{this.length}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, data_{{this.dataname}}, {{this.length}});
+  #endif
+{{/case}}
+{{/switch}}
+
+    {{../definePrefix}}_onFileServed("{{../basePath}}/{{this.filename}}", 200);
+  });
+  {{#if this.isDefault}}
+  server->on("{{#if ../basePath}}{{../basePath}}{{else}}/{{/if}}", HTTP_GET, [server]() {
+
+{{#switch ../etag}}
+{{#case "true"}}
+    if (server->hasHeader("If-None-Match") && server->header("If-None-Match").equals(etag_{{this.dataname}})) {
+      server->send(304);
+      {{../definePrefix}}_onFileServed("{{#if ../basePath}}{{../basePath}}{{else}}/{{/if}}", 304);
+      return;
+    }
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_ETAG
+    if (server->hasHeader("If-None-Match") && server->header("If-None-Match").equals(etag_{{this.dataname}})) {
+      server->send(304);
+      {{../definePrefix}}_onFileServed("{{#if ../basePath}}{{../basePath}}{{else}}/{{/if}}", 304);
+      return;
+    }
+  #endif
+{{/case}}
+{{/switch}}
+
+{{#switch ../etag}}
+{{#case "true"}}
+{{#../cacheTime}}
+    server->sendHeader("Cache-Control", "max-age={{value}}");
+{{/../cacheTime}}
+{{^../cacheTime}}
+    server->sendHeader("Cache-Control", "no-cache");
+{{/../cacheTime}}
+    server->sendHeader("ETag", etag_{{this.dataname}});
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_ETAG
+{{#../cacheTime}}
+    server->sendHeader("Cache-Control", "max-age={{value}}");
+{{/../cacheTime}}
+{{^../cacheTime}}
+    server->sendHeader("Cache-Control", "no-cache");
+{{/../cacheTime}}
+    server->sendHeader("ETag", etag_{{this.dataname}});
+  #endif
+{{/case}}
+{{/switch}}
+
+{{#switch ../gzip}}
+{{#case "true"}}
+{{#if this.isGzip}}
+    server->sendHeader("Content-Encoding", "gzip");
+{{/if}}
+    server->setContentLength({{this.lengthGzip}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, datagzip_{{this.dataname}}, {{this.lengthGzip}});
+{{/case}}
+{{#case "false"}}
+    server->setContentLength({{this.length}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, data_{{this.dataname}}, {{this.length}});
+{{/case}}
+{{#case "compiler"}}
+  #ifdef {{../definePrefix}}_ENABLE_GZIP
+{{#if this.isGzip}}
+    server->sendHeader("Content-Encoding", "gzip");
+{{/if}}
+    server->setContentLength({{this.lengthGzip}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, datagzip_{{this.dataname}}, {{this.lengthGzip}});
+  #else
+    server->setContentLength({{this.length}});
+    server->send(200, "{{this.mime}}", "");
+    {{../definePrefix}}_sendChunked(server, data_{{this.dataname}}, {{this.length}});
+  #endif
+{{/case}}
+{{/switch}}
+
+    {{../definePrefix}}_onFileServed("{{#if ../basePath}}{{../basePath}}{{else}}/{{/if}}", 200);
+  });
+  {{/if}}
+
 {{/each}}
 }`;
 const getTemplate = (engine) => {
@@ -502,6 +701,8 @@ const getTemplate = (engine) => {
             return asyncTemplate;
         case 'espidf':
             return cppCodeEspIdf_1.espidfTemplate;
+        case 'webserver':
+            return webserverTemplate;
         default:
             throw new Error(`Unknown engine: ${engine}`);
     }

package/dist/errorMessages.js

@@ -14,7 +14,8 @@ function getEngineName(engine) {
     const names = {
         psychic: 'PsychicHttpServer',
         async: 'ESPAsyncWebServer',
-        espidf: 'ESP-IDF'
+        espidf: 'ESP-IDF',
+        webserver: 'Arduino WebServer'
     };
     return names[engine] ?? engine;
 }
@@ -28,7 +29,10 @@ function getMissingIndexError(engine) {
   3. ESPAsyncWebServer uses: server.on("/", HTTP_GET, ...)`,
         espidf: `  1. Add an index.html file to your source directory
   2. The file will register both "/" and "/index.html" routes
-  3. ESP-IDF uses: httpd_register_uri_handler(server, &route_def_...)`
+  3. ESP-IDF uses: httpd_register_uri_handler(server, &route_def_...)`,
+        webserver: `  1. Add an index.html file to your source directory
+  2. The file will automatically create a "/" route handler
+  3. Arduino WebServer uses: server.on("/", HTTP_GET, handler)`
     };
     const hint = hints[engine] ?? hints['psychic'];
     return ((0, consoleColor_1.redLog)('[ERROR] No index.html or index.htm found in source files') +
@@ -53,6 +57,7 @@ Valid engines are:
   ${(0, consoleColor_1.cyanLog)('• psychic')}    - PsychicHttpServer (ESP32 only, fastest performance)
   ${(0, consoleColor_1.cyanLog)('• async')}      - ESPAsyncWebServer (ESP32/ESP8266 compatible)
   ${(0, consoleColor_1.cyanLog)('• espidf')}     - Native ESP-IDF web server (ESP32 only, no Arduino)
+  ${(0, consoleColor_1.cyanLog)('• webserver')}  - Arduino WebServer (ESP32, synchronous, built-in)
 
 How to fix:
   npx svelteesp32 --engine=psychic --sourcepath=./dist

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Convert Svelte (or any frontend) JS application to serve it from ESP32 webserver (PsychicHttp)",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -30,6 +30,7 @@
   "scripts": {
     "dev:async": "nodemon src/index.ts -- -e async -s ./demo/svelte/dist -o ./demo/esp32/include/svelteesp32.h --etag=true --gzip=true --cachetime=86400 --version=v$npm_package_version",
     "dev:psychic": "nodemon src/index.ts -- -e psychic -s ./demo/svelte/dist -o ./demo/esp32/include/svelteesp32.h --etag=false --gzip=false --version=v$npm_package_version",
+    "dev:webserver": "nodemon src/index.ts -- -e webserver -s ./demo/svelte/dist -o ./demo/esp32/include/svelteesp32.h --etag=true --gzip=true --cachetime=86400 --version=v$npm_package_version",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
@@ -58,18 +59,20 @@
     "espasyncwebserver"
   ],
   "devDependencies": {
+    "@eslint/eslintrc": "^3.3.4",
+    "@eslint/js": "^10.0.1",
     "@types/mime-types": "^3.0.1",
-    "@types/node": "^25.2.2",
+    "@types/node": "^25.3.2",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
-    "@typescript-eslint/parser": "^8.54.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
     "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^9.39.2",
+    "eslint": "^10.0.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
-    "eslint-plugin-unicorn": "^62.0.0",
+    "eslint-plugin-unicorn": "^63.0.0",
     "memfs": "^4.56.10",
-    "nodemon": "^3.1.11",
+    "nodemon": "^3.1.14",
     "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",