svelteesp32 3.0.0 → 3.0.2

package/README.md

@@ -88,7 +88,7 @@ void setup() {
 
 ## What's New
 
-- **v3.0.0** — **Vite plugin** (`import { svelteESP32 } from 'svelteesp32/vite'`) generates the header automatically after every build; `npx svelteesp32 init` interactive RC file wizard; Node.js >= 22 required
+- **v3.0.0** — **Vite plugin** (`import { svelteESP32 } from 'svelteesp32/vite'`) generates the header automatically after every build — call with no argument for RC file mode or pass an options object for plugin-options mode; `npx svelteesp32 init` interactive RC file wizard; Node.js >= 22 required
 - **v2.4.0** — `--analyze` for CI size budget checks (per-file table, exits 1 on over-budget); `--manifest` to write a companion JSON manifest alongside the header
 - **v2.3.0** — `--cachetime-html` and `--cachetime-assets` for per-type cache control (e.g. `no-cache` for HTML, 1-year for content-hashed JS/CSS)
 - **v2.2.0** — SPA routing catch-all (`--spa`) for client-side routers on all four engines
@@ -132,13 +132,27 @@ It asks for engine, source path, output path, and ETag preference, writes the RC
 
 For Vite-based projects (SvelteKit, React, Vue, Vanilla) you can skip the manual CLI step entirely — the plugin hooks into the build pipeline and regenerates the C++ header automatically after every `vite build`.
 
-**`vite.config.ts`**
+The plugin has two exclusive modes — pick one:
+
+**RC file mode** — call with no argument (or a string path to a custom RC file). All settings come from `.svelteesp32rc.json`; `outputfile` in the RC file is required.
 
 ```ts
 import { svelteKit } from '@sveltejs/kit/vite';
 import { svelteESP32 } from 'svelteesp32/vite';
 import { defineConfig } from 'vite';
 
+export default defineConfig({
+  plugins: [
+    svelteKit(),
+    svelteESP32() // auto-discover .svelteesp32rc.json
+    // svelteESP32('/path/to/custom.rc.json')  // or specify path explicitly
+  ]
+});
+```
+
+**Plugin options mode** — call with an options object. The RC file is completely ignored; `output` is required.
+
+```ts
 export default defineConfig({
   plugins: [
     svelteKit(),
@@ -147,27 +161,27 @@ export default defineConfig({
       engine: 'psychic',
       etag: 'always',
       gzip: 'always',
-      cachetimeHtml: 0,
-      cachetimeAssets: 31536000
+      cachetimehtml: 0,
+      cachetimeassets: 31536000
     })
   ]
 });
 ```
 
-The `output` path is required; all other options mirror the CLI flags and have the same defaults. `sourcepath` defaults to Vite's `build.outDir` when omitted.
+`sourcepath` defaults to Vite's `build.outDir` in both modes.
 
 **Plugin options**
 
 | Option            | Type                                        | Default                   | Description                                        |
 | ----------------- | ------------------------------------------- | ------------------------- | -------------------------------------------------- |
-| `output`          | `string`                                    | (required)                | Output `.h` file path                              |
+| `output`          | `string`                                    | RC `outputfile`           | Output `.h` file path                              |
 | `sourcepath`      | `string`                                    | Vite's `build.outDir`     | Source directory (compiled web files)              |
 | `engine`          | `'psychic'\|'async'\|'espidf'\|'webserver'` | `'psychic'`               | Target web server engine                           |
 | `etag`            | `'always'\|'never'\|'compiler'`             | `'never'`                 | ETag generation mode                               |
 | `gzip`            | `'always'\|'never'\|'compiler'`             | `'always'`                | Gzip compression mode                              |
 | `cachetime`       | `number`                                    | `0`                       | `Cache-Control: max-age` in seconds (all files)    |
-| `cachetimeHtml`   | `number`                                    | (unset)                   | max-age for HTML files (overrides `cachetime`)     |
-| `cachetimeAssets` | `number`                                    | (unset)                   | max-age for non-HTML files (overrides `cachetime`) |
+| `cachetimehtml`   | `number`                                    | (unset)                   | max-age for HTML files (overrides `cachetime`)     |
+| `cachetimeassets` | `number`                                    | (unset)                   | max-age for non-HTML files (overrides `cachetime`) |
 | `exclude`         | `string[]`                                  | `[]`                      | Glob patterns to exclude                           |
 | `basepath`        | `string`                                    | (none)                    | URL prefix for all routes                          |
 | `espmethod`       | `string`                                    | `'initSvelteStaticFiles'` | Generated init function name                       |
@@ -176,9 +190,9 @@ The `output` path is required; all other options mirror the CLI flags and have t
 | `created`         | `boolean`                                   | `false`                   | Include creation timestamp                         |
 | `spa`             | `boolean`                                   | `false`                   | Serve `index.html` for unmatched routes            |
 | `manifest`        | `boolean`                                   | `false`                   | Write companion `.manifest.json`                   |
-| `noIndexCheck`    | `boolean`                                   | `false`                   | Skip `index.html` validation                       |
-| `maxSize`         | `number`                                    | (none)                    | Max total uncompressed size in bytes               |
-| `maxGzipSize`     | `number`                                    | (none)                    | Max total gzip size in bytes                       |
+| `noindexcheck`    | `boolean`                                   | `false`                   | Skip `index.html` validation                       |
+| `maxsize`         | `number`                                    | (none)                    | Max total uncompressed size in bytes               |
+| `maxgzipsize`     | `number`                                    | (none)                    | Max total gzip size in bytes                       |
 
 ### Generate Header File (CLI)
 

package/dist/commandLine.d.ts

@@ -21,8 +21,9 @@ export interface ICopyFilesArguments {
     spa?: boolean;
     manifest?: boolean;
     help?: boolean;
+    configSource: 'cli' | 'rcfile' | 'vite';
 }
-interface IRcFileConfig {
+export interface IRcFileConfig {
     engine?: 'psychic' | 'async' | 'espidf' | 'webserver';
     sourcepath?: string;
     outputfile?: string;
@@ -46,11 +47,12 @@ interface IRcFileConfig {
     manifest?: boolean | 'true' | 'false';
 }
 declare function validateCppIdentifier(value: string, name: string): string;
+export declare function validateBasePath(value: string): string;
 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 declare function loadRcFileConfig(configPath?: string): Partial<IRcFileConfig>;
+export declare function parseArguments(): ICopyFilesArguments;
 export { getNpmPackageVariable, hasNpmVariables, interpolateNpmVariables, parseSize, validateCppIdentifier };
 export declare function formatConfiguration(cmdLine: ICopyFilesArguments): string;
-export declare const cmdLine: ICopyFilesArguments;
-//# sourceMappingURL=commandLine.d.ts.map

package/dist/commandLine.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cmdLine = void 0;
+exports.validateBasePath = validateBasePath;
+exports.loadRcFileConfig = loadRcFileConfig;
+exports.parseArguments = parseArguments;
 exports.getNpmPackageVariable = getNpmPackageVariable;
 exports.hasNpmVariables = hasNpmVariables;
 exports.interpolateNpmVariables = interpolateNpmVariables;
@@ -255,6 +257,12 @@ function loadRcFile(rcPath) {
         throw error;
     }
 }
+function loadRcFileConfig(configPath) {
+    const rcPath = findRcFile(configPath);
+    if (!rcPath)
+        return {};
+    return loadRcFile(rcPath);
+}
 function validateSizeOption(configObject, key) {
     const value = configObject[key];
     if (value === undefined)
@@ -404,7 +412,8 @@ function parseArguments() {
         define: 'SVELTEESP32',
         cachetime: 0,
         exclude: [],
-        basePath: ''
+        basePath: '',
+        configSource: 'cli'
     };
     if (rcConfig.engine)
         result.engine = rcConfig.engine;
@@ -525,8 +534,10 @@ function parseArguments() {
         const argument = arguments_[index];
         if (!argument)
             continue;
-        if (argument === '--help' || argument === '-h')
+        if (argument === '--help' || argument === '-h') {
             showHelp();
+            return result;
+        }
         if (argument.startsWith('--') && argument.includes('=')) {
             const parts = argument.split('=');
             const flag = parts[0];
@@ -605,10 +616,12 @@ function parseArguments() {
     return result;
 }
 function formatConfiguration(cmdLine) {
+    const relativeOutput = node_path_1.default.relative(process.cwd(), cmdLine.outputfile);
     const parts = [
+        `source=${cmdLine.configSource}`,
         `engine=${cmdLine.engine}`,
         `sourcepath=${cmdLine.sourcepath}`,
-        `outputfile=${cmdLine.outputfile}`,
+        `outputfile=${relativeOutput}`,
         `etag=${cmdLine.etag}`,
         `gzip=${cmdLine.gzip}`,
         `cachetime=${cmdLine.cachetime}`
@@ -639,13 +652,3 @@ function formatConfiguration(cmdLine) {
         parts.push(`exclude=[${cmdLine.exclude.join(', ')}]`);
     return parts.join(' ').replace(/[\n\r]/g, ' ');
 }
-exports.cmdLine = parseArguments();
-if (!(0, node_fs_1.existsSync)(exports.cmdLine.sourcepath)) {
-    console.error((0, errorMessages_1.getSourcepathNotFoundError)(exports.cmdLine.sourcepath, 'not_found'));
-    process.exit(1);
-}
-if (!(0, node_fs_1.statSync)(exports.cmdLine.sourcepath).isDirectory()) {
-    console.error((0, errorMessages_1.getSourcepathNotFoundError)(exports.cmdLine.sourcepath, 'not_directory'));
-    process.exit(1);
-}
-console.log(`[SvelteESP32] Generate code for ${exports.cmdLine.engine} engine`);

package/dist/consoleColor.d.ts

@@ -2,4 +2,3 @@ export declare const greenLog: (s: string) => string;
 export declare const yellowLog: (s: string) => string;
 export declare const redLog: (s: string) => string;
 export declare const cyanLog: (s: string) => string;
-//# sourceMappingURL=consoleColor.d.ts.map

package/dist/cppCode.d.ts

@@ -1,3 +1,4 @@
+import type { ICopyFilesArguments } from './commandLine';
 export type CppCodeSource = {
     filename: string;
     dataname: string;
@@ -14,5 +15,4 @@ export type ExtensionGroup = {
     count: number;
 };
 export type ExtensionGroups = ExtensionGroup[];
-export declare const getCppCode: (sources: CppCodeSources, filesByExtension: ExtensionGroups) => string;
-//# sourceMappingURL=cppCode.d.ts.map
+export declare const getCppCode: (sources: CppCodeSources, filesByExtension: ExtensionGroups, options: ICopyFilesArguments) => string;

package/dist/cppCode.js

@@ -1010,17 +1010,17 @@ const createHandlebarsHelpers = () => {
         }
     };
 };
-const getCppCode = (sources, filesByExtension) => {
-    const template = (0, handlebars_1.compile)(getTemplate(commandLine_1.cmdLine.engine));
+const getCppCode = (sources, filesByExtension, options) => {
+    const template = (0, handlebars_1.compile)(getTemplate(options.engine));
     const transformedSources = sources.map((s) => {
         const effectiveCacheTime = s.mime === 'text/html'
-            ? (commandLine_1.cmdLine.cachetimeHtml ?? commandLine_1.cmdLine.cachetime)
-            : (commandLine_1.cmdLine.cachetimeAssets ?? commandLine_1.cmdLine.cachetime);
-        return transformSourceToTemplateData(s, commandLine_1.cmdLine.etag, effectiveCacheTime);
+            ? (options.cachetimeHtml ?? options.cachetime)
+            : (options.cachetimeAssets ?? options.cachetime);
+        return transformSourceToTemplateData(s, options.etag, effectiveCacheTime);
     });
-    const spaSource = commandLine_1.cmdLine.spa ? transformedSources.find((s) => s.isDefault) : undefined;
+    const spaSource = options.spa ? transformedSources.find((s) => s.isDefault) : undefined;
     const templateData = {
-        config: (0, commandLine_1.formatConfiguration)(commandLine_1.cmdLine),
+        config: (0, commandLine_1.formatConfiguration)(options),
         now: (() => {
             const d = new Date();
             return `${d.toLocaleDateString()} ${d.toLocaleTimeString()}`;
@@ -1030,16 +1030,16 @@ const getCppCode = (sources, filesByExtension) => {
         fileGzipSize: sources.reduce((previous, current) => previous + current.contentGzip.length, 0).toString(),
         sources: transformedSources,
         filesByExtension,
-        etag: commandLine_1.cmdLine.etag,
-        gzip: commandLine_1.cmdLine.gzip,
-        created: commandLine_1.cmdLine.created,
-        version: commandLine_1.cmdLine.version,
-        methodName: commandLine_1.cmdLine.espmethod,
-        definePrefix: commandLine_1.cmdLine.define,
-        basePath: commandLine_1.cmdLine.basePath,
-        spa: !!commandLine_1.cmdLine.spa,
+        etag: options.etag,
+        gzip: options.gzip,
+        created: options.created,
+        version: options.version,
+        methodName: options.espmethod,
+        definePrefix: options.define,
+        basePath: options.basePath,
+        spa: !!options.spa,
         spaSource,
-        isPsychic: commandLine_1.cmdLine.engine === 'psychic',
+        isPsychic: options.engine === 'psychic',
         maxUriHandlers: (sources.length + 5).toString()
     };
     const rawCode = template(templateData, { helpers: createHandlebarsHelpers() });

package/dist/cppCodeEspIdf.d.ts

@@ -1,2 +1 @@
 export declare const espidfTemplate = "\n//engine:   espidf\n//config:   {{{config}}}\n{{#if created }}\n//created:  {{now}}\n{{/if}}\n//\n\n{{#switch etag}}\n{{#case \"always\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"never\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n{{#switch gzip}}\n{{#case \"always\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"never\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n//\n{{#if version }}\n#define {{definePrefix}}_VERSION \"{{version}}\"\n{{/if}}\n#define {{definePrefix}}_COUNT {{fileCount}}\n#define {{definePrefix}}_SIZE {{fileSize}}\n#define {{definePrefix}}_SIZE_GZIP {{fileGzipSize}}\n\n//\n{{#each sources}}\n#define {{../definePrefix}}_FILE_{{this.datanameUpperCase}}\n{{/each}}\n\n//\n{{#each filesByExtension}}\n#define {{../definePrefix}}_{{this.extension}}_FILES {{this.count}}\n{{/each}}\n\n#include <stdint.h>\n#include <string.h>\n#include <stdlib.h>\n#include <esp_err.h>\n#include <esp_http_server.h>\n\n//\n{{#switch gzip}}\n{{#case \"always\"}}\n  {{#each sources}}\nstatic const unsigned char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n{{/case}}\n{{#case \"never\"}}\n  {{#each sources}}\nstatic const unsigned char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n  {{#each sources}}\nstatic const unsigned char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n#else\n  {{#each sources}}\nstatic const unsigned char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n#endif \n{{/case}}\n{{/switch}}\n\n//\n{{#switch etag}}\n{{#case \"always\"}}\n  {{#each sources}}\nstatic const char etag_{{this.dataname}}[] = \"{{this.sha256}}\";\n  {{/each}}\n{{/case}}\n{{#case \"never\"}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n  {{#each sources}}\nstatic const char etag_{{this.dataname}}[] = \"{{this.sha256}}\";\n  {{/each}}\n#endif\n{{/case}}\n{{/switch}}\n\n// File manifest struct (C-compatible typedef)\ntypedef struct {\n  const char* path;\n  uint32_t size;\n  uint32_t gzipSize;\n  const char* etag;\n  const char* contentType;\n} {{definePrefix}}_FileInfo;\n\n// File manifest array\nstatic const {{definePrefix}}_FileInfo {{definePrefix}}_FILES[] = {\n{{#each sources}}\n  { \"{{../basePath}}/{{this.filename}}\", {{this.length}}, {{this.gzipSizeForManifest}}, {{this.etagForManifest}}, \"{{this.mime}}\" },\n{{/each}}\n};\nstatic const size_t {{definePrefix}}_FILE_COUNT = sizeof({{definePrefix}}_FILES) / sizeof({{definePrefix}}_FILES[0]);\n\n// File served hook - override with your own implementation\n__attribute__((weak)) void {{definePrefix}}_onFileServed(const char* path, int statusCode) {}\n\n{{#each sources}}\n\nstatic esp_err_t file_handler_{{this.datanameUpperCase}} (httpd_req_t *req)\n{\n{{#switch ../etag}}\n{{#case \"always\"}}\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (hdr_value == NULL) { httpd_resp_send_500(req); return ESP_FAIL; }\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                {{../definePrefix}}_onFileServed(\"{{../basePath}}/{{this.filename}}\", 304);\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (hdr_value == NULL) { httpd_resp_send_500(req); return ESP_FAIL; }\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                {{../definePrefix}}_onFileServed(\"{{../basePath}}/{{this.filename}}\", 304);\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n  #endif\n{{/case}}\n{{/switch}}\n    httpd_resp_set_type(req, \"{{this.mime}}\");\n{{#switch ../gzip}}\n{{#case \"always\"}}\n{{#if this.isGzip}}\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n{{/if}}\n{{/case}}\n{{#case \"compiler\"}}\n  {{#if this.isGzip}}\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n  #endif \n  {{/if}}\n{{/case}}\n{{/switch}}\n\n{{#switch ../etag}}\n{{#case \"always\"}}\n{{#this.cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/this.cacheTime}}\n{{^this.cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/this.cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n{{#this.cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/this.cacheTime}}\n{{^this.cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/this.cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n  #endif \n{{/case}}\n{{/switch}}\n\n{{#switch ../gzip}}\n{{#case \"always\"}}\n    {{../definePrefix}}_onFileServed(\"{{../basePath}}/{{this.filename}}\", 200);\n    httpd_resp_send(req, (const char *)datagzip_{{this.dataname}}, {{this.lengthGzip}});\n{{/case}}\n{{#case \"never\"}}\n    {{../definePrefix}}_onFileServed(\"{{../basePath}}/{{this.filename}}\", 200);\n    httpd_resp_send(req, (const char *)data_{{this.dataname}}, {{this.length}});\n{{/case}}\n{{#case \"compiler\"}}\n    {{../definePrefix}}_onFileServed(\"{{../basePath}}/{{this.filename}}\", 200);\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_send(req, (const char *)datagzip_{{this.dataname}}, {{this.lengthGzip}});\n  #else\n    httpd_resp_send(req, (const char *)data_{{this.dataname}}, {{this.length}});\n  #endif\n{{/case}}\n{{/switch}}\n    return ESP_OK;\n}\n\n{{#if this.isDefault}}\nstatic const httpd_uri_t route_def_{{this.datanameUpperCase}} = {\n    .uri = \"{{#if ../basePath}}{{../basePath}}{{else}}/{{/if}}\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n{{/if}}\n\nstatic const httpd_uri_t route_{{this.datanameUpperCase}} = {\n    .uri = \"{{../basePath}}/{{this.filename}}\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n\n{{/each}}\n\n{{#if spa}}\n{{#with spaSource}}\nstatic esp_err_t spa_handler_{{this.datanameUpperCase}}(httpd_req_t *req, httpd_err_code_t err) {\n{{#if ../basePath}}\n    const char* prefix = \"{{../basePath}}/\";\n    if (strncmp(req->uri, prefix, strlen(prefix)) != 0 && strcmp(req->uri, \"{{../basePath}}\") != 0) {\n        httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, \"Not found\");\n        return ESP_FAIL;\n    }\n{{/if}}\n    return file_handler_{{this.datanameUpperCase}}(req);\n}\n{{/with}}\n{{/if}}\n\n\nstatic inline void {{methodName}}(httpd_handle_t server) {\n{{#each sources}}\n{{#if this.isDefault}}\n    httpd_register_uri_handler(server, &route_def_{{this.datanameUpperCase}});\n{{/if}}\n    httpd_register_uri_handler(server, &route_{{this.datanameUpperCase}});\n{{/each}}\n{{#if spa}}\n{{#with spaSource}}\n    httpd_register_err_handler(server, HTTPD_404_NOT_FOUND, spa_handler_{{this.datanameUpperCase}});\n{{/with}}\n{{/if}}\n\n}";
-//# sourceMappingURL=cppCodeEspIdf.d.ts.map

package/dist/errorMessages.d.ts

@@ -3,4 +3,3 @@ 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, espmethod?: string): string;
-//# sourceMappingURL=errorMessages.d.ts.map

package/dist/file.d.ts

@@ -4,4 +4,3 @@ export type FileData = {
     hash: string;
 };
 export declare const getFiles: (options: Pick<ICopyFilesArguments, "sourcepath" | "exclude" | "noIndexCheck" | "engine">) => Map<string, FileData>;
-//# sourceMappingURL=file.d.ts.map

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 export declare function main(): void;
 export { calculateCompressionRatio, createSourceEntry, formatAnalyzeTable, formatChangeSummary, formatCompressionLog, formatDryRunRoutes, formatSize, formatSizePrecise, type PreviousManifestFile, shouldUseGzip, updateExtensionGroup } from './pipeline';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,11 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateExtensionGroup = exports.shouldUseGzip = exports.formatSizePrecise = exports.formatSize = exports.formatDryRunRoutes = exports.formatCompressionLog = exports.formatChangeSummary = exports.formatAnalyzeTable = exports.createSourceEntry = exports.calculateCompressionRatio = void 0;
 exports.main = main;
+const node_fs_1 = require("node:fs");
 const commandLine_1 = require("./commandLine");
+const errorMessages_1 = require("./errorMessages");
 const pipeline_1 = require("./pipeline");
 function main() {
+    const cmdLine = (0, commandLine_1.parseArguments)();
+    if (!(0, node_fs_1.existsSync)(cmdLine.sourcepath)) {
+        console.error((0, errorMessages_1.getSourcepathNotFoundError)(cmdLine.sourcepath, 'not_found'));
+        process.exit(1);
+    }
+    if (!(0, node_fs_1.statSync)(cmdLine.sourcepath).isDirectory()) {
+        console.error((0, errorMessages_1.getSourcepathNotFoundError)(cmdLine.sourcepath, 'not_directory'));
+        process.exit(1);
+    }
+    console.log(`[SvelteESP32] Generate code for ${cmdLine.engine} engine`);
     try {
-        (0, pipeline_1.runPipeline)(commandLine_1.cmdLine);
+        (0, pipeline_1.runPipeline)(cmdLine);
     }
     catch (error) {
         if (!(error instanceof pipeline_1.OverBudgetError)) {

package/dist/initCommand.d.ts

@@ -1,2 +1 @@
 export declare function runInit(): Promise<void>;
-//# sourceMappingURL=initCommand.d.ts.map

package/dist/pipeline.d.ts

@@ -26,4 +26,3 @@ export declare class OverBudgetError extends Error {
 declare const formatChangeSummary: (sources: CppCodeSources, previousFiles: PreviousManifestFile[]) => string;
 export declare function runPipeline(options: ICopyFilesArguments): void;
 export { calculateCompressionRatio, createSourceEntry, formatAnalyzeTable, formatChangeSummary, formatCompressionLog, formatDryRunRoutes, formatSize, formatSizePrecise, shouldUseGzip, updateExtensionGroup };
-//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.js

@@ -181,6 +181,8 @@ function runPipeline(options) {
     };
     const sources = [];
     const filesByExtension = [];
+    const sourceLabels = { cli: 'command line', rcfile: 'RC file', vite: 'vite plugin' };
+    console.log(`Config source: ${sourceLabels[options.configSource]}`);
     console.log('Collecting source files');
     const files = (0, file_1.getFiles)(options);
     if (files.size === 0)
@@ -237,7 +239,7 @@ function runPipeline(options) {
         console.log(formatDryRunRoutes(sources, options.engine, options.basePath, options.spa ?? false));
         return;
     }
-    const cppFile = (0, cppCode_1.getCppCode)(sources, filesByExtension);
+    const cppFile = (0, cppCode_1.getCppCode)(sources, filesByExtension, options);
     (0, node_fs_1.mkdirSync)(node_path_1.default.normalize(node_path_1.default.dirname(options.outputfile)), { recursive: true });
     (0, node_fs_1.writeFileSync)(options.outputfile, cppFile, { flush: true, encoding: 'utf8' });
     console.log(`${summary.filecount} files, ${formatSize(summary.size)} original size, ${formatSize(summary.gzipsize)} gzip size`);

package/dist/vitePlugin.d.ts

@@ -9,14 +9,14 @@ interface VitePlugin {
     closeBundle: () => void;
 }
 export interface SvelteESP32PluginOptions {
-    output: string;
+    output?: string;
     sourcepath?: string;
     engine?: 'psychic' | 'async' | 'espidf' | 'webserver';
     etag?: 'always' | 'never' | 'compiler';
     gzip?: 'always' | 'never' | 'compiler';
     cachetime?: number;
-    cachetimeHtml?: number;
-    cachetimeAssets?: number;
+    cachetimehtml?: number;
+    cachetimeassets?: number;
     exclude?: string[];
     basepath?: string;
     espmethod?: string;
@@ -25,10 +25,9 @@ export interface SvelteESP32PluginOptions {
     created?: boolean;
     spa?: boolean;
     manifest?: boolean;
-    noIndexCheck?: boolean;
-    maxSize?: number;
-    maxGzipSize?: number;
+    noindexcheck?: boolean;
+    maxsize?: number;
+    maxgzipsize?: number;
 }
-export declare function svelteESP32(options: SvelteESP32PluginOptions): VitePlugin;
+export declare function svelteESP32(optionsOrRcPath?: SvelteESP32PluginOptions | string): VitePlugin;
 export {};
-//# sourceMappingURL=vitePlugin.d.ts.map

package/dist/vitePlugin.js

@@ -5,8 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.svelteESP32 = svelteESP32;
 const node_path_1 = __importDefault(require("node:path"));
+const commandLine_1 = require("./commandLine");
 const pipeline_1 = require("./pipeline");
-function svelteESP32(options) {
+function coerceBool(value) {
+    if (value === undefined)
+        return undefined;
+    return value === true || value === 'true';
+}
+function svelteESP32(optionsOrRcPath) {
     let outDirectory = 'dist';
     return {
         name: 'svelteesp32',
@@ -14,42 +20,72 @@ function svelteESP32(options) {
             outDirectory = config.build.outDir;
         },
         closeBundle() {
-            const sourcepath = options.sourcepath ?? outDirectory;
-            const outputfile = node_path_1.default.resolve(options.output);
-            if (options.basepath !== undefined) {
-                const bp = options.basepath;
-                if (bp !== '' && !bp.startsWith('/'))
-                    throw new Error(`basePath must start with /: ${bp}`);
-                if (bp.endsWith('/'))
-                    throw new Error(`basePath must not end with /: ${bp}`);
-                if (bp.includes('//'))
-                    throw new Error(`basePath must not contain //: ${bp}`);
-                if (bp.includes('"'))
-                    throw new Error(`basePath must not contain double quotes: ${bp}`);
-                if (bp.includes('\\'))
-                    throw new Error(`basePath must not contain backslashes: ${bp}`);
+            let options_;
+            if (optionsOrRcPath === undefined || typeof optionsOrRcPath === 'string') {
+                const rcPath = optionsOrRcPath;
+                const rcConfig = (0, commandLine_1.loadRcFileConfig)(rcPath);
+                const rawOutput = rcConfig.outputfile;
+                if (!rawOutput)
+                    throw new Error('output is required — specify outputfile in the RC file (.svelteesp32rc.json)');
+                const outputfile = node_path_1.default.resolve(rawOutput);
+                const sourcepath = rcConfig.sourcepath ?? outDirectory;
+                const rawBasepath = rcConfig.basepath ?? '';
+                const basePath = (0, commandLine_1.validateBasePath)(rawBasepath);
+                options_ = {
+                    configSource: 'rcfile',
+                    engine: rcConfig.engine ?? 'psychic',
+                    sourcepath,
+                    outputfile,
+                    etag: rcConfig.etag ?? 'never',
+                    gzip: rcConfig.gzip ?? 'always',
+                    cachetime: rcConfig.cachetime ?? 0,
+                    cachetimeHtml: rcConfig.cachetimehtml,
+                    cachetimeAssets: rcConfig.cachetimeassets,
+                    created: coerceBool(rcConfig.created) ?? false,
+                    version: rcConfig.version ?? '',
+                    espmethod: rcConfig.espmethod ?? 'initSvelteStaticFiles',
+                    define: rcConfig.define ?? 'SVELTEESP32',
+                    exclude: rcConfig.exclude ?? [],
+                    basePath,
+                    noIndexCheck: coerceBool(rcConfig.noindexcheck),
+                    spa: coerceBool(rcConfig.spa),
+                    manifest: coerceBool(rcConfig.manifest),
+                    maxSize: rcConfig.maxsize,
+                    maxGzipSize: rcConfig.maxgzipsize
+                };
+            }
+            else {
+                const options = optionsOrRcPath;
+                const rawOutput = options.output;
+                if (!rawOutput)
+                    throw new Error('output is required — specify it as a plugin option or use svelteESP32() for RC file mode');
+                const outputfile = node_path_1.default.resolve(rawOutput);
+                const sourcepath = options.sourcepath ?? outDirectory;
+                const rawBasepath = options.basepath ?? '';
+                const basePath = (0, commandLine_1.validateBasePath)(rawBasepath);
+                options_ = {
+                    configSource: 'vite',
+                    engine: options.engine ?? 'psychic',
+                    sourcepath,
+                    outputfile,
+                    etag: options.etag ?? 'never',
+                    gzip: options.gzip ?? 'always',
+                    cachetime: options.cachetime ?? 0,
+                    cachetimeHtml: options.cachetimehtml,
+                    cachetimeAssets: options.cachetimeassets,
+                    created: options.created ?? false,
+                    version: options.version ?? '',
+                    espmethod: options.espmethod ?? 'initSvelteStaticFiles',
+                    define: options.define ?? 'SVELTEESP32',
+                    exclude: options.exclude ?? [],
+                    basePath,
+                    noIndexCheck: options.noindexcheck,
+                    spa: options.spa,
+                    manifest: options.manifest,
+                    maxSize: options.maxsize,
+                    maxGzipSize: options.maxgzipsize
+                };
             }
-            const options_ = {
-                engine: options.engine ?? 'psychic',
-                sourcepath,
-                outputfile,
-                etag: options.etag ?? 'never',
-                gzip: options.gzip ?? 'always',
-                cachetime: options.cachetime ?? 0,
-                cachetimeHtml: options.cachetimeHtml,
-                cachetimeAssets: options.cachetimeAssets,
-                created: options.created ?? false,
-                version: options.version ?? '',
-                espmethod: options.espmethod ?? 'initSvelteStaticFiles',
-                define: options.define ?? 'SVELTEESP32',
-                exclude: options.exclude ?? [],
-                basePath: options.basepath ?? '',
-                noIndexCheck: options.noIndexCheck,
-                spa: options.spa,
-                manifest: options.manifest,
-                maxSize: options.maxSize,
-                maxGzipSize: options.maxGzipSize
-            };
             (0, pipeline_1.runPipeline)(options_);
         }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Convert Svelte (or any frontend) JS application to serve it from ESP32 webserver (PsychicHttp)",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -11,6 +11,7 @@
     },
     "./vite": {
       "types": "./dist/vitePlugin.d.ts",
+      "require": "./dist/vitePlugin.js",
       "default": "./dist/vitePlugin.js"
     }
   },
@@ -73,8 +74,8 @@
     "@types/mime-types": "^3.0.1",
     "@types/node": "^25.6.0",
     "@types/picomatch": "^4.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.59.1",
-    "@typescript-eslint/parser": "^8.59.1",
+    "@typescript-eslint/eslint-plugin": "^8.59.2",
+    "@typescript-eslint/parser": "^8.59.2",
     "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^10.3.0",
     "eslint-config-prettier": "^10.1.8",