flash_rowan 0.5.7

Biome's custom Rowan definition (forked from biome_rowan)
Documentation
use crate::green::GreenElement;
use crate::{GreenNode, GreenToken, NodeOrToken, SyntaxKind};
use std::marker::PhantomData;

/// New-type wrapper around a `GreenNode`.
///
/// Allows third-party crates to access limited information about a `GreenNode` or construct
/// a `GreenNode` in a limited places.
#[derive(Debug)]
pub struct RawSyntaxNode<K: SyntaxKind> {
    raw: GreenNode,
    ph: PhantomData<K>,
}

impl<K: SyntaxKind> RawSyntaxNode<K> {
    /// Creates a new node with the given `kind` and `slots`.
    #[inline]
    pub fn new<I>(kind: K, slots: I) -> Self
    where
        I: IntoIterator<Item = Option<RawSyntaxElement<K>>>,
        I::IntoIter: ExactSizeIterator,
    {
        Self {
            raw: GreenNode::new(
                kind.to_raw(),
                slots
                    .into_iter()
                    .map(|slot| slot.map(|element| element.into_green())),
            ),
            ph: PhantomData,
        }
    }

    #[inline]
    pub fn kind(&self) -> K {
        K::from_raw(self.raw.kind())
    }

    /// Unwraps this raw syntax into it's underlying green node.
    #[inline]
    pub(crate) fn into_green(self) -> GreenNode {
        self.raw
    }
}

impl<K: SyntaxKind> From<GreenNode> for RawSyntaxNode<K> {
    #[inline]
    fn from(node: GreenNode) -> Self {
        Self {
            raw: node,
            ph: PhantomData,
        }
    }
}

/// New-type wrapper around a `GreenToken`. Allows third-party crates to access limited information
/// on not yet fully constructed nodes.
#[derive(Debug)]
pub struct RawSyntaxToken<K: SyntaxKind> {
    raw: GreenToken,
    ph: PhantomData<K>,
}

impl<K: SyntaxKind> RawSyntaxToken<K> {
    #[inline]
    pub fn kind(&self) -> K {
        K::from_raw(self.raw.kind())
    }
}

impl<K: SyntaxKind> From<GreenToken> for RawSyntaxToken<K> {
    fn from(token: GreenToken) -> Self {
        Self {
            raw: token,
            ph: PhantomData,
        }
    }
}

pub type RawSyntaxElement<K> = NodeOrToken<RawSyntaxNode<K>, RawSyntaxToken<K>>;

impl<K: SyntaxKind> RawSyntaxElement<K> {
    #[inline]
    pub fn kind(&self) -> K {
        match self {
            Self::Node(node) => node.kind(),
            Self::Token(token) => token.kind(),
        }
    }

    #[inline]
    fn into_green(self) -> GreenElement {
        match self {
            Self::Node(node) => NodeOrToken::Node(node.raw),
            Self::Token(token) => NodeOrToken::Token(token.raw),
        }
    }
}

impl<K: SyntaxKind> From<GreenElement> for RawSyntaxElement<K> {
    #[inline]
    fn from(element: GreenElement) -> Self {
        match element {
            NodeOrToken::Node(node) => Self::Node(RawSyntaxNode::from(node)),
            NodeOrToken::Token(token) => Self::Token(RawSyntaxToken::from(token)),
        }
    }
}

/// New-type wrapper to a reference of a `GreenNode`.
#[derive(Debug)]
pub struct RawSyntaxNodeRef<'a, K: SyntaxKind> {
    raw: &'a GreenNode,
    ph: PhantomData<K>,
}

impl<K: SyntaxKind> RawSyntaxNodeRef<'_, K> {
    #[inline]
    pub fn kind(&self) -> K {
        K::from_raw(self.raw.kind())
    }
}

impl<'a, K: SyntaxKind> From<&'a GreenNode> for RawSyntaxNodeRef<'a, K> {
    #[inline]
    fn from(node: &'a GreenNode) -> Self {
        Self {
            raw: node,
            ph: PhantomData,
        }
    }
}

/// New-type wrapper to a reference of a `GreenToken`
#[derive(Debug)]
pub struct RawSyntaxTokenRef<'a, K: SyntaxKind> {
    raw: &'a GreenToken,
    ph: PhantomData<K>,
}

impl<K: SyntaxKind> RawSyntaxTokenRef<'_, K> {
    #[inline]
    pub fn kind(&self) -> K {
        K::from_raw(self.raw.kind())
    }
}

impl<'a, K: SyntaxKind> From<&'a GreenToken> for RawSyntaxTokenRef<'a, K> {
    #[inline]
    fn from(token: &'a GreenToken) -> Self {
        Self {
            raw: token,
            ph: PhantomData,
        }
    }
}

pub type RawSyntaxElementRef<'a, K> =
    NodeOrToken<RawSyntaxNodeRef<'a, K>, RawSyntaxTokenRef<'a, K>>;

impl<K: SyntaxKind> RawSyntaxElementRef<'_, K> {
    #[inline]
    pub fn kind(&self) -> K {
        match self {
            NodeOrToken::Node(node) => node.kind(),
            NodeOrToken::Token(token) => token.kind(),
        }
    }
}

impl<'a, K: SyntaxKind> From<NodeOrToken<&'a GreenNode, &'a GreenToken>>
    for RawSyntaxElementRef<'a, K>
{
    #[inline]
    fn from(element: NodeOrToken<&'a GreenNode, &'a GreenToken>) -> Self {
        match element {
            NodeOrToken::Node(node) => NodeOrToken::Node(RawSyntaxNodeRef::from(node)),
            NodeOrToken::Token(token) => NodeOrToken::Token(RawSyntaxTokenRef::from(token)),
        }
    }
}

impl<'a, K: SyntaxKind> From<&'a GreenElement> for RawSyntaxElementRef<'a, K> {
    #[inline]
    fn from(element: &'a GreenElement) -> Self {
        match element {
            NodeOrToken::Node(node) => NodeOrToken::Node(RawSyntaxNodeRef::from(node)),
            NodeOrToken::Token(token) => NodeOrToken::Token(RawSyntaxTokenRef::from(token)),
        }
    }
}