@dogsbay/ssg 0.2.0-beta.135 → 0.2.0-beta.138

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.135 (MIT)
+@dogsbay/elements@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.135 (MIT)
+@dogsbay/primitives@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.135 (MIT)
+@dogsbay/render-html@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.135 (MIT)
+@dogsbay/search@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.135 (MIT)
+@dogsbay/ui@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.

package/dist/package/browser.mjs

@@ -143,7 +143,8 @@ function parseConfig(text, overrides = {}) {
     locale: s.locale != null ? unitId("locale", s.locale) : void 0,
     attributes: s.attributes ?? void 0,
     templates: sourceTemplates(s.templates, String(s.path)),
-    ...s.nav != null ? { nav: sourceNav(s.nav, String(s.path), s.from) } : {}
+    ...s.nav != null ? { nav: sourceNav(s.nav, String(s.path), s.from) } : {},
+    ...s.data != null ? { data: dataFolder(`content.sources (${String(s.path)}): data`, s.data) } : {}
   }));
   if (sources.length === 0) sources.push({ path: "content" });
   const versions = (content.versions ?? raw.versions ?? []).map((v) => ({
@@ -243,6 +244,8 @@ function parseConfig(text, overrides = {}) {
     codeBlockTitle: content.codeBlockTitle === false ? false : content.codeBlockTitle === "auto" ? "auto" : true,
     imageCaptions: content.imageCaptions === "title" ? "title" : false,
     html: htmlOf(content.html),
+    dataDir: content.data != null ? dataFolder("content.data", content.data) : "data",
+    dataDirSet: content.data != null,
     plausible: typeof raw.analytics?.plausible?.domain === "string" ? { domain: raw.analytics.plausible.domain, scriptUrl: strOrUndef(raw.analytics.plausible.scriptUrl) } : void 0,
     ...overrides
   };
@@ -466,7 +469,17 @@ 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);
+  const dataDirs = [cfg.dataDir, ...cfg.sources.flatMap((s) => s.data ? [s.data] : [])];
+  return [.../* @__PURE__ */ new Set([...roots, cfg.themeDir, ...cfg.css, ...navDirs, ...dataDirs])].filter(Boolean);
+}
+function dataFolder(what, v) {
+  if (typeof v !== "string" || !v.trim()) throw new ConfigError(`${what} must be a folder inside the project, such as ./data; got ${JSON.stringify(v)}`);
+  const p = insideProject(what, v.trim()).replace(/^(\.\/)+/, "").replace(/\/+$/, "");
+  if (!p || p === ".") throw new ConfigError(`${what} must be a folder inside the project, not the project itself (every file would be a data file)`);
+  return p;
+}
+function dataDirOf(cfg, s) {
+  return s.data ?? cfg.dataDir;
 }
 function sourceRoot(s) {
   return s.path === "." ? "" : s.path.replace(/^\.\//, "").replace(/\/+$/, "") + "/";
@@ -1072,31 +1085,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.135 (MIT)
+@dogsbay/elements@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/primitives@0.2.0-beta.135 (MIT)
+@dogsbay/primitives@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/render-html@0.2.0-beta.135 (MIT)
+@dogsbay/render-html@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/search@0.2.0-beta.135 (MIT)
+@dogsbay/search@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
 
 ========================================================================
-@dogsbay/ui@0.2.0-beta.135 (MIT)
+@dogsbay/ui@0.2.0-beta.138 (MIT)
 https://github.com/dogsbay/dogsbay.git
 
 Licensed under MIT; the package ships no licence file.
@@ -2253,6 +2266,7 @@ async function preprocess(text, path, attributes, files, undefinedRefs = "preser
   };
   if (budget && timeout <= 0) return skip();
   budget?.start();
+  const warnings = [];
   try {
     const out = await render(mask(text), {
       context: withUnderscoreAliases(attributes),
@@ -2262,9 +2276,14 @@ async function preprocess(text, path, attributes, files, undefinedRefs = "preser
       basePath: dirname(path),
       loader: new MapLoader(files),
       timeout,
-      ...run.parseCache !== void 0 ? { parseCache: run.parseCache } : {}
+      ...run.parseCache !== void 0 ? { parseCache: run.parseCache } : {},
+      // Once per tag and place: a page that includes a file twice is told once.
+      onWarning: (w) => {
+        if (!warnings.some((x) => x.tag === w.tag && x.line === w.line && x.include === w.include && x.variable === w.variable))
+          warnings.push({ tag: w.tag, line: w.line, ...w.include ? { include: w.include } : {}, ...w.variable ? { variable: w.variable } : {} });
+      }
     });
-    return { text: stripFenceMinjaMarkers(stripInlineMinjaMarkers(unmask(out))) };
+    return { text: stripFenceMinjaMarkers(stripInlineMinjaMarkers(unmask(out))), ...warnings.length ? { warnings } : {} };
   } 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) };
@@ -2360,7 +2379,7 @@ var ScanCache = class {
 };
 
 // src/core/build.ts
-import { TemplatePages } from "@dogsbay/format-dogsbay-md/browser";
+import { DATA_DIRECTIVES, DataCache, DataFileError, DataFiles, DEFAULT_DATA_LIMITS, hasDataDirectives, NO_PROJECT_MESSAGE, resolveDataDirectives, TemplatePages, UNTRUSTED_DATA_LIMITS } from "@dogsbay/format-dogsbay-md/browser";
 import { extractText, SearchIndexBuilder } from "@dogsbay/search/index";
 
 // src/core/strings.ts
@@ -2981,7 +3000,7 @@ function reporter(warnings, problems) {
     problems.push({ code, ...at, ...at.file !== void 0 ? { file: detach(at.file) } : {}, message, text: t });
   };
 }
-function linedDiagnostics(found, raw, body, parsed) {
+function linedDiagnostics(found, raw, body, parsed, after = "of the page after templating") {
   if (!found.length) return [];
   const offset = raw.slice(0, raw.length - body.length).split("\n").length - 1;
   const LINE = /\bline (\d+)/g;
@@ -2999,10 +3018,34 @@ function linedDiagnostics(found, raw, body, parsed) {
   return found.map((d) => {
     const i = asWritten.findIndex((w) => key(w) === key(d));
     if (i >= 0) return lined(asWritten.splice(i, 1)[0]);
-    return { code: d.code, message: detach(d.message.replace(LINE, "line $1 of the page after templating")), ...named(d) };
+    return { code: d.code, message: detach(d.message.replace(LINE, `line $1 ${after}`)), ...named(d) };
   });
 }
 var decoder = new TextDecoder();
+var DATA_DIRECTIVE_NODES = new Set(DATA_DIRECTIVES);
+var DEFAULT_DATA_CACHE_BYTES = 32 * 1024 * 1024;
+var NO_DATA_FOLDER = "this site has no data folder (data/ beside dogsbay.config.yml, or content.data)";
+function hasFilesUnder(files, dir) {
+  const prefix = `${dir}/`;
+  for (const k of files.keys()) if (k.startsWith(prefix)) return true;
+  return false;
+}
+function strictestData(floor, given) {
+  const out = { ...floor };
+  for (const k of Object.keys(floor)) {
+    const g = given?.[k];
+    if (typeof g === "number" && Number.isFinite(g) && g >= 0 && g < floor[k]) out[k] = g;
+  }
+  return out;
+}
+function finiteLimits(given) {
+  const out = {};
+  for (const [k, v] of Object.entries(given ?? {})) if (typeof v === "number" && Number.isFinite(v) && v >= 0) out[k] = v;
+  return out;
+}
+function inDataFolder(cfg, path) {
+  return [cfg.dataDir, ...cfg.sources.flatMap((s) => s.data ? [s.data] : [])].some((d) => path.startsWith(`${d}/`));
+}
 async function readText(c) {
   if (typeof c === "string") return c;
   if (isLazyText(c)) return c.read();
@@ -3082,13 +3125,16 @@ async function build(input, hooks = {}) {
   const problems = [];
   const report = reporter(warnings, problems);
   for (const m of ignored) report("untrusted", `[untrusted] ${m}`);
+  for (const [what, dir] of [...cfg.dataDirSet ? [["content.data", cfg.dataDir]] : [], ...cfg.sources.flatMap((s) => s.data ? [[`content.sources (${s.path}) data`, s.data]] : [])]) {
+    if (!hasFilesUnder(input.files, dir)) report("data", `[data] ${what}: ${dir} has no files, so its data directives and data.<name> lookups find nothing`);
+  }
   for (const p of cfg.unsupportedPlugins) report("plugins", `[plugins] ${p} is an Astro-pipeline plugin; dogsbay-ssg ignores it`);
   const highlighter = input.highlighter ?? await (await import("@dogsbay/highlight")).createHighlighter({ cacheChars: input.highlightCacheChars });
   const buildCss = await siteCssBuilder(input);
   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), 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) };
+  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), dataCache: new DataCache(input.dataCacheBytes ?? DEFAULT_DATA_CACHE_BYTES) };
   for (const r of cfg.redirects) {
     const from = sitePath(r.from, cfg.basePath);
     if (!from) {
@@ -3279,8 +3325,8 @@ async function buildUnit(unit, allUnits, cfg, input, highlighter, emit, report,
   const prefix = unit.prefix ? unit.prefix + "/" : "";
   const label = unit.prefix || "/";
   const warn = (code, m, at = {}) => report(code, `[${label}] ${m}`, { unit: label, ...at, message: at.message ?? m });
-  const warnFile = (code, shown, file, m, line) => warn(code, `${shown}: ${m}`, { file, message: m, ...line ? { line } : {} });
-  const warnPage = (info, code, m, line) => warnFile(code, where(info), srcOf(info), m, line);
+  const warnFile = (code, shown, file, m, line, more = {}) => warn(code, `${shown}: ${m}`, { file, message: m, ...line ? { line } : {}, ...more });
+  const warnPage = (info, code, m, line, more) => warnFile(code, where(info), srcOf(info), m, line, more);
   const navFileAt = () => navProjectFiles.length === 1 ? { file: navProjectFiles[0] } : {};
   const diagramWarn = (m, file) => file ? warnFile("diagram", file, abs(file), m) : warn("diagram", m);
   let math;
@@ -3385,13 +3431,54 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     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 dataLimits = input.untrusted ? strictestData(UNTRUSTED_DATA_LIMITS, input.dataLimits) : { ...DEFAULT_DATA_LIMITS, ...finiteLimits(input.dataLimits) };
+  const pageDataBytes = Math.min(dataLimits.maxTotalBytes, 4 * dataLimits.maxFileBytes);
+  let dataDirHas = /* @__PURE__ */ new Map();
+  const dataDir = (p) => {
+    const dir2 = dataDirOf(cfg, sourceOf(p));
+    let has = dataDirHas.get(dir2);
+    if (has === void 0) dataDirHas.set(dir2, has = hasFilesUnder(input.files, dir2));
+    return has ? dir2 : void 0;
+  };
+  const dataReader = (dir2, onLoad) => new DataFiles({
+    limits: dataLimits,
+    cache: state.dataCache,
+    load: async (rel2) => {
+      const c = input.files.get(`${dir2}/${rel2}`);
+      if (c == null) return void 0;
+      const text = await readText(c);
+      onLoad?.(text.length, rel2);
+      return text;
+    }
+  });
+  let dataBy = /* @__PURE__ */ new Map();
+  const dataOf = (p) => {
+    const dir2 = dataDir(p);
+    if (!dir2) return void 0;
+    let d = dataBy.get(dir2);
+    if (!d) dataBy.set(dir2, d = dataReader(dir2));
+    return d;
+  };
+  const pageDataOf = (p) => {
+    const dir2 = dataDir(p);
+    if (!dir2) return void 0;
+    let read2 = 0;
+    return dataReader(dir2, (bytes, rel2) => {
+      read2 += bytes;
+      if (read2 > pageDataBytes) throw new DataFileError(`this page's data directives read more than ${pageDataBytes.toLocaleString("en")} bytes of data in all (each directive counts its file again); split the page or the file`, rel2);
+    });
+  };
+  const dataUnresolved = /* @__PURE__ */ new Set();
+  const dataReads = /* @__PURE__ */ new Map();
+  const dataTemplatePages = /* @__PURE__ */ new Set();
+  let dataInTitles = false;
+  let templatesBy = /* @__PURE__ */ new Map();
   const templatesOf = (p) => {
     const key = named.length ? namespaceOf(p) : "";
     let tp = templatesBy.get(key);
     if (!tp) {
       const at = scoped(p);
-      tp = new TemplatePages({ load: (q) => readInclude(at ? at(q) : q), attributes: attributesOf(p), sourceDefault: sourceOf(p).templates === "jinja" });
+      tp = new TemplatePages({ load: (q) => readInclude(at ? at(q) : q), attributes: attributesOf(p), sourceDefault: sourceOf(p).templates === "jinja", data: dataOf(p) });
       templatesBy.set(key, tp);
     }
     return tp;
@@ -3409,6 +3496,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
   const leftOut = /* @__PURE__ */ new Map();
   for (const [p, c] of files) {
     if (buildOnly(p)) continue;
+    if (inDataFolder(cfg, abs(p))) continue;
     if (/\.(md|markdown)$/i.test(p)) {
       if (excluded(p)) {
         leftOut.set(slugFromPath(p), cfg.excludeFromRoutes.find((d) => p === d || p.startsWith(d.replace(/\/+$/, "") + "/")) ?? "_ or . files");
@@ -3473,6 +3561,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
         for (const f of memo2.deps ?? []) includedProject.add(f);
       } else {
         const keep = memo2 && !templatesOf(p).isTemplatePage(fm);
+        if (templatesOf(p).isTemplatePage(fm) && /\bdata\s*[.[]/.test(`${str(fm.title) ?? ""} ${fm.description ?? ""}`)) dataInTitles = true;
         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));
@@ -3708,7 +3797,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
   const brokenCounts = /* @__PURE__ */ new Map();
   const prepare = async (info) => {
     const warned = [];
-    const warn2 = (code, m, line) => warned.push([code, m, line]);
+    const warn2 = (code, m, line, more) => warned.push([code, m, line, more]);
     let diagnostics;
     let t2 = now();
     if (info.virtual) {
@@ -3730,18 +3819,54 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
       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, templateRun);
+    const reads = /* @__PURE__ */ new Set();
+    const readDir = dataDir(info.source);
+    const isTemplate = templatesOf(info.source).isTemplatePage(fm);
+    if (isTemplate && readDir) dataTemplatePages.add(info.source);
+    else dataTemplatePages.delete(info.source);
+    const pre = isTemplate ? { text: await templatesOf(info.source).render(bodySrc, info.source, fm, { firstLine: raw.slice(0, raw.length - bodySrc.length).split("\n").length, onDataRead: (d) => reads.add(`${readDir}/${d}`) }) } : 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}`) });
     }
+    if ("warnings" in pre && pre.warnings) {
+      const fmLines = raw.slice(0, raw.length - bodySrc.length).split("\n").length - 1;
+      for (const w of pre.warnings) {
+        if (w.tag.startsWith("end")) continue;
+        const where2 = w.include ? ` (in ${w.include})` : w.variable ? ` (in the value of {{ ${w.variable} }})` : "";
+        const m = `{% ${w.tag} %} is not a tag of an ordinary page and is shown as written${where2}; for loops and the like, make it a template page (template: jinja in its front matter)`;
+        const line = w.include || w.variable ? void 0 : w.line + fmLines;
+        warn2("template-tag", m, line);
+        if (mode.diagnostics) (diagnostics ??= []).push({ code: "template-tag", message: detach(m), ...line ? { line } : {} });
+      }
+    }
+    const templated = pre.text;
+    dataUnresolved.delete(info.source);
+    if (hasDataDirectives(pre.text)) {
+      const data = pageDataOf(info.source);
+      const r = await resolveDataDirectives(pre.text, data);
+      if (r.problems.length) dataUnresolved.add(info.source);
+      for (const d of r.reads) reads.add(`${readDir}/${d}`);
+      const offset = pre.text === bodySrc ? raw.slice(0, raw.length - bodySrc.length).split("\n").length - 1 : void 0;
+      for (const pr of r.problems) {
+        const message = data ? pr.message : pr.message.replace(NO_PROJECT_MESSAGE, NO_DATA_FOLDER);
+        const line = offset === void 0 ? void 0 : pr.line + offset;
+        const shown = line === void 0 ? `${message} (line ${pr.line} of the page after templating)` : message;
+        const inFile = pr.file && readDir && data && !/(^|\/)\.\.?(\/|$)/.test(pr.file) && input.files.has(`${readDir}/${pr.file}`) ? { dataFile: `${readDir}/${pr.file}`, ...pr.fileLine ? { dataLine: pr.fileLine } : {} } : {};
+        warn2("data", shown, line, inFile);
+        if (mode.diagnostics) (diagnostics ??= []).push({ code: "data", message: detach(shown), ...line ? { line } : {} });
+      }
+      pre.text = r.text;
+    }
+    if (reads.size) dataReads.set(info.source, reads);
+    else dataReads.delete(info.source);
     phase.template = (phase.template ?? 0) + now() - t2;
     t2 = now();
     let tree;
     try {
       const parsed = dogsbayMdToTree(pre.text, mode.diagnostics ? { diagnostics: true } : void 0);
       tree = parsed.tree;
-      if (mode.diagnostics) (diagnostics ??= []).push(...linedDiagnostics(parsed.diagnostics ?? [], raw, bodySrc, pre.text));
+      if (mode.diagnostics) (diagnostics ??= []).push(...linedDiagnostics(parsed.diagnostics ?? [], raw, bodySrc, pre.text, templated === bodySrc ? "of the page with its data directives drawn" : void 0));
     } catch (e) {
       warn2("parse", `parse error: ${e.message}`);
       if (mode.diagnostics) (diagnostics ??= []).push({ code: "parse", message: detach(`parse error: ${e.message}`) });
@@ -3759,50 +3884,100 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     const markdown = (unresolved || ns) && cfg.mdMirror ? treeToDogsbayMd(tree) : pre.text;
     return { raw, fm, bodySrc, pre, tree, warned, markdown, diagnostics };
   };
-  const AHEAD = 24;
+  const pagesOpt = Math.floor(input.highlightAhead?.pages ?? 24);
+  const aheadPages = Number.isNaN(pagesOpt) ? 24 : Math.max(1, pagesOpt);
+  const aheadChars = input.highlightAhead?.chars ?? Infinity;
+  const charBound = Number.isFinite(aheadChars);
+  const keyOf = (code, lang2, opts) => `${lang2 ?? ""}\0${JSON.stringify(opts)}\0${code}`;
+  const delivered = /* @__PURE__ */ new Map();
+  const wanted = /* @__PURE__ */ new Map();
+  const pageHighlighter = input.highlightPool ? {
+    render: (c, l, o) => highlighter.render(c, l, o),
+    code: (c, l, o) => delivered.get(keyOf(c, l, o)) ?? highlighter.code(c, l, o),
+    resolve: (l) => highlighter.resolve(l),
+    has: (c, l, o) => delivered.has(keyOf(c, l, o)) || highlighter.has(c, l, o),
+    prime: (c, l, o, h) => highlighter.prime(c, l, o, h),
+    cacheStats: () => highlighter.cacheStats(),
+    load: highlighter.load && ((b) => highlighter.load(b))
+  } : highlighter;
   const renderAhead = async (all, pool) => {
     const list = input.onPageBuilt ? all : all.filter((info) => !(replaced != null && info.slug === replaced));
     const inflight = /* @__PURE__ */ new Map();
     const ahead = /* @__PURE__ */ new Map();
-    const keyOf = (r) => `${r.lang ?? ""}\0${JSON.stringify(r.opts)}\0${r.code}`;
+    let cur = 0;
+    let next = 0;
+    let held = 0;
+    let preparing = 0;
+    const fill = () => {
+      while (next < list.length && next < cur + aheadPages && (next <= cur + 1 || !charBound || preparing === 0 && held < aheadChars)) start(next++);
+    };
     const start = (i) => {
-      if (i >= list.length || ahead.has(i)) return;
-      const job = prepare(list[i]).then(async (p) => {
+      preparing++;
+      const prepared = prepare(list[i]).finally(() => preparing--);
+      const job = prepared.then(async (p) => {
+        held += p.raw.length;
         const waits = [];
         const send = [];
+        const keys = /* @__PURE__ */ new Map();
         const sendKeys = /* @__PURE__ */ new Set();
         for (const r of codeRequests(p.tree, !!diagrams)) {
-          const k = keyOf(r);
-          const on = inflight.get(k);
-          if (on) waits.push(on);
-          else if (!highlighter.has(r.code, r.lang, r.opts) && !sendKeys.has(k)) {
+          const k = keyOf(r.code, r.lang, r.opts);
+          if (keys.has(k)) continue;
+          if (delivered.has(k) || inflight.has(k)) {
+            keys.set(k, r);
+            const on = inflight.get(k);
+            if (on) waits.push(on);
+          } else if (!highlighter.has(r.code, r.lang, r.opts)) {
+            keys.set(k, r);
             send.push(r);
             sendKeys.add(k);
           }
         }
+        for (const [k, r] of keys) {
+          const w = wanted.get(k);
+          if (w) w.n++;
+          else wanted.set(k, { r, n: 1 });
+        }
         if (send.length) {
-          const delivered = pool.render(send).then(
-            (html) => send.forEach((r, n) => typeof html[n] === "string" && highlighter.prime(r.code, r.lang, r.opts, html[n])),
+          const done2 = pool.render(send).then(
+            (html) => send.forEach((r, n) => {
+              const k = keyOf(r.code, r.lang, r.opts);
+              if (typeof html[n] === "string" && wanted.has(k) && !delivered.has(k)) {
+                delivered.set(k, html[n]);
+                held += html[n].length;
+              }
+            }),
             () => {
             }
-          );
-          const done2 = delivered.finally(() => sendKeys.forEach((k) => inflight.delete(k)));
+          ).finally(() => sendKeys.forEach((k) => inflight.delete(k)));
           for (const k of sendKeys) inflight.set(k, done2);
           waits.push(done2);
         }
+        fill();
         await Promise.all(waits);
-        return p;
+        return { p, keys };
       });
       job.catch(() => {
       });
       ahead.set(i, job);
     };
     try {
-      for (let i = 0; i < list.length; i++) {
-        for (let j = i; j < i + AHEAD; j++) start(j);
-        const p = await ahead.get(i);
-        ahead.delete(i);
-        await renderPage(list[i], p);
+      for (cur = 0; cur < list.length; cur++) {
+        fill();
+        const { p, keys } = await ahead.get(cur);
+        ahead.delete(cur);
+        await renderPage(list[cur], p);
+        held -= p.raw.length;
+        for (const k of keys.keys()) {
+          const w = wanted.get(k);
+          if (--w.n) continue;
+          wanted.delete(k);
+          const html = delivered.get(k);
+          if (html === void 0) continue;
+          delivered.delete(k);
+          held -= html.length;
+          highlighter.prime(w.r.code, w.r.lang, w.r.opts, html);
+        }
       }
     } finally {
       for (const p of ahead.values()) p.catch(() => {
@@ -3813,7 +3988,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     const isReplaced = replaced != null && info.slug === replaced;
     if (isReplaced && !input.onPageBuilt) return;
     const got = prepared ?? await prepare(info);
-    for (const [code, m, line] of got.warned) warnPage(info, code, m, line);
+    for (const [code, m, line, more] of got.warned) warnPage(info, code, m, line, more);
     mode.diagnostics?.(srcOf(info), got.diagnostics ?? []);
     const { raw, fm, bodySrc, pre, markdown } = got;
     let tree = got.tree;
@@ -3852,7 +4027,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     const noteRemoved = (code, m) => void (code !== "image-remote" && removed.add(m));
     if (sanitizing) tree = sanitizeTree(tree, noteRemoved);
     if (cfg.math && !math && mayHaveMath(tree)) math = await loadMath();
-    await highlighter.load?.(highlightInputs(tree));
+    if (!input.highlightPool || codeRequests(tree, !!diagrams).some((r) => !pageHighlighter.has(r.code, r.lang, r.opts))) await highlighter.load?.(highlightInputs(tree));
     const unloadedBefore = highlighter.cacheStats().unloaded ?? 0;
     t = now();
     const apiLayout = apiPageLayout(tree);
@@ -3860,7 +4035,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     const ctx = createRenderContext({
       link: resolver.link,
       asset: resolver.asset,
-      highlighter,
+      highlighter: pageHighlighter,
       // The layout's own ids, outside the rendered content: generated ids avoid them
       reservedIds: ["db-content", "db-sidebar", "db-search", "db-search-results", "db-toc-title", "db-page-markdown"],
       t: t_,
@@ -3894,7 +4069,7 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     if (navNode?.children.length && !hasProse(tree)) body += childLinks2(navNode.children, (s) => pageRefs.get(s), info.out, cfg.linkStyle, infos);
     const layoutName = str(fm.layout) ?? (post ? "blank" : cfg.layout);
     const tocMode = fm.toc === false ? "off" : ["top", "popover", "rail", "off"].includes(fm.toc) ? fm.toc : cfg.toc;
-    for (const u of ctx.unknown) warnPage(info, "unsupported-node", `unsupported node "${u}" rendered as a plain container`);
+    for (const u of ctx.unknown) if (!(DATA_DIRECTIVE_NODES.has(u) && dataUnresolved.has(info.source))) warnPage(info, "unsupported-node", `unsupported node "${u}" rendered as a plain container`);
     for (const u of ctx.unsafeUrls ?? []) warnPage(info, "unsafe-url", `refused the unsafe URL "${u}"`);
     for (const m of removed) warnPage(info, "html", m);
     for (const name of ctx.missingIcons ?? []) warnPage(info, "icon", `unknown icon "${name}"${input.icons ? "" : " (only the built-in icons are available in this build)"}`);
@@ -4081,7 +4256,8 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
           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, { ...templateRun, kind: "copy" })).text;
+        const templated = 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 text = hasDataDirectives(templated) ? (await resolveDataDirectives(templated, pageDataOf(info.source))).text : templated;
         const ns = named.length ? namespaceOf(info.source) : "";
         if (!ns && !PLACEHOLDER_DIRECTIVE.test(text)) return text;
         const tree = dogsbayMdToTree(text).tree;
@@ -4145,6 +4321,26 @@ ${marker}${title}${marker}`, path, attributesOf(path), includesFor(path, read2),
     included(path) {
       const r = rel(path);
       return r !== void 0 && includedPaths.has(r) || includedProject.has(path);
+    },
+    dataReaders(path) {
+      const stem = (p) => p.replace(/\.[A-Za-z]+$/, "");
+      const out = [];
+      for (const info of bySource.values()) {
+        if (info.slug === replaced) continue;
+        const dir2 = dataDirOf(cfg, sourceOf(info.source));
+        if (!path.startsWith(`${dir2}/`)) continue;
+        const read2 = [...dataReads.get(info.source) ?? []];
+        if (read2.some((r) => r === path || stem(r) === stem(path)) || dataUnresolved.has(info.source) || dataTemplatePages.has(info.source)) out.push(prefix + info.out);
+      }
+      return out;
+    },
+    dataInTitles() {
+      return dataInTitles;
+    },
+    invalidateData() {
+      dataBy = /* @__PURE__ */ new Map();
+      templatesBy = /* @__PURE__ */ new Map();
+      dataDirHas = /* @__PURE__ */ new Map();
     }
   };
   async function emitGenerated() {
@@ -4903,6 +5099,23 @@ async function openDevSession(input, o = {}) {
         continue;
       }
       if (TOPIC_MAP.test(p)) continue;
+      const dataDirs = (x) => [...new Set(x.unit.members.map((m) => dataDirOf(config, m.source)))].filter((d) => p.startsWith(`${d}/`));
+      const dataUnits = [...units.values()].filter((x) => dataDirs(x).length);
+      if (dataUnits.length) {
+        for (const x of dataUnits) {
+          if (x.handle.dataInTitles()) {
+            lazy.add(x.unit.prefix);
+            mark("unit");
+            continue;
+          }
+          x.handle.invalidateData();
+          for (const page of x.handle.dataReaders(p)) {
+            stale.add(page);
+            mark("page");
+          }
+        }
+        continue;
+      }
       const u = unitOf(p);
       if (!u) continue;
       const content = input.files.get(p);

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

@@ -23,6 +23,7 @@ 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 { DataCache, type DataLimits } from "@dogsbay/format-dogsbay-md/browser";
 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;
@@ -75,6 +76,14 @@ export interface BuildInput {
     sink?: (path: string, content: SinkContent) => void | Promise<void>;
     /** Characters of include fragments to keep in memory between pages (default 8M). */
     textCacheChars?: number;
+    /**
+     * Limits on the data files a build reads (docs/data-files.md in the dogsbay repo): per file, per
+     * build, values, depth, rows, columns, cell size. Default: the loader's (`DEFAULT_DATA_LIMITS`).
+     * An untrusted build never reads past `UNTRUSTED_DATA_LIMITS`, whatever is given here.
+     */
+    dataLimits?: Partial<DataLimits>;
+    /** Bytes of parsed data files kept between pages and units (default 32 MB), weighed as the loader weighs them. */
+    dataCacheBytes?: number;
     /** Called after each page, for progress reporting. */
     onPage?: (done: number, total: number, unit: string) => void;
     /**
@@ -141,11 +150,21 @@ export interface BuildInput {
     /**
      * Highlights code blocks off the main thread (the Node CLI passes a pool of
      * worker threads). With it, pages are read and parsed a few ahead of their
-     * turn and their code blocks highlighted in the pool into the highlight
-     * cache, so each page renders from cache hits. Output is the same: a block
-     * the pool has not delivered is highlighted on the main thread as before.
+     * turn (`highlightAhead`) and their code blocks highlighted in the pool; each
+     * page renders from the blocks delivered for it, which then move into the
+     * highlight cache. Output is the same: a block the pool has not delivered is
+     * highlighted on the main thread as before.
      */
     highlightPool?: HighlightPool;
+    /**
+     * How far ahead of rendering pages are prepared for the pool: at most `pages` pages (default 24; at least 1) and,
+     * beyond the next page, `chars` of their source plus the HTML delivered for them and not yet cached (default: no
+     * limit). Without a pool nothing is read ahead.
+     */
+    highlightAhead?: {
+        pages?: number;
+        chars?: number;
+    };
     /** Called once with the redirects the build writes (checked and resolved; site paths). */
     onRedirects?: (rules: readonly RedirectRule[]) => void;
     /**
@@ -161,9 +180,9 @@ export interface BuildInput {
 export type SiteCssBuilder = (o: CssOptions) => Promise<string>;
 /** The stylesheet builder of a build: the caller's, else Tailwind's. */
 export declare function siteCssBuilder(input: BuildInput): Promise<SiteCssBuilder>;
-/** Renders code blocks as `Highlighter.render` does, elsewhere; one result per request, in order. */
+/** Renders code blocks as `Highlighter.render` does, elsewhere; one result per request, in order (null: not rendered there, so highlighted here). */
 export interface HighlightPool {
-    render(blocks: CodeRequest[]): Promise<string[]>;
+    render(blocks: CodeRequest[]): Promise<(string | null)[]>;
 }
 /** A page as `BuildInput.onPageBuilt` sees it. */
 export interface BuiltPage {
@@ -211,6 +230,8 @@ export interface SiteState {
     parseCache: ParseCache | false;
     /** Template time left for the build, or for a dev session's current request. */
     templateBudget: TemplateBudget;
+    /** Parsed data files, by path and text (so an edited file is parsed again), shared by units and a dev session's rebuilds. */
+    dataCache: DataCache;
 }
 export interface BuildStats {
     pages: number;
@@ -259,6 +280,9 @@ export interface BuildProblem {
     /** The warning without its `[unit]` and file. */
     message: string;
     text: string;
+    /** For a data directive's problem in a data file: that file (a project path), and its 1-based line when known. */
+    dataFile?: string;
+    dataLine?: number;
 }
 /** Where a warning is, and its message when the text says more (a file first). */
 type ProblemAt = Partial<Omit<BuildProblem, "code" | "text">>;
@@ -284,7 +308,7 @@ export interface PageDiagnostic {
  * that one's lines; one only the templated text has has no `line`, and its message says the lines
  * it names are the templated page's. Messages are detached (a session keeps them; some quote a line).
  */
-export declare function linedDiagnostics(found: ParseDiagnostic[], raw: string, body: string, parsed: string): PageDiagnostic[];
+export declare function linedDiagnostics(found: ParseDiagnostic[], raw: string, body: string, parsed: string, after?: string): PageDiagnostic[];
 /** A file's text, read now if it is lazy. */
 export declare function readText(c: FileContent): Promise<string>;
 /**
@@ -319,6 +343,16 @@ export interface UnitHandle {
     forget(path: string): void;
     /** Whether a page of the unit has included this file (so its includers must render again). */
     included(path: string): boolean;
+    /**
+     * The pages to render again when a data file (a project path) changes: those whose directives or
+     * template read it, those whose data directives were left in place, and template pages that use
+     * `data`. Empty when the unit does not read its folder.
+     */
+    dataReaders(path: string): string[];
+    /** Whether a template page's title or description uses `data` (resolved in pass 1: a change needs the unit built again). */
+    dataInTitles(): boolean;
+    /** Forget what the unit loaded from data files: readers, template pages and their values, which folders had files. */
+    invalidateData(): void;
     /** The project files the unit's nav was read from: `nav:` files, topic maps and every map they include. */
     navInputs: string[];
 }

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

@@ -43,6 +43,12 @@ export interface SourceDef {
      * source's root, else its folders.
      */
     nav?: string;
+    /**
+     * The source's own data folder (`data:` on the source, docs/data-files.md in the dogsbay repo),
+     * project-relative: a versioned site whose versions need different data gives each its own.
+     * Unset: the site's (`SiteConfig.dataDir`).
+     */
+    data?: string;
 }
 export type SearchEngine = "builtin" | "pagefind" | "both";
 export interface SiteConfig {
@@ -139,6 +145,14 @@ export interface SiteConfig {
      * default (BuildInput.defaultHtml), "keep" for local builds, "sanitize" in the Worker.
      */
     html?: "keep" | "sanitize";
+    /**
+     * The data folder (content.data, shared with the Astro pipeline): YAML, JSON, CSV and TSV files
+     * pages read by name (`::data-table`, `::data-cards`, `data.<name>` in template pages).
+     * Project-relative; "data" (beside dogsbay.config.yml) unless set. `dataDirSet`: named in the
+     * config, so a folder with no files is reported.
+     */
+    dataDir: string;
+    dataDirSet: boolean;
     /** Click-to-zoom images, from `plugins: [@dogsbay/plugin-image-zoom]` with its options. */
     imageZoom?: {
         background: string;
@@ -278,9 +292,12 @@ export declare function projectPath(unit: BuildUnit, path: string): string;
 export declare const TOPIC_MAP: RegExp;
 /**
  * The project folders and files a build reads: every source's root, the theme folder, extra
- * stylesheets, and the folder of each source's own nav file (a topic map's includes sit beside it).
+ * stylesheets, the folder of each source's own nav file (a topic map's includes sit beside it), and
+ * the data folders (the site's, and any source's own; one that does not exist is not read).
  * [""] when a source is the whole project. What the CLI reads from disk, and a dev session watches.
  */
 export declare function projectRoots(cfg: SiteConfig): string[];
+/** The data folder a source's pages read: its own `data:`, else the site's. */
+export declare function dataDirOf(cfg: SiteConfig, s: SourceDef): string;
 /** A source's content root as a path prefix: "" for ".", else "content/". */
 export declare function sourceRoot(s: SourceDef): string;

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

@@ -10,6 +10,10 @@
  *    its pages (`rebuildUnitLazy`), its old output is dropped, and all its
  *    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 data file (in the site's data folder or a source's own): the pages
+ *    that read it (or a file of the same name), have data directives left
+ *    in place, or are template pages of that folder are stale; a unit whose
+ *    template titles use `data` is built again;
  *  - 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;

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

@@ -14,7 +14,7 @@ export type DiagramResult = {
 };
 export interface DiagramRenderer {
     render(batch: DiagramRequest[]): Promise<DiagramResult[]>;
-    /** Calls allowed per build; a Worker service binding allows about 30. Default: no limit. */
+    /** Calls allowed per build. Default: no limit (the Worker's renderer, on one session, has none). */
     maxCalls?: number;
     /** Most diagrams per call; larger batches are split (each part is a call). Default: no limit. */
     maxBatch?: number;
@@ -55,10 +55,10 @@ export declare function fencedDiagrams(src: string): string[];
  *
  * The SVGs the current unit's built pages use are pinned until `endUnit()`:
  * evicting one would cost a renderer call to get it back (the first deployed
- * test spent 20 of a Worker's 30 calls that way). Pinning stops at
- * `maxPinnedChars`, so memory stays bounded however many diagrams a unit
- * has; beyond it, SVGs are evicted and pages render them again while the
- * call budget lasts. Unpinned SVGs are kept up to `maxChars` for later
+ * test, when each call was a Worker call, spent 20 of its 30 that way).
+ * Pinning stops at `maxPinnedChars`, so memory stays bounded however many
+ * diagrams a unit has; beyond it, SVGs are evicted and pages render them
+ * again, within `maxCalls` if the renderer has one. Unpinned SVGs are kept up to `maxChars` for later
  * units, least recently used first out.
  */
 export declare class DiagramStore {

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

@@ -14,6 +14,16 @@ export interface PreprocessResult {
     error?: string;
     /** Not rendered: the build's template time budget was spent (counted in `TemplateBudget.skipped`). */
     skipped?: boolean;
+    /**
+     * Tags content mode does not know (`{% for %}`, `{% macro %}`), kept as written: minja's warnings
+     * (outside code, which is masked). `line` is in `text` when `include` is unset.
+     */
+    warnings?: {
+        tag: string;
+        line: number;
+        include?: string;
+        variable?: string;
+    }[];
 }
 /**
  * Template time for a whole build (plans/worker-scale.md stage 3): each render gets the shorter of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/ssg",
-  "version": "0.2.0-beta.135",
+  "version": "0.2.0-beta.138",
   "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",
@@ -33,8 +33,10 @@
     "test": "npm run build:client && vitest run",
     "test:browser": "playwright test",
     "check": "npm run build:client && tsc --noEmit && tsc --noEmit -p src/worker/tsconfig.json",
-    "dev:worker": "npm run build:client && wrangler dev -c wrangler.jsonc -c wrangler.diagrams.jsonc --port 8798",
+    "dev:worker": "npm run build:client && wrangler dev -c wrangler.jsonc -c wrangler.diagrams.jsonc -c wrangler.highlight.jsonc --port 8798",
     "deploy": "npm run build:client && wrangler deploy",
+    "deploy:diagrams": "npm run build:client && wrangler deploy -c wrangler.diagrams.jsonc",
+    "deploy:highlight": "npm run build:client && wrangler deploy -c wrangler.highlight.jsonc",
     "test:worker": "npm run build:client && node scripts/test-worker.mjs",
     "build:package": "npm run build:client && node scripts/build-package.mjs",
     "prepublishOnly": "npm run build:package"
@@ -47,38 +49,38 @@
     "tailwindcss": "^4.3.2"
   },
   "peerDependencies": {
-    "@dogsbay/elements": "0.2.0-beta.135",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.135",
-    "@dogsbay/format-openapi": "0.2.0-beta.135",
-    "@dogsbay/format-topicmap": "0.2.0-beta.135",
-    "@dogsbay/highlight": "0.2.0-beta.135",
-    "@dogsbay/minja": "0.2.0-beta.135",
-    "@dogsbay/primitives": "0.2.0-beta.135",
-    "@dogsbay/render-html": "0.2.0-beta.135",
-    "@dogsbay/search": "0.2.0-beta.135",
-    "@dogsbay/serialize-core": "0.2.0-beta.135",
-    "@dogsbay/site-check": "0.2.0-beta.135",
-    "@dogsbay/site-files": "0.2.0-beta.135",
-    "@dogsbay/types": "0.2.0-beta.135"
+    "@dogsbay/elements": "0.2.0-beta.138",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.138",
+    "@dogsbay/format-openapi": "0.2.0-beta.138",
+    "@dogsbay/format-topicmap": "0.2.0-beta.138",
+    "@dogsbay/highlight": "0.2.0-beta.138",
+    "@dogsbay/minja": "0.2.0-beta.138",
+    "@dogsbay/primitives": "0.2.0-beta.138",
+    "@dogsbay/render-html": "0.2.0-beta.138",
+    "@dogsbay/search": "0.2.0-beta.138",
+    "@dogsbay/serialize-core": "0.2.0-beta.138",
+    "@dogsbay/site-check": "0.2.0-beta.138",
+    "@dogsbay/site-files": "0.2.0-beta.138",
+    "@dogsbay/types": "0.2.0-beta.138"
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.12.1",
     "@cloudflare/workers-types": "^5.20260921.1",
-    "@dogsbay/elements": "0.2.0-beta.135",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.135",
-    "@dogsbay/format-openapi": "0.2.0-beta.135",
-    "@dogsbay/format-topicmap": "0.2.0-beta.135",
-    "@dogsbay/highlight": "0.2.0-beta.135",
-    "@dogsbay/icons": "0.2.0-beta.135",
-    "@dogsbay/minja": "0.2.0-beta.135",
-    "@dogsbay/primitives": "0.2.0-beta.135",
-    "@dogsbay/render-html": "0.2.0-beta.135",
-    "@dogsbay/search": "0.2.0-beta.135",
-    "@dogsbay/serialize-core": "0.2.0-beta.135",
-    "@dogsbay/site-check": "0.2.0-beta.135",
-    "@dogsbay/site-files": "0.2.0-beta.135",
-    "@dogsbay/types": "0.2.0-beta.135",
-    "@dogsbay/ui": "0.2.0-beta.135",
+    "@dogsbay/elements": "0.2.0-beta.138",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.138",
+    "@dogsbay/format-openapi": "0.2.0-beta.138",
+    "@dogsbay/format-topicmap": "0.2.0-beta.138",
+    "@dogsbay/highlight": "0.2.0-beta.138",
+    "@dogsbay/icons": "0.2.0-beta.138",
+    "@dogsbay/minja": "0.2.0-beta.138",
+    "@dogsbay/primitives": "0.2.0-beta.138",
+    "@dogsbay/render-html": "0.2.0-beta.138",
+    "@dogsbay/search": "0.2.0-beta.138",
+    "@dogsbay/serialize-core": "0.2.0-beta.138",
+    "@dogsbay/site-check": "0.2.0-beta.138",
+    "@dogsbay/site-files": "0.2.0-beta.138",
+    "@dogsbay/types": "0.2.0-beta.138",
+    "@dogsbay/ui": "0.2.0-beta.138",
     "@mermanjs/web": "0.7.0",
     "@playwright/test": "1.61.1",
     "@types/node": "^22.10.0",