Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | 51x 51x 51x 40x 40x 40x 51x 40x 40x 19x 21x 21x 21x 21x 51x | /**
* useTrainingLayout Hook - Enhanced Responsive Training Layout
*
* Custom hook for managing responsive training screen layout calculations with
* comprehensive support for all screen sizes from mobile to ultra-wide displays.
*
* Enhanced Features:
* - Five screen size categories (mobile, tablet, desktop, large, xlarge)
* - Proportional scaling for consistent sizing across devices
* - Optimized layout sizing for each device category
* - Smooth transitions for resize operations
* - 60fps performance maintained
*
* Uses robust device detection combining user-agent and screen size to ensure
* mobile controls are shown on all mobile devices, including high-resolution phones.
*
* Performance:
* - Reduces recalculations by checking only breakpoint changes, not exact dimensions
* - Memoizes layout constants to prevent cascading re-renders
* - Targets <1ms execution time for layout calculations
*
* @param width - Screen width
* @param height - Screen height
*
* @returns Layout constants and training area bounds
*
* @example
* ```typescript
* const { layoutConstants, trainingAreaBounds, isMobile, screenSize } = useTrainingLayout(1200, 800);
* ```
*/
import { useMemo } from "react";
import { shouldUseMobileControls } from "../../../../utils/deviceDetection";
import { getScreenSize } from "../../../../systems/ResponsiveScaling";
import { calculateMobileAreaBounds } from "../../../../utils/mobileLayoutHelpers";
import type { ScreenSize } from "../../../../systems/ResponsiveScaling";
export interface TrainingLayoutConstants {
readonly padding: number;
readonly headerHeight: number;
readonly buttonHeight: number;
readonly sectionSpacing: number;
readonly controlsHeight: number;
readonly footerHeight: number;
}
export interface TrainingAreaBounds {
readonly x: number;
readonly y: number;
readonly width: number;
readonly height: number;
readonly scale: number; // 3D scale factor for training area (1.0 = desktop, <1.0 = mobile)
}
export interface TrainingLayout {
readonly layoutConstants: TrainingLayoutConstants;
readonly trainingAreaBounds: TrainingAreaBounds;
readonly isMobile: boolean;
readonly screenSize: ScreenSize;
}
/**
* Custom hook for training screen layout calculations
* Enhanced with centralized responsive scaling system
* Optimized to reduce recalculations and improve 60fps performance
*/
export function useTrainingLayout(width: number, height: number): TrainingLayout {
// Determine screen size category using centralized scaling system
const screenSize = useMemo(() => getScreenSize(width), [width]);
// Device detection has its own internal caching based on screen dimensions
// No need for additional React memoization here
const isMobile = shouldUseMobileControls();
// Centralized layout constants for easier tweaking
// Enhanced with tablet-specific values for better responsive support
const layoutConstants = useMemo<TrainingLayoutConstants>(() => {
// Determine if large desktop
const isLargeDesktop = screenSize === 'xlarge';
const isTablet = screenSize === 'tablet';
return {
padding: isMobile ? 20 : isTablet ? 25 : isLargeDesktop ? 35 : 30,
headerHeight: isMobile ? 80 : isTablet ? 90 : isLargeDesktop ? 110 : 100,
buttonHeight: isMobile ? 45 : isTablet ? 50 : isLargeDesktop ? 60 : 55,
sectionSpacing: isMobile ? 15 : isTablet ? 18 : isLargeDesktop ? 25 : 20,
controlsHeight: isMobile ? 120 : isTablet ? 110 : isLargeDesktop ? 150 : 130,
footerHeight: isMobile ? 60 : isTablet ? 70 : isLargeDesktop ? 90 : 80,
};
}, [isMobile, screenSize]);
// Training area bounds should account for header at top and controls at bottom
// Mobile training area sizing adapts to device resolution
const trainingAreaBounds = useMemo<TrainingAreaBounds>(() => {
const areaY = layoutConstants.headerHeight + layoutConstants.padding;
// Mobile-specific training area sizing for better screen fit
if (isMobile) {
// Use shared mobile area calculation for consistency with combat screen
return calculateMobileAreaBounds(
width,
height,
80, // minTopClearance (header space)
120, // minBottomClearance (controls space)
areaY
);
}
// Desktop training area sizing - use full available space
const totalReservedHeight =
layoutConstants.headerHeight +
layoutConstants.controlsHeight +
layoutConstants.footerHeight;
const totalPadding = layoutConstants.padding * 3;
const areaHeight = height - totalReservedHeight - totalPadding;
return {
x: width * 0.1,
y: areaY,
width: width * 0.8,
height: areaHeight,
scale: 1.0, // Desktop uses full scale
};
}, [width, height, layoutConstants, isMobile]);
return {
layoutConstants,
trainingAreaBounds,
isMobile,
screenSize,
};
}
|