nightshade-api 0.51.0

//! A multi-cursor code editor rendered on a virtualized monospace grid.

use leptos::html;
use leptos::prelude::*;
use wasm_bindgen::JsCast;
use wasm_bindgen::prelude::Closure;

use crate::web::code_editor::Highlighter;
use crate::web::{use_retained_closures, visible_range};

fn selection_text(chars: &[char], carets: &[Caret]) -> String {
    let mut sorted = carets.to_vec();
    sorted.sort_by_key(Caret::low);
    sorted
        .iter()
        .map(|caret| chars[caret.low()..caret.high()].iter().collect::<String>())
        .collect::<Vec<_>>()
        .join("\n")
}

fn move_line_edge(chars: &[char], carets: &mut [Caret], to_end: bool, extend: bool) {
    for caret in carets.iter_mut() {
        let (line, _) = line_col(chars, caret.head);
        let target = if to_end {
            line_start(chars, line) + line_len(chars, line)
        } else {
            line_start(chars, line)
        };
        caret.head = target;
        if !extend {
            caret.anchor = target;
        }
    }
}

fn write_clipboard(text: &str) {
    if let Some(window) = web_sys::window() {
        let _ = window.navigator().clipboard().write_text(text);
    }
}

#[derive(Clone, Copy)]
struct Caret {
    anchor: usize,
    head: usize,
}

impl Caret {
    fn collapsed(position: usize) -> Self {
        Self {
            anchor: position,
            head: position,
        }
    }

    fn low(&self) -> usize {
        self.anchor.min(self.head)
    }

    fn high(&self) -> usize {
        self.anchor.max(self.head)
    }
}

fn line_col(chars: &[char], index: usize) -> (usize, usize) {
    let mut line = 0;
    let mut col = 0;
    for &character in &chars[..index.min(chars.len())] {
        if character == '\n' {
            line += 1;
            col = 0;
        } else {
            col += 1;
        }
    }
    (line, col)
}

fn line_start(chars: &[char], line: usize) -> usize {
    let mut current = 0;
    let mut index = 0;
    while index < chars.len() && current < line {
        if chars[index] == '\n' {
            current += 1;
        }
        index += 1;
    }
    index
}

fn line_len(chars: &[char], line: usize) -> usize {
    let start = line_start(chars, line);
    let mut end = start;
    while end < chars.len() && chars[end] != '\n' {
        end += 1;
    }
    end - start
}

fn total_lines(chars: &[char]) -> usize {
    chars.iter().filter(|&&character| character == '\n').count() + 1
}

fn offset_of(chars: &[char], line: usize, col: usize) -> usize {
    line_start(chars, line) + col.min(line_len(chars, line))
}

fn normalize(carets: &mut Vec<Caret>) {
    carets.sort_by_key(Caret::low);
    carets.dedup_by_key(|caret| (caret.anchor, caret.head));
}

fn insert_text(chars: &mut Vec<char>, carets: &mut [Caret], insert: &[char]) {
    carets.sort_by_key(Caret::low);
    let mut delta: isize = 0;
    for caret in carets.iter_mut() {
        let low = (caret.low() as isize + delta) as usize;
        let high = (caret.high() as isize + delta) as usize;
        chars.splice(low..high, insert.iter().copied());
        *caret = Caret::collapsed(low + insert.len());
        delta += insert.len() as isize - (high as isize - low as isize);
    }
}

fn delete_backward(chars: &mut Vec<char>, carets: &mut [Caret]) {
    carets.sort_by_key(Caret::low);
    let mut delta: isize = 0;
    for caret in carets.iter_mut() {
        let low = (caret.low() as isize + delta) as usize;
        let high = (caret.high() as isize + delta) as usize;
        let (from, to) = if high > low {
            (low, high)
        } else if low > 0 {
            (low - 1, low)
        } else {
            (low, low)
        };
        chars.drain(from..to);
        *caret = Caret::collapsed(from);
        delta -= (to - from) as isize;
    }
}

fn move_horizontal(chars: &[char], carets: &mut [Caret], direction: isize, extend: bool) {
    let len = chars.len() as isize;
    for caret in carets.iter_mut() {
        let head = (caret.head as isize + direction).clamp(0, len) as usize;
        caret.head = head;
        if !extend {
            caret.anchor = head;
        }
    }
}

fn move_vertical(chars: &[char], carets: &mut [Caret], direction: isize, extend: bool) {
    for caret in carets.iter_mut() {
        let (line, col) = line_col(chars, caret.head);
        let target = (line as isize + direction).max(0) as usize;
        if target < total_lines(chars) {
            caret.head = offset_of(chars, target, col);
            if !extend {
                caret.anchor = caret.head;
            }
        }
    }
}

fn word_bounds(chars: &[char], index: usize) -> (usize, usize) {
    let is_word = |character: char| character.is_alphanumeric() || character == '_';
    let mut start = index;
    while start > 0 && chars.get(start - 1).is_some_and(|&c| is_word(c)) {
        start -= 1;
    }
    let mut end = index;
    while end < chars.len() && chars.get(end).is_some_and(|&c| is_word(c)) {
        end += 1;
    }
    (start, end)
}

fn add_next_occurrence(chars: &[char], carets: &mut Vec<Caret>) {
    let Some(last) = carets.iter().max_by_key(|caret| caret.high()).copied() else {
        return;
    };
    let (low, high) = if last.high() > last.low() {
        (last.low(), last.high())
    } else {
        word_bounds(chars, last.head)
    };
    if high <= low {
        return;
    }
    let needle = &chars[low..high];
    let mut cursor = high;
    while cursor + needle.len() <= chars.len() {
        if &chars[cursor..cursor + needle.len()] == needle {
            carets.push(Caret {
                anchor: cursor,
                head: cursor + needle.len(),
            });
            return;
        }
        cursor += 1;
    }
}

/// A multi-cursor code editor over the `value` buffer on a virtualized
/// monospace grid: add cursors above/below (Ctrl/Cmd+Alt+Arrow), add-next-
/// occurrence (Ctrl/Cmd+D), select-all, drag-select, clipboard, and IME
/// composition via a hidden textarea sink. Renders only the rows in the visible
/// window (plus `overscan`) at the given `line_height`, `height`, and optional
/// `highlighter`.
#[component]
pub fn MultiEditor(
    value: RwSignal<String>,
    #[prop(optional)] highlighter: Option<Highlighter>,
    #[prop(default = 20.0)] line_height: f64,
    #[prop(default = 360.0)] height: f64,
    #[prop(default = 12)] overscan: usize,
) -> impl IntoView {
    let carets = RwSignal::new(vec![Caret::collapsed(0)]);
    let scroll_top = RwSignal::new(0.0);
    let viewport_height = RwSignal::new(height);
    let wrap_ref = NodeRef::<html::Div>::new();
    let ruler_ref = NodeRef::<html::Span>::new();
    let pressed = StoredValue::new(false);
    let retained = use_retained_closures();
    let textarea_ref = NodeRef::<html::Textarea>::new();
    let composing = StoredValue::new(false);

    let model = Memo::new(move |_| {
        let source = value.get();
        (
            source.chars().collect::<Vec<char>>(),
            source
                .split('\n')
                .map(str::to_string)
                .collect::<Vec<String>>(),
        )
    });

    let offset_at = move |event: &web_sys::PointerEvent| -> Option<usize> {
        let wrap = wrap_ref.get()?;
        let rect = wrap.get_bounding_client_rect();
        let char_width = ruler_ref
            .get()
            .map(|ruler| ruler.get_bounding_client_rect().width() / 10.0)
            .filter(|width| *width > 0.0)
            .unwrap_or(8.0);
        let x = event.client_x() as f64 - rect.left() + wrap.scroll_left() as f64 - 10.0;
        let y = event.client_y() as f64 - rect.top() + wrap.scroll_top() as f64;
        let target_line = (y / line_height).floor().max(0.0) as usize;
        let target_col = (x / char_width).round().max(0.0) as usize;
        model.with(|(chars, _)| {
            let line = target_line.min(total_lines(chars).saturating_sub(1));
            Some(offset_of(chars, line, target_col))
        })
    };

    let on_pointer_down = move |event: web_sys::PointerEvent| {
        if let Some(offset) = offset_at(&event) {
            carets.set(vec![Caret::collapsed(offset)]);
            pressed.set_value(true);
            if let Some(area) = textarea_ref.get() {
                let _ = area.focus();
            }
        }
    };
    let on_pointer_move = move |event: web_sys::PointerEvent| {
        if pressed.get_value()
            && let Some(offset) = offset_at(&event)
        {
            carets.update(|list| {
                if let Some(first) = list.first_mut() {
                    first.head = offset;
                }
            });
        }
    };
    let release_handle =
        window_event_listener(leptos::ev::pointerup, move |_| pressed.set_value(false));
    on_cleanup(move || release_handle.remove());

    let edit = move |mutate: &dyn Fn(&mut Vec<char>, &mut Vec<Caret>)| {
        let mut chars: Vec<char> = value.get_untracked().chars().collect();
        let mut current = carets.get_untracked();
        mutate(&mut chars, &mut current);
        normalize(&mut current);
        value.set(chars.into_iter().collect());
        carets.set(current);
    };

    let copy_selection = move || {
        let chars: Vec<char> = value.get_untracked().chars().collect();
        let text = selection_text(&chars, &carets.get_untracked());
        if !text.is_empty() {
            write_clipboard(&text);
        }
    };
    let paste = move || {
        let Some(window) = web_sys::window() else {
            return;
        };
        let promise = window.navigator().clipboard().read_text();
        let closure = Closure::<dyn FnMut(wasm_bindgen::JsValue)>::new(
            move |result: wasm_bindgen::JsValue| {
                if let Some(text) = result.as_string() {
                    let insert: Vec<char> = text.chars().collect();
                    let mut chars: Vec<char> = value.get_untracked().chars().collect();
                    let mut current = carets.get_untracked();
                    insert_text(&mut chars, &mut current, &insert);
                    normalize(&mut current);
                    value.set(chars.into_iter().collect());
                    carets.set(current);
                }
            },
        );
        let _ = promise.then(&closure);
        retained.retain(closure);
    };

    let commit_input = move || {
        if let Some(area) = textarea_ref.get() {
            let text = area.value();
            if !text.is_empty() {
                let inserted: Vec<char> = text.chars().collect();
                edit(&move |chars, carets| insert_text(chars, carets, &inserted));
                area.set_value("");
            }
        }
    };
    let on_input = move |_: web_sys::Event| {
        if !composing.get_value() {
            commit_input();
        }
    };
    let on_compose_start = move |_: web_sys::CompositionEvent| composing.set_value(true);
    let on_compose_end = move |_: web_sys::CompositionEvent| {
        composing.set_value(false);
        commit_input();
    };

    let on_key = move |event: web_sys::KeyboardEvent| {
        let key = event.key();
        let ctrl = event.ctrl_key() || event.meta_key();
        let alt = event.alt_key();
        let shift = event.shift_key();

        if ctrl && alt && key == "ArrowDown" {
            event.prevent_default();
            edit(&|chars, carets| {
                if let Some(last) = carets.iter().max_by_key(|caret| caret.high()).copied() {
                    let (line, col) = line_col(chars, last.head);
                    if line + 1 < total_lines(chars) {
                        carets.push(Caret::collapsed(offset_of(chars, line + 1, col)));
                    }
                }
            });
            return;
        }
        if ctrl && alt && key == "ArrowUp" {
            event.prevent_default();
            edit(&|chars, carets| {
                if let Some(first) = carets.iter().min_by_key(|caret| caret.low()).copied() {
                    let (line, col) = line_col(chars, first.head);
                    if line > 0 {
                        carets.push(Caret::collapsed(offset_of(chars, line - 1, col)));
                    }
                }
            });
            return;
        }
        if ctrl && key == "d" {
            event.prevent_default();
            edit(&|chars, carets| add_next_occurrence(chars, carets));
            return;
        }
        if ctrl && key == "a" {
            event.prevent_default();
            let len = value.get_untracked().chars().count();
            carets.set(vec![Caret {
                anchor: 0,
                head: len,
            }]);
            return;
        }
        if ctrl && key == "c" {
            event.prevent_default();
            copy_selection();
            return;
        }
        if ctrl && key == "x" {
            event.prevent_default();
            copy_selection();
            edit(&|chars, carets| insert_text(chars, carets, &[]));
            return;
        }
        if ctrl && key == "v" {
            event.prevent_default();
            paste();
            return;
        }
        match key.as_str() {
            "Home" => {
                event.prevent_default();
                edit(&move |chars, carets| move_line_edge(chars, carets, false, shift));
            }
            "End" => {
                event.prevent_default();
                edit(&move |chars, carets| move_line_edge(chars, carets, true, shift));
            }
            "ArrowLeft" => {
                event.prevent_default();
                edit(&move |chars, carets| move_horizontal(chars, carets, -1, shift));
            }
            "ArrowRight" => {
                event.prevent_default();
                edit(&move |chars, carets| move_horizontal(chars, carets, 1, shift));
            }
            "ArrowUp" => {
                event.prevent_default();
                edit(&move |chars, carets| move_vertical(chars, carets, -1, shift));
            }
            "ArrowDown" => {
                event.prevent_default();
                edit(&move |chars, carets| move_vertical(chars, carets, 1, shift));
            }
            "Backspace" => {
                event.prevent_default();
                edit(&|chars, carets| delete_backward(chars, carets));
            }
            "Enter" => {
                event.prevent_default();
                edit(&|chars, carets| insert_text(chars, carets, &['\n']));
            }
            "Tab" => {
                event.prevent_default();
                edit(&|chars, carets| insert_text(chars, carets, &[' ', ' ', ' ', ' ']));
            }
            "Escape" => {
                event.prevent_default();
                carets.update(|list| {
                    if let Some(first) = list.first().copied() {
                        *list = vec![Caret::collapsed(first.head)];
                    }
                });
            }
            _ => {}
        }
    };

    let on_scroll = move |event: web_sys::Event| {
        if let Some(element) = event
            .target()
            .and_then(|target| target.dyn_into::<web_sys::HtmlElement>().ok())
        {
            scroll_top.set(element.scroll_top() as f64);
            viewport_height.set(element.client_height() as f64);
        }
    };

    Effect::new(move |_| {
        if let Some(element) = wrap_ref.get() {
            viewport_height.set(element.client_height() as f64);
        }
    });

    let content = move || {
        let view_height = viewport_height.get().max(line_height);
        let scroll = scroll_top.get();
        let cursors = carets.get();
        model.with(|(chars, lines)| {
        let total = lines.len();
        let (start, end) = visible_range(scroll, view_height, line_height, overscan, total);

        let rendered_lines = (start..end)
            .map(|index| {
                let text = lines[index].clone();
                let spans = match highlighter {
                    Some(highlight) => highlight(&text),
                    None => vec![("tok-plain", text)],
                };
                view! {
                    <div
                        class="nightshade-ml-line"
                        style=format!("top:{}px;height:{}px", index as f64 * line_height, line_height)
                    >
                        {spans
                            .into_iter()
                            .map(|(class, text)| view! { <span class=class>{text}</span> })
                            .collect_view()}
                    </div>
                }
            })
            .collect_view();

        let overlays = cursors
            .into_iter()
            .flat_map(|caret| {
                let mut nodes = Vec::new();
                if caret.high() > caret.low() {
                    let (start_line, start_col) = line_col(chars, caret.low());
                    let (end_line, end_col) = line_col(chars, caret.high());
                    for line in start_line..=end_line {
                        let from = if line == start_line { start_col } else { 0 };
                        let to = if line == end_line {
                            end_col
                        } else {
                            line_len(chars, line) + 1
                        };
                        nodes.push(
                            view! {
                                <div
                                    class="nightshade-ml-selection"
                                    style=format!(
                                        "top:{}px;height:{}px;left:calc(10px + {}ch);width:calc({}ch)",
                                        line as f64 * line_height,
                                        line_height,
                                        from,
                                        to.saturating_sub(from),
                                    )
                                ></div>
                            }
                            .into_any(),
                        );
                    }
                }
                let (line, col) = line_col(chars, caret.head);
                nodes.push(
                    view! {
                        <div
                            class="nightshade-ml-caret"
                            style=format!(
                                "top:{}px;height:{}px;left:calc(10px + {}ch)",
                                line as f64 * line_height,
                                line_height,
                                col,
                            )
                        ></div>
                    }
                    .into_any(),
                );
                nodes
            })
            .collect_view();

        view! {
            <div
                class="nightshade-ml-inner"
                style=format!("height:{}px", total as f64 * line_height)
            >
                {overlays}
                {rendered_lines}
            </div>
        }
        })
    };

    view! {
        <div
            class="nightshade-ml"
            tabindex="0"
            node_ref=wrap_ref
            style=format!("height:{height}px")
            on:keydown=on_key
            on:scroll=on_scroll
            on:pointerdown=on_pointer_down
            on:pointermove=on_pointer_move
        >
            <span node_ref=ruler_ref class="nightshade-ml-ruler">"0000000000"</span>
            <textarea
                class="nightshade-ml-sink"
                node_ref=textarea_ref
                on:input=on_input
                on:compositionstart=on_compose_start
                on:compositionend=on_compose_end
                style=move || {
                    let head = carets.get().last().map(|caret| caret.head).unwrap_or(0);
                    model.with(|(chars, _)| {
                        let (line, col) = line_col(chars, head);
                        format!(
                            "top:{}px; left:calc(10px + {}ch); height:{}px",
                            line as f64 * line_height,
                            col,
                            line_height,
                        )
                    })
                }
            ></textarea>
            {content}
        </div>
    }
}

#[cfg(test)]
mod tests {
    use super::{Caret, add_next_occurrence, delete_backward, insert_text};

    fn chars(text: &str) -> Vec<char> {
        text.chars().collect()
    }

    #[test]
    fn insert_at_multiple_carets_shifts_correctly() {
        let mut buffer = chars("ab\ncd");
        let mut carets = vec![Caret::collapsed(0), Caret::collapsed(3)];
        insert_text(&mut buffer, &mut carets, &['X']);
        assert_eq!(buffer.iter().collect::<String>(), "Xab\nXcd");
        assert_eq!(carets[0].head, 1);
        assert_eq!(carets[1].head, 5);
    }

    #[test]
    fn backspace_deletes_before_each_caret() {
        let mut buffer = chars("ab\ncd");
        let mut carets = vec![Caret::collapsed(2), Caret::collapsed(5)];
        delete_backward(&mut buffer, &mut carets);
        assert_eq!(buffer.iter().collect::<String>(), "a\nc");
    }

    #[test]
    fn selection_text_joins_multiple_carets() {
        let buffer = super::selection_text(
            &chars("abcdef"),
            &[Caret { anchor: 0, head: 2 }, Caret { anchor: 4, head: 6 }],
        );
        assert_eq!(buffer, "ab\nef");
    }

    #[test]
    fn add_next_occurrence_selects_following_match() {
        let buffer = chars("foo bar foo");
        let mut carets = vec![Caret { anchor: 0, head: 3 }];
        add_next_occurrence(&buffer, &mut carets);
        assert_eq!(carets.len(), 2);
        assert_eq!(carets[1].anchor, 8);
        assert_eq!(carets[1].head, 11);
    }
}