thymeleaf 0.1.0-beta.0

use crate::util::Utf16String;

use super::{ElementName, ElementNameError, ElementNameKind};

/// TEXT、JAVASCRIPT 与 CSS 模式共用的元素名称。
///
/// 对应 Java: `org.thymeleaf.engine.TextElementName`。
///
/// 文本模板只产生一个 complete name；非空 prefix 以 `prefix:name` 组合，null
/// 或空 prefix 使用原 element name。基类仍保存调用方原始 prefix，因此空 prefix
/// 的 `isPrefixed()` 与 complete-name 选择刻意表现不同。
pub struct TextElementName {
    element_name: ElementName,
    complete_namespaced_element_name: Utf16String,
}

impl TextElementName {
    /// 对应 Java: `TextElementName#forName()`。
    pub(super) fn for_name(
        prefix: Option<Utf16String>,
        element_name: Option<Utf16String>,
    ) -> Result<Self, ElementNameError> {
        let raw_element_name = element_name
            .as_ref()
            .ok_or(ElementNameError::InvalidElementName)?;
        let has_prefix = prefix.as_ref().is_some_and(|value| !value.is_empty());
        let complete_namespaced_element_name = if has_prefix {
            let prefix_value = prefix.as_ref().expect("checked non-null prefix");
            let mut complete = prefix_value.as_utf16().to_vec();
            complete.push(u16::from(b':'));
            complete.extend_from_slice(raw_element_name.as_utf16());
            Utf16String::from_utf16(complete)
        } else {
            raw_element_name.clone()
        };
        let base = ElementName::new(
            ElementNameKind::Text,
            prefix,
            element_name,
            vec![Some(complete_namespaced_element_name.clone())],
        )?;
        Ok(Self {
            element_name: base,
            complete_namespaced_element_name,
        })
    }

    /// 返回基础 `ElementName` 视图。
    #[must_use]
    pub const fn as_element_name(&self) -> &ElementName {
        &self.element_name
    }

    /// 返回可直接用于文本模式匹配的完整命名空间元素名。
    #[must_use]
    pub const fn get_complete_namespaced_element_name(&self) -> &Utf16String {
        &self.complete_namespaced_element_name
    }
}