tiny.syn.highlightLine

1/// Marks up one line of a document and updates `state` with what the line leaves open. A caller2/// walking a document line by line passes the same `State` to every call, so comments and strings3/// that run over more than one line are marked correctly. The call replaces the storage's spans4/// with this line's spans, each an offset into `text`. The call keeps no spans and returns5/// `.discarded` when the line is longer than the text limit. That line is still scanned in full, so6/// `state` comes out the same as it would with room to spare. A comment or string that `state`7/// carries from a different language is dropped, and the line is scanned fresh. A comment or string8/// that `state` carries from this language runs up to its closing delimiter as one comment or9/// string span, and the rest of the line is scanned as usual. A line with no closing delimiter10/// becomes one span, and the comment or string stays open. The storage must be activated before the11/// call, and the call allocates nothing. The call keeps no reference to `text`.12pub fn highlightLine(13    language: Language,14    text: []const u8,15    state: *State,16    spans: *SpanStorage,17) syn.SpanMaterialization {18    const materialization = prepare(spans, text.len);19    state.rebind(language);20    if (!highlightContinuing(language, text, state, spans)) {21        state.retain(language, highlightFlat(language, text, spans));22    }23    return materialization;24}

1pub const highlightLine = scan.highlightLine;