chore: compare two-line capability status markers and requirement pills

examples/supported-devices-prototypes/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex, nofollow" />
+    <title>Two-line DeviceDB · Design review</title>
+  </head>
+  <body>
+    <main id="root">Loading design review…</main>
+    <script type="module" src="./src/main.tsx"></script>
+  </body>
+</html>

examples/supported-devices-prototypes/src/App.tsx

@@ -0,0 +1,282 @@
+import { useEffect, useState } from 'react'
+
+import {
+  getCapabilityLabel,
+  getProvidersWithMissingRequirements,
+  resolveProviderRequirements,
+  scopeDeviceModelsToProvider,
+} from 'lib/seam/components/SupportedDevices/device-models.js'
+import { useEcosystemDeviceModelSummaries } from 'lib/seam/ecosystem/use-ecosystem-device-model-summaries.js'
+import { useEcosystemProviderRequirements } from 'lib/seam/ecosystem/use-ecosystem-provider-requirements.js'
+
+import { CheckInfo } from './CheckInfo.js'
+import { reviewDevice } from './model.js'
+import { Picker } from './Picker.js'
+import { RequirementPills } from './RequirementPills.js'
+import { Legend } from './shared.js'
+import { Stacked } from './Stacked.js'
+
+const variants = [
+  {
+    name: 'Current',
+    title: 'Two-line rows · current version',
+    description:
+      'The selected layout, with capability-specific icons and one requirements disclosure.',
+    component: Stacked,
+  },
+  {
+    name: 'Checks',
+    title: 'Two-line rows · checks and info',
+    description:
+      'Green checks indicate support. Amber info icons indicate additional requirements. Capability names stay visible.',
+    component: CheckInfo,
+  },
+  {
+    name: 'Pills',
+    title: 'Two-line rows · requirement pills',
+    description:
+      'The same check/info treatment, with explicit bridge, keypad, and subscription pills. Open a row for the full requirements.',
+    component: RequirementPills,
+  },
+]
+const brands = [
+  { slug: 'nuki', label: 'Nuki', provider: 'nuki-web' },
+  { slug: 'august', label: 'August', provider: 'august-access' },
+  { slug: 'keyincode', label: 'KeyInCode', provider: 'keyincode' },
+]
+const params = new URLSearchParams(window.location.search)
+const requestedVariant = Number(params.get('v')) - 1
+const initialVariant =
+  Number.isInteger(requestedVariant) &&
+  requestedVariant >= 0 &&
+  requestedVariant < variants.length
+    ? requestedVariant
+    : 0
+
+export function App(): JSX.Element {
+  const [active, setActive] = useState(initialVariant)
+  const [replay, setReplay] = useState(0)
+  const [brandSlug, setBrandSlug] = useState(params.get('brand') ?? 'nuki')
+  const [dark, setDark] = useState(params.get('theme') === 'dark')
+  const [search, setSearch] = useState('')
+  const [capability, setCapability] = useState('')
+  const brand = brands.find((entry) => entry.slug === brandSlug) ?? brands[0]
+  const variant = variants[active] ?? variants[0]
+
+  useEffect(() => {
+    const url = new URL(window.location.href)
+    url.searchParams.set('v', String(active + 1))
+    url.searchParams.set('brand', brandSlug)
+    url.searchParams.set('theme', dark ? 'dark' : 'light')
+    window.history.replaceState(null, '', url)
+    document.documentElement.style.colorScheme = dark ? 'dark' : 'light'
+  }, [active, brandSlug, dark])
+
+  const modelsQuery = useEcosystemDeviceModelSummaries({
+    manufacturer: brand?.slug,
+    provider: brand?.provider,
+    deviceType: 'smartlock',
+  })
+  const scopedModels = scopeDeviceModelsToProvider(
+    modelsQuery.deviceModels ?? [],
+    brand?.provider
+  )
+  const missing = getProvidersWithMissingRequirements(scopedModels)
+  const requirementsQuery = useEcosystemProviderRequirements(missing)
+  const devices = resolveProviderRequirements(
+    scopedModels,
+    requirementsQuery.providers ?? []
+  ).map(reviewDevice)
+  const allCapabilities = [
+    ...new Set(
+      devices.flatMap((device) => device.capabilities.map((item) => item.name))
+    ),
+  ]
+  const filtered = devices.filter((device) => {
+    const text = [
+      device.name,
+      ...device.source.variants.map((item) => item.manufacturer_model_id),
+    ]
+      .join(' ')
+      .toLowerCase()
+    return (
+      text.includes(search.toLowerCase().trim()) &&
+      (capability === '' ||
+        device.capabilities.some((item) => item.name === capability))
+    )
+  })
+  const loading =
+    modelsQuery.isLoading || (missing.length > 0 && requirementsQuery.isLoading)
+  const error = modelsQuery.isError || requirementsQuery.isError
+  if (variant == null || brand == null) return <p>Design review unavailable.</p>
+  const Variant = variant.component
+
+  return (
+    <div
+      className={`seam-ecosystem seam-ecosystem-theme-${dark ? 'dark' : 'light'} seam-proto-page`}
+    >
+      <aside
+        className='seam-proto-review-bar'
+        aria-label='Design review controls'
+      >
+        <span>
+          <strong>DeviceDB</strong>{' '}
+          <span className='seam-proto-muted'>/ Design review</span>
+        </span>
+        <div className='seam-proto-review-controls'>
+          <label>
+            Preview brand{' '}
+            <select
+              value={brand.slug}
+              onChange={(event) => {
+                setBrandSlug(event.target.value)
+                setSearch('')
+                setCapability('')
+              }}
+            >
+              {brands.map((item) => (
+                <option value={item.slug} key={item.slug}>
+                  {item.label}
+                </option>
+              ))}
+            </select>
+          </label>
+          <button
+            type='button'
+            aria-pressed={dark}
+            onClick={() => {
+              setDark(!dark)
+            }}
+          >
+            Dark mode
+          </button>
+        </div>
+      </aside>
+      <div className='seam-proto-workspace'>
+        <header className='seam-proto-intro'>
+          <span className='seam-proto-eyebrow'>
+            Option {active + 1} of {variants.length} · {variant.name}
+          </span>
+          <h1>{variant.title}</h1>
+          <p>{variant.description}</p>
+          <p className='seam-proto-shortcuts'>
+            Switch below or use keys 1–3 / ← →. R resets open details.
+          </p>
+        </header>
+        <section className='seam-proto-stage' aria-labelledby='catalog-title'>
+          <div className='seam-proto-context'>
+            <span>Brand guides / {brand.label}</span>
+            <a
+              href={`https://www.seam.co/docs/device-and-system-integration-guides/${brand.slug}-locks/index`}
+              target='_blank'
+              rel='noreferrer'
+            >
+              View live guide ↗
+            </a>
+          </div>
+          <h2 id='catalog-title'>Supported devices</h2>
+          <p className='seam-proto-stage-description'>
+            Supported capabilities at a glance. Open a row for setup
+            requirements and model details.
+          </p>
+          <div className='seam-proto-filters'>
+            <label className='seam-proto-search'>
+              Search devices
+              <input
+                type='search'
+                value={search}
+                placeholder='Search by name or model number'
+                onChange={(event) => {
+                  setSearch(event.target.value)
+                }}
+              />
+            </label>
+            <label>
+              Capability
+              <select
+                value={capability}
+                onChange={(event) => {
+                  setCapability(event.target.value)
+                }}
+              >
+                <option value=''>All capabilities</option>
+                {allCapabilities.map((name) => (
+                  <option key={name} value={name}>
+                    {getCapabilityLabel(name)}
+                  </option>
+                ))}
+              </select>
+            </label>
+          </div>
+          <div className='seam-proto-catalog-heading'>
+            <strong>{brand.label}</strong>
+            <span aria-live='polite'>
+              {loading ? 'Loading…' : `${filtered.length} devices`}
+            </span>
+          </div>
+          <Legend />
+          {loading ? (
+            <p className='seam-proto-state' role='status'>
+              Loading capabilities and requirements…
+            </p>
+          ) : error ? (
+            <div className='seam-proto-state' role='alert'>
+              <p>We couldn’t load the complete device information.</p>
+              <button
+                type='button'
+                onClick={() => {
+                  void modelsQuery.refetch()
+                  if (missing.length > 0) void requirementsQuery.refetch()
+                }}
+              >
+                Try again
+              </button>
+            </div>
+          ) : filtered.length === 0 ? (
+            <div className='seam-proto-state'>
+              <p>No devices match these filters.</p>
+              <button
+                type='button'
+                onClick={() => {
+                  setSearch('')
+                  setCapability('')
+                }}
+              >
+                Clear filters
+              </button>
+            </div>
+          ) : (
+            <div
+              key={`${active}-${replay}-${brand.slug}`}
+              className={`seam-proto-variant seam-proto-variant-${variant.name.toLowerCase()}`}
+            >
+              <Variant devices={filtered} />
+            </div>
+          )}
+          <a
+            className='seam-proto-catalog-link'
+            href={`https://www.seam.co/manufacturers/${brand.slug}`}
+            target='_blank'
+            rel='noreferrer'
+          >
+            View {brand.label} in the device catalog ↗
+          </a>
+        </section>
+        <p className='seam-proto-review-note'>
+          Review prototype · Live Ecosystem catalog ·{' '}
+          <a href='https://linear.app/seam/issue/DEVDB-466'>
+            Dawn’s design feedback ↗
+          </a>
+        </p>
+      </div>
+      <Picker
+        names={variants.map((item) => item.name)}
+        active={active}
+        onChange={setActive}
+        onReplay={() => {
+          setReplay((value) => value + 1)
+        }}
+      />
+    </div>
+  )
+}

examples/supported-devices-prototypes/src/CheckInfo.tsx

@@ -0,0 +1,23 @@
+import type { VariantProps } from './model.js'
+import { CompactRow, DeviceIdentity, Features } from './shared.js'
+
+export function CheckInfo({ devices }: VariantProps): JSX.Element {
+  return (
+    <div className='seam-compact-list'>
+      <div className='seam-compact-list-heading'>
+        <span>Device & supported capabilities</span>
+      </div>
+      {devices.map((device) => (
+        <CompactRow
+          key={device.source.device_model_id}
+          device={device}
+          layout='stacked'
+        >
+          <DeviceIdentity device={device} showType={false}>
+            <Features device={device} statusIcons />
+          </DeviceIdentity>
+        </CompactRow>
+      ))}
+    </div>
+  )
+}