@pagenary/publisher 2026.5.3 → 2026.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagenary/publisher",
-  "version": "2026.5.3",
+  "version": "2026.6.0",
   "type": "module",
   "description": "Multi-tenant static publishing component for Pagenary platform.",
   "license": "AGPL-3.0-or-later",

package/scripts/build-tenants.js

@@ -8,6 +8,7 @@ import { createHash } from 'crypto';
 import os from 'os';
 import { generateSeoArtifacts, resolveBaseUrl, resolveOgImage } from './lib/seo-generator.js';
 import { generateCollections } from './lib/collections-generator.js';
+import { parseFrontmatter } from './lib/frontmatter.js';
 import { fileURLToPath } from 'node:url';
 
 const root = process.cwd();
@@ -1374,6 +1375,12 @@ function parseInlineMarkdown(input, linkContext = null) {
  * @returns {string} HTML string
  */
 function markdownToHtml(markdown, linkContext = null) {
+  // Strip YAML frontmatter before rendering so the fence block doesn't leak
+  // into the page as <hr>/<p>… text (#19). #18 made frontmatter mandatory on
+  // collection posts; this wires the same parser the collections generator
+  // already uses into the page render path so every caller benefits.
+  const parsed = parseFrontmatter(markdown);
+  markdown = parsed.body;
   const lines = markdown.replace(/\r\n/g, '\n').split('\n');
   const chunks = [];
   let inList = false;
@@ -1665,6 +1672,35 @@ async function ensureJavascriptModule(sourcePath, targetPath) {
   await fsp.copyFile(sourcePath, targetPath);
 }
 
+async function readMarkdownMetadata(sourcePath) {
+  const raw = await fsp.readFile(sourcePath, 'utf8');
+  const { data, body } = parseFrontmatter(raw);
+  return {
+    title: data.title || firstHeadingFromMarkdown(body) || null,
+    summary: data.summary || data.description || '',
+    date: data.date || null,
+    reading_time: estimateReadingTime(body)
+  };
+}
+
+function firstHeadingFromMarkdown(body) {
+  const match = body.match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : null;
+}
+
+function estimateReadingTime(body) {
+  const words = String(body || '').trim().split(/\s+/).filter(Boolean);
+  return Math.max(1, Math.ceil(words.length / 200));
+}
+
+async function readContentMetadata(sourcePath) {
+  const ext = path.extname(sourcePath).toLowerCase();
+  if (ext === '.md' || ext === '.markdown') {
+    return readMarkdownMetadata(sourcePath);
+  }
+  return {};
+}
+
 // ============================================================================
 // Internal Link Transformation (ADR-011)
 // ============================================================================
@@ -1985,6 +2021,46 @@ function deriveSectionId(parentId, name, isIndex = false) {
   return stem;
 }
 
+function routePath(value) {
+  return String(value || '').replace(/^\/+|\/+$/g, '');
+}
+
+function collectionForRelPath(relPath, collections = []) {
+  const normalized = relPath.split(path.sep).join('/');
+  return collections.find((collection) => {
+    const collectionPath = routePath(collection.path);
+    return collectionPath && (normalized === collectionPath || normalized.startsWith(`${collectionPath}/`));
+  }) || null;
+}
+
+function decorateCollectionEntry(entry, metadata, collection) {
+  if (!collection || !entry) return entry;
+  entry.collection = routePath(collection.path);
+  entry.showDate = collection.showDate === true;
+  entry.showSummary = collection.showSummary === true;
+  entry.showReadingTime = collection.showReadingTime !== false;
+  if (metadata.date) entry.date = metadata.date;
+  if (metadata.reading_time) entry.reading_time = metadata.reading_time;
+  return entry;
+}
+
+function sortCollectionEntries(entries, collection) {
+  if (!collection || !Array.isArray(entries)) return entries;
+  const sortBy = collection.sortBy || 'date';
+  const dir = (collection.order || 'desc').toLowerCase() === 'asc' ? 1 : -1;
+  entries.sort((a, b) => {
+    const av = a?.[sortBy];
+    const bv = b?.[sortBy];
+    if (av == null && bv == null) return 0;
+    if (av == null) return 1;
+    if (bv == null) return -1;
+    if (av < bv) return -1 * dir;
+    if (av > bv) return 1 * dir;
+    return 0;
+  });
+  return entries;
+}
+
 /**
  * Encode section ID for use in output filename
  * Replaces / with -- to create flat output structure
@@ -2100,19 +2176,21 @@ async function scanContentDirectory(dirPath, parentId, context, depth = 0) {
   const indexFile = files.find(f => /^index\.(md|markdown|html|htm|js|mjs)$/i.test(f.name));
   if (indexFile) {
     const sectionId = parentId || path.basename(dirPath);
-    const title = manifest?.title || humanizeTitle(path.basename(dirPath));
-    const summary = manifest?.summary || '';
-
-    // Calculate relative path from content root
     const relPath = path.relative(context.contentRoot, path.join(dirPath, indexFile.name));
+    const metadata = await readContentMetadata(path.join(dirPath, indexFile.name));
+    const collection = collectionForRelPath(relPath, context.collections);
+    const title = manifest?.title || metadata.title || humanizeTitle(path.basename(dirPath));
+    const summary = manifest?.summary || metadata.summary || '';
 
-    sections.push({
+    const sectionEntry = {
       id: sectionId,
       title,
       summary,
       file: relPath,
       _isIndex: true
-    });
+    };
+    decorateCollectionEntry(sectionEntry, metadata, collection);
+    sections.push(sectionEntry);
   }
 
   // Process other content files
@@ -2124,10 +2202,12 @@ async function scanContentDirectory(dirPath, parentId, context, depth = 0) {
       s.id === sectionId || s.file === file.name || s.id === file.name.replace(/\.[^.]+$/, '')
     );
 
-    const title = manifestEntry?.title || humanizeTitle(file.name);
-    const summary = manifestEntry?.summary || '';
-    const type = manifestEntry?.type || null;
     const relPath = path.relative(context.contentRoot, path.join(dirPath, file.name));
+    const metadata = await readContentMetadata(path.join(dirPath, file.name));
+    const collection = collectionForRelPath(relPath, context.collections);
+    const title = manifestEntry?.title || metadata.title || humanizeTitle(file.name);
+    const summary = manifestEntry?.summary || metadata.summary || '';
+    const type = manifestEntry?.type || null;
 
     const sectionEntry = {
       id: sectionId,
@@ -2135,6 +2215,7 @@ async function scanContentDirectory(dirPath, parentId, context, depth = 0) {
       summary,
       file: relPath
     };
+    decorateCollectionEntry(sectionEntry, metadata, collection);
     if (type) sectionEntry.type = type;
     sections.push(sectionEntry);
   }
@@ -2163,6 +2244,7 @@ async function scanContentDirectory(dirPath, parentId, context, depth = 0) {
       if (indexEntry) {
         // Remove index from subsections, it becomes the group itself
         const otherSections = subsections.filter(s => !s._isIndex);
+        sortCollectionEntries(otherSections, collectionForRelPath(path.relative(context.contentRoot, subdirPath), context.collections));
         const entry = {
           id: subdirId,
           title,
@@ -2178,7 +2260,7 @@ async function scanContentDirectory(dirPath, parentId, context, depth = 0) {
           id: subdirId,
           title,
           summary,
-          subsections
+          subsections: sortCollectionEntries(subsections, collectionForRelPath(path.relative(context.contentRoot, subdirPath), context.collections))
         };
         if (collapsed) entry.collapsed = true;
         sections.push(entry);
@@ -2434,7 +2516,7 @@ async function materializeScannedSections(sections, context) {
   const processed = [];
 
   for (const section of sections) {
-    const { id, title, summary, file, subsections, url, type, collapsed } = section;
+    const { id, title, summary, file, subsections, url, type, collapsed, _isIndex, ...metadata } = section;
 
     // Pass through external links without processing
     if (url) {
@@ -2492,21 +2574,22 @@ async function materializeScannedSections(sections, context) {
           id,
           title,
           summary,
-          module: `./sections/${outFile}`,
+          ...metadata,
+          module: `/sections/${outFile}`,
           subsections: processedSubsections
         };
         if (type) entry.type = type;
         if (collapsed) entry.collapsed = true;
         processed.push(entry);
       } else {
-        const entry = { id, title, summary, module: `./sections/${outFile}` };
+        const entry = { id, title, summary, ...metadata, module: `/sections/${outFile}` };
         if (type) entry.type = type;
         if (collapsed) entry.collapsed = true;
         processed.push(entry);
       }
     } else if (processedSubsections && processedSubsections.length > 0) {
       // Group without its own content
-      const entry = { id, title, summary, subsections: processedSubsections };
+      const entry = { id, title, summary, ...metadata, subsections: processedSubsections };
       if (type) entry.type = type;
       if (collapsed) entry.collapsed = true;
       processed.push(entry);
@@ -2568,6 +2651,9 @@ function applyManifestHierarchy(scannedSections, rootManifest) {
       title: mEntry.title || scanned?.title || mEntry.id,
       summary: mEntry.summary || scanned?.summary || ''
     };
+    for (const key of ['collection', 'showDate', 'showSummary', 'showReadingTime', 'date', 'reading_time']) {
+      if (scanned?.[key] !== undefined) node[key] = scanned[key];
+    }
 
     if (mEntry.collapsed) node.collapsed = true;
     if (mEntry.type) node.type = mEntry.type;
@@ -2664,6 +2750,7 @@ async function processNestedContent(sourceDir, distDir, tenantId, contentRoot, o
     keepFiles,
     leafOrder: [],
     siteConfig,
+    collections: Array.isArray(config.collections) ? config.collections : [],
     // Link transformation context (populated after scan)
     sectionIndex: null,
     linkWarnings,
@@ -2772,7 +2859,7 @@ async function materializeSectionModule(entry, context) {
   }
 
   const ext = path.extname(sourcePath).toLowerCase();
-  const outFile = `${id}.js`;
+  const outFile = `${encodePathForFilename(id)}.js`;
   const targetPath = path.join(context.sectionsDir, outFile);
   context.keepFiles.add(outFile);
 
@@ -2800,7 +2887,7 @@ async function materializeSectionModule(entry, context) {
     return null;
   }
 
-  return `./sections/${outFile}`;
+  return `/sections/${outFile}`;
 }
 
 function buildManifestModuleSource(manifestEntries, defaultSection, siteConfig = {}, exportConfig = {}) {
@@ -3332,7 +3419,7 @@ async function processIncrementalManifest(sourceDir, distDir, tenantId, changedF
     const ext = path.extname(sourcePath).toLowerCase();
     // Use manifest section ID if available, otherwise fall back to filename
     const sectionId = fileToSectionId.get(relPath) || path.basename(relPath, ext);
-    const targetPath = path.join(sectionsDir, `${sectionId}.js`);
+    const targetPath = path.join(sectionsDir, `${encodePathForFilename(sectionId)}.js`);
 
     try {
       if (ext === '.md' || ext === '.markdown') {
@@ -3342,7 +3429,8 @@ async function processIncrementalManifest(sourceDir, distDir, tenantId, changedF
           contentRoot: contentRoot.basePath || contentDir,
           sectionIndex,
           linkWarnings,
-          strictLinks: options.strictLinks !== false
+          strictLinks: options.strictLinks !== false,
+          collections: Array.isArray(config.collections) ? config.collections : []
         };
         await ensureMarkdownModule(sourcePath, targetPath, linkContext);
         console.log(`  ↳ updated: ${sectionId} (markdown)`);
@@ -3608,7 +3696,15 @@ async function main() {
   return results;
 }
 
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+// Only auto-run when this file is the process entrypoint, so unit tests can
+// import named exports (e.g. markdownToHtml — #19) without triggering main().
+const __isMainModule = process.argv[1]
+  && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (__isMainModule) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}
+
+export { markdownToHtml };

package/site/app.js

@@ -1 +1 @@
-import{MANIFEST as e,DEFAULT_SECTION as t,findSection as n,getAdjacentSections as a,SITE_CONFIG as s,EXPORT_CONFIG as o}from"./manifest.js";import{updateMetaTags as i}from"./seo.js";import{escapeRegExp as l,searchContent as c,flattenManifest as r,findPreferredIndex as d}from"./lib/search.js";import{resolveTarget as m,resolveEntry as p}from"./lib/router.js";import{composeExportDocument as u,collectExportableSections as v}from"./lib/export.js";import{renderMermaidBlocks as h}from"./mermaid-init.js";import{highlightCodeBlocks as f}from"./syntax-highlight.js";const y=document.getElementById("app"),g=document.getElementById("nav"),b=document.getElementById("year"),E=document.getElementById("exportBtn"),L=document.getElementById("commandToggle"),T=document.getElementById("commandPalette"),x=document.getElementById("commandInput"),N=document.getElementById("commandList"),w=document.getElementById("mobileMenuToggle"),C=document.querySelector(".sidebar"),k="docs-toolkit-command-query",$=new Map,H=new Map,I=new Map,M=new Set;let A=[],S=0,P=!1,q=(localStorage.getItem(k)||"").trim(),B=!1;function R(e,t){const n=document.createElement("a");return n.href=e.url,n.target="_blank",n.rel="noopener noreferrer",n.className=`${t} nav-external`,n.title=e.summary||e.title,n.innerHTML=`\n    <span class="nav-title">${e.title}<span class="nav-external-icon" aria-label="(opens in new tab)">↗</span></span>\n    ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n  `,n}function F(e,t={}){const{scrollToHighlight:a=!1}=t,{targetId:s,parentId:o}=function(e){return m(e,n)}(e);P&&_(),o&&j(o,!0),B=a||Boolean(q),location.hash.replace("#","")===s?O():location.hash=`#${s}`}function D(){return location.hash.replace("#","")||t}async function O(){const e=D(),t=p(e,n);if(!t)return;const{entry:o,targetId:l,parentId:c}=t;l===e?(c&&j(c,!0),function(e,t=null){H.forEach(e=>{e.setAttribute("aria-current","false")});const n=H.get(e);if(n&&n.setAttribute("aria-current","page"),t){const e=H.get(t);e&&e.setAttribute("aria-current","page")}}(o.id,c),await async function(e){if(!e)return;const t=await import(e.module),n=t.load||t.default;if("function"!=typeof n)return void(y.innerHTML='<article class="section"><p>Section failed to load.</p></article>');const o=await n();y.innerHTML=o.html||"",await h(y),await f(y),function(e){const t=y.querySelector(".bottom-nav");if(t&&t.remove(),"never"===s.bottomNav)return;const n=(s.bottomNavSections||[]).some(t=>e.startsWith(t)),o="mobile"===s.bottomNav&&!n,{prev:i,next:l}=a(e);if(!i&&!l)return;const c=document.createElement("nav");if(c.className="bottom-nav",o&&c.classList.add("mobile-only"),i){const e=document.createElement("div");e.className="bottom-nav-item bottom-nav-prev",e.innerHTML='<span class="bottom-nav-chevron">‹</span>';const t=document.createElement("a");t.href=`#${i.id}`,t.className="bottom-nav-link",t.title=`Previous: ${i.title}`,t.textContent=i.title,t.addEventListener("click",e=>{e.preventDefault(),F(i.id)}),e.appendChild(t),c.appendChild(e)}else{const e=document.createElement("div");e.className="bottom-nav-spacer",c.appendChild(e)}if(l){const e=document.createElement("div");e.className="bottom-nav-item bottom-nav-next";const t=document.createElement("a");t.href=`#${l.id}`,t.className="bottom-nav-link",t.title=`Next: ${l.title}`,t.textContent=l.title,t.addEventListener("click",e=>{e.preventDefault(),F(l.id)}),e.appendChild(t),e.innerHTML+='<span class="bottom-nav-chevron">›</span>',c.appendChild(e)}(y.querySelector("section")||y).appendChild(c)}(e.id),y.scrollTop=0,window.scrollTo(0,0),"function"==typeof o.afterRender&&o.afterRender(y),i({title:e.title,description:e.summary,siteTitle:s.siteTitle,siteUrl:s.siteUrl,sectionId:e.id,ogImage:e.ogImage||s.ogImage}),$.set(e.id,Date.now());const l=B;B=!1,K(l),requestAnimationFrame(()=>y.focus())}(o)):location.replace(`#${l}`)}function j(e,t){if(!e)return;const n=I.get(e);t?(M.add(e),n&&n.group.classList.add("expanded")):(M.delete(e),n&&n.group.classList.remove("expanded"))}function W(){if(!T||!x)return;P=!0,T.hidden=!1;const e=q;x.value=e,z(e),requestAnimationFrame(()=>{x.focus(),e&&x.select()})}function _(){T&&x&&(P=!1,T.hidden=!0,x.blur())}!function(){g.innerHTML="",H.clear(),I.clear();let t=M.size>0;e.forEach((e,n)=>{if(e.url){const t=R(e,"nav-leaf");return void g.appendChild(t)}if(e.subsections&&e.subsections.length){const n=document.createElement("div");n.className="nav-group";const a=Boolean(e.module),s=document.createElement("button");s.type="button",s.className="nav-parent"+(a?" nav-parent-with-content":""),s.dataset.section=e.id,s.title=e.summary,a?(s.innerHTML=`\n          <span class="nav-title-link">${e.title}</span>\n          <span class="nav-expand-toggle" aria-label="Expand"></span>\n          ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n        `,s.querySelector(".nav-title-link").addEventListener("click",t=>{t.stopPropagation(),F(e.id,{scrollToHighlight:Boolean(q)})}),s.querySelector(".nav-expand-toggle").addEventListener("click",t=>{t.stopPropagation();const n=!M.has(e.id);j(e.id,n)}),s.addEventListener("click",t=>{if(t.target===s){const t=!M.has(e.id);j(e.id,t)}})):(s.innerHTML=`\n          <span class="nav-title">${e.title}</span>\n          ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n        `,s.addEventListener("click",()=>{const t=!M.has(e.id);j(e.id,t)}));const o=document.createElement("div");o.className="nav-sublist",e.subsections.forEach(e=>{if(e.url){const t=R(e,"nav-item");return void o.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-nested";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-nested",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);j(e.id,t)});const a=document.createElement("div");a.className="nav-sublist nav-sublist-nested",e.subsections.forEach(e=>{if(e.url){const t=R(e,"nav-item");return void a.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-deep";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-deep",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);j(e.id,t)});const s=document.createElement("div");s.className="nav-sublist nav-sublist-deep",e.subsections.forEach(e=>{if(e.url){const t=R(e,"nav-item");return void s.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-ultra";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-ultra",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);j(e.id,t)});const a=document.createElement("div");a.className="nav-sublist nav-sublist-ultra",e.subsections.forEach(e=>{if(e.url){const t=R(e,"nav-item");return void a.appendChild(t)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-ultra"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n                      <span class="nav-title">${e.title}</span>\n                      <span class="nav-summary">${e.summary||""}</span>\n                    `,t.addEventListener("click",()=>F(e.id,{scrollToHighlight:Boolean(q)})),a.appendChild(t),H.set(e.id,t)}),t.append(n,a),s.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:a});const o=M.has(e.id)&&!e.collapsed;return void j(e.id,o)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-deep"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n                  <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n                  <span class="nav-summary">${e.summary||""}</span>\n                `,t.addEventListener("click",()=>F(e.id,{scrollToHighlight:Boolean(q)})),s.appendChild(t),H.set(e.id,t)}),t.append(n,s),a.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:s});const o=M.has(e.id)&&!e.collapsed;return void j(e.id,o)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-nested"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n              <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n              <span class="nav-summary">${e.summary||""}</span>\n            `,t.addEventListener("click",()=>F(e.id,{scrollToHighlight:Boolean(q)})),a.appendChild(t),H.set(e.id,t)}),t.append(n,a),o.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:a});const s=M.has(e.id)&&!e.collapsed;return void j(e.id,s)}const t=document.createElement("button");t.type="button",t.className="nav-item"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary,t.innerHTML=`\n          <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n          <span class="nav-summary">${e.summary}</span>\n        `,t.addEventListener("click",()=>F(e.id,{scrollToHighlight:Boolean(q)})),o.appendChild(t),H.set(e.id,t)}),n.append(s,o),g.appendChild(n),H.set(e.id,s),I.set(e.id,{group:n,button:s,list:o});const i=!e.collapsed&&(M.has(e.id)||!t&&!M.size);j(e.id,i),i&&(t=!0)}else{const t=document.createElement("button");t.type="button",t.className="nav-leaf"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary,t.innerHTML=`\n        <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n        <span class="nav-summary">${e.summary}</span>\n      `,t.addEventListener("click",()=>F(e.id,{scrollToHighlight:Boolean(q)})),g.appendChild(t),H.set(e.id,t)}})}(),q&&(B=!0),window.addEventListener("hashchange",()=>{q&&(B=!0),O()}),b.textContent=(new Date).getFullYear(),O(),L&&T&&x&&N&&(L.addEventListener("click",()=>{P?_():W()}),x.addEventListener("input",()=>{const e=x.value;J(e,!0),z(e)}),x.addEventListener("keydown",e=>{const t=A.length-1;if("ArrowDown"===e.key)e.preventDefault(),S=Math.min(t,S+1),X();else if("ArrowUp"===e.key)e.preventDefault(),S=Math.max(0,S-1),X();else if("Enter"===e.key){e.preventDefault();const t=A[S];t&&(J(x.value,!0),F(t.id,{scrollToHighlight:!0}),_())}else"Escape"===e.key&&(e.preventDefault(),_())}),N.addEventListener("click",e=>{const t=e.target.closest("[data-section]");if(!t)return;const n=t.dataset.section;n&&(J(x.value,!0),F(n,{scrollToHighlight:!0}),_())}),T.addEventListener("click",e=>{e.target===T&&_()}),window.addEventListener("keydown",e=>{const t=e.target,n=t&&("INPUT"===t.tagName||"TEXTAREA"===t.tagName||t.isContentEditable),a=e.metaKey||e.ctrlKey;"k"===e.key.toLowerCase()&&a||"/"===e.key&&!n?(e.preventDefault(),P?_():W()):"Escape"===e.key&&P&&(e.preventDefault(),_())}));let V=null,U=!1;async function z(t){N&&(!U&&t.trim()&&(U=!0,N.innerHTML='<li class="cmd-item cmd-loading">Indexing content...</li>'),clearTimeout(V),V=setTimeout(async()=>{A=await c(e,t);const n=D();S=d(A,n),function(){if(N){if(N.innerHTML="",!A.length){const e=document.createElement("li");return e.className="cmd-item",e.setAttribute("aria-selected","false"),e.textContent="No matches.",void N.appendChild(e)}A.forEach(e=>{const t=document.createElement("li");t.className="cmd-item",t.dataset.section=e.id,t.setAttribute("role","option");const n=document.createElement("span");if(n.className="cmd-item-title",n.textContent=e.title,e.group){const t=document.createElement("span");t.className="cmd-item-group",t.textContent=e.group,n.prepend(t)}const a=document.createElement("span");a.className="cmd-item-summary",a.textContent=e.summary||"",t.append(n,a),N.appendChild(t)})}}(),X(),U=!1},t.trim()?150:0))}function X(){N&&Array.from(N.children).forEach((e,t)=>{const n=t===S&&A.length;e.setAttribute("aria-selected",n?"true":"false"),n&&e.scrollIntoView({block:"nearest"})})}function G(e){const t=document.createElement("div");t.innerHTML=e,t.querySelectorAll("script").forEach(e=>e.remove()),t.querySelectorAll("button").forEach(e=>e.removeAttribute("onclick")),t.querySelectorAll("mark.hl").forEach(e=>{const t=document.createTextNode(e.textContent||"");e.replaceWith(t)});const n=t.querySelector("section");return n?n.innerHTML:t.innerHTML}function J(e,t=!1){q=e.trim(),t&&(q?localStorage.setItem(k,q):localStorage.removeItem(k)),K()}function K(e=!1){y&&function(e,t,{scrollToFirst:n=!1}={}){if(!e)return;if(function(e){e&&e.querySelectorAll("mark.hl").forEach(e=>{const t=document.createTextNode(e.textContent||"");e.replaceWith(t)})}(e),!t)return;const a=t.split(/\s+/).map(e=>e.trim()).filter(Boolean);if(!a.length)return;const s=a.map(e=>e.toLowerCase()),o=new Set(["SCRIPT","STYLE","CODE","PRE"]),i=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,{acceptNode(e){if(!e.nodeValue||!e.nodeValue.trim())return NodeFilter.FILTER_REJECT;const t=e.parentNode;return t&&o.has(t.tagName)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT}}),c=[];let r;for(;r=i.nextNode();){const e=r.nodeValue.toLowerCase();s.some(t=>e.includes(t))&&c.push(r)}const d=new RegExp(`(${a.map(l).join("|")})`,"gi");c.forEach(e=>{const t=e.nodeValue,n=[];let a=0;t.replace(d,(e,s,o)=>{o>a&&n.push(document.createTextNode(t.slice(a,o)));const i=document.createElement("mark");return i.className="hl",i.textContent=e,n.push(i),a=o+e.length,e}),a<t.length&&n.push(document.createTextNode(t.slice(a)));const s=document.createDocumentFragment();n.forEach(e=>s.appendChild(e)),e.parentNode.replaceChild(s,e)}),n&&requestAnimationFrame(()=>{const t=e.querySelector("mark.hl");t&&t.scrollIntoView({behavior:"smooth",block:"center"})})}(y,q,{scrollToFirst:e})}E&&E.addEventListener("click",function(){const t=document.createElement("div");t.className="export-options-overlay",t.innerHTML='\n    <div class="export-options-modal">\n      <div class="export-options-header">EXPORT OPTIONS</div>\n      <div class="export-options-buttons">\n        <button type="button" class="export-option-btn" data-scope="page">\n          <span class="export-option-title">Current Page</span>\n          <span class="export-option-desc">Export only this section</span>\n        </button>\n        <button type="button" class="export-option-btn" data-scope="site">\n          <span class="export-option-title">Entire Site</span>\n          <span class="export-option-desc">Export all documentation</span>\n        </button>\n      </div>\n      <button type="button" class="export-cancel-btn">Cancel</button>\n    </div>\n  ',document.body.appendChild(t),setTimeout(()=>t.classList.add("active"),10);const n=()=>{t.classList.remove("active"),setTimeout(()=>t.remove(),200)};t.querySelector(".export-cancel-btn").addEventListener("click",n),t.addEventListener("click",e=>{e.target===t&&n()}),t.querySelectorAll(".export-option-btn").forEach(t=>{t.addEventListener("click",()=>{const a=t.dataset.scope;n(),async function(t="site"){if(!E)return;const n=E.innerHTML,a=window.open("","_blank","width=1,height=1,left=0,top=0");if(!a||a.closed||void 0===a.closed)return void confirm("Pop-ups are blocked. Please allow pop-ups for this site to export the document.\n\nWould you like to try again after enabling pop-ups?");a.close(),E.disabled=!0;const s=document.createElement("div");s.className="export-loading-overlay",s.innerHTML='\n    <div class="export-loading-modal">\n      <div class="export-loading-header">\n        <div class="export-loading-title">COMPILING DOCUMENTATION</div>\n        <div class="export-loading-subtitle">Assembling all sections into unified document</div>\n      </div>\n      <div class="export-loading-progress">\n        <div class="export-loading-bar">\n          <div class="export-loading-fill"></div>\n        </div>\n        <div class="export-loading-status-container">\n          <div class="export-loading-status">Initializing...</div>\n        </div>\n      </div>\n      <div class="export-loading-scanner">\n        <div class="scanner-line"></div>\n      </div>\n    </div>\n  ',document.body.appendChild(s),setTimeout(()=>s.classList.add("active"),10);const i=s.querySelector(".export-loading-fill"),l=s.querySelector(".export-loading-status");try{let n;if("page"===t){const t=D(),a=v(e).find(e=>e.id===t);n=a?[a]:[]}else n=v(e);if(0===n.length)return alert("No content available to export."),s.remove(),void(E.disabled=!1);const a=[],c=n.length;let r=0;for(const e of n){r++;const n=r/c*100;i.style.width=`${n}%`,l.textContent="page"===t?`Exporting: ${e.title}`:`Processing section ${r} of ${c}: ${e.title}`,await new Promise(e=>setTimeout(e,50));try{const t=await import(e.module),n=t.load||t.default;if("function"!=typeof n)continue;const s=G((await n()).html||"");a.push({section:e,html:s})}catch(t){console.error("Failed to include section in export",e.id,t)}}l.textContent="Generating document...",await new Promise(e=>setTimeout(e,200));const d=u(a,o);l.textContent="Opening document viewer...",await new Promise(e=>setTimeout(e,100));const m=window.open("","_blank","width=900,height=860,scrollbars=yes,resizable=yes");if(!m)return alert("Please allow pop-ups to export the document."),void s.remove();m.document.open(),m.document.write(d),m.document.close(),m.focus(),s.classList.remove("active"),setTimeout(()=>s.remove(),300)}catch(e){console.error("Export failed",e),alert("Export failed. Check console for details."),s.remove()}finally{E.disabled=!1,E.innerHTML=n}}(a)})})}),w&&C&&(w.addEventListener("click",()=>{C.classList.contains("mobile-open")?(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),w.setAttribute("aria-expanded","false")):(C.classList.add("mobile-open"),document.body.classList.add("menu-open"),w.setAttribute("aria-expanded","true"))}),g.addEventListener("click",e=>{if(window.innerWidth<=960){const t=e.target.closest(".nav-item, .nav-leaf, .nav-parent");t&&(t.classList.contains("nav-item")||t.classList.contains("nav-leaf"))&&(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),w.setAttribute("aria-expanded","false"))}}),document.addEventListener("click",e=>{window.innerWidth<=960&&C.classList.contains("mobile-open")&&!C.contains(e.target)&&!w.contains(e.target)&&(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),w.setAttribute("aria-expanded","false"))}));
+import{MANIFEST as e,DEFAULT_SECTION as t,findSection as n,getAdjacentSections as a,SITE_CONFIG as s,EXPORT_CONFIG as o}from"./manifest.js";import{updateMetaTags as i}from"./seo.js";import{escapeRegExp as l,searchContent as r,flattenManifest as c,findPreferredIndex as d}from"./lib/search.js";import{resolveTarget as m,resolveEntry as p}from"./lib/router.js";import{composeExportDocument as u,collectExportableSections as v}from"./lib/export.js";import{renderMermaidBlocks as h}from"./mermaid-init.js";import{highlightCodeBlocks as f}from"./syntax-highlight.js";const y=document.getElementById("app"),g=document.getElementById("nav"),b=document.getElementById("year"),E=document.getElementById("exportBtn"),L=document.getElementById("commandToggle"),T=document.getElementById("commandPalette"),x=document.getElementById("commandInput"),w=document.getElementById("commandList"),N=document.getElementById("mobileMenuToggle"),C=document.querySelector(".sidebar"),k="docs-toolkit-command-query",$=new Map,H=new Map,I=new Map,M=new Set;let S=[],A=0,P=!1,q=(localStorage.getItem(k)||"").trim(),B=!1;function D(e,t){const n=document.createElement("a");return n.href=e.url,n.target="_blank",n.rel="noopener noreferrer",n.className=`${t} nav-external`,n.title=e.summary||e.title,n.innerHTML=`\n    <span class="nav-title">${e.title}<span class="nav-external-icon" aria-label="(opens in new tab)">↗</span></span>\n    ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n  `,n}function R(e,t={}){const{scrollToHighlight:a=!1}=t,{targetId:s,parentId:o}=function(e){return m(e,n)}(e);P&&W(),o&&O(o,!0),B=a||Boolean(q),location.hash.replace("#","")===s?j():location.hash=`#${s}`}function F(){return location.hash.replace("#","")||t}async function j(){const e=F(),t=p(e,n);if(!t)return;const{entry:o,targetId:l,parentId:r}=t;l===e?(r&&O(r,!0),function(e,t=null){H.forEach(e=>{e.setAttribute("aria-current","false")});const n=H.get(e);if(n&&n.setAttribute("aria-current","page"),t){const e=H.get(t);e&&e.setAttribute("aria-current","page")}}(o.id,r),await async function(e){if(!e)return;const t=await import(e.module),n=t.load||t.default;if("function"!=typeof n)return void(y.innerHTML='<article class="section"><p>Section failed to load.</p></article>');const o=await n();y.innerHTML=o.html||"",function(e){if(!e||!e.showDate&&!e.showReadingTime&&!e.showSummary)return;const t=(y.querySelector(".doc-content")||y.querySelector("article, section")||y).querySelector("h1");if(!t)return;const n=[];e.showDate&&e.date&&n.push(function(e){const t=String(e||"").trim();if(!t)return"";const n=/^\d{4}-\d{2}-\d{2}$/.test(t)?`${t}T00:00:00Z`:t,a=new Date(n);return Number.isNaN(a.getTime())?t:new Intl.DateTimeFormat(void 0,{year:"numeric",month:"long",day:"numeric",timeZone:"UTC"}).format(a)}(e.date)),e.showReadingTime&&e.reading_time&&n.push(`${e.reading_time} min read`);let a=t;if(n.length>0){const e=document.createElement("p");e.className="doc-meta",e.textContent=n.join(" · "),t.after(e),a=e}if(e.showSummary&&e.summary){const t=document.createElement("p");t.className="doc-summary",t.textContent=e.summary,a.after(t)}}(e),await h(y),await f(y),function(e){const t=y.querySelector(".bottom-nav");if(t&&t.remove(),"never"===s.bottomNav)return;const n=(s.bottomNavSections||[]).some(t=>e.startsWith(t)),o="mobile"===s.bottomNav&&!n,{prev:i,next:l}=a(e);if(!i&&!l)return;const r=document.createElement("nav");if(r.className="bottom-nav",o&&r.classList.add("mobile-only"),i){const e=document.createElement("div");e.className="bottom-nav-item bottom-nav-prev",e.innerHTML='<span class="bottom-nav-chevron">‹</span>';const t=document.createElement("a");t.href=`#${i.id}`,t.className="bottom-nav-link",t.title=`Previous: ${i.title}`,t.textContent=i.title,t.addEventListener("click",e=>{e.preventDefault(),R(i.id)}),e.appendChild(t),r.appendChild(e)}else{const e=document.createElement("div");e.className="bottom-nav-spacer",r.appendChild(e)}if(l){const e=document.createElement("div");e.className="bottom-nav-item bottom-nav-next";const t=document.createElement("a");t.href=`#${l.id}`,t.className="bottom-nav-link",t.title=`Next: ${l.title}`,t.textContent=l.title,t.addEventListener("click",e=>{e.preventDefault(),R(l.id)}),e.appendChild(t),e.innerHTML+='<span class="bottom-nav-chevron">›</span>',r.appendChild(e)}(y.querySelector("section")||y).appendChild(r)}(e.id),y.scrollTop=0,window.scrollTo(0,0),"function"==typeof o.afterRender&&o.afterRender(y),i({title:e.title,description:e.summary,siteTitle:s.siteTitle,siteUrl:s.siteUrl,sectionId:e.id,ogImage:e.ogImage||s.ogImage}),$.set(e.id,Date.now());const l=B;B=!1,K(l),requestAnimationFrame(()=>y.focus())}(o)):location.replace(`#${l}`)}function O(e,t){if(!e)return;const n=I.get(e);t?(M.add(e),n&&n.group.classList.add("expanded")):(M.delete(e),n&&n.group.classList.remove("expanded"))}function _(){if(!T||!x)return;P=!0,T.hidden=!1;const e=q;x.value=e,z(e),requestAnimationFrame(()=>{x.focus(),e&&x.select()})}function W(){T&&x&&(P=!1,T.hidden=!0,x.blur())}!function(){g.innerHTML="",H.clear(),I.clear();let t=M.size>0;e.forEach((e,n)=>{if(e.url){const t=D(e,"nav-leaf");return void g.appendChild(t)}if(e.subsections&&e.subsections.length){const n=document.createElement("div");n.className="nav-group";const a=Boolean(e.module),s=document.createElement("button");s.type="button",s.className="nav-parent"+(a?" nav-parent-with-content":""),s.dataset.section=e.id,s.title=e.summary,a?(s.innerHTML=`\n          <span class="nav-title-link">${e.title}</span>\n          <span class="nav-expand-toggle" aria-label="Expand"></span>\n          ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n        `,s.querySelector(".nav-title-link").addEventListener("click",t=>{t.stopPropagation(),R(e.id,{scrollToHighlight:Boolean(q)})}),s.querySelector(".nav-expand-toggle").addEventListener("click",t=>{t.stopPropagation();const n=!M.has(e.id);O(e.id,n)}),s.addEventListener("click",t=>{if(t.target===s){const t=!M.has(e.id);O(e.id,t)}})):(s.innerHTML=`\n          <span class="nav-title">${e.title}</span>\n          ${e.summary?`<span class="nav-summary">${e.summary}</span>`:""}\n        `,s.addEventListener("click",()=>{const t=!M.has(e.id);O(e.id,t)}));const o=document.createElement("div");o.className="nav-sublist",e.subsections.forEach(e=>{if(e.url){const t=D(e,"nav-item");return void o.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-nested";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-nested",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);O(e.id,t)});const a=document.createElement("div");a.className="nav-sublist nav-sublist-nested",e.subsections.forEach(e=>{if(e.url){const t=D(e,"nav-item");return void a.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-deep";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-deep",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);O(e.id,t)});const s=document.createElement("div");s.className="nav-sublist nav-sublist-deep",e.subsections.forEach(e=>{if(e.url){const t=D(e,"nav-item");return void s.appendChild(t)}if(e.subsections&&e.subsections.length){const t=document.createElement("div");t.className="nav-group nav-group-ultra";const n=document.createElement("button");n.type="button",n.className="nav-parent nav-parent-ultra",n.dataset.section=e.id,n.title=e.summary||e.title,n.innerHTML=`<span class="nav-title">${e.title}</span>`,n.addEventListener("click",()=>{const t=!M.has(e.id);O(e.id,t)});const a=document.createElement("div");a.className="nav-sublist nav-sublist-ultra",e.subsections.forEach(e=>{if(e.url){const t=D(e,"nav-item");return void a.appendChild(t)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-ultra"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n                      <span class="nav-title">${e.title}</span>\n                      <span class="nav-summary">${e.summary||""}</span>\n                    `,t.addEventListener("click",()=>R(e.id,{scrollToHighlight:Boolean(q)})),a.appendChild(t),H.set(e.id,t)}),t.append(n,a),s.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:a});const o=M.has(e.id)&&!e.collapsed;return void O(e.id,o)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-deep"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n                  <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n                  <span class="nav-summary">${e.summary||""}</span>\n                `,t.addEventListener("click",()=>R(e.id,{scrollToHighlight:Boolean(q)})),s.appendChild(t),H.set(e.id,t)}),t.append(n,s),a.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:s});const o=M.has(e.id)&&!e.collapsed;return void O(e.id,o)}const t=document.createElement("button");t.type="button",t.className="nav-item nav-item-nested"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary||e.title,t.innerHTML=`\n              <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n              <span class="nav-summary">${e.summary||""}</span>\n            `,t.addEventListener("click",()=>R(e.id,{scrollToHighlight:Boolean(q)})),a.appendChild(t),H.set(e.id,t)}),t.append(n,a),o.appendChild(t),H.set(e.id,n),I.set(e.id,{group:t,button:n,list:a});const s=M.has(e.id)&&!e.collapsed;return void O(e.id,s)}const t=document.createElement("button");t.type="button",t.className="nav-item"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary,t.innerHTML=`\n          <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n          <span class="nav-summary">${e.summary}</span>\n        `,t.addEventListener("click",()=>R(e.id,{scrollToHighlight:Boolean(q)})),o.appendChild(t),H.set(e.id,t)}),n.append(s,o),g.appendChild(n),H.set(e.id,s),I.set(e.id,{group:n,button:s,list:o});const i=!e.collapsed&&(M.has(e.id)||!t&&!M.size);O(e.id,i),i&&(t=!0)}else{const t=document.createElement("button");t.type="button",t.className="nav-leaf"+(e.type?` nav-type-${e.type}`:""),t.dataset.section=e.id,t.title=e.summary,t.innerHTML=`\n        <span class="nav-title">${e.title}${"press-release"===e.type?'<span class="nav-type-icon" aria-label="Press Release"></span>':""}</span>\n        <span class="nav-summary">${e.summary}</span>\n      `,t.addEventListener("click",()=>R(e.id,{scrollToHighlight:Boolean(q)})),g.appendChild(t),H.set(e.id,t)}})}(),q&&(B=!0),window.addEventListener("hashchange",()=>{q&&(B=!0),j()}),b.textContent=(new Date).getFullYear(),j(),L&&T&&x&&w&&(L.addEventListener("click",()=>{P?W():_()}),x.addEventListener("input",()=>{const e=x.value;J(e,!0),z(e)}),x.addEventListener("keydown",e=>{const t=S.length-1;if("ArrowDown"===e.key)e.preventDefault(),A=Math.min(t,A+1),X();else if("ArrowUp"===e.key)e.preventDefault(),A=Math.max(0,A-1),X();else if("Enter"===e.key){e.preventDefault();const t=S[A];t&&(J(x.value,!0),R(t.id,{scrollToHighlight:!0}),W())}else"Escape"===e.key&&(e.preventDefault(),W())}),w.addEventListener("click",e=>{const t=e.target.closest("[data-section]");if(!t)return;const n=t.dataset.section;n&&(J(x.value,!0),R(n,{scrollToHighlight:!0}),W())}),T.addEventListener("click",e=>{e.target===T&&W()}),window.addEventListener("keydown",e=>{const t=e.target,n=t&&("INPUT"===t.tagName||"TEXTAREA"===t.tagName||t.isContentEditable),a=e.metaKey||e.ctrlKey;"k"===e.key.toLowerCase()&&a||"/"===e.key&&!n?(e.preventDefault(),P?W():_()):"Escape"===e.key&&P&&(e.preventDefault(),W())}));let U=null,V=!1;async function z(t){w&&(!V&&t.trim()&&(V=!0,w.innerHTML='<li class="cmd-item cmd-loading">Indexing content...</li>'),clearTimeout(U),U=setTimeout(async()=>{S=await r(e,t);const n=F();A=d(S,n),function(){if(w){if(w.innerHTML="",!S.length){const e=document.createElement("li");return e.className="cmd-item",e.setAttribute("aria-selected","false"),e.textContent="No matches.",void w.appendChild(e)}S.forEach(e=>{const t=document.createElement("li");t.className="cmd-item",t.dataset.section=e.id,t.setAttribute("role","option");const n=document.createElement("span");if(n.className="cmd-item-title",n.textContent=e.title,e.group){const t=document.createElement("span");t.className="cmd-item-group",t.textContent=e.group,n.prepend(t)}const a=document.createElement("span");a.className="cmd-item-summary",a.textContent=e.summary||"",t.append(n,a),w.appendChild(t)})}}(),X(),V=!1},t.trim()?150:0))}function X(){w&&Array.from(w.children).forEach((e,t)=>{const n=t===A&&S.length;e.setAttribute("aria-selected",n?"true":"false"),n&&e.scrollIntoView({block:"nearest"})})}function G(e){const t=document.createElement("div");t.innerHTML=e,t.querySelectorAll("script").forEach(e=>e.remove()),t.querySelectorAll("button").forEach(e=>e.removeAttribute("onclick")),t.querySelectorAll("mark.hl").forEach(e=>{const t=document.createTextNode(e.textContent||"");e.replaceWith(t)});const n=t.querySelector("section");return n?n.innerHTML:t.innerHTML}function J(e,t=!1){q=e.trim(),t&&(q?localStorage.setItem(k,q):localStorage.removeItem(k)),K()}function K(e=!1){y&&function(e,t,{scrollToFirst:n=!1}={}){if(!e)return;if(function(e){e&&e.querySelectorAll("mark.hl").forEach(e=>{const t=document.createTextNode(e.textContent||"");e.replaceWith(t)})}(e),!t)return;const a=t.split(/\s+/).map(e=>e.trim()).filter(Boolean);if(!a.length)return;const s=a.map(e=>e.toLowerCase()),o=new Set(["SCRIPT","STYLE","CODE","PRE"]),i=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,{acceptNode(e){if(!e.nodeValue||!e.nodeValue.trim())return NodeFilter.FILTER_REJECT;const t=e.parentNode;return t&&o.has(t.tagName)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT}}),r=[];let c;for(;c=i.nextNode();){const e=c.nodeValue.toLowerCase();s.some(t=>e.includes(t))&&r.push(c)}const d=new RegExp(`(${a.map(l).join("|")})`,"gi");r.forEach(e=>{const t=e.nodeValue,n=[];let a=0;t.replace(d,(e,s,o)=>{o>a&&n.push(document.createTextNode(t.slice(a,o)));const i=document.createElement("mark");return i.className="hl",i.textContent=e,n.push(i),a=o+e.length,e}),a<t.length&&n.push(document.createTextNode(t.slice(a)));const s=document.createDocumentFragment();n.forEach(e=>s.appendChild(e)),e.parentNode.replaceChild(s,e)}),n&&requestAnimationFrame(()=>{const t=e.querySelector("mark.hl");t&&t.scrollIntoView({behavior:"smooth",block:"center"})})}(y,q,{scrollToFirst:e})}E&&E.addEventListener("click",function(){const t=document.createElement("div");t.className="export-options-overlay",t.innerHTML='\n    <div class="export-options-modal">\n      <div class="export-options-header">EXPORT OPTIONS</div>\n      <div class="export-options-buttons">\n        <button type="button" class="export-option-btn" data-scope="page">\n          <span class="export-option-title">Current Page</span>\n          <span class="export-option-desc">Export only this section</span>\n        </button>\n        <button type="button" class="export-option-btn" data-scope="site">\n          <span class="export-option-title">Entire Site</span>\n          <span class="export-option-desc">Export all documentation</span>\n        </button>\n      </div>\n      <button type="button" class="export-cancel-btn">Cancel</button>\n    </div>\n  ',document.body.appendChild(t),setTimeout(()=>t.classList.add("active"),10);const n=()=>{t.classList.remove("active"),setTimeout(()=>t.remove(),200)};t.querySelector(".export-cancel-btn").addEventListener("click",n),t.addEventListener("click",e=>{e.target===t&&n()}),t.querySelectorAll(".export-option-btn").forEach(t=>{t.addEventListener("click",()=>{const a=t.dataset.scope;n(),async function(t="site"){if(!E)return;const n=E.innerHTML,a=window.open("","_blank","width=1,height=1,left=0,top=0");if(!a||a.closed||void 0===a.closed)return void confirm("Pop-ups are blocked. Please allow pop-ups for this site to export the document.\n\nWould you like to try again after enabling pop-ups?");a.close(),E.disabled=!0;const s=document.createElement("div");s.className="export-loading-overlay",s.innerHTML='\n    <div class="export-loading-modal">\n      <div class="export-loading-header">\n        <div class="export-loading-title">COMPILING DOCUMENTATION</div>\n        <div class="export-loading-subtitle">Assembling all sections into unified document</div>\n      </div>\n      <div class="export-loading-progress">\n        <div class="export-loading-bar">\n          <div class="export-loading-fill"></div>\n        </div>\n        <div class="export-loading-status-container">\n          <div class="export-loading-status">Initializing...</div>\n        </div>\n      </div>\n      <div class="export-loading-scanner">\n        <div class="scanner-line"></div>\n      </div>\n    </div>\n  ',document.body.appendChild(s),setTimeout(()=>s.classList.add("active"),10);const i=s.querySelector(".export-loading-fill"),l=s.querySelector(".export-loading-status");try{let n;if("page"===t){const t=F(),a=v(e).find(e=>e.id===t);n=a?[a]:[]}else n=v(e);if(0===n.length)return alert("No content available to export."),s.remove(),void(E.disabled=!1);const a=[],r=n.length;let c=0;for(const e of n){c++;const n=c/r*100;i.style.width=`${n}%`,l.textContent="page"===t?`Exporting: ${e.title}`:`Processing section ${c} of ${r}: ${e.title}`,await new Promise(e=>setTimeout(e,50));try{const t=await import(e.module),n=t.load||t.default;if("function"!=typeof n)continue;const s=G((await n()).html||"");a.push({section:e,html:s})}catch(t){console.error("Failed to include section in export",e.id,t)}}l.textContent="Generating document...",await new Promise(e=>setTimeout(e,200));const d=u(a,o);l.textContent="Opening document viewer...",await new Promise(e=>setTimeout(e,100));const m=window.open("","_blank","width=900,height=860,scrollbars=yes,resizable=yes");if(!m)return alert("Please allow pop-ups to export the document."),void s.remove();m.document.open(),m.document.write(d),m.document.close(),m.focus(),s.classList.remove("active"),setTimeout(()=>s.remove(),300)}catch(e){console.error("Export failed",e),alert("Export failed. Check console for details."),s.remove()}finally{E.disabled=!1,E.innerHTML=n}}(a)})})}),N&&C&&(N.addEventListener("click",()=>{C.classList.contains("mobile-open")?(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),N.setAttribute("aria-expanded","false")):(C.classList.add("mobile-open"),document.body.classList.add("menu-open"),N.setAttribute("aria-expanded","true"))}),g.addEventListener("click",e=>{if(window.innerWidth<=960){const t=e.target.closest(".nav-item, .nav-leaf, .nav-parent");t&&(t.classList.contains("nav-item")||t.classList.contains("nav-leaf"))&&(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),N.setAttribute("aria-expanded","false"))}}),document.addEventListener("click",e=>{window.innerWidth<=960&&C.classList.contains("mobile-open")&&!C.contains(e.target)&&!N.contains(e.target)&&(C.classList.remove("mobile-open"),document.body.classList.remove("menu-open"),N.setAttribute("aria-expanded","false"))}));

package/site/index.html

@@ -5,9 +5,9 @@
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Pagenary Docs</title>
     <meta name="description" content="Pagenary developer documentation — building, configuring, deploying, and extending the multi-tenant documentation publisher, published with Pagenary itself." />
-    <link rel="icon" type="image/png" href="./favicon.png" />
-    <link rel="stylesheet" href="./styles.css" />
-    <meta name="x-build" content="2026-05-27T07:30:04.796Z" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <link rel="stylesheet" href="/styles.css" />
+    <meta name="x-build" content="2026-06-13T16:49:25.891Z" />
   </head>
   <body>
     <a class="skip-link" href="#app">Skip to content</a>
@@ -52,6 +52,6 @@
         <ul id="commandList" class="cmd-list" role="listbox"></ul>
       </div>
     </div>
-    <script type="module" src="./app.js"></script>
+    <script type="module" src="/app.js"></script>
   </body>
 </html>

package/site/lib/manifest-utils.js

@@ -1 +1 @@
-export function sectionEntry(t,n){const e="string"==typeof t?t:t.id,r=n(e,"string"==typeof t?{}:{title:t.title,summary:t.summary});return{id:e,title:r.title,summary:r.summary,module:`./sections/${e}.js`}}export function groupEntry(t,n){const{id:e,title:r,summary:i,sections:s}=t;return{id:e,title:r,summary:i,subsections:s.map(t=>sectionEntry(t,n))}}export function buildSectionIndex(t){const n=new Map;function e(t,r=null){r&&(t.parentId=r),n.set(t.id,t),Array.isArray(t.subsections)&&t.subsections.forEach(n=>e(n,t.id))}return t.forEach(t=>e(t)),n}export function createFindSection(t){return function(n){return t.get(n)||null}}
+export function sectionEntry(t,n){const e="string"==typeof t?t:t.id,r=n(e,"string"==typeof t?{}:{title:t.title,summary:t.summary});return{id:e,title:r.title,summary:r.summary,module:`/sections/${e}.js`}}export function groupEntry(t,n){const{id:e,title:r,summary:i,sections:s}=t;return{id:e,title:r,summary:i,subsections:s.map(t=>sectionEntry(t,n))}}export function buildSectionIndex(t){const n=new Map;function e(t,r=null){r&&(t.parentId=r),n.set(t.id,t),Array.isArray(t.subsections)&&t.subsections.forEach(n=>e(n,t.id))}return t.forEach(t=>e(t)),n}export function createFindSection(t){return function(n){return t.get(n)||null}}

package/site/manifest.js

@@ -3,7 +3,7 @@ export const MANIFEST = [
     "id": "welcome",
     "title": "Welcome",
     "summary": "What Pagenary is and how this dogfooded portal is built.",
-    "module": "./sections/welcome.js"
+    "module": "/sections/welcome.js"
   },
   {
     "id": "getting-started",
@@ -14,7 +14,7 @@ export const MANIFEST = [
         "id": "quickstart",
         "title": "Quickstart",
         "summary": "Install, build the default bundle, and serve it locally.",
-        "module": "./sections/quickstart.js"
+        "module": "/sections/quickstart.js"
       }
     ]
   },
@@ -27,19 +27,19 @@ export const MANIFEST = [
         "id": "developer-guide",
         "title": "Developer Guide",
         "summary": "Project layout, scripts, and the content authoring workflow.",
-        "module": "./sections/developer-guide.js"
+        "module": "/sections/developer-guide.js"
       },
       {
         "id": "tenant-config",
         "title": "Tenant Configuration",
         "summary": "Every config.json option: branding, theming, SEO, and export.",
-        "module": "./sections/tenant-config.js"
+        "module": "/sections/tenant-config.js"
       },
       {
         "id": "extending",
         "title": "Extending",
         "summary": "Add section templates, content types, and build behaviors.",
-        "module": "./sections/extending.js"
+        "module": "/sections/extending.js"
       }
     ]
   },
@@ -52,25 +52,25 @@ export const MANIFEST = [
         "id": "architecture",
         "title": "Architecture",
         "summary": "The static SPA pattern, build pipeline, and tenant content model.",
-        "module": "./sections/architecture.js"
+        "module": "/sections/architecture.js"
       },
       {
         "id": "api",
         "title": "API Reference",
         "summary": "Module-level documentation for the publisher internals.",
-        "module": "./sections/api.js"
+        "module": "/sections/api.js"
       },
       {
         "id": "deployment",
         "title": "Deployment",
         "summary": "Hosting the static output and multi-tenant domain routing.",
-        "module": "./sections/deployment.js"
+        "module": "/sections/deployment.js"
       },
       {
         "id": "seo-strategy",
         "title": "SEO Strategy",
         "summary": "Metadata, hash-routing considerations, and discoverability.",
-        "module": "./sections/seo-strategy.js"
+        "module": "/sections/seo-strategy.js"
       }
     ]
   }

package/site/pages/api.html

@@ -27,7 +27,7 @@
     "headline": "API Reference",
     "description": "Module-level documentation for the publisher internals.",
     "url": "https://docs.pagenary.com/pages/api.html",
-    "dateModified": "2026-05-27",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/api.html"
@@ -318,19 +318,102 @@ interface Chapter {
 <li>`--dev` - Skip minification</li>
 </ul>
 <h3 id="scriptsbuild-tenantsjs">scripts/build-tenants.js</h3>
-<p>Multi-tenant build orchestrator.</p>
+<p>Multi-tenant build orchestrator. It processes tenant content, applies branding</p>
+<p>and overrides, copies public assets, then calls the build library modules for</p>
+<p>SEO artifacts and collections.</p>
 <pre><code class="language-bash">node scripts/build-tenants.js [tenant-id] [--incremental]</code></pre>
 <p>Arguments:</p>
 <ul>
 <li>`tenant-id` - Build specific tenant (omit for all)</li>
 <li>`--incremental` - Only rebuild changed files</li>
 </ul>
+<p>See <a href="#build-library-modules">Build Library Modules</a> for the helper modules used</p>
+<p>by this orchestrator.</p>
 <h3 id="scriptsservejs">scripts/serve.js</h3>
 <p>Development server.</p>
 <pre><code class="language-bash">node scripts/serve.js [--port=5173]</code></pre>
 <h3 id="scriptssync-docsjs">scripts/sync-docs.js</h3>
 <p>Regenerate section template modules.</p>
 <pre><code class="language-bash">node scripts/sync-docs.js</code></pre>
+<h2 id="build-library-modules">Build Library Modules</h2>
+<p>These modules are called by `scripts/build-tenants.js` during tenant builds.</p>
+<p>They generate files that ship in each tenant output, so they are part of the</p>
+<p>build-time API surface even though they do not run in the browser.</p>
+<h3 id="scriptslibseo-generatorjs">scripts/lib/seo-generator.js</h3>
+<p>Generates crawler-facing SEO artifacts after tenant content, branding, theme,</p>
+<p>welcome, and public assets have been written.</p>
+<h4 id="exports-2">Exports</h4>
+<p><strong>`resolveBaseUrl(config?: object): string`</strong></p>
+<p>Resolve the tenant absolute base URL. `seo.siteUrl` takes precedence over</p>
+<p>`domain`; domains without a scheme are treated as HTTPS. Returns an empty</p>
+<p>string when neither value is configured.</p>
+<pre><code class="language-javascript">const baseUrl = resolveBaseUrl({ domain: &#39;docs.example.com&#39; });
+// &#39;https://docs.example.com&#39;</code></pre>
+<p><strong>`resolveOgImage(config?: object, baseUrl?: string): string`</strong></p>
+<p>Resolve `seo.ogImage` for Open Graph and Twitter metadata. Absolute image URLs</p>
+<p>pass through; site-relative paths are joined to `baseUrl` when available.</p>
+<p><strong>`generateSeoArtifacts(distDir: string, config: object): Promise&lt;void&gt;`</strong></p>
+<p>Generate all enabled SEO artifacts for the tenant output directory:</p>
+<ul>
+<li>`sitemap.xml`</li>
+<li>`robots.txt`</li>
+<li>`llms.txt`</li>
+<li>static crawler snapshots under `pages/`</li>
+<li>JSON-LD embedded in generated static pages</li>
+</ul>
+<p>Called from `scripts/build-tenants.js` after `.public/` assets are copied and</p>
+<p>before collection manifests are generated.</p>
+<pre><code class="language-javascript">await generateSeoArtifacts(distDir, config);</code></pre>
+<p><strong>`generateSitemap(distDir: string, manifest: SectionEntry[], config: object): Promise&lt;void&gt;`</strong></p>
+<p>Write `sitemap.xml` from the generated navigation manifest.</p>
+<p><strong>`generateRobotsTxt(distDir: string, config: object): Promise&lt;void&gt;`</strong></p>
+<p>Write `robots.txt`, including a sitemap pointer when a base URL is configured.</p>
+<p><strong>`generateStaticSnapshots(distDir: string, manifest: SectionEntry[], config: object): Promise&lt;void&gt;`</strong></p>
+<p>Write static HTML snapshots for each navigable section so crawlers can consume</p>
+<p>content without executing the SPA.</p>
+<p><strong>`generateLlmsTxt(distDir: string, manifest: SectionEntry[], config: object): Promise&lt;void&gt;`</strong></p>
+<p>Write `llms.txt` with tenant-level metadata and links to generated static pages.</p>
+<h3 id="scriptslibcollections-generatorjs">scripts/lib/collections-generator.js</h3>
+<p>Generates per-collection manifests and optional RSS feeds from Markdown posts&#39;</p>
+<p>front matter. Collections are opt-in through `config.collections`.</p>
+<h4 id="exports-3">Exports</h4>
+<p><strong>`generateCollections(distDir: string, config: object, contentBasePath: string): Promise&lt;void&gt;`</strong></p>
+<p>For each collection config, read posts under `contentBasePath/&lt;collection.path&gt;`</p>
+<p>and emit artifacts under the configured route:</p>
+<ul>
+<li>`&lt;route&gt;/index.json` when `manifest !== false`</li>
+<li>`&lt;route&gt;/feed.xml` when `feed === true`</li>
+</ul>
+<p>The `index.json` entry shape is:</p>
+<pre><code class="language-typescript">interface CollectionEntry {
+  slug: string;
+  title: string;
+  date: string | null;
+  summary: string;
+  hero: string | null;
+  tags: string[];
+  reading_time: number;
+  canonical: string;
+  path: string;
+}</code></pre>
+<p>Called from `scripts/build-tenants.js` after SEO artifacts are generated:</p>
+<pre><code class="language-javascript">const collectionRoot = await findContentRoot(sourceDir);
+await generateCollections(distDir, config, collectionRoot.basePath);</code></pre>
+<h3 id="scriptslibfrontmatterjs">scripts/lib/frontmatter.js</h3>
+<p>Parses the Markdown front-matter subset used by collection posts and tenant</p>
+<p>content metadata.</p>
+<h4 id="exports-4">Exports</h4>
+<p><strong>`parseFrontmatter(raw: string): { data: Record&lt;string, any&gt;, body: string }`</strong></p>
+<p>Parse a leading `---` fenced block of `key: value` pairs. Values are coerced to</p>
+<p>booleans, numbers, `null`, quoted strings, or inline lists such as</p>
+<p>`[docs, release]`. Nested maps are not supported; unsupported values remain</p>
+<p>strings.</p>
+<pre><code class="language-javascript">const { data, body } = parseFrontmatter(markdown);</code></pre>
+<p><strong>`estimateReadingTime(body: string): number`</strong></p>
+<p>Estimate reading time in minutes at roughly 200 words per minute, with a</p>
+<p>minimum of `1`.</p>
+<p><strong>`firstHeading(body: string): string | null`</strong></p>
+<p>Return the first Markdown H1 (`# Title`) in the body, or `null` when none is present.</p>
   </div>
 </section>
       </div>