camelmind 0.1.0

package/template/app/api/raw/route.ts

@@ -0,0 +1,43 @@
+import { NextRequest, NextResponse } from "next/server"
+import fs from "fs"
+import path from "path"
+import { getSession } from "@/lib/auth"
+import { isAuthEnabled } from "@/lib/config"
+
+export async function GET(req: NextRequest) {
+  const session = await getSession()
+  if (isAuthEnabled() && !session) {
+    return new NextResponse("Unauthorized", { status: 401 })
+  }
+
+  const file = req.nextUrl.searchParams.get("file")
+  const download = req.nextUrl.searchParams.get("download") === "1"
+
+  if (!file) {
+    return new NextResponse("Missing file param", { status: 400 })
+  }
+
+  // Only allow reading from the content directory
+  const resolved = path.resolve(process.cwd(), file)
+  const contentRoot = path.resolve(process.cwd(), "content")
+  if (!resolved.startsWith(contentRoot)) {
+    return new NextResponse("Forbidden", { status: 403 })
+  }
+
+  if (!fs.existsSync(resolved)) {
+    return new NextResponse("Not found", { status: 404 })
+  }
+
+  const raw = fs.readFileSync(resolved, "utf-8")
+  const filename = path.basename(resolved).replace(/\.mdx?$/, ".md")
+
+  const headers: Record<string, string> = {
+    "Content-Type": "text/plain; charset=utf-8",
+  }
+
+  if (download) {
+    headers["Content-Disposition"] = `attachment; filename="${filename}"`
+  }
+
+  return new NextResponse(raw, { headers })
+}

package/template/app/api/search/route.ts

@@ -0,0 +1,138 @@
+import { NextRequest, NextResponse } from "next/server"
+import { loadNav, getAllSlugs, getNavEntryBySlug, getSectionForSlug } from "@/lib/nav"
+import { loadMdxFile } from "@/lib/mdx"
+import { getSession, hasAccess } from "@/lib/auth"
+import { isAuthEnabled } from "@/lib/config"
+import type { NavGroup } from "@/lib/nav-types"
+
+type SearchIndex = {
+  slug: string
+  title: string
+  description?: string
+  body: string
+  group?: string       // top-level nav group (Getting Started, Platform & Security…)
+  section?: string     // section label (Authorization Path, Entrance Criteria…)
+  roles: string[]
+}
+
+let _index: SearchIndex[] | null = null
+
+function buildIndex(): SearchIndex[] {
+  if (_index) return _index
+
+  const nav = loadNav()
+  const slugs = getAllSlugs()
+  const index: SearchIndex[] = []
+
+  const groupMap = new Map<string, string>()
+  for (const item of nav.nav) {
+    if ("dropdown" in item) {
+      const group = item as NavGroup
+      for (const entry of group.items) {
+        groupMap.set(entry.slug, group.label)
+        if (entry.section) {
+          for (const child of entry.section) {
+            groupMap.set(child.slug, group.label)
+            if (child.children) {
+              for (const grandchild of child.children) {
+                groupMap.set(grandchild.slug, group.label)
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+  for (const slug of slugs) {
+    const entry = getNavEntryBySlug(slug)
+    if (!entry || !entry.file) continue
+
+    try {
+      const { frontmatter, source } = loadMdxFile(entry.file)
+      const body = source
+        .replace(/<[^>]+>/g, " ")
+        .replace(/[#*`>|]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+
+      const sectionEntry = getSectionForSlug(slug)
+
+      index.push({
+        slug,
+        title: frontmatter.title,
+        description: frontmatter.description,
+        body,
+        group: groupMap.get(slug),
+        section: sectionEntry?.label,
+        roles: entry.roles ?? [],
+      })
+    } catch {
+      // skip missing files
+    }
+  }
+
+  _index = index
+  return index
+}
+
+export async function GET(req: NextRequest) {
+  const session = await getSession()
+  const authEnabled = isAuthEnabled()
+
+  if (authEnabled && !session) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 })
+  }
+
+  const userRoles = session?.roles ?? []
+  const q = req.nextUrl.searchParams.get("q")?.toLowerCase().trim() ?? ""
+  const filterGroup = req.nextUrl.searchParams.get("group") ?? ""
+  const filterRole = req.nextUrl.searchParams.get("role") ?? ""
+
+  const index = buildIndex()
+  const accessible = authEnabled
+    ? index.filter((doc) => hasAccess(doc.roles, userRoles))
+    : index
+  if (!q) {
+    const groups = [...new Set(accessible.map((d) => d.group).filter(Boolean))]
+    return NextResponse.json({ results: [], groups })
+  }
+
+  const terms = q.split(/\s+/).filter(Boolean)
+
+  const scored = accessible
+    .filter((doc) => {
+      if (filterGroup && doc.group !== filterGroup) return false
+      if (filterRole && !doc.roles.includes(filterRole) && doc.roles.length > 0) return false
+      return true
+    })
+    .map((doc) => {
+      const titleLower = doc.title.toLowerCase()
+      const descLower = (doc.description ?? "").toLowerCase()
+      const bodyLower = doc.body.toLowerCase()
+
+      let score = 0
+      for (const term of terms) {
+        if (titleLower.includes(term)) score += 10
+        if (descLower.includes(term)) score += 5
+        if (bodyLower.includes(term)) score += 1
+      }
+
+      let excerpt = doc.description ?? ""
+      if (!excerpt) {
+        const idx = bodyLower.indexOf(terms[0])
+        if (idx >= 0) {
+          excerpt = doc.body.slice(Math.max(0, idx - 30), idx + 100).trim()
+        }
+      }
+
+      return { ...doc, score, excerpt }
+    })
+    .filter((d) => d.score > 0)
+    .sort((a, b) => b.score - a.score)
+    .slice(0, 10)
+    .map(({ body: _body, score: _score, ...rest }) => rest)
+
+  const groups = [...new Set(accessible.map((d) => d.group).filter(Boolean))]
+  return NextResponse.json({ results: scored, groups })
+}

package/template/app/globals.css

@@ -0,0 +1,524 @@
+@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+
+/* Tailwind v4 dark mode — toggled by .dark class on <html> */
+@custom-variant dark (&:where(.dark, .dark *));
+
+/* ── CamelMind design tokens (Sahara theme) ── */
+:root {
+  --cm-camel-gold: #D8A15B;
+  --cm-sandstone: #F4D6A7;
+  --cm-oasis-teal: #4BA8B7;
+  --cm-caravan-brown: #6A4B33;
+  --cm-night-dune: #1E2833;
+  --cm-parchment: #FFF6E9;
+  --cm-dune-beige: #E7D7BF;
+  --cm-palm-green: #8FA65C;
+  --cm-sunset-gold: #E8B34E;
+  --cm-shadow-brown: #4B3424;
+  --cm-border-sand: #E6DCCB;
+
+  --cm-primary: var(--cm-oasis-teal);
+  --cm-success: #5B9B62;
+  --cm-warning: #D9A441;
+  --cm-danger: #C76B56;
+
+  --cm-bg-primary: var(--cm-parchment);
+  --cm-bg-secondary: #FCF8F1;
+  --cm-bg-tertiary: #F7F1E7;
+  --cm-text-primary: var(--cm-caravan-brown);
+  --cm-text-secondary: #7A624F;
+  --cm-text-muted: #9B8876;
+  --cm-border: var(--cm-border-sand);
+  --cm-link: var(--cm-oasis-teal);
+  --cm-link-hover: #388A97;
+
+  --cm-btn-primary-bg: var(--cm-oasis-teal);
+  --cm-btn-primary-text: #FFFFFF;
+
+  --cm-note-bg: #EAF7FA;
+  --cm-note-border: #4BA8B7;
+  --cm-tip-bg: #EEF7EC;
+  --cm-tip-border: #5B9B62;
+  --cm-warning-bg: #FFF6E2;
+  --cm-warning-border: #D9A441;
+  --cm-danger-bg: #FFF0EC;
+  --cm-danger-border: #C76B56;
+
+  --cm-radius-md: 10px;
+  --cm-font-heading: var(--font-alegreya), Georgia, serif;
+  --cm-font-body: var(--font-inter), system-ui, sans-serif;
+  --cm-font-mono: var(--font-jetbrains-mono), monospace;
+
+  --cm-active: var(--cm-oasis-teal);
+  --cm-active-border: var(--cm-oasis-teal);
+}
+
+.dark {
+  --cm-bg-primary: #1E2833;
+  --cm-bg-secondary: #26323F;
+  --cm-bg-tertiary: #2D3B4A;
+  --cm-text-primary: #F8F2E8;
+  --cm-text-secondary: #D7C8B4;
+  --cm-text-muted: #B8A996;
+  --cm-border: #3B4A5A;
+  --cm-link: #63C1CF;
+  --cm-link-hover: #7AD2DE;
+  --cm-active: #63C1CF;
+  --cm-active-border: #63C1CF;
+}
+
+.cm-primary-button {
+  background: var(--cm-btn-primary-bg);
+  color: var(--cm-btn-primary-text);
+  border-radius: var(--cm-radius-md);
+}
+
+/* ── Callout / Admonition styles ── */
+
+.callout {
+  margin-bottom: 1.25rem;
+  border-radius: 8px;
+  font-size: 1rem;
+  background-color: #fdfdfd;
+  border: 1.5px solid #bbbbbb;
+  overflow: hidden;
+}
+
+.callout-header {
+  border-radius: 8px 8px 0 0;
+  font-weight: 700;
+  font-size: 0.85rem;
+  padding: 0.4rem 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: #1f1f1f;
+}
+
+.callout-body {
+  padding: 0.75rem;
+  font-size: 0.95rem;
+  color: #333;
+}
+
+.callout.note  { border-color: var(--cm-note-border); }
+.callout.note  .callout-header { background-color: var(--cm-note-bg); color: var(--cm-text-primary); }
+
+.callout.tip   { border-color: var(--cm-tip-border); }
+.callout.tip   .callout-header { background-color: var(--cm-tip-bg); color: var(--cm-text-primary); }
+
+.callout.warning { border-color: var(--cm-warning-border); }
+.callout.warning .callout-header { background-color: var(--cm-warning-bg); color: var(--cm-text-primary); }
+
+.callout.important { border-color: var(--cm-oasis-teal); }
+.callout.important .callout-header { background-color: var(--cm-note-bg); color: var(--cm-text-primary); }
+
+.callout.danger  { border-color: var(--cm-danger-border); }
+.callout.danger  .callout-header { background-color: var(--cm-danger-bg); color: var(--cm-text-primary); }
+
+.callout.success { border-color: var(--cm-tip-border); }
+.callout.success .callout-header { background-color: var(--cm-tip-bg); color: var(--cm-text-primary); }
+
+body {
+  font-family: var(--cm-font-body);
+}
+
+/* ── Prose refinements ── */
+
+/* Tighter max-width for better line length */
+.prose {
+  max-width: 680px;
+}
+
+/* Alternating table rows — no cell borders */
+.prose table {
+  border-collapse: collapse;
+  width: 100%;
+}
+.prose thead th {
+  background-color: #f4f4f4;
+  border-bottom: 2px solid #e0e0e0;
+  padding: 0.55rem 0.85rem;
+  text-align: left;
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: #333;
+}
+.prose tbody td {
+  padding: 0.55rem 0.85rem;
+  border: none;
+  font-size: 0.9rem;
+  vertical-align: top;
+}
+.prose tbody tr:nth-child(even) td {
+  background-color: #f9f9f9;
+}
+.prose tbody tr:nth-child(odd) td {
+  background-color: #ffffff;
+}
+
+/* Remove underlines from heading anchor links */
+.prose h1 a,
+.prose h2 a,
+.prose h3 a,
+.prose h4 a,
+.prose h5 a,
+.prose h6 a {
+  text-decoration: none;
+}
+
+/* Strip background and restore color for code inside pre (code blocks) */
+.prose pre code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+  font-size: inherit;
+  color: #e2e8f0;
+}
+
+/* Inline code — covers both backtick syntax and raw <code> tags in MDX */
+.prose code {
+  background-color: #f3f4f6;
+  color: #1f2937;
+  padding: 0.15rem 0.375rem;
+  border-radius: 0.25rem;
+  font-size: 0.875rem;
+  font-weight: normal;
+  font-family: ui-monospace, monospace;
+}
+
+/* Remove backtick pseudo-elements added by @tailwindcss/typography */
+@layer utilities {
+  .prose code::before,
+  .prose code::after {
+    content: none;
+  }
+}
+
+/* Softer code block background */
+.prose pre, pre {
+  background-color: #1a1d23 !important;
+  border-radius: 8px;
+}
+
+/* Timeline container */
+.timeline {
+  display: flex;
+  flex-direction: column; /* stack vertically for better responsiveness */
+  justify-content: flex-start;
+  align-items: flex-start;
+  padding-top: 1.5rem;
+}
+
+/* Wrapper for all timeline steps */
+.timeline-content {
+  width: 100%;
+  position: relative;
+  padding-left: 1.5rem;
+}
+
+/* Individual timeline item */
+.timeline-item {
+  margin-bottom: 2.5rem;
+  position: relative;
+  padding-left: 2rem;
+  max-width: 100%;
+}
+
+/* Numbered circle — used by raw HTML divs in MDX */
+.timeline-item::before {
+  content: attr(data-step);
+  position: absolute;
+  left: -2rem;
+  top: 0;
+  background-color: #636363;
+  color: white;
+  width: 30px;
+  height: 30px;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  border-radius: 50%;
+  font-weight: bold;
+  font-size: 16px;
+  z-index: 1;
+}
+
+/* When a real <a> renders the circle (Step component), suppress ::before */
+.timeline-item:has(.timeline-step-anchor:not(:empty))::before {
+  display: none;
+}
+
+/* Anchor link that IS the circle — same geometry as ::before */
+.timeline-step-anchor {
+  position: absolute;
+  left: -2rem;
+  top: 0;
+  background-color: #636363;
+  color: white;
+  width: 30px;
+  height: 30px;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  border-radius: 50%;
+  font-weight: bold;
+  font-size: 16px;
+  z-index: 1;
+  text-decoration: none;
+  transition: background-color 0.15s;
+}
+
+.timeline-step-anchor:hover {
+  background-color: #444;
+}
+
+/* Dotted vertical line */
+.timeline-item:not(.last-item)::after {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: -1.25rem;
+  width: 2px;
+  height: calc(100% + 40px);
+  background-color: transparent;
+  border-left: 2px dotted #dadde1;
+}
+
+/* Timeline heading spacing */
+.timeline-item h3 {
+  margin-bottom: 0.5rem;
+}
+
+/* Timeline images */
+.timeline-image img {
+  max-width: 100%;
+  max-height: 300px;
+  border-radius: 4px;
+  margin-top: 0.5rem;
+}
+
+
+/* Image zoom */
+.prose img {
+  cursor: zoom-in;
+  transition: transform 0.3s ease-in-out;
+  position: relative;
+  z-index: 1;
+  border-radius: 6px;
+}
+
+.prose img.zoomed {
+  transform: scale(1.7);
+  cursor: zoom-out;
+  z-index: 9999;
+  position: relative;
+}
+
+
+/* ── Dark mode overrides ── */
+
+.dark .callout {
+  background-color: #1e2027;
+  border-color: #374151;
+}
+
+.dark .callout-header {
+  color: #f3f4f6;
+}
+
+.dark .callout-body {
+  color: #d1d5db;
+}
+
+.dark .callout.note  { border-color: #3b5ea6; }
+.dark .callout.note  .callout-header { background-color: #1e3a5f; }
+
+.dark .callout.tip   { border-color: #3b4ea6; }
+.dark .callout.tip   .callout-header { background-color: #1e2f6b; }
+
+.dark .callout.warning { border-color: #7c5a2a; }
+.dark .callout.warning .callout-header { background-color: #4a3010; }
+
+.dark .callout.important { border-color: #1a7a70; }
+.dark .callout.important .callout-header { background-color: #0d3d39; }
+
+.dark .callout.danger  { border-color: #7c2a2a; }
+.dark .callout.danger  .callout-header { background-color: #4a1010; }
+
+.dark .callout.success { border-color: #2a6b2a; }
+.dark .callout.success .callout-header { background-color: #103a10; }
+
+/* Dark prose — tables, code, headings */
+.dark .prose {
+  color: #d1d5db;
+}
+
+.dark .prose h1,
+.dark .prose h2,
+.dark .prose h3,
+.dark .prose h4 {
+  color: #f3f4f6;
+}
+
+.dark .prose strong {
+  color: #f3f4f6;
+}
+
+.dark .prose a {
+  color: #93c5fd;
+}
+
+.dark .prose h1 a,
+.dark .prose h2 a,
+.dark .prose h3 a,
+.dark .prose h4 a,
+.dark .prose h5 a,
+.dark .prose h6 a {
+  color: inherit;
+}
+
+.dark .prose thead th {
+  background-color: #1f2937;
+  border-bottom-color: #374151;
+  color: #d1d5db;
+}
+
+.dark .prose tbody tr:nth-child(even) td {
+  background-color: #1a1f2e;
+}
+
+.dark .prose tbody tr:nth-child(odd) td {
+  background-color: #111827;
+}
+
+.dark .prose code:not(pre code) {
+  background-color: #1f2937;
+  color: #e5e7eb;
+}
+
+.dark .prose pre code {
+  background: none !important;
+  color: #e2e8f0;
+}
+
+/* Prose link styles override the circle's color — win specificity back */
+.prose .timeline-step-anchor,
+.dark .prose .timeline-step-anchor {
+  color: white;
+}
+
+/* Dark timeline */
+.dark .timeline-item::before {
+  background-color: #4b5563;
+}
+
+.dark .timeline-step-anchor {
+  background-color: #4b5563;
+  color: white;
+}
+
+.dark .timeline-step-anchor:hover {
+  background-color: #6b7280;
+}
+
+.dark .timeline-item:not(.last-item)::after {
+  border-left-color: #374151;
+}
+
+/* ── Print / PDF styles ── */
+@media print {
+  /* Hide all chrome — nav, sidebar, ToC, actions, footer */
+  nav,
+  aside,
+  footer,
+  [data-print="hide"],
+  .print\:hidden {
+    display: none !important;
+  }
+
+  /* Break the h-screen / overflow layout so full content prints.
+     Target Tailwind utility classes directly — they map 1:1 to CSS selectors. */
+  html,
+  body,
+  .h-screen,
+  .h-full {
+    height: auto !important;
+    min-height: 0 !important;
+  }
+
+  .overflow-hidden,
+  .overflow-y-auto,
+  .overflow-x-hidden {
+    overflow: visible !important;
+  }
+
+  /* flex-1 inside a fixed-height container would clip; release it */
+  .flex-1 {
+    flex: none !important;
+    height: auto !important;
+  }
+
+  /* Full-width article */
+  article {
+    max-width: 100% !important;
+    padding: 0 !important;
+    margin: 0 !important;
+  }
+
+  /* Expand all <details> elements — also handled via JS in generate-pdfs.ts */
+  details,
+  details[open] {
+    display: block !important;
+  }
+  details > :not(summary) {
+    display: block !important;
+    visibility: visible !important;
+  }
+
+  /* Avoid breaking inside callouts, code blocks, tables, timeline steps */
+  .callout,
+  pre,
+  table,
+  figure,
+  .timeline-item {
+    break-inside: avoid;
+    page-break-inside: avoid;
+  }
+
+  /* Keep headings with the content below them */
+  h1, h2, h3, h4 {
+    break-after: avoid;
+    page-break-after: avoid;
+  }
+
+  /* Remove link underlines and interactive cursor */
+  a {
+    text-decoration: none !important;
+    color: inherit !important;
+  }
+
+  /* Disable image zoom cursor */
+  .prose img {
+    cursor: default !important;
+    transform: none !important;
+    max-width: 100%;
+  }
+
+  /* Code blocks — keep dark background */
+  pre, code {
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  /* Callout backgrounds */
+  .callout {
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+  }
+
+  /* Page margins */
+  @page {
+    margin: 18mm 16mm 18mm 16mm;
+  }
+}