@pagenary/publisher 2026.5.4 → 2026.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagenary/publisher",
-  "version": "2026.5.4",
+  "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

@@ -1672,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)
 // ============================================================================
@@ -1992,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
@@ -2107,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
@@ -2131,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,
@@ -2142,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);
   }
@@ -2170,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,
@@ -2185,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);
@@ -2441,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) {
@@ -2499,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);
@@ -2575,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;
@@ -2671,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,
@@ -2779,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);
 
@@ -2807,7 +2887,7 @@ async function materializeSectionModule(entry, context) {
     return null;
   }
 
-  return `./sections/${outFile}`;
+  return `/sections/${outFile}`;
 }
 
 function buildManifestModuleSource(manifestEntries, defaultSection, siteConfig = {}, exportConfig = {}) {
@@ -3339,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') {
@@ -3349,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)`);

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-28T16:02:34.220Z" />
+    <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-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/api.html"

package/site/pages/architecture.html

@@ -27,7 +27,7 @@
     "headline": "Architecture",
     "description": "The static SPA pattern, build pipeline, and tenant content model.",
     "url": "https://docs.pagenary.com/pages/architecture.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/architecture.html"

package/site/pages/deployment.html

@@ -27,7 +27,7 @@
     "headline": "Deployment",
     "description": "Hosting the static output and multi-tenant domain routing.",
     "url": "https://docs.pagenary.com/pages/deployment.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/deployment.html"

package/site/pages/developer-guide.html

@@ -27,7 +27,7 @@
     "headline": "Developer Guide",
     "description": "Project layout, scripts, and the content authoring workflow.",
     "url": "https://docs.pagenary.com/pages/developer-guide.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/developer-guide.html"

package/site/pages/extending.html

@@ -27,7 +27,7 @@
     "headline": "Extending",
     "description": "Add section templates, content types, and build behaviors.",
     "url": "https://docs.pagenary.com/pages/extending.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/extending.html"

package/site/pages/quickstart.html

@@ -27,7 +27,7 @@
     "headline": "Quickstart",
     "description": "Install, build the default bundle, and serve it locally.",
     "url": "https://docs.pagenary.com/pages/quickstart.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/quickstart.html"

package/site/pages/seo-strategy.html

@@ -27,7 +27,7 @@
     "headline": "SEO Strategy",
     "description": "Metadata, hash-routing considerations, and discoverability.",
     "url": "https://docs.pagenary.com/pages/seo-strategy.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/seo-strategy.html"

package/site/pages/tenant-config.html

@@ -27,7 +27,7 @@
     "headline": "Tenant Configuration",
     "description": "Every config.json option: branding, theming, SEO, and export.",
     "url": "https://docs.pagenary.com/pages/tenant-config.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/tenant-config.html"

package/site/pages/welcome.html

@@ -27,7 +27,7 @@
     "headline": "Welcome",
     "description": "What Pagenary is and how this dogfooded portal is built.",
     "url": "https://docs.pagenary.com/pages/welcome.html",
-    "dateModified": "2026-05-28",
+    "dateModified": "2026-06-13",
     "mainEntityOfPage": {
       "@type": "WebPage",
       "@id": "https://docs.pagenary.com/pages/welcome.html"

package/site/robots.txt

@@ -1,5 +1,5 @@
 # Pagenary Docs
-# Generated: 2026-05-28T16:02:34.576Z
+# Generated: 2026-06-13T16:49:26.262Z
 
 User-agent: *
 Allow: /

package/site/sitemap.xml

@@ -2,61 +2,61 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://docs.pagenary.com/</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/welcome.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/quickstart.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/developer-guide.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/tenant-config.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/extending.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/architecture.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/api.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/deployment.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://docs.pagenary.com/pages/seo-strategy.html</loc>
-    <lastmod>2026-05-28</lastmod>
+    <lastmod>2026-06-13</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>

package/site/styles.css

@@ -684,6 +684,19 @@ mark.hl {
   color: var(--ink);
 }
 
+.doc-content .doc-meta {
+  color: var(--muted);
+  font-size: 0.85rem;
+  letter-spacing: 0;
+  text-transform: uppercase;
+}
+
+.doc-content .doc-summary {
+  color: var(--muted);
+  font-size: 1.05rem;
+  line-height: 1.6;
+}
+
 .doc-content ul,
 .doc-content ol {
   margin: 0;

package/src/app.js

@@ -380,6 +380,7 @@ async function loadSection(entry) {
   }
   const payload = await loader();
   app.innerHTML = payload.html || '';
+  renderEntryMetadata(entry);
 
   // Render any mermaid diagrams in the content
   await renderMermaidBlocks(app);
@@ -412,6 +413,51 @@ async function loadSection(entry) {
   focusCanvas();
 }
 
+function renderEntryMetadata(entry) {
+  if (!entry || (!entry.showDate && !entry.showReadingTime && !entry.showSummary)) return;
+  const content = app.querySelector('.doc-content') || app.querySelector('article, section') || app;
+  const heading = content.querySelector('h1');
+  if (!heading) return;
+
+  const fragments = [];
+  if (entry.showDate && entry.date) {
+    fragments.push(formatEntryDate(entry.date));
+  }
+  if (entry.showReadingTime && entry.reading_time) {
+    fragments.push(`${entry.reading_time} min read`);
+  }
+
+  let insertAfter = heading;
+  if (fragments.length > 0) {
+    const meta = document.createElement('p');
+    meta.className = 'doc-meta';
+    meta.textContent = fragments.join(' · ');
+    heading.after(meta);
+    insertAfter = meta;
+  }
+
+  if (entry.showSummary && entry.summary) {
+    const summary = document.createElement('p');
+    summary.className = 'doc-summary';
+    summary.textContent = entry.summary;
+    insertAfter.after(summary);
+  }
+}
+
+function formatEntryDate(value) {
+  const raw = String(value || '').trim();
+  if (!raw) return '';
+  const normalized = /^\d{4}-\d{2}-\d{2}$/.test(raw) ? `${raw}T00:00:00Z` : raw;
+  const date = new Date(normalized);
+  if (Number.isNaN(date.getTime())) return raw;
+  return new Intl.DateTimeFormat(undefined, {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+    timeZone: 'UTC'
+  }).format(date);
+}
+
 /**
  * Render bottom page navigation (prev/next links)
  * Visibility controlled by SITE_CONFIG.bottomNav: 'always' | 'mobile' | 'never'

package/src/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Docs Toolkit</title>
     <meta name="description" content="Reusable documentation toolkit for multi-tenant services." />
-    <link rel="icon" type="image/png" href="./favicon.png" />
-    <link rel="stylesheet" href="./styles.css" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <link rel="stylesheet" href="/styles.css" />
   </head>
   <body>
     <a class="skip-link" href="#app">Skip to content</a>
@@ -51,6 +51,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/src/lib/manifest-utils.js

@@ -17,7 +17,7 @@ export function sectionEntry(input, getSectionMetadata) {
     id: sectionId,
     title: meta.title,
     summary: meta.summary,
-    module: `./sections/${sectionId}.js`
+    module: `/sections/${sectionId}.js`
   };
 }
 

package/src/manifest.js

@@ -8,7 +8,7 @@ function sectionEntry(input) {
     id: sectionId,
     title: meta.title,
     summary: meta.summary,
-    module: `./sections/${sectionId}.js`
+    module: `/sections/${sectionId}.js`
   };
 }
 

package/src/styles.css

@@ -684,6 +684,19 @@ mark.hl {
   color: var(--ink);
 }
 
+.doc-content .doc-meta {
+  color: var(--muted);
+  font-size: 0.85rem;
+  letter-spacing: 0;
+  text-transform: uppercase;
+}
+
+.doc-content .doc-summary {
+  color: var(--muted);
+  font-size: 1.05rem;
+  line-height: 1.6;
+}
+
 .doc-content ul,
 .doc-content ol {
   margin: 0;