Struct Canonicalizer 

pub struct Canonicalizer { /* private fields */ }

Provides deterministic canonicalization and hashing of content Implements explicit v1 algorithms for YAML and Markdown canonicalization

Implementations

impl Canonicalizer

pub fn new() -> Canonicalizer

Create a new canonicalizer with the current version

pub fn version(&self) -> &str

Get the canonicalization version string

pub const fn backend(&self) -> &'static str

Get the canonicalization backend identifier

pub fn canonicalize_yaml(&self, content: &str) -> Result<String, Error>

Canonicalize YAML content (v1 algorithm) Uses JCS (JSON Canonicalization Scheme) approach:

1. Parse YAML → convert to JSON with deterministic maps (BTreeMap)

2. Keep human-readable YAML on disk (normalized: LF, trim trailing spaces, final newline)

3. For hashing: use JCS canonicalization of the JSON representation

   Reserved for future content-addressed verification

pub fn normalize_markdown(&self, content: &str) -> Result<String, Error>

Normalize Markdown content (v1 algorithm) Explicit rules:

1. Normalize \n, trim trailing spaces, collapse trailing blank lines to 1
2. Fence normalization: ``` with language tag preserved
3. Final newline enforced
4. Normalize heading underlines to # style
5. Stable ordering where structure allows

pub fn normalize_text(&self, content: &str) -> String

Normalize plain text content

pub fn hash_canonicalized( &self, content: &str, file_type: FileType, ) -> Result<String, Error>

Compute BLAKE3 hash of canonicalized content with FileType dispatch For YAML: uses JCS (RFC 8785) canonicalization of JSON representation For Markdown: uses v1 normalization rules For Text: uses basic line ending normalization

pub fn hash_canonicalized_with_context( &self, content: &str, file_type: FileType, phase: &str, ) -> Result<String, XCheckerError>

Compute BLAKE3 hash of canonicalized content with error context

Trait Implementations

impl Default for Canonicalizer

fn default() -> Canonicalizer

Returns the “default value” for a type.