The Open Framework for Building Agents
Add interactive paint hover to Eve hero shader (#550)
Matias Gonzalezed59cb42f43d
diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsx b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsxnew file mode 100644index 000000000..b1fc6acd1--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/fallback-image.tsx@@ -0,0 +1,63 @@+import { getImageProps } from "next/image";+import type { ComponentProps } from "react";+import fallbackDarkImage from "../../../../../public/eve-5/fallback-dark-content.webp";+import fallbackLightImage from "../../../../../public/eve-5/fallback-light-content.webp";+import { BLOOM_RADIUS } from "./render";++// Owns static fallback image sizing and rendering for the Eve hero logo.+// INVARIANT: CSS padding mirrors the animated canvas bloom padding.+// Imported only by index.tsx.++export const FALLBACK_IMAGE_WIDTH = 1095;+export const FALLBACK_IMAGE_HEIGHT = 348;+export const FALLBACK_IMAGE_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH} / ${FALLBACK_IMAGE_HEIGHT}`;+export const FALLBACK_CONTAINER_ASPECT_RATIO = `${FALLBACK_IMAGE_WIDTH + BLOOM_RADIUS} / ${FALLBACK_IMAGE_HEIGHT + BLOOM_RADIUS}`;+export const FALLBACK_IMAGE_SIZES = "(min-width: 768px) 1095px, calc(100vw - 16px)";+export const FALLBACK_IMAGE_PADDING = BLOOM_RADIUS / 2;++const fallbackImageOptions = {+ alt: "",+ width: FALLBACK_IMAGE_WIDTH,+ height: FALLBACK_IMAGE_HEIGHT,+ sizes: FALLBACK_IMAGE_SIZES,+ priority: true,+ quality: 95,+} as const;++export function getFallbackImageProps() {+ const { props: fallbackLightImageProps } = getImageProps({+ ...fallbackImageOptions,+ src: fallbackLightImage,+ });+ const { props: fallbackDarkImageProps } = getImageProps({+ ...fallbackImageOptions,+ src: fallbackDarkImage,+ });+ return { fallbackLightImageProps, fallbackDarkImageProps };+}++export 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>+ );+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.tsnew file mode 100644index 000000000..7e65508a3--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/hooks.ts@@ -0,0 +1,53 @@+import { useEffect, useState } from "react";++// Owns browser theme and reduced-motion subscriptions for the Eve hero.+// INVARIANT: resolution order matches the old index.tsx hooks exactly.+// Imported only by index.tsx.++export function getCurrentTheme(): "light" | "dark" {+ if (typeof document === "undefined") return "light";+ const root = document.documentElement;+ if (root.classList.contains("dark") || root.dataset.theme === "dark") return "dark";+ if (root.classList.contains("light") || root.dataset.theme === "light") return "light";+ return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";+}++export function useResolvedTheme() {+ const [theme, setTheme] = useState<"light" | "dark">("light");++ useEffect(() => {+ const syncTheme = () => setTheme(getCurrentTheme());+ const media = window.matchMedia("(prefers-color-scheme: dark)");+ const observer = new MutationObserver(syncTheme);++ syncTheme();+ observer.observe(document.documentElement, {+ attributes: true,+ attributeFilter: ["class", "data-theme"],+ });+ media.addEventListener("change", syncTheme);++ return () => {+ observer.disconnect();+ media.removeEventListener("change", syncTheme);+ };+ }, []);++ return theme;+}++export 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;+}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 242488980..411c8c495 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,12 +1,38 @@"use client";import { App, Device, type VGPUAdapter } from "@vgpu/core";-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, DEFAULT_CAMERA_FOV, cameraRadiusForFov, createEve5Renderer, type RenderControls } from "./render";+import { useEffect, useRef, useState, type CSSProperties } from "react";+import { meshAspect } from "./mesh";+import {+ FallbackImage,+ FALLBACK_CONTAINER_ASPECT_RATIO,+ getFallbackImageProps,+} from "./fallback-image";+import { usePrefersReducedMotion, useResolvedTheme } from "./hooks";+import { DEFAULT_LOGO_ASPECT, getLogicalRenderSize, resizeCanvas } from "./runtime/canvas-sizing";+import { loadMesh } from "./runtime/load-mesh";+import {+ destroyTransitionDebugGui,+ setupTransitionDebugGui,+ type EveTransitionDebugGui,+ type EveTransitionDebugState,+} from "./runtime/debug-gui";+import { createDrawLoop } from "./runtime/frame-loop";+import { createPointerController } from "./runtime/pointer-input";+import type { HeroRuntimeState } from "./runtime/state";+import {+ BLOOM_RADIUS,+ DEFAULT_CAMERA_FOV,+ DEFAULT_PAINT_BRUSH_RADIUS,+ DEFAULT_PAINT_BRUSH_STRENGTH,+ DEFAULT_PAINT_DECAY_PER_FRAME_120,+ DEFAULT_PAINT_DIFFUSION_JITTER,+ DEFAULT_PAINT_DIFFUSION_RATE,+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ cameraRadiusForFov,+ createEve5Renderer,+ type RenderControls,+} from "./render";import type { InstallAudience } from "../install-switcher";class BrowserAdapter implements VGPUAdapter {@@ -17,13 +43,6 @@ 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,pitch: 0,@@ -37,87 +56,9 @@ const DEFAULT_CONTROLS: RenderControls = {wireframe: false,showEnv: false,};-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.3;-const MAX_ENV_PITCH = 0.2;-const ENV_YAW_LERP_SPEED = 3;-const AGENTS_ENV_YAW_OFFSET = -Math.PI * 0.1;export const AGENTS_ENV_YAW_LERP_SPEED = 3;const LOGO_MODE_TRANSITION_DURATION_SECONDS = 0.45;const IMPRINT_GLYPH_SCALE = 1.35;-const ASCII_MOUSE_LERP_SPEED = 6;--const CANVAS_FADE_FALLBACK_MS = 800;-const CANVAS_REVEAL_RENDER_COUNT = 3;--type EveTransitionDebugGui = {- destroy(): void;-};--type EveTransitionDebugState = {- overrideEnabled: boolean;- progress: number;- gridScaleMultiplier: number;- glyphScale: number;- durationSeconds: number;-};--declare global {- interface Window {- __eveLogoTransitionDebugGui?: EveTransitionDebugGui;- }-}--function getCurrentTheme(): "light" | "dark" {- if (typeof document === "undefined") return "light";- const root = document.documentElement;- if (root.classList.contains("dark") || root.dataset.theme === "dark") return "dark";- if (root.classList.contains("light") || root.dataset.theme === "light") return "light";- return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";-}--function useResolvedTheme() {- const [theme, setTheme] = useState<"light" | "dark">("light");-- useEffect(() => {- const syncTheme = () => setTheme(getCurrentTheme());- const media = window.matchMedia("(prefers-color-scheme: dark)");- const observer = new MutationObserver(syncTheme);-- syncTheme();- observer.observe(document.documentElement, {- attributes: true,- attributeFilter: ["class", "data-theme"],- });- media.addEventListener("change", syncTheme);-- return () => {- observer.disconnect();- media.removeEventListener("change", syncTheme);- };- }, []);-- 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({ audience = "humans" }: { audience?: InstallAudience }) {const theme = useResolvedTheme();const prefersReducedMotion = usePrefersReducedMotion();@@ -133,25 +74,36 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudietargetLogoModeProgressRef.current = agentsSelected ? 1 : 0;useEffect(() => {- const agentsSelected = audience === "agents";- targetAgentsEnvYawMixRef.current = agentsSelected ? 1 : 0;- targetLogoModeProgressRef.current = agentsSelected ? 1 : 0;- }, [audience]);-- useEffect(() => {- let cancelled = false;- let animationFrame = 0;- let cleanup: (() => void) | undefined;- let mouseEnvYaw = controlsRef.current.envYaw;- let targetMouseEnvYaw = mouseEnvYaw;- let mouseEnvPitch = controlsRef.current.envPitch;- let targetMouseEnvPitch = mouseEnvPitch;- let asciiMouseX = 0;- let asciiMouseY = 0;- let targetAsciiMouseX = 0;- let targetAsciiMouseY = 0;- let agentsEnvYawMix = targetAgentsEnvYawMixRef.current;- let previousFrameTime = performance.now();+ const state: HeroRuntimeState = {+ cancelled: false,+ animationFrame: 0,+ cleanup: undefined,+ mouseEnvYaw: controlsRef.current.envYaw,+ targetMouseEnvYaw: controlsRef.current.envYaw,+ mouseEnvPitch: controlsRef.current.envPitch,+ targetMouseEnvPitch: controlsRef.current.envPitch,+ asciiMouseX: 0,+ asciiMouseY: 0,+ targetAsciiMouseX: 0,+ targetAsciiMouseY: 0,+ brushCellX: 0,+ brushCellY: 0,+ previousRenderedBrushCellX: 0,+ previousRenderedBrushCellY: 0,+ hasBrushCell: false,+ hasRenderedBrushCell: false,+ brushActive: false,+ paintGridScaleMultiplier: DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ targetBrushActive: false,+ activeMesh: undefined,+ agentsEnvYawMix: targetAgentsEnvYawMixRef.current,+ previousFrameTime: performance.now(),+ autoRotateStartTime: performance.now(),+ lastBrushMoveTime: Number.NEGATIVE_INFINITY,+ lastPointerClientX: undefined,+ lastPointerClientY: undefined,+ isCoarsePointer: window.matchMedia("(pointer: coarse)").matches,+ };const canvas = canvasRef.current;resetCanvasVisibility(canvas);@@ -167,20 +119,7 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie}setShowLightFallback(false);- const updateEnvRotation = (clientX: number, clientY: number) => {- const viewportWidth = Math.max(1, window.innerWidth || 1);- const viewportHeight = Math.max(1, window.innerHeight || 1);- const clampedX = Math.max(0, Math.min(viewportWidth, clientX));- const clampedY = Math.max(0, Math.min(viewportHeight, clientY));- const normalizedX = (clampedX / viewportWidth) * 2 - 1;- const normalizedY = (clampedY / viewportHeight) * 2 - 1;- targetMouseEnvYaw = normalizedX * MAX_ENV_YAW;- targetMouseEnvPitch = normalizedY * MAX_ENV_PITCH;- targetAsciiMouseX = normalizedX;- targetAsciiMouseY = normalizedY;- };- const onPointerMove = (event: PointerEvent) => updateEnvRotation(event.clientX, event.clientY);- window.addEventListener("pointermove", onPointerMove, { passive: true });+ const pointerController = createPointerController({ state, controlsRef, canvasRef });async function start() {const renderTheme = theme;@@ -192,13 +131,14 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie}const mesh = await loadMesh();- if (cancelled) return;+ if (state.cancelled) return;+ state.activeMesh = mesh;setLogoAspect(meshAspect(mesh));await nextFrame();resizeCanvas(canvas);const app = await App.create({ adapter: new BrowserAdapter() });- if (cancelled) {+ if (state.cancelled) {app.device.destroy();return;}@@ -207,149 +147,88 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudieconst alphaMode = renderTheme === "light" ? "premultiplied" : "opaque";context.configure({ device: app.device.gpu, format, alphaMode });const renderer = createEve5Renderer(app.device, format, mesh, { theme: renderTheme });- let modeTransitionProgress = targetLogoModeProgressRef.current;let disposed = false;+ let drawLoopDispose: (() => void) | undefined;let transitionDebugGui: EveTransitionDebugGui | undefined;+ const modeTransitionProgressRef = { current: targetLogoModeProgressRef.current };const transitionDebug: EveTransitionDebugState = {overrideEnabled: false,- progress: modeTransitionProgress,- gridScaleMultiplier: 1.03,+ progress: modeTransitionProgressRef.current,+ gridScaleMultiplier: DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,glyphScale: IMPRINT_GLYPH_SCALE,durationSeconds: LOGO_MODE_TRANSITION_DURATION_SECONDS,+ paintDecayPerFrame120: DEFAULT_PAINT_DECAY_PER_FRAME_120,+ diffusionAmount: DEFAULT_PAINT_DIFFUSION_RATE,+ diffusionJitter: DEFAULT_PAINT_DIFFUSION_JITTER,+ brushRadius: DEFAULT_PAINT_BRUSH_RADIUS,+ brushStrength: DEFAULT_PAINT_BRUSH_STRENGTH,+ visualizePaintBuffer: false,};- previousFrameTime = performance.now();-- const destroyTransitionDebugGui = () => {- if (!transitionDebugGui) return;- if (window.__eveLogoTransitionDebugGui === transitionDebugGui) {- delete window.__eveLogoTransitionDebugGui;- }- transitionDebugGui.destroy();- transitionDebugGui = undefined;- };- const setupTransitionDebugGui = async () => {- if (!new URLSearchParams(window.location.search).has("debug")) return;- const { GUI } = await import("lil-gui");- if (cancelled || disposed) return;- window.__eveLogoTransitionDebugGui?.destroy();- const gui = new GUI({ title: "Eve logo imprint" });- let guiDestroyed = false;- const guiHandle: EveTransitionDebugGui = {- destroy() {- if (guiDestroyed) return;- guiDestroyed = true;- gui.destroy();- },- };- transitionDebugGui = guiHandle;- window.__eveLogoTransitionDebugGui = guiHandle;- gui.add(transitionDebug, "overrideEnabled").name("Override imprint");- gui.add(transitionDebug, "progress", 0, 1, 0.001).name("Imprint progress");- const imprint = gui.addFolder("Imprint");- imprint.add(transitionDebug, "gridScaleMultiplier", 0.5, 2, 0.01).name("Grid scale multiplier");- imprint.add(transitionDebug, "glyphScale", 0.5, 2.5, 0.01).name("Glyph scale");- imprint.open();- gui.add(transitionDebug, "durationSeconds", 0.05, 2, 0.01).name("Transition duration (s)");- };- void setupTransitionDebugGui();+ state.previousFrameTime = performance.now();+ state.autoRotateStartTime = state.previousFrameTime;++ void setupTransitionDebugGui({+ transitionDebug,+ isCancelled: () => state.cancelled,+ isDisposed: () => disposed,+ onReady: (gui) => {+ transitionDebugGui = gui;+ },+ });- let successfulRenderCount = 0;- let finishCanvasFade: (() => void) | undefined;const dispose = () => {if (disposed) return;disposed = true;- cancelAnimationFrame(animationFrame);- finishCanvasFade?.();+ drawLoopDispose?.();resetCanvasVisibility(canvas);- if (!cancelled) setRevealed(false);- destroyTransitionDebugGui();+ if (!state.cancelled) setRevealed(false);+ destroyTransitionDebugGui(transitionDebugGui);+ transitionDebugGui = undefined;renderer.dispose();app.device.destroy();};app.device.gpu.lost.then(() => {- if (cancelled) return;+ if (state.cancelled) return;setRevealed(false);setShowLightFallback(true);- cancelled = true;+ state.cancelled = true;dispose();}).catch(() => {// The landing page must degrade silently when the GPU process is unavailable.});- const draw = (frameTime = performance.now()) => {- if (cancelled || disposed) return;-- const deltaSeconds = Math.max(0, (frameTime - previousFrameTime) / 1000);- previousFrameTime = frameTime;- mouseEnvYaw = safeLerp(mouseEnvYaw, targetMouseEnvYaw, deltaSeconds * ENV_YAW_LERP_SPEED);- mouseEnvPitch = safeLerp(mouseEnvPitch, targetMouseEnvPitch, deltaSeconds * ENV_YAW_LERP_SPEED);- asciiMouseX = safeLerp(asciiMouseX, targetAsciiMouseX, deltaSeconds * ASCII_MOUSE_LERP_SPEED);- asciiMouseY = safeLerp(asciiMouseY, targetAsciiMouseY, deltaSeconds * ASCII_MOUSE_LERP_SPEED);- const targetAgentsEnvYawMix = targetAgentsEnvYawMixRef.current;- agentsEnvYawMix = safeLerp(agentsEnvYawMix, targetAgentsEnvYawMix, deltaSeconds * AGENTS_ENV_YAW_LERP_SPEED);- controlsRef.current.envYaw = mouseEnvYaw + agentsEnvYawMix * AGENTS_ENV_YAW_OFFSET;- controlsRef.current.envPitch = mouseEnvPitch;-- resizeCanvas(canvas);- // The renderer pads the logical scene size by BLOOM_RADIUS on each side before allocating- // its offscreen back/depth targets. The canvas itself is that padded physical render target,- // so subtract the padding here. Passing CSS/logical logo dimensions would make the front- // 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);-- try {- const transitionDurationSeconds = clampRange(transitionDebug.durationSeconds, 0.05, 2);- modeTransitionProgress = stepLogoModeProgress(- modeTransitionProgress,- targetLogoModeProgressRef.current,- deltaSeconds,- transitionDurationSeconds,- );- const animatedMixProgress = easeLogoModeProgress(modeTransitionProgress);- const mixProgress = transitionDebug.overrideEnabled ? clampUnit(transitionDebug.progress) : animatedMixProgress;- const timeSeconds = frameTime / 1000;- renderer.render(context.getCurrentTexture().createView(), controlsRef.current, logicalWidth, logicalHeight, {- progress: mixProgress,- gridScaleMultiplier: clampRange(transitionDebug.gridScaleMultiplier, 0.5, 2),- glyphScale: clampRange(transitionDebug.glyphScale, 0.5, 2.5),- time: timeSeconds,- mouse: [asciiMouseX, asciiMouseY],- });-- canvas.dataset.eveRenderMode = mixProgress >= 0.5 ? "agents" : "humans";- canvas.dataset.eveAsciiProgress = mixProgress.toFixed(3);- canvas.dataset.eveAsciiMode = mixProgress > 0.001 ? "active" : "inactive";- } catch {- cancelled = true;+ const drawLoop = createDrawLoop({+ state,+ canvas,+ context,+ renderer,+ controlsRef,+ transitionDebug,+ modeTransitionProgressRef,+ targetLogoModeProgressRef,+ targetAgentsEnvYawMixRef,+ defaultMaterial: DEFAULT_CONTROLS.material,+ onCanvasRevealed: () => {+ if (!state.cancelled) setRevealed(true);+ },+ onFallback: () => {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();+ },+ onFatalError: dispose,+ });+ drawLoopDispose = drawLoop.dispose;+ drawLoop.draw();return dispose;}start().then((dispose) => {- cleanup = dispose;+ state.cleanup = dispose;}).catch(() => {setShowLightFallback(true);@@ -357,10 +236,10 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie});return () => {- cancelled = true;- cancelAnimationFrame(animationFrame);- window.removeEventListener("pointermove", onPointerMove);- cleanup?.();+ state.cancelled = true;+ cancelAnimationFrame(state.animationFrame);+ pointerController.detach();+ state.cleanup?.();resetCanvasVisibility(canvasRef.current);};}, [theme, prefersReducedMotion]);@@ -368,22 +247,7 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudieconst 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,- });+ const { fallbackLightImageProps, fallbackDarkImageProps } = getFallbackImageProps();return (<div@@ -417,117 +281,11 @@ export function EveLogoShader({ audience = "humans" }: { audience?: InstallAudie);}-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>- );-}--async function loadMesh() {- const response = await fetch(MODEL_URL, { cache: "no-store" });- if (!response.ok) throw new Error(`Failed to load ${MODEL_URL}: ${response.status}`);- return decodeGltfMesh(await response.json(), (uri) => loadGltfBuffer(uri, MODEL_URL));-}--async function loadGltfBuffer(uri: string, modelUrl: string) {- if (uri.startsWith("data:application/octet-stream;base64,")) {- return Uint8Array.from(atob(uri.split(",")[1]!), (char) => char.charCodeAt(0)).buffer;- }- const url = new URL(uri, window.location.origin + modelUrl);- const response = await fetch(url, { cache: "no-store" });- if (!response.ok) throw new Error(`Failed to load glTF buffer ${url.pathname}: ${response.status}`);- return response.arrayBuffer();-}--function getLogicalRenderSize(aspect: number) {- return {- width: Math.max(1, Math.round(LOGO_RENDER_HEIGHT * aspect)),- height: LOGO_RENDER_HEIGHT,- };-}--function resizeCanvas(canvas: HTMLCanvasElement | null) {- if (!canvas) return;- const dpr = Math.min(window.devicePixelRatio || 1, MAX_DEVICE_PIXEL_RATIO);- const rect = canvas.getBoundingClientRect();- const width = Math.max(1, Math.floor(rect.width * dpr));- const height = Math.max(1, Math.floor(rect.height * dpr));- if (canvas.width !== width || canvas.height !== height) {- canvas.width = width;- canvas.height = height;- }-}--function safeLerp(from: number, to: number, amount: number) {- const safeAmount = Math.max(0, Math.min(1, amount));- return from + (to - from) * safeAmount;-}--function clampUnit(value: number) {- return clampRange(value, 0, 1);-}--function clampRange(value: number, min: number, max: number) {- return Math.max(min, Math.min(max, value));-}--function stepLogoModeProgress(current: number, target: number, deltaSeconds: number, durationSeconds: number) {- const safeTarget = target >= 0.5 ? 1 : 0;- const safeDuration = clampRange(durationSeconds, 0.05, 2);- const step = Math.max(0, deltaSeconds) / safeDuration;- if (Math.abs(safeTarget - current) <= step) return safeTarget;- return current + Math.sign(safeTarget - current) * step;-}--function easeLogoModeProgress(progress: number) {- const t = Math.max(0, Math.min(1, progress));- return t * t * (3 - 2 * t);-}-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/mobile-motion.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/mobile-motion.tsnew file mode 100644index 000000000..92d1069b5--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/mobile-motion.ts@@ -0,0 +1,17 @@+export const MOBILE_AUTO_ROTATE_SPEED = 0.15;++export type EvePointerInteractionMode = {+ paintEnabled: boolean;+ autoRotateEnvYaw: boolean;+};++export function evePointerInteractionMode(isCoarsePointer: boolean): EvePointerInteractionMode {+ return {+ paintEnabled: !isCoarsePointer,+ autoRotateEnvYaw: isCoarsePointer,+ };+}++export function mobileAutoEnvYaw(timeSeconds: number) {+ return timeSeconds * MOBILE_AUTO_ROTATE_SPEED;+}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 9f23cd921..aba918e00 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@@ -1,1211 +1,30 @@-import { Device, type Buffer } from "@vgpu/core";-import { createRenderPipeline, RenderPass } from "@vgpu/render";-import { compile } from "@vgpu/wgsl";-import glassBackWgsl from "./shaders/glass/back.wgsl";-import glassFrontWgsl from "./shaders/glass/front.wgsl";-import glassBackDepthWgsl from "./shaders/glass/back-depth.wgsl";-import eveBloomBlurWgsl from "./shaders/bloom/blur.wgsl";-import eveBloomCompositeWgsl from "./shaders/bloom/composite.wgsl";-import eveLightCompositeWgsl from "./shaders/postprocess/light-composite.wgsl";-import eveCubemapWgsl from "./shaders/cubemap/render.wgsl";-import eveEnvBgWgsl from "./shaders/env/background.wgsl";-import renderTargetPreviewWgsl from "./shaders/debug/render-target-preview.wgsl";--export type Bounds = {- min: [number, number, number];- max: [number, number, number];-};--export type MeshData = {- positions: Float32Array;- normals: Float32Array;- indices: Uint32Array;- bounds: Bounds;-};--export type EveMaterial = "glass" | "normal" | "camera reflected normal" | "metallic" | "back-albedo" | "back-depth" | "thickness";--export type ImprintRenderOptions = {- progress?: number;- gridScaleMultiplier?: number;- glyphScale?: number;- time?: number;- mouse?: readonly [number, number];-};--export type RenderControls = {- yaw: number;- pitch: number;- radius: number;- fov: number;- envYaw: number;- envPitch: number;- insideRendering: boolean;- outsideRendering: boolean;- material: EveMaterial;- wireframe: boolean;- showEnv: boolean;-};--type GpuMesh = {- vertexBuffer: Buffer;- indexBuffer: Buffer;- lineIndexBuffer: Buffer;- indexCount: number;- lineIndexCount: number;-};--export type StudioCubemap = {- texture: GPUTexture;- view: GPUTextureView;- sampler: GPUSampler;- faceParams: Buffer;-};--const PARAMS_BYTE_SIZE = 176;-const CUBE_MAX_LIGHTS = 16;-const CUBE_LIGHT_FLOAT_COUNT = 12;-const CUBE_PARAMS_FLOAT_COUNT = 4 + CUBE_MAX_LIGHTS * CUBE_LIGHT_FLOAT_COUNT;-const CUBE_PARAMS_BYTE_SIZE = CUBE_PARAMS_FLOAT_COUNT * Float32Array.BYTES_PER_ELEMENT;-export const CUBE_SIZE = 256;-export const CUBE_FACE_COUNT = 6;-export const CUBE_FORMAT: GPUTextureFormat = "rgba16float";-export const BLOOM_RADIUS = 16;-export const SCENE_FORMAT: GPUTextureFormat = "rgba16float";-export const BLOOM_STRENGTH = 0.85;-export const BLOOM_STRENGTH_OFF = BLOOM_STRENGTH;-export const BLOOM_STRENGTH_ON = BLOOM_STRENGTH_OFF * 0.25;-export const BLOOM_THRESHOLD = 0;-const BACK_DEPTH_FORMAT: GPUTextureFormat = "depth32float";--// The shader renders the back side first, then the front side. Keeping two passes-// preserves the acrylic depth/overlap cues while avoiding a depth buffer.-const PASS_INSIDE = 0;-const PASS_OUTSIDE = 1;-const PASS_WIREFRAME = 2;-const MATERIAL_KIND: Record<EveMaterial, number> = {- glass: 0,- normal: 1,- "camera reflected normal": 2,- metallic: 3,- "back-albedo": 0,- "back-depth": 0,- thickness: 4,-};-const CAMERA_CLIP_PADDING = 0.02;-export const BASELINE_CAMERA_RADIUS = 1.9;-export const BASELINE_CAMERA_FOV = 35;-export const DEFAULT_CAMERA_FOV = BASELINE_CAMERA_FOV / 2;-const EVE_THICKNESS_SCALE_MULTIPLIER = 1.3;-const PREVIEW_BACK_ALBEDO = 0;-const PREVIEW_BACK_DEPTH = 1;-const DEFAULT_IMPRINT_CELL_SIZE = 16;-const DEFAULT_IMPRINT_GLYPH_SCALE = 1.35;--type Mat4 = Float32Array;-type Vec3 = [number, number, number];--type EnvLightConfig = {- name: string;- position: readonly [number, number, number];- color: string;- intensity: number;- radius: number;- softness: number;- luminance: number;-};--// Editable environment-light knobs. Hex colors are sRGB and are converted to-// linear values before the one-time cubemap bake. Light and dark intentionally-// start as duplicated white studio setups so each theme can be tuned independently.-export const EVE_LIGHT_ENV_LIGHTS = [- { name: "top-left high", position: [-1.4, 2, -0.4], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 0.02, luminance: 10 },- { name: "front high", position: [0, 0, 2], color: "#FFFFFF", intensity: 2, radius: 0.8, softness: 0.02, luminance: 1 },- { name: "back high", position: [1, 0, -2], color: "#FFFFFF", intensity: 10, radius: 0.5, softness: 0.1, luminance: 0.2 },- { name: "back-right", position: [0.4, -0.3, -1], color: "#FFFFFF", intensity: 1, radius: 0.1, softness: 1, luminance: 0.5 },- { name: "front-bottom-right", position: [1, -2, -0.5], color: "#FFFFFF", intensity: 1, radius: 0.2, softness: 1, luminance: 5 },- { name: "front-bottom-left", position: [-0.3, -0.2, -0.2], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 4, luminance: 3 },-] as const satisfies readonly EnvLightConfig[];--export const EVE_DARK_ENV_LIGHTS = [- { name: "top-left high", position: [-1.3, 2, -0.3], color: "#FFFFFF", intensity: 2, radius: 0.3, softness: 0.02, luminance: 10 },- { name: "front-left high", position: [-0.4, 1, 1], color: "#FFFFFF", intensity: 1, radius: 0.9, softness: 0.02, luminance: 1 },- { name: "front-right", position: [5, 0, 10], color: "#FFFFFF", intensity: 1.5, radius: 0.5, softness: 0.1, luminance: 0.2 },- { name: "back-right", position: [0.4, -0.3, -1], color: "#FFFFFF", intensity: 5, radius: 0.1, softness: 1, luminance: 0.5 },- { name: "front-bottom-right", position: [1, -2, -0.5], color: "#FFFFFF", intensity: 1, radius: 0.2, softness: 1, luminance: 5 },- { name: "front-bottom-left", position: [-0.3, -0.2, -0.2], color: "#FFFFFF", intensity: 1, radius: 0.3, softness: 4, luminance: 3 },-] as const satisfies readonly EnvLightConfig[];--export function createEve5Renderer(- device: Device,- format: GPUTextureFormat,- mesh: MeshData,- options: { thicknessScale?: number; theme?: "light" | "dark"; paddingRadius?: number; bloom?: boolean } = {},-) {- const studioCubemap = createStudioCubemap(device, "eve-5-studio-hdr-cubemap");- const isLight = options.theme === "light";- const envLights = isLight ? EVE_LIGHT_ENV_LIGHTS : EVE_DARK_ENV_LIGHTS;- renderStudioCubemap(device, studioCubemap, envLights);- const orbitTarget = meshOrbitTarget(mesh);- const thicknessScale = options.thicknessScale ?? meshThicknessScale(mesh.bounds);- const paddingRadius = options.paddingRadius ?? BLOOM_RADIUS;- const bloomEnabled = options.bloom ?? true;-- const glassBackShader = device.createShader(compile(glassBackWgsl));- const glassFrontShader = device.createShader(compile(glassFrontWgsl));- const glassBackDepthShader = device.createShader(compile(glassBackDepthWgsl));- const vertexLayout: GPUVertexBufferLayout = {- arrayStride: 6 * 4,- attributes: [- { shaderLocation: 0, offset: 0, format: "float32x3" },- { shaderLocation: 1, offset: 3 * 4, format: "float32x3" },- ],- };-- const backMaterialPipeline = createRenderPipeline(device, {- label: "eve-5-glass-back-material-pipeline",- shader: glassBackShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: {- entry: "fs_main",- targets: [- {- format: SCENE_FORMAT,- blend: {- color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },- },- },- ],- },- primitive: { topology: "triangle-list" },- depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: true, depthCompare: "less" },- });-- const backDepthPipeline = createRenderPipeline(device, {- label: "eve-5-glass-back-depth-pipeline",- shader: glassBackDepthShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },- primitive: { topology: "triangle-list" },- depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: false, depthCompare: "less-equal" },- });-- const frontMaterialPipeline = createRenderPipeline(device, {- label: "eve-5-glass-front-material-pipeline",- shader: glassFrontShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: {- entry: "fs_main",- targets: [- {- format: SCENE_FORMAT,- blend: {- color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },- },- },- ],- },- primitive: { topology: "triangle-list" },- });-- const frontDisplayPipeline = createRenderPipeline(device, {- label: "eve-5-glass-front-display-pipeline",- shader: glassFrontShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: { entry: "fs_main", targets: [{ format }] },- primitive: { topology: "triangle-list" },- });-- const opaquePipeline = createRenderPipeline(device, {- label: "eve-5-opaque-material-pipeline",- shader: glassFrontShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: {- entry: "fs_main",- targets: [- {- format: SCENE_FORMAT,- blend: {- color: { srcFactor: "one", dstFactor: "zero", operation: "add" },- alpha: { srcFactor: "one", dstFactor: "zero", operation: "add" },- },- },- ],- },- primitive: { topology: "triangle-list" },- });-- const wirePipeline = createRenderPipeline(device, {- label: "eve-5-wireframe-pipeline",- shader: glassFrontShader,- vertex: { entry: "vs_main", buffers: [vertexLayout] },- fragment: {- entry: "fs_main",- targets: [- {- format: SCENE_FORMAT,- blend: {- color: { srcFactor: "src-alpha", dstFactor: "one-minus-src-alpha", operation: "add" },- alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },- },- },- ],- },- primitive: { topology: "line-list" },- });-- const blurPipeline = createRenderPipeline(device, {- label: "eve-5-bloom-blur-pipeline",- shader: device.createShader(compile(eveBloomBlurWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },- primitive: { topology: "triangle-list" },- });-- const compositePipeline = createRenderPipeline(device, {- label: "eve-5-bloom-composite-pipeline",- shader: device.createShader(compile(eveBloomCompositeWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format }] },- primitive: { topology: "triangle-list" },- });-- const lightCompositePipeline = createRenderPipeline(device, {- label: "eve-5-light-composite-pipeline",- shader: device.createShader(compile(eveLightCompositeWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format }] },- primitive: { topology: "triangle-list" },- });-- const envBgPipeline = createRenderPipeline(device, {- label: "eve-5-env-bg-pipeline",- shader: device.createShader(compile(eveEnvBgWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },- primitive: { topology: "triangle-list" },- });-- const previewPipeline = createRenderPipeline(device, {- label: "eve-5-render-target-preview-pipeline",- shader: device.createShader(compile(renderTargetPreviewWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format }] },- primitive: { topology: "triangle-list" },- });-- const gpuMesh = createGpuMesh(device, mesh);- const insideParams = createBackParamsBinding(device, backMaterialPipeline, studioCubemap, "eve-5-inside-params");- const backDepthParams = createUniformParamsBinding(device, backDepthPipeline, "eve-5-back-depth-params");- const envBgParams = createEnvParamsBinding(device, envBgPipeline, studioCubemap, "eve-5-env-bg-params");- const outsideParams = createParamsBinding(device, frontMaterialPipeline, studioCubemap, "eve-5-outside-params");- const opaqueOutsideParams = createParamsBinding(device, opaquePipeline, studioCubemap, "eve-5-opaque-outside-params");- const wireParams = createParamsBinding(device, wirePipeline, studioCubemap, "eve-5-wire-params");- const blurParamsBuffer = device.createBuffer({- label: "eve-5-bloom-blur-params",- size: 16,- usage: ["uniform", "copy_dst"],- });- const compositeParamsBuffer = device.createBuffer({- label: "eve-5-bloom-composite-params",- size: 16,- usage: ["uniform", "copy_dst"],- });- const blurSampler = device.gpu.createSampler({- label: "eve-5-bloom-sampler",- magFilter: "linear",- minFilter: "linear",- addressModeU: "clamp-to-edge",- addressModeV: "clamp-to-edge",- });- const previewSampler = device.gpu.createSampler({- label: "eve-5-render-target-preview-sampler",- magFilter: "linear",- minFilter: "linear",- addressModeU: "clamp-to-edge",- addressModeV: "clamp-to-edge",- });- const previewMode = device.createBuffer({- label: "eve-5-render-target-preview-mode",- size: 16,- usage: ["uniform", "copy_dst"],- });- let bloomTargets: BloomTargets | undefined;-- const writeParams = (- target: { buffer: Buffer },- controls: RenderControls,- logicalWidth: number,- logicalHeight: number,- passKind: number,- projectionPaddingRadius = paddingRadius,- imprint: ImprintRenderOptions = {},- ) => {- const padded = getPaddedRenderSize(logicalWidth, logicalHeight, projectionPaddingRadius);- const fovRad = degreesToRadians(controls.fov);- const verticalScale = padded.height / logicalHeight;- const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));- const aspect = padded.width / padded.height;- const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);- const basis = cameraBasis(eye, orbitTarget);- const clip = cameraClipPlanes(mesh.bounds, eye, basis.forward);- const proj = perspective(fovEff, aspect, clip.near, clip.far);- const view = lookAt(eye, orbitTarget, [0, 1, 0]);- const viewProj = multiply(proj, view);- const data = new Float32Array(44);- data.set(viewProj, 0);- data[16] = eye[0];- data[17] = eye[1];- data[18] = eye[2];- data[19] = passKind;- data[20] = basis.right[0];- data[21] = basis.right[1];- data[22] = basis.right[2];- data[23] = fovEff;- data[24] = basis.up[0];- data[25] = basis.up[1];- data[26] = basis.up[2];- data[27] = aspect;- data[28] = basis.forward[0];- data[29] = basis.forward[1];- data[30] = basis.forward[2];- data[31] = MATERIAL_KIND[controls.material];- data[32] = thicknessScale;- data[33] = controls.envYaw;- data[34] = controls.envPitch;- data[35] = isLight ? 0 : 1;- const distToFrontPlane = Math.max(0.001, -dot(eye, basis.forward));- const pxPerModelUnit = padded.height / (2 * distToFrontPlane * Math.tan(fovEff * 0.5));- const gridScale = (pxPerModelUnit / DEFAULT_IMPRINT_CELL_SIZE) * Math.max(0.001, imprint.gridScaleMultiplier ?? 1);- data[36] = Math.max(0, Math.min(1, imprint.progress ?? 0));- data[37] = gridScale;- data[38] = Math.max(0.1, imprint.glyphScale ?? DEFAULT_IMPRINT_GLYPH_SCALE);- data[39] = imprint.time ?? 0;- data[40] = imprint.mouse?.[0] ?? 0;- data[41] = imprint.mouse?.[1] ?? 0;- data[42] = 0;- data[43] = 0;- target.buffer.write(data);- };-- const ensureBloomTargets = (logicalWidth: number, logicalHeight: number) => {- const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);- if (bloomTargets?.width === padded.width && bloomTargets.height === padded.height) return bloomTargets;- bloomTargets?.scene.destroy();- bloomTargets?.backMaterial.destroy();- bloomTargets?.backDepth.destroy();- bloomTargets?.backSurfaceDepth.destroy();- bloomTargets?.horizontal.destroy();- bloomTargets?.vertical.destroy();- bloomTargets = {- width: padded.width,- height: padded.height,- scene: createBloomTexture(device, "eve-5-scene-linear-hdr", padded.width, padded.height),- backMaterial: createBloomTexture(device, "eve-5-back-material-linear-hdr", padded.width, padded.height),- backDepth: createBloomTexture(device, "eve-5-back-camera-axis-depth", padded.width, padded.height),- backSurfaceDepth: createBackDepthTexture(device, "eve-5-back-surface-depth", padded.width, padded.height),- horizontal: createBloomTexture(device, "eve-5-bloom-horizontal", padded.width, padded.height),- vertical: createBloomTexture(device, "eve-5-bloom-vertical", padded.width, padded.height),- };- return bloomTargets;- };-- const renderBackMaterial = (- target: GPUTextureView,- depth: GPUTextureView,- controls: RenderControls,- logicalWidth: number,- logicalHeight: number,- projectionPaddingRadius = paddingRadius,- ) => {- writeParams(insideParams, controls, logicalWidth, logicalHeight, PASS_INSIDE, projectionPaddingRadius);- const pass = new RenderPass(device, {- label: "eve-5-back-material-pass",- colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- depthStencilAttachment: {- view: depth,- depthClearValue: 1,- depthLoadOp: "clear",- depthStoreOp: "store",- },- });- if (controls.insideRendering) {- pass.setPipeline(backMaterialPipeline);- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");- pass.setBindGroup(0, insideParams.bindGroup);- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);- }- pass.end();- };-- const renderBackDepth = (- target: GPUTextureView,- depth: GPUTextureView,- controls: RenderControls,- logicalWidth: number,- logicalHeight: number,- projectionPaddingRadius = paddingRadius,- ) => {- writeParams(backDepthParams, controls, logicalWidth, logicalHeight, PASS_INSIDE, projectionPaddingRadius);- const pass = new RenderPass(device, {- label: "eve-5-back-depth-pass",- colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- depthStencilAttachment: {- view: depth,- depthLoadOp: "load",- depthStoreOp: "store",- },- });- if (controls.insideRendering) {- pass.setPipeline(backDepthPipeline);- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");- pass.setBindGroup(0, backDepthParams.bindGroup);- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);- }- pass.end();- };-- const renderScene = (- view: GPUTextureView,- backMaterial: GPUTexture,- backDepth: GPUTexture,- controls: RenderControls,- logicalWidth: number,- logicalHeight: number,- projectionPaddingRadius = paddingRadius,- imprint: ImprintRenderOptions = {},- ) => {- writeParams(outsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius, imprint);- writeParams(wireParams, controls, logicalWidth, logicalHeight, PASS_WIREFRAME, projectionPaddingRadius);- writeParams(envBgParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);- writeParams(opaqueOutsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);-- const outsideBindGroup = createParamsBindGroup(- device,- frontMaterialPipeline,- studioCubemap,- outsideParams.buffer,- backMaterial.createView(),- backDepth.createView(),- "eve-5-outside-params-bind-group",- );-- const pass = new RenderPass(device, {- label: "eve-5-scene-hdr-pass",- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, isLight ? 0 : 1] }],- });-- // Optional environment background: draw the studio cubemap behind the logo so the lighting- // is visible. Fullscreen triangle, no vertex buffer, so do it before binding the mesh.- if (controls.showEnv) {- pass.setPipeline(envBgPipeline);- pass.setBindGroup(0, envBgParams.bindGroup);- pass.draw(3);- }-- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);-- const needsBackTargets = controls.material === "glass" || controls.material === "thickness";- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");- if (needsBackTargets) {- // The back/inside material and camera-axis depth have already been rendered into offscreen- // targets. The main scene draws only the front/outside material; glass and thickness debug- // both need the real back targets rather than the opaque/debug fallback bind group.- if (controls.outsideRendering) {- pass.setPipeline(frontMaterialPipeline);- pass.setBindGroup(0, outsideBindGroup);- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);- }- } else if (controls.outsideRendering) {- // Opaque/debug materials are single-surface views. Drawing the inside pass too would- // double-expose through the depthless transparent ordering used by glass.- pass.setPipeline(opaquePipeline);- pass.setBindGroup(0, opaqueOutsideParams.bindGroup);- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);- }-- if (controls.wireframe) {- pass.setPipeline(wirePipeline);- pass.gpu.setIndexBuffer(gpuMesh.lineIndexBuffer.gpu, "uint32");- pass.setBindGroup(0, wireParams.bindGroup);- pass.gpu.drawIndexed(gpuMesh.lineIndexCount, 1, 0, 0, 0);- }-- pass.end();- };-- const renderTargetPreview = (view: GPUTextureView, targets: BloomTargets, controls: RenderControls) => {- const basis = cameraBasis(orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch), orbitTarget);- const depthRange = cameraAxisDepthRange(mesh.bounds, basis.forward);- previewMode.write(- new Float32Array([- controls.material === "back-depth" ? PREVIEW_BACK_DEPTH : PREVIEW_BACK_ALBEDO,- depthRange.min,- depthRange.max,- 0,- ]),- );- const bindGroup = device.gpu.createBindGroup({- label: "eve-5-render-target-preview-bind-group",- layout: previewPipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: targets.backMaterial.createView() },- { binding: 1, resource: targets.backDepth.createView() },- { binding: 2, resource: previewSampler },- { binding: 3, resource: { buffer: previewMode.gpu } },- ],- });- const pass = new RenderPass(device, {- label: "eve-5-render-target-preview-pass",- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- });- pass.setPipeline(previewPipeline);- pass.setBindGroup(0, bindGroup);- pass.draw(3);- pass.end();- };-- const renderThicknessDebug = (- view: GPUTextureView,- backMaterial: GPUTexture,- backDepth: GPUTexture,- controls: RenderControls,- logicalWidth: number,- logicalHeight: number,- projectionPaddingRadius = paddingRadius,- ) => {- writeParams(outsideParams, controls, logicalWidth, logicalHeight, PASS_OUTSIDE, projectionPaddingRadius);- const outsideBindGroup = createParamsBindGroup(- device,- frontDisplayPipeline,- studioCubemap,- outsideParams.buffer,- backMaterial.createView(),- backDepth.createView(),- "eve-5-thickness-debug-params-bind-group",- );-- const pass = new RenderPass(device, {- label: "eve-5-thickness-debug-pass",- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- });- pass.setVertexBuffer(0, gpuMesh.vertexBuffer);- pass.gpu.setIndexBuffer(gpuMesh.indexBuffer.gpu, "uint32");- if (controls.outsideRendering) {- pass.setPipeline(frontDisplayPipeline);- pass.setBindGroup(0, outsideBindGroup);- pass.gpu.drawIndexed(gpuMesh.indexCount, 1, 0, 0, 0);- }- pass.end();- };-- const renderBlur = (source: GPUTexture, target: GPUTexture, direction: [number, number], extract: boolean) => {- blurParamsBuffer.write(new Float32Array([direction[0], direction[1], extract ? 1 : 0, BLOOM_THRESHOLD]));- const bindGroup = device.gpu.createBindGroup({- label: "eve-5-bloom-blur-bind-group",- layout: blurPipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: source.createView() },- { binding: 1, resource: blurSampler },- { binding: 2, resource: { buffer: blurParamsBuffer.gpu } },- ],- });- const pass = new RenderPass(device, {- label: `eve-5-bloom-${direction[0] > 0 ? "horizontal" : "vertical"}-pass`,- colorAttachments: [{ view: target.createView(), loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- });- pass.setPipeline(blurPipeline);- pass.setBindGroup(0, bindGroup);- pass.draw(3);- pass.end();- };-- const renderComposite = (view: GPUTextureView, targets: BloomTargets, bloomTexture: GPUTexture = targets.vertical, strength = BLOOM_STRENGTH_OFF) => {- compositeParamsBuffer.write(new Float32Array([strength, 0, 0, 0]));- 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: bloomTexture.createView() },- { binding: 2, resource: blurSampler },- { binding: 3, resource: { buffer: compositeParamsBuffer.gpu } },- ],- });- const pass = new RenderPass(device, {- label: "eve-5-composite-tonemap-pass",- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],- });- pass.setPipeline(compositePipeline);- pass.setBindGroup(0, bindGroup);- pass.draw(3);- pass.end();- };-- const renderLightComposite = (view: GPUTextureView, targets: BloomTargets) => {- const bindGroup = device.gpu.createBindGroup({- label: "eve-5-light-composite-bind-group",- layout: lightCompositePipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: targets.scene.createView() },- { binding: 1, resource: blurSampler },- ],- });- const pass = new RenderPass(device, {- label: "eve-5-light-composite-premultiplied-pass",- colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 0] }],- });- pass.setPipeline(lightCompositePipeline);- pass.setBindGroup(0, bindGroup);- pass.draw(3);- pass.end();- };-- const renderGlassTarget = (target: GPUTextureView, controls: RenderControls, logicalWidth: number, logicalHeight: number, imprint: ImprintRenderOptions = {}) => {- const safeWidth = Math.max(1, Math.round(logicalWidth));- const safeHeight = Math.max(1, Math.round(logicalHeight));- const targets = ensureBloomTargets(safeWidth, safeHeight);- const backSurfaceDepthView = targets.backSurfaceDepth.createView();- renderBackMaterial(targets.backMaterial.createView(), backSurfaceDepthView, controls, safeWidth, safeHeight);- renderBackDepth(targets.backDepth.createView(), backSurfaceDepthView, controls, safeWidth, safeHeight);- if (controls.material === "back-albedo" || controls.material === "back-depth") {- renderTargetPreview(target, targets, controls);- return;- }- if (controls.material === "thickness") {- renderThicknessDebug(target, targets.backMaterial, targets.backDepth, controls, safeWidth, safeHeight);- return;- }- renderScene(targets.scene.createView(), targets.backMaterial, targets.backDepth, controls, safeWidth, safeHeight, paddingRadius, imprint);- if (isLight) {- renderLightComposite(target, targets);- return;- }- if (!bloomEnabled) {- renderComposite(target, targets, targets.scene, 0);- return;- }- const effectiveBloomStrength = mix(BLOOM_STRENGTH_OFF, BLOOM_STRENGTH_ON, clampUnit(imprint.progress ?? 0));- renderBlur(targets.scene, targets.horizontal, [1, 0], true);- renderBlur(targets.horizontal, targets.vertical, [0, 1], false);- renderComposite(target, targets, targets.vertical, effectiveBloomStrength);- };-- return {- render(target: GPUTextureView, controls: RenderControls, logicalWidth: number, logicalHeight: number, imprint?: ImprintRenderOptions) {- renderGlassTarget(target, controls, logicalWidth, logicalHeight, imprint);- },- dispose() {- gpuMesh.vertexBuffer.destroy();- gpuMesh.indexBuffer.destroy();- gpuMesh.lineIndexBuffer.destroy();- insideParams.buffer.destroy();- backDepthParams.buffer.destroy();- outsideParams.buffer.destroy();- outsideParams.fallbackBackMaterial.destroy();- outsideParams.fallbackBackDepth.destroy();- opaqueOutsideParams.buffer.destroy();- opaqueOutsideParams.fallbackBackMaterial.destroy();- opaqueOutsideParams.fallbackBackDepth.destroy();- wireParams.buffer.destroy();- wireParams.fallbackBackMaterial.destroy();- wireParams.fallbackBackDepth.destroy();- envBgParams.buffer.destroy();- blurParamsBuffer.destroy();- compositeParamsBuffer.destroy();- previewMode.destroy();- bloomTargets?.scene.destroy();- bloomTargets?.backMaterial.destroy();- bloomTargets?.backDepth.destroy();- bloomTargets?.backSurfaceDepth.destroy();- bloomTargets?.horizontal.destroy();- bloomTargets?.vertical.destroy();- studioCubemap.faceParams.destroy();- studioCubemap.texture.destroy();- },- };-}--type BloomTargets = {- width: number;- height: number;- scene: GPUTexture;- backMaterial: GPUTexture;- backDepth: GPUTexture;- backSurfaceDepth: GPUTexture;- horizontal: GPUTexture;- vertical: GPUTexture;-};--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)) + padding,- height: Math.max(1, Math.round(height)) + padding,- };-}--function createBloomTexture(device: Device, label: string, width: number, height: number) {- return device.gpu.createTexture({- label,- size: [width, height],- format: SCENE_FORMAT,- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,- });-}--function createBackDepthTexture(device: Device, label: string, width: number, height: number) {- return device.gpu.createTexture({- label,- size: [width, height],- format: BACK_DEPTH_FORMAT,- usage: GPUTextureUsage.RENDER_ATTACHMENT,- });-}--export function createStudioCubemap(device: Device, label = "eve-5-studio-hdr-cubemap"): StudioCubemap {- const texture = device.gpu.createTexture({- label,- size: { width: CUBE_SIZE, height: CUBE_SIZE, depthOrArrayLayers: CUBE_FACE_COUNT },- dimension: "2d",- format: CUBE_FORMAT,- usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,- });- // Dawn's node adapter runs in compatibility mode and validates cube views as 2D arrays.- // Keep the asset semantically as a cubemap, but bind/sample it as six array layers.- const view = texture.createView({ dimension: "2d-array", baseArrayLayer: 0, arrayLayerCount: CUBE_FACE_COUNT });- const sampler = device.gpu.createSampler({- label: "eve-5-studio-hdr-cubemap-sampler",- magFilter: "linear",- minFilter: "linear",- });- const faceParams = device.createBuffer({- label: "eve-5-studio-cubemap-face-params",- size: CUBE_PARAMS_BYTE_SIZE,- usage: ["uniform", "copy_dst"],- });- return { texture, view, sampler, faceParams };-}--export function renderStudioCubemap(device: Device, cubemap: StudioCubemap, lights: readonly EnvLightConfig[], globalIntensity = 1) {- const pipeline = createRenderPipeline(device, {- label: "eve-5-studio-cubemap-bake-pipeline",- shader: device.createShader(compile(eveCubemapWgsl)),- vertex: { entry: "vs_main" },- fragment: { entry: "fs_main", targets: [{ format: CUBE_FORMAT }] },- primitive: { topology: "triangle-list" },- });-- const bindGroup = device.gpu.createBindGroup({- label: "eve-5-studio-cubemap-bake-bind-group",- layout: pipeline.getBindGroupLayout(0),- entries: [{ binding: 0, resource: { buffer: cubemap.faceParams.gpu } }],- });-- for (let face = 0; face < CUBE_FACE_COUNT; face += 1) {- cubemap.faceParams.write(cubeParamsData(face, lights, globalIntensity));- const pass = new RenderPass(device, {- label: `eve-5-studio-cubemap-face-${face}`,- colorAttachments: [- {- view: cubemap.texture.createView({ dimension: "2d", baseArrayLayer: face, arrayLayerCount: 1 }),- loadOp: "clear",- storeOp: "store",- clearValue: [0, 0, 0, 1],- },- ],- });- pass.setPipeline(pipeline);- pass.setBindGroup(0, bindGroup);- pass.draw(3);- pass.end();- }-}--function cubeParamsData(face: number, lights: readonly EnvLightConfig[], globalIntensity: number) {- if (lights.length > CUBE_MAX_LIGHTS) {- throw new Error(`Studio cubemap supports up to ${CUBE_MAX_LIGHTS} lights, received ${lights.length}`);- }-- const data = new Float32Array(CUBE_PARAMS_FLOAT_COUNT);- data[0] = face;- data[1] = lights.length;-- lights.forEach((light, index) => {- const [r, g, b] = lightColorLinear(light);- const offset = 4 + index * CUBE_LIGHT_FLOAT_COUNT;- data[offset] = light.position[0];- data[offset + 1] = light.position[1];- data[offset + 2] = light.position[2];- data[offset + 3] = light.radius;- data[offset + 4] = r;- data[offset + 5] = g;- data[offset + 6] = b;- data[offset + 7] = light.intensity * globalIntensity;- data[offset + 8] = light.softness;- data[offset + 9] = light.luminance;- });-- return data;-}--function lightColorLinear(light: EnvLightConfig): Vec3 {- return srgbHexToLinear(light.color);-}--function srgbHexToLinear(hex: string): Vec3 {- const normalized = hex.replace(/^#/, "");- if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {- throw new Error(`Expected a 6-digit sRGB hex color, received ${hex}`);- }- return [0, 2, 4].map((offset) => {- const channel = Number.parseInt(normalized.slice(offset, offset + 2), 16) / 255;- return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;- }) as Vec3;-}--function createEnvParamsBinding(device: Device, pipeline: GPURenderPipeline, cubemap: StudioCubemap, label: string) {- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });- const bindGroup = device.gpu.createBindGroup({- label: `${label}-bind-group`,- layout: pipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: { buffer: buffer.gpu } },- { binding: 1, resource: cubemap.view },- { binding: 2, resource: cubemap.sampler },- ],- });- return { buffer, bindGroup };-}--function createBackParamsBinding(device: Device, pipeline: GPURenderPipeline, cubemap: StudioCubemap, label: string) {- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });- const bindGroup = device.gpu.createBindGroup({- label: `${label}-bind-group`,- layout: pipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: { buffer: buffer.gpu } },- { binding: 1, resource: cubemap.view },- { binding: 2, resource: cubemap.sampler },- ],- });- return { buffer, bindGroup };-}--function createUniformParamsBinding(device: Device, pipeline: GPURenderPipeline, label: string) {- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });- const bindGroup = device.gpu.createBindGroup({- label: `${label}-bind-group`,- layout: pipeline.getBindGroupLayout(0),- entries: [{ binding: 0, resource: { buffer: buffer.gpu } }],- });- return { buffer, bindGroup };-}--function createParamsBinding(- device: Device,- pipeline: GPURenderPipeline,- cubemap: StudioCubemap,- label: string,- backMaterialView?: GPUTextureView,- backDepthView?: GPUTextureView,-) {- const buffer = device.createBuffer({ size: PARAMS_BYTE_SIZE, usage: ["uniform", "copy_dst"], label });- const fallbackBackMaterial = device.gpu.createTexture({- label: `${label}-empty-back-material`,- size: [1, 1],- format: SCENE_FORMAT,- usage: GPUTextureUsage.TEXTURE_BINDING,- });- const fallbackBackDepth = device.gpu.createTexture({- label: `${label}-empty-back-depth`,- size: [1, 1],- format: SCENE_FORMAT,- usage: GPUTextureUsage.TEXTURE_BINDING,- });- const bindGroup = createParamsBindGroup(- device,- pipeline,- cubemap,- buffer,- backMaterialView ?? fallbackBackMaterial.createView(),- backDepthView ?? fallbackBackDepth.createView(),- `${label}-bind-group`,- );- return { buffer, bindGroup, fallbackBackMaterial, fallbackBackDepth };-}--function createParamsBindGroup(- device: Device,- pipeline: GPURenderPipeline,- cubemap: StudioCubemap,- buffer: Buffer,- backMaterialView: GPUTextureView,- backDepthView: GPUTextureView,- label: string,-) {- return device.gpu.createBindGroup({- label,- layout: pipeline.getBindGroupLayout(0),- entries: [- { binding: 0, resource: { buffer: buffer.gpu } },- { binding: 1, resource: cubemap.view },- { binding: 2, resource: cubemap.sampler },- { binding: 3, resource: backMaterialView },- { binding: 4, resource: backDepthView },- ],- });-}--function createGpuMesh(device: Device, mesh: MeshData): GpuMesh {- const vertices = normalizeMeshForGpu(mesh);- const lineIndices = triangleIndicesToLineIndices(mesh.indices);-- const vertexBuffer = device.createBuffer({- label: "eve-5-logo-vertices",- size: vertices.byteLength,- usage: ["vertex", "copy_dst"],- });- vertexBuffer.write(vertices);-- const indexBuffer = device.createBuffer({- label: "eve-5-logo-indices",- size: mesh.indices.byteLength,- usage: ["index", "copy_dst"],- });- indexBuffer.write(new Uint32Array(mesh.indices));-- const lineIndexBuffer = device.createBuffer({- label: "eve-5-logo-line-indices",- size: lineIndices.byteLength,- usage: ["index", "copy_dst"],- });- lineIndexBuffer.write(lineIndices);-- return {- vertexBuffer,- indexBuffer,- lineIndexBuffer,- indexCount: mesh.indices.length,- lineIndexCount: lineIndices.length,- };-}--function normalizeMeshForGpu(mesh: MeshData) {- const height = mesh.bounds.max[1] - mesh.bounds.min[1];- const centerX = (mesh.bounds.min[0] + mesh.bounds.max[0]) * 0.5;- const centerY = (mesh.bounds.min[1] + mesh.bounds.max[1]) * 0.5;- const frontZ = mesh.bounds.max[2];- const data = new Float32Array((mesh.positions.length / 3) * 6);-- for (let i = 0, j = 0; i < mesh.positions.length; i += 3, j += 6) {- data[j] = (mesh.positions[i]! - centerX) / height;- data[j + 1] = (mesh.positions[i + 1]! - centerY) / height;- data[j + 2] = (mesh.positions[i + 2]! - frontZ) / height;- data[j + 3] = mesh.normals[i]!;- data[j + 4] = mesh.normals[i + 1]!;- data[j + 5] = mesh.normals[i + 2]!;- }-- return data;-}--function triangleIndicesToLineIndices(indices: Uint32Array) {- const lines = new Uint32Array(indices.length * 2);- for (let i = 0, j = 0; i < indices.length; i += 3, j += 6) {- const a = indices[i]!;- const b = indices[i + 1]!;- const c = indices[i + 2]!;- lines[j] = a;- lines[j + 1] = b;- lines[j + 2] = b;- lines[j + 3] = c;- lines[j + 4] = c;- lines[j + 5] = a;- }- return lines;-}--function meshOrbitTarget(mesh: MeshData): Vec3 {- const height = mesh.bounds.max[1] - mesh.bounds.min[1] || 1;- const depth = mesh.bounds.max[2] - mesh.bounds.min[2];- return [0, 0, -depth / (height * 2)];-}--export function meshThicknessScale(bounds: Bounds) {- // The shader computes camera-axis depth from the normalized GPU mesh coordinates created in- // normalizeMeshForGpu(...), not raw glTF/model units. Keep the real EVE logo normalization in the- // same coordinate space; otherwise the tiny raw Z extent clamps the thickness debug to white.- const height = bounds.max[1] - bounds.min[1] || 1;- const normalizedZExtent = (bounds.max[2] - bounds.min[2]) / height;- return Math.max(normalizedZExtent * EVE_THICKNESS_SCALE_MULTIPLIER, 0.000001);-}--function cameraClipPlanes(bounds: Bounds, eye: Vec3, forward: Vec3) {- const corners: Vec3[] = [- [bounds.min[0], bounds.min[1], bounds.min[2]],- [bounds.min[0], bounds.min[1], bounds.max[2]],- [bounds.min[0], bounds.max[1], bounds.min[2]],- [bounds.min[0], bounds.max[1], bounds.max[2]],- [bounds.max[0], bounds.min[1], bounds.min[2]],- [bounds.max[0], bounds.min[1], bounds.max[2]],- [bounds.max[0], bounds.max[1], bounds.min[2]],- [bounds.max[0], bounds.max[1], bounds.max[2]],- ];- let near = Infinity;- let far = -Infinity;- for (const corner of corners) {- const position = normalizePositionForGpu(corner, bounds);- const depth = dot(sub(position, eye), forward);- near = Math.min(near, depth);- far = Math.max(far, depth);- }- return {- near: Math.max(0.001, near - CAMERA_CLIP_PADDING),- far: Math.max(0.002, far + CAMERA_CLIP_PADDING),- };-}--function cameraAxisDepthRange(bounds: Bounds, forward: Vec3) {- const corners: Vec3[] = [- [bounds.min[0], bounds.min[1], bounds.min[2]],- [bounds.min[0], bounds.min[1], bounds.max[2]],- [bounds.min[0], bounds.max[1], bounds.min[2]],- [bounds.min[0], bounds.max[1], bounds.max[2]],- [bounds.max[0], bounds.min[1], bounds.min[2]],- [bounds.max[0], bounds.min[1], bounds.max[2]],- [bounds.max[0], bounds.max[1], bounds.min[2]],- [bounds.max[0], bounds.max[1], bounds.max[2]],- ];- let minDepth = Infinity;- let maxDepth = -Infinity;- for (const corner of corners) {- const depth = dot(normalizePositionForGpu(corner, bounds), forward);- minDepth = Math.min(minDepth, depth);- maxDepth = Math.max(maxDepth, depth);- }- return { min: minDepth, max: maxDepth };-}--function normalizePositionForGpu(position: Vec3, bounds: Bounds): Vec3 {- const height = bounds.max[1] - bounds.min[1] || 1;- const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;- const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;- const frontZ = bounds.max[2];- return [(position[0] - centerX) / height, (position[1] - centerY) / height, (position[2] - frontZ) / height];-}--function orbitEye(target: Vec3, radius: number, yawRadians: number, pitchRadians: number): Vec3 {- const cp = Math.cos(pitchRadians);- return [- target[0] + radius * cp * Math.sin(yawRadians),- target[1] + radius * Math.sin(pitchRadians),- target[2] + radius * cp * Math.cos(yawRadians),- ];-}--function cameraBasis(eye: Vec3, target: Vec3) {- const forward = normalize(sub(target, eye));- const upRef: Vec3 = Math.abs(dot(forward, [0, 1, 0])) > 0.98 ? [0, 0, 1] : [0, 1, 0];- const right = normalize(cross(forward, upRef));- const up = cross(right, forward);- return { forward, right, up };-}--function perspective(fovYRadians: number, aspect: number, near: number, far: number): Mat4 {- const f = 1 / Math.tan(fovYRadians / 2);- const m = new Float32Array(16);- m[0] = f / aspect;- m[5] = f;- m[10] = far / (near - far);- m[11] = -1;- m[14] = (far * near) / (near - far);- return m;-}--function lookAt(eye: Vec3, target: Vec3, up: Vec3): Mat4 {- const z = normalize(sub(eye, target));- let x = cross(up, z);- if (length(x) < 1e-6) {- x = cross([0, 0, 1], z);- if (length(x) < 1e-6) x = cross([1, 0, 0], z);- }- x = normalize(x);- const y = cross(z, x);-- const m = new Float32Array(16);- m[0] = x[0];- m[1] = y[0];- m[2] = z[0];- m[3] = 0;- m[4] = x[1];- m[5] = y[1];- m[6] = z[1];- m[7] = 0;- m[8] = x[2];- m[9] = y[2];- m[10] = z[2];- m[11] = 0;- m[12] = -dot(x, eye);- m[13] = -dot(y, eye);- m[14] = -dot(z, eye);- m[15] = 1;- return m;-}--function multiply(a: Mat4, b: Mat4): Mat4 {- const out = new Float32Array(16);- for (let col = 0; col < 4; col += 1) {- for (let row = 0; row < 4; row += 1) {- let sum = 0;- for (let k = 0; k < 4; k += 1) {- sum += a[k * 4 + row]! * b[col * 4 + k]!;- }- out[col * 4 + row] = sum;- }- }- return out;-}--function sub(a: Vec3, b: Vec3): Vec3 {- return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];-}--function cross(a: Vec3, b: Vec3): Vec3 {- return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];-}--function dot(a: Vec3, b: Vec3): number {- return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];-}--function clampUnit(value: number) {- return Math.max(0, Math.min(1, value));-}--function mix(from: number, to: number, amount: number) {- return from + (to - from) * amount;-}--function length(a: Vec3): number {- return Math.hypot(a[0], a[1], a[2]);-}--function normalize(a: Vec3): Vec3 {- const l = length(a) || 1;- return [a[0] / l, a[1] / l, a[2] / l];-}--export function cameraRadiusForFov(fovDegrees: number, baselineRadius = BASELINE_CAMERA_RADIUS, baselineFovDegrees = BASELINE_CAMERA_FOV) {- const baselineHalfFov = degreesToRadians(baselineFovDegrees) * 0.5;- const targetHalfFov = degreesToRadians(fovDegrees) * 0.5;- return (baselineRadius * Math.tan(baselineHalfFov)) / Math.tan(targetHalfFov);-}--function degreesToRadians(degrees: number) {- return (degrees * Math.PI) / 180;-}+// Pure facade for the Eve hero renderer.+// INVARIANT: External imports continue to target this file; implementation lives under render/.+// Re-export only stable renderer API names and types.++export { createEve5Renderer } from "./render/renderer";+export { mapClientPointToPaintCell } from "./render/pointer-mapping";+export { getPaddedRenderSize } from "./render/textures";+export { cameraRadiusForFov } from "./render/math";+export { meshThicknessScale } from "./render/camera";+export { createStudioCubemap, renderStudioCubemap } from "./render/cubemap";+export { EVE_DARK_ENV_LIGHTS, EVE_LIGHT_ENV_LIGHTS } from "./render/env-lights";+export {+ BLOOM_RADIUS,+ BLOOM_STRENGTH_OFF,+ BLOOM_STRENGTH_ON,+ BLOOM_THRESHOLD,+ bloomRadiusForDevicePixelRatio,+ DEFAULT_CAMERA_FOV,+ DEFAULT_IMPRINT_CELL_SIZE,+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ DEFAULT_PAINT_BRUSH_RADIUS,+ DEFAULT_PAINT_BRUSH_STRENGTH,+ DEFAULT_PAINT_DECAY_PER_FRAME_120,+ DEFAULT_PAINT_DIFFUSION_JITTER,+ DEFAULT_PAINT_DIFFUSION_RATE,+ DEFAULT_PAINT_DT,+ imprintCellSizeForDevicePixelRatio,+} from "./render/constants";+export type { Bounds, EnvLightConfig, EveMaterial, ImprintRenderOptions, MeshData, PaintPointerMapping, PaintPointerMappingInput, PaintPointerRect, PaintRenderOptions, PaintSeed, PaintStroke, RenderControls, StudioCubemap } from "./render/types";diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.tsnew file mode 100644index 000000000..da4e68ede--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/bindings.ts@@ -0,0 +1,193 @@+// Bind-group creators; front bindings 0-7 remain ABI-stable.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device, type Buffer } from "@vgpu/core";+import { PAINT_FORMAT, PARAMS_BYTE_SIZE, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";+import type { StudioCubemap } from "./types";++export function createEnvParamsBinding(+ device: Device,+ pipeline: GPURenderPipeline,+ cubemap: StudioCubemap,+ label: string,+) {+ const buffer = device.createBuffer({+ size: PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ label,+ });+ const bindGroup = device.gpu.createBindGroup({+ label: `${label}-bind-group`,+ layout: pipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: { buffer: buffer.gpu } },+ { binding: 1, resource: cubemap.view },+ { binding: 2, resource: cubemap.sampler },+ ],+ });+ return { buffer, bindGroup };+}++export function createBackParamsBinding(+ device: Device,+ pipeline: GPURenderPipeline,+ cubemap: StudioCubemap,+ label: string,+) {+ const buffer = device.createBuffer({+ size: PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ label,+ });+ const bindGroup = device.gpu.createBindGroup({+ label: `${label}-bind-group`,+ layout: pipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: { buffer: buffer.gpu } },+ { binding: 1, resource: cubemap.view },+ { binding: 2, resource: cubemap.sampler },+ ],+ });+ return { buffer, bindGroup };+}++export function createUniformParamsBinding(device: Device, pipeline: GPURenderPipeline, label: string) {+ const buffer = device.createBuffer({+ size: PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ label,+ });+ const bindGroup = device.gpu.createBindGroup({+ label: `${label}-bind-group`,+ layout: pipeline.getBindGroupLayout(0),+ entries: [{ binding: 0, resource: { buffer: buffer.gpu } }],+ });+ return { buffer, bindGroup };+}++export function createPaintDecayBindGroup(+ device: Device,+ pipeline: GPURenderPipeline,+ paintView: GPUTextureView,+ staticNoiseView: GPUTextureView,+ paintParamsBuffer: Buffer,+ label: string,+) {+ return device.gpu.createBindGroup({+ label,+ layout: pipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: paintView },+ { binding: 1, resource: { buffer: paintParamsBuffer.gpu } },+ { binding: 2, resource: staticNoiseView },+ ],+ });+}++export function createPaintDebugBindGroup(+ device: Device,+ pipeline: GPURenderPipeline,+ paintView: GPUTextureView,+ label: string,+) {+ return device.gpu.createBindGroup({+ label,+ layout: pipeline.getBindGroupLayout(0),+ entries: [{ binding: 0, resource: paintView }],+ });+}++export function createParamsBinding(+ device: Device,+ pipeline: GPURenderPipeline,+ cubemap: StudioCubemap,+ label: string,+ backMaterialView?: GPUTextureView,+ backDepthView?: GPUTextureView,+) {+ const buffer = device.createBuffer({+ size: PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ label,+ });+ const fallbackBackMaterial = device.gpu.createTexture({+ label: `${label}-empty-back-material`,+ size: [1, 1],+ format: SCENE_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING,+ });+ const fallbackBackDepth = device.gpu.createTexture({+ label: `${label}-empty-back-depth`,+ size: [1, 1],+ format: SCENE_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING,+ });+ const fallbackPaint = device.gpu.createTexture({+ label: `${label}-empty-paint`,+ size: [1, 1],+ format: PAINT_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING,+ });+ const fallbackVoronoiValue = device.gpu.createTexture({+ label: `${label}-empty-voronoi-value`,+ size: [1, 1],+ format: VORONOI_NOISE_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING,+ });+ const fallbackVoronoiEdge = device.gpu.createTexture({+ label: `${label}-empty-voronoi-edge`,+ size: [1, 1],+ format: VORONOI_NOISE_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING,+ });+ const bindGroup = createParamsBindGroup(+ device,+ pipeline,+ cubemap,+ buffer,+ backMaterialView ?? fallbackBackMaterial.createView(),+ backDepthView ?? fallbackBackDepth.createView(),+ fallbackPaint.createView(),+ fallbackVoronoiValue.createView(),+ fallbackVoronoiEdge.createView(),+ `${label}-bind-group`,+ );+ return {+ buffer,+ bindGroup,+ fallbackBackMaterial,+ fallbackBackDepth,+ fallbackPaint,+ fallbackVoronoiValue,+ fallbackVoronoiEdge,+ };+}++export function createParamsBindGroup(+ device: Device,+ pipeline: GPURenderPipeline,+ cubemap: StudioCubemap,+ buffer: Buffer,+ backMaterialView: GPUTextureView,+ backDepthView: GPUTextureView,+ paintView: GPUTextureView,+ voronoiValueView: GPUTextureView,+ voronoiEdgeView: GPUTextureView,+ label: string,+) {+ return device.gpu.createBindGroup({+ label,+ layout: pipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: { buffer: buffer.gpu } },+ { binding: 1, resource: cubemap.view },+ { binding: 2, resource: cubemap.sampler },+ { binding: 3, resource: backMaterialView },+ { binding: 4, resource: backDepthView },+ { binding: 5, resource: paintView },+ { binding: 6, resource: voronoiValueView },+ { binding: 7, resource: voronoiEdgeView },+ ],+ });+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.tsnew file mode 100644index 000000000..d3ff405c0--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/camera.ts@@ -0,0 +1,84 @@+// Camera framing, clip planes, and mesh-normalized coordinate helpers.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { Bounds, MeshData, Vec3 } from "./types";+import { CAMERA_CLIP_PADDING, EVE_THICKNESS_SCALE_MULTIPLIER } from "./constants";+import { dot, sub } from "./math";++export function meshOrbitTarget(mesh: MeshData): Vec3 {+ return meshOrbitTargetFromBounds(mesh.bounds);+}++export function meshOrbitTargetFromBounds(bounds: Bounds): Vec3 {+ const height = bounds.max[1] - bounds.min[1] || 1;+ const depth = bounds.max[2] - bounds.min[2];+ return [0, 0, -depth / (height * 2)];+}++export function meshThicknessScale(bounds: Bounds) {+ // The shader computes camera-axis depth from the normalized GPU mesh coordinates created in+ // normalizeMeshForGpu(...), not raw glTF/model units. Keep the real EVE logo normalization in the+ // same coordinate space; otherwise the tiny raw Z extent clamps the thickness debug to white.+ const height = bounds.max[1] - bounds.min[1] || 1;+ const normalizedZExtent = (bounds.max[2] - bounds.min[2]) / height;+ return Math.max(normalizedZExtent * EVE_THICKNESS_SCALE_MULTIPLIER, 0.000001);+}++export function cameraClipPlanes(bounds: Bounds, eye: Vec3, forward: Vec3) {+ const corners: Vec3[] = [+ [bounds.min[0], bounds.min[1], bounds.min[2]],+ [bounds.min[0], bounds.min[1], bounds.max[2]],+ [bounds.min[0], bounds.max[1], bounds.min[2]],+ [bounds.min[0], bounds.max[1], bounds.max[2]],+ [bounds.max[0], bounds.min[1], bounds.min[2]],+ [bounds.max[0], bounds.min[1], bounds.max[2]],+ [bounds.max[0], bounds.max[1], bounds.min[2]],+ [bounds.max[0], bounds.max[1], bounds.max[2]],+ ];+ let near = Infinity;+ let far = -Infinity;+ for (const corner of corners) {+ const position = normalizePositionForGpu(corner, bounds);+ const depth = dot(sub(position, eye), forward);+ near = Math.min(near, depth);+ far = Math.max(far, depth);+ }+ return {+ near: Math.max(0.001, near - CAMERA_CLIP_PADDING),+ far: Math.max(0.002, far + CAMERA_CLIP_PADDING),+ };+}++export function cameraAxisDepthRange(bounds: Bounds, forward: Vec3) {+ const corners: Vec3[] = [+ [bounds.min[0], bounds.min[1], bounds.min[2]],+ [bounds.min[0], bounds.min[1], bounds.max[2]],+ [bounds.min[0], bounds.max[1], bounds.min[2]],+ [bounds.min[0], bounds.max[1], bounds.max[2]],+ [bounds.max[0], bounds.min[1], bounds.min[2]],+ [bounds.max[0], bounds.min[1], bounds.max[2]],+ [bounds.max[0], bounds.max[1], bounds.min[2]],+ [bounds.max[0], bounds.max[1], bounds.max[2]],+ ];+ let minDepth = Infinity;+ let maxDepth = -Infinity;+ for (const corner of corners) {+ const depth = dot(normalizePositionForGpu(corner, bounds), forward);+ minDepth = Math.min(minDepth, depth);+ maxDepth = Math.max(maxDepth, depth);+ }+ return { min: minDepth, max: maxDepth };+}++export function normalizePositionForGpu(position: Vec3, bounds: Bounds): Vec3 {+ const height = bounds.max[1] - bounds.min[1] || 1;+ const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;+ const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;+ const frontZ = bounds.max[2];+ return [+ (position[0] - centerX) / height,+ (position[1] - centerY) / height,+ (position[2] - frontZ) / height,+ ];+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.tsnew file mode 100644index 000000000..027305d7c--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/constants.ts@@ -0,0 +1,90 @@+// Renderer numeric constants, GPU formats, and public defaults.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { EveMaterial } from "./types";++export const PARAMS_BYTE_SIZE = 176;+export const CUBE_MAX_LIGHTS = 16;+export const CUBE_LIGHT_FLOAT_COUNT = 12;+export const CUBE_PARAMS_FLOAT_COUNT = 4 + CUBE_MAX_LIGHTS * CUBE_LIGHT_FLOAT_COUNT;+export const CUBE_PARAMS_BYTE_SIZE = CUBE_PARAMS_FLOAT_COUNT * Float32Array.BYTES_PER_ELEMENT;+export const CUBE_SIZE = 256;+export const CUBE_FACE_COUNT = 6;+export const CUBE_FORMAT: GPUTextureFormat = "rgba16float";+export const BLOOM_RADIUS = 16;+export const SCENE_FORMAT: GPUTextureFormat = "rgba16float";+export const BLOOM_STRENGTH = 0.85;+export const BLOOM_STRENGTH_OFF = BLOOM_STRENGTH;+export const BLOOM_STRENGTH_ON = BLOOM_STRENGTH_OFF * 0.25;+export const BLOOM_THRESHOLD = 0;+export const BACK_DEPTH_FORMAT: GPUTextureFormat = "depth32float";++// The shader renders the back side first, then the front side. Keeping two passes+// preserves the acrylic depth/overlap cues while avoiding a depth buffer.+export const PASS_INSIDE = 0;+export const PASS_OUTSIDE = 1;+export const PASS_WIREFRAME = 2;+export const MATERIAL_KIND: Record<EveMaterial, number> = {+ glass: 0,+ normal: 1,+ "camera reflected normal": 2,+ metallic: 3,+ "back-albedo": 0,+ "back-depth": 0,+ thickness: 4,+ "paint-debug": 0,+};+export const CAMERA_CLIP_PADDING = 0.02;+export const BASELINE_CAMERA_RADIUS = 1.9;+export const BASELINE_CAMERA_FOV = 35;+export const DEFAULT_CAMERA_FOV = BASELINE_CAMERA_FOV / 2;+export const EVE_THICKNESS_SCALE_MULTIPLIER = 1.3;+export const PREVIEW_BACK_ALBEDO = 0;+export const PREVIEW_BACK_DEPTH = 1;+export const DEFAULT_IMPRINT_CELL_SIZE = 16;+export const DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO = 2;+export const DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER = 0.71;+export const DEFAULT_IMPRINT_GLYPH_SCALE = 1.35;+export const PAINT_FORMAT: GPUTextureFormat = "r32float";+export const PAINT_STATIC_NOISE_FORMAT: GPUTextureFormat = "rgba32float";+export const VORONOI_NOISE_FORMAT: GPUTextureFormat = "r32float";+export const PAINT_PARAMS_BYTE_SIZE = 48;+export const VORONOI_NOISE_PARAMS_BYTE_SIZE = 16;+export const DEFAULT_PAINT_DECAY_PER_FRAME_120 = 0.032;+export const DEFAULT_PAINT_DECAY_RATE = DEFAULT_PAINT_DECAY_PER_FRAME_120 * 120;+export const DEFAULT_PAINT_DIFFUSION_RATE = 1.6;+export const DEFAULT_PAINT_DIFFUSION_JITTER = 4.0;+export const DEFAULT_PAINT_BRUSH_RADIUS = 8.0;+export const DEFAULT_PAINT_BRUSH_STRENGTH = 32.0;+export const DEFAULT_PAINT_DT = 1 / 60;+export const PAINT_STROKE_MOVEMENT_EPSILON_CELLS = 0.05;++function safeDevicePixelRatioOrDefault(devicePixelRatio: number | undefined) {+ const ratio = typeof devicePixelRatio === "number" && Number.isFinite(devicePixelRatio)+ ? devicePixelRatio+ : DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;++ return Math.max(0.001, ratio);+}++export function imprintCellSizeForDevicePixelRatio(+ devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,+) {+ return (+ DEFAULT_IMPRINT_CELL_SIZE *+ (safeDevicePixelRatioOrDefault(devicePixelRatio) / DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO)+ );+}++export function bloomRadiusForDevicePixelRatio(+ devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,+) {+ return Math.max(+ 0,+ Math.round(+ BLOOM_RADIUS *+ (safeDevicePixelRatioOrDefault(devicePixelRatio) / DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO),+ ),+ );+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.tsnew file mode 100644index 000000000..09d10cbbb--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/cubemap.ts@@ -0,0 +1,129 @@+// Studio cubemap allocation and one-time bake pass.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device } from "@vgpu/core";+import { createRenderPipeline, RenderPass } from "@vgpu/render";+import { compile } from "@vgpu/wgsl";+import eveCubemapWgsl from "../shaders/cubemap/render.wgsl";+import { CUBE_FACE_COUNT, CUBE_FORMAT, CUBE_LIGHT_FLOAT_COUNT, CUBE_MAX_LIGHTS, CUBE_PARAMS_BYTE_SIZE, CUBE_PARAMS_FLOAT_COUNT, CUBE_SIZE } from "./constants";+import type { EnvLightConfig, StudioCubemap, Vec3 } from "./types";++export function createStudioCubemap(+ device: Device,+ label = "eve-5-studio-hdr-cubemap",+): StudioCubemap {+ const texture = device.gpu.createTexture({+ label,+ size: { width: CUBE_SIZE, height: CUBE_SIZE, depthOrArrayLayers: CUBE_FACE_COUNT },+ dimension: "2d",+ format: CUBE_FORMAT,+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,+ });+ // Dawn's node adapter runs in compatibility mode and validates cube views as 2D arrays.+ // Keep the asset semantically as a cubemap, but bind/sample it as six array layers.+ const view = texture.createView({+ dimension: "2d-array",+ baseArrayLayer: 0,+ arrayLayerCount: CUBE_FACE_COUNT,+ });+ const sampler = device.gpu.createSampler({+ label: "eve-5-studio-hdr-cubemap-sampler",+ magFilter: "linear",+ minFilter: "linear",+ });+ const faceParams = device.createBuffer({+ label: "eve-5-studio-cubemap-face-params",+ size: CUBE_PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ });+ return { texture, view, sampler, faceParams };+}++export function renderStudioCubemap(+ device: Device,+ cubemap: StudioCubemap,+ lights: readonly EnvLightConfig[],+ globalIntensity = 1,+) {+ const pipeline = createRenderPipeline(device, {+ label: "eve-5-studio-cubemap-bake-pipeline",+ shader: device.createShader(compile(eveCubemapWgsl)),+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format: CUBE_FORMAT }] },+ primitive: { topology: "triangle-list" },+ });++ const bindGroup = device.gpu.createBindGroup({+ label: "eve-5-studio-cubemap-bake-bind-group",+ layout: pipeline.getBindGroupLayout(0),+ entries: [{ binding: 0, resource: { buffer: cubemap.faceParams.gpu } }],+ });++ for (let face = 0; face < CUBE_FACE_COUNT; face += 1) {+ cubemap.faceParams.write(cubeParamsData(face, lights, globalIntensity));+ const pass = new RenderPass(device, {+ label: `eve-5-studio-cubemap-face-${face}`,+ colorAttachments: [+ {+ view: cubemap.texture.createView({+ dimension: "2d",+ baseArrayLayer: face,+ arrayLayerCount: 1,+ }),+ loadOp: "clear",+ storeOp: "store",+ clearValue: [0, 0, 0, 1],+ },+ ],+ });+ pass.setPipeline(pipeline);+ pass.setBindGroup(0, bindGroup);+ pass.draw(3);+ pass.end();+ }+}++export function cubeParamsData(face: number, lights: readonly EnvLightConfig[], globalIntensity: number) {+ if (lights.length > CUBE_MAX_LIGHTS) {+ throw new Error(+ `Studio cubemap supports up to ${CUBE_MAX_LIGHTS} lights, received ${lights.length}`,+ );+ }++ const data = new Float32Array(CUBE_PARAMS_FLOAT_COUNT);+ data[0] = face;+ data[1] = lights.length;++ lights.forEach((light, index) => {+ const [r, g, b] = lightColorLinear(light);+ const offset = 4 + index * CUBE_LIGHT_FLOAT_COUNT;+ data[offset] = light.position[0];+ data[offset + 1] = light.position[1];+ data[offset + 2] = light.position[2];+ data[offset + 3] = light.radius;+ data[offset + 4] = r;+ data[offset + 5] = g;+ data[offset + 6] = b;+ data[offset + 7] = light.intensity * globalIntensity;+ data[offset + 8] = light.softness;+ data[offset + 9] = light.luminance;+ });++ return data;+}++export function lightColorLinear(light: EnvLightConfig): Vec3 {+ return srgbHexToLinear(light.color);+}++export function srgbHexToLinear(hex: string): Vec3 {+ const normalized = hex.replace(/^#/, "");+ if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {+ throw new Error(`Expected a 6-digit sRGB hex color, received ${hex}`);+ }+ return [0, 2, 4].map((offset) => {+ const channel = Number.parseInt(normalized.slice(offset, offset + 2), 16) / 255;+ return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;+ }) as Vec3;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.tsnew file mode 100644index 000000000..52652539e--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/env-lights.ts@@ -0,0 +1,122 @@+// Theme-specific studio light data.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { EnvLightConfig } from "./types";++// Editable environment-light knobs. Hex colors are sRGB and are converted to+// linear values before the one-time cubemap bake. Light and dark intentionally+// start as duplicated white studio setups so each theme can be tuned independently.+export const EVE_LIGHT_ENV_LIGHTS = [+ {+ name: "top-left high",+ position: [-1.4, 2, -0.4],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.3,+ softness: 0.02,+ luminance: 10,+ },+ {+ name: "front high",+ position: [0, 0, 2],+ color: "#FFFFFF",+ intensity: 2,+ radius: 0.8,+ softness: 0.02,+ luminance: 1,+ },+ {+ name: "back high",+ position: [1, 0, -2],+ color: "#FFFFFF",+ intensity: 10,+ radius: 0.5,+ softness: 0.1,+ luminance: 0.2,+ },+ {+ name: "back-right",+ position: [0.4, -0.3, -1],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.1,+ softness: 1,+ luminance: 0.5,+ },+ {+ name: "front-bottom-right",+ position: [1, -2, -0.5],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.2,+ softness: 1,+ luminance: 5,+ },+ {+ name: "front-bottom-left",+ position: [-0.3, -0.2, -0.2],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.3,+ softness: 4,+ luminance: 3,+ },+] as const satisfies readonly EnvLightConfig[];++export const EVE_DARK_ENV_LIGHTS = [+ {+ name: "top-left high",+ position: [-1.3, 2, -0.3],+ color: "#FFFFFF",+ intensity: 2,+ radius: 0.3,+ softness: 0.02,+ luminance: 10,+ },+ {+ name: "front-left high",+ position: [-0.4, 1, 1],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.9,+ softness: 0.02,+ luminance: 1,+ },+ {+ name: "front-right",+ position: [5, 0, 10],+ color: "#FFFFFF",+ intensity: 1.5,+ radius: 0.5,+ softness: 0.1,+ luminance: 0.2,+ },+ {+ name: "back-right",+ position: [0.4, -0.3, -1],+ color: "#FFFFFF",+ intensity: 5,+ radius: 0.1,+ softness: 1,+ luminance: 0.5,+ },+ {+ name: "front-bottom-right",+ position: [1, -2, -0.5],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.2,+ softness: 1,+ luminance: 5,+ },+ {+ name: "front-bottom-left",+ position: [-0.3, -0.2, -0.2],+ color: "#FFFFFF",+ intensity: 1,+ radius: 0.3,+ softness: 4,+ luminance: 3,+ },+] as const satisfies readonly EnvLightConfig[];\ No newline at end of filediff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.tsnew file mode 100644index 000000000..9ac6f186e--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/math.ts@@ -0,0 +1,121 @@+// Small matrix/vector math helpers used by camera and params.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { Mat4, Vec3 } from "./types";+import { BASELINE_CAMERA_FOV, BASELINE_CAMERA_RADIUS } from "./constants";++export function orbitEye(target: Vec3, radius: number, yawRadians: number, pitchRadians: number): Vec3 {+ const cp = Math.cos(pitchRadians);+ return [+ target[0] + radius * cp * Math.sin(yawRadians),+ target[1] + radius * Math.sin(pitchRadians),+ target[2] + radius * cp * Math.cos(yawRadians),+ ];+}++export function cameraBasis(eye: Vec3, target: Vec3) {+ const forward = normalize(sub(target, eye));+ const upRef: Vec3 = Math.abs(dot(forward, [0, 1, 0])) > 0.98 ? [0, 0, 1] : [0, 1, 0];+ const right = normalize(cross(forward, upRef));+ const up = cross(right, forward);+ return { forward, right, up };+}++export function perspective(fovYRadians: number, aspect: number, near: number, far: number): Mat4 {+ const f = 1 / Math.tan(fovYRadians / 2);+ const m = new Float32Array(16);+ m[0] = f / aspect;+ m[5] = f;+ m[10] = far / (near - far);+ m[11] = -1;+ m[14] = (far * near) / (near - far);+ return m;+}++export function lookAt(eye: Vec3, target: Vec3, up: Vec3): Mat4 {+ const z = normalize(sub(eye, target));+ let x = cross(up, z);+ if (length(x) < 1e-6) {+ x = cross([0, 0, 1], z);+ if (length(x) < 1e-6) x = cross([1, 0, 0], z);+ }+ x = normalize(x);+ const y = cross(z, x);++ const m = new Float32Array(16);+ m[0] = x[0];+ m[1] = y[0];+ m[2] = z[0];+ m[3] = 0;+ m[4] = x[1];+ m[5] = y[1];+ m[6] = z[1];+ m[7] = 0;+ m[8] = x[2];+ m[9] = y[2];+ m[10] = z[2];+ m[11] = 0;+ m[12] = -dot(x, eye);+ m[13] = -dot(y, eye);+ m[14] = -dot(z, eye);+ m[15] = 1;+ return m;+}++export function multiply(a: Mat4, b: Mat4): Mat4 {+ const out = new Float32Array(16);+ for (let col = 0; col < 4; col += 1) {+ for (let row = 0; row < 4; row += 1) {+ let sum = 0;+ for (let k = 0; k < 4; k += 1) {+ sum += a[k * 4 + row]! * b[col * 4 + k]!;+ }+ out[col * 4 + row] = sum;+ }+ }+ return out;+}++export function sub(a: Vec3, b: Vec3): Vec3 {+ return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];+}++export function cross(a: Vec3, b: Vec3): Vec3 {+ return [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];+}++export function dot(a: Vec3, b: Vec3): number {+ return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];+}++export function clampUnit(value: number) {+ return Math.max(0, Math.min(1, value));+}++export function mix(from: number, to: number, amount: number) {+ return from + (to - from) * amount;+}++export function length(a: Vec3): number {+ return Math.hypot(a[0], a[1], a[2]);+}++export function normalize(a: Vec3): Vec3 {+ const l = length(a) || 1;+ return [a[0] / l, a[1] / l, a[2] / l];+}++export function cameraRadiusForFov(+ fovDegrees: number,+ baselineRadius = BASELINE_CAMERA_RADIUS,+ baselineFovDegrees = BASELINE_CAMERA_FOV,+) {+ const baselineHalfFov = degreesToRadians(baselineFovDegrees) * 0.5;+ const targetHalfFov = degreesToRadians(fovDegrees) * 0.5;+ return (baselineRadius * Math.tan(baselineHalfFov)) / Math.tan(targetHalfFov);+}++export function degreesToRadians(degrees: number) {+ return (degrees * Math.PI) / 180;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.tsnew file mode 100644index 000000000..326d98604--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/mesh-gpu.ts@@ -0,0 +1,94 @@+// GPU mesh upload plus normalization and line-index generation.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device } from "@vgpu/core";+import type { Bounds, GpuMesh, MeshData } from "./types";++export function createGpuMesh(device: Device, mesh: MeshData): GpuMesh {+ const vertices = normalizeMeshForGpu(mesh);+ const lineIndices = triangleIndicesToLineIndices(mesh.indices);++ const vertexBuffer = device.createBuffer({+ label: "eve-5-logo-vertices",+ size: vertices.byteLength,+ usage: ["vertex", "copy_dst"],+ });+ vertexBuffer.write(vertices);++ const indexBuffer = device.createBuffer({+ label: "eve-5-logo-indices",+ size: mesh.indices.byteLength,+ usage: ["index", "copy_dst"],+ });+ indexBuffer.write(new Uint32Array(mesh.indices));++ const lineIndexBuffer = device.createBuffer({+ label: "eve-5-logo-line-indices",+ size: lineIndices.byteLength,+ usage: ["index", "copy_dst"],+ });+ lineIndexBuffer.write(lineIndices);++ return {+ vertexBuffer,+ indexBuffer,+ lineIndexBuffer,+ indexCount: mesh.indices.length,+ lineIndexCount: lineIndices.length,+ };+}++export function normalizedMeshBounds(bounds: Bounds): Bounds {+ const height = bounds.max[1] - bounds.min[1] || 1;+ const centerX = (bounds.min[0] + bounds.max[0]) * 0.5;+ const centerY = (bounds.min[1] + bounds.max[1]) * 0.5;+ const frontZ = bounds.max[2];+ return {+ min: [+ (bounds.min[0] - centerX) / height,+ (bounds.min[1] - centerY) / height,+ (bounds.min[2] - frontZ) / height,+ ],+ max: [+ (bounds.max[0] - centerX) / height,+ (bounds.max[1] - centerY) / height,+ (bounds.max[2] - frontZ) / height,+ ],+ };+}++function normalizeMeshForGpu(mesh: MeshData) {+ const height = mesh.bounds.max[1] - mesh.bounds.min[1];+ const centerX = (mesh.bounds.min[0] + mesh.bounds.max[0]) * 0.5;+ const centerY = (mesh.bounds.min[1] + mesh.bounds.max[1]) * 0.5;+ const frontZ = mesh.bounds.max[2];+ const data = new Float32Array((mesh.positions.length / 3) * 6);++ for (let i = 0, j = 0; i < mesh.positions.length; i += 3, j += 6) {+ data[j] = (mesh.positions[i]! - centerX) / height;+ data[j + 1] = (mesh.positions[i + 1]! - centerY) / height;+ data[j + 2] = (mesh.positions[i + 2]! - frontZ) / height;+ data[j + 3] = mesh.normals[i]!;+ data[j + 4] = mesh.normals[i + 1]!;+ data[j + 5] = mesh.normals[i + 2]!;+ }++ return data;+}++function triangleIndicesToLineIndices(indices: Uint32Array) {+ const lines = new Uint32Array(indices.length * 2);+ for (let i = 0, j = 0; i < indices.length; i += 3, j += 6) {+ const a = indices[i]!;+ const b = indices[i + 1]!;+ const c = indices[i + 2]!;+ lines[j] = a;+ lines[j + 1] = b;+ lines[j + 2] = b;+ lines[j + 3] = c;+ lines[j + 4] = c;+ lines[j + 5] = a;+ }+ return lines;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.tsnew file mode 100644index 000000000..5f54fb7b1--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/paint-system.ts@@ -0,0 +1,287 @@+// Owns paint target state as one unit, including ping-pong parity and decay/noise/debug passes.+// INVARIANT: readIsPing flips only after encoding a decay pass; front rendering samples current read texture.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import { createPaintDebugBindGroup, createPaintDecayBindGroup } from "./bindings";+import {+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ DEFAULT_PAINT_BRUSH_RADIUS,+ DEFAULT_PAINT_BRUSH_STRENGTH,+ DEFAULT_PAINT_DECAY_RATE,+ DEFAULT_PAINT_DIFFUSION_JITTER,+ DEFAULT_PAINT_DIFFUSION_RATE,+ DEFAULT_PAINT_DT,+ PAINT_STROKE_MOVEMENT_EPSILON_CELLS,+ imprintCellSizeForDevicePixelRatio,+} from "./constants";+import { mix } from "./math";+import { paintMappingMetrics } from "./pointer-mapping";+import type { RendererResources } from "./resources";+import {+ createPaintStaticNoiseTexture,+ createPaintTexture,+ createVoronoiNoiseTexture,+ uploadStaticNoiseTexture,+} from "./textures";+import type { ImprintRenderOptions, MeshData, PaintRenderOptions, PaintSeed, PaintTargets, RenderControls } from "./types";++export function createPaintSystem(device: Device, resources: RendererResources, mesh: MeshData) {+ let targets: PaintTargets | undefined;++ const dispose = () => {+ targets?.ping.destroy();+ targets?.pong.destroy();+ targets?.staticNoise.destroy();+ targets?.voronoiValue.destroy();+ targets?.voronoiEdge.destroy();+ targets = undefined;+ };++ const ensure = (logicalWidth: number, logicalHeight: number, devicePixelRatio?: number) => {+ const cellSize = imprintCellSizeForDevicePixelRatio(devicePixelRatio);+ const cols = Math.max(1, Math.ceil(logicalWidth / cellSize));+ const rows = Math.max(1, Math.ceil(logicalHeight / cellSize));+ if (targets?.cols === cols && targets.rows === rows) return targets;+ dispose();+ const ping = createPaintTexture(device, "eve-5-paint-ping", cols, rows);+ const pong = createPaintTexture(device, "eve-5-paint-pong", cols, rows);+ const staticNoise = createPaintStaticNoiseTexture(device, "eve-5-paint-static-noise", cols, rows);+ const voronoiValue = createVoronoiNoiseTexture(device, "eve-5-ascii-voronoi-value", cols, rows);+ const voronoiEdge = createVoronoiNoiseTexture(device, "eve-5-ascii-voronoi-edge", cols, rows);+ uploadStaticNoiseTexture(device, staticNoise, cols, rows);+ targets = {+ cols,+ rows,+ ping,+ pong,+ staticNoise,+ voronoiValue,+ voronoiEdge,+ readIsPing: true,+ pingReadBindGroup: createPaintDecayBindGroup(+ device,+ resources.pipelines.paintDecayPipeline,+ ping.createView(),+ staticNoise.createView(),+ resources.buffers.paintParamsBuffer,+ "eve-5-paint-decay-read-ping",+ ),+ pongReadBindGroup: createPaintDecayBindGroup(+ device,+ resources.pipelines.paintDecayPipeline,+ pong.createView(),+ staticNoise.createView(),+ resources.buffers.paintParamsBuffer,+ "eve-5-paint-decay-read-pong",+ ),+ pingDebugBindGroup: createPaintDebugBindGroup(+ device,+ resources.pipelines.paintDebugPipeline,+ ping.createView(),+ "eve-5-paint-debug-ping",+ ),+ pongDebugBindGroup: createPaintDebugBindGroup(+ device,+ resources.pipelines.paintDebugPipeline,+ pong.createView(),+ "eve-5-paint-debug-pong",+ ),+ };+ return targets;+ };++ const uploadSeed = (paintTargets: PaintTargets, seed: PaintSeed) => {+ if (seed.width !== paintTargets.cols || seed.height !== paintTargets.rows) {+ throw new Error(+ `Paint seed dimensions ${seed.width}×${seed.height} do not match paint grid ${paintTargets.cols}×${paintTargets.rows}.`,+ );+ }+ if (seed.values.length !== paintTargets.cols * paintTargets.rows) {+ throw new Error(+ `Paint seed has ${seed.values.length} values, expected ${paintTargets.cols * paintTargets.rows}.`,+ );+ }+ paintTargets.readIsPing = true;+ device.gpu.queue.writeTexture(+ { texture: paintTargets.ping },+ seed.values as GPUAllowSharedBufferSource,+ { bytesPerRow: paintTargets.cols * Float32Array.BYTES_PER_ELEMENT, rowsPerImage: paintTargets.rows },+ { width: paintTargets.cols, height: paintTargets.rows },+ );+ };++ const paintStepOptions = (+ paint: PaintRenderOptions,+ step: number,+ steps: number,+ ): PaintRenderOptions => {+ const stroke = paint.stroke;+ if (!stroke) {+ return {+ ...paint,+ seed: undefined,+ steps: undefined,+ decaySteps: undefined,+ brushActive: false,+ };+ }+ const denominator = Math.max(1, steps - 1);+ const t = steps <= 1 ? 1 : step / denominator;+ const brushCell = [+ mix(stroke.fromCell[0], stroke.toCell[0], t),+ mix(stroke.fromCell[1], stroke.toCell[1], t),+ ] as const;+ const previousT = steps <= 1 ? t : Math.max(0, step - 1) / denominator;+ const previousBrushCell = [+ mix(stroke.fromCell[0], stroke.toCell[0], previousT),+ mix(stroke.fromCell[1], stroke.toCell[1], previousT),+ ] as const;+ const dx = brushCell[0] - previousBrushCell[0];+ const dy = brushCell[1] - previousBrushCell[1];+ const moved = Math.hypot(dx, dy) >= PAINT_STROKE_MOVEMENT_EPSILON_CELLS;+ return {+ ...paint,+ seed: undefined,+ steps: undefined,+ stroke: undefined,+ decaySteps: undefined,+ brushCell,+ brushPreviousCell: previousBrushCell,+ brushActive: stroke.movementGated === false || moved,+ dt: stroke.duration !== undefined && steps > 0 ? stroke.duration / steps : paint.dt,+ };+ };++ const renderDecay = (paintTargets: PaintTargets, paint: PaintRenderOptions = {}) => {+ const dt = Math.min(Math.max(paint.dt ?? DEFAULT_PAINT_DT, 0), 0.1);+ const brushCell = paint.brushCell ?? [-1000000, -1000000];+ const brushPreviousCell = paint.brushPreviousCell ?? brushCell;+ resources.buffers.paintParamsBuffer.write(+ new Float32Array([+ brushCell[0],+ brushCell[1],+ brushPreviousCell[0],+ brushPreviousCell[1],+ paint.brushRadius ?? DEFAULT_PAINT_BRUSH_RADIUS,+ paint.brushStrength ?? DEFAULT_PAINT_BRUSH_STRENGTH,+ paint.decayRate ?? DEFAULT_PAINT_DECAY_RATE,+ paint.diffusionRate ?? DEFAULT_PAINT_DIFFUSION_RATE,+ paint.diffusionJitter ?? DEFAULT_PAINT_DIFFUSION_JITTER,+ dt,+ paint.brushActive ? 1 : 0,+ 0,+ ]),+ );+ const readBindGroup = paintTargets.readIsPing+ ? paintTargets.pingReadBindGroup+ : paintTargets.pongReadBindGroup;+ const writeTexture = paintTargets.readIsPing ? paintTargets.pong : paintTargets.ping;+ const pass = new RenderPass(device, {+ label: "eve-5-paint-decay-pass",+ colorAttachments: [+ {+ view: writeTexture.createView(),+ loadOp: "clear",+ storeOp: "store",+ clearValue: [0, 0, 0, 1],+ },+ ],+ });+ pass.setPipeline(resources.pipelines.paintDecayPipeline);+ pass.setBindGroup(0, readBindGroup);+ pass.draw(3);+ pass.end();+ paintTargets.readIsPing = !paintTargets.readIsPing;+ };++ const apply = (paintTargets: PaintTargets, paint: PaintRenderOptions | undefined) => {+ if (paint?.seed) {+ uploadSeed(paintTargets, paint.seed);+ }+ if (paint?.seed || paint?.stroke) {+ const steps = Math.max(0, Math.floor(paint.steps ?? 0));+ for (let step = 0; step < steps; step += 1) {+ renderDecay(paintTargets, paintStepOptions(paint, step, steps));+ }+ const decaySteps = Math.max(0, Math.floor(paint.decaySteps ?? 0));+ for (let step = 0; step < decaySteps; step += 1) {+ renderDecay(paintTargets, {+ ...paint,+ seed: undefined,+ steps: undefined,+ stroke: undefined,+ decaySteps: undefined,+ brushActive: false,+ });+ }+ } else {+ renderDecay(paintTargets, paint);+ }+ };++ const renderVoronoiNoise = (+ paintTargets: PaintTargets,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ projectionPaddingRadius: number,+ imprint: ImprintRenderOptions = {},+ ) => {+ const metrics = paintMappingMetrics(+ mesh.bounds,+ controls,+ logicalWidth,+ logicalHeight,+ imprint.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ projectionPaddingRadius,+ imprint.devicePixelRatio,+ );+ resources.buffers.voronoiNoiseParamsBuffer.write(+ new Float32Array([+ metrics.gridScale,+ imprint.time ?? 0,+ metrics.originCell[0],+ metrics.originCell[1],+ ]),+ );+ const pass = new RenderPass(device, {+ label: "eve-5-ascii-voronoi-noise-pass",+ colorAttachments: [+ {+ view: paintTargets.voronoiValue.createView(),+ loadOp: "clear",+ storeOp: "store",+ clearValue: [0, 0, 0, 1],+ },+ {+ view: paintTargets.voronoiEdge.createView(),+ loadOp: "clear",+ storeOp: "store",+ clearValue: [0, 0, 0, 1],+ },+ ],+ });+ pass.setPipeline(resources.pipelines.voronoiNoisePipeline);+ pass.setBindGroup(0, resources.voronoiNoiseBindGroup);+ pass.draw(3);+ pass.end();+ };++ const renderDebug = (view: GPUTextureView, paintTargets: PaintTargets) => {+ const pass = new RenderPass(device, {+ label: "eve-5-paint-debug-pass",+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ });+ pass.setPipeline(resources.pipelines.paintDebugPipeline);+ pass.setBindGroup(+ 0,+ paintTargets.readIsPing ? paintTargets.pingDebugBindGroup : paintTargets.pongDebugBindGroup,+ );+ pass.draw(3);+ pass.end();+ };++ return { ensure, apply, renderVoronoiNoise, renderDebug, dispose };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.tsnew file mode 100644index 000000000..b444c40fc--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/params.ts@@ -0,0 +1,68 @@+// TS-side uniform ABI writer for shared scene params.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { Buffer } from "@vgpu/core";+import { DEFAULT_IMPRINT_GLYPH_SCALE, DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER, MATERIAL_KIND } from "./constants";+import { cameraClipPlanes } from "./camera";+import { cameraBasis, degreesToRadians, lookAt, multiply, orbitEye, perspective } from "./math";+import { getPaddedRenderSize } from "./textures";+import { paintMappingMetrics } from "./pointer-mapping";+import type { Bounds, ImprintRenderOptions, RenderControls, Vec3 } from "./types";++// ABI: must match shaders/shared/scene-params.wgsl (176 B / 44 f32).+export function writeParams(args: { target: { buffer: Buffer }; controls: RenderControls; logicalWidth: number; logicalHeight: number; passKind: number; projectionPaddingRadius: number; imprint?: ImprintRenderOptions; meshBounds: Bounds; orbitTarget: Vec3; thicknessScale: number; isLight: boolean }) {+ const { target, controls, logicalWidth, logicalHeight, passKind, projectionPaddingRadius, imprint = {}, meshBounds, orbitTarget, thicknessScale, isLight } = args;+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, projectionPaddingRadius);+ const fovRad = degreesToRadians(controls.fov);+ const verticalScale = padded.height / logicalHeight;+ const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));+ const aspect = padded.width / padded.height;+ const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);+ const basis = cameraBasis(eye, orbitTarget);+ const clip = cameraClipPlanes(meshBounds, eye, basis.forward);+ const proj = perspective(fovEff, aspect, clip.near, clip.far);+ const view = lookAt(eye, orbitTarget, [0, 1, 0]);+ const viewProj = multiply(proj, view);+ const data = new Float32Array(44);+ data.set(viewProj, 0);+ data[16] = eye[0];+ data[17] = eye[1];+ data[18] = eye[2];+ data[19] = passKind;+ data[20] = basis.right[0];+ data[21] = basis.right[1];+ data[22] = basis.right[2];+ data[23] = fovEff;+ data[24] = basis.up[0];+ data[25] = basis.up[1];+ data[26] = basis.up[2];+ data[27] = aspect;+ data[28] = basis.forward[0];+ data[29] = basis.forward[1];+ data[30] = basis.forward[2];+ data[31] = MATERIAL_KIND[controls.material];+ data[32] = thicknessScale;+ data[33] = controls.envYaw;+ data[34] = controls.envPitch;+ data[35] = isLight ? 0 : 1;+ const metrics = paintMappingMetrics(+ meshBounds,+ controls,+ logicalWidth,+ logicalHeight,+ imprint.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ projectionPaddingRadius,+ imprint.devicePixelRatio,+ );+ const gridScale = metrics.gridScale;+ data[36] = Math.max(0, Math.min(1, imprint.progress ?? 0));+ data[37] = gridScale;+ data[38] = Math.max(0.1, imprint.glyphScale ?? DEFAULT_IMPRINT_GLYPH_SCALE);+ data[39] = imprint.time ?? 0;+ data[40] = imprint.mouse?.[0] ?? 0;+ data[41] = imprint.mouse?.[1] ?? 0;+ data[42] = metrics.originCell[0];+ data[43] = metrics.originCell[1];+ target.buffer.write(data);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.tsnew file mode 100644index 000000000..7c059eb7e--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/back-pass.ts@@ -0,0 +1,95 @@+// Encodes the back material and back camera-axis depth passes.+// INVARIANT: Back material renders before front scene; pass kind and depth state are shader ABI inputs.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import { PASS_INSIDE } from "../constants";+import { writeParams } from "../params";+import type { RendererResources } from "../resources";+import type { MeshData, RenderControls } from "../types";++export function renderBackMaterial(+ device: Device,+ resources: RendererResources,+ mesh: MeshData,+ target: GPUTextureView,+ depth: GPUTextureView,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ projectionPaddingRadius = resources.paddingRadius,+) {+ writeParams({+ target: resources.params.insideParams,+ controls,+ logicalWidth,+ logicalHeight,+ passKind: PASS_INSIDE,+ projectionPaddingRadius,+ meshBounds: mesh.bounds,+ orbitTarget: resources.orbitTarget,+ thicknessScale: resources.thicknessScale,+ isLight: resources.isLight,+ });+ const pass = new RenderPass(device, {+ label: "eve-5-back-material-pass",+ colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ depthStencilAttachment: {+ view: depth,+ depthClearValue: 1,+ depthLoadOp: "clear",+ depthStoreOp: "store",+ },+ });+ if (controls.insideRendering) {+ pass.setPipeline(resources.pipelines.backMaterialPipeline);+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");+ pass.setBindGroup(0, resources.params.insideParams.bindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);+ }+ pass.end();+}++export function renderBackDepth(+ device: Device,+ resources: RendererResources,+ mesh: MeshData,+ target: GPUTextureView,+ depth: GPUTextureView,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ projectionPaddingRadius = resources.paddingRadius,+) {+ writeParams({+ target: resources.params.backDepthParams,+ controls,+ logicalWidth,+ logicalHeight,+ passKind: PASS_INSIDE,+ projectionPaddingRadius,+ meshBounds: mesh.bounds,+ orbitTarget: resources.orbitTarget,+ thicknessScale: resources.thicknessScale,+ isLight: resources.isLight,+ });+ const pass = new RenderPass(device, {+ label: "eve-5-back-depth-pass",+ colorAttachments: [{ view: target, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ depthStencilAttachment: {+ view: depth,+ depthLoadOp: "load",+ depthStoreOp: "store",+ },+ });+ if (controls.insideRendering) {+ pass.setPipeline(resources.pipelines.backDepthPipeline);+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");+ pass.setBindGroup(0, resources.params.backDepthParams.bindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);+ }+ pass.end();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.tsnew file mode 100644index 000000000..06e02d6b0--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/bloom-pass.ts@@ -0,0 +1,82 @@+// Encodes bloom blur and dark-theme composite passes.+// INVARIANT: Bloom extract/blur/composite order and blend strength math remain in renderer.ts.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import { BLOOM_STRENGTH_OFF, BLOOM_THRESHOLD } from "../constants";+import type { RendererResources } from "../resources";+import type { BloomTargets } from "../types";++export function renderBlur(+ device: Device,+ resources: RendererResources,+ source: GPUTexture,+ target: GPUTexture,+ direction: [number, number],+ extract: boolean,+ radius: number,+) {+ const kernelRadius = Math.max(0, Math.round(radius));+ const sigma = Math.max(0.001, kernelRadius / 3);+ resources.buffers.blurParamsBuffer.write(+ new Float32Array([+ direction[0],+ direction[1],+ extract ? 1 : 0,+ BLOOM_THRESHOLD,+ kernelRadius,+ sigma,+ 0,+ 0,+ ]),+ );+ const bindGroup = device.gpu.createBindGroup({+ label: "eve-5-bloom-blur-bind-group",+ layout: resources.pipelines.blurPipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: source.createView() },+ { binding: 1, resource: resources.samplers.blurSampler },+ { binding: 2, resource: { buffer: resources.buffers.blurParamsBuffer.gpu } },+ ],+ });+ const pass = new RenderPass(device, {+ label: `eve-5-bloom-${direction[0] > 0 ? "horizontal" : "vertical"}-pass`,+ colorAttachments: [+ { view: target.createView(), loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] },+ ],+ });+ pass.setPipeline(resources.pipelines.blurPipeline);+ pass.setBindGroup(0, bindGroup);+ pass.draw(3);+ pass.end();+}++export function renderComposite(+ device: Device,+ resources: RendererResources,+ view: GPUTextureView,+ targets: BloomTargets,+ bloomTexture: GPUTexture = targets.vertical,+ strength = BLOOM_STRENGTH_OFF,+) {+ resources.buffers.compositeParamsBuffer.write(new Float32Array([strength, 0, 0, 0]));+ const bindGroup = device.gpu.createBindGroup({+ label: "eve-5-bloom-composite-bind-group",+ layout: resources.pipelines.compositePipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: targets.scene.createView() },+ { binding: 1, resource: bloomTexture.createView() },+ { binding: 2, resource: resources.samplers.blurSampler },+ { binding: 3, resource: { buffer: resources.buffers.compositeParamsBuffer.gpu } },+ ],+ });+ const pass = new RenderPass(device, {+ label: "eve-5-composite-tonemap-pass",+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ });+ pass.setPipeline(resources.pipelines.compositePipeline);+ pass.setBindGroup(0, bindGroup);+ pass.draw(3);+ pass.end();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.tsnew file mode 100644index 000000000..a33c8cd59--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/debug-passes.ts@@ -0,0 +1,106 @@+// Encodes non-main debug display passes: target preview and thickness visualization.+// INVARIANT: Debug passes use display-format front pipeline and do not change paint parity.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import { cameraAxisDepthRange } from "../camera";+import { createParamsBindGroup } from "../bindings";+import { PASS_OUTSIDE, PREVIEW_BACK_ALBEDO, PREVIEW_BACK_DEPTH } from "../constants";+import { cameraBasis, orbitEye } from "../math";+import { writeParams } from "../params";+import type { RendererResources } from "../resources";+import type { BloomTargets, MeshData, RenderControls } from "../types";++export function renderTargetPreview(+ device: Device,+ resources: RendererResources,+ mesh: MeshData,+ view: GPUTextureView,+ targets: BloomTargets,+ controls: RenderControls,+) {+ const basis = cameraBasis(+ orbitEye(resources.orbitTarget, controls.radius, controls.yaw, controls.pitch),+ resources.orbitTarget,+ );+ const depthRange = cameraAxisDepthRange(mesh.bounds, basis.forward);+ resources.buffers.previewMode.write(+ new Float32Array([+ controls.material === "back-depth" ? PREVIEW_BACK_DEPTH : PREVIEW_BACK_ALBEDO,+ depthRange.min,+ depthRange.max,+ 0,+ ]),+ );+ const bindGroup = device.gpu.createBindGroup({+ label: "eve-5-render-target-preview-bind-group",+ layout: resources.pipelines.previewPipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: targets.backMaterial.createView() },+ { binding: 1, resource: targets.backDepth.createView() },+ { binding: 2, resource: resources.samplers.previewSampler },+ { binding: 3, resource: { buffer: resources.buffers.previewMode.gpu } },+ ],+ });+ const pass = new RenderPass(device, {+ label: "eve-5-render-target-preview-pass",+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ });+ pass.setPipeline(resources.pipelines.previewPipeline);+ pass.setBindGroup(0, bindGroup);+ pass.draw(3);+ pass.end();+}++export function renderThicknessDebug(+ device: Device,+ resources: RendererResources,+ mesh: MeshData,+ view: GPUTextureView,+ backMaterial: GPUTexture,+ backDepth: GPUTexture,+ paintTexture: GPUTexture,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ projectionPaddingRadius = resources.paddingRadius,+) {+ writeParams({+ target: resources.params.outsideParams,+ controls,+ logicalWidth,+ logicalHeight,+ passKind: PASS_OUTSIDE,+ projectionPaddingRadius,+ meshBounds: mesh.bounds,+ orbitTarget: resources.orbitTarget,+ thicknessScale: resources.thicknessScale,+ isLight: resources.isLight,+ });+ const outsideBindGroup = createParamsBindGroup(+ device,+ resources.pipelines.frontDisplayPipeline,+ resources.studioCubemap,+ resources.params.outsideParams.buffer,+ backMaterial.createView(),+ backDepth.createView(),+ paintTexture.createView(),+ resources.params.outsideParams.fallbackVoronoiValue.createView(),+ resources.params.outsideParams.fallbackVoronoiEdge.createView(),+ "eve-5-thickness-debug-params-bind-group",+ );++ const pass = new RenderPass(device, {+ label: "eve-5-thickness-debug-pass",+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 1] }],+ });+ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");+ if (controls.outsideRendering) {+ pass.setPipeline(resources.pipelines.frontDisplayPipeline);+ pass.setBindGroup(0, outsideBindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);+ }+ pass.end();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.tsnew file mode 100644index 000000000..e4f74159d--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/light-composite-pass.ts@@ -0,0 +1,32 @@+// Encodes the light-theme premultiplied composite pass.+// INVARIANT: Clear alpha remains 0 for light theme compositing.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import type { RendererResources } from "../resources";+import type { BloomTargets } from "../types";++export function renderLightComposite(+ device: Device,+ resources: RendererResources,+ view: GPUTextureView,+ targets: BloomTargets,+) {+ const bindGroup = device.gpu.createBindGroup({+ label: "eve-5-light-composite-bind-group",+ layout: resources.pipelines.lightCompositePipeline.getBindGroupLayout(0),+ entries: [+ { binding: 0, resource: targets.scene.createView() },+ { binding: 1, resource: resources.samplers.blurSampler },+ ],+ });+ const pass = new RenderPass(device, {+ label: "eve-5-light-composite-premultiplied-pass",+ colorAttachments: [{ view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, 0] }],+ });+ pass.setPipeline(resources.pipelines.lightCompositePipeline);+ pass.setBindGroup(0, bindGroup);+ pass.draw(3);+ pass.end();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.tsnew file mode 100644index 000000000..8976eb896--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/passes/scene-pass.ts@@ -0,0 +1,106 @@+// Encodes the main front scene pass and wireframe/environment overlays.+// INVARIANT: Front binding indices 0-7 and back-before-front ordering are unchanged.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { RenderPass } from "@vgpu/render";+import { createParamsBindGroup } from "../bindings";+import { PASS_OUTSIDE, PASS_WIREFRAME } from "../constants";+import { writeParams } from "../params";+import type { RendererResources } from "../resources";+import type { ImprintRenderOptions, MeshData, RenderControls } from "../types";++export function renderScene(+ device: Device,+ resources: RendererResources,+ mesh: MeshData,+ view: GPUTextureView,+ backMaterial: GPUTexture,+ backDepth: GPUTexture,+ paintTexture: GPUTexture,+ voronoiValueTexture: GPUTexture,+ voronoiEdgeTexture: GPUTexture,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ projectionPaddingRadius = resources.paddingRadius,+ imprint: ImprintRenderOptions = {},+) {+ const paramsBase = {+ controls,+ logicalWidth,+ logicalHeight,+ projectionPaddingRadius,+ meshBounds: mesh.bounds,+ orbitTarget: resources.orbitTarget,+ thicknessScale: resources.thicknessScale,+ isLight: resources.isLight,+ };+ writeParams({+ ...paramsBase,+ target: resources.params.outsideParams,+ passKind: PASS_OUTSIDE,+ imprint,+ });+ writeParams({ ...paramsBase, target: resources.params.wireParams, passKind: PASS_WIREFRAME });+ writeParams({ ...paramsBase, target: resources.params.envBgParams, passKind: PASS_OUTSIDE });+ writeParams({ ...paramsBase, target: resources.params.opaqueOutsideParams, passKind: PASS_OUTSIDE });++ const outsideBindGroup = createParamsBindGroup(+ device,+ resources.pipelines.frontMaterialPipeline,+ resources.studioCubemap,+ resources.params.outsideParams.buffer,+ backMaterial.createView(),+ backDepth.createView(),+ paintTexture.createView(),+ voronoiValueTexture.createView(),+ voronoiEdgeTexture.createView(),+ "eve-5-outside-params-bind-group",+ );++ const pass = new RenderPass(device, {+ label: "eve-5-scene-hdr-pass",+ colorAttachments: [+ { view, loadOp: "clear", storeOp: "store", clearValue: [0, 0, 0, resources.isLight ? 0 : 1] },+ ],+ });++ // Optional environment background: draw the studio cubemap behind the logo so the lighting+ // is visible. Fullscreen triangle, no vertex buffer, so do it before binding the mesh.+ if (controls.showEnv) {+ pass.setPipeline(resources.pipelines.envBgPipeline);+ pass.setBindGroup(0, resources.params.envBgParams.bindGroup);+ pass.draw(3);+ }++ pass.setVertexBuffer(0, resources.gpuMesh.vertexBuffer);++ const needsBackTargets = controls.material === "glass" || controls.material === "thickness";+ pass.gpu.setIndexBuffer(resources.gpuMesh.indexBuffer.gpu, "uint32");+ if (needsBackTargets) {+ // The back/inside material and camera-axis depth have already been rendered into offscreen+ // targets. The main scene draws only the front/outside material; glass and thickness debug+ // both need the real back targets rather than the opaque/debug fallback bind group.+ if (controls.outsideRendering) {+ pass.setPipeline(resources.pipelines.frontMaterialPipeline);+ pass.setBindGroup(0, outsideBindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);+ }+ } else if (controls.outsideRendering) {+ // Opaque/debug materials are single-surface views. Drawing the inside pass too would+ // double-expose through the depthless transparent ordering used by glass.+ pass.setPipeline(resources.pipelines.opaquePipeline);+ pass.setBindGroup(0, resources.params.opaqueOutsideParams.bindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.indexCount, 1, 0, 0, 0);+ }++ if (controls.wireframe) {+ pass.setPipeline(resources.pipelines.wirePipeline);+ pass.gpu.setIndexBuffer(resources.gpuMesh.lineIndexBuffer.gpu, "uint32");+ pass.setBindGroup(0, resources.params.wireParams.bindGroup);+ pass.gpu.drawIndexed(resources.gpuMesh.lineIndexCount, 1, 0, 0, 0);+ }++ pass.end();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.tsnew file mode 100644index 000000000..8548cdcda--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pipelines.ts@@ -0,0 +1,185 @@+// Declarative render pipeline creation with fixed vertex layout/bindings.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device } from "@vgpu/core";+import { createRenderPipeline } from "@vgpu/render";+import { BACK_DEPTH_FORMAT, PAINT_FORMAT, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";+import { createShaders } from "./shaders";++export function createPipelines(device: Device, format: GPUTextureFormat) {+ const shaders = createShaders(device);+ const vertexLayout: GPUVertexBufferLayout = {+ arrayStride: 6 * 4,+ attributes: [+ { shaderLocation: 0, offset: 0, format: "float32x3" },+ { shaderLocation: 1, offset: 3 * 4, format: "float32x3" },+ ],+ };++ const backMaterialPipeline = createRenderPipeline(device, {+ label: "eve-5-glass-back-material-pipeline",+ shader: shaders.glassBack,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: {+ entry: "fs_main",+ targets: [+ {+ format: SCENE_FORMAT,+ blend: {+ color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },+ },+ },+ ],+ },+ primitive: { topology: "triangle-list" },+ depthStencil: { format: BACK_DEPTH_FORMAT, depthWriteEnabled: true, depthCompare: "less" },+ });++ const backDepthPipeline = createRenderPipeline(device, {+ label: "eve-5-glass-back-depth-pipeline",+ shader: shaders.glassBackDepth,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },+ primitive: { topology: "triangle-list" },+ depthStencil: {+ format: BACK_DEPTH_FORMAT,+ depthWriteEnabled: false,+ depthCompare: "less-equal",+ },+ });++ const frontMaterialPipeline = createRenderPipeline(device, {+ label: "eve-5-glass-front-material-pipeline",+ shader: shaders.glassFront,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: {+ entry: "fs_main",+ targets: [+ {+ format: SCENE_FORMAT,+ blend: {+ color: { srcFactor: "src-alpha", dstFactor: "one", operation: "add" },+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },+ },+ },+ ],+ },+ primitive: { topology: "triangle-list" },+ });++ const frontDisplayPipeline = createRenderPipeline(device, {+ label: "eve-5-glass-front-display-pipeline",+ shader: shaders.glassFront,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: { entry: "fs_main", targets: [{ format }] },+ primitive: { topology: "triangle-list" },+ });++ const opaquePipeline = createRenderPipeline(device, {+ label: "eve-5-opaque-material-pipeline",+ shader: shaders.glassFront,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: {+ entry: "fs_main",+ targets: [+ {+ format: SCENE_FORMAT,+ blend: {+ color: { srcFactor: "one", dstFactor: "zero", operation: "add" },+ alpha: { srcFactor: "one", dstFactor: "zero", operation: "add" },+ },+ },+ ],+ },+ primitive: { topology: "triangle-list" },+ });++ const wirePipeline = createRenderPipeline(device, {+ label: "eve-5-wireframe-pipeline",+ shader: shaders.glassFront,+ vertex: { entry: "vs_main", buffers: [vertexLayout] },+ fragment: {+ entry: "fs_main",+ targets: [+ {+ format: SCENE_FORMAT,+ blend: {+ color: { srcFactor: "src-alpha", dstFactor: "one-minus-src-alpha", operation: "add" },+ alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha", operation: "add" },+ },+ },+ ],+ },+ primitive: { topology: "line-list" },+ });++ const blurPipeline = createRenderPipeline(device, {+ label: "eve-5-bloom-blur-pipeline",+ shader: shaders.bloomBlur,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },+ primitive: { topology: "triangle-list" },+ });++ const compositePipeline = createRenderPipeline(device, {+ label: "eve-5-bloom-composite-pipeline",+ shader: shaders.bloomComposite,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format }] },+ primitive: { topology: "triangle-list" },+ });++ const lightCompositePipeline = createRenderPipeline(device, {+ label: "eve-5-light-composite-pipeline",+ shader: shaders.lightComposite,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format }] },+ primitive: { topology: "triangle-list" },+ });++ const envBgPipeline = createRenderPipeline(device, {+ label: "eve-5-env-bg-pipeline",+ shader: shaders.envBg,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format: SCENE_FORMAT }] },+ primitive: { topology: "triangle-list" },+ });++ const previewPipeline = createRenderPipeline(device, {+ label: "eve-5-render-target-preview-pipeline",+ shader: shaders.preview,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format }] },+ primitive: { topology: "triangle-list" },+ });++ const paintDecayPipeline = createRenderPipeline(device, {+ label: "eve-5-paint-decay-pipeline",+ shader: shaders.paintUpdate,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format: PAINT_FORMAT }] },+ primitive: { topology: "triangle-list" },+ });++ const paintDebugPipeline = createRenderPipeline(device, {+ label: "eve-5-paint-debug-pipeline",+ shader: shaders.paintDebug,+ vertex: { entry: "vs_main" },+ fragment: { entry: "fs_main", targets: [{ format }] },+ primitive: { topology: "triangle-list" },+ });++ const voronoiNoisePipeline = createRenderPipeline(device, {+ label: "eve-5-voronoi-noise-update-pipeline",+ shader: shaders.voronoiNoiseUpdate,+ vertex: { entry: "vs_main" },+ fragment: {+ entry: "fs_main",+ targets: [{ format: VORONOI_NOISE_FORMAT }, { format: VORONOI_NOISE_FORMAT }],+ },+ primitive: { topology: "triangle-list" },+ });+ return { backMaterialPipeline, backDepthPipeline, frontMaterialPipeline, frontDisplayPipeline, opaquePipeline, wirePipeline, blurPipeline, compositePipeline, lightCompositePipeline, envBgPipeline, previewPipeline, paintDecayPipeline, paintDebugPipeline, voronoiNoisePipeline };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.tsnew file mode 100644index 000000000..41fcb1b00--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/pointer-mapping.ts@@ -0,0 +1,84 @@+// Pointer-to-paint-cell mapping; mirrors params origin-cell math.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { Bounds, PaintPointerMapping, PaintPointerMappingInput, RenderControls } from "./types";+import {+ BLOOM_RADIUS,+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ imprintCellSizeForDevicePixelRatio,+} from "./constants";+import { meshOrbitTargetFromBounds } from "./camera";+import { degreesToRadians, dot } from "./math";+import { getPaddedRenderSize } from "./textures";+import { cameraBasis, orbitEye } from "./math";+import { normalizedMeshBounds } from "./mesh-gpu";++export function mapClientPointToPaintCell(+ input: PaintPointerMappingInput,+): PaintPointerMapping | undefined {+ const rectWidth = Math.max(0, input.rect.width);+ const rectHeight = Math.max(0, input.rect.height);+ const canvasWidth = Math.max(1, input.canvasWidth);+ const canvasHeight = Math.max(1, input.canvasHeight);+ const logicalWidth = Math.max(1, Math.round(input.logicalWidth));+ const logicalHeight = Math.max(1, Math.round(input.logicalHeight));+ if (rectWidth <= 0 || rectHeight <= 0) return undefined;++ const paddingRadius = input.paddingRadius ?? BLOOM_RADIUS;+ const xPhys = (input.clientX - input.rect.left) * (canvasWidth / rectWidth);+ const yPhys = (input.clientY - input.rect.top) * (canvasHeight / rectHeight);+ const xLog = xPhys - paddingRadius;+ const yLog = yPhys - paddingRadius;+ const metrics = paintMappingMetrics(+ input.meshBounds,+ input.controls,+ logicalWidth,+ logicalHeight,+ input.gridScaleMultiplier ?? DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ paddingRadius,+ input.devicePixelRatio,+ );+ const modelX = (xLog - logicalWidth * 0.5) / metrics.pxPerModelUnit;+ const modelY = (logicalHeight * 0.5 - yLog) / metrics.pxPerModelUnit;+ const brushCellX = modelX * metrics.gridScale - metrics.originCell[0];+ const brushCellY = modelY * metrics.gridScale - metrics.originCell[1];+ return {+ physical: [xPhys, yPhys],+ logical: [xLog, yLog],+ model: [modelX, modelY],+ brushCell: [brushCellX, brushCellY],+ originCell: metrics.originCell,+ gridScale: metrics.gridScale,+ pxPerModelUnit: metrics.pxPerModelUnit,+ insideLogicalBounds: xLog >= 0 && xLog <= logicalWidth && yLog >= 0 && yLog <= logicalHeight,+ };+}++export function paintMappingMetrics(+ bounds: Bounds,+ controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov">,+ logicalWidth: number,+ logicalHeight: number,+ gridScaleMultiplier: number,+ paddingRadius: number,+ devicePixelRatio?: number,+) {+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);+ const fovRad = degreesToRadians(controls.fov);+ const verticalScale = padded.height / Math.max(1, logicalHeight);+ const fovEff = 2 * Math.atan(verticalScale * Math.tan(fovRad * 0.5));+ const orbitTarget = meshOrbitTargetFromBounds(bounds);+ const eye = orbitEye(orbitTarget, controls.radius, controls.yaw, controls.pitch);+ const basis = cameraBasis(eye, orbitTarget);+ const distToFrontPlane = Math.max(0.001, -dot(eye, basis.forward));+ const pxPerModelUnit = padded.height / (2 * distToFrontPlane * Math.tan(fovEff * 0.5));+ const cellSize = imprintCellSizeForDevicePixelRatio(devicePixelRatio);+ const gridScale = (pxPerModelUnit / cellSize) * Math.max(0.001, gridScaleMultiplier);+ const normalizedBounds = normalizedMeshBounds(bounds);+ const originCell: [number, number] = [+ Math.floor(normalizedBounds.min[0] * gridScale),+ Math.floor(normalizedBounds.min[1] * gridScale),+ ];+ return { gridScale, originCell, pxPerModelUnit };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.tsnew file mode 100644index 000000000..6698cdb7d--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/renderer.ts@@ -0,0 +1,156 @@+// Composes Eve renderer resources and owns the frame graph behind the facade.+// INVARIANT: This file orders passes only; subsystems own their resources and disposal.+// Imported exclusively by render.ts.++import { Device } from "@vgpu/core";+import { BLOOM_STRENGTH_OFF, BLOOM_STRENGTH_ON, bloomRadiusForDevicePixelRatio } from "./constants";+import { clampUnit, mix } from "./math";+import { createPaintSystem } from "./paint-system";+import { renderBackDepth, renderBackMaterial } from "./passes/back-pass";+import { renderBlur, renderComposite } from "./passes/bloom-pass";+import { renderTargetPreview, renderThicknessDebug } from "./passes/debug-passes";+import { renderLightComposite } from "./passes/light-composite-pass";+import { renderScene } from "./passes/scene-pass";+import { createResources, disposeResources } from "./resources";+import { createBloomTargetCache } from "./targets";+import type { ImprintRenderOptions, MeshData, RenderControls } from "./types";++export function createEve5Renderer(+ device: Device,+ format: GPUTextureFormat,+ mesh: MeshData,+ options: {+ thicknessScale?: number;+ theme?: "light" | "dark";+ paddingRadius?: number;+ bloom?: boolean;+ } = {},+) {+ const resources = createResources(device, format, mesh, options);+ const bloomTargets = createBloomTargetCache(device);+ const paintSystem = createPaintSystem(device, resources, mesh);++ const renderGlassTarget = (+ target: GPUTextureView,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ imprint: ImprintRenderOptions = {},+ ) => {+ const safeWidth = Math.max(1, Math.round(logicalWidth));+ const safeHeight = Math.max(1, Math.round(logicalHeight));+ const paddingRadius = options.paddingRadius ?? bloomRadiusForDevicePixelRatio(imprint.devicePixelRatio);+ const targets = bloomTargets.ensure(safeWidth, safeHeight, paddingRadius);+ const currentPaintTargets = paintSystem.ensure(safeWidth, safeHeight, imprint.devicePixelRatio);+ const backSurfaceDepthView = targets.backSurfaceDepth.createView();++ renderBackMaterial(+ device,+ resources,+ mesh,+ targets.backMaterial.createView(),+ backSurfaceDepthView,+ controls,+ safeWidth,+ safeHeight,+ paddingRadius,+ );+ renderBackDepth(+ device,+ resources,+ mesh,+ targets.backDepth.createView(),+ backSurfaceDepthView,+ controls,+ safeWidth,+ safeHeight,+ paddingRadius,+ );++ paintSystem.apply(currentPaintTargets, imprint.paint);++ if (controls.material === "back-albedo" || controls.material === "back-depth") {+ renderTargetPreview(device, resources, mesh, target, targets, controls);+ return;+ }+ if (controls.material === "thickness") {+ renderThicknessDebug(+ device,+ resources,+ mesh,+ target,+ targets.backMaterial,+ targets.backDepth,+ currentPaintTargets.readIsPing ? currentPaintTargets.ping : currentPaintTargets.pong,+ controls,+ safeWidth,+ safeHeight,+ paddingRadius,+ );+ return;+ }+ if (controls.material === "paint-debug") {+ paintSystem.renderDebug(target, currentPaintTargets);+ return;+ }++ paintSystem.renderVoronoiNoise(+ currentPaintTargets,+ controls,+ safeWidth,+ safeHeight,+ paddingRadius,+ imprint,+ );+ renderScene(+ device,+ resources,+ mesh,+ targets.scene.createView(),+ targets.backMaterial,+ targets.backDepth,+ currentPaintTargets.readIsPing ? currentPaintTargets.ping : currentPaintTargets.pong,+ currentPaintTargets.voronoiValue,+ currentPaintTargets.voronoiEdge,+ controls,+ safeWidth,+ safeHeight,+ paddingRadius,+ imprint,+ );++ if (resources.isLight) {+ renderLightComposite(device, resources, target, targets);+ return;+ }+ if (!resources.bloomEnabled) {+ renderComposite(device, resources, target, targets, targets.scene, 0);+ return;+ }+ const effectiveBloomStrength = mix(+ BLOOM_STRENGTH_OFF,+ BLOOM_STRENGTH_ON,+ clampUnit(imprint.progress ?? 0),+ );+ renderBlur(device, resources, targets.scene, targets.horizontal, [1, 0], true, paddingRadius);+ renderBlur(device, resources, targets.horizontal, targets.vertical, [0, 1], false, paddingRadius);+ renderComposite(device, resources, target, targets, targets.vertical, effectiveBloomStrength);+ };++ return {+ render(+ target: GPUTextureView,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ imprint?: ImprintRenderOptions,+ ) {+ renderGlassTarget(target, controls, logicalWidth, logicalHeight, imprint);+ },+ dispose() {+ paintSystem.dispose();+ bloomTargets.dispose();+ disposeResources(resources);+ },+ };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.tsnew file mode 100644index 000000000..9b115d4a1--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/resources.ts@@ -0,0 +1,172 @@+// Owns long-lived GPU resources for one Eve renderer instance.+// INVARIANT: Creation/disposal mirrors the original render.ts resource list exactly.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { createBackParamsBinding, createEnvParamsBinding, createParamsBinding, createUniformParamsBinding } from "./bindings";+import { BLOOM_RADIUS, PAINT_PARAMS_BYTE_SIZE, VORONOI_NOISE_PARAMS_BYTE_SIZE } from "./constants";+import { createStudioCubemap, renderStudioCubemap } from "./cubemap";+import { EVE_DARK_ENV_LIGHTS, EVE_LIGHT_ENV_LIGHTS } from "./env-lights";+import { meshOrbitTarget, meshThicknessScale } from "./camera";+import { createGpuMesh } from "./mesh-gpu";+import { createPipelines } from "./pipelines";+import type { MeshData } from "./types";++export function createResources(+ device: Device,+ format: GPUTextureFormat,+ mesh: MeshData,+ options: {+ thicknessScale?: number;+ theme?: "light" | "dark";+ paddingRadius?: number;+ bloom?: boolean;+ } = {},+) {+ const studioCubemap = createStudioCubemap(device, "eve-5-studio-hdr-cubemap");+ const isLight = options.theme === "light";+ const envLights = isLight ? EVE_LIGHT_ENV_LIGHTS : EVE_DARK_ENV_LIGHTS;+ renderStudioCubemap(device, studioCubemap, envLights);+ const orbitTarget = meshOrbitTarget(mesh);+ const thicknessScale = options.thicknessScale ?? meshThicknessScale(mesh.bounds);+ const paddingRadius = options.paddingRadius ?? BLOOM_RADIUS;+ const bloomEnabled = options.bloom ?? true;+ const pipelines = createPipelines(device, format);+ const gpuMesh = createGpuMesh(device, mesh);++ const insideParams = createBackParamsBinding(+ device,+ pipelines.backMaterialPipeline,+ studioCubemap,+ "eve-5-inside-params",+ );+ const backDepthParams = createUniformParamsBinding(+ device,+ pipelines.backDepthPipeline,+ "eve-5-back-depth-params",+ );+ const envBgParams = createEnvParamsBinding(+ device,+ pipelines.envBgPipeline,+ studioCubemap,+ "eve-5-env-bg-params",+ );+ const outsideParams = createParamsBinding(+ device,+ pipelines.frontMaterialPipeline,+ studioCubemap,+ "eve-5-outside-params",+ );+ const opaqueOutsideParams = createParamsBinding(+ device,+ pipelines.opaquePipeline,+ studioCubemap,+ "eve-5-opaque-outside-params",+ );+ const wireParams = createParamsBinding(+ device,+ pipelines.wirePipeline,+ studioCubemap,+ "eve-5-wire-params",+ );+ const blurParamsBuffer = device.createBuffer({+ label: "eve-5-bloom-blur-params",+ size: 32,+ usage: ["uniform", "copy_dst"],+ });+ const compositeParamsBuffer = device.createBuffer({+ label: "eve-5-bloom-composite-params",+ size: 16,+ usage: ["uniform", "copy_dst"],+ });+ const paintParamsBuffer = device.createBuffer({+ label: "eve-5-paint-params",+ size: PAINT_PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ });+ const voronoiNoiseParamsBuffer = device.createBuffer({+ label: "eve-5-voronoi-noise-params",+ size: VORONOI_NOISE_PARAMS_BYTE_SIZE,+ usage: ["uniform", "copy_dst"],+ });+ const voronoiNoiseBindGroup = device.gpu.createBindGroup({+ label: "eve-5-voronoi-noise-bind-group",+ layout: pipelines.voronoiNoisePipeline.getBindGroupLayout(0),+ entries: [{ binding: 0, resource: { buffer: voronoiNoiseParamsBuffer.gpu } }],+ });+ const blurSampler = device.gpu.createSampler({+ label: "eve-5-bloom-sampler",+ magFilter: "linear",+ minFilter: "linear",+ addressModeU: "clamp-to-edge",+ addressModeV: "clamp-to-edge",+ });+ const previewSampler = device.gpu.createSampler({+ label: "eve-5-render-target-preview-sampler",+ magFilter: "linear",+ minFilter: "linear",+ addressModeU: "clamp-to-edge",+ addressModeV: "clamp-to-edge",+ });+ const previewMode = device.createBuffer({+ label: "eve-5-render-target-preview-mode",+ size: 16,+ usage: ["uniform", "copy_dst"],+ });++ const params = { insideParams, backDepthParams, envBgParams, outsideParams, opaqueOutsideParams, wireParams };+ const buffers = { blurParamsBuffer, compositeParamsBuffer, paintParamsBuffer, voronoiNoiseParamsBuffer, previewMode };+ const samplers = { blurSampler, previewSampler };++ return {+ studioCubemap,+ isLight,+ orbitTarget,+ thicknessScale,+ paddingRadius,+ bloomEnabled,+ pipelines,+ gpuMesh,+ params,+ buffers,+ samplers,+ voronoiNoiseBindGroup,+ };+}++export type RendererResources = ReturnType<typeof createResources>;++function destroyParamsBinding(binding: {+ buffer: { destroy(): void };+ fallbackBackMaterial?: GPUTexture;+ fallbackBackDepth?: GPUTexture;+ fallbackPaint?: GPUTexture;+ fallbackVoronoiValue?: GPUTexture;+ fallbackVoronoiEdge?: GPUTexture;+}) {+ binding.buffer.destroy();+ binding.fallbackBackMaterial?.destroy();+ binding.fallbackBackDepth?.destroy();+ binding.fallbackPaint?.destroy();+ binding.fallbackVoronoiValue?.destroy();+ binding.fallbackVoronoiEdge?.destroy();+}++export function disposeResources(resources: RendererResources) {+ resources.gpuMesh.vertexBuffer.destroy();+ resources.gpuMesh.indexBuffer.destroy();+ resources.gpuMesh.lineIndexBuffer.destroy();+ destroyParamsBinding(resources.params.insideParams);+ destroyParamsBinding(resources.params.backDepthParams);+ destroyParamsBinding(resources.params.outsideParams);+ destroyParamsBinding(resources.params.opaqueOutsideParams);+ destroyParamsBinding(resources.params.wireParams);+ destroyParamsBinding(resources.params.envBgParams);+ resources.buffers.blurParamsBuffer.destroy();+ resources.buffers.compositeParamsBuffer.destroy();+ resources.buffers.paintParamsBuffer.destroy();+ resources.buffers.voronoiNoiseParamsBuffer.destroy();+ resources.buffers.previewMode.destroy();+ resources.studioCubemap.faceParams.destroy();+ resources.studioCubemap.texture.destroy();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.tsnew file mode 100644index 000000000..cd1690cd9--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/shaders.ts@@ -0,0 +1,33 @@+// Single shader import/compile registry; WGSL entry paths stay unchanged.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device } from "@vgpu/core";+import { compile } from "@vgpu/wgsl";+import glassBackWgsl from "../shaders/glass/back.wgsl";+import glassFrontWgsl from "../shaders/glass/front.wgsl";+import glassBackDepthWgsl from "../shaders/glass/back-depth.wgsl";+import eveBloomBlurWgsl from "../shaders/bloom/blur.wgsl";+import eveBloomCompositeWgsl from "../shaders/bloom/composite.wgsl";+import eveLightCompositeWgsl from "../shaders/postprocess/light-composite.wgsl";+import eveEnvBgWgsl from "../shaders/env/background.wgsl";+import renderTargetPreviewWgsl from "../shaders/debug/render-target-preview.wgsl";+import paintUpdateWgsl from "../shaders/paint/paint-update.wgsl";+import paintDebugWgsl from "../shaders/paint/paint-debug.wgsl";+import voronoiNoiseUpdateWgsl from "../shaders/paint/voronoi-noise-update.wgsl";++export function createShaders(device: Device) {+ return {+ glassBack: device.createShader(compile(glassBackWgsl)),+ glassFront: device.createShader(compile(glassFrontWgsl)),+ glassBackDepth: device.createShader(compile(glassBackDepthWgsl)),+ bloomBlur: device.createShader(compile(eveBloomBlurWgsl)),+ bloomComposite: device.createShader(compile(eveBloomCompositeWgsl)),+ lightComposite: device.createShader(compile(eveLightCompositeWgsl)),+ envBg: device.createShader(compile(eveEnvBgWgsl)),+ preview: device.createShader(compile(renderTargetPreviewWgsl)),+ paintUpdate: device.createShader(compile(paintUpdateWgsl)),+ paintDebug: device.createShader(compile(paintDebugWgsl)),+ voronoiNoiseUpdate: device.createShader(compile(voronoiNoiseUpdateWgsl)),+ };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.tsnew file mode 100644index 000000000..c71ed398b--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/targets.ts@@ -0,0 +1,63 @@+// Owns resize-sensitive bloom/back render targets.+// INVARIANT: Target formats, labels, and destroy-before-recreate order match the original renderer.+// Imported only by render/renderer.ts.++import { Device } from "@vgpu/core";+import { createBackDepthTexture, createBloomTexture, getPaddedRenderSize } from "./textures";+import type { BloomTargets } from "./types";++export function createBloomTargetCache(device: Device) {+ let targets: (BloomTargets & { paddingRadius: number }) | undefined;++ const dispose = () => {+ targets?.scene.destroy();+ targets?.backMaterial.destroy();+ targets?.backDepth.destroy();+ targets?.backSurfaceDepth.destroy();+ targets?.horizontal.destroy();+ targets?.vertical.destroy();+ targets = undefined;+ };++ return {+ ensure(logicalWidth: number, logicalHeight: number, paddingRadius: number) {+ const padded = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);+ if (+ targets?.width === padded.width &&+ targets.height === padded.height &&+ targets.paddingRadius === paddingRadius+ ) {+ return targets;+ }+ dispose();+ targets = {+ width: padded.width,+ height: padded.height,+ paddingRadius,+ scene: createBloomTexture(device, "eve-5-scene-linear-hdr", padded.width, padded.height),+ backMaterial: createBloomTexture(+ device,+ "eve-5-back-material-linear-hdr",+ padded.width,+ padded.height,+ ),+ backDepth: createBloomTexture(+ device,+ "eve-5-back-camera-axis-depth",+ padded.width,+ padded.height,+ ),+ backSurfaceDepth: createBackDepthTexture(+ device,+ "eve-5-back-surface-depth",+ padded.width,+ padded.height,+ ),+ horizontal: createBloomTexture(device, "eve-5-bloom-horizontal", padded.width, padded.height),+ vertical: createBloomTexture(device, "eve-5-bloom-vertical", padded.width, padded.height),+ };+ return targets;+ },+ dispose,+ };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.tsnew file mode 100644index 000000000..a730cc31c--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/textures.ts@@ -0,0 +1,95 @@+// Render target sizing, texture factories, and static noise upload.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import { Device } from "@vgpu/core";+import { BACK_DEPTH_FORMAT, BLOOM_RADIUS, PAINT_FORMAT, PAINT_STATIC_NOISE_FORMAT, SCENE_FORMAT, VORONOI_NOISE_FORMAT } from "./constants";++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)) + padding,+ height: Math.max(1, Math.round(height)) + padding,+ };+}++export function createBloomTexture(device: Device, label: string, width: number, height: number) {+ return device.gpu.createTexture({+ label,+ size: [width, height],+ format: SCENE_FORMAT,+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,+ });+}++export function createBackDepthTexture(device: Device, label: string, width: number, height: number) {+ return device.gpu.createTexture({+ label,+ size: [width, height],+ format: BACK_DEPTH_FORMAT,+ usage: GPUTextureUsage.RENDER_ATTACHMENT,+ });+}++export function createPaintTexture(device: Device, label: string, width: number, height: number) {+ return device.gpu.createTexture({+ label,+ size: [width, height],+ format: PAINT_FORMAT,+ usage:+ GPUTextureUsage.RENDER_ATTACHMENT |+ GPUTextureUsage.TEXTURE_BINDING |+ GPUTextureUsage.COPY_DST |+ GPUTextureUsage.COPY_SRC,+ });+}++export function createPaintStaticNoiseTexture(+ device: Device,+ label: string,+ width: number,+ height: number,+) {+ return device.gpu.createTexture({+ label,+ size: [width, height],+ format: PAINT_STATIC_NOISE_FORMAT,+ usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,+ });+}++export function createVoronoiNoiseTexture(device: Device, label: string, width: number, height: number) {+ return device.gpu.createTexture({+ label,+ size: [width, height],+ format: VORONOI_NOISE_FORMAT,+ usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING,+ });+}++export function uploadStaticNoiseTexture(device: Device, texture: GPUTexture, width: number, height: number) {+ const values = new Float32Array(width * height * 4);+ for (let y = 0; y < height; y += 1) {+ for (let x = 0; x < width; x += 1) {+ const offset = (y * width + x) * 4;+ values[offset] = hashPaintCell(x, y, 0xa511e9b3);+ values[offset + 1] = hashPaintCell(x, y, 0x63d83595);+ values[offset + 2] = hashPaintCell(x, y, 0xf9bd1c5b);+ values[offset + 3] = hashPaintCell(x, y, 0x1c4b256d);+ }+ }+ device.gpu.queue.writeTexture(+ { texture },+ values,+ { bytesPerRow: width * 4 * Float32Array.BYTES_PER_ELEMENT, rowsPerImage: height },+ { width, height },+ );+}++export function hashPaintCell(x: number, y: number, salt: number) {+ let h = (Math.imul(x >>> 0, 0x8da6b343) ^ Math.imul(y >>> 0, 0xd8163841) ^ salt) >>> 0;+ h = (h ^ (h >>> 13)) >>> 0;+ h = Math.imul(h, 0x85ebca6b) >>> 0;+ h = (h ^ (h >>> 16)) >>> 0;+ return (h & 0x00ffffff) / 0x01000000;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.tsnew file mode 100644index 000000000..092cde415--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/render/types.ts@@ -0,0 +1,167 @@+// Renderer domain types and GPU resource shapes.+// INVARIANT: Pure move from render.ts; keep shader ABI, binding order, and pixel output unchanged.+// Imported by render/renderer.ts and re-exported only through render.ts facade.++import type { Buffer } from "@vgpu/core";++export type Bounds = {+ min: [number, number, number];+ max: [number, number, number];+};++export type MeshData = {+ positions: Float32Array;+ normals: Float32Array;+ indices: Uint32Array;+ bounds: Bounds;+};++export type EveMaterial =+ | "glass"+ | "normal"+ | "camera reflected normal"+ | "metallic"+ | "back-albedo"+ | "back-depth"+ | "thickness"+ | "paint-debug";++export type PaintSeed = {+ width: number;+ height: number;+ values: Float32Array;+};++export type PaintStroke = {+ fromCell: readonly [number, number];+ toCell: readonly [number, number];+ duration?: number;+ movementGated?: boolean;+};++export type PaintRenderOptions = {+ seed?: PaintSeed;+ steps?: number;+ dt?: number;+ brushCell?: readonly [number, number];+ brushPreviousCell?: readonly [number, number];+ brushRadius?: number;+ brushStrength?: number;+ brushActive?: boolean;+ decayRate?: number;+ diffusionRate?: number;+ diffusionJitter?: number;+ stroke?: PaintStroke;+ decaySteps?: number;+};++export type ImprintRenderOptions = {+ progress?: number;+ gridScaleMultiplier?: number;+ glyphScale?: number;+ time?: number;+ mouse?: readonly [number, number];+ paint?: PaintRenderOptions;+ devicePixelRatio?: number;+};++export type RenderControls = {+ yaw: number;+ pitch: number;+ radius: number;+ fov: number;+ envYaw: number;+ envPitch: number;+ insideRendering: boolean;+ outsideRendering: boolean;+ material: EveMaterial;+ wireframe: boolean;+ showEnv: boolean;+};++export type PaintPointerRect = {+ left: number;+ top: number;+ width: number;+ height: number;+};++export type PaintPointerMappingInput = {+ clientX: number;+ clientY: number;+ rect: PaintPointerRect;+ canvasWidth: number;+ canvasHeight: number;+ logicalWidth: number;+ logicalHeight: number;+ controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov">;+ meshBounds: Bounds;+ gridScaleMultiplier?: number;+ paddingRadius?: number;+ devicePixelRatio?: number;+};++export type PaintPointerMapping = {+ physical: readonly [number, number];+ logical: readonly [number, number];+ model: readonly [number, number];+ brushCell: readonly [number, number];+ originCell: readonly [number, number];+ gridScale: number;+ pxPerModelUnit: number;+ insideLogicalBounds: boolean;+};++export type GpuMesh = {+ vertexBuffer: Buffer;+ indexBuffer: Buffer;+ lineIndexBuffer: Buffer;+ indexCount: number;+ lineIndexCount: number;+};++export type StudioCubemap = {+ texture: GPUTexture;+ view: GPUTextureView;+ sampler: GPUSampler;+ faceParams: Buffer;+};++export type Mat4 = Float32Array;+export type Vec3 = [number, number, number];++export type EnvLightConfig = {+ name: string;+ position: readonly [number, number, number];+ color: string;+ intensity: number;+ radius: number;+ softness: number;+ luminance: number;+};++export type BloomTargets = {+ width: number;+ height: number;+ scene: GPUTexture;+ backMaterial: GPUTexture;+ backDepth: GPUTexture;+ backSurfaceDepth: GPUTexture;+ horizontal: GPUTexture;+ vertical: GPUTexture;+};++export type PaintTargets = {+ cols: number;+ rows: number;+ ping: GPUTexture;+ pong: GPUTexture;+ staticNoise: GPUTexture;+ voronoiValue: GPUTexture;+ voronoiEdge: GPUTexture;+ readIsPing: boolean;+ pingReadBindGroup: GPUBindGroup;+ pongReadBindGroup: GPUBindGroup;+ pingDebugBindGroup: GPUBindGroup;+ pongDebugBindGroup: GPUBindGroup;+};diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.tsnew file mode 100644index 000000000..b3533d30f--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/canvas-sizing.ts@@ -0,0 +1,48 @@+import { DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO, bloomRadiusForDevicePixelRatio } from "../render";++// Owns canvas and hero-logo sizing math for the browser renderer.+// INVARIANT: load-bearing DPR/back-target alignment; must match getPaddedRenderSize.+// Imported by index.tsx and runtime frame orchestration only.++export const DEFAULT_LOGO_ASPECT = 78 / 25;+const LOGO_RENDER_HEIGHT = 500;+const MAX_DEVICE_PIXEL_RATIO = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;++export function getLogicalRenderSize(aspect: number) {+ return {+ width: Math.max(1, Math.round(LOGO_RENDER_HEIGHT * aspect)),+ height: LOGO_RENDER_HEIGHT,+ };+}++export function getBrowserDevicePixelRatio() {+ return Math.min(window.devicePixelRatio || 1, MAX_DEVICE_PIXEL_RATIO);+}++export function resizeCanvas(canvas: HTMLCanvasElement | null) {+ const dpr = getBrowserDevicePixelRatio();+ if (!canvas) return dpr;+ const rect = canvas.getBoundingClientRect();+ const width = Math.max(1, Math.floor(rect.width * dpr));+ const height = Math.max(1, Math.floor(rect.height * dpr));+ if (canvas.width !== width || canvas.height !== height) {+ canvas.width = width;+ canvas.height = height;+ }+ return dpr;+}++export function getCanvasLogicalSize(+ canvas: HTMLCanvasElement,+ devicePixelRatio = getBrowserDevicePixelRatio(),+) {+ // The renderer pads the logical scene size by a DPR-scaled bloom radius on each side before+ // allocating its offscreen back/depth targets. The canvas itself is that padded physical render+ // target, so subtract the same physical padding here. Passing CSS/logical logo dimensions would+ // make the front shader's @builtin(position) sample different pixels from the back-side targets.+ const bloomRadius = bloomRadiusForDevicePixelRatio(devicePixelRatio);+ return {+ logicalWidth: Math.max(1, canvas.width - bloomRadius * 2),+ logicalHeight: Math.max(1, canvas.height - bloomRadius * 2),+ };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.tsnew file mode 100644index 000000000..af1875446--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/debug-gui.ts@@ -0,0 +1,80 @@+// Owns the optional lil-gui transition debugger for the Eve hero.+// INVARIANT: ?debug gate and window.__eveLogoTransitionDebugGui lifecycle are preserved.+// Imported only by index.tsx runtime startup.++export type EveTransitionDebugGui = {+ destroy(): void;+};++export type EveTransitionDebugState = {+ overrideEnabled: boolean;+ progress: number;+ gridScaleMultiplier: number;+ glyphScale: number;+ durationSeconds: number;+ paintDecayPerFrame120: number;+ diffusionAmount: number;+ diffusionJitter: number;+ brushRadius: number;+ brushStrength: number;+ visualizePaintBuffer: boolean;+};++declare global {+ interface Window {+ __eveLogoTransitionDebugGui?: EveTransitionDebugGui;+ }+}++export function destroyTransitionDebugGui(gui: EveTransitionDebugGui | undefined) {+ if (!gui) return;+ if (window.__eveLogoTransitionDebugGui === gui) {+ delete window.__eveLogoTransitionDebugGui;+ }+ gui.destroy();+}++export async function setupTransitionDebugGui({+ transitionDebug,+ isCancelled,+ isDisposed,+ onReady,+}: {+ transitionDebug: EveTransitionDebugState;+ isCancelled: () => boolean;+ isDisposed: () => boolean;+ onReady: (gui: EveTransitionDebugGui) => void;+}) {+ if (!new URLSearchParams(window.location.search).has("debug")) return;+ const { GUI } = await import("lil-gui");+ if (isCancelled() || isDisposed()) return;+ window.__eveLogoTransitionDebugGui?.destroy();+ const gui = new GUI({ title: "Eve logo imprint" });+ let guiDestroyed = false;+ const guiHandle: EveTransitionDebugGui = {+ destroy() {+ if (guiDestroyed) return;+ guiDestroyed = true;+ gui.destroy();+ },+ };+ onReady(guiHandle);+ window.__eveLogoTransitionDebugGui = guiHandle;+ gui.add(transitionDebug, "overrideEnabled").name("Override imprint");+ gui.add(transitionDebug, "progress", 0, 1, 0.001).name("Imprint progress");+ const imprint = gui.addFolder("Imprint");+ imprint.add(transitionDebug, "gridScaleMultiplier", 0.5, 2, 0.01).name("Grid scale multiplier");+ imprint.add(transitionDebug, "glyphScale", 0.5, 2.5, 0.01).name("Glyph scale");+ imprint.open();+ const paint = gui.addFolder("Paint");+ paint+ .add(transitionDebug, "paintDecayPerFrame120", 0.002, 0.08, 0.001)+ .name("Decay/frame @120fps");+ paint.add(transitionDebug, "diffusionAmount", 0, 24, 0.1).name("Diffusion (1/s)");+ paint.add(transitionDebug, "diffusionJitter", 0, 4, 0.01).name("Diffusion jitter");+ paint.add(transitionDebug, "brushRadius", 1, 8, 0.1).name("Brush radius (cells)");+ paint.add(transitionDebug, "brushStrength", 4, 32, 0.1).name("Brush strength (1/s)");+ paint.add(transitionDebug, "visualizePaintBuffer").name("Visualize paint buffer");+ paint.open();+ gui.add(transitionDebug, "durationSeconds", 0.05, 2, 0.01).name("Transition duration (s)");+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.tsnew file mode 100644index 000000000..e08dcf284--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/frame-loop.ts@@ -0,0 +1,239 @@+import type { MutableRefObject } from "react";+import { evePointerInteractionMode, mobileAutoEnvYaw } from "../mobile-motion";+import type { ImprintRenderOptions, RenderControls } from "../render";+import { getCanvasLogicalSize, resizeCanvas } from "./canvas-sizing";+import type { EveTransitionDebugState } from "./debug-gui";+import type { ControlsRef, HeroRuntimeState } from "./state";++// Owns the Eve hero rAF draw loop and canvas reveal sequencing.+// INVARIANT: dataset markers, paint movement gating, and fallback-on-error behavior are preserved.+// Imported only by index.tsx's single effect.++const ENV_YAW_LERP_SPEED = 3;+export const AGENTS_ENV_YAW_LERP_SPEED = 3;+const AGENTS_ENV_YAW_OFFSET = -Math.PI * 0.1;+const ASCII_MOUSE_LERP_SPEED = 6;+const PAINT_MOVEMENT_GRACE_MS = 72;+const CANVAS_FADE_FALLBACK_MS = 800;+const CANVAS_REVEAL_RENDER_COUNT = 3;++type Renderer = {+ render: (+ target: GPUTextureView,+ controls: RenderControls,+ logicalWidth: number,+ logicalHeight: number,+ imprint?: ImprintRenderOptions,+ ) => void;+};++export function createDrawLoop({+ state,+ canvas,+ context,+ renderer,+ controlsRef,+ transitionDebug,+ modeTransitionProgressRef,+ targetLogoModeProgressRef,+ targetAgentsEnvYawMixRef,+ defaultMaterial,+ onCanvasRevealed,+ onFallback,+ onFatalError,+}: {+ state: HeroRuntimeState;+ canvas: HTMLCanvasElement;+ context: GPUCanvasContext;+ renderer: Renderer;+ controlsRef: ControlsRef;+ transitionDebug: EveTransitionDebugState;+ modeTransitionProgressRef: MutableRefObject<number>;+ targetLogoModeProgressRef: MutableRefObject<number>;+ targetAgentsEnvYawMixRef: MutableRefObject<number>;+ defaultMaterial: RenderControls["material"];+ onCanvasRevealed: () => void;+ onFallback: () => void;+ onFatalError: () => void;+}) {+ let successfulRenderCount = 0;+ let finishCanvasFade: (() => void) | undefined;++ const draw = (frameTime = performance.now()) => {+ if (state.cancelled) return;++ const deltaSeconds = Math.max(0, (frameTime - state.previousFrameTime) / 1000);+ state.previousFrameTime = frameTime;+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) {+ state.targetMouseEnvYaw = mobileAutoEnvYaw((frameTime - state.autoRotateStartTime) / 1000);+ state.targetMouseEnvPitch = 0;+ state.targetBrushActive = false;+ }+ state.mouseEnvYaw = safeLerp(+ state.mouseEnvYaw,+ state.targetMouseEnvYaw,+ deltaSeconds * ENV_YAW_LERP_SPEED,+ );+ state.mouseEnvPitch = safeLerp(+ state.mouseEnvPitch,+ state.targetMouseEnvPitch,+ deltaSeconds * ENV_YAW_LERP_SPEED,+ );+ state.asciiMouseX = safeLerp(+ state.asciiMouseX,+ state.targetAsciiMouseX,+ deltaSeconds * ASCII_MOUSE_LERP_SPEED,+ );+ state.asciiMouseY = safeLerp(+ state.asciiMouseY,+ state.targetAsciiMouseY,+ deltaSeconds * ASCII_MOUSE_LERP_SPEED,+ );+ state.brushActive = state.targetBrushActive && state.hasBrushCell;+ const targetAgentsEnvYawMix = targetAgentsEnvYawMixRef.current;+ state.agentsEnvYawMix = safeLerp(+ state.agentsEnvYawMix,+ targetAgentsEnvYawMix,+ deltaSeconds * AGENTS_ENV_YAW_LERP_SPEED,+ );+ controlsRef.current.envYaw = state.mouseEnvYaw + state.agentsEnvYawMix * AGENTS_ENV_YAW_OFFSET;+ controlsRef.current.envPitch = state.mouseEnvPitch;++ const devicePixelRatio = resizeCanvas(canvas);+ const { logicalWidth, logicalHeight } = getCanvasLogicalSize(canvas, devicePixelRatio);++ try {+ const transitionDurationSeconds = clampRange(transitionDebug.durationSeconds, 0.05, 2);+ modeTransitionProgressRef.current = stepLogoModeProgress(+ modeTransitionProgressRef.current,+ targetLogoModeProgressRef.current,+ deltaSeconds,+ transitionDurationSeconds,+ );+ const animatedMixProgress = easeLogoModeProgress(modeTransitionProgressRef.current);+ const mixProgress = transitionDebug.overrideEnabled+ ? clampUnit(transitionDebug.progress)+ : animatedMixProgress;+ const timeSeconds = frameTime / 1000;+ const gridScaleMultiplier = clampRange(transitionDebug.gridScaleMultiplier, 0.5, 2);+ state.paintGridScaleMultiplier = gridScaleMultiplier;+ controlsRef.current.material = transitionDebug.visualizePaintBuffer+ ? "paint-debug"+ : defaultMaterial;+ const brushPreviousCell: readonly [number, number] = state.hasRenderedBrushCell+ ? [state.previousRenderedBrushCellX, state.previousRenderedBrushCellY]+ : [state.brushCellX, state.brushCellY];+ const brushCanWrite =+ state.brushActive && frameTime - state.lastBrushMoveTime <= PAINT_MOVEMENT_GRACE_MS;+ renderer.render(+ context.getCurrentTexture().createView(),+ controlsRef.current,+ logicalWidth,+ logicalHeight,+ {+ progress: mixProgress,+ gridScaleMultiplier,+ glyphScale: clampRange(transitionDebug.glyphScale, 0.5, 2.5),+ time: timeSeconds,+ mouse: [state.asciiMouseX, state.asciiMouseY],+ devicePixelRatio,+ paint: {+ // rAF timestamps are ms; deltaSeconds is converted once above and all paint+ // decay/diffusion/brush math expects seconds. Brush cells are raw pointer cells+ // (no lerp); the shader stamps the segment from previous rendered cell to current.+ dt: deltaSeconds,+ brushCell: [state.brushCellX, state.brushCellY],+ brushPreviousCell,+ brushRadius: clampRange(transitionDebug.brushRadius, 1, 8),+ brushStrength: clampRange(transitionDebug.brushStrength, 4, 32),+ brushActive: brushCanWrite,+ decayRate: clampRange(transitionDebug.paintDecayPerFrame120, 0.002, 0.08) * 120,+ diffusionRate: clampRange(transitionDebug.diffusionAmount, 0, 24),+ diffusionJitter: clampRange(transitionDebug.diffusionJitter, 0, 4),+ },+ },+ );++ if (state.hasBrushCell) {+ state.previousRenderedBrushCellX = state.brushCellX;+ state.previousRenderedBrushCellY = state.brushCellY;+ state.hasRenderedBrushCell = true;+ }++ canvas.dataset.eveRenderMode = mixProgress >= 0.5 ? "agents" : "humans";+ canvas.dataset.eveAsciiProgress = mixProgress.toFixed(3);+ canvas.dataset.eveAsciiMode = mixProgress > 0.001 ? "active" : "inactive";+ } catch {+ state.cancelled = true;+ onFallback();+ onFatalError();+ return;+ }++ successfulRenderCount += 1;+ if (successfulRenderCount === CANVAS_REVEAL_RENDER_COUNT) {+ canvas.style.opacity = "1";+ finishCanvasFade = onCanvasFullyOpaque(canvas, onCanvasRevealed);+ }++ state.animationFrame = requestAnimationFrame(draw);+ };++ return {+ draw,+ dispose() {+ cancelAnimationFrame(state.animationFrame);+ finishCanvasFade?.();+ },+ };+}++function safeLerp(from: number, to: number, amount: number) {+ const safeAmount = Math.max(0, Math.min(1, amount));+ return from + (to - from) * safeAmount;+}++function clampUnit(value: number) {+ return clampRange(value, 0, 1);+}++function clampRange(value: number, min: number, max: number) {+ return Math.max(min, Math.min(max, value));+}++function stepLogoModeProgress(+ current: number,+ target: number,+ deltaSeconds: number,+ durationSeconds: number,+) {+ const safeTarget = target >= 0.5 ? 1 : 0;+ const safeDuration = clampRange(durationSeconds, 0.05, 2);+ const step = Math.max(0, deltaSeconds) / safeDuration;+ if (Math.abs(safeTarget - current) <= step) return safeTarget;+ return current + Math.sign(safeTarget - current) * step;+}++function easeLogoModeProgress(progress: number) {+ const t = Math.max(0, Math.min(1, progress));+ return t * t * (3 - 2 * t);+}++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;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.tsnew file mode 100644index 000000000..ae2210b9f--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/load-mesh.ts@@ -0,0 +1,24 @@+import { decodeGltfMesh } from "../mesh";++// Owns browser glTF fetch/decode for the Eve logo mesh.+// INVARIANT: no-store fetch behavior is preserved for HMR/content updates.+// Imported only by index.tsx startup.++export const MODEL_URL = "/eve-5/eve-logo.gltf";++export async function loadMesh() {+ const response = await fetch(MODEL_URL, { cache: "no-store" });+ if (!response.ok) throw new Error(`Failed to load ${MODEL_URL}: ${response.status}`);+ return decodeGltfMesh(await response.json(), (uri) => loadGltfBuffer(uri, MODEL_URL));+}++async function loadGltfBuffer(uri: string, modelUrl: string) {+ if (uri.startsWith("data:application/octet-stream;base64,")) {+ return Uint8Array.from(atob(uri.split(",")[1]!), (char) => char.charCodeAt(0)).buffer;+ }+ const url = new URL(uri, window.location.origin + modelUrl);+ const response = await fetch(url, { cache: "no-store" });+ if (!response.ok)+ throw new Error(`Failed to load glTF buffer ${url.pathname}: ${response.status}`);+ return response.arrayBuffer();+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.tsnew file mode 100644index 000000000..25baf9d78--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/pointer-input.ts@@ -0,0 +1,132 @@+import type { RefObject } from "react";+import { evePointerInteractionMode } from "../mobile-motion";+import { bloomRadiusForDevicePixelRatio, mapClientPointToPaintCell } from "../render";+import { getBrowserDevicePixelRatio } from "./canvas-sizing";+import type { ControlsRef, HeroRuntimeState } from "./state";++// Owns browser pointer input for env yaw and paint brush updates.+// INVARIANT: coarse-pointer mode disables paint and switches to env auto-rotate.+// Imported only by index.tsx's single effect.++const MAX_ENV_YAW = 0.3;+const MAX_ENV_PITCH = 0.2;+const PAINT_POINTER_MOVE_EPSILON_PX = 0.5;++export function createPointerController({+ state,+ controlsRef,+ canvasRef,+}: {+ state: HeroRuntimeState;+ controlsRef: ControlsRef;+ canvasRef: RefObject<HTMLCanvasElement | null>;+}) {+ const coarsePointerQuery = window.matchMedia("(pointer: coarse)");+ const syncPointerInteractionMode = () => {+ state.isCoarsePointer = coarsePointerQuery.matches;+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) {+ state.targetBrushActive = false;+ state.targetMouseEnvPitch = 0;+ state.targetAsciiMouseX = 0;+ state.targetAsciiMouseY = 0;+ state.autoRotateStartTime = performance.now();+ }+ };++ const updateEnvRotation = (clientX: number, clientY: number) => {+ if (evePointerInteractionMode(state.isCoarsePointer).autoRotateEnvYaw) return;+ const viewportWidth = Math.max(1, window.innerWidth || 1);+ const viewportHeight = Math.max(1, window.innerHeight || 1);+ const clampedX = Math.max(0, Math.min(viewportWidth, clientX));+ const clampedY = Math.max(0, Math.min(viewportHeight, clientY));+ const normalizedX = (clampedX / viewportWidth) * 2 - 1;+ const normalizedY = (clampedY / viewportHeight) * 2 - 1;+ state.targetMouseEnvYaw = normalizedX * MAX_ENV_YAW;+ state.targetMouseEnvPitch = normalizedY * MAX_ENV_PITCH;+ state.targetAsciiMouseX = normalizedX;+ state.targetAsciiMouseY = normalizedY;+ };++ const deactivateBrush = () => {+ state.targetBrushActive = false;+ state.hasBrushCell = false;+ state.hasRenderedBrushCell = false;+ state.lastPointerClientX = undefined;+ state.lastPointerClientY = undefined;+ state.lastBrushMoveTime = Number.NEGATIVE_INFINITY;+ };++ const updatePaintBrush = (event: PointerEvent) => {+ const canvas = canvasRef.current;+ const mesh = state.activeMesh;+ if (+ !canvas ||+ !mesh ||+ event.pointerType !== "mouse" ||+ !evePointerInteractionMode(state.isCoarsePointer).paintEnabled+ ) {+ deactivateBrush();+ return;+ }+ const devicePixelRatio = getBrowserDevicePixelRatio();+ const paddingRadius = bloomRadiusForDevicePixelRatio(devicePixelRatio);+ const logicalWidth = Math.max(1, canvas.width - paddingRadius * 2);+ const logicalHeight = Math.max(1, canvas.height - paddingRadius * 2);+ const mapping = mapClientPointToPaintCell({+ clientX: event.clientX,+ clientY: event.clientY,+ rect: canvas.getBoundingClientRect(),+ canvasWidth: canvas.width,+ canvasHeight: canvas.height,+ logicalWidth,+ logicalHeight,+ controls: controlsRef.current,+ meshBounds: mesh.bounds,+ gridScaleMultiplier: state.paintGridScaleMultiplier,+ paddingRadius,+ devicePixelRatio,+ });+ if (!mapping?.insideLogicalBounds) {+ deactivateBrush();+ return;+ }+ const nextBrushCellX = mapping.brushCell[0];+ const nextBrushCellY = mapping.brushCell[1];+ const pointerMoved =+ state.lastPointerClientX === undefined ||+ state.lastPointerClientY === undefined ||+ Math.hypot(+ event.clientX - state.lastPointerClientX,+ event.clientY - state.lastPointerClientY,+ ) >= PAINT_POINTER_MOVE_EPSILON_PX;+ if (pointerMoved) {+ state.lastBrushMoveTime = performance.now();+ }+ state.brushCellX = nextBrushCellX;+ state.brushCellY = nextBrushCellY;+ state.hasBrushCell = true;+ state.lastPointerClientX = event.clientX;+ state.lastPointerClientY = event.clientY;+ state.targetBrushActive = true;+ };++ const onPointerMove = (event: PointerEvent) => {+ updateEnvRotation(event.clientX, event.clientY);+ updatePaintBrush(event);+ };++ syncPointerInteractionMode();+ coarsePointerQuery.addEventListener("change", syncPointerInteractionMode);+ window.addEventListener("pointermove", onPointerMove, { passive: true });+ window.addEventListener("pointerout", deactivateBrush, { passive: true });+ window.addEventListener("blur", deactivateBrush);++ return {+ detach() {+ window.removeEventListener("pointermove", onPointerMove);+ window.removeEventListener("pointerout", deactivateBrush);+ window.removeEventListener("blur", deactivateBrush);+ coarsePointerQuery.removeEventListener("change", syncPointerInteractionMode);+ },+ };+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.ts b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.tsnew file mode 100644index 000000000..49996c9eb--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/runtime/state.ts@@ -0,0 +1,39 @@+import type { MutableRefObject } from "react";+import type { MeshData, RenderControls } from "../render";++// Owns the mutable fields shared by pointer input and the draw loop.+// INVARIANT: this remains one lifecycle state object owned by index.tsx's single effect.+// Imported only by runtime modules and index.tsx.++export type HeroRuntimeState = {+ cancelled: boolean;+ animationFrame: number;+ cleanup: (() => void) | undefined;+ mouseEnvYaw: number;+ targetMouseEnvYaw: number;+ mouseEnvPitch: number;+ targetMouseEnvPitch: number;+ asciiMouseX: number;+ asciiMouseY: number;+ targetAsciiMouseX: number;+ targetAsciiMouseY: number;+ brushCellX: number;+ brushCellY: number;+ previousRenderedBrushCellX: number;+ previousRenderedBrushCellY: number;+ hasBrushCell: boolean;+ hasRenderedBrushCell: boolean;+ brushActive: boolean;+ paintGridScaleMultiplier: number;+ targetBrushActive: boolean;+ activeMesh: MeshData | undefined;+ agentsEnvYawMix: number;+ previousFrameTime: number;+ autoRotateStartTime: number;+ lastBrushMoveTime: number;+ lastPointerClientX: number | undefined;+ lastPointerClientY: number | undefined;+ isCoarsePointer: boolean;+};++export type ControlsRef = MutableRefObject<RenderControls>;diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgslindex 86835615f..03ffe2295 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/blur.wgsl@@ -1,5 +1,7 @@+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";+// Bloom blur pass.-// Separable finite Gaussian blur; samples every integer texel in [-BLOOM_RADIUS, BLOOM_RADIUS]+// Separable finite Gaussian blur; samples every integer texel in the DPR-scaled radius// with no skipped pixels. Pass 0 extracts bright pixels and blurs horizontally. Pass 1 blurs// vertically from the horizontal result.@@ -12,27 +14,21 @@ struct BloomParams {direction: vec2f,extract: f32,threshold: f32,+ radius: f32,+ sigma: f32,};@group(0) @binding(0) var sourceTexture: texture_2d<f32>;@group(0) @binding(1) var sourceSampler: sampler;@group(0) @binding(2) var<uniform> params: BloomParams;-const BLOOM_RADIUS: i32 = 16;-const BLOOM_SIGMA: f32 = 5.3333335; // radius / 3.0; finite support reaches exactly 16px.+const MAX_BLOOM_RADIUS: i32 = 64;@vertexfn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {- var positions = array<vec2f, 3>(- vec2f(-1.0, -3.0),- vec2f(-1.0, 1.0),- vec2f(3.0, 1.0),- );-var output: VertexOutput;- let position = positions[vertexIndex];- output.position = vec4f(position, 0.0, 1.0);- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);+ output.position = fullscreen_clip_position(vertexIndex);+ output.uv = fullscreen_uv(vertexIndex);return output;}@@ -49,17 +45,21 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {var sum = vec3f(0.0);var weightSum = 0.0;- for (var i = -BLOOM_RADIUS; i <= BLOOM_RADIUS; i = i + 1) {- let fi = f32(i);- let offsetUv = input.uv + params.direction * texel * fi;- let uv = clamp(offsetUv, vec2f(0.0), vec2f(1.0));- var color = textureSample(sourceTexture, sourceSampler, uv).rgb;- if (params.extract > 0.5) {- color = bright_pass(color);+ let radius = clamp(i32(round(params.radius)), 0, MAX_BLOOM_RADIUS);+ let sigma = max(params.sigma, 0.001);+ for (var i = -MAX_BLOOM_RADIUS; i <= MAX_BLOOM_RADIUS; i = i + 1) {+ if (abs(i) <= radius) {+ let fi = f32(i);+ let offsetUv = input.uv + params.direction * texel * fi;+ let uv = clamp(offsetUv, vec2f(0.0), vec2f(1.0));+ var color = textureSample(sourceTexture, sourceSampler, uv).rgb;+ if (params.extract > 0.5) {+ color = bright_pass(color);+ }+ let weight = exp(-(fi * fi) / (2.0 * sigma * sigma));+ sum += color * weight;+ weightSum += weight;}- let weight = exp(-(fi * fi) / (2.0 * BLOOM_SIGMA * BLOOM_SIGMA));- sum += color * weight;- weightSum += weight;}return vec4f(sum / max(weightSum, 1e-5), 1.0);diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgslindex bb0f6367e..71629ad90 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/bloom/composite.wgsl@@ -1,3 +1,6 @@+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";+import { aces_tonemap, linear_to_display } from "../shared/tonemap.wgsl";+// Bloom composite pass. Adds finite-radius blurred bloom in linear HDR, then tonemaps once.struct VertexOutput {@@ -17,37 +20,16 @@ struct CompositeParams {@group(0) @binding(2) var texSampler: sampler;@group(0) @binding(3) var<uniform> params: CompositeParams;-const DISPLAY_GAMMA = 2.2;const BLOOM_RADIAL_FULL_RADIUS = 0.55;@vertexfn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {- var positions = array<vec2f, 3>(- vec2f(-1.0, -3.0),- vec2f(-1.0, 1.0),- vec2f(3.0, 1.0),- );-var output: VertexOutput;- let position = positions[vertexIndex];- output.position = vec4f(position, 0.0, 1.0);- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);+ output.position = fullscreen_clip_position(vertexIndex);+ output.uv = fullscreen_uv(vertexIndex);return output;}-fn aces_tonemap(color: vec3f) -> vec3f {- let a = 2.51;- let b = 0.03;- let c = 2.43;- let d = 0.59;- let e = 0.14;- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));-}--fn linear_to_display(color: vec3f) -> vec3f {- return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));-}-@fragmentfn fs_main(input: VertexOutput) -> @location(0) vec4f {let scene = textureSample(sceneTexture, texSampler, input.uv).rgb;diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgslindex 58640a28c..fc40e86eb 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/cubemap/render.wgsl@@ -1,3 +1,5 @@+import { cube_dir } from "../shared/cube-face.wgsl";+const MAX_ENV_LIGHTS = 16u;struct EnvLight {@@ -39,27 +41,6 @@ fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {return output;}-fn cube_dir(face: f32, uv: vec2f) -> vec3f {- let p = uv * 2.0 - vec2f(1.0);- // WebGPU cube face order: +X, -X, +Y, -Y, +Z, -Z.- if (face < 0.5) {- return normalize(vec3f(1.0, -p.y, -p.x));- }- if (face < 1.5) {- return normalize(vec3f(-1.0, -p.y, p.x));- }- if (face < 2.5) {- return normalize(vec3f(p.x, 1.0, p.y));- }- if (face < 3.5) {- return normalize(vec3f(p.x, -1.0, -p.y));- }- if (face < 4.5) {- return normalize(vec3f(p.x, -p.y, 1.0));- }- return normalize(vec3f(-p.x, -p.y, -1.0));-}-fn spot(dir: vec3f, center: vec3f, radius: f32, softness: f32, luminance: f32, color: vec3f, intensity: f32) -> vec3f {let d = distance(normalize(dir), normalize(center));let soft = clamp(softness, 0.0, 1.0);diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgslindex d2f1be41d..7da044709 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/env/background.wgsl@@ -1,27 +1,9 @@-import { sample_env } from "../shared/cube-sample.wgsl";+import { sample_env } from "../shared/env-sample.wgsl";+import { Params } from "../shared/scene-params.wgsl";// Environment background pass for eve-5.// Draws the fixed-world studio HDR cubemap from the same true orbit camera as the logo.-struct Params {- viewProj: mat4x4f,- cameraPos: vec3f,- passKind: f32,- cameraRight: vec3f,- fov: f32,- cameraUp: vec3f,- aspect: f32,- cameraForward: vec3f,- materialKind: f32,- thicknessScale: f32,- envYaw: f32,- envPitch: f32,- glassAbsorption: f32,- // Match the shared glass Params layout because this pass receives the same buffer.- ascii0: vec4f,- ascii1: vec4f,-};-struct VertexOutput {@builtin(position) clipPosition: vec4f,@location(0) ndc: vec2f,diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgslnew file mode 100644index 000000000..b1e06868b--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/ascii-composite.wgsl@@ -0,0 +1,66 @@+import { HOVER_OVERLAY_SCALE } from "../shared/ascii-imprint.wgsl";++// Scalar ASCII opacity and premultiplied composition helpers for front glass.+// INVARIANT: fwidth/coverage construction stays in ascii-imprint/front entry flow, not here.+// This module declares no bindings and performs no texture reads.++const IMPRINT_EMISSIVE = vec3f(2.5);+const PAINT_EMISSIVE_BOOST = 0.5;+const PAINT_DARKEN_GAMMA = 1.2;+const PAINT_FADE_BYPASS = 0.85;+const GLASS_HOVER_ALPHA_GAIN = 2.75;+const GLASS_HOVER_ALPHA_FLOOR = 0.25;+const ASCII_OPACITY_BOTTOM_Y = 0.;+const ASCII_OPACITY_TOP_Y = 0.3;+const ASCII_OPACITY_BOTTOM_LIGHT = 0.3;+const ASCII_OPACITY_BOTTOM_DARK = 0.1;+const ASCII_OPACITY_TOP = 1.0;+const ASCII_OPACITY_CURVE_POWER = 2.0;++export fn ascii_vertical_opacity(modelY: f32, themeT: f32) -> f32 {+ let verticalT = clamp(+ (modelY - ASCII_OPACITY_BOTTOM_Y) / (ASCII_OPACITY_TOP_Y - ASCII_OPACITY_BOTTOM_Y),+ 0.0,+ 1.0,+ );+ let verticalCurve = pow(verticalT, ASCII_OPACITY_CURVE_POWER);+ let asciiOpacityBottom = mix(ASCII_OPACITY_BOTTOM_LIGHT, ASCII_OPACITY_BOTTOM_DARK, themeT);+ return mix(asciiOpacityBottom, ASCII_OPACITY_TOP, verticalCurve);+}++export fn ascii_theme_coverage(glyphCoverage: f32, paintValue: f32, themeT: f32) -> f32 {+ let lightCoverage = pow(+ clamp(glyphCoverage, 0.0, 1.0),+ 1.0 / (1.0 + PAINT_DARKEN_GAMMA * paintValue),+ );+ return mix(lightCoverage, glyphCoverage, themeT);+}++export fn ascii_coverage_with_opacity(glyphCoverage: f32, asciiOpacity: f32, paintValue: f32, themeT: f32) -> f32 {+ // Paint bypasses most of the vertical fade, boosts light-theme density by lowering+ // coverage gamma. The coverage is still premultiplied-safe alpha coverage; the glass+ // color itself is not paint-faded.+ let scaledPaint = paintValue * HOVER_OVERLAY_SCALE;+ let opacity = mix(asciiOpacity, 1.0, PAINT_FADE_BYPASS * scaledPaint);+ return ascii_theme_coverage(glyphCoverage, scaledPaint, themeT) * opacity;+}++export fn ascii_final_composite(glass: vec4f, glassVisibility: f32, coverage: f32, themeT: f32, paintValue: f32) -> vec4f {+ // Fade the normal front-glass/env/back-blur contribution out only as the regular imprint+ // progresses. Paint overlays ASCII on top of intact glass at imprintProgress=0.+ let fadedGlassAlpha = glass.a * glassVisibility;+ let fadedGlassContribution = glass.rgb * fadedGlassAlpha;+ let scaledPaint = paintValue * HOVER_OVERLAY_SCALE;+ let imprintColor = IMPRINT_EMISSIVE * themeT * (1.0 + PAINT_EMISSIVE_BOOST * scaledPaint);+ // Glass-only hover mode (imprintProgress=0) wants translucent white emission that follows+ // the glass alpha and never exceeds 0.8. glassVisibility is 1 when the imprint is fully off.+ let glassHoverStrength = max(fadedGlassAlpha * GLASS_HOVER_ALPHA_GAIN, GLASS_HOVER_ALPHA_FLOOR);+ let glassHoverAlpha = clamp(glassHoverStrength * coverage, 0.0, 0.8);+ let glassHoverColor = vec3f(1.0) * glassHoverAlpha;+ let glassMode = step(0.999, glassVisibility);+ let asciiAlpha = mix(coverage, glassHoverAlpha, glassMode);+ let asciiColor = mix(imprintColor, glassHoverColor, glassMode);+ let aNew = mix(fadedGlassAlpha, 1.0, asciiAlpha);+ let desired = mix(fadedGlassContribution, asciiColor, asciiAlpha);+ return vec4f(desired / max(aNew, 0.001), aNew);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgslindex d6e73e064..5d9d70b4b 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-depth.wgsl@@ -1,4 +1,5 @@-import { Params, VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";+import { Params } from "../shared/scene-params.wgsl";+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";@group(0) @binding(0) var<uniform> params: Params;diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgslnew file mode 100644index 000000000..5fa99ecb1--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back-refraction.wgsl@@ -0,0 +1,85 @@+// Back-surface refraction helpers for the front glass entry shader.+// INVARIANT: texture/sampler resources are passed as parameters; this module declares no bindings.+// INVARIANT: fallback 1x1 back-depth texture means zero thickness and disables blur.++const VOGEL_SAMPLE_COUNT = 16u;+const GOLDEN_ANGLE = 2.399963229728653;+const MAX_BACK_BLUR_RADIUS_UV = 0.01;+const BACK_BLUR_SIGMA = 0.4;+const BACK_MIN_TRANSMISSION = 0.38;+const BACK_ABSORPTION_TINT = vec3f(0.9);+const TAU = 6.28318530718;++export fn hash12(p: vec2f) -> f32 {+ let h = dot(p, vec2f(127.1, 311.7));+ return fract(sin(h) * 43758.5453123);+}++export fn normalized_thickness(+ backDepthTexture: texture_2d<f32>,+ cameraAxisDepth: f32,+ thicknessScale: f32,+ pixel: vec2i,+ backSize: vec2i,+) -> f32 {+ // A 1x1 back-depth texture is the fallback used by renderers that have not produced a real+ // back depth map. Treat it as zero thickness so the blur remains disabled there.+ if (backSize.x <= 1 || backSize.y <= 1 || !all(pixel >= vec2i(0)) || !all(pixel < backSize)) {+ return 0.0;+ }++ let backCameraAxisDepth = textureLoad(backDepthTexture, pixel, 0).r;+ let thickness = max(backCameraAxisDepth - cameraAxisDepth, 0.0);+ return clamp(thickness / max(thicknessScale, 0.000001), 0.0, 1.0);+}++fn vogel_gaussian_blur(+ backMaterialTexture: texture_2d<f32>,+ backSampler: sampler,+ uv: vec2f,+ blurRadius: f32,+ baseRotation: f32,+) -> vec3f {+ var color = vec3f(0.0);+ var totalWeight = 0.0;++ for (var i = 0u; i < VOGEL_SAMPLE_COUNT; i = i + 1u) {+ let fi = f32(i);+ let vogelRadius = sqrt((fi + 0.5) / f32(VOGEL_SAMPLE_COUNT));+ let theta = fi * GOLDEN_ANGLE + baseRotation;+ let sampleUv = uv + vec2f(cos(theta), sin(theta)) * vogelRadius * blurRadius;+ let sigma = max(BACK_BLUR_SIGMA, 0.0001);+ let weight = exp(-(vogelRadius * vogelRadius) / (2.0 * sigma * sigma));+ color += textureSampleLevel(backMaterialTexture, backSampler, sampleUv, 0.0).rgb * weight;+ totalWeight += weight;+ }++ return color / max(totalWeight, 0.0001);+}++export fn blurred_back_contribution(+ backMaterialTexture: texture_2d<f32>,+ backDepthTexture: texture_2d<f32>,+ backSampler: sampler,+ uv: vec2f,+ pixel: vec2i,+ cameraAxisDepth: f32,+ thicknessScale: f32,+ glassAbsorption: f32,+) -> vec3f {+ let normalizedThickness = normalized_thickness(+ backDepthTexture,+ cameraAxisDepth,+ thicknessScale,+ pixel,+ vec2i(textureDimensions(backDepthTexture)),+ );+ let blurRadius = normalizedThickness * MAX_BACK_BLUR_RADIUS_UV;+ let baseVogelRotation = hash12(uv) * TAU;+ let blurredBackContribution = vogel_gaussian_blur(backMaterialTexture, backSampler, uv, blurRadius, baseVogelRotation);+ let thicknessFade = pow(clamp(normalizedThickness, 0.0, 1.0), 0.5);+ let absorptionFade = thicknessFade * glassAbsorption;+ let transmission = mix(1.0, BACK_MIN_TRANSMISSION, absorptionFade);+ let absorptionTint = mix(vec3f(1.0), BACK_ABSORPTION_TINT, absorptionFade);+ return blurredBackContribution * transmission * absorptionTint;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgslindex 466c7457b..b5fc0fd12 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/back.wgsl@@ -1,5 +1,6 @@import { oriented_normal, env_reflect_dir, env_reflection_from_dir, encode_normal } from "../shared/material-core.wgsl";-import { Params, VertexInput, VertexOutput, WIRE_PASS_THRESHOLD, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";+import { Params, WIRE_PASS_THRESHOLD } from "../shared/scene-params.wgsl";+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";import { shade_glass } from "../shared/glass-material.wgsl";@group(0) @binding(0) var<uniform> params: Params;diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgslindex 5e5eb13c8..026f8104e 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/front.wgsl@@ -1,65 +1,23 @@import { oriented_normal, env_reflect_dir, env_reflection_from_dir, encode_normal } from "../shared/material-core.wgsl";-import { Params, VertexInput, VertexOutput, WIRE_PASS_THRESHOLD, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-common.wgsl";+import { Params, WIRE_PASS_THRESHOLD } from "../shared/scene-params.wgsl";+import { VertexInput, VertexOutput, glass_vs_main, is_back_facing_to_camera } from "../shared/glass-vertex.wgsl";import { shade_glass } from "../shared/glass-material.wgsl";import { ascii_imprint_coverage } from "../shared/ascii-imprint.wgsl";+import { normalized_thickness, blurred_back_contribution } from "./back-refraction.wgsl";+import { sample_paint, sample_ascii_voronoi } from "./paint-read.wgsl";+import { ascii_vertical_opacity, ascii_coverage_with_opacity, ascii_final_composite } from "./ascii-composite.wgsl";@group(0) @binding(0) var<uniform> params: Params;@group(0) @binding(1) var studioCube: texture_2d_array<f32>;@group(0) @binding(2) var studioSampler: sampler;@group(0) @binding(3) var backMaterial: texture_2d<f32>;@group(0) @binding(4) var backDepth: texture_2d<f32>;+@group(0) @binding(5) var paintTex: texture_2d<f32>;+@group(0) @binding(6) var asciiVoronoiValueTex: texture_2d<f32>;+@group(0) @binding(7) var asciiVoronoiEdgeTex: texture_2d<f32>;-const VOGEL_SAMPLE_COUNT = 16u;-const GOLDEN_ANGLE = 2.399963229728653;-const MAX_BACK_BLUR_RADIUS_UV = 0.01;-const BACK_BLUR_SIGMA = 0.4;-const BACK_MIN_TRANSMISSION = 0.38;-const BACK_ABSORPTION_TINT = vec3f(0.9);-const TAU = 6.28318530718;const FRONT_GATE_START = 0.55;const FRONT_GATE_FULL = 0.80;-const IMPRINT_EMISSIVE = vec3f(2.5);-const ASCII_OPACITY_BOTTOM_Y = 0.;-const ASCII_OPACITY_TOP_Y = 0.3;-const ASCII_OPACITY_BOTTOM_LIGHT = 0.3;-const ASCII_OPACITY_BOTTOM_DARK = 0.1;-const ASCII_OPACITY_TOP = 1.0;-const ASCII_OPACITY_CURVE_POWER = 2.0;--fn hash12(p: vec2f) -> f32 {- let h = dot(p, vec2f(127.1, 311.7));- return fract(sin(h) * 43758.5453123);-}--fn normalized_thickness(input: VertexOutput, pixel: vec2i, backSize: vec2i) -> f32 {- // A 1x1 back-depth texture is the fallback used by renderers that have not produced a real- // back depth map. Treat it as zero thickness so the blur remains disabled there.- if (backSize.x <= 1 || backSize.y <= 1 || !all(pixel >= vec2i(0)) || !all(pixel < backSize)) {- return 0.0;- }-- let backCameraAxisDepth = textureLoad(backDepth, pixel, 0).r;- let thickness = max(backCameraAxisDepth - input.cameraAxisDepth, 0.0);- return clamp(thickness / max(params.thicknessScale, 0.000001), 0.0, 1.0);-}--fn vogel_gaussian_blur(uv: vec2f, blurRadius: f32, baseRotation: f32) -> vec3f {- var color = vec3f(0.0);- var totalWeight = 0.0;-- for (var i = 0u; i < VOGEL_SAMPLE_COUNT; i = i + 1u) {- let fi = f32(i);- let vogelRadius = sqrt((fi + 0.5) / f32(VOGEL_SAMPLE_COUNT));- let theta = fi * GOLDEN_ANGLE + baseRotation;- let sampleUv = uv + vec2f(cos(theta), sin(theta)) * vogelRadius * blurRadius;- let sigma = max(BACK_BLUR_SIGMA, 0.0001);- let weight = exp(-(vogelRadius * vogelRadius) / (2.0 * sigma * sigma));- color += textureSampleLevel(backMaterial, studioSampler, sampleUv, 0.0).rgb * weight;- totalWeight += weight;- }-- return color / max(totalWeight, 0.0001);-}@vertexfn vs_main(input: VertexInput) -> VertexOutput {@@ -89,7 +47,7 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {case 4u: {let backSize = vec2i(textureDimensions(backDepth));let pixel = vec2i(input.clipPosition.xy);- let normalizedThickness = normalized_thickness(input, pixel, backSize);+ let normalizedThickness = normalized_thickness(backDepth, input.cameraAxisDepth, params.thicknessScale, pixel, backSize);return vec4f(vec3f(normalizedThickness), 1.0);}case 1u: {@@ -107,53 +65,48 @@ fn fs_main(input: VertexOutput) -> @location(0) vec4f {let pixel = vec2i(input.clipPosition.xy);if (all(pixel >= vec2i(0)) && all(pixel < backSize)) {let uv = (vec2f(pixel) + vec2f(0.5)) / vec2f(backSize);- let normalizedThickness = normalized_thickness(input, pixel, vec2i(textureDimensions(backDepth)));- let blurRadius = normalizedThickness * MAX_BACK_BLUR_RADIUS_UV;- let baseVogelRotation = hash12(uv) * TAU;- let blurredBackContribution = vogel_gaussian_blur(uv, blurRadius, baseVogelRotation);- let thicknessFade = pow(clamp(normalizedThickness, 0.0, 1.0), 0.5);- let absorptionFade = thicknessFade * params.glassAbsorption;- let transmission = mix(1.0, BACK_MIN_TRANSMISSION, absorptionFade);- let absorptionTint = mix(vec3f(1.0), BACK_ABSORPTION_TINT, absorptionFade);- let backContribution = blurredBackContribution * transmission * absorptionTint;+ let backContribution = blurred_back_contribution(+ backMaterial,+ backDepth,+ studioSampler,+ uv,+ pixel,+ input.cameraAxisDepth,+ params.thicknessScale,+ params.glassAbsorption,+ );// The main scene uses additive alpha blending (`src-alpha + one`). The offscreen back// texture already contains the blended back-side contribution, so divide by the front// alpha before returning to preserve the previous two-draw visual result.glass = vec4f(glass.rgb + backContribution / max(glass.a, 0.001), glass.a);}- if (params.ascii0.x <= 0.0) {- return glass;- }-+ // Order: read paint -> build glyph coverage -> apply theme/fade/luminance -> composite.+ // Paint never reveals the noisy base ASCII chain; ascii_imprint_coverage gates that by+ // imprintProgress and adds a separate clean hover-station coverage for paint.+ let paintValue = clamp(sample_paint(paintTex, input.modelPos.xy, params.ascii0.y, params.ascii1.zw), 0.0, 1.0);let imprintProgress = clamp(params.ascii0.x, 0.0, 1.0);let glassVisibility = 1.0 - imprintProgress;let frontMask = smoothstep(FRONT_GATE_START, FRONT_GATE_FULL, ngeo.z);- let verticalT = clamp(- (input.modelPos.y - ASCII_OPACITY_BOTTOM_Y) / (ASCII_OPACITY_TOP_Y - ASCII_OPACITY_BOTTOM_Y),- 0.0,- 1.0,- );- let verticalCurve = pow(verticalT, ASCII_OPACITY_CURVE_POWER);let themeT = clamp(params.glassAbsorption, 0.0, 1.0);- let asciiOpacityBottom = mix(ASCII_OPACITY_BOTTOM_LIGHT, ASCII_OPACITY_BOTTOM_DARK, themeT);- let asciiOpacity = mix(asciiOpacityBottom, ASCII_OPACITY_TOP, verticalCurve);- let coverage = ascii_imprint_coverage(+ let asciiOpacity = ascii_vertical_opacity(input.modelPos.y, themeT);+ let glyphCoverage = ascii_imprint_coverage(input.modelPos.xy,params.ascii0.y,params.ascii0.z,params.ascii0.w,params.ascii1.xy,imprintProgress,- ) * frontMask * asciiOpacity;- // Fade the normal front-glass/env/back-blur contribution out as ASCII takes over.- // ASCII coverage itself is not faded by this visibility term, so at p=1 only the- // emissive imprint remains while non-ASCII glass becomes transparent.- let fadedGlassAlpha = glass.a * glassVisibility;- let fadedGlassContribution = glass.rgb * fadedGlassAlpha;- let imprintColor = IMPRINT_EMISSIVE * clamp(params.glassAbsorption, 0.0, 1.0);- let aNew = mix(fadedGlassAlpha, 1.0, coverage);- let desired = mix(fadedGlassContribution, imprintColor, coverage);- return vec4f(desired / max(aNew, 0.001), aNew);+ paintValue,+ sample_ascii_voronoi(asciiVoronoiValueTex, asciiVoronoiEdgeTex, input.modelPos.xy, params.ascii0.y, params.ascii0.w, params.ascii1.zw),+ ) * frontMask;+ // Paint bypasses most of the vertical fade, boosts light-theme density by lowering+ // coverage gamma, and boosts dark-theme HDR emissive below. `coverage` is still+ // premultiplied-safe alpha coverage; the glass color itself is not paint-faded.+ let coverage = ascii_coverage_with_opacity(glyphCoverage, asciiOpacity, paintValue, themeT);+ if (params.ascii0.x <= 0.0 && paintValue <= 0.0) {+ return glass;+ }+ return ascii_final_composite(glass, glassVisibility, coverage, themeT, paintValue);}}}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgslnew file mode 100644index 000000000..0a7cc5508--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/glass/paint-read.wgsl@@ -0,0 +1,49 @@+import { ascii_voronoi_noise_for_cell } from "../shared/ascii-imprint.wgsl";++// Paint and animated Voronoi texture readers for the front glass entry shader.+// INVARIANT: r32float textures are sampled with textureLoad only; no filtering.+// Texture resources are passed as parameters; this module declares no bindings.++export fn model_cell_index(modelPosXY: vec2f, gridScale: f32, originCellValue: vec2f) -> vec2i {+ let originCell = vec2i(i32(originCellValue.x), i32(originCellValue.y));+ return vec2i(floor(modelPosXY * gridScale)) - originCell;+}++export fn sample_paint(+ paintTexture: texture_2d<f32>,+ modelPosXY: vec2f,+ gridScale: f32,+ originCellValue: vec2f,+) -> f32 {+ // Front pass reads the paint buffer by ASCII cell with textureLoad only.+ // Renderer stores the negative-bound origin in ascii1.zw so writer/reader use+ // identical model-space -> cell mapping, including cells left/below model zero.+ let dims = vec2i(textureDimensions(paintTexture));+ let cell = model_cell_index(modelPosXY, gridScale, originCellValue);+ if (any(cell < vec2i(0)) || any(cell >= dims)) {+ return 0.0;+ }+ return textureLoad(paintTexture, cell, 0).r;+}++export fn sample_ascii_voronoi(+ asciiVoronoiValueTexture: texture_2d<f32>,+ asciiVoronoiEdgeTexture: texture_2d<f32>,+ modelPosXY: vec2f,+ gridScale: f32,+ time: f32,+ originCellValue: vec2f,+) -> vec2f {+ // Voronoi noise is animated in z, so the renderer refreshes these two r32 textures once+ // per frame at the ASCII-cell lattice resolution. The coverage code still computes+ // derivatives for glyph edges procedurally; only the per-cell random value/edge mask moves.+ let dims = vec2i(textureDimensions(asciiVoronoiValueTexture));+ let cell = model_cell_index(modelPosXY, gridScale, originCellValue);+ if (any(cell < vec2i(0)) || any(cell >= dims)) {+ return ascii_voronoi_noise_for_cell(modelPosXY, gridScale, time);+ }+ return vec2f(+ textureLoad(asciiVoronoiValueTexture, cell, 0).r,+ textureLoad(asciiVoronoiEdgeTexture, cell, 0).r,+ );+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgslnew file mode 100644index 000000000..3a39804b1--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-debug.wgsl@@ -0,0 +1,26 @@+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";++struct VertexOutput {+ @builtin(position) position: vec4f,+ @location(0) uv: vec2f,+};++@group(0) @binding(0) var paintTex: texture_2d<f32>;++@vertex+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {+ var output: VertexOutput;+ output.position = fullscreen_clip_position(vertexIndex);+ output.uv = fullscreen_uv(vertexIndex);+ output.uv.y = 1. - output.uv.y;+ return output;+}++@fragment+fn fs_main(input: VertexOutput) -> @location(0) vec4f {+ let dims = vec2i(textureDimensions(paintTex));+ let uv = clamp(input.uv, vec2f(0.0), vec2f(0.999999));+ let coord = clamp(vec2i(floor(uv * vec2f(dims))), vec2i(0), dims - vec2i(1));+ let paint = textureLoad(paintTex, coord, 0).r;+ return vec4f(vec3f(clamp(paint, 0.0, 1.0)), 1.0);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgslnew file mode 100644index 000000000..dabb35345--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/paint-update.wgsl@@ -0,0 +1,106 @@+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";++struct VertexOutput {+ @builtin(position) position: vec4f,+ @location(0) uv: vec2f,+};++struct PaintParams {+ brushCell: vec2f,+ brushPreviousCell: vec2f,+ brushRadius: f32,+ brushStrength: f32,+ decayRate: f32,+ diffusionRate: f32,+ diffusionJitter: f32,+ dt: f32,+ brushActive: f32,+ _pad: f32,+};++@group(0) @binding(0) var readTex: texture_2d<f32>;+@group(0) @binding(1) var<uniform> params: PaintParams;+@group(0) @binding(2) var staticNoiseTex: texture_2d<f32>;++const TAU = 6.28318530718;+const BRUSH_EDGE_NOISE = 1.5;+const PAINT_VALUE_MAX = 2.0; // Stored paint max; values >1 give a hidden decay buffer while display clamps at 1.0.++@vertex+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {+ var output: VertexOutput;+ output.position = fullscreen_clip_position(vertexIndex);+ output.uv = fullscreen_uv(vertexIndex);+ return output;+}++fn load_cell(coord: vec2i, dims: vec2i) -> f32 {+ return textureLoad(readTex, clamp(coord, vec2i(0), dims - vec2i(1)), 0).r;+}++fn jittered_offset(axis: vec2f, angle: f32, scale: f32) -> vec2i {+ let c = cos(angle);+ let s = sin(angle);+ let rotated = vec2f(c * axis.x - s * axis.y, s * axis.x + c * axis.y) * scale;+ var offset = vec2i(round(rotated));+ if (all(offset == vec2i(0))) {+ offset = vec2i(select(-1, 1, axis.x + axis.y >= 0.0), 0);+ }+ return offset;+}++fn segment_distance(p: vec2f, a: vec2f, b: vec2f) -> f32 {+ let ab = b - a;+ let denom = max(dot(ab, ab), 0.000001);+ let t = clamp(dot(p - a, ab) / denom, 0.0, 1.0);+ return distance(p, a + ab * t);+}++@fragment+fn fs_main(input: VertexOutput) -> @location(0) f32 {+ let dims = vec2i(textureDimensions(readTex));+ let q = clamp(vec2i(input.position.xy), vec2i(0), dims - vec2i(1));++ let c = load_cell(q, dims);+ // Static per-cell hash rotates/scales the four taps, then snaps them to texels.+ // r32float is unfilterable here, so this stays textureLoad-only and preserves the+ // convex 5-tap update while making diffusion grow organically instead of as a disc.+ // Channel usage: r=angle hash, g=diffusion scale hash, b=brush-edge hash, a=decay multiplier.+ let staticNoise = textureLoad(staticNoiseTex, q, 0);+ let jitter = clamp(params.diffusionJitter, 0.0, 4.0);+ let angle = staticNoise.r * TAU;+ let scale = mix(1.0, 1.0 + jitter * 1., staticNoise.g);+ let o0 = jittered_offset(vec2f(1.0, 0.0), angle, scale);+ let o1 = jittered_offset(vec2f(-1.0, 0.0), angle, scale);+ let o2 = jittered_offset(vec2f(0.0, 1.0), angle, scale);+ let o3 = jittered_offset(vec2f(0.0, -1.0), angle, scale);+ let n0 = load_cell(q + o0, dims);+ let n1 = load_cell(q + o1, dims);+ let n2 = load_cell(q + o2, dims);+ let n3 = load_cell(q + o3, dims);+ // `dt` is seconds from rAF/renderer code, clamped to avoid giant hidden-tab steps.+ // TS exposes decay as "paint removed per frame at 120fps", then uploads+ // decayRate = decayPerFrame120 * 120, so the shader applies the equivalent+ // frame-rate-independent subtraction: decayThisFrame = decayRate * dt.+ let dt = min(max(params.dt, 0.0), 0.1);+ let diffusionWeight = min(max(params.diffusionRate, 0.0) * dt, 0.24);+ let diffused = (1.0 - 4.0 * diffusionWeight) * c + diffusionWeight * (n0 + n1 + n2 + n3);++ let cellCenter = vec2f(q) + vec2f(0.5);+ let radius = max(params.brushRadius, 0.0001);+ let segmentDistance = segment_distance(cellCenter, params.brushPreviousCell, params.brushCell);+ // Per-cell hash perturbs the capsule edge to keep brush stamps organic. The noise is static+ // per cell (free) so strokes stay stable frame-to-frame but lose the perfect capsule.+ let brushNoise = (staticNoise.b - 0.5) * BRUSH_EDGE_NOISE;+ let noisyDistance = clamp(segmentDistance + brushNoise, 0.0, radius + BRUSH_EDGE_NOISE);+ let brushFalloff = 1.0 - smoothstep(0.0, radius, noisyDistance);+ let brush = step(0.5, params.brushActive) * max(params.brushStrength, 0.0) * dt * brushFalloff;++ let decayMultiplier = mix(1.0, 2.0, staticNoise.a);+ let decayRate = max(params.decayRate, 0.0) * decayMultiplier;+ var outValue = clamp(diffused - decayRate * 0.2 * dt + brush, 0.0, PAINT_VALUE_MAX);+ if (outValue < 0.001) {+ outValue = 0.0;+ }+ return outValue;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgslnew file mode 100644index 000000000..ab1e4bb6a--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/paint/voronoi-noise-update.wgsl@@ -0,0 +1,52 @@+import { voronoi_cell_value_and_edge_3d } from "../shared/voronoi.wgsl";++struct VertexOutput {+ @builtin(position) position: vec4f,+};++struct VoronoiNoiseParams {+ gridScale: f32,+ time: f32,+ originCell: vec2f,+};++struct VoronoiNoiseOutput {+ @location(0) value: f32,+ @location(1) edge: f32,+};++@group(0) @binding(0) var<uniform> params: VoronoiNoiseParams;++const IMPRINT_VORONOI_FREQUENCY = 4.8;+const ASCII_VORONOI_Z_SPEED = 0.35;++@vertex+fn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {+ var positions = array<vec2f, 3>(+ vec2f(-1.0, -3.0),+ vec2f(-1.0, 1.0),+ vec2f(3.0, 1.0),+ );++ var output: VertexOutput;+ output.position = vec4f(positions[vertexIndex], 0.0, 1.0);+ return output;+}++@fragment+fn fs_main(input: VertexOutput) -> VoronoiNoiseOutput {+ let localCell = vec2i(input.position.xy);+ let globalCell = vec2f(localCell) + params.originCell;+ let safeGridScale = max(params.gridScale, 0.001);+ let cellCenter = (globalCell + vec2f(0.5)) / safeGridScale;+ let samplePosition = vec3f(+ cellCenter * IMPRINT_VORONOI_FREQUENCY,+ params.time * ASCII_VORONOI_Z_SPEED,+ );+ let voronoi = voronoi_cell_value_and_edge_3d(samplePosition);++ var output: VoronoiNoiseOutput;+ output.value = voronoi.x;+ output.edge = voronoi.y;+ return output;+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgslindex 89b84ac93..f05b8da83 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/postprocess/light-composite.wgsl@@ -1,3 +1,6 @@+import { fullscreen_clip_position, fullscreen_uv } from "../shared/fullscreen.wgsl";+import { aces_tonemap, linear_to_display } from "../shared/tonemap.wgsl";+// Light-mode composite pass. Tonemaps scene color and writes premultiplied alpha for a transparent canvas.struct VertexOutput {@@ -8,36 +11,15 @@ struct VertexOutput {@group(0) @binding(0) var sceneTexture: texture_2d<f32>;@group(0) @binding(1) var texSampler: sampler;-const DISPLAY_GAMMA = 2.2;@vertexfn vs_main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {- var positions = array<vec2f, 3>(- vec2f(-1.0, -3.0),- vec2f(-1.0, 1.0),- vec2f(3.0, 1.0),- );-var output: VertexOutput;- let position = positions[vertexIndex];- output.position = vec4f(position, 0.0, 1.0);- output.uv = position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);+ output.position = fullscreen_clip_position(vertexIndex);+ output.uv = fullscreen_uv(vertexIndex);return output;}-fn aces_tonemap(color: vec3f) -> vec3f {- let a = 2.51;- let b = 0.03;- let c = 2.43;- let d = 0.59;- let e = 0.14;- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));-}--fn linear_to_display(color: vec3f) -> vec3f {- return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));-}-@fragmentfn fs_main(input: VertexOutput) -> @location(0) vec4f {let scene = textureSample(sceneTexture, texSampler, input.uv);diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgslnew file mode 100644index 000000000..7f7a766b2--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-glyphs.wgsl@@ -0,0 +1,66 @@+import { sd_box, sd_equilateral_triangle, sd_rotated_box } from "./sdf.wgsl";++// Shared ASCII glyph selection and hover-station distances.+// INVARIANT: true SDF-value interpolation in hover_shape_distance is preserved.+// The caller owns fwidth/coverage so derivatives stay in uniform control flow.++export const ASCII_BASE_DOT_RADIUS = 0.075;+export const ASCII_EDGE_SQUARE_HALF_SIZE = 0.22;+export const HOVER_ENTRY_START = 0.1;+export const HOVER_ENTRY_FULL = 0.5;++export fn shape_distance(p: vec2f, value: f32) -> f32 {+ if (value < 0.002) {+ return 1.0;+ }+ // Voronoi luminance now selects the spinner glyph ramp (| / \ – — ▲). Keep glyph dimensions+ // fixed so size is controlled by grid geometry and glyphScale, not value. After the tiny+ // empty band the remaining range is divided into six equal hard-switch stations.+ let normalizedValue = clamp((value - 0.002) / (1.0 - 0.002), 0.0, 1.0);+ let station = clamp(i32(floor(normalizedValue * 6.0)), 0, 5);+ return spinner_station_distance(p, station);+}++fn spinner_station_distance(p: vec2f, station: i32) -> f32 {+ if (station <= 0) {+ return sd_rotated_box(p, vec2f(0.28, 0.05), 1.57079632679);+ }+ if (station == 1) {+ return sd_rotated_box(p, vec2f(0.28, 0.05), 0.78539816339);+ }+ if (station == 2) {+ return sd_rotated_box(p, vec2f(0.28, 0.05), -0.78539816339);+ }+ if (station == 3) {+ return sd_box(p, vec2f(0.20, 0.045));+ }+ if (station == 4) {+ return sd_box(p, vec2f(0.31, 0.055));+ }+ let scale = 0.66;+ return sd_equilateral_triangle(p / scale) * scale;+}++fn imprint_station_distance(p: vec2f, station: i32) -> f32 {+ if (station <= 0) {+ return length(p) - ASCII_BASE_DOT_RADIUS;+ }+ if (station == 1) {+ return length(p) - 0.145;+ }+ if (station == 2) {+ return sd_box(p, vec2f(0.27, 0.055));+ }+ if (station == 3) {+ return length(p) - 0.235;+ }+ return sd_box(p, vec2f(0.255, 0.255));+}++export fn hover_shape_distance(p: vec2f, hover: f32) -> f32 {+ // Paint drives only this clean station ramp: dot -> circle -> dash -> circle -> square.+ // Hard switch: each station covers an equal-length range; no blending between glyphs.+ let t = clamp((hover - HOVER_ENTRY_START) / (1.0 - HOVER_ENTRY_START), 0.0, 1.0);+ let station = clamp(i32(floor(t * 5.0)), 0, 4);+ return imprint_station_distance(p, station);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgslindex f9f77b02a..54f6961dc 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/ascii-imprint.wgsl@@ -1,158 +1,75 @@-export fn sd_box(p: vec2f, halfSize: vec2f) -> f32 {- let q = abs(p) - halfSize;- return length(max(q, vec2f(0.0))) + min(max(q.x, q.y), 0.0);-}--export fn sd_equilateral_triangle(p0: vec2f) -> f32 {- let k = sqrt(3.0);- var p = p0;- p.x = abs(p.x) - 0.42;- p.y = p.y + 0.24;- if (p.x + k * p.y > 0.0) {- p = vec2f(p.x - k * p.y, -k * p.x - p.y) / 2.0;- }- p.x = p.x - clamp(p.x, -0.84, 0.0);- return -length(p) * sign(p.y);-}--export fn hash_u32(value: u32) -> u32 {- var x = value;- x ^= x >> 16u;- x *= 0x7feb352du;- x ^= x >> 15u;- x *= 0x846ca68bu;- x ^= x >> 16u;- return x;-}--export fn hash3(cell: vec3i) -> f32 {- let ux = bitcast<u32>(cell.x);- let uy = bitcast<u32>(cell.y);- let uz = bitcast<u32>(cell.z);- let mixed = (ux * 0x8da6b343u) ^ (uy * 0xd8163841u) ^ (uz * 0xcb1ab31fu);- return f32(hash_u32(mixed) & 0x00ffffffu) / 16777215.0;-}+import { sd_box } from "./sdf.wgsl";+import { hash3, voronoi_cell_value_and_edge_3d } from "./voronoi.wgsl";+import { ASCII_BASE_DOT_RADIUS, ASCII_EDGE_SQUARE_HALF_SIZE, HOVER_ENTRY_START, HOVER_ENTRY_FULL, shape_distance, hover_shape_distance } from "./ascii-glyphs.wgsl";-fn hash3_feature_point(cell: vec3i) -> vec3f {- return vec3f(- hash3(cell + vec3i(17, 59, 113)),- hash3(cell + vec3i(101, 191, 53)),- hash3(cell + vec3i(47, 223, 149)),- );-}--const VORONOI_EDGE_WIDTH = 0.08;-const VORONOI_EDGE_SOFTNESS = 0.04;--export fn voronoi_cell_value_and_edge_3d(p: vec3f) -> vec2f {- let baseCell = vec3i(floor(p));- let localPosition = fract(p);- var nearestDistanceSquared = 1000.0;- var secondNearestDistanceSquared = 1000.0;- var winningCell = baseCell;-- for (var z = -1; z <= 1; z = z + 1) {- for (var y = -1; y <= 1; y = y + 1) {- for (var x = -1; x <= 1; x = x + 1) {- let neighborOffset = vec3i(x, y, z);- let neighborCell = baseCell + neighborOffset;- let featurePoint = vec3f(neighborOffset) + hash3_feature_point(neighborCell);- let delta = featurePoint - localPosition;- let distanceSquared = dot(delta, delta);- if (distanceSquared < nearestDistanceSquared) {- secondNearestDistanceSquared = nearestDistanceSquared;- nearestDistanceSquared = distanceSquared;- winningCell = neighborCell;- } else if (distanceSquared < secondNearestDistanceSquared) {- secondNearestDistanceSquared = distanceSquared;- }- }- }- }-- // Hard-cell Voronoi: the nearest feature cell gets one random value for glyph type.- // The F2-F1 gap controls a pure-white edge overlay, while interiors keep the full- // random-selected glyph instead of being masked away.- let cellValue = hash3(winningCell + vec3i(211, 37, 173));- let edgeGap = sqrt(secondNearestDistanceSquared) - sqrt(nearestDistanceSquared);- let edgeMask = 1.0 - smoothstep(VORONOI_EDGE_WIDTH, VORONOI_EDGE_WIDTH + VORONOI_EDGE_SOFTNESS, edgeGap);- return vec2f(cellValue, edgeMask);-}+// ASCII imprint combiner for front-glass coverage.+// INVARIANT: fwidth calls stay in this function's uniform control flow; do not move them behind non-uniform branches.+// Entry shaders provide textures/bindings and material masks; this module declares none.-const ASCII_BASE_DOT_RADIUS = 0.075;-const ASCII_EDGE_SQUARE_HALF_SIZE = 0.22;--export fn shape_distance(p: vec2f, value: f32) -> f32 {- if (value < 0.002) {- return 1.0;- }- // Luminance/noise selects the glyph only. Keep each glyph's dimensions fixed so- // glyph size is controlled by grid geometry and the glyphScale uniform, not value.- if (value < 0.18) {- return length(p) - ASCII_BASE_DOT_RADIUS;- }- if (value < 0.36) {- return length(p) - 0.145;- }- if (value < 0.58) {- return sd_box(p, vec2f(0.27, 0.055));- }- if (value < 0.78) {- return length(p) - 0.235;- }- if (value < 0.93) {- let scale = 0.66;- return sd_equilateral_triangle(p / scale) * scale;- }- return sd_box(p, vec2f(0.255, 0.255));-}--const IMPRINT_VORONOI_FREQUENCY = 2.4;+const IMPRINT_VORONOI_FREQUENCY = 4.8;const ASCII_VORONOI_Z_SPEED = 0.35;const REVEAL_STAGGER_WINDOW = 0.25;+export const HOVER_OVERLAY_SCALE = 0.5; // scales hover spinner-glyph opacity only++export fn ascii_voronoi_noise_for_cell(modelPosXY: vec2f, gridScale: f32, time: f32) -> vec2f {+ let safeGridScale = max(gridScale, 0.001);+ let gridPosition = modelPosXY * safeGridScale;+ let cellCoord = floor(gridPosition);+ let cellCenter = (cellCoord + vec2f(0.5)) / safeGridScale;+ let samplePosition = vec3f(cellCenter * IMPRINT_VORONOI_FREQUENCY, time * ASCII_VORONOI_Z_SPEED);+ return voronoi_cell_value_and_edge_3d(samplePosition);+}// Returns glyph coverage 0..1 for a model-space X/Y position. The caller applies the// geometric front-face mask so this module stays independent of material normals.-export fn ascii_imprint_coverage(modelPosXY: vec2f, gridScale: f32, glyphScale: f32, time: f32, mouse: vec2f, prog: f32) -> f32 {+export fn ascii_imprint_coverage(modelPosXY: vec2f, gridScale: f32, glyphScale: f32, time: f32, mouse: vec2f, prog: f32, hover: f32, voronoi: vec2f) -> f32 {let safeProgress = clamp(prog, 0.0, 1.0);- if (safeProgress <= 0.0) {- return 0.0;- }+ let safeHover = clamp(hover, 0.0, 1.0);let safeGridScale = max(gridScale, 0.001);let safeGlyphScale = max(glyphScale, 0.1);let gridPosition = modelPosXY * safeGridScale;let cellCoord = floor(gridPosition);- let cellCenter = (cellCoord + vec2f(0.5)) / safeGridScale;let glyphUv = fract(gridPosition);let p = (glyphUv - vec2f(0.5)) * 2.0;- let samplePosition = vec3f(cellCenter * IMPRINT_VORONOI_FREQUENCY, time * ASCII_VORONOI_Z_SPEED);- let voronoi = voronoi_cell_value_and_edge_3d(samplePosition);let cellValue = voronoi.x;let edgeMask = voronoi.y;let scaledP = p / safeGlyphScale;let baseDotDistance = (length(scaledP) - ASCII_BASE_DOT_RADIUS) * safeGlyphScale;let selectedGlyphDistance = shape_distance(scaledP, cellValue) * safeGlyphScale;+ let hoverGlyphDistance = hover_shape_distance(scaledP, safeHover) * safeGlyphScale;let baseDotAa = max(fwidth(baseDotDistance), 0.01);let selectedGlyphAa = max(fwidth(selectedGlyphDistance), 0.01);+ let hoverGlyphAa = max(fwidth(hoverGlyphDistance), 0.01);let baseDotCoverage = 1.0 - smoothstep(0.0, baseDotAa, baseDotDistance);let selectedGlyphCoverage = 1.0 - smoothstep(0.0, selectedGlyphAa, selectedGlyphDistance);- let interiorGlyph = max(selectedGlyphCoverage, baseDotCoverage);+ let hoverGlyphCoverage = 1.0 - smoothstep(0.0, hoverGlyphAa, hoverGlyphDistance);+ let hoverEntry = smoothstep(HOVER_ENTRY_START, HOVER_ENTRY_FULL, safeHover);+ let selectedCoverage = selectedGlyphCoverage;+ let interiorGlyph = max(selectedCoverage, baseDotCoverage);let edgeGlyphDistance = sd_box(scaledP, vec2f(ASCII_EDGE_SQUARE_HALF_SIZE)) * safeGlyphScale;let edgeGlyphAa = max(fwidth(edgeGlyphDistance), 0.01);let edgeGlyphCoverage = (1.0 - smoothstep(0.0, edgeGlyphAa, edgeGlyphDistance)) * edgeMask;- // Draw the full random-selected glyph throughout each Voronoi region; the minimum dot only- // prevents empty branches. F2-F1 edge proximity boosts a small SDF-shaped square at- // boundaries instead of bypassing the SDF and filling the whole ASCII quad.- let glyph = max(interiorGlyph, edgeGlyphCoverage);+ // The noisy ASCII chain is controlled only by imprint progress: random selected glyph,+ // minimum dot, Voronoi edge square, then per-cell stagger reveal.+ let imprintGlyph = max(interiorGlyph, edgeGlyphCoverage);let cellRand = hash3(vec3i(vec2i(cellCoord), 0));// Spread each cell's 0.25-wide reveal window across the full transition instead of scaling// progress by the stagger range. This keeps p=0.5 as a true mid-state while preserving exact// endpoints: p=0 reveals no cells, p=1 reveals every cell fully.let revealStart = cellRand * (1.0 - REVEAL_STAGGER_WINDOW);- let reveal = smoothstep(revealStart, revealStart + REVEAL_STAGGER_WINDOW, safeProgress);- return glyph * reveal;+ let staggerReveal = smoothstep(revealStart, revealStart + REVEAL_STAGGER_WINDOW, safeProgress);+ let imprintCoverage = imprintGlyph * staggerReveal;++ // Paint reveal is independent from the noise chain. On glass (progress=0) this contributes+ // only the clean station ramp; in ASCII mode it cleanly overrides the selected glyph while+ // the base dots/edge squares remain part of the imprint chain.+ let hoverCoverage = hoverGlyphCoverage * hoverEntry * HOVER_OVERLAY_SCALE;+ // Hard per-cell switchover: once hover passes the entry threshold, the entire cell shows+ // only the spinner glyph; otherwise only the imprint glyph contributes.+ let hoverGate = step(HOVER_ENTRY_START, safeHover);+ return mix(imprintCoverage, hoverCoverage, hoverGate);}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgslnew file mode 100644index 000000000..d80b7b57a--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-face.wgsl@@ -0,0 +1,62 @@+// Shared cubemap face mapping helpers for eve logo environment shaders.+// INVARIANT: face order is +X, -X, +Y, -Y, +Z, -Z for all bake/sample paths.+// INVARIANT: lookup UVs keep a small inset and the established Y conventions.++const CUBEMAP_UV_INSET = 0.001;++export fn cube_dir(face: f32, uv: vec2f) -> vec3f {+ let p = uv * 2.0 - vec2f(1.0);+ // WebGPU cube face order: +X, -X, +Y, -Y, +Z, -Z.+ if (face < 0.5) {+ return normalize(vec3f(1.0, -p.y, -p.x));+ }+ if (face < 1.5) {+ return normalize(vec3f(-1.0, -p.y, p.x));+ }+ if (face < 2.5) {+ return normalize(vec3f(p.x, 1.0, p.y));+ }+ if (face < 3.5) {+ return normalize(vec3f(p.x, -1.0, -p.y));+ }+ if (face < 4.5) {+ return normalize(vec3f(p.x, -p.y, 1.0));+ }+ return normalize(vec3f(-p.x, -p.y, -1.0));+}++export fn cube_lookup_uv_face(direction: vec3f) -> vec3f {+ let dir = normalize(direction);+ let ad = abs(dir);+ var face = 0.0;+ var p = vec2f(0.0);++ if (ad.x >= ad.y && ad.x >= ad.z) {+ if (dir.x > 0.0) {+ face = 0.0;+ p = vec2f(-dir.z / ad.x, -dir.y / ad.x);+ } else {+ face = 1.0;+ p = vec2f(dir.z / ad.x, -dir.y / ad.x);+ }+ } else if (ad.y >= ad.x && ad.y >= ad.z) {+ if (dir.y > 0.0) {+ face = 2.0;+ p = vec2f(dir.x / ad.y, dir.z / ad.y);+ } else {+ face = 3.0;+ p = vec2f(dir.x / ad.y, -dir.z / ad.y);+ }+ } else {+ if (dir.z > 0.0) {+ face = 4.0;+ p = vec2f(dir.x / ad.z, -dir.y / ad.z);+ } else {+ face = 5.0;+ p = vec2f(-dir.x / ad.z, -dir.y / ad.z);+ }+ }++ let uv = clamp(p * 0.5 + vec2f(0.5), vec2f(CUBEMAP_UV_INSET), vec2f(1.0 - CUBEMAP_UV_INSET));+ return vec3f(uv, face);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsldeleted file mode 100644index 1984f667b..000000000--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/cube-sample.wgsl+++ /dev/null@@ -1,113 +0,0 @@-// Shared cubemap utilities for eve-5 shaders.-// Face order is the repo convention used throughout eve-5: +X, -X, +Y, -Y, +Z, -Z.--const CUBEMAP_UV_INSET = 0.001;--export fn cube_dir(face: f32, uv: vec2f) -> vec3f {- let p = uv * 2.0 - vec2f(1.0);- if (face < 0.5) {- return normalize(vec3f(1.0, -p.y, -p.x));- }- if (face < 1.5) {- return normalize(vec3f(-1.0, -p.y, p.x));- }- if (face < 2.5) {- return normalize(vec3f(p.x, 1.0, p.y));- }- if (face < 3.5) {- return normalize(vec3f(p.x, -1.0, -p.y));- }- if (face < 4.5) {- return normalize(vec3f(p.x, -p.y, 1.0));- }- return normalize(vec3f(-p.x, -p.y, -1.0));-}--export fn cube_lookup_uv_face(direction: vec3f) -> vec3f {- let dir = normalize(direction);- let ad = abs(dir);- var face = 0.0;- var p = vec2f(0.0);-- if (ad.x >= ad.y && ad.x >= ad.z) {- if (dir.x > 0.0) {- face = 0.0;- p = vec2f(-dir.z / ad.x, -dir.y / ad.x);- } else {- face = 1.0;- p = vec2f(dir.z / ad.x, -dir.y / ad.x);- }- } else if (ad.y >= ad.x && ad.y >= ad.z) {- if (dir.y > 0.0) {- face = 2.0;- p = vec2f(dir.x / ad.y, dir.z / ad.y);- } else {- face = 3.0;- p = vec2f(dir.x / ad.y, -dir.z / ad.y);- }- } else {- if (dir.z > 0.0) {- face = 4.0;- p = vec2f(dir.x / ad.z, -dir.y / ad.z);- } else {- face = 5.0;- p = vec2f(-dir.x / ad.z, -dir.y / ad.z);- }- }-- let uv = clamp(p * 0.5 + vec2f(0.5), vec2f(CUBEMAP_UV_INSET), vec2f(1.0 - CUBEMAP_UV_INSET));- return vec3f(uv, face);-}--export fn rotate_y(direction: vec3f, yaw: f32) -> vec3f {- let s = sin(yaw);- let c = cos(yaw);- return normalize(vec3f(direction.x * c - direction.z * s, direction.y, direction.x * s + direction.z * c));-}--export fn rotate_x(direction: vec3f, pitch: f32) -> vec3f {- let s = sin(pitch);- let c = cos(pitch);- return normalize(vec3f(direction.x, direction.y * c - direction.z * s, direction.y * s + direction.z * c));-}--export fn rotate_env(direction: vec3f, yaw: f32, pitch: f32) -> vec3f {- return rotate_x(rotate_y(direction, yaw), pitch);-}--export fn sample_cubemap_array(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {- let lookup = cube_lookup_uv_face(direction);- return textureSample(envCube, envSampler, lookup.xy, i32(lookup.z)).rgb;-}--export fn sample_cubemap_array_yaw(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f, yaw: f32) -> vec3f {- return sample_cubemap_array(envCube, envSampler, rotate_y(direction, yaw));-}--export fn sample_env(- envCube: texture_2d_array<f32>,- envSampler: sampler,- direction: vec3f,- yaw: f32,- pitch: f32,-) -> vec3f {- return sample_cubemap_array(envCube, envSampler, rotate_env(direction, yaw, pitch));-}--export fn sample_cubemap_array_level(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {- let lookup = cube_lookup_uv_face(direction);- return textureSampleLevel(envCube, envSampler, lookup.xy, i32(lookup.z), 0.0).rgb;-}--export fn aces_tonemap(color: vec3f) -> vec3f {- let a = 2.51;- let b = 0.03;- let c = 2.43;- let d = 0.59;- let e = 0.14;- return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));-}--export fn linear_to_display(color: vec3f) -> vec3f {- return pow(max(color, vec3f(0.0)), vec3f(1.0 / 2.2));-}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgslnew file mode 100644index 000000000..0a1347927--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/env-sample.wgsl@@ -0,0 +1,36 @@+import { cube_lookup_uv_face } from "./cube-face.wgsl";++// Shared environment sampling helpers for eve logo material/background shaders.+// INVARIANT: yaw then pitch rotation order matches the pre-split cube-sample module.+// Textures and sampler are always supplied by entry shaders; this file declares no bindings.++export fn rotate_y(direction: vec3f, yaw: f32) -> vec3f {+ let s = sin(yaw);+ let c = cos(yaw);+ return normalize(vec3f(direction.x * c - direction.z * s, direction.y, direction.x * s + direction.z * c));+}++export fn rotate_x(direction: vec3f, pitch: f32) -> vec3f {+ let s = sin(pitch);+ let c = cos(pitch);+ return normalize(vec3f(direction.x, direction.y * c - direction.z * s, direction.y * s + direction.z * c));+}++export fn rotate_env(direction: vec3f, yaw: f32, pitch: f32) -> vec3f {+ return rotate_x(rotate_y(direction, yaw), pitch);+}++export fn sample_cubemap_array(envCube: texture_2d_array<f32>, envSampler: sampler, direction: vec3f) -> vec3f {+ let lookup = cube_lookup_uv_face(direction);+ return textureSample(envCube, envSampler, lookup.xy, i32(lookup.z)).rgb;+}++export fn sample_env(+ envCube: texture_2d_array<f32>,+ envSampler: sampler,+ direction: vec3f,+ yaw: f32,+ pitch: f32,+) -> vec3f {+ return sample_cubemap_array(envCube, envSampler, rotate_env(direction, yaw, pitch));+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgslnew file mode 100644index 000000000..c4e97be60--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/fullscreen.wgsl@@ -0,0 +1,22 @@+// Shared non-entry fullscreen triangle helpers.+// INVARIANT: entry shaders keep their own vertex-stage wrappers to avoid duplicate entrypoints.+// The returned UV orientation matches the pre-split fullscreen triangle convention.++export fn fullscreen_clip_position(vertexIndex: u32) -> vec4f {+ let positions = array<vec2f, 3>(+ vec2f(-1.0, -3.0),+ vec2f(-1.0, 1.0),+ vec2f(3.0, 1.0),+ );+ return vec4f(positions[vertexIndex], 0.0, 1.0);+}++export fn fullscreen_uv(vertexIndex: u32) -> vec2f {+ let positions = array<vec2f, 3>(+ vec2f(-1.0, -3.0),+ vec2f(-1.0, 1.0),+ vec2f(3.0, 1.0),+ );+ let position = positions[vertexIndex];+ return position * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgslsimilarity index 65%rename from apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgslrename to apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgslindex 4ebd34c93..3b3dc0556 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-common.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/glass-vertex.wgsl@@ -1,22 +1,8 @@-export struct Params {- viewProj: mat4x4f,- cameraPos: vec3f,- passKind: f32,- cameraRight: vec3f,- fov: f32,- cameraUp: vec3f,- aspect: f32,- cameraForward: vec3f,- materialKind: f32,- thicknessScale: f32,- envYaw: f32,- envPitch: f32,- glassAbsorption: f32,- // x = imprint progress, y = grid scale (cells/model unit), z = glyph scale, w = time seconds.- ascii0: vec4f,- // x/y = normalized mouse offset; z/w reserved.- ascii1: vec4f,-};+import { Params } from "./scene-params.wgsl";++// Shared mesh vertex IO and vertex helper for glass mesh entry shaders.+// INVARIANT: vertex locations and output locations match the pipeline vertex layout.+// This module contains no shader entrypoints; entry files keep their vs_main wrappers.export struct VertexInput {@location(0) position: vec3f,@@ -31,9 +17,6 @@ export struct VertexOutput {@location(3) modelPos: vec3f,};-export const OUTSIDE_PASS_THRESHOLD = 0.5;-export const WIRE_PASS_THRESHOLD = 1.5;-export fn glass_vs_main(input: VertexInput, params: Params) -> VertexOutput {var output: VertexOutput;output.clipPosition = params.viewProj * vec4f(input.position, 1.0);diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgslindex 67164a411..2117c5aa6 100644--- a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/material-core.wgsl@@ -1,4 +1,4 @@-import { sample_env } from "./cube-sample.wgsl";+import { sample_env } from "./env-sample.wgsl";// Shared material/reflection primitives for eve-5 mesh materials.// Keep camera-facing normal orientation and reflection direction here so glass,@@ -23,17 +23,6 @@ export fn env_reflection_from_dir(return sample_env(envCube, envSampler, reflected, envYaw, envPitch);}-export fn env_reflection(- envCube: texture_2d_array<f32>,- envSampler: sampler,- n: vec3f,- v: vec3f,- envYaw: f32,- envPitch: f32,-) -> vec3f {- return env_reflection_from_dir(envCube, envSampler, env_reflect_dir(n, v), envYaw, envPitch);-}-export fn encode_normal(n: vec3f) -> vec3f {return normalize(n) * 0.5 + vec3f(0.5);}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgslnew file mode 100644index 000000000..63c597d09--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/scene-params.wgsl@@ -0,0 +1,29 @@+// Shared scene uniform ABI for glass and environment entry shaders.+// INVARIANT: 176 bytes / 44 f32; field order must match render/params.ts writeParams.+// 0-15 viewProj, 16-18 cameraPos, 19 passKind, 20-22 cameraRight, 23 fov,+// 24-26 cameraUp, 27 aspect, 28-30 cameraForward, 31 materialKind,+// 32 thicknessScale, 33 envYaw, 34 envPitch, 35 glassAbsorption,+// 36 imprintProgress, 37 gridScale, 38 glyphScale, 39 time,+// 40-41 mouse, 42-43 originCell.++export struct Params {+ viewProj: mat4x4f,+ cameraPos: vec3f,+ passKind: f32,+ cameraRight: vec3f,+ fov: f32,+ cameraUp: vec3f,+ aspect: f32,+ cameraForward: vec3f,+ materialKind: f32,+ thicknessScale: f32,+ envYaw: f32,+ envPitch: f32,+ glassAbsorption: f32,+ // x = imprint progress, y = grid scale (cells/model unit), z = glyph scale, w = time seconds.+ ascii0: vec4f,+ // x/y = normalized mouse offset; z/w = origin cell.+ ascii1: vec4f,+};++export const WIRE_PASS_THRESHOLD = 1.5;diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgslnew file mode 100644index 000000000..569ec9429--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/sdf.wgsl@@ -0,0 +1,27 @@+// Shared 2D signed-distance primitives for ASCII glyph shaders.+// INVARIANT: formulas are the pre-split ascii-imprint SDFs; glyph scale is applied by callers.+// No entrypoints or bindings are declared here.++export fn sd_box(p: vec2f, halfSize: vec2f) -> f32 {+ let q = abs(p) - halfSize;+ return length(max(q, vec2f(0.0))) + min(max(q.x, q.y), 0.0);+}++export fn sd_equilateral_triangle(p0: vec2f) -> f32 {+ let k = sqrt(3.0);+ var p = p0;+ p.x = abs(p.x) - 0.42;+ p.y = p.y + 0.24;+ if (p.x + k * p.y > 0.0) {+ p = vec2f(p.x - k * p.y, -k * p.x - p.y) / 2.0;+ }+ p.x = p.x - clamp(p.x, -0.84, 0.0);+ return -length(p) * sign(p.y);+}++export fn sd_rotated_box(p: vec2f, halfSize: vec2f, angle: f32) -> f32 {+ let s = sin(angle);+ let c = cos(angle);+ let rotated = vec2f(c * p.x + s * p.y, -s * p.x + c * p.y);+ return sd_box(rotated, halfSize);+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgslnew file mode 100644index 000000000..877937c8a--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/tonemap.wgsl@@ -0,0 +1,18 @@+// Shared display transform helpers for eve logo postprocess passes.+// INVARIANT: tonemap is applied once, after HDR scene/bloom accumulation.+// Imported only by fullscreen composite entry shaders.++export const DISPLAY_GAMMA = 2.2;++export fn aces_tonemap(color: vec3f) -> vec3f {+ let a = 2.51;+ let b = 0.03;+ let c = 2.43;+ let d = 0.59;+ let e = 0.14;+ return clamp((color * (a * color + vec3f(b))) / (color * (c * color + vec3f(d)) + vec3f(e)), vec3f(0.0), vec3f(1.0));+}++export fn linear_to_display(color: vec3f) -> vec3f {+ return pow(max(color, vec3f(0.0)), vec3f(1.0 / DISPLAY_GAMMA));+}diff --git a/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgsl b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgslnew file mode 100644index 000000000..8e95286b4--- /dev/null+++ b/apps/docs/app/[lang]/(home)/components/eve-logo-shader/shaders/shared/voronoi.wgsl@@ -0,0 +1,67 @@+// Shared hash and animated 3D Voronoi core for ASCII imprint noise.+// INVARIANT: constants match 7.10 visuals: frequency 4.8, edge 0.04/0.02 at call sites.+// Hash salts and F2-F1 edge math are unchanged from the duplicated implementations.++export fn hash_u32(value: u32) -> u32 {+ var x = value;+ x ^= x >> 16u;+ x *= 0x7feb352du;+ x ^= x >> 15u;+ x *= 0x846ca68bu;+ x ^= x >> 16u;+ return x;+}++export fn hash3(cell: vec3i) -> f32 {+ let ux = bitcast<u32>(cell.x);+ let uy = bitcast<u32>(cell.y);+ let uz = bitcast<u32>(cell.z);+ let mixed = (ux * 0x8da6b343u) ^ (uy * 0xd8163841u) ^ (uz * 0xcb1ab31fu);+ return f32(hash_u32(mixed) & 0x00ffffffu) / 16777215.0;+}++fn hash3_feature_point(cell: vec3i) -> vec3f {+ return vec3f(+ hash3(cell + vec3i(17, 59, 113)),+ hash3(cell + vec3i(101, 191, 53)),+ hash3(cell + vec3i(47, 223, 149)),+ );+}++const VORONOI_EDGE_WIDTH = 0.04;+const VORONOI_EDGE_SOFTNESS = 0.02;++export fn voronoi_cell_value_and_edge_3d(p: vec3f) -> vec2f {+ let baseCell = vec3i(floor(p));+ let localPosition = fract(p);+ var nearestDistanceSquared = 1000.0;+ var secondNearestDistanceSquared = 1000.0;+ var winningCell = baseCell;++ for (var z = -1; z <= 1; z = z + 1) {+ for (var y = -1; y <= 1; y = y + 1) {+ for (var x = -1; x <= 1; x = x + 1) {+ let neighborOffset = vec3i(x, y, z);+ let neighborCell = baseCell + neighborOffset;+ let featurePoint = vec3f(neighborOffset) + hash3_feature_point(neighborCell);+ let delta = featurePoint - localPosition;+ let distanceSquared = dot(delta, delta);+ if (distanceSquared < nearestDistanceSquared) {+ secondNearestDistanceSquared = nearestDistanceSquared;+ nearestDistanceSquared = distanceSquared;+ winningCell = neighborCell;+ } else if (distanceSquared < secondNearestDistanceSquared) {+ secondNearestDistanceSquared = distanceSquared;+ }+ }+ }+ }++ // Hard-cell Voronoi: the nearest feature cell gets one random value for glyph type.+ // The F2-F1 gap controls a pure-white edge overlay, while interiors keep the full+ // random-selected glyph instead of being masked away.+ let cellValue = hash3(winningCell + vec3i(211, 37, 173));+ let edgeGap = sqrt(secondNearestDistanceSquared) - sqrt(nearestDistanceSquared);+ let edgeMask = 1.0 - smoothstep(VORONOI_EDGE_WIDTH, VORONOI_EDGE_WIDTH + VORONOI_EDGE_SOFTNESS, edgeGap);+ return vec2f(cellValue, edgeMask);+}diff --git a/apps/docs/next-env.d.ts b/apps/docs/next-env.d.tsindex 9edff1c7c..c4b7818fb 100644--- a/apps/docs/next-env.d.ts+++ b/apps/docs/next-env.d.ts@@ -1,6 +1,6 @@/// <reference types="next" />/// <reference types="next/image-types/global" />-import "./.next/types/routes.d.ts";+import "./.next/dev/types/routes.d.ts";// NOTE: This file should not be edited// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.diff --git a/apps/docs/scripts/check-eve-mobile-motion.ts b/apps/docs/scripts/check-eve-mobile-motion.tsnew file mode 100644index 000000000..c2b533d0b--- /dev/null+++ b/apps/docs/scripts/check-eve-mobile-motion.ts@@ -0,0 +1,51 @@+import { strict as assert } from "node:assert";+import {+ MOBILE_AUTO_ROTATE_SPEED,+ evePointerInteractionMode,+ mobileAutoEnvYaw,+} from "../app/[lang]/(home)/components/eve-logo-shader/mobile-motion";++const coarse = evePointerInteractionMode(true);+assert.equal(coarse.paintEnabled, false, "coarse pointer must disable paint");+assert.equal(coarse.autoRotateEnvYaw, true, "coarse pointer must enable auto env yaw");++const fine = evePointerInteractionMode(false);+assert.equal(fine.paintEnabled, true, "fine pointer must keep paint enabled");+assert.equal(fine.autoRotateEnvYaw, false, "fine pointer must keep pointer-driven env yaw");++assertAlmost(mobileAutoEnvYaw(0), 0, "yaw at t=0");+assertAlmost(mobileAutoEnvYaw(10), 1.5, "yaw at t=10s");+assertAlmost(mobileAutoEnvYaw(21), 3.15, "yaw at t=21s");+assertAlmost(+ mobileAutoEnvYaw(3600),+ MOBILE_AUTO_ROTATE_SPEED * 3600,+ "yaw after 1h remains unwrapped",+);+assert(mobileAutoEnvYaw(3600) > Math.PI * 2, "auto yaw must be monotonic and unwrapped");++console.log(+ JSON.stringify(+ {+ ok: true,+ speedRadPerSecond: MOBILE_AUTO_ROTATE_SPEED,+ coarse,+ fine,+ yawSamples: {+ t0: round(mobileAutoEnvYaw(0)),+ t10: round(mobileAutoEnvYaw(10)),+ t21: round(mobileAutoEnvYaw(21)),+ t3600: round(mobileAutoEnvYaw(3600)),+ },+ },+ null,+ 2,+ ),+);++function assertAlmost(actual: number, expected: number, label: string) {+ assert(Math.abs(actual - expected) < 1e-9, `${label}: expected ${expected}, received ${actual}`);+}++function round(value: number) {+ return Number(value.toFixed(6));+}diff --git a/apps/docs/scripts/check-eve-paint-mapping.ts b/apps/docs/scripts/check-eve-paint-mapping.tsnew file mode 100644index 000000000..e639ec89b--- /dev/null+++ b/apps/docs/scripts/check-eve-paint-mapping.ts@@ -0,0 +1,141 @@+import { strict as assert } from "node:assert";+import {+ DEFAULT_CAMERA_FOV,+ BLOOM_RADIUS,+ cameraRadiusForFov,+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ mapClientPointToPaintCell,+ type Bounds,+ type RenderControls,+} from "../app/[lang]/(home)/components/eve-logo-shader/render";++const bounds: Bounds = {+ min: [-0.039000000804662704, -0.01188180036842823, -0.0020000000949949026],+ max: [0.03870119899511337, 0.012500000186264515, 0.0020000000949949026],+};+const controls: Pick<RenderControls, "radius" | "yaw" | "pitch" | "fov"> = {+ yaw: 0,+ pitch: 0,+ radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),+ fov: DEFAULT_CAMERA_FOV,+};+const rect = { left: 10, top: 20, width: 563.5, height: 190 };+const devicePixelRatio = DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO;+const canvasWidth = Math.floor(rect.width * devicePixelRatio);+const canvasHeight = Math.floor(rect.height * devicePixelRatio);+const logicalWidth = canvasWidth - BLOOM_RADIUS * 2;+const logicalHeight = canvasHeight - BLOOM_RADIUS * 2;+const gridScaleMultiplier = DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER;++const center = mapClientPointToPaintCell({+ clientX: rect.left + rect.width / 2,+ clientY: rect.top + rect.height / 2,+ rect,+ canvasWidth,+ canvasHeight,+ logicalWidth,+ logicalHeight,+ controls,+ meshBounds: bounds,+ gridScaleMultiplier,+ devicePixelRatio,+});+assert(center);+assert.equal(center.insideLogicalBounds, true);+assert.deepEqual(center.originCell, [-21, -7]);+assertAlmost(center.physical[0], 563.5, "center physical x");+assertAlmost(center.physical[1], 190, "center physical y");+assertAlmost(center.logical[0], 547.5, "center logical x");+assertAlmost(center.logical[1], 174, "center logical y");+assertAlmost(center.model[0], 0, "center model x");+assertAlmost(center.model[1], 0, "center model y");+assertAlmost(center.brushCell[0], 21, "center cell x");+assertAlmost(center.brushCell[1], 7, "center cell y");++const dpr1SameBuffer = mapClientPointToPaintCell({+ clientX: rect.left + rect.width / 2,+ clientY: rect.top + rect.height / 2,+ rect,+ canvasWidth,+ canvasHeight,+ logicalWidth,+ logicalHeight,+ controls,+ meshBounds: bounds,+ gridScaleMultiplier,+ devicePixelRatio: 1,+});+assert(dpr1SameBuffer);+assert.equal(dpr1SameBuffer.insideLogicalBounds, true);+assertAlmost(+ dpr1SameBuffer.gridScale,+ center.gridScale * 2,+ "dpr1 same-buffer grid scale doubles",+);+assertAlmost(+ dpr1SameBuffer.brushCell[0] - dpr1SameBuffer.originCell[0],+ (center.brushCell[0] - center.originCell[0]) * 2,+ "dpr1 same-buffer center lattice coordinate doubles",+);++const leftEdgeClientX = rect.left + (BLOOM_RADIUS * rect.width) / canvasWidth;+const leftOfOrigin = mapClientPointToPaintCell({+ clientX: leftEdgeClientX,+ clientY: rect.top + rect.height / 2,+ rect,+ canvasWidth,+ canvasHeight,+ logicalWidth,+ logicalHeight,+ controls,+ meshBounds: bounds,+ gridScaleMultiplier,+ devicePixelRatio,+});+assert(leftOfOrigin);+assert.equal(leftOfOrigin.insideLogicalBounds, true);+assert.deepEqual(leftOfOrigin.originCell, [-21, -7]);+assert(leftOfOrigin.model[0] < 0, "left case is in negative model X");+assert(leftOfOrigin.brushCell[0] < 0, "originCell offset preserves negative/out-of-grid cell X");+assertAlmost(leftOfOrigin.logical[0], 0, "left logical x");+assertAlmost(leftOfOrigin.brushCell[0], -3.2953125, "left cell x");+assertAlmost(leftOfOrigin.brushCell[1], 7, "left cell y");++console.log(+ JSON.stringify(+ {+ ok: true,+ center: summarize(center),+ leftOfOrigin: summarize(leftOfOrigin),+ dpr1SameBuffer: summarize(dpr1SameBuffer),+ },+ null,+ 2,+ ),+);++function summarize(mapping: NonNullable<ReturnType<typeof mapClientPointToPaintCell>>) {+ return {+ physical: roundPair(mapping.physical),+ logical: roundPair(mapping.logical),+ model: roundPair(mapping.model),+ brushCell: roundPair(mapping.brushCell),+ originCell: mapping.originCell,+ gridScale: round(mapping.gridScale),+ pxPerModelUnit: round(mapping.pxPerModelUnit),+ insideLogicalBounds: mapping.insideLogicalBounds,+ };+}++function roundPair(pair: readonly [number, number]) {+ return [round(pair[0]), round(pair[1])] as const;+}++function round(value: number) {+ return Number(value.toFixed(6));+}++function assertAlmost(actual: number, expected: number, label: string) {+ assert(Math.abs(actual - expected) < 1e-6, `${label}: expected ${expected}, received ${actual}`);+}diff --git a/apps/docs/scripts/eve-render/config.ts b/apps/docs/scripts/eve-render/config.tsnew file mode 100644index 000000000..f562dae43--- /dev/null+++ b/apps/docs/scripts/eve-render/config.ts@@ -0,0 +1,161 @@+import { resolve } from "node:path";+import { mobileAutoEnvYaw } from "../../app/[lang]/(home)/components/eve-logo-shader/mobile-motion";+import {+ BLOOM_RADIUS,+ BLOOM_STRENGTH_OFF,+ BLOOM_STRENGTH_ON,+ BLOOM_THRESHOLD,+ DEFAULT_CAMERA_FOV,+ DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO,+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ DEFAULT_PAINT_BRUSH_RADIUS,+ DEFAULT_PAINT_BRUSH_STRENGTH,+ DEFAULT_PAINT_DECAY_PER_FRAME_120,+ DEFAULT_PAINT_DIFFUSION_JITTER,+ DEFAULT_PAINT_DIFFUSION_RATE,+ DEFAULT_PAINT_DT,+ cameraRadiusForFov,+ getPaddedRenderSize,+ type EveMaterial,+ type RenderControls,+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";+import {+ readBooleanEnv,+ readFiniteNumberEnv,+ readNonNegativeIntegerEnv,+ readNonNegativeNumberEnv,+ readOptionalFiniteNumberEnv,+ readOptionalPositiveNumberEnv,+ readPositiveIntegerEnv,+ readPositiveNumberEnv,+ readRangeEnv,+ readRenderStageEnv,+ readThemeEnv,+ readUnitIntervalEnv,+} from "./env";++// Owns env-to-render-config assembly for the offline Eve renderer.+// INVARIANT: defaults and eager CLI semantics match the original script.+// Imported only by render-eve-5.ts and helper modules.++export const FORMAT: GPUTextureFormat = "rgba8unorm";++export type RenderConfig = ReturnType<typeof readRenderConfig>;++export function readRenderConfig() {+ const runId = new Date().toISOString().replaceAll(":", "-").replace(".", "-");+ const outDir = resolve(process.cwd(), "tmp/eve-5-renders", runId);+ const paddingRadius = readNonNegativeIntegerEnv("EVE_LOGO_RENDER_PADDING", 0);+ const bloomEnabled = readBooleanEnv("EVE_LOGO_RENDER_BLOOM", false);+ const outputWidth = readPositiveIntegerEnv("EVE_LOGO_RENDER_WIDTH", 1095, paddingRadius * 2);+ const outputHeight = readPositiveIntegerEnv("EVE_LOGO_RENDER_HEIGHT", 348, paddingRadius * 2);+ const logicalWidth = Math.max(1, outputWidth - paddingRadius * 2);+ const logicalHeight = Math.max(1, outputHeight - paddingRadius * 2);+ const paddedSize = getPaddedRenderSize(logicalWidth, logicalHeight, paddingRadius);+ const width = paddedSize.width;+ const height = paddedSize.height;+ const theme = readThemeEnv();+ const dpr = readPositiveNumberEnv("EVE_LOGO_RENDER_DPR", DEFAULT_IMPRINT_DEVICE_PIXEL_RATIO);+ const imprintProgress = readUnitIntervalEnv("EVE_LOGO_RENDER_IMPRINT_PROGRESS");+ const imprintGridScaleMultiplier = readPositiveNumberEnv(+ "EVE_LOGO_IMPRINT_GRID_SCALE_MULTIPLIER",+ DEFAULT_IMPRINT_GRID_SCALE_MULTIPLIER,+ );+ const imprintGlyphScale = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GLYPH_SCALE", 1.35);+ const requestedRenderStage = readRenderStageEnv();+ const renderStage: EveMaterial = requestedRenderStage;+ const paintSteps = readNonNegativeIntegerEnv("EVE_LOGO_PAINT_STEPS", 0);+ const paintDecayPerFrame120 = readPositiveNumberEnv(+ "EVE_LOGO_PAINT_DECAY_PER_FRAME_120",+ DEFAULT_PAINT_DECAY_PER_FRAME_120,+ );+ const paintDecayRate =+ readOptionalPositiveNumberEnv("EVE_LOGO_PAINT_DECAY_RATE") ?? paintDecayPerFrame120 * 120;+ const paintDiffusionRate = readNonNegativeNumberEnv(+ "EVE_LOGO_PAINT_DIFFUSION",+ DEFAULT_PAINT_DIFFUSION_RATE,+ );+ const paintDiffusionJitter = readRangeEnv(+ "EVE_LOGO_PAINT_DIFFUSION_JITTER",+ DEFAULT_PAINT_DIFFUSION_JITTER,+ 0,+ 4,+ );+ const paintBrushRadius = readPositiveNumberEnv(+ "EVE_LOGO_PAINT_BRUSH_RADIUS",+ DEFAULT_PAINT_BRUSH_RADIUS,+ );+ const paintBrushStrength = readNonNegativeNumberEnv(+ "EVE_LOGO_PAINT_BRUSH_STRENGTH",+ DEFAULT_PAINT_BRUSH_STRENGTH,+ );+ const paintDt = readPositiveNumberEnv("EVE_LOGO_PAINT_DT", DEFAULT_PAINT_DT);+ const paintDecaySteps = readNonNegativeIntegerEnv("EVE_LOGO_PAINT_DECAY_STEPS", 0);+ const renderYaw = readFiniteNumberEnv("EVE_LOGO_RENDER_YAW", 0);+ const renderEnvYawTime = readOptionalFiniteNumberEnv("EVE_LOGO_ENV_YAW_TIME");+ const renderEnvYaw =+ readOptionalFiniteNumberEnv("EVE_LOGO_RENDER_ENV_YAW") ??+ (renderEnvYawTime === undefined ? 0 : mobileAutoEnvYaw(renderEnvYawTime));+ const modelPath = resolve(process.cwd(), "public/eve-5/eve-logo.gltf");+ const defaultControls: RenderControls = {+ yaw: renderYaw,+ pitch: 0,+ radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),+ fov: DEFAULT_CAMERA_FOV,+ envYaw: renderEnvYaw,+ envPitch: 0,+ insideRendering: true,+ outsideRendering: true,+ material: renderStage,+ wireframe: false,+ showEnv: false,+ };++ return {+ runId,+ outDir,+ format: FORMAT,+ paddingRadius,+ bloomEnabled,+ outputWidth,+ outputHeight,+ logicalWidth,+ logicalHeight,+ width,+ height,+ theme,+ dpr,+ imprintProgress,+ imprintGridScaleMultiplier,+ imprintGlyphScale,+ requestedRenderStage,+ renderStage,+ paintSteps,+ paintDecayPerFrame120,+ paintDecayRate,+ paintDiffusionRate,+ paintDiffusionJitter,+ paintBrushRadius,+ paintBrushStrength,+ paintDt,+ paintDecaySteps,+ renderYaw,+ renderEnvYawTime,+ renderEnvYaw,+ modelPath,+ defaultControls,+ bloomConstants: {+ radius: BLOOM_RADIUS,+ strengthOff: BLOOM_STRENGTH_OFF,+ strengthOn: BLOOM_STRENGTH_ON,+ threshold: BLOOM_THRESHOLD,+ },+ };+}++export function effectiveBloomStrength(config: RenderConfig, imprintProgress: number) {+ return (+ config.bloomConstants.strengthOff ++ (config.bloomConstants.strengthOn - config.bloomConstants.strengthOff) * imprintProgress+ );+}diff --git a/apps/docs/scripts/eve-render/env.ts b/apps/docs/scripts/eve-render/env.tsnew file mode 100644index 000000000..aa785b7c8--- /dev/null+++ b/apps/docs/scripts/eve-render/env.ts@@ -0,0 +1,135 @@+import type { EveMaterial } from "../../app/[lang]/(home)/components/eve-logo-shader/render";++// Owns environment-variable parsing for the offline Eve renderer.+// INVARIANT: EVE_LOGO_RENDER_* and EVE_LOGO_PAINT_* names/accepted values are unchanged.+// Imported by config, paint-fixtures, and views.++export function readFiniteNumberEnv(name: string, fallback: number) {+ return readOptionalFiniteNumberEnv(name) ?? fallback;+}++export function readOptionalFiniteNumberEnv(name: string) {+ const value = process.env[name];+ if (!value) return undefined;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed)) {+ throw new Error(`${name} must be a finite number.`);+ }+ return parsed;+}++export 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;+}++export function readPositiveNumberEnv(name: string, fallback: number) {+ return readOptionalPositiveNumberEnv(name) ?? fallback;+}++export function readOptionalPositiveNumberEnv(name: string) {+ const value = process.env[name];+ if (!value) return undefined;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed) || parsed <= 0) {+ throw new Error(`${name} must be a positive number.`);+ }+ return parsed;+}++export function readNonNegativeNumberEnv(name: string, fallback: number) {+ const value = process.env[name];+ if (!value) return fallback;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed) || parsed < 0) {+ throw new Error(`${name} must be a non-negative number.`);+ }+ return parsed;+}++export function readUnitIntervalEnv(name: string) {+ const value = process.env[name];+ if (value === undefined || value === "") return undefined;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {+ throw new Error(`${name} must be a finite number between 0 and 1.`);+ }+ return parsed;+}++export function readRangeEnv(name: string, fallback: number, min: number, max: number) {+ const value = process.env[name];+ if (value === undefined || value === "") return fallback;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed) || parsed < min || parsed > max) {+ throw new Error(`${name} must be a finite number between ${min} and ${max}.`);+ }+ return parsed;+}++export 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;+}++export 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.`);+}++export function readRenderStageEnv(): EveMaterial {+ const values: Record<string, EveMaterial> = {+ glass: "glass",+ "back-albedo": "back-albedo",+ "back-depth": "back-depth",+ thickness: "thickness",+ normal: "normal",+ "camera-reflected-normal": "camera reflected normal",+ metallic: "metallic",+ "paint-debug": "paint-debug",+ };+ const value = process.env.EVE_LOGO_RENDER_STAGE ?? "glass";+ const stage = values[value];+ if (!stage) {+ throw new Error(`EVE_LOGO_RENDER_STAGE must be one of: ${Object.keys(values).join(", ")}.`);+ }+ return stage;+}++export function stageFileName(stage: EveMaterial) {+ return stage.replaceAll(" ", "-");+}++export function formatProgressForFile(progress: number) {+ return progress.toFixed(3).replace(/0+$/, "").replace(/\.$/, "").replace(".", "p");+}++export function readNoiseTimeEnv() {+ const value = process.env.EVE_LOGO_RENDER_NOISE_TIME;+ if (!value) return 0;+ const parsed = Number.parseFloat(value);+ if (!Number.isFinite(parsed)) {+ throw new Error("EVE_LOGO_RENDER_NOISE_TIME must be a finite number.");+ }+ return parsed;+}++export 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".');+}diff --git a/apps/docs/scripts/eve-render/load-mesh.ts b/apps/docs/scripts/eve-render/load-mesh.tsnew file mode 100644index 000000000..d409f5f9c--- /dev/null+++ b/apps/docs/scripts/eve-render/load-mesh.ts@@ -0,0 +1,23 @@+import { readFile } from "node:fs/promises";+import { resolve } from "node:path";+import { decodeGltfMesh } from "../../app/[lang]/(home)/components/eve-logo-shader/mesh";++// Owns disk glTF loading for the offline Eve renderer.+// INVARIANT: data URI and relative-buffer decoding match the original script.+// Imported only by render-eve-5.ts.++export async function loadMeshFromDisk(path: string) {+ const gltf = JSON.parse(await readFile(path, "utf8"));+ return decodeGltfMesh(gltf, async (uri) => {+ if (uri.startsWith("data:application/octet-stream;base64,")) {+ const [, payload] = uri.split(",");+ return exactArrayBuffer(Buffer.from(payload!, "base64"));+ }+ const bufferPath = resolve(path, "..", uri);+ return exactArrayBuffer(await readFile(bufferPath));+ });+}++function exactArrayBuffer(buffer: Buffer) {+ return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);+}diff --git a/apps/docs/scripts/eve-render/paint-fixtures.ts b/apps/docs/scripts/eve-render/paint-fixtures.tsnew file mode 100644index 000000000..d3098b5e2--- /dev/null+++ b/apps/docs/scripts/eve-render/paint-fixtures.ts@@ -0,0 +1,118 @@+import {+ imprintCellSizeForDevicePixelRatio,+ type PaintRenderOptions,+ type PaintSeed,+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";+import type { RenderConfig } from "./config";+import { readBooleanEnv } from "./env";++// Owns deterministic paint seed/stroke fixtures for offline renders.+// INVARIANT: cell sizing and env grammar preserve legacy output pixels.+// Imported by views and render-eve-5.ts reporting.++export function paintRequested() {+ return Boolean(+ process.env.EVE_LOGO_PAINT_BLOB ||+ process.env.EVE_LOGO_PAINT_PATTERN ||+ process.env.EVE_LOGO_PAINT_STROKE,+ );+}++export function buildPaintSeed(config: RenderConfig): PaintSeed | undefined {+ if (!paintRequested()) return undefined;+ const cellSize = imprintCellSizeForDevicePixelRatio(config.dpr);+ const width = Math.max(1, Math.ceil(config.logicalWidth / cellSize));+ const height = Math.max(1, Math.ceil(config.logicalHeight / cellSize));+ const values = new Float32Array(width * height);+ const pattern = process.env.EVE_LOGO_PAINT_PATTERN;+ if (pattern) {+ fillPaintPattern(values, width, height, pattern);+ }+ const blob = process.env.EVE_LOGO_PAINT_BLOB;+ if (blob) {+ for (const part of blob.split(/[;|]/)) {+ if (part.trim()) addPaintBlob(values, width, height, part.trim());+ }+ }+ return { width, height, values };+}++export function paintOptions(config: RenderConfig, seed: PaintSeed): PaintRenderOptions {+ return {+ seed,+ steps: config.paintSteps,+ decaySteps: config.paintDecaySteps,+ dt: config.paintDt,+ brushRadius: config.paintBrushRadius,+ brushStrength: config.paintBrushStrength,+ brushActive: false,+ decayRate: config.paintDecayRate,+ diffusionRate: config.paintDiffusionRate,+ diffusionJitter: config.paintDiffusionJitter,+ stroke: readPaintStroke(seed.width, seed.height),+ };+}++export function readPaintStroke(width: number, height: number): PaintRenderOptions["stroke"] {+ const spec = process.env.EVE_LOGO_PAINT_STROKE;+ if (!spec) return undefined;+ const parts = spec.split(",").map((value) => Number.parseFloat(value));+ if (parts.length !== 5 || parts.some((value) => !Number.isFinite(value))) {+ throw new Error('EVE_LOGO_PAINT_STROKE must be "x0,y0,x1,y1,duration".');+ }+ const [x0, y0, x1, y1, duration] = parts as [number, number, number, number, number];+ if (duration <= 0) throw new Error("EVE_LOGO_PAINT_STROKE duration must be positive.");+ return {+ fromCell: [x0 * width, y0 * height],+ toCell: [x1 * width, y1 * height],+ duration,+ movementGated: readBooleanEnv("EVE_LOGO_PAINT_STROKE_MOVEMENT_GATED", true),+ };+}++function fillPaintPattern(values: Float32Array, width: number, height: number, pattern: string) {+ if (pattern === "full") {+ values.fill(1);+ return;+ }+ if (pattern === "ramp") {+ for (let y = 0; y < height; y += 1) {+ for (let x = 0; x < width; x += 1) values[y * width + x] = width <= 1 ? 1 : x / (width - 1);+ }+ return;+ }+ if (pattern === "stripes") {+ for (let y = 0; y < height; y += 1) {+ for (let x = 0; x < width; x += 1) values[y * width + x] = x % 2 === 0 ? 1 : 0;+ }+ return;+ }+ throw new Error('EVE_LOGO_PAINT_PATTERN must be "stripes", "ramp", or "full".');+}++function addPaintBlob(values: Float32Array, width: number, height: number, spec: string) {+ const parts = spec.split(",").map((value) => Number.parseFloat(value));+ if (parts.length !== 4 || parts.some((value) => !Number.isFinite(value))) {+ throw new Error('EVE_LOGO_PAINT_BLOB entries must be "x,y,radius,intensity".');+ }+ const [x, y, radius, intensity] = parts as [number, number, number, number];+ if (radius <= 0) throw new Error("EVE_LOGO_PAINT_BLOB radius must be positive.");+ const centerX = x * width;+ const centerY = y * height;+ const radiusCells = radius * Math.max(width, height);+ for (let row = 0; row < height; row += 1) {+ for (let col = 0; col < width; col += 1) {+ const dx = col + 0.5 - centerX;+ const dy = row + 0.5 - centerY;+ const d = Math.hypot(dx, dy);+ const falloff = 1 - smoothstep(0, radiusCells, d);+ const index = row * width + col;+ values[index] = Math.max(values[index] ?? 0, Math.max(0, Math.min(1, intensity * falloff)));+ }+ }+}++function smoothstep(edge0: number, edge1: number, x: number) {+ const t = Math.max(0, Math.min(1, (x - edge0) / Math.max(edge1 - edge0, 0.000001)));+ return t * t * (3 - 2 * t);+}diff --git a/apps/docs/scripts/eve-render/report.ts b/apps/docs/scripts/eve-render/report.tsnew file mode 100644index 000000000..2d105b364--- /dev/null+++ b/apps/docs/scripts/eve-render/report.ts@@ -0,0 +1,44 @@+import { createHash } from "node:crypto";+import { writeFile } from "node:fs/promises";+import { PNG } from "pngjs";++// Owns PNG writing and pixel-stat helpers for offline Eve renders.+// INVARIANT: PNG bytes and pixelStats sha256 algorithm are unchanged.+// Imported only by views and render-eve-5.ts.++export async function writePng(path: string, width: number, height: number, pixels: Uint8Array) {+ const png = new PNG({ width, height });+ png.data.set(pixels);+ await writeFile(path, PNG.sync.write(png));+}++export function pixelStats(width: number, height: number, pixels: Uint8Array) {+ let nonBlack = 0;+ let alpha = 0;+ let colored = 0;++ for (let index = 0; index < pixels.length; index += 4) {+ const r = pixels[index] ?? 0;+ const g = pixels[index + 1] ?? 0;+ const b = pixels[index + 2] ?? 0;+ const a = pixels[index + 3] ?? 0;+ const max = Math.max(r, g, b);+ const min = Math.min(r, g, b);+ if (max > 8) nonBlack++;+ if (a > 20) alpha++;+ if (max - min > 8 && r + g + b > 24) colored++;+ }++ const header = Buffer.alloc(8);+ header.writeUInt32LE(width, 0);+ header.writeUInt32LE(height, 4);+ const sha256 = createHash("sha256").update(header).update(pixels).digest("hex");++ return { width, height, total: width * height, nonBlack, alpha, colored, sha256 };+}++export function maxFloat32(values: Float32Array) {+ let max = 0;+ for (const value of values) max = Math.max(max, value);+ return max;+}diff --git a/apps/docs/scripts/eve-render/views.ts b/apps/docs/scripts/eve-render/views.tsnew file mode 100644index 000000000..71200d031--- /dev/null+++ b/apps/docs/scripts/eve-render/views.ts@@ -0,0 +1,121 @@+import { resolve } from "node:path";+import type { Device } from "@vgpu/core";+import {+ createEve5Renderer,+ type ImprintRenderOptions,+ type PaintSeed,+ type RenderControls,+} from "../../app/[lang]/(home)/components/eve-logo-shader/render";+import type { RenderConfig } from "./config";+import { formatProgressForFile, readNoiseTimeEnv, stageFileName } from "./env";+import { paintOptions, paintRequested } from "./paint-fixtures";+import { pixelStats, writePng } from "./report";++// Owns offline view orchestration, filenames, and GPU readback.+// INVARIANT: output filenames and manifest keys are byte-identical to the original script.+// Imported only by render-eve-5.ts.++export async function renderDefaultViews(+ renderer: ReturnType<typeof createEve5Renderer>,+ device: Device,+ config: RenderConfig,+ controls: RenderControls,+ paintSeed: PaintSeed | undefined,+) {+ const output = await renderView(+ renderer,+ device,+ config,+ controls,+ outputFileName(config),+ paintSeed,+ );+ await renderView(+ renderer,+ device,+ config,+ {+ ...controls,+ yaw: config.renderYaw || -0.49,+ pitch: config.renderYaw ? controls.pitch : 0.31,+ },+ "rotated.png",+ paintSeed,+ );+ await renderView(+ renderer,+ device,+ config,+ { ...controls, wireframe: true },+ "wireframe.png",+ paintSeed,+ );++ return {+ files: {+ output: outputFileName(config),+ rotated: "rotated.png",+ wireframe: "wireframe.png",+ log: "log.json",+ },+ output: pixelStats(config.width, config.height, output),+ };+}++function outputFileName(config: RenderConfig) {+ const stagePrefix = config.renderStage === "glass" ? "" : `${stageFileName(config.renderStage)}-`;+ const imprintPart =+ config.imprintProgress === undefined+ ? "output"+ : `imprint-${formatProgressForFile(config.imprintProgress)}`;+ const paintPart = paintRequested() ? `-paint-steps-${config.paintSteps}` : "";+ return `${stagePrefix}${imprintPart}${paintPart}.png`;+}++function imprintOptions(+ config: RenderConfig,+ paintSeed?: PaintSeed,+): ImprintRenderOptions | undefined {+ const paint = paintSeed ? paintOptions(config, paintSeed) : undefined;+ if (config.imprintProgress === undefined && !paint) return undefined;+ return {+ progress: config.imprintProgress ?? 0,+ gridScaleMultiplier: config.imprintGridScaleMultiplier,+ glyphScale: config.imprintGlyphScale,+ time: readNoiseTimeEnv(),+ mouse: [0, 0] as const,+ devicePixelRatio: config.dpr,+ paint,+ };+}++async function renderView(+ renderer: ReturnType<typeof createEve5Renderer>,+ device: Device,+ config: RenderConfig,+ controls: RenderControls,+ file: string,+ paintSeed?: PaintSeed,+) {+ const target = device.createTexture({+ label: `eve-5-static-${file}`,+ size: [config.width, config.height],+ format: config.format,+ usage: ["render_attachment", "copy_src"],+ });+ try {+ renderer.render(+ target.createView(),+ controls,+ config.logicalWidth,+ config.logicalHeight,+ imprintOptions(config, paintSeed),+ );+ await device.queue.flush();+ const pixels = new Uint8Array(await target.read());+ await writePng(resolve(config.outDir, file), config.width, config.height, pixels);+ return pixels;+ } finally {+ target.destroy();+ }+}diff --git a/apps/docs/scripts/render-eve-5.ts b/apps/docs/scripts/render-eve-5.tsindex 47914ed6c..c4ee4bdd1 100644--- a/apps/docs/scripts/render-eve-5.ts+++ b/apps/docs/scripts/render-eve-5.ts@@ -3,7 +3,7 @@// the static Eve logo fallback://// docker run --rm \-// -v /home/user/eve-worktrees/eve-migrate-shader:/work \+// -v /home/user/eve-worktrees/eve-hero-updates:/work \// -w /work/apps/docs \// -e VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/lvp_icd.json \// -e LIBGL_ALWAYS_SOFTWARE=1 \@@ -22,110 +22,118 @@// 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";+//+// QA / synthetic paint envs:+// - EVE_LOGO_RENDER_STAGE=glass|paint-debug|ascii|imprint|ascii/imprint+// - EVE_LOGO_RENDER_IMPRINT_PROGRESS=0..1 enables the front ASCII imprint path.+// - EVE_LOGO_PAINT_BLOB="x,y,radius,intensity[;...]" seeds soft paint blobs in paint-UV.+// - EVE_LOGO_PAINT_PATTERN=stripes|ramp|full seeds procedural paint.+// - EVE_LOGO_PAINT_STROKE="x0,y0,x1,y1,duration" simulates a moving brush stroke.+// - EVE_LOGO_PAINT_STROKE_MOVEMENT_GATED=false disables stroke movement gating for legacy sims.+// - EVE_LOGO_PAINT_STEPS=N runs N paint update frames before rendering.+// - EVE_LOGO_PAINT_DECAY_STEPS=N runs N additional inactive decay frames.+// - EVE_LOGO_PAINT_DECAY_PER_FRAME_120 sets linear paint removed per 120fps frame;+// EVE_LOGO_PAINT_DECAY_RATE still overrides the equivalent per-second rate directly.+// - EVE_LOGO_PAINT_DIFFUSION, EVE_LOGO_PAINT_DIFFUSION_JITTER,+// EVE_LOGO_PAINT_BRUSH_RADIUS, EVE_LOGO_PAINT_BRUSH_STRENGTH, and+// EVE_LOGO_PAINT_DT override paint dynamics.+// - EVE_LOGO_ENV_YAW_TIME=seconds drives env yaw as seconds*0.15 for mobile rotation QA.+// - EVE_LOGO_RENDER_ENV_YAW=radians sets env yaw directly.+// Example: EVE_LOGO_RENDER_STAGE=glass EVE_LOGO_RENDER_IMPRINT_PROGRESS=1 \+// EVE_LOGO_PAINT_BLOB="0.5,0.48,0.16,1" pnpm --dir apps/docs render:eve-5++import { mkdir, writeFile } from "node:fs/promises";import { resolve } from "node:path";-import { App } from "@vgpu/core";import { createNodeAdapter } from "@vgpu/adapter-node";-import { PNG } from "pngjs";-import { decodeGltfMesh } from "../app/[lang]/(home)/components/eve-logo-shader/mesh";-import {- BLOOM_RADIUS,- BLOOM_STRENGTH_OFF,- BLOOM_STRENGTH_ON,- BLOOM_THRESHOLD,- DEFAULT_CAMERA_FOV,- cameraRadiusForFov,- createEve5Renderer,- getPaddedRenderSize,- type EveMaterial,- type MeshData,- type RenderControls,-} from "../app/[lang]/(home)/components/eve-logo-shader/render";--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 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 IMPRINT_PROGRESS = readUnitIntervalEnv("EVE_LOGO_RENDER_IMPRINT_PROGRESS");-const IMPRINT_GRID_SCALE_MULTIPLIER = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GRID_SCALE_MULTIPLIER", 1);-const IMPRINT_GLYPH_SCALE = readPositiveNumberEnv("EVE_LOGO_IMPRINT_GLYPH_SCALE", 1.35);-const REQUESTED_RENDER_STAGE = readRenderStageEnv();-const RENDER_STAGE: EveMaterial = REQUESTED_RENDER_STAGE;-const RENDER_YAW = readFiniteNumberEnv("EVE_LOGO_RENDER_YAW", 0);-const MODEL_PATH = resolve(process.cwd(), "public/eve-5/eve-logo.gltf");-const DEFAULT_CONTROLS: RenderControls = {- yaw: RENDER_YAW,- pitch: 0,- radius: cameraRadiusForFov(DEFAULT_CAMERA_FOV),- fov: DEFAULT_CAMERA_FOV,- envYaw: 0,- envPitch: 0,- insideRendering: true,- outsideRendering: true,- material: RENDER_STAGE,- wireframe: false,- showEnv: false,-};+import { App } from "@vgpu/core";+import { createEve5Renderer } from "../app/[lang]/(home)/components/eve-logo-shader/render";+import { effectiveBloomStrength, readRenderConfig } from "./eve-render/config";+import { readNoiseTimeEnv } from "./eve-render/env";+import { loadMeshFromDisk } from "./eve-render/load-mesh";+import { buildPaintSeed } from "./eve-render/paint-fixtures";+import { maxFloat32 } from "./eve-render/report";+import { renderDefaultViews } from "./eve-render/views";async function main() {- await mkdir(OUT_DIR, { recursive: true });- const mesh = await loadMeshFromDisk(MODEL_PATH);+ const config = readRenderConfig();+ await mkdir(config.outDir, { recursive: true });+ const mesh = await loadMeshFromDisk(config.modelPath);const app = await App.create({ adapter: createNodeAdapter() });let renderer: ReturnType<typeof createEve5Renderer> | undefined;try {- renderer = createEve5Renderer(app.device, FORMAT, mesh, {- theme: THEME,- paddingRadius: PADDING_RADIUS,- bloom: BLOOM_ENABLED,+ renderer = createEve5Renderer(app.device, config.format, mesh, {+ theme: config.theme,+ paddingRadius: config.paddingRadius,+ bloom: config.bloomEnabled,});- const renderResult = await renderDefaultViews(renderer, app.device, DEFAULT_CONTROLS);+ const paintSeed = buildPaintSeed(config);+ const renderResult = await renderDefaultViews(+ renderer,+ app.device,+ config,+ config.defaultControls,+ paintSeed,+ );const log = {- runId: RUN_ID,- outDir: OUT_DIR,+ runId: config.runId,+ outDir: config.outDir,dimensions: {- width: WIDTH,- height: HEIGHT,- format: FORMAT,- theme: THEME,- stage: RENDER_STAGE,- requestedStage: REQUESTED_RENDER_STAGE,+ width: config.width,+ height: config.height,+ format: config.format,+ theme: config.theme,+ stage: config.renderStage,+ requestedStage: config.requestedRenderStage,+ dpr: config.dpr,+ envYaw: config.renderEnvYaw,+ envYawTime: config.renderEnvYawTime ?? null,},bloom: {- enabled: BLOOM_ENABLED,- runtimeRadius: BLOOM_RADIUS,- radius: PADDING_RADIUS,- strength: BLOOM_ENABLED ? effectiveBloomStrength(IMPRINT_PROGRESS ?? 0) : 0,- strengthOff: BLOOM_STRENGTH_OFF,- strengthOn: BLOOM_STRENGTH_ON,- threshold: BLOOM_THRESHOLD,- logical: { width: LOGICAL_WIDTH, height: LOGICAL_HEIGHT },- padded: { width: WIDTH, height: HEIGHT },+ enabled: config.bloomEnabled,+ runtimeRadius: config.bloomConstants.radius,+ radius: config.paddingRadius,+ strength: config.bloomEnabled+ ? effectiveBloomStrength(config, config.imprintProgress ?? 0)+ : 0,+ strengthOff: config.bloomConstants.strengthOff,+ strengthOn: config.bloomConstants.strengthOn,+ threshold: config.bloomConstants.threshold,+ logical: { width: config.logicalWidth, height: config.logicalHeight },+ padded: { width: config.width, height: config.height },},imprint:- IMPRINT_PROGRESS !== undefined+ config.imprintProgress !== undefined? {enabled: true,- progress: IMPRINT_PROGRESS,- gridScaleMultiplier: IMPRINT_GRID_SCALE_MULTIPLIER,- glyphScale: IMPRINT_GLYPH_SCALE,+ progress: config.imprintProgress,+ gridScaleMultiplier: config.imprintGridScaleMultiplier,+ glyphScale: config.imprintGlyphScale,noise: { time: readNoiseTimeEnv(), mouse: [0, 0] },stage: "front-glass-material-imprint",}: { enabled: false },+ paint: paintSeed+ ? {+ enabled: true,+ grid: { width: paintSeed.width, height: paintSeed.height },+ blob: process.env.EVE_LOGO_PAINT_BLOB ?? null,+ pattern: process.env.EVE_LOGO_PAINT_PATTERN ?? null,+ stroke: process.env.EVE_LOGO_PAINT_STROKE ?? null,+ steps: config.paintSteps,+ decaySteps: config.paintDecaySteps,+ dt: config.paintDt,+ decayPerFrame120: config.paintDecayPerFrame120,+ decayRate: config.paintDecayRate,+ diffusionRate: config.paintDiffusionRate,+ diffusionJitter: config.paintDiffusionJitter,+ brushRadius: config.paintBrushRadius,+ brushStrength: config.paintBrushStrength,+ seedMax: maxFloat32(paintSeed.values),+ }+ : { enabled: false },mesh: {vertices: mesh.positions.length / 3,triangles: mesh.indices.length / 3,@@ -140,228 +148,22 @@ async function main() {logWithOptionalBounds.bounds = renderResult.bounds;}- await writeFile(resolve(OUT_DIR, "log.json"), `${JSON.stringify(log, null, 2)}\n`);+ await writeFile(resolve(config.outDir, "log.json"), `${JSON.stringify(log, null, 2)}\n`);console.log(JSON.stringify(log, null, 2));- if (log.output.nonBlack === 0) process.exitCode = 1;+ if (+ log.output.nonBlack === 0 &&+ log.output.alpha === 0 &&+ !(+ config.renderStage === "paint-debug" &&+ (config.paintSteps > 0 || config.paintDecaySteps > 0)+ )+ )+ process.exitCode = 1;} finally {renderer?.dispose();app.device.destroy();}}-async function renderDefaultViews(- renderer: ReturnType<typeof createEve5Renderer>,- device: Awaited<ReturnType<typeof App.create>>["device"],- controls: RenderControls,-) {- const output = await renderView(renderer, device, controls, outputFileName(), WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);- await renderView(renderer, device, { ...controls, yaw: RENDER_YAW || -0.49, pitch: RENDER_YAW ? controls.pitch : 0.31 }, "rotated.png", WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);- await renderView(renderer, device, { ...controls, wireframe: true }, "wireframe.png", WIDTH, HEIGHT, LOGICAL_WIDTH, LOGICAL_HEIGHT);-- return {- files: {- output: outputFileName(),- rotated: "rotated.png",- wireframe: "wireframe.png",- log: "log.json",- },- output: pixelStats(WIDTH, HEIGHT, output),- };-}--function outputFileName() {- return IMPRINT_PROGRESS === undefined ? "output.png" : `imprint-${formatProgressForFile(IMPRINT_PROGRESS)}.png`;-}--function effectiveBloomStrength(imprintProgress: number) {- return BLOOM_STRENGTH_OFF + (BLOOM_STRENGTH_ON - BLOOM_STRENGTH_OFF) * imprintProgress;-}--function imprintOptions() {- if (IMPRINT_PROGRESS === undefined) return undefined;- return {- progress: IMPRINT_PROGRESS,- gridScaleMultiplier: IMPRINT_GRID_SCALE_MULTIPLIER,- glyphScale: IMPRINT_GLYPH_SCALE,- time: readNoiseTimeEnv(),- mouse: [0, 0] as const,- };-}--async function renderView(- renderer: ReturnType<typeof createEve5Renderer>,- device: Awaited<ReturnType<typeof App.create>>["device"],- controls: RenderControls,- file: string,- width: number,- height: number,- logicalWidth: number,- logicalHeight: number,-) {- const target = device.createTexture({- label: `eve-5-static-${file}`,- size: [width, height],- format: FORMAT,- usage: ["render_attachment", "copy_src"],- });- try {- renderer.render(target.createView(), controls, logicalWidth, logicalHeight, imprintOptions());- await device.queue.flush();- const pixels = new Uint8Array(await target.read());- await writePng(resolve(OUT_DIR, file), width, height, pixels);- return pixels;- } finally {- target.destroy();- }-}--async function loadMeshFromDisk(path: string) {- const gltf = JSON.parse(await readFile(path, "utf8"));- return decodeGltfMesh(gltf, async (uri) => {- if (uri.startsWith("data:application/octet-stream;base64,")) {- const [, payload] = uri.split(",");- return exactArrayBuffer(Buffer.from(payload!, "base64"));- }- const bufferPath = resolve(path, "..", uri);- return exactArrayBuffer(await readFile(bufferPath));- });-}--function readFiniteNumberEnv(name: string, fallback: number) {- const value = process.env[name];- if (!value) return fallback;- const parsed = Number.parseFloat(value);- if (!Number.isFinite(parsed)) {- throw new Error(`${name} must be a finite number.`);- }- return parsed;-}--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 readPositiveNumberEnv(name: string, fallback: number) {- const value = process.env[name];- if (!value) return fallback;- const parsed = Number.parseFloat(value);- if (!Number.isFinite(parsed) || parsed <= 0) {- throw new Error(`${name} must be a positive number.`);- }- return parsed;-}--function readUnitIntervalEnv(name: string) {- const value = process.env[name];- if (value === undefined || value === "") return undefined;- const parsed = Number.parseFloat(value);- if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {- throw new Error(`${name} must be a finite number between 0 and 1.`);- }- 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 readRenderStageEnv(): EveMaterial {- const values: Record<string, EveMaterial> = {- glass: "glass",- "back-albedo": "back-albedo",- "back-depth": "back-depth",- thickness: "thickness",- normal: "normal",- "camera-reflected-normal": "camera reflected normal",- metallic: "metallic",- };- const value = process.env.EVE_LOGO_RENDER_STAGE ?? "glass";- const stage = values[value];- if (!stage) {- throw new Error(`EVE_LOGO_RENDER_STAGE must be one of: ${Object.keys(values).join(", ")}.`);- }- return stage;-}--function stageFileName(stage: EveMaterial) {- return stage.replaceAll(" ", "-");-}--function formatProgressForFile(progress: number) {- return progress.toFixed(3).replace(/0+$/, "").replace(/\.$/, "").replace(".", "p");-}--function readNoiseTimeEnv() {- const value = process.env.EVE_LOGO_RENDER_NOISE_TIME;- if (!value) return 0;- const parsed = Number.parseFloat(value);- if (!Number.isFinite(parsed)) {- throw new Error("EVE_LOGO_RENDER_NOISE_TIME must be a finite number.");- }- return parsed;-}--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);-}--async function writePng(path: string, width: number, height: number, pixels: Uint8Array) {- const png = new PNG({ width, height });- png.data.set(pixels);- await writeFile(path, PNG.sync.write(png));-}--function pixelStats(width: number, height: number, pixels: Uint8Array) {- let nonBlack = 0;- let alpha = 0;- let colored = 0;-- for (let index = 0; index < pixels.length; index += 4) {- const r = pixels[index] ?? 0;- const g = pixels[index + 1] ?? 0;- const b = pixels[index + 2] ?? 0;- const a = pixels[index + 3] ?? 0;- const max = Math.max(r, g, b);- const min = Math.min(r, g, b);- if (max > 8) nonBlack++;- if (a > 20) alpha++;- if (max - min > 8 && r + g + b > 24) colored++;- }-- const header = Buffer.alloc(8);- header.writeUInt32LE(width, 0);- header.writeUInt32LE(height, 4);- const sha256 = createHash("sha256").update(header).update(pixels).digest("hex");-- return { width, height, total: width * height, nonBlack, alpha, colored, sha256 };-}-await main();