more prod ready comments

canvas/src/validation/formatting.rs

@@ -1,6 +1,11 @@
-/* canvas/src/validation/formatting.rs
-   Add new formatting module with CustomFormatter, PositionMapper, DefaultPositionMapper, and FormattingResult
-*/
+// src/validation/formatting.rs
+//! Custom formatting and position mapping for validation/display.
+//!
+//! This module defines the CustomFormatter trait along with helpers to map
+//! cursor positions between the raw stored text and the formatted display
+//! representation. Implementors may provide a custom PositionMapper to handle
+//! advanced formatting scenarios.
+
 use std::sync::Arc;
 
 /// Bidirectional mapping between raw input positions and formatted display positions.
@@ -214,4 +219,4 @@ mod tests {
             _ => panic!("expected success"),
         }
     }
-}
+}

canvas/src/validation/mod.rs

@@ -1,6 +1,11 @@
 // src/validation/mod.rs
+//! Validation subsystem re-exports and helpers.
+//!
+//! This module collects validation-related modules (limits, masks, patterns,
+//! formatting, and state) and re-exports the most commonly used types so that
+//! callers can import them from `crate::validation`.
 
-// Core validation modules
+ // Core validation modules
 pub mod config;
 pub mod limits;
 pub mod state;