svelteesp32 1.15.0 → 1.16.1

package/README.md

@@ -75,7 +75,8 @@ void setup() {
 
 ## What's New
 
-- **v1.15.0** — `--base-path` for multiple frontends (e.g., `/admin`, `/app`)
+- **v1.16.0** — Size budget constraints (`--maxsize`, `--maxgzipsize`)
+- **v1.15.0** — `--basepath` for multiple frontends (e.g., `/admin`, `/app`)
 - **v1.13.0** — npm package variable interpolation in RC files
 - **v1.12.0** — RC file configuration support
 - **v1.11.0** — File exclusion patterns
@@ -301,10 +302,10 @@ Fine-tune how browsers cache your content:
 
 Your `index.html` is automatically served at the root URL — just like any web server. Visit `http://esp32.local/` and your app loads.
 
-**API-only projects?** Skip index validation with `--no-index-check`:
+**API-only projects?** Skip index validation with `--noindexcheck`:
 
 ```bash
-npx svelteesp32 -e psychic -s ./dist -o ./output.h --no-index-check
+npx svelteesp32 -e psychic -s ./dist -o ./output.h --noindexcheck
 ```
 
 ### File Exclusion
@@ -335,8 +336,8 @@ Excluded 3 file(s):
 Serve multiple web apps from one ESP32 using URL prefixes:
 
 ```bash
-npx svelteesp32 -s ./admin-dist -o ./admin.h --base-path=/admin
-npx svelteesp32 -s ./user-dist -o ./user.h --base-path=/app
+npx svelteesp32 -s ./admin-dist -o ./admin.h --basepath=/admin
+npx svelteesp32 -s ./user-dist -o ./user.h --basepath=/app
 ```
 
 ```c
@@ -402,22 +403,24 @@ 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/psychic2/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            |
-| `--base-path`      | URL prefix for all routes                         | (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`   |
-| `--no-index-check` | Skip index.html validation                        | `false`                 |
-| `-h`               | Show help                                         |                         |
+| Option           | Description                                       | Default                 |
+| ---------------- | ------------------------------------------------- | ----------------------- |
+| `-s`             | Source folder with compiled web files             | (required)              |
+| `-e`             | Web server engine (psychic/psychic2/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`   |
+| `--noindexcheck` | Skip index.html validation                        | `false`                 |
+| `-h`             | Show help                                         |                         |
 
 ---
 
@@ -432,7 +435,11 @@ Store your settings in `.svelteesp32rc.json` for zero-argument builds:
   "outputfile": "./esp32/svelteesp32.h",
   "etag": "true",
   "gzip": "true",
-  "exclude": ["*.map", "*.md"]
+  "exclude": ["*.map", "*.md"],
+  "basepath": "/ui",
+  "maxsize": "400k",
+  "maxgzipsize": "150k",
+  "noindexcheck": false
 }
 ```
 

package/dist/commandLine.d.ts

@@ -11,6 +11,8 @@ interface ICopyFilesArguments {
     version: string;
     exclude: string[];
     basePath: string;
+    maxSize?: number;
+    maxGzipSize?: number;
     noIndexCheck?: boolean;
     help?: boolean;
 }
@@ -26,11 +28,15 @@ interface IRcFileConfig {
     created?: boolean;
     version?: string;
     exclude?: string[];
-    basePath?: string;
+    basepath?: string;
+    maxsize?: number | string;
+    maxgzipsize?: number | string;
+    noindexcheck?: boolean;
 }
+declare function parseSize(value: string, name: string): number;
 declare function getNpmPackageVariable(packageJson: Record<string, unknown>, variableName: string): string | undefined;
 declare function hasNpmVariables(config: IRcFileConfig): boolean;
 declare function interpolateNpmVariables(config: IRcFileConfig, rcFilePath: string): IRcFileConfig;
-export { getNpmPackageVariable, hasNpmVariables, interpolateNpmVariables };
+export { getNpmPackageVariable, hasNpmVariables, interpolateNpmVariables, parseSize };
 export declare function formatConfiguration(cmdLine: ICopyFilesArguments): string;
 export declare const cmdLine: ICopyFilesArguments;

package/dist/commandLine.js

@@ -7,6 +7,7 @@ exports.cmdLine = void 0;
 exports.getNpmPackageVariable = getNpmPackageVariable;
 exports.hasNpmVariables = hasNpmVariables;
 exports.interpolateNpmVariables = interpolateNpmVariables;
+exports.parseSize = parseSize;
 exports.formatConfiguration = formatConfiguration;
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
@@ -34,7 +35,9 @@ Options:
   --cachetime <seconds>      max-age cache time in seconds (default: 0)
   --exclude <pattern>        Exclude files matching glob pattern (repeatable or comma-separated)
                              Examples: --exclude="*.map" --exclude="test/**/*.ts"
-  --base-path <path>         URL prefix for all routes (e.g., "/ui") (default: "")
+  --basepath <path>          URL prefix for all routes (e.g., "/ui") (default: "")
+  --maxsize <size>           Maximum total uncompressed size (e.g., 400k, 1.5m, 409600)
+  --maxgzipsize <size>       Maximum total gzip size (e.g., 150k, 1m, 153600)
   -h, --help                 Shows this help
 
 RC File:
@@ -49,7 +52,11 @@ RC File:
       "outputfile": "./output.h",
       "etag": "true",
       "gzip": "true",
-      "exclude": ["*.map", "*.md"]
+      "exclude": ["*.map", "*.md"],
+      "basepath": "/ui",
+      "maxsize": "400k",
+      "maxgzipsize": "150k",
+      "noindexcheck": false
     }
 
   CLI arguments override RC file values.
@@ -78,6 +85,25 @@ function validateBasePath(value) {
         throw new Error(`basePath must not contain //: ${value}`);
     return value;
 }
+function parseSize(value, name) {
+    const trimmed = value.trim();
+    const match = trimmed.match(/^(\d+(?:\.\d+)?)\s*([KMkm])?$/);
+    if (!match || !match[1])
+        throw new Error(`${name} must be a positive number with optional k/K (×1024) or m/M (×1024²) suffix: ${value}`);
+    const numericPart = Number.parseFloat(match[1]);
+    const suffix = match[2]?.toLowerCase();
+    let bytes;
+    if (suffix === 'k')
+        bytes = numericPart * 1024;
+    else if (suffix === 'm')
+        bytes = numericPart * 1024 * 1024;
+    else
+        bytes = numericPart;
+    bytes = Math.round(bytes);
+    if (bytes <= 0 || !Number.isFinite(bytes))
+        throw new Error(`${name} must be a positive integer: ${value}`);
+    return bytes;
+}
 const DEFAULT_EXCLUDE_PATTERNS = [
     '.DS_Store',
     'Thumbs.db',
@@ -148,7 +174,7 @@ function hasNpmVariables(config) {
         checkStringForNpmVariable(config.espmethod) ||
         checkStringForNpmVariable(config.define) ||
         checkStringForNpmVariable(config.version) ||
-        checkStringForNpmVariable(config.basePath) ||
+        checkStringForNpmVariable(config.basepath) ||
         (Array.isArray(config.exclude) && config.exclude.some((pattern) => checkStringForNpmVariable(pattern))) ||
         false);
 }
@@ -168,8 +194,8 @@ function interpolateNpmVariables(config, rcFilePath) {
             affectedFields.push('espmethod');
         if (config.define?.includes('$npm_package_'))
             affectedFields.push('define');
-        if (config.basePath?.includes('$npm_package_'))
-            affectedFields.push('basePath');
+        if (config.basepath?.includes('$npm_package_'))
+            affectedFields.push('basepath');
         if (config.exclude)
             for (const [index, pattern] of config.exclude.entries())
                 if (pattern.includes('$npm_package_'))
@@ -194,8 +220,8 @@ function interpolateNpmVariables(config, rcFilePath) {
         result.define = interpolateString(result.define);
     if (result.version)
         result.version = interpolateString(result.version);
-    if (result.basePath)
-        result.basePath = interpolateString(result.basePath);
+    if (result.basepath)
+        result.basepath = interpolateString(result.basepath);
     if (result.exclude)
         result.exclude = result.exclude.map((pattern) => interpolateString(pattern));
     return result;
@@ -229,7 +255,10 @@ function validateRcConfig(config, rcPath) {
         'created',
         'version',
         'exclude',
-        'basePath'
+        'basepath',
+        'maxsize',
+        'maxgzipsize',
+        'noindexcheck'
     ]);
     for (const key of Object.keys(configObject))
         if (!validKeys.has(key))
@@ -250,6 +279,32 @@ function validateRcConfig(config, rcPath) {
             if (typeof pattern !== 'string')
                 throw new TypeError('All exclude patterns must be strings');
     }
+    if (configObject['maxsize'] !== undefined) {
+        const value = configObject['maxsize'];
+        if (typeof value === 'string')
+            try {
+                configObject['maxsize'] = parseSize(value, 'maxsize');
+            }
+            catch {
+                throw new TypeError(`Invalid maxsize in RC file: ${value} (must be a positive number with optional k/m suffix)`);
+            }
+        else if (typeof value !== 'number' || Number.isNaN(value) || value <= 0)
+            throw new TypeError(`Invalid maxsize in RC file: ${value} (must be a positive number)`);
+    }
+    if (configObject['maxgzipsize'] !== undefined) {
+        const value = configObject['maxgzipsize'];
+        if (typeof value === 'string')
+            try {
+                configObject['maxgzipsize'] = parseSize(value, 'maxgzipsize');
+            }
+            catch {
+                throw new TypeError(`Invalid maxgzipsize in RC file: ${value} (must be a positive number with optional k/m suffix)`);
+            }
+        else if (typeof value !== 'number' || Number.isNaN(value) || value <= 0)
+            throw new TypeError(`Invalid maxgzipsize in RC file: ${value} (must be a positive number)`);
+    }
+    if (configObject['noindexcheck'] !== undefined && typeof configObject['noindexcheck'] !== 'boolean')
+        throw new TypeError(`Invalid noindexcheck in RC file: ${configObject['noindexcheck']} (must be boolean)`);
     return configObject;
 }
 function parseArguments() {
@@ -305,8 +360,14 @@ function parseArguments() {
         result.espmethod = rcConfig.espmethod;
     if (rcConfig.define)
         result.define = rcConfig.define;
-    if (rcConfig.basePath !== undefined)
-        result.basePath = validateBasePath(rcConfig.basePath);
+    if (rcConfig.basepath !== undefined)
+        result.basePath = validateBasePath(rcConfig.basepath);
+    if (rcConfig.maxsize !== undefined)
+        result.maxSize = rcConfig.maxsize;
+    if (rcConfig.maxgzipsize !== undefined)
+        result.maxGzipSize = rcConfig.maxgzipsize;
+    if (rcConfig.noindexcheck !== undefined)
+        result.noIndexCheck = rcConfig.noindexcheck;
     if (rcConfig.exclude && rcConfig.exclude.length > 0)
         result.exclude = [...rcConfig.exclude];
     const cliExclude = [];
@@ -363,9 +424,15 @@ function parseArguments() {
                     cliExclude.push(...patterns);
                     break;
                 }
-                case 'base-path':
+                case 'basepath':
                     result.basePath = validateBasePath(value);
                     break;
+                case 'maxsize':
+                    result.maxSize = parseSize(value, '--maxsize');
+                    break;
+                case 'maxgzipsize':
+                    result.maxGzipSize = parseSize(value, '--maxgzipsize');
+                    break;
                 default:
                     throw new Error(`Unknown flag: ${flag}`);
             }
@@ -375,7 +442,7 @@ function parseArguments() {
             result.created = true;
             continue;
         }
-        if (argument === '--no-index-check') {
+        if (argument === '--noindexcheck') {
             result.noIndexCheck = true;
             continue;
         }
@@ -458,10 +525,18 @@ function parseArguments() {
                     index++;
                     break;
                 }
-                case 'base-path':
+                case 'basepath':
                     result.basePath = validateBasePath(nextArgument);
                     index++;
                     break;
+                case 'maxsize':
+                    result.maxSize = parseSize(nextArgument, '--maxsize');
+                    index++;
+                    break;
+                case 'maxgzipsize':
+                    result.maxGzipSize = parseSize(nextArgument, '--maxgzipsize');
+                    index++;
+                    break;
                 default:
                     throw new Error(`Unknown flag: --${flag}`);
             }
@@ -496,6 +571,10 @@ function formatConfiguration(cmdLine) {
         parts.push(`define=${cmdLine.define}`);
     if (cmdLine.basePath)
         parts.push(`basePath=${cmdLine.basePath}`);
+    if (cmdLine.maxSize !== undefined)
+        parts.push(`maxSize=${cmdLine.maxSize}`);
+    if (cmdLine.maxGzipSize !== undefined)
+        parts.push(`maxGzipSize=${cmdLine.maxGzipSize}`);
     if (cmdLine.exclude.length > 0)
         parts.push(`exclude=[${cmdLine.exclude.join(', ')}]`);
     return parts.join(' ');

package/dist/errorMessages.d.ts

@@ -1,4 +1,5 @@
 export declare function getMissingIndexError(engine: string): string;
 export declare function getInvalidEngineError(attempted: string): string;
 export declare function getSourcepathNotFoundError(sourcepath: string, reason: 'not_found' | 'not_directory'): string;
+export declare function getSizeBudgetExceededError(type: 'size' | 'gzipSize', limit: number, actual: number): string;
 export declare function getMaxUriHandlersHint(engine: string, routeCount: number): string;

package/dist/errorMessages.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMissingIndexError = getMissingIndexError;
 exports.getInvalidEngineError = getInvalidEngineError;
 exports.getSourcepathNotFoundError = getSourcepathNotFoundError;
+exports.getSizeBudgetExceededError = getSizeBudgetExceededError;
 exports.getMaxUriHandlersHint = getMaxUriHandlersHint;
 const node_path_1 = __importDefault(require("node:path"));
 const consoleColor_1 = require("./consoleColor");
@@ -45,7 +46,7 @@ How to fix (for ${getEngineName(engine)}):
 ${hint}
 
 Alternative:
-  If you use a different entry point (e.g., main.html), you can add --no-index-check flag,
+  If you use a different entry point (e.g., main.html), you can add --noindexcheck flag,
   but users must navigate to http://your-esp32/main.html explicitly.`);
 }
 function getInvalidEngineError(attempted) {
@@ -109,6 +110,32 @@ How to fix:
 Current directory: ${currentDirectory}
 Attempted path: ${resolvedPath} (resolved)`);
 }
+function getSizeBudgetExceededError(type, limit, actual) {
+    const typeLabel = type === 'size' ? 'Uncompressed' : 'Gzip';
+    const flagName = type === 'size' ? '--maxsize' : '--maxgzipsize';
+    const overage = actual - limit;
+    const overagePercent = Math.round((overage / limit) * 100);
+    return ((0, consoleColor_1.redLog)(`[ERROR] ${typeLabel} size budget exceeded`) +
+        `
+
+Budget:   ${limit.toLocaleString()} bytes
+Actual:   ${actual.toLocaleString()} bytes
+Overage:  ${overage.toLocaleString()} bytes (+${overagePercent}%)
+
+Why this matters:
+  Size budgets help prevent frontend bloat and ensure your application
+  fits within ESP32 flash memory constraints.
+
+How to fix:
+  1. Reduce bundle size (tree-shaking, code splitting, smaller dependencies)
+  2. Optimize assets (compress images, minify CSS/JS)
+  3. Remove unused files with --exclude patterns
+  4. Increase the budget: ${flagName}=${actual}
+
+CI integration:
+  This non-zero exit code allows build pipelines to fail early when
+  the frontend exceeds allocated flash space.`);
+}
 function getMaxUriHandlersHint(engine, routeCount) {
     const recommended = routeCount + 5;
     const hints = {

package/dist/index.js

@@ -84,6 +84,14 @@ for (const [originalFilename, content] of files) {
 }
 console.log('');
 filesByExtension.sort((left, right) => left.extension.localeCompare(right.extension));
+if (commandLine_1.cmdLine.maxSize !== undefined && summary.size > commandLine_1.cmdLine.maxSize) {
+    console.error((0, errorMessages_1.getSizeBudgetExceededError)('size', commandLine_1.cmdLine.maxSize, summary.size));
+    process.exit(1);
+}
+if (commandLine_1.cmdLine.maxGzipSize !== undefined && summary.gzipsize > commandLine_1.cmdLine.maxGzipSize) {
+    console.error((0, errorMessages_1.getSizeBudgetExceededError)('gzipSize', commandLine_1.cmdLine.maxGzipSize, summary.gzipsize));
+    process.exit(1);
+}
 const cppFile = (0, cppCode_1.getCppCode)(sources, filesByExtension);
 (0, node_fs_1.mkdirSync)(node_path_1.default.normalize(node_path_1.default.dirname(commandLine_1.cmdLine.outputfile)), { recursive: true });
 (0, node_fs_1.writeFileSync)(commandLine_1.cmdLine.outputfile, cppFile, { flush: true, encoding: 'utf8' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "description": "Convert Svelte (or any frontend) JS application to serve it from ESP32 webserver (PsychicHttp)",
   "author": "BCsabaEngine",
   "license": "ISC",