@pagenary/publisher 2026.5.0 → 2026.5.2

package/README.md

@@ -6,13 +6,25 @@ Transform shared documentation templates into tenant-specific bundles with custo
 
 ## Quick Start
 
+Install the package and drive it with the `pagenary` CLI — **no clone required**.
+New here? Follow the [Getting Started guide](docs/GETTING-STARTED.md).
+
 ```bash
-npm install
-npm run dev         # Build + serve with watch mode
+npm install --save-dev @pagenary/publisher
 
-# Or separately:
-npm run build       # Build default bundle to dist/
-npm run serve       # Preview on http://localhost:5173
+npx pagenary build:tenants my-docs   # build your tenant (see Tenant Registry below)
+npx pagenary serve                   # preview on http://localhost:5173
+```
+
+Commands: `build`, `build:tenants [id]`, `tenants:list`, `serve` (run
+`npx pagenary --help`). The package also ships a compiled reference site under `site/`.
+
+**Building from source** (contributors / modifying Pagenary):
+
+```bash
+npm install
+npm run dev         # build + serve with watch mode
+npm run build       # build default bundle to dist/
 ```
 
 ## Features
@@ -233,47 +245,56 @@ export async function load() {
 
 ## Build Commands
 
+With the package installed (the default):
+
 ```bash
-# Full builds
-npm run build                    # Build default bundle
-npm run build:tenants            # Build all registered tenants
-npm run build:tenants my-tenant  # Build specific tenant
-
-# Incremental builds (git-aware)
-npm run build:incremental my-tenant  # Only rebuild changed files
-
-# Development
-npm run dev                      # Build + serve with watch
-npm run serve                    # Serve dist/ on localhost:5173
-
-# Utilities
-npm run lint:content             # Check for trailing whitespace/tabs
-npm run check:seo                # Verify SEO metadata
-npm run check                    # Run all checks
-npm run sync:docs                # Regenerate section templates
-npm test                         # Run test suite
+npx pagenary build                    # build the default bundle to dist/
+npx pagenary build:tenants            # build all enabled tenants
+npx pagenary build:tenants my-tenant  # build a specific tenant
+npx pagenary tenants:list             # list configured tenants
+npx pagenary serve                    # serve dist/ on localhost:5173
+```
+
+From source (clone — adds dev/utility scripts):
+
+```bash
+npm run build:incremental my-tenant  # git-aware incremental rebuild
+npm run dev                          # build + serve with watch
+npm run lint:content                 # check trailing whitespace/tabs
+npm run check:seo                    # verify SEO metadata
+npm run check                        # run all checks
+npm test                             # run test suite
 ```
 
 ## Tenant Registry
 
-Register tenants in `tenants.json`:
+Register tenants in a `tenants.json` at your project root (validated by the
+bundled `tenants.schema.json`):
 
 ```json
 {
-  "my-docs": {
-    "source": "/absolute/path/to/my-docs",
-    "domain": "my-docs.local"
-  },
-  "client-portal": {
-    "source": "git:https://github.com/org/client-docs.git#main",
-    "domain": "docs.client.com"
-  }
+  "tenants": [
+    {
+      "id": "my-docs",
+      "source": { "type": "local", "path": "./docs" },
+      "strictLinks": true
+    },
+    {
+      "id": "client-portal",
+      "source": { "type": "git", "url": "https://github.com/org/client-docs.git", "ref": "main" },
+      "domains": ["docs.client.com"]
+    }
+  ]
 }
 ```
 
 **Source types:**
-- **Local path**: `/absolute/path/to/content`
-- **Git repository**: `git:https://github.com/org/repo.git#branch`
+- **Local**: `{ "type": "local", "path": "./relative/or/abs/path" }`
+- **Git**: `{ "type": "git", "url": "https://…", "ref": "main", "path": "subdir" }`
+
+Per-tenant options include `enabled` (default `true`), `strictLinks` (default
+`true` — fail the build on broken internal links), and `domains` (for the
+multi-tenant Caddy router). See [Tenant Configuration](docs/TENANT-CONFIG.md).
 
 ## Docker Caddy Workflow
 
@@ -329,6 +350,7 @@ apps/publisher/
 
 ## Documentation
 
+- [Getting Started](docs/GETTING-STARTED.md) - **start here**: zero to a published site with the npm package
 - [Quick Start Guide](docs/QUICKSTART.md) - Step-by-step tenant creation
 - [Tenant Configuration](docs/TENANT-CONFIG.md) - All config options
 - [Architecture](docs/ARCHITECTURE.md) - System design

package/package.json

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

package/scripts/build-tenants.js

@@ -6,9 +6,15 @@ import path from 'path';
 import { spawn, execSync } from 'child_process';
 import { createHash } from 'crypto';
 import os from 'os';
-import { generateSeoArtifacts } from './lib/seo-generator.js';
+import { generateSeoArtifacts, resolveBaseUrl, resolveOgImage } from './lib/seo-generator.js';
+import { fileURLToPath } from 'node:url';
 
 const root = process.cwd();
+// The package's own directory (this file lives at <pkg>/scripts/build-tenants.js).
+// Bundled scripts/assets (build.js, src/, build.config.json) resolve against this
+// so the `pagenary` bin works from any consumer CWD (#11). Tenant source/target/
+// registry paths stay relative to `root` (the caller's CWD).
+const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 const DEFAULT_TENANTS_DIR = path.join(root, 'tenants');
 const DEFAULT_DIST_DIR = path.join(root, 'dist');
 const DEFAULT_REGISTRY_PATH = path.join(root, 'tenants.json');
@@ -738,10 +744,16 @@ function escapeAttribute(value) {
 
 async function runBuild(buildOutput) {
   return new Promise((resolve, reject) => {
-    const proc = spawn(process.execPath, [path.join('scripts', 'build.js')], {
-      cwd: root,
+    // Resolve build.js and run it from the package dir so it reads the package's
+    // own src/ + build.config.json (not the caller's CWD). Pass an ABSOLUTE
+    // output path (resolved against the caller's CWD) so the bundle still lands
+    // in the right dist/ regardless of build.js's CWD (#11).
+    const buildScript = path.join(packageRoot, 'scripts', 'build.js');
+    const absOutput = path.resolve(root, buildOutput);
+    const proc = spawn(process.execPath, [buildScript], {
+      cwd: packageRoot,
       stdio: 'inherit',
-      env: { ...process.env, BUILD_OUTPUT: buildOutput }
+      env: { ...process.env, BUILD_OUTPUT: absOutput }
     });
     proc.on('exit', (code) => {
       if (code === 0) return resolve();
@@ -2634,9 +2646,11 @@ async function processNestedContent(sourceDir, distDir, tenantId, contentRoot, o
   const siteConfig = {
     bottomNav: rootManifest?.bottomNav || 'mobile',
     bottomNavSections: rootManifest?.bottomNavSections || [],
-    // Pass SEO-relevant config to SPA for dynamic meta tag updates
+    // Pass SEO-relevant config to SPA for dynamic meta tag updates.
+    // siteUrl falls back to `domain` (#15); ogImage drives social cards (#16).
     siteTitle: config.title || '',
-    siteUrl: config.seo?.siteUrl || ''
+    siteUrl: resolveBaseUrl(config),
+    ogImage: resolveOgImage(config, resolveBaseUrl(config))
   };
 
   // Build export branding configuration
@@ -2874,7 +2888,7 @@ async function processTenantContent(sourceDir, distDir, tenantId, options = {},
 
   if (contentRoot.type === 'none' && !hasManifest) {
     console.warn(`  ↳ ${tenantId}: no content found`);
-    return;
+    return { success: true };
   }
 
   // If nested structure detected, use new processing
@@ -2892,8 +2906,7 @@ async function processTenantContent(sourceDir, distDir, tenantId, options = {},
 
         if (hasDirectoryType || !hasExplicitFiles) {
           // Use nested content processing
-          await processNestedContent(sourceDir, distDir, tenantId, contentRoot, options, config);
-          return;
+          return (await processNestedContent(sourceDir, distDir, tenantId, contentRoot, options, config)) ?? { success: true };
         }
       } catch {
         // Fall through to nested processing if manifest is invalid
@@ -2901,20 +2914,20 @@ async function processTenantContent(sourceDir, distDir, tenantId, options = {},
     }
 
     // No manifest or manifest doesn't fully define structure - use nested scanning
-    await processNestedContent(sourceDir, distDir, tenantId, contentRoot, options, config);
-    return;
+    return (await processNestedContent(sourceDir, distDir, tenantId, contentRoot, options, config)) ?? { success: true };
   }
 
   // Flat content/ structure with manifest - use legacy processing
   if (hasManifest && contentRoot.type === 'flat') {
-    await processTenantManifestLegacy(sourceDir, distDir, tenantId, options);
-    return;
+    return (await processTenantManifestLegacy(sourceDir, distDir, tenantId, options)) ?? { success: true };
   }
 
   // Fallback: try legacy processing
   if (hasManifest) {
-    await processTenantManifestLegacy(sourceDir, distDir, tenantId, options);
+    return (await processTenantManifestLegacy(sourceDir, distDir, tenantId, options)) ?? { success: true };
   }
+
+  return { success: true };
 }
 
 /**
@@ -2996,15 +3009,21 @@ async function processTenantManifestLegacy(sourceDir, distDir, tenantId, options
     return;
   }
 
-  // Print link warnings
+  // Print link warnings, and fail the tenant on broken links under strict mode
   if (linkWarnings.length > 0) {
     printLinkWarnings(linkWarnings, tenantId, strictLinks);
+    const brokenLinks = linkWarnings.filter(w => w.type === 'broken');
+    if (strictLinks && brokenLinks.length > 0) {
+      console.error(`  ↳ [ERROR] ${tenantId}: Build failed due to ${brokenLinks.length} broken link(s). Use strictLinks: false to warn instead.`);
+      return { success: false, brokenLinks: brokenLinks.length };
+    }
   }
 
   const defaultSection = manifestData.default || manifestData.defaultSection || context.leafOrder[0];
   const manifestModule = buildManifestModuleSource(processedManifest, defaultSection, context.siteConfig);
   await fsp.writeFile(path.join(distDir, 'manifest.js'), manifestModule, 'utf8');
   console.log(`  ↳ applied manifest-driven content for ${tenantId}`);
+  return { success: true };
 }
 
 /**
@@ -3127,6 +3146,7 @@ async function buildTenant(tenant, targetOverride, cacheDir, buildOptions) {
     followLinks: followLinksSetting || false
   };
 
+  let contentResult = { success: true };
   if (isExplicitFileBuild) {
     // Explicit file targeting - create synthetic change set
     const explicitFiles = {
@@ -3140,7 +3160,7 @@ async function buildTenant(tenant, targetOverride, cacheDir, buildOptions) {
     if (!(await pathExists(distDir))) {
       console.log(`  ↳ no existing build found, performing full build first`);
       await runBuild(buildOutput);
-      await processTenantContent(sourceDir, distDir, tenantId, contentOptions, config);
+      contentResult = await processTenantContent(sourceDir, distDir, tenantId, contentOptions, config);
     }
 
     // Process only the specified files
@@ -3161,7 +3181,16 @@ async function buildTenant(tenant, targetOverride, cacheDir, buildOptions) {
     await runBuild(buildOutput);
 
     // Process full manifest from source directory
-    await processTenantContent(sourceDir, distDir, tenantId, contentOptions, config);
+    contentResult = await processTenantContent(sourceDir, distDir, tenantId, contentOptions, config);
+  }
+
+  // Fail the tenant before branding/SEO/deploy if content processing failed
+  // (e.g. broken links under strictLinks). Continuing would deploy a half-built
+  // dist with no tenant manifest.js, yielding a misleading "ready" and the
+  // downstream SEO "sectionEntry is not defined" error (#12, #13).
+  if (contentResult && contentResult.success === false) {
+    console.error(`  ↳ ${tenantId}: aborting build — content processing failed`);
+    return { success: false, changes };
   }
 
   // Apply file overrides from source FIRST (before branding/theme modifications)
@@ -3559,6 +3588,13 @@ async function main() {
     }
   }
 
+  // Exit non-zero when any tenant failed so CI can gate on it — e.g. the
+  // strictLinks broken-link gate (#12). Use exitCode (not exit()) so the
+  // return below still works when this script is imported programmatically.
+  if (failCount > 0) {
+    process.exitCode = 1;
+  }
+
   // Return results for programmatic use (if this script is imported)
   return results;
 }

package/scripts/lib/seo-generator.js

@@ -6,6 +6,43 @@
 import * as fsp from 'node:fs/promises';
 import * as path from 'node:path';
 
+/**
+ * Resolve the absolute base URL for a tenant's SEO output.
+ *
+ * Precedence: `seo.siteUrl` > `domain` (https:// prefixed) > '' (relative fallback).
+ * Returns a URL with no trailing slash, or '' when neither is configured.
+ * Tenants that declare only `domain` (the common case) get absolute SEO URLs
+ * for free — see issue #15.
+ *
+ * @param {object} config - Tenant configuration
+ * @returns {string} Absolute base URL (no trailing slash) or ''
+ */
+export function resolveBaseUrl(config = {}) {
+  const seoConfig = config.seo || {};
+  const raw = String(seoConfig.siteUrl || config.domain || '').trim();
+  if (!raw) return '';
+  const withScheme = /^https?:\/\//i.test(raw) ? raw : `https://${raw}`;
+  return withScheme.replace(/\/+$/, '');
+}
+
+/**
+ * Resolve a social-share image URL (og:image / twitter:image).
+ * Absolute URLs pass through; site-relative paths are joined to baseUrl.
+ * Returns '' when no image is configured. See issue #16.
+ *
+ * @param {object} config - Tenant configuration
+ * @param {string} baseUrl - Resolved base URL (may be '')
+ * @returns {string} Image URL, or '' when none configured
+ */
+export function resolveOgImage(config = {}, baseUrl = '') {
+  const seoConfig = config.seo || {};
+  const img = String(seoConfig.ogImage || '').trim();
+  if (!img) return '';
+  if (/^https?:\/\//i.test(img)) return img;
+  const pathPart = img.startsWith('/') ? img : `/${img}`;
+  return baseUrl ? `${baseUrl}${pathPart}` : pathPart;
+}
+
 /**
  * Encode section ID for use as filename (replace / with --)
  * @param {string} sectionId - Section ID like "guides/getting-started"
@@ -30,7 +67,8 @@ export function collectAllSections(manifest, parentTitle = null) {
         title: entry.title,
         summary: entry.summary || '',
         module: entry.module,
-        parent: parentTitle
+        parent: parentTitle,
+        ogImage: entry.ogImage || ''
       });
     }
     if (entry.subsections) {
@@ -85,7 +123,7 @@ export async function generateSitemap(distDir, manifest, config) {
   const seoConfig = config.seo || {};
   if (seoConfig.generateSitemap === false) return;
 
-  const baseUrl = seoConfig.siteUrl || '';
+  const baseUrl = resolveBaseUrl(config);
   const defaultChangeFreq = seoConfig.defaultChangeFreq || 'weekly';
   const urls = [];
 
@@ -125,7 +163,7 @@ export async function generateRobotsTxt(distDir, config) {
   const seoConfig = config.seo || {};
   if (seoConfig.generateRobotsTxt === false) return;
 
-  const baseUrl = seoConfig.siteUrl || '';
+  const baseUrl = resolveBaseUrl(config);
   const sitemapUrl = baseUrl ? `${baseUrl}/sitemap.xml` : '/sitemap.xml';
   const buildDate = new Date().toISOString();
 
@@ -153,8 +191,10 @@ Sitemap: ${sitemapUrl}
  */
 export function buildPageJsonLd(section, config) {
   const seoConfig = config.seo || {};
-  const baseUrl = seoConfig.siteUrl || '';
-  const canonicalUrl = `${baseUrl}/#${section.id}`;
+  const baseUrl = resolveBaseUrl(config);
+  // Canonical points at the crawlable static snapshot, not the SPA hash route
+  // (search engines ignore #fragments, which collapsed every page to home). #17
+  const canonicalUrl = `${baseUrl}/pages/${encodePathForFilename(section.id)}.html`;
   const buildDate = new Date().toISOString().split('T')[0];
 
   const articleSchema = {
@@ -229,7 +269,7 @@ export function buildPageJsonLd(section, config) {
  */
 export function buildHomePageJsonLd(config) {
   const seoConfig = config.seo || {};
-  const baseUrl = seoConfig.siteUrl || '';
+  const baseUrl = resolveBaseUrl(config);
 
   const schema = {
     '@context': 'https://schema.org',
@@ -265,10 +305,14 @@ export function buildStaticPage(options) {
     contentHtml,
     siteTitle,
     baseUrl,
+    ogImage = '',
     config
   } = options;
 
-  const canonicalUrl = `${baseUrl}/#${sectionId}`;
+  // Canonical = the crawlable static snapshot (#17). The SPA hash route is for
+  // humans (JS redirect / noscript / "interactive version" link).
+  const canonicalUrl = `${baseUrl}/pages/${encodePathForFilename(sectionId)}.html`;
+  const spaUrl = `${baseUrl}/#${sectionId}`;
   const jsonLd = buildPageJsonLd({
     id: sectionId,
     title: sectionTitle,
@@ -281,6 +325,13 @@ export function buildStaticPage(options) {
   const safeSiteTitle = escapeHtml(siteTitle);
   const safeSummary = escapeHtml(sectionSummary || '');
 
+  // Social share image (#16): summary_large_image when present, else summary.
+  const safeImage = ogImage ? escapeHtml(ogImage) : '';
+  const twitterCard = safeImage ? 'summary_large_image' : 'summary';
+  const imageTags = safeImage
+    ? `\n  <meta property="og:image" content="${safeImage}" />\n  <meta name="twitter:image" content="${safeImage}" />`
+    : '';
+
   return `<!doctype html>
 <html lang="en">
 <head>
@@ -294,10 +345,10 @@ export function buildStaticPage(options) {
   <meta property="og:title" content="${safeTitle}" />
   <meta property="og:description" content="${safeSummary}" />
   <meta property="og:type" content="article" />
-  <meta property="og:url" content="${canonicalUrl}" />
+  <meta property="og:url" content="${canonicalUrl}" />${imageTags}
 
   <!-- Twitter Card -->
-  <meta name="twitter:card" content="summary" />
+  <meta name="twitter:card" content="${twitterCard}" />
   <meta name="twitter:title" content="${safeTitle}" />
   <meta name="twitter:description" content="${safeSummary}" />
 
@@ -309,11 +360,11 @@ ${jsonLd}
   <!-- Redirect to SPA for JavaScript-enabled browsers -->
   <script>
     if (typeof window !== 'undefined') {
-      window.location.replace('${baseUrl}/#${sectionId}');
+      window.location.replace('${spaUrl}');
     }
   </script>
   <noscript>
-    <meta http-equiv="refresh" content="0; url=${baseUrl}/#${sectionId}" />
+    <meta http-equiv="refresh" content="0; url=${spaUrl}" />
   </noscript>
 
   <link rel="stylesheet" href="../styles.css" />
@@ -332,7 +383,7 @@ ${contentHtml}
       </div>
     </article>
     <footer class="static-footer">
-      <p>View interactive version: <a href="${canonicalUrl}">${safeTitle}</a></p>
+      <p>View interactive version: <a href="${spaUrl}">${safeTitle}</a></p>
     </footer>
   </main>
 </body>
@@ -398,7 +449,8 @@ export async function generateStaticSnapshots(distDir, manifest, config) {
   const pagesDir = path.join(distDir, 'pages');
   await fsp.mkdir(pagesDir, { recursive: true });
 
-  const baseUrl = seoConfig.siteUrl || '';
+  const baseUrl = resolveBaseUrl(config);
+  const siteOgImage = resolveOgImage(config, baseUrl);
   const sections = collectAllSections(manifest);
   let generated = 0;
 
@@ -415,6 +467,11 @@ export async function generateStaticSnapshots(distDir, manifest, config) {
         continue;
       }
 
+      // Per-section og:image override (frontmatter) falls back to the site image
+      const pageOgImage = section.ogImage
+        ? resolveOgImage({ seo: { ogImage: section.ogImage } }, baseUrl)
+        : siteOgImage;
+
       // Generate static page
       const pageHtml = buildStaticPage({
         sectionId: section.id,
@@ -424,6 +481,7 @@ export async function generateStaticSnapshots(distDir, manifest, config) {
         contentHtml,
         siteTitle: config.title || 'Documentation',
         baseUrl,
+        ogImage: pageOgImage,
         config
       });
 
@@ -471,7 +529,7 @@ export async function readManifestFromDist(distDir) {
  */
 export async function generateLlmsTxt(distDir, manifest, config) {
   const seoConfig = config.seo || {};
-  const baseUrl = seoConfig.siteUrl || '';
+  const baseUrl = resolveBaseUrl(config);
   const title = config.title || 'Documentation';
   const description = config.description || '';
 
@@ -543,6 +601,12 @@ export async function generateSeoArtifacts(distDir, config) {
     return;
   }
 
+  // Warn when neither seo.siteUrl nor domain is set — SEO output will use
+  // relative URLs (invalid sitemap <loc>, weak canonicals). See #15.
+  if (!resolveBaseUrl(config)) {
+    console.warn(`  ⚠ SEO: no seo.siteUrl or domain set — sitemap/canonical URLs will be relative. Set "domain" or "seo.siteUrl" for absolute URLs.`);
+  }
+
   // Read manifest from generated file
   const manifest = await readManifestFromDist(distDir);
   if (!manifest) {

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"),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"))}));
+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"))}));

package/site/index.html

@@ -7,7 +7,7 @@
     <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" />
+    <meta name="x-build" content="2026-05-27T05:01:47.803Z" />
   </head>
   <body>
     <a class="skip-link" href="#app">Skip to content</a>