/// Move floor entities to their target Y positions based on movement speed
///
/// # Behavior
/// - Calculates movement distance based on player speed and delta time
/// - Moves floors towards their target Y position
/// - Removes FloorYTarget component when floor reaches destination
pub fn move_floors(
    mut commands: Commands,
    mut maze_query: Query<
        (Entity, &mut Transform, &FloorYTarget),
        (With<HexMaze>, With<FloorYTarget>),
    >,
    player_query: Query<&MovementSpeed, With<Player>>,
    time: Res<Time>,
) {
    let speed = player_query.get_single().map_or(100., |s| s.0);
    let movement_distance = speed * time.delta_secs();
    for (entity, mut transform, movement_state) in maze_query.iter_mut() {
        let delta = movement_state.0 - transform.translation.y;
        if delta.abs() > MOVEMENT_THRESHOLD {
            let movement = delta.signum() * movement_distance.min(delta.abs());
            transform.translation.y += movement;
        } else {
            transform.translation.y = movement_state.0; // snap to final position
            commands.entity(entity).remove::<FloorYTarget>();
        }
    }
}

/// Handle floor transition events by setting up floor movement targets
///
/// # Behavior
/// - Checks if any floors are currently moving
/// - Processes floor transition events
/// - Sets target Y positions for all maze entities
/// - Updates current and next floor designations
pub fn handle_floor_transition_events(
    mut commands: Commands,
    mut maze_query: Query<
        (Entity, &Transform, Option<&FloorYTarget>),
        With<HexMaze>
    >,
    current_query: Query<Entity, With<CurrentFloor>>,
    next_query: Query<Entity, With<NextFloor>>,
    mut event_reader: EventReader<TransitionFloor>,
) {
    let is_moving = maze_query
        .iter()
        .any(|(_, _, movement_state)| movement_state.is_some());
    if is_moving {
        return;
    }
    for event in event_reader.read() {
        let direction = event.into();
        let Some(current_entity) = current_query.get_single().ok() else {
            continue;
        };
        let Some(next_entity) = next_query.get_single().ok() else {
            continue;
        };
        for (entity, transforms, movement_state) in maze_query.iter_mut() {
            let target_y = (FLOOR_Y_OFFSET as f32).mul_add(direction, transforms.translation.y);
            if movement_state.is_none() {
                commands.entity(entity).insert(FloorYTarget(target_y));
            }
        }
        update_current_next_floor(&mut commands, current_entity, next_entity);
        break;
    }