defuss-ssg 0.1.0 → 0.1.2

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { v as validateProjectDir, b as build, s as serve } from './serve-BR2MS6bN.mjs';
-import { join, resolve } from 'node:path';
+import { v as validateProjectDir, b as build, s as serve } from './serve-CMNixAKF.mjs';
+import { join, dirname, resolve } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
 import { spawn } from 'node:child_process';
 import 'chokidar';
@@ -22,6 +22,54 @@ import 'node:fs/promises';
 import 'node:url';
 import 'node:module';
 
+const canResolve = (dep, dir) => {
+  let current = dir;
+  while (true) {
+    if (existsSync(join(current, "node_modules", dep))) return true;
+    const parent = dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return false;
+};
+const runInstall = (cmd, args, cwd, env) => new Promise((resolve, reject) => {
+  const child = spawn(cmd, args, {
+    cwd,
+    shell: true,
+    stdio: ["inherit", "pipe", "pipe"],
+    env: env ?? process.env
+  });
+  const lastLines = [];
+  let printedLines = 0;
+  const pushLine = (line) => {
+    lastLines.push(line);
+    if (lastLines.length > 3) lastLines.shift();
+    if (process.stdout.isTTY) {
+      for (let i = 0; i < printedLines; i++) {
+        process.stdout.write("\x1B[1A\x1B[2K");
+      }
+      for (const l of lastLines) {
+        process.stdout.write(`${l}
+`);
+      }
+      printedLines = lastLines.length;
+    } else {
+      process.stdout.write(`${line}
+`);
+    }
+  };
+  const handleData = (chunk) => {
+    const lines = chunk.toString().split(/\r\n|\n|\r/).filter((l) => l.trim().length > 0);
+    for (const line of lines) pushLine(line);
+  };
+  child.stdout?.on("data", handleData);
+  child.stderr?.on("data", handleData);
+  child.on("error", reject);
+  child.on("close", (code) => {
+    if (code === 0) resolve();
+    else reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code ?? "unknown"}`));
+  });
+});
 const setup = async (projectDir) => {
   const projectDirStatus = validateProjectDir(projectDir);
   if (projectDirStatus.code !== "OK") return projectDirStatus;
@@ -50,69 +98,78 @@ const setup = async (projectDir) => {
       message: `Unsupported package manager: ${pm}`
     };
   }
+  const allDeps = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies
+  };
+  const depNames = Object.keys(allDeps).filter(
+    (d) => d !== "defuss-ssg"
+    // skip self-reference (we're already running)
+  );
+  const allResolvable = depNames.length === 0 || depNames.every((d) => canResolve(d, projectDir));
+  if (allResolvable) {
+    console.log(
+      `All dependencies already available \u2014 skipping install.`
+    );
+    return { code: "OK", message: "Setup completed (deps already available)" };
+  }
   console.log(`Setting up project in ${projectDir} using ${pm}...`);
-  try {
-    await new Promise((resolve, reject) => {
-      const child = spawn(pm, ["install"], {
-        cwd: projectDir,
-        shell: true,
-        stdio: ["inherit", "pipe", "pipe"]
+  if (pm === "bun") {
+    try {
+      await new Promise((resolve, reject) => {
+        const child = spawn(pm, ["pm", "trust", "esbuild"], {
+          cwd: projectDir,
+          shell: true,
+          stdio: "ignore",
+          env: { ...process.env, BUN_WORKSPACE_ROOT: projectDir }
+        });
+        child.on("error", reject);
+        child.on("close", () => resolve());
       });
-      const lastLines = [];
-      let printedLines = 0;
-      const pushLine = (line) => {
-        lastLines.push(line);
-        if (lastLines.length > 3) lastLines.shift();
-        if (process.stdout.isTTY) {
-          for (let i = 0; i < printedLines; i++) {
-            process.stdout.write("\x1B[1A\x1B[2K");
-          }
-          for (const l of lastLines) {
-            process.stdout.write(`${l}
-`);
-          }
-          printedLines = lastLines.length;
-        } else {
-          process.stdout.write(`${line}
-`);
-        }
-      };
-      const handleData = (chunk) => {
-        const lines = chunk.toString().split(/\r\n|\n|\r/).filter((l) => l.trim().length > 0);
-        for (const line of lines) {
-          pushLine(line);
-        }
-      };
-      child.stdout?.on("data", handleData);
-      child.stderr?.on("data", handleData);
-      child.on("error", reject);
-      child.on("close", (code) => {
-        if (code === 0) {
-          resolve();
-        } else {
-          reject(
-            new Error(
-              `${pm} install exited with code ${code ?? "unknown"}`
-            )
-          );
-        }
-      });
-    });
+    } catch {
+    }
+  }
+  try {
+    const bunEnv = { ...process.env, BUN_WORKSPACE_ROOT: projectDir };
+    await runInstall(
+      pm,
+      ["install", "--linker", "isolated"],
+      projectDir,
+      pm === "bun" ? bunEnv : void 0
+    );
     console.log("Dependencies installed successfully.");
   } catch (error) {
-    return {
-      code: "INSTALL_FAILED",
-      message: `Failed to install dependencies: ${error.message}`
-    };
+    if (pm === "bun") {
+      console.warn(
+        `Warning: ${error.message}
+Falling back to npm install...`
+      );
+      try {
+        await runInstall("npm", ["install"], projectDir);
+        console.log("Dependencies installed successfully via npm.");
+      } catch (npmError) {
+        console.warn(
+          `Warning: npm install also failed: ${npmError.message}
+Continuing anyway \u2014 dependencies may already be available.`
+        );
+      }
+    } else {
+      console.warn(
+        `Warning: ${error.message}
+Continuing anyway \u2014 dependencies may already be available.`
+      );
+    }
   }
   return { code: "OK", message: "Setup completed successfully" };
 };
 
 (async () => {
   const args = process.argv.slice(2);
-  const command = args[0];
-  const folder = args[1];
-  const usage = "Usage: defuss-ssg <build|serve> <folder>";
+  const debug = args.includes("--debug") || args.includes("-d");
+  const positional = args.filter((a) => !a.startsWith("-"));
+  const command = positional[0];
+  const folder = positional[1];
+  const usage = "Usage: defuss-ssg <build|serve> <folder> [--debug]";
   if (!command || !folder) {
     console.error(usage);
     process.exit(1);
@@ -123,14 +180,14 @@ const setup = async (projectDir) => {
     console.log(`Building ${folder}...`);
     await build({
       projectDir,
-      debug: true,
+      debug,
       mode: "build"
     });
   } else if (command === "serve") {
     console.log(`Serving ${folder}...`);
     await serve({
       projectDir,
-      debug: true});
+      debug});
   } else {
     console.error(usage);
     process.exit(1);

package/dist/index.cjs

@@ -208,15 +208,13 @@ const __dirname$1 = node_path.dirname(__filename$1);
 const build = async ({
   projectDir,
   debug = false,
-  mode = "build"
+  mode = "build",
+  changedFile
 }) => {
   const projectDirStatus = validateProjectDir(projectDir);
   if (projectDirStatus.code !== "OK") return projectDirStatus;
   const startTime = performance.now();
   const config = await readConfig(projectDir, debug);
-  if (debug) {
-    console.log("PRE config", config);
-  }
   if (debug) {
     console.log("Using config:", config);
   }
@@ -245,193 +243,213 @@ const build = async ({
   }
   if (!node_fs.existsSync(inputPagesDir)) {
     throw new Error(`Input pages directory does not exist: ${inputPagesDir}`);
-  } else if (debug) {
-    console.log(`Input pages directory exists: ${inputPagesDir}`);
   }
-  if (!node_fs.existsSync(inputComponentsDir)) {
-    console.warn(
-      `There is no components directory: ${inputComponentsDir}. You may not be able to use any custom components.`
-    );
-  }
-  if (!node_fs.existsSync(inputAssetsDir)) {
-    console.warn(
-      `There is no assets directory: ${inputAssetsDir}. You may not be able to serve any custom assets.`
-    );
+  let changeKind = "full";
+  let changedRelative = "";
+  if (changedFile) {
+    changedRelative = changedFile.startsWith(projectDir) ? changedFile.slice(projectDir.length).replace(/^\//, "") : changedFile;
+    if (changedRelative.startsWith(config.pages + node_path.sep) || changedRelative.startsWith(config.pages + "/")) {
+      changeKind = "page";
+    } else if (changedRelative.startsWith(config.components + node_path.sep) || changedRelative.startsWith(config.components + "/")) {
+      changeKind = "component";
+    } else if (changedRelative.startsWith(config.assets + node_path.sep) || changedRelative.startsWith(config.assets + "/")) {
+      changeKind = "asset";
+    } else if (changedRelative === "config.ts" || changedRelative === "config.js") {
+      changeKind = "config";
+    }
+    if (debug) {
+      console.log(`Incremental build \u2014 changeKind: ${changeKind}, file: ${changedRelative}`);
+    }
   }
-  for (const plugin of config.plugins || []) {
-    if (plugin.phase === "pre" && (plugin.mode === mode || plugin.mode === "both")) {
-      if (debug) {
-        console.log(`Running pre-plugin: ${plugin.name}`);
+  const isFullBuild = changeKind === "full" || changeKind === "config";
+  const tempExists = node_fs.existsSync(config.tmp);
+  if (isFullBuild) {
+    for (const plugin of config.plugins || []) {
+      if (plugin.phase === "pre" && (plugin.mode === mode || plugin.mode === "both")) {
+        if (debug) {
+          console.log(`Running pre-plugin: ${plugin.name}`);
+        }
+        await plugin.fn(projectDir, config);
       }
-      await plugin.fn(projectDir, config);
     }
   }
-  if (node_fs.existsSync(config.tmp)) {
-    if (debug) {
-      console.log(`Removing existing temp folder: ${config.tmp}`);
+  if (isFullBuild || !tempExists) {
+    if (tempExists) {
+      node_fs.rmSync(config.tmp, { recursive: true });
     }
-    node_fs.rmSync(config.tmp, { recursive: true });
-  }
-  await promises.cp(projectDir, config.tmp, {
-    recursive: true,
-    filter: (src) => {
-      const relative = src.replace(node_path.join(projectDir, ""), "");
-      if (relative.startsWith(node_path.join("assets", "")) || relative.startsWith(node_path.join("node_modules", ""))) {
-        return false;
+    await promises.cp(projectDir, config.tmp, {
+      recursive: true,
+      filter: (src) => {
+        const relative = src.replace(node_path.join(projectDir, ""), "");
+        if (relative.startsWith(node_path.join("assets", "")) || relative.startsWith(node_path.join("node_modules", ""))) {
+          return false;
+        }
+        return true;
       }
-      return true;
+    });
+  } else {
+    const srcFile = node_path.join(projectDir, changedRelative);
+    const destFile = node_path.join(config.tmp, changedRelative);
+    const destDir = node_path.dirname(destFile);
+    if (!node_fs.existsSync(destDir)) {
+      node_fs.mkdirSync(destDir, { recursive: true });
     }
-  });
+    if (node_fs.existsSync(srcFile)) {
+      await promises.cp(srcFile, destFile);
+    }
+  }
   await promises.cp(
-    // in a built situation, __dirname is the dist folder of defuss-ssg
     node_path.resolve(node_path.join(__dirname$1, "components", "index.mjs")),
     node_path.join(tmpComponentsDir, "hydrate.tsx")
-    // any valid JS is always a valid TS file
   );
   await promises.cp(
-    // in a built situation, __dirname is the dist folder of defuss-ssg
     node_path.resolve(node_path.join(__dirname$1, "runtime.mjs")),
     node_path.join(tmpComponentsDir, "runtime.ts")
-    // any valid JS is always a valid TS file
   );
-  await esbuild.build({
-    entryPoints: [node_path.join(tmpPagesDir, "**/*.mdx")],
-    format: "esm",
-    bundle: true,
-    sourcemap: true,
-    jsxDev: true,
-    target: ["esnext"],
-    outdir: tmpPagesDir,
-    plugins: [
-      mdx({
-        // using the defuss jsxImportSource so that the output code contains JSX runtime calls
-        // and can be rendered to HTML here on the server (in Node.js).
-        jsxImportSource: "defuss",
-        development: true,
-        // We also use any remark/rehype plugins specified in the config file.
-        remarkPlugins: config.remarkPlugins,
-        rehypePlugins: config.rehypePlugins
-      })
-    ]
-  });
-  await esbuild.build({
-    entryPoints: [
-      node_path.join(tmpComponentsDir, "**/*.tsx"),
-      node_path.join(tmpComponentsDir, "**/*.ts")
-    ],
-    format: "esm",
-    bundle: true,
-    // making sure we can do code splitting for shared dependencies (e.g. defuss lib)
-    splitting: true,
-    target: ["esnext"],
-    outdir: tmpComponentsDir
-  });
-  const outputFiles = await glob.async(node_path.join(tmpPagesDir, "**/*.js"));
-  if (!node_fs.existsSync(outputProjectDir)) {
-    node_fs.mkdirSync(outputProjectDir, { recursive: true });
+  if (changeKind !== "asset") {
+    const pageEntryPoints = changeKind === "page" ? [node_path.join(config.tmp, changedRelative)] : [node_path.join(tmpPagesDir, "**/*.mdx")];
+    await esbuild.build({
+      entryPoints: pageEntryPoints,
+      format: "esm",
+      bundle: true,
+      sourcemap: true,
+      jsxDev: true,
+      target: ["esnext"],
+      outdir: tmpPagesDir,
+      plugins: [
+        mdx({
+          jsxImportSource: "defuss",
+          development: true,
+          remarkPlugins: config.remarkPlugins,
+          rehypePlugins: config.rehypePlugins
+        })
+      ]
+    });
   }
-  for (const outputFile of outputFiles) {
-    const outputHtmlFilePath = outputFile.replace(".js", ".html");
-    const relativeOutputHtmlFilePath = outputHtmlFilePath.replace(
-      `${tmpPagesDir}${node_path.sep}`,
-      ""
-    );
-    if (debug) {
-      console.log("Processing output file (JS):", outputFile);
-      console.log("Output HTML file path:", outputHtmlFilePath);
-      console.log("Relative output HTML path:", relativeOutputHtmlFilePath);
+  if (isFullBuild || changeKind === "component") {
+    await esbuild.build({
+      entryPoints: [
+        node_path.join(tmpComponentsDir, "**/*.tsx"),
+        node_path.join(tmpComponentsDir, "**/*.ts")
+      ],
+      format: "esm",
+      bundle: true,
+      splitting: true,
+      target: ["esnext"],
+      outdir: tmpComponentsDir
+    });
+  }
+  if (changeKind !== "asset") {
+    let outputFiles;
+    if (changeKind === "page") {
+      const jsFile = node_path.join(config.tmp, changedRelative.replace(/\.mdx$/, ".js"));
+      outputFiles = node_fs.existsSync(jsFile) ? [jsFile] : [];
+    } else {
+      outputFiles = await glob.async(node_path.join(tmpPagesDir, "**/*.js"));
     }
-    const code = await promises.readFile(outputFile, "utf-8");
-    const encoded = Buffer.from(code).toString("base64");
-    const dataUrl = `data:text/javascript;base64,${encoded}`;
-    const exports$1 = await import(dataUrl);
-    if (debug) {
-      console.log("exports", exports$1);
+    if (!node_fs.existsSync(outputProjectDir)) {
+      node_fs.mkdirSync(outputProjectDir, { recursive: true });
     }
-    let vdom = exports$1.default(exports$1);
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-vdom" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-vdom plugin: ${plugin.name}`);
+    for (const outputFile of outputFiles) {
+      const outputHtmlFilePath = outputFile.replace(".js", ".html");
+      const relativeOutputHtmlFilePath = outputHtmlFilePath.replace(
+        `${tmpPagesDir}${node_path.sep}`,
+        ""
+      );
+      if (debug) {
+        console.log("Processing output file (JS):", outputFile);
+        console.log("Relative output HTML path:", relativeOutputHtmlFilePath);
+      }
+      const code = await promises.readFile(outputFile, "utf-8");
+      const encoded = Buffer.from(code).toString("base64");
+      const dataUrl = `data:text/javascript;base64,${encoded}`;
+      const exports$1 = await import(dataUrl);
+      if (debug) {
+        console.log("exports", exports$1);
+      }
+      let vdom = exports$1.default(exports$1);
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-vdom" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-vdom plugin: ${plugin.name}`);
+          }
+          vdom = await plugin.fn(
+            vdom,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config,
+            exports$1
+          );
         }
-        vdom = await plugin.fn(
-          vdom,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config,
-          exports$1
-        );
       }
-    }
-    const browserGlobals = server.getBrowserGlobals();
-    const document = server.getDocument(false, browserGlobals);
-    browserGlobals.document = document;
-    let el = server.renderSync(vdom, document.documentElement, {
-      browserGlobals
-    });
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-dom" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-dom plugin: ${plugin.name}`);
+      const browserGlobals = server.getBrowserGlobals();
+      const document = server.getDocument(false, browserGlobals);
+      browserGlobals.document = document;
+      let el = server.renderSync(vdom, document.documentElement, {
+        browserGlobals
+      });
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-dom" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-dom plugin: ${plugin.name}`);
+          }
+          el = await plugin.fn(
+            el,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config
+          );
         }
-        el = await plugin.fn(
-          el,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config
-        );
       }
-    }
-    let html = server.renderToString(el);
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-html" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-html plugin: ${plugin.name}`);
+      let html = server.renderToString(el);
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-html" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-html plugin: ${plugin.name}`);
+          }
+          html = await plugin.fn(
+            html,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config
+          );
         }
-        html = await plugin.fn(
-          html,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config
-        );
       }
+      const finalOutputFile = node_path.join(
+        projectDir,
+        config.output,
+        relativeOutputHtmlFilePath
+      );
+      const finalOutputDir = node_path.dirname(finalOutputFile);
+      if (!node_fs.existsSync(finalOutputDir)) {
+        node_fs.mkdirSync(finalOutputDir, { recursive: true });
+      }
+      await promises.writeFile(finalOutputFile, html);
     }
-    if (debug) {
-      console.log("Writing HTML file", outputHtmlFilePath);
-    }
-    if (debug) {
-      console.log("Relative HTML path:", relativeOutputHtmlFilePath);
-    }
-    const finalOutputFile = node_path.join(
-      projectDir,
-      config.output,
-      relativeOutputHtmlFilePath
-    );
-    if (debug) {
-      console.log("Full HTML output path:", finalOutputFile);
-    }
-    const finalOutputDir = node_path.dirname(finalOutputFile);
-    if (!node_fs.existsSync(finalOutputDir)) {
-      node_fs.mkdirSync(finalOutputDir, { recursive: true });
-    }
-    await promises.writeFile(finalOutputFile, html);
   }
-  await promises.cp(tmpComponentsDir, outputComponentsDir, { recursive: true });
-  await promises.cp(inputAssetsDir, outputAssetsDir, { recursive: true });
-  for (const plugin of config.plugins || []) {
-    if (plugin.phase === "post" && (plugin.mode === mode || plugin.mode === "both")) {
-      if (debug) {
-        console.log(`Running post-plugin: ${plugin.name}`);
+  if (isFullBuild || changeKind === "component") {
+    await promises.cp(tmpComponentsDir, outputComponentsDir, { recursive: true });
+  }
+  if (isFullBuild || changeKind === "asset") {
+    await promises.cp(inputAssetsDir, outputAssetsDir, { recursive: true });
+  }
+  if (isFullBuild || changeKind === "component") {
+    for (const plugin of config.plugins || []) {
+      if (plugin.phase === "post" && (plugin.mode === mode || plugin.mode === "both")) {
+        if (debug) {
+          console.log(`Running post-plugin: ${plugin.name}`);
+        }
+        await plugin.fn(projectDir, config);
       }
-      await plugin.fn(projectDir, config);
     }
   }
-  if (!debug) {
+  if (mode === "build" && !debug) {
     node_fs.rmSync(config.tmp, { recursive: true });
   }
   const endTime = performance.now();
   const totalTime = (endTime - startTime) / 1e3;
-  console.log(`Build completed in ${totalTime.toFixed(2)} seconds.`);
+  const label = isFullBuild ? "Full build" : `Incremental build (${changeKind}: ${changedRelative})`;
+  console.log(`${label} completed in ${totalTime.toFixed(2)} seconds.`);
   return { code: "OK", message: "Build completed successfully" };
 };
 
@@ -494,10 +512,10 @@ const serve = async ({
     path: "/livereload"
   });
   let isBuilding = false;
-  let pendingBuild = false;
+  let pendingBuild = null;
   const triggerBuild = async (filePath) => {
     if (isBuilding) {
-      pendingBuild = true;
+      pendingBuild = filePath;
       if (debug) {
         console.log("Build scheduled after current one completes");
       }
@@ -505,7 +523,7 @@ const serve = async ({
     }
     isBuilding = true;
     try {
-      await build({ projectDir, debug, mode: "serve" });
+      await build({ projectDir, debug, mode: "serve", changedFile: filePath });
       liveReloadServer.clients.forEach((client) => {
         if (client.readyState === 1) {
           client.send(
@@ -521,11 +539,12 @@ const serve = async ({
     } finally {
       isBuilding = false;
       if (pendingBuild) {
-        pendingBuild = false;
+        const pending = pendingBuild;
+        pendingBuild = null;
         if (debug) {
           console.log("Running pending build");
         }
-        await triggerBuild(filePath);
+        await triggerBuild(pending);
       }
     }
   };

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as RehypePlugins, a as RemarkPlugins, S as SsgConfig, B as BuildOptions, b as Status } from './types-BhV8wSVk.cjs';
-export { c as BuildMode, P as PluginFn, d as PluginFnPageDom, e as PluginFnPageHtml, f as PluginFnPageVdom, g as PluginFnPrePost, h as SsgPlugin, i as StatusCode } from './types-BhV8wSVk.cjs';
+import { R as RehypePlugins, a as RemarkPlugins, S as SsgConfig, B as BuildOptions, b as Status } from './types-C0p7aCdN.cjs';
+export { c as BuildMode, P as PluginFn, d as PluginFnPageDom, e as PluginFnPageHtml, f as PluginFnPageVdom, g as PluginFnPrePost, h as SsgPlugin, i as StatusCode } from './types-C0p7aCdN.cjs';
 import '@mdx-js/esbuild';
 import 'defuss/server';
 
@@ -19,7 +19,7 @@ declare const configDefaults: SsgConfig;
  * A single, complete build process for a static site project.
  * @param projectDir The root directory of the project to build
  */
-declare const build: ({ projectDir, debug, mode, }: BuildOptions) => Promise<Status>;
+declare const build: ({ projectDir, debug, mode, changedFile, }: BuildOptions) => Promise<Status>;
 
 /**
  * A simple static file server to serve the generated static site from the output folder.

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { R as RehypePlugins, a as RemarkPlugins, S as SsgConfig, B as BuildOptions, b as Status } from './types-BhV8wSVk.mjs';
-export { c as BuildMode, P as PluginFn, d as PluginFnPageDom, e as PluginFnPageHtml, f as PluginFnPageVdom, g as PluginFnPrePost, h as SsgPlugin, i as StatusCode } from './types-BhV8wSVk.mjs';
+import { R as RehypePlugins, a as RemarkPlugins, S as SsgConfig, B as BuildOptions, b as Status } from './types-C0p7aCdN.mjs';
+export { c as BuildMode, P as PluginFn, d as PluginFnPageDom, e as PluginFnPageHtml, f as PluginFnPageVdom, g as PluginFnPrePost, h as SsgPlugin, i as StatusCode } from './types-C0p7aCdN.mjs';
 import '@mdx-js/esbuild';
 import 'defuss/server';
 
@@ -19,7 +19,7 @@ declare const configDefaults: SsgConfig;
  * A single, complete build process for a static site project.
  * @param projectDir The root directory of the project to build
  */
-declare const build: ({ projectDir, debug, mode, }: BuildOptions) => Promise<Status>;
+declare const build: ({ projectDir, debug, mode, changedFile, }: BuildOptions) => Promise<Status>;
 
 /**
  * A simple static file server to serve the generated static site from the output folder.

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { b as build, c as configDefaults, r as readConfig, a as rehypePlugins, d as remarkPlugins, s as serve } from './serve-BR2MS6bN.mjs';
+export { b as build, c as configDefaults, r as readConfig, a as rehypePlugins, d as remarkPlugins, s as serve } from './serve-CMNixAKF.mjs';
 import 'chokidar';
 import 'ultimate-express';
 import 'node:path';

package/dist/plugins/index.d.cts

@@ -1,4 +1,4 @@
-import { h as SsgPlugin, g as PluginFnPrePost } from '../types-BhV8wSVk.cjs';
+import { h as SsgPlugin, g as PluginFnPrePost } from '../types-C0p7aCdN.cjs';
 import '@mdx-js/esbuild';
 import 'defuss/server';
 

package/dist/plugins/index.d.mts

@@ -1,4 +1,4 @@
-import { h as SsgPlugin, g as PluginFnPrePost } from '../types-BhV8wSVk.mjs';
+import { h as SsgPlugin, g as PluginFnPrePost } from '../types-C0p7aCdN.mjs';
 import '@mdx-js/esbuild';
 import 'defuss/server';
 

package/dist/{serve-BR2MS6bN.mjs → serve-CMNixAKF.mjs}

@@ -1,6 +1,6 @@
 import chokidar from 'chokidar';
 import express from 'ultimate-express';
-import { join, sep, resolve, dirname } from 'node:path';
+import { join, sep, dirname, resolve } from 'node:path';
 import { existsSync, statSync, rmSync, mkdirSync } from 'node:fs';
 import esbuild from 'esbuild';
 import rehypeKatex from 'rehype-katex';
@@ -205,15 +205,13 @@ const __dirname$1 = dirname(__filename$1);
 const build = async ({
   projectDir,
   debug = false,
-  mode = "build"
+  mode = "build",
+  changedFile
 }) => {
   const projectDirStatus = validateProjectDir(projectDir);
   if (projectDirStatus.code !== "OK") return projectDirStatus;
   const startTime = performance.now();
   const config = await readConfig(projectDir, debug);
-  if (debug) {
-    console.log("PRE config", config);
-  }
   if (debug) {
     console.log("Using config:", config);
   }
@@ -242,193 +240,213 @@ const build = async ({
   }
   if (!existsSync(inputPagesDir)) {
     throw new Error(`Input pages directory does not exist: ${inputPagesDir}`);
-  } else if (debug) {
-    console.log(`Input pages directory exists: ${inputPagesDir}`);
   }
-  if (!existsSync(inputComponentsDir)) {
-    console.warn(
-      `There is no components directory: ${inputComponentsDir}. You may not be able to use any custom components.`
-    );
-  }
-  if (!existsSync(inputAssetsDir)) {
-    console.warn(
-      `There is no assets directory: ${inputAssetsDir}. You may not be able to serve any custom assets.`
-    );
+  let changeKind = "full";
+  let changedRelative = "";
+  if (changedFile) {
+    changedRelative = changedFile.startsWith(projectDir) ? changedFile.slice(projectDir.length).replace(/^\//, "") : changedFile;
+    if (changedRelative.startsWith(config.pages + sep) || changedRelative.startsWith(config.pages + "/")) {
+      changeKind = "page";
+    } else if (changedRelative.startsWith(config.components + sep) || changedRelative.startsWith(config.components + "/")) {
+      changeKind = "component";
+    } else if (changedRelative.startsWith(config.assets + sep) || changedRelative.startsWith(config.assets + "/")) {
+      changeKind = "asset";
+    } else if (changedRelative === "config.ts" || changedRelative === "config.js") {
+      changeKind = "config";
+    }
+    if (debug) {
+      console.log(`Incremental build \u2014 changeKind: ${changeKind}, file: ${changedRelative}`);
+    }
   }
-  for (const plugin of config.plugins || []) {
-    if (plugin.phase === "pre" && (plugin.mode === mode || plugin.mode === "both")) {
-      if (debug) {
-        console.log(`Running pre-plugin: ${plugin.name}`);
+  const isFullBuild = changeKind === "full" || changeKind === "config";
+  const tempExists = existsSync(config.tmp);
+  if (isFullBuild) {
+    for (const plugin of config.plugins || []) {
+      if (plugin.phase === "pre" && (plugin.mode === mode || plugin.mode === "both")) {
+        if (debug) {
+          console.log(`Running pre-plugin: ${plugin.name}`);
+        }
+        await plugin.fn(projectDir, config);
       }
-      await plugin.fn(projectDir, config);
     }
   }
-  if (existsSync(config.tmp)) {
-    if (debug) {
-      console.log(`Removing existing temp folder: ${config.tmp}`);
+  if (isFullBuild || !tempExists) {
+    if (tempExists) {
+      rmSync(config.tmp, { recursive: true });
     }
-    rmSync(config.tmp, { recursive: true });
-  }
-  await cp(projectDir, config.tmp, {
-    recursive: true,
-    filter: (src) => {
-      const relative = src.replace(join(projectDir, ""), "");
-      if (relative.startsWith(join("assets", "")) || relative.startsWith(join("node_modules", ""))) {
-        return false;
+    await cp(projectDir, config.tmp, {
+      recursive: true,
+      filter: (src) => {
+        const relative = src.replace(join(projectDir, ""), "");
+        if (relative.startsWith(join("assets", "")) || relative.startsWith(join("node_modules", ""))) {
+          return false;
+        }
+        return true;
       }
-      return true;
+    });
+  } else {
+    const srcFile = join(projectDir, changedRelative);
+    const destFile = join(config.tmp, changedRelative);
+    const destDir = dirname(destFile);
+    if (!existsSync(destDir)) {
+      mkdirSync(destDir, { recursive: true });
     }
-  });
+    if (existsSync(srcFile)) {
+      await cp(srcFile, destFile);
+    }
+  }
   await cp(
-    // in a built situation, __dirname is the dist folder of defuss-ssg
     resolve(join(__dirname$1, "components", "index.mjs")),
     join(tmpComponentsDir, "hydrate.tsx")
-    // any valid JS is always a valid TS file
   );
   await cp(
-    // in a built situation, __dirname is the dist folder of defuss-ssg
     resolve(join(__dirname$1, "runtime.mjs")),
     join(tmpComponentsDir, "runtime.ts")
-    // any valid JS is always a valid TS file
   );
-  await esbuild.build({
-    entryPoints: [join(tmpPagesDir, "**/*.mdx")],
-    format: "esm",
-    bundle: true,
-    sourcemap: true,
-    jsxDev: true,
-    target: ["esnext"],
-    outdir: tmpPagesDir,
-    plugins: [
-      mdx({
-        // using the defuss jsxImportSource so that the output code contains JSX runtime calls
-        // and can be rendered to HTML here on the server (in Node.js).
-        jsxImportSource: "defuss",
-        development: true,
-        // We also use any remark/rehype plugins specified in the config file.
-        remarkPlugins: config.remarkPlugins,
-        rehypePlugins: config.rehypePlugins
-      })
-    ]
-  });
-  await esbuild.build({
-    entryPoints: [
-      join(tmpComponentsDir, "**/*.tsx"),
-      join(tmpComponentsDir, "**/*.ts")
-    ],
-    format: "esm",
-    bundle: true,
-    // making sure we can do code splitting for shared dependencies (e.g. defuss lib)
-    splitting: true,
-    target: ["esnext"],
-    outdir: tmpComponentsDir
-  });
-  const outputFiles = await glob.async(join(tmpPagesDir, "**/*.js"));
-  if (!existsSync(outputProjectDir)) {
-    mkdirSync(outputProjectDir, { recursive: true });
+  if (changeKind !== "asset") {
+    const pageEntryPoints = changeKind === "page" ? [join(config.tmp, changedRelative)] : [join(tmpPagesDir, "**/*.mdx")];
+    await esbuild.build({
+      entryPoints: pageEntryPoints,
+      format: "esm",
+      bundle: true,
+      sourcemap: true,
+      jsxDev: true,
+      target: ["esnext"],
+      outdir: tmpPagesDir,
+      plugins: [
+        mdx({
+          jsxImportSource: "defuss",
+          development: true,
+          remarkPlugins: config.remarkPlugins,
+          rehypePlugins: config.rehypePlugins
+        })
+      ]
+    });
   }
-  for (const outputFile of outputFiles) {
-    const outputHtmlFilePath = outputFile.replace(".js", ".html");
-    const relativeOutputHtmlFilePath = outputHtmlFilePath.replace(
-      `${tmpPagesDir}${sep}`,
-      ""
-    );
-    if (debug) {
-      console.log("Processing output file (JS):", outputFile);
-      console.log("Output HTML file path:", outputHtmlFilePath);
-      console.log("Relative output HTML path:", relativeOutputHtmlFilePath);
+  if (isFullBuild || changeKind === "component") {
+    await esbuild.build({
+      entryPoints: [
+        join(tmpComponentsDir, "**/*.tsx"),
+        join(tmpComponentsDir, "**/*.ts")
+      ],
+      format: "esm",
+      bundle: true,
+      splitting: true,
+      target: ["esnext"],
+      outdir: tmpComponentsDir
+    });
+  }
+  if (changeKind !== "asset") {
+    let outputFiles;
+    if (changeKind === "page") {
+      const jsFile = join(config.tmp, changedRelative.replace(/\.mdx$/, ".js"));
+      outputFiles = existsSync(jsFile) ? [jsFile] : [];
+    } else {
+      outputFiles = await glob.async(join(tmpPagesDir, "**/*.js"));
     }
-    const code = await readFile(outputFile, "utf-8");
-    const encoded = Buffer.from(code).toString("base64");
-    const dataUrl = `data:text/javascript;base64,${encoded}`;
-    const exports$1 = await import(dataUrl);
-    if (debug) {
-      console.log("exports", exports$1);
+    if (!existsSync(outputProjectDir)) {
+      mkdirSync(outputProjectDir, { recursive: true });
     }
-    let vdom = exports$1.default(exports$1);
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-vdom" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-vdom plugin: ${plugin.name}`);
+    for (const outputFile of outputFiles) {
+      const outputHtmlFilePath = outputFile.replace(".js", ".html");
+      const relativeOutputHtmlFilePath = outputHtmlFilePath.replace(
+        `${tmpPagesDir}${sep}`,
+        ""
+      );
+      if (debug) {
+        console.log("Processing output file (JS):", outputFile);
+        console.log("Relative output HTML path:", relativeOutputHtmlFilePath);
+      }
+      const code = await readFile(outputFile, "utf-8");
+      const encoded = Buffer.from(code).toString("base64");
+      const dataUrl = `data:text/javascript;base64,${encoded}`;
+      const exports$1 = await import(dataUrl);
+      if (debug) {
+        console.log("exports", exports$1);
+      }
+      let vdom = exports$1.default(exports$1);
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-vdom" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-vdom plugin: ${plugin.name}`);
+          }
+          vdom = await plugin.fn(
+            vdom,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config,
+            exports$1
+          );
         }
-        vdom = await plugin.fn(
-          vdom,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config,
-          exports$1
-        );
       }
-    }
-    const browserGlobals = getBrowserGlobals();
-    const document = getDocument(false, browserGlobals);
-    browserGlobals.document = document;
-    let el = renderSync(vdom, document.documentElement, {
-      browserGlobals
-    });
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-dom" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-dom plugin: ${plugin.name}`);
+      const browserGlobals = getBrowserGlobals();
+      const document = getDocument(false, browserGlobals);
+      browserGlobals.document = document;
+      let el = renderSync(vdom, document.documentElement, {
+        browserGlobals
+      });
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-dom" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-dom plugin: ${plugin.name}`);
+          }
+          el = await plugin.fn(
+            el,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config
+          );
         }
-        el = await plugin.fn(
-          el,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config
-        );
       }
-    }
-    let html = renderToString(el);
-    for (const plugin of config.plugins || []) {
-      if (plugin.phase === "page-html" && (plugin.mode === mode || plugin.mode === "both")) {
-        if (debug) {
-          console.log(`Running page-html plugin: ${plugin.name}`);
+      let html = renderToString(el);
+      for (const plugin of config.plugins || []) {
+        if (plugin.phase === "page-html" && (plugin.mode === mode || plugin.mode === "both")) {
+          if (debug) {
+            console.log(`Running page-html plugin: ${plugin.name}`);
+          }
+          html = await plugin.fn(
+            html,
+            relativeOutputHtmlFilePath,
+            projectDir,
+            config
+          );
         }
-        html = await plugin.fn(
-          html,
-          relativeOutputHtmlFilePath,
-          projectDir,
-          config
-        );
       }
+      const finalOutputFile = join(
+        projectDir,
+        config.output,
+        relativeOutputHtmlFilePath
+      );
+      const finalOutputDir = dirname(finalOutputFile);
+      if (!existsSync(finalOutputDir)) {
+        mkdirSync(finalOutputDir, { recursive: true });
+      }
+      await writeFile(finalOutputFile, html);
     }
-    if (debug) {
-      console.log("Writing HTML file", outputHtmlFilePath);
-    }
-    if (debug) {
-      console.log("Relative HTML path:", relativeOutputHtmlFilePath);
-    }
-    const finalOutputFile = join(
-      projectDir,
-      config.output,
-      relativeOutputHtmlFilePath
-    );
-    if (debug) {
-      console.log("Full HTML output path:", finalOutputFile);
-    }
-    const finalOutputDir = dirname(finalOutputFile);
-    if (!existsSync(finalOutputDir)) {
-      mkdirSync(finalOutputDir, { recursive: true });
-    }
-    await writeFile(finalOutputFile, html);
   }
-  await cp(tmpComponentsDir, outputComponentsDir, { recursive: true });
-  await cp(inputAssetsDir, outputAssetsDir, { recursive: true });
-  for (const plugin of config.plugins || []) {
-    if (plugin.phase === "post" && (plugin.mode === mode || plugin.mode === "both")) {
-      if (debug) {
-        console.log(`Running post-plugin: ${plugin.name}`);
+  if (isFullBuild || changeKind === "component") {
+    await cp(tmpComponentsDir, outputComponentsDir, { recursive: true });
+  }
+  if (isFullBuild || changeKind === "asset") {
+    await cp(inputAssetsDir, outputAssetsDir, { recursive: true });
+  }
+  if (isFullBuild || changeKind === "component") {
+    for (const plugin of config.plugins || []) {
+      if (plugin.phase === "post" && (plugin.mode === mode || plugin.mode === "both")) {
+        if (debug) {
+          console.log(`Running post-plugin: ${plugin.name}`);
+        }
+        await plugin.fn(projectDir, config);
       }
-      await plugin.fn(projectDir, config);
     }
   }
-  if (!debug) {
+  if (mode === "build" && !debug) {
     rmSync(config.tmp, { recursive: true });
   }
   const endTime = performance.now();
   const totalTime = (endTime - startTime) / 1e3;
-  console.log(`Build completed in ${totalTime.toFixed(2)} seconds.`);
+  const label = isFullBuild ? "Full build" : `Incremental build (${changeKind}: ${changedRelative})`;
+  console.log(`${label} completed in ${totalTime.toFixed(2)} seconds.`);
   return { code: "OK", message: "Build completed successfully" };
 };
 
@@ -491,10 +509,10 @@ const serve = async ({
     path: "/livereload"
   });
   let isBuilding = false;
-  let pendingBuild = false;
+  let pendingBuild = null;
   const triggerBuild = async (filePath) => {
     if (isBuilding) {
-      pendingBuild = true;
+      pendingBuild = filePath;
       if (debug) {
         console.log("Build scheduled after current one completes");
       }
@@ -502,7 +520,7 @@ const serve = async ({
     }
     isBuilding = true;
     try {
-      await build({ projectDir, debug, mode: "serve" });
+      await build({ projectDir, debug, mode: "serve", changedFile: filePath });
       liveReloadServer.clients.forEach((client) => {
         if (client.readyState === 1) {
           client.send(
@@ -518,11 +536,12 @@ const serve = async ({
     } finally {
       isBuilding = false;
       if (pendingBuild) {
-        pendingBuild = false;
+        const pending = pendingBuild;
+        pendingBuild = null;
         if (debug) {
           console.log("Running pending build");
         }
-        await triggerBuild(filePath);
+        await triggerBuild(pending);
       }
     }
   };

package/dist/{types-BhV8wSVk.d.cts → types-C0p7aCdN.d.cts}

@@ -30,6 +30,12 @@ interface BuildOptions {
      * Defaults to "build"
      */
     mode: Omit<BuildMode, "both">;
+    /**
+     * When set, only the changed file is rebuilt instead of the entire project.
+     * This is used by the dev server for incremental rebuilds.
+     * The path should be absolute.
+     */
+    changedFile?: string;
 }
 type PluginFn = PluginFnPageHtml | PluginFnPageVdom | PluginFnPageDom | PluginFnPrePost;
 /**

package/dist/{types-BhV8wSVk.d.mts → types-C0p7aCdN.d.mts}

@@ -30,6 +30,12 @@ interface BuildOptions {
      * Defaults to "build"
      */
     mode: Omit<BuildMode, "both">;
+    /**
+     * When set, only the changed file is rebuilt instead of the entire project.
+     * This is used by the dev server for incremental rebuilds.
+     * The path should be absolute.
+     */
+    changedFile?: string;
 }
 type PluginFn = PluginFnPageHtml | PluginFnPageVdom | PluginFnPageDom | PluginFnPrePost;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "defuss-ssg",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -26,8 +26,8 @@
     "pretest": "bun run build",
     "prebuild": "bun run clean",
     "build": "pkgroll",
-    "cli-build": "node ./dist/cli.mjs build ./example",
-    "cli-serve": "node ./dist/cli.mjs serve ./example",
+    "cli-build": "node ./dist/cli.mjs build ../../example-ssg/",
+    "cli-serve": "node ./dist/cli.mjs serve ../../example-ssg/",
     "test": "echo 'No tests available'",
     "bench": "npx autocannon -p 32 -w 8 -c 200 -d 20 -m POST -H \"content-type: application/json\" -b '{\"hello\":\"world\"}' http://127.0.0.1:3000/body",
     "start": "tsx src/dynamic.ts",
@@ -90,7 +90,7 @@
     "@mdx-js/esbuild": "^3.1.1",
     "@types/ws": "^8.18.1",
     "chokidar": "^5.0.0",
-    "defuss": "^3.1.0",
+    "defuss": "^3.2.0",
     "esbuild": "^0.27.3",
     "ultimate-express": "^2.0.17",
     "ultimate-ws": "^2.0.7",