honey LED rim on homepage copy chip (periwinkle on copy)

[ghesp]

Stacked on #547 (equalize hero CTA gaps), which is stacked on #540 (agent prompt homepage chip). Do not merge before those PRs.

Railway preview (homepage): https://docspage-docspage-pr-548.up.railway.app/

Hard-refresh that URL — 9349864 types the incoming command in on For humans ↔ For agents at a shared 23ms/glyph pace. Hex #542 is unchanged.

Head SHA: 934986464c62f6a4971011da742e058398081a58

Summary

Georgina asked for the homepage hero copy chip to use the same behaviour as the 404 hex LED (PR #542): honey idle crawl + soft bloom, periwinkle #5368BD on the agents tab.

Typewriter (9ff5bd7, shared pace 9349864)

On tab change the outgoing command clears (~70ms), then the incoming string types in character-by-character. The chip stays mounted so the LED rim does not restart.

Speed: both tabs use a fixed 23ms per glyph — the humans pace from clamp(round(520 / n), 6, 28) when n is 23. The longer agents prompt is not sped up; it just takes longer (~1.9s of glyphs + 70ms clear).

A 1px caret blinks while glyphs land (hidden for prefers-reduced-motion). Reduced motion gets the full string instantly — no typewriter, no fill dim.

Fill dim still bookends the switch (bg-black/25 inside the pill). Copy icon stays put. Shared humans width, overflow fade, and horizontal scroll are unchanged. Glow stays tab-linked (honey / periwinkle), not copy.

Tab glow + fill dim

• Glow: honey #E69135 on For humans, periwinkle #5368BD on For agents. The hex deploy lerp eases the colour (responseSmoothing 0.17 ≈ 510ms). Copy shows the check tick only — it does not drive rgbDeployActive.
• Fill dim: a bg-black/25 overlay inside the pill bookends the type-in. The page and LED rim stay undimmed. prefers-reduced-motion skips the overlay.

Chip width (1872fce)

Both tabs hug the humans command ($ npx @docs.page/cli init + copy icon + padding). An invisible in-flow sizer holds that row; the visible snippet is absolute so the agents prompt cannot widen the pill. inline-flex w-max max-w-full mx-auto — content-hug vs the page, not the hero column.

When the snippet overflows, a trailing-edge CSS mask fades the text over 1.25rem on the scrollport. The copy icon sits outside the scroll/fade. The snippet uses overflow-x-auto (touch / trackpad / mouse) with the scrollbar hidden; the chip width does not grow while scrolling.

Chip bloom

Chip-only (404 hex on #542 unchanged). Honey #E69135 / periwinkle #5368BD unchanged.

Constant	38f51b6	777262c	356865d
CHIP_BLOOM_CSS (canvas pad)	32	52	52
CHIP_NEAR_RADIUS_SCALE	0.18	0.26	0.23
CHIP_NEAR_INTENSITY	1.38	1.90	1.68
CHIP_FAR_INTENSITY	0.80	1.12	0.98
CHIP_FAR_POWER (lower → longer tail)	0.32	0.28	0.30
DIRECT_TRIANGLE_INTENSITY_SCALE	58	82	72
DIRECT_TRIANGLE_ABSORPTION	1.7	1.45	1.52

Mask edge

Far bloom was lighting the whole presentation buffer, so the pad showed as a hard honey rectangle. Expanding the pad only moved that line.

• Floor shader buffer_edge_fade: coverage → 0 in the outer 55% of the canvas pad (smoothstep, all four sides). The LED rim sits at the chip edge, inside the fade, so corners/AA stay hex-style.
• Canvas pad is also clamped to the viewport so _app overflow-x-clip cannot cut the sides.
• Chip / hero stacks are overflow-visible.

Matches #542 except rounded-rect path + chip bloom

• LEDS_PER_EDGE = 24 (144 capsules)
• led-buffer crawl, honey / periwinkle linear, hero-frame-state deploy lerp
• Sim floor (MIN_SIM_HEIGHT 360), canvas dpr: [1, 2]
• Tab (not copy) → rgbDeployActive → deploy lerp
• Same hex occluder AA on the chip’s rounded-rect SDF (transparent interior)

Remaining differences (intentional)

#542 hex	Chip on this PR
Pointy hex + 6×60° fillets	Chip rounded-xl + 4×90° fillets
Black hex fill	Transparent interior (periwinkle-950 shows through)
Canvas pointer-down is the hold	Tab drives rgbDeployActive (agents = periwinkle)
Hex sized by TRIANGLE_HEIGHT_RATIO + desktop zoom	Outline measured from the chip box + bloom pad
Fillet = HEX_FILLET_RATIO of circumradius	Fillet = CSS border-radius of the chip
lil-gui + hover brush on the canvas	No GUI; overlay is pointer-events-none
Hex bloom tunables	Chip-local bloom (softer than 777262c)

Humans/agents tabs, copy tracking, and Get started are unchanged. The 404 branch was read only.

Scope

• app/ (hosted site, MCP, Ask AI)
• packages/cli/
• packages/mdx-bundler/
• docs/ (product documentation)
• Repo / CI / other

Type of change

• Bug fix
• New feature
• Documentation
• Refactor / chore

Test plan

• bun run check passes locally
• bun run --cwd app build passes locally (Next typecheck)
• Hard-refresh Railway: both tabs type at 23ms/glyph; glow and fill dim bookend the type-in; copy tick does not recolor the rim
• prefers-reduced-motion: instant full text, no typewriter / no fill dim
• LED crawl does not restart on tab change

Notes for reviewers

Depends on #547 (and transitively #540). Base is cursor/equalize-hero-cta-gaps-fc07.

Adds vgpu / @vgpu/wgsl and the same Next wgsl loader as #542. Do not merge this before those homepage PRs.

This VM has no WebGPU adapter — confirm the fade and brightness on Railway in a GPU browser.

  

[railway-app]

🚅 Deployed to the docs.page-pr-548 environment in docs.page

Service	Status	Web	Updated
docs.page	✅ Success (View Logs)	Web	Sep 8, 2026 at 4:43 pm UTC

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 2 committers have signed the CLA.

❌ cursoragent
❌ claude
_{You have signed the CLA already but the status is still pending? Let us recheck it.}