[fix] documentation.

Author: vmarcella

crates/lambda-rs-args/src/lib.rs

@@ -36,8 +36,8 @@ pub struct ArgumentParser {
   is_subcommand: bool,
 }
 
-#[derive(Debug, Copy, Clone, PartialEq, PartialOrd)]
 /// Supported value types for an argument definition.
+#[derive(Debug, Copy, Clone, PartialEq, PartialOrd)]
 pub enum ArgumentType {
   /// `true`/`false` (or implied by presence when compiled as a flag).
   Boolean,
@@ -61,8 +61,8 @@ pub enum ArgumentType {
   DoubleList,
 }
 
-#[derive(Debug, Clone, PartialEq, PartialOrd)]
 /// Parsed value container used in results and defaults.
+#[derive(Debug, Clone, PartialEq, PartialOrd)]
 pub enum ArgumentValue {
   None,
   Boolean(bool),
@@ -112,8 +112,8 @@ impl Into<f64> for ArgumentValue {
   }
 }
 
-#[derive(Debug)]
 /// Declarative definition for a single CLI argument or positional parameter.
+#[derive(Debug)]
 pub struct Argument {
   name: String,
   description: String,
@@ -222,8 +222,8 @@ impl Argument {
   }
 }
 
-#[derive(Debug, Clone)]
 /// A single parsed argument result as `(name, value)`.
+#[derive(Debug, Clone)]
 pub struct ParsedArgument {
   name: String,
   value: ArgumentValue,
@@ -830,8 +830,8 @@ fn parse_value(arg: &Argument, raw: &str) -> Result<ArgumentValue, ArgsError> {
   }
 }
 
-#[derive(Debug)]
 /// Errors that may occur during argument parsing.
+#[derive(Debug)]
 pub enum ArgsError {
   /// An unknown flag or option was encountered.
   UnknownArgument(String),

crates/lambda-rs-platform/src/wgpu/bind.rs

@@ -13,8 +13,8 @@ use crate::wgpu::{
   gpu::Gpu,
 };
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::BindGroupLayout` that preserves a label.
+#[derive(Debug)]
 pub struct BindGroupLayout {
   pub(crate) raw: wgpu::BindGroupLayout,
   pub(crate) label: Option<String>,
@@ -32,8 +32,8 @@ impl BindGroupLayout {
   }
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::BindGroup` that preserves a label.
+#[derive(Debug)]
 pub struct BindGroup {
   pub(crate) raw: wgpu::BindGroup,
   pub(crate) label: Option<String>,
@@ -51,8 +51,8 @@ impl BindGroup {
   }
 }
 
-#[derive(Clone, Copy, Debug)]
 /// Visibility of a binding across shader stages.
+#[derive(Clone, Copy, Debug)]
 pub enum Visibility {
   Vertex,
   Fragment,
@@ -99,8 +99,8 @@ mod tests {
   }
 }
 
-#[derive(Default)]
 /// Builder for creating a `wgpu::BindGroupLayout`.
+#[derive(Default)]
 pub struct BindGroupLayoutBuilder {
   label: Option<String>,
   entries: Vec<wgpu::BindGroupLayoutEntry>,
@@ -171,8 +171,8 @@ impl BindGroupLayoutBuilder {
   }
 }
 
-#[derive(Default)]
 /// Builder for creating a `wgpu::BindGroup`.
+#[derive(Default)]
 pub struct BindGroupBuilder<'a> {
   label: Option<String>,
   layout: Option<&'a wgpu::BindGroupLayout>,

crates/lambda-rs-platform/src/wgpu/buffer.rs

@@ -10,8 +10,8 @@ use wgpu::{
 
 use crate::wgpu::gpu::Gpu;
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// Index format for indexed drawing.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum IndexFormat {
   Uint16,
   Uint32,
@@ -26,8 +26,8 @@ impl IndexFormat {
   }
 }
 
-#[derive(Clone, Copy, Debug)]
 /// Platform buffer usage flags.
+#[derive(Clone, Copy, Debug)]
 pub struct Usage(pub(crate) wgpu::BufferUsages);
 
 impl Usage {
@@ -60,8 +60,8 @@ impl Default for Usage {
   }
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::Buffer` with metadata.
+#[derive(Debug)]
 pub struct Buffer {
   pub(crate) raw: wgpu::Buffer,
   pub(crate) label: Option<String>,
@@ -96,8 +96,8 @@ impl Buffer {
   }
 }
 
-#[derive(Default)]
 /// Builder for creating a `Buffer` with optional initial contents.
+#[derive(Default)]
 pub struct BufferBuilder {
   label: Option<String>,
   size: usize,

crates/lambda-rs-platform/src/wgpu/command.rs

@@ -4,14 +4,14 @@
 
 use super::gpu;
 
-#[derive(Debug)]
 /// Thin wrapper around `wgpu::CommandEncoder` with convenience helpers.
+#[derive(Debug)]
 pub struct CommandEncoder {
   raw: wgpu::CommandEncoder,
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::CommandBuffer` to avoid exposing raw types upstream.
+#[derive(Debug)]
 pub struct CommandBuffer {
   raw: wgpu::CommandBuffer,
 }

crates/lambda-rs-platform/src/wgpu/gpu.rs

@@ -165,8 +165,8 @@ impl GpuBuilder {
   }
 }
 
-#[derive(Debug)]
 /// Errors emitted while building a `Gpu`.
+#[derive(Debug)]
 pub enum GpuBuildError {
   /// No compatible adapter could be found.
   AdapterUnavailable,
@@ -185,9 +185,9 @@ impl From<wgpu::RequestDeviceError> for GpuBuildError {
   }
 }
 
-#[derive(Debug)]
 /// Holds the chosen adapter along with its logical device and submission queue
 /// plus immutable copies of features and limits used to create the device.
+#[derive(Debug)]
 pub struct Gpu {
   adapter: wgpu::Adapter,
   device: wgpu::Device,

crates/lambda-rs-platform/src/wgpu/instance.rs

@@ -4,8 +4,8 @@
 
 use pollster::block_on;
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// Wrapper over `wgpu::Backends` as a bitset.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub struct Backends(wgpu::Backends);
 
 impl Backends {
@@ -40,8 +40,8 @@ impl std::ops::BitOr for Backends {
   }
 }
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// Wrapper over `wgpu::InstanceFlags` as a bitset.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub struct InstanceFlags(wgpu::InstanceFlags);
 
 impl InstanceFlags {
@@ -69,8 +69,8 @@ impl std::ops::BitOr for InstanceFlags {
   }
 }
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// Which DX12 shader compiler to use on Windows platforms.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum Dx12Compiler {
   Fxc,
 }
@@ -83,8 +83,8 @@ impl Dx12Compiler {
   }
 }
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// OpenGL ES 3 minor version (used by GL/Web targets).
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum Gles3MinorVersion {
   Automatic,
   Version0,
@@ -103,8 +103,8 @@ impl Gles3MinorVersion {
   }
 }
 
-#[derive(Debug, Clone)]
 /// Builder for creating a `wgpu::Instance` with consistent defaults.
+#[derive(Debug, Clone)]
 ///
 /// Defaults to primary backends and no special flags. Options map to
 /// `wgpu::InstanceDescriptor` internally without leaking raw types.

crates/lambda-rs-platform/src/wgpu/pipeline.rs

@@ -11,8 +11,8 @@ use crate::wgpu::{
   vertex::ColorFormat,
 };
 
-#[derive(Clone, Copy, Debug)]
 /// Shader stage flags for push constants and visibility.
+#[derive(Clone, Copy, Debug)]
 ///
 /// This wrapper avoids exposing `wgpu` directly to higher layers while still
 /// allowing flexible combinations when needed.
@@ -47,15 +47,15 @@ impl std::ops::BitOrAssign for PipelineStage {
   }
 }
 
-#[derive(Clone, Debug)]
 /// Push constant declaration for a stage and byte range.
+#[derive(Clone, Debug)]
 pub struct PushConstantRange {
   pub stages: PipelineStage,
   pub range: Range<u32>,
 }
 
-#[derive(Clone, Copy, Debug)]
 /// Face culling mode for graphics pipelines.
+#[derive(Clone, Copy, Debug)]
 pub enum CullingMode {
   None,
   Front,
@@ -72,16 +72,16 @@ impl CullingMode {
   }
 }
 
-#[derive(Clone, Copy, Debug)]
 /// Description of a single vertex attribute used by a pipeline.
+#[derive(Clone, Copy, Debug)]
 pub struct VertexAttributeDesc {
   pub shader_location: u32,
   pub offset: u64,
   pub format: ColorFormat,
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::ShaderModule` that preserves a label.
+#[derive(Debug)]
 pub struct ShaderModule {
   raw: wgpu::ShaderModule,
   label: Option<String>,
@@ -108,8 +108,8 @@ impl ShaderModule {
   }
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::PipelineLayout`.
+#[derive(Debug)]
 pub struct PipelineLayout {
   raw: wgpu::PipelineLayout,
   label: Option<String>,
@@ -185,8 +185,8 @@ impl<'a> PipelineLayoutBuilder<'a> {
   }
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::RenderPipeline`.
+#[derive(Debug)]
 pub struct RenderPipeline {
   raw: wgpu::RenderPipeline,
   label: Option<String>,

crates/lambda-rs-platform/src/wgpu/render_pass.rs

@@ -20,26 +20,26 @@ use super::{
   surface,
 };
 
-#[derive(Clone, Copy, Debug, PartialEq)]
 /// Color load operation for a render pass color attachment.
+#[derive(Clone, Copy, Debug, PartialEq)]
 pub enum ColorLoadOp {
   /// Load the existing contents of the attachment.
   Load,
   /// Clear the attachment to the provided RGBA color.
   Clear([f64; 4]),
 }
 
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 /// Store operation for a render pass attachment.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum StoreOp {
   /// Store the results to the attachment at the end of the pass.
   Store,
   /// Discard the results at the end of the pass when possible.
   Discard,
 }
 
-#[derive(Clone, Copy, Debug)]
 /// Combined load and store operations for the color attachment.
+#[derive(Clone, Copy, Debug)]
 pub struct ColorOperations {
   pub load: ColorLoadOp,
   pub store: StoreOp,
@@ -54,16 +54,16 @@ impl Default for ColorOperations {
   }
 }
 
-#[derive(Clone, Debug, Default)]
 /// Configuration for beginning a render pass.
+#[derive(Clone, Debug, Default)]
 pub struct RenderPassConfig {
   pub label: Option<String>,
   pub color_operations: ColorOperations,
 }
 
-#[derive(Debug)]
 /// Wrapper around `wgpu::RenderPass<'_>` exposing the operations needed by the
 /// engine without leaking raw `wgpu` types at the call sites.
+#[derive(Debug)]
 pub struct RenderPass<'a> {
   pub(super) raw: wgpu::RenderPass<'a>,
 }
@@ -151,10 +151,10 @@ impl<'a> RenderPass<'a> {
   }
 }
 
-#[derive(Debug, Default)]
 /// Wrapper for a variably sized list of color attachments passed into a render
 /// pass. The attachments borrow `TextureView` references for the duration of
 /// the pass.
+#[derive(Debug, Default)]
 pub struct RenderColorAttachments<'a> {
   attachments: Vec<Option<wgpu::RenderPassColorAttachment<'a>>>,
 }