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/site/pages/api.html ADDED Viewed

@@ -0,0 +1,339 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>API Reference | Pagenary Docs</title>
+  <meta name="description" content="Module-level documentation for the publisher internals." />
+  <link rel="canonical" href="/#api" />
+  <!-- Open Graph -->
+  <meta property="og:title" content="API Reference" />
+  <meta property="og:description" content="Module-level documentation for the publisher internals." />
+  <meta property="og:type" content="article" />
+  <meta property="og:url" content="/#api" />
+  <!-- Twitter Card -->
+  <meta name="twitter:card" content="summary" />
+  <meta name="twitter:title" content="API Reference" />
+  <meta name="twitter:description" content="Module-level documentation for the publisher internals." />
+  <!-- Structured Data -->
+  <script type="application/ld+json">
+[
+  {
+    "@context": "https://schema.org",
+    "@type": "TechArticle",
+    "headline": "API Reference",
+    "description": "Module-level documentation for the publisher internals.",
+    "url": "/#api",
+    "dateModified": "2026-05-26",
+    "mainEntityOfPage": {
+      "@type": "WebPage",
+      "@id": "/#api"
+    },
+    "isPartOf": {
+      "@type": "WebSite",
+      "name": "Pagenary Docs",
+      "url": "/"
+    }
+  },
+  {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    "itemListElement": [
+      {
+        "@type": "ListItem",
+        "position": 1,
+        "name": "Home",
+        "item": "/"
+      },
+      {
+        "@type": "ListItem",
+        "position": 2,
+        "name": "Reference",
+        "item": "/#reference"
+      },
+      {
+        "@type": "ListItem",
+        "position": 3,
+        "name": "API Reference",
+        "item": "/#api"
+      }
+    ]
+  }
+]
+  </script>
+  <!-- Redirect to SPA for JavaScript-enabled browsers -->
+  <script>
+    if (typeof window !== 'undefined') {
+      window.location.replace('/#api');
+    }
+  </script>
+  <noscript>
+    <meta http-equiv="refresh" content="0; url=/#api" />
+  </noscript>
+  <link rel="stylesheet" href="../styles.css" />
+  <style>
+    .static-content { max-width: 800px; margin: 0 auto; padding: 2rem; }
+    .static-footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid #eee; font-size: 0.9rem; color: #666; }
+  </style>
+</head>
+<body>
+  <main class="static-content">
+    <article>
+      <h1>API Reference</h1>
+      <p class="lead">Module-level documentation for the publisher internals.</p>
+      <div class="section-body">
+<section class="section doc markdown">
+  <div class="doc-content">
+<h1 id="api-reference">API Reference</h1>
+<p>Complete reference for Pagenary Publisher modules and functions.</p>
+<h2 id="core-modules">Core Modules</h2>
+<h3 id="appjs-shell-controller">app.js - Shell Controller</h3>
+<p>Main application controller handling routing, navigation, and UI state.</p>
+<h4 id="functions">Functions</h4>
+<p><strong>`navigate(id: string): void`</strong></p>
+<p>Navigate to a section by ID.</p>
+<pre><code class="language-javascript">navigate(&#39;guides/getting-started&#39;);
+// Updates hash to #/guides/getting-started and renders section</code></pre>
+<p><strong>`handleRoute(): Promise&lt;void&gt;`</strong></p>
+<p>Process current URL hash and render corresponding section.</p>
+<p><strong>`loadSection(entry: SectionEntry): Promise&lt;void&gt;`</strong></p>
+<p>Load and render a section from the manifest.</p>
+<pre><code class="language-javascript">const section = findSection(&#39;welcome&#39;);
+await loadSection(section);</code></pre>
+<p><strong>`updateNavState(activeId: string): void`</strong></p>
+<p>Update navigation UI to reflect active section.</p>
+<p><strong>`openCommandPalette(): void`</strong></p>
+<p>Open the command palette (search interface).</p>
+<p><strong>`closeCommandPalette(): void`</strong></p>
+<p>Close the command palette.</p>
+<hr>
+<h3 id="manifestjs-navigation-registry">manifest.js - Navigation Registry</h3>
+<p>Defines navigation structure and section metadata.</p>
+<h4 id="exports">Exports</h4>
+<p><strong>`MANIFEST: SectionEntry[]`</strong></p>
+<p>Ordered array of sections defining navigation.</p>
+<pre><code class="language-javascript">export const MANIFEST = [
+  {
+    id: &#39;welcome&#39;,
+    title: &#39;Welcome&#39;,
+    summary: &#39;Introduction&#39;,
+    module: &#39;./sections/welcome.js&#39;
+  },
+  {
+    id: &#39;guides&#39;,
+    title: &#39;Guides&#39;,
+    subsections: [
+      { id: &#39;guides/setup&#39;, title: &#39;Setup&#39;, module: &#39;./sections/guides--setup.js&#39; }
+    ]
+  }
+];</code></pre>
+<p><strong>`DEFAULT_SECTION: string`</strong></p>
+<p>ID of the default section (first in manifest).</p>
+<p><strong>`SITE_CONFIG: SiteConfig`</strong></p>
+<p>Site configuration from build.</p>
+<pre><code class="language-javascript">export const SITE_CONFIG = {
+  title: &#39;My Docs&#39;,
+  description: &#39;Documentation for My Product&#39;,
+  brandMark: &#39;MY&#39;,
+  brandSub: &#39;DOCS&#39;
+};</code></pre>
+<p><strong>`findSection(id: string): SectionEntry | undefined`</strong></p>
+<p>Look up a section by ID.</p>
+<pre><code class="language-javascript">const section = findSection(&#39;guides/setup&#39;);
+// Returns { id: &#39;guides/setup&#39;, title: &#39;Setup&#39;, ... }</code></pre>
+<p><strong>`getAdjacentSections(id: string): { prev?: SectionEntry, next?: SectionEntry }`</strong></p>
+<p>Get previous and next sections for navigation.</p>
+<hr>
+<h3 id="seojs-metadata-helper">seo.js - Metadata Helper</h3>
+<p>Manages document metadata for SEO.</p>
+<h4 id="functions-2">Functions</h4>
+<p><strong>`updateMetaTags({ title: string, description?: string }): void`</strong></p>
+<p>Update document title and meta description.</p>
+<pre><code class="language-javascript">updateMetaTags({
+  title: &#39;Getting Started - My Docs&#39;,
+  description: &#39;Learn how to get started with My Product&#39;
+});</code></pre>
+<hr>
+<h2 id="library-modules">Library Modules</h2>
+<h3 id="libsearchjs-full-text-search">lib/search.js - Full-Text Search</h3>
+<p>Search functionality with lazy content indexing.</p>
+<h4 id="functions-3">Functions</h4>
+<p><strong>`escapeRegExp(value: string): string`</strong></p>
+<p>Escape special regex characters.</p>
+<pre><code class="language-javascript">escapeRegExp(&#39;foo.bar&#39;); // &#39;foo\\.bar&#39;</code></pre>
+<p><strong>`flattenManifest(manifest: SectionEntry[]): FlatSection[]`</strong></p>
+<p>Flatten nested manifest into searchable sections.</p>
+<pre><code class="language-javascript">const flat = flattenManifest(MANIFEST);
+// Returns all navigable sections with group info</code></pre>
+<p><strong>`buildSearchIndex(manifest: SectionEntry[]): Promise&lt;IndexedSection[]&gt;`</strong></p>
+<p>Build search index by loading all section modules. Cached after first call.</p>
+<pre><code class="language-javascript">const index = await buildSearchIndex(MANIFEST);
+// Each entry has searchContent: lowercase text for matching</code></pre>
+<p><strong>`filterSections(manifest: SectionEntry[], query: string): FlatSection[]`</strong></p>
+<p>Synchronous title/summary search (no content).</p>
+<pre><code class="language-javascript">const results = filterSections(MANIFEST, &#39;setup&#39;);</code></pre>
+<p><strong>`searchContent(manifest: SectionEntry[], query: string): Promise&lt;IndexedSection[]&gt;`</strong></p>
+<p>Full-text search across all content.</p>
+<pre><code class="language-javascript">const results = await searchContent(MANIFEST, &#39;authentication&#39;);
+// Searches titles, summaries, and full content</code></pre>
+<p><strong>`findPreferredIndex(entries: Section[], currentId: string): number`</strong></p>
+<p>Find index of current section in filtered results.</p>
+<hr>
+<h3 id="librouterjs-hash-routing">lib/router.js - Hash Routing</h3>
+<p>URL hash parsing and resolution.</p>
+<h4 id="functions-4">Functions</h4>
+<p><strong>`resolveTarget(hash: string): string`</strong></p>
+<p>Extract section ID from URL hash.</p>
+<pre><code class="language-javascript">resolveTarget(&#39;#/guides/setup&#39;); // &#39;guides/setup&#39;
+resolveTarget(&#39;#&#39;); // &#39;&#39; (empty)</code></pre>
+<p><strong>`resolveEntry(entry: SectionEntry): SectionEntry`</strong></p>
+<p>Resolve a section entry, following redirects if needed.</p>
+<hr>
+<h3 id="libexportjs-document-export">lib/export.js - Document Export</h3>
+<p>Compose sections into exportable HTML documents.</p>
+<h4 id="functions-5">Functions</h4>
+<p><strong>`composeExportDocument(chapters: Chapter[]): string`</strong></p>
+<p>Generate complete HTML document from chapters.</p>
+<pre><code class="language-javascript">const html = composeExportDocument([
+  { section: { title: &#39;Welcome&#39; }, html: &#39;&lt;p&gt;Hello&lt;/p&gt;&#39; },
+  { section: { title: &#39;Setup&#39; }, html: &#39;&lt;p&gt;Install...&lt;/p&gt;&#39; }
+]);
+// Returns complete HTML with TOC, styles, syntax highlighting</code></pre>
+<p><strong>`collectExportableSections(manifest: SectionEntry[]): SectionEntry[]`</strong></p>
+<p>Get all sections that can be exported (have module paths).</p>
+<pre><code class="language-javascript">const sections = collectExportableSections(MANIFEST);</code></pre>
+<hr>
+<h2 id="enhancement-modules">Enhancement Modules</h2>
+<h3 id="mermaid-initjs-diagram-rendering">mermaid-init.js - Diagram Rendering</h3>
+<p>Lazy-load and render Mermaid diagrams.</p>
+<h4 id="functions-6">Functions</h4>
+<p><strong>`renderMermaidBlocks(container: Element): Promise&lt;void&gt;`</strong></p>
+<p>Find and render all Mermaid code blocks in a container.</p>
+<pre><code class="language-javascript">await renderMermaidBlocks(document.querySelector(&#39;.canvas&#39;));
+// Replaces ```mermaid blocks with rendered SVGs</code></pre>
+<hr>
+<h3 id="syntax-highlightjs-code-highlighting">syntax-highlight.js - Code Highlighting</h3>
+<p>Lazy-load and apply Prism.js syntax highlighting.</p>
+<h4 id="functions-7">Functions</h4>
+<p><strong>`highlightCodeBlocks(container: Element): Promise&lt;void&gt;`</strong></p>
+<p>Highlight all code blocks in a container.</p>
+<pre><code class="language-javascript">await highlightCodeBlocks(document.querySelector(&#39;.canvas&#39;));
+// Applies syntax highlighting to all &lt;code&gt; elements</code></pre>
+<p>Supported languages: JavaScript, TypeScript, Python, Rust, Go, C, JSON, YAML, Bash, SQL, Solidity.</p>
+<hr>
+<h2 id="section-module-contract">Section Module Contract</h2>
+<p>All section modules must export a `load` function:</p>
+<pre><code class="language-javascript">/**
+ * Load section content.
+ * @returns {Promise&lt;{ html: string, afterRender?: (container: Element) =&gt; void }&gt;}
+ */
+export async function load() {
+  return {
+    html: &#39;&lt;section class=&quot;section doc&quot;&gt;...&lt;/section&gt;&#39;,
+    // Optional: called after HTML is inserted into DOM
+    afterRender(container) {
+      // DOM manipulation, event listeners, etc.
+    }
+  };
+}</code></pre>
+<h3 id="examples">Examples</h3>
+<p><strong>Static Content:</strong></p>
+<pre><code class="language-javascript">export async function load() {
+  return {
+    html: `
+      &lt;section class=&quot;section doc markdown&quot;&gt;
+        &lt;div class=&quot;doc-content&quot;&gt;
+          &lt;h1&gt;Welcome&lt;/h1&gt;
+          &lt;p&gt;Hello, world!&lt;/p&gt;
+        &lt;/div&gt;
+      &lt;/section&gt;
+    `
+  };
+}</code></pre>
+<p><strong>Dynamic Content:</strong></p>
+<pre><code class="language-javascript">export async function load() {
+  const data = await fetch(&#39;/api/stats.json&#39;).then(r =&gt; r.json());
+  return {
+    html: `
+      &lt;section class=&quot;section doc&quot;&gt;
+        &lt;h1&gt;Stats&lt;/h1&gt;
+        &lt;p&gt;Count: ${data.count}&lt;/p&gt;
+      &lt;/section&gt;
+    `,
+    afterRender(container) {
+      container.querySelector(&#39;button&#39;)?.addEventListener(&#39;click&#39;, refresh);
+    }
+  };
+}</code></pre>
+<hr>
+<h2 id="type-definitions">Type Definitions</h2>
+<pre><code class="language-typescript">interface SectionEntry {
+  id: string;
+  title: string;
+  summary?: string;
+  module?: string;
+  subsections?: SectionEntry[];
+  exclude?: boolean;
+}
+interface FlatSection extends SectionEntry {
+  group?: string;  // Parent group title
+}
+interface IndexedSection extends FlatSection {
+  searchContent: string;  // Lowercase text for searching
+}
+interface SiteConfig {
+  title: string;
+  description?: string;
+  brandMark?: string;
+  brandSub?: string;
+  tagline?: string;
+  copyright?: string;
+}
+interface Chapter {
+  section: { title: string; summary?: string };
+  html: string;
+}</code></pre>
+<hr>
+<h2 id="build-scripts">Build Scripts</h2>
+<h3 id="scriptsbuildjs">scripts/build.js</h3>
+<p>Core build script for copying and minifying assets.</p>
+<pre><code class="language-bash">node scripts/build.js [--dev]</code></pre>
+<p>Options:</p>
+<ul>
+<li>`--dev` - Skip minification</li>
+</ul>
+<h3 id="scriptsbuild-tenantsjs">scripts/build-tenants.js</h3>
+<p>Multi-tenant build orchestrator.</p>
+<pre><code class="language-bash">node scripts/build-tenants.js [tenant-id] [--incremental]</code></pre>
+<p>Arguments:</p>
+<ul>
+<li>`tenant-id` - Build specific tenant (omit for all)</li>
+<li>`--incremental` - Only rebuild changed files</li>
+</ul>
+<h3 id="scriptsservejs">scripts/serve.js</h3>
+<p>Development server.</p>
+<pre><code class="language-bash">node scripts/serve.js [--port=5173]</code></pre>
+<h3 id="scriptssync-docsjs">scripts/sync-docs.js</h3>
+<p>Regenerate section template modules.</p>
+<pre><code class="language-bash">node scripts/sync-docs.js</code></pre>
+  </div>
+</section>
+      </div>
+    </article>
+    <footer class="static-footer">
+      <p>View interactive version: <a href="/#api">API Reference</a></p>
+    </footer>
+  </main>
+</body>
+</html>

package/site/pages/architecture.html ADDED Viewed

@@ -0,0 +1,303 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Architecture | Pagenary Docs</title>
+  <meta name="description" content="The static SPA pattern, build pipeline, and tenant content model." />
+  <link rel="canonical" href="/#architecture" />
+  <!-- Open Graph -->
+  <meta property="og:title" content="Architecture" />
+  <meta property="og:description" content="The static SPA pattern, build pipeline, and tenant content model." />
+  <meta property="og:type" content="article" />
+  <meta property="og:url" content="/#architecture" />
+  <!-- Twitter Card -->
+  <meta name="twitter:card" content="summary" />
+  <meta name="twitter:title" content="Architecture" />
+  <meta name="twitter:description" content="The static SPA pattern, build pipeline, and tenant content model." />
+  <!-- Structured Data -->
+  <script type="application/ld+json">
+[
+  {
+    "@context": "https://schema.org",
+    "@type": "TechArticle",
+    "headline": "Architecture",
+    "description": "The static SPA pattern, build pipeline, and tenant content model.",
+    "url": "/#architecture",
+    "dateModified": "2026-05-26",
+    "mainEntityOfPage": {
+      "@type": "WebPage",
+      "@id": "/#architecture"
+    },
+    "isPartOf": {
+      "@type": "WebSite",
+      "name": "Pagenary Docs",
+      "url": "/"
+    }
+  },
+  {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    "itemListElement": [
+      {
+        "@type": "ListItem",
+        "position": 1,
+        "name": "Home",
+        "item": "/"
+      },
+      {
+        "@type": "ListItem",
+        "position": 2,
+        "name": "Reference",
+        "item": "/#reference"
+      },
+      {
+        "@type": "ListItem",
+        "position": 3,
+        "name": "Architecture",
+        "item": "/#architecture"
+      }
+    ]
+  }
+]
+  </script>
+  <!-- Redirect to SPA for JavaScript-enabled browsers -->
+  <script>
+    if (typeof window !== 'undefined') {
+      window.location.replace('/#architecture');
+    }
+  </script>
+  <noscript>
+    <meta http-equiv="refresh" content="0; url=/#architecture" />
+  </noscript>
+  <link rel="stylesheet" href="../styles.css" />
+  <style>
+    .static-content { max-width: 800px; margin: 0 auto; padding: 2rem; }
+    .static-footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid #eee; font-size: 0.9rem; color: #666; }
+  </style>
+</head>
+<body>
+  <main class="static-content">
+    <article>
+      <h1>Architecture</h1>
+      <p class="lead">The static SPA pattern, build pipeline, and tenant content model.</p>
+      <div class="section-body">
+<section class="section doc markdown">
+  <div class="doc-content">
+<h1 id="pagenary-architecture">Pagenary Architecture</h1>
+<p>A minimalist multi-tenant documentation platform built around static assets and client-side rendering.</p>
+<h2 id="design-principles">Design Principles</h2>
+<ul>
+<li><strong>Zero Runtime Dependencies</strong> - Vanilla HTML, CSS, and ES modules keep the footprint tiny</li>
+<li><strong>Static-First</strong> - Hash-based routing (`#/page-id`) works on any static host</li>
+<li><strong>Multi-Tenant Isolation</strong> - Each tenant gets isolated content, branding, and configuration</li>
+<li><strong>Progressive Enhancement</strong> - Core content works without JavaScript; features enhance with it</li>
+</ul>
+<h2 id="system-overview">System Overview</h2>
+<pre><code>┌─────────────────────────────────────────────────────────────┐
+│                      Build System                           │
+│  ┌──────────┐  ┌──────────────┐  ┌───────────────────────┐ │
+│  │ Tenant   │  │ Content      │  │ Asset Pipeline        │ │
+│  │ Registry │──│ Processor    │──│ (Minify, Copy, Brand) │ │
+│  └──────────┘  └──────────────┘  └───────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Static Bundle (dist/)                    │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────────┐  │
+│  │index.html│  │ app.js   │  │styles.css│  │ sections/  │  │
+│  └──────────┘  └──────────┘  └──────────┘  └────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                           │
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Runtime (Browser)                        │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────────┐  │
+│  │ Router   │  │ Search   │  │ Renderer │  │ Export     │  │
+│  └──────────┘  └──────────┘  └──────────┘  └────────────┘  │
+└─────────────────────────────────────────────────────────────┘</code></pre>
+<h2 id="build-system">Build System</h2>
+<h3 id="tenant-registry">Tenant Registry</h3>
+<p>`tenants.json` maps tenant IDs to content sources:</p>
+<pre><code class="language-json">{
+  &quot;tenant-id&quot;: {
+    &quot;source&quot;: &quot;/path/or/git:url#branch&quot;,
+    &quot;domain&quot;: &quot;docs.example.com&quot;
+  }
+}</code></pre>
+<p>Supports local paths and git repositories. Git sources are cloned to a cache directory.</p>
+<h3 id="content-processor">Content Processor</h3>
+<p>Transforms source content into section modules:</p>
+<table><thead><tr><th style="text-align: left">Input</th><th style="text-align: left">Processing</th><th style="text-align: left">Output</th></tr></thead><tbody><tr><td style="text-align: left">`.md`</td><td style="text-align: left">Parse Markdown → HTML</td><td style="text-align: left">ES module with `load()`</td></tr><tr><td style="text-align: left">`.html`</td><td style="text-align: left">Wrap in loader</td><td style="text-align: left">ES module with `load()`</td></tr><tr><td style="text-align: left">`.js`</td><td style="text-align: left">Copy unchanged</td><td style="text-align: left">ES module with `load()`</td></tr></tbody></table>
+<h3 id="asset-pipeline">Asset Pipeline</h3>
+<p>1. <strong>Copy</strong> - Static assets from `src/` to `dist/`</p>
+<p>2. <strong>Minify</strong> - JavaScript via Terser (production)</p>
+<p>3. <strong>Brand</strong> - Apply tenant config (colors, text)</p>
+<p>4. <strong>Override</strong> - Replace files from `overrides/`</p>
+<h2 id="runtime-architecture">Runtime Architecture</h2>
+<h3 id="shell-layout">Shell Layout</h3>
+<pre><code>┌─────────────────────────────────────────────────────────┐
+│ Top Bar: Menu Toggle │ Brand │ Command Palette │ Export │
+├───────────────┬─────────────────────────────────────────┤
+│               │                                         │
+│   Sidebar     │              Canvas                     │
+│   (Nav)       │           (Content)                     │
+│               │                                         │
+├───────────────┴─────────────────────────────────────────┤
+│                     Footer                              │
+└─────────────────────────────────────────────────────────┘</code></pre>
+<h3 id="module-structure">Module Structure</h3>
+<pre><code>src/
+├── index.html          # Shell template
+├── app.js              # Core controller
+├── styles.css          # All styling
+├── manifest.js         # Navigation registry
+├── seo.js              # Meta tag management
+├── mermaid-init.js     # Diagram rendering
+├── syntax-highlight.js # Code highlighting
+└── lib/
+    ├── search.js       # Full-text search
+    ├── router.js       # Hash routing utilities
+    └── export.js       # Document export</code></pre>
+<h3 id="core-flow">Core Flow</h3>
+<pre><code>Hash Change → Router → Manifest Lookup → Module Import → Render → Post-Process
+                                              │
+                                              ├── Mermaid Diagrams
+                                              ├── Syntax Highlighting
+                                              └── SEO Meta Tags</code></pre>
+<h2 id="key-components">Key Components</h2>
+<h3 id="router-appjs">Router (app.js)</h3>
+<p>Hash-based navigation with history support:</p>
+<pre><code class="language-javascript">// URL: https://docs.example.com/#/guides/setup
+// Resolves to section ID: &quot;guides/setup&quot;
+window.addEventListener(&#39;hashchange&#39;, handleRoute);
+function handleRoute() {
+  const id = resolveTarget(location.hash);
+  const section = findSection(id);
+  await loadSection(section);
+}</code></pre>
+<h3 id="search-libsearchjs">Search (lib/search.js)</h3>
+<p>Full-text search with lazy indexing:</p>
+<pre><code class="language-javascript">// First search: load all modules, extract text, build index
+// Subsequent: search cached index
+async function buildSearchIndex(manifest) {
+  const sections = flattenManifest(manifest);
+  return Promise.all(sections.map(async (section) =&gt; {
+    const mod = await import(section.module);
+    const { html } = await mod.load();
+    return { ...section, searchContent: extractText(html) };
+  }));
+}</code></pre>
+<h3 id="mermaid-integration-mermaid-initjs">Mermaid Integration (mermaid-init.js)</h3>
+<p>Lazy-loaded diagram rendering:</p>
+<pre><code class="language-javascript">export async function renderMermaidBlocks(container) {
+  const blocks = container.querySelectorAll(&#39;pre &gt; code.language-mermaid&#39;);
+  if (!blocks.length) return;
+  const mermaid = await import(&#39;https://esm.sh/mermaid@11&#39;);
+  mermaid.default.initialize({ startOnLoad: false });
+  for (const block of blocks) {
+    const { svg } = await mermaid.default.render(id, block.textContent);
+    // Replace code block with rendered SVG
+  }
+}</code></pre>
+<h3 id="syntax-highlighting-syntax-highlightjs">Syntax Highlighting (syntax-highlight.js)</h3>
+<p>Prism.js integration with language auto-detection:</p>
+<pre><code class="language-javascript">export async function highlightCodeBlocks(container) {
+  const blocks = container.querySelectorAll(&#39;pre &gt; code[class*=&quot;language-&quot;]&#39;);
+  if (!blocks.length) return;
+  const Prism = await import(&#39;https://esm.sh/prismjs@1.29.0&#39;);
+  // Load language modules dynamically
+  Prism.highlightAllUnder(container);
+}</code></pre>
+<h3 id="export-libexportjs">Export (lib/export.js)</h3>
+<p>Document composition for print/PDF:</p>
+<pre><code class="language-javascript">export function composeExportDocument(chapters) {
+  // Generate TOC
+  const toc = chapters.map((ch, i) =&gt; `&lt;li&gt;${i+1}. ${ch.title}&lt;/li&gt;`);
+  // Compose sections
+  const body = chapters.map((ch, i) =&gt; `
+    &lt;section&gt;
+      &lt;h2&gt;${i+1}. ${ch.title}&lt;/h2&gt;
+      ${ch.html}
+    &lt;/section&gt;
+  `);
+  return `&lt;!doctype html&gt;...${toc}...${body}...`;
+}</code></pre>
+<h2 id="multi-tenant-architecture">Multi-Tenant Architecture</h2>
+<h3 id="build-time-isolation">Build-Time Isolation</h3>
+<p>Each tenant build produces an isolated bundle:</p>
+<pre><code>dist/
+├── tenant-a/
+│   ├── index.html      # Branded shell
+│   ├── manifest.js     # Tenant navigation
+│   ├── styles.css      # Themed styles
+│   └── sections/       # Tenant content
+└── tenant-b/
+    └── ...             # Completely separate</code></pre>
+<h3 id="runtime-isolation">Runtime Isolation</h3>
+<ul>
+<li>No shared state between tenants</li>
+<li>Each tenant loads its own manifest</li>
+<li>Theming via CSS variables replaced at build time</li>
+</ul>
+<h3 id="caddy-routing">Caddy Routing</h3>
+<p>Multi-tenant domain routing via Caddy:</p>
+<pre><code>tenant-a.example.com → dist/tenant-a/
+tenant-b.example.com → dist/tenant-b/</code></pre>
+<h2 id="performance-characteristics">Performance Characteristics</h2>
+<h3 id="bundle-size">Bundle Size</h3>
+<table><thead><tr><th style="text-align: left">Component</th><th style="text-align: left">Size (minified)</th></tr></thead><tbody><tr><td style="text-align: left">Shell (HTML/CSS/JS)</td><td style="text-align: left">~50 KB</td></tr><tr><td style="text-align: left">Per section</td><td style="text-align: left">~1-5 KB</td></tr><tr><td style="text-align: left">Mermaid (lazy)</td><td style="text-align: left">~800 KB</td></tr><tr><td style="text-align: left">Prism (lazy)</td><td style="text-align: left">~30 KB</td></tr></tbody></table>
+<h3 id="loading-strategy">Loading Strategy</h3>
+<p>1. <strong>Critical Path</strong> - Shell + manifest + first section</p>
+<p>2. <strong>Lazy Load</strong> - Other sections on navigation</p>
+<p>3. <strong>On-Demand</strong> - Mermaid/Prism when needed</p>
+<p>4. <strong>Cached</strong> - Search index after first search</p>
+<h2 id="extensibility-points">Extensibility Points</h2>
+<h3 id="custom-page-types">Custom Page Types</h3>
+<p>Add to `section-templates.js`:</p>
+<pre><code class="language-javascript">export const templates = {
+  &#39;custom-type&#39;: {
+    render: (data) =&gt; `&lt;section class=&quot;custom&quot;&gt;...&lt;/section&gt;`
+  }
+};</code></pre>
+<h3 id="custom-components">Custom Components</h3>
+<p>Use HTML classes in content:</p>
+<div class="html-block"><div class="my-component">...</div></div>
+<p>Add styles to tenant&#39;s `overrides/styles.css`.</p>
+<h3 id="dynamic-data">Dynamic Data</h3>
+<p>JavaScript modules can fetch external data:</p>
+<pre><code class="language-javascript">export async function load() {
+  const data = await fetch(&#39;/api/data.json&#39;).then(r =&gt; r.json());
+  return { html: renderWithData(data) };
+}</code></pre>
+<h2 id="security-considerations">Security Considerations</h2>
+<ul>
+<li><strong>No Server-Side Code</strong> - Pure static assets</li>
+<li><strong>CSP Compatible</strong> - No inline scripts in content</li>
+<li><strong>Sandboxed Content</strong> - Each tenant in separate directory</li>
+<li><strong>No User Data</strong> - Only localStorage for UI state</li>
+</ul>
+  </div>
+</section>
+      </div>
+    </article>
+    <footer class="static-footer">
+      <p>View interactive version: <a href="/#architecture">Architecture</a></p>
+    </footer>
+  </main>
+</body>
+</html>