} ); } function TOC({ items }) { const [active, setActive] = React.useState(items[0]?.id); React.useEffect(() => { const handler = () => { let current = items[0]?.id; for (const it of items) { const el = document.getElementById(it.id); if (el && el.getBoundingClientRect().top < 120) current = it.id; } setActive(current); }; handler(); window.addEventListener('scroll', handler, { passive: true }); return () => window.removeEventListener('scroll', handler); }, [items]); return ( ); } function CodeBlock({ tabs, filename, defaultTab = 0, pretty, code, raw, label }) { // Backward-compat: older invocations pass `pretty` (plain text) + // `code` (HTML-tinted) instead of `tabs`. Synthesize a single tab so // the rest of the component renders the same way. Without this the // component throws `Cannot read properties of undefined (reading // '0')` and the whole guide page errors out. const resolvedTabs = tabs ?? [ { label: label ?? filename ?? "code", code: code ?? pretty ?? "", raw: raw ?? pretty, }, ]; const [active, setActive] = React.useState(defaultTab); const [copied, setCopied] = React.useState(false); const current = resolvedTabs[active]; const copy = () => { const text = current.raw || current.code.replace(/<[^>]+>/g, ''); navigator.clipboard?.writeText(text); setCopied(true); setTimeout(() => setCopied(false), 1400); }; return (

{resolvedTabs.length > 1 ? (

{resolvedTabs.map((t, i) => ( ))}

) : ( {filename || resolvedTabs[0].label} )}

); } // Dot — render Graphviz DOT source to inline SVG. // Lazily loads viz-js from a CDN on first mount. If rendering fails // (offline preview, CSP, blocked CDN), shows the DOT source as a code // block so readers always see something. A rejected load is not cached, // so a transient network blip doesn't permanently disable diagrams. let vizLoadingPromise = null; function loadViz() { if (window.Viz) return Promise.resolve(window.Viz); if (vizLoadingPromise) return vizLoadingPromise; vizLoadingPromise = new Promise((resolve, reject) => { const s = document.createElement('script'); s.src = 'https://unpkg.com/@viz-js/viz@3.2.4/lib/viz-standalone.js'; s.onload = () => resolve(window.Viz); s.onerror = () => { vizLoadingPromise = null; // clear on failure so next mount can retry reject(new Error('viz-js load failed')); }; document.head.appendChild(s); }); return vizLoadingPromise; } function Dot({ src, caption, maxWidth = 780, ariaLabel }) { const hostRef = React.useRef(null); const [state, setState] = React.useState('loading'); React.useEffect(() => { let cancelled = false; (async () => { try { await loadViz(); const viz = await window.Viz.instance(); if (cancelled) return; const svg = viz.renderSVGElement(src); svg.removeAttribute('width'); svg.removeAttribute('height'); svg.style.maxWidth = '100%'; svg.style.height = 'auto'; const host = hostRef.current; if (host) { while (host.firstChild) host.removeChild(host.firstChild); host.appendChild(svg); setState('ready'); } } catch (_) { if (!cancelled) setState('error'); } })(); return () => { cancelled = true; }; }, [src]); // Keep the host div (which we mutate imperatively) separate from any // React-managed sibling. Sharing a parent would cause React's reconciler // to trip over nodes we already removed via appendChild/removeChild. return (

{state === 'loading' && (

rendering diagram…

)} {state === 'error' && (

{src}

)}

{caption && (

{caption}

)}

); } function Callout({ type = 'info', title, children }) { const icons = { info: 'info', warn: 'warn', note: 'sparkle', danger: 'warn' }; return (

{title &&

{title}

}

{children}

); } function Feedback() { const [rating, setRating] = React.useState(null); const [sent, setSent] = React.useState(false); if (sent) { return (

Thanks for the feedback.

We read every note and use it to improve these docs.

); } return (

Was this page helpful?

Your feedback helps us sharpen the docs.

<div className="row">
          <button className="btn-ghost" onClick={() => setRating(null)}>Cancel</button>
          <button className="btn-primary" onClick={() => setSent(true)}>Send feedback</button>
        </div>
      </div>
    </div>
  );
}

function PageFoot({ prev, next }) {
  return (
    <div className="page-foot">
      {prev ? (
        <a href={prev.href}>
          <div className="label">← Previous</div>
          <div className="title"><Icon name="arrowL" size={12} /> {prev.label}</div>
        </a>
      ) : <div />}
      {next ? (
        <a href={next.href} className="next">
          <div className="label">Next →</div>
          <div className="title">{next.label} <Icon name="arrowR" size={12} /></div>
        </a>
      ) : <div />}
    </div>
  );
}

const SEARCH_INDEX = [
  // Getting started
  { group: 'Getting started', title: 'Introduction — self-hostable AI memory for production agents', path: '/', href: 'index.html', icon: 'book' },
  { group: 'Getting started', title: 'Quickstart — uv add memgc and your first call', path: '/quickstart', href: 'quickstart.html', icon: 'rocket' },

// Concepts
  { group: 'Concepts', title: 'How it works — extract, retrieve, consolidate, sweep', path: '/concepts/how', href: 'index.html#how', icon: 'puzzle' },
  { group: 'Concepts', title: 'Calibrated decay — 6-component score + half-life', path: '/concepts/decay', href: 'index.html#decay', icon: 'cpu' },
  { group: 'Concepts', title: 'Hybrid recall — vector + BM25 via tokio::join', path: '/concepts/hybrid', href: 'index.html#hybrid', icon: 'zap' },
  { group: 'Concepts', title: 'Audit & lineage — version chain + persistent SQL log', path: '/concepts/audit', href: 'audit.html', icon: 'shield' },
  { group: 'Concepts', title: 'Injection safety — six prompt-injection defenses', path: '/concepts/injection', href: 'index.html#injection', icon: 'shield' },
  { group: 'Concepts', title: 'Storage backends — SQLite, Postgres, in-memory', path: '/concepts/storage', href: 'index.html#storage', icon: 'database' },

// Reference
  { group: 'Reference', title: 'Public API overview', path: '/api', href: 'api.html', icon: 'code' },
  { group: 'Reference', title: 'MemGC handle — extract, retrieve, consolidate, sweep', path: '/api/memgc', href: 'api.html#memgc', icon: 'code' },
  { group: 'Reference', title: 'Memory — id, scope, content, tags, embedding', path: '/api/memory', href: 'api.html#memory', icon: 'database' },
  { group: 'Reference', title: 'Storage trait — SQLite, Postgres, InMemory', path: '/api/storage', href: 'api.html#storage', icon: 'database' },
  { group: 'Reference', title: 'Embedder trait — OpenAI, Azure, Voyage, Mock', path: '/api/embedder', href: 'api.html#embedder', icon: 'cpu' },
  { group: 'Reference', title: 'AuditEntry — op, scope_or_id, at, duration_ms, ok', path: '/api/audit', href: 'audit.html#api', icon: 'list' },

// Validation
  { group: 'Validation', title: 'LongMemEval R@5 = 0.984 on 450-question held-out', path: '/longmemeval', href: 'longmemeval.html', icon: 'sparkle' },
  { group: 'Validation', title: 'Benchmark integrity disclosure — what we tuned, what we measured', path: '/longmemeval#integrity', href: 'longmemeval.html#integrity', icon: 'shield' },

// Project
  { group: 'Project', title: 'License — Apache 2.0 (with patent grant)', path: '/license', href: 'license.html', icon: 'leaf' },
  { group: 'Project', title: 'GitHub — github.com/carrickcheah/memgc', path: '/github', href: 'https://github.com/carrickcheah/memgc', icon: 'ext' },
  { group: 'Project', title: 'PyPI — pypi.org/project/memgc', path: '/pypi', href: 'https://pypi.org/project/memgc/', icon: 'ext' },
];

React.useEffect(() => {
    if (!open) return;
    const onKey = (e) => {
      if (e.key === 'Escape') onClose();
      if (e.key === 'ArrowDown') { e.preventDefault(); setFocus(f => Math.min(flat.length - 1, f + 1)); }
      if (e.key === 'ArrowUp') { e.preventDefault(); setFocus(f => Math.max(0, f - 1)); }
      if (e.key === 'Enter' && flat[focus]) {
        window.location.href = flat[focus].href;
      }
    };
    window.addEventListener('keydown', onKey);
    return () => window.removeEventListener('keydown', onKey);
  }, [open, flat, focus, onClose]);

function TweaksPanel({ visible, theme, setTheme }) {
  if (!visible) return null;
  return (
    <div className="tweaks-panel visible">
      <div className="tweaks-title">Tweaks</div>
      <div className="tweaks-row">
        <span>Theme</span>
        <div className="toggle-group">
          <button className={`toggle-btn ${theme === 'light' ? 'active' : ''}`} onClick={() => setTheme('light')}>Light</button>
          <button className={`toggle-btn ${theme === 'dark' ? 'active' : ''}`} onClick={() => setTheme('dark')}>Dark</button>
        </div>
      </div>
    </div>
  );
}

function useShell(defaultTheme = 'light') {
  const [theme, setThemeState] = React.useState(() => localStorage.getItem('memgc-theme') || defaultTheme);
  const [searchOpen, setSearchOpen] = React.useState(false);
  const [tweaksVisible, setTweaksVisible] = React.useState(false);
  const [mobileMenuOpen, setMobileMenuOpen] = React.useState(false);

const setTheme = React.useCallback((t) => {
    setThemeState(t);
    localStorage.setItem('memgc-theme', t);
    document.documentElement.setAttribute('data-theme', t);
  }, []);

React.useEffect(() => {
    document.documentElement.setAttribute('data-theme', theme);
  }, [theme]);

React.useEffect(() => {
    const onKey = (e) => {
      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') {
        e.preventDefault();
        setSearchOpen(s => !s);
      }
    };
    window.addEventListener('keydown', onKey);
    return () => window.removeEventListener('keydown', onKey);
  }, []);

// Lock body scroll when mobile drawer is open
  React.useEffect(() => {
    document.body.style.overflow = mobileMenuOpen ? 'hidden' : '';
    return () => { document.body.style.overflow = ''; };
  }, [mobileMenuOpen]);

return {
    theme, setTheme,
    searchOpen, setSearchOpen,
    tweaksVisible,
    mobileMenuOpen, setMobileMenuOpen,
  };
}

Object.assign(window, {
  Icon, Topbar, Sidebar, TOC, CodeBlock, Callout, Dot, Feedback, PageFoot,
  SearchOverlay, TweaksPanel, useShell, NAV, SEARCH_INDEX,
});