defuss-ssg 0.1.1 → 0.1.2

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { v as validateProjectDir, b as build, s as serve } from './serve-BR2MS6bN.mjs';
+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';
@@ -165,9 +165,11 @@ Continuing anyway \u2014 dependencies may already be available.`
 
 (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);
@@ -178,14 +180,14 @@ Continuing anyway \u2014 dependencies may already be available.`
     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.1",
+  "version": "0.1.2",
   "type": "module",
   "publishConfig": {
     "access": "public"