mordoc 0.1.13 → 1.0.0

package/src/app/header/SearchModal.module.css

@@ -0,0 +1,185 @@
+/* ============================================================
+   SEARCH MODAL TOKENS
+   ============================================================ */
+:root {
+  --modal-max-width:    640px;
+  --modal-overlay-bg:  rgba(0, 0, 0, 0.45);
+  --modal-bg:          var(--color-bg);
+  --modal-border:      var(--color-border);
+  --modal-shadow:      0 24px 64px rgba(0, 0, 0, 0.22);
+  --modal-input-size:  16px;
+  --modal-result-hover: var(--color-bg-hover);
+  --modal-result-selected: var(--accent-subtle);
+}
+
+:global(.dark) {
+  --modal-overlay-bg: rgba(0, 0, 0, 0.65);
+}
+
+/* ============================================================
+   OVERLAY — full-screen backdrop
+   ============================================================ */
+.overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  background: var(--modal-overlay-bg);
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding-top: 8vh;
+  padding-inline: 1rem;
+}
+
+/* ============================================================
+   MODAL SHELL
+   ============================================================ */
+.modal {
+  width: 100%;
+  max-width: var(--modal-max-width);
+  background: var(--modal-bg);
+  border: 1px solid var(--modal-border);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--modal-shadow);
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+}
+
+/* ============================================================
+   INPUT ROW
+   ============================================================ */
+.inputRow {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 0 14px;
+  height: 54px;
+  border-bottom: 1px solid var(--modal-border);
+  flex-shrink: 0;
+}
+
+.searchIcon {
+  color: var(--color-fg-muted);
+  flex-shrink: 0;
+}
+
+.input {
+  flex: 1;
+  background: none;
+  border: none;
+  outline: none;
+  font-family: var(--font-sans);
+  font-size: var(--modal-input-size);
+  color: var(--color-fg);
+  min-width: 0;
+}
+
+.input::placeholder {
+  color: var(--color-fg-muted);
+}
+
+.input:disabled {
+  cursor: not-allowed;
+}
+
+.closeBtn {
+  display: flex;
+  align-items: center;
+  background: none;
+  border: none;
+  padding: 0;
+  cursor: pointer;
+  flex-shrink: 0;
+}
+
+.closeBtn kbd {
+  display: inline-flex;
+  align-items: center;
+  padding: 2px 7px;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-sm);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  font-weight: 500;
+  color: var(--color-fg-muted);
+  background: var(--color-surface);
+}
+
+/* ============================================================
+   STATUS / NOTICES
+   ============================================================ */
+.notice,
+.status {
+  padding: 20px 16px;
+  color: var(--color-fg-muted);
+  font-size: 13px;
+  text-align: center;
+  line-height: 1.6;
+}
+
+.notice code {
+  font-family: var(--font-mono);
+  font-size: 12px;
+  background: var(--color-surface);
+  padding: 1px 5px;
+  border-radius: var(--radius-sm);
+  border: 1px solid var(--color-border);
+}
+
+/* ============================================================
+   RESULTS LIST
+   ============================================================ */
+.results {
+  list-style: none;
+  margin: 0;
+  padding: 6px;
+  max-height: 420px;
+  overflow-y: auto;
+}
+
+.result {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  padding: 10px 12px;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: background-color 0.1s;
+}
+
+.result:hover {
+  background: var(--modal-result-hover);
+}
+
+.resultSelected {
+  background: var(--modal-result-selected);
+}
+
+.resultTitle {
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--color-fg);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.resultExcerpt {
+  font-size: 12px;
+  color: var(--color-fg-muted);
+  line-height: 1.55;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+/* Pagefind wraps matched terms in <mark> for highlighting */
+.resultExcerpt :global(mark) {
+  background: var(--accent-muted);
+  color: var(--color-fg);
+  border-radius: 2px;
+  padding: 0 2px;
+  font-style: normal;
+}

package/src/app/header/SearchModal.tsx

@@ -0,0 +1,245 @@
+import { useEffect, useRef, useState } from 'react';
+import { useNavigate } from 'react-router';
+import styles from './SearchModal.module.css';
+
+// Module-level singleton so the loaded Pagefind instance is reused across
+// open/close cycles. Replaced atomically when the language changes.
+let pf: PagefindAPI | null = null;
+let pfLoadPromise: Promise<void> | null = null;
+let currentIndexPath: string | null = null;
+
+/**
+ * Loads (or switches to) the Pagefind index at `indexPath`.
+ *
+ * Called from App.tsx on every language change, including the initial mount.
+ * Switching languages:
+ *   1. Destroys the previous Pagefind instance to release index memory.
+ *   2. Resets module state so any in-progress search awaits the new index.
+ *   3. Starts fetching the new index manifest in the background.
+ *
+ * Race-condition guard: if another switch fires before this load completes,
+ * the stale `.then()` handler checks `currentIndexPath` and discards itself.
+ */
+export function switchPagefind(indexPath: string): void {
+  if (indexPath === currentIndexPath) return;
+
+  pf?.destroy?.();
+  pf = null;
+  pfLoadPromise = null;
+  currentIndexPath = indexPath;
+
+  pfLoadPromise = import(/* @vite-ignore */ indexPath)
+    .then(async (mod) => {
+      if (currentIndexPath !== indexPath) return; // superseded by a later switch
+      pf = mod as PagefindAPI;
+      await mod.init?.();
+    })
+    .catch(() => {
+      if (currentIndexPath === indexPath) {
+        pf = null;
+        pfLoadPromise = null;
+        currentIndexPath = null;
+      }
+    });
+}
+
+interface SearchModalProps {
+  open: boolean;
+  onClose: () => void;
+}
+
+interface SearchResult {
+  id: string;
+  url: string;
+  title: string;
+  excerpt: string;
+}
+
+/**
+ * Full-screen search modal with Pagefind-powered results.
+ *
+ * Dev mode: shows the input disabled with a "build required" notice, since
+ * the Pagefind index only exists after `mordoc build` has run.
+ *
+ * Production: queries the preloaded Pagefind index on every keystroke
+ * (debounced). If the index is still loading when the user types, the
+ * component awaits the load promise before running the query.
+ *
+ * Keyboard navigation: ↑/↓ moves between results, Enter navigates, Esc closes.
+ *
+ * Result excerpts use dangerouslySetInnerHTML for Pagefind's <mark> highlights.
+ * This is safe — the content comes from our own indexed pages, not user input.
+ */
+export function SearchModal({ open, onClose }: SearchModalProps) {
+  const [query, setQuery] = useState('');
+  const [results, setResults] = useState<SearchResult[]>([]);
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const [isLoading, setIsLoading] = useState(false);
+  const inputRef = useRef<HTMLInputElement>(null);
+  const navigate = useNavigate();
+
+  const isDev = import.meta.env.DEV;
+
+  // Focus input on open; reset state on close
+  useEffect(() => {
+    if (open) {
+      setQuery('');
+      setResults([]);
+      setSelectedIndex(0);
+      requestAnimationFrame(() => inputRef.current?.focus());
+    }
+  }, [open]);
+
+  // Global Escape listener — handles dev mode where the disabled input
+  // swallows keyboard events and they never reach the modal's onKeyDown.
+  useEffect(() => {
+    if (!open) return;
+    function handleEscape(e: KeyboardEvent) {
+      if (e.key === 'Escape') onClose();
+    }
+    document.addEventListener('keydown', handleEscape);
+    return () => document.removeEventListener('keydown', handleEscape);
+  }, [open, onClose]);
+
+  // Debounced search — waits 180 ms after the last keystroke
+  useEffect(() => {
+    if (!query.trim() || isDev) {
+      setResults([]);
+      return;
+    }
+
+    const timerId = setTimeout(async () => {
+      if (!pf) {
+        if (pfLoadPromise) {
+          setIsLoading(true);
+          await pfLoadPromise;
+          setIsLoading(false);
+        }
+        if (!pf) return;
+      }
+
+      const capturedQuery = query;
+      try {
+        const { results: raw } = await pf.search(capturedQuery);
+        const resolved = await Promise.all(
+          raw.slice(0, 8).map(async (r) => {
+            const data = await r.data();
+            return {
+              id: r.id,
+              url: data.url,
+              title: data.meta?.title ?? data.url,
+              excerpt: data.excerpt,
+            };
+          }),
+        );
+        setResults(resolved);
+        setSelectedIndex(0);
+      } catch {
+        setResults([]);
+      }
+    }, 180);
+
+    return () => clearTimeout(timerId);
+  }, [query, isDev]);
+
+  function handleKeyDown(e: React.KeyboardEvent) {
+    if (e.key === 'Escape') {
+      onClose();
+    } else if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      setSelectedIndex((i) => Math.min(i + 1, results.length - 1));
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      setSelectedIndex((i) => Math.max(i - 1, 0));
+    } else if (e.key === 'Enter' && results[selectedIndex]) {
+      onClose();
+      navigate(results[selectedIndex].url);
+    }
+  }
+
+  if (!open) return null;
+
+  return (
+    <div
+      className={styles.overlay}
+      onClick={(e) => { if (e.target === e.currentTarget) onClose(); }}
+      role="dialog"
+      aria-modal="true"
+      aria-label="Search"
+    >
+      <div className={styles.modal} onKeyDown={handleKeyDown}>
+        <div className={styles.inputRow}>
+          <svg
+            className={styles.searchIcon}
+            width="18"
+            height="18"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            strokeWidth="2"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            aria-hidden="true"
+          >
+            <circle cx="11" cy="11" r="8" />
+            <line x1="21" y1="21" x2="16.65" y2="16.65" />
+          </svg>
+          <input
+            ref={inputRef}
+            className={styles.input}
+            type="text"
+            placeholder={isDev ? 'Search unavailable in dev mode' : 'Search docs…'}
+            value={query}
+            onChange={(e) => setQuery(e.target.value)}
+            disabled={isDev}
+            aria-label="Search"
+          />
+          <button
+            className={styles.closeBtn}
+            onClick={onClose}
+            aria-label="Close search"
+            type="button"
+          >
+            <kbd>esc</kbd>
+          </button>
+        </div>
+
+        {isDev && (
+          <div className={styles.notice}>
+            Search is only available after running <code>mordoc build</code>.
+          </div>
+        )}
+
+        {!isDev && isLoading && (
+          <div className={styles.status}>Loading search index…</div>
+        )}
+
+        {!isDev && !isLoading && query.trim() && results.length === 0 && (
+          <div className={styles.status}>No results for &ldquo;{query}&rdquo;</div>
+        )}
+
+        {results.length > 0 && (
+          <ul className={styles.results} role="listbox">
+            {results.map((result, i) => (
+              <li
+                key={result.id}
+                role="option"
+                aria-selected={i === selectedIndex}
+                className={`${styles.result}${i === selectedIndex ? ` ${styles.resultSelected}` : ''}`}
+                onClick={() => { onClose(); navigate(result.url); }}
+                onMouseEnter={() => setSelectedIndex(i)}
+              >
+                <span className={styles.resultTitle}>{result.title}</span>
+                {/* Pagefind wraps matched terms in <mark> — safe to inject as HTML */}
+                <span
+                  className={styles.resultExcerpt}
+                  dangerouslySetInnerHTML={{ __html: result.excerpt }}
+                />
+              </li>
+            ))}
+          </ul>
+        )}
+      </div>
+    </div>
+  );
+}

package/src/app/header/Topnav.module.css

@@ -0,0 +1,37 @@
+/* Topnav lives in the second header row (.topnavRow in Header.module.css).
+   Links use height: 100% + a bottom-border indicator for the active state. */
+.topnav {
+  display: flex;
+  align-items: stretch;
+  gap: 0;
+  height: 100%;
+}
+
+.link {
+  display: flex;
+  align-items: center;
+  padding: 0 0.75rem;
+  color: var(--color-fg-muted);
+  text-decoration: none;
+  font-size: 0.875rem;
+  font-weight: 500;
+  white-space: nowrap;
+  border-bottom: 2px solid transparent;
+  transition: color 0.15s, border-color 0.15s;
+  /* Shift content up by 1px so the bottom border doesn't push layout */
+  margin-bottom: -1px;
+}
+
+.link:hover {
+  color: var(--color-fg);
+}
+
+.link:focus-visible {
+  outline: 2px solid var(--accent-emphasis);
+  outline-offset: -2px;
+}
+
+.link.active {
+  color: var(--color-fg);
+  border-bottom-color: var(--accent-emphasis);
+}

package/src/app/header/Topnav.tsx

@@ -0,0 +1,30 @@
+import { NavLink, useLocation } from 'react-router';
+import { useMordocData } from '../data-context.js';
+import { detectCurrentLang, buildLangPrefix, resolveLabel } from '../lang-utils.js';
+import styles from './Topnav.module.css';
+
+export function Topnav() {
+  const { navigation, language, site, translations } = useMordocData();
+  const { pathname } = useLocation();
+
+  if (navigation.kind !== 'topnav') return null;
+
+  const currentLang = detectCurrentLang(pathname, language, site.defaultLanguage);
+  const prefix = buildLangPrefix(currentLang, site.defaultLanguage);
+
+  return (
+    <nav className={styles.topnav} aria-label="Top navigation">
+      {navigation.topnav.map((item) => (
+        <NavLink
+          key={item.path}
+          to={`${prefix}${item.path}`}
+          className={({ isActive }) =>
+            isActive ? `${styles.link} ${styles.active}` : styles.link
+          }
+        >
+          {resolveLabel(item.label, currentLang, site.defaultLanguage, translations)}
+        </NavLink>
+      ))}
+    </nav>
+  );
+}

package/src/app/index.css

@@ -0,0 +1,119 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
+
+/* ============================================================
+   ROOT TOKENS — global design primitives only.
+   Component-specific tokens live at the top of each component's
+   CSS module file (e.g. Sidenav.module.css, Header.module.css).
+   ============================================================ */
+:root {
+  /* Surfaces */
+  --color-bg:            #ffffff;
+  --color-surface:       #fafafa;
+  --color-border:        #e5e5e5;
+  --color-header-bg:     rgba(255, 255, 255);
+
+  /* Text */
+  --color-fg:            #1c1c1c;
+  --color-content-fg:    rgb(46, 46, 46);
+  --color-fg-muted:      #6b7280;
+
+  /* Interaction */
+  --color-bg-hover: #f3f4f6;
+
+  /* Accent — single configurable token; all other accent vars are derived.
+     Users override --accent (and optionally dark) in config/theme.css. */
+  --accent:          #D64518;
+  --accent-subtle:   color-mix(in oklch, var(--accent) 8%, white);
+  --accent-muted:    color-mix(in oklch, var(--accent) 20%, white);
+  --accent-emphasis: var(--accent);
+  --accent-strong:   color-mix(in oklch, var(--accent) 80%, black);
+  --accent-on:       white;
+
+  /* Layout — shared across multiple components */
+  --header-height:      4rem;
+  --topnav-height:      0px;
+  --header-total:       calc(var(--header-height) + var(--topnav-height));
+  --sidebar-width:      16rem;
+  --sidebar-width-icon: 3.5rem;
+  --toc-width:          16rem;
+  --content-max-width:  48rem;
+  --page-gutter:        2.5rem;
+
+  /* Typography */
+  --font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-mono: ui-monospace, 'Cascadia Code', 'Fira Code', 'Consolas', monospace;
+
+  /* Shape */
+  --radius-sm: 4px;
+  --radius-md: 6px;
+  --radius-lg: 10px;
+
+  /* Shadow */
+  --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.06), 0 1px 2px rgba(0, 0, 0, 0.04);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.07), 0 2px 4px -1px rgba(0, 0, 0, 0.04);
+}
+
+/* Dark mode overrides — global primitives only */
+.dark {
+  --color-bg:        #121212;
+  --color-surface:   #0f0f0f;
+  --color-border:    #2e2e2e;
+  --color-header-bg: rgba(18, 18, 18);
+
+  --color-fg:         #e2e8f0;
+  --color-content-fg: rgb(214, 214, 214);
+  --color-fg-muted:   #94a3b8;
+
+  --color-bg-hover: #1e2432;
+
+  /* Accent — re-derived for dark surfaces; --accent base stays the same */
+  --accent-subtle:   color-mix(in oklch, var(--accent) 12%, #121212);
+  --accent-muted:    color-mix(in oklch, var(--accent) 25%, #121212);
+  --accent-emphasis: color-mix(in oklch, var(--accent) 70%, white);
+  --accent-strong:   color-mix(in oklch, var(--accent) 50%, white);
+}
+
+/* ============================================================
+   BASE RESET
+   ============================================================ */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+html,
+body {
+  margin: 0;
+  padding: 0;
+  overscroll-behavior: none;
+}
+
+body {
+  background: var(--color-bg);
+  color: var(--color-fg);
+  font-family: var(--font-sans);
+  font-size: 15px;
+  line-height: 1.6;
+}
+
+/* Scrollbar */
+::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+::-webkit-scrollbar-thumb {
+  background: var(--color-border);
+  border-radius: 3px;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: var(--color-fg-muted);
+}

package/src/app/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="<!--ssr-lang-->">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <script>(()=>{try{if(localStorage.getItem('mordoc-theme')==='dark')document.documentElement.classList.add('dark')}catch(e){}})();</script>
+  <!--ssr-head-->
+</head>
+<body>
+  <div id="app"><!--ssr-outlet--></div>
+  <script type="module" src="/main.tsx"></script>
+</body>
+</html>

package/src/app/landing/LandingPage.module.css

@@ -0,0 +1,14 @@
+/* ── Landing page shell ───────────────────────────────────────── */
+
+.landing {
+  display: flex;
+  flex-direction: column;
+  min-height: calc(100svh - var(--header-total));
+}
+
+/* No padding — hero and section components each own their inner spacing
+   so full-bleed backgrounds can reach the viewport edge. */
+.content {
+  flex: 1;
+  width: 100%;
+}