npm - @pagenary/publisher - Versions diffs - 2026.5.0 - Mend

@pagenary/publisher 2026.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (147) hide show

package/LICENSE +661 -0
package/README.md +337 -0
package/bin/pagenary.mjs +116 -0
package/build.config.json +5 -0
package/package.json +66 -0
package/scripts/build-site.js +87 -0
package/scripts/build-tenants.js +3569 -0
package/scripts/build.js +99 -0
package/scripts/generate-sections.js +41 -0
package/scripts/lib/seo-generator.js +558 -0
package/scripts/lint-content.js +62 -0
package/scripts/seo-smoke.js +94 -0
package/scripts/serve.js +142 -0
package/site/app.js +1 -0
package/site/index.html +57 -0
package/site/lib/categories.js +1 -0
package/site/lib/export.js +1 -0
package/site/lib/manifest-utils.js +1 -0
package/site/lib/router.js +1 -0
package/site/lib/search.js +1 -0
package/site/llms.txt +22 -0
package/site/manifest.js +132 -0
package/site/mermaid-init.js +1 -0
package/site/pages/api.html +339 -0
package/site/pages/architecture.html +303 -0
package/site/pages/deployment.html +282 -0
package/site/pages/developer-guide.html +157 -0
package/site/pages/extending.html +135 -0
package/site/pages/quickstart.html +318 -0
package/site/pages/seo-strategy.html +121 -0
package/site/pages/tenant-config.html +519 -0
package/site/pages/welcome.html +116 -0
package/site/robots.txt +10 -0
package/site/sections/api.js +3 -0
package/site/sections/architecture.js +3 -0
package/site/sections/deployment.js +3 -0
package/site/sections/developer-guide.js +3 -0
package/site/sections/extending.js +3 -0
package/site/sections/quickstart.js +3 -0
package/site/sections/section-templates.js +1 -0
package/site/sections/seo-strategy.js +3 -0
package/site/sections/tenant-config.js +3 -0
package/site/sections/welcome.js +3 -0
package/site/seo.js +1 -0
package/site/sitemap.xml +63 -0
package/site/styles.css +1982 -0
package/site/syntax-highlight.js +1 -0
package/src/app.js +988 -0
package/src/index.html +56 -0
package/src/lib/categories.js +55 -0
package/src/lib/export.js +195 -0
package/src/lib/manifest-utils.js +69 -0
package/src/lib/router.js +44 -0
package/src/lib/search.js +151 -0
package/src/manifest.js +246 -0
package/src/mermaid-init.js +207 -0
package/src/sections/archive-future-roadmap.js +7 -0
package/src/sections/archive-initiative-alpha.js +7 -0
package/src/sections/archive-milestone-records.js +7 -0
package/src/sections/archive-timeline-overview.js +7 -0
package/src/sections/core-technology-compliance-frameworks.js +7 -0
package/src/sections/core-technology-coordination-model.js +7 -0
package/src/sections/core-technology-data-definitions.js +7 -0
package/src/sections/core-technology-hardware-integration.js +7 -0
package/src/sections/core-technology-integrity-controls.js +7 -0
package/src/sections/core-technology-network-topology.js +7 -0
package/src/sections/core-technology-operator-requirements.js +7 -0
package/src/sections/core-technology-overview.js +7 -0
package/src/sections/core-technology-service-interfaces.js +7 -0
package/src/sections/core-technology-synchronization-strategy.js +7 -0
package/src/sections/core-technology-system-foundation.js +7 -0
package/src/sections/developers-api-credentials.js +7 -0
package/src/sections/developers-api-operations.js +7 -0
package/src/sections/developers-api-reference.js +7 -0
package/src/sections/developers-api-websocket.js +7 -0
package/src/sections/developers-automation-blueprints.js +7 -0
package/src/sections/developers-automation-modules.js +7 -0
package/src/sections/developers-automation-patterns.js +7 -0
package/src/sections/developers-deployment-playbook.js +7 -0
package/src/sections/developers-overview.js +7 -0
package/src/sections/developers-scheduling-patterns.js +7 -0
package/src/sections/developers-sdk-go.js +7 -0
package/src/sections/developers-sdk-javascript.js +7 -0
package/src/sections/developers-sdk-python.js +7 -0
package/src/sections/developers-sdk-rust.js +7 -0
package/src/sections/developers-sdks.js +7 -0
package/src/sections/developers-solution-examples.js +7 -0
package/src/sections/developers-testing-framework.js +7 -0
package/src/sections/getting-started-architecture-basics.js +7 -0
package/src/sections/getting-started-introduction.js +7 -0
package/src/sections/getting-started-performance-overview.js +7 -0
package/src/sections/governance-community-initiatives.js +7 -0
package/src/sections/governance-dao-overview.js +7 -0
package/src/sections/governance-multi-token.js +7 -0
package/src/sections/governance-overview.js +7 -0
package/src/sections/governance-proposal-process.js +7 -0
package/src/sections/governance-proposals.js +7 -0
package/src/sections/governance-structure.js +7 -0
package/src/sections/governance-token-distribution.js +7 -0
package/src/sections/governance-treasury.js +7 -0
package/src/sections/operations-environment-prep.js +7 -0
package/src/sections/operations-getting-started.js +7 -0
package/src/sections/operations-incentives-guide.js +7 -0
package/src/sections/operations-incentives-strategies.js +7 -0
package/src/sections/operations-incentives.js +7 -0
package/src/sections/operations-infrastructure.js +7 -0
package/src/sections/operations-monitoring.js +7 -0
package/src/sections/operations-overview.js +7 -0
package/src/sections/operations-performance.js +7 -0
package/src/sections/operations-power-infrastructure.js +7 -0
package/src/sections/operations-setup-guide.js +7 -0
package/src/sections/operations-sync-setup.js +7 -0
package/src/sections/products-flagship-solution.js +7 -0
package/src/sections/products-solution-library.js +7 -0
package/src/sections/resources-brand-assets.js +7 -0
package/src/sections/resources-faq.js +7 -0
package/src/sections/resources-glossary.js +7 -0
package/src/sections/resources-research-papers.js +7 -0
package/src/sections/section-templates.js +873 -0
package/src/sections/security-audits.js +7 -0
package/src/sections/security-best-practices.js +7 -0
package/src/sections/security-bug-bounty.js +7 -0
package/src/sections/security-incident-response.js +7 -0
package/src/sections/security-overview.js +7 -0
package/src/sections/technical-architecture.js +7 -0
package/src/sections/technical-whitepaper.js +7 -0
package/src/sections/tutorial-automation-bot.js +7 -0
package/src/sections/tutorial-build-first-integration.js +7 -0
package/src/sections/tutorial-deploy-automation.js +7 -0
package/src/sections/tutorial-event-driven-experience.js +7 -0
package/src/sections/tutorial-operations-onboarding.js +7 -0
package/src/sections/tutorial-systems-integration.js +7 -0
package/src/sections/tutorials-overview.js +7 -0
package/src/sections/use-case-connected-devices.js +7 -0
package/src/sections/use-case-digital-auctions.js +7 -0
package/src/sections/use-case-financial-automation.js +7 -0
package/src/sections/use-case-interactive-media.js +7 -0
package/src/sections/use-case-realtime-execution.js +7 -0
package/src/sections/use-case-research-analytics.js +7 -0
package/src/sections/use-case-supply-operations.js +7 -0
package/src/sections/use-cases-overview.js +7 -0
package/src/sections/welcome-overview.js +7 -0
package/src/seo.js +90 -0
package/src/styles.css +1982 -0
package/src/syntax-highlight.js +90 -0
package/tenants.json.example +68 -0
package/tenants.schema.json +231 -0

package/src/index.html ADDED Viewed

@@ -0,0 +1,56 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>Docs Toolkit</title>
+    <meta name="description" content="Reusable documentation toolkit for multi-tenant services." />
+    <link rel="icon" type="image/png" href="./favicon.png" />
+    <link rel="stylesheet" href="./styles.css" />
+  </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">Docs</span>
+        <span class="brand-sub">Toolkit</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> Modular Documentation Toolkit</span>
+      <span class="divider"></span>
+      <span>Reusable patterns for multi-tenant services.</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/src/lib/categories.js ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * Category inference and title formatting utilities.
+ * Pure functions - no DOM dependencies.
+ */
+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: (id) => id.startsWith('welcome') },
+  { category: 'guide', test: (id) => id.startsWith('getting-started') },
+  { category: 'reference', test: (id) => id.startsWith('core-technology') },
+  { category: 'technical', test: (id) => id.startsWith('technical') },
+  { category: 'developer', test: (id) => id.startsWith('developers') },
+  { category: 'tutorial-overview', test: (id) => id === 'tutorials-overview' },
+  { category: 'tutorial', test: (id) => id.startsWith('tutorial-') },
+  { category: 'tutorial', test: (id) => id.startsWith('tutorials-') },
+  { category: 'use-case', test: (id) => id.startsWith('use-case') },
+  { category: 'product', test: (id) => id.startsWith('products') },
+  { category: 'governance', test: (id) => id.startsWith('governance') },
+  { category: 'resource', test: (id) => id.startsWith('resources') },
+  { category: 'security', test: (id) => id.startsWith('security') },
+  { category: 'operations', test: (id) => id.startsWith('operations') },
+  { category: 'archive', test: (id) => id.startsWith('archive') },
+];
+export function formatWord(word) {
+  if (!word) return '';
+  if (WORD_OVERRIDES[word]) return WORD_OVERRIDES[word];
+  if (/^\d+$/.test(word)) return word;
+  return word.charAt(0).toUpperCase() + word.slice(1);
+}
+export function normalizeId(id) {
+  return id.trim();
+}
+export function inferCategory(id) {
+  const normalized = normalizeId(id);
+  const match = CATEGORY_RULES.find((rule) => rule.test(normalized));
+  return match ? match.category : 'default';
+}
+export function titleFromId(id) {
+  const normalized = normalizeId(id).replace(/_/g, '-');
+  const words = normalized.split('-').filter(Boolean).map((word) => formatWord(word));
+  return words.join(' ');
+}

package/src/lib/export.js ADDED Viewed

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

package/src/lib/manifest-utils.js ADDED Viewed

@@ -0,0 +1,69 @@
+/**
+ * Manifest building utilities.
+ * Pure functions - no DOM dependencies.
+ */
+/**
+ * Create a section entry from input (string ID or object with overrides).
+ * @param {string|{id: string, title?: string, summary?: string}} input - Section ID or config object
+ * @param {Function} getSectionMetadata - Function to get metadata for a section ID
+ * @returns {{id: string, title: string, summary: string, module: string}} Section entry
+ */
+export function sectionEntry(input, getSectionMetadata) {
+  const sectionId = typeof input === 'string' ? input : input.id;
+  const overrides = typeof input === 'string' ? {} : { title: input.title, summary: input.summary };
+  const meta = getSectionMetadata(sectionId, overrides);
+  return {
+    id: sectionId,
+    title: meta.title,
+    summary: meta.summary,
+    module: `./sections/${sectionId}.js`
+  };
+}
+/**
+ * Create a group entry with subsections.
+ * @param {{id: string, title: string, summary: string, sections: Array}} config - Group config
+ * @param {Function} getSectionMetadata - Function to get metadata for section IDs
+ * @returns {{id: string, title: string, summary: string, subsections: Array}} Group entry
+ */
+export function groupEntry(config, getSectionMetadata) {
+  const { id, title, summary, sections } = config;
+  return {
+    id,
+    title,
+    summary,
+    subsections: sections.map((s) => sectionEntry(s, getSectionMetadata))
+  };
+}
+/**
+ * Build a section index from a manifest array.
+ * @param {Array} manifest - Array of section/group entries
+ * @returns {Map} Map of section ID to entry (with parentId set on subsections)
+ */
+export function buildSectionIndex(manifest) {
+  const index = new Map();
+  function registerEntry(entry, parentId = null) {
+    if (parentId) entry.parentId = parentId;
+    index.set(entry.id, entry);
+    if (Array.isArray(entry.subsections)) {
+      entry.subsections.forEach((subsection) => registerEntry(subsection, entry.id));
+    }
+  }
+  manifest.forEach((entry) => registerEntry(entry));
+  return index;
+}
+/**
+ * Create a findSection function from an index.
+ * @param {Map} index - Section index map
+ * @returns {Function} Function that takes ID and returns entry or null
+ */
+export function createFindSection(index) {
+  return function findSection(id) {
+    return index.get(id) || null;
+  };
+}

package/src/lib/router.js ADDED Viewed

@@ -0,0 +1,44 @@
+/**
+ * Router and navigation utilities.
+ * Pure functions - no DOM dependencies.
+ */
+/**
+ * Extract current section ID from URL hash.
+ * @param {string} hash - URL hash (e.g., '#section-id' or '')
+ * @param {string} defaultSection - Default section ID if hash is empty
+ * @returns {string} Section ID
+ */
+export function currentSectionId(hash, defaultSection) {
+  return hash.replace('#', '') || defaultSection;
+}
+/**
+ * Resolve target section and parent group from an ID.
+ * If ID is a group with subsections, redirects to first subsection.
+ * @param {string} id - Section ID to resolve
+ * @param {Function} findSection - Function to look up section by ID
+ * @returns {{targetId: string, parentId: string|null}} Resolved target and parent
+ */
+export function resolveTarget(id, findSection) {
+  const entry = findSection(id);
+  if (!entry) return { targetId: id, parentId: null };
+  // If it's a group with subsections but no module, redirect to first subsection
+  if (!entry.module && entry.subsections && entry.subsections.length) {
+    return { targetId: entry.subsections[0].id, parentId: entry.id };
+  }
+  return { targetId: entry.id, parentId: entry.parentId || null };
+}
+/**
+ * Resolve full entry information from an ID.
+ * @param {string} id - Section ID to resolve
+ * @param {Function} findSection - Function to look up section by ID
+ * @returns {{entry: object, targetId: string, parentId: string|null}|null} Resolved entry or null
+ */
+export function resolveEntry(id, findSection) {
+  const { targetId, parentId } = resolveTarget(id, findSection);
+  const entry = findSection(targetId);
+  if (!entry) return null;
+  return { entry, targetId, parentId };
+}

package/src/lib/search.js ADDED Viewed

@@ -0,0 +1,151 @@
+/**
+ * Search and filtering utilities.
+ */
+// Cache for loaded section content
+let searchIndex = null;
+let indexPromise = null;
+/**
+ * Escape special regex characters in a string.
+ * @param {string} value - String to escape
+ * @returns {string} Escaped string safe for use in RegExp
+ */
+export function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Flatten manifest into searchable sections.
+ * Returns all navigable sections (those with module paths).
+ * Recursively handles deeply nested subsections.
+ * @param {Array} manifest - Nested manifest array
+ * @param {string} [parentGroup] - Parent group title for tracking hierarchy
+ * @returns {Array} Flat array of searchable sections
+ */
+export function flattenManifest(manifest, parentGroup = '') {
+  const flat = [];
+  for (const entry of manifest) {
+    const groupLabel = parentGroup ? `${parentGroup} > ${entry.title}` : entry.title;
+    const hasSubsections = Array.isArray(entry.subsections) && entry.subsections.length > 0;
+    // Include an entry as a searchable section when it has a module (a
+    // navigable leaf in production manifests) OR when it is a leaf with no
+    // subsections (flat manifests carry navigable sections without a module
+    // field). Group entries — those with subsections — are containers, not
+    // navigable targets, so they are not included directly; their children
+    // are picked up by the recursion below.
+    if (entry.module || !hasSubsections) {
+      flat.push({
+        ...entry,
+        group: parentGroup || entry.title
+      });
+    }
+    // Recursively include all subsections
+    if (hasSubsections) {
+      const nested = flattenManifest(entry.subsections, groupLabel);
+      flat.push(...nested);
+    }
+  }
+  return flat;
+}
+/**
+ * Extract plain text from HTML string.
+ * @param {string} html - HTML content
+ * @returns {string} Plain text
+ */
+function extractText(html) {
+  const div = document.createElement('div');
+  div.innerHTML = html;
+  return div.textContent || div.innerText || '';
+}
+/**
+ * Build search index by loading all section modules.
+ * @param {Array} manifest - The manifest array
+ * @returns {Promise<Array>} Indexed sections with content
+ */
+export async function buildSearchIndex(manifest) {
+  if (searchIndex) return searchIndex;
+  if (indexPromise) return indexPromise;
+  indexPromise = (async () => {
+    const flat = flattenManifest(manifest);
+    const indexed = await Promise.all(
+      flat.map(async (section) => {
+        let content = '';
+        try {
+          if (section.module) {
+            // Adjust path: module paths are relative to root, but we're in lib/
+            const modulePath = section.module.replace('./', '../');
+            const mod = await import(modulePath);
+            if (mod.load) {
+              const result = await mod.load();
+              content = extractText(result.html || '');
+            }
+          }
+        } catch (e) {
+          // Module failed to load, search by title/summary only
+        }
+        return {
+          ...section,
+          searchContent: `${section.title || ''} ${section.summary || ''} ${section.group || ''} ${content}`.toLowerCase()
+        };
+      })
+    );
+    searchIndex = indexed;
+    return indexed;
+  })();
+  return indexPromise;
+}
+/**
+ * Filter sections by search query (title/summary only, synchronous).
+ * @param {Array} manifest - Array of section objects
+ * @param {string} query - Search query
+ * @returns {Array} Filtered sections
+ */
+export function filterSections(manifest, query) {
+  const flat = flattenManifest(manifest);
+  const q = query.trim().toLowerCase();
+  if (!q) return flat;
+  return flat.filter((section) => {
+    const haystack = `${section.title || ''} ${section.summary || ''} ${section.group || ''}`.toLowerCase();
+    return haystack.includes(q);
+  });
+}
+/**
+ * Full-text search across all section content.
+ * Loads all modules on first call (cached thereafter).
+ * @param {Array} manifest - The manifest array
+ * @param {string} query - Search query
+ * @returns {Promise<Array>} Matching sections
+ */
+export async function searchContent(manifest, query) {
+  const index = await buildSearchIndex(manifest);
+  const q = query.trim().toLowerCase();
+  if (!q) return index;
+  return index.filter((section) => section.searchContent.includes(q));
+}
+/**
+ * Parse search query into individual terms.
+ * @param {string} query - Search query
+ * @returns {Array<string>} Array of search terms
+ */
+export function parseSearchTerms(query) {
+  return query.split(/\s+/).map((term) => term.trim()).filter(Boolean);
+}
+/**
+ * Find the preferred index in filtered entries based on current section.
+ * @param {Array} entries - Filtered section entries
+ * @param {string} currentId - Current section ID
+ * @returns {number} Index to select (0 if current not found)
+ */
+export function findPreferredIndex(entries, currentId) {
+  const index = entries.findIndex((entry) => entry.id === currentId);
+  return index >= 0 ? index : 0;
+}