@dogsbay/ssg 0.2.0-beta.132 → 0.2.0-beta.134

package/dist/package/THIRD-PARTY-NOTICES.txt

@@ -1,31 +1,31 @@
 Third-party software in @dogsbay/ssg (dist/package/)
 
 ========================================================================
-@dogsbay/elements@0.2.0-beta.132 (MIT)
+@dogsbay/elements@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.132 (MIT)
+@dogsbay/primitives@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.132 (MIT)
+@dogsbay/render-html@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.132 (MIT)
+@dogsbay/search@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.132 (MIT)
+@dogsbay/ui@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.

package/dist/package/browser.mjs

@@ -462,6 +462,12 @@ function sourceNav(v, path, from) {
   if (!/\.(ya?ml|json)$/i.test(p)) throw new ConfigError(`content.sources (${path}): nav must be a .topicmap.yml topic map or a .yml or .json nav file; got ${JSON.stringify(v)}`);
   return p;
 }
+function projectRoots(cfg) {
+  const roots = cfg.sources.map((s) => s.path === "." ? "" : s.path);
+  if (roots.includes("")) return [""];
+  const navDirs = cfg.sources.flatMap((s) => s.nav ? [s.nav.includes("/") ? s.nav.slice(0, s.nav.lastIndexOf("/")) : s.nav] : []);
+  return [.../* @__PURE__ */ new Set([...roots, cfg.themeDir, ...cfg.css, ...navDirs])].filter(Boolean);
+}
 function sourceRoot(s) {
   return s.path === "." ? "" : s.path.replace(/^\.\//, "").replace(/\/+$/, "") + "/";
 }
@@ -548,8 +554,8 @@ function slugFromPath(p) {
   if (s.endsWith("/index")) s = s.slice(0, -"/index".length);
   return s;
 }
-function parseNavYaml(text, labelFor, baseDir = "") {
-  const data = loadYaml(text);
+function parseNavYaml(text, labelFor, baseDir = "", load2 = loadYaml) {
+  const data = load2(text);
   if (!Array.isArray(data)) return [];
   return data.flatMap((e) => yamlEntry(e, labelFor, baseDir, false));
 }
@@ -1066,31 +1072,31 @@ var CLIENT_CANDIDATES = ['""', '"&"', '"\\\\$&")).join("|")})', '"\\\\$&")}"', '
 var SITE_NOTICES = `Third-party software in this site's _dogsbay/ files (dogsbay.js, site.css) and pages
 
 ========================================================================
-@dogsbay/elements@0.2.0-beta.132 (MIT)
+@dogsbay/elements@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.132 (MIT)
+@dogsbay/primitives@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.132 (MIT)
+@dogsbay/render-html@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.132 (MIT)
+@dogsbay/search@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.132 (MIT)
+@dogsbay/ui@0.2.0-beta.134 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
@@ -2164,7 +2170,7 @@ var ThemeTemplates = class {
 };
 
 // src/core/preprocess.ts
-import { render } from "@dogsbay/minja/browser";
+import { render, RenderLimitError } from "@dogsbay/minja/browser";
 import {
   maskMinjaInCode,
   unmaskMinjaInCode,
@@ -2194,11 +2200,59 @@ var MapLoader = class {
     throw new Error(`include not found: ${path}${basePath ? ` (from ${basePath})` : ""}`);
   }
 };
+var TemplateBudget = class {
+  constructor(renderMs, buildMs, now2 = () => Date.now()) {
+    this.renderMs = renderMs;
+    this.buildMs = buildMs;
+    this.now = now2;
+  }
+  spentMs = 0;
+  active = 0;
+  since = 0;
+  /** Renders not run because the budget was spent, by what they were for. */
+  skipped = { pages: 0, titles: 0 };
+  get spent() {
+    return this.spentMs + (this.active ? this.now() - this.since : 0);
+  }
+  /** The time the next render may take; 0 when the budget is spent. */
+  next() {
+    return Math.max(0, Math.min(this.renderMs, this.buildMs - this.spent));
+  }
+  start() {
+    if (this.active++ === 0) this.since = this.now();
+  }
+  end() {
+    if (--this.active === 0) this.spentMs += this.now() - this.since;
+  }
+  reset() {
+    this.spentMs = 0;
+    this.since = this.now();
+    this.skipped = { pages: 0, titles: 0 };
+  }
+  /** The problem to report when renders were skipped since the last reset, else undefined. */
+  problem() {
+    const { pages, titles } = this.skipped;
+    if (!pages && !titles) return void 0;
+    const what = [pages && `${pages} page(s)`, titles && `${titles} title(s)`].filter(Boolean).join(" and ");
+    return `[template] the template time budget (${this.buildMs / 1e3} s) ran out: ${what} shown without their templates rendered`;
+  }
+};
+function templateBudget(untrusted, given) {
+  return new TemplateBudget(given?.renderMs ?? (untrusted ? 2e3 : 1e4), given?.buildMs ?? (untrusted ? 3e4 : 6e5));
+}
 function needsTemplating(text) {
   return text.includes("{{") || text.includes("{%");
 }
-async function preprocess(text, path, attributes, files, undefinedRefs = "preserve") {
+async function preprocess(text, path, attributes, files, undefinedRefs = "preserve", run = {}) {
   if (!needsTemplating(text)) return { text };
+  const budget = run.budget;
+  const timeout = budget ? budget.next() : 1e4;
+  const skip = () => {
+    if (run.kind !== "copy") budget.skipped[run.kind === "title" ? "titles" : "pages"]++;
+    return { text, skipped: true };
+  };
+  if (budget && timeout <= 0) return skip();
+  budget?.start();
   try {
     const out = await render(mask(text), {
       context: withUnderscoreAliases(attributes),
@@ -2207,11 +2261,15 @@ async function preprocess(text, path, attributes, files, undefinedRefs = "preser
       hyphenToUnderscore: true,
       basePath: dirname(path),
       loader: new MapLoader(files),
-      timeout: 1e4
+      timeout,
+      ...run.parseCache !== void 0 ? { parseCache: run.parseCache } : {}
     });
     return { text: stripFenceMinjaMarkers(stripInlineMinjaMarkers(unmask(out))) };
   } catch (err) {
+    if (budget && timeout < budget.renderMs && err instanceof RenderLimitError && budget.next() <= 0) return skip();
     return { text, error: err instanceof Error ? err.message : String(err) };
+  } finally {
+    budget?.end();
   }
 }
 function withUnderscoreAliases(attrs2) {
@@ -2223,6 +2281,84 @@ function withUnderscoreAliases(attrs2) {
   return out;
 }
 
+// src/core/build.ts
+import { ParseCache, DEFAULT_PARSE_CACHE_BYTES } from "@dogsbay/minja/browser";
+
+// src/core/scan-cache.ts
+var ScanCache = class {
+  entries = /* @__PURE__ */ new Map();
+  /** Project path of a file read while resolving titles → the pages whose entries read it. */
+  readers = /* @__PURE__ */ new Map();
+  /** The last nav YAML loaded, by its text: an unchanged nav.yml is not parsed again. */
+  navText;
+  navData;
+  /** Resolved topic maps, with what they were resolved with and the file map's value of every file read. */
+  maps = /* @__PURE__ */ new Map();
+  /** The page's entry when it was made from this content, else a new empty one for it. */
+  entry(path, content) {
+    const had = this.entries.get(path);
+    if (had && had.content === content) return had;
+    if (had) this.dropDeps(path, had);
+    const e = { content };
+    this.entries.set(path, e);
+    return e;
+  }
+  /** Records that a page's title or description read a file, so a change to that file drops them. */
+  read(page, file) {
+    const e = this.entries.get(page);
+    if (!e) return;
+    (e.deps ??= /* @__PURE__ */ new Set()).add(file);
+    let r = this.readers.get(file);
+    if (!r) this.readers.set(file, r = /* @__PURE__ */ new Set());
+    r.add(page);
+  }
+  /** A file changed, was added or was removed: its own entry goes, and the titles that read it. */
+  changed(path) {
+    const own = this.entries.get(path);
+    if (own) {
+      this.dropDeps(path, own);
+      this.entries.delete(path);
+    }
+    const readers = this.readers.get(path);
+    if (!readers) return;
+    this.readers.delete(path);
+    for (const page of readers) {
+      const e = this.entries.get(page);
+      if (!e) continue;
+      this.dropDeps(page, e);
+      delete e.title;
+      delete e.description;
+      delete e.resolvedWith;
+    }
+  }
+  /** `load(text)`, or the value it gave for the same text last time (the caller must not change it). */
+  yaml(text, load2) {
+    if (this.navText !== text) {
+      this.navData = load2(text);
+      this.navText = text;
+    }
+    return this.navData;
+  }
+  /** A topic map resolved with `key` (its variables), if no file it read has changed since. */
+  topicMap(path, key, files) {
+    const m = this.maps.get(path);
+    if (!m || m.key !== key) return void 0;
+    for (const [p, c] of m.reads) if (files.get(p) !== c) return void 0;
+    return m.nav;
+  }
+  /** Keeps a resolved topic map (not one with errors: the build stops on those) and the files it read. */
+  keepTopicMap(path, key, reads, nav) {
+    if (!nav.errors.length) this.maps.set(path, { key, reads, nav });
+  }
+  get size() {
+    return this.entries.size;
+  }
+  dropDeps(page, e) {
+    for (const f of e.deps ?? []) this.readers.get(f)?.delete(page);
+    e.deps = void 0;
+  }
+};
+
 // src/core/build.ts
 import { TemplatePages } from "@dogsbay/format-dogsbay-md/browser";
 import { extractText, SearchIndexBuilder } from "@dogsbay/search/index";
@@ -2896,6 +3032,16 @@ function fmKey(src) {
   return detach(`${m ? m[0] : ""}
 ${firstH1(src) ?? ""}`);
 }
+function detachValue(v) {
+  if (typeof v === "string") return detach(v);
+  if (Array.isArray(v)) return v.map(detachValue);
+  if (v && typeof v === "object" && Object.getPrototypeOf(v) === Object.prototype) {
+    const o = {};
+    for (const [k, x] of Object.entries(v)) o[detach(k)] = detachValue(x);
+    return o;
+  }
+  return v;
+}
 function frontMatterCopy(fm) {
   try {
     const copy = JSON.parse(JSON.stringify(fm));
@@ -2942,7 +3088,7 @@ async function build(input, hooks = {}) {
   phase.init = now() - t0;
   let pages = 0;
   let assets = 0;
-  const state = { redirects: [], navCache: navCache(), written: /* @__PURE__ */ new Set(), stubs: [], pageOut: /* @__PURE__ */ new Map(), sitemaps: /* @__PURE__ */ new Map(), supplied: /* @__PURE__ */ new Set(), usedMath: false, diagrams: diagramStore(input, cfg) };
+  const state = { redirects: [], navCache: navCache(), written: /* @__PURE__ */ new Set(), stubs: [], pageOut: /* @__PURE__ */ new Map(), sitemaps: /* @__PURE__ */ new Map(), supplied: /* @__PURE__ */ new Set(), usedMath: false, diagrams: diagramStore(input, cfg), scan: hooks.keep || hooks.lazy ? new ScanCache() : void 0, parseCache: input.parseCacheBytes === 0 ? false : new ParseCache(input.parseCacheBytes ?? DEFAULT_PARSE_CACHE_BYTES), templateBudget: templateBudget(input.untrusted === true, input.templateMs) };
   for (const r of cfg.redirects) {
     const from = sitePath(r.from, cfg.basePath);
     if (!from) {
@@ -3013,12 +3159,14 @@ async function build(input, hooks = {}) {
     }
   }
   state.stubs = await writeTranslationStubs(cfg, allUnits, units, translations, state, emit);
+  const spent = state.templateBudget.problem();
+  if (spent) report("template", spent);
   return {
     files: out,
     warnings,
     problems,
     config: cfg,
-    stats: { pages, assets, units: units.length, ms: Math.round(now() - t0), msByPhase: roundAll(phase), highlightCache: highlighter.cacheStats() }
+    stats: { pages, assets, units: units.length, ms: Math.round(now() - t0), msByPhase: roundAll(phase), highlightCache: highlighter.cacheStats(), ...state.parseCache ? { parseCache: state.parseCache.stats() } : {} }
   };
 }
 function selectUnits(allUnits, names) {
@@ -3116,9 +3264,14 @@ async function buildUnit(unit, allUnits, cfg, input, highlighter, emit, report,
     const ns = named.length ? namespaceOf(src) : "";
     return ns ? (p) => p === ns || p.startsWith(ns + "/") ? p : `${ns}/${p}` : void 0;
   };
-  const includesFor = (src) => {
+  const includesFor = (src, read2) => {
     const at = scoped(src);
-    return at ? (p) => readInclude(at(p)) : readInclude;
+    if (!read2) return at ? (p) => readInclude(at(p)) : readInclude;
+    return (p) => {
+      const q = at ? at(p) : p;
+      read2(abs(q));
+      return readInclude(q);
+    };
   };
   const namespaceOf = (p) => named.find((m) => p === m.namespace || p.startsWith(m.namespace + "/"))?.namespace ?? "";
   const globalPrefixes = new Set(cfg.taxonomies.map((t2) => t2.path.split("/")[0]).filter(Boolean));
@@ -3156,6 +3309,7 @@ async function buildUnit(unit, allUnits, cfg, input, highlighter, emit, report,
     return c == null ? void 0 : readText(c);
   };
   const includedPaths = /* @__PURE__ */ new Set();
+  const includedProject = /* @__PURE__ */ new Set();
   const readInclude = async (p) => {
     if (mode.keep || mode.lazy) includedPaths.add(p);
     const hit = cache.get(p);
@@ -3168,7 +3322,8 @@ async function buildUnit(unit, allUnits, cfg, input, highlighter, emit, report,
   };
   const resolvers = [openApiResolver(read, input.openApiChars), autodocUnresolved, ...input.resolvers?.(unit) ?? []];
   const hasContent = (p) => !buildOnly(p) && input.files.has(abs(p));
-  const resolveTitle = async (title, src, path, pageFm) => {
+  const templateRun = { parseCache: state.parseCache, budget: state.templateBudget, kind: "page" };
+  const resolveTitle = async (title, src, path, pageFm, read2) => {
     if (!isTemplated(title)) return title;
     if (pageFm && templatesOf(path).isTemplatePage(pageFm)) {
       return (await templatesOf(path).renderField(title, path, pageFm)).trim();
@@ -3178,7 +3333,7 @@ async function buildUnit(unit, allUnits, cfg, input, highlighter, emit, report,
     const preamble = head.split("\n").filter((l) => /^\s*\{%-?\s*(include|set)\b/.test(l)).join("\n");
     const marker = "DBTITLEMARKER";
     const r = await preprocess(`${preamble}
-${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.undefinedRefs);
+${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2), cfg.undefinedRefs, { parseCache: state.parseCache, budget: state.templateBudget, kind: "title" });
     const m = r.text.split(marker);
     return (m.length >= 3 ? m[1] : title).trim();
   };
@@ -3186,13 +3341,23 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
   for (const m of unit.members) {
     const path = m.source.nav;
     if (!path || !TOPIC_MAP.test(path) || topicMaps.has(path)) continue;
+    const variables = withUnderscoreAliases({ ...cfg.attributes, ...m.source.attributes ?? {} });
+    const key = state.scan ? JSON.stringify([sourceRoot(m.source), variables]) : "";
+    const kept = state.scan?.topicMap(path, key, input.files);
+    if (kept) {
+      topicMaps.set(path, kept);
+      continue;
+    }
     const { topicMapError, topicMapNav } = await import("./chunks/topicmap-PY3WDCSI.mjs");
+    const reads = /* @__PURE__ */ new Map();
     const projectText = async (p) => {
       const c = input.files.get(p);
+      reads.set(p, c);
       return c == null ? void 0 : readText(c);
     };
-    const got = await topicMapNav(path, sourceRoot(m.source), projectText, withUnderscoreAliases({ ...cfg.attributes, ...m.source.attributes ?? {} }));
+    const got = await topicMapNav(path, sourceRoot(m.source), projectText, variables);
     if (got.errors.length) throw topicMapError(path, got.errors);
+    state.scan?.keepTopicMap(path, key, reads, got);
     topicMaps.set(path, got);
   }
   const navInputs = /* @__PURE__ */ new Set([...unit.members.flatMap((m) => m.source.nav ? [m.source.nav] : []), ...[...topicMaps.values()].flatMap((t2) => t2.maps)]);
@@ -3213,6 +3378,13 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
     }
     return a;
   };
+  const resolvedKeys = /* @__PURE__ */ new Map();
+  const resolvedKey = (p) => {
+    const key = named.length ? namespaceOf(p) : "";
+    let k = resolvedKeys.get(key);
+    if (k === void 0) resolvedKeys.set(key, k = JSON.stringify([label, key, sourceOf(p).templates ?? null, cfg.name, cfg.undefinedRefs, attributesOf(p)]));
+    return k;
+  };
   const templatesBy = /* @__PURE__ */ new Map();
   const templatesOf = (p) => {
     const key = named.length ? namespaceOf(p) : "";
@@ -3234,18 +3406,31 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
   const sanitizing = (cfg.html ?? input.defaultHtml ?? "keep") === "sanitize";
   const activeFiles = [];
   const untrustedFiles = [];
+  const leftOut = /* @__PURE__ */ new Map();
   for (const [p, c] of files) {
     if (buildOnly(p)) continue;
     if (/\.(md|markdown)$/i.test(p)) {
-      if (excluded(p)) continue;
+      if (excluded(p)) {
+        leftOut.set(slugFromPath(p), cfg.excludeFromRoutes.find((d) => p === d || p.startsWith(d.replace(/\/+$/, "") + "/")) ?? "_ or . files");
+        continue;
+      }
       const slug = slugFromPath(p);
-      const src = await readText(c);
+      const memo2 = state.scan?.entry(abs(p), c);
+      let text;
+      const source = async () => text ??= await readText(c);
       let fm = {};
-      try {
-        fm = splitFrontmatter2(src).data ?? {};
-      } catch {
+      if (memo2?.fm) fm = memo2.fm;
+      else {
+        try {
+          fm = splitFrontmatter2(await source()).data ?? {};
+        } catch {
+        }
+        if (memo2) memo2.fm = detachValue(fm);
+      }
+      if (fm.status === "draft" && !input.includeDrafts) {
+        leftOut.set(slug, "draft");
+        continue;
       }
-      if (fm.status === "draft" && !input.includeDrafts) continue;
       if (templatesOf(p).isPartial(fm, p)) continue;
       const inUnit = (s) => unit.prefix && (s === unit.prefix || s.startsWith(unit.prefix + "/")) ? s : [unit.prefix, s].filter(Boolean).join("/");
       const pageNs = named.length ? namespaceOf(p) : "";
@@ -3279,20 +3464,35 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
         warn("duplicate-page", `two sources map to the page "${slug || "/"}"; keeping ${srcOf(infos.get(slug))}, ignoring ${abs(p)}`, { file: abs(p) });
         continue;
       }
+      const resolvedWith = memo2 ? resolvedKey(p) : void 0;
+      let title;
+      let description;
+      if (memo2 && memo2.title !== void 0 && memo2.resolvedWith === resolvedWith) {
+        title = memo2.title;
+        description = memo2.description;
+        for (const f of memo2.deps ?? []) includedProject.add(f);
+      } else {
+        const keep = memo2 && !templatesOf(p).isTemplatePage(fm);
+        const reads = keep ? (f) => state.scan.read(abs(p), f) : void 0;
+        const skippedBefore = state.templateBudget.skipped.titles;
+        title = detach(await resolveTitle(str(fm.title) ?? firstH1(await source()) ?? humanize2(slug.split("/").pop() || cfg.name), await source(), p, fm, reads));
+        description = fm.description != null ? detach(await resolveTitle(String(fm.description), await source(), p, fm, reads)) : void 0;
+        if (keep && state.templateBudget.skipped.titles === skippedBefore) Object.assign(memo2, { title, description, resolvedWith });
+      }
       infos.set(slug, {
         slug,
         source: p,
         out: outFileFor(slug, isIndexFile),
-        title: detach(await resolveTitle(str(fm.title) ?? firstH1(src) ?? humanize2(slug.split("/").pop() || cfg.name), src, p, fm)),
+        title,
         order: typeof fm.order === "number" ? fm.order : typeof fm.weight === "number" ? fm.weight : void 0,
         draft: fm.draft === true || fm.status === "draft",
-        description: fm.description != null ? detach(await resolveTitle(String(fm.description), src, p, fm)) : void 0,
+        description,
         data: frontMatterCopy(fm)
       });
-      if (diagrams) for (const code of fencedDiagrams(src)) diagrams.note(detach(code), p);
+      if (diagrams) for (const code of memo2 ? memo2.diagrams ??= fencedDiagrams(await source()).map(detach) : fencedDiagrams(await source())) diagrams.note(detach(code), p);
       taxonomies?.add(slug, fm);
       blog?.add(slug, infos.get(slug).title, fm);
-      if (mode.keep || mode.lazy) frontMatter.set(p, fmKey(src));
+      if (mode.keep || mode.lazy) frontMatter.set(p, memo2 ? memo2.fmKey ??= fmKey(await source()) : fmKey(await source()));
     } else if (!SKIP_FILES.has(memberRel(p)) && copiedPath(p)) {
       const verdict = await assetVerdict(p, c, input.untrusted === true, sanitizing);
       if (verdict === "untrusted") untrustedFiles.push(p);
@@ -3353,6 +3553,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
     if (strays.length) warn("openapi", `${strays.length} page(s) are in the folder of the OpenAPI source "${ns}", and are left out of the nav: ${strays.slice(0, 5).map(srcOf).join(", ")}${strays.length > 5 ? ", \u2026" : ""}`);
   }
   const labelFor = (slug) => infos.get(slug)?.title;
+  const navLoad = state.scan ? (text) => state.scan.yaml(text, loadYaml) : void 0;
   const memberNav = async (ns) => {
     const dir2 = ns ? ns + "/" : "";
     const member = unit.members.find((m) => m.namespace === ns);
@@ -3364,7 +3565,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
     if (!file) return { nav: fromPages() };
     try {
       const text = await read(file);
-      return { nav: file.endsWith(".json") ? prefixNav(parseNavJson(text, (slug) => labelFor(ns ? prefixSlug([ns], slug) : slug)), ns) : parseNavYaml(text, labelFor, ns), file, project: abs(file) };
+      return { nav: file.endsWith(".json") ? prefixNav(parseNavJson(text, (slug) => labelFor(ns ? prefixSlug([ns], slug) : slug)), ns) : parseNavYaml(text, labelFor, ns, navLoad), file, project: abs(file) };
     } catch (e) {
       const mark = e.mark;
       warn("nav", `could not read ${file}: ${e.message}; using the directory layout`, {
@@ -3382,7 +3583,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
     const c = input.files.get(path);
     const text = c == null ? void 0 : await readText(c);
     if (text === void 0) throw new ConfigError(`content.sources (${src.path}): its nav file ${path} does not exist`);
-    return { nav: path.endsWith(".json") ? prefixNav(parseNavJson(text, nsLabel), ns) : parseNavYaml(text, labelFor, ns), file: path, project: path, files: [path] };
+    return { nav: path.endsWith(".json") ? prefixNav(parseNavJson(text, nsLabel), ns) : parseNavYaml(text, labelFor, ns, navLoad), file: path, project: path, files: [path] };
   };
   let nav = [];
   const navFiles = [];
@@ -3416,12 +3617,27 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
   const childLinkNav = (nodes) => nodes.map((n) => ({ label: n.label, href: n.slug != null ? `/${n.slug}` : n.href, children: childLinkNav(n.children) }));
   let childLinkItems;
   let childLinkDirs;
-  for (const s of order) if (!infos.has(s) && !stubTargets.has(s)) warn("nav", `nav entry "${s}" has no page`, navFileAt());
+  const isLeftOut = (s) => !infos.has(s) && !stubTargets.has(s) && leftOut.has(s);
+  for (const s of order) if (!infos.has(s) && !stubTargets.has(s) && !leftOut.has(s)) warn("nav", `nav entry "${s}" has no page`, navFileAt());
   if (cfg.routablesFrom === "nav") {
     const keep = new Set(order);
     for (const s of [...infos.keys()]) if (s !== "" && !keep.has(s)) infos.delete(s);
   }
+  const excludedEntries = /* @__PURE__ */ new Map();
   const dropMissing = (nodes) => {
+    const kept = nodes.filter((n) => {
+      const had = n.children.length;
+      dropMissing(n.children);
+      if (n.slug != null && isLeftOut(n.slug)) {
+        const why = leftOut.get(n.slug);
+        if (why !== "draft") excludedEntries.set(why, (excludedEntries.get(why) ?? 0) + 1);
+        delete n.slug;
+        delete n.fragment;
+        return n.children.length > 0;
+      }
+      return !(had > 0 && n.children.length === 0 && n.slug == null && n.href == null);
+    });
+    nodes.splice(0, nodes.length, ...kept);
     for (const n of nodes) {
       if (n.slug != null && !infos.has(n.slug)) {
         const stub = stubTargets.get(n.slug);
@@ -3442,10 +3658,14 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
           } else warn("nav", `nav entry "${from}" redirects to /${stub.to}, which is not a page of this build; it keeps its label without a link`);
         }
       }
-      dropMissing(n.children);
     }
   };
   dropMissing(nav);
+  if (excludedEntries.size) {
+    const n = [...excludedEntries.values()].reduce((a, b) => a + b, 0);
+    const why = [...excludedEntries.keys()].slice(0, 5).join(", ");
+    warn("nav", n === 1 ? `1 nav entry left out: its page is excluded from routes (${why})` : `${n} nav entries left out: their pages are excluded from routes (${why})`, navFileAt());
+  }
   const blogIndex = cfg.blog?.path;
   const replaced = blogIndex === "" ? "" : void 0;
   if (blogIndex && infos.has(blogIndex)) warn("duplicate-page", `the page ${infos.get(blogIndex).source} and the blog index both serve /${blogIndex} on hosts that drop .html; rename one`);
@@ -3469,7 +3689,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
   const t_ = strings(unit.locale ?? cfg.defaultLocale, void 0);
   const lang = unit.locale ?? cfg.defaultLocale ?? "en";
   const dir = /^(ar|he|fa|ur)(-|$)/.test(unit.locale ?? "") ? "rtl" : "ltr";
-  const search = cfg.search && cfg.searchEngine !== "pagefind" ? new SearchIndexBuilder({ lang: unit.locale ?? cfg.defaultLocale ?? "en" }) : void 0;
+  let search = cfg.search && cfg.searchEngine !== "pagefind" ? new SearchIndexBuilder({ lang: unit.locale ?? cfg.defaultLocale ?? "en" }) : void 0;
   const siteDepthPrefix = unit.prefix ? "../".repeat(unit.prefix.split("/").length) : "";
   phase.scan = (phase.scan ?? 0) + now() - t;
   input.onUnitAssets?.(unit.prefix, assetPaths);
@@ -3510,7 +3730,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
       warn2("front-matter", `front matter does not parse${line ? ` (line ${line})` : ""}: ${reason}`, line);
       if (mode.diagnostics) diagnostics = [{ code: "front-matter", message: detach(`front matter does not parse: ${reason}`), ...line ? { line } : {} }];
     }
-    const pre = templatesOf(info.source).isTemplatePage(fm) ? { text: await templatesOf(info.source).render(bodySrc, info.source, fm, { firstLine: raw.slice(0, raw.length - bodySrc.length).split("\n").length }) } : await preprocess(bodySrc, info.source, attributesOf(info.source), includesFor(info.source), cfg.undefinedRefs);
+    const pre = templatesOf(info.source).isTemplatePage(fm) ? { text: await templatesOf(info.source).render(bodySrc, info.source, fm, { firstLine: raw.slice(0, raw.length - bodySrc.length).split("\n").length }) } : await preprocess(bodySrc, info.source, attributesOf(info.source), includesFor(info.source), cfg.undefinedRefs, templateRun);
     if (pre.error) {
       warn2("template", `template error: ${pre.error}`);
       if (mode.diagnostics) (diagnostics ??= []).push({ code: "template", message: detach(`template error: ${pre.error}`) });
@@ -3830,7 +4050,11 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
   const unitHref = (slug) => pageRefs.get(slug)?.out;
   await emit(prefix + "_dogsbay/nav.js", `window.__DOGSBAY_NAV__=${JSON.stringify(compactNav(nav, unitHref)).replace(/<\//g, "<\\/")};
 `);
-  if (search) for (const [f, c] of search.emitFiles()) await emit(`${prefix}_dogsbay/search/${f}`, c);
+  if (search) {
+    const written = search;
+    search = void 0;
+    for (const [f, c] of written.emitFiles()) await emit(`${prefix}_dogsbay/search/${f}`, c);
+  }
   if (!infos.has("") && blogIndex !== "") {
     const first = readingOrder[0] ?? [...infos.keys()][0];
     if (first != null) await emit(prefix + "index.html", redirectPage(pageRefs.get(first).out, cfg.name));
@@ -3857,7 +4081,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
           body = sp.content;
         } catch {
         }
-        const text = templatesOf(info.source).isTemplatePage(pageFm) ? await templatesOf(info.source).render(body, info.source, pageFm) : (await preprocess(body, info.source, attributesOf(info.source), includesFor(info.source), cfg.undefinedRefs)).text;
+        const text = templatesOf(info.source).isTemplatePage(pageFm) ? await templatesOf(info.source).render(body, info.source, pageFm) : (await preprocess(body, info.source, attributesOf(info.source), includesFor(info.source), cfg.undefinedRefs, { ...templateRun, kind: "copy" })).text;
         const ns = named.length ? namespaceOf(info.source) : "";
         if (!ns && !PLACEHOLDER_DIRECTIVE.test(text)) return text;
         const tree = dogsbayMdToTree(text).tree;
@@ -3920,7 +4144,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path), cfg.un
     },
     included(path) {
       const r = rel(path);
-      return r !== void 0 && includedPaths.has(r);
+      return r !== void 0 && includedPaths.has(r) || includedProject.has(path);
     }
   };
   async function emitGenerated() {
@@ -4450,6 +4674,7 @@ async function openDevSession(input, o = {}) {
   const rendering = /* @__PURE__ */ new Map();
   let ctx;
   let config;
+  let parsedConfig;
   let taken = 0;
   let takenProblems = 0;
   let buildError;
@@ -4493,6 +4718,7 @@ async function openDevSession(input, o = {}) {
     } catch (e) {
       throw e instanceof ConfigError ? inConfig(e, name) : e;
     }
+    parsedConfig = parsed;
     out = next;
     units = nextUnits;
     ctx = nextCtx;
@@ -4534,8 +4760,23 @@ async function openDevSession(input, o = {}) {
     const css = await (await siteCssBuilder(input))({ theme: config.theme, themeCss: ctx.theme.themeCss, extra: ctx.theme.extraCss, candidates: u.classes });
     out.set(`${u.unit.prefix ? u.unit.prefix + "/" : ""}_dogsbay/site.css`, css);
   };
+  let requests = Promise.resolve();
+  const budgeted = (work) => {
+    const run = requests.then(async () => {
+      const budget = ctx?.state.templateBudget;
+      budget?.reset();
+      try {
+        return await work();
+      } finally {
+        const spent = ctx?.state.templateBudget === budget ? budget?.problem() : void 0;
+        if (spent) ctx.report("template", spent);
+      }
+    });
+    requests = run.catch(() => void 0);
+    return run;
+  };
   const renderStale = async (path, u) => {
-    await u.handle.render(path);
+    await budgeted(() => u.handle.render(path));
     stale.delete(path);
     const html = out.get(path);
     if (typeof html === "string") {
@@ -4611,48 +4852,80 @@ async function openDevSession(input, o = {}) {
     },
     get,
     async change(paths) {
+      const t0 = Date.now();
+      const done = (r) => ({ ...r, ms: Date.now() - t0 });
       try {
         if (buildError !== void 0) {
           await full();
           buildError = void 0;
           buildProblem = void 0;
-          return { css: true };
+          return done({ css: true, handled: "full" });
         }
-        return await changeParts(paths);
+        return done(await budgeted(() => changeParts(paths)));
       } catch (e) {
         failed(e);
-        return { css: false };
+        return done({ css: false, handled: "full" });
       }
     }
   };
   async function changeParts(paths) {
     const themeDir = config.themeDir ? config.themeDir.replace(/\/+$/, "") + "/" : void 0;
     const extraCss = new Set(config.css.map((c) => c.replace(/^\.\//, "")));
-    const navInputs = new Set([...units.values()].flatMap((u) => u.handle.navInputs));
-    const ownNav = (p) => TOPIC_MAP.test(p) || navInputs.has(p) || config.sources.some((s) => s.nav === p);
-    if (paths.some((p) => CONFIG_FILES.has(p) || themeDir && p.startsWith(themeDir) || extraCss.has(p) || ownNav(p))) {
+    const lazy = /* @__PURE__ */ new Set();
+    if (paths.some((p) => CONFIG_FILES.has(p))) {
+      const next = await attributesOnly();
+      if (!next) {
+        await full();
+        return { css: true, handled: "full" };
+      }
+      ctx.cfg = { ...ctx.cfg, attributes: next.attributes };
+      config = { ...config, attributes: next.attributes };
+      const same = JSON.stringify(next.attributes) === JSON.stringify(parsedConfig?.attributes);
+      parsedConfig = next;
+      if (!same) for (const prefix of units.keys()) lazy.add(prefix);
+    }
+    if (paths.some((p) => themeDir && p.startsWith(themeDir) || extraCss.has(p))) {
       await full();
-      return { css: true };
+      return { css: true, handled: "full" };
     }
-    const lazy = /* @__PURE__ */ new Set();
+    for (const p of paths) ctx.state.scan?.changed(p);
+    let handled = lazy.size ? "unit" : "none";
+    const mark = (h) => {
+      const rank = ["none", "asset", "page", "unit", "full"];
+      if (rank.indexOf(h) > rank.indexOf(handled)) handled = h;
+    };
     for (const p of paths) {
+      if (CONFIG_FILES.has(p)) continue;
+      const readers = [...units.values()].filter((u2) => u2.handle.navInputs.includes(p) || u2.unit.members.some((m) => m.source.nav === p));
+      if (readers.length) {
+        for (const u2 of [...readers, unitOf(p)]) if (u2) lazy.add(u2.unit.prefix);
+        mark("unit");
+        continue;
+      }
+      if (TOPIC_MAP.test(p)) continue;
       const u = unitOf(p);
       if (!u) continue;
       const content = input.files.get(p);
       if (/\.(md|markdown)$/i.test(p)) {
         const page = u.handle.pageForSource(p);
         const text = content === void 0 ? void 0 : await textOf(content);
-        if (page && text !== void 0 && u.handle.sameFrontMatter(p, text) && !u.handle.included(p)) stale.add(page);
-        else {
+        if (page && text !== void 0 && u.handle.sameFrontMatter(p, text) && !u.handle.included(p)) {
+          stale.add(page);
+          mark("page");
+        } else {
           u.handle.forget(p);
           lazy.add(u.unit.prefix);
+          mark("unit");
         }
       } else if (NAV_FILES2.test(p)) {
         lazy.add(u.unit.prefix);
+        mark("unit");
       } else if (content === void 0 || /\.(md|markdown|ya?ml|json|txt|html?|csv)$/i.test(p)) {
         u.handle.forget(p);
         lazy.add(u.unit.prefix);
+        mark("unit");
       } else {
+        mark("asset");
         const at = memberPath(u.unit, p)?.path ?? p.slice(sourceRoot(u.unit.source).length);
         const key = u.unit.prefix ? `${u.unit.prefix}/${at}` : at;
         const sanitizing = (config.html ?? input.defaultHtml ?? "keep") === "sanitize";
@@ -4698,7 +4971,20 @@ async function openDevSession(input, o = {}) {
         (p) => stale.has(p)
       );
     }
-    return { css: false };
+    return { css: false, handled };
+  }
+  async function attributesOnly() {
+    const file = input.files.get("dogsbay.config.yml") ?? input.files.get("dogsbay.config.yaml");
+    const text = file !== void 0 ? await textOf(file) : void 0;
+    if (text === void 0 || !parsedConfig) return void 0;
+    let next;
+    try {
+      next = parseConfig(text);
+    } catch {
+      return void 0;
+    }
+    const rest = (c) => JSON.stringify({ ...c, attributes: void 0 });
+    return rest(next) === rest(parsedConfig) ? next : void 0;
   }
   async function emitInto(path, content) {
     if (START_ONLY.test(path)) return;
@@ -4818,5 +5104,6 @@ export {
   parseNavJson,
   parseNavYaml,
   peleRenderer,
-  prebuiltSiteCss
+  prebuiltSiteCss,
+  projectRoots
 };

package/dist/package/types/core/build.d.ts

@@ -20,6 +20,9 @@ import { type NavCache } from "../theme/regions.js";
 import { ThemeTemplates } from "../theme/page.js";
 import type { CssOptions } from "../theme/css-build.js";
 import { type FileRef, type TextRef, type TextStream } from "./detach.js";
+import { type TemplateBudget } from "./preprocess.js";
+import { ParseCache } from "@dogsbay/minja/browser";
+import { ScanCache } from "./scan-cache.js";
 import { type RedirectInput, type RedirectRule } from "./site-files.js";
 import { DiagramStore, type DiagramRenderer, type DiagramRenderers } from "./diagrams.js";
 export type FileContent = string | Uint8Array | FileRef | TextRef;
@@ -90,6 +93,19 @@ export interface BuildInput {
      * 8–16 MB). The CLI passes 64M (up to about 128 MB), the Worker 4M.
      */
     highlightCacheChars?: number;
+    /**
+     * Estimated bytes of included templates' parses kept for reuse (minja's `ParseCache`; default
+     * 8 MB, which holds every reuse on OpenShift). 0 parses every include again.
+     */
+    parseCacheBytes?: number;
+    /**
+     * Template time: per render, and for the whole build (a dev session: for opening it, and for
+     * each change or page request). Defaults: 10 s and 10 minutes; an untrusted build 2 s and 30 s.
+     */
+    templateMs?: {
+        renderMs?: number;
+        buildMs?: number;
+    };
     /** Characters of rendered SVG kept for reuse across units (default 8M; a Worker passes less). */
     diagramCacheChars?: number;
     /**
@@ -189,6 +205,12 @@ export interface SiteState {
     written: Set<string>;
     /** The stubs for missing translations last written, so a dev session can replace them. */
     stubs: string[];
+    /** A dev session's: what pass 1 read from each page, kept between its rebuilds (src/core/scan-cache.ts). */
+    scan?: ScanCache;
+    /** Included templates' parses (false: none kept), kept as long as the state: a dev session's unit rebuilds keep it. */
+    parseCache: ParseCache | false;
+    /** Template time left for the build, or for a dev session's current request. */
+    templateBudget: TemplateBudget;
 }
 export interface BuildStats {
     pages: number;
@@ -203,6 +225,14 @@ export interface BuildStats {
         entries: number;
         chars: number;
     };
+    /** The parse cache for includes at the end of the build (minja's `ParseCache.stats()`). */
+    parseCache?: {
+        hits: number;
+        misses: number;
+        entries: number;
+        bytes: number;
+        maxBytes: number;
+    };
 }
 export interface BuildResult {
     files: Map<string, OutputContent>;

package/dist/package/types/core/dev.d.ts

@@ -8,10 +8,14 @@
  *  - otherwise a page added, removed or changed, a nav file, or a file of the
  *    unit that is not a page (an include): the unit is built again without
  *    its pages (`rebuildUnitLazy`), its old output is dropped, and all its
- *    pages are stale;
+ *    pages are stale. What pass 1 read from each unchanged page is kept
+ *    between rebuilds (src/core/scan-cache.ts), so this is cheap;
+ *  - a topic map, a map it includes or a source's `nav:` file: the units
+ *    that read it are built again, as above;
  *  - an asset: its entry is replaced;
- *  - the config, theme or extra stylesheets: everything is built again, and
- *    swapped in only if that build succeeds.
+ *  - a config change to `attributes` only: every unit is built again, as above;
+ *  - any other config change, the theme or extra stylesheets: everything is
+ *    built again, and swapped in only if that build succeeds.
  *
  * A stale page is rendered when it is asked for, with the current nav and
  * page table, so nothing shown is out of date and no dependency map is
@@ -32,9 +36,7 @@ export interface DevSession {
      * already updated. It does not throw: a change that fails sets `buildError` (and `buildProblem`)
      * and resolves `{ css: false }`, and the last good site stays served.
      */
-    change(paths: string[]): Promise<{
-        css: boolean;
-    }>;
+    change(paths: string[]): Promise<ChangeResult>;
     /** Warnings not handed out yet (the start's, then those of each change and page render). */
     takeWarnings(): string[];
     /**
@@ -62,6 +64,16 @@ export interface DevSession {
     /** `buildError` as data: a config that does not parse names the config file, with its line and column. */
     readonly buildProblem: BuildProblem | undefined;
 }
+/** What `change` did: `css` when the stylesheet may have changed, how it handled the change, and how long it took. */
+export interface ChangeResult {
+    css: boolean;
+    /**
+     * The most it rebuilt: `full` (everything, as at the start), `unit` (one or more units without
+     * their pages), `page` (pages marked stale), `asset` (files replaced), `none` (nothing it builds).
+     */
+    handled: "full" | "unit" | "page" | "asset" | "none";
+    ms: number;
+}
 /**
  * By default every page is rendered at the start, as `build` does: search has its index and
  * every warning is reported up front. `lazy`: only pass 1 runs at the start and each page is

package/dist/package/types/core/nav.d.ts

@@ -15,7 +15,8 @@ export interface NavNode {
 /** "topics/x.md" → "topics/x"; "index.md" → ""; "a/index.md" → "a". */
 export declare function slugFromPath(p: string): string;
 type LabelFor = (slug: string) => string | undefined;
-export declare function parseNavYaml(text: string, labelFor: LabelFor, baseDir?: string): NavNode[];
+/** `load`: the YAML loader, which a dev session's scan cache wraps (it reads the result, never changes it). */
+export declare function parseNavYaml(text: string, labelFor: LabelFor, baseDir?: string, load?: (text: string) => unknown): NavNode[];
 export declare function parseNavJson(text: string, labelFor: LabelFor): NavNode[];
 /** Derive a nav tree from page slugs: one section per directory, index pages as landing pages. */
 export declare function navFromPages(pages: {

package/dist/package/types/core/preprocess.d.ts

@@ -1,6 +1,59 @@
+/**
+ * Minja templating pass: `{{ var }}`, `{% if %}`, `{% include %}`.
+ * Runs on the raw page text before the markdown parser, the same way
+ * the Dogsbay CLI's site build does, but over an in-memory file map.
+ *
+ * Template syntax inside code (fences and inline spans) is masked so
+ * examples such as Helm's `{{ .Values }}` are never evaluated. `{#`
+ * (heading anchors like `{#intro}`) is masked globally because minja
+ * reads it as a comment opener.
+ */
+import { type ParseCache } from "@dogsbay/minja/browser";
 export interface PreprocessResult {
     text: string;
     error?: string;
+    /** Not rendered: the build's template time budget was spent (counted in `TemplateBudget.skipped`). */
+    skipped?: boolean;
+}
+/**
+ * Template time for a whole build (plans/worker-scale.md stage 3): each render gets the shorter of
+ * its own limit and what is left, and once it is spent the rest are not rendered (counted, for one
+ * problem). Time is counted while at least one render is running, so renders the build prepares
+ * ahead in parallel are not counted twice. A dev session resets it for each request.
+ */
+export declare class TemplateBudget {
+    readonly renderMs: number;
+    readonly buildMs: number;
+    private readonly now;
+    private spentMs;
+    private active;
+    private since;
+    /** Renders not run because the budget was spent, by what they were for. */
+    skipped: {
+        pages: number;
+        titles: number;
+    };
+    constructor(renderMs: number, buildMs: number, now?: () => number);
+    get spent(): number;
+    /** The time the next render may take; 0 when the budget is spent. */
+    next(): number;
+    start(): void;
+    end(): void;
+    reset(): void;
+    /** The problem to report when renders were skipped since the last reset, else undefined. */
+    problem(): string | undefined;
+}
+/** Per render: render limits for a build (untrusted: 2 s; else 10 s), and for the whole build (untrusted: 30 s; else 10 minutes). */
+export declare function templateBudget(untrusted: boolean, given?: {
+    renderMs?: number;
+    buildMs?: number;
+}): TemplateBudget;
+/** What a build's renders share: the parse cache for includes, the time budget, and what the render is for. */
+export interface TemplateRun {
+    parseCache?: ParseCache | false;
+    budget?: TemplateBudget;
+    /** What the render is for: a page's body, a title, or a copy of a body already counted (llms-full.txt), not counted again. */
+    kind?: "page" | "title" | "copy";
 }
 /** True when a page contains template syntax worth running minja over. */
 export declare function needsTemplating(text: string): boolean;
@@ -9,6 +62,6 @@ export declare function needsTemplating(text: string): boolean;
  * to the content root; `files` looks up other files by the same kind
  * of path. A template error leaves the page unchanged and is reported.
  */
-export declare function preprocess(text: string, path: string, attributes: Record<string, unknown>, files: (path: string) => string | undefined | Promise<string | undefined>, undefinedRefs?: "preserve" | "asciidoc-literal"): Promise<PreprocessResult>;
+export declare function preprocess(text: string, path: string, attributes: Record<string, unknown>, files: (path: string) => string | undefined | Promise<string | undefined>, undefinedRefs?: "preserve" | "asciidoc-literal", run?: TemplateRun): Promise<PreprocessResult>;
 /** `product-title` is also reachable as `product_title`, because minja normalises hyphens on lookup. */
 export declare function withUnderscoreAliases(attrs: Record<string, unknown>): Record<string, unknown>;

package/dist/package/types/core/scan-cache.d.ts

@@ -0,0 +1,51 @@
+/**
+ * What pass 1 of a unit's build reads from each page, kept between a dev session's rebuilds
+ * (plans/worker-scale.md, stage 4). Rebuilding a unit after a menu, title, include or new-page
+ * edit re-reads every page; on a large site most of that is resolving templated titles, which
+ * renders each page's preamble and its includes. A page's entry is used again while its file is
+ * the same content (the dev server and the playground replace a changed file's value in the file
+ * map), its title was resolved with the same attributes, and no file its title read has changed.
+ *
+ * Only a dev session builds with one (`BuildHooks.keep` or `lazy`): a build reads each page once.
+ */
+import type { FileContent } from "./build.js";
+import type { TopicMapNav } from "./topicmap.js";
+export interface ScanEntry {
+    /** The file map's value the entry was made from: a different value is a different file. */
+    content: FileContent;
+    fm?: Record<string, unknown>;
+    /** The first H1 and the front matter block (`fmKey`), for telling a body edit from a page-table change. */
+    fmKey?: string;
+    /** Mermaid sources the page fences. */
+    diagrams?: string[];
+    /** The resolved title and description, and what they were resolved with. */
+    title?: string;
+    description?: string;
+    resolvedWith?: string;
+    /** Project paths the title and description read (includes found or looked for). */
+    deps?: Set<string>;
+}
+export declare class ScanCache {
+    private entries;
+    /** Project path of a file read while resolving titles → the pages whose entries read it. */
+    private readers;
+    /** The last nav YAML loaded, by its text: an unchanged nav.yml is not parsed again. */
+    private navText?;
+    private navData?;
+    /** Resolved topic maps, with what they were resolved with and the file map's value of every file read. */
+    private maps;
+    /** The page's entry when it was made from this content, else a new empty one for it. */
+    entry(path: string, content: FileContent): ScanEntry;
+    /** Records that a page's title or description read a file, so a change to that file drops them. */
+    read(page: string, file: string): void;
+    /** A file changed, was added or was removed: its own entry goes, and the titles that read it. */
+    changed(path: string): void;
+    /** `load(text)`, or the value it gave for the same text last time (the caller must not change it). */
+    yaml(text: string, load: (text: string) => unknown): unknown;
+    /** A topic map resolved with `key` (its variables), if no file it read has changed since. */
+    topicMap(path: string, key: string, files: Map<string, FileContent>): TopicMapNav | undefined;
+    /** Keeps a resolved topic map (not one with errors: the build stops on those) and the files it read. */
+    keepTopicMap(path: string, key: string, reads: Map<string, FileContent | undefined>, nav: TopicMapNav): void;
+    get size(): number;
+    private dropDeps;
+}

package/dist/package/types/package/browser.d.ts

@@ -20,8 +20,8 @@ export declare function openDevSession(input: BuildInput & {
 }, o?: DevOptions): Promise<DevSession>;
 export { prebuiltSiteCss };
 export type { BuildInput, BuildResult, FileContent, OutputContent, SinkContent, SiteCssBuilder, BuiltPage, HighlightPool, BuildProblem, PageDiagnostic } from "../core/build.js";
-export type { DevOptions, DevSession } from "../core/dev.js";
-export { parseConfig, ConfigError, type SiteConfig, type DiagramEngine } from "../core/config.js";
+export type { ChangeResult, DevOptions, DevSession } from "../core/dev.js";
+export { parseConfig, projectRoots, ConfigError, type SiteConfig, type DiagramEngine } from "../core/config.js";
 export type { DiagramRenderer, DiagramRenderers, DiagramRequest, DiagramResult } from "../core/diagrams.js";
 export { peleRenderer } from "../core/pele.js";
 export { parseNavYaml, parseNavJson, navFromPages, indexNav, type NavNode, type NavIndex } from "../core/nav.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/ssg",
-  "version": "0.2.0-beta.132",
+  "version": "0.2.0-beta.134",
   "type": "module",
   "description": "Documentation static site generator for Dogsbay-MD that builds inside Cloudflare Workers and publishes sites that work offline",
   "license": "Apache-2.0",
@@ -47,38 +47,38 @@
     "tailwindcss": "^4.3.2"
   },
   "peerDependencies": {
-    "@dogsbay/elements": "0.2.0-beta.132",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.132",
-    "@dogsbay/format-openapi": "0.2.0-beta.132",
-    "@dogsbay/format-topicmap": "0.2.0-beta.132",
-    "@dogsbay/highlight": "0.2.0-beta.132",
-    "@dogsbay/minja": "0.2.0-beta.132",
-    "@dogsbay/primitives": "0.2.0-beta.132",
-    "@dogsbay/render-html": "0.2.0-beta.132",
-    "@dogsbay/search": "0.2.0-beta.132",
-    "@dogsbay/serialize-core": "0.2.0-beta.132",
-    "@dogsbay/site-check": "0.2.0-beta.132",
-    "@dogsbay/site-files": "0.2.0-beta.132",
-    "@dogsbay/types": "0.2.0-beta.132"
+    "@dogsbay/elements": "0.2.0-beta.134",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.134",
+    "@dogsbay/format-openapi": "0.2.0-beta.134",
+    "@dogsbay/format-topicmap": "0.2.0-beta.134",
+    "@dogsbay/highlight": "0.2.0-beta.134",
+    "@dogsbay/minja": "0.2.0-beta.134",
+    "@dogsbay/primitives": "0.2.0-beta.134",
+    "@dogsbay/render-html": "0.2.0-beta.134",
+    "@dogsbay/search": "0.2.0-beta.134",
+    "@dogsbay/serialize-core": "0.2.0-beta.134",
+    "@dogsbay/site-check": "0.2.0-beta.134",
+    "@dogsbay/site-files": "0.2.0-beta.134",
+    "@dogsbay/types": "0.2.0-beta.134"
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.12.1",
     "@cloudflare/workers-types": "^5.20260921.1",
-    "@dogsbay/elements": "0.2.0-beta.132",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.132",
-    "@dogsbay/format-openapi": "0.2.0-beta.132",
-    "@dogsbay/format-topicmap": "0.2.0-beta.132",
-    "@dogsbay/highlight": "0.2.0-beta.132",
-    "@dogsbay/icons": "0.2.0-beta.132",
-    "@dogsbay/minja": "0.2.0-beta.132",
-    "@dogsbay/primitives": "0.2.0-beta.132",
-    "@dogsbay/render-html": "0.2.0-beta.132",
-    "@dogsbay/search": "0.2.0-beta.132",
-    "@dogsbay/serialize-core": "0.2.0-beta.132",
-    "@dogsbay/site-check": "0.2.0-beta.132",
-    "@dogsbay/site-files": "0.2.0-beta.132",
-    "@dogsbay/types": "0.2.0-beta.132",
-    "@dogsbay/ui": "0.2.0-beta.132",
+    "@dogsbay/elements": "0.2.0-beta.134",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.134",
+    "@dogsbay/format-openapi": "0.2.0-beta.134",
+    "@dogsbay/format-topicmap": "0.2.0-beta.134",
+    "@dogsbay/highlight": "0.2.0-beta.134",
+    "@dogsbay/icons": "0.2.0-beta.134",
+    "@dogsbay/minja": "0.2.0-beta.134",
+    "@dogsbay/primitives": "0.2.0-beta.134",
+    "@dogsbay/render-html": "0.2.0-beta.134",
+    "@dogsbay/search": "0.2.0-beta.134",
+    "@dogsbay/serialize-core": "0.2.0-beta.134",
+    "@dogsbay/site-check": "0.2.0-beta.134",
+    "@dogsbay/site-files": "0.2.0-beta.134",
+    "@dogsbay/types": "0.2.0-beta.134",
+    "@dogsbay/ui": "0.2.0-beta.134",
     "@mermanjs/web": "0.7.0",
     "@playwright/test": "1.61.1",
     "@types/node": "^22.10.0",