create-jen-app 0.1.0

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();
+}

package/templates/static/lib/core/config.d.ts

@@ -0,0 +1,53 @@
+export type RenderMode = "ssr" | "ssg" | "isr" | "ppr";
+export type FrameworkConfig = {
+    siteDir: string;
+    distDir: string;
+    routes: {
+        fileExtensions: string[];
+        routeFilePattern: RegExp;
+        enableIndexFallback: boolean;
+    };
+    rendering: {
+        defaultMode: RenderMode;
+        defaultRevalidateSeconds: number;
+    };
+    inject: {
+        head: string[];
+        bodyEnd: string[];
+    };
+    css: {
+        globalScss: string;
+        criticalBudget?: number;
+        extractCritical?: boolean;
+    };
+    assets: {
+        publicDir: string;
+        cacheControl: string;
+        hashLength?: number;
+    };
+    server: {
+        port: number;
+        hostname: string;
+    };
+    build?: {
+        minifyHtml?: boolean;
+        minifyCss?: boolean;
+        minifyJs?: boolean;
+        hashAssets?: boolean;
+        generateManifest?: boolean;
+        generateSitemap?: boolean;
+        cacheDir?: string;
+        incrementalBuild?: boolean;
+        sourceMap?: boolean;
+    };
+    dev?: {
+        enableSSR?: boolean;
+        liveReload?: boolean;
+        port?: number;
+    };
+    seo?: {
+        generateRobotsTxt?: boolean;
+        generateSitemap?: boolean;
+        sitemapBaseUrl?: string;
+    };
+};

package/templates/static/lib/core/config.js

@@ -0,0 +1,18 @@
+/*
+ * 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 {};

package/templates/static/lib/core/http.d.ts

@@ -0,0 +1,3 @@
+import type { IncomingMessage } from "node:http";
+export declare function parseCookies(req: IncomingMessage): Record<string, string>;
+export declare function headersToObject(headers: IncomingMessage["headers"]): Record<string, string>;

package/templates/static/lib/core/http.js

@@ -0,0 +1,42 @@
+/*
+ * 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 function parseCookies(req) {
+    const cookie = req.headers.cookie;
+    if (!cookie)
+        return {};
+    const out = {};
+    for (const part of cookie.split(";")) {
+        const [k, ...rest] = part.trim().split("=");
+        const trimmedName = k.trim();
+        const trimmedValue = rest.join("=").trim();
+        if (trimmedName && trimmedValue) {
+            out[trimmedName] = decodeURIComponent(trimmedValue);
+        }
+    }
+    return out;
+}
+export function headersToObject(headers) {
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (Array.isArray(v))
+            out[k] = v.join(", ");
+        else if (typeof v === "string")
+            out[k] = v;
+    }
+    return out;
+}

package/templates/static/lib/core/middleware-hooks.d.ts

@@ -0,0 +1,46 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * Route middleware context. Available to middleware functions.
+ */
+export interface RouteMiddlewareContext {
+    req: IncomingMessage;
+    res: ServerResponse;
+    url: URL;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    headers: Record<string, string>;
+    cookies: Record<string, string>;
+    data?: Record<string, any>;
+    status: (code: number) => RouteMiddlewareContext;
+    setHeader: (key: string, value: string) => RouteMiddlewareContext;
+    redirect: (url: string, statusCode?: number) => never;
+    json: (data: any, statusCode?: number) => never;
+}
+/**
+ * Route middleware function signature.
+ * Return undefined/void to continue to next middleware/page.
+ * Call ctx.redirect() or ctx.json() to short-circuit.
+ */
+export type RouteMiddleware = (ctx: RouteMiddlewareContext) => Promise<void> | void;
+/**
+ * Note: Route module types (middleware, hydrate fields) are defined in core/types.ts
+ * This module just provides the middleware execution primitives.
+ */
+/**
+ * Create middleware context from request.
+ * Called by server before rendering route.
+ */
+export declare function createRouteMiddlewareContext(opts: {
+    req: IncomingMessage;
+    res: ServerResponse;
+    url: URL;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    headers: Record<string, string>;
+    cookies: Record<string, string>;
+}): RouteMiddlewareContext;
+/**
+ * Execute route middlewares in sequence.
+ * If any middleware calls redirect() or json(), it throws and stops execution.
+ */
+export declare function executeRouteMiddleware(middlewares: RouteMiddleware[], ctx: RouteMiddlewareContext): Promise<void>;

package/templates/static/lib/core/middleware-hooks.js

@@ -0,0 +1,69 @@
+/*
+ * 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/>.
+ */
+/**
+ * Note: Route module types (middleware, hydrate fields) are defined in core/types.ts
+ * This module just provides the middleware execution primitives.
+ */
+/**
+ * Create middleware context from request.
+ * Called by server before rendering route.
+ */
+export function createRouteMiddlewareContext(opts) {
+    const ctx = {
+        ...opts,
+        data: {},
+        status: function (code) {
+            this.res.statusCode = code;
+            return this;
+        },
+        setHeader: function (key, value) {
+            this.res.setHeader(key, value);
+            return this;
+        },
+        redirect: function (url, statusCode = 302) {
+            this.res.statusCode = statusCode;
+            this.res.setHeader("location", url);
+            this.res.end();
+            throw new Error("__REDIRECT__");
+        },
+        json: function (data, statusCode = 200) {
+            this.res.statusCode = statusCode;
+            this.res.setHeader("content-type", "application/json; charset=utf-8");
+            this.res.end(JSON.stringify(data));
+            throw new Error("__JSON__");
+        },
+    };
+    return ctx;
+}
+/**
+ * Execute route middlewares in sequence.
+ * If any middleware calls redirect() or json(), it throws and stops execution.
+ */
+export async function executeRouteMiddleware(middlewares, ctx) {
+    for (const mw of middlewares) {
+        try {
+            await mw(ctx);
+        }
+        catch (err) {
+            if (err.message === "__REDIRECT__" || err.message === "__JSON__") {
+                throw err;
+            }
+            throw err;
+        }
+    }
+}

package/templates/static/lib/core/paths.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveSitePath(config: {
+    siteDir: string;
+}, ...p: string[]): string;
+export declare function resolveDistPath(config: {
+    distDir: string;
+}, ...p: string[]): string;

package/templates/static/lib/core/paths.js

@@ -0,0 +1,24 @@
+/*
+ * 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 { join } from "node:path";
+export function resolveSitePath(config, ...p) {
+    return join(process.cwd(), config.siteDir, ...p);
+}
+export function resolveDistPath(config, ...p) {
+    return join(process.cwd(), config.distDir, ...p);
+}

package/templates/static/lib/core/routes/match.d.ts

@@ -0,0 +1,6 @@
+import type { RouteEntry } from "./scan.js";
+export type MatchResult = {
+    route: RouteEntry;
+    params: Record<string, string>;
+};
+export declare function matchRoute(routes: RouteEntry[], pathname: string): MatchResult | null;

package/templates/static/lib/core/routes/match.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 function matchRoute(routes, pathname) {
+    for (const r of routes) {
+        const re = new RegExp(r.pattern);
+        const m = pathname.match(re);
+        if (!m)
+            continue;
+        const params = {};
+        for (let i = 0; i < r.paramNames.length; i++) {
+            params[r.paramNames[i]] = decodeURIComponent(m[i + 1] ?? "");
+        }
+        return { route: r, params };
+    }
+    return null;
+}

package/templates/static/lib/core/routes/scan.d.ts

@@ -0,0 +1,9 @@
+import type { FrameworkConfig } from "../config.js";
+export type RouteEntry = {
+    id: string;
+    filePath: string;
+    urlPath: string;
+    pattern: string;
+    paramNames: string[];
+};
+export declare function scanRoutes(config: FrameworkConfig): RouteEntry[];