Phase 3: Graph View, Backlinks UI, Quick Switcher, Dark Mode, Export

Features:
- GraphView.vue: SVG-based force-directed graph visualization for projects
- QuickSwitcher.vue: Cmd+K modal with fuzzy search via /search API
- Dark Mode: Theme toggle in Header, persisted in localStorage, system pref support
- Backlinks UI: Incoming and outgoing links in DocumentView
- Export: Document (markdown/JSON) and Project (ZIP/JSON) export with download
- New composables: useTheme.ts for dark/light/system theme management
- New store methods: fetchBacklinks, fetchOutgoingLinks, search, exportDocument, fetchProjectGraph, exportProject
- TypeScript types for all Phase 3 API responses
This commit is contained in:
Hiro
2026-03-30 23:47:17 +00:00
parent 24925e1acb
commit f758927848
11 changed files with 1563 additions and 10 deletions

View File

@@ -0,0 +1,419 @@
<script setup lang="ts">
import { ref, onMounted, onUnmounted, watch } from 'vue'
import { useRouter } from 'vue-router'
import { useProjectsStore } from '@/stores/projects'
import type { GraphData } from '@/types'
import Button from '@/components/common/Button.vue'
const props = defineProps<{
projectId: string
}>()
defineEmits<{
close: []
}>()
const router = useRouter()
const projectsStore = useProjectsStore()
const graphData = ref<GraphData | null>(null)
const loading = ref(false)
const error = ref<string | null>(null)
const depth = ref<1 | 2 | 3>(2)
// Node positions (computed by force simulation)
interface NodePos {
id: string
title: string
x: number
y: number
vx: number
vy: number
}
const nodePositions = ref<Map<string, NodePos>>(new Map())
const svgWidth = ref(800)
const svgHeight = ref(600)
const svgRef = ref<SVGSVGElement | null>(null)
const containerRef = ref<HTMLDivElement | null>(null)
async function loadGraph() {
loading.value = true
error.value = null
try {
graphData.value = await projectsStore.fetchProjectGraph(props.projectId, depth.value)
initializePositions()
runSimulation()
} catch (e) {
error.value = e instanceof Error ? e.message : 'Failed to load graph'
} finally {
loading.value = false
}
}
function initializePositions() {
if (!graphData.value) return
const centerX = svgWidth.value / 2
const centerY = svgHeight.value / 2
const radius = Math.min(svgWidth.value, svgHeight.value) * 0.35
const newPositions = new Map<string, NodePos>()
graphData.value.nodes.forEach((node, i) => {
const angle = (2 * Math.PI * i) / graphData.value!.nodes.length
newPositions.set(node.id, {
id: node.id,
title: node.title,
x: centerX + radius * Math.cos(angle),
y: centerY + radius * Math.sin(angle),
vx: 0,
vy: 0
})
})
nodePositions.value = newPositions
}
function runSimulation(iterations = 150) {
if (!graphData.value) return
for (let i = 0; i < iterations; i++) {
simulateStep()
}
}
function simulateStep() {
if (!graphData.value) return
const nodes = Array.from(nodePositions.value.values())
const edges = graphData.value.edges
const repulsion = 3000
const attraction = 0.05
const centering = 0.01
const damping = 0.85
// Repulsion between all nodes
for (let a = 0; a < nodes.length; a++) {
for (let b = a + 1; b < nodes.length; b++) {
const na = nodes[a]
const nb = nodes[b]
const dx = nb.x - na.x
const dy = nb.y - na.y
const dist = Math.sqrt(dx * dx + dy * dy) || 1
const force = repulsion / (dist * dist)
const fx = (dx / dist) * force
const fy = (dy / dist) * force
na.vx -= fx
na.vy -= fy
nb.vx += fx
nb.vy += fy
}
}
// Attraction along edges
for (const edge of edges) {
const source = nodePositions.value.get(edge.source)
const target = nodePositions.value.get(edge.target)
if (!source || !target) continue
const dx = target.x - source.x
const dy = target.y - source.y
const dist = Math.sqrt(dx * dx + dy * dy) || 1
const force = (dist - 80) * attraction
const fx = (dx / dist) * force
const fy = (dy / dist) * force
source.vx += fx
source.vy += fy
target.vx -= fx
target.vy -= fy
}
// Centering force
const centerX = svgWidth.value / 2
const centerY = svgHeight.value / 2
for (const node of nodes) {
node.vx += (centerX - node.x) * centering
node.vy += (centerY - node.y) * centering
}
// Apply velocities with damping
for (const node of nodes) {
node.vx *= damping
node.vy *= damping
node.x += node.vx
node.y += node.vy
// Keep within bounds
node.x = Math.max(40, Math.min(svgWidth.value - 40, node.x))
node.y = Math.max(40, Math.min(svgHeight.value - 40, node.y))
nodePositions.value.set(node.id, node)
}
}
function getEdgePath(sourceId: string, targetId: string): string {
const source = nodePositions.value.get(sourceId)
const target = nodePositions.value.get(targetId)
if (!source || !target) return ''
return `M ${source.x} ${source.y} L ${target.x} ${target.y}`
}
function handleNodeClick(nodeId: string) {
router.push(`/documents/${nodeId}`)
}
function handleResize() {
if (!containerRef.value) return
svgWidth.value = containerRef.value.clientWidth
svgHeight.value = containerRef.value.clientHeight
if (graphData.value) {
initializePositions()
runSimulation(100)
}
}
let resizeObserver: ResizeObserver | null = null
onMounted(async () => {
if (containerRef.value) {
svgWidth.value = containerRef.value.clientWidth
svgHeight.value = containerRef.value.clientHeight
resizeObserver = new ResizeObserver(handleResize)
resizeObserver.observe(containerRef.value)
}
await loadGraph()
})
onUnmounted(() => {
resizeObserver?.disconnect()
})
watch(depth, () => {
loadGraph()
})
</script>
<template>
<div class="graph-view">
<div class="graph-view__header">
<h2 class="graph-view__title">Project Graph</h2>
<div class="graph-view__controls">
<div class="graph-view__depth">
<span class="graph-view__depth-label">Depth:</span>
<Button
v-for="d in [1, 2, 3] as const"
:key="d"
:variant="depth === d ? 'primary' : 'ghost'"
size="sm"
@click="depth = d"
>{{ d }}</Button>
</div>
<Button variant="ghost" size="sm" @click="loadGraph">
<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
<path d="M23 4v6h-6"/><path d="M1 20v-6h6"/>
<path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/>
</svg>
Refresh
</Button>
</div>
</div>
<div v-if="graphData" class="graph-view__stats">
<span>{{ graphData.stats.total_documents }} documents</span>
<span>{{ graphData.stats.total_references }} references</span>
<span v-if="graphData.stats.orphaned_documents > 0" class="graph-view__stat--warning">
{{ graphData.stats.orphaned_documents }} orphaned
</span>
</div>
<div ref="containerRef" class="graph-view__canvas">
<div v-if="loading" class="graph-view__loading">
<div class="graph-view__spinner"></div>
Loading graph...
</div>
<div v-else-if="error" class="graph-view__error">
{{ error }}
</div>
<svg
v-else-if="graphData && nodePositions.size > 0"
ref="svgRef"
:width="svgWidth"
:height="svgHeight"
class="graph-view__svg"
>
<!-- Edges -->
<g class="graph-view__edges">
<path
v-for="edge in graphData.edges"
:key="`${edge.source}-${edge.target}`"
:d="getEdgePath(edge.source, edge.target)"
class="graph-view__edge"
/>
</g>
<!-- Nodes -->
<g class="graph-view__nodes">
<g
v-for="[id, pos] in nodePositions"
:key="id"
class="graph-view__node"
:transform="`translate(${pos.x}, ${pos.y})`"
@click="handleNodeClick(id)"
>
<circle
r="24"
class="graph-view__node-circle"
/>
<text
class="graph-view__node-icon"
text-anchor="middle"
dominant-baseline="central"
dy="0.05em"
>📄</text>
<title>{{ pos.title }}</title>
</g>
</g>
</svg>
<div v-else-if="graphData && graphData.nodes.length === 0" class="graph-view__empty">
No documents in this project yet.
</div>
</div>
<div class="graph-view__legend">
<span>Click a node to open the document</span>
</div>
</div>
</template>
<style scoped>
.graph-view {
display: flex;
flex-direction: column;
height: 100%;
background: var(--bg-primary);
}
.graph-view__header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 1rem 1.5rem;
border-bottom: 1px solid var(--border);
flex-shrink: 0;
}
.graph-view__title {
font-size: 1rem;
font-weight: 600;
color: var(--text-primary);
margin: 0;
}
.graph-view__controls {
display: flex;
align-items: center;
gap: 1rem;
}
.graph-view__depth {
display: flex;
align-items: center;
gap: 0.375rem;
}
.graph-view__depth-label {
font-size: 0.8125rem;
color: var(--text-secondary);
margin-right: 0.25rem;
}
.graph-view__stats {
display: flex;
gap: 1.5rem;
padding: 0.625rem 1.5rem;
background: var(--bg-secondary);
border-bottom: 1px solid var(--border);
font-size: 0.8125rem;
color: var(--text-secondary);
flex-shrink: 0;
}
.graph-view__stat--warning {
color: #f59e0b;
}
.graph-view__canvas {
flex: 1;
position: relative;
overflow: hidden;
min-height: 300px;
}
.graph-view__loading,
.graph-view__error,
.graph-view__empty {
position: absolute;
inset: 0;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 0.75rem;
color: var(--text-secondary);
font-size: 0.875rem;
}
.graph-view__spinner {
width: 24px;
height: 24px;
border: 2px solid var(--border);
border-top-color: var(--accent);
border-radius: 50%;
animation: spin 0.6s linear infinite;
}
@keyframes spin {
to { transform: rotate(360deg); }
}
.graph-view__svg {
display: block;
cursor: default;
}
.graph-view__edge {
stroke: var(--border);
stroke-width: 1.5;
fill: none;
transition: stroke 0.15s;
}
.graph-view__node-circle {
fill: var(--bg-secondary);
stroke: var(--accent);
stroke-width: 2;
cursor: pointer;
transition: fill 0.15s, stroke 0.15s, transform 0.15s;
}
.graph-view__node:hover .graph-view__node-circle {
fill: var(--accent);
stroke: var(--accent-hover);
transform: scale(1.1);
}
.graph-view__node-icon {
font-size: 14px;
pointer-events: none;
user-select: none;
}
.graph-view__legend {
padding: 0.5rem 1.5rem;
border-top: 1px solid var(--border);
font-size: 0.75rem;
color: var(--text-secondary);
text-align: center;
flex-shrink: 0;
}
</style>

View File

@@ -0,0 +1,360 @@
<script setup lang="ts">
import { ref, watch, nextTick } from 'vue'
import { useRouter } from 'vue-router'
import { useDocumentsStore } from '@/stores/documents'
import type { SearchResult } from '@/types'
const props = defineProps<{
show: boolean
}>()
const emit = defineEmits<{
close: []
}>()
const router = useRouter()
const documentsStore = useDocumentsStore()
const query = ref('')
const results = ref<SearchResult[]>([])
const selectedIndex = ref(0)
const isLoading = ref(false)
const inputRef = ref<HTMLInputElement | null>(null)
const listRef = ref<HTMLUListElement | null>(null)
let debounceTimer: ReturnType<typeof setTimeout> | null = null
watch(() => props.show, async (val) => {
if (val) {
query.value = ''
results.value = []
selectedIndex.value = 0
await nextTick()
inputRef.value?.focus()
}
})
watch(query, (q) => {
if (debounceTimer) clearTimeout(debounceTimer)
if (!q.trim()) {
results.value = []
return
}
debounceTimer = setTimeout(() => {
performSearch(q)
}, 150)
})
async function performSearch(q: string) {
if (!q.trim()) return
isLoading.value = true
try {
const response = await documentsStore.search(q, 'all', 10)
results.value = response.results
selectedIndex.value = 0
} catch (e) {
console.error('Search failed:', e)
results.value = []
} finally {
isLoading.value = false
}
}
function handleKeydown(e: KeyboardEvent) {
if (e.key === 'ArrowDown') {
e.preventDefault()
selectedIndex.value = Math.min(selectedIndex.value + 1, results.value.length - 1)
scrollToSelected()
} else if (e.key === 'ArrowUp') {
e.preventDefault()
selectedIndex.value = Math.max(selectedIndex.value - 1, 0)
scrollToSelected()
} else if (e.key === 'Enter') {
e.preventDefault()
if (results.value[selectedIndex.value]) {
selectResult(results.value[selectedIndex.value])
}
} else if (e.key === 'Escape') {
emit('close')
}
}
function scrollToSelected() {
nextTick(() => {
const item = listRef.value?.children[selectedIndex.value] as HTMLElement
item?.scrollIntoView({ block: 'nearest' })
})
}
function selectResult(result: SearchResult) {
if (result.type === 'document') {
router.push(`/documents/${result.id}`)
} else if (result.type === 'project') {
router.push(`/projects/${result.id}`)
}
emit('close')
}
function getIcon(type: string): string {
if (type === 'document') return '📄'
if (type === 'project') return '📁'
return '📄'
}
</script>
<template>
<Teleport to="body">
<Transition name="quick-switcher">
<div v-if="show" class="quick-switcher" @click.self="emit('close')">
<div class="quick-switcher__dialog">
<div class="quick-switcher__input-wrap">
<svg class="quick-switcher__icon" 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 21-4.35-4.35"/>
</svg>
<input
ref="inputRef"
v-model="query"
type="text"
class="quick-switcher__input"
placeholder="Search documents and projects..."
@keydown="handleKeydown"
/>
<kbd class="quick-switcher__kbd">Esc</kbd>
</div>
<div v-if="isLoading" class="quick-switcher__loading">
<div class="quick-switcher__spinner"></div>
Searching...
</div>
<ul v-else-if="results.length > 0" ref="listRef" class="quick-switcher__results">
<li
v-for="(result, index) in results"
:key="result.id"
:class="['quick-switcher__result', { 'quick-switcher__result--selected': index === selectedIndex }]"
@click="selectResult(result)"
@mouseenter="selectedIndex = index"
>
<span class="quick-switcher__result-icon">{{ getIcon(result.type) }}</span>
<div class="quick-switcher__result-info">
<span class="quick-switcher__result-title" v-html="result.highlight || result.title"></span>
<span v-if="result.subtitle" class="quick-switcher__result-subtitle">{{ result.subtitle }}</span>
</div>
<span class="quick-switcher__result-type">{{ result.type }}</span>
</li>
</ul>
<div v-else-if="query.trim()" class="quick-switcher__empty">
No results found
</div>
<div v-else class="quick-switcher__hint">
<p>Start typing to search...</p>
<div class="quick-switcher__shortcuts">
<span><kbd></kbd><kbd></kbd> Navigate</span>
<span><kbd>Enter</kbd> Open</span>
<span><kbd>Esc</kbd> Close</span>
</div>
</div>
</div>
</div>
</Transition>
</Teleport>
</template>
<style scoped>
.quick-switcher {
position: fixed;
inset: 0;
z-index: 2000;
display: flex;
align-items: flex-start;
justify-content: center;
padding-top: 15vh;
background: rgba(0, 0, 0, 0.5);
backdrop-filter: blur(4px);
}
.quick-switcher__dialog {
width: 90%;
max-width: 600px;
background: var(--bg-primary);
border: 1px solid var(--border);
border-radius: 12px;
box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
overflow: hidden;
}
.quick-switcher__input-wrap {
display: flex;
align-items: center;
padding: 0 1rem;
border-bottom: 1px solid var(--border);
gap: 0.75rem;
}
.quick-switcher__icon {
flex-shrink: 0;
color: var(--text-secondary);
}
.quick-switcher__input {
flex: 1;
padding: 1rem 0;
background: none;
border: none;
font-size: 1rem;
color: var(--text-primary);
outline: none;
}
.quick-switcher__input::placeholder {
color: var(--text-secondary);
}
.quick-switcher__kbd {
padding: 0.25rem 0.5rem;
background: var(--bg-secondary);
border: 1px solid var(--border);
border-radius: 4px;
font-size: 0.75rem;
color: var(--text-secondary);
}
.quick-switcher__loading {
display: flex;
align-items: center;
justify-content: center;
gap: 0.75rem;
padding: 2rem;
color: var(--text-secondary);
font-size: 0.875rem;
}
.quick-switcher__spinner {
width: 18px;
height: 18px;
border: 2px solid var(--border);
border-top-color: var(--accent);
border-radius: 50%;
animation: spin 0.6s linear infinite;
}
@keyframes spin {
to { transform: rotate(360deg); }
}
.quick-switcher__results {
list-style: none;
max-height: 400px;
overflow-y: auto;
padding: 0.5rem;
}
.quick-switcher__result {
display: flex;
align-items: center;
gap: 0.75rem;
padding: 0.625rem 0.75rem;
border-radius: 8px;
cursor: pointer;
transition: background 0.1s;
}
.quick-switcher__result--selected {
background: var(--bg-secondary);
}
.quick-switcher__result-icon {
font-size: 1.125rem;
flex-shrink: 0;
}
.quick-switcher__result-info {
flex: 1;
min-width: 0;
display: flex;
flex-direction: column;
gap: 0.125rem;
}
.quick-switcher__result-title {
font-size: 0.9375rem;
color: var(--text-primary);
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.quick-switcher__result-subtitle {
font-size: 0.8125rem;
color: var(--text-secondary);
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.quick-switcher__result-type {
font-size: 0.75rem;
padding: 0.125rem 0.5rem;
background: var(--bg-tertiary);
border-radius: 4px;
color: var(--text-secondary);
text-transform: capitalize;
flex-shrink: 0;
}
.quick-switcher__empty {
padding: 2rem;
text-align: center;
color: var(--text-secondary);
font-size: 0.875rem;
}
.quick-switcher__hint {
padding: 1.5rem;
text-align: center;
color: var(--text-secondary);
font-size: 0.875rem;
}
.quick-switcher__shortcuts {
display: flex;
justify-content: center;
gap: 1.5rem;
margin-top: 1rem;
font-size: 0.8125rem;
}
.quick-switcher__shortcuts kbd {
padding: 0.125rem 0.375rem;
background: var(--bg-secondary);
border: 1px solid var(--border);
border-radius: 4px;
font-size: 0.75rem;
margin-right: 0.25rem;
}
/* Transitions */
.quick-switcher-enter-active,
.quick-switcher-leave-active {
transition: opacity 0.15s ease;
}
.quick-switcher-enter-active .quick-switcher__dialog,
.quick-switcher-leave-active .quick-switcher__dialog {
transition: transform 0.15s ease, opacity 0.15s ease;
}
.quick-switcher-enter-from,
.quick-switcher-leave-to {
opacity: 0;
}
.quick-switcher-enter-from .quick-switcher__dialog,
.quick-switcher-leave-to .quick-switcher__dialog {
transform: scale(0.95) translateY(-10px);
opacity: 0;
}
</style>

View File

@@ -1,13 +1,33 @@
<script setup lang="ts">
import { ref } from 'vue'
import { ref, onMounted, onUnmounted } from 'vue'
import { useRouter } from 'vue-router'
import { useAuthStore } from '@/stores/auth'
import { useTheme } from '@/composables/useTheme'
import QuickSwitcher from '@/components/common/QuickSwitcher.vue'
const router = useRouter()
const authStore = useAuthStore()
const { resolvedTheme, toggleTheme } = useTheme()
const searchQuery = ref('')
const showUserMenu = ref(false)
const showQuickSwitcher = ref(false)
function handleGlobalKeydown(e: KeyboardEvent) {
// Cmd+K or Ctrl+K
if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
e.preventDefault()
showQuickSwitcher.value = true
}
}
onMounted(() => {
document.addEventListener('keydown', handleGlobalKeydown)
})
onUnmounted(() => {
document.removeEventListener('keydown', handleGlobalKeydown)
})
function handleSearch() {
if (searchQuery.value.trim()) {
@@ -50,6 +70,24 @@ function logout() {
</div>
<div class="header__right">
<button class="header__theme-toggle" @click="toggleTheme" :title="resolvedTheme === 'dark' ? 'Switch to light mode' : 'Switch to dark mode'">
<!-- Sun icon for dark mode (click to go light) -->
<svg v-if="resolvedTheme === 'dark'" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
<circle cx="12" cy="12" r="5"/>
<line x1="12" y1="1" x2="12" y2="3"/>
<line x1="12" y1="21" x2="12" y2="23"/>
<line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/>
<line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/>
<line x1="1" y1="12" x2="3" y2="12"/>
<line x1="21" y1="12" x2="23" y2="12"/>
<line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/>
<line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/>
</svg>
<!-- Moon icon for light mode (click to go dark) -->
<svg v-else width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
<path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>
</svg>
</button>
<div class="header__user" @click="showUserMenu = !showUserMenu">
<div class="header__avatar">
{{ authStore.user?.username?.charAt(0).toUpperCase() || 'U' }}
@@ -79,6 +117,7 @@ function logout() {
</div>
</div>
</header>
<QuickSwitcher :show="showQuickSwitcher" @close="showQuickSwitcher = false" />
</template>
<style scoped>
@@ -164,6 +203,26 @@ function logout() {
justify-content: flex-end;
}
.header__theme-toggle {
display: flex;
align-items: center;
justify-content: center;
width: 36px;
height: 36px;
background: none;
border: 1px solid var(--border);
border-radius: 8px;
color: var(--text-secondary);
cursor: pointer;
transition: all 0.15s;
margin-right: 0.5rem;
}
.header__theme-toggle:hover {
background: var(--bg-secondary);
color: var(--text-primary);
}
.header__user {
position: relative;
display: flex;