cc4-embedded-system 3.0.0

package/README.md

@@ -0,0 +1,44 @@
+# CC4EmbeddedSystem V3
+This version based on [html-minifier-next](https://github.com/j9t/html-minifier-next) and rewrite [lwIP makefsdata](https://github.com/m-labs/lwip/tree/master/src/apps/httpd/makefsdata), run on localhost, default port: ```3000```.
+
+![](./Screenshot/v3.0.0.png)
+
+## Structure
+```text
+CC4EmbeddedSystem/
+├── src/
+│   ├── gui.ts        // Express server & CLI entry point
+│   └── makefsdata.ts // Core C code generation & minification logic
+├── public/
+│   └── index.html    // Web GUI dashboard
+├── dist/             // Compiled JavaScript output (Auto-generated)
+├── tsconfig.json     // TypeScript configuration
+└── package.json      // Project configuration & dependencies
+```
+
+## Commands
+### Normal Use
+- Global installation
+    ```bash
+    npm install -g cc4-embedded-system
+    cc4es # run
+    ```
+- Run once (no installation)
+    ```bash
+    npx cc4-embedded-system
+    ```
+### Development
+```bash
+# build
+npm run build
+
+# mimic global installation
+npm link
+cc4es
+
+# publish
+npm login
+# npm version patch # if increase version
+npm run build
+npm publish --access public
+```

package/dist/gui.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/*
+ * ==============================================================================
+ * CC4EmbeddedSystem V3 (makefsdata)
+ * Copyright (c) 2026 LunaticGhoulPiano / Emile Su
+ * Licensed under the MIT License.
+ * ==============================================================================
+ *
+ * This software integrates concepts, logic, and minification processes derived
+ * from the following open-source projects. We deeply appreciate their work:
+ *
+ * ------------------------------------------------------------------------------
+ * 1. lwIP (Lightweight TCP/IP stack)
+ * Repository: https://github.com/m-labs/lwip
+ * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
+ * All rights reserved.
+ * * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+ * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+ * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ * OF SUCH DAMAGE.
+ *
+ * ------------------------------------------------------------------------------
+ * 2. html-minifier-next
+ * Repository: https://github.com/j9t/html-minifier-next
+ * Copyright (c) Jens Oliver Meiert (html-minifier-next)
+ * Copyright (c) Daniel Ruf (html-minifier-terser)
+ * Copyright (c) Juriy "kangax" Zaytsev (html-minifier)
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ * ==============================================================================
+ */
+// modern ESM
+import express from 'express';
+import open from 'open';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import { runMakeFsData } from './makefsdata.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const app = express();
+// port default: 3000
+let PORT = parseInt(process.env.PORT || '3000', 10);
+const portArgIndex = process.argv.indexOf('--port');
+if (portArgIndex !== -1 && process.argv[portArgIndex + 1]) {
+    const parsedPort = parseInt(process.argv[portArgIndex + 1], 10);
+    if (!isNaN(parsedPort))
+        PORT = parsedPort;
+}
+let server;
+app.use(express.json());
+app.use(express.static(path.join(__dirname, '../public')));
+// get current version
+const getPackageVersion = () => {
+    try {
+        const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "3.0.0";
+    }
+};
+app.get('/api/version', (_req, res) => {
+    res.json({ version: getPackageVersion() });
+});
+// main
+app.post('/api/build', async (req, res) => {
+    // get minifyOpts
+    const { inputPath, outputPath, minifyOpts } = req.body;
+    const opts = {
+        inputDir: inputPath,
+        outputFile: outputPath,
+        processSubs: true,
+        includeHttpHeader: true,
+        useHttp11: false,
+        supportSsi: true,
+        precalcChksum: false,
+        minifyOpts: minifyOpts
+    };
+    try {
+        await runMakeFsData(opts);
+        await open(path.dirname(outputPath));
+        res.json({ success: true });
+    }
+    catch (error) {
+        res.json({ success: false, message: error.message });
+    }
+});
+app.post('/api/shutdown', (_req, res) => {
+    console.log('👋 Window closed, shutting down ...');
+    res.json({ success: true });
+    setTimeout(() => { process.exit(0); }, 500);
+});
+app.post('/api/change-port', (req, res) => {
+    const parsedPort = parseInt(req.body.newPort, 10);
+    if (isNaN(parsedPort) || parsedPort < 1 || parsedPort > 65535) {
+        res.json({ success: false, message: 'Invalid port number.' });
+        return;
+    }
+    res.json({ success: true });
+    // restart
+    setTimeout(() => {
+        if (server) {
+            server.closeAllConnections();
+            server.close(() => {
+                PORT = parsedPort;
+                server = app.listen(PORT, () => {
+                    console.log(`🔄 Server successfully restarted on port ${PORT}`);
+                });
+            });
+        }
+    }, 100);
+});
+server = app.listen(PORT, async () => {
+    console.log(`✨ GUI Server started! Opening in browser...`);
+    await open(`http://localhost:${PORT}`);
+});

package/dist/makefsdata.js

@@ -0,0 +1,322 @@
+/*
+ * ==============================================================================
+ * CC4EmbeddedSystem V3 (makefsdata)
+ * Copyright (c) 2026 LunaticGhoulPiano / Emile Su
+ * Licensed under the MIT License.
+ * ==============================================================================
+ *
+ * This software integrates concepts, logic, and minification processes derived
+ * from the following open-source projects. We deeply appreciate their work:
+ *
+ * ------------------------------------------------------------------------------
+ * 1. lwIP (Lightweight TCP/IP stack)
+ * Repository: https://github.com/m-labs/lwip
+ * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
+ * All rights reserved.
+ * * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+ * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+ * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ * OF SUCH DAMAGE.
+ *
+ * ------------------------------------------------------------------------------
+ * 2. html-minifier-next
+ * Repository: https://github.com/j9t/html-minifier-next
+ * Copyright (c) Jens Oliver Meiert (html-minifier-next)
+ * Copyright (c) Daniel Ruf (html-minifier-terser)
+ * Copyright (c) Juriy "kangax" Zaytsev (html-minifier)
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ * ==============================================================================
+ */
+// modern ESM
+import fs from 'node:fs';
+import path from 'node:path';
+import { minify } from 'html-minifier-next';
+// ----------------------------------------------------------------------
+// 1. Configs & Version Recovery
+// ----------------------------------------------------------------------
+const TCP_MSS = 1460;
+const LWIP_VERSION = "1.3.1"; // this makefsdata.ts is based on lwIP v1.3.1
+const getPackageVersion = () => {
+    try {
+        const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "v3.0.0";
+    }
+};
+// html-minifier-next options
+const COMPRESS_OPTS_DEFAULT = {
+    collapseWhitespace: true,
+    removeComments: true,
+    minifyJS: true,
+    minifyCSS: true,
+    processConditionalComments: true,
+    decodeEntities: true
+};
+// ----------------------------------------------------------------------
+// 3. lwIP Helpers
+// ----------------------------------------------------------------------
+function getMimeType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    switch (ext) {
+        case '.html':
+        case '.htm':
+        case '.shtml':
+        case '.shtm':
+        case '.ssi': {
+            return 'text/html';
+        }
+        case '.css':
+            return 'text/css';
+        case '.js':
+            return 'application/javascript';
+        case '.png':
+            return 'image/png';
+        case '.gif':
+            return 'image/gif';
+        case '.jpg':
+        case '.jpeg': {
+            return 'image/jpeg';
+        }
+        case '.ico':
+            return 'image/x-icon';
+        case '.xml':
+            return 'text/xml';
+        case '.json':
+            return 'application/json';
+        default:
+            return 'text/plain';
+    }
+}
+function inetChksum(buf) {
+    let sum = 0;
+    for (let i = 0; i < buf.length; i += 2) {
+        const b1 = buf[i];
+        const b2 = (i + 1 < buf.length) ? buf[i + 1] : 0;
+        if (b1 === undefined)
+            continue;
+        sum += (b1 << 8) | (b2 ?? 0);
+    }
+    while (sum >> 16)
+        sum = (sum & 0xFFFF) + (sum >> 16);
+    return (~sum) & 0xFFFF;
+}
+function generateHttpHeaders(fileName, dataLength, opts) {
+    const parts = [];
+    const ccVersion = getPackageVersion();
+    const addPart = (str) => { parts.push({ str, buf: Buffer.from(str, 'ascii') }); };
+    const baseName = path.basename(fileName);
+    const ext = path.extname(fileName).toLowerCase();
+    const protocol = opts.useHttp11 ? "HTTP/1.1" : "HTTP/1.0";
+    if (baseName.startsWith("404"))
+        addPart(`${protocol} 404 File not found\r\n`);
+    else if (baseName.startsWith("400"))
+        addPart(`${protocol} 400 Bad Request\r\n`);
+    else if (baseName.startsWith("501"))
+        addPart(`${protocol} 501 Not Implemented\r\n`);
+    else
+        addPart(`${protocol} 200 OK\r\n`);
+    const serverInfo = `Server: lwIP & CC4EmbeddedSystem V3\r\n` +
+        `lwIP (${LWIP_VERSION}): (http://savannah.nongnu.org/projects/lwip)\r\n` +
+        `CC4EmbeddedSystem V3 (${ccVersion}): https://github.com/LunaticGhoulPiano/CC4EmbeddedSystem\r\n`;
+    parts.push({ str: serverInfo, buf: Buffer.alloc(0) }); // addPart(serverInfo);
+    let isSsi = false;
+    if (opts.supportSsi && ['.shtml', '.shtm', '.ssi', '.xml'].includes(ext))
+        isSsi = true;
+    if (opts.useHttp11) {
+        if (!isSsi) {
+            addPart(`Content-Length: ${dataLength}\r\n`);
+            addPart(`Connection: keep-alive\r\n`);
+        }
+        else
+            addPart(`Connection: close\r\n`);
+    }
+    addPart(`Content-type: ${getMimeType(fileName)}\r\n\r\n`);
+    return { parts, totalBuffer: Buffer.concat(parts.map(p => p.buf)) };
+}
+function getFilesRecursive(dir, processSubs) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const list = fs.readdirSync(dir);
+    for (const file of list) {
+        const fullPath = path.join(dir, file);
+        const stat = fs.statSync(fullPath);
+        if (!stat.isDirectory())
+            results.push(fullPath);
+        else if (processSubs)
+            results.push(...getFilesRecursive(fullPath, processSubs));
+    }
+    return results;
+}
+function bufferToHexCArray(buf) {
+    let out = '';
+    for (let i = 0; i < buf.length; i++) {
+        if (i % 16 === 0)
+            out += '\t';
+        const b = buf[i];
+        if (b === undefined)
+            continue;
+        out += `0x${b.toString(16).padStart(2, '0')},`;
+        if ((i + 1) % 16 === 0)
+            out += '\n';
+    }
+    if (!out.endsWith('\n'))
+        out += '\n';
+    return out;
+}
+// ----------------------------------------------------------------------
+// 4. export API
+// ----------------------------------------------------------------------
+export async function runMakeFsData(opts) {
+    console.log(`🚀 CC4EmbeddedSystem V3: Starting makefsdata compilation...`);
+    // checkers
+    if (!fs.existsSync(opts.inputDir)) {
+        console.log(`⚠️ Input directory not found. Auto-creating directory: \n${opts.inputDir}`);
+        fs.mkdirSync(opts.inputDir, { recursive: true });
+    }
+    if (!opts.outputFile.toLowerCase().endsWith('.c')) {
+        opts.outputFile += '.c';
+        console.log(`🔧 Auto-appended '.c' to output file -> ${opts.outputFile}`);
+    }
+    const outDir = path.dirname(opts.outputFile);
+    if (!fs.existsSync(outDir))
+        fs.mkdirSync(outDir, { recursive: true });
+    const allFiles = getFilesRecursive(opts.inputDir, opts.processSubs);
+    const fileEntries = [];
+    if (allFiles.length === 0)
+        throw new Error(`Input directory is empty! Please put your web files (.html, .css, etc.) into:\n${path.resolve(opts.inputDir)}`);
+    // html-minifier-next options
+    const activeCompressOpts = opts.minifyOpts || COMPRESS_OPTS_DEFAULT;
+    for (let i = 0; i < allFiles.length; i++) {
+        const filePath = allFiles[i];
+        const relativePath = '/' + path.relative(opts.inputDir, filePath).replace(/\\/g, '/');
+        const ext = path.extname(filePath).toLowerCase();
+        let content = fs.readFileSync(filePath);
+        if (['.html', '.htm', '.css', '.js'].includes(ext)) {
+            const minifiedStr = await minify(content.toString('utf8'), activeCompressOpts);
+            if (typeof minifiedStr === 'string') {
+                content = Buffer.from(minifiedStr, 'utf8');
+                console.log(`📦 Minified: ${relativePath}`);
+            }
+        }
+        else
+            console.log(`📄 Copied: ${relativePath}`);
+        // generate header
+        const headerData = opts.includeHttpHeader ? generateHttpHeaders(filePath, content.length, opts) : { parts: [], totalBuffer: Buffer.alloc(0) };
+        const nameBuffer = Buffer.from(relativePath + '\0', 'utf8');
+        const varName = relativePath.replace(/[^A-Za-z0-9]/g, '_');
+        const chksums = [];
+        if (opts.precalcChksum) {
+            let offset = 0;
+            if (headerData.totalBuffer.length > 0) {
+                chksums.push({ offset: 0, chksum: inetChksum(headerData.totalBuffer), len: headerData.totalBuffer.length });
+                offset += headerData.totalBuffer.length;
+            }
+            for (let chunkOffset = 0; chunkOffset < content.length; chunkOffset += TCP_MSS) {
+                const chunkLen = Math.min(TCP_MSS, content.length - chunkOffset);
+                chksums.push({ offset: offset, chksum: inetChksum(content.subarray(chunkOffset, chunkOffset + chunkLen)), len: chunkLen });
+                offset += chunkLen;
+            }
+        }
+        fileEntries.push({ varName, pathName: relativePath, nameBuffer, headerParts: headerData.parts, headerTotalBuffer: headerData.totalBuffer, contentBuffer: content, chksums });
+    }
+    // ====================================================================
+    // C Code Generation
+    // ====================================================================
+    let cOutput = `/* Generated by CC4EmbeddedSystem V3 (makefsdata) */\n\n`;
+    cOutput += `#include "fs.h"\n#include "lwip/def.h"\n#include "fsdata.h"\n\n\n`;
+    cOutput += `#define file_NULL (struct fsdata_file *) NULL\n\n\n`;
+    if (opts.precalcChksum) {
+        cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n`;
+        for (const file of fileEntries) {
+            cOutput += `const struct fsdata_chksum chksums_${file.varName}[] = {\n`;
+            for (const chk of file.chksums)
+                cOutput += `\t{${chk.offset}, 0x${chk.chksum.toString(16).padStart(4, '0')}, ${chk.len}},\n`;
+            cOutput += `};\n`;
+        }
+        cOutput += `#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n\n\n`;
+    }
+    // generate data arrays
+    for (const file of fileEntries) {
+        cOutput += `static const unsigned int dummy_align_${file.varName} = 0;\n`;
+        cOutput += `static const unsigned char data_${file.varName}[] = {\n`;
+        cOutput += `\t/* ${file.pathName} (${file.nameBuffer.length} chars) */\n`;
+        cOutput += bufferToHexCArray(file.nameBuffer);
+        if (file.headerParts.length > 0) {
+            cOutput += `\n\t/* HTTP header */\n`;
+            for (const part of file.headerParts) {
+                let finalStr = part.str.replace(/\n/g, '\n\t');
+                if (finalStr.endsWith('\t'))
+                    finalStr = finalStr.slice(0, -1);
+                cOutput += `\t/* "${finalStr}\t" (${part.buf.length} bytes) */\n`;
+                cOutput += bufferToHexCArray(part.buf);
+            }
+        }
+        cOutput += `\n\t/* raw file data (${file.contentBuffer.length} bytes) */\n`;
+        cOutput += bufferToHexCArray(file.contentBuffer);
+        cOutput += `};\n\n\n\n`;
+    }
+    // redirhome.html
+    cOutput += `/* --- Empty arrays --- */\n`;
+    cOutput += `static const unsigned char data__redirhome_html[] = {};\n`;
+    cOutput += `const struct fsdata_file file__redirhome_html[] = { {\n`;
+    cOutput += `\tfile_NULL,\n`;
+    cOutput += `\tdata__redirhome_html,\n`;
+    cOutput += `\tdata__redirhome_html + 16,\n`;
+    cOutput += `\tsizeof(data__redirhome_html) - 16,\n`;
+    cOutput += `\t1,\n`;
+    // checksum
+    if (opts.precalcChksum)
+        cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n\t0, NULL,\n#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n`;
+    cOutput += `}};\n\n\n`;
+    // generate linked-list
+    for (let i = fileEntries.length - 1; i >= 0; i--) {
+        const current = fileEntries[i];
+        // last element didn't points to file_NULL but file__redirhome_html
+        const nextVar = fileEntries[i + 1] ? `file_${fileEntries[i + 1].varName}` : 'file__redirhome_html';
+        const nameLen = current.nameBuffer.length;
+        // address: e.g. "/index.html\0" = '/' + 'i' + 'n' + 'd' + 'e' + 'x' + '.' + 'h' + 't' + 'm' + 'l' + '\0' = 12
+        cOutput += `const struct fsdata_file file_${current.varName}[] = { {\n`;
+        cOutput += `\t${nextVar},\n\tdata_${current.varName},\n\tdata_${current.varName} + ${nameLen},\n\tsizeof(data_${current.varName}) - ${nameLen},\n\t${opts.includeHttpHeader ? 1 : 0},\n`;
+        if (opts.precalcChksum)
+            cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n\t${current.chksums.length}, chksums_${current.varName},\n#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n`;
+        cOutput += `}};\n\n`;
+    }
+    const rootNode = fileEntries[0];
+    if (rootNode) {
+        cOutput += `#define FS_ROOT file_${rootNode.varName}\n#define FS_NUMFILES ${fileEntries.length + 1}\n`;
+        fs.writeFileSync(opts.outputFile, cOutput);
+        console.log(`\n✨ Success! Output written to: ${opts.outputFile}`);
+    }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "cc4-embedded-system",
+  "version": "3.0.0",
+  "description": "A modern typescript version of makefsdata based on html-minifier-next and lwIP v1.3.1",
+  "bin": {
+    "cc4es": "./dist/gui.js"
+  },
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/gui.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "lwip",
+    "makefsdata",
+    "stm32",
+    "embedded-system",
+    "html-minifier",
+    "html-minifier-next",
+    "html-compressor"
+  ],
+  "author": "LunaticGhoulPiano",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^5.2.1",
+    "html-minifier-next": "^6.1.2",
+    "open": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.6.0",
+    "@types/open": "^6.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  }
+}

package/public/index.html

@@ -0,0 +1,166 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>CC4EmbeddedSystem V3</title>
+    <style>
+        body { font-family: 'Consolas', monospace; background: #1e1e1e; color: #d4d4d4; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; }
+        .container { background: #252526; padding: 30px 40px; border-radius: 8px; border: 1px solid #333; width: 500px; box-shadow: 0 4px 20px rgba(0,0,0,0.5); }
+        h2 { color: #569cd6; margin-top: 0; display: flex; justify-content: center; align-items: center; gap: 12px; }
+        .github-link { color: #d4d4d4; display: flex; align-items: center; transition: color 0.2s; text-decoration: none; }
+        .github-link:hover { color: #ffffff; }
+        .form-group { margin-bottom: 20px; }
+        label { display: block; font-weight: bold; margin-bottom: 8px; color: #9cdcfe; }
+        input[type="text"] { width: 100%; padding: 10px; background: #3c3c3c; border: 1px solid #555; border-radius: 4px; color: #d4d4d4; box-sizing: border-box; font-family: 'Consolas', monospace; }
+        input[type="text"]:focus { outline: none; border-color: #569cd6; }
+        input::placeholder { color: #888; }
+        button { width: 100%; padding: 12px; background: #0e639c; color: white; border: none; border-radius: 4px; font-size: 16px; font-weight: bold; cursor: pointer; transition: 0.2s; font-family: 'Consolas', monospace; }
+        button:hover { background: #1177bb; }
+        
+        /* Additional settings' styles */
+        details { background: #1e1e1e; padding: 12px; border-radius: 4px; border: 1px solid #444; margin-bottom: 20px; }
+        summary { cursor: pointer; color: #c586c0; font-weight: bold; outline: none; user-select: none; }
+        .options-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; margin-top: 15px; }
+        .checkbox-label { display: flex; align-items: center; font-weight: normal; color: #cccccc; cursor: pointer; font-size: 14px; margin-bottom: 0; }
+        .checkbox-label input { margin-right: 8px; cursor: pointer; accent-color: #0e639c; }
+    </style>
+</head>
+<body>
+
+<div class="container">
+    <h2>
+        <a href="https://github.com/LunaticGhoulPiano/CC4EmbeddedSystem" target="_blank" rel="noopener noreferrer" class="github-link" title="View Source on GitHub">
+            <svg height="28" viewBox="0 0 16 16" width="28" aria-hidden="true">
+                <path fill="currentColor" d="M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z"></path>
+            </svg>
+        </a>
+        <span id="app-title-text">CC4EmbeddedSystem V3</span>
+    </h2>
+    
+    <div class="form-group">
+        <label>Input Directory</label>
+        <input type="text" id="inputPath" placeholder="e.g., ./input_webpages">
+    </div>
+
+    <div class="form-group">
+        <label>Output File (fsdata.c)</label>
+        <input type="text" id="outputPath" placeholder="e.g., ./output_fsdata.c">
+    </div>
+
+    <details>
+        <summary>⚙️ Advanced Settings</summary>
+        
+        <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 12px; padding-bottom: 12px; border-bottom: 1px solid #444;">
+            <label style="margin-bottom: 0;">GUI Server Port</label>
+            <div style="display: flex; gap: 8px;">
+                <input type="number" id="guiPort" style="width: 80px; padding: 6px; background: #3c3c3c; border: 1px solid #555; border-radius: 4px; color: #d4d4d4; text-align: center; font-family: 'Consolas', monospace;" min="1" max="65535">
+                <button type="button" onclick="changePort()" style="width: auto; padding: 6px 12px; font-size: 14px; background: #007acc;">Apply</button>
+            </div>
+        </div>
+
+        <label style="margin-bottom: 10px; font-size: 14px;">Compression Options:</label>
+        <div class="options-grid">
+            <label class="checkbox-label"><input type="checkbox" id="opt-collapseWhitespace" checked> collapseWhitespace</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-removeComments" checked> removeComments</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-minifyJS" checked> minifyJS</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-minifyCSS" checked> minifyCSS</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-processConditionalComments" checked> conditionalComments</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-decodeEntities" checked> decodeEntities</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-removeAttributeQuotes"> removeAttributeQuotes</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-removeEmptyAttributes"> removeEmptyAttributes</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-removeRedundantAttributes"> redundantAttributes</label>
+            <label class="checkbox-label"><input type="checkbox" id="opt-useShortDoctype"> useShortDoctype</label>
+        </div>
+    </details>
+
+    <button onclick="startBuild()">Generate C Code</button>
+</div>
+
+<script>
+    let isRedirecting = false;
+    document.getElementById('guiPort').value = window.location.port || '80';
+
+    // get package.json version
+    window.addEventListener('DOMContentLoaded', async () => {
+        try {
+            const res = await fetch('/api/version');
+            const data = await res.json();
+            if (data.version) document.getElementById('app-title-text').innerText = `CC4EmbeddedSystem V3 (${data.version})`;
+        }
+        catch (error) {
+            console.error('Can\'t get package.json version!', error);
+        }
+    });
+
+    async function changePort() {
+        const newPort = document.getElementById('guiPort').value.trim();
+        const currentPort = window.location.port || '80';
+
+        if (!newPort || newPort === currentPort) return;
+
+        const res = await fetch('/api/change-port', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ newPort })
+        });
+
+        const result = await res.json();
+        if (result.success) {
+            isRedirecting = true; 
+            
+            // 0.5s restart server and redirect
+            setTimeout(() => {
+                window.location.href = `${window.location.protocol}//${window.location.hostname}:${newPort}`;
+            }, 500);
+        }
+        else alert('❌ Failed to change port: \n' + result.message);
+    }
+
+    // run
+    async function startBuild() {
+        const inPath = document.getElementById('inputPath').value.trim();
+        const outPath = document.getElementById('outputPath').value.trim();
+
+        if (! inPath || ! outPath) {
+            alert('❌ Compile Error: \nBoth Input Directory and Output File paths are required.');
+            return;
+        }
+
+        // get all checkboxes
+        const minifyOptions = {
+            collapseWhitespace: document.getElementById('opt-collapseWhitespace').checked,
+            removeComments: document.getElementById('opt-removeComments').checked,
+            minifyJS: document.getElementById('opt-minifyJS').checked,
+            minifyCSS: document.getElementById('opt-minifyCSS').checked,
+            processConditionalComments: document.getElementById('opt-processConditionalComments').checked,
+            decodeEntities: document.getElementById('opt-decodeEntities').checked,
+            removeAttributeQuotes: document.getElementById('opt-removeAttributeQuotes').checked,
+            removeEmptyAttributes: document.getElementById('opt-removeEmptyAttributes').checked,
+            removeRedundantAttributes: document.getElementById('opt-removeRedundantAttributes').checked,
+            useShortDoctype: document.getElementById('opt-useShortDoctype').checked
+        };
+
+        const res = await fetch('/api/build', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ 
+                inputPath: inPath, 
+                outputPath: outPath,
+                minifyOpts: minifyOptions
+            })
+        });
+
+        const result = await res.json();
+
+        if (result.success) alert('✨ Success: \nC Array successfully generated at ' + outPath);
+        else alert('❌ Compile Error: \n' + result.message);
+    }
+    
+    // listen close window
+    window.addEventListener('beforeunload', () => {
+        if (! isRedirecting) navigator.sendBeacon('/api/shutdown');
+    });
+</script>
+
+</body>
+</html>

package/src/gui.ts

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+
+/*
+ * ==============================================================================
+ * CC4EmbeddedSystem V3 (makefsdata)
+ * Copyright (c) 2026 LunaticGhoulPiano / Emile Su
+ * Licensed under the MIT License.
+ * ==============================================================================
+ *
+ * This software integrates concepts, logic, and minification processes derived 
+ * from the following open-source projects. We deeply appreciate their work:
+ *
+ * ------------------------------------------------------------------------------
+ * 1. lwIP (Lightweight TCP/IP stack)
+ * Repository: https://github.com/m-labs/lwip
+ * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
+ * All rights reserved.
+ * * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+ * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+ * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ * OF SUCH DAMAGE.
+ *
+ * ------------------------------------------------------------------------------
+ * 2. html-minifier-next
+ * Repository: https://github.com/j9t/html-minifier-next
+ * Copyright (c) Jens Oliver Meiert (html-minifier-next)
+ * Copyright (c) Daniel Ruf (html-minifier-terser)
+ * Copyright (c) Juriy "kangax" Zaytsev (html-minifier)
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ * ==============================================================================
+ */
+
+// modern ESM
+import express from 'express'; 
+import open from 'open';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fs from 'node:fs';
+import { runMakeFsData, MakeFsDataOptions } from './makefsdata.js'; 
+
+const __filename: string = fileURLToPath(import.meta.url);
+const __dirname: string = path.dirname(__filename);
+const app = express();
+
+// port default: 3000
+let PORT: number = parseInt(process.env.PORT || '3000', 10);
+const portArgIndex = process.argv.indexOf('--port');
+if (portArgIndex !== -1 && process.argv[portArgIndex + 1]) {
+    const parsedPort = parseInt(process.argv[portArgIndex + 1]!, 10);
+    if (!isNaN(parsedPort)) PORT = parsedPort;
+}
+
+let server: any;
+
+app.use(express.json());
+app.use(express.static(path.join(__dirname, '../public')));
+
+// get current version
+const getPackageVersion = (): string => {
+    try {
+        const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "3.0.0";
+    }
+};
+
+app.get('/api/version', (_req: express.Request, res: express.Response) => {
+    res.json({ version: getPackageVersion() });
+});
+
+// main
+app.post('/api/build', async (req: express.Request, res: express.Response) => {
+    // get minifyOpts
+    const { inputPath, outputPath, minifyOpts } = req.body;
+    const opts: MakeFsDataOptions = {
+        inputDir: inputPath,
+        outputFile: outputPath,
+        processSubs: true,
+        includeHttpHeader: true,
+        useHttp11: false,
+        supportSsi: true,
+        precalcChksum: false,
+        minifyOpts: minifyOpts
+    };
+
+    try {
+        await runMakeFsData(opts);
+        await open(path.dirname(outputPath));
+        res.json({ success: true });
+    }
+    catch (error: any) {
+        res.json({ success: false, message: error.message });
+    }
+});
+
+app.post('/api/shutdown', (_req: express.Request, res: express.Response) => {
+    console.log('👋 Window closed, shutting down ...');
+    res.json({ success: true });
+    setTimeout(() => { process.exit(0); }, 500);
+});
+
+app.post('/api/change-port', (req: express.Request, res: express.Response): void => {
+    const parsedPort = parseInt(req.body.newPort, 10);
+    
+    if (isNaN(parsedPort) || parsedPort < 1 || parsedPort > 65535) {
+        res.json({ success: false, message: 'Invalid port number.' });
+        return; 
+    }
+
+    res.json({ success: true });
+
+    // restart
+    setTimeout(() => {
+        if (server) {
+            server.closeAllConnections(); 
+            server.close(() => {
+                PORT = parsedPort;
+                server = app.listen(PORT, () => {
+                    console.log(`🔄 Server successfully restarted on port ${PORT}`);
+                });
+            });
+        }
+    }, 100);
+});
+
+server = app.listen(PORT, async () => {
+    console.log(`✨ GUI Server started! Opening in browser...`);
+    await open(`http://localhost:${PORT}`);
+});

package/src/makefsdata.ts

@@ -0,0 +1,377 @@
+/*
+ * ==============================================================================
+ * CC4EmbeddedSystem V3 (makefsdata)
+ * Copyright (c) 2026 LunaticGhoulPiano / Emile Su
+ * Licensed under the MIT License.
+ * ==============================================================================
+ *
+ * This software integrates concepts, logic, and minification processes derived 
+ * from the following open-source projects. We deeply appreciate their work:
+ *
+ * ------------------------------------------------------------------------------
+ * 1. lwIP (Lightweight TCP/IP stack)
+ * Repository: https://github.com/m-labs/lwip
+ * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
+ * All rights reserved.
+ * * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ * * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * 3. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+ * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+ * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ * OF SUCH DAMAGE.
+ *
+ * ------------------------------------------------------------------------------
+ * 2. html-minifier-next
+ * Repository: https://github.com/j9t/html-minifier-next
+ * Copyright (c) Jens Oliver Meiert (html-minifier-next)
+ * Copyright (c) Daniel Ruf (html-minifier-terser)
+ * Copyright (c) Juriy "kangax" Zaytsev (html-minifier)
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ * ==============================================================================
+ */
+
+// modern ESM
+import fs from 'node:fs';
+import path from 'node:path';
+import { minify } from 'html-minifier-next';
+
+// ----------------------------------------------------------------------
+// 1. Configs & Version Recovery
+// ----------------------------------------------------------------------
+const TCP_MSS: number = 1460;
+const LWIP_VERSION: string = "1.3.1"; // this makefsdata.ts is based on lwIP v1.3.1
+
+const getPackageVersion = (): string => {
+    try {
+        const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "v3.0.0";
+    }
+};
+
+// html-minifier-next options
+const COMPRESS_OPTS_DEFAULT = {
+    collapseWhitespace: true,
+    removeComments: true,
+    minifyJS: true,
+    minifyCSS: true,
+    processConditionalComments: true,
+    decodeEntities: true
+};
+
+export interface MakeFsDataOptions {
+    inputDir: string;
+    outputFile: string;
+    processSubs: boolean;
+    includeHttpHeader: boolean;
+    useHttp11: boolean;
+    supportSsi: boolean;
+    precalcChksum: boolean;
+    minifyOpts?: any; // customize
+}
+
+// ----------------------------------------------------------------------
+// 2. Structures
+// ----------------------------------------------------------------------
+interface ChksumBlock { offset: number; chksum: number; len: number; }
+interface HeaderPart { str: string; buf: Buffer; }
+interface FileEntry {
+    varName: string; pathName: string; nameBuffer: Buffer;
+    headerParts: HeaderPart[]; headerTotalBuffer: Buffer;
+    contentBuffer: Buffer; chksums: ChksumBlock[];
+}
+
+// ----------------------------------------------------------------------
+// 3. lwIP Helpers
+// ----------------------------------------------------------------------
+function getMimeType(fileName: string): string {
+    const ext: string = path.extname(fileName).toLowerCase();
+    switch (ext) {
+        case '.html':
+        case '.htm':
+        case '.shtml':
+        case '.shtm':
+        case '.ssi': {
+            return 'text/html';
+        }
+
+        case '.css':
+            return 'text/css';
+        case '.js':
+            return 'application/javascript';
+        case '.png':
+            return 'image/png';
+        case '.gif':
+            return 'image/gif';
+        
+        case '.jpg':
+        case '.jpeg': {
+            return 'image/jpeg';
+        }
+        
+        case '.ico':
+            return 'image/x-icon';
+        case '.xml':
+            return 'text/xml';
+        case '.json':
+            return 'application/json';
+        default:
+            return 'text/plain';
+    }
+}
+
+function inetChksum(buf: Buffer): number {
+    let sum: number = 0;
+    for (let i = 0; i < buf.length; i += 2) {
+        const b1: number | undefined = buf[i];
+        const b2: number | undefined = (i + 1 < buf.length) ? buf[i + 1] : 0;
+        
+        if (b1 === undefined) continue;
+        sum += (b1 << 8) | (b2 ?? 0);
+    }
+    
+    while (sum >> 16) sum = (sum & 0xFFFF) + (sum >> 16);
+    
+    return (~sum) & 0xFFFF;
+}
+
+function generateHttpHeaders(fileName: string, dataLength: number, opts: MakeFsDataOptions): { parts: HeaderPart[], totalBuffer: Buffer } {
+    const parts: HeaderPart[] = [];
+    const ccVersion = getPackageVersion();
+    const addPart = (str: string) => { parts.push({ str, buf: Buffer.from(str, 'ascii') }); };
+
+    const baseName: string = path.basename(fileName);
+    const ext: string = path.extname(fileName).toLowerCase();
+    
+    const protocol: string = opts.useHttp11 ? "HTTP/1.1" : "HTTP/1.0";
+    if (baseName.startsWith("404")) addPart(`${protocol} 404 File not found\r\n`);
+    else if (baseName.startsWith("400")) addPart(`${protocol} 400 Bad Request\r\n`);
+    else if (baseName.startsWith("501")) addPart(`${protocol} 501 Not Implemented\r\n`);
+    else addPart(`${protocol} 200 OK\r\n`);
+
+    const serverInfo = `Server: lwIP & CC4EmbeddedSystem V3\r\n` +
+                       `lwIP (${LWIP_VERSION}): (http://savannah.nongnu.org/projects/lwip)\r\n` +
+                       `CC4EmbeddedSystem V3 (${ccVersion}): https://github.com/LunaticGhoulPiano/CC4EmbeddedSystem\r\n`;
+    parts.push({ str: serverInfo, buf: Buffer.alloc(0) }); // addPart(serverInfo);
+
+    let isSsi: boolean = false;
+    if (opts.supportSsi && ['.shtml', '.shtm', '.ssi', '.xml'].includes(ext)) isSsi = true;
+
+    if (opts.useHttp11) {
+        if (! isSsi) {
+            addPart(`Content-Length: ${dataLength}\r\n`);
+            addPart(`Connection: keep-alive\r\n`);
+        }
+        else addPart(`Connection: close\r\n`);
+    }
+
+    addPart(`Content-type: ${getMimeType(fileName)}\r\n\r\n`);
+    
+    return { parts, totalBuffer: Buffer.concat(parts.map(p => p.buf)) };
+}
+
+function getFilesRecursive(dir: string, processSubs: boolean): string[] {
+    const results: string[] = [];
+    if (! fs.existsSync(dir)) return results;
+    const list: string[] = fs.readdirSync(dir);
+    
+    for (const file of list) {
+        const fullPath: string = path.join(dir, file);
+        const stat: fs.Stats = fs.statSync(fullPath);
+        if (! stat.isDirectory()) results.push(fullPath);
+        else if (processSubs) results.push(...getFilesRecursive(fullPath, processSubs));
+    }
+
+    return results;
+}
+
+function bufferToHexCArray(buf: Buffer): string {
+    let out = '';
+    for (let i = 0; i < buf.length; i++) {
+        if (i % 16 === 0) out += '\t';
+        const b: number | undefined = buf[i];
+        if (b === undefined) continue;
+        out += `0x${b.toString(16).padStart(2, '0')},`;
+        if ((i + 1) % 16 === 0) out += '\n';
+    }
+
+    if (!out.endsWith('\n')) out += '\n';
+    
+    return out;
+}
+
+// ----------------------------------------------------------------------
+// 4. export API
+// ----------------------------------------------------------------------
+export async function runMakeFsData(opts: MakeFsDataOptions): Promise<void> {
+    console.log(`🚀 CC4EmbeddedSystem V3: Starting makefsdata compilation...`);
+    
+    // checkers
+    if (! fs.existsSync(opts.inputDir)) {
+        console.log(`⚠️ Input directory not found. Auto-creating directory: \n${opts.inputDir}`);
+        fs.mkdirSync(opts.inputDir, { recursive: true });
+    }
+
+    if (!opts.outputFile.toLowerCase().endsWith('.c')) {
+        opts.outputFile += '.c';
+        console.log(`🔧 Auto-appended '.c' to output file -> ${opts.outputFile}`);
+    }
+
+    const outDir = path.dirname(opts.outputFile);
+    if (! fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
+
+    const allFiles = getFilesRecursive(opts.inputDir, opts.processSubs);
+    const fileEntries: FileEntry[] = [];
+
+    if (allFiles.length === 0) throw new Error(`Input directory is empty! Please put your web files (.html, .css, etc.) into:\n${path.resolve(opts.inputDir)}`);
+
+    // html-minifier-next options
+    const activeCompressOpts = opts.minifyOpts || COMPRESS_OPTS_DEFAULT;
+
+    for (let i = 0; i < allFiles.length; i++) {
+        const filePath = allFiles[i]!;
+        const relativePath = '/' + path.relative(opts.inputDir, filePath).replace(/\\/g, '/');
+        const ext = path.extname(filePath).toLowerCase();
+        let content = fs.readFileSync(filePath);
+
+        if (['.html', '.htm', '.css', '.js'].includes(ext)) {
+            const minifiedStr = await minify(content.toString('utf8'), activeCompressOpts);
+
+            if (typeof minifiedStr === 'string') {
+                content = Buffer.from(minifiedStr, 'utf8');
+                console.log(`📦 Minified: ${relativePath}`);
+            }
+        }
+        else console.log(`📄 Copied: ${relativePath}`);
+
+        // generate header
+        const headerData = opts.includeHttpHeader ? generateHttpHeaders(filePath, content.length, opts) : { parts: [], totalBuffer: Buffer.alloc(0) };
+        const nameBuffer = Buffer.from(relativePath + '\0', 'utf8');
+        const varName = relativePath.replace(/[^A-Za-z0-9]/g, '_');
+
+        const chksums: ChksumBlock[] = [];
+        if (opts.precalcChksum) {
+            let offset = 0;
+            
+            if (headerData.totalBuffer.length > 0) {
+                chksums.push({ offset: 0, chksum: inetChksum(headerData.totalBuffer), len: headerData.totalBuffer.length });
+                offset += headerData.totalBuffer.length;
+            }
+
+            for (let chunkOffset = 0; chunkOffset < content.length; chunkOffset += TCP_MSS) {
+                const chunkLen = Math.min(TCP_MSS, content.length - chunkOffset);
+                chksums.push({ offset: offset, chksum: inetChksum(content.subarray(chunkOffset, chunkOffset + chunkLen)), len: chunkLen });
+                offset += chunkLen;
+            }
+        }
+
+        fileEntries.push({ varName, pathName: relativePath, nameBuffer, headerParts: headerData.parts, headerTotalBuffer: headerData.totalBuffer, contentBuffer: content, chksums });
+    }
+
+    // ====================================================================
+    // C Code Generation
+    // ====================================================================
+    let cOutput: string = `/* Generated by CC4EmbeddedSystem V3 (makefsdata) */\n\n`;
+    cOutput += `#include "fs.h"\n#include "lwip/def.h"\n#include "fsdata.h"\n\n\n`;
+    cOutput += `#define file_NULL (struct fsdata_file *) NULL\n\n\n`;
+
+    if (opts.precalcChksum) {
+        cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n`;
+        for (const file of fileEntries) {
+            cOutput += `const struct fsdata_chksum chksums_${file.varName}[] = {\n`;
+            for (const chk of file.chksums) cOutput += `\t{${chk.offset}, 0x${chk.chksum.toString(16).padStart(4, '0')}, ${chk.len}},\n`;
+            cOutput += `};\n`;
+        }
+
+        cOutput += `#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n\n\n`;
+    }
+
+    // generate data arrays
+    for (const file of fileEntries) {
+        cOutput += `static const unsigned int dummy_align_${file.varName} = 0;\n`;
+        cOutput += `static const unsigned char data_${file.varName}[] = {\n`;
+        cOutput += `\t/* ${file.pathName} (${file.nameBuffer.length} chars) */\n`;
+        cOutput += bufferToHexCArray(file.nameBuffer);
+        
+        if (file.headerParts.length > 0) {
+            cOutput += `\n\t/* HTTP header */\n`;
+            for (const part of file.headerParts) {
+                let finalStr = part.str.replace(/\n/g, '\n\t');
+                if (finalStr.endsWith('\t')) finalStr = finalStr.slice(0, -1);
+                cOutput += `\t/* "${finalStr}\t" (${part.buf.length} bytes) */\n`;
+                cOutput += bufferToHexCArray(part.buf);
+            }
+        }
+        
+        cOutput += `\n\t/* raw file data (${file.contentBuffer.length} bytes) */\n`;
+        cOutput += bufferToHexCArray(file.contentBuffer);
+        cOutput += `};\n\n\n\n`;
+    }
+
+    // redirhome.html
+    cOutput += `/* --- Empty arrays --- */\n`;
+    cOutput += `static const unsigned char data__redirhome_html[] = {};\n`;
+    cOutput += `const struct fsdata_file file__redirhome_html[] = { {\n`;
+    cOutput += `\tfile_NULL,\n`;
+    cOutput += `\tdata__redirhome_html,\n`;
+    cOutput += `\tdata__redirhome_html + 16,\n`;
+    cOutput += `\tsizeof(data__redirhome_html) - 16,\n`;
+    cOutput += `\t1,\n`;
+    
+    // checksum
+    if (opts.precalcChksum) cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n\t0, NULL,\n#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n`;
+    cOutput += `}};\n\n\n`;
+
+
+    // generate linked-list
+    for (let i = fileEntries.length - 1; i >= 0; i--) {
+        const current = fileEntries[i]!;
+        
+        // last element didn't points to file_NULL but file__redirhome_html
+        const nextVar = fileEntries[i + 1] ? `file_${fileEntries[i+1]!.varName}` : 'file__redirhome_html';
+        const nameLen = current.nameBuffer.length;
+        
+        // address: e.g. "/index.html\0" = '/' + 'i' + 'n' + 'd' + 'e' + 'x' + '.' + 'h' + 't' + 'm' + 'l' + '\0' = 12
+        cOutput += `const struct fsdata_file file_${current.varName}[] = { {\n`;
+        cOutput += `\t${nextVar},\n\tdata_${current.varName},\n\tdata_${current.varName} + ${nameLen},\n\tsizeof(data_${current.varName}) - ${nameLen},\n\t${opts.includeHttpHeader ? 1 : 0},\n`; 
+        
+        if (opts.precalcChksum) cOutput += `#if HTTPD_PRECALCULATED_CHECKSUM\n\t${current.chksums.length}, chksums_${current.varName},\n#endif /* HTTPD_PRECALCULATED_CHECKSUM */\n`;
+        cOutput += `}};\n\n`;
+    }
+
+    const rootNode = fileEntries[0];
+    if (rootNode) {
+        cOutput += `#define FS_ROOT file_${rootNode.varName}\n#define FS_NUMFILES ${fileEntries.length + 1}\n`;
+        fs.writeFileSync(opts.outputFile, cOutput);
+        console.log(`\n✨ Success! Output written to: ${opts.outputFile}`);
+    }
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    /* environment */
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    
+    /* strict type checking */
+    "strict": true,
+    "noImplicitAny": true, /* no "any" */
+    "strictNullChecks": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    /* Coding style */
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    
+    /* module and consistency */
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}