defuss-ssg 0.3.0 → 0.4.0

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.
 
@@ -318,4 +335,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,17 @@
 #!/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-DyhxNy3G.mjs';
+import { d as dev, s as serve } from './serve-CLC1GbGD.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 '@mdx-js/rollup';
+import 'fast-glob';
+import 'vite';
+import 'defuss-vite';
+import 'defuss/server';
+import 'node:url';
+import 'node:os';
 import 'esbuild';
 import 'rehype-katex';
 import 'rehype-stringify';
@@ -18,10 +22,8 @@ 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 'node:crypto';
+import 'defuss-express';
 
 const canResolve = (dep, dir) => {
   let current = dir;
@@ -68,7 +70,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 +116,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}...`);
@@ -134,7 +139,7 @@ const setup = async (projectDir) => {
     const bunEnv = { ...process.env, BUN_WORKSPACE_ROOT: projectDir };
     await runInstall(
       pm,
-      ["install", "--linker", "isolated"],
+      pm === "bun" ? ["install", "--no-cache", "--linker", "isolated"] : ["install"],
       projectDir,
       pm === "bun" ? bunEnv : void 0
     );
@@ -151,13 +156,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 +174,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 +213,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);