defuss-ssg 0.3.1 → 0.5.1

package/README.md

@@ -29,7 +29,7 @@ bunx defuss-ssg build ./folder
 Or install globally or locally in a project:
 
 ```bash 
-npm install -g defuss-ssg
+bun add -g defuss-ssg
 ```
 
 And then run (in an NPM script or globally):
@@ -40,13 +40,13 @@ And then run (in an NPM script or globally):
 defuss-ssg build ./folder
 ```
 
-<h4>Serve-mode with automatic re-build on change</h4>
+<h4>Vite-powered development</h4>
 
 ```bash
-defuss-ssg serve ./folder
+defuss-ssg dev ./folder
 ```
 
-This starts a local server at http://localhost:3000 and watches for changes in:
+This starts a Vite dev server at http://localhost:3000 and watches for changes in:
 
 - `pages/` directory
 - `components/` directory
@@ -54,6 +54,16 @@ This starts a local server at http://localhost:3000 and watches for changes in:
 
 Changes trigger automatic rebuilds, with the last change always taking priority to prevent build queueing issues.
 
+The current migration bridge still writes dev output to `dist/` while the request-time Vite renderer is being moved over.
+
+<h4>Production serving</h4>
+
+```bash
+defuss-ssg serve ./folder
+```
+
+This serves already-built output with `defuss-express`. Run `defuss-ssg build ./folder` first.
+
 <h4>Local development of SSG and running the example</h4>
 
 Unlike other SSG systems, this package is **not** meant to be installed in a project, but rather used as a global CLI tool or programmatically.
@@ -61,14 +71,14 @@ Unlike other SSG systems, this package is **not** meant to be installed in a pro
 Developing this means to clone the repo, install dependencies and run the example site:
 
 ```bash
-git clone
+git clone https://github.com/kyr0/defuss.git
 
 cd defuss/packages/ssg
 
 bun i && bun build
 
 # for building and serving the example site with auto-rebuild:
-bun run cli-serve ./example
+bun run cli-dev ./example
 
 # for one-time build of the example site:
 bun run cli-build ./example
@@ -81,7 +91,7 @@ Please create a PR or issue if you find any bugs or have feature requests.
 Advanced users may want to use the library programmatically:
 
 ```typescript
-import { setup, build, serve } from "defuss-ssg";
+import { setup, build, dev, serve } from "defuss-ssg";
 
 (async () => {
 
@@ -98,11 +108,17 @@ import { setup, build, serve } from "defuss-ssg";
     debug: true,
   });
 
-  // Or serve with auto-rebuild
-  await serve({
+  // Or start the Vite-backed dev server
+  await dev({
     projectDir: "./my-site", 
     debug: true,
   });
+
+  // Or serve an already-built production output
+  await serve({
+    projectDir: "./my-site",
+    workers: "auto",
+  });
 })();
 ```
 
@@ -112,7 +128,7 @@ Overview
 
 > `defuss-ssg` is a CLI tool and library for building static websites using modern JavaScript/TypeScript and `defuss`. It reads content files (Markdown, MDX) from a specified directory, processes them with MDX plugins, compiles components with esbuild, and outputs fully static HTML sites ready for deployment.
 
-> It supports a plugin system for extending the build process at various phases (pre-build, post-build, page-level transformations), automatic file watching and rebuilding in serve mode, and seamless integration with defuss components for interactive features.
+> It supports a plugin system for extending the build process at various phases (pre-build, post-build, page-level transformations), Vite-backed development, and defuss-express production serving.
 
 <h3 align="center">
 
@@ -123,8 +139,9 @@ Features
 - **MDX Support**: Full Markdown + JSX support with frontmatter parsing
 - **Component Integration**: Use defuss components in your MDX files
 - **Plugin System**: Extend the build process with custom plugins at multiple phases
-- **Fast Compilation**: Powered by esbuild for quick builds and hot reloading
-- **Serve Mode**: Built-in development server with file watching and auto-rebuild
+- **Fast Compilation**: Powered by esbuild today, with Vite now orchestrating development
+- **Dev Mode**: Vite-backed development server with auto-rebuild and full reload
+- **Production Runtime**: `defuss-express` serves static output plus dynamic endpoints and RPC
 - **TypeScript Ready**: Full TypeScript support for components and configuration
 - **Asset Handling**: Automatic copying of static assets to output directory
 - **Flexible Configuration**: Configurable via TypeScript config file with sensible defaults
@@ -139,15 +156,15 @@ Create a project structure like this:
 
 ```typescript
 my-site/
-├── pages/
-│   ├── index.mdx
-│   └── blog/
-│       └── hello-world.mdx
-├── components/
-│   └── button.tsx
-├── assets/
-│   └── styles.css
-└── config.ts
+├-- pages/
+│   ├-- index.mdx
+│   └-- blog/
+│       └-- hello-world.mdx
+├-- components/
+│   └-- button.tsx
+├-- assets/
+│   └-- styles.css
+└-- config.ts
 ```
 Then run `defuss-ssg build ./my-site` and a `dist` folder will be created with the complete static build.
 
@@ -310,6 +327,38 @@ Commands:
   serve <folder>    Serve with auto-rebuild on changes
 ```
 
+<h3 align="center">
+Benchmark
+</h3>
+
+The following benchmark was performed on the RPC endpoint of the example site, which calls a simple server-side function that adds two numbers. The test was run with 1024 concurrent connections, a pipelining factor of 256, and 8 workers for 30 seconds on a Macbook Air M4, 24 GB RAM under medium load (IDE, browser, docker, Spotify, Mail and terminal running while the benchmark was conducted).
+
+```bash
+$ bun x autocannon -p 256 -w 8 -c 1024 -d 30 -m POST -H 'content-type: application/json' -b '{"className":"mathApi","methodName":"add","args":[1,2]}' http://127.0.0.1:3000/rpc
+Running 30s test @ http://127.0.0.1:3000/rpc
+1024 connections with 256 pipelining factor
+8 workers
+
+/
+┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐
+│ Stat    │ 2.5%   │ 50%     │ 97.5%   │ 99%     │ Avg        │ Stdev      │ Max     │
+├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤
+│ Latency │ 617 ms │ 4708 ms │ 5629 ms │ 6230 ms │ 4367.37 ms │ 1263.71 ms │ 7115 ms │
+└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘
+┌───────────┬─────────┬─────────┬─────────┬─────────┬──────────┬─────────┬─────────┐
+│ Stat      │ 1%      │ 2.5%    │ 50%     │ 97.5%   │ Avg      │ Stdev   │ Min     │
+├───────────┼─────────┼─────────┼─────────┼─────────┼──────────┼─────────┼─────────┤
+│ Req/Sec   │ 41,215  │ 41,215  │ 54,559  │ 66,751  │ 55,371.2 │ 5,492.3 │ 41,210  │
+├───────────┼─────────┼─────────┼─────────┼─────────┼──────────┼─────────┼─────────┤
+│ Bytes/Sec │ 8.37 MB │ 8.37 MB │ 11.1 MB │ 13.5 MB │ 11.2 MB  │ 1.11 MB │ 8.37 MB │
+└───────────┴─────────┴─────────┴─────────┴─────────┴──────────┴─────────┴─────────┘
+
+Req/Bytes counts sampled once per second.
+# of samples: 240
+
+1923k requests in 30.08s, 337 MB read
+```
+
 <p align="center">
 
   <img src="https://raw.githubusercontent.com/kyr0/defuss/refs/heads/main/assets/defuss_comic.png" width="400px" />
@@ -318,4 +367,4 @@ Commands:
 
 <p align="center">
   <i><b>Come visit us on <code>defuss</code> Island!</b></i>
-</p>
+</p>

package/dist/cli.mjs

@@ -1,13 +1,18 @@
 #!/usr/bin/env node
-import { v as validateProjectDir, b as build, s as serve } from './serve-C7GCBFVo.mjs';
+import { v as validateProjectDir, b as build } from './vite-B4oPT39d.mjs';
+import { d as dev, s as serve } from './serve-BJ00mBAJ.mjs';
 import { join, dirname, resolve } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
 import { spawn } from 'node:child_process';
-import 'node:os';
-import 'chokidar';
-import 'elysia';
-import '@elysiajs/static';
 import 'node:fs/promises';
+import 'node:url';
+import 'defuss/server';
+import 'node:crypto';
+import '@mdx-js/rollup';
+import 'fast-glob';
+import 'vite';
+import 'defuss-vite';
+import 'node:os';
 import 'esbuild';
 import 'rehype-katex';
 import 'rehype-stringify';
@@ -17,11 +22,7 @@ import 'remark-gfm';
 import 'remark-parse';
 import 'remark-rehype';
 import 'remark-mdx-frontmatter';
-import './tailwind-DV23JSh-.mjs';
-import '@mdx-js/esbuild';
-import 'fast-glob';
-import 'defuss/server';
-import 'node:url';
+import 'defuss-express';
 
 const canResolve = (dep, dir) => {
   let current = dir;
@@ -68,7 +69,12 @@ const runInstall = (cmd, args, cwd, env) => new Promise((resolve, reject) => {
   child.on("error", reject);
   child.on("close", (code) => {
     if (code === 0) resolve();
-    else reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code ?? "unknown"}`));
+    else
+      reject(
+        new Error(
+          `${cmd} ${args.join(" ")} exited with code ${code ?? "unknown"}`
+        )
+      );
   });
 });
 const setup = async (projectDir) => {
@@ -109,9 +115,7 @@ const setup = async (projectDir) => {
   );
   const allResolvable = depNames.length === 0 || depNames.every((d) => canResolve(d, projectDir));
   if (allResolvable) {
-    console.log(
-      `All dependencies already available \u2014 skipping install.`
-    );
+    console.log(`All dependencies already available - skipping install.`);
     return { code: "OK", message: "Setup completed (deps already available)" };
   }
   console.log(`Setting up project in ${projectDir} using ${pm}...`);
@@ -151,13 +155,13 @@ Falling back to npm install...`
       } catch (npmError) {
         console.warn(
           `Warning: npm install also failed: ${npmError.message}
-Continuing anyway \u2014 dependencies may already be available.`
+Continuing anyway - dependencies may already be available.`
         );
       }
     } else {
       console.warn(
         `Warning: ${error.message}
-Continuing anyway \u2014 dependencies may already be available.`
+Continuing anyway - dependencies may already be available.`
       );
     }
   }
@@ -169,16 +173,38 @@ Continuing anyway \u2014 dependencies may already be available.`
   const debug = args.includes("--debug") || args.includes("-d");
   const multicore = args.includes("--multicore");
   const positional = args.filter((a) => !a.startsWith("-"));
-  const command = positional[0];
-  const folder = positional[1];
-  const usage = "Usage: defuss-ssg <build|serve> <folder> [--debug] [--multicore]";
-  if (!command || !folder) {
-    console.error(usage);
-    process.exit(1);
+  const usage = "Usage: defuss-ssg [dev|build|serve] [folder]\n  No args           \u2192 serve .\n  Single path       \u2192 serve <path>\n  Single command    \u2192 <command> .\n  Command + folder  \u2192 <command> <folder>\n  Flags: [--debug] [--multicore]";
+  let command;
+  let folder;
+  if (positional.length === 0) {
+    command = "serve";
+    folder = ".";
+  } else if (positional.length === 1) {
+    const arg = positional[0];
+    if (arg === "dev" || arg === "build" || arg === "serve") {
+      command = arg;
+      folder = ".";
+    } else if (arg.startsWith(".") || arg.startsWith("/")) {
+      command = "serve";
+      folder = arg;
+    } else {
+      console.error(usage);
+      process.exit(1);
+    }
+  } else {
+    command = positional[0];
+    folder = positional[1];
   }
   const projectDir = resolve(folder);
   await setup(projectDir);
-  if (command === "build") {
+  if (command === "dev") {
+    console.log(`Starting Vite dev server for ${folder}...`);
+    await dev({
+      projectDir,
+      debug,
+      writeDevOutput: true
+    });
+  } else if (command === "build") {
     console.log(`Building ${folder}...`);
     await build({
       projectDir,
@@ -186,11 +212,11 @@ Continuing anyway \u2014 dependencies may already be available.`
       mode: "build"
     });
   } else if (command === "serve") {
-    console.log(`Serving ${folder}...`);
+    console.log(`Serving built output for ${folder}...`);
     await serve({
       projectDir,
       debug,
-      multicore
+      workers: multicore ? "auto" : 1
     });
   } else {
     console.error(usage);