describe-me 0.1.1 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "describe-me",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Living component documentation generated from your Vitest tests: viewer and CLI",
   "keywords": [
     "vitest",
@@ -43,13 +43,13 @@
   "dependencies": {
     "rrweb-snapshot": "^2.1.6",
     "vite": "^8.3.0",
-    "@describe-me/core": "^0.1.1"
+    "@describe-me/core": "^0.3.0"
   },
   "devDependencies": {
     "@types/node": "^22"
   },
   "scripts": {
     "build": "rimraf dist-cli && tsc -p tsconfig.cli.json",
-    "dev": "node dist-cli/main.js dev --data ../../examples/react-basic/.describe-me"
+    "dev": "node dist-cli/main.js dev --data ../../examples/react-browser/.describe-me"
   }
 }

package/src/content-box.ts

@@ -0,0 +1,51 @@
+const SKIPPED_TAGS = new Set(['SCRIPT', 'NOSCRIPT', 'STYLE', 'LINK', 'META', 'TITLE'])
+
+/**
+ * Whether an element draws something itself. Layout wrappers (the test
+ * container, a full-width flex row) stretch across the page and would make
+ * every measurement fall back to the whole viewport.
+ */
+function isVisual(element: Element, view: Window): boolean {
+  if (element.children.length === 0) {
+    return true
+  }
+
+  const style = view.getComputedStyle(element)
+  const hasBackground =
+    style.backgroundColor !== 'rgba(0, 0, 0, 0)' && style.backgroundColor !== 'transparent'
+
+  const hasBorder = parseFloat(style.borderTopWidth) > 0 || parseFloat(style.borderLeftWidth) > 0
+  const hasShadow = style.boxShadow !== 'none'
+
+  return hasBackground || hasBorder || hasShadow
+}
+
+/** The box around everything that actually paints in a snapshot, in the iframe's own pixels. */
+export function contentBox(body: HTMLElement, view: Window): DOMRect | null {
+  let box: DOMRect | null = null
+
+  for (const element of Array.from(body.querySelectorAll('*'))) {
+    if (SKIPPED_TAGS.has(element.tagName) || !isVisual(element, view)) {
+      continue
+    }
+
+    const rect = element.getBoundingClientRect()
+    if (rect.width === 0 || rect.height === 0) {
+      continue
+    }
+
+    if (!box) {
+      box = DOMRect.fromRect(rect)
+      continue
+    }
+
+    const right = Math.max(box.right, rect.right)
+    const bottom = Math.max(box.bottom, rect.bottom)
+    box.x = Math.min(box.x, rect.x)
+    box.y = Math.min(box.y, rect.y)
+    box.width = right - box.x
+    box.height = bottom - box.y
+  }
+
+  return box
+}

package/src/fit-stage.ts

@@ -0,0 +1,20 @@
+import { contentBox } from './content-box.js'
+
+const BOTTOM_MARGIN = 20
+const MIN_HEIGHT = 120
+
+/**
+ * Shrink the replay frame to what the snapshot actually paints. A snapshot is
+ * a whole document, so at its natural size the frame is a tall empty sheet
+ * with the component alone in the top corner.
+ */
+export function fitStage(iframe: HTMLIFrameElement): void {
+  const body = iframe.contentDocument?.body
+  const view = iframe.contentWindow
+  const box = body && view ? contentBox(body, view) : null
+  if (!box) {
+    return
+  }
+
+  iframe.style.height = `${Math.max(MIN_HEIGHT, Math.round(box.bottom + BOTTOM_MARGIN))}px`
+}

package/src/header.ts

@@ -1,31 +1,31 @@
 import { el } from './el.js'
 import { allTests, state } from './state.js'
 
+function stat(count: number, label: string, tone?: 'pass' | 'fail'): HTMLElement {
+  return el('span', { class: tone ? `stat ${tone}` : 'stat' }, el('b', {}, String(count)), label)
+}
+
 /** Wordmark, pass/fail counts and the time of the last run. */
 export function renderHeader(): HTMLElement {
   const manifest = state.manifest
   const tests = manifest ? allTests(manifest) : []
   const passed = tests.filter((test) => test.state === 'passed').length
   const failed = tests.filter((test) => test.state === 'failed').length
-  const summary = el('span', { class: 'summary' })
-  summary.append(
-    el('b', {}, String(tests.length)),
-    ' tests · ',
-    el('b', {}, String(passed)),
-    ' passed',
-  )
 
+  const summary = el('span', { class: 'summary' }, stat(tests.length, 'tests'))
+  summary.append(stat(passed, 'passed', 'pass'))
   if (failed) {
-    summary.append(' · ', el('b', { class: 'fail' }, String(failed)), ' failed')
+    summary.append(stat(failed, 'failed', 'fail'))
   }
 
-  const wm = el('span', { class: 'wordmark' }, 'describe', el('span', { class: 'me' }, '-me'))
+  const wordmark = el('span', { class: 'wordmark' }, 'describe', el('span', { class: 'me' }, '-me'))
   const when = manifest ? new Date(manifest.generatedAt).toLocaleTimeString() : '…'
+
   return el(
     'header',
     { class: 'header' },
-    wm,
+    wordmark,
     summary,
-    el('span', { class: 'right live' }, `updated ${when}`),
+    el('span', { class: 'right live' }, 'updated ', el('span', { class: 'mono' }, when)),
   )
 }

package/src/inspector.ts

@@ -48,7 +48,7 @@ export function renderInspector(): HTMLElement {
         'section',
         {},
         el('h3', {}, `frame ${state.frame + 1} / ${test.frames.length}`),
-        el('div', {}, frame.label),
+        el('div', { class: 'mono' }, frame.label),
         el('div', { class: 'hint' }, `${frame.kind} · ${frame.at}ms into the test`),
       ),
     )

package/src/main-panel.ts

@@ -59,7 +59,7 @@ export function renderMain(): HTMLElement {
           },
         },
         el('span', { class: 'k' }, timelineFrame.kind),
-        el('span', {}, timelineFrame.label),
+        el('span', { class: 'label' }, timelineFrame.label),
         el('span', { class: 't' }, `${timelineFrame.at}ms`),
       ),
     )

package/src/sidebar.ts

@@ -1,13 +1,42 @@
+import type { ManifestModule, ManifestTest } from '@describe-me/core/types'
 import { el } from './el.js'
 import { select, selectSuite, state } from './state.js'
 import { suiteKey } from './suite-key.js'
 import { buildTree, type SuiteNode } from './tree.js'
 
-function scopeButton(label: string, key: string, kind: 'module' | 'suite'): HTMLElement {
+/**
+ * The one describe every test of a module sits under, if there is one. Its
+ * overview lists exactly the tests the module's overview would, so the two
+ * rows collapse into a single header instead of leading to near-identical
+ * pages.
+ */
+function soleSuite(root: SuiteNode): SuiteNode | null {
+  if (root.tests.length > 0 || root.suites.size !== 1) {
+    return null
+  }
+
+  return [...root.suites.values()][0] ?? null
+}
+
+/** The header of a module block: the describe it holds, over the file it came from. */
+function moduleButton(name: string | null, file: string, key: string): HTMLElement {
   return el(
     'button',
     {
-      class: `${kind}-button${key === state.suiteKey ? ' active' : ''}`,
+      class: `module-button${key === state.suiteKey ? ' active' : ''}`,
+      click: () => selectSuite(key),
+      title: `overview of ${name ? `${name} — ${file}` : file}`,
+    },
+    name ? el('span', { class: 'module-name' }, name) : null,
+    el('span', { class: 'module-path' }, file),
+  )
+}
+
+function suiteButton(label: string, key: string): HTMLElement {
+  return el(
+    'button',
+    {
+      class: `suite-button${key === state.suiteKey ? ' active' : ''}`,
       click: () => selectSuite(key),
       title: `overview of ${label}`,
     },
@@ -15,47 +44,61 @@ function scopeButton(label: string, key: string, kind: 'module' | 'suite'): HTML
   )
 }
 
-function renderSuite(node: SuiteNode, moduleId: string, path: string[]): HTMLElement {
-  const wrap = el('div', { class: 'suite' })
-  if (node.name) {
-    wrap.append(scopeButton(node.name, suiteKey(moduleId, path), 'suite'))
-  }
+function testButton(test: ManifestTest): HTMLElement {
+  return el(
+    'button',
+    {
+      class: `test${!state.suiteKey && test.id === state.testId ? ' active' : ''}`,
+      click: () => select(test.id),
+      title: test.fullName,
+    },
+    el('span', { class: `dot ${test.state}` }),
+    el('span', { class: 'test-name' }, test.name),
+    el('span', { class: 'n' }, String(test.frames.length)),
+  )
+}
 
+/** The rows under one suite: its own tests, then the suites nested in it. */
+function renderRows(node: SuiteNode, moduleId: string, path: string[]): DocumentFragment {
+  const rows = document.createDocumentFragment()
   for (const test of node.tests) {
-    wrap.append(
-      el(
-        'button',
-        {
-          class: `test${!state.suiteKey && test.id === state.testId ? ' active' : ''}`,
-          click: () => select(test.id),
-          title: test.fullName,
-        },
-        el('span', { class: `dot ${test.state}` }),
-        el('span', {}, test.name),
-        el('span', { class: 'n' }, String(test.frames.length)),
-      ),
-    )
+    rows.append(testButton(test))
   }
 
   for (const child of node.suites.values()) {
-    wrap.append(renderSuite(child, moduleId, [...path, child.name]))
+    rows.append(renderSuite(child, moduleId, [...path, child.name]))
   }
 
-  return wrap
+  return rows
+}
+
+function renderSuite(node: SuiteNode, moduleId: string, path: string[]): HTMLElement {
+  return el(
+    'div',
+    { class: 'suite' },
+    suiteButton(node.name, suiteKey(moduleId, path)),
+    renderRows(node, moduleId, path),
+  )
+}
+
+function renderModule(mod: ManifestModule): HTMLElement {
+  const root = buildTree(mod)
+  const only = soleSuite(root)
+  const path = only ? [only.name] : []
+
+  return el(
+    'div',
+    { class: 'module' },
+    moduleButton(only?.name ?? null, mod.id, suiteKey(mod.id, path)),
+    el('div', { class: 'suite root' }, renderRows(only ?? root, mod.id, path)),
+  )
 }
 
 /** One block per test module, each holding its suite tree. */
 export function renderSidebar(): HTMLElement {
   const aside = el('aside', { class: 'sidebar' })
   for (const mod of state.manifest?.modules ?? []) {
-    aside.append(
-      el(
-        'div',
-        { class: 'module' },
-        scopeButton(mod.id, suiteKey(mod.id, []), 'module'),
-        renderSuite(buildTree(mod), mod.id, []),
-      ),
-    )
+    aside.append(renderModule(mod))
   }
 
   return aside

package/src/stage.ts

@@ -1,6 +1,7 @@
 import { createCache, createMirror, rebuildIntoSandboxedIframe } from 'rrweb-snapshot'
 import type { ManifestFrame } from '@describe-me/core/types'
 import { loadSnapshot } from './data.js'
+import { fitStage } from './fit-stage.js'
 import { state } from './state.js'
 
 let paintToken = 0
@@ -25,4 +26,11 @@ export async function paintFrame(stage: HTMLElement, frame: ManifestFrame): Prom
   if (state.width !== 'auto') {
     iframe.style.width = `${state.width}px`
   }
+
+  // Styles are in place after a frame; only then do the boxes have their final size.
+  requestAnimationFrame(() => {
+    if (token === paintToken) {
+      fitStage(iframe)
+    }
+  })
 }

package/src/states-gallery.ts

@@ -1,5 +1,6 @@
 import { createCache, createMirror, rebuildIntoSandboxedIframe } from 'rrweb-snapshot'
 import type { ManifestFrame, ManifestTest } from '@describe-me/core/types'
+import { contentBox } from './content-box.js'
 import { loadSnapshot } from './data.js'
 import { el } from './el.js'
 import { select } from './state.js'
@@ -25,58 +26,6 @@ async function paintThumb(thumb: HTMLElement, frame: ManifestFrame, token: numbe
   requestAnimationFrame(() => fitThumb(thumb, iframe))
 }
 
-const SKIPPED_TAGS = new Set(['SCRIPT', 'NOSCRIPT', 'STYLE', 'LINK', 'META', 'TITLE'])
-
-/**
- * Whether an element draws something itself. Layout wrappers (the test
- * container, a full-width flex row) stretch across the page and would make
- * every thumbnail zoom out to the whole viewport.
- */
-function isVisual(element: Element, view: Window): boolean {
-  if (element.children.length === 0) {
-    return true
-  }
-
-  const style = view.getComputedStyle(element)
-  const hasBackground =
-    style.backgroundColor !== 'rgba(0, 0, 0, 0)' && style.backgroundColor !== 'transparent'
-
-  const hasBorder = parseFloat(style.borderTopWidth) > 0 || parseFloat(style.borderLeftWidth) > 0
-  const hasShadow = style.boxShadow !== 'none'
-
-  return hasBackground || hasBorder || hasShadow
-}
-
-/** The box around everything that actually paints in the snapshot, in the iframe's own pixels. */
-function contentBox(body: HTMLElement, view: Window): DOMRect | null {
-  let box: DOMRect | null = null
-
-  for (const element of Array.from(body.querySelectorAll('*'))) {
-    if (SKIPPED_TAGS.has(element.tagName) || !isVisual(element, view)) {
-      continue
-    }
-
-    const rect = element.getBoundingClientRect()
-    if (rect.width === 0 || rect.height === 0) {
-      continue
-    }
-
-    if (!box) {
-      box = DOMRect.fromRect(rect)
-      continue
-    }
-
-    const right = Math.max(box.right, rect.right)
-    const bottom = Math.max(box.bottom, rect.bottom)
-    box.x = Math.min(box.x, rect.x)
-    box.y = Math.min(box.y, rect.y)
-    box.width = right - box.x
-    box.height = bottom - box.y
-  }
-
-  return box
-}
-
 const THUMB_PADDING = 16
 
 /**

package/src/style.css

@@ -1,29 +1,80 @@
+/* --------------------------------------------------------------- tokens -- */
+
+/*
+ * Chrome is set in the UI sans; anything that came out of the codebase —
+ * props, types, values, file paths, frame labels — is set in the mono face.
+ * That split is what keeps a documentation tool from reading like a terminal.
+ */
 :root {
-  --bg: #fafafa;
+  --font-ui: system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-mono: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+  /*--mono: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;*/
+  --bg: #f5f6f8;
   --panel: #ffffff;
-  --ink: #141414;
-  --muted: #7a7a7a;
-  --line: #e6e6e6;
-  --hover: #f0f0f0;
-  --accent: #2b5cff;
-  --pass: #1f9d55;
-  --fail: #d43f3f;
-  --skip: #b5b5b5;
+  --raised: #ffffff;
+  --stage-bg: #eef0f3;
   --stage: #ffffff;
-  --mono: ui-monospace, 'SF Mono', Menlo, Consolas, monospace;
+
+  --ink: #1c2024;
+  --ink-2: #4f5762;
+  --ink-3: #6b7381;
+
+  --line: #e6e9ee;
+  --line-soft: #eff1f5;
+  --hover: #f1f3f6;
+
+  --accent: #4a63d8;
+  --pass: #2f9e5f;
+  --fail: #d04747;
+  --warn: #b0760c;
+  --skip: #a8b0bb;
+
+  --tint: color-mix(in srgb, var(--accent) 7%, transparent);
+  --tint-strong: color-mix(in srgb, var(--accent) 13%, transparent);
+  --ring: color-mix(in srgb, var(--accent) 45%, transparent);
+
+  --r-sm: 6px;
+  --r-md: 8px;
+  --r-lg: 12px;
+  --r-pill: 999px;
+
+  --shadow-sm: 0 1px 2px rgba(20, 24, 32, 0.05);
+  --shadow-md: 0 1px 2px rgba(20, 24, 32, 0.05), 0 6px 16px -6px rgba(20, 24, 32, 0.14);
+
   color-scheme: light dark;
 }
 @media (prefers-color-scheme: dark) {
   :root {
-    --bg: #101010;
-    --panel: #171717;
-    --ink: #ececec;
-    --muted: #8a8a8a;
-    --line: #2a2a2a;
-    --hover: #202020;
+    --bg: #111316;
+    --panel: #171a1f;
+    --raised: #1c2026;
+    --stage-bg: #0b0d10;
     --stage: #ffffff;
+
+    --ink: #e2e6ea;
+    --ink-2: #b0b9c5;
+    --ink-3: #8a939f;
+
+    --line: #252a31;
+    --line-soft: #1e2228;
+    --hover: #21262d;
+
+    --accent: #8ea2ff;
+    --pass: #4fbb7d;
+    --fail: #e8756f;
+    --warn: #d3a24a;
+    --skip: #5c646f;
+
+    --tint: color-mix(in srgb, var(--accent) 10%, transparent);
+    --tint-strong: color-mix(in srgb, var(--accent) 18%, transparent);
+
+    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
+    --shadow-md: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 20px -8px rgba(0, 0, 0, 0.6);
   }
 }
+
+/* ----------------------------------------------------------------- base -- */
+
 * {
   box-sizing: border-box;
 }
@@ -35,7 +86,8 @@ body {
 body {
   background: var(--bg);
   color: var(--ink);
-  font: 13px/1.45 var(--mono);
+  font: 400 13px/1.5 var(--font-ui);
+  -webkit-font-smoothing: antialiased;
 }
 button {
   font: inherit;
@@ -48,200 +100,326 @@ button {
 a {
   color: inherit;
 }
+::selection {
+  background: var(--tint-strong);
+}
+:focus-visible {
+  outline: 2px solid var(--ring);
+  outline-offset: 1px;
+}
+
+/* Panels scroll on their own; the thin bars keep the chrome quiet. */
+.sidebar,
+.inspector,
+.overview,
+.stage,
+.timeline {
+  scrollbar-width: thin;
+  scrollbar-color: var(--line) transparent;
+}
+
+/** Anything quoted from the codebase. */
+.mono {
+  font-family: var(--font-mono);
+}
 
 #app {
   height: 100%;
   display: grid;
-  grid-template-rows: 44px 1fr;
+  grid-template-rows: 52px 1fr;
 }
+.body {
+  display: grid;
+  grid-template-columns: 296px 1fr 320px;
+  min-height: 0;
+}
+
+/* --------------------------------------------------------------- header -- */
+
 .header {
   display: flex;
   align-items: center;
-  gap: 16px;
-  padding: 0 16px;
+  gap: 18px;
+  padding: 0 18px;
   border-bottom: 1px solid var(--line);
   background: var(--panel);
 }
 .wordmark {
+  font-size: 14px;
   font-weight: 600;
-  letter-spacing: -0.01em;
+  letter-spacing: -0.015em;
 }
 .wordmark .me {
   color: var(--accent);
 }
 .summary {
-  color: var(--muted);
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  color: var(--ink-2);
+  font-size: 12px;
 }
-.summary b {
+.stat {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 5px;
+}
+.summary .stat + .stat::before {
+  content: '';
+  align-self: center;
+  width: 1px;
+  height: 11px;
+  margin-right: 14px;
+  background: var(--line);
+}
+.stat b {
   color: var(--ink);
-  font-weight: 500;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
 }
-.summary .fail {
+.stat.pass b {
+  color: var(--pass);
+}
+.stat.fail {
+  padding: 2px 9px;
+  border-radius: var(--r-pill);
+  background: color-mix(in srgb, var(--fail) 12%, transparent);
   color: var(--fail);
 }
+.stat.fail b {
+  color: inherit;
+}
 .header .right {
   margin-left: auto;
-  color: var(--muted);
+  color: var(--ink-3);
+  font-size: 12px;
 }
 .live {
   display: inline-flex;
   align-items: center;
-  gap: 6px;
+  gap: 7px;
 }
 .live::before {
   content: '';
-  width: 7px;
-  height: 7px;
+  width: 6px;
+  height: 6px;
   border-radius: 50%;
   background: var(--pass);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--pass) 18%, transparent);
 }
 
-.body {
-  display: grid;
-  grid-template-columns: 300px 1fr 320px;
-  min-height: 0;
-}
+/* -------------------------------------------------------------- sidebar -- */
+
 .sidebar {
   border-right: 1px solid var(--line);
   overflow: auto;
-  padding: 12px 8px;
+  padding: 14px 10px 32px;
   background: var(--panel);
 }
-.module {
-  margin-bottom: 14px;
+.module + .module {
+  margin-top: 18px;
+  padding-top: 18px;
+  border-top: 1px solid var(--line-soft);
 }
 .module-button,
 .suite-button {
+  position: relative;
   display: block;
   width: 100%;
   text-align: left;
-  border-radius: 6px;
+  border-radius: var(--r-sm);
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
 .module-button {
-  color: var(--muted);
-  padding: 4px 8px;
-  font-size: 12px;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 1px;
+  padding: 5px 9px;
+  margin-bottom: 4px;
 }
-.suite {
-  padding-left: 12px;
+.module-name,
+.module-path {
+  max-width: 100%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
-.suite-button {
-  padding: 3px 8px;
+.module-name {
   color: var(--ink);
+  font-size: 13px;
+  font-weight: 600;
+  letter-spacing: -0.01em;
 }
-.module-button:hover,
-.suite-button:hover {
-  background: var(--hover);
+.module-path {
+  color: var(--ink-3);
+  font-family: var(--font-mono);
+  font-size: 10.5px;
 }
-.module-button.active,
-.suite-button.active {
-  background: var(--ink);
-  color: var(--bg);
+.suite-button {
+  padding: 4px 9px;
+  color: var(--ink);
+  font-size: 12.5px;
+  font-weight: 500;
+}
+
+/* One hairline per nesting level: the tree stays readable without deep indents. */
+.suite:not(.root) {
+  margin-left: 9px;
+  padding-left: 9px;
+  border-left: 1px solid var(--line-soft);
 }
 .test {
+  position: relative;
   display: flex;
   align-items: center;
   gap: 8px;
   width: 100%;
+  min-width: 0;
   text-align: left;
-  padding: 4px 8px;
-  border-radius: 6px;
-  padding-left: 20px;
+  padding: 4px 9px;
+  border-radius: var(--r-sm);
+  color: var(--ink-2);
+}
+.test-name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
+.module-button:hover,
+.suite-button:hover,
 .test:hover {
   background: var(--hover);
+  color: var(--ink);
 }
+
+/* Selection is a tinted row with an accent edge — visible while scanning, quiet at rest. */
+.module-button.active,
+.suite-button.active,
 .test.active {
-  background: var(--ink);
-  color: var(--bg);
+  background: var(--tint);
+  color: var(--ink);
+  font-weight: 500;
+}
+.module-button.active::before,
+.suite-button.active::before,
+.test.active::before {
+  content: '';
+  position: absolute;
+  left: 0;
+  top: 3px;
+  bottom: 3px;
+  width: 2px;
+  border-radius: 0 2px 2px 0;
+  background: var(--accent);
 }
+.test .n {
+  margin-left: auto;
+  color: var(--ink-3);
+  font-family: var(--font-mono);
+  font-size: 10.5px;
+  font-variant-numeric: tabular-nums;
+}
+
+/* Passing is the norm; only a failure earns full contrast. */
 .dot {
-  width: 7px;
-  height: 7px;
+  width: 6px;
+  height: 6px;
   border-radius: 50%;
   flex: none;
 }
 .dot.passed {
-  background: var(--pass);
+  background: color-mix(in srgb, var(--pass) 55%, transparent);
 }
 .dot.failed {
   background: var(--fail);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--fail) 16%, transparent);
 }
 .dot.skipped,
 .dot.pending {
-  background: var(--skip);
-}
-.test .n {
-  color: var(--muted);
-  margin-left: auto;
-  font-size: 11px;
-}
-.test.active .n {
-  color: inherit;
-  opacity: 0.7;
+  background: transparent;
+  box-shadow: inset 0 0 0 1.5px var(--skip);
 }
 
+/* ----------------------------------------------------------------- main -- */
+
 .main {
   display: grid;
-  grid-template-rows: 40px 1fr auto;
+  grid-template-rows: 46px 1fr auto;
   min-width: 0;
   min-height: 0;
 }
 .crumbs {
   display: flex;
   align-items: center;
-  gap: 8px;
+  gap: 7px;
   padding: 0 16px;
   border-bottom: 1px solid var(--line);
-  color: var(--muted);
+  background: var(--panel);
+  color: var(--ink-3);
+  font-size: 12.5px;
   overflow: hidden;
   white-space: nowrap;
 }
 .crumbs .sep {
-  opacity: 0.5;
+  color: var(--ink-3);
+  opacity: 0.55;
 }
 .crumbs .cur {
   color: var(--ink);
+  font-weight: 500;
 }
+
+/* A segmented control, not three loose buttons. */
 .crumbs .tools {
   margin-left: auto;
   display: flex;
-  gap: 4px;
+  gap: 2px;
+  padding: 2px;
+  border-radius: var(--r-md);
+  background: var(--hover);
 }
 .crumbs .tools button {
-  padding: 2px 8px;
-  border-radius: 5px;
-  color: var(--muted);
+  padding: 3px 10px;
+  border-radius: var(--r-sm);
+  color: var(--ink-3);
+  font-size: 11.5px;
+  font-variant-numeric: tabular-nums;
+}
+.crumbs .tools button:hover {
+  color: var(--ink);
 }
 .crumbs .tools button.on {
-  background: var(--hover);
+  background: var(--panel);
   color: var(--ink);
+  box-shadow: var(--shadow-sm);
 }
+
 .stage {
   position: relative;
   overflow: auto;
-  padding: 24px;
+  padding: 28px;
   display: flex;
   justify-content: center;
   align-items: flex-start;
-  background-image: radial-gradient(var(--line) 1px, transparent 1px);
-  background-size: 16px 16px;
+  background: var(--stage-bg);
 }
 .stage iframe {
   border: 1px solid var(--line);
-  border-radius: 8px;
+  border-radius: var(--r-lg);
   background: var(--stage);
   width: 100%;
-  height: 100%;
-  min-height: 320px;
-  box-shadow: 0 1px 0 rgba(0, 0, 0, 0.04);
-  transition: width 0.15s ease;
+  height: 180px;
+  min-height: 120px;
+  box-shadow: var(--shadow-md);
+  transition:
+    width 0.2s ease,
+    height 0.2s ease;
 }
 .stage .empty {
-  color: var(--muted);
+  color: var(--ink-3);
   align-self: center;
 }
 
@@ -256,88 +434,107 @@ a {
 .frame {
   display: inline-flex;
   align-items: center;
-  gap: 8px;
-  padding: 6px 10px;
-  border: 1px solid var(--line);
-  border-radius: 999px;
+  gap: 9px;
+  padding: 6px 12px;
+  border: 1px solid transparent;
+  border-radius: var(--r-md);
   white-space: nowrap;
-  color: var(--muted);
+  color: var(--ink-2);
 }
 .frame:hover {
   background: var(--hover);
 }
 .frame.active {
-  border-color: var(--ink);
+  background: var(--tint);
+  border-color: color-mix(in srgb, var(--accent) 30%, transparent);
   color: var(--ink);
 }
 .frame .k {
-  font-size: 10px;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-  opacity: 0.7;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--ink-3);
+  font-size: 11px;
+}
+.frame .k::before {
+  content: '';
+  width: 6px;
+  height: 6px;
+  border-radius: 2px;
+  background: currentColor;
+}
+.frame .label {
+  font-family: var(--font-mono);
+  font-size: 12px;
 }
 .frame .t {
-  opacity: 0.6;
-  font-size: 11px;
+  color: var(--ink-3);
+  font-family: var(--font-mono);
+  font-size: 10.5px;
+  font-variant-numeric: tabular-nums;
 }
 .frame.render .k {
   color: var(--accent);
-  opacity: 1;
 }
 .frame.action .k {
   color: var(--pass);
-  opacity: 1;
 }
 .frame.step .k {
-  color: #c77d00;
-  opacity: 1;
-}
-.frame.end .k {
-  color: var(--muted);
+  color: var(--warn);
 }
 
+/* ------------------------------------------------------------ inspector -- */
+
 .inspector {
   border-left: 1px solid var(--line);
   overflow: auto;
-  padding: 16px;
+  padding: 16px 18px 32px;
   background: var(--panel);
 }
 .inspector h3 {
-  margin: 0 0 8px;
-  font-size: 11px;
-  text-transform: uppercase;
-  letter-spacing: 0.08em;
-  color: var(--muted);
-  font-weight: 500;
+  margin: 0 0 9px;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--ink-3);
+  text-transform: capitalize;
 }
 .inspector section {
-  margin-bottom: 20px;
+  margin-bottom: 22px;
+}
+.inspector section + section {
+  padding-top: 18px;
+  border-top: 1px solid var(--line-soft);
 }
 .status {
   display: inline-flex;
   align-items: center;
   gap: 8px;
-}
-.status .dot {
-  width: 8px;
-  height: 8px;
+  font-weight: 500;
+  text-transform: capitalize;
 }
 .kv {
   width: 100%;
   border-collapse: collapse;
 }
 .kv td {
-  padding: 3px 0;
+  padding: 4px 0;
   vertical-align: top;
-  border-bottom: 1px solid var(--line);
+  border-bottom: 1px solid var(--line-soft);
+}
+.kv tr:last-child td {
+  border-bottom: 0;
 }
 .kv td:first-child {
-  color: var(--muted);
-  padding-right: 12px;
+  color: var(--ink-3);
+  padding-right: 14px;
   white-space: nowrap;
+  font-family: var(--font-mono);
+  font-size: 12px;
 }
 .kv td:last-child {
   word-break: break-word;
+  font-family: var(--font-mono);
+  font-size: 12px;
 }
 .val-string {
   color: #b0501f;
@@ -347,99 +544,139 @@ a {
   color: var(--accent);
 }
 .val-fn {
-  color: var(--muted);
+  color: var(--ink-3);
   font-style: italic;
 }
+@media (prefers-color-scheme: dark) {
+  .val-string {
+    color: #d98a5f;
+  }
+}
 .err {
+  margin: 0;
   color: var(--fail);
   white-space: pre-wrap;
+  font-family: var(--font-mono);
   font-size: 12px;
 }
 .hint {
-  color: var(--muted);
+  color: var(--ink-3);
   font-size: 12px;
 }
 kbd {
+  display: inline-block;
+  min-width: 18px;
+  text-align: center;
   border: 1px solid var(--line);
-  border-radius: 4px;
+  border-bottom-width: 2px;
+  border-radius: 5px;
   padding: 0 4px;
+  background: var(--bg);
   font: inherit;
   font-size: 11px;
+  color: var(--ink-2);
+}
+.missing-line {
+  color: var(--fail);
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+.component-line {
+  display: flex;
+  gap: 12px;
+  justify-content: space-between;
+  padding: 3px 0;
+}
+.component-line span:first-child {
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+.component-line .hint {
+  font-family: var(--font-mono);
+  font-size: 11px;
+  overflow: hidden;
+  text-overflow: ellipsis;
 }
 
+/* ------------------------------------------------------------- overview -- */
+
 .overview {
   overflow: auto;
   min-width: 0;
   min-height: 0;
-  padding: 20px 24px 48px;
+  padding: 24px 28px 56px;
 }
 .overview-head {
   display: flex;
   align-items: baseline;
   gap: 16px;
-  padding-bottom: 10px;
+  padding-bottom: 14px;
   border-bottom: 1px solid var(--line);
 }
 .overview-head h1 {
   margin: 0;
-  font-size: 17px;
+  font-size: 19px;
   font-weight: 600;
-  letter-spacing: -0.01em;
+  letter-spacing: -0.02em;
 }
 .overview-meta {
   margin-left: auto;
-  color: var(--muted);
+  color: var(--ink-3);
+  font-family: var(--font-mono);
+  font-size: 11px;
 }
 .overview-section {
-  margin-top: 22px;
+  margin-top: 26px;
 }
 .overview-section h2 {
   margin: 0;
-  font-size: 14px;
+  font-size: 15px;
   font-weight: 600;
 }
 .overview h3 {
-  margin: 18px 0 8px;
-  font-size: 11px;
-  text-transform: uppercase;
-  letter-spacing: 0.08em;
-  color: var(--muted);
-  font-weight: 500;
+  margin: 22px 0 10px;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--ink-3);
+  text-transform: capitalize;
 }
 .overview .empty {
-  color: var(--muted);
-  padding: 24px 0;
+  color: var(--ink-3);
+  padding: 28px 0;
 }
 .head-hint {
   margin-left: 10px;
-  color: var(--muted);
+  color: var(--ink-3);
+  font-weight: 400;
   text-transform: none;
-  letter-spacing: 0;
-  opacity: 0.85;
 }
 
 .props th {
   text-align: left;
-  padding: 0 12px 5px 0;
-  font-size: 11px;
-  font-weight: 500;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-  color: var(--muted);
+  padding: 0 14px 7px 0;
+  font-size: 11.5px;
+  font-weight: 600;
+  color: var(--ink-3);
+  text-transform: capitalize;
   border-bottom: 1px solid var(--line);
 }
 .props td {
-  padding: 7px 12px 7px 0;
+  padding: 9px 14px 9px 0;
 }
 .props td.prop-name {
   color: var(--ink);
+  font-family: var(--font-mono);
+  font-size: 12px;
+  font-weight: 500;
 }
 .props .req {
   color: var(--fail);
 }
 .props .prop-type {
-  color: var(--muted);
+  color: var(--ink-2);
   white-space: pre-wrap;
+  font-family: var(--font-mono);
+  font-size: 12px;
 }
 .props .prop-covered {
   width: 52%;
@@ -448,44 +685,43 @@ kbd {
   display: inline-flex;
   align-items: baseline;
   gap: 4px;
-  margin: 0 6px 4px 0;
-  padding: 1px 8px;
-  border: 1px solid transparent;
-  border-radius: 999px;
-  font-size: 12px;
+  margin: 0 6px 5px 0;
+  padding: 2px 9px;
+  border-radius: var(--r-pill);
+  font-family: var(--font-mono);
+  font-size: 11.5px;
   white-space: nowrap;
 }
 .chip.covered {
   color: var(--pass);
-  background: color-mix(in srgb, var(--pass) 14%, transparent);
-  border-color: color-mix(in srgb, var(--pass) 32%, transparent);
+  background: color-mix(in srgb, var(--pass) 11%, transparent);
 }
 .chip.missing {
   color: var(--fail);
-  background: color-mix(in srgb, var(--fail) 14%, transparent);
-  border-color: color-mix(in srgb, var(--fail) 32%, transparent);
+  background: color-mix(in srgb, var(--fail) 11%, transparent);
 }
 .chip-default {
-  color: var(--muted);
-  font-size: 11px;
+  color: var(--ink-3);
+  font-size: 10.5px;
 }
 
 .gallery {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
-  gap: 14px;
+  gap: 16px;
 }
 .tile {
   display: block;
   width: 100%;
   text-align: left;
   border: 1px solid var(--line);
-  border-radius: 10px;
+  border-radius: var(--r-lg);
   overflow: hidden;
-  background: var(--panel);
+  background: var(--raised);
+  transition: border-color 0.15s ease;
 }
 .tile:hover {
-  border-color: var(--muted);
+  border-color: var(--accent);
 }
 .thumb {
   height: 150px;
@@ -502,26 +738,18 @@ kbd {
   pointer-events: none;
 }
 .thumb .hint {
-  padding: 10px;
+  padding: 12px;
 }
 .cap {
   display: flex;
   align-items: center;
   gap: 8px;
-  padding: 7px 10px;
+  padding: 9px 12px;
   min-width: 0;
+  font-size: 12.5px;
 }
 .cap-name {
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
-
-.missing-line {
-  color: var(--fail);
-}
-.component-line {
-  display: flex;
-  gap: 12px;
-  justify-content: space-between;
-}

package/vite.config.ts

@@ -4,7 +4,7 @@ import { defineConfig, type Plugin } from 'vite'
 
 /** Where the manifest and snapshots live. The CLI sets this; the default is the example project. */
 function dataDir(): string {
-  return resolve(process.env.DESCRIBE_ME_DIR ?? '../../examples/react-basic/.describe-me')
+  return resolve(process.env.DESCRIBE_ME_DIR ?? '../../examples/react-browser/.describe-me')
 }
 
 /**