feat: integrate TUI module and apply professional refactoring

include/vec3.h

@@ -1,10 +1,3 @@
-/**
- * @file vec3.h
- * @brief 3D Vector mathematics for ASCII 3D Renderer
- * @author ASCII3D Project
- * @version 1.0.0
- */
-
 #ifndef ASCII3D_VEC3_H
 #define ASCII3D_VEC3_H
 
@@ -12,104 +5,29 @@
 extern "C" {
 #endif
 
-/**
- * @brief 3D Vector structure
- */
+// A standard 3-component float vector
 typedef struct Vec3 {
-    float x;
-    float y;
-    float z;
+  float x;
+  float y;
+  float z;
 } Vec3;
 
-/**
- * @brief Create a new Vec3
- * @param x X component
- * @param y Y component
- * @param z Z component
- * @return New Vec3 instance
- */
 Vec3 vec3_create(float x, float y, float z);
-
-/**
- * @brief Add two vectors
- * @param a First vector
- * @param b Second vector
- * @return Result of a + b
- */
 Vec3 vec3_add(Vec3 a, Vec3 b);
-
-/**
- * @brief Subtract two vectors
- * @param a First vector
- * @param b Second vector
- * @return Result of a - b
- */
 Vec3 vec3_sub(Vec3 a, Vec3 b);
-
-/**
- * @brief Scale a vector by a scalar
- * @param v Vector to scale
- * @param s Scalar value
- * @return Scaled vector
- */
 Vec3 vec3_scale(Vec3 v, float s);
-
-/**
- * @brief Calculate dot product of two vectors
- * @param a First vector
- * @param b Second vector
- * @return Dot product
- */
 float vec3_dot(Vec3 a, Vec3 b);
-
-/**
- * @brief Calculate cross product of two vectors
- * @param a First vector
- * @param b Second vector
- * @return Cross product
- */
 Vec3 vec3_cross(Vec3 a, Vec3 b);
-
-/**
- * @brief Calculate length of a vector
- * @param v Vector
- * @return Length
- */
 float vec3_length(Vec3 v);
-
-/**
- * @brief Normalize a vector
- * @param v Vector to normalize
- * @return Normalized vector
- */
 Vec3 vec3_normalize(Vec3 v);
 
-/**
- * @brief Rotate vector around X axis
- * @param v Vector to rotate
- * @param angle Angle in radians
- * @return Rotated vector
- */
+// Rotating points through standard Euler coordinate transformations
 Vec3 vec3_rotate_x(Vec3 v, float angle);
-
-/**
- * @brief Rotate vector around Y axis
- * @param v Vector to rotate
- * @param angle Angle in radians
- * @return Rotated vector
- */
 Vec3 vec3_rotate_y(Vec3 v, float angle);
-
-/**
- * @brief Rotate vector around Z axis
- * @param v Vector to rotate
- * @param angle Angle in radians
- * @return Rotated vector
- */
 Vec3 vec3_rotate_z(Vec3 v, float angle);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif /* ASCII3D_VEC3_H */
+#endif