new architecture

crates/gfx_hal/src/error.rs

@@ -0,0 +1,64 @@
+use ash::vk;
+use thiserror::Error;
+
+/// Top-level error type for the gfx_hal crate.
+#[derive(Error, Debug)]
+pub enum GfxHalError {
+    /// Error originating directly from a Vulkan API call.
+    #[error("Vulkan API Error: {0}")]
+    VulkanError(#[from] vk::Result),
+
+    /// Error loading the Vulkan library or resolving function pointers.
+    #[error("Failed to load Vulkan library: {0}")]
+    LoadError(String),
+
+    /// No suitable physical device (GPU) could be found that meets requirements.
+    #[error("No suitable physical device found: {0}")]
+    NoSuitableGpu(String),
+
+    /// A required Vulkan instance or device extension is not supported.
+    #[error("Missing required Vulkan extension: {0:?}")]
+    MissingExtension(String),
+
+    /// A required Vulkan feature is not supported by the physical device.
+    #[error("Missing required Vulkan feature.")]
+    MissingFeature,
+
+    /// Failed to find a suitable queue family (e.g., graphics, present).
+    #[error("Could not find required queue family: {0}")]
+    MissingQueueFamily(String),
+
+    /// Error related to window system integration surface creation.
+    #[error("Failed to create Vulkan surface: {0}")]
+    SurfaceCreationError(vk::Result),
+
+    /// The Vulkan surface became invalid (e.g., window resized, closed).
+    #[error("Vulkan surface is no longer valid (maybe lost or out of date)")]
+    SurfaceLost,
+
+    /// Error converting a C-style string.
+    #[error("Invalid C string: {0}")]
+    InvalidCString(#[from] std::ffi::NulError),
+
+    /// Error converting C string slice to Rust string slice.
+    #[error("Invalid UTF-8 sequence in C string: {0}")]
+    InvalidCStringUtf8(#[from] std::ffi::FromBytesWithNulError),
+
+    /// Generic I/O error.
+    #[error("I/O error: {0}")]
+    IoError(#[from] std::io::Error),
+
+    /// Error with winit windowing library.
+    #[error("Winit Error: {0}")]
+    WinitHandleError(#[from] winit::raw_window_handle::HandleError),
+
+    /// Ash loader error.
+    #[error("Error loading the ash entry.")]
+    AshEntryError(#[from] ash::LoadingError),
+
+    /// Placeholder for other specific errors.
+    #[error("An unexpected error occurred: {0}")]
+    Other(String),
+}
+
+pub type Result<T, E = GfxHalError> = std::result::Result<T, E>;