prev-cli 0.5.0 → 0.7.0

package/dist/cli.js

@@ -71,45 +71,104 @@ async function ensureCacheDir(rootDir) {
 import fg from "fast-glob";
 import { readFile } from "fs/promises";
 import path2 from "path";
+function parseFrontmatter(content) {
+  const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+  const match = content.match(frontmatterRegex);
+  if (!match) {
+    return { frontmatter: {}, content };
+  }
+  const frontmatterStr = match[1];
+  const restContent = content.slice(match[0].length);
+  const frontmatter = {};
+  for (const line of frontmatterStr.split(`
+`)) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1)
+      continue;
+    const key = line.slice(0, colonIndex).trim();
+    let value = line.slice(colonIndex + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    if (value === "true")
+      value = true;
+    else if (value === "false")
+      value = false;
+    else if (!isNaN(Number(value)) && value !== "")
+      value = Number(value);
+    if (key) {
+      frontmatter[key] = value;
+    }
+  }
+  return { frontmatter, content: restContent };
+}
+function isIndexFile(basename) {
+  const lower = basename.toLowerCase();
+  return lower === "index" || lower === "readme";
+}
 function fileToRoute(file) {
   const withoutExt = file.replace(/\.mdx?$/, "");
-  if (withoutExt === "index") {
-    return "/";
-  }
-  if (withoutExt.endsWith("/index")) {
-    return "/" + withoutExt.slice(0, -6);
+  const basename = path2.basename(withoutExt).toLowerCase();
+  if (basename === "index" || basename === "readme") {
+    const dir = path2.dirname(withoutExt);
+    if (dir === ".") {
+      return "/";
+    }
+    return "/" + dir;
   }
   return "/" + withoutExt;
 }
 async function scanPages(rootDir) {
   const files = await fg.glob("**/*.{md,mdx}", {
     cwd: rootDir,
-    ignore: ["node_modules/**", "dist/**", ".cache/**"]
+    ignore: ["node_modules/**", "dist/**", ".cache/**"],
+    dot: true
   });
-  const pages = [];
+  const routeMap = new Map;
   for (const file of files) {
+    const route = fileToRoute(file);
+    const basename = path2.basename(file, path2.extname(file)).toLowerCase();
+    const priority = basename === "index" ? 1 : basename === "readme" ? 2 : 0;
+    const existing = routeMap.get(route);
+    if (!existing || priority > 0 && priority < existing.priority) {
+      routeMap.set(route, { file, priority });
+    }
+  }
+  const pages = [];
+  for (const { file } of routeMap.values()) {
     const fullPath = path2.join(rootDir, file);
-    const content = await readFile(fullPath, "utf-8");
-    const title = extractTitle(content, file);
-    pages.push({
+    const rawContent = await readFile(fullPath, "utf-8");
+    const { frontmatter, content } = parseFrontmatter(rawContent);
+    const title = extractTitle(content, file, frontmatter);
+    const page = {
       route: fileToRoute(file),
       title,
       file
-    });
+    };
+    if (frontmatter.description) {
+      page.description = frontmatter.description;
+    }
+    if (Object.keys(frontmatter).length > 0) {
+      page.frontmatter = frontmatter;
+    }
+    pages.push(page);
   }
   return pages.sort((a, b) => a.route.localeCompare(b.route));
 }
-function extractTitle(content, file) {
+function extractTitle(content, file, frontmatter) {
+  if (frontmatter?.title && typeof frontmatter.title === "string") {
+    return frontmatter.title;
+  }
   const match = content.match(/^#\s+(.+)$/m);
   if (match) {
     return match[1].trim();
   }
-  const basename = path2.basename(file, path2.extname(file));
-  if (basename === "index") {
+  const basename = path2.basename(file, path2.extname(file)).toLowerCase();
+  if (isIndexFile(basename)) {
     const dirname = path2.dirname(file);
     return dirname === "." ? "Home" : capitalize(path2.basename(dirname));
   }
-  return capitalize(basename);
+  return capitalize(path2.basename(file, path2.extname(file)));
 }
 function capitalize(str) {
   return str.charAt(0).toUpperCase() + str.slice(1).replace(/-/g, " ");

package/dist/vite/pages.d.ts

@@ -1,13 +1,27 @@
+export interface Frontmatter {
+    title?: string;
+    description?: string;
+    [key: string]: unknown;
+}
 export interface Page {
     route: string;
     title: string;
     file: string;
+    description?: string;
+    frontmatter?: Frontmatter;
 }
 export interface SidebarItem {
     title: string;
     route?: string;
     children?: SidebarItem[];
 }
+/**
+ * Parse YAML frontmatter from markdown content
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: Frontmatter;
+    content: string;
+};
 export declare function fileToRoute(file: string): string;
 export declare function scanPages(rootDir: string): Promise<Page[]>;
 export declare function buildSidebarTree(pages: Page[]): SidebarItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prev-cli",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Transform MDX directories into beautiful documentation websites",
   "type": "module",
   "license": "MIT",

package/src/theme/Layout.tsx

@@ -1,4 +1,4 @@
-import React, { useState } from 'react'
+import React, { useState, useEffect } from 'react'
 import { Link, useLocation } from '@tanstack/react-router'
 import type { PageTree } from 'fumadocs-core/server'
 
@@ -7,6 +7,40 @@ interface LayoutProps {
   children: React.ReactNode
 }
 
+function SidebarToggle({ collapsed, onToggle }: { collapsed: boolean; onToggle: () => void }) {
+  return (
+    <button
+      className="sidebar-toggle"
+      onClick={onToggle}
+      aria-label={collapsed ? 'Expand sidebar' : 'Collapse sidebar'}
+    >
+      {collapsed ? (
+        <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+          <path d="M3 12h18M3 6h18M3 18h18" />
+        </svg>
+      ) : (
+        <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+          <path d="M11 19l-7-7 7-7M18 19l-7-7 7-7" />
+        </svg>
+      )}
+    </button>
+  )
+}
+
+function CollapsedFolderIcon({ item, onClick }: { item: PageTree.Folder; onClick: () => void }) {
+  return (
+    <button
+      className="sidebar-rail-icon"
+      onClick={onClick}
+      title={item.name}
+    >
+      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+        <path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z" />
+      </svg>
+    </button>
+  )
+}
+
 interface SidebarItemProps {
   item: PageTree.Item | PageTree.Folder
   depth?: number
@@ -88,25 +122,61 @@ function ThemeToggle() {
 }
 
 export function Layout({ tree, children }: LayoutProps) {
+  const [collapsed, setCollapsed] = useState(() => {
+    if (typeof window !== 'undefined') {
+      return localStorage.getItem('sidebar-collapsed') === 'true'
+    }
+    return false
+  })
+
   // Initialize theme from localStorage
-  React.useEffect(() => {
+  useEffect(() => {
     const saved = localStorage.getItem('theme')
     const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches
     const isDark = saved === 'dark' || (!saved && prefersDark)
     document.documentElement.classList.toggle('dark', isDark)
   }, [])
 
+  // Persist collapsed state
+  useEffect(() => {
+    localStorage.setItem('sidebar-collapsed', String(collapsed))
+  }, [collapsed])
+
+  const toggleCollapsed = () => setCollapsed(!collapsed)
+
+  // Get top-level folders for collapsed rail
+  const topFolders = tree.children.filter(
+    (item): item is PageTree.Folder => item.type === 'folder'
+  )
+
   return (
-    <div className="prev-layout">
+    <div className={`prev-layout ${collapsed ? 'sidebar-collapsed' : ''}`}>
       <aside className="prev-sidebar">
-        <nav className="sidebar-nav">
-          {tree.children.map((item, i) => (
-            <SidebarItem key={i} item={item} />
-          ))}
-        </nav>
-        <div className="sidebar-footer">
-          <ThemeToggle />
+        <div className="sidebar-header">
+          <SidebarToggle collapsed={collapsed} onToggle={toggleCollapsed} />
         </div>
+        {collapsed ? (
+          <div className="sidebar-rail">
+            {topFolders.map((folder, i) => (
+              <CollapsedFolderIcon
+                key={i}
+                item={folder}
+                onClick={toggleCollapsed}
+              />
+            ))}
+          </div>
+        ) : (
+          <>
+            <nav className="sidebar-nav">
+              {tree.children.map((item, i) => (
+                <SidebarItem key={i} item={item} />
+              ))}
+            </nav>
+            <div className="sidebar-footer">
+              <ThemeToggle />
+            </div>
+          </>
+        )}
       </aside>
       <main className="prev-main">
         {children}

package/src/theme/diagrams.tsx

@@ -1,6 +1,195 @@
 import { useEffect } from 'react'
 import { useLocation } from '@tanstack/react-router'
 
+// Diagram controls and fullscreen functionality
+function createDiagramControls(container: HTMLElement): void {
+  // Skip if already has controls
+  if (container.querySelector('.diagram-controls')) return
+
+  const wrapper = document.createElement('div')
+  wrapper.className = 'diagram-wrapper'
+
+  // Move container content to wrapper
+  const svg = container.querySelector('svg')
+  if (!svg) return
+
+  // Create controls
+  const controls = document.createElement('div')
+  controls.className = 'diagram-controls'
+  controls.innerHTML = `
+    <button class="diagram-btn diagram-zoom-in" title="Zoom in">
+      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35M11 8v6M8 11h6"/>
+      </svg>
+    </button>
+    <button class="diagram-btn diagram-zoom-out" title="Zoom out">
+      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35M8 11h6"/>
+      </svg>
+    </button>
+    <button class="diagram-btn diagram-fullscreen" title="Fullscreen">
+      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M8 3H5a2 2 0 00-2 2v3m18 0V5a2 2 0 00-2-2h-3m0 18h3a2 2 0 002-2v-3M3 16v3a2 2 0 002 2h3"/>
+      </svg>
+    </button>
+  `
+
+  // Track zoom level
+  let scale = 1
+  const minScale = 0.5
+  const maxScale = 3
+  const scaleStep = 0.25
+
+  const updateScale = () => {
+    svg.style.transform = `scale(${scale})`
+    svg.style.transformOrigin = 'center center'
+  }
+
+  // Zoom in
+  controls.querySelector('.diagram-zoom-in')?.addEventListener('click', (e) => {
+    e.stopPropagation()
+    if (scale < maxScale) {
+      scale += scaleStep
+      updateScale()
+    }
+  })
+
+  // Zoom out
+  controls.querySelector('.diagram-zoom-out')?.addEventListener('click', (e) => {
+    e.stopPropagation()
+    if (scale > minScale) {
+      scale -= scaleStep
+      updateScale()
+    }
+  })
+
+  // Fullscreen
+  controls.querySelector('.diagram-fullscreen')?.addEventListener('click', (e) => {
+    e.stopPropagation()
+    openFullscreenModal(svg.outerHTML)
+  })
+
+  container.appendChild(controls)
+}
+
+function openFullscreenModal(svgHtml: string): void {
+  // Remove existing modal if any
+  document.querySelector('.diagram-modal')?.remove()
+
+  const modal = document.createElement('div')
+  modal.className = 'diagram-modal'
+
+  let scale = 1
+  let translateX = 0
+  let translateY = 0
+  let isDragging = false
+  let startX = 0
+  let startY = 0
+
+  modal.innerHTML = `
+    <div class="diagram-modal-backdrop"></div>
+    <div class="diagram-modal-content">
+      <div class="diagram-modal-controls">
+        <button class="diagram-btn modal-zoom-in" title="Zoom in">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35M11 8v6M8 11h6"/>
+          </svg>
+        </button>
+        <button class="diagram-btn modal-zoom-out" title="Zoom out">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <circle cx="11" cy="11" r="8"/><path d="M21 21l-4.35-4.35M8 11h6"/>
+          </svg>
+        </button>
+        <button class="diagram-btn modal-reset" title="Reset view">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <path d="M3 12a9 9 0 109-9 9.75 9.75 0 00-6.74 2.74L3 8"/><path d="M3 3v5h5"/>
+          </svg>
+        </button>
+        <button class="diagram-btn modal-close" title="Close">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <path d="M18 6L6 18M6 6l12 12"/>
+          </svg>
+        </button>
+      </div>
+      <div class="diagram-modal-svg-container">
+        ${svgHtml}
+      </div>
+    </div>
+  `
+
+  const svgContainer = modal.querySelector('.diagram-modal-svg-container') as HTMLElement
+  const svg = svgContainer?.querySelector('svg') as SVGElement
+
+  const updateTransform = () => {
+    if (svg) {
+      svg.style.transform = `translate(${translateX}px, ${translateY}px) scale(${scale})`
+      svg.style.transformOrigin = 'center center'
+    }
+  }
+
+  // Zoom controls
+  modal.querySelector('.modal-zoom-in')?.addEventListener('click', () => {
+    scale = Math.min(scale + 0.25, 5)
+    updateTransform()
+  })
+
+  modal.querySelector('.modal-zoom-out')?.addEventListener('click', () => {
+    scale = Math.max(scale - 0.25, 0.25)
+    updateTransform()
+  })
+
+  modal.querySelector('.modal-reset')?.addEventListener('click', () => {
+    scale = 1
+    translateX = 0
+    translateY = 0
+    updateTransform()
+  })
+
+  // Close handlers
+  const closeModal = () => modal.remove()
+  modal.querySelector('.modal-close')?.addEventListener('click', closeModal)
+  modal.querySelector('.diagram-modal-backdrop')?.addEventListener('click', closeModal)
+
+  // Keyboard close
+  const handleKeydown = (e: KeyboardEvent) => {
+    if (e.key === 'Escape') {
+      closeModal()
+      document.removeEventListener('keydown', handleKeydown)
+    }
+  }
+  document.addEventListener('keydown', handleKeydown)
+
+  // Pan with mouse drag
+  svgContainer?.addEventListener('mousedown', (e) => {
+    isDragging = true
+    startX = e.clientX - translateX
+    startY = e.clientY - translateY
+    svgContainer.style.cursor = 'grabbing'
+  })
+
+  document.addEventListener('mousemove', (e) => {
+    if (!isDragging) return
+    translateX = e.clientX - startX
+    translateY = e.clientY - startY
+    updateTransform()
+  })
+
+  document.addEventListener('mouseup', () => {
+    isDragging = false
+    if (svgContainer) svgContainer.style.cursor = 'grab'
+  })
+
+  // Mouse wheel zoom
+  svgContainer?.addEventListener('wheel', (e) => {
+    e.preventDefault()
+    const delta = e.deltaY > 0 ? -0.1 : 0.1
+    scale = Math.min(Math.max(scale + delta, 0.25), 5)
+    updateTransform()
+  })
+
+  document.body.appendChild(modal)
+}
+
 // Simple hash function for cache keys
 function hashCode(str: string): string {
   let hash = 0
@@ -67,6 +256,7 @@ async function renderMermaidDiagrams() {
       container.innerHTML = cached
       pre.style.display = 'none'
       pre.insertAdjacentElement('afterend', container)
+      createDiagramControls(container)
       continue
     }
 
@@ -82,6 +272,7 @@ async function renderMermaidDiagrams() {
       cacheSvg('mermaid', code, svg)
       pre.style.display = 'none'
       pre.insertAdjacentElement('afterend', container)
+      createDiagramControls(container)
     } catch (e) {
       console.error('Mermaid render error:', e)
     }
@@ -110,6 +301,7 @@ async function renderD2Diagrams() {
       container.innerHTML = cached
       pre.style.display = 'none'
       pre.insertAdjacentElement('afterend', container)
+      createDiagramControls(container)
       continue
     }
 
@@ -132,6 +324,7 @@ async function renderD2Diagrams() {
       cacheSvg('d2', code, svg)
       pre.style.display = 'none'
       pre.insertAdjacentElement('afterend', container)
+      createDiagramControls(container)
     } catch (e) {
       console.error('D2 render error:', e)
     }

package/src/theme/styles.css

@@ -16,9 +16,15 @@ body {
 
 /* Layout structure */
 .prev-layout {
+  --sidebar-width: 260px;
   display: grid;
-  grid-template-columns: 260px 1fr;
+  grid-template-columns: var(--sidebar-width) 1fr;
   min-height: 100vh;
+  transition: grid-template-columns 0.2s ease;
+}
+
+.prev-layout.sidebar-collapsed {
+  --sidebar-width: 50px;
 }
 
 /* Sidebar */
@@ -26,11 +32,74 @@ body {
   position: sticky;
   top: 0;
   height: 100vh;
+  width: var(--sidebar-width);
   background: var(--fd-background);
   border-right: 1px solid var(--fd-border);
   display: flex;
   flex-direction: column;
   overflow: hidden;
+  transition: width 0.2s ease;
+}
+
+/* Sidebar header with toggle */
+.sidebar-header {
+  padding: 0.75rem;
+  border-bottom: 1px solid var(--fd-border);
+  display: flex;
+  justify-content: flex-start;
+}
+
+.sidebar-collapsed .sidebar-header {
+  justify-content: center;
+}
+
+.sidebar-toggle {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  background: var(--fd-muted);
+  border: none;
+  border-radius: 0.5rem;
+  color: var(--fd-muted-foreground);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.sidebar-toggle:hover {
+  background: var(--fd-accent);
+  color: var(--fd-accent-foreground);
+}
+
+/* Collapsed rail */
+.sidebar-rail {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 0.5rem;
+  gap: 0.5rem;
+  flex: 1;
+  overflow-y: auto;
+}
+
+.sidebar-rail-icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  background: transparent;
+  border: none;
+  border-radius: 0.5rem;
+  color: var(--fd-muted-foreground);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.sidebar-rail-icon:hover {
+  background: var(--fd-muted);
+  color: var(--fd-foreground);
 }
 
 .sidebar-nav {
@@ -178,12 +247,114 @@ body {
   border-radius: 0.5rem;
   display: flex;
   justify-content: center;
+  position: relative;
+  overflow: hidden;
 }
 
 .mermaid-diagram svg,
 .d2-diagram svg {
   max-width: 100%;
   height: auto;
+  transition: transform 0.2s ease;
+}
+
+/* Diagram hover controls */
+.diagram-controls {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  display: flex;
+  gap: 0.25rem;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+  z-index: 10;
+}
+
+.mermaid-diagram:hover .diagram-controls,
+.d2-diagram:hover .diagram-controls {
+  opacity: 1;
+}
+
+.diagram-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  background: var(--fd-background);
+  border: 1px solid var(--fd-border);
+  border-radius: 0.375rem;
+  color: var(--fd-muted-foreground);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.diagram-btn:hover {
+  background: var(--fd-accent);
+  color: var(--fd-accent-foreground);
+  border-color: var(--fd-accent);
+}
+
+/* Fullscreen modal */
+.diagram-modal {
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.diagram-modal-backdrop {
+  position: absolute;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.8);
+  backdrop-filter: blur(4px);
+}
+
+.diagram-modal-content {
+  position: relative;
+  width: 90vw;
+  height: 90vh;
+  background: var(--fd-background);
+  border-radius: 0.75rem;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+}
+
+.diagram-modal-controls {
+  display: flex;
+  gap: 0.5rem;
+  padding: 0.75rem;
+  border-bottom: 1px solid var(--fd-border);
+  background: var(--fd-muted);
+}
+
+.diagram-modal-controls .diagram-btn {
+  width: 36px;
+  height: 36px;
+}
+
+.diagram-modal-controls .modal-close {
+  margin-left: auto;
+}
+
+.diagram-modal-svg-container {
+  flex: 1;
+  overflow: hidden;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: grab;
+  padding: 2rem;
+}
+
+.diagram-modal-svg-container svg {
+  max-width: none;
+  max-height: none;
+  transition: transform 0.1s ease;
 }
 
 /* Smooth page transitions */