nuxt-devtools-observatory 0.1.30 → 0.1.31

package/client/src/components/WaterfallView.vue

@@ -0,0 +1,443 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import type { TraceEntry, TraceSpan } from '@observatory/types/snapshot'
+
+interface Props {
+    trace: TraceEntry
+}
+
+const props = defineProps<Props>()
+
+const spansByType = computed(() => {
+    const groups: Record<string, TraceSpan[]> = {}
+
+    for (const span of props.trace.spans) {
+        if (!groups[span.type]) {
+            groups[span.type] = []
+        }
+
+        groups[span.type].push(span)
+    }
+
+    return Object.entries(groups)
+        .map(([type, spans]) => ({
+            type,
+            spans: spans.sort((a, b) => a.startTime - b.startTime),
+        }))
+        .sort((a, b) => {
+            const typeOrder: Record<string, number> = {
+                navigation: 0,
+                fetch: 1,
+                composable: 2,
+                component: 3,
+                render: 4,
+                transition: 5,
+            }
+
+            return (typeOrder[a.type] ?? 999) - (typeOrder[b.type] ?? 999)
+        })
+})
+
+const timelineDuration = computed(() => {
+    if (props.trace.durationMs && props.trace.durationMs > 0) {
+        return props.trace.durationMs
+    }
+
+    if (props.trace.endTime && props.trace.endTime > props.trace.startTime) {
+        return props.trace.endTime - props.trace.startTime
+    }
+
+    let maxEndOffset = 0
+
+    for (const span of props.trace.spans) {
+        const endTime = span.endTime ?? span.startTime + (span.durationMs ?? 0)
+        const endOffset = endTime - props.trace.startTime
+
+        if (endOffset > maxEndOffset) {
+            maxEndOffset = endOffset
+        }
+    }
+
+    return maxEndOffset || 1
+})
+
+function getSpanX(span: TraceSpan): number {
+    const left = ((span.startTime - props.trace.startTime) / timelineDuration.value) * 100
+
+    return Math.min(100, Math.max(0, left))
+}
+
+function getSpanWidth(span: TraceSpan): number {
+    const left = getSpanX(span)
+    const width = ((span.durationMs || 0) / timelineDuration.value) * 100
+
+    return Math.max(2, Math.min(100 - left, width))
+}
+
+function isNarrowBar(span: TraceSpan): boolean {
+    const width = ((span.durationMs || 0) / timelineDuration.value) * 100
+
+    return width < 5
+}
+
+function formatDuration(durationMs?: number) {
+    if (!durationMs) {
+        return '0ms'
+    }
+
+    if (durationMs < 1) {
+        return `${(durationMs * 1000).toFixed(1)}μs`
+    }
+
+    if (durationMs < 1000) {
+        return `${durationMs.toFixed(1)}ms`
+    }
+
+    return `${(durationMs / 1000).toFixed(2)}s`
+}
+
+function getSpanColorClass(type: string) {
+    const colors: Record<string, string> = {
+        fetch: 'bg-blue-500',
+        composable: 'bg-purple-500',
+        component: 'bg-green-500',
+        navigation: 'bg-yellow-500',
+        render: 'bg-orange-500',
+        transition: 'bg-pink-500',
+    }
+
+    return colors[type] || 'bg-gray-500'
+}
+
+function getStatusColor(status: string) {
+    const statusColors: Record<string, string> = {
+        ok: 'border-green-400',
+        error: 'border-red-400',
+        cancelled: 'border-gray-400',
+        active: 'border-yellow-400',
+    }
+
+    return statusColors[status] || 'border-gray-400'
+}
+
+function asString(val: unknown): string {
+    return typeof val === 'string' ? val : ''
+}
+
+function getSpanDisplayName(span: TraceSpan): string {
+    const m = span.metadata as Record<string, unknown> | undefined
+
+    if (!m) {
+        return span.name
+    }
+
+    const componentName = asString(m.componentName)
+    const lifecycle = asString(m.lifecycle)
+    const uid = m.uid !== undefined ? String(m.uid) : ''
+    const method = asString(m.method)
+    const url = asString(m.url)
+    const route = asString(m.route) || asString(m.path)
+
+    if (componentName && lifecycle) {
+        return uid ? `${componentName}.${lifecycle} #${uid}` : `${componentName}.${lifecycle}`
+    }
+
+    if (componentName) {
+        return uid ? `${componentName} #${uid}` : componentName
+    }
+
+    if (method && url) {
+        return `${method} ${url}`
+    }
+
+    if (url) {
+        return url
+    }
+
+    if (route) {
+        return `${span.name} (${route})`
+    }
+
+    return span.name
+}
+
+function getSpanTooltip(span: TraceSpan): string {
+    const displayName = getSpanDisplayName(span)
+    const duration = formatDuration(span.durationMs)
+    const m = span.metadata as Record<string, unknown> | undefined
+    const route = m ? asString(m.route) || asString(m.path) : ''
+    let tooltip = `${displayName} — ${duration} (${span.status})`
+
+    if (route && !displayName.includes(route)) {
+        tooltip += ` [${route}]`
+    }
+
+    return tooltip
+}
+</script>
+
+<template>
+    <div class="waterfall">
+        <div class="waterfall__timeline-header">
+            <div class="waterfall__type-col">Type</div>
+            <div class="waterfall__timeline-col">
+                <div class="waterfall__time-markers">
+                    <div class="waterfall__time-marker">0ms</div>
+                    <div class="waterfall__time-marker">{{ formatDuration(timelineDuration / 4) }}</div>
+                    <div class="waterfall__time-marker">{{ formatDuration(timelineDuration / 2) }}</div>
+                    <div class="waterfall__time-marker">{{ formatDuration((timelineDuration * 3) / 4) }}</div>
+                    <div class="waterfall__time-marker">{{ formatDuration(timelineDuration) }}</div>
+                </div>
+            </div>
+        </div>
+
+        <div class="waterfall__groups">
+            <div v-for="group in spansByType" :key="group.type" class="waterfall__group">
+                <div class="waterfall__group-header">
+                    <span class="waterfall__group-type">
+                        <span class="waterfall__color-dot" :class="getSpanColorClass(group.type)"></span>
+                        {{ group.type }}
+                    </span>
+                    <span class="waterfall__group-count">{{ group.spans.length }}</span>
+                </div>
+
+                <div class="waterfall__group-spans">
+                    <div v-for="span in group.spans" :key="span.id" class="waterfall__span-row">
+                        <div class="waterfall__span-label">
+                            <span :title="getSpanTooltip(span)">{{ getSpanDisplayName(span) }}</span>
+                        </div>
+                        <div class="waterfall__span-bar-container">
+                            <div
+                                class="waterfall__span-bar"
+                                :class="[getSpanColorClass(span.type), getStatusColor(span.status)]"
+                                :style="{
+                                    left: `${getSpanX(span)}%`,
+                                    width: `${Math.max(1, getSpanWidth(span))}%`,
+                                }"
+                                :title="getSpanTooltip(span)"
+                            >
+                                <span v-if="!isNarrowBar(span)" class="waterfall__bar-duration">{{ formatDuration(span.durationMs) }}</span>
+                            </div>
+                            <span
+                                v-if="isNarrowBar(span)"
+                                class="waterfall__bar-duration-outside"
+                                :style="{ left: `calc(${getSpanX(span)}% + 4px)` }"
+                            >
+                                {{ formatDuration(span.durationMs) }}
+                            </span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <div v-if="spansByType.length === 0" class="waterfall__empty">No spans in this trace</div>
+        </div>
+    </div>
+</template>
+
+<style scoped>
+.waterfall {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    overflow: auto;
+    font-family: var(--mono);
+    font-size: 11px;
+}
+
+.waterfall__timeline-header {
+    display: flex;
+    position: sticky;
+    top: 0;
+    z-index: 20;
+    background: var(--bg2, var(--bg));
+    box-shadow: 0 1px 0 var(--border);
+    border-bottom: 1px solid var(--border);
+}
+
+.waterfall__type-col {
+    width: 120px;
+    min-width: 120px;
+    padding: 8px 0;
+    border-right: 1px solid var(--border);
+}
+
+.waterfall__timeline-col {
+    flex: 1;
+    min-width: 0;
+}
+
+.waterfall__time-markers {
+    display: flex;
+    justify-content: space-around;
+    padding: 8px 16px;
+    gap: 8px;
+}
+
+.waterfall__time-marker {
+    font-size: 10px;
+    color: var(--text2, var(--text));
+    flex: 1;
+    text-align: center;
+}
+
+.waterfall__groups {
+    display: flex;
+    flex-direction: column;
+}
+
+.waterfall__group {
+    border-bottom: 1px solid var(--border);
+}
+
+.waterfall__group-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    background: var(--bg2, var(--bg));
+    padding: 8px 16px;
+    font-weight: 600;
+    font-size: 12px;
+    color: var(--text2, var(--text));
+}
+
+.waterfall__group-type {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+}
+
+.waterfall__color-dot {
+    display: inline-block;
+    width: 8px;
+    height: 8px;
+    border-radius: 2px;
+}
+
+.waterfall__group-count {
+    background: var(--bg);
+    border: 1px solid var(--border);
+    padding: 2px 6px;
+    border-radius: 3px;
+    font-size: 10px;
+}
+
+.waterfall__group-spans {
+    display: flex;
+    flex-direction: column;
+}
+
+.waterfall__span-row {
+    display: flex;
+    height: 28px;
+    align-items: center;
+    border-bottom: 1px solid var(--border);
+}
+
+.waterfall__span-label {
+    width: 120px;
+    min-width: 120px;
+    padding: 0 16px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    color: var(--text);
+    font-size: 11px;
+    border-right: 1px solid var(--border);
+}
+
+.waterfall__span-bar-container {
+    flex: 1;
+    height: 100%;
+    position: relative;
+    min-width: 0;
+}
+
+.waterfall__span-bar {
+    position: absolute;
+    top: 50%;
+    transform: translateY(-50%);
+    height: 16px;
+    border-radius: 2px;
+    border-left: 2px solid;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: white;
+    overflow: hidden;
+    cursor: pointer;
+    transition: opacity 0.2s;
+    padding: 0 4px;
+}
+
+.waterfall__span-bar:hover {
+    opacity: 0.8;
+    box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.3);
+}
+
+.waterfall__bar-duration {
+    font-size: 9px;
+    white-space: nowrap;
+}
+
+.waterfall__bar-duration-outside {
+    position: absolute;
+    top: 50%;
+    transform: translateY(-50%);
+    font-size: 9px;
+    white-space: nowrap;
+    color: var(--text);
+    pointer-events: none;
+}
+
+.waterfall__empty {
+    padding: 32px 16px;
+    text-align: center;
+    color: var(--text2, var(--text));
+}
+
+/* Color utilities */
+.bg-blue-500 {
+    background-color: #3b82f6;
+}
+
+.bg-purple-500 {
+    background-color: #a855f7;
+}
+
+.bg-green-500 {
+    background-color: #22c55e;
+}
+
+.bg-yellow-500 {
+    background-color: #eab308;
+}
+
+.bg-orange-500 {
+    background-color: #f97316;
+}
+
+.bg-pink-500 {
+    background-color: #ec4899;
+}
+
+.bg-gray-500 {
+    background-color: #6b7280;
+}
+
+.border-green-400 {
+    border-color: #4ade80;
+}
+
+.border-red-400 {
+    border-color: #f87171;
+}
+
+.border-gray-400 {
+    border-color: #9ca3af;
+}
+
+.border-yellow-400 {
+    border-color: #facc15;
+}
+</style>

package/client/src/composables/useTraceFilter.ts

@@ -0,0 +1,164 @@
+import { computed, ref } from 'vue'
+import type { TraceEntry } from '@observatory/types/snapshot'
+
+export function getSpanTypesFromTraces(traces: TraceEntry[]): string[] {
+    const types = new Set<string>()
+
+    for (const trace of traces) {
+        for (const span of trace.spans) {
+            types.add(span.type)
+        }
+    }
+
+    return Array.from(types).sort()
+}
+
+export function useTraceFilter() {
+    const searchQuery = ref<string>('')
+    const selectedSpanTypes = ref<Set<string>>(new Set())
+    const minDuration = ref<number>(0)
+    const maxDuration = ref<number>(Infinity)
+    const routeFilter = ref<string>('')
+
+    function matchesSearch(trace: TraceEntry, query: string): boolean {
+        if (!query) {
+            return true
+        }
+
+        const lowerQuery = query.toLowerCase()
+
+        // Search in trace name
+        if (trace.name.toLowerCase().includes(lowerQuery)) {
+            return true
+        }
+
+        // Search in span names
+        for (const span of trace.spans) {
+            if (span.name.toLowerCase().includes(lowerQuery)) {
+                return true
+            }
+        }
+
+        // Search in metadata (e.g., route, URL endpoint)
+        for (const span of trace.spans) {
+            if (span.metadata) {
+                for (const value of Object.values(span.metadata)) {
+                    if (typeof value === 'string' && value.toLowerCase().includes(lowerQuery)) {
+                        return true
+                    }
+                }
+            }
+        }
+
+        return false
+    }
+
+    function matchesSpanTypeFilter(trace: TraceEntry, types: Set<string>): boolean {
+        if (types.size === 0) return true
+
+        for (const span of trace.spans) {
+            if (types.has(span.type)) {
+                return true
+            }
+        }
+
+        return false
+    }
+
+    function matchesDurationFilter(
+        trace: TraceEntry,
+        min: number,
+        max: number
+    ): boolean {
+        const hasExplicitDurationFilter = min > 0 || max < Infinity
+
+        if (trace.durationMs === undefined) {
+            return !hasExplicitDurationFilter
+        }
+
+        return trace.durationMs >= min && trace.durationMs <= max
+    }
+
+    function matchesRouteFilter(trace: TraceEntry, route: string): boolean {
+        if (!route) {
+            return true
+        }
+
+        // Check trace metadata for route
+        if (trace.metadata?.route && typeof trace.metadata.route === 'string') {
+            if (trace.metadata.route.toLowerCase().includes(route.toLowerCase())) {
+                return true
+            }
+        }
+
+        // Check span metadata for route or path
+        for (const span of trace.spans) {
+            if (span.metadata?.route) {
+                const routeValue = String(span.metadata.route).toLowerCase()
+
+                if (routeValue.includes(route.toLowerCase())) {
+                    return true
+                }
+            }
+
+            if (span.metadata?.path) {
+                const pathValue = String(span.metadata.path).toLowerCase()
+
+                if (pathValue.includes(route.toLowerCase())) {
+                    return true
+                }
+            }
+        }
+
+        return false
+    }
+
+    function filterTraces(traces: TraceEntry[]): TraceEntry[] {
+        return traces.filter((trace) => {
+            return (
+                matchesSearch(trace, searchQuery.value) &&
+                matchesSpanTypeFilter(trace, selectedSpanTypes.value) &&
+                matchesDurationFilter(trace, minDuration.value, maxDuration.value) &&
+                matchesRouteFilter(trace, routeFilter.value)
+            )
+        })
+    }
+
+    function toggleSpanType(type: string) {
+        if (selectedSpanTypes.value.has(type)) {
+            selectedSpanTypes.value.delete(type)
+        } else {
+            selectedSpanTypes.value.add(type)
+        }
+    }
+
+    function clearFilters() {
+        searchQuery.value = ''
+        selectedSpanTypes.value.clear()
+        minDuration.value = 0
+        maxDuration.value = Infinity
+        routeFilter.value = ''
+    }
+
+    const hasActiveFilters = computed(() => {
+        return (
+            searchQuery.value.length > 0 ||
+            selectedSpanTypes.value.size > 0 ||
+            minDuration.value > 0 ||
+            maxDuration.value < Infinity ||
+            routeFilter.value.length > 0
+        )
+    })
+
+    return {
+        searchQuery,
+        selectedSpanTypes,
+        minDuration,
+        maxDuration,
+        routeFilter,
+        filterTraces,
+        toggleSpanType,
+        clearFilters,
+        hasActiveFilters,
+    }
+}

package/client/src/stores/observatory.ts

@@ -1,7 +1,7 @@
 import { ref } from 'vue'
 import { useDevtoolsClient, onDevtoolsClientConnected } from '@nuxt/devtools-kit/iframe-client'
 import type { ObservatorySnapshot, ObservatoryServerFunctions, ObservatoryClientFunctions } from '@observatory/types/rpc'
-import type { FetchEntry, ProvideEntry, InjectEntry, ComposableEntry, RenderEntry, TransitionEntry } from '@observatory/types/snapshot'
+import type { FetchEntry, ProvideEntry, InjectEntry, ComposableEntry, RenderEntry, TransitionEntry, TraceEntry } from '@observatory/types/snapshot'
 
 type ProvideInjectSnapshot = { provides: ProvideEntry[]; injects: InjectEntry[] }
 
@@ -10,6 +10,7 @@ const provideInject = ref<ProvideInjectSnapshot>({ provides: [], injects: [] })
 const composables = ref<ComposableEntry[]>([])
 const renders = ref<RenderEntry[]>([])
 const transitions = ref<TransitionEntry[]>([])
+const traces = ref<TraceEntry[]>([])
 const connected = ref(false)
 const features = ref<ObservatorySnapshot['features']>({})
 const debugRpc = typeof window !== 'undefined' && new URLSearchParams(window.location.search).has('debugRpc')
@@ -50,6 +51,7 @@ function applySnapshot(data: ObservatorySnapshot) {
     composables.value = cloneArray(data.composables as ComposableEntry[] | undefined)
     renders.value = normalizeRenderEntries(data.renders as RenderEntry[] | undefined)
     transitions.value = cloneArray(data.transitions as TransitionEntry[] | undefined)
+    traces.value = cloneArray(data.traces as TraceEntry[] | undefined)
     features.value = data.features || {}
 
     // If the server snapshot disagrees with the user's requested mode,
@@ -79,6 +81,7 @@ function applySnapshot(data: ObservatorySnapshot) {
             composables: composables.value.length,
             renders: renders.value.length,
             transitions: transitions.value.length,
+            traces: traces.value.length,
         })
     }
 }
@@ -224,6 +227,7 @@ export function useObservatoryData() {
         composables,
         renders,
         transitions,
+        traces,
         features,
         connected,
         refresh,