1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//! Shared validation utilities for the unified validation framework.
//!
//! This module provides common validation operations that can be used by both
//! raw and owned validators. It centralizes validation logic to avoid code
//! duplication and ensure consistency across the validation framework. The shared
//! utilities implement core ECMA-335 compliance checks and provide reusable validation
//! components for token integrity, schema validation, and reference consistency.
//!
//! # Architecture
//!
//! The shared validation system provides three main categories of utilities:
//! 1. **Token Validation** ([`tokens`]) - Token format and integrity validation
//! 2. **Schema Validation** ([`schema`]) - ECMA-335 schema compliance validation
//! 3. **Reference Validation** ([`references`]) - Cross-table reference integrity validation
//!
//! These utilities are designed to be composed into higher-level validators without
//! duplicating validation logic across the raw and owned validation stages.
//!
//! # Key Components
//!
//! - [`tokens`] - Token format validation and consistency checks
//! - [`schema`] - ECMA-335 specification compliance validation
//! - [`references`] - Cross-table reference integrity validation
//!
//! # Usage Examples
//!
//! ```rust,no_run
//! use dotscope::metadata::validation::{TokenValidator, ReferenceValidator, ReferenceScanner};
//! use dotscope::metadata::cilassemblyview::CilAssemblyView;
//! use dotscope::metadata::token::Token;
//! use std::path::Path;
//!
//! # let path = Path::new("assembly.dll");
//! let view = CilAssemblyView::from_path(&path)?;
//! let scanner = ReferenceScanner::from_view(&view)?;
//!
//! // Token validation example
//! let token_validator = TokenValidator::new(&scanner);
//! let token = Token::new(0x02000001);
//! if token_validator.validate_token_bounds(token).is_ok() {
//! println!("Token bounds are valid");
//! }
//!
//! // Reference validation example
//! let ref_validator = ReferenceValidator::new(&scanner);
//! # Ok::<(), dotscope::Error>(())
//! ```
//!
//! # Thread Safety
//!
//! All shared validation utilities are stateless and implement [`Send`] + [`Sync`],
//! making them safe for concurrent use across multiple validation threads.
//!
//! # Integration
//!
//! This module integrates with:
//! - Raw validators - Used by raw validators for basic validation
//! - Owned validators - Used by owned validators for consistency checks
//! - [`crate::metadata::validation::scanner`] - Provides reference scanning infrastructure
//! - [`crate::metadata::validation::engine`] - Coordinates shared utility usage
pub use ReferenceValidator;
pub use SchemaValidator;
pub use TokenValidator;