hyperbook 0.87.2 → 0.88.1

package/dist/index.js

@@ -55361,7 +55361,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.ASSETS_FOLDER = void 0;
+exports.buildSingleBookPage = buildSingleBookPage;
+exports.buildSingleGlossaryPage = buildSingleGlossaryPage;
 exports.runBuildProject = runBuildProject;
+exports.makeBaseCtx = makeBaseCtx;
 const path_1 = __importStar(__nccwpck_require__(16928));
 const promises_1 = __importStar(__nccwpck_require__(91943));
 const chalk_1 = __importDefault(__nccwpck_require__(2434));
@@ -55375,6 +55378,108 @@ const lunr_1 = __importDefault(__nccwpck_require__(12203));
 const markdown_1 = __nccwpck_require__(61549);
 const package_json_1 = __importDefault(__nccwpck_require__(8330));
 exports.ASSETS_FOLDER = "__hyperbook_assets";
+async function buildSingleBookPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson) {
+    const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
+    const navigation = {
+        ...n1,
+        ...pagesAndSections,
+    };
+    const ctx = {
+        ...baseCtx,
+        navigation,
+    };
+    const result = await (0, markdown_1.process)(file.markdown.content, ctx);
+    const searchDocuments = [...(result.data.searchDocuments || [])];
+    const directives = Object.keys(result.data.directives || {});
+    for (const generated of result.data.generatedFiles || []) {
+        let genDir;
+        if (generated.relativeTo === "page") {
+            genDir = path_1.default.join(rootOut, file.path.directory);
+        }
+        else {
+            genDir = path_1.default.join(assetsOut, `directive-${generated.directive}`);
+        }
+        await (0, make_dir_1.makeDir)(genDir, { recursive: true });
+        await promises_1.default.writeFile(path_1.default.join(genDir, generated.filename), generated.content);
+    }
+    let directoryOut = path_1.default.join(rootOut, file.path.directory);
+    let href;
+    if (file.name === "index") {
+        href = path_1.default.posix.join(file.path.href || "", "index.html");
+    }
+    else if (hyperbookJson.trailingSlash) {
+        directoryOut = path_1.default.join(directoryOut, file.name);
+        href = path_1.default.posix.join(file.path.href || "", "index.html");
+    }
+    else {
+        href = file.path.href + ".html";
+    }
+    const fileOut = path_1.default.join(rootOut, href);
+    await (0, make_dir_1.makeDir)(directoryOut, { recursive: true });
+    if (file.markdown.data.permaid) {
+        const permaOut = path_1.default.join(rootOut, "@");
+        await (0, make_dir_1.makeDir)(permaOut, { recursive: true });
+        const permaFileOut = path_1.default.join(permaOut, file.markdown.data.permaid + ".html");
+        await promises_1.default.writeFile(permaFileOut, result.value);
+    }
+    await promises_1.default.writeFile(fileOut, result.value);
+    return { searchDocuments, directives };
+}
+async function buildSingleGlossaryPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson) {
+    const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
+    const navigation = {
+        ...n1,
+        ...pagesAndSections,
+    };
+    if (!navigation.current && file.markdown.data) {
+        navigation.current = {
+            name: file.markdown.data.name || file.name,
+            href: file.path.href || undefined,
+            path: file.path,
+            scripts: file.markdown.data.scripts,
+            styles: file.markdown.data.styles,
+            description: file.markdown.data.description,
+            keywords: file.markdown.data.keywords,
+            lang: file.markdown.data.lang,
+            qrcode: file.markdown.data.qrcode,
+            toc: file.markdown.data.toc,
+            layout: file.markdown.data.layout,
+        };
+    }
+    const ctx = {
+        ...baseCtx,
+        navigation,
+    };
+    const result = await (0, markdown_1.process)(file.markdown.content, ctx);
+    const searchDocuments = [...(result.data.searchDocuments || [])];
+    const directives = Object.keys(result.data.directives || {});
+    for (const generated of result.data.generatedFiles || []) {
+        let genDir;
+        if (generated.relativeTo === "page") {
+            genDir = path_1.default.join(rootOut, file.path.directory);
+        }
+        else {
+            genDir = path_1.default.join(assetsOut, `directive-${generated.directive}`);
+        }
+        await (0, make_dir_1.makeDir)(genDir, { recursive: true });
+        await promises_1.default.writeFile(path_1.default.join(genDir, generated.filename), generated.content);
+    }
+    const glossaryOut = path_1.default.join(rootOut, "glossary");
+    let href = file.path.href + ".html";
+    let fileOut = path_1.default.join(rootOut, href);
+    if (hyperbookJson.trailingSlash) {
+        href = path_1.default.posix.join(file.path.href || "", "index.html");
+        fileOut = path_1.default.join(rootOut, file.path.href || "", "index.html");
+        await (0, make_dir_1.makeDir)(path_1.default.join(rootOut, file.path.href || ""), {
+            recursive: true,
+        });
+    }
+    else {
+        await (0, make_dir_1.makeDir)(glossaryOut, { recursive: true });
+    }
+    await promises_1.default.writeFile(fileOut, result.value);
+    return { searchDocuments, directives };
+}
 /**
  * Generates an llms.txt file by combining all markdown files in order
  */
@@ -55502,49 +55607,12 @@ async function runBuildProject(project, rootProject, out, filter) {
         }
     }
 }
-async function runBuild(root, rootProject, basePath, prefix, out, filter) {
-    var _a;
-    console.log(`${chalk_1.default.blue(`[${prefix}]`)} Reading hyperbook.json.`);
-    const hyperbookJson = await fs_1.hyperbook.getJson(root);
-    if (!basePath && (hyperbookJson === null || hyperbookJson === void 0 ? void 0 : hyperbookJson.basePath)) {
-        basePath = hyperbookJson.basePath;
-    }
-    if (basePath && !basePath.startsWith("/")) {
-        basePath = "/" + basePath;
-    }
-    if (basePath && basePath.endsWith("/")) {
-        basePath = basePath.slice(0, -1);
-    }
-    hyperbookJson.basePath = basePath;
-    fs_1.vfile.clean(root);
-    let link = undefined;
-    if (rootProject.type === "library") {
-        link = await fs_1.hyperproject.getLink(rootProject, hyperbookJson.language);
-    }
-    if (link) {
-        if (!hyperbookJson.links) {
-            hyperbookJson.links = [link];
-        }
-        else {
-            hyperbookJson.links.push(link);
-        }
-    }
-    let rootOut = path_1.default.join(root, ".hyperbook", "out");
-    if (out) {
-        rootOut = path_1.default.join(out, ".hyperbook", "out", basePath || "");
-    }
-    const assetsOut = path_1.default.join(rootOut, exports.ASSETS_FOLDER);
-    console.log(`${chalk_1.default.blue(`[${prefix}]`)} Cleaning output folder ${rootOut}.`);
-    await (0, archive_1.runArchive)(root, rootOut, prefix);
-    // Helper function to resolve relative paths
-    const resolveRelativePath = (path, page) => {
+function makeBaseCtx(root, hyperbookJson, basePath, rootProject) {
+    const resolveRelativePath = (p, page) => {
         var _a;
-        // If path is absolute, return as-is
-        if (path.startsWith("/")) {
-            return path;
+        if (p.startsWith("/")) {
+            return p;
         }
-        // Get the directory of the current page
-        // Use page.path.directory if available, otherwise derive from href
         let currentPageDir;
         if ((_a = page.path) === null || _a === void 0 ? void 0 : _a.directory) {
             currentPageDir = path_1.posix.join("/", page.path.directory);
@@ -55552,67 +55620,99 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
         else {
             currentPageDir = path_1.posix.dirname(page.href || "/");
         }
-        // Resolve the relative path and normalize
-        const resolvedPath = path_1.posix.normalize(path_1.posix.resolve(currentPageDir, path));
-        return resolvedPath;
+        return path_1.posix.normalize(path_1.posix.resolve(currentPageDir, p));
     };
-    const baseCtx = {
+    return {
         root,
         config: hyperbookJson,
-        makeUrl: (path, base, page, options = { versioned: true }) => {
-            if (typeof path === "string") {
-                // Handle absolute URLs
-                if (path.includes("://") || path.startsWith("data:")) {
-                    return path;
+        makeUrl: (p, base, page, options = { versioned: true }) => {
+            if (typeof p === "string") {
+                if (p.includes("://") || p.startsWith("data:")) {
+                    return p;
                 }
-                if (path.endsWith(".md")) {
-                    path = path.slice(0, -3);
+                if (p.endsWith(".md")) {
+                    p = p.slice(0, -3);
                 }
-                else if (path.endsWith(".md.json")) {
-                    path = path.slice(0, -8);
+                else if (p.endsWith(".md.json")) {
+                    p = p.slice(0, -8);
                 }
-                else if (path.endsWith(".md.yml")) {
-                    path = path.slice(0, -7);
+                else if (p.endsWith(".md.yml")) {
+                    p = p.slice(0, -7);
                 }
-                // Handle relative paths when we have a current page context
-                if (page && !path.startsWith("/")) {
-                    path = resolveRelativePath(path, page);
+                if (page && !p.startsWith("/")) {
+                    p = resolveRelativePath(p, page);
                 }
-                path = [path];
+                p = [p];
             }
-            // Handle array paths - resolve relative segments
-            if (Array.isArray(path) && page) {
-                path = path.map((segment) => {
+            if (Array.isArray(p) && page) {
+                p = p.map((segment) => {
                     if (typeof segment === "string" && !segment.startsWith("/")) {
                         return resolveRelativePath(segment, page);
                     }
                     return segment;
                 });
             }
+            const pathArr = p;
             switch (base) {
                 case "glossary":
-                    return path_1.posix.join("/", basePath || "", "glossary", ...path);
+                    return path_1.posix.join("/", basePath || "", "glossary", ...pathArr);
                 case "book":
-                    return path_1.posix.join(basePath || "", ...path);
+                    return path_1.posix.join(basePath || "", ...pathArr);
                 case "public":
-                    return path_1.posix.join(basePath || "", ...path);
+                    return path_1.posix.join(basePath || "", ...pathArr);
                 case "archive":
-                    return path_1.posix.join("/", basePath || "", "archives", ...path);
+                    return path_1.posix.join("/", basePath || "", "archives", ...pathArr);
                 case "assets":
-                    if (path.length === 1 && path[0] === "/") {
-                        return `${path_1.posix.join("/", basePath || "", exports.ASSETS_FOLDER, ...path)}`;
+                    if (pathArr.length === 1 && pathArr[0] === "/") {
+                        return `${path_1.posix.join("/", basePath || "", exports.ASSETS_FOLDER, ...pathArr)}`;
                     }
                     else {
-                        let p = `${path_1.posix.join("/", basePath || "", exports.ASSETS_FOLDER, ...path)}`;
+                        let result = `${path_1.posix.join("/", basePath || "", exports.ASSETS_FOLDER, ...pathArr)}`;
                         if (options === null || options === void 0 ? void 0 : options.versioned) {
-                            p += `?v=${package_json_1.default.version}`;
+                            result += `?v=${package_json_1.default.version}`;
                         }
-                        return p;
+                        return result;
                     }
             }
         },
         project: rootProject,
     };
+}
+async function runBuild(root, rootProject, basePath, prefix, out, filter) {
+    var _a;
+    console.log(`${chalk_1.default.blue(`[${prefix}]`)} Reading hyperbook.json.`);
+    const hyperbookJson = await fs_1.hyperbook.getJson(root);
+    if (!basePath && (hyperbookJson === null || hyperbookJson === void 0 ? void 0 : hyperbookJson.basePath)) {
+        basePath = hyperbookJson.basePath;
+    }
+    if (basePath && !basePath.startsWith("/")) {
+        basePath = "/" + basePath;
+    }
+    if (basePath && basePath.endsWith("/")) {
+        basePath = basePath.slice(0, -1);
+    }
+    hyperbookJson.basePath = basePath;
+    fs_1.vfile.clean(root);
+    let link = undefined;
+    if (rootProject.type === "library") {
+        link = await fs_1.hyperproject.getLink(rootProject, hyperbookJson.language);
+    }
+    if (link) {
+        if (!hyperbookJson.links) {
+            hyperbookJson.links = [link];
+        }
+        else {
+            hyperbookJson.links.push(link);
+        }
+    }
+    let rootOut = path_1.default.join(root, ".hyperbook", "out");
+    if (out) {
+        rootOut = path_1.default.join(out, ".hyperbook", "out", basePath || "");
+    }
+    const assetsOut = path_1.default.join(rootOut, exports.ASSETS_FOLDER);
+    console.log(`${chalk_1.default.blue(`[${prefix}]`)} Cleaning output folder ${rootOut}.`);
+    await (0, archive_1.runArchive)(root, rootOut, prefix);
+    const baseCtx = makeBaseCtx(root, hyperbookJson, basePath, rootProject);
     const directives = new Set([]);
     const pagesAndSections = await fs_1.hyperbook.getPagesAndSections(root);
     const pageList = fs_1.hyperbook.getPageList(pagesAndSections.sections, pagesAndSections.pages);
@@ -55623,56 +55723,11 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
     }
     let i = 1;
     for (let file of bookFiles) {
-        const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
-        const navigation = {
-            ...n1,
-            ...pagesAndSections,
-        };
-        const ctx = {
-            ...baseCtx,
-            navigation,
-        };
-        const result = await (0, markdown_1.process)(file.markdown.content, ctx);
-        searchDocuments.push(...(result.data.searchDocuments || []));
-        for (let directive of Object.keys(result.data.directives || {})) {
+        const pageResult = await buildSingleBookPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson);
+        searchDocuments.push(...pageResult.searchDocuments);
+        for (let directive of pageResult.directives) {
             directives.add(directive);
         }
-        for (const generated of result.data.generatedFiles || []) {
-            let genDir;
-            if (generated.relativeTo === "page") {
-                genDir = path_1.default.join(rootOut, file.path.directory);
-            }
-            else {
-                genDir = path_1.default.join(assetsOut, `directive-${generated.directive}`);
-            }
-            await (0, make_dir_1.makeDir)(genDir, { recursive: true });
-            await promises_1.default.writeFile(path_1.default.join(genDir, generated.filename), generated.content);
-        }
-        let directoryOut = path_1.default.join(rootOut, file.path.directory);
-        let href;
-        if (file.name === "index") {
-            href = path_1.default.posix.join(file.path.href || "", "index.html");
-        }
-        else if (hyperbookJson.trailingSlash) {
-            directoryOut = path_1.default.join(directoryOut, file.name);
-            href = path_1.default.posix.join(file.path.href || "", "index.html");
-        }
-        else {
-            href = file.path.href + ".html";
-        }
-        const fileOut = path_1.default.join(rootOut, href);
-        await (0, make_dir_1.makeDir)(directoryOut, {
-            recursive: true,
-        });
-        if (file.markdown.data.permaid) {
-            const permaOut = path_1.default.join(rootOut, "@");
-            await (0, make_dir_1.makeDir)(permaOut, {
-                recursive: true,
-            });
-            const permaFileOut = path_1.default.join(permaOut, file.markdown.data.permaid + ".html");
-            await promises_1.default.writeFile(permaFileOut, result.value);
-        }
-        await promises_1.default.writeFile(fileOut, result.value);
         if (!process.env.CI) {
             readline_1.default.clearLine(process.stdout, 0);
             readline_1.default.cursorTo(process.stdout, 0);
@@ -55684,68 +55739,16 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
     }
     process.stdout.write("\n");
     let glossaryFiles = await fs_1.vfile.listForFolder(root, "glossary");
-    const glossaryOut = path_1.default.join(rootOut, "glossary");
     if (filter) {
         glossaryFiles = glossaryFiles.filter((f) => { var _a; return (_a = f.path.absolute) === null || _a === void 0 ? void 0 : _a.endsWith(filter); });
     }
     i = 1;
     for (let file of glossaryFiles) {
-        const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
-        const navigation = {
-            ...n1,
-            ...pagesAndSections,
-        };
-        // If current is null (glossary page not in pageList), create it from file frontmatter
-        if (!navigation.current && file.markdown.data) {
-            navigation.current = {
-                name: file.markdown.data.name || file.name,
-                href: file.path.href || undefined,
-                path: file.path,
-                scripts: file.markdown.data.scripts,
-                styles: file.markdown.data.styles,
-                description: file.markdown.data.description,
-                keywords: file.markdown.data.keywords,
-                lang: file.markdown.data.lang,
-                qrcode: file.markdown.data.qrcode,
-                toc: file.markdown.data.toc,
-                layout: file.markdown.data.layout,
-            };
-        }
-        const ctx = {
-            ...baseCtx,
-            navigation,
-        };
-        const result = await (0, markdown_1.process)(file.markdown.content, ctx);
-        searchDocuments.push(...(result.data.searchDocuments || []));
-        for (let directive of Object.keys(result.data.directives || {})) {
+        const pageResult = await buildSingleGlossaryPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson);
+        searchDocuments.push(...pageResult.searchDocuments);
+        for (let directive of pageResult.directives) {
             directives.add(directive);
         }
-        for (const generated of result.data.generatedFiles || []) {
-            let genDir;
-            if (generated.relativeTo === "page") {
-                genDir = path_1.default.join(rootOut, file.path.directory);
-            }
-            else {
-                genDir = path_1.default.join(assetsOut, `directive-${generated.directive}`);
-            }
-            await (0, make_dir_1.makeDir)(genDir, { recursive: true });
-            await promises_1.default.writeFile(path_1.default.join(genDir, generated.filename), generated.content);
-        }
-        let href = file.path.href + ".html";
-        let fileOut = path_1.default.join(rootOut, href);
-        if (hyperbookJson.trailingSlash) {
-            href = path_1.default.posix.join(file.path.href || "", "index.html");
-            fileOut = path_1.default.join(rootOut, file.path.href || "", "index.html");
-            await (0, make_dir_1.makeDir)(path_1.default.join(rootOut, file.path.href || ""), {
-                recursive: true,
-            });
-        }
-        else {
-            await (0, make_dir_1.makeDir)(glossaryOut, {
-                recursive: true,
-            });
-        }
-        await promises_1.default.writeFile(fileOut, result.value);
         if (!process.env.CI) {
             readline_1.default.clearLine(process.stdout, 0);
             readline_1.default.cursorTo(process.stdout, 0);
@@ -55956,8 +55959,12 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
         let foundLanguage = false;
         if (hyperbookJson.language && hyperbookJson.language !== "en") {
             try {
-                __nccwpck_require__(30089)(lunr_1.default);
-                require(`./lunr-languages/lunr.${hyperbookJson.language}.min.js`)(lunr_1.default);
+                // Only register lunr language plugins once to avoid "Overwriting" warnings
+                if (!lunr_1.default["_hyperbook_lang_loaded_" + hyperbookJson.language]) {
+                    __nccwpck_require__(30089)(lunr_1.default);
+                    require(`./lunr-languages/lunr.${hyperbookJson.language}.min.js`)(lunr_1.default);
+                    lunr_1.default["_hyperbook_lang_loaded_" + hyperbookJson.language] = true;
+                }
                 foundLanguage = true;
             }
             catch (e) {
@@ -56029,14 +56036,13 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.runDev = runDev;
 const chokidar_1 = __importDefault(__nccwpck_require__(39827));
 const fs_1 = __nccwpck_require__(96780);
-const build_1 = __nccwpck_require__(58097);
+const incremental_1 = __nccwpck_require__(94153);
 const path_1 = __importDefault(__nccwpck_require__(16928));
 const http_1 = __importDefault(__nccwpck_require__(58611));
 const fs_2 = __importDefault(__nccwpck_require__(79896));
 const mime_1 = __importDefault(__nccwpck_require__(94931));
 const ws_1 = __nccwpck_require__(55999);
 const chalk_1 = __importDefault(__nccwpck_require__(2434));
-const rimraf_1 = __nccwpck_require__(52114);
 const prompts_1 = __importDefault(__nccwpck_require__(63792));
 const net_1 = __importDefault(__nccwpck_require__(69278));
 async function isPortAvailable(port) {
@@ -56108,15 +56114,68 @@ async function runDev({ port = 8080 }) {
         if (request.url === "/__hyperbook_dev.js") {
             const responseBody = `
 const socket = new WebSocket("ws://localhost:${port}");
+
+// Report current page to server
+socket.addEventListener("open", () => {
+  socket.send(JSON.stringify({ type: "page", href: window.location.pathname }));
+});
+
 socket.addEventListener("message", (event) => {
-  if (event.data === "RELOAD") {
-    const main = document.querySelector("main");
-    if (main) {
-      localStorage.setItem("__hyperbook_dev_scroll", main.scrollTop);
+  let msg;
+  try {
+    msg = JSON.parse(event.data);
+  } catch {
+    // Legacy fallback
+    if (event.data === "RELOAD") {
+      msg = { type: "reload", changedPages: "*" };
+    } else {
+      return;
+    }
+  }
+
+  if (msg.type === "rebuilding") {
+    var btn = document.getElementById("__hb_reload_btn");
+    if (btn) {
+      btn.style.opacity = "1";
+      btn.style.animation = "__hb_spin 0.8s linear infinite";
+      btn.disabled = true;
+      btn.dataset.spinning = "1";
+    }
+  }
+
+  if (msg.type === "rebuild-complete") {
+    // Force-reload build finished — stop spinner, don't refresh
+    var btn = document.getElementById("__hb_reload_btn");
+    if (btn) {
+      btn.style.animation = "none";
+      btn.disabled = false;
+      delete btn.dataset.spinning;
+      btn.innerHTML = "✓";
+      setTimeout(function() { btn.innerHTML = "↻"; btn.style.opacity = "0.6"; }, 2000);
+    }
+  }
+
+  if (msg.type === "reload") {
+    const currentPath = window.location.pathname;
+    const shouldReload = msg.changedPages === "*" || msg.changedPages.some(function(p) {
+      // Special case for root page
+      if (p === "/" && (currentPath === "/" || currentPath === "/index.html")) {
+        return true;
+      }
+      return currentPath === p || currentPath === p + "/" || currentPath === p + ".html"
+        || currentPath === p + "/index.html" || currentPath.startsWith(p + "/");
+    });
+
+    if (shouldReload) {
+      const main = document.querySelector("main");
+      if (main) {
+        localStorage.setItem("__hyperbook_dev_scroll", main.scrollTop);
+      }
+      window.location.reload();
     }
-    window.location.reload();
   }
 });
+
 window.onload = () => {
   const main = document.querySelector("main");
   const scrollTop = localStorage.getItem("__hyperbook_dev_scroll");
@@ -56124,6 +56183,31 @@ window.onload = () => {
     main.scrollTop = parseInt(scrollTop, 10);
     localStorage.removeItem("__hyperbook_dev_scroll");
   }
+
+  // Force full reload button
+  var style = document.createElement("style");
+  style.textContent = "@keyframes __hb_spin { from { transform: rotate(0deg); } to { transform: rotate(360deg); } }";
+  document.head.appendChild(style);
+
+  var btn = document.createElement("button");
+  btn.id = "__hb_reload_btn";
+  btn.type = "button";
+  btn.innerHTML = "↻";
+  btn.title = "Force full rebuild";
+  btn.style.cssText = "position:fixed;bottom:16px;right:16px;z-index:99999;"
+    + "width:40px;height:40px;border-radius:50%;border:none;cursor:pointer;"
+    + "background:#333;color:#fff;font-size:20px;line-height:1;"
+    + "box-shadow:0 2px 8px rgba(0,0,0,0.3);opacity:0.6;transition:opacity 0.2s;";
+  btn.addEventListener("mouseenter", function() { btn.style.opacity = "1"; });
+  btn.addEventListener("mouseleave", function() { if (!btn.dataset.spinning) btn.style.opacity = "0.6"; });
+  btn.addEventListener("click", function() {
+    btn.style.opacity = "1";
+    btn.style.animation = "__hb_spin 0.8s linear infinite";
+    btn.disabled = true;
+    btn.dataset.spinning = "1";
+    socket.send(JSON.stringify({ type: "force-reload" }));
+  });
+  document.body.appendChild(btn);
 };
 `;
             response.writeHead(200, {
@@ -56192,42 +56276,72 @@ window.onload = () => {
     const reloadServer = new ws_1.WebSocketServer({
         server,
     });
-    reloadServer.on("reload", () => {
+    const broadcast = (msg) => {
+        const message = JSON.stringify(msg);
         reloadServer.clients.forEach((client) => {
-            client.send("RELOAD");
+            if (client.readyState === ws_1.WebSocket.OPEN) {
+                client.send(message);
+            }
+        });
+    };
+    const sendReload = (changedPages) => {
+        broadcast({ type: "reload", changedPages });
+    };
+    // Handle client messages (force-reload requests)
+    reloadServer.on("connection", (ws) => {
+        ws.on("message", (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.type === "force-reload" && !rebuilding) {
+                    console.log(`${chalk_1.default.yellow("[Force Reload]")} Triggered by client`);
+                    rebuilding = true;
+                    broadcast({ type: "rebuilding" });
+                    builder.handleChange("hyperbook.json", "change")
+                        .then(() => {
+                        broadcast({ type: "rebuild-complete" });
+                    })
+                        .catch((e) => {
+                        console.error(`${chalk_1.default.red("[Error]")}: ${e instanceof Error ? e.message : e}`);
+                    })
+                        .finally(() => {
+                        rebuilding = false;
+                    });
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
         });
     });
+    ////////////////////
+    // Incremental Builder
+    ////////////////////
+    const builder = new incremental_1.IncrementalBuilder(root, rootProject);
     let rebuilding = false;
-    const rebuild = (status, shouldClean = false) => async (file) => {
+    const handleFileChange = (eventType) => async (file) => {
         if (!rebuilding) {
-            console.log(`${chalk_1.default.yellow(`[Rebuilding ${status}]`)}: ${file}.`);
+            console.log(`${chalk_1.default.yellow(`[File ${eventType}]`)}: ${file}`);
             rebuilding = true;
+            broadcast({ type: "rebuilding" });
             try {
-                const rootProject = await fs_1.hyperproject.get(process.cwd());
-                // Clean output folder when files are deleted or renamed to avoid stale files
-                if (shouldClean) {
-                    const cleanOutDir = path_1.default.join(rootProject.src, ".hyperbook", "out");
-                    console.log(`${chalk_1.default.yellow(`[Cleaning]`)}: ${cleanOutDir}`);
-                    await (0, rimraf_1.rimraf)(cleanOutDir);
-                }
-                await (0, build_1.runBuildProject)(rootProject, rootProject);
-                console.log(`${chalk_1.default.yellow(`[Reloading]`)}: Website`);
-                reloadServer.emit("reload");
+                const result = await builder.handleChange(file, eventType);
+                console.log(`${chalk_1.default.yellow("[Reloading]")}: Website`);
+                sendReload(result.changedPages);
             }
             catch (e) {
                 if (e instanceof Error) {
-                    console.error(`${chalk_1.default.red(`[Error]`)}: ${e.message}.`);
+                    console.error(`${chalk_1.default.red("[Error]")}: ${e.message}.`);
                 }
                 else {
-                    console.error(`${chalk_1.default.red(`[Error]`)}: ${e}.`);
+                    console.error(`${chalk_1.default.red("[Error]")}: ${e}.`);
                 }
             }
             rebuilding = false;
         }
     };
-    await rebuild("(Initialize)")("");
+    await builder.initialize();
     server.listen(port, () => {
-        console.log(`${chalk_1.default.yellow(`[DEV-SERVER]`)} is running at http://localhost:${port}`);
+        console.log(`${chalk_1.default.yellow("[DEV-SERVER]")} is running at http://localhost:${port}`);
     });
     ////////////////////
     // File Watching
@@ -56238,11 +56352,11 @@ window.onload = () => {
         cwd: root,
         usePolling: true,
         interval: 600,
-        ignored: [outDir, path_1.default.join("archives", "*.zip")],
+        ignored: [outDir, path_1.default.join("archives", "*.zip"), /(^|[\/\\])\./, "**/node_modules/**"],
     })
-        .on("add", rebuild("(Added)"))
-        .on("change", rebuild("(Changed)"))
-        .on("unlink", rebuild("(Deleted)", true));
+        .on("add", handleFileChange("add"))
+        .on("change", handleFileChange("change"))
+        .on("unlink", handleFileChange("unlink"));
 }
 
 
@@ -56398,6 +56512,239 @@ async function makeDir(root, options = { recursive: true }) {
 }
 
 
+/***/ }),
+
+/***/ 94153:
+/***/ (function(__unused_webpack_module, exports, __nccwpck_require__) {
+
+"use strict";
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.IncrementalBuilder = void 0;
+const path_1 = __importDefault(__nccwpck_require__(16928));
+const promises_1 = __importDefault(__nccwpck_require__(91943));
+const promises_2 = __nccwpck_require__(91943);
+const chalk_1 = __importDefault(__nccwpck_require__(2434));
+const fs_1 = __nccwpck_require__(96780);
+const build_1 = __nccwpck_require__(58097);
+class IncrementalBuilder {
+    constructor(root, rootProject) {
+        this.hyperbookJson = null;
+        this.baseCtx = null;
+        this.pagesAndSections = null;
+        this.pageList = null;
+        this.searchDocuments = new Map();
+        this.directives = new Set();
+        this.rootOut = "";
+        this.assetsOut = "";
+        this.initialized = false;
+        // Track known files for structural change detection
+        this.knownBookFiles = new Set();
+        this.knownGlossaryFiles = new Set();
+        this.root = root;
+        this.rootProject = rootProject;
+    }
+    async initialize() {
+        console.log(`${chalk_1.default.yellow("[Incremental]")} Full initial build...`);
+        await (0, build_1.runBuildProject)(this.rootProject, this.rootProject);
+        // Populate caches after full build
+        await this.refreshCaches();
+        this.initialized = true;
+        console.log(`${chalk_1.default.green("[Incremental]")} Initial build complete. Incremental mode active.`);
+    }
+    async refreshCaches() {
+        var _a;
+        const project = this.rootProject;
+        if (project.type !== "book") {
+            // For libraries, we don't support incremental — always full rebuild
+            return;
+        }
+        this.hyperbookJson = await fs_1.hyperbook.getJson(this.root);
+        let basePath = project.basePath;
+        if (!basePath && ((_a = this.hyperbookJson) === null || _a === void 0 ? void 0 : _a.basePath)) {
+            basePath = this.hyperbookJson.basePath;
+        }
+        if (basePath && !basePath.startsWith("/")) {
+            basePath = "/" + basePath;
+        }
+        if (basePath && basePath.endsWith("/")) {
+            basePath = basePath.slice(0, -1);
+        }
+        this.hyperbookJson.basePath = basePath;
+        this.baseCtx = (0, build_1.makeBaseCtx)(this.root, this.hyperbookJson, basePath, this.rootProject);
+        this.pagesAndSections = await fs_1.hyperbook.getPagesAndSections(this.root);
+        this.pageList = fs_1.hyperbook.getPageList(this.pagesAndSections.sections, this.pagesAndSections.pages);
+        this.rootOut = path_1.default.join(this.root, ".hyperbook", "out");
+        this.assetsOut = path_1.default.join(this.rootOut, build_1.ASSETS_FOLDER);
+        // Track known files
+        this.knownBookFiles.clear();
+        this.knownGlossaryFiles.clear();
+        const bookFiles = await fs_1.vfile.listForFolder(this.root, "book");
+        for (const f of bookFiles) {
+            this.knownBookFiles.add(f.path.absolute);
+        }
+        const glossaryFiles = await fs_1.vfile.listForFolder(this.root, "glossary");
+        for (const f of glossaryFiles) {
+            this.knownGlossaryFiles.add(f.path.absolute);
+        }
+    }
+    classifyChange(filePath, eventType) {
+        const absPath = path_1.default.resolve(this.root, filePath);
+        // Config changes always trigger full rebuild
+        if (filePath === "hyperbook.json" || filePath === "hyperlibrary.json") {
+            return "config";
+        }
+        // Public file changes (check before structural to avoid unnecessary full rebuilds)
+        const publicDir = path_1.default.join(this.root, "public");
+        const bookPublicDir = path_1.default.join(this.root, "book-public");
+        const glossaryPublicDir = path_1.default.join(this.root, "glossary-public");
+        if (absPath.startsWith(publicDir + path_1.default.sep) ||
+            absPath.startsWith(bookPublicDir + path_1.default.sep) ||
+            absPath.startsWith(glossaryPublicDir + path_1.default.sep)) {
+            return "public";
+        }
+        // File add/delete is structural (affects navigation)
+        if (eventType === "add" || eventType === "unlink") {
+            return "structural";
+        }
+        // Content changes to book files
+        const bookDir = path_1.default.join(this.root, "book");
+        if (absPath.startsWith(bookDir + path_1.default.sep) || absPath === bookDir) {
+            const isMarkdown = filePath.endsWith(".md") || filePath.endsWith(".md.hbs") || filePath.endsWith(".md.json") || filePath.endsWith(".md.yml");
+            if (isMarkdown) {
+                return "content-book";
+            }
+            return "public";
+        }
+        // Content changes to glossary files
+        const glossaryDir = path_1.default.join(this.root, "glossary");
+        if (absPath.startsWith(glossaryDir + path_1.default.sep) || absPath === glossaryDir) {
+            return "content-glossary";
+        }
+        // Template/snippet changes or anything else → structural (full rebuild)
+        return "structural";
+    }
+    async handleChange(filePath, eventType) {
+        if (!this.initialized || this.rootProject.type !== "book") {
+            // Fall back to full rebuild for libraries or uninitialized state
+            await (0, build_1.runBuildProject)(this.rootProject, this.rootProject);
+            await this.refreshCaches();
+            return { changedPages: "*" };
+        }
+        const changeType = this.classifyChange(filePath, eventType);
+        switch (changeType) {
+            case "config":
+            case "structural": {
+                console.log(`${chalk_1.default.yellow("[Incremental]")} Structural change detected, full rebuild...`);
+                fs_1.vfile.clean(this.root);
+                await (0, build_1.runBuildProject)(this.rootProject, this.rootProject);
+                await this.refreshCaches();
+                return { changedPages: "*" };
+            }
+            case "content-book": {
+                console.log(`${chalk_1.default.yellow("[Incremental]")} Content change: ${filePath}`);
+                // Clear vfile cache so it re-reads the changed file
+                fs_1.vfile.clean(this.root);
+                // Refresh navigation (fast — reads frontmatter only)
+                this.pagesAndSections = await fs_1.hyperbook.getPagesAndSections(this.root);
+                this.pageList = fs_1.hyperbook.getPageList(this.pagesAndSections.sections, this.pagesAndSections.pages);
+                const bookFiles = await fs_1.vfile.listForFolder(this.root, "book");
+                const absPath = path_1.default.resolve(this.root, filePath);
+                const changedFile = bookFiles.find((f) => f.path.absolute === absPath);
+                if (!changedFile) {
+                    console.log(`${chalk_1.default.yellow("[Incremental]")} Could not find changed file, full rebuild...`);
+                    await (0, build_1.runBuildProject)(this.rootProject, this.rootProject);
+                    await this.refreshCaches();
+                    return { changedPages: "*" };
+                }
+                const result = await (0, build_1.buildSingleBookPage)(changedFile, this.baseCtx, this.pageList, this.pagesAndSections, this.rootOut, this.assetsOut, this.hyperbookJson);
+                // Update search documents cache
+                this.searchDocuments.set(changedFile.path.href || changedFile.path.absolute, result.searchDocuments);
+                for (const directive of result.directives) {
+                    this.directives.add(directive);
+                }
+                // Copy any new directive assets
+                await this.copyDirectiveAssets(result.directives);
+                const changedHref = changedFile.path.href || "/";
+                console.log(`${chalk_1.default.green("[Incremental]")} Rebuilt: ${changedHref}`);
+                return { changedPages: [changedHref] };
+            }
+            case "content-glossary": {
+                console.log(`${chalk_1.default.yellow("[Incremental]")} Glossary change: ${filePath}`);
+                fs_1.vfile.clean(this.root);
+                this.pagesAndSections = await fs_1.hyperbook.getPagesAndSections(this.root);
+                this.pageList = fs_1.hyperbook.getPageList(this.pagesAndSections.sections, this.pagesAndSections.pages);
+                const glossaryFiles = await fs_1.vfile.listForFolder(this.root, "glossary");
+                const absPath = path_1.default.resolve(this.root, filePath);
+                const changedFile = glossaryFiles.find((f) => f.path.absolute === absPath);
+                if (!changedFile) {
+                    console.log(`${chalk_1.default.yellow("[Incremental]")} Could not find changed glossary file, full rebuild...`);
+                    await (0, build_1.runBuildProject)(this.rootProject, this.rootProject);
+                    await this.refreshCaches();
+                    return { changedPages: "*" };
+                }
+                const result = await (0, build_1.buildSingleGlossaryPage)(changedFile, this.baseCtx, this.pageList, this.pagesAndSections, this.rootOut, this.assetsOut, this.hyperbookJson);
+                this.searchDocuments.set(changedFile.path.href || changedFile.path.absolute, result.searchDocuments);
+                for (const directive of result.directives) {
+                    this.directives.add(directive);
+                }
+                await this.copyDirectiveAssets(result.directives);
+                const changedHref = changedFile.path.href || "/glossary";
+                console.log(`${chalk_1.default.green("[Incremental]")} Rebuilt: ${changedHref}`);
+                return { changedPages: [changedHref] };
+            }
+            case "public": {
+                console.log(`${chalk_1.default.yellow("[Incremental]")} Public file change: ${filePath}`);
+                const absPath = path_1.default.resolve(this.root, filePath);
+                // Determine which public folder it belongs to and copy it
+                const publicDirs = [
+                    { dir: path_1.default.join(this.root, "public"), folder: "public" },
+                    { dir: path_1.default.join(this.root, "book-public"), folder: "book-public" },
+                    { dir: path_1.default.join(this.root, "glossary-public"), folder: "glossary-public" },
+                ];
+                for (const { dir } of publicDirs) {
+                    if (absPath.startsWith(dir + path_1.default.sep)) {
+                        const relativePath = path_1.default.relative(dir, absPath);
+                        const destPath = path_1.default.join(this.rootOut, relativePath);
+                        const destDir = path_1.default.dirname(destPath);
+                        try {
+                            await promises_1.default.mkdir(destDir, { recursive: true });
+                            await (0, promises_2.cp)(absPath, destPath);
+                            console.log(`${chalk_1.default.green("[Incremental]")} Copied: ${relativePath}`);
+                        }
+                        catch (e) {
+                            console.log(`${chalk_1.default.red("[Incremental]")} Failed to copy: ${relativePath}`);
+                        }
+                        break;
+                    }
+                }
+                // Public file changes affect all pages (images could be on any page)
+                return { changedPages: "*" };
+            }
+        }
+    }
+    async copyDirectiveAssets(newDirectives) {
+        const assetsPath = path_1.default.join(__dirname, "assets");
+        for (const directive of newDirectives) {
+            const assetsDirectivePath = path_1.default.join(assetsPath, `directive-${directive}`);
+            const assetsDirectiveOut = path_1.default.join(this.assetsOut, `directive-${directive}`);
+            try {
+                await promises_1.default.access(assetsDirectivePath);
+                await promises_1.default.mkdir(assetsDirectiveOut, { recursive: true });
+                await (0, promises_2.cp)(assetsDirectivePath, assetsDirectiveOut, { recursive: true });
+            }
+            catch {
+                // Directive has no assets or already copied
+            }
+        }
+    }
+}
+exports.IncrementalBuilder = IncrementalBuilder;
+
+
 /***/ }),
 
 /***/ 35773:
@@ -200968,18 +201315,14 @@ var remarkDirectiveBlockflowEditor_default = (ctx) => () => {
           const config2 = {};
           if (title) config2.title = title;
           if (src) config2.sb3 = ctx.makeUrl(src, "public", ctx.navigation.current || void 0);
-          const ui = {};
           if (allowExtensions !== void 0) {
-            ui.allowExtensions = allowExtensions !== "false";
+            config2.ui = { allowExtensions: allowExtensions !== "false" };
           }
           if (showCostumesTab !== void 0) {
-            ui.showCostumesTab = showCostumesTab !== "false";
+            config2.costumes = { enabled: showCostumesTab !== "false" };
           }
           if (showSoundsTab !== void 0) {
-            ui.showSoundsTab = showSoundsTab !== "false";
-          }
-          if (Object.keys(ui).length > 0) {
-            config2.ui = ui;
+            config2.sounds = { enabled: showSoundsTab !== "false" };
           }
           if (categories || Object.keys(rest).some((k) => k.startsWith("blocks-"))) {
             config2.toolbox = {};
@@ -200999,9 +201342,11 @@ var remarkDirectiveBlockflowEditor_default = (ctx) => () => {
           }
           if (steps.length > 0) config2.steps = steps;
           const configJson = JSON.stringify(config2);
-          projectParam = Buffer.from(configJson).toString("base64");
+          const compressed = deflate_1(configJson);
+          const encoded = "pako:" + Buffer.from(compressed).toString("base64");
+          projectParam = encodeURIComponent(encoded);
         }
-        const iframeSrc = `https://blockflow.openpatch.org?project=${projectParam}`;
+        const iframeSrc = `https://blockflow.openpatch.org/editor?project=${projectParam}`;
         data.hName = "div";
         data.hProperties = {
           class: "directive-blockflow-editor",
@@ -201186,7 +201531,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.87.2","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.88.1","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
 
 /***/ })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperbook",
-  "version": "0.87.2",
+  "version": "0.88.1",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",
@@ -58,7 +58,7 @@
     "ws": "^8.18.0",
     "create-hyperbook": "0.3.5",
     "@hyperbook/fs": "0.25.0",
-    "@hyperbook/markdown": "0.59.2",
+    "@hyperbook/markdown": "0.59.3",
     "@hyperbook/types": "0.22.1"
   },
   "scripts": {