feat: Enhance model and texture loading with improved error handling and new features

- Introduced `LoadedModel` and `LoadedTexture` structs for better encapsulation of model and texture data.
- Added functions to load models and textures from archives, including support for resolving textures based on materials and wear entries.
- Implemented error handling for missing textures, materials, and wear entries.
- Updated the rendering pipeline to support texture loading and binding, including command-line arguments for texture customization.
- Enhanced the `texm` crate with new decoding capabilities for various pixel formats, including indexed textures.
- Added tests for texture decoding and loading to ensure reliability and correctness.
- Updated documentation to reflect changes in the material and texture resolution process.

crates/texm/src/error.rs

@@ -23,6 +23,15 @@ pub enum Error {
         expected_end: usize,
         actual_size: usize,
     },
+    MipIndexOutOfRange {
+        requested: usize,
+        mip_count: usize,
+    },
+    MipDataOutOfBounds {
+        offset: usize,
+        size: usize,
+        payload_size: usize,
+    },
     InvalidPageMagic,
     InvalidPageSize {
         expected: usize,
@@ -50,6 +59,21 @@ impl fmt::Display for Error {
                 f,
                 "Texm core data out of bounds: expected_end={expected_end}, actual_size={actual_size}"
             ),
+            Self::MipIndexOutOfRange {
+                requested,
+                mip_count,
+            } => write!(
+                f,
+                "Texm mip index out of range: requested={requested}, mip_count={mip_count}"
+            ),
+            Self::MipDataOutOfBounds {
+                offset,
+                size,
+                payload_size,
+            } => write!(
+                f,
+                "Texm mip data out of bounds: offset={offset}, size={size}, payload_size={payload_size}"
+            ),
             Self::InvalidPageMagic => write!(f, "Texm tail exists but Page magic is missing"),
             Self::InvalidPageSize { expected, actual } => {
                 write!(f, "invalid Page chunk size: expected={expected}, actual={actual}")