S box: command search at the cursor (fuzzy over name, id, tab and panel; recent first; pinned favourites as a mini toolbar; kept between runs); Named Views in the browser (save the camera, restore animated, rename, update, delete; Top/Front/Right/Home listed; view.save/rename/delete/list, saved in the design); Keyboard Shortcuts (File menu): rebind any command, conflicts reported, clear, reset, kept between runs; ui.shortcut control method

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AS5Tn3xieewUSg3uxrMVdL
This commit is contained in:
bherbruckandClaude Opus 5.5 committed 2026-10-08 10:29:11 +00:00
1 parent d0a9ef27ca
commit a7fc1fe532
11 files changed
+825 -8

No files matched your search

+287
View File
@@ -0,0 +1,287 @@
//! The S box: a command search that opens at the cursor (the S key). It searches every command by
//! name, id, toolbar tab and panel with a forgiving (fuzzy) match. With nothing typed it lists
//! the recent commands first. Pinned commands sit in a row of icons on top, a small toolbar of
//! favourites. Up/Down choose, Enter runs, Esc closes. Recent and pinned commands are kept
//! between runs.
use egui::{Align2, FontId, Pos2, Rect, Sense, Stroke, pos2, vec2};
use serde_json::{Value, json};
use solvecraft_engine::command_specs;
use crate::theme::Tokens;
use crate::{SolveApp, icons};
/// How many recent commands are kept.
const RECENT: usize = 12;
const W: f32 = 340.0;
#[derive(Default)]
pub struct ShortcutBox {
/// Where it opened (the cursor), while open.
at: Option<Pos2>,
/// The highlighted row.
index: usize,
/// What is typed.
pub text: String,
/// Most recent first.
pub recent: Vec<String>,
pub pinned: Vec<String>,
}
impl ShortcutBox {
pub fn prefs(&self) -> Value {
json!({ "recent": self.recent, "pinned": self.pinned })
}
pub fn load(&mut self, v: &Value) {
let list = |k: &str| -> Vec<String> {
v.get(k).and_then(Value::as_array).map(|a| a.iter().take(64).filter_map(|x| x.as_str().map(str::to_string)).collect()).unwrap_or_default()
};
self.recent = list("recent");
self.pinned = list("pinned");
}
/// A command was run from the box: it goes to the front of the recent list.
pub fn used(&mut self, id: &str) {
self.recent.retain(|r| r != id);
self.recent.insert(0, id.to_string());
self.recent.truncate(RECENT);
}
pub fn toggle_pin(&mut self, id: &str) {
if self.pinned.iter().any(|p| p == id) {
self.pinned.retain(|p| p != id);
} else {
self.pinned.push(id.to_string());
}
}
}
/// How well `q` matches `s` (0 = not at all): a prefix beats a word start beats a substring
/// beats the letters in order with gaps.
pub fn score(q: &str, s: &str) -> u32 {
if q.is_empty() {
return 1;
}
let s = s.to_lowercase();
if s.starts_with(q) {
return 1000 - s.len().min(500) as u32;
}
if s.split(|c: char| !c.is_alphanumeric()).any(|w| w.starts_with(q)) {
return 800;
}
if s.contains(q) {
return 600;
}
// Letters in order: fewer gaps score higher.
let mut gaps = 0u32;
let mut it = s.chars();
let mut last_hit = true;
for qc in q.chars() {
let mut found = false;
for c in it.by_ref() {
if c == qc {
found = true;
break;
}
if last_hit {
gaps += 1;
}
last_hit = false;
}
if !found {
return 0;
}
last_hit = true;
}
300u32.saturating_sub(gaps * 20).max(10)
}
/// Commands matching `q`, best first: (id, label, icon, where it lives on the toolbar). With an
/// empty query, recent commands come first, then everything by name.
pub fn search(app: &SolveApp, q: &str) -> Vec<(&'static str, &'static str, &'static str, String)> {
let q = q.trim().to_lowercase();
let mut v: Vec<(u32, &'static str, &'static str, &'static str, String)> = command_specs()
.into_iter()
.filter_map(|c| {
let place = if c.tab.is_empty() { String::new() } else { format!("{} › {}", c.tab, c.panel) };
let s = score(&q, c.label).max(score(&q, c.id) * 9 / 10).max(score(&q, c.tab) / 3).max(score(&q, c.panel) / 3);
let recent = app.sbox.recent.iter().position(|r| r == c.id).map_or(0, |i| 2000 - i as u32);
// Commands that can run now come before those that can't.
let usable = if c.info(&app.session).enabled { 150 } else { 0 };
(s > 0).then_some((s + usable + if q.is_empty() { recent } else { recent / 20 }, c.id, c.label, c.icon, place))
})
.collect();
v.sort_by(|a, b| b.0.cmp(&a.0).then(a.2.cmp(b.2)));
v.into_iter().map(|(_, id, label, icon, place)| (id, label, icon, place)).collect()
}
/// Open the box at a point (the cursor), or at the middle of the window.
pub fn open(app: &mut SolveApp, at: Option<Pos2>) {
app.ui.palette_open = true;
app.sbox.at = at;
app.sbox.index = 0;
app.sbox.text.clear();
}
fn run(app: &mut SolveApp, id: &str) {
app.sbox.used(id);
app.ui.palette_open = false;
app.sbox.at = None;
app.sbox.text.clear();
app.start(id);
}
pub fn show(app: &mut SolveApp, ctx: &egui::Context) {
if !app.ui.palette_open {
app.sbox.at = None;
return;
}
let t = Tokens::get();
let screen = ctx.content_rect();
let at = *app.sbox.at.get_or_insert_with(|| ctx.input(|i| i.pointer.latest_pos()).unwrap_or(screen.center()));
let list = search(app, &app.sbox.text);
let (up, down, enter, esc) = ctx.input(|i| {
(i.key_pressed(egui::Key::ArrowUp), i.key_pressed(egui::Key::ArrowDown), i.key_pressed(egui::Key::Enter), i.key_pressed(egui::Key::Escape))
});
if down {
app.sbox.index = (app.sbox.index + 1).min(list.len().saturating_sub(1));
}
if up {
app.sbox.index = app.sbox.index.saturating_sub(1);
}
let mut picked: Option<&'static str> = None;
let mut pin: Option<&'static str> = None;
let h = 380.0;
let pos = pos2(
at.x.clamp(screen.left() + 4.0, (screen.right() - W - 4.0).max(screen.left())),
at.y.clamp(screen.top() + 4.0, (screen.bottom() - h).max(screen.top())),
);
let resp = egui::Area::new(egui::Id::new("sc_sbox")).fixed_pos(pos).order(egui::Order::Foreground).show(ctx, |ui| {
crate::context_menu::menu_frame(ui, |ui| {
ui.set_width(W - 10.0);
// Pinned commands: a mini toolbar.
if !app.sbox.pinned.is_empty() {
ui.horizontal_wrapped(|ui| {
for id in app.sbox.pinned.clone() {
let Some(c) = solvecraft_engine::find_command(&id) else { continue };
let (r, resp) = ui.allocate_exact_size(vec2(28.0, 28.0), Sense::click());
if resp.hovered() {
ui.painter().rect_filled(r, 4.0, t.hover);
}
icons::paint(ui.painter(), r.shrink(5.0), c.icon, t.icon, t.icon_fill, t.accent);
if resp.on_hover_text(c.label).clicked() {
picked = Some(c.id);
}
}
});
ui.separator();
}
let te = ui.add(
egui::TextEdit::singleline(&mut app.sbox.text).hint_text("Search commands").desired_width(W - 20.0).id(egui::Id::new("sc_sbox_text")),
);
te.request_focus();
if te.changed() {
app.sbox.index = 0;
}
ui.add_space(4.0);
if app.sbox.text.trim().is_empty() && !app.sbox.recent.is_empty() {
ui.label(egui::RichText::new("RECENT").size(10.0).color(t.text_dim));
}
egui::ScrollArea::vertical().max_height(h - 90.0).show(ui, |ui| {
ui.spacing_mut().item_spacing.y = 0.0;
for (i, (id, label, icon, place)) in list.iter().enumerate().take(80) {
let enabled = solvecraft_engine::find_command(id).is_some_and(|c| c.info(&app.session).enabled);
let (r, resp) = ui.allocate_exact_size(vec2(W - 20.0, 26.0), Sense::click());
let lit = i == app.sbox.index || resp.hovered();
if lit {
ui.painter().rect_filled(r, 4.0, t.hover);
if i == app.sbox.index && (up || down) {
ui.scroll_to_rect(r, None);
}
}
let ink = if enabled { t.icon } else { t.border };
icons::paint(
ui.painter(),
Rect::from_center_size(pos2(r.left() + 14.0, r.center().y), vec2(16.0, 16.0)),
icon,
ink,
t.icon_fill,
t.accent,
);
let col = if enabled { t.text } else { t.text_dim };
ui.painter().text(pos2(r.left() + 30.0, r.center().y), Align2::LEFT_CENTER, *label, FontId::proportional(13.0), col);
let key = crate::keymap::effective(app, id).unwrap_or_default();
let right = if key.is_empty() { place.clone() } else { format!("{key} {place}") };
ui.painter().text(pos2(r.right() - 26.0, r.center().y), Align2::RIGHT_CENTER, right, FontId::proportional(10.5), t.text_dim);
// The pin.
let pinned = app.sbox.pinned.iter().any(|p| p == id);
let pr = Rect::from_center_size(pos2(r.right() - 11.0, r.center().y), vec2(16.0, 16.0));
let presp = ui.interact(pr, ui.id().with(("pin", *id)), Sense::click());
if pinned || lit {
let c = pr.center();
let pts: Vec<Pos2> = (0..10)
.map(|k| {
let a = std::f32::consts::PI * (k as f32 / 5.0) - std::f32::consts::FRAC_PI_2;
let rr = if k % 2 == 0 { 6.0 } else { 2.6 };
c + vec2(a.cos() * rr, a.sin() * rr)
})
.collect();
if pinned {
ui.painter().add(egui::Shape::convex_polygon(pts.clone(), t.warning, Stroke::NONE));
}
ui.painter().add(egui::Shape::closed_line(pts, Stroke::new(1.0, if pinned { t.warning } else { t.text_dim })));
}
if presp.on_hover_text(if pinned { "Unpin" } else { "Pin to the top of the S box" }).clicked() {
pin = Some(id);
} else if resp.clicked() && enabled {
picked = Some(id);
}
}
});
});
});
if let Some(id) = pin {
app.sbox.toggle_pin(id);
}
if enter
&& picked.is_none()
&& let Some((id, ..)) = list.get(app.sbox.index)
{
picked = Some(id);
}
let outside = ctx.input(|i| i.pointer.any_pressed()) && !resp.response.contains_pointer();
if let Some(id) = picked {
run(app, id);
} else if esc || outside {
app.ui.palette_open = false;
app.sbox.at = None;
app.sbox.text.clear();
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn fuzzy_scores_prefixes_over_words_over_letters() {
assert!(score("ext", "Extrude") > score("ext", "Offset Text"));
assert!(score("pres", "Press Pull") > score("ppl", "Press Pull"));
assert!(score("ppl", "Press Pull") > 0);
assert_eq!(score("xyz", "Extrude"), 0);
}
#[test]
fn search_finds_by_name_id_and_panel_and_puts_recent_first() {
let mut app = SolveApp::new(solvecraft_engine::Session::default(), Default::default());
assert_eq!(search(&app, "extr").first().map(|x| x.0), Some("Extrude"));
assert_eq!(search(&app, "FusionFilletEdges").first().map(|x| x.0), Some("FusionFilletEdgesCommand"));
assert!(search(&app, "constraints").iter().any(|x| x.0 == "ConstraintParallel"), "by panel");
app.sbox.used("FusionShellBodyCommand");
app.sbox.used("Revolve");
let all = search(&app, "");
assert_eq!((all[0].0, all[1].0), ("Revolve", "FusionShellBodyCommand"));
app.sbox.toggle_pin("Extrude");
let mut other = SolveApp::new(solvecraft_engine::Session::default(), Default::default());
other.sbox.load(&app.sbox.prefs());
assert_eq!((other.sbox.pinned.clone(), other.sbox.recent.len()), (vec!["Extrude".to_string()], 2));
}
}