qubit-value 0.11.0

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Typed destinations for iterative JSON hashing.

use std::collections::hash_map::DefaultHasher;
use std::hash::Hash;
use std::hash::Hasher;

/// A destination receiving hashes during one iterative traversal.
///
/// # Type Parameters
///
/// * `H` - Caller-selected hasher used for the root JSON value.
pub(super) enum HashDestination<'a, H> {
    /// The caller-provided root destination.
    Root(
        /// Caller-owned destination used for the complete root identity.
        &'a mut H,
    ),
    /// The independent hasher for one JSON object entry.
    ObjectEntry(
        /// Independent state whose final hash is merged without key order.
        DefaultHasher,
    ),
}

impl<H> HashDestination<'_, H>
where
    H: Hasher,
{
    /// Hashes one value into this destination without erasing the hasher type.
    ///
    /// # Type Parameters
    ///
    /// * `T` - Hashable value type accepted by the active destination.
    ///
    /// # Parameters
    ///
    /// * `value` - Value whose identity bytes are appended to this destination.
    #[inline(always)]
    pub(super) fn hash<T>(&mut self, value: &T)
    where
        T: Hash + ?Sized,
    {
        match self {
            Self::Root(state) => value.hash(*state),
            Self::ObjectEntry(state) => value.hash(state),
        }
    }

    /// Returns the object-entry hash, or `None` for the root destination.
    ///
    /// # Returns
    ///
    /// `Some(hash)` for an object-entry destination and `None` for the caller's
    /// root destination.
    #[must_use]
    #[inline(always)]
    pub(super) fn finish_object_entry(self) -> Option<u64> {
        match self {
            Self::ObjectEntry(state) => Some(state.finish()),
            Self::Root(_) => None,
        }
    }
}