feat(web): Storybook for offline UI design + light theme + brand spinner

Stand up Storybook so the management console can be designed without a running host, plus the design-system work that surfaced along the way. Storybook (@storybook/react-vite): - Slim Start/Nitro-free vite config; the preview imports the app's real src/styles.css directly so the design tokens stay single-sourced (no mirror). - Stories for the @unom/ui primitives (Button/Card/Inputs/Badge), brand marks, the AppShell (throwaway in-memory TanStack router), and every data-driven page (Dashboard/Host/Clients/Library/Settings) rendered offline via a window.fetch stub + typed fixtures. The route page components are exported so stories can render them. Light theme: - styles.css now carries a light :root (lavender, from the docs palette) with the existing violet chrome moved to .dark; the live console still pins html.dark by default, so this only adds the option (Storybook's toolbar toggles it). - Fixes a stray `*/` inside a comment that prematurely closed it and silently broke Tailwind's @theme processing. Spinner: - The punktfunk lens recreated with motion/react: two circles surge through one another in depth (JS perspective scale + z-index — robust where mix-blend-mode flattens CSS preserve-3d) with a screen-blend lens highlight. Replaces the skeleton loading state in QueryState; removes ui/skeleton.tsx. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-25 21:58:36 +00:00
parent e785591bf7
commit 6bd2e3341f
30 changed files with 1164 additions and 246 deletions
@@ -0,0 +1,87 @@
+// Mock API payloads for the page stories — typed against the generated models so
+// they stay honest if the OpenAPI schema changes.
+import type { AvailableCompositor } from '@/api/gen/model/availableCompositor'
+import type { GameEntry } from '@/api/gen/model/gameEntry'
+import type { HostInfo } from '@/api/gen/model/hostInfo'
+import type { PairedClient } from '@/api/gen/model/pairedClient'
+import type { RuntimeStatus } from '@/api/gen/model/runtimeStatus'
+
+export const hostInfo: HostInfo = {
+  abi_version: 2,
+  app_version: '7.1.450.0',
+  codecs: ['h264', 'h265', 'av1'],
+  gfe_version: '3.23.0.74',
+  hostname: 'ENRICOS-DESKTOP',
+  local_ip: '192.168.1.173',
+  ports: {
+    audio: 48000,
+    control: 47999,
+    http: 47989,
+    https: 47984,
+    mgmt: 47990,
+    rtsp: 48010,
+    video: 47998,
+  },
+  uniqueid: '0f8a1c3e9b7d4a62',
+  version: '0.2.0',
+}
+
+export const compositors: AvailableCompositor[] = [
+  { id: 'kwin', label: 'KWin (Plasma)', available: true, default: true },
+  { id: 'gamescope', label: 'gamescope', available: true, default: false },
+  { id: 'mutter', label: 'Mutter (GNOME)', available: false, default: false },
+  { id: 'wlroots', label: 'Sway / wlroots', available: false, default: false },
+]
+
+export const statusActive: RuntimeStatus = {
+  video_streaming: true,
+  audio_streaming: true,
+  paired_clients: 3,
+  pin_pending: false,
+  session: { width: 5120, height: 1440, fps: 240 },
+  stream: {
+    codec: 'h265',
+    width: 5120,
+    height: 1440,
+    fps: 240,
+    bitrate_kbps: 150_000,
+    min_fec: 5,
+    packet_size: 1392,
+  },
+}
+
+export const statusIdle: RuntimeStatus = {
+  video_streaming: false,
+  audio_streaming: false,
+  paired_clients: 1,
+  pin_pending: true,
+  session: null,
+  stream: null,
+}
+
+export const pairedClients: PairedClient[] = [
+  {
+    fingerprint: 'a1b2c3d4e5f60718293a4b5c6d7e8f90112233445566778899aabbccddeeff00',
+    subject: 'enricos-macbook',
+    not_before_unix: 1_718_000_000,
+    not_after_unix: 2_030_000_000,
+  },
+  {
+    fingerprint: 'ff00eeddccbbaa998877665544332211009f8e7d6c5b4a39281706f5e4d3c2b1',
+    subject: 'living-room-tv',
+    not_before_unix: 1_718_500_000,
+    not_after_unix: 2_030_000_000,
+  },
+  {
+    fingerprint: '0011223344556677889900aabbccddeeff112233445566778899aabbccddeeff',
+    subject: null,
+  },
+]
+
+const noArt = { header: null, hero: null, logo: null, portrait: null }
+export const library: GameEntry[] = [
+  { id: 'steam:1245620', store: 'steam', title: 'Elden Ring', art: noArt, launch: null },
+  { id: 'steam:1086940', store: 'steam', title: "Baldur's Gate 3", art: noArt, launch: null },
+  { id: 'steam:413150', store: 'steam', title: 'Stardew Valley', art: noArt, launch: null },
+  { id: 'custom:retroarch', store: 'custom', title: 'RetroArch', art: noArt, launch: null },
+]
@@ -0,0 +1,49 @@
+import { type ReactNode, useEffect, useRef, useState } from 'react'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+
+/** Map of API pathname (e.g. `/api/v1/host`) → JSON body to return for a GET. */
+export type MockRoutes = Record<string, unknown>
+
+/**
+ * Renders a data-backed page WITHOUT a running host by stubbing `window.fetch`
+ * for the lifetime of the story: matched pathnames return their mock JSON (200),
+ * everything else returns `{}` (200) so mutations + polling never error. The
+ * real orval/React-Query hooks run unchanged, so loading/success transitions and
+ * `refetchInterval` behave exactly as in the app. Each story gets a fresh,
+ * isolated QueryClient (retries off).
+ */
+export function MockApi({ routes, children }: { routes: MockRoutes; children: ReactNode }) {
+  // Read the latest routes inside the stub without re-installing it.
+  const routesRef = useRef(routes)
+  routesRef.current = routes
+  const [stubbed, setStubbed] = useState(false)
+
+  useEffect(() => {
+    const real = window.fetch
+    const stub = (input: RequestInfo | URL): Promise<Response> => {
+      const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url
+      const path = new URL(url, window.location.origin).pathname
+      const data = path in routesRef.current ? routesRef.current[path] : {}
+      return Promise.resolve(
+        new Response(JSON.stringify(data ?? null), {
+          status: 200,
+          headers: { 'content-type': 'application/json' },
+        }),
+      )
+    }
+    window.fetch = stub as typeof window.fetch
+    setStubbed(true)
+    return () => {
+      window.fetch = real
+    }
+  }, [])
+
+  const [queryClient] = useState(
+    () => new QueryClient({ defaultOptions: { queries: { retry: false } } }),
+  )
+
+  // Hold the first render until the stub is installed, so the page's initial
+  // query resolves against the mock rather than racing a real (failing) request.
+  if (!stubbed) return null
+  return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+}