Create professional demos and 3D mockups in seconds, directly in your browser
feat: refine Preview3DConfig and ZoomFragment interfaces for improved clarity and structure
CristianOlivera1b2d5aedf0c79
diff --git a/types/photo.types.ts b/types/photo.types.tsindex a04b22b..64f0744 100644--- a/types/photo.types.ts+++ b/types/photo.types.ts@@ -11,27 +11,16 @@ export interface Preview3DConfig {perspective?: number;}-// Configuraciones 3D estáticas e inmutables para los previews-// Estas configuraciones NUNCA deben cambiar, independientemente del estado del canvasexport const PREVIEW_CONFIGS: readonly Preview3DConfig[] = Object.freeze([Object.freeze({ id: "front", label: "Front", rotateX: 0, rotateY: 0, rotateZ: 0, translateY: 0, scale: 0.9, perspective: 600 }),- Object.freeze({ id: "tilt-up", label: "Tilt Up", rotateX: 15, rotateY: 0, rotateZ: 0, translateY: -2, scale: 0.88, perspective: 500 }),Object.freeze({ id: "top-left-angle", label: "Top Left Angle", rotateX: 18, rotateY: 25, rotateZ: -15, translateY: -10, scale: 0.95, perspective: 500 }),Object.freeze({ id: "top-right-angle", label: "Top Right Angle", rotateX: 18, rotateY: -22, rotateZ: 15, translateY: 5, scale: 0.95, perspective: 500 }),+ Object.freeze({ id: "bottom-left-angle", label: "Bottom Left Angle", rotateX: -18, rotateY: 25, rotateZ: 15, translateY: -5, scale: 0.95, perspective: 500 }),+ Object.freeze({ id: "bottom-right-angle", label: "Bottom Right Angle", rotateX: -18, rotateY: -22, rotateZ: -15, translateY: -5, scale: 0.95, perspective: 500 }),+ Object.freeze({ id: "isometric", label: "Isometric", rotateX: 35, rotateY: -45, rotateZ: 10, translateY: 0, scale: 0.85, perspective: 1000 }), Object.freeze({ id: "tilt-up", label: "Tilt Up", rotateX: 15, rotateY: 0, rotateZ: 0, translateY: -2, scale: 0.88, perspective: 500 }),+ Object.freeze({ id: "tilt-down", label: "Tilt Down", rotateX: -15, rotateY: 0, rotateZ: 0, translateY: 2, scale: 0.88, perspective: 500 }),]);-// Configuración estática para previews de mask (siempre en posición frontal)-export const PREVIEW_FRONT_CONFIG: Readonly<Preview3DConfig> = Object.freeze({- id: "front",- label: "Front",- rotateX: 0,- rotateY: 0,- rotateZ: 0,- translateY: 0,- scale: 0.9,- perspective: 600,-});-export interface ImageMaskConfig {enabled: boolean;top?: { from: number; to?: number };@@ -50,7 +39,6 @@ export const DEFAULT_MASK_CONFIG: ImageMaskConfig = {export interface PhotoEditorPlaceholderProps {className?: string;canvasImageUrl?: string | null;- /** Raw uploaded image URL (no canvas effects). Used as static reference in preview cards. */staticImageUrl?: string | null;onSelectPreview?: (config: Preview3DConfig) => void;selectedPreviewId?: string;diff --git a/types/zoom.types.ts b/types/zoom.types.tsindex 725d65a..6b323ca 100644--- a/types/zoom.types.ts+++ b/types/zoom.types.ts@@ -2,27 +2,21 @@ import { VideoThumbnail } from "./editor.types";export interface ZoomFragment {id: string;- startTime: number; // Tiempo de inicio del fragmento (segundos)- endTime: number; // Tiempo de fin del fragmento (segundos)- zoomLevel: number; // Nivel de zoom (1-10, donde 5 = 2x)- speed: number; // Velocidad de animación entrada/salida (1-10)- focusX: number; // Punto de enfoque inicial X (0-100%)- focusY: number; // Punto de enfoque inicial Y (0-100%)-- // 3-Phase System: Entry → Hold with Pan Movement → Exit- // When movementEnabled is false, it's simple zoom in/out (CSS handles transitions)- movementEnabled?: boolean; // Enable dynamic hold phase with panning- movementEndX?: number; // Destination X after panning (0-100%)- movementEndY?: number; // Destination Y after panning (0-100%)- // Movement timing within hold period (0 = hold start, holdDuration = hold end)- movementStartOffset?: number; // When movement starts (seconds from hold start)- movementEndOffset?: number; // When movement ends (seconds from hold start)-- // 3D perspective effect during zoom- enable3D?: boolean; // Enable 3D perspective effect- perspective3DIntensity?: number; // 0-100: intensity of 3D effect (default 50)- perspective3DAngleX?: number; // -45 to 45: tilt angle X direction (default: auto from focus)- perspective3DAngleY?: number; // -45 to 45: tilt angle Y direction (default: auto from focus)+ startTime: number;+ endTime: number;+ zoomLevel: number;+ speed: number;+ focusX: number;+ focusY: number;+ movementEnabled?: boolean;+ movementEndX?: number;+ movementEndY?: number;+ movementStartOffset?: number;+ movementEndOffset?: number;+ enable3D?: boolean;+ perspective3DIntensity?: number;+ perspective3DAngleX?: number;+ perspective3DAngleY?: number;}export interface ZoomState {@@ -57,19 +51,12 @@ export interface ZoomPhaseState {scale: number;focusX: number;focusY: number;- progress: number; // 0-1 progress within current phase- // 3D effect values- rotateX: number; // degrees- rotateY: number; // degrees- perspective: number; // px (0 = no perspective)+ progress: number;+ rotateX: number;+ rotateY: number;+ perspective: number;}-/**- * Calculate zoom phase state for both preview and export- * @param fragment - The zoom fragment configuration- * @param currentTime - Current playback time in seconds- * @param forExport - If true, calculates animated scale (for canvas export). If false, returns target scale (CSS handles animation)- */export function calculateZoomPhaseState(fragment: ZoomFragment,currentTime: number,@@ -82,23 +69,20 @@ export function calculateZoomPhaseState(const targetScale = zoomLevelToFactor(fragment.zoomLevel);const enable3D = fragment.enable3D ?? false;- // Calculate transition timingconst transitionSeconds = speedToTransitionMs(fragment.speed) / 1000;const entryEndTime = fragment.startTime + transitionSeconds;const exitStartTime = fragment.endTime - transitionSeconds;const holdDuration = Math.max(0, exitStartTime - entryEndTime);- // Initialize statelet rotateX = 0;let rotateY = 0;let perspective = 0;- let scale = forExport ? 1 : targetScale; // For preview, CSS handles animation+ let scale = forExport ? 1 : targetScale;let focusX = fragment.focusX;let focusY = fragment.focusY;let phase: 'entry' | 'hold' | 'exit' = 'hold';let progress = normalizedTime;- // Movement end pointsconst movementEndX = fragment.movementEndX ?? fragment.focusX;const movementEndY = fragment.movementEndY ?? fragment.focusY;@@ -125,21 +109,18 @@ export function calculateZoomPhaseState(scale = targetScale - (targetScale - 1) * easedProgress;}- // Focus should be at movement end if movement was enabledif (fragment.movementEnabled) {focusX = movementEndX;focusY = movementEndY;}} else {- // HOLD PHASE: Maintain zoom, handle movementphase = 'hold';if (forExport) {scale = targetScale;}- // Handle camera movement during holdif (fragment.movementEnabled && holdDuration > 0) {const movementStartOffset = fragment.movementStartOffset ?? 0;const movementEndOffset = fragment.movementEndOffset ?? holdDuration;@@ -163,24 +144,19 @@ export function calculateZoomPhaseState(}// 3D EFFECT: Completely separate from zoom animation- // Professional approach: subtle static perspective that fades in/out smoothlyif (enable3D) {- const intensity = (fragment.perspective3DIntensity ?? 50) / 100; // 0-1 range+ const intensity = (fragment.perspective3DIntensity ?? 50) / 100;- // Get user-configured angles (default to 0 for neutral, user picks direction)const baseAngleX = fragment.perspective3DAngleX ?? 0;const baseAngleY = fragment.perspective3DAngleY ?? 0;- // Calculate 3D opacity based on phase for smooth transitionslet effect3DOpacity = 0;if (phase === 'entry') {const entryProgress = (currentTime - fragment.startTime) / transitionSeconds;- // El 3D arranca desde el inicio de la entry, sin umbral- effect3DOpacity = Math.min(1, entryProgress * 1.2); // llega a 1 antes del final de entry+ effect3DOpacity = Math.min(1, entryProgress * 1.2);} else if (phase === 'exit') {const exitProgress = (currentTime - exitStartTime) / transitionSeconds;- // El 3D se va durante toda la exiteffect3DOpacity = Math.max(0, 1 - exitProgress * 1.8);} else {effect3DOpacity = 1;@@ -188,9 +164,8 @@ export function calculateZoomPhaseState(// Apply 3D with smooth easingconst smoothOpacity = easeInOutQuart(effect3DOpacity);- perspective = 500; // Distancia de perspectiva fija para un efecto sutil y profesional+ perspective = 500;- // Intensidad de rotacionconst maxRotation = 32 * intensity;rotateX = (baseAngleX / 45) * maxRotation * smoothOpacity;rotateY = (baseAngleY / 45) * maxRotation * smoothOpacity;@@ -209,7 +184,6 @@ export function calculateZoomPhaseState(}// Calculate available hold time for camera movement-// Hold time = fragment duration - entry transition - exit transitionexport function calculateHoldDuration(fragment: ZoomFragment): number {const totalDuration = fragment.endTime - fragment.startTime;const transitionSeconds = speedToTransitionMs(fragment.speed) / 1000;@@ -228,11 +202,10 @@ export interface ZoomState {focusY: number;}-const DEFAULT_ZOOM_LEVEL = 1.5; // 2x zoom-const DEFAULT_ZOOM_SPEED = 4; // Medium speed+const DEFAULT_ZOOM_LEVEL = 1.5;+const DEFAULT_ZOOM_SPEED = 5;// Helper para crear un nuevo fragmento con valores por defecto-// By default, creates a simple zoom in/out fragment without camera movementexport function createZoomFragment(startTime: number,endTime: number@@ -245,7 +218,6 @@ export function createZoomFragment(speed: DEFAULT_ZOOM_SPEED,focusX: 50,focusY: 50,- // 3-phase movement disabled by default (simple zoom in/out)movementEnabled: false,};}@@ -261,14 +233,12 @@ export function generateDefaultZoomFragments(const fragments: ZoomFragment[] = [];- // Primer fragmento en el primer tercioconst start1 = Math.max(0, spacing * 0.5);fragments.push(createZoomFragment(start1,Math.min(start1 + fragmentDuration, videoDuration)));- // Segundo fragmento en el segundo tercioconst start2 = Math.max(0, spacing * 2);fragments.push(createZoomFragment(start2,@@ -282,22 +252,20 @@ export function generateDefaultZoomFragments(export function zoomLevelToFactor(level: number): number {const minZoom = 1.2;const maxZoom = 4.0;- const normalized = (level - 1) / 9; // 0 to 1+ const normalized = (level - 1) / 9;return minZoom + (maxZoom - minZoom) * normalized;}// Convertir speed (1-10) a duración de transición en milisegundosexport function speedToTransitionMs(speed: number): number {- const minMs = 150; // Speed 10- const maxMs = 2000; // Speed 1- const normalized = (speed - 1) / 9; // 0 to 1+ const minMs = 150;+ const maxMs = 2000;+ const normalized = (speed - 1) / 9;return Math.round(maxMs - (maxMs - minMs) * normalized);}-// Easing suave para animaciones de zoom (cubic-bezier)export const ZOOM_EASING = 'cubic-bezier(0.4, 0, 0.2, 1)';-// Formatear tiempo para mostrar en UI (MM:SS)export function formatZoomTime(seconds: number): string {const mins = Math.floor(seconds / 60);const secs = Math.floor(seconds % 60);