create-jen-app 1.0.0 → 1.2.1

package/templates/static/lib/build-tools/build-site.js

@@ -0,0 +1,56 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+// Site build utilities
+// Migrated from Python src/python/build.py
+import { copyFileSync, rmSync, mkdirSync, readdirSync, } from "node:fs";
+import { join } from "node:path";
+import { log } from "../shared/log.js";
+function copyDir(src, dst) {
+    if (!readdirSync(src, { withFileTypes: true }).length)
+        return;
+    mkdirSync(dst, { recursive: true });
+    for (const file of readdirSync(src, { withFileTypes: true })) {
+        const srcPath = join(src, file.name);
+        const dstPath = join(dst, file.name);
+        if (file.isDirectory()) {
+            copyDir(srcPath, dstPath);
+        }
+        else {
+            copyFileSync(srcPath, dstPath);
+        }
+    }
+}
+export async function buildSite(opts = {}) {
+    log.info("Building site...");
+    const srcDir = "site";
+    const distDir = "dist";
+    // Clean dist
+    try {
+        rmSync(distDir, { recursive: true, force: true });
+    }
+    catch { }
+    // Copy assets
+    copyDir(srcDir, distDir);
+    log.info(`Copied ${srcDir} → ${distDir}`);
+    // Minify if requested
+    if (opts.minify) {
+        log.info("Minifying assets...");
+        // Placeholder: integrate image/font minifiers
+    }
+    log.info("Build complete.");
+}

package/templates/static/lib/cache/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./memory";
+export * from "./redis";

package/templates/static/lib/cache/index.js

@@ -0,0 +1,19 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export * from "./memory";
+export * from "./redis";

package/templates/static/lib/cache/memory.d.ts

@@ -0,0 +1,6 @@
+export declare class MemoryCache {
+    private store;
+    set(key: string, value: any, ttlMs?: number): void;
+    get(key: string): any;
+    delete(key: string): void;
+}

package/templates/static/lib/cache/memory.js

@@ -0,0 +1,31 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export class MemoryCache {
+    store = new Map();
+    set(key, value, ttlMs) {
+        this.store.set(key, value);
+        if (ttlMs)
+            setTimeout(() => this.store.delete(key), ttlMs);
+    }
+    get(key) {
+        return this.store.get(key);
+    }
+    delete(key) {
+        this.store.delete(key);
+    }
+}

package/templates/static/lib/cache/redis.d.ts

@@ -0,0 +1,6 @@
+export declare class RedisCache {
+    connect(): Promise<void>;
+    set(key: string, value: any, ttlSec?: number): Promise<void>;
+    get(key: string): Promise<void>;
+    delete(key: string): Promise<void>;
+}

package/templates/static/lib/cache/redis.js

@@ -0,0 +1,33 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+// Redis cache utilities - external Redis library not included
+// Users should implement with their own redis library (e.g., npm install redis)
+export class RedisCache {
+    async connect() {
+        throw new Error("Redis implementation requires external library. Install: npm install redis");
+    }
+    async set(key, value, ttlSec) {
+        throw new Error("Redis implementation requires external library. Install: npm install redis");
+    }
+    async get(key) {
+        throw new Error("Redis implementation requires external library. Install: npm install redis");
+    }
+    async delete(key) {
+        throw new Error("Redis implementation requires external library. Install: npm install redis");
+    }
+}

package/templates/static/lib/cli/banner.d.ts

@@ -0,0 +1 @@
+export declare function printBanner(port: number, env: string, version?: string): void;

package/templates/static/lib/cli/banner.js

@@ -0,0 +1,41 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+// Stylized CLI Banner for Jen.js
+// Matches the visual style requested (Purple/Cyan gradient feel)
+const RES = "\x1b[0m";
+const PURPLE = "\x1b[38;2;200;128;255m"; // #C880FF
+const CYAN = "\x1b[38;2;86;194;201m"; // #56C2C9
+const GRAY = "\x1b[90m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+export function printBanner(port, env, version = "1.0.0") {
+    // Clear screen mostly
+    // console.log("\x1b[2J\x1b[3J\x1b[H");
+    console.log();
+    console.log(`  ${PURPLE}       __               ${CYAN}   _     ${RES}`);
+    console.log(`  ${PURPLE}      / /__  ____       ${CYAN}  (_)____${RES}`);
+    console.log(`  ${PURPLE} __  / / _ \/ __ \      ${CYAN} / / ___/${RES}`);
+    console.log(`  ${PURPLE}/ /_/ /  __/ / / /${GRAY}_____${CYAN}/ / (__  )${RES}`);
+    console.log(`  ${PURPLE}\____/\___/_/ /_/${GRAY}_____/${CYAN}_/____/ ${RES}`);
+    console.log();
+    console.log(`  ${GRAY}Jen.js Framework ${DIM}v${version}${RES}`);
+    console.log();
+    console.log(`  ${GRAY}➜${RES}  ${BOLD}Local:${RES}   ${CYAN}http://localhost:${port}/${RES}`);
+    console.log(`  ${GRAY}➜${RES}  ${BOLD}Mode:${RES}    ${PURPLE}${env}${RES}`);
+    console.log();
+}

package/templates/static/lib/cli/templates/ssg/jen.config.d.ts

@@ -0,0 +1,3 @@
+import type { FrameworkConfig } from "@src/core/config";
+declare const config: FrameworkConfig;
+export default config;

package/templates/static/lib/cli/templates/ssg/jen.config.js

@@ -0,0 +1,49 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+const config = {
+    siteDir: "site",
+    distDir: "dist",
+    routes: {
+        fileExtensions: [".tsx", ".jsx", ".ts", ".js"],
+        routeFilePattern: /^\((.+)\)\.(t|j)sx?$/,
+        enableIndexFallback: true,
+    },
+    rendering: {
+        defaultMode: "ssg",
+        defaultRevalidateSeconds: 60,
+    },
+    assets: {
+        publicDir: "site/assets",
+        cacheControl: "public, max-age=31536000, immutable",
+    },
+    inject: {
+        head: [
+            `<meta charset="utf-8">`,
+            `<meta name="viewport" content="width=device-width, initial-scale=1">`,
+        ],
+        bodyEnd: [],
+    },
+    css: {
+        globalScss: "site/styles/global.scss",
+    },
+    server: {
+        port: 3000,
+        hostname: "0.0.0.0",
+    },
+};
+export default config;

package/templates/static/lib/cli/templates/ssg/site/index.d.ts

@@ -0,0 +1,2 @@
+import { h } from "preact";
+export default function Home(): h.JSX.Element;

package/templates/static/lib/cli/templates/ssg/site/index.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+export default function Home() {
+    return (_jsxs("div", { children: [_jsx("h1", { children: "Welcome to My SSG App" }), _jsx("p", { children: "This page was generated from the SSG template." })] }));
+}

package/templates/static/lib/cli/templates/ssr/jen.config.d.ts

@@ -0,0 +1,3 @@
+import type { FrameworkConfig } from "@src/core/config";
+declare const config: FrameworkConfig;
+export default config;

package/templates/static/lib/cli/templates/ssr/jen.config.js

@@ -0,0 +1,49 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+const config = {
+    siteDir: "site",
+    distDir: "dist",
+    routes: {
+        fileExtensions: [".tsx", ".jsx", ".ts", ".js"],
+        routeFilePattern: /^\((.+)\)\.(t|j)sx?$/,
+        enableIndexFallback: true,
+    },
+    rendering: {
+        defaultMode: "ssr",
+        defaultRevalidateSeconds: 60,
+    },
+    assets: {
+        publicDir: "site/assets",
+        cacheControl: "public, max-age=31536000, immutable",
+    },
+    inject: {
+        head: [
+            `<meta charset="utf-8">`,
+            `<meta name="viewport" content="width=device-width, initial-scale=1">`,
+        ],
+        bodyEnd: [],
+    },
+    css: {
+        globalScss: "site/styles/global.scss",
+    },
+    server: {
+        port: 3000,
+        hostname: "0.0.0.0",
+    },
+};
+export default config;

package/templates/static/lib/cli/templates/ssr/site/index.d.ts

@@ -0,0 +1,2 @@
+import { h } from "preact";
+export default function Home(): h.JSX.Element;

package/templates/static/lib/cli/templates/ssr/site/index.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+export default function Home() {
+    return (_jsxs("div", { children: [_jsx("h1", { children: "Welcome to My SSR App" }), _jsx("p", { children: "This page is rendered on the server." })] }));
+}

package/templates/static/lib/compilers/esbuild-plugins.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin as ESBuildPlugin } from "esbuild";
+export declare function vueEsbuildPlugin(): ESBuildPlugin;
+export declare function svelteEsbuildPlugin(): ESBuildPlugin;
+export declare function invalidateVueCache(filePath: string): void;
+export declare function invalidateSvelteCache(filePath: string): void;
+export declare function clearAllCompilerCaches(): void;

package/templates/static/lib/compilers/esbuild-plugins.js

@@ -0,0 +1,130 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { readFileSync } from "node:fs";
+import { createVueCompiler } from "./vue.js";
+import { createSvelteCompiler } from "./svelte.js";
+const vueCache = new Map();
+const svelteCache = new Map();
+export function vueEsbuildPlugin() {
+    const compiler = createVueCompiler();
+    return {
+        name: "vue",
+        setup(build) {
+            build.onLoad({ filter: /\.vue$/ }, async (args) => {
+                try {
+                    // Check cache
+                    if (vueCache.has(args.path)) {
+                        return {
+                            contents: vueCache.get(args.path),
+                            loader: "js",
+                        };
+                    }
+                    const source = readFileSync(args.path, "utf-8");
+                    const result = compiler.compile(source, {
+                        filename: args.path,
+                        id: args.path.replace(/[^a-z0-9]/gi, "_"),
+                    });
+                    if (result.error) {
+                        return {
+                            errors: [
+                                {
+                                    text: `Vue compilation failed: ${result.error}`,
+                                    location: { file: args.path, line: 1, column: 0 },
+                                },
+                            ],
+                        };
+                    }
+                    vueCache.set(args.path, result.code);
+                    return {
+                        contents: result.code,
+                        loader: "js",
+                    };
+                }
+                catch (err) {
+                    return {
+                        errors: [
+                            {
+                                text: `Vue plugin error: ${String(err)}`,
+                                location: { file: args.path, line: 1, column: 0 },
+                            },
+                        ],
+                    };
+                }
+            });
+        },
+    };
+}
+export function svelteEsbuildPlugin() {
+    const compiler = createSvelteCompiler();
+    return {
+        name: "svelte",
+        setup(build) {
+            build.onLoad({ filter: /\.svelte$/ }, async (args) => {
+                try {
+                    // Check cache
+                    if (svelteCache.has(args.path)) {
+                        return {
+                            contents: svelteCache.get(args.path),
+                            loader: "js",
+                        };
+                    }
+                    const source = readFileSync(args.path, "utf-8");
+                    const result = compiler.compile(source, {
+                        filename: args.path,
+                        dev: process.env.NODE_ENV !== "production",
+                    });
+                    if (result.error) {
+                        return {
+                            errors: [
+                                {
+                                    text: `Svelte compilation failed: ${result.error}`,
+                                    location: { file: args.path, line: 1, column: 0 },
+                                },
+                            ],
+                        };
+                    }
+                    svelteCache.set(args.path, result.code);
+                    return {
+                        contents: result.code,
+                        loader: "js",
+                    };
+                }
+                catch (err) {
+                    return {
+                        errors: [
+                            {
+                                text: `Svelte plugin error: ${String(err)}`,
+                                location: { file: args.path, line: 1, column: 0 },
+                            },
+                        ],
+                    };
+                }
+            });
+        },
+    };
+}
+export function invalidateVueCache(filePath) {
+    vueCache.delete(filePath);
+}
+export function invalidateSvelteCache(filePath) {
+    svelteCache.delete(filePath);
+}
+export function clearAllCompilerCaches() {
+    vueCache.clear();
+    svelteCache.clear();
+}

package/templates/static/lib/compilers/svelte.d.ts

@@ -0,0 +1,18 @@
+export interface SvelteCompileOptions {
+    filename?: string;
+    dev?: boolean;
+    minified?: boolean;
+    hydratable?: boolean;
+}
+export interface SvelteCompileResult {
+    code: string;
+    css?: {
+        code: string;
+        map?: any;
+    };
+    error?: string;
+}
+export declare class SvelteCompiler {
+    compile(source: string, options: SvelteCompileOptions): SvelteCompileResult;
+}
+export declare function createSvelteCompiler(): SvelteCompiler;

package/templates/static/lib/compilers/svelte.js

@@ -0,0 +1,61 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { compile as svelteCompile } from "svelte/compiler";
+import { log } from "../shared/log.js";
+export class SvelteCompiler {
+    compile(source, options) {
+        try {
+            const filename = options.filename || "component.svelte";
+            const result = svelteCompile(source, {
+                filename,
+                dev: options.dev ?? false,
+                hydratable: options.hydratable ?? false,
+                css: "injected", // Inject CSS at runtime instead of extracting
+                preserveComments: !options.minified,
+                preserveWhitespace: !options.minified,
+            });
+            if (result.warnings && result.warnings.length > 0) {
+                result.warnings.forEach((w) => {
+                    log.warn(`[Svelte] ${filename}: ${w.message}`);
+                });
+            }
+            // Build module code
+            let code = result.js.code;
+            // If CSS is generated, inject it
+            if (result.css && result.css.code.trim()) {
+                const escapedCss = result.css.code.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+                code += `
+if (typeof window !== 'undefined') {
+  const style = document.createElement('style');
+  style.textContent = "${escapedCss}";
+  document.head.appendChild(style);
+}
+`;
+            }
+            return { code };
+        }
+        catch (err) {
+            const message = err.message || String(err);
+            log.error(`[Svelte] Compilation error: ${message}`);
+            return { code: "", error: message };
+        }
+    }
+}
+export function createSvelteCompiler() {
+    return new SvelteCompiler();
+}

package/templates/static/lib/compilers/vue.d.ts

@@ -0,0 +1,15 @@
+export interface VueCompileOptions {
+    id?: string;
+    filename?: string;
+    minified?: boolean;
+    sourceMap?: boolean;
+}
+export interface VueCompileResult {
+    code: string;
+    bindings?: Record<string, any>;
+    error?: string;
+}
+export declare class VueCompiler {
+    compile(source: string, options: VueCompileOptions): VueCompileResult;
+}
+export declare function createVueCompiler(): VueCompiler;

package/templates/static/lib/compilers/vue.js

@@ -0,0 +1,99 @@
+/*
+ * This file is part of Jen.js.
+ * Copyright (C) 2026 oopsio
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { parse, compileScript, compileTemplate, compileStyle } from "@vue/compiler-sfc";
+import { log } from "../shared/log.js";
+export class VueCompiler {
+    compile(source, options) {
+        try {
+            const filename = options.filename || "component.vue";
+            const id = options.id || filename.replace(/[^a-z0-9]/gi, "_");
+            // Parse SFC
+            const parseResult = parse(source, { filename });
+            const descriptor = parseResult.descriptor;
+            let scriptCode = "";
+            let templateCode = "";
+            let styleCode = "";
+            // Compile script
+            if (descriptor.script || descriptor.scriptSetup) {
+                const scriptCompiled = compileScript(descriptor, {
+                    id,
+                    isProd: options.minified ?? false,
+                });
+                scriptCode = scriptCompiled.content;
+            }
+            // Compile template
+            if (descriptor.template) {
+                const templateCompiled = compileTemplate({
+                    source: descriptor.template.content,
+                    filename,
+                    id,
+                    compilerOptions: {
+                        isCustomElement: (tag) => tag.startsWith("custom-"),
+                    },
+                });
+                if (templateCompiled.errors.length > 0) {
+                    return {
+                        code: "",
+                        error: `Template compilation error: ${templateCompiled.errors.join(", ")}`,
+                    };
+                }
+                templateCode = templateCompiled.code;
+            }
+            // Compile styles (scoped)
+            if (descriptor.styles.length > 0) {
+                descriptor.styles.forEach((style, idx) => {
+                    const styleCompiled = compileStyle({
+                        source: style.content,
+                        filename,
+                        id,
+                        scoped: style.scoped ?? false,
+                    });
+                    if (styleCompiled.errors.length > 0) {
+                        log.warn(`Style compilation warning at style[${idx}]: ${styleCompiled.errors.join(", ")}`);
+                    }
+                    styleCode += styleCompiled.code + "\n";
+                });
+            }
+            // Inject styles at runtime
+            let injectStyle = "";
+            if (styleCode.trim()) {
+                const escapedStyle = styleCode.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+                injectStyle = `
+const style = document.createElement('style');
+style.textContent = "${escapedStyle}";
+document.head.appendChild(style);
+`;
+            }
+            // Build final module
+            const finalCode = `
+${scriptCode || "export default {}"}
+${templateCode}
+${injectStyle}
+`;
+            return { code: finalCode };
+        }
+        catch (err) {
+            const message = err.message || String(err);
+            log.error(`[Vue] Compilation error: ${message}`);
+            return { code: "", error: message };
+        }
+    }
+}
+export function createVueCompiler() {
+    return new VueCompiler();
+}