Skip to content

VectorCraft: An open-source, vector art tool written by scratch in pure Rust

21.1 KB
Raw Blame
//! The canvas context menu: right-click selects the object under the pointer and lists what
//! applies to the selection.

use egui::{Event, PointerButton, Pos2, Rect, pos2, vec2};
use serde_json::json;
use vectorcraft_doc::{NodeId, NodeKind};
use vectorcraft_engine::Session;
use vectorcraft_geom::Point;

use crate::canvas::Xf;
use crate::menus::{self, Item};
use crate::{VectorcraftApp, canvas};

fn app() -> VectorcraftApp {
    let mut app = VectorcraftApp::new(Session::new(), Default::default());
    app.run("file.new", json!({"width": 400, "height": 300})).unwrap();
    app
}

fn rect(app: &mut VectorcraftApp, x: f64, y: f64) -> NodeId {
    NodeId(app.run("shape.rectangle", json!({"x": x, "y": y, "width": 100, "height": 100})).unwrap()["id"].as_u64().unwrap())
}

/// One headless frame of the canvas on an 800 × 600 window → the text painted, with its rect.
fn frame(app: &mut VectorcraftApp, ctx: &egui::Context, events: Vec<Event>) -> Vec<(String, Rect)> {
    let raw = egui::RawInput { screen_rect: Some(Rect::from_min_size(Pos2::ZERO, vec2(800.0, 600.0))), events, ..Default::default() };
    let mut out = ctx.run_ui(raw, |ui| canvas::show(app, ui));
    out.textures_delta.clear();
    fn walk(s: &egui::Shape, v: &mut Vec<(String, Rect)>) {
        match s {
            egui::Shape::Text(t) => v.push((t.galley.text().to_string(), Rect::from_min_size(t.pos, t.galley.size()))),
            egui::Shape::Vec(s) => s.iter().for_each(|s| walk(s, v)),
            _ => {}
        }
    }
    let mut v = vec![];
    out.shapes.iter().for_each(|c| walk(&c.shape, &mut v));
    v
}

fn press(pos: Pos2, button: PointerButton, pressed: bool) -> Event {
    Event::PointerButton { pos, button, pressed, modifiers: Default::default() }
}

/// Click `button` at `pos` (move, press, release, then a frame to show the result).
fn click(app: &mut VectorcraftApp, ctx: &egui::Context, pos: Pos2, button: PointerButton) -> Vec<(String, Rect)> {
    frame(app, ctx, vec![Event::PointerMoved(pos)]);
    frame(app, ctx, vec![press(pos, button, true)]);
    frame(app, ctx, vec![press(pos, button, false)]);
    frame(app, ctx, vec![])
}

/// Where document point `p` is on screen (after a first frame laid the canvas out).
fn screen(app: &VectorcraftApp, x: f64, y: f64) -> Pos2 {
    Xf::new(app.canvas_rect.unwrap(), app.view().unwrap()).to_screen(Point::new(x, y))
}

fn has(texts: &[(String, Rect)], label: &str) -> bool {
    texts.iter().any(|(t, _)| t.trim_start_matches(['✓', ' ']) == label)
}

fn at(texts: &[(String, Rect)], label: &str) -> Pos2 {
    texts.iter().find(|(t, _)| t == label).map(|(_, r)| r.center()).unwrap_or_else(|| panic!("no `{label}` in {texts:?}"))
}

#[test]
fn right_click_selects_the_object_and_lists_its_commands() {
    let mut app = app();
    let id = rect(&mut app, 50.0, 50.0);
    app.run("select.none", json!({})).unwrap();
    let ctx = egui::Context::default();
    assert!(!has(&frame(&mut app, &ctx, vec![]), "Arrange"));
    let p = screen(&app, 100.0, 100.0);
    let texts = click(&mut app, &ctx, p, PointerButton::Secondary);
    assert_eq!(app.session.active().unwrap().selection.objects, [id], "the object right-clicked is selected");
    for label in ["Undo Rectangle", "Cut", "Copy", "Make Guides", "Transform", "Arrange", "Select", "Export Selection…"] {
        assert!(has(&texts, label), "{label} in {texts:?}");
    }
    // Nothing that needs several objects, a group or nothing selected.
    for label in ["Group", "Ungroup", "Make Clipping Mask", "Release Compound Path", "Select All", "Zoom In"] {
        assert!(!has(&texts, label), "{label} in {texts:?}");
    }
    // Choosing an item runs its command and closes the menu.
    let texts = click(&mut app, &ctx, at(&texts, "Make Guides"), PointerButton::Primary);
    let n = app.session.active().unwrap().doc.node(id).cloned().unwrap();
    assert!(matches!(n.kind, NodeKind::Path { guide: true, .. }));
    assert!(!has(&texts, "Arrange"));
}

#[test]
fn right_click_on_empty_canvas_offers_the_view_and_a_dismissing_click_does_nothing() {
    let mut app = app();
    app.select_tool("rectangle");
    let ctx = egui::Context::default();
    frame(&mut app, &ctx, vec![]);
    let p = screen(&app, 300.0, 250.0);
    let texts = click(&mut app, &ctx, p, PointerButton::Secondary);
    for label in ["Zoom In", "Zoom Out", "Fit Artboard in Window", "Show Rulers", "Select All"] {
        assert!(has(&texts, label), "{label} in {texts:?}");
    }
    assert!(!has(&texts, "Cut") && !has(&texts, "Arrange"));
    // A click on the canvas away from the menu only closes it: the Rectangle tool draws nothing.
    let away = pos2(100.0, 500.0);
    frame(&mut app, &ctx, vec![Event::PointerMoved(away)]);
    frame(&mut app, &ctx, vec![press(away, PointerButton::Primary, true)]);
    frame(&mut app, &ctx, vec![Event::PointerMoved(away + vec2(40.0, 30.0))]);
    frame(&mut app, &ctx, vec![press(away + vec2(40.0, 30.0), PointerButton::Primary, false)]);
    let texts = frame(&mut app, &ctx, vec![]);
    assert!(!has(&texts, "Zoom In"));
    assert_eq!(app.session.active().unwrap().doc.art_bounds(), None);
}

/// A right-click over a locked object adds an Unlock submenu that lists the object by its name.
/// Choosing the name unlocks the object in one undo step; once the menu is closed, the menu lists
/// no Unlock items.
#[test]
fn right_click_on_a_locked_object_offers_unlock_by_its_name() {
    let mut app = app();
    let id = rect(&mut app, 50.0, 50.0);
    app.run("layer.setProps", json!({"ids": [id.0], "name": "Sky", "locked": true})).unwrap();
    let steps = app.session.active().unwrap().history.undo.len();
    let ctx = egui::Context::default();
    frame(&mut app, &ctx, vec![]);
    let p = screen(&app, 100.0, 100.0);
    let texts = click(&mut app, &ctx, p, PointerButton::Secondary);
    assert!(has(&texts, "Unlock"), "{texts:?}");
    // Agents see the item under the Unlock path, by the object's name.
    let entries = menus::context_entries(&app);
    let item = entries.iter().find(|e| e.path == ["Unlock"]).unwrap();
    assert_eq!((item.label.as_str(), item.command.as_deref()), ("Sky", Some("layer.setProps")));
    assert_eq!(item.params, json!({"ids": [id.0], "locked": false}));
    // Hovering Unlock opens the submenu.
    frame(&mut app, &ctx, vec![Event::PointerMoved(at(&texts, "Unlock"))]);
    let texts = frame(&mut app, &ctx, vec![]);
    let texts = click(&mut app, &ctx, at(&texts, "Sky"), PointerButton::Primary);
    let st = app.session.active().unwrap();
    assert!(!st.doc.node(id).unwrap().locked, "the object is unlocked");
    assert_eq!(st.history.undo.len(), steps + 1, "in one undo step");
    assert!(!has(&texts, "Unlock"), "the menu closed: {texts:?}");
    // Locked again, it is not listed until the next right-click over it.
    app.run("layer.setProps", json!({"ids": [id.0], "locked": true})).unwrap();
    assert!(menus::context_entries(&app).iter().all(|e| e.path.first().map(String::as_str) != Some("Unlock")));
}

/// #528: right-clicking a ruler offers the document units, the current one checked, and choosing one
/// swaps them — the same effect as Preferences ▸ Units ▸ General (`document.setUnits`).
#[test]
fn right_clicking_a_ruler_swaps_the_document_units() {
    use vectorcraft_doc::Unit;
    let mut app = app();
    app.ui.view.rulers = true;
    let ctx = egui::Context::default();
    frame(&mut app, &ctx, vec![]);
    assert_eq!(app.session.general_unit(), Unit::Points, "a new document starts in the prefs unit");
    // Right-click on the top ruler (the band along the top, past the origin box).
    let texts = click(&mut app, &ctx, pos2(400.0, 8.0), PointerButton::Secondary);
    for label in ["Points", "Picas", "Inches", "Millimeters", "Feet & Inches", "Pixels"] {
        assert!(has(&texts, label), "{label} in {texts:?}");
    }
    assert!(texts.iter().any(|(t, _)| t == "✓  Points"), "the current unit is checked: {texts:?}");
    // Choosing a unit runs document.setUnits and closes the menu.
    let mm = texts.iter().find(|(t, _)| t.trim_start_matches(['✓', ' ']) == "Millimeters").map(|(_, r)| r.center()).expect("Millimeters");
    let texts = click(&mut app, &ctx, mm, PointerButton::Primary);
    assert_eq!(app.session.general_unit(), Unit::Millimeters, "the ruler's unit changed");
    assert!(!has(&texts, "Inches"), "the menu closed");
    // The left ruler offers the same menu, now checking the new unit.
    let texts = click(&mut app, &ctx, pos2(8.0, 300.0), PointerButton::Secondary);
    assert!(texts.iter().any(|(t, _)| t == "✓  Millimeters"), "the left ruler reflects the current unit: {texts:?}");
}

/// Cmd+Alt+Shift+U is Switch Units by default (Ctrl+Alt+Shift+U on Windows and Linux,
/// Option+Shift+Command+U on macOS): pressed, the document goes to the unit after its own in the
/// ruler's menu, and Smart Guides (Cmd+U) stay as they are. No other default has the key.
#[test]
fn cmd_alt_shift_u_switches_to_the_next_unit() {
    use crate::shortcut_editor as ed;
    use vectorcraft_doc::Unit;
    assert_eq!(ed::default_command_shortcut("document.switchUnits"), Some("Cmd+Alt+Shift+U"));
    assert_eq!(ed::command_for_key("Cmd+Alt+Shift+U"), Some("document.switchUnits"));
    let shown = menus::pretty_shortcut("Cmd+Alt+Shift+U");
    assert_eq!(shown, if cfg!(target_os = "macos") { "⌥⇧⌘U" } else { "Ctrl+Alt+Shift+U" });
    let mut app = app();
    let listed = app.run("shortcuts.list", json!({"query": "document.switchUnits"})).unwrap();
    let rows: Vec<_> = listed.as_array().expect("rows").iter().map(|r| (r["label"].clone(), r["group"].clone(), r["default"].clone())).collect();
    assert_eq!(rows, [(json!("Switch Units"), json!("Document"), json!("Cmd+Alt+Shift+U"))], "Keyboard Shortcuts lists it under Document");
    assert_eq!(app.run("shortcuts.conflicts", json!({})).unwrap(), json!([]), "no other default has the key");
    fn press(app: &mut VectorcraftApp) {
        let ctx = egui::Context::default();
        let modifiers = egui::Modifiers::COMMAND | egui::Modifiers::ALT | egui::Modifiers::SHIFT;
        let ev = Event::Key { key: egui::Key::U, physical_key: None, pressed: true, repeat: false, modifiers };
        let mut out = ctx.run_ui(egui::RawInput { events: vec![ev], ..Default::default() }, |ui| crate::shortcuts::handle(app, ui.ctx()));
        out.textures_delta.clear();
    }
    let guides = app.ui.view.smart_guides;
    press(&mut app);
    assert_eq!(app.session.general_unit(), Unit::Picas, "Points → Picas");
    assert_eq!(app.ui.view.smart_guides, guides, "Smart Guides stay as they are");
    app.run("document.setUnits", json!({"units": "Feet"})).unwrap();
    press(&mut app);
    assert_eq!(app.session.general_unit(), Unit::Points, "Feet → Points");
}

fn labels(items: &[Item]) -> Vec<&'static str> {
    items
        .iter()
        .flat_map(|it| match it {
            Item::Cmd(l, ..) => vec![*l],
            Item::Sub(l, ch) => std::iter::once(*l).chain(labels(ch)).collect(),
            _ => vec![],
        })
        .collect()
}

#[test]
fn the_menu_follows_the_selection() {
    let mut app = app();
    let (a, b) = (rect(&mut app, 0.0, 0.0), rect(&mut app, 50.0, 50.0));
    app.run("select.set", json!({"ids": [a.0, b.0]})).unwrap();
    let l = labels(&menus::context_items(&app));
    for label in ["Group", "Join", "Make Clipping Mask", "Make Compound Path", "Objects on Path", "Bring to Front", "Move…"] {
        assert!(l.contains(&label), "{label} in {l:?}");
    }
    assert!(!l.contains(&"Ungroup") && !l.contains(&"Isolate Selected Group"));
    // Objects on Path chooses its tool, which attaches the selection to the path clicked next.
    menus::invoke(&mut app, "object.objectsOnPath.attach", json!({}));
    assert_eq!(app.session.tool_id(), "objectsOnPath");
    app.select_tool("selection");
    app.run("object.group", json!({})).unwrap();
    let l = labels(&menus::context_items(&app));
    assert!(l.contains(&"Ungroup") && l.contains(&"Isolate Selected Group"));
    assert!(!l.contains(&"Group") && !l.contains(&"Join"));
    // Isolated: a way out.
    menus::invoke(&mut app, "object.isolate", json!({}));
    assert!(labels(&menus::context_items(&app)).contains(&"Exit Isolation Mode"));
    // Agents see the same menu, with submenus as paths.
    let entries = menus::context_entries(&app);
    assert!(entries.iter().any(|e| e.command.as_deref() == Some("object.exitIsolation") && e.enabled));
    app.run("select.set", json!({"ids": [a.0]})).unwrap();
    let entries = menus::context_entries(&app);
    let front = entries.iter().find(|e| e.command.as_deref() == Some("object.arrange.bringToFront")).unwrap();
    assert_eq!(front.path, ["Arrange"]);
    // No separator leads, trails or doubles up.
    let items = menus::context_items(&app);
    assert!(!matches!(items.first(), Some(Item::Sep)) && !matches!(items.last(), Some(Item::Sep)));
    assert!(items.windows(2).all(|w| !matches!(w, [Item::Sep, Item::Sep])));
}

/// Selected type has Bullets and Numbering › Apply Bullets in the context menu and the Type menu,
/// which makes its paragraphs a bulleted list; other art has no such item.
#[test]
fn selected_type_has_apply_bullets() {
    let mut app = app();
    let r = rect(&mut app, 0.0, 0.0);
    app.run("select.set", json!({"ids": [r.0]})).unwrap();
    let bullets = |app: &VectorcraftApp| menus::context_entries(app).into_iter().find(|e| e.command.as_deref() == Some("type.applyBullets"));
    assert!(bullets(&app).is_none(), "a rectangle has no paragraphs");
    let t = NodeId(app.run("text.create", json!({"x": 10, "y": 200, "text": "Item"})).unwrap()["id"].as_u64().unwrap());
    app.run("select.set", json!({"ids": [t.0]})).unwrap();
    let e = bullets(&app).expect("Apply Bullets");
    assert_eq!((e.path.as_slice(), e.label.as_str(), e.enabled), (&["Bullets and Numbering".to_string()][..], "Apply Bullets", true));
    let typed = menus::menu_entries(&app).into_iter().find(|e| e.command.as_deref() == Some("type.applyBullets")).expect("in the Type menu");
    assert_eq!(typed.path, ["Type", "Bullets and Numbering"]);
    menus::invoke(&mut app, "type.applyBullets", json!({}));
    let Some(NodeKind::Text(text)) = app.session.active().unwrap().doc.node(t).map(|n| &n.kind) else { panic!("text") };
    assert!(text.para_at(0).list.is_some());
}

/// Selected type has Bullets and Numbering › Apply Numbers in the context menu and the Type menu,
/// after Apply Bullets, which makes its paragraphs a numbered list; other art has no such item.
#[test]
fn selected_type_has_apply_numbers() {
    let mut app = app();
    let r = rect(&mut app, 0.0, 0.0);
    app.run("select.set", json!({"ids": [r.0]})).unwrap();
    let numbers = |app: &VectorcraftApp| menus::context_entries(app).into_iter().position(|e| e.command.as_deref() == Some("type.applyNumbers"));
    assert!(numbers(&app).is_none(), "a rectangle has no paragraphs");
    let t = NodeId(app.run("text.create", json!({"x": 10, "y": 200, "text": "Item"})).unwrap()["id"].as_u64().unwrap());
    app.run("select.set", json!({"ids": [t.0]})).unwrap();
    let entries = menus::context_entries(&app);
    let at = numbers(&app).expect("Apply Numbers");
    let e = &entries[at];
    assert_eq!((e.path.as_slice(), e.label.as_str(), e.enabled), (&["Bullets and Numbering".to_string()][..], "Apply Numbers", true));
    assert_eq!(entries.get(at.wrapping_sub(1)).and_then(|e| e.command.as_deref()), Some("type.applyBullets"));
    let typed = menus::menu_entries(&app).into_iter().find(|e| e.command.as_deref() == Some("type.applyNumbers")).expect("in the Type menu");
    assert_eq!(typed.path, ["Type", "Bullets and Numbering"]);
    menus::invoke(&mut app, "type.applyNumbers", json!({}));
    let Some(NodeKind::Text(text)) = app.session.active().unwrap().doc.node(t).map(|n| &n.kind) else { panic!("text") };
    assert_eq!(text.para_at(0).list.and_then(|l| l.number), Some(vectorcraft_doc::text::NumberStyle::Arabic));
}

/// The members of the overlap area of Intertwine group `g` at (x, y), in the order they are drawn
/// there, bottom first.
fn intertwine_order(app: &VectorcraftApp, g: NodeId, x: f64, y: f64) -> Vec<NodeId> {
    use vectorcraft_tools::intertwine::{drawn_order, face_at, faces};
    let st = app.session.active().unwrap();
    let children = st.doc.node(g).unwrap().children().unwrap();
    let face = face_at(&faces(children), Point::new(x, y)).unwrap();
    drawn_order(children, &face).into_iter().map(|i| children[i].id).collect()
}

/// With the Intertwine tool, a right-click where three or more objects of the group overlap lists
/// Bring to Front, Bring Forward, Send Backward and Send to Back for the object nearest to the
/// pointer in place of the Arrange submenu, and they move it in that overlap area only. Elsewhere
/// the menu is the usual one.
#[test]
fn right_click_where_three_intertwined_objects_overlap_arranges_the_nearest_one() {
    let mut app = app();
    // Rectangles from x = 50, 90 and 130, 120 wide: all three overlap from x = 130 to 170.
    let wide = |app: &mut VectorcraftApp, x: f64| {
        NodeId(app.run("shape.rectangle", json!({"x": x, "y": 50, "width": 120, "height": 100})).unwrap()["id"].as_u64().unwrap())
    };
    let (a, b, c) = (wide(&mut app, 50.0), wide(&mut app, 90.0), wide(&mut app, 130.0));
    app.run("select.set", json!({"ids": [a.0, b.0, c.0]})).unwrap();
    let g = NodeId(app.run("object.intertwine.make", json!({})).unwrap()["id"].as_u64().unwrap());
    assert_eq!(app.session.tool_id(), "intertwine");
    let ctx = egui::Context::default();
    frame(&mut app, &ctx, vec![]);
    let items = ["Bring to Front", "Bring Forward", "Send Backward", "Send to Back"];
    // By the right edge of A (the first rectangle), where all three overlap.
    let p = screen(&app, 169.0, 100.0);
    let texts = click(&mut app, &ctx, p, PointerButton::Secondary);
    assert_eq!(app.session.active().unwrap().selection.objects, [g], "the selection stays the group");
    for label in items {
        assert!(has(&texts, label), "{label} in {texts:?}");
    }
    assert!(!has(&texts, "Arrange"), "no Arrange submenu: {texts:?}");
    let rows: Vec<f32> = items.iter().map(|l| at(&texts, l).y).collect();
    assert!(rows.windows(2).all(|w| w[0] < w[1]), "in that order: {rows:?}");
    let Some(Item::Cmd(_, id, params)) = menus::context_items(&app).into_iter().find(|i| matches!(i, Item::Cmd("Bring Forward", ..))) else {
        panic!("no Bring Forward item")
    };
    assert_eq!(id, "object.intertwine.arrange");
    assert_eq!((&params["id"], &params["order"], &params["member"]), (&json!(g.0), &json!("forward"), &json!(a.0)));
    // Bring Forward moves A one place up in that area only.
    assert_eq!(intertwine_order(&app, g, 150.0, 100.0), [a, b, c]);
    let texts = click(&mut app, &ctx, at(&texts, "Bring Forward"), PointerButton::Primary);
    assert!(!has(&texts, "Bring Forward"), "the menu closes");
    assert_eq!(intertwine_order(&app, g, 150.0, 100.0), [b, a, c]);
    assert_eq!(intertwine_order(&app, g, 110.0, 100.0), [a, b], "where only A and B overlap");
    // Where only two overlap, the menu is the usual one.
    let p = screen(&app, 110.0, 100.0);
    let texts = click(&mut app, &ctx, p, PointerButton::Secondary);
    assert!(has(&texts, "Arrange") && !has(&texts, "Bring Forward"), "{texts:?}");
}

/// Every label the context menu can show is a menu string, so complete catalogs must translate it.
#[test]
fn every_context_label_is_a_menu_string() {
    let strings = menus::menu_strings();
    let mut app = app();
    let mut shown = vec![];
    // Nothing selected, one path, two paths, a group, a clipping group, a compound path, isolation.
    shown.extend(labels(&menus::context_items(&app)));
    let (a, b) = (rect(&mut app, 0.0, 0.0), rect(&mut app, 50.0, 50.0));
    shown.extend(labels(&menus::context_items(&app)));
    app.run("select.set", json!({"ids": [a.0, b.0]})).unwrap();
    shown.extend(labels(&menus::context_items(&app)));
    app.run("object.compoundPath.make", json!({})).unwrap();
    shown.extend(labels(&menus::context_items(&app)));
    app.run("object.compoundPath.release", json!({})).unwrap();
    app.run("select.set", json!({"ids": [a.0, b.0]})).unwrap();
    app.run("object.clippingMask.make", json!({})).unwrap();
    shown.extend(labels(&menus::context_items(&app)));
    app.run("object.group", json!({})).unwrap();
    shown.extend(labels(&menus::context_items(&app)));
    menus::invoke(&mut app, "object.isolate", json!({}));
    shown.extend(labels(&menus::context_items(&app)));
    // The Unlock submenu that a right-click over a locked object adds.
    menus::invoke(&mut app, "object.exitIsolation", json!({}));
    app.run("layer.setProps", json!({"ids": [a.0], "locked": true})).unwrap();
    app.ui.context_locked = Some((app.session.active().unwrap().uid, vec![a]));
    shown.extend(labels(&menus::context_items(&app)));
    // The Lock Artboards and Unlock Artboards submenus of the Artboard tool.
    app.run("artboard.new", json!({"x": 400, "y": 0, "width": 100, "height": 100})).unwrap();
    app.run("artboard.setProps", json!({"index": 0, "locked": true})).unwrap();
    app.select_tool("artboard");
    shown.extend(labels(&menus::context_items(&app)));
    let missing: Vec<_> = shown.iter().filter(|l| !strings.contains(**l)).collect();
    assert!(missing.is_empty(), "context menu labels missing from menu_strings: {missing:?}");
    for label in menus::CONTEXT_LABELS {
        assert!(shown.contains(label), "`{label}` is listed but the context menu never shows it");
    }
}