hyperbook 0.99.1 → 0.100.0

package/dist/index.js

@@ -55361,6 +55361,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.ASSETS_FOLDER = void 0;
+exports.writeSearchIndex = writeSearchIndex;
 exports.buildSingleBookPage = buildSingleBookPage;
 exports.buildSingleGlossaryPage = buildSingleGlossaryPage;
 exports.runBuildProject = runBuildProject;
@@ -55378,15 +55379,72 @@ 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";
+/**
+ * Builds the lunr index and writes search.js. Extracted so the dev server can
+ * regenerate it after an incremental rebuild instead of leaving it stale.
+ */
+async function writeSearchIndex(hyperbookJson, baseCtx, searchDocuments, rootOut, prefix = "Hyperbook") {
+    if (!hyperbookJson.search)
+        return;
+    const documents = {};
+    console.log(`${chalk_1.default.blue(`[${prefix}]`)} Building search index`);
+    let foundLanguage = false;
+    if (hyperbookJson.language && hyperbookJson.language !== "en") {
+        try {
+            // 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) {
+            console.log(e);
+            console.log(`${chalk_1.default.yellow(`[${prefix}]`)} ${hyperbookJson.language} is not a valid value for the language key. See https://github.com/MihaiValentin/lunr-languages for possible values. Falling back to English.`);
+        }
+    }
+    const idx = (0, lunr_1.default)(function () {
+        if (foundLanguage) {
+            // @ts-ignore
+            this.use(lunr_1.default[hyperbookJson.language]);
+        }
+        this.ref("href");
+        this.field("description");
+        this.field("keywords");
+        this.field("heading");
+        this.field("content");
+        this.metadataWhitelist = ["position"];
+        searchDocuments.forEach((doc) => {
+            const href = baseCtx.makeUrl(doc.href, "book");
+            const docWithBase = {
+                ...doc,
+                href,
+            };
+            this.add(docWithBase);
+            documents[href] = docWithBase;
+        });
+    });
+    const js = `
+const LUNR_INDEX = ${JSON.stringify(idx)};
+const SEARCH_DOCUMENTS = ${JSON.stringify(documents)};
+`;
+    await promises_1.default.writeFile(path_1.default.join(rootOut, exports.ASSETS_FOLDER, "search.js"), js);
+}
 async function buildSingleBookPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson) {
     const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
     const navigation = {
         ...n1,
         ...pagesAndSections,
     };
+    // Templates and snippets were inlined while the vfile was read; directive
+    // `src=` files are collected as the markdown is processed.
+    const dependencies = new Set((file.markdown.dependencies || []).map((d) => path_1.default.resolve(file.root, d)));
     const ctx = {
         ...baseCtx,
         navigation,
+        dependencies,
     };
     const result = await (0, markdown_1.process)(file.markdown.content, ctx);
     const searchDocuments = [...(result.data.searchDocuments || [])];
@@ -55429,7 +55487,7 @@ async function buildSingleBookPage(file, baseCtx, pageList, pagesAndSections, ro
         await promises_1.default.writeFile(permaFileOut, redirectHtml);
     }
     await promises_1.default.writeFile(fileOut, result.value);
-    return { searchDocuments, directives };
+    return { searchDocuments, directives, dependencies: [...dependencies] };
 }
 async function buildSingleGlossaryPage(file, baseCtx, pageList, pagesAndSections, rootOut, assetsOut, hyperbookJson) {
     const n1 = await fs_1.hyperbook.getNavigationForFile(pageList, file);
@@ -55452,9 +55510,13 @@ async function buildSingleGlossaryPage(file, baseCtx, pageList, pagesAndSections
             layout: file.markdown.data.layout,
         };
     }
+    // Templates and snippets were inlined while the vfile was read; directive
+    // `src=` files are collected as the markdown is processed.
+    const dependencies = new Set((file.markdown.dependencies || []).map((d) => path_1.default.resolve(file.root, d)));
     const ctx = {
         ...baseCtx,
         navigation,
+        dependencies,
     };
     const result = await (0, markdown_1.process)(file.markdown.content, ctx);
     const searchDocuments = [...(result.data.searchDocuments || [])];
@@ -55484,7 +55546,7 @@ async function buildSingleGlossaryPage(file, baseCtx, pageList, pagesAndSections
         await (0, make_dir_1.makeDir)(glossaryOut, { recursive: true });
     }
     await promises_1.default.writeFile(fileOut, result.value);
-    return { searchDocuments, directives };
+    return { searchDocuments, directives, dependencies: [...dependencies] };
 }
 /**
  * Generates an llms.txt file by combining all markdown files in order
@@ -55596,11 +55658,11 @@ Also you need to use unique ids when the element supports it.
     const llmsTxtContent = lines.join("\n");
     await promises_1.default.writeFile(path_1.default.join(rootOut, "llms.txt"), llmsTxtContent);
 }
-async function runBuildProject(project, rootProject, out, filter) {
+async function runBuildProject(project, rootProject, out, filter, onPage) {
     const name = fs_1.hyperproject.getName(project);
     if (project.type === "book") {
         console.log(`${chalk_1.default.cyan(`[${name}]`)} Building Book.`);
-        await runBuild(project.src, rootProject, project.basePath, name, out, filter);
+        await runBuild(project.src, rootProject, project.basePath, name, out, filter, onPage);
     }
     else {
         console.log(`${chalk_1.default.cyan(`[${name}]`)} Building Library.`);
@@ -55609,7 +55671,7 @@ async function runBuildProject(project, rootProject, out, filter) {
         }
         await (0, rimraf_1.rimraf)(path_1.default.join(out, ".hyperbook", "out"));
         for (const p of project.projects) {
-            await runBuildProject(p, rootProject, out, filter);
+            await runBuildProject(p, rootProject, out, filter, onPage);
         }
     }
 }
@@ -55688,7 +55750,7 @@ function makeBaseCtx(root, hyperbookJson, basePath, rootProject) {
         project: rootProject,
     };
 }
-async function runBuild(root, rootProject, basePath, prefix, out, filter) {
+async function runBuild(root, rootProject, basePath, prefix, out, filter, onPage) {
     var _a;
     console.log(`${chalk_1.default.blue(`[${prefix}]`)} Reading hyperbook.json.`);
     const hyperbookJson = await fs_1.hyperbook.getJson(root);
@@ -55738,6 +55800,7 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
         for (let directive of pageResult.directives) {
             directives.add(directive);
         }
+        onPage === null || onPage === void 0 ? void 0 : onPage(file.path.href || file.path.absolute, pageResult);
         if (!process.env.CI) {
             readline_1.default.clearLine(process.stdout, 0);
             readline_1.default.cursorTo(process.stdout, 0);
@@ -55759,6 +55822,7 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
         for (let directive of pageResult.directives) {
             directives.add(directive);
         }
+        onPage === null || onPage === void 0 ? void 0 : onPage(file.path.href || file.path.absolute, pageResult);
         if (!process.env.CI) {
             readline_1.default.clearLine(process.stdout, 0);
             readline_1.default.cursorTo(process.stdout, 0);
@@ -55963,52 +56027,7 @@ async function runBuild(root, rootProject, basePath, prefix, out, filter) {
         }
     }
     process.stdout.write("\n");
-    if (hyperbookJson.search) {
-        const documents = {};
-        console.log(`${chalk_1.default.blue(`[${prefix}]`)} Building search index`);
-        let foundLanguage = false;
-        if (hyperbookJson.language && hyperbookJson.language !== "en") {
-            try {
-                // 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) {
-                console.log(e);
-                console.log(`${chalk_1.default.yellow(`[${prefix}]`)} ${hyperbookJson.language} is not a valid value for the language key. See https://github.com/MihaiValentin/lunr-languages for possible values. Falling back to English.`);
-            }
-        }
-        const idx = (0, lunr_1.default)(function () {
-            if (foundLanguage) {
-                // @ts-ignore
-                this.use(lunr_1.default[hyperbookJson.language]);
-            }
-            this.ref("href");
-            this.field("description");
-            this.field("keywords");
-            this.field("heading");
-            this.field("content");
-            this.metadataWhitelist = ["position"];
-            searchDocuments.forEach((doc) => {
-                const href = baseCtx.makeUrl(doc.href, "book");
-                const docWithBase = {
-                    ...doc,
-                    href,
-                };
-                this.add(docWithBase);
-                documents[href] = docWithBase;
-            });
-        });
-        const js = `
-const LUNR_INDEX = ${JSON.stringify(idx)};
-const SEARCH_DOCUMENTS = ${JSON.stringify(documents)};
-`;
-        await promises_1.default.writeFile(path_1.default.join(rootOut, exports.ASSETS_FOLDER, "search.js"), js);
-    }
+    await writeSearchIndex(hyperbookJson, baseCtx, searchDocuments, rootOut, prefix);
     const supportLanguages = await promises_1.default
         .readdir(path_1.default.join(__dirname, "locales"))
         .then((files) => files.map((file) => file.split(".")[0]));
@@ -56554,17 +56573,65 @@ class IncrementalBuilder {
         // Track known files for structural change detection
         this.knownBookFiles = new Set();
         this.knownGlossaryFiles = new Set();
+        // Reverse dependency index: inlined file -> pages that inlined it. Built from
+        // what each page actually read, so a change maps to the pages it can affect
+        // rather than to a guess based on the file's folder.
+        this.dependents = new Map();
+        // Page absolute path -> the file it was built from, to rebuild by dependency.
+        this.bookFileByPath = new Map();
+        this.glossaryFileByPath = new Map();
+        // Nav-relevant shape of the last build, to notice when every page goes stale.
+        this.navigationFingerprint = "";
         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);
+        await this.fullRebuild();
         // Populate caches after full build
         await this.refreshCaches();
         this.initialized = true;
         console.log(`${chalk_1.default.green("[Incremental]")} Initial build complete. Incremental mode active.`);
     }
+    /**
+     * Full rebuild that also repopulates the dependency graph and the cached
+     * search documents, so incremental updates afterwards start from the truth.
+     */
+    async fullRebuild() {
+        this.dependents.clear();
+        this.searchDocuments.clear();
+        await (0, build_1.runBuildProject)(this.rootProject, this.rootProject, undefined, undefined, (href, result) => {
+            this.recordPageResult(href, result);
+        });
+    }
+    /** Indexes one page's dependencies and search documents. */
+    recordPageResult(href, result) {
+        // Drop stale edges first: a page that no longer uses a file must not keep
+        // being rebuilt when that file changes.
+        for (const pages of this.dependents.values()) {
+            pages.delete(href);
+        }
+        for (const dependency of result.dependencies) {
+            let pages = this.dependents.get(dependency);
+            if (!pages) {
+                pages = new Set();
+                this.dependents.set(dependency, pages);
+            }
+            pages.add(href);
+        }
+        this.searchDocuments.set(href, result.searchDocuments);
+    }
+    /**
+     * Everything that is baked into every page's HTML — the sidebar, page order,
+     * titles. When this changes, one rebuilt page is not enough.
+     */
+    computeNavigationFingerprint() {
+        var _a, _b, _c, _d;
+        return JSON.stringify({
+            sections: (_b = (_a = this.pagesAndSections) === null || _a === void 0 ? void 0 : _a.sections) !== null && _b !== void 0 ? _b : [],
+            pages: (_d = (_c = this.pagesAndSections) === null || _c === void 0 ? void 0 : _c.pages) !== null && _d !== void 0 ? _d : [],
+        });
+    }
     async refreshCaches() {
         var _a;
         const project = this.rootProject;
@@ -56592,21 +56659,33 @@ class IncrementalBuilder {
         // Track known files
         this.knownBookFiles.clear();
         this.knownGlossaryFiles.clear();
+        this.bookFileByPath.clear();
+        this.glossaryFileByPath.clear();
         const bookFiles = await fs_1.vfile.listForFolder(this.root, "book");
         for (const f of bookFiles) {
             this.knownBookFiles.add(f.path.absolute);
+            this.bookFileByPath.set(f.path.absolute, f);
         }
         const glossaryFiles = await fs_1.vfile.listForFolder(this.root, "glossary");
         for (const f of glossaryFiles) {
             this.knownGlossaryFiles.add(f.path.absolute);
+            this.glossaryFileByPath.set(f.path.absolute, f);
         }
+        this.navigationFingerprint = this.computeNavigationFingerprint();
     }
     classifyChange(filePath, eventType) {
+        var _a;
         const absPath = path_1.default.resolve(this.root, filePath);
         // Config changes always trigger full rebuild
         if (filePath === "hyperbook.json" || filePath === "hyperlibrary.json") {
             return "config";
         }
+        // A file some page inlined — rebuild those pages, whatever folder it is in.
+        // Checked before the folder rules, because a `src=` target usually lives in
+        // public/ or book/ and would otherwise be treated as a plain asset.
+        if ((_a = this.dependents.get(absPath)) === null || _a === void 0 ? void 0 : _a.size) {
+            return "dependency";
+        }
         // 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");
@@ -56623,7 +56702,10 @@ class IncrementalBuilder {
         // 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");
+            const isMarkdown = filePath.endsWith(".md") ||
+                filePath.endsWith(".md.hbs") ||
+                filePath.endsWith(".md.json") ||
+                filePath.endsWith(".md.yml");
             if (isMarkdown) {
                 return "content-book";
             }
@@ -56640,7 +56722,7 @@ class IncrementalBuilder {
     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.fullRebuild();
             await this.refreshCaches();
             return { changedPages: "*" };
         }
@@ -56650,10 +56732,33 @@ class IncrementalBuilder {
             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.fullRebuild();
                 await this.refreshCaches();
                 return { changedPages: "*" };
             }
+            case "dependency": {
+                const absPath = path_1.default.resolve(this.root, filePath);
+                const pages = [...(this.dependents.get(absPath) || [])];
+                console.log(`${chalk_1.default.yellow("[Incremental]")} Dependency change: ${filePath} -> ${pages.length} page(s)`);
+                // The file itself may also be a served asset (a `src=` script under
+                // public/ is both inlined and downloadable), so copy it as well.
+                await this.copyIfPublic(filePath);
+                fs_1.vfile.clean(this.root);
+                await this.refreshCaches();
+                const rebuilt = [];
+                for (const href of pages) {
+                    const file = [...this.bookFileByPath.values()].find((f) => (f.path.href || "/") === href) ||
+                        [...this.glossaryFileByPath.values()].find((f) => (f.path.href || "/glossary") === href);
+                    if (!file)
+                        continue;
+                    const result = await this.rebuildPage(file.path.absolute);
+                    if (result)
+                        rebuilt.push(result);
+                }
+                await this.refreshSearchIndex();
+                console.log(`${chalk_1.default.green("[Incremental]")} Rebuilt: ${rebuilt.join(", ") || "nothing"}`);
+                return { changedPages: rebuilt };
+            }
             case "content-book": {
                 console.log(`${chalk_1.default.yellow("[Incremental]")} Content change: ${filePath}`);
                 // Clear vfile cache so it re-reads the changed file
@@ -56666,19 +56771,39 @@ class IncrementalBuilder {
                 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.fullRebuild();
                     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);
+                // Reindex, so a page that dropped a `src=` or a snippet stops being
+                // rebuilt when that file changes.
+                this.recordPageResult(changedFile.path.href || "/", result);
                 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 || "/";
+                // The sidebar is baked into every page, so a rename or reorder makes
+                // all of them stale — rebuilding just this one would leave the rest
+                // showing the old title.
+                const nextFingerprint = this.computeNavigationFingerprint();
+                if (nextFingerprint !== this.navigationFingerprint) {
+                    console.log(`${chalk_1.default.yellow("[Incremental]")} Navigation changed, rebuilding all pages...`);
+                    this.navigationFingerprint = nextFingerprint;
+                    for (const absolute of this.bookFileByPath.keys()) {
+                        if (absolute === absPath)
+                            continue;
+                        await this.rebuildPage(absolute);
+                    }
+                    for (const absolute of this.glossaryFileByPath.keys()) {
+                        await this.rebuildPage(absolute);
+                    }
+                    await this.refreshSearchIndex();
+                    return { changedPages: "*" };
+                }
+                await this.refreshSearchIndex();
                 console.log(`${chalk_1.default.green("[Incremental]")} Rebuilt: ${changedHref}`);
                 return { changedPages: [changedHref] };
             }
@@ -56692,50 +56817,91 @@ class IncrementalBuilder {
                 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.fullRebuild();
                     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);
+                this.recordPageResult(changedFile.path.href || "/glossary", result);
                 for (const directive of result.directives) {
                     this.directives.add(directive);
                 }
                 await this.copyDirectiveAssets(result.directives);
                 const changedHref = changedFile.path.href || "/glossary";
+                await this.refreshSearchIndex();
                 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)
+                await this.copyIfPublic(filePath);
+                // No page inlined this file — it is a plain asset, so nothing needs
+                // rebuilding, but any page could embed it, so reload everything.
                 return { changedPages: "*" };
             }
         }
     }
+    /** Copies a changed file to the output if it lives in a public folder. */
+    async copyIfPublic(filePath) {
+        const absPath = path_1.default.resolve(this.root, filePath);
+        const publicDirs = [
+            path_1.default.join(this.root, "public"),
+            path_1.default.join(this.root, "book-public"),
+            path_1.default.join(this.root, "glossary-public"),
+        ];
+        for (const dir of publicDirs) {
+            if (!absPath.startsWith(dir + path_1.default.sep))
+                continue;
+            const relativePath = path_1.default.relative(dir, absPath);
+            const destPath = path_1.default.join(this.rootOut, relativePath);
+            try {
+                await promises_1.default.mkdir(path_1.default.dirname(destPath), { 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}`);
+            }
+            return;
+        }
+    }
+    /** Rebuilds one book or glossary page and reindexes what it consumed. */
+    async rebuildPage(absPath) {
+        const bookFile = this.bookFileByPath.get(absPath);
+        if (bookFile) {
+            const result = await (0, build_1.buildSingleBookPage)(bookFile, this.baseCtx, this.pageList, this.pagesAndSections, this.rootOut, this.assetsOut, this.hyperbookJson);
+            const href = bookFile.path.href || "/";
+            this.recordPageResult(href, result);
+            for (const directive of result.directives) {
+                this.directives.add(directive);
+            }
+            await this.copyDirectiveAssets(result.directives);
+            return href;
+        }
+        const glossaryFile = this.glossaryFileByPath.get(absPath);
+        if (glossaryFile) {
+            const result = await (0, build_1.buildSingleGlossaryPage)(glossaryFile, this.baseCtx, this.pageList, this.pagesAndSections, this.rootOut, this.assetsOut, this.hyperbookJson);
+            const href = glossaryFile.path.href || "/glossary";
+            this.recordPageResult(href, result);
+            for (const directive of result.directives) {
+                this.directives.add(directive);
+            }
+            await this.copyDirectiveAssets(result.directives);
+            return href;
+        }
+        return null;
+    }
+    /** Rewrites search.js from the cached per-page documents. */
+    async refreshSearchIndex() {
+        var _a;
+        if (!((_a = this.hyperbookJson) === null || _a === void 0 ? void 0 : _a.search))
+            return;
+        const all = [];
+        for (const docs of this.searchDocuments.values()) {
+            all.push(...docs);
+        }
+        await (0, build_1.writeSearchIndex)(this.hyperbookJson, this.baseCtx, all, this.rootOut, "Incremental");
+    }
     async copyDirectiveAssets(newDirectives) {
         const assetsPath = path_1.default.join(__dirname, "assets");
         for (const directive of newDirectives) {
@@ -94869,6 +95035,8 @@ var getMarkdown = async (file) => {
     );
   }
   registerHelpers(import_handlebars.default, { file });
+  const dependencies = [];
+  const addDependency = (absolute) => dependencies.push(external_path_.relative(file.root, absolute));
   let markdown = "";
   if (file.extension === ".md.yml") {
     const j = await promises_.readFile(file.path.absolute).then((f) => dist.parse(f.toString()));
@@ -94877,9 +95045,13 @@ var getMarkdown = async (file) => {
         `Yaml files need a template. You need to define a template property in your yaml file: ${file.path.absolute}`
       );
     } else {
-      const templateSource = await promises_.readFile(
-        external_path_.join(file.root, "templates", j.template + ".md.hbs")
+      const templatePath = external_path_.join(
+        file.root,
+        "templates",
+        j.template + ".md.hbs"
       );
+      addDependency(templatePath);
+      const templateSource = await promises_.readFile(templatePath);
       const template = import_handlebars.default.compile(templateSource.toString());
       markdown = template(j);
     }
@@ -94890,9 +95062,13 @@ var getMarkdown = async (file) => {
         `JSON files need a template. You need to define a template property in your json file: ${file.path.absolute}`
       );
     } else {
-      const templateSource = await promises_.readFile(
-        external_path_.join(file.root, "templates", j.template + ".md.hbs")
+      const templatePath = external_path_.join(
+        file.root,
+        "templates",
+        j.template + ".md.hbs"
       );
+      addDependency(templatePath);
+      const templateSource = await promises_.readFile(templatePath);
       const template = import_handlebars.default.compile(templateSource.toString());
       markdown = template(j);
     }
@@ -94915,10 +95091,9 @@ var getMarkdown = async (file) => {
   for (const snippet of snippets) {
     const dots = snippet[2];
     const snippetId = snippet[3];
-    const snippetFile = await promises_.readFile(
-      external_path_.join(file.root, "snippets", snippetId + ".md.hbs"),
-      { encoding: "utf8" }
-    );
+    const snippetPath = external_path_.join(file.root, "snippets", snippetId + ".md.hbs");
+    addDependency(snippetPath);
+    const snippetFile = await promises_.readFile(snippetPath, { encoding: "utf8" });
     const template = import_handlebars.default.compile(snippetFile);
     const vars = {
       hyperbook,
@@ -94968,6 +95143,7 @@ var getMarkdown = async (file) => {
   }
   return {
     content,
+    dependencies,
     data: { ...data }
   };
 };
@@ -174933,6 +175109,7 @@ var en_default = {
   "pyide-canvas": "Canvas",
   "pyide-input": "Input",
   "pyide-input-prompt": "Input required:",
+  "pyide-input-submit": "Send",
   "pyide-reset": "Reset",
   "pyide-copy": "Copy",
   "pyide-download": "Download",
@@ -175076,6 +175253,7 @@ var de_default = {
   "pyide-canvas": "Canvas",
   "pyide-input": "Eingabe",
   "pyide-input-prompt": "Eingabe erforderlich:",
+  "pyide-input-submit": "Senden",
   "pyide-reset": "Zur\xFCcksetzen",
   "pyide-copy": "Kopieren",
   "pyide-download": "Herunterladen",
@@ -177242,7 +177420,7 @@ var remarkDirectiveTiles_default = (ctx) => () => {
             if (node4.name !== "tile") {
               return;
             }
-            const { title, size = "M", icon, href } = node4.attributes || {};
+            const { title, size = "M", icon: icon2, href } = node4.attributes || {};
             expectLeafDirective(node4, file, "tile");
             if (!title) {
               file.fail(
@@ -177266,11 +177444,11 @@ var remarkDirectiveTiles_default = (ctx) => () => {
                 ]
               }
             ];
-            if (icon) {
-              const emojiMatch = icon.match(/^:([+\w-]+):$/);
+            if (icon2) {
+              const emojiMatch = icon2.match(/^:([+\w-]+):$/);
               if (emojiMatch) {
                 const emojiName = emojiMatch[1];
-                const emoji = github_emojis_default[emojiName] ?? icon;
+                const emoji = github_emojis_default[emojiName] ?? icon2;
                 tileChildren.push({
                   type: "element",
                   tagName: "span",
@@ -177290,7 +177468,7 @@ var remarkDirectiveTiles_default = (ctx) => () => {
                   tagName: "img",
                   properties: {
                     class: "tile-icon",
-                    src: ctx.makeUrl(icon, "public")
+                    src: ctx.makeUrl(icon2, "public")
                   },
                   children: []
                 });
@@ -179914,9 +180092,9 @@ var makeHeaderElements = (ctx) => {
             let submenu = [];
             if ("links" in link3) {
               const links = link3.links.map((link4) => {
-                let icon2 = [];
+                let icon3 = [];
                 if (link4.icon) {
-                  icon2.push({
+                  icon3.push({
                     type: "element",
                     tagName: "div",
                     properties: {
@@ -179944,7 +180122,7 @@ var makeHeaderElements = (ctx) => {
                         href: "href" in link4 ? link4.href : "#"
                       },
                       children: [
-                        ...icon2,
+                        ...icon3,
                         {
                           type: "element",
                           tagName: "div",
@@ -179972,9 +180150,9 @@ var makeHeaderElements = (ctx) => {
                 children: links
               });
             }
-            const icon = [];
+            const icon2 = [];
             if (link3.icon) {
-              icon.push({
+              icon2.push({
                 type: "element",
                 tagName: "div",
                 properties: {
@@ -180004,7 +180182,7 @@ var makeHeaderElements = (ctx) => {
                     href
                   },
                   children: [
-                    ...icon,
+                    ...icon2,
                     {
                       type: "element",
                       tagName: "div",
@@ -180431,9 +180609,9 @@ var makeCustomLinksFooter = (ctx) => {
         let submenu = [];
         if ("links" in link3) {
           const links = link3.links.map((link4) => {
-            let icon2 = [];
+            let icon3 = [];
             if (link4.icon) {
-              icon2.push({
+              icon3.push({
                 type: "element",
                 tagName: "div",
                 properties: {
@@ -180461,7 +180639,7 @@ var makeCustomLinksFooter = (ctx) => {
                     href: "href" in link4 ? link4.href : "#"
                   },
                   children: [
-                    ...icon2,
+                    ...icon3,
                     {
                       type: "element",
                       tagName: "div",
@@ -180489,9 +180667,9 @@ var makeCustomLinksFooter = (ctx) => {
             children: links
           });
         }
-        const icon = [];
+        const icon2 = [];
         if (link3.icon) {
-          icon.push({
+          icon2.push({
             type: "element",
             tagName: "div",
             properties: {
@@ -180524,7 +180702,7 @@ var makeCustomLinksFooter = (ctx) => {
                     href
                   },
                   children: [
-                    ...icon,
+                    ...icon2,
                     {
                       type: "element",
                       tagName: "div",
@@ -180803,10 +180981,10 @@ var remarkDirectiveAlert_default = (ctx) => () => {
         const color3 = node3.attributes?.color;
         const content5 = node3.attributes?.label;
         const type = Object.keys(node3.attributes || {}).join(" ").trim();
-        const icon = content5 || type;
+        const icon2 = content5 || type;
         data.hName = "div";
         data.hProperties = {
-          class: `directive-alert ${type} ${icon ? "icon" : ""}`.trim(),
+          class: `directive-alert ${type} ${icon2 ? "icon" : ""}`.trim(),
           style: `${color3 ? `--alert-color: ${color3};` : ""} ${content5 ? `--alert-content: '${content5}';` : ""}`
         };
       }
@@ -181037,6 +181215,68 @@ var remarkDirectiveCollapsible_default = (ctx) => function() {
   };
 };
 
+// src/icons.ts
+var PATHS = {
+  // rotate-ccw
+  reset: ["M1 4v6h6", "M3.51 15a9 9 0 1 0 2.13-9.36L1 10"],
+  // two offset sheets
+  copy: [
+    "M9 9h11a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2h-9a2 2 0 0 1-2-2V9z",
+    "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"
+  ],
+  // arrow into a tray
+  download: [
+    "M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4",
+    "M7 10l5 5 5-5",
+    "M12 15V3"
+  ],
+  // four corner brackets
+  fullscreen: [
+    "M8 3H5a2 2 0 0 0-2 2v3",
+    "M21 8V5a2 2 0 0 0-2-2h-3",
+    "M16 21h3a2 2 0 0 0 2-2v-3",
+    "M3 16v3a2 2 0 0 0 2 2h3"
+  ],
+  // closed padlock
+  lock: [
+    "M5 11h14a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2z",
+    "M7 11V7a5 5 0 0 1 10 0v4"
+  ],
+  plus: ["M12 5v14", "M5 12h14"],
+  // lidded box — the whole project rather than a single file
+  archive: ["M21 8v13H3V8", "M1 3h22v5H1z", "M10 12h4"],
+  // document with a folded corner — the rendered PDF
+  pdf: [
+    "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z",
+    "M14 2v6h6",
+    "M16 13H8",
+    "M16 17H8"
+  ],
+  // disclosure arrow; rotated by CSS when the section is open
+  chevron: ["M9 18l6-6-6-6"]
+};
+var icon = (name) => ({
+  type: "element",
+  tagName: "svg",
+  properties: {
+    className: ["icon", `icon-${name}`],
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "currentColor",
+    strokeWidth: "2",
+    strokeLinecap: "round",
+    strokeLinejoin: "round",
+    "aria-hidden": "true",
+    focusable: "false"
+  },
+  children: PATHS[name].map((d) => ({
+    type: "element",
+    tagName: "path",
+    properties: { d },
+    children: []
+  }))
+});
+
 // src/remarkDirectiveArchive.ts
 var remarkDirectiveArchive_default = (ctx) => () => {
   const name = "archive";
@@ -181062,12 +181302,7 @@ var remarkDirectiveArchive_default = (ctx) => () => {
             properties: {
               class: "icon"
             },
-            children: [
-              {
-                type: "text",
-                value: "\u23EC"
-              }
-            ]
+            children: [icon("download")]
           },
           {
             type: "element",
@@ -181112,12 +181347,7 @@ var remarkDirectiveDownload_default = (ctx) => () => {
             properties: {
               class: "icon"
             },
-            children: [
-              {
-                type: "text",
-                value: "\u23EC"
-              }
-            ]
+            children: [icon("download")]
           },
           {
             type: "element",
@@ -181351,9 +181581,12 @@ var remarkDirectiveProtect_default = (ctx) => function() {
               type: "paragraph",
               data: {
                 hName: "span",
-                hProperties: { class: "icon" }
+                hProperties: { class: "icon" },
+                // This is an mdast node, so the hast icon has to be handed
+                // over as hChildren — mdast children would drop it.
+                hChildren: [icon("lock")]
               },
-              children: [{ type: "text", value: "\u{1F512}" }]
+              children: []
             },
             {
               type: "paragraph",
@@ -194338,6 +194571,8 @@ var getMarkdown = async (file) => {
     );
   }
   registerHelpers(import_handlebars.default, { file });
+  const dependencies = [];
+  const addDependency = (absolute) => dependencies.push(path__WEBPACK_IMPORTED_MODULE_4__.relative(file.root, absolute));
   let markdown = "";
   if (file.extension === ".md.yml") {
     const j = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(file.path.absolute).then((f) => import_yaml5.default.parse(f.toString()));
@@ -194346,9 +194581,13 @@ var getMarkdown = async (file) => {
         `Yaml files need a template. You need to define a template property in your yaml file: ${file.path.absolute}`
       );
     } else {
-      const templateSource = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(
-        path__WEBPACK_IMPORTED_MODULE_4__.join(file.root, "templates", j.template + ".md.hbs")
+      const templatePath = path__WEBPACK_IMPORTED_MODULE_4__.join(
+        file.root,
+        "templates",
+        j.template + ".md.hbs"
       );
+      addDependency(templatePath);
+      const templateSource = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(templatePath);
       const template = import_handlebars.default.compile(templateSource.toString());
       markdown = template(j);
     }
@@ -194359,9 +194598,13 @@ var getMarkdown = async (file) => {
         `JSON files need a template. You need to define a template property in your json file: ${file.path.absolute}`
       );
     } else {
-      const templateSource = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(
-        path__WEBPACK_IMPORTED_MODULE_4__.join(file.root, "templates", j.template + ".md.hbs")
+      const templatePath = path__WEBPACK_IMPORTED_MODULE_4__.join(
+        file.root,
+        "templates",
+        j.template + ".md.hbs"
       );
+      addDependency(templatePath);
+      const templateSource = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(templatePath);
       const template = import_handlebars.default.compile(templateSource.toString());
       markdown = template(j);
     }
@@ -194384,10 +194627,9 @@ var getMarkdown = async (file) => {
   for (const snippet of snippets) {
     const dots = snippet[2];
     const snippetId = snippet[3];
-    const snippetFile = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(
-      path__WEBPACK_IMPORTED_MODULE_4__.join(file.root, "snippets", snippetId + ".md.hbs"),
-      { encoding: "utf8" }
-    );
+    const snippetPath = path__WEBPACK_IMPORTED_MODULE_4__.join(file.root, "snippets", snippetId + ".md.hbs");
+    addDependency(snippetPath);
+    const snippetFile = await fs_promises__WEBPACK_IMPORTED_MODULE_5__.readFile(snippetPath, { encoding: "utf8" });
     const template = import_handlebars.default.compile(snippetFile);
     const vars = {
       hyperbook,
@@ -194437,6 +194679,7 @@ var getMarkdown = async (file) => {
   }
   return {
     content: content5,
+    dependencies,
     data: { ...data }
   };
 };
@@ -195172,29 +195415,24 @@ function node2(value) {
 
 
 var readFile = (src, ctx) => {
-  let srcFile = null;
-  try {
-    srcFile = fs__WEBPACK_IMPORTED_MODULE_7__.readFileSync(path__WEBPACK_IMPORTED_MODULE_4__.join(ctx.root, "public", src), "utf-8");
-  } catch (e) {
+  const candidates = [
+    path__WEBPACK_IMPORTED_MODULE_4__.join(ctx.root, "public", src),
+    path__WEBPACK_IMPORTED_MODULE_4__.join(ctx.root, "book", src),
+    path__WEBPACK_IMPORTED_MODULE_4__.join(
+      ctx.root,
+      "book",
+      ctx.navigation.current?.path?.directory || "",
+      src
+    )
+  ];
+  for (const candidate of candidates) {
+    ctx.dependencies?.add(candidate);
     try {
-      srcFile = fs__WEBPACK_IMPORTED_MODULE_7__.readFileSync(path__WEBPACK_IMPORTED_MODULE_4__.join(ctx.root, "book", src), "utf-8");
-    } catch (e2) {
-      try {
-        srcFile = fs__WEBPACK_IMPORTED_MODULE_7__.readFileSync(
-          path__WEBPACK_IMPORTED_MODULE_4__.join(
-            ctx.root,
-            "book",
-            ctx.navigation.current?.path?.directory || "",
-            src
-          ),
-          "utf-8"
-        );
-      } catch (e3) {
-        return null;
-      }
+      return fs__WEBPACK_IMPORTED_MODULE_7__.readFileSync(candidate, "utf-8");
+    } catch (e) {
     }
   }
-  return srcFile;
+  return null;
 };
 
 // src/rehypeDirectiveP5.ts
@@ -195366,40 +195604,31 @@ ${(code4.scripts ? [cdnLibraryUrl, ...code4.scripts] : []).map((src) => `<script
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "reset"
+                        class: "reset",
+                        title: i18n.get("p5-reset"),
+                        "aria-label": i18n.get("p5-reset")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("p5-reset")
-                        }
-                      ]
+                      children: [icon("reset")]
                     },
                     {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "copy"
+                        class: "copy",
+                        title: i18n.get("p5-copy"),
+                        "aria-label": i18n.get("p5-copy")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("p5-copy")
-                        }
-                      ]
+                      children: [icon("copy")]
                     },
                     {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "download"
+                        class: "download",
+                        title: i18n.get("p5-download"),
+                        "aria-label": i18n.get("p5-download")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("p5-download")
-                        }
-                      ]
+                      children: [icon("download")]
                     },
                     {
                       type: "element",
@@ -195409,12 +195638,7 @@ ${(code4.scripts ? [cdnLibraryUrl, ...code4.scripts] : []).map((src) => `<script
                         title: i18n.get("ide-fullscreen-enter"),
                         "aria-label": i18n.get("ide-fullscreen-enter")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: "\u26F6"
-                        }
-                      ]
+                      children: [icon("fullscreen")]
                     }
                   ]
                 }
@@ -195598,40 +195822,31 @@ var remarkDirectiveAbcMusic_default = (ctx) => () => {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "reset"
+                        class: "reset",
+                        title: i18n.get("abc-music-reset"),
+                        "aria-label": i18n.get("abc-music-reset")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("abc-music-reset")
-                        }
-                      ]
+                      children: [icon("reset")]
                     },
                     {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "copy"
+                        class: "copy",
+                        title: i18n.get("abc-music-copy"),
+                        "aria-label": i18n.get("abc-music-copy")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("abc-music-copy")
-                        }
-                      ]
+                      children: [icon("copy")]
                     },
                     {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "download"
+                        class: "download",
+                        title: i18n.get("abc-music-download"),
+                        "aria-label": i18n.get("abc-music-download")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("abc-music-download")
-                        }
-                      ]
+                      children: [icon("download")]
                     }
                   ]
                 }
@@ -195670,11 +195885,22 @@ var remarkDirectivePyide_default = (ctx) => () => {
       if (isDirective(node3)) {
         if (node3.name !== name) return;
         const data = node3.data || (node3.data = {});
-        const { src = "", id = hash(node3), packages, height } = node3.attributes || {};
+        const {
+          src = "",
+          id = hash(node3),
+          packages,
+          height
+        } = node3.attributes || {};
         const hasCanvas = "canvas" in (node3.attributes || {});
         const packageList = parsePackagesAttribute(packages);
         expectContainerDirective(node3, file, name);
-        registerDirective(file, name, ["python-friendly-error-messages.js", "client.js"], ["style.css"], []);
+        registerDirective(
+          file,
+          name,
+          ["python-friendly-error-messages.js", "client.js"],
+          ["style.css"],
+          []
+        );
         requestJS(file, ["codemirror", "codemirror.bundle.js"]);
         let srcFile = "";
         let tests = [];
@@ -195807,6 +196033,53 @@ var remarkDirectivePyide_default = (ctx) => () => {
                   class: "output"
                 },
                 children: []
+              },
+              // Shown only while the running script waits on input(). Reading
+              // input here keeps the main thread free, so drawings stay live.
+              {
+                type: "element",
+                tagName: "form",
+                properties: {
+                  class: "stdin hidden"
+                },
+                children: [
+                  // The prompt also goes to the output panel, but that panel is
+                  // hidden while the canvas tab is open — so repeat it here.
+                  {
+                    type: "element",
+                    tagName: "span",
+                    properties: {
+                      class: "stdin-prompt"
+                    },
+                    children: []
+                  },
+                  {
+                    type: "element",
+                    tagName: "input",
+                    properties: {
+                      class: "stdin-field",
+                      type: "text",
+                      autocomplete: "off",
+                      spellcheck: "false",
+                      "aria-label": i18n.get("pyide-input")
+                    },
+                    children: []
+                  },
+                  {
+                    type: "element",
+                    tagName: "button",
+                    properties: {
+                      class: "stdin-submit",
+                      type: "submit"
+                    },
+                    children: [
+                      {
+                        type: "text",
+                        value: i18n.get("pyide-input-submit")
+                      }
+                    ]
+                  }
+                ]
               }
             ]
           },
@@ -195903,40 +196176,31 @@ var remarkDirectivePyide_default = (ctx) => () => {
                     type: "element",
                     tagName: "button",
                     properties: {
-                      class: "reset"
+                      class: "reset",
+                      title: i18n.get("pyide-reset"),
+                      "aria-label": i18n.get("pyide-reset")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: i18n.get("pyide-reset")
-                      }
-                    ]
+                    children: [icon("reset")]
                   },
                   {
                     type: "element",
                     tagName: "button",
                     properties: {
-                      class: "copy"
+                      class: "copy",
+                      title: i18n.get("pyide-copy"),
+                      "aria-label": i18n.get("pyide-copy")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: i18n.get("pyide-copy")
-                      }
-                    ]
+                    children: [icon("copy")]
                   },
                   {
                     type: "element",
                     tagName: "button",
                     properties: {
-                      class: "download"
+                      class: "download",
+                      title: i18n.get("pyide-download"),
+                      "aria-label": i18n.get("pyide-download")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: i18n.get("pyide-download")
-                      }
-                    ]
+                    children: [icon("download")]
                   },
                   {
                     type: "element",
@@ -195946,12 +196210,7 @@ var remarkDirectivePyide_default = (ctx) => () => {
                       title: i18n.get("ide-fullscreen-enter"),
                       "aria-label": i18n.get("ide-fullscreen-enter")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: "\u26F6"
-                      }
-                    ]
+                    children: [icon("fullscreen")]
                   }
                 ]
               }
@@ -196188,27 +196447,21 @@ html, body {
                     type: "element",
                     tagName: "button",
                     properties: {
-                      class: "reset"
+                      class: "reset",
+                      title: i18n.get("webide-reset"),
+                      "aria-label": i18n.get("webide-reset")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: i18n.get("webide-reset")
-                      }
-                    ]
+                    children: [icon("reset")]
                   },
                   {
                     type: "element",
                     tagName: "button",
                     properties: {
-                      class: "download"
+                      class: "download",
+                      title: i18n.get("webide-download"),
+                      "aria-label": i18n.get("webide-download")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: i18n.get("webide-download")
-                      }
-                    ]
+                    children: [icon("download")]
                   },
                   {
                     type: "element",
@@ -196218,12 +196471,7 @@ html, body {
                       title: i18n.get("ide-fullscreen-enter"),
                       "aria-label": i18n.get("ide-fullscreen-enter")
                     },
-                    children: [
-                      {
-                        type: "text",
-                        value: "\u26F6"
-                      }
-                    ]
+                    children: [icon("fullscreen")]
                   }
                 ]
               }
@@ -201165,9 +201413,7 @@ var remarkDirectiveTypst_default = (ctx) => () => {
               );
               binaryFiles.push({ dest, url });
             }
-            const fontMatches = text9.matchAll(
-              /@font\s+src="([^"]+)"/g
-            );
+            const fontMatches = text9.matchAll(/@font\s+src="([^"]+)"/g);
             for (const match of fontMatches) {
               const src = match[1];
               const isRemote = src.startsWith("http://") || src.startsWith("https://");
@@ -201212,9 +201458,7 @@ var remarkDirectiveTypst_default = (ctx) => () => {
               );
               binaryFiles.push({ dest, url });
             }
-            const fontMatches = text9.matchAll(
-              /@font\s+src="([^"]+)"/g
-            );
+            const fontMatches = text9.matchAll(/@font\s+src="([^"]+)"/g);
             for (const match of fontMatches) {
               const src = match[1];
               const isRemote = src.startsWith("http://") || src.startsWith("https://");
@@ -201270,9 +201514,9 @@ var remarkDirectiveTypst_default = (ctx) => () => {
           "data-binary-files": Buffer.from(
             JSON.stringify(binaryFiles)
           ).toString("base64"),
-          "data-font-files": Buffer.from(
-            JSON.stringify(fontFiles)
-          ).toString("base64"),
+          "data-font-files": Buffer.from(JSON.stringify(fontFiles)).toString(
+            "base64"
+          ),
           "data-base-path": basePath,
           "data-page-path": pagePath,
           ...height !== void 0 && !isPreviewMode ? { style: `--typst-height: ${height}` } : {}
@@ -201327,27 +201571,21 @@ var remarkDirectiveTypst_default = (ctx) => () => {
           type: "element",
           tagName: "button",
           properties: {
-            class: "download-pdf"
+            class: "download-pdf",
+            title: i18n.get("typst-download-pdf"),
+            "aria-label": i18n.get("typst-download-pdf")
           },
-          children: [
-            {
-              type: "text",
-              value: i18n.get("typst-download-pdf")
-            }
-          ]
+          children: [icon("pdf")]
         };
         const downloadProjectButton = {
           type: "element",
           tagName: "button",
           properties: {
-            class: "download-project"
+            class: "download-project",
+            title: i18n.get("typst-download-project"),
+            "aria-label": i18n.get("typst-download-project")
           },
-          children: [
-            {
-              type: "text",
-              value: i18n.get("typst-download-project")
-            }
-          ]
+          children: [icon("archive")]
         };
         const createFullscreenButton = () => ({
           type: "element",
@@ -201357,12 +201595,7 @@ var remarkDirectiveTypst_default = (ctx) => () => {
             title: i18n.get("ide-fullscreen-enter"),
             "aria-label": i18n.get("ide-fullscreen-enter")
           },
-          children: [
-            {
-              type: "text",
-              value: "\u26F6"
-            }
-          ]
+          children: [icon("fullscreen")]
         });
         if (isEditMode) {
           data.hChildren = [
@@ -201406,12 +201639,7 @@ var remarkDirectiveTypst_default = (ctx) => () => {
                         class: "add-source-file",
                         title: i18n.get("typst-add-source-file")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: "+"
-                        }
-                      ]
+                      children: [icon("plus")]
                     }
                   ]
                 },
@@ -201440,12 +201668,7 @@ var remarkDirectiveTypst_default = (ctx) => () => {
                               properties: {
                                 class: "summary-indicator"
                               },
-                              children: [
-                                {
-                                  type: "text",
-                                  value: "\u25B6"
-                                }
-                              ]
+                              children: [icon("chevron")]
                             },
                             {
                               type: "text",
@@ -201513,14 +201736,11 @@ var remarkDirectiveTypst_default = (ctx) => () => {
                       type: "element",
                       tagName: "button",
                       properties: {
-                        class: "reset"
+                        class: "reset",
+                        title: i18n.get("typst-reset"),
+                        "aria-label": i18n.get("typst-reset")
                       },
-                      children: [
-                        {
-                          type: "text",
-                          value: i18n.get("typst-reset")
-                        }
-                      ]
+                      children: [icon("reset")]
                     },
                     downloadProjectButton,
                     downloadButton,
@@ -201571,7 +201791,12 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
   return (tree, file) => {
     visit(tree, function(node3) {
       if (isDirective(node3) && node3.name === name) {
-        const { src = "", id = hash(node3), height, library } = node3.attributes || {};
+        const {
+          src = "",
+          id = hash(node3),
+          height,
+          library
+        } = node3.attributes || {};
         const data = node3.data || (node3.data = {});
         const binaryFiles = [];
         for (const child of node3.children) {
@@ -201590,7 +201815,9 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
             text9 = child.children.map(reconstructText).join("");
           }
           if (!text9) continue;
-          const fileMatches = text9.matchAll(/@file\s+dest="([^"]+)"\s+src="([^"]+)"/g);
+          const fileMatches = text9.matchAll(
+            /@file\s+dest="([^"]+)"\s+src="([^"]+)"/g
+          );
           for (const match of fileMatches) {
             const dest = match[1];
             const src2 = match[2];
@@ -201640,7 +201867,9 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                     type: "element",
                     tagName: "div",
                     properties: { class: "preview-header" },
-                    children: [{ type: "text", value: i18n.get("openscad-preview") }]
+                    children: [
+                      { type: "text", value: i18n.get("openscad-preview") }
+                    ]
                   },
                   {
                     type: "element",
@@ -201682,7 +201911,9 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                     type: "element",
                     tagName: "div",
                     properties: { class: "parameters-header" },
-                    children: [{ type: "text", value: i18n.get("openscad-parameters") }]
+                    children: [
+                      { type: "text", value: i18n.get("openscad-parameters") }
+                    ]
                   },
                   {
                     type: "element",
@@ -201718,7 +201949,9 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                     type: "element",
                     tagName: "button",
                     properties: { class: "render" },
-                    children: [{ type: "text", value: i18n.get("openscad-render") }]
+                    children: [
+                      { type: "text", value: i18n.get("openscad-render") }
+                    ]
                   }
                 ]
               },
@@ -201747,12 +201980,7 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                             properties: {
                               class: "summary-indicator"
                             },
-                            children: [
-                              {
-                                type: "text",
-                                value: "\u25B6"
-                              }
-                            ]
+                            children: [icon("chevron")]
                           },
                           {
                             type: "text",
@@ -201821,20 +202049,32 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                   {
                     type: "element",
                     tagName: "button",
-                    properties: { class: "copy" },
-                    children: [{ type: "text", value: i18n.get("openscad-copy") }]
+                    properties: {
+                      class: "copy",
+                      title: i18n.get("openscad-copy"),
+                      "aria-label": i18n.get("openscad-copy")
+                    },
+                    children: [icon("copy")]
                   },
                   {
                     type: "element",
                     tagName: "button",
-                    properties: { class: "download-stl" },
-                    children: [{ type: "text", value: i18n.get("openscad-download-stl") }]
+                    properties: {
+                      class: "download-stl",
+                      title: i18n.get("openscad-download-stl"),
+                      "aria-label": i18n.get("openscad-download-stl")
+                    },
+                    children: [icon("download")]
                   },
                   {
                     type: "element",
                     tagName: "button",
-                    properties: { class: "reset" },
-                    children: [{ type: "text", value: i18n.get("openscad-reset") }]
+                    properties: {
+                      class: "reset",
+                      title: i18n.get("openscad-reset"),
+                      "aria-label": i18n.get("openscad-reset")
+                    },
+                    children: [icon("reset")]
                   },
                   {
                     type: "element",
@@ -201844,7 +202084,7 @@ var remarkDirectiveOpenscad_default = (ctx) => () => {
                       title: i18n.get("ide-fullscreen-enter"),
                       "aria-label": i18n.get("ide-fullscreen-enter")
                     },
-                    children: [{ type: "text", value: "\u26F6" }]
+                    children: [icon("fullscreen")]
                   }
                 ]
               }
@@ -202298,7 +202538,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.99.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"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.100.0","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","test":"vitest","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":{"@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","create-hyperbook":"workspace:*","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","vitest":"^4.0.18","ws":"^8.18.0"}}');
 
 /***/ })