@pagenary/publisher 2026.5.0

package/scripts/lint-content.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Lightweight content linting for Docs Toolkit.
+ * - scans source and docs for trailing whitespace or tab characters
+ * - ensures files end with a newline
+ */
+import fs from 'fs';
+import path from 'path';
+
+const ROOT = process.cwd();
+const INCLUDE_DIRS = ['src', 'scripts', 'docs'];
+const EXTENSIONS = new Set(['.js', '.mjs', '.css', '.html', '.md', '.json']);
+const IGNORED_FILES = new Set(['scripts/lint-content.js', 'scripts/seo-smoke.js']);
+
+const issues = [];
+
+function walk(dir) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name.startsWith('.')) continue;
+    const fullPath = path.join(dir, entry.name);
+    const relPath = path.relative(ROOT, fullPath);
+    if (IGNORED_FILES.has(relPath)) continue;
+    if (entry.isDirectory()) {
+      walk(fullPath);
+    } else {
+      const ext = path.extname(entry.name);
+      if (!EXTENSIONS.has(ext)) continue;
+      lintFile(fullPath, relPath);
+    }
+  }
+}
+
+function lintFile(fullPath, relPath) {
+  const content = fs.readFileSync(fullPath, 'utf8');
+  const lines = content.split(/\r?\n/);
+  lines.forEach((line, index) => {
+    if (/\s$/.test(line)) {
+      issues.push(`${relPath}:${index + 1} trailing whitespace`);
+    }
+    if (/\t/.test(line)) {
+      issues.push(`${relPath}:${index + 1} tab character found`);
+    }
+  });
+  if (!content.endsWith('\n')) {
+    issues.push(`${relPath} missing terminating newline`);
+  }
+}
+
+for (const dir of INCLUDE_DIRS) {
+  const target = path.join(ROOT, dir);
+  if (!fs.existsSync(target)) continue;
+  walk(target);
+}
+
+if (issues.length) {
+  console.error('Lint issues detected:\n');
+  issues.forEach((issue) => console.error(` • ${issue}`));
+  process.exit(1);
+} else {
+  console.log('Lint check passed.');
+}

package/scripts/seo-smoke.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * SEO smoke checks for Docs Toolkit.
+ * Verifies dist/index.html contains core metadata and that manifest entries
+ * include summaries and modules for shareability.
+ */
+import fs from 'fs';
+import path from 'path';
+import { pathToFileURL } from 'url';
+
+const ROOT = process.cwd();
+const DIST = path.join(ROOT, 'dist');
+const INDEX = path.join(DIST, 'index.html');
+
+function fail(message) {
+  console.error(`✖ ${message}`);
+  process.exitCode = 1;
+}
+
+function pass(message) {
+  console.log(`✔ ${message}`);
+}
+
+if (!fs.existsSync(DIST)) {
+  fail('dist/ not found. Run "npm run build" first.');
+  process.exit(1);
+}
+
+if (!fs.existsSync(INDEX)) {
+  fail('dist/index.html missing. Build may have failed.');
+  process.exit(1);
+}
+
+const html = fs.readFileSync(INDEX, 'utf8');
+
+const requiredPatterns = [
+  { label: 'Meta description', pattern: /<meta\s+name="description"\s+content="[^"]+"/i },
+  { label: 'Viewport tag', pattern: /<meta\s+name="viewport"\s+content="[^"]+"/i },
+  { label: 'Document title', pattern: /<title>\s*[^<]+\s*<\/title>/i },
+  { label: 'Stylesheet link', pattern: /<link\s+rel="stylesheet"\s+href="\.[^"]*styles\.css"/i }
+];
+
+for (const { label, pattern } of requiredPatterns) {
+  if (pattern.test(html)) pass(`${label} present`);
+  else fail(`${label} missing in dist/index.html`);
+}
+
+async function loadManifest() {
+  const manifestUrl = pathToFileURL(path.join(ROOT, 'src', 'manifest.js')).href;
+  try {
+    const mod = await import(manifestUrl);
+    if (!mod || !Array.isArray(mod.MANIFEST)) {
+      fail('Manifest did not export an array.');
+      return [];
+    }
+    return mod.MANIFEST;
+  } catch (err) {
+    fail(`Failed to import manifest: ${err.message}`);
+    return [];
+  }
+}
+
+function ensureSummary(entity, label) {
+  if (!entity.summary || !String(entity.summary).trim()) {
+    fail(`${label} missing summary`);
+  }
+}
+
+function ensureModule(entity, label) {
+  if (!entity.module || !String(entity.module).trim()) {
+    fail(`${label} missing module path`);
+  }
+}
+
+(async function run() {
+  const manifest = await loadManifest();
+  if (!manifest.length) {
+    fail('Manifest has no sections.');
+    return;
+  }
+  pass(`Manifest contains ${manifest.length} top-level entr${manifest.length === 1 ? 'y' : 'ies'}`);
+
+  manifest.forEach((section) => {
+    ensureSummary(section, `Section "${section.title}"`);
+    if (section.subsections && Array.isArray(section.subsections)) {
+      section.subsections.forEach((subsection) => {
+        ensureSummary(subsection, `Subsection "${subsection.title}"`);
+        ensureModule(subsection, `Subsection "${subsection.title}"`);
+      });
+    } else {
+      ensureModule(section, `Section "${section.title}"`);
+    }
+  });
+})();

package/scripts/serve.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/* Lightweight static server for dist with tenant routing */
+import http from 'http';
+import fs from 'fs';
+import path from 'path';
+import url from 'url';
+
+const root = path.join(process.cwd(), 'dist');
+const port = Number(process.env.PORT || 5173);
+const host = process.env.HOST || '0.0.0.0';
+const DEV = process.argv.includes('--dev') || process.env.NODE_ENV === 'development';
+const DEFAULT_TENANT = process.env.DEFAULT_TENANT || 'tenant-default';
+
+const MIME = {
+  '.html': 'text/html; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.js': 'application/javascript; charset=utf-8',
+  '.mjs': 'application/javascript; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png'
+};
+
+// Detect tenant directories at startup
+// Tenants can use tenant-* prefix or any custom name (e.g., aiwg-docs)
+const tenantDirs = new Set();
+const NON_TENANT_DIRS = new Set(['lib', 'sections', 'pages', 'assets', 'node_modules']);
+try {
+  const entries = fs.readdirSync(root, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory() && !NON_TENANT_DIRS.has(entry.name)) {
+      tenantDirs.add(entry.name);
+    }
+  }
+} catch {
+  // dist may not exist yet
+}
+
+/**
+ * Parse tenant from path. Returns { tenant, localPath }
+ * e.g., /tenant-alpha/app.js -> { tenant: 'tenant-alpha', localPath: '/app.js' }
+ *       /aiwg-docs/app.js -> { tenant: 'aiwg-docs', localPath: '/app.js' }
+ *       /app.js -> { tenant: null, localPath: '/app.js' }
+ */
+function parseTenantPath(pathname) {
+  const match = pathname.match(/^\/([^/]+)(\/.*)?$/);
+  if (match && tenantDirs.has(match[1])) {
+    return {
+      tenant: match[1],
+      localPath: match[2] || '/'
+    };
+  }
+  return { tenant: null, localPath: pathname };
+}
+
+const server = http.createServer((req, res) => {
+  const parsed = url.parse(req.url);
+  let pathname = decodeURIComponent(parsed.pathname || '/');
+
+  // Redirect root to default tenant
+  if (pathname === '/' && tenantDirs.has(DEFAULT_TENANT)) {
+    res.writeHead(302, { Location: `/${DEFAULT_TENANT}/` });
+    res.end();
+    return;
+  }
+
+  // Redirect tenant path without trailing slash to add it (for correct relative path resolution)
+  const tenantOnlyMatch = pathname.match(/^\/([^/]+)$/);
+  if (tenantOnlyMatch && tenantDirs.has(tenantOnlyMatch[1])) {
+    res.writeHead(302, { Location: `${pathname}/` });
+    res.end();
+    return;
+  }
+
+  // Parse tenant from path
+  const { tenant, localPath } = parseTenantPath(pathname);
+
+  // If no tenant specified and not a root redirect, serve 404
+  if (!tenant) {
+    res.writeHead(404).end('Not Found - Please specify a tenant');
+    return;
+  }
+
+  // Determine the root directory for this request
+  const requestRoot = path.join(root, tenant);
+
+  // Resolve the local path within the tenant/root directory
+  let resolvedPath = localPath === '/' ? '/index.html' : localPath;
+  let filePath = path.join(requestRoot, resolvedPath);
+
+  // Security check
+  if (!filePath.startsWith(requestRoot)) {
+    res.writeHead(403).end('Forbidden');
+    return;
+  }
+
+  fs.stat(filePath, (err, stat) => {
+    if (!err && stat.isDirectory()) {
+      filePath = path.join(filePath, 'index.html');
+      fs.stat(filePath, (idxErr, idxStat) => {
+        if (idxErr || !idxStat.isFile()) {
+          res.writeHead(404).end('Not Found');
+          return;
+        }
+        return streamFile(filePath, res);
+      });
+      return;
+    }
+
+    if (err || !stat.isFile()) {
+      const noExt = !path.extname(filePath);
+      if (noExt) {
+        const htmlFallback = `${filePath}.html`;
+        return fs.stat(htmlFallback, (htmlErr, htmlStat) => {
+          if (htmlErr || !htmlStat.isFile()) {
+            res.writeHead(404).end('Not Found');
+            return;
+          }
+          streamFile(htmlFallback, res);
+        });
+      }
+      res.writeHead(404).end('Not Found');
+      return;
+    }
+    streamFile(filePath, res);
+  });
+});
+
+function streamFile(target, res) {
+  const ext = path.extname(target).toLowerCase();
+  const headers = { 'Content-Type': MIME[ext] || 'application/octet-stream' };
+  headers['Cache-Control'] = DEV ? 'no-store' : (ext === '.html' ? 'no-cache' : 'public, max-age=31536000, immutable');
+  res.writeHead(200, headers);
+  fs.createReadStream(target).pipe(res);
+}
+
+server.listen(port, host, () => {
+  console.log(`Serving dist at http://${host}:${port} ${DEV ? '(dev cache disabled)' : ''}`);
+  if (tenantDirs.size > 0) {
+    console.log(`Tenants: ${[...tenantDirs].join(', ')}`);
+  }
+});

package/site/app.js

@@ -0,0 +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"),b=document.getElementById("nav"),g=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,M=new Map,I=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}),$.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=M.get(e);t?(I.add(e),n&&n.group.classList.add("expanded")):(I.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(){b.innerHTML="",H.clear(),M.clear();let t=I.size>0;e.forEach((e,n)=>{if(e.url){const t=R(e,"nav-leaf");return void b.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=!I.has(e.id);j(e.id,n)}),s.addEventListener("click",t=>{if(t.target===s){const t=!I.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=!I.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=!I.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=!I.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=!I.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),M.set(e.id,{group:t,button:n,list:a});const o=I.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),M.set(e.id,{group:t,button:n,list:s});const o=I.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),M.set(e.id,{group:t,button:n,list:a});const s=I.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),b.appendChild(n),H.set(e.id,s),M.set(e.id,{group:n,button:s,list:o});const i=!e.collapsed&&(I.has(e.id)||!t&&!I.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)})),b.appendChild(t),H.set(e.id,t)}})}(),q&&(B=!0),window.addEventListener("hashchange",()=>{q&&(B=!0),O()}),g.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"))}),b.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"))}));

package/site/index.html

@@ -0,0 +1,57 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <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-26T00:23:59.591Z" />
+  </head>
+  <body>
+    <a class="skip-link" href="#app">Skip to content</a>
+    <header class="shell topbar">
+      <button type="button" id="mobileMenuToggle" class="mobile-menu-toggle" aria-label="Toggle navigation" aria-expanded="false">
+        <span class="menu-icon"></span>
+      </button>
+      <div class="brand">
+        <span class="brand-mark">Pagenary</span>
+        <span class="brand-sub">Docs</span>
+      </div>
+      <div class="top-actions">
+        <button type="button" id="commandToggle" class="ghost-button" aria-haspopup="dialog" aria-controls="commandPalette">
+          <span class="ghost-icon">⌘K</span>
+          <span class="ghost-label">Quick Find</span>
+        </button>
+        <button type="button" id="exportBtn" class="ghost-button">
+          <span class="ghost-icon">⇣</span>
+          <span class="ghost-label">Export</span>
+        </button>
+      </div>
+    </header>
+    <div class="layout">
+      <aside class="sidebar" aria-label="Section navigation">
+        <div class="sidebar-inner">
+          <nav id="nav" class="nav" aria-label="Primary"></nav>
+        </div>
+      </aside>
+      <main id="app" class="canvas" tabindex="-1" aria-live="polite"></main>
+    </div>
+    <footer class="shell footnote">
+      <span>© <span id="year"></span> Pagenary</span>
+      <span class="divider"></span>
+      <span>Where documentation takes shape.</span>
+    </footer>
+    <div id="commandPalette" class="cmd" role="dialog" aria-modal="true" aria-labelledby="commandLabel" hidden>
+      <div class="cmd-surface" role="document">
+        <div class="cmd-header">
+          <label id="commandLabel" class="cmd-title" for="commandInput">Jump to section</label>
+          <input id="commandInput" class="cmd-input" type="search" name="query" autocomplete="off" placeholder="Start typing…" />
+        </div>
+        <ul id="commandList" class="cmd-list" role="listbox"></ul>
+      </div>
+    </div>
+    <script type="module" src="./app.js"></script>
+  </body>
+</html>

package/site/lib/categories.js

@@ -0,0 +1 @@
+export const WORD_OVERRIDES={api:"API",apis:"APIs",faq:"FAQ",rpc:"RPC",sdk:"SDK",sdks:"SDKs",ui:"UI"};export const CATEGORY_RULES=[{category:"welcome",test:t=>t.startsWith("welcome")},{category:"guide",test:t=>t.startsWith("getting-started")},{category:"reference",test:t=>t.startsWith("core-technology")},{category:"technical",test:t=>t.startsWith("technical")},{category:"developer",test:t=>t.startsWith("developers")},{category:"tutorial-overview",test:t=>"tutorials-overview"===t},{category:"tutorial",test:t=>t.startsWith("tutorial-")},{category:"tutorial",test:t=>t.startsWith("tutorials-")},{category:"use-case",test:t=>t.startsWith("use-case")},{category:"product",test:t=>t.startsWith("products")},{category:"governance",test:t=>t.startsWith("governance")},{category:"resource",test:t=>t.startsWith("resources")},{category:"security",test:t=>t.startsWith("security")},{category:"operations",test:t=>t.startsWith("operations")},{category:"archive",test:t=>t.startsWith("archive")}];export function formatWord(t){return t?WORD_OVERRIDES[t]?WORD_OVERRIDES[t]:/^\d+$/.test(t)?t:t.charAt(0).toUpperCase()+t.slice(1):""}export function normalizeId(t){return t.trim()}export function inferCategory(t){const e=normalizeId(t),r=CATEGORY_RULES.find(t=>t.test(e));return r?r.category:"default"}export function titleFromId(t){return normalizeId(t).replace(/_/g,"-").split("-").filter(Boolean).map(t=>formatWord(t)).join(" ")}

package/site/lib/export.js

@@ -0,0 +1 @@
+export function composeExportDocument(e,t={}){const{title:n="Documentation Export",brandMark:o="Docs",brandSub:r="Toolkit",tagline:a="",logo:i=null,showTagline:s=!0,showDate:l=!0}=t,m=(new Date).toLocaleString();return`<!doctype html>\n<html lang="en">\n  <head>\n    <meta charset="utf-8" />\n    <meta name="viewport" content="width=device-width, initial-scale=1" />\n    <title>${n}</title>\n    <style>\n      :root { color-scheme: light; font-family: 'IBM Plex Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }\n      body { margin: 0 auto; padding: 2.5rem; max-width: 820px; color: #111; line-height: 1.6; }\n      /* Export header styling */\n      header { text-align: center; margin-bottom: 3rem; }\n      .export-brand { display: flex; align-items: center; justify-content: center; gap: 1rem; margin-bottom: 0.5rem; }\n      .export-header--logo-text .export-brand { flex-direction: row; }\n      .export-header--text-only .export-brand { flex-direction: column; gap: 0; }\n      .export-logo { max-height: 48px; width: auto; }\n      h1 { font-size: 2.2rem; letter-spacing: 0.1em; text-transform: uppercase; margin: 0; line-height: 1; }\n      .brand-mark { font-weight: 700; }\n      .brand-sub { font-weight: 400; opacity: 0.85; }\n      .tagline { color: #666; font-size: 0.95rem; margin: 0.5rem 0 0 0; font-style: italic; }\n      .meta { color: #666; font-size: 0.9rem; margin: 0.5rem 0 0 0; }\n      .toc { border: 1px solid rgba(0,0,0,0.1); padding: 1.5rem; margin-bottom: 2.5rem; background: rgba(0,0,0,0.02); }\n      .toc h2 { margin-top: 0; letter-spacing: 0.12em; text-transform: uppercase; font-size: 0.95rem; }\n      .toc ul { margin: 0; padding-left: 1.2rem; }\n      .toc li { margin: 0.4rem 0; }\n      section { page-break-inside: avoid; margin-bottom: 2.75rem; }\n      h2 { font-size: 1.4rem; letter-spacing: 0.08em; text-transform: uppercase; border-bottom: 1px solid rgba(0,0,0,0.12); padding-bottom: 0.5rem; margin-bottom: 1rem; }\n      .section-summary { color: #5a5a5a; font-size: 0.95rem; margin-top: 0; }\n      .section-body { border-left: 1px solid rgba(0,0,0,0.1); padding-left: 1.25rem; }\n      .card, .card-grid, .card-grid > *, .section-body > * { break-inside: avoid; }\n      pre { background: rgba(0,0,0,0.05); padding: 1rem; border-radius: 4px; overflow-x: auto; }\n      code { font-family: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }\n      /* Table styling */\n      table { width: 100%; border-collapse: collapse; margin: 1rem 0; font-size: 0.9rem; }\n      th, td { padding: 0.75rem 1rem; text-align: left; border: 1px solid rgba(0,0,0,0.15); }\n      th { background: rgba(0,0,0,0.05); font-weight: 600; }\n      tbody tr:nth-child(even) { background: rgba(0,0,0,0.02); }\n      /* Spec table styling (legacy) */\n      .spec-table { width: 100%; border-collapse: collapse; margin: 1rem 0; font-size: 0.9rem; }\n      .spec-table th, .spec-table td { padding: 0.75rem 1rem; text-align: left; border: 1px solid rgba(0,0,0,0.15); }\n      .spec-table th { background: rgba(0,0,0,0.05); font-weight: 600; }\n      .spec-table tr:nth-child(even) { background: rgba(0,0,0,0.02); }\n      .spec-table td:first-child { width: 40%; }\n      /* Layer stack styling */\n      .layer-stack { display: flex; flex-direction: column; margin: 1.5rem 0; border: 2px solid #111; border-radius: 6px; overflow: hidden; }\n      .layer-stack .layer { padding: 1rem 1.25rem; text-align: center; border-bottom: 1px solid rgba(0,0,0,0.15); }\n      .layer-stack .layer:last-child { border-bottom: none; }\n      .layer-stack .layer:first-child { background: rgba(0,0,0,0.02); }\n      .layer-stack .layer:nth-child(2) { background: rgba(0,0,0,0.04); }\n      .layer-stack .layer:nth-child(3) { background: rgba(0,0,0,0.06); }\n      .layer-stack .layer-title { font-weight: 600; font-size: 1rem; margin-bottom: 0.25rem; }\n      .layer-stack .layer-desc, .layer-stack .layer-detail { font-size: 0.85rem; color: #666; }\n      /* HTML block container */\n      .html-block { margin: 1.5rem 0; }\n      /* Box diagram styling */\n      .box-diagram { border: 2px solid #111; border-radius: 6px; padding: 1.25rem; margin: 1.5rem 0; background: rgba(0,0,0,0.02); font-family: 'IBM Plex Mono', monospace; font-size: 0.85rem; white-space: pre-wrap; }\n      .box-diagram .box-title { font-weight: 700; font-size: 1rem; margin-bottom: 0.75rem; padding-bottom: 0.5rem; border-bottom: 1px solid rgba(0,0,0,0.15); }\n      /* Syntax highlighting tokens */\n      .token.comment, .token.prolog, .token.doctype, .token.cdata { color: #6a737d; font-style: italic; }\n      .token.punctuation { color: #24292e; }\n      .token.property, .token.tag, .token.constant, .token.symbol, .token.deleted { color: #d73a49; }\n      .token.boolean, .token.number { color: #005cc5; }\n      .token.selector, .token.attr-name, .token.string, .token.char, .token.builtin, .token.inserted { color: #22863a; }\n      .token.operator, .token.entity, .token.url, .language-css .token.string, .style .token.string { color: #d73a49; }\n      .token.atrule, .token.attr-value, .token.keyword { color: #d73a49; }\n      .token.function, .token.class-name { color: #6f42c1; }\n      .token.regex, .token.important, .token.variable { color: #e36209; }\n      .token.important, .token.bold { font-weight: bold; }\n      .token.italic { font-style: italic; }\n      @media print {\n        @page { size: A4; margin: 1in; }\n        body { box-shadow: none; }\n        header, .toc { break-after: avoid; }\n        .export-logo { max-height: 36px; }\n      }\n    </style>\n  </head>\n  <body>\n    <header class="${i?"export-header--logo-text":"export-header--text-only"}">\n      <div class="export-brand">\n        ${i?`<img src="${i}" alt="" class="export-logo" aria-hidden="true" />`:""}\n        <h1>${r?`<span class="brand-mark">${o}</span><span class="brand-sub">${r}</span>`:o}</h1>\n      </div>\n      ${s&&a?`<p class="tagline">${a}</p>`:""}\n      ${l?`<p class="meta">Generated ${m}</p>`:""}\n    </header>\n    <div class="toc">\n      <h2>Table of Contents</h2>\n      <ul>${e.map((e,t)=>`\n        <li>${t+1}. ${e.section.title}</li>`).join("")||"<li>No sections</li>"}</ul>\n    </div>\n${e.map((e,t)=>`\n      <section>\n        <h2>${t+1}. ${e.section.title}</h2>\n        <p class="section-summary">${e.section.summary||""}</p>\n        <div class="section-body">\n${e.html}\n        </div>\n      </section>`).join("\n")||"<p>No sections available.</p>"}\n    <script type="module">\n      import Prism from 'https://esm.sh/prismjs@1.29.0';\n      await Promise.all([\n        import('https://esm.sh/prismjs@1.29.0/components/prism-c'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-json'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-typescript'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-python'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-rust'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-go'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-bash'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-yaml'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-sql'),\n        import('https://esm.sh/prismjs@1.29.0/components/prism-solidity'),\n      ]);\n      Prism.highlightAll();\n      window.focus();\n    <\/script>\n  </body>\n</html>`}export function collectExportableSections(e){const t=[];for(const n of e)if(n.module&&t.push(n),n.subsections)for(const e of n.subsections)e.module&&t.push(e);return t}

package/site/lib/manifest-utils.js

@@ -0,0 +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}}

package/site/lib/router.js

@@ -0,0 +1 @@
+export function currentSectionId(t,e){return t.replace("#","")||e}export function resolveTarget(t,e){const r=e(t);return r?!r.module&&r.subsections&&r.subsections.length?{targetId:r.subsections[0].id,parentId:r.id}:{targetId:r.id,parentId:r.parentId||null}:{targetId:t,parentId:null}}export function resolveEntry(t,e){const{targetId:r,parentId:n}=resolveTarget(t,e),d=e(r);return d?{entry:d,targetId:r,parentId:n}:null}

package/site/lib/search.js

@@ -0,0 +1 @@
+let t=null,e=null;export function escapeRegExp(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}export function flattenManifest(t,e=""){const n=[];for(const r of t){const t=e?`${e} > ${r.title}`:r.title,o=Array.isArray(r.subsections)&&r.subsections.length>0;if(!r.module&&o||n.push({...r,group:e||r.title}),o){const e=flattenManifest(r.subsections,t);n.push(...e)}}return n}export async function buildSearchIndex(n){return t||e||(e=(async()=>{const e=flattenManifest(n),r=await Promise.all(e.map(async t=>{let e="";try{if(t.module){const n=t.module.replace("./","../"),r=await import(n);r.load&&(e=function(t){const e=document.createElement("div");return e.innerHTML=t,e.textContent||e.innerText||""}((await r.load()).html||""))}}catch(t){}return{...t,searchContent:`${t.title||""} ${t.summary||""} ${t.group||""} ${e}`.toLowerCase()}}));return t=r,r})(),e)}export function filterSections(t,e){const n=flattenManifest(t),r=e.trim().toLowerCase();return r?n.filter(t=>`${t.title||""} ${t.summary||""} ${t.group||""}`.toLowerCase().includes(r)):n}export async function searchContent(t,e){const n=await buildSearchIndex(t),r=e.trim().toLowerCase();return r?n.filter(t=>t.searchContent.includes(r)):n}export function parseSearchTerms(t){return t.split(/\s+/).map(t=>t.trim()).filter(Boolean)}export function findPreferredIndex(t,e){const n=t.findIndex(t=>t.id===e);return n>=0?n:0}

package/site/llms.txt

@@ -0,0 +1,22 @@
+# Pagenary Docs
+
+> Pagenary developer documentation — building, configuring, deploying, and extending the multi-tenant documentation publisher, published with Pagenary itself.
+
+- [Welcome](/pages/welcome.html): What Pagenary is and how this dogfooded portal is built.
+
+## Getting Started
+
+- [Quickstart](/pages/quickstart.html): Install, build the default bundle, and serve it locally.
+
+## Guides
+
+- [Developer Guide](/pages/developer-guide.html): Project layout, scripts, and the content authoring workflow.
+- [Tenant Configuration](/pages/tenant-config.html): Every config.json option: branding, theming, SEO, and export.
+- [Extending](/pages/extending.html): Add section templates, content types, and build behaviors.
+
+## Reference
+
+- [Architecture](/pages/architecture.html): The static SPA pattern, build pipeline, and tenant content model.
+- [API Reference](/pages/api.html): Module-level documentation for the publisher internals.
+- [Deployment](/pages/deployment.html): Hosting the static output and multi-tenant domain routing.
+- [SEO Strategy](/pages/seo-strategy.html): Metadata, hash-routing considerations, and discoverability.

package/site/manifest.js

@@ -0,0 +1,132 @@
+export const MANIFEST = [
+  {
+    "id": "welcome",
+    "title": "Welcome",
+    "summary": "What Pagenary is and how this dogfooded portal is built.",
+    "module": "./sections/welcome.js"
+  },
+  {
+    "id": "getting-started",
+    "title": "Getting Started",
+    "summary": "Build your first bundle and stand up a tenant.",
+    "subsections": [
+      {
+        "id": "quickstart",
+        "title": "Quickstart",
+        "summary": "Install, build the default bundle, and serve it locally.",
+        "module": "./sections/quickstart.js"
+      }
+    ]
+  },
+  {
+    "id": "guides",
+    "title": "Guides",
+    "summary": "Day-to-day workflows for authors and maintainers.",
+    "subsections": [
+      {
+        "id": "developer-guide",
+        "title": "Developer Guide",
+        "summary": "Project layout, scripts, and the content authoring workflow.",
+        "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"
+      },
+      {
+        "id": "extending",
+        "title": "Extending",
+        "summary": "Add section templates, content types, and build behaviors.",
+        "module": "./sections/extending.js"
+      }
+    ]
+  },
+  {
+    "id": "reference",
+    "title": "Reference",
+    "summary": "Architecture, APIs, deployment, and SEO reference material.",
+    "subsections": [
+      {
+        "id": "architecture",
+        "title": "Architecture",
+        "summary": "The static SPA pattern, build pipeline, and tenant content model.",
+        "module": "./sections/architecture.js"
+      },
+      {
+        "id": "api",
+        "title": "API Reference",
+        "summary": "Module-level documentation for the publisher internals.",
+        "module": "./sections/api.js"
+      },
+      {
+        "id": "deployment",
+        "title": "Deployment",
+        "summary": "Hosting the static output and multi-tenant domain routing.",
+        "module": "./sections/deployment.js"
+      },
+      {
+        "id": "seo-strategy",
+        "title": "SEO Strategy",
+        "summary": "Metadata, hash-routing considerations, and discoverability.",
+        "module": "./sections/seo-strategy.js"
+      }
+    ]
+  }
+];
+export const DEFAULT_SECTION = "welcome";
+
+const SECTION_INDEX = new Map();
+
+function registerEntry(entry, parentId = null) {
+  if (parentId) entry.parentId = parentId;
+  SECTION_INDEX.set(entry.id, entry);
+  if (Array.isArray(entry.subsections)) {
+    entry.subsections.forEach((child) => registerEntry(child, entry.id));
+  }
+}
+
+MANIFEST.forEach((entry) => registerEntry(entry));
+
+export function findSection(id) {
+  return SECTION_INDEX.get(id) || null;
+}
+
+// Build flat list of navigable sections for prev/next navigation
+function buildFlatNav() {
+  const flat = [];
+  MANIFEST.forEach((entry) => {
+    if (entry.subsections && entry.subsections.length) {
+      entry.subsections.forEach((sub) => flat.push(sub));
+    } else {
+      flat.push(entry);
+    }
+  });
+  return flat;
+}
+
+const FLAT_NAV = buildFlatNav();
+
+/**
+ * Get previous and next sections for bottom navigation
+ * @param {string} currentId - Current section ID
+ * @returns {{ prev: object|null, next: object|null }}
+ */
+export function getAdjacentSections(currentId) {
+  const index = FLAT_NAV.findIndex((s) => s.id === currentId);
+  if (index === -1) return { prev: null, next: null };
+  return {
+    prev: index > 0 ? FLAT_NAV[index - 1] : null,
+    next: index < FLAT_NAV.length - 1 ? FLAT_NAV[index + 1] : null
+  };
+}
+
+// Site configuration (from tenant _manifest.json)
+export const SITE_CONFIG = {
+  "bottomNav": "mobile",
+  "bottomNavSections": []
+};
+
+// Export document branding configuration
+export const EXPORT_CONFIG = {};

package/site/mermaid-init.js

@@ -0,0 +1 @@
+let e=null;function t(){return"mermaid-"+Math.random().toString(36).slice(2,10)}export async function renderMermaidBlocks(o){const s=o.querySelectorAll("code.language-mermaid");if(0===s.length)return;const a=await async function(){return e||(e=(async()=>{const{default:e}=await import("https://esm.sh/mermaid@10/dist/mermaid.esm.min.mjs");return e.initialize({startOnLoad:!1,theme:"neutral",securityLevel:"strict",flowchart:{htmlLabels:!0,curve:"basis",nodeSpacing:30,rankSpacing:50,padding:15,useMaxWidth:!0},themeVariables:{fontFamily:"system-ui, -apple-system, sans-serif",fontSize:"14px"}}),e})(),e)}();for(const e of s){const o=e.parentElement,s=e.textContent,r=t();try{const{svg:e}=await a.render(r,s),t=document.createElement("div");t.className="mermaid-diagram";const n=document.createElement("div");n.className="mermaid-controls",n.innerHTML='\n        <button type="button" class="mermaid-btn mermaid-zoom-out" aria-label="Zoom out">−</button>\n        <button type="button" class="mermaid-btn mermaid-zoom-reset" aria-label="Reset zoom">⊙</button>\n        <button type="button" class="mermaid-btn mermaid-zoom-in" aria-label="Zoom in">+</button>\n      ';const c=document.createElement("div");c.className="mermaid-content",c.innerHTML=e,t.appendChild(n),t.appendChild(c);let i=1;const l=c.querySelector("svg");let m,d,u,p,f=!1;const h=()=>{l&&(l.style.transform=`scale(${i})`,l.style.transformOrigin="top left")};n.querySelector(".mermaid-zoom-in").addEventListener("click",()=>{i=Math.min(i+.25,3),h()}),n.querySelector(".mermaid-zoom-out").addEventListener("click",()=>{i=Math.max(i-.25,.5),h()}),n.querySelector(".mermaid-zoom-reset").addEventListener("click",()=>{i=1,h(),c.scrollLeft=0,c.scrollTop=0}),c.addEventListener("mousedown",e=>{f=!0,c.style.cursor="grabbing",m=e.pageX-c.offsetLeft,d=e.pageY-c.offsetTop,u=c.scrollLeft,p=c.scrollTop}),c.addEventListener("mouseleave",()=>{f=!1,c.style.cursor="grab"}),c.addEventListener("mouseup",()=>{f=!1,c.style.cursor="grab"}),c.addEventListener("mousemove",e=>{if(!f)return;e.preventDefault();const t=e.pageX-c.offsetLeft,o=e.pageY-c.offsetTop;c.scrollLeft=u-(t-m),c.scrollTop=p-(o-d)});let g=0;c.addEventListener("touchstart",e=>{1===e.touches.length?(f=!0,m=e.touches[0].pageX-c.offsetLeft,d=e.touches[0].pageY-c.offsetTop,u=c.scrollLeft,p=c.scrollTop):2===e.touches.length&&(g=Math.hypot(e.touches[0].pageX-e.touches[1].pageX,e.touches[0].pageY-e.touches[1].pageY))},{passive:!0}),c.addEventListener("touchmove",e=>{if(1===e.touches.length&&f){const t=e.touches[0].pageX-c.offsetLeft,o=e.touches[0].pageY-c.offsetTop;c.scrollLeft=u-(t-m),c.scrollTop=p-(o-d)}else if(2===e.touches.length){const t=Math.hypot(e.touches[0].pageX-e.touches[1].pageX,e.touches[0].pageY-e.touches[1].pageY);if(g>0){const e=t-g;Math.abs(e)>10&&(i=Math.max(.5,Math.min(3,i+(e>0?.1:-.1))),h(),g=t)}}},{passive:!0}),c.addEventListener("touchend",()=>{f=!1,g=0},{passive:!0}),c.style.cursor="grab",o.replaceWith(t)}catch(e){console.error("Mermaid render error:",e),o.classList.add("mermaid-error");const t=document.createElement("div");t.className="mermaid-error-message",t.textContent="Diagram failed to render: "+e.message,o.insertAdjacentElement("beforebegin",t)}}}