blacktrigram 0.7.2

package/lib/components/screens/training/hooks/useTrainingState.js

@@ -0,0 +1,344 @@
+import { useCallback, useMemo, useReducer } from "react";
+//#region src/components/screens/training/hooks/useTrainingState.ts
+/**
+* useTrainingState Hook - Consolidated Training State Management
+*
+* Custom hook for managing training state using useReducer.
+* Mirrors useCombatState pattern for consistency.
+*
+* @korean 훈련상태관리훅 - useReducer를 사용한 통합 훈련 상태 관리
+*/
+/**
+* Initial training state
+*/
+var initialState = {
+	trainingMode: "basics",
+	isTraining: false,
+	selectedVitalPoint: null,
+	feedback: "",
+	showFeedback: false,
+	hitEffects: [],
+	nextEffectId: 0,
+	dummyHealth: 100,
+	sessionStartTime: null,
+	sessionDuration: 0,
+	perfectStrikes: 0,
+	bestCombo: 0,
+	stats: {
+		score: 0,
+		combo: 0,
+		hits: 0,
+		misses: 0,
+		accuracy: 0
+	},
+	currentStanceIndex: 0,
+	stanceWheelExpanded: false,
+	visibleAnatomyLayers: [],
+	footworkDrillActive: false,
+	footworkDrillType: "circular_left",
+	footworkDrillStep: 0
+};
+/**
+* Training state reducer
+*/
+function trainingReducer(state, action) {
+	switch (action.type) {
+		case "SET_TRAINING_MODE": return {
+			...state,
+			trainingMode: action.payload
+		};
+		case "START_TRAINING": return {
+			...state,
+			isTraining: true,
+			sessionStartTime: Date.now(),
+			dummyHealth: 100,
+			perfectStrikes: 0,
+			bestCombo: 0,
+			stats: {
+				score: 0,
+				combo: 0,
+				hits: 0,
+				misses: 0,
+				accuracy: 0
+			},
+			feedback: "훈련 시작! | Training Start!",
+			showFeedback: true
+		};
+		case "STOP_TRAINING": return {
+			...state,
+			isTraining: false,
+			sessionStartTime: null,
+			sessionDuration: 0,
+			feedback: "훈련 종료 | Training End",
+			showFeedback: true
+		};
+		case "SET_SELECTED_VITAL_POINT": return {
+			...state,
+			selectedVitalPoint: action.payload
+		};
+		case "SET_FEEDBACK": return {
+			...state,
+			feedback: action.payload.feedback,
+			showFeedback: action.payload.show
+		};
+		case "HIDE_FEEDBACK": return {
+			...state,
+			showFeedback: false
+		};
+		case "ADD_HIT_EFFECT": return {
+			...state,
+			hitEffects: [...state.hitEffects, {
+				...action.payload,
+				id: state.nextEffectId
+			}],
+			nextEffectId: state.nextEffectId + 1
+		};
+		case "REMOVE_HIT_EFFECT": return {
+			...state,
+			hitEffects: state.hitEffects.filter((e) => e.id !== action.payload)
+		};
+		case "SET_DUMMY_HEALTH": return {
+			...state,
+			dummyHealth: action.payload
+		};
+		case "RESET_DUMMY": return {
+			...state,
+			dummyHealth: 100,
+			feedback: "더미 재설정 | Dummy Reset",
+			showFeedback: true
+		};
+		case "UPDATE_SESSION_DURATION": return {
+			...state,
+			sessionDuration: action.payload
+		};
+		case "INCREMENT_PERFECT_STRIKES": return {
+			...state,
+			perfectStrikes: state.perfectStrikes + 1
+		};
+		case "UPDATE_STATS": return {
+			...state,
+			stats: {
+				...state.stats,
+				...action.payload
+			}
+		};
+		case "REGISTER_HIT": {
+			const newHits = state.stats.hits + 1;
+			const totalAttempts = newHits + state.stats.misses;
+			const newCombo = state.stats.combo + 1;
+			const newBestCombo = Math.max(state.bestCombo, newCombo);
+			return {
+				...state,
+				perfectStrikes: action.payload.isPerfect ? state.perfectStrikes + 1 : state.perfectStrikes,
+				bestCombo: newBestCombo,
+				dummyHealth: Math.max(0, state.dummyHealth - action.payload.damage),
+				stats: {
+					...state.stats,
+					score: state.stats.score + action.payload.points,
+					combo: newCombo,
+					hits: newHits,
+					accuracy: totalAttempts > 0 ? newHits / totalAttempts * 100 : 0
+				}
+			};
+		}
+		case "REGISTER_MISS": {
+			const newMisses = state.stats.misses + 1;
+			const totalAttempts = state.stats.hits + newMisses;
+			return {
+				...state,
+				stats: {
+					...state.stats,
+					combo: 0,
+					misses: newMisses,
+					accuracy: totalAttempts > 0 ? state.stats.hits / totalAttempts * 100 : 0
+				}
+			};
+		}
+		case "SET_STANCE_INDEX": return {
+			...state,
+			currentStanceIndex: action.payload
+		};
+		case "TOGGLE_STANCE_WHEEL": return {
+			...state,
+			stanceWheelExpanded: !state.stanceWheelExpanded
+		};
+		case "UPDATE_BEST_COMBO": return {
+			...state,
+			bestCombo: Math.max(state.bestCombo, action.payload)
+		};
+		case "TOGGLE_ANATOMY_LAYER": {
+			const layer = action.payload;
+			const currentLayers = state.visibleAnatomyLayers;
+			const newLayers = currentLayers.includes(layer) ? currentLayers.filter((l) => l !== layer) : [...currentLayers, layer];
+			return {
+				...state,
+				visibleAnatomyLayers: newLayers
+			};
+		}
+		case "SET_ANATOMY_LAYERS": return {
+			...state,
+			visibleAnatomyLayers: action.payload
+		};
+		case "START_FOOTWORK_DRILL": return {
+			...state,
+			footworkDrillActive: true,
+			footworkDrillType: action.payload,
+			footworkDrillStep: 0,
+			feedback: "보법 훈련 시작! | Footwork drill started!",
+			showFeedback: true
+		};
+		case "STOP_FOOTWORK_DRILL": return {
+			...state,
+			footworkDrillActive: false,
+			footworkDrillStep: 0,
+			feedback: "보법 훈련 종료! | Footwork drill stopped!",
+			showFeedback: true
+		};
+		case "ADVANCE_FOOTWORK_STEP": return {
+			...state,
+			footworkDrillStep: state.footworkDrillStep + 1
+		};
+		case "RESET_FOOTWORK_DRILL": return {
+			...state,
+			footworkDrillStep: 0
+		};
+		default: return state;
+	}
+}
+/**
+* useTrainingState hook
+* Provides consolidated training state management using useReducer
+*/
+function useTrainingState() {
+	const [state, dispatch] = useReducer(trainingReducer, initialState);
+	const setTrainingMode = useCallback((mode) => dispatch({
+		type: "SET_TRAINING_MODE",
+		payload: mode
+	}), []);
+	const startTraining = useCallback(() => dispatch({ type: "START_TRAINING" }), []);
+	const stopTraining = useCallback(() => dispatch({ type: "STOP_TRAINING" }), []);
+	const setSelectedVitalPoint = useCallback((point) => dispatch({
+		type: "SET_SELECTED_VITAL_POINT",
+		payload: point
+	}), []);
+	const setFeedback = useCallback((feedback, show = true) => dispatch({
+		type: "SET_FEEDBACK",
+		payload: {
+			feedback,
+			show
+		}
+	}), []);
+	const hideFeedback = useCallback(() => dispatch({ type: "HIDE_FEEDBACK" }), []);
+	const addHitEffect = useCallback((effect) => dispatch({
+		type: "ADD_HIT_EFFECT",
+		payload: effect
+	}), []);
+	const removeHitEffect = useCallback((id) => dispatch({
+		type: "REMOVE_HIT_EFFECT",
+		payload: id
+	}), []);
+	const setDummyHealth = useCallback((health) => dispatch({
+		type: "SET_DUMMY_HEALTH",
+		payload: health
+	}), []);
+	const resetDummy = useCallback(() => dispatch({ type: "RESET_DUMMY" }), []);
+	const updateSessionDuration = useCallback((duration) => dispatch({
+		type: "UPDATE_SESSION_DURATION",
+		payload: duration
+	}), []);
+	const registerHit = useCallback((points, damage, isPerfect) => dispatch({
+		type: "REGISTER_HIT",
+		payload: {
+			points,
+			damage,
+			isPerfect
+		}
+	}), []);
+	const registerMiss = useCallback(() => dispatch({ type: "REGISTER_MISS" }), []);
+	const setStanceIndex = useCallback((index) => dispatch({
+		type: "SET_STANCE_INDEX",
+		payload: index
+	}), []);
+	const toggleStanceWheel = useCallback(() => dispatch({ type: "TOGGLE_STANCE_WHEEL" }), []);
+	const updateBestCombo = useCallback((combo) => dispatch({
+		type: "UPDATE_BEST_COMBO",
+		payload: combo
+	}), []);
+	const toggleAnatomyLayer = useCallback((layer) => dispatch({
+		type: "TOGGLE_ANATOMY_LAYER",
+		payload: layer
+	}), []);
+	const setAnatomyLayers = useCallback((layers) => dispatch({
+		type: "SET_ANATOMY_LAYERS",
+		payload: layers
+	}), []);
+	const startFootworkDrill = useCallback((drillType) => {
+		dispatch({
+			type: "START_FOOTWORK_DRILL",
+			payload: drillType
+		});
+	}, []);
+	const stopFootworkDrill = useCallback(() => {
+		dispatch({ type: "STOP_FOOTWORK_DRILL" });
+	}, []);
+	const advanceFootworkStep = useCallback(() => {
+		dispatch({ type: "ADVANCE_FOOTWORK_STEP" });
+	}, []);
+	const resetFootworkDrill = useCallback(() => {
+		dispatch({ type: "RESET_FOOTWORK_DRILL" });
+	}, []);
+	return {
+		state,
+		actions: useMemo(() => ({
+			setTrainingMode,
+			startTraining,
+			stopTraining,
+			setSelectedVitalPoint,
+			setFeedback,
+			hideFeedback,
+			addHitEffect,
+			removeHitEffect,
+			setDummyHealth,
+			resetDummy,
+			updateSessionDuration,
+			registerHit,
+			registerMiss,
+			setStanceIndex,
+			toggleStanceWheel,
+			updateBestCombo,
+			toggleAnatomyLayer,
+			setAnatomyLayers,
+			startFootworkDrill,
+			stopFootworkDrill,
+			advanceFootworkStep,
+			resetFootworkDrill
+		}), [
+			setTrainingMode,
+			startTraining,
+			stopTraining,
+			setSelectedVitalPoint,
+			setFeedback,
+			hideFeedback,
+			addHitEffect,
+			removeHitEffect,
+			setDummyHealth,
+			resetDummy,
+			updateSessionDuration,
+			registerHit,
+			registerMiss,
+			setStanceIndex,
+			toggleStanceWheel,
+			updateBestCombo,
+			toggleAnatomyLayer,
+			setAnatomyLayers,
+			startFootworkDrill,
+			stopFootworkDrill,
+			advanceFootworkStep,
+			resetFootworkDrill
+		])
+	};
+}
+//#endregion
+export { useTrainingState as default };
+
+//# sourceMappingURL=useTrainingState.js.map

package/lib/components/screens/training/hooks/useTrainingState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrainingState.js","names":[],"sources":["../../../../../src/components/screens/training/hooks/useTrainingState.ts"],"sourcesContent":["/**\n * useTrainingState Hook - Consolidated Training State Management\n *\n * Custom hook for managing training state using useReducer.\n * Mirrors useCombatState pattern for consistency.\n *\n * @korean 훈련상태관리훅 - useReducer를 사용한 통합 훈련 상태 관리\n */\n\nimport { useCallback, useMemo, useReducer } from \"react\";\n// Re-export types from components for consistency\nimport type { AnatomyLayer } from \"../components/AnatomyOverlay3D\";\nimport type { FootworkDrill } from \"../components/FootworkDrillsOverlayHtml\";\nimport type { TrainingMode } from \"../components/TrainingModeSelectorOverlayHtml\";\n\n// Re-export for convenience\nexport type { AnatomyLayer, FootworkDrill, TrainingMode };\n\n/**\n * Training statistics\n */\nexport interface TrainingStats {\n  readonly score: number;\n  readonly combo: number;\n  readonly hits: number;\n  readonly misses: number;\n  readonly accuracy: number;\n  readonly sessionDuration?: number;\n  readonly bestCombo?: number;\n  readonly perfectStrikes?: number;\n}\n\n/**\n * Hit effect for training\n */\nexport interface TrainingHitEffect {\n  readonly id: number;\n  readonly position: [number, number, number];\n  readonly type: \"success\" | \"perfect\" | \"miss\";\n  readonly visible: boolean;\n  readonly damage?: number;\n}\n\n/**\n * Training screen state managed by the reducer\n */\nexport interface TrainingScreenState {\n  readonly trainingMode: TrainingMode;\n  readonly isTraining: boolean;\n  readonly selectedVitalPoint: string | null;\n  readonly feedback: string;\n  readonly showFeedback: boolean;\n  readonly hitEffects: TrainingHitEffect[];\n  readonly nextEffectId: number;\n  readonly dummyHealth: number;\n  readonly sessionStartTime: number | null;\n  readonly sessionDuration: number;\n  readonly perfectStrikes: number;\n  readonly bestCombo: number;\n  readonly stats: TrainingStats;\n  readonly currentStanceIndex: number;\n  readonly stanceWheelExpanded: boolean;\n  readonly visibleAnatomyLayers: AnatomyLayer[];\n  // Footwork drill state\n  readonly footworkDrillActive: boolean;\n  readonly footworkDrillType: FootworkDrill;\n  readonly footworkDrillStep: number;\n}\n\n/**\n * Training state actions\n */\ntype TrainingAction =\n  | { type: \"SET_TRAINING_MODE\"; payload: TrainingMode }\n  | { type: \"START_TRAINING\" }\n  | { type: \"STOP_TRAINING\" }\n  | { type: \"SET_SELECTED_VITAL_POINT\"; payload: string | null }\n  | { type: \"SET_FEEDBACK\"; payload: { feedback: string; show: boolean } }\n  | { type: \"HIDE_FEEDBACK\" }\n  | { type: \"ADD_HIT_EFFECT\"; payload: Omit<TrainingHitEffect, \"id\"> }\n  | { type: \"REMOVE_HIT_EFFECT\"; payload: number }\n  | { type: \"SET_DUMMY_HEALTH\"; payload: number }\n  | { type: \"RESET_DUMMY\" }\n  | { type: \"UPDATE_SESSION_DURATION\"; payload: number }\n  | { type: \"INCREMENT_PERFECT_STRIKES\" }\n  | { type: \"UPDATE_STATS\"; payload: Partial<TrainingStats> }\n  | {\n      type: \"REGISTER_HIT\";\n      payload: { points: number; damage: number; isPerfect: boolean };\n    }\n  | { type: \"REGISTER_MISS\" }\n  | { type: \"SET_STANCE_INDEX\"; payload: number }\n  | { type: \"TOGGLE_STANCE_WHEEL\" }\n  | { type: \"UPDATE_BEST_COMBO\"; payload: number }\n  | { type: \"TOGGLE_ANATOMY_LAYER\"; payload: AnatomyLayer }\n  | { type: \"SET_ANATOMY_LAYERS\"; payload: AnatomyLayer[] }\n  | { type: \"START_FOOTWORK_DRILL\"; payload: FootworkDrill }\n  | { type: \"STOP_FOOTWORK_DRILL\" }\n  | { type: \"ADVANCE_FOOTWORK_STEP\" }\n  | { type: \"RESET_FOOTWORK_DRILL\" };\n\n/**\n * Initial training state\n */\nconst initialState: TrainingScreenState = {\n  trainingMode: \"basics\",\n  isTraining: false,\n  selectedVitalPoint: null,\n  feedback: \"\",\n  showFeedback: false,\n  hitEffects: [],\n  nextEffectId: 0,\n  dummyHealth: 100,\n  sessionStartTime: null,\n  sessionDuration: 0,\n  perfectStrikes: 0,\n  bestCombo: 0,\n  stats: {\n    score: 0,\n    combo: 0,\n    hits: 0,\n    misses: 0,\n    accuracy: 0,\n  },\n  currentStanceIndex: 0,\n  stanceWheelExpanded: false,\n  visibleAnatomyLayers: [],\n  footworkDrillActive: false,\n  footworkDrillType: \"circular_left\",\n  footworkDrillStep: 0,\n};\n\n/**\n * Training state reducer\n */\nfunction trainingReducer(\n  state: TrainingScreenState,\n  action: TrainingAction\n): TrainingScreenState {\n  switch (action.type) {\n    case \"SET_TRAINING_MODE\":\n      return { ...state, trainingMode: action.payload };\n\n    case \"START_TRAINING\":\n      return {\n        ...state,\n        isTraining: true,\n        sessionStartTime: Date.now(),\n        dummyHealth: 100,\n        perfectStrikes: 0,\n        bestCombo: 0,\n        stats: {\n          score: 0,\n          combo: 0,\n          hits: 0,\n          misses: 0,\n          accuracy: 0,\n        },\n        feedback: \"훈련 시작! | Training Start!\",\n        showFeedback: true,\n      };\n\n    case \"STOP_TRAINING\":\n      return {\n        ...state,\n        isTraining: false,\n        sessionStartTime: null,\n        sessionDuration: 0,\n        feedback: \"훈련 종료 | Training End\",\n        showFeedback: true,\n      };\n\n    case \"SET_SELECTED_VITAL_POINT\":\n      return { ...state, selectedVitalPoint: action.payload };\n\n    case \"SET_FEEDBACK\":\n      return {\n        ...state,\n        feedback: action.payload.feedback,\n        showFeedback: action.payload.show,\n      };\n\n    case \"HIDE_FEEDBACK\":\n      return { ...state, showFeedback: false };\n\n    case \"ADD_HIT_EFFECT\":\n      return {\n        ...state,\n        hitEffects: [\n          ...state.hitEffects,\n          { ...action.payload, id: state.nextEffectId },\n        ],\n        nextEffectId: state.nextEffectId + 1,\n      };\n\n    case \"REMOVE_HIT_EFFECT\":\n      return {\n        ...state,\n        hitEffects: state.hitEffects.filter((e) => e.id !== action.payload),\n      };\n\n    case \"SET_DUMMY_HEALTH\":\n      return { ...state, dummyHealth: action.payload };\n\n    case \"RESET_DUMMY\":\n      return {\n        ...state,\n        dummyHealth: 100,\n        feedback: \"더미 재설정 | Dummy Reset\",\n        showFeedback: true,\n      };\n\n    case \"UPDATE_SESSION_DURATION\":\n      return { ...state, sessionDuration: action.payload };\n\n    case \"INCREMENT_PERFECT_STRIKES\":\n      return { ...state, perfectStrikes: state.perfectStrikes + 1 };\n\n    case \"UPDATE_STATS\":\n      return { ...state, stats: { ...state.stats, ...action.payload } };\n\n    case \"REGISTER_HIT\": {\n      const newHits = state.stats.hits + 1;\n      const totalAttempts = newHits + state.stats.misses;\n      const newCombo = state.stats.combo + 1;\n      const newBestCombo = Math.max(state.bestCombo, newCombo);\n\n      return {\n        ...state,\n        perfectStrikes: action.payload.isPerfect\n          ? state.perfectStrikes + 1\n          : state.perfectStrikes,\n        bestCombo: newBestCombo,\n        dummyHealth: Math.max(0, state.dummyHealth - action.payload.damage),\n        stats: {\n          ...state.stats,\n          score: state.stats.score + action.payload.points,\n          combo: newCombo,\n          hits: newHits,\n          accuracy: totalAttempts > 0 ? (newHits / totalAttempts) * 100 : 0,\n        },\n      };\n    }\n\n    case \"REGISTER_MISS\": {\n      const newMisses = state.stats.misses + 1;\n      const totalAttempts = state.stats.hits + newMisses;\n\n      return {\n        ...state,\n        stats: {\n          ...state.stats,\n          combo: 0,\n          misses: newMisses,\n          accuracy:\n            totalAttempts > 0 ? (state.stats.hits / totalAttempts) * 100 : 0,\n        },\n      };\n    }\n\n    case \"SET_STANCE_INDEX\":\n      return { ...state, currentStanceIndex: action.payload };\n\n    case \"TOGGLE_STANCE_WHEEL\":\n      return { ...state, stanceWheelExpanded: !state.stanceWheelExpanded };\n\n    case \"UPDATE_BEST_COMBO\":\n      return {\n        ...state,\n        bestCombo: Math.max(state.bestCombo, action.payload),\n      };\n\n    case \"TOGGLE_ANATOMY_LAYER\": {\n      const layer = action.payload;\n      const currentLayers = state.visibleAnatomyLayers;\n      const newLayers = currentLayers.includes(layer)\n        ? currentLayers.filter((l) => l !== layer)\n        : [...currentLayers, layer];\n      return { ...state, visibleAnatomyLayers: newLayers };\n    }\n\n    case \"SET_ANATOMY_LAYERS\":\n      return { ...state, visibleAnatomyLayers: action.payload };\n\n    case \"START_FOOTWORK_DRILL\":\n      return {\n        ...state,\n        footworkDrillActive: true,\n        footworkDrillType: action.payload,\n        footworkDrillStep: 0,\n        feedback: \"보법 훈련 시작! | Footwork drill started!\",\n        showFeedback: true,\n      };\n\n    case \"STOP_FOOTWORK_DRILL\":\n      return {\n        ...state,\n        footworkDrillActive: false,\n        footworkDrillStep: 0,\n        feedback: \"보법 훈련 종료! | Footwork drill stopped!\",\n        showFeedback: true,\n      };\n\n    case \"ADVANCE_FOOTWORK_STEP\":\n      return {\n        ...state,\n        footworkDrillStep: state.footworkDrillStep + 1,\n      };\n\n    case \"RESET_FOOTWORK_DRILL\":\n      return {\n        ...state,\n        footworkDrillStep: 0,\n      };\n\n    default:\n      return state;\n  }\n}\n\n/**\n * Training state actions interface\n */\nexport interface TrainingActions {\n  readonly setTrainingMode: (mode: TrainingMode) => void;\n  readonly startTraining: () => void;\n  readonly stopTraining: () => void;\n  readonly setSelectedVitalPoint: (point: string | null) => void;\n  readonly setFeedback: (feedback: string, show?: boolean) => void;\n  readonly hideFeedback: () => void;\n  readonly addHitEffect: (effect: Omit<TrainingHitEffect, \"id\">) => void;\n  readonly removeHitEffect: (id: number) => void;\n  readonly setDummyHealth: (health: number) => void;\n  readonly resetDummy: () => void;\n  readonly updateSessionDuration: (duration: number) => void;\n  readonly registerHit: (\n    points: number,\n    damage: number,\n    isPerfect: boolean\n  ) => void;\n  readonly registerMiss: () => void;\n  readonly setStanceIndex: (index: number) => void;\n  readonly toggleStanceWheel: () => void;\n  readonly updateBestCombo: (combo: number) => void;\n  readonly toggleAnatomyLayer: (layer: AnatomyLayer) => void;\n  readonly setAnatomyLayers: (layers: AnatomyLayer[]) => void;\n  readonly startFootworkDrill: (drillType: FootworkDrill) => void;\n  readonly stopFootworkDrill: () => void;\n  readonly advanceFootworkStep: () => void;\n  readonly resetFootworkDrill: () => void;\n}\n\n/**\n * Hook return type\n */\nexport interface UseTrainingStateReturn {\n  readonly state: TrainingScreenState;\n  readonly actions: TrainingActions;\n}\n\n/**\n * useTrainingState hook\n * Provides consolidated training state management using useReducer\n */\nexport function useTrainingState(): UseTrainingStateReturn {\n  const [state, dispatch] = useReducer(trainingReducer, initialState);\n\n  // Memoize individual callbacks to prevent recreating on every render\n  const setTrainingMode = useCallback(\n    (mode: TrainingMode) =>\n      dispatch({ type: \"SET_TRAINING_MODE\", payload: mode }),\n    []\n  );\n  const startTraining = useCallback(\n    () => dispatch({ type: \"START_TRAINING\" }),\n    []\n  );\n  const stopTraining = useCallback(\n    () => dispatch({ type: \"STOP_TRAINING\" }),\n    []\n  );\n  const setSelectedVitalPoint = useCallback(\n    (point: string | null) =>\n      dispatch({ type: \"SET_SELECTED_VITAL_POINT\", payload: point }),\n    []\n  );\n  const setFeedback = useCallback(\n    (feedback: string, show = true) =>\n      dispatch({ type: \"SET_FEEDBACK\", payload: { feedback, show } }),\n    []\n  );\n  const hideFeedback = useCallback(\n    () => dispatch({ type: \"HIDE_FEEDBACK\" }),\n    []\n  );\n  const addHitEffect = useCallback(\n    (effect: Omit<TrainingHitEffect, \"id\">) =>\n      dispatch({ type: \"ADD_HIT_EFFECT\", payload: effect }),\n    []\n  );\n  const removeHitEffect = useCallback(\n    (id: number) => dispatch({ type: \"REMOVE_HIT_EFFECT\", payload: id }),\n    []\n  );\n  const setDummyHealth = useCallback(\n    (health: number) => dispatch({ type: \"SET_DUMMY_HEALTH\", payload: health }),\n    []\n  );\n  const resetDummy = useCallback(() => dispatch({ type: \"RESET_DUMMY\" }), []);\n  const updateSessionDuration = useCallback(\n    (duration: number) =>\n      dispatch({ type: \"UPDATE_SESSION_DURATION\", payload: duration }),\n    []\n  );\n  const registerHit = useCallback(\n    (points: number, damage: number, isPerfect: boolean) =>\n      dispatch({\n        type: \"REGISTER_HIT\",\n        payload: { points, damage, isPerfect },\n      }),\n    []\n  );\n  const registerMiss = useCallback(\n    () => dispatch({ type: \"REGISTER_MISS\" }),\n    []\n  );\n  const setStanceIndex = useCallback(\n    (index: number) => dispatch({ type: \"SET_STANCE_INDEX\", payload: index }),\n    []\n  );\n  const toggleStanceWheel = useCallback(\n    () => dispatch({ type: \"TOGGLE_STANCE_WHEEL\" }),\n    []\n  );\n  const updateBestCombo = useCallback(\n    (combo: number) => dispatch({ type: \"UPDATE_BEST_COMBO\", payload: combo }),\n    []\n  );\n  const toggleAnatomyLayer = useCallback(\n    (layer: AnatomyLayer) =>\n      dispatch({ type: \"TOGGLE_ANATOMY_LAYER\", payload: layer }),\n    []\n  );\n  const setAnatomyLayers = useCallback(\n    (layers: AnatomyLayer[]) =>\n      dispatch({ type: \"SET_ANATOMY_LAYERS\", payload: layers }),\n    []\n  );\n  const startFootworkDrill = useCallback((drillType: FootworkDrill) => {\n    dispatch({ type: \"START_FOOTWORK_DRILL\", payload: drillType });\n  }, []);\n  const stopFootworkDrill = useCallback(() => {\n    dispatch({ type: \"STOP_FOOTWORK_DRILL\" });\n  }, []);\n  const advanceFootworkStep = useCallback(() => {\n    dispatch({ type: \"ADVANCE_FOOTWORK_STEP\" });\n  }, []);\n  const resetFootworkDrill = useCallback(() => {\n    dispatch({ type: \"RESET_FOOTWORK_DRILL\" });\n  }, []);\n\n  // Memoize the actions object to prevent unnecessary re-renders\n  // All callbacks are stable since they have empty dependency arrays\n  const actions: TrainingActions = useMemo(\n    () => ({\n      setTrainingMode,\n      startTraining,\n      stopTraining,\n      setSelectedVitalPoint,\n      setFeedback,\n      hideFeedback,\n      addHitEffect,\n      removeHitEffect,\n      setDummyHealth,\n      resetDummy,\n      updateSessionDuration,\n      registerHit,\n      registerMiss,\n      setStanceIndex,\n      toggleStanceWheel,\n      updateBestCombo,\n      toggleAnatomyLayer,\n      setAnatomyLayers,\n      startFootworkDrill,\n      stopFootworkDrill,\n      advanceFootworkStep,\n      resetFootworkDrill,\n    }),\n    [\n      setTrainingMode,\n      startTraining,\n      stopTraining,\n      setSelectedVitalPoint,\n      setFeedback,\n      hideFeedback,\n      addHitEffect,\n      removeHitEffect,\n      setDummyHealth,\n      resetDummy,\n      updateSessionDuration,\n      registerHit,\n      registerMiss,\n      setStanceIndex,\n      toggleStanceWheel,\n      updateBestCombo,\n      toggleAnatomyLayer,\n      setAnatomyLayers,\n      startFootworkDrill,\n      stopFootworkDrill,\n      advanceFootworkStep,\n      resetFootworkDrill,\n    ]\n  );\n\n  return { state, actions };\n}\n\nexport default useTrainingState;\n"],"mappings":";;;;;;;;;;;;;AAwGA,IAAM,eAAoC;CACxC,cAAc;CACd,YAAY;CACZ,oBAAoB;CACpB,UAAU;CACV,cAAc;CACd,YAAY,EAAE;CACd,cAAc;CACd,aAAa;CACb,kBAAkB;CAClB,iBAAiB;CACjB,gBAAgB;CAChB,WAAW;CACX,OAAO;EACL,OAAO;EACP,OAAO;EACP,MAAM;EACN,QAAQ;EACR,UAAU;EACX;CACD,oBAAoB;CACpB,qBAAqB;CACrB,sBAAsB,EAAE;CACxB,qBAAqB;CACrB,mBAAmB;CACnB,mBAAmB;CACpB;;;;AAKD,SAAS,gBACP,OACA,QACqB;AACrB,SAAQ,OAAO,MAAf;EACE,KAAK,oBACH,QAAO;GAAE,GAAG;GAAO,cAAc,OAAO;GAAS;EAEnD,KAAK,iBACH,QAAO;GACL,GAAG;GACH,YAAY;GACZ,kBAAkB,KAAK,KAAK;GAC5B,aAAa;GACb,gBAAgB;GAChB,WAAW;GACX,OAAO;IACL,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACX;GACD,UAAU;GACV,cAAc;GACf;EAEH,KAAK,gBACH,QAAO;GACL,GAAG;GACH,YAAY;GACZ,kBAAkB;GAClB,iBAAiB;GACjB,UAAU;GACV,cAAc;GACf;EAEH,KAAK,2BACH,QAAO;GAAE,GAAG;GAAO,oBAAoB,OAAO;GAAS;EAEzD,KAAK,eACH,QAAO;GACL,GAAG;GACH,UAAU,OAAO,QAAQ;GACzB,cAAc,OAAO,QAAQ;GAC9B;EAEH,KAAK,gBACH,QAAO;GAAE,GAAG;GAAO,cAAc;GAAO;EAE1C,KAAK,iBACH,QAAO;GACL,GAAG;GACH,YAAY,CACV,GAAG,MAAM,YACT;IAAE,GAAG,OAAO;IAAS,IAAI,MAAM;IAAc,CAC9C;GACD,cAAc,MAAM,eAAe;GACpC;EAEH,KAAK,oBACH,QAAO;GACL,GAAG;GACH,YAAY,MAAM,WAAW,QAAQ,MAAM,EAAE,OAAO,OAAO,QAAQ;GACpE;EAEH,KAAK,mBACH,QAAO;GAAE,GAAG;GAAO,aAAa,OAAO;GAAS;EAElD,KAAK,cACH,QAAO;GACL,GAAG;GACH,aAAa;GACb,UAAU;GACV,cAAc;GACf;EAEH,KAAK,0BACH,QAAO;GAAE,GAAG;GAAO,iBAAiB,OAAO;GAAS;EAEtD,KAAK,4BACH,QAAO;GAAE,GAAG;GAAO,gBAAgB,MAAM,iBAAiB;GAAG;EAE/D,KAAK,eACH,QAAO;GAAE,GAAG;GAAO,OAAO;IAAE,GAAG,MAAM;IAAO,GAAG,OAAO;IAAS;GAAE;EAEnE,KAAK,gBAAgB;GACnB,MAAM,UAAU,MAAM,MAAM,OAAO;GACnC,MAAM,gBAAgB,UAAU,MAAM,MAAM;GAC5C,MAAM,WAAW,MAAM,MAAM,QAAQ;GACrC,MAAM,eAAe,KAAK,IAAI,MAAM,WAAW,SAAS;AAExD,UAAO;IACL,GAAG;IACH,gBAAgB,OAAO,QAAQ,YAC3B,MAAM,iBAAiB,IACvB,MAAM;IACV,WAAW;IACX,aAAa,KAAK,IAAI,GAAG,MAAM,cAAc,OAAO,QAAQ,OAAO;IACnE,OAAO;KACL,GAAG,MAAM;KACT,OAAO,MAAM,MAAM,QAAQ,OAAO,QAAQ;KAC1C,OAAO;KACP,MAAM;KACN,UAAU,gBAAgB,IAAK,UAAU,gBAAiB,MAAM;KACjE;IACF;;EAGH,KAAK,iBAAiB;GACpB,MAAM,YAAY,MAAM,MAAM,SAAS;GACvC,MAAM,gBAAgB,MAAM,MAAM,OAAO;AAEzC,UAAO;IACL,GAAG;IACH,OAAO;KACL,GAAG,MAAM;KACT,OAAO;KACP,QAAQ;KACR,UACE,gBAAgB,IAAK,MAAM,MAAM,OAAO,gBAAiB,MAAM;KAClE;IACF;;EAGH,KAAK,mBACH,QAAO;GAAE,GAAG;GAAO,oBAAoB,OAAO;GAAS;EAEzD,KAAK,sBACH,QAAO;GAAE,GAAG;GAAO,qBAAqB,CAAC,MAAM;GAAqB;EAEtE,KAAK,oBACH,QAAO;GACL,GAAG;GACH,WAAW,KAAK,IAAI,MAAM,WAAW,OAAO,QAAQ;GACrD;EAEH,KAAK,wBAAwB;GAC3B,MAAM,QAAQ,OAAO;GACrB,MAAM,gBAAgB,MAAM;GAC5B,MAAM,YAAY,cAAc,SAAS,MAAM,GAC3C,cAAc,QAAQ,MAAM,MAAM,MAAM,GACxC,CAAC,GAAG,eAAe,MAAM;AAC7B,UAAO;IAAE,GAAG;IAAO,sBAAsB;IAAW;;EAGtD,KAAK,qBACH,QAAO;GAAE,GAAG;GAAO,sBAAsB,OAAO;GAAS;EAE3D,KAAK,uBACH,QAAO;GACL,GAAG;GACH,qBAAqB;GACrB,mBAAmB,OAAO;GAC1B,mBAAmB;GACnB,UAAU;GACV,cAAc;GACf;EAEH,KAAK,sBACH,QAAO;GACL,GAAG;GACH,qBAAqB;GACrB,mBAAmB;GACnB,UAAU;GACV,cAAc;GACf;EAEH,KAAK,wBACH,QAAO;GACL,GAAG;GACH,mBAAmB,MAAM,oBAAoB;GAC9C;EAEH,KAAK,uBACH,QAAO;GACL,GAAG;GACH,mBAAmB;GACpB;EAEH,QACE,QAAO;;;;;;;AAgDb,SAAgB,mBAA2C;CACzD,MAAM,CAAC,OAAO,YAAY,WAAW,iBAAiB,aAAa;CAGnE,MAAM,kBAAkB,aACrB,SACC,SAAS;EAAE,MAAM;EAAqB,SAAS;EAAM,CAAC,EACxD,EAAE,CACH;CACD,MAAM,gBAAgB,kBACd,SAAS,EAAE,MAAM,kBAAkB,CAAC,EAC1C,EAAE,CACH;CACD,MAAM,eAAe,kBACb,SAAS,EAAE,MAAM,iBAAiB,CAAC,EACzC,EAAE,CACH;CACD,MAAM,wBAAwB,aAC3B,UACC,SAAS;EAAE,MAAM;EAA4B,SAAS;EAAO,CAAC,EAChE,EAAE,CACH;CACD,MAAM,cAAc,aACjB,UAAkB,OAAO,SACxB,SAAS;EAAE,MAAM;EAAgB,SAAS;GAAE;GAAU;GAAM;EAAE,CAAC,EACjE,EAAE,CACH;CACD,MAAM,eAAe,kBACb,SAAS,EAAE,MAAM,iBAAiB,CAAC,EACzC,EAAE,CACH;CACD,MAAM,eAAe,aAClB,WACC,SAAS;EAAE,MAAM;EAAkB,SAAS;EAAQ,CAAC,EACvD,EAAE,CACH;CACD,MAAM,kBAAkB,aACrB,OAAe,SAAS;EAAE,MAAM;EAAqB,SAAS;EAAI,CAAC,EACpE,EAAE,CACH;CACD,MAAM,iBAAiB,aACpB,WAAmB,SAAS;EAAE,MAAM;EAAoB,SAAS;EAAQ,CAAC,EAC3E,EAAE,CACH;CACD,MAAM,aAAa,kBAAkB,SAAS,EAAE,MAAM,eAAe,CAAC,EAAE,EAAE,CAAC;CAC3E,MAAM,wBAAwB,aAC3B,aACC,SAAS;EAAE,MAAM;EAA2B,SAAS;EAAU,CAAC,EAClE,EAAE,CACH;CACD,MAAM,cAAc,aACjB,QAAgB,QAAgB,cAC/B,SAAS;EACP,MAAM;EACN,SAAS;GAAE;GAAQ;GAAQ;GAAW;EACvC,CAAC,EACJ,EAAE,CACH;CACD,MAAM,eAAe,kBACb,SAAS,EAAE,MAAM,iBAAiB,CAAC,EACzC,EAAE,CACH;CACD,MAAM,iBAAiB,aACpB,UAAkB,SAAS;EAAE,MAAM;EAAoB,SAAS;EAAO,CAAC,EACzE,EAAE,CACH;CACD,MAAM,oBAAoB,kBAClB,SAAS,EAAE,MAAM,uBAAuB,CAAC,EAC/C,EAAE,CACH;CACD,MAAM,kBAAkB,aACrB,UAAkB,SAAS;EAAE,MAAM;EAAqB,SAAS;EAAO,CAAC,EAC1E,EAAE,CACH;CACD,MAAM,qBAAqB,aACxB,UACC,SAAS;EAAE,MAAM;EAAwB,SAAS;EAAO,CAAC,EAC5D,EAAE,CACH;CACD,MAAM,mBAAmB,aACtB,WACC,SAAS;EAAE,MAAM;EAAsB,SAAS;EAAQ,CAAC,EAC3D,EAAE,CACH;CACD,MAAM,qBAAqB,aAAa,cAA6B;AACnE,WAAS;GAAE,MAAM;GAAwB,SAAS;GAAW,CAAC;IAC7D,EAAE,CAAC;CACN,MAAM,oBAAoB,kBAAkB;AAC1C,WAAS,EAAE,MAAM,uBAAuB,CAAC;IACxC,EAAE,CAAC;CACN,MAAM,sBAAsB,kBAAkB;AAC5C,WAAS,EAAE,MAAM,yBAAyB,CAAC;IAC1C,EAAE,CAAC;CACN,MAAM,qBAAqB,kBAAkB;AAC3C,WAAS,EAAE,MAAM,wBAAwB,CAAC;IACzC,EAAE,CAAC;AAuDN,QAAO;EAAE;EAAO,SAnDiB,eACxB;GACL;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,GACD;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CACF;EAEwB"}

package/lib/components/screens/training/index.d.ts

@@ -0,0 +1,4 @@
+export { TrainingScreen3D } from "./TrainingScreen3D";
+export * from "./components";
+export type { TrainingScreen3DProps } from "./TrainingScreen3D";
+//# sourceMappingURL=index.d.ts.map

package/lib/components/screens/training/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/training/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,cAAc,cAAc,CAAC;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/components/screens/training/index.js

@@ -0,0 +1,16 @@
+import "./components/AnatomyOverlay3D.js";
+import "./components/HitFeedbackEffect3D.js";
+import "./components/VitalPointMarker3D.js";
+import "./components/TrainingDummy3D.js";
+import "./components/TrainingFeedbackOverlayHtml.js";
+import "./components/hud/TrainingBottomHUD.js";
+import "./components/AnatomyControlsOverlayHtml.js";
+import "./components/hud/TrainingLeftHUD.js";
+import "./components/TrainingModeSelectorOverlayHtml.js";
+import "./components/TrainingStatsOverlayHtml.js";
+import "./components/VitalPointTrainingOverlayHtml.js";
+import "./components/hud/TrainingRightHUD.js";
+import "./components/TrainingControlsOverlayHtml.js";
+import "./components/hud/TrainingTopHUD.js";
+import "./TrainingScreen3D.js";
+import "./components/index.js";

package/lib/components/shared/base/AccessibilityProvider.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AccessibilityProvider - Context provider for accessibility settings
+ *
+ * Provides high contrast mode, reduced motion support, and other accessibility features
+ * Respects user preferences from prefers-reduced-motion and prefers-contrast media queries
+ *
+ * @module components/base
+ */
+import React from "react";
+/**
+ * Accessibility context value interface
+ */
+export interface AccessibilityContextValue {
+    readonly highContrast: boolean;
+    readonly reducedMotion: boolean;
+    readonly setHighContrast: (enabled: boolean) => void;
+    readonly toggleHighContrast: () => void;
+}
+/**
+ * Props for AccessibilityProvider
+ */
+export interface AccessibilityProviderProps {
+    readonly children: React.ReactNode;
+}
+/**
+ * AccessibilityProvider Component
+ *
+ * Provides accessibility settings throughout the component tree
+ * Automatically detects user preferences for reduced motion
+ *
+ * @example
+ * ```tsx
+ * <AccessibilityProvider>
+ *   <App />
+ * </AccessibilityProvider>
+ * ```
+ */
+export declare const AccessibilityProvider: React.FC<AccessibilityProviderProps>;
+/**
+ * Custom hook to access accessibility context
+ *
+ * @throws Error if used outside of AccessibilityProvider
+ * @returns Accessibility context value
+ *
+ * @example
+ * ```tsx
+ * const { highContrast, reducedMotion, toggleHighContrast } = useAccessibility();
+ * ```
+ */
+export declare function useAccessibility(): AccessibilityContextValue;
+//# sourceMappingURL=AccessibilityProvider.d.ts.map

package/lib/components/shared/base/AccessibilityProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessibilityProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/base/AccessibilityProvider.tsx"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAON,MAAM,OAAO,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,IAAI,CAAC;CACzC;AASD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAyDtE,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,yBAAyB,CAU5D"}

package/lib/components/shared/base/AccessibilityProvider.js

@@ -0,0 +1,71 @@
+import { createContext, useCallback, useEffect, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/shared/base/AccessibilityProvider.tsx
+/**
+* AccessibilityProvider - Context provider for accessibility settings
+*
+* Provides high contrast mode, reduced motion support, and other accessibility features
+* Respects user preferences from prefers-reduced-motion and prefers-contrast media queries
+*
+* @module components/base
+*/
+/**
+* Accessibility context
+*/
+var AccessibilityContext = createContext(null);
+/**
+* AccessibilityProvider Component
+*
+* Provides accessibility settings throughout the component tree
+* Automatically detects user preferences for reduced motion
+*
+* @example
+* ```tsx
+* <AccessibilityProvider>
+*   <App />
+* </AccessibilityProvider>
+* ```
+*/
+var AccessibilityProvider = ({ children }) => {
+	const [highContrast, setHighContrast] = useState(false);
+	const [reducedMotion, setReducedMotion] = useState(false);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const mediaQuery = window.matchMedia("(prefers-reduced-motion: reduce)");
+		setReducedMotion(mediaQuery.matches);
+		const handleChange = (e) => {
+			setReducedMotion(e.matches);
+		};
+		mediaQuery.addEventListener("change", handleChange);
+		return () => {
+			mediaQuery.removeEventListener("change", handleChange);
+		};
+	}, []);
+	useEffect(() => {
+		if (typeof document === "undefined") return;
+		if (highContrast) document.body.classList.add("high-contrast");
+		else document.body.classList.remove("high-contrast");
+	}, [highContrast]);
+	const toggleHighContrast = useCallback(() => {
+		setHighContrast((prev) => !prev);
+	}, []);
+	const value = useMemo(() => ({
+		highContrast,
+		reducedMotion,
+		setHighContrast,
+		toggleHighContrast
+	}), [
+		highContrast,
+		reducedMotion,
+		toggleHighContrast
+	]);
+	return /* @__PURE__ */ jsx(AccessibilityContext.Provider, {
+		value,
+		children
+	});
+};
+AccessibilityProvider.displayName = "AccessibilityProvider";
+//#endregion
+export { AccessibilityProvider };
+
+//# sourceMappingURL=AccessibilityProvider.js.map

package/lib/components/shared/base/AccessibilityProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessibilityProvider.js","names":[],"sources":["../../../../src/components/shared/base/AccessibilityProvider.tsx"],"sourcesContent":["/* eslint-disable react-refresh/only-export-components */\n/**\n * AccessibilityProvider - Context provider for accessibility settings\n *\n * Provides high contrast mode, reduced motion support, and other accessibility features\n * Respects user preferences from prefers-reduced-motion and prefers-contrast media queries\n *\n * @module components/base\n */\n\nimport React, {\n  createContext,\n  useContext,\n  useState,\n  useEffect,\n  useMemo,\n  useCallback,\n} from \"react\";\n\n/**\n * Accessibility context value interface\n */\nexport interface AccessibilityContextValue {\n  readonly highContrast: boolean;\n  readonly reducedMotion: boolean;\n  readonly setHighContrast: (enabled: boolean) => void;\n  readonly toggleHighContrast: () => void;\n}\n\n/**\n * Accessibility context\n */\nconst AccessibilityContext = createContext<AccessibilityContextValue | null>(\n  null,\n);\n\n/**\n * Props for AccessibilityProvider\n */\nexport interface AccessibilityProviderProps {\n  readonly children: React.ReactNode;\n}\n\n/**\n * AccessibilityProvider Component\n *\n * Provides accessibility settings throughout the component tree\n * Automatically detects user preferences for reduced motion\n *\n * @example\n * ```tsx\n * <AccessibilityProvider>\n *   <App />\n * </AccessibilityProvider>\n * ```\n */\nexport const AccessibilityProvider: React.FC<AccessibilityProviderProps> = ({\n  children,\n}) => {\n  const [highContrast, setHighContrast] = useState(false);\n  const [reducedMotion, setReducedMotion] = useState(false);\n\n  // Detect user preference for reduced motion\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const mediaQuery = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    setReducedMotion(mediaQuery.matches);\n\n    const handleChange = (e: MediaQueryListEvent) => {\n      setReducedMotion(e.matches);\n    };\n\n    // Modern browsers\n    mediaQuery.addEventListener(\"change\", handleChange);\n\n    return () => {\n      mediaQuery.removeEventListener(\"change\", handleChange);\n    };\n  }, []);\n\n  // Apply high contrast theme globally\n  useEffect(() => {\n    if (typeof document === \"undefined\") return;\n\n    if (highContrast) {\n      document.body.classList.add(\"high-contrast\");\n    } else {\n      document.body.classList.remove(\"high-contrast\");\n    }\n  }, [highContrast]);\n\n  // Toggle high contrast mode\n  const toggleHighContrast = useCallback(() => {\n    setHighContrast((prev) => !prev);\n  }, []);\n\n  // Memoize context value to prevent unnecessary re-renders\n  const value = useMemo<AccessibilityContextValue>(\n    () => ({\n      highContrast,\n      reducedMotion,\n      setHighContrast,\n      toggleHighContrast,\n    }),\n    [highContrast, reducedMotion, toggleHighContrast],\n  );\n\n  return (\n    <AccessibilityContext.Provider value={value}>\n      {children}\n    </AccessibilityContext.Provider>\n  );\n};\n\nAccessibilityProvider.displayName = \"AccessibilityProvider\";\n\n/**\n * Custom hook to access accessibility context\n *\n * @throws Error if used outside of AccessibilityProvider\n * @returns Accessibility context value\n *\n * @example\n * ```tsx\n * const { highContrast, reducedMotion, toggleHighContrast } = useAccessibility();\n * ```\n */\nexport function useAccessibility(): AccessibilityContextValue {\n  const context = useContext(AccessibilityContext);\n\n  if (!context) {\n    throw new Error(\n      \"useAccessibility must be used within AccessibilityProvider\",\n    );\n  }\n\n  return context;\n}\n"],"mappings":";;;;;;;;;;;;;;AAgCA,IAAM,uBAAuB,cAC3B,KACD;;;;;;;;;;;;;;AAsBD,IAAa,yBAA+D,EAC1E,eACI;CACJ,MAAM,CAAC,cAAc,mBAAmB,SAAS,MAAM;CACvD,MAAM,CAAC,eAAe,oBAAoB,SAAS,MAAM;AAGzD,iBAAgB;AACd,MAAI,OAAO,WAAW,YAAa;EAEnC,MAAM,aAAa,OAAO,WAAW,mCAAmC;AACxE,mBAAiB,WAAW,QAAQ;EAEpC,MAAM,gBAAgB,MAA2B;AAC/C,oBAAiB,EAAE,QAAQ;;AAI7B,aAAW,iBAAiB,UAAU,aAAa;AAEnD,eAAa;AACX,cAAW,oBAAoB,UAAU,aAAa;;IAEvD,EAAE,CAAC;AAGN,iBAAgB;AACd,MAAI,OAAO,aAAa,YAAa;AAErC,MAAI,aACF,UAAS,KAAK,UAAU,IAAI,gBAAgB;MAE5C,UAAS,KAAK,UAAU,OAAO,gBAAgB;IAEhD,CAAC,aAAa,CAAC;CAGlB,MAAM,qBAAqB,kBAAkB;AAC3C,mBAAiB,SAAS,CAAC,KAAK;IAC/B,EAAE,CAAC;CAGN,MAAM,QAAQ,eACL;EACL;EACA;EACA;EACA;EACD,GACD;EAAC;EAAc;EAAe;EAAmB,CAClD;AAED,QACE,oBAAC,qBAAqB,UAAtB;EAAsC;EACnC;EAC6B,CAAA;;AAIpC,sBAAsB,cAAc"}

package/lib/components/shared/base/BaseButton.d.ts

@@ -0,0 +1,42 @@
+/**
+ * BaseButton - Enhanced button component with Korean theming
+ *
+ * Builds on existing KoreanButton with extracted common logic
+ * Provides consistent button styling across the application
+ *
+ * Now with Html overlay positioning helpers for:
+ * - Consistent z-index management
+ * - Performance optimization with distanceFactor
+ * - GPU acceleration
+ *
+ * @module components/base
+ */
+import React from "react";
+import type { HtmlOverlayLayer } from "../../../types/HtmlOverlayTypes";
+/**
+ * Props for BaseButton component
+ */
+export interface BaseButtonProps {
+    readonly korean: string;
+    readonly english: string;
+    readonly onClick: () => void;
+    readonly disabled?: boolean;
+    readonly variant?: "primary" | "secondary" | "danger";
+    readonly size?: "sm" | "md" | "lg";
+    readonly position?: [number, number, number];
+    readonly fullWidth?: boolean;
+    readonly testId?: string;
+    readonly isMobile?: boolean;
+    /** Html overlay layer for z-index (default: 'hud') */
+    readonly layer?: HtmlOverlayLayer;
+    /** Whether button should occlude behind 3D objects (default: false) */
+    readonly occlude?: boolean;
+    /** ARIA label for accessibility (optional, defaults to korean text) */
+    readonly ariaLabel?: string;
+    /** ARIA described by ID for additional context */
+    readonly ariaDescribedBy?: string;
+    /** Auto-focus on mount (default: false) */
+    readonly autoFocus?: boolean;
+}
+export declare const BaseButton: React.NamedExoticComponent<BaseButtonProps>;
+//# sourceMappingURL=BaseButton.d.ts.map

package/lib/components/shared/base/BaseButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseButton.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/base/BaseButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAMN,MAAM,OAAO,CAAC;AAOf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAwQD,eAAO,MAAM,UAAU,6CAAkC,CAAC"}