The Open Framework for Building Agents
Add Eve logo shader hero updates (#430)
Matias Gonzalez2ccf3d1342ed
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsxindex 3a8e409e0..20f988e59 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/index.tsx@@ -1,7 +1,10 @@"use client";import { App, Device, type VGPUAdapter } from "@vgpu/core";-import { useEffect, useRef, useState } from "react";+import { getImageProps } from "next/image";+import fallbackDarkImage from "../../../../../public/eve-5/fallback-dark-content.webp";+import fallbackLightImage from "../../../../../public/eve-5/fallback-light-content.webp";+import { useEffect, useRef, useState, type ComponentProps, type CSSProperties } from "react";import { decodeGltfMesh, meshAspect } from "./mesh";import { BLOOM_RADIUS, createEve5Renderer, type RenderControls } from "./render";@@ -14,6 +17,11 @@ class BrowserAdapter implements VGPUAdapter {}const MODEL_URL = "/eve-5/eve-logo.gltf";+const FALLBACK_IMAGE_WIDTH = 1095;+const FALLBACK_IMAGE_HEIGHT = 348;+const FALLBACK_IMAGE_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH} / ${FALLBACK_IMAGE_HEIGHT}`;+const FALLBACK_CONTAINER_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH + BLOOM_RADIUS} / ${FALLBACK_IMAGE_HEIGHT + BLOOM_RADIUS}`;+const FALLBACK_IMAGE_SIZES = "(min-width: 768px) 1095px, calc(100vw - 16px)";const DEFAULT_LOGO_ASPECT = 78 / 25;const DEFAULT_CONTROLS: RenderControls = {yaw: 0,@@ -29,8 +37,11 @@ const DEFAULT_CONTROLS: RenderControls = {};const LOGO_RENDER_HEIGHT = 500;const MAX_DEVICE_PIXEL_RATIO = 2;+const FALLBACK_IMAGE_PADDING = BLOOM_RADIUS / MAX_DEVICE_PIXEL_RATIO;const MAX_ENV_YAW = 0.45;const ENV_YAW_LERP_SPEED = 3;+const CANVAS_FADE_FALLBACK_MS = 800;+const CANVAS_REVEAL_RENDER_COUNT = 3;function getCurrentTheme(): "light" | "dark" {if (typeof document === "undefined") return "light";@@ -64,18 +75,52 @@ function useResolvedTheme() {return theme;}+function usePrefersReducedMotion() {+ const [prefersReducedMotion, setPrefersReducedMotion] = useState<boolean | null>(null);++ useEffect(() => {+ const media = window.matchMedia("(prefers-reduced-motion: reduce)");+ const syncPreference = () => setPrefersReducedMotion(media.matches);++ syncPreference();+ media.addEventListener("change", syncPreference);++ return () => media.removeEventListener("change", syncPreference);+ }, []);++ return prefersReducedMotion;+}+export function EveLogoShader() {const theme = useResolvedTheme();+ const prefersReducedMotion = usePrefersReducedMotion();const canvasRef = useRef<HTMLCanvasElement>(null);const controlsRef = useRef<RenderControls>({ ...DEFAULT_CONTROLS });const [logoAspect, setLogoAspect] = useState(DEFAULT_LOGO_ASPECT);+ const [revealed, setRevealed] = useState(false);+ const [showLightFallback, setShowLightFallback] = useState(false);useEffect(() => {let cancelled = false;let animationFrame = 0;+ let cleanup: (() => void) | undefined;let targetEnvYaw = controlsRef.current.envYaw;let previousFrameTime = performance.now();+ const canvas = canvasRef.current;+ resetCanvasVisibility(canvas);+ setRevealed(false);++ if (prefersReducedMotion !== false) {+ // No WebGPU animation will run (reduced motion or the preference hasn't+ // resolved yet), so the canvas stays hidden. Show the static light+ // fallback to mirror the dark fallback, which is always visible until+ // the animation reveals. Otherwise light-theme users would see a blank hero.+ setShowLightFallback(true);+ return;+ }+ setShowLightFallback(false);+const updateEnvYaw = (clientX: number) => {const viewportWidth = Math.max(1, window.innerWidth || 1);const normalizedX = Math.max(-1, Math.min(1, (clientX / viewportWidth) * 2 - 1));@@ -88,7 +133,10 @@ export function EveLogoShader() {const renderTheme = theme;const canvas = canvasRef.current;const context = canvas?.getContext("webgpu");- if (!canvas || !context || !navigator.gpu) return;+ if (!canvas || !context || !navigator.gpu) {+ setShowLightFallback(true);+ return;+ }const mesh = await loadMesh();if (cancelled) return;@@ -108,8 +156,34 @@ export function EveLogoShader() {const renderer = createEve5Renderer(app.device, format, mesh, { theme: renderTheme });previousFrameTime = performance.now();+ let disposed = false;+ let successfulRenderCount = 0;+ let finishCanvasFade: (() => void) | undefined;+ const dispose = () => {+ if (disposed) return;+ disposed = true;+ cancelAnimationFrame(animationFrame);+ finishCanvasFade?.();+ resetCanvasVisibility(canvas);+ if (!cancelled) setRevealed(false);+ renderer.dispose();+ app.device.destroy();+ };++ app.device.gpu.lost+ .then(() => {+ if (cancelled) return;+ setRevealed(false);+ setShowLightFallback(true);+ cancelled = true;+ dispose();+ })+ .catch(() => {+ // The landing page must degrade silently when the GPU process is unavailable.+ });+const draw = (frameTime = performance.now()) => {- if (cancelled) return;+ if (cancelled || disposed) return;const deltaSeconds = Math.max(0, (frameTime - previousFrameTime) / 1000);previousFrameTime = frameTime;@@ -122,24 +196,39 @@ export function EveLogoShader() {// shader's @builtin(position) sample different pixels from the back-side targets on DPR > 1.const logicalWidth = Math.max(1, canvas.width - BLOOM_RADIUS * 2);const logicalHeight = Math.max(1, canvas.height - BLOOM_RADIUS * 2);- renderer.render(context.getCurrentTexture().createView(), controlsRef.current, logicalWidth, logicalHeight);++ try {+ renderer.render(context.getCurrentTexture().createView(), controlsRef.current, logicalWidth, logicalHeight);+ } catch {+ cancelled = true;+ setRevealed(false);+ setShowLightFallback(true);+ dispose();+ return;+ }++ successfulRenderCount += 1;+ if (successfulRenderCount === CANVAS_REVEAL_RENDER_COUNT) {+ canvas.style.opacity = "1";+ finishCanvasFade = onCanvasFullyOpaque(canvas, () => {+ if (!cancelled) setRevealed(true);+ });+ }+animationFrame = requestAnimationFrame(draw);};draw();- return () => {- renderer.dispose();- app.device.destroy();- };+ return dispose;}- let cleanup: (() => void) | undefined;start().then((dispose) => {cleanup = dispose;}).catch(() => {+ setShowLightFallback(true);// The landing page must degrade silently when WebGPU or the GPU process is unavailable.});@@ -148,24 +237,80 @@ export function EveLogoShader() {cancelAnimationFrame(animationFrame);window.removeEventListener("pointermove", onPointerMove);cleanup?.();+ resetCanvasVisibility(canvasRef.current);};- }, [theme]);+ }, [theme, prefersReducedMotion]);const logicalSize = getLogicalRenderSize(logoAspect);const paddedWidth = logicalSize.width + BLOOM_RADIUS * 2;const paddedHeight = logicalSize.height + BLOOM_RADIUS * 2;+ const fallbackImageOptions = {+ alt: "",+ width: FALLBACK_IMAGE_WIDTH,+ height: FALLBACK_IMAGE_HEIGHT,+ sizes: FALLBACK_IMAGE_SIZES,+ priority: true,+ quality: 95,+ } as const;+ const { props: fallbackLightImageProps } = getImageProps({+ ...fallbackImageOptions,+ src: fallbackLightImage,+ });+ const { props: fallbackDarkImageProps } = getImageProps({+ ...fallbackImageOptions,+ src: fallbackDarkImage,+ });return (<divaria-hidden="true"- className="pointer-events-none absolute left-1/2 top-1/2 z-0 h-[6.5em] max-w-none -translate-x-1/2 translate-y-[calc(-50%-0.42em)]"- style={{- aspectRatio: `${paddedWidth} / ${paddedHeight}`,- }}+ className="pointer-events-none relative z-0 mb-8 aspect-[var(--eve-logo-mobile-aspect-ratio)] w-full md:absolute md:left-1/2 md:top-1/2 md:mb-0 md:h-[6.5em] md:w-auto md:max-w-none md:-translate-x-1/2 md:translate-y-[calc(-50%-0.42em)] md:aspect-[var(--eve-logo-desktop-aspect-ratio)]"+ style={+ {+ "--eve-logo-mobile-aspect-ratio": FALLBACK_CONTAINER_ASPECT_RATIO,+ "--eve-logo-desktop-aspect-ratio": `${paddedWidth} / ${paddedHeight}`,+ } as CSSProperties+ }>- <canvas ref={canvasRef} className="block size-full" />+ <FallbackImage+ imageProps={fallbackLightImageProps}+ visible={showLightFallback && !revealed}+ className="dark:hidden"+ />+ <FallbackImage+ imageProps={fallbackDarkImageProps}+ visible={!revealed}+ className="hidden dark:block"+ />+ <canvas ref={canvasRef} className="absolute inset-0 size-full opacity-0 transition-opacity duration-700 ease-linear" /><div- className={`pointer-events-none absolute inset-0 bg-gradient-to-b from-transparent ${theme === "light" ? "to-background-200" : "to-black"}`}+ className={`pointer-events-none absolute inset-0 hidden bg-gradient-to-b from-transparent md:block ${theme === "light" ? "to-background-200" : "to-black"}`}+ />+ </div>+ );+}++function FallbackImage({+ imageProps,+ visible,+ className,+}: {+ imageProps: ComponentProps<"img">;+ visible: boolean;+ className: string;+}) {+ return (+ <div+ className={`${className} absolute transition-opacity duration-700 ease-linear ${visible ? "opacity-100" : "opacity-0"}`}+ style={{ inset: FALLBACK_IMAGE_PADDING }}+ >+ <img+ {...imageProps}+ aria-hidden="true"+ role="presentation"+ decoding="async"+ className="absolute left-1/2 top-1/2 h-full w-auto max-w-none -translate-x-1/2 -translate-y-1/2"+ style={{ aspectRatio: FALLBACK_IMAGE_ASPECT_RATIO }}/></div>);@@ -211,6 +356,30 @@ function safeLerp(from: number, to: number, amount: number) {return from + (to - from) * safeAmount;}+function resetCanvasVisibility(canvas: HTMLCanvasElement | null) {+ if (!canvas) return;+ canvas.style.opacity = "";+}++function onCanvasFullyOpaque(canvas: HTMLCanvasElement, callback: () => void) {+ let done = false;+ let timeout = 0;+ const finish = () => {+ if (done) return;+ done = true;+ canvas.removeEventListener("transitionend", onTransitionEnd);+ window.clearTimeout(timeout);+ if (canvas.isConnected) callback();+ };+ const onTransitionEnd = (event: TransitionEvent) => {+ if (event.propertyName === "opacity") finish();+ };++ canvas.addEventListener("transitionend", onTransitionEnd);+ timeout = window.setTimeout(finish, CANVAS_FADE_FALLBACK_MS);+ return finish;+}+function nextFrame() {return new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.tsindex 677c2fce6..d04bcb886 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render.ts@@ -91,13 +91,15 @@ export function createEve5Renderer(device: Device,format: GPUTextureFormat,mesh: MeshData,- options: { thicknessScale?: number; theme?: "light" | "dark" } = {},+ options: { thicknessScale?: number; theme?: "light" | "dark"; paddingRadius?: number; bloom?: boolean } = {},) {const studioCubemap = createStudioCubemap(device);renderStudioCubemap(device, studioCubemap);const orbitTarget = meshOrbitTarget(mesh);const thicknessScale = options.thicknessScale ?? meshThicknessScale(mesh.bounds);const isLight = options.theme === "light";+ const paddingRadius = options.paddingRadius ?? BLOOM_RADIUS;+ const bloomEnabled = options.bloom ?? true;const glassBackShader = device.createShader(compile(glassBackWgsl));const glassFrontShader = device.createShader(compile(glassFrontWgsl));@@ -261,7 +263,7 @@ export function createEve5Renderer(size: 16,usage: ["uniform", "copy_dst"],});- compositeParamsBuffer.write(new Float32Array([BLOOM_STRENGTH, 0, 0, 0]));+ compositeParamsBuffer.write(new Float32Array([bloomEnabled ? BLOOM_STRENGTH : 0, 0, 0, 0]));const blurSampler = device.gpu.createSampler({label: "eve-5-bloom-sampler",magFilter: "linear",@@ -284,7 +286,7 @@ export function createEve5Renderer(let bloomTargets: BloomTargets | undefined;const writeParams = (target: { buffer: Buffer }, controls: RenderControls, logicalWidth: number, logicalHeight: number, passKind: number) => {- const padded = getPaddedRenderSize(logicalWidth, logicalHeight);+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);const fovRad = degreesToRadians(controls.fov);const verticalScale = padded.height / logicalHeight;const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));@@ -318,7 +320,7 @@ export function createEve5Renderer(};const ensureBloomTargets = (logicalWidth: number, logicalHeight: number) => {- const padded = getPaddedRenderSize(logicalWidth, logicalHeight);+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);if (bloomTargets?.width === padded.width && bloomTargets.height === padded.height) return bloomTargets;bloomTargets?.scene.destroy();bloomTargets?.backMaterial.destroy();@@ -520,13 +522,13 @@ export function createEve5Renderer(pass.end();};- const renderComposite = (view: GPUTextureView, targets: BloomTargets) => {+ const renderComposite = (view: GPUTextureView, targets: BloomTargets, bloomTexture: GPUTexture = targets.vertical) => {const bindGroup = device.gpu.createBindGroup({label: "eve-5-bloom-composite-bind-group",layout: compositePipeline.getBindGroupLayout(0),entries: [{ binding: 0, resource: targets.scene.createView() },- { binding: 1, resource: targets.vertical.createView() },+ { binding: 1, resource: bloomTexture.createView() },{ binding: 2, resource: blurSampler },{ binding: 3, resource: { buffer: compositeParamsBuffer.gpu } },],@@ -581,6 +583,10 @@ export function createEve5Renderer(renderLightComposite(target, targets);return;}+ if (!bloomEnabled) {+ renderComposite(target, targets, targets.scene);+ return;+ }renderBlur(targets.scene, targets.horizontal, [1, 0], true);renderBlur(targets.horizontal, targets.vertical, [0, 1], false);renderComposite(target, targets);@@ -627,10 +633,11 @@ type BloomTargets = {vertical: GPUTexture;};-export function getPaddedRenderSize(width: number, height: number) {+export function getPaddedRenderSize(width: number, height: number, paddingRadius = BLOOM_RADIUS) {+ const padding = Math.max(0, Math.round(paddingRadius)) * 2;return {- width: Math.max(1, Math.round(width)) + BLOOM_RADIUS * 2,- height: Math.max(1, Math.round(height)) + BLOOM_RADIUS * 2,+ width: Math.max(1, Math.round(width)) + padding,+ height: Math.max(1, Math.round(height)) + padding,};}diff --git a/apps/docs/next.config.ts b/apps/docs/next.config.tsindex 6ef14a0ed..c76f94f69 100644--- a/apps/docs/next.config.ts+++ b/apps/docs/next.config.ts@@ -34,6 +34,7 @@ const config: NextConfig = {images: {formats: ["image/avif", "image/webp"],+ qualities: [75, 95],remotePatterns: [{protocol: "https",diff --git a/apps/docs/public/eve-5/fallback-dark-content.webp b/apps/docs/public/eve-5/fallback-dark-content.webpnew file mode 100644index 000000000..d3cd2edd0Binary files /dev/null and b/apps/docs/public/eve-5/fallback-dark-content.webp differdiff --git a/apps/docs/public/eve-5/fallback-dark.webp b/apps/docs/public/eve-5/fallback-dark.webpnew file mode 100644index 000000000..d3cd2edd0Binary files /dev/null and b/apps/docs/public/eve-5/fallback-dark.webp differdiff --git a/apps/docs/public/eve-5/fallback-light-content.webp b/apps/docs/public/eve-5/fallback-light-content.webpnew file mode 100644index 000000000..c9a987a9eBinary files /dev/null and b/apps/docs/public/eve-5/fallback-light-content.webp differdiff --git a/apps/docs/public/eve-5/fallback-light.webp b/apps/docs/public/eve-5/fallback-light.webpnew file mode 100644index 000000000..c9a987a9eBinary files /dev/null and b/apps/docs/public/eve-5/fallback-light.webp differdiff --git a/apps/docs/scripts/render-eve-5.ts b/apps/docs/scripts/render-eve-5.tsindex 5be85a7c4..9d218766b 100644--- a/apps/docs/scripts/render-eve-5.ts+++ b/apps/docs/scripts/render-eve-5.ts@@ -1,3 +1,28 @@+// This script uses @vgpu/adapter-node, which requires native Vulkan support and a+// new-enough GLIBC. Run it inside the software-Vulkan Docker image when baking+// the static Eve logo fallback:+//+// docker run --rm \+// -v /home/user/eve-worktrees/eve-migrate-shader:/work \+// -w /work/apps/docs \+// -e VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/lvp_icd.json \+// -e LIBGL_ALWAYS_SOFTWARE=1 \+// -e EVE_LOGO_RENDER_THEME=dark \+// -e EVE_LOGO_RENDER_WIDTH=1095 \+// -e EVE_LOGO_RENDER_HEIGHT=348 \+// -e EVE_LOGO_RENDER_PADDING=0 \+// -e EVE_LOGO_RENDER_BLOOM=0 \+// browser-webgpu-lab:native-vgpu-node \+// bash -lc 'xvfb-run -a bash -lc "NODE_OPTIONS=--loader=./scripts/wgsl-node-loader.mjs ./node_modules/.bin/tsx scripts/render-eve-5.ts"'+//+// The Docker image provides GLIBC 2.41, lavapipe/llvmpipe, libvulkan, and xvfb.+// Convert the generated tmp/eve-5-renders/<run>/output.png to the desired+// public/eve-5/fallback-<theme>.webp with ImageMagick from the same container.+// Set EVE_LOGO_RENDER_THEME=light|dark and EVE_LOGO_RENDER_WIDTH/HEIGHT when+// baking production fallbacks. Fallback images are content-only: render without+// bloom or padding, then place them inside the padded canvas box in CSS so the+// animated shader appears to "turn on" around the same logo geometry.+import { createHash } from "node:crypto";import { readFile, mkdir, writeFile } from "node:fs/promises";import { resolve } from "node:path";@@ -17,11 +42,16 @@ import {const RUN_ID = new Date().toISOString().replaceAll(":", "-").replace(".", "-");const OUT_DIR = resolve(process.cwd(), "tmp/eve-5-renders", RUN_ID);const FORMAT: GPUTextureFormat = "rgba8unorm";-const LOGICAL_WIDTH = 960;-const LOGICAL_HEIGHT = Math.round(LOGICAL_WIDTH / (78 / 25));-const PADDED_SIZE = getPaddedRenderSize(LOGICAL_WIDTH, LOGICAL_HEIGHT);+const PADDING_RADIUS = readNonNegativeIntegerEnv("EVE_LOGO_RENDER_PADDING", 0);+const BLOOM_ENABLED = readBooleanEnv("EVE_LOGO_RENDER_BLOOM", false);+const OUTPUT_WIDTH = readPositiveIntegerEnv("EVE_LOGO_RENDER_WIDTH", 1095, PADDING_RADIUS * 2);+const OUTPUT_HEIGHT = readPositiveIntegerEnv("EVE_LOGO_RENDER_HEIGHT", 348, PADDING_RADIUS * 2);+const LOGICAL_WIDTH = Math.max(1, OUTPUT_WIDTH - PADDING_RADIUS * 2);+const LOGICAL_HEIGHT = Math.max(1, OUTPUT_HEIGHT - PADDING_RADIUS * 2);+const PADDED_SIZE = getPaddedRenderSize(LOGICAL_WIDTH, LOGICAL_HEIGHT, PADDING_RADIUS);const WIDTH = PADDED_SIZE.width;const HEIGHT = PADDED_SIZE.height;+const THEME = readThemeEnv();const MODEL_PATH = resolve(process.cwd(), "public/eve-5/eve-logo.gltf");const DEFAULT_CONTROLS: RenderControls = {yaw: 0,@@ -43,7 +73,7 @@ async function main() {let renderer: ReturnType<typeof createEve5Renderer> | undefined;try {- renderer = createEve5Renderer(app.device, FORMAT, mesh);+ renderer = createEve5Renderer(app.device, FORMAT, mesh, { theme: THEME, paddingRadius: PADDING_RADIUS, bloom: BLOOM_ENABLED });const output = await renderView(renderer, app.device, DEFAULT_CONTROLS, "output.png");await renderView(renderer, app.device, { ...DEFAULT_CONTROLS, yaw: -0.49, pitch: 0.31 }, "rotated.png");await renderView(renderer, app.device, { ...DEFAULT_CONTROLS, wireframe: true }, "wireframe.png");@@ -51,10 +81,12 @@ async function main() {const log = {runId: RUN_ID,outDir: OUT_DIR,- dimensions: { width: WIDTH, height: HEIGHT, format: FORMAT },+ dimensions: { width: WIDTH, height: HEIGHT, format: FORMAT, theme: THEME },bloom: {- radius: BLOOM_RADIUS,- strength: BLOOM_STRENGTH,+ enabled: BLOOM_ENABLED,+ runtimeRadius: BLOOM_RADIUS,+ radius: PADDING_RADIUS,+ strength: BLOOM_ENABLED ? BLOOM_STRENGTH : 0,threshold: BLOOM_THRESHOLD,logical: { width: LOGICAL_WIDTH, height: LOGICAL_HEIGHT },padded: { width: WIDTH, height: HEIGHT },@@ -118,6 +150,41 @@ async function loadMeshFromDisk(path: string) {});}+function readPositiveIntegerEnv(name: string, fallback: number, minimumExclusive = 0) {+ const value = process.env[name];+ if (!value) return fallback;+ const parsed = Number.parseInt(value, 10);+ if (!Number.isFinite(parsed) || parsed <= minimumExclusive) {+ throw new Error(`${name} must be an integer greater than ${minimumExclusive}.`);+ }+ return parsed;+}++function readNonNegativeIntegerEnv(name: string, fallback: number) {+ const value = process.env[name];+ if (!value) return fallback;+ const parsed = Number.parseInt(value, 10);+ if (!Number.isFinite(parsed) || parsed < 0) {+ throw new Error(`${name} must be a non-negative integer.`);+ }+ return parsed;+}++function readBooleanEnv(name: string, fallback: boolean) {+ const value = process.env[name];+ if (!value) return fallback;+ const normalized = value.toLowerCase();+ if (["1", "true", "yes", "on"].includes(normalized)) return true;+ if (["0", "false", "no", "off"].includes(normalized)) return false;+ throw new Error(`${name} must be a boolean value.`);+}++function readThemeEnv(): "light" | "dark" {+ const value = process.env.EVE_LOGO_RENDER_THEME ?? "dark";+ if (value === "light" || value === "dark") return value;+ throw new Error('EVE_LOGO_RENDER_THEME must be "light" or "dark".');+}+function exactArrayBuffer(buffer: Buffer) {return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);}