vize_l1 0.488.0

//! Generic live namespace recovery; authored heads are recorded uninterpreted.

use vize_l0::{Allocator, Namespace, Vec, is_void_tag};

use crate::build::scope::{Frame, Recovery};
use crate::event::{EventKind, Recorder};
use crate::markup::entity::DecodedEntity;
use crate::markup::{LexErrorCode, QuoteType, Sink};

struct OpenFrame<'a> {
    tag: &'a str,
    ns: Namespace,
}

impl<'a> Frame<'a> for OpenFrame<'a> {
    fn tag(&self) -> &'a str {
        self.tag
    }

    fn namespace(&self) -> Namespace {
        self.ns
    }
}

pub(super) struct NamespaceSink<'a, 'v> {
    source: &'a str,
    recorder: Recorder<'a, 'v>,
    stack: Vec<'a, OpenFrame<'a>>,
    recovery: Recovery<'a>,
    tag: Option<&'a str>,
    live: bool,
}

impl<'a, 'v> NamespaceSink<'a, 'v> {
    pub(super) fn new(
        allocator: &'a Allocator,
        source: &'a str,
        recorder: Recorder<'a, 'v>,
    ) -> Self {
        Self {
            source,
            recorder,
            stack: Vec::new_in(&allocator),
            recovery: Recovery::new(allocator, true),
            tag: None,
            live: false,
        }
    }

    // The live owner is needed only when the lexer reaches its first title.
    // Replay recorded structural heads once; do not lex or inspect attributes.
    fn activate(&mut self) {
        for index in 0..self.recorder.events.len() {
            let Some(event) = self.recorder.events.get(index).copied() else {
                break;
            };
            match event.kind {
                EventKind::OpenTagName => {
                    self.tag = self.source.get(event.start as usize..event.end as usize);
                }
                EventKind::OpenTagEnd => self.finish_tag(false),
                EventKind::SelfClosingTag => self.finish_tag(true),
                EventKind::CloseTag => {
                    if let Some(tag) = self.source.get(event.start as usize..event.end as usize) {
                        self.close_tag(tag);
                    }
                }
                _ => {}
            }
        }
        self.live = true;
    }

    fn close_tag(&mut self, tag: &str) {
        if let Some(depth) = self.recovery.close(&self.stack, tag) {
            self.stack.truncate(depth);
        }
    }

    fn finish_tag(&mut self, self_closing: bool) {
        let Some(tag) = self.tag.take() else { return };
        let (ns, implicit_depth) = self.recovery.open(&self.stack, tag, self_closing);
        if let Some(depth) = implicit_depth {
            self.stack.truncate(depth);
        }
        if !self_closing && !is_void_tag(tag) {
            self.stack.push(OpenFrame { tag, ns });
        }
    }
}

macro_rules! forward {
    ($($name:ident($($arg:ident: $ty:ty),*);)*) => {
        $(fn $name(&mut self, $($arg: $ty),*) {
            self.recorder.$name($($arg),*);
        })*
    };
}

impl Sink for NamespaceSink<'_, '_> {
    forward! {
        on_text(start: usize, end: usize);
        on_text_entity(ch: char, start: usize, end: usize);
        on_text_entity_value(value: DecodedEntity, start: usize, end: usize);
        on_interpolation(start: usize, end: usize);
        on_attrib_data(start: usize, end: usize);
        on_attrib_entity(ch: char, start: usize, end: usize);
        on_attrib_entity_value(value: DecodedEntity, start: usize, end: usize);
        on_attrib_end(quote: QuoteType, end: usize);
        on_attrib_name(start: usize, end: usize);
        on_attrib_name_end(end: usize);
        on_dir_name(start: usize, end: usize);
        on_dir_arg(start: usize, end: usize);
        on_dir_modifier(start: usize, end: usize);
        on_comment(start: usize, end: usize);
        on_cdata(start: usize, end: usize);
        on_processing_instruction(start: usize, end: usize);
        on_end();
        on_error(code: LexErrorCode, index: usize);
    }

    fn on_open_tag_name(&mut self, start: usize, end: usize) {
        let tag = self.source.get(start..end);
        if !self.live && tag.is_some_and(|tag| tag.eq_ignore_ascii_case("title")) {
            self.activate();
        }
        if self.live {
            self.tag = tag;
        }
        self.recorder.on_open_tag_name(start, end);
    }

    fn svg_title_children(&self) -> bool {
        self.stack.last().is_some_and(|parent| {
            parent.ns == Namespace::Svg && !matches!(parent.tag, "foreignObject" | "desc" | "title")
        })
    }

    fn on_open_tag_end(&mut self, end: usize) {
        if self.live {
            self.finish_tag(false);
        }
        self.recorder.on_open_tag_end(end);
    }

    fn on_self_closing_tag(&mut self, end: usize) {
        if self.live {
            self.finish_tag(true);
        }
        self.recorder.on_self_closing_tag(end);
    }

    fn on_close_tag(&mut self, start: usize, end: usize) {
        if self.live
            && let Some(tag) = self.source.get(start..end)
        {
            self.close_tag(tag);
        }
        self.recorder.on_close_tag(start, end);
    }
}

#[cfg(test)]
mod tests {
    //! The deferred owner must retain the complete previous eager event stream.

    use vize_l0::{Allocator, Vec};

    use super::NamespaceSink;
    use crate::event::{Event, Recorder};
    use crate::markup::{Component, LexOptions, Lexer};
    use crate::parse::SurfaceError;

    fn record<'a>(
        allocator: &'a Allocator,
        source: &'a str,
        eager: bool,
    ) -> (Vec<'a, Event>, Vec<'a, SurfaceError>) {
        let mut events = Vec::new_in(&allocator);
        let mut errors = Vec::new_in(&allocator);
        let recorder = Recorder {
            events: &mut events,
            errors: &mut errors,
        };
        let mut sink = NamespaceSink::new(allocator, source, recorder);
        sink.live = eager;
        Lexer::<Component, _>::new(source, sink, LexOptions::default()).run();
        (events, errors)
    }

    #[test]
    fn deferred_title_scope_keeps_every_eager_event_and_error() {
        let sources = [
            "<div><span>before</span></div><svg><title><span>one</span></title></svg>",
            "<div><svg><title><span>one</span></title></svg><svg><title><b>two</b></title></svg></div>",
            "<svg><TITLE><span>upper</span></TITLE><title><b>later</b></title></svg>",
            "<svg><foreignObject><title><span>html</span></title></foreignObject><title><b>svg</b></title></svg>",
            "<div><svg></div><title><span>html</span></title>",
            "<button><span><button></button></button><svg><title><b>svg</b></title></svg>",
            "<a><a></a></a><svg><title><b>svg</b></title></svg>",
            "<svg><path/><title><span>svg</span></title></svg><title><b>html</b></title>",
            "<svg><title/><title><span>svg</span></title></svg>",
            "<math><mtext><svg><title><b>svg</b></title></svg></mtext></math>",
            "<div :[broken><svg><title><b>svg</b></title></svg></div>",
            "<svg><title",
            "<div><span>no title</span><button>one</button></div>",
        ];
        for source in sources {
            let allocator = Allocator::new();
            let (eager_events, eager_errors) = record(&allocator, source, true);
            let (deferred_events, deferred_errors) = record(&allocator, source, false);
            assert_eq!(
                deferred_events, eager_events,
                "whole event stream: {source}"
            );
            assert!(
                deferred_errors
                    .iter()
                    .map(|error| (error.code, error.offset))
                    .eq(eager_errors.iter().map(|error| (error.code, error.offset))),
                "all exact diagnostics: {source}"
            );
            let (tree, _) = crate::parse(&allocator, source);
            assert_eq!(crate::check_fidelity(&tree), Ok(()), "{source}");
        }
    }
}