Skip to content

armgit / eve

Public Imported from GitHub
0

The Open Framework for Building Agents

Add Eve logo shader hero updates (#430)

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