feat(site): span-driven demo blocks + fix findQuantities span anchoring

[Aymericr]

What

Three docs-site demos built on lingo's spans, reworked after an adversarial review, plus one library bug the demos surfaced.

Site (apps/site)

• Token highlighter — regexes propose slices of a sentence; parseDate / parseDateRange / parseDuration confirm each one. A color only appears where lingo actually read something; the whole-input reading (single date / range / duration / declined) is shown alongside, with lingo's own issue message when it declines.
• Remind me popover — a Base UI Popover whose presets (tomorrow, next week, this weekend, someday) and free-text field go through the same reader. No hard-coded times: a preset row shows exactly what typing its phrase would give, or — when lingo has no reading.
• Workflow rules — automation sentences where findQuantities pulls the numeric bounds (below $10k, over 15 minutes) out with spans into the original string; entity chips are vendor-neutral and icon-labelled.
• Token colors are --token-* OKLCH variables in globals.css with light and dark values, applied via data-token.
• Shared lib/date-display.ts (day / clock / range / zone formatters) and ui/popover.tsx.
• Docs page + sidebar entries under Dates & durations and One schema; landing sections.

Library (packages/lingo)

• findQuantities returned mid-word spans for open-bound ranges and fuzzy spreads that did not start the input (call mom over 5 min → [2, 19)): the qualifier branch of parseRangeOrQty passed a token index where okRange expects a normalized offset. Spans now start at the qualifier. Regression test in grammar.test.ts; CHANGELOG under [Unreleased].

Hydration fix (pre-existing, site-wide)

/docs, /forms and /escalation on production throw React #418 for any visitor whose browser zone is not UTC, and React re-renders the whole page client-side. Cause: demos hold a local wall-clock SSR_NOW through hydration, and the calendar demo's Output JSON / coverage table print UTC instants, which differ per zone. Instant-bearing text now fills in after hydration (useHydrated); wall-clock labels were already zone-stable.

Adversarial review → changes

The first version was reviewed adversarially; every finding was addressed:

• Default readouts that showed garbage or empty placeholders (presets lingo could not parse, parseRange on full sentences) → presets are phrases lingo reads; the one deliberately declined sentence is labelled as such.
• eight pm classified as a quantity → word-number hours handled; overlap resolution is priority → length → position instead of earliest-start-wins.
• Dead now parameter, un-memoised new Date() in render, timezone label hydration mismatch → fixed.
• Marketing copy and brand names (Superhuman, Linear, gpu-time, "zero-latency", "production-ready") → removed; copy describes what the code does.
• Hand-rolled dropdown, invisible input, emoji icons, mouse-only tooltips → Base UI Select / Popover, visible Input, aria-pressed presets, Lucide icons.
• Hard-coded hex colors → OKLCH design tokens.
• Duplicate / inverted headings → DemoFrame everywhere; section headings are thesis-style like their neighbours.

Verification

• bun run check (typecheck, tests, build, size budgets, corpus gates, zero-deps, docs sync, schema artifacts): green.
• bun run lint: clean. React Doctor: no new issues on 9b1f3a9.
• Site production build served with TZ=UTC, loaded in headless Chrome with TZ=America/Los_Angeles and Pacific/Auckland: no console errors on /, /docs, /forms, /escalation, /integrations.
• Same check against the Vercel preview of this PR: clean; against current production lingo.pascal.app/docs: React #418.

lingo_reworked_blocks_walkthrough.mp4

Token highlighter: a sentence lingo declines whole, with the three slices it did confirm

Workflow rule: two thresholds extracted from a typed sentence

Deploy

Production deploys from main through the Vercel Git integration; merging this PR ships it.

_{To show artifacts inline, enable in settings.}

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
lingo	Ready	Preview	Sep 13, 2026 5:39am UTC

[pascal]

I hit an error while handling your request (Model unavailable on AI Gateway free tier: Free tier users do not have access to this model. Upgrade to paid credits at https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fai%3Fmodal%3Dtop-up for unrestricted…).

Please try again, rephrase, or reach out if it keeps failing.

Error id: 56cf829b-902f-432e-a8dd-69cf6c3c82d0

[github-actions]

React Doctor found no new issues. 🎉

_{Reviewed by React Doctor for commit 9b1f3a9.}