svelteesp32 3.0.1 → 3.0.2

package/README.md

@@ -88,8 +88,7 @@ void setup() {
 
 ## What's New
 
-- **v3.0.1** — Vite plugin now reads RC file automatically; `output` is optional when `outputfile` is in the RC file; option names aligned to lowercase to match RC file keys (`cachetimehtml`, `cachetimeassets`, `noindexcheck`, `maxsize`, `maxgzipsize`); new `config` option to point at a custom RC file
-- **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
@@ -133,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(),
@@ -155,7 +168,7 @@ export default defineConfig({
 });
 ```
 
-`output` can be omitted when `outputfile` is set in an RC file. `sourcepath` defaults to Vite's `build.outDir`. All other options mirror CLI flags and fall back to the RC file before applying built-in defaults.
+`sourcepath` defaults to Vite's `build.outDir` in both modes.
 
 **Plugin options**
 
@@ -180,7 +193,6 @@ export default defineConfig({
 | `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                       |
-| `config`          | `string`                                    | auto-discover             | Path to a custom RC file                           |
 
 ### Generate Header File (CLI)
 

package/dist/commandLine.d.ts

@@ -21,6 +21,7 @@ export interface ICopyFilesArguments {
     spa?: boolean;
     manifest?: boolean;
     help?: boolean;
+    configSource: 'cli' | 'rcfile' | 'vite';
 }
 export interface IRcFileConfig {
     engine?: 'psychic' | 'async' | 'espidf' | 'webserver';

package/dist/commandLine.js

@@ -412,7 +412,8 @@ function parseArguments() {
         define: 'SVELTEESP32',
         cachetime: 0,
         exclude: [],
-        basePath: ''
+        basePath: '',
+        configSource: 'cli'
     };
     if (rcConfig.engine)
         result.engine = rcConfig.engine;
@@ -615,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}`

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)

package/dist/vitePlugin.d.ts

@@ -28,7 +28,6 @@ export interface SvelteESP32PluginOptions {
     noindexcheck?: boolean;
     maxsize?: number;
     maxgzipsize?: number;
-    config?: string;
 }
-export declare function svelteESP32(options: SvelteESP32PluginOptions): VitePlugin;
+export declare function svelteESP32(optionsOrRcPath?: SvelteESP32PluginOptions | string): VitePlugin;
 export {};

package/dist/vitePlugin.js

@@ -12,7 +12,7 @@ function coerceBool(value) {
         return undefined;
     return value === true || value === 'true';
 }
-function svelteESP32(options) {
+function svelteESP32(optionsOrRcPath) {
     let outDirectory = 'dist';
     return {
         name: 'svelteesp32',
@@ -20,35 +20,72 @@ function svelteESP32(options) {
             outDirectory = config.build.outDir;
         },
         closeBundle() {
-            const rcConfig = (0, commandLine_1.loadRcFileConfig)(options.config);
-            const rawOutput = options.output ?? rcConfig.outputfile;
-            if (!rawOutput)
-                throw new Error('output is required — specify it as a plugin option or in the RC file (outputfile)');
-            const outputfile = node_path_1.default.resolve(rawOutput);
-            const sourcepath = options.sourcepath ?? rcConfig.sourcepath ?? outDirectory;
-            const rawBasepath = options.basepath ?? rcConfig.basepath ?? '';
-            const basePath = (0, commandLine_1.validateBasePath)(rawBasepath);
-            const options_ = {
-                engine: options.engine ?? rcConfig.engine ?? 'psychic',
-                sourcepath,
-                outputfile,
-                etag: options.etag ?? rcConfig.etag ?? 'never',
-                gzip: options.gzip ?? rcConfig.gzip ?? 'always',
-                cachetime: options.cachetime ?? rcConfig.cachetime ?? 0,
-                cachetimeHtml: options.cachetimehtml ?? rcConfig.cachetimehtml,
-                cachetimeAssets: options.cachetimeassets ?? rcConfig.cachetimeassets,
-                created: options.created ?? coerceBool(rcConfig.created) ?? false,
-                version: options.version ?? rcConfig.version ?? '',
-                espmethod: options.espmethod ?? rcConfig.espmethod ?? 'initSvelteStaticFiles',
-                define: options.define ?? rcConfig.define ?? 'SVELTEESP32',
-                exclude: options.exclude ?? rcConfig.exclude ?? [],
-                basePath,
-                noIndexCheck: options.noindexcheck ?? coerceBool(rcConfig.noindexcheck),
-                spa: options.spa ?? coerceBool(rcConfig.spa),
-                manifest: options.manifest ?? coerceBool(rcConfig.manifest),
-                maxSize: options.maxsize ?? rcConfig.maxsize,
-                maxGzipSize: options.maxgzipsize ?? rcConfig.maxgzipsize
-            };
+            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
+                };
+            }
             (0, pipeline_1.runPipeline)(options_);
         }
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Convert Svelte (or any frontend) JS application to serve it from ESP32 webserver (PsychicHttp)",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -74,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",