chromatic: ShaderHero.stories build error — 'FE is not a function' (pre-existing on main since 2026-05-19)

[A-PachecoT]

Symptom

chromatic CI step fails when building Storybook with error:

Error: Error: page.evaluate: TypeError: FE is not a function
    at .../ShaderHero.stories-<hash>.js:1:295

Evidence pre-existing

gh run list --branch main --workflow Chromatic --limit 3 returns 3 consecutive failure runs since 2026-05-19:

• 1286540 (2026-05-20 20:44Z)
• f8722bd (2026-05-20 17:58Z)
• d1c4955 (2026-05-19 16:41Z)

Surfaced during the mobile-first Tier 1 cycle (docs-ai PR #46 / cofoundy/ui PR #8). NOT introduced by either PR — neither touches src/stories/landing/ShaderHero.stories.tsx or related shader components.

Hypothesis

FE is likely a minified bundle reference — Three.js / @react-three/fiber / shadergradient subpackage failing to initialize in headless Chromium under @storybook/test-runner / Chromatic's static build. Probably a bundler-target mismatch (CommonJS vs ESM) or a server-side import in a client-only component.

Repro

1. cd ~/cofoundy/packages/ui && pnpm storybook:build
2. Open the built static Storybook in headless Chromium
3. Navigate to ShaderHero story → console error fires

Suggested triage owner

UI infra / chromatic maintainer. Not blocking mobile-first Tier 1.

Cross-links

• docs-ai PR #46 (merged): https://github.com/cofoundy/docs-ai/pull/46
• cofoundy/ui PR feat(stories): MobileBaseline contract for interactive primitives #8 (mobile-first stories — affected by this issue but unrelated to fix): feat(stories): MobileBaseline contract for interactive primitives #8