@buildcores/render-client 1.1.0 → 1.3.0

package/README.md

@@ -69,6 +69,9 @@ interface RenderBuildRequest {
   parts: {
     [K in PartCategory]?: string[];
   };
+  format?: "video" | "sprite";
+  width?: number;  // Optional: Canvas pixel width (256-2000)
+  height?: number; // Optional: Canvas pixel height (256-2000)
 }
 
 // Available part categories
@@ -86,6 +89,8 @@ enum PartCategory {
 
 **Current Limitation**: Each category array must contain exactly one part ID. Multiple parts per category will be supported in future versions.
 
+**Resolution Control**: You can specify custom `width` and `height` (both must be provided together, 256-2000 pixels) for higher or lower quality renders. If not specified, the default resolution is used.
+
 #### Examples
 
 **Complete Build (All Components)**
@@ -119,6 +124,27 @@ const caseOnly = {
 <BuildRender parts={caseOnly} size={500} />;
 ```
 
+**Custom Resolution (High Quality)**
+
+```tsx
+const highResBuild = {
+  parts: {
+    CPU: ["7xjqsomhr"],
+    GPU: ["z7pyphm9k"],
+    RAM: ["dpl1iyvb5"],
+    Motherboard: ["iwin2u9vx"],
+    PSU: ["m4kilv190"],
+    Storage: ["0bkvs17po"],
+    PCCase: ["qq9jamk7c"],
+    CPUCooler: ["62d8zelr5"],
+  },
+  width: 1920,   // Custom resolution width
+  height: 1080,  // Custom resolution height
+};
+
+<BuildRender parts={highResBuild} size={500} />;
+```
+
 ### `getAvailableParts()` Function
 
 Fetches all available PC parts from the BuildCores API.

package/dist/hooks/useZoomPan.d.ts

@@ -0,0 +1,16 @@
+import { type TouchEvent as ReactTouchEvent, type WheelEvent as ReactWheelEvent } from "react";
+interface UseZoomOptions {
+    displayWidth?: number;
+    displayHeight?: number;
+    minScale?: number;
+    maxScale?: number;
+}
+interface UseZoomReturn {
+    scale: number;
+    isPinching: boolean;
+    handleWheel: (event: ReactWheelEvent<Element>) => void;
+    handleTouchStart: (event: ReactTouchEvent<HTMLCanvasElement>) => boolean;
+    reset: () => void;
+}
+export declare const useZoomPan: ({ displayWidth, displayHeight, minScale, maxScale, }?: UseZoomOptions) => UseZoomReturn;
+export {};

package/dist/index.d.ts

@@ -340,6 +340,58 @@ interface RenderBuildRequest {
      * @default "video"
      */
     format?: "video" | "sprite";
+    /**
+     * Desired canvas pixel width (256-2000).
+     * Must be provided together with height.
+     *
+     * @example
+     * ```tsx
+     * const request: RenderBuildRequest = {
+     *   parts: { CPU: ["7xjqsomhr"] },
+     *   width: 1920,
+     *   height: 1080
+     * };
+     * ```
+     */
+    width?: number;
+    /**
+     * Desired canvas pixel height (256-2000).
+     * Must be provided together with width.
+     *
+     * @example
+     * ```tsx
+     * const request: RenderBuildRequest = {
+     *   parts: { CPU: ["7xjqsomhr"] },
+     *   width: 1920,
+     *   height: 1080
+     * };
+     * ```
+     */
+    height?: number;
+    /**
+     * Render quality profile that controls visual effects and rendering speed.
+     *
+     * - **cinematic**: All effects enabled (shadows, ambient occlusion, bloom) for highest quality
+     * - **flat**: No effects for clean, simple product shots
+     * - **fast**: Minimal rendering for fastest processing speed
+     *
+     * @example
+     * ```tsx
+     * const request: RenderBuildRequest = {
+     *   parts: { CPU: ["7xjqsomhr"] },
+     *   profile: 'cinematic'  // High quality with all effects
+     * };
+     * ```
+     *
+     * @example Fast rendering
+     * ```tsx
+     * const request: RenderBuildRequest = {
+     *   parts: { CPU: ["7xjqsomhr"] },
+     *   profile: 'fast'  // Quick render, minimal effects
+     * };
+     * ```
+     */
+    profile?: 'cinematic' | 'flat' | 'fast';
 }
 /**
  * Response structure containing all available parts for each category.

package/dist/index.esm.js

@@ -1,5 +1,6 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { useState, useRef, useCallback, useEffect, createContext, useContext } from 'react';
+import { useState, useRef, useCallback, useEffect } from 'react';
+import { useAnimationFrame } from 'framer-motion';
 
 // Helper to extract clientX from mouse or touch events
 const getClientX$1 = (e) => {
@@ -102,186 +103,6 @@ const useSpriteScrubbing = (canvasRef, totalFrames, options = {}) => {
     };
 };
 
-/**
- * @public
- */
-const MotionConfigContext = createContext({
-    transformPagePoint: (p) => p,
-    isStatic: false,
-    reducedMotion: "never",
-});
-
-/*#__NO_SIDE_EFFECTS__*/
-const noop = (any) => any;
-
-if (process.env.NODE_ENV !== "production") ;
-
-function createRenderStep(runNextFrame) {
-    /**
-     * We create and reuse two queues, one to queue jobs for the current frame
-     * and one for the next. We reuse to avoid triggering GC after x frames.
-     */
-    let thisFrame = new Set();
-    let nextFrame = new Set();
-    /**
-     * Track whether we're currently processing jobs in this step. This way
-     * we can decide whether to schedule new jobs for this frame or next.
-     */
-    let isProcessing = false;
-    let flushNextFrame = false;
-    /**
-     * A set of processes which were marked keepAlive when scheduled.
-     */
-    const toKeepAlive = new WeakSet();
-    let latestFrameData = {
-        delta: 0.0,
-        timestamp: 0.0,
-        isProcessing: false,
-    };
-    function triggerCallback(callback) {
-        if (toKeepAlive.has(callback)) {
-            step.schedule(callback);
-            runNextFrame();
-        }
-        callback(latestFrameData);
-    }
-    const step = {
-        /**
-         * Schedule a process to run on the next frame.
-         */
-        schedule: (callback, keepAlive = false, immediate = false) => {
-            const addToCurrentFrame = immediate && isProcessing;
-            const queue = addToCurrentFrame ? thisFrame : nextFrame;
-            if (keepAlive)
-                toKeepAlive.add(callback);
-            if (!queue.has(callback))
-                queue.add(callback);
-            return callback;
-        },
-        /**
-         * Cancel the provided callback from running on the next frame.
-         */
-        cancel: (callback) => {
-            nextFrame.delete(callback);
-            toKeepAlive.delete(callback);
-        },
-        /**
-         * Execute all schedule callbacks.
-         */
-        process: (frameData) => {
-            latestFrameData = frameData;
-            /**
-             * If we're already processing we've probably been triggered by a flushSync
-             * inside an existing process. Instead of executing, mark flushNextFrame
-             * as true and ensure we flush the following frame at the end of this one.
-             */
-            if (isProcessing) {
-                flushNextFrame = true;
-                return;
-            }
-            isProcessing = true;
-            [thisFrame, nextFrame] = [nextFrame, thisFrame];
-            // Execute this frame
-            thisFrame.forEach(triggerCallback);
-            // Clear the frame so no callbacks remain. This is to avoid
-            // memory leaks should this render step not run for a while.
-            thisFrame.clear();
-            isProcessing = false;
-            if (flushNextFrame) {
-                flushNextFrame = false;
-                step.process(frameData);
-            }
-        },
-    };
-    return step;
-}
-
-const stepsOrder = [
-    "read", // Read
-    "resolveKeyframes", // Write/Read/Write/Read
-    "update", // Compute
-    "preRender", // Compute
-    "render", // Write
-    "postRender", // Compute
-];
-const maxElapsed = 40;
-function createRenderBatcher(scheduleNextBatch, allowKeepAlive) {
-    let runNextFrame = false;
-    let useDefaultElapsed = true;
-    const state = {
-        delta: 0.0,
-        timestamp: 0.0,
-        isProcessing: false,
-    };
-    const flagRunNextFrame = () => (runNextFrame = true);
-    const steps = stepsOrder.reduce((acc, key) => {
-        acc[key] = createRenderStep(flagRunNextFrame);
-        return acc;
-    }, {});
-    const { read, resolveKeyframes, update, preRender, render, postRender } = steps;
-    const processBatch = () => {
-        const timestamp = performance.now();
-        runNextFrame = false;
-        state.delta = useDefaultElapsed
-            ? 1000 / 60
-            : Math.max(Math.min(timestamp - state.timestamp, maxElapsed), 1);
-        state.timestamp = timestamp;
-        state.isProcessing = true;
-        // Unrolled render loop for better per-frame performance
-        read.process(state);
-        resolveKeyframes.process(state);
-        update.process(state);
-        preRender.process(state);
-        render.process(state);
-        postRender.process(state);
-        state.isProcessing = false;
-        if (runNextFrame && allowKeepAlive) {
-            useDefaultElapsed = false;
-            scheduleNextBatch(processBatch);
-        }
-    };
-    const wake = () => {
-        runNextFrame = true;
-        useDefaultElapsed = true;
-        if (!state.isProcessing) {
-            scheduleNextBatch(processBatch);
-        }
-    };
-    const schedule = stepsOrder.reduce((acc, key) => {
-        const step = steps[key];
-        acc[key] = (process, keepAlive = false, immediate = false) => {
-            if (!runNextFrame)
-                wake();
-            return step.schedule(process, keepAlive, immediate);
-        };
-        return acc;
-    }, {});
-    const cancel = (process) => {
-        for (let i = 0; i < stepsOrder.length; i++) {
-            steps[stepsOrder[i]].cancel(process);
-        }
-    };
-    return { schedule, cancel, state, steps };
-}
-
-const { schedule: frame, cancel: cancelFrame} = createRenderBatcher(typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : noop, true);
-
-function useAnimationFrame(callback) {
-    const initialTimestamp = useRef(0);
-    const { isStatic } = useContext(MotionConfigContext);
-    useEffect(() => {
-        if (isStatic)
-            return;
-        const provideTimeSinceStart = ({ timestamp, delta }) => {
-            if (!initialTimestamp.current)
-                initialTimestamp.current = timestamp;
-            callback(timestamp - initialTimestamp.current, delta);
-        };
-        frame.update(provideTimeSinceStart, true);
-        return () => cancelFrame(provideTimeSinceStart);
-    }, [callback]);
-}
-
 function useBouncePatternProgress(enabled = true) {
     const [value, setValue] = useState(0);
     const [isBouncing, setIsBouncing] = useState(false);
@@ -353,6 +174,11 @@ const renderBuildExperimental = async (request, config) => {
     const requestWithFormat = {
         ...request,
         format: request.format || "video", // Default to video format
+        // Include width and height if provided
+        ...(request.width !== undefined ? { width: request.width } : {}),
+        ...(request.height !== undefined ? { height: request.height } : {}),
+        // Include profile if provided
+        ...(request.profile ? { profile: request.profile } : {}),
     };
     const response = await fetch(buildApiUrl(API_ENDPOINTS.RENDER_BUILD_EXPERIMENTAL, config), {
         method: "POST",
@@ -377,6 +203,11 @@ const createRenderBuildJob = async (request, config) => {
         parts: request.parts,
         // If provided, forward format; default handled server-side but we keep explicit default
         ...(request.format ? { format: request.format } : {}),
+        // Include width and height if provided
+        ...(request.width !== undefined ? { width: request.width } : {}),
+        ...(request.height !== undefined ? { height: request.height } : {}),
+        // Include profile if provided
+        ...(request.profile ? { profile: request.profile } : {}),
     };
     const response = await fetch(buildApiUrl(API_ENDPOINTS.RENDER_BUILD, config), {
         method: "POST",
@@ -437,6 +268,11 @@ const renderSpriteExperimental = async (request, config) => {
     const requestWithFormat = {
         ...request,
         format: "sprite",
+        // Include width and height if provided
+        ...(request.width !== undefined ? { width: request.width } : {}),
+        ...(request.height !== undefined ? { height: request.height } : {}),
+        // Include profile if provided
+        ...(request.profile ? { profile: request.profile } : {}),
     };
     const response = await fetch(buildApiUrl(API_ENDPOINTS.RENDER_BUILD_EXPERIMENTAL, config), {
         method: "POST",
@@ -738,8 +574,101 @@ const InstructionTooltip = ({ isVisible, progressValue, instructionIcon, }) => {
             } })) }));
 };
 
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+const getTouchDistance = (touches) => {
+    const first = touches[0];
+    const second = touches[1];
+    if (!first || !second)
+        return 0;
+    return Math.hypot(second.clientX - first.clientX, second.clientY - first.clientY);
+};
+const useZoomPan = ({ displayWidth, displayHeight, minScale = 1, maxScale = 4, } = {}) => {
+    const [scale, setScale] = useState(1);
+    const [isPinching, setIsPinching] = useState(false);
+    const scaleRef = useRef(1);
+    const pinchDataRef = useRef({
+        initialDistance: 0,
+        initialScale: 1,
+    });
+    const setScaleSafe = useCallback((next) => {
+        const clamped = clamp(next, minScale, maxScale);
+        if (clamped === scaleRef.current)
+            return;
+        scaleRef.current = clamped;
+        setScale(clamped);
+    }, [minScale, maxScale]);
+    const handleWheel = useCallback((event) => {
+        event.preventDefault();
+        event.stopPropagation();
+        const deltaY = event.deltaMode === 1
+            ? event.deltaY * 16
+            : event.deltaMode === 2
+                ? event.deltaY * (displayHeight ?? 300)
+                : event.deltaY;
+        const zoomFactor = Math.exp(-deltaY * 0.0015);
+        const nextScale = scaleRef.current * zoomFactor;
+        setScaleSafe(nextScale);
+    }, [setScaleSafe, displayHeight]);
+    const handleTouchStart = useCallback((event) => {
+        if (event.touches.length < 2) {
+            return false;
+        }
+        const distance = getTouchDistance(event.touches);
+        if (!distance) {
+            return false;
+        }
+        pinchDataRef.current = {
+            initialDistance: distance,
+            initialScale: scaleRef.current,
+        };
+        setIsPinching(true);
+        event.preventDefault();
+        return true;
+    }, []);
+    useEffect(() => {
+        if (!isPinching)
+            return;
+        const handleMove = (event) => {
+            if (event.touches.length < 2)
+                return;
+            const distance = getTouchDistance(event.touches);
+            if (!distance || pinchDataRef.current.initialDistance === 0)
+                return;
+            const scaleFactor = distance / pinchDataRef.current.initialDistance;
+            const nextScale = pinchDataRef.current.initialScale * scaleFactor;
+            setScaleSafe(nextScale);
+            event.preventDefault();
+        };
+        const handleEnd = (event) => {
+            if (event.touches.length < 2) {
+                setIsPinching(false);
+            }
+        };
+        window.addEventListener("touchmove", handleMove, { passive: false });
+        window.addEventListener("touchend", handleEnd);
+        window.addEventListener("touchcancel", handleEnd);
+        return () => {
+            window.removeEventListener("touchmove", handleMove);
+            window.removeEventListener("touchend", handleEnd);
+            window.removeEventListener("touchcancel", handleEnd);
+        };
+    }, [isPinching, setScaleSafe]);
+    const reset = useCallback(() => {
+        scaleRef.current = 1;
+        setScale(1);
+    }, []);
+    return {
+        scale,
+        isPinching,
+        handleWheel,
+        handleTouchStart,
+        reset,
+    };
+};
+
 const BuildRender = ({ parts, width, height, size, apiConfig, useSpriteRenderOptions, mouseSensitivity = 0.2, touchSensitivity = 0.2, }) => {
     const canvasRef = useRef(null);
+    const containerRef = useRef(null);
     const [img, setImg] = useState(null);
     const [isLoading, setIsLoading] = useState(true);
     const [bouncingAllowed, setBouncingAllowed] = useState(false);
@@ -752,6 +681,10 @@ const BuildRender = ({ parts, width, height, size, apiConfig, useSpriteRenderOpt
     const cols = spriteMetadata ? spriteMetadata.cols : 12;
     const rows = spriteMetadata ? spriteMetadata.rows : 6;
     const frameRef = useRef(0);
+    const { scale, handleWheel: handleZoomWheel, handleTouchStart: handleZoomTouchStart, reset: resetZoom, } = useZoomPan({
+        displayWidth: displayW,
+        displayHeight: displayH,
+    });
     // Image/frame sizes
     const frameW = img ? img.width / cols : 0;
     const frameH = img ? img.height / rows : 0;
@@ -810,8 +743,12 @@ const BuildRender = ({ parts, width, height, size, apiConfig, useSpriteRenderOpt
         ctx.clearRect(0, 0, targetW, targetH);
         ctx.imageSmoothingEnabled = true;
         ctx.imageSmoothingQuality = "high";
-        ctx.drawImage(img, sx, sy, sw, sh, 0, 0, targetW, targetH);
-    }, [img, frameW, frameH, displayW, displayH, cols, total]);
+        const scaledW = targetW * scale;
+        const scaledH = targetH * scale;
+        const offsetX = -((scaledW - targetW) / 2);
+        const offsetY = -((scaledH - targetH) / 2);
+        ctx.drawImage(img, sx, sy, sw, sh, offsetX, offsetY, scaledW, scaledH);
+    }, [img, frameW, frameH, displayW, displayH, cols, total, scale]);
     const { isDragging, handleMouseDown, handleTouchStart, hasDragged } = useSpriteScrubbing(canvasRef, total, {
         mouseSensitivity,
         touchSensitivity,
@@ -833,18 +770,66 @@ const BuildRender = ({ parts, width, height, size, apiConfig, useSpriteRenderOpt
         frameRef.current = frame;
         draw(frame);
     }, [progressValue, hasDragged, img, total, draw]);
-    // Initial draw once image is ready
+    // Reset zoom when sprite changes or container size updates
+    useEffect(() => {
+        resetZoom();
+    }, [spriteSrc, displayW, displayH, resetZoom]);
+    // Add native wheel event listener to prevent scrolling AND handle zoom
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        const handleNativeWheel = (event) => {
+            event.preventDefault();
+            event.stopPropagation();
+            // Manually trigger zoom since we're preventing the React event
+            event.deltaMode === 1
+                ? event.deltaY * 16
+                : event.deltaMode === 2
+                    ? event.deltaY * (displayH ?? 300)
+                    : event.deltaY;
+            // We need to call the zoom handler directly
+            // Create a synthetic React event-like object
+            const syntheticEvent = {
+                preventDefault: () => { },
+                stopPropagation: () => { },
+                deltaY: event.deltaY,
+                deltaMode: event.deltaMode,
+                currentTarget: container,
+            };
+            handleZoomWheel(syntheticEvent);
+            hasDragged.current = true;
+        };
+        // Add listener to container to catch all wheel events
+        container.addEventListener('wheel', handleNativeWheel, { passive: false });
+        return () => {
+            container.removeEventListener('wheel', handleNativeWheel);
+        };
+    }, [handleZoomWheel, scale, displayH]);
+    // Initial draw once image is ready or zoom changes
     useEffect(() => {
         if (img && !isLoading) {
             draw(frameRef.current);
         }
     }, [img, isLoading, draw]);
-    return (jsxs("div", { style: {
+    const handleCanvasTouchStart = useCallback((event) => {
+        if (handleZoomTouchStart(event)) {
+            hasDragged.current = true;
+            return;
+        }
+        handleTouchStart(event);
+    }, [handleZoomTouchStart, handleTouchStart, hasDragged]);
+    useCallback((event) => {
+        hasDragged.current = true;
+        handleZoomWheel(event);
+    }, [handleZoomWheel, hasDragged]);
+    return (jsxs("div", { ref: containerRef, style: {
             position: "relative",
             width: displayW,
             height: displayH,
             backgroundColor: "black",
-        }, children: [img && (jsx("canvas", { ref: canvasRef, onMouseDown: handleMouseDown, onTouchStart: handleTouchStart, style: {
+            overflow: "hidden",
+        }, children: [img && (jsx("canvas", { ref: canvasRef, onMouseDown: handleMouseDown, onTouchStart: handleCanvasTouchStart, style: {
                     width: displayW,
                     height: displayH,
                     cursor: isDragging ? "grabbing" : "grab",