@invisibleloop/pulse 0.20.11 → 0.20.19

package/docs/server.js

@@ -1,161 +0,0 @@
-import fs                      from 'fs'
-import { createServer }        from '../src/server/index.js'
-import { initLayoutManifest }  from './src/lib/layout.js'
-import { metrics }             from './src/lib/stats.js'
-import { metricsStore }        from './src/lib/metrics-store.js'
-import { NAV }                 from './src/lib/nav.js'
-metricsStore.current = metrics
-
-// Build search index once at startup from nav structure
-const searchIndex = JSON.stringify(
-  NAV.flatMap(({ section, items }) =>
-    items.map(item => ({ title: item.label, href: item.href, section, body: '' }))
-  )
-)
-const searchIndexEtag = `"${Buffer.from(searchIndex).length}-search"`
-
-// Populate hashed asset paths in layout.js before any page renders
-try {
-  const raw = fs.readFileSync(new URL('./public/dist/manifest.json', import.meta.url), 'utf8')
-  initLayoutManifest(JSON.parse(raw))
-} catch { /* dev: no manifest yet, layout falls back to unhashed paths */ }
-
-await createServer(
-  [
-    // Framework
-    new URL('./src/pages/home.js',              import.meta.url),
-    new URL('./src/pages/how-it-works.js',      import.meta.url),
-    new URL('./src/pages/faq.js',               import.meta.url),
-    new URL('./src/pages/config.js',            import.meta.url),
-    new URL('./src/pages/getting-started.js',   import.meta.url),
-    new URL('./src/pages/slash-commands.js',    import.meta.url),
-    new URL('./src/pages/prompt-examples.js',   import.meta.url),
-    new URL('./src/pages/components.js',        import.meta.url),
-    new URL('./src/pages/project-structure.js', import.meta.url),
-    new URL('./src/pages/spec.js',              import.meta.url),
-    // State & Behaviour
-    new URL('./src/pages/state.js',             import.meta.url),
-    new URL('./src/pages/mutations.js',         import.meta.url),
-    new URL('./src/pages/actions.js',           import.meta.url),
-    new URL('./src/pages/validation.js',        import.meta.url),
-    new URL('./src/pages/constraints.js',       import.meta.url),
-    new URL('./src/pages/persist.js',           import.meta.url),
-    // Server
-    new URL('./src/pages/server-data.js',       import.meta.url),
-    new URL('./src/pages/markdown.js',          import.meta.url),
-    new URL('./src/pages/store.js',             import.meta.url),
-    new URL('./src/pages/routing.js',           import.meta.url),
-    new URL('./src/pages/error-pages.js',       import.meta.url),
-    new URL('./src/pages/streaming.js',         import.meta.url),
-    new URL('./src/pages/caching.js',           import.meta.url),
-    new URL('./src/pages/guard.js',             import.meta.url),
-    new URL('./src/pages/forms.js',             import.meta.url),
-    new URL('./src/pages/raw-responses.js',     import.meta.url),
-    new URL('./src/pages/server-api.js',        import.meta.url),
-    new URL('./src/pages/extending.js',         import.meta.url),
-    // Client
-    new URL('./src/pages/hydration.js',         import.meta.url),
-    new URL('./src/pages/navigation.js',        import.meta.url),
-    new URL('./src/pages/images.js',            import.meta.url),
-    // Deployment
-    new URL('./src/pages/deploy.js',            import.meta.url),
-    // Reference
-    new URL('./src/pages/meta.js',              import.meta.url),
-    new URL('./src/pages/performance.js',       import.meta.url),
-    new URL('./src/pages/accessibility.js',     import.meta.url),
-    new URL('./src/pages/testing.js',           import.meta.url),
-    // Integrations
-    new URL('./src/pages/supabase.js',          import.meta.url),
-    new URL('./src/pages/auth.js',              import.meta.url),
-    new URL('./src/pages/stripe.js',            import.meta.url),
-    // UI Components
-    new URL('./src/pages/components/alert.js',       import.meta.url),
-    new URL('./src/pages/components/avatar.js',      import.meta.url),
-    new URL('./src/pages/components/badge.js',       import.meta.url),
-    new URL('./src/pages/components/breadcrumbs.js', import.meta.url),
-    new URL('./src/pages/components/button.js',      import.meta.url),
-    new URL('./src/pages/components/card.js',        import.meta.url),
-    new URL('./src/pages/components/checkbox.js',    import.meta.url),
-    new URL('./src/pages/components/charts.js',      import.meta.url),
-    new URL('./src/pages/components/empty.js',       import.meta.url),
-    new URL('./src/pages/components/fieldset.js',    import.meta.url),
-    new URL('./src/pages/components/fileupload.js',  import.meta.url),
-    new URL('./src/pages/components/heading.js',     import.meta.url),
-    new URL('./src/pages/components/icons.js',       import.meta.url),
-    new URL('./src/pages/components/image.js',       import.meta.url),
-    new URL('./src/pages/components/input.js',       import.meta.url),
-    new URL('./src/pages/components/modal.js',       import.meta.url),
-    new URL('./src/pages/components/progress.js',    import.meta.url),
-    new URL('./src/pages/components/prose.js',       import.meta.url),
-    new URL('./src/pages/components/pullquote.js',   import.meta.url),
-    new URL('./src/pages/components/radio.js',       import.meta.url),
-    new URL('./src/pages/components/rating.js',      import.meta.url),
-    new URL('./src/pages/components/search.js',      import.meta.url),
-    new URL('./src/pages/components/segmented.js',   import.meta.url),
-    new URL('./src/pages/components/select.js',      import.meta.url),
-    new URL('./src/pages/components/slider.js',      import.meta.url),
-    new URL('./src/pages/components/spinner.js',     import.meta.url),
-    new URL('./src/pages/components/stat.js',        import.meta.url),
-    new URL('./src/pages/components/stepper.js',     import.meta.url),
-    new URL('./src/pages/components/table.js',       import.meta.url),
-    new URL('./src/pages/components/textarea.js',    import.meta.url),
-    new URL('./src/pages/components/toggle.js',      import.meta.url),
-    new URL('./src/pages/components/tooltip.js',     import.meta.url),
-    // Landing Components
-    new URL('./src/pages/components/accordion.js',   import.meta.url),
-    new URL('./src/pages/components/app-badge.js',   import.meta.url),
-    new URL('./src/pages/components/cta.js',         import.meta.url),
-    new URL('./src/pages/components/feature.js',     import.meta.url),
-    new URL('./src/pages/components/hero.js',        import.meta.url),
-    new URL('./src/pages/components/nav.js',         import.meta.url),
-    new URL('./src/pages/components/phone-frame.js', import.meta.url),
-    // Templates
-    new URL('./src/pages/templates.js',                     import.meta.url),
-    new URL('./src/pages/templates/mobile-app.js',          import.meta.url),
-    new URL('./src/pages/templates/blog-post.js',           import.meta.url),
-    new URL('./src/pages/templates/coutumes.js',            import.meta.url),
-    new URL('./src/pages/templates/sparkys.js',             import.meta.url),
-    new URL('./src/pages/templates/swish.js',               import.meta.url),
-    new URL('./src/pages/templates/bookworms.js',           import.meta.url),
-    new URL('./src/pages/templates/retrowheels.js',         import.meta.url),
-    new URL('./src/pages/templates/suzukibento.js',         import.meta.url),
-    new URL('./src/pages/templates/andypixel.js',           import.meta.url),
-    new URL('./src/pages/templates/journey.js',             import.meta.url),
-    new URL('./src/pages/templates/shop.js',                import.meta.url),
-    // Layout Components
-    new URL('./src/pages/components/cluster.js',     import.meta.url),
-    new URL('./src/pages/components/container.js',   import.meta.url),
-    new URL('./src/pages/components/divider.js',     import.meta.url),
-    new URL('./src/pages/components/footer.js',      import.meta.url),
-    new URL('./src/pages/components/grid.js',        import.meta.url),
-    new URL('./src/pages/components/media.js',       import.meta.url),
-    new URL('./src/pages/components/section.js',     import.meta.url),
-    new URL('./src/pages/components/stack.js',       import.meta.url),
-  ],
-  {
-    port:         process.env.PORT ? Number(process.env.PORT) : 4000,
-    staticDir:    new URL('./public', import.meta.url).pathname,
-    root:         new URL('.', import.meta.url),
-    defaultCache: true,
-    csp: {
-      'img-src':   ['https://picsum.photos', 'https://fastly.picsum.photos', 'https://images.unsplash.com'],
-      'style-src': ['https://fonts.googleapis.com'],
-      'font-src':  ['https://fonts.gstatic.com'],
-    },
-    onRequest(req, res) {
-      if (req.url !== '/search-index.json') return
-      if (req.headers['if-none-match'] === searchIndexEtag) {
-        res.writeHead(304)
-        res.end()
-        return false
-      }
-      res.writeHead(200, {
-        'Content-Type':  'application/json; charset=utf-8',
-        'Cache-Control': 'public, max-age=3600',
-        'ETag':          searchIndexEtag,
-      })
-      res.end(searchIndex)
-      return false
-    },
-  }
-)

package/docs/src/lib/component-page.js

@@ -1,49 +0,0 @@
-/**
- * Pulse Docs — Component page factory
- *
- * renderComponentPage({ name, description, demos, props, prev, next, currentHref })
- * Returns the HTML content string for a standard component doc page.
- */
-
-import { renderLayout, h1, lead, codeBlock } from './layout.js'
-import { highlight } from './highlight.js'
-
-export function demo(previewHtml, codeStr, { col = false, scroll = false, bleed = false } = {}) {
-  const previewClass = [
-    'demo-preview',
-    'is-light',
-    col    ? 'demo-preview--col'    : '',
-    scroll ? 'demo-preview--scroll' : '',
-    bleed  ? 'demo-preview--bleed'  : '',
-  ].filter(Boolean).join(' ')
-  const toggle = `<button class="demo-theme-toggle" aria-label="Toggle light/dark theme" title="Toggle theme">
-    <svg class="demo-theme-toggle__dark" width="14" height="14" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M21 12.79A9 9 0 1111.21 3a7 7 0 109.79 9.79z"/></svg>
-    <svg class="demo-theme-toggle__light" width="14" height="14" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><circle cx="12" cy="12" r="5"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
-  </button>`
-  return `<div class="component-demo">
-  <div class="${previewClass}">${toggle}<div class="demo-preview-inner ui-theme-light">${previewHtml}</div></div>
-  <div class="demo-code">${codeBlock(highlight(codeStr, 'js'))}</div>
-</div>`
-}
-
-/**
- * @param {object} opts
- * @param {string}   opts.currentHref  - The route of this page
- * @param {string}   opts.name         - Component name displayed in h1
- * @param {string}   opts.description  - Lead paragraph HTML
- * @param {string}   opts.content      - Full HTML body (demos + props table)
- * @param {object|null} opts.prev      - { label, href } or null
- * @param {object|null} opts.next      - { label, href } or null
- */
-export function renderComponentPage({ currentHref, name, description, content, prev = null, next = null }) {
-  return renderLayout({
-    currentHref,
-    prev,
-    next,
-    content: `
-      ${h1(name)}
-      ${lead(description)}
-      ${content}
-    `,
-  })
-}

package/docs/src/lib/highlight.js

@@ -1,2 +0,0 @@
-// Re-export from the framework's canonical highlight implementation.
-export { highlight } from '../../../src/md/highlight.js'

package/docs/src/lib/layout.js

@@ -1,190 +0,0 @@
-/**
- * Pulse Docs — Page layout
- *
- * renderLayout({ currentHref, content, prev, next }) → HTML string
- * Used by every docs page except the home page.
- */
-
-import { NAV } from './nav.js'
-import pkg from '../../../package.json' with { type: 'json' }
-
-// Resolve static asset paths through the build manifest (hashed in prod, raw in dev).
-// Populated by initLayoutManifest() in server.js before the server starts.
-let _manifest = {}
-export function initLayoutManifest(m) { _manifest = m }
-export const asset = href => _manifest[href] || href
-
-const version = typeof pkg !== 'undefined' ? (pkg?.version ?? '') : ''
-
-function esc(s) {
-  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
-}
-
-function sidebar(currentHref) {
-  const sections = NAV.map(({ section, items }) => {
-    const links = items.map(item => {
-      const active = item.href === currentHref
-      return `<a href="${esc(item.href)}" class="nav-link${active ? ' active' : ''}"${active ? ' aria-current="page"' : ''}>${esc(item.label)}</a>`
-    }).join('')
-    return `
-      <div class="nav-section">
-        <p class="nav-section-title">${esc(section)}</p>
-        ${links}
-      </div>`
-  }).join('')
-
-  return `
-    <aside class="docs-sidebar" id="docs-sidebar" aria-label="Documentation navigation">
-      <div class="sidebar-logo">
-        <a href="/" class="logo-link" aria-label="Pulse home">
-          <svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true">
-            <path d="M13 2L4.5 13.5H11L10 22L19.5 10.5H13L13 2Z" fill="var(--accent)" stroke="var(--accent)" stroke-width="1" stroke-linejoin="round"/>
-          </svg>
-          <span class="logo-name">Pulse</span>
-        </a>
-        <span class="version-badge">v${version}</span>
-      </div>
-      <div class="sidebar-search-wrap">
-        <svg class="sidebar-search-icon" width="14" height="14" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
-          <path fill-rule="evenodd" d="M8 4a4 4 0 100 8 4 4 0 000-8zM2 8a6 6 0 1110.89 3.476l4.817 4.817a1 1 0 01-1.414 1.414l-4.816-4.816A6 6 0 012 8z" clip-rule="evenodd"/>
-        </svg>
-        <input
-          type="search"
-          id="sidebar-search"
-          class="sidebar-search"
-          placeholder="Filter pages…"
-          aria-label="Filter documentation pages"
-          autocomplete="off"
-          spellcheck="false"
-        >
-        <button class="sidebar-search-full" aria-label="Search all docs content" title="Search all docs">
-          <svg width="14" height="14" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
-            <path fill-rule="evenodd" d="M3 4a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zm0 4a1 1 0 011-1h12a1 1 0 110 2H4a1 1 0 01-1-1zm0 4a1 1 0 011-1h7a1 1 0 110 2H4a1 1 0 01-1-1z" clip-rule="evenodd"/>
-          </svg>
-        </button>
-      </div>
-      <nav class="sidebar-nav" id="sidebar-nav">
-        ${sections}
-        <p class="sidebar-no-results" hidden>No pages found</p>
-      </nav>
-    </aside>
-    <div class="search-overlay" id="search-overlay" role="dialog" aria-modal="true" aria-label="Search documentation" hidden>
-      <div class="search-overlay-backdrop"></div>
-      <div class="search-overlay-panel">
-        <div class="search-overlay-header">
-          <div class="search-overlay-input-wrap">
-            <svg width="18" height="18" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
-              <path fill-rule="evenodd" d="M8 4a4 4 0 100 8 4 4 0 000-8zM2 8a6 6 0 1110.89 3.476l4.817 4.817a1 1 0 01-1.414 1.414l-4.816-4.816A6 6 0 012 8z" clip-rule="evenodd"/>
-            </svg>
-            <input
-              type="search"
-              id="search-overlay-input"
-              class="search-overlay-input"
-              placeholder="Search all docs…"
-              aria-label="Search all documentation"
-              autocomplete="off"
-              spellcheck="false"
-            >
-          </div>
-          <button class="search-overlay-close" aria-label="Close search">ESC</button>
-        </div>
-        <div class="search-overlay-results" id="search-overlay-results" role="listbox" aria-label="Search results"></div>
-        <div class="search-overlay-footer">
-          <span><kbd>↑</kbd><kbd>↓</kbd> navigate</span>
-          <span><kbd>↵</kbd> open</span>
-          <span><kbd>ESC</kbd> close</span>
-        </div>
-      </div>
-    </div>`
-}
-
-function prevNextBar(prev, next) {
-  if (!prev && !next) return ''
-  return `
-    <nav class="doc-prev-next" aria-label="Previous and next pages">
-      <div class="prev-next-grid">
-        ${prev ? `<a href="${esc(prev.href)}" class="prev-next-link prev-link">
-          <span class="prev-next-label">← Previous</span>
-          <span class="prev-next-title">${esc(prev.label)}</span>
-        </a>` : '<div></div>'}
-        ${next ? `<a href="${esc(next.href)}" class="prev-next-link next-link">
-          <span class="prev-next-label">Next →</span>
-          <span class="prev-next-title">${esc(next.label)}</span>
-        </a>` : '<div></div>'}
-      </div>
-    </nav>`
-}
-
-export function renderLayout({ currentHref, content, prev = null, next = null }) {
-  return `
-    <a href="#main-content" class="skip-link">Skip to main content</a>
-    <div class="sidebar-overlay" aria-hidden="true"></div>
-    ${sidebar(currentHref)}
-    <div class="docs-main">
-      <header class="docs-header">
-        <button class="mobile-menu-btn" aria-label="Toggle navigation menu" aria-expanded="false" aria-controls="docs-sidebar">
-          <svg width="20" height="20" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
-            <path fill-rule="evenodd" d="M2 4.75A.75.75 0 012.75 4h14.5a.75.75 0 010 1.5H2.75A.75.75 0 012 4.75zm0 10.5a.75.75 0 01.75-.75h14.5a.75.75 0 010 1.5H2.75a.75.75 0 01-.75-.75zM2 10a.75.75 0 01.75-.75h14.5a.75.75 0 010 1.5H2.75A.75.75 0 012 10z" clip-rule="evenodd"/>
-          </svg>
-        </button>
-        <a href="/" class="header-logo-mobile" aria-label="Pulse home">
-          <svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true">
-            <path d="M13 2L4.5 13.5H11L10 22L19.5 10.5H13L13 2Z" fill="var(--accent)" stroke="var(--accent)" stroke-width="1" stroke-linejoin="round"/>
-          </svg>
-        </a>
-        <a href="https://github.com/invisibleloop/pulse-framework" class="header-github" aria-label="View on GitHub (opens in new tab)" target="_blank" rel="noopener noreferrer">
-          <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
-            <path d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"/>
-          </svg>
-          GitHub
-        </a>
-      </header>
-      <main class="docs-content" id="main-content">
-        ${content}
-        ${prevNextBar(prev, next)}
-      </main>
-    </div>
-    <script src="${asset('/menu.js')}" defer></script>
-    <script src="${asset('/pulse-ui.js')}" defer></script>`
-}
-
-/**
- * Convenience helpers used in every page's view function
- */
-
-export function h1(text) {
-  return `<h1 class="doc-h1">${esc(text)}</h1>`
-}
-
-export function lead(text) {
-  return `<p class="doc-lead">${text}</p>`
-}
-
-export function section(id, title) {
-  return `<h2 class="doc-h2" id="${esc(id)}"><a href="#${esc(id)}" class="heading-anchor">${esc(title)}</a></h2>`
-}
-
-export function sub(id, title) {
-  const label = title ?? id
-  return `<h3 class="doc-h3" id="${esc(id)}"><a href="#${esc(id)}" class="heading-anchor">${esc(label)}</a></h3>`
-}
-
-export function codeBlock(highlighted, filename = '') {
-  const header = filename ? `<div class="code-filename">${esc(filename)}</div>` : ''
-  return `${header}<pre class="code-block"><code>${highlighted}</code></pre>`
-}
-
-export function table(headers, rows, caption = '') {
-  const cap = caption ? `<caption>${esc(caption)}</caption>` : ''
-  const ths = headers.map(h => `<th scope="col">${h}</th>`).join('')
-  const trs = rows.map(row =>
-    `<tr>${row.map(cell => `<td>${cell}</td>`).join('')}</tr>`
-  ).join('')
-  return `<div class="table-wrap"><table>${cap}<thead><tr>${ths}</tr></thead><tbody>${trs}</tbody></table></div>`
-}
-
-export function callout(type, content) {
-  // type: 'note' | 'warning' | 'tip'
-  const icons = { note: 'ℹ', warning: '⚠', tip: '✦' }
-  return `<div class="callout callout-${esc(type)}"><span class="callout-icon" aria-hidden="true">${icons[type] || 'ℹ'}</span><div class="callout-body">${content}</div></div>`
-}

package/docs/src/lib/metrics-store.js

@@ -1,6 +0,0 @@
-/**
- * Shared metrics holder. Populated by docs/server.js at startup
- * before createServer() is called. home.js reads from here so
- * the spec file stays free of Node built-ins (safe to bundle for browser).
- */
-export const metricsStore = { current: null }

package/docs/src/lib/nav.js

@@ -1,171 +0,0 @@
-/**
- * Pulse Docs — Navigation structure
- */
-
-export const NAV = [
-  {
-    section: 'Framework',
-    items: [
-      { label: 'Overview',          href: '/'                  },
-      { label: 'FAQ',               href: '/faq'               },
-      { label: 'Project Structure', href: '/project-structure' },
-      { label: 'Spec Reference',    href: '/spec'              },
-      { label: 'Configuration',     href: '/config'            },
-    ],
-  },
-  {
-    section: 'Developer Guide',
-    items: [
-      { label: 'Getting Started',   href: '/getting-started'   },
-      { label: 'How It Works',      href: '/how-it-works'      },
-      { label: 'Slash Commands',    href: '/slash-commands'    },
-      { label: 'Prompt Examples',   href: '/prompt-examples'   },
-      { label: 'Component Library', href: '/components'        },
-    ],
-  },
-  {
-    section: 'State & Behaviour',
-    items: [
-      { label: 'State',        href: '/state'       },
-      { label: 'Mutations',    href: '/mutations'   },
-      { label: 'Actions',      href: '/actions'     },
-      { label: 'Validation',   href: '/validation'  },
-      { label: 'Constraints',  href: '/constraints' },
-      { label: 'Persist',      href: '/persist'     },
-    ],
-  },
-  {
-    section: 'Server',
-    items: [
-      { label: 'Server Data',    href: '/server-data'   },
-      { label: 'Markdown',       href: '/markdown'      },
-      { label: 'Global Store',   href: '/store'         },
-      { label: 'Routing',        href: '/routing'       },
-      { label: 'Error Pages',    href: '/error-pages'   },
-      { label: 'Streaming SSR',  href: '/streaming'     },
-      { label: 'Caching',        href: '/caching'       },
-      { label: 'Guard',          href: '/guard'         },
-      { label: 'Forms',          href: '/forms'         },
-      { label: 'Raw Responses',  href: '/raw-responses' },
-      { label: 'Server API',     href: '/server-api'    },
-      { label: 'Extending Pulse', href: '/extending'    },
-    ],
-  },
-  {
-    section: 'Client',
-    items: [
-      { label: 'Hydration',   href: '/hydration'  },
-      { label: 'Navigation',  href: '/navigation' },
-      { label: 'Images',      href: '/images'     },
-    ],
-  },
-  {
-    section: 'Deployment',
-    items: [
-      { label: 'Deployment', href: '/deploy' },
-    ],
-  },
-  {
-    section: 'Reference',
-    items: [
-      { label: 'Metadata & SEO',  href: '/meta'          },
-      { label: 'Performance',     href: '/performance'   },
-      { label: 'Accessibility',   href: '/accessibility' },
-      { label: 'Testing',         href: '/testing'       },
-    ],
-  },
-  {
-    section: 'UI Components',
-    items: [
-      { label: 'Alert',       href: '/components/alert'       },
-      { label: 'Avatar',      href: '/components/avatar'      },
-      { label: 'Badge',       href: '/components/badge'       },
-      { label: 'Breadcrumbs', href: '/components/breadcrumbs' },
-      { label: 'Button',      href: '/components/button'      },
-      { label: 'Card',        href: '/components/card'        },
-      { label: 'Checkbox',    href: '/components/checkbox'    },
-      { label: 'Charts',      href: '/components/charts'      },
-      { label: 'Empty',       href: '/components/empty'       },
-      { label: 'Fieldset',    href: '/components/fieldset'    },
-      { label: 'File Upload', href: '/components/file-upload' },
-      { label: 'Heading',     href: '/components/heading'     },
-      { label: 'Icons',       href: '/components/icons'       },
-      { label: 'Image',       href: '/components/image'       },
-      { label: 'Input',       href: '/components/input'       },
-      { label: 'Modal',       href: '/components/modal'       },
-      { label: 'Progress',    href: '/components/progress'    },
-      { label: 'Prose',       href: '/components/prose'       },
-      { label: 'Pullquote',   href: '/components/pullquote'   },
-      { label: 'Radio',       href: '/components/radio'       },
-      { label: 'Rating',      href: '/components/rating'      },
-      { label: 'Search',      href: '/components/search'      },
-      { label: 'Segmented',   href: '/components/segmented'   },
-      { label: 'Select',      href: '/components/select'      },
-      { label: 'Slider',      href: '/components/slider'      },
-      { label: 'Spinner',     href: '/components/spinner'     },
-      { label: 'Stat',        href: '/components/stat'        },
-      { label: 'Stepper',     href: '/components/stepper'     },
-      { label: 'Table',       href: '/components/table'       },
-      { label: 'Textarea',    href: '/components/textarea'    },
-      { label: 'Toggle',      href: '/components/toggle'      },
-      { label: 'Tooltip',     href: '/components/tooltip'     },
-    ],
-  },
-  {
-    section: 'Landing Components',
-    items: [
-      { label: 'Accordion',   href: '/components/accordion'   },
-      { label: 'App Badge',   href: '/components/app-badge'   },
-      { label: 'CTA',         href: '/components/cta'         },
-      { label: 'Feature',     href: '/components/feature'     },
-      { label: 'Hero',        href: '/components/hero'        },
-      { label: 'Nav',         href: '/components/nav'         },
-      { label: 'Phone Frame', href: '/components/phone-frame' },
-    ],
-  },
-  {
-    section: 'Layout Components',
-    items: [
-      { label: 'Cluster',     href: '/components/cluster'     },
-      { label: 'Container',   href: '/components/container'   },
-      { label: 'Divider',     href: '/components/divider'     },
-      { label: 'Footer',      href: '/components/footer'      },
-      { label: 'Grid',        href: '/components/grid'        },
-      { label: 'Media',       href: '/components/media'       },
-      { label: 'Section',     href: '/components/section'     },
-      { label: 'Stack',       href: '/components/stack'       },
-    ],
-  },
-  {
-    section: 'Integrations',
-    items: [
-      { label: 'Supabase',          href: '/supabase' },
-      { label: 'Auth (Auth0)',      href: '/auth'     },
-      { label: 'Payments (Stripe)', href: '/stripe'   },
-    ],
-  },
-  {
-    section: 'Templates',
-    items: [
-      { label: 'All Templates',        href: '/templates'                   },
-      { label: 'Mobile App Landing',   href: '/templates/mobile-app'        },
-      { label: 'Blog Post',            href: '/templates/blog-post'         },
-      { label: 'Swish — Fashion',      href: '/templates/swish'             },
-      { label: 'BookWorms',            href: '/templates/bookworms'         },
-      { label: 'Retro Wheels Co.',     href: '/templates/retrowheels'       },
-      { label: 'Susuki Bento',         href: '/templates/suzukibento'       },
-      { label: 'Andy Pixel — Blog',    href: '/templates/andypixel'         },
-      { label: 'Journey — App',        href: '/templates/journey'           },
-      { label: 'Shop — Product Page',  href: '/templates/shop'              },
-    ],
-  },
-]
-
-export function prevNext(currentHref) {
-  const all = NAV.flatMap(s => s.items)
-  const idx = all.findIndex(i => i.href === currentHref)
-  return {
-    prev: idx > 0             ? all[idx - 1] : null,
-    next: idx < all.length - 1 ? all[idx + 1] : null,
-  }
-}