@mauroandre/velojs 0.0.1

package/bin/velojs.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = resolve(__dirname, "../src/cli.ts");
+
+const result = spawnSync("npx", ["tsx", cliPath, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+});
+
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,120 @@
+{
+    "name": "@mauroandre/velojs",
+    "version": "0.0.1",
+    "type": "module",
+    "description": "Fullstack web framework built on Hono + Preact with Vite-powered AST transforms",
+    "keywords": [
+        "framework",
+        "fullstack",
+        "hono",
+        "preact",
+        "vite",
+        "ssr",
+        "typescript"
+    ],
+    "author": "Mauro André Silva",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/mauro-andre/velojs.git"
+    },
+    "homepage": "https://github.com/mauro-andre/velojs#readme",
+    "bin": {
+        "velojs": "./bin/velojs.js"
+    },
+    "files": [
+        "src/",
+        "bin/",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "typecheck": "tsc --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "exports": {
+        ".": {
+            "types": "./src/index.ts",
+            "import": "./src/index.ts"
+        },
+        "./server": {
+            "types": "./src/server.tsx",
+            "import": "./src/server.tsx"
+        },
+        "./client": {
+            "types": "./src/client.tsx",
+            "import": "./src/client.tsx"
+        },
+        "./hooks": {
+            "types": "./src/hooks.tsx",
+            "import": "./src/hooks.tsx"
+        },
+        "./cookie": {
+            "types": "./src/cookie.ts",
+            "import": "./src/cookie.ts"
+        },
+        "./factory": {
+            "types": "./src/factory.ts",
+            "import": "./src/factory.ts"
+        },
+        "./vite": {
+            "types": "./src/vite.ts",
+            "import": "./src/vite.ts"
+        },
+        "./config": {
+            "types": "./src/config.ts",
+            "import": "./src/config.ts"
+        }
+    },
+    "typesVersions": {
+        "*": {
+            "server": [
+                "./src/server.tsx"
+            ],
+            "client": [
+                "./src/client.tsx"
+            ],
+            "hooks": [
+                "./src/hooks.tsx"
+            ],
+            "cookie": [
+                "./src/cookie.ts"
+            ],
+            "factory": [
+                "./src/factory.ts"
+            ],
+            "vite": [
+                "./src/vite.ts"
+            ],
+            "config": [
+                "./src/config.ts"
+            ]
+        }
+    },
+    "dependencies": {
+        "@babel/generator": "^7.28.5",
+        "@babel/parser": "^7.28.5",
+        "@babel/traverse": "^7.28.5",
+        "@babel/types": "^7.28.5",
+        "@hono/node-server": "^1.19.0",
+        "@hono/vite-dev-server": "^0.25.0",
+        "@preact/preset-vite": "^2.10.0",
+        "@preact/signals": "^2.8.0",
+        "hono": "^4.12.0",
+        "preact": "^10.29.0",
+        "preact-render-to-string": "^6.6.0",
+        "tsx": "^4.19.0",
+        "vite": "^7.3.0",
+        "wouter-preact": "^3.9.0"
+    },
+    "devDependencies": {
+        "@types/babel__generator": "^7.27.0",
+        "@types/babel__traverse": "^7.28.0",
+        "@types/node": "^25.5.2",
+        "typescript": "^6.0.2",
+        "vitest": "^3.2.1"
+    }
+}

package/src/cli.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env npx tsx
+
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const runCommand = (cmd: string, cmdArgs: string[] = []) => {
+    const result = spawnSync(cmd, cmdArgs, {
+        stdio: "inherit",
+        cwd: process.cwd(),
+    });
+    process.exit(result.status ?? 0);
+};
+
+const runVite = () => {
+    runCommand("npx", ["vite", ...args.slice(1)]);
+};
+
+const runBuild = () => {
+    console.log("Building client...");
+    spawnSync("npx", ["vite", "build"], { stdio: "inherit", cwd: process.cwd() });
+
+    console.log("Building server...");
+    spawnSync("npx", ["vite", "build", "--mode", "server"], { stdio: "inherit", cwd: process.cwd() });
+
+    console.log("Build complete!");
+};
+
+const runStart = () => {
+    const serverPath = resolve(process.cwd(), "dist/server.js");
+    runCommand("node", [serverPath]);
+};
+
+const showHelp = () => {
+    console.log(`
+VeloJS CLI
+
+Usage:
+  velojs <command>
+
+Commands:
+  init     Create a new VeloJS project
+  dev      Start development server
+  build    Build for production (client + server)
+  start    Start production server
+
+Examples:
+  velojs init my-app
+  velojs dev
+  velojs build
+  velojs start
+`);
+};
+
+switch (command) {
+    case "init": {
+        const { runInit } = await import("./init.js");
+        await runInit(args[1]);
+        break;
+    }
+    case "dev":
+        runVite();
+        break;
+    case "build":
+        runBuild();
+        break;
+    case "start":
+        runStart();
+        break;
+    case "help":
+    case "--help":
+    case "-h":
+        showHelp();
+        break;
+    default:
+        if (command) {
+            console.error(`Unknown command: ${command}`);
+        }
+        showHelp();
+        process.exit(1);
+}

package/src/client.tsx

@@ -0,0 +1,79 @@
+import { hydrate } from "preact";
+import { Router, Route, Switch } from "wouter-preact";
+import type { VNode } from "preact";
+import type { RouteNode, AppRoutes } from "./types.js";
+
+// ============================================
+// CLIENT OPTIONS
+// ============================================
+
+export interface StartClientOptions {
+    routes: AppRoutes;
+}
+
+// ============================================
+// BUILD ROUTES - Gera rotas do wouter recursivamente
+// ============================================
+
+const buildRoutes = (nodes: RouteNode[], nested: boolean = false): VNode[] => {
+    return nodes.map((node, index) => {
+        const Component = node.module.Component;
+
+        // Leaf node - rota final
+        if (!node.children) {
+            return (
+                <Route key={index} path={node.path || ""}>
+                    <Component />
+                </Route>
+            );
+        }
+
+        // Node com children - os children são sempre relativos com nest
+        const childRoutes = buildRoutes(node.children, !!node.path);
+
+        // isRoot - pula o componente, renderiza só os children
+        if (node.isRoot) {
+            return <Switch key={index}>{childRoutes}</Switch>;
+        }
+
+        // Sem path - wrapper puro (sem Route)
+        if (!node.path) {
+            return (
+                <Component key={index}>
+                    <Switch>{childRoutes}</Switch>
+                </Component>
+            );
+        }
+
+        // Layout com path + nest
+        return (
+            <Route key={index} path={node.path} nest>
+                <Component>
+                    <Switch>{childRoutes}</Switch>
+                </Component>
+            </Route>
+        );
+    });
+};
+
+// ============================================
+// CLIENT ROUTES - Componente de rotas
+// ============================================
+
+const ClientRoutes = ({ routes }: { routes: AppRoutes }) => {
+    const routeTree = buildRoutes(routes);
+    return <Router>{routeTree}</Router>;
+};
+
+// ============================================
+// START CLIENT - Entry point principal
+// ============================================
+
+export const startClient = (options: StartClientOptions) => {
+    const { routes } = options;
+    const body = document.querySelector("body");
+
+    if (body) {
+        hydrate(<ClientRoutes routes={routes} />, body);
+    }
+};

package/src/components.tsx

@@ -0,0 +1,155 @@
+/**
+ * VeloJS Components
+ * Components that can be used in the app for script/style injection
+ */
+
+import { Link as WouterLink } from "wouter-preact";
+import type { ComponentChildren } from "preact";
+
+// ============================================
+// SCRIPTS COMPONENT
+// ============================================
+
+interface ScriptsProps {
+    /**
+     * Base path for static assets in production
+     * @default ""
+     */
+    basePath?: string;
+
+    /**
+     * Path to the favicon file relative to the public directory
+     * Set to false to disable favicon injection
+     * @default "/favicon.ico"
+     */
+    favicon?: string | false;
+}
+
+/**
+ * Injects the necessary scripts and styles for VeloJS.
+ * In dev mode: injects Vite HMR client and velo client script
+ * In production: injects compiled CSS and JS
+ *
+ * @example
+ * ```tsx
+ * <head>
+ *     <Scripts />
+ * </head>
+ * ```
+ */
+export function Scripts({ basePath, favicon = "/favicon.ico" }: ScriptsProps = {}) {
+    const isDev = import.meta.env.DEV;
+    basePath = basePath || process.env.STATIC_BASE_URL || "";
+
+    const faviconTag = favicon !== false && (
+        <link rel="icon" href={`${basePath}${favicon}`} type="image/x-icon" />
+    );
+
+    if (isDev) {
+        return (
+            <>
+                {faviconTag}
+                <script type="module" src="/@vite/client"></script>
+                <script type="module" src="/__velo_client.js"></script>
+            </>
+        );
+    }
+
+    return (
+        <>
+            {faviconTag}
+            <link rel="stylesheet" href={`${basePath}/client.css`} />
+            <script type="module" src={`${basePath}/client.js`}></script>
+        </>
+    );
+}
+
+// ============================================
+// LINK COMPONENT
+// ============================================
+
+import type { ComponentProps } from "preact";
+import type { RouteModule } from "./types.js";
+
+// Props do Link do wouter, mas com "to" estendido
+type WouterLinkProps = ComponentProps<typeof WouterLink>;
+type LinkProps = Omit<WouterLinkProps, "to" | "href"> & {
+    /**
+     * Destination - can be a string path or a module with metadata
+     */
+    to: string | RouteModule;
+
+    /**
+     * URL parameters to substitute in the path
+     * e.g., { id: "123" } replaces :id with 123
+     */
+    params?: Record<string, string>;
+
+    /**
+     * Query string parameters appended to the URL
+     * e.g., { company: "abc" } appends ?company=abc
+     */
+    search?: Record<string, string> | undefined;
+
+    /**
+     * When true, ignores current URL params and uses fullPath as-is
+     * By default, params are extracted from current URL and substituted
+     * @default false
+     */
+    absolute?: boolean;
+};
+
+/**
+ * Substitutes :param placeholders in a path with actual values
+ */
+export function substituteParams(
+    path: string,
+    params: Record<string, string>
+): string {
+    let result = path;
+    for (const [key, value] of Object.entries(params)) {
+        result = result.replace(`:${key}`, value);
+    }
+    return result;
+}
+
+/**
+ * Link component for navigation.
+ * Accepts either a string path or a route module.
+ *
+ * @example
+ * ```tsx
+ * // With string path
+ * <Link to="/login">Login</Link>
+ *
+ * // With route module (relative - uses path, works with nest)
+ * <Link to={McpPage}>MCP</Link>
+ *
+ * // With route module (absolute - uses fullPath)
+ * <Link to={LoginPage} absolute>Login</Link>
+ *
+ * // With explicit params
+ * <Link to={UserPage} params={{ id: "123" }}>View User</Link>
+ * ```
+ */
+export function Link({ to, params, search, absolute, ...rest }: LinkProps) {
+    const isModule = typeof to !== "string";
+
+    // Default: path (relative), absolute: fullPath
+    const basePath = isModule
+        ? (absolute ? to.metadata?.fullPath : to.metadata?.path) ?? "/"
+        : to;
+
+    // Substitute params if provided
+    const finalPath = params ? substituteParams(basePath, params) : basePath;
+
+    // Absolute module paths: prefix with ~ for wouter absolute navigation
+    const routePath = isModule && absolute ? `~${finalPath}` : finalPath;
+
+    // Append query string if search params provided
+    const queryString = search
+        ? `?${new URLSearchParams(search).toString()}`
+        : "";
+
+    return <WouterLink to={`${routePath}${queryString}`} {...rest} />;
+}

package/src/config.ts

@@ -0,0 +1,29 @@
+export interface VeloConfig {
+    /**
+     * Diretório base da aplicação onde estão as rotas
+     * @default "./app"
+     */
+    appDirectory?: string;
+
+    /**
+     * Arquivo de rotas com export default AppRoutes
+     * @default "routes.tsx"
+     */
+    routesFile?: string;
+
+    /**
+     * Arquivo de inicialização do servidor (custom init, sem velojs imports)
+     * @default "server.tsx"
+     */
+    serverInit?: string;
+
+    /**
+     * Arquivo de inicialização do cliente (custom init, sem velojs imports)
+     * @default "client.tsx"
+     */
+    clientInit?: string;
+}
+
+export function defineConfig(config: VeloConfig): VeloConfig {
+    return config;
+}

package/src/cookie.ts

@@ -0,0 +1,7 @@
+export {
+    getCookie,
+    getSignedCookie,
+    setCookie,
+    setSignedCookie,
+    deleteCookie,
+} from "hono/cookie";

package/src/factory.ts

@@ -0,0 +1 @@
+export { createMiddleware, createFactory } from "hono/factory";