Files
vectorcraft/crates/engine/src/inspect.rs
T
dotCooCoo dbc1b69f1c Find Objects: document.find filters by bounds, size and anchor count and can select the matches
document.find took only name, kind and text, so removing hairline slivers or
every object in one region needed the whole inspect tree and a filter
written outside the app. It now also takes within and intersects
([x, y, width, height] in document points), min and max width, height,
thickness (the smaller side) and area of the geometric bounds, and min and
max anchor count (a compound path counts its members together). Each given
filter must match, and limits are inclusive.

select: true also selects the matches, leaving out hidden and locked
objects, matches inside another match, and compound path members unless
the compound path is isolated; the reply adds selected. Select > Reselect
repeats the find, and an action being recorded records a find that
selects. The count that select.color, the Select > Same commands and the
Select > Object commands report is now the number of objects selected,
after Lock Guides leaves out guide paths.
2026-10-24 17:46:13 +07:00

515 lines
21 KiB
Rust

//! Agent-friendly document summaries and view-models for panels.
use serde_json::{Value, json};
use vectorcraft_color::BlendMode;
use vectorcraft_doc::{ArrowAlign, Document, LineCap, LineJoin, Node, NodeId, NodeKind, StrokeAlign, StrokeLayer, SymbolBoxes, WidthProfile};
use vectorcraft_geom::Rect;
use crate::Session;
pub(crate) fn rect_json(r: Option<vectorcraft_geom::Rect>) -> Value {
match r {
Some(r) => json!({ "x": r.x0, "y": r.y0, "width": r.width(), "height": r.height() }),
None => Value::Null,
}
}
/// How much of the subtree a node summary carries.
#[derive(Clone, Copy, Default)]
pub struct SummaryOpts {
/// Child levels to include (`None`: the whole subtree). `0` is the node alone.
pub depth: Option<u64>,
/// Children shown per node (`None`: all, top of the stack first). A level that shows
/// fewer children than it has reports `childCount`, so truncation is never silent.
pub child_limit: Option<u64>,
/// The node is a member of a compound path, which paints it: it has no paint of its own
/// to report.
pub compound_member: bool,
}
/// Compact tree summary of a node (for `document.inspect`): the whole subtree, symbol instances
/// measured by their art from `symbols`.
pub fn node_summary(n: &Node, symbols: &SymbolBoxes) -> Value {
node_summary_opts(n, SummaryOpts::default(), symbols)
}
/// The same summary with [`SummaryOpts`] applied.
pub fn node_summary_opts(n: &Node, opts: SummaryOpts, symbols: &SymbolBoxes) -> Value {
let mut v = json!({
"id": n.id.0,
"name": n.display_name(),
"kind": n.kind_label(),
"visible": n.visible,
"locked": n.locked,
"bounds": rect_json(n.geometric_bounds_with(symbols)),
});
if n.opacity < 1.0 {
v["opacity"] = json!(n.opacity);
}
if n.blend != BlendMode::Normal {
v["blend"] = json!(n.blend.label());
}
// The angle of its rotated bounding box (counter-clockwise degrees).
if n.bbox_angle != 0.0 {
v["rotation"] = json!(n.bbox_angle);
}
if let NodeKind::Text(t) = &n.kind {
// Type shows its characters' paint: the first run's, as paint.proxies and the Stroke
// options read it. Fills and strokes of the type object itself, above or below its
// characters, come separately so the two stay apart.
let default = vectorcraft_doc::CharStyle::default();
let style = t.runs.first().map_or(&default, |r| &r.style);
v["fill"] = json!(style.fill.label());
v["stroke"] = json!(style.stroke.label());
v["strokeWidth"] = json!(if style.stroke.is_none() { 0.0 } else { style.stroke_width });
if n.appearance.fill().is_some() || n.appearance.stroke().is_some() {
v["objectFill"] = json!(n.appearance.fill_paint().label());
v["objectStroke"] = json!(n.appearance.stroke_paint().label());
v["objectStrokeWidth"] = json!(n.appearance.stroke_width());
}
} else if opts.compound_member {
v["compoundMember"] = json!(true);
} else if !n.is_container() || matches!(n.kind, NodeKind::Compound { .. }) {
// A compound path is a container, but its fill and stroke live on it, not on its members.
v["fill"] = json!(n.appearance.fill_paint().label());
v["stroke"] = json!(n.appearance.stroke_paint().label());
v["strokeWidth"] = json!(n.appearance.stroke_width());
}
if let Some(st) = node_stroke(n).filter(|_| !opts.compound_member) {
v["strokeOptions"] = stroke_options(&st);
}
match &n.kind {
NodeKind::Layer { color, template, printable, preview, dim_images, clip, .. } => {
let [r, g, b] = color.rgb();
v["color"] = json!(format!("#{r:02x}{g:02x}{b:02x}"));
v["template"] = json!(template);
v["printable"] = json!(printable);
v["preview"] = json!(preview);
v["dimImages"] = json!(dim_images);
v["clip"] = json!(clip);
}
NodeKind::Path { path, .. } => {
v["anchors"] = json!(path.anchor_count());
v["closed"] = json!(path.is_closed());
}
NodeKind::Text(t) => {
v["text"] = json!(t.plain_text());
// Area type and type on a path: does the text fit (the red overflow "+")? Area type
// also reports its fit and Shrink Text's factor (1 unshrunk).
if !matches!(t.kind, vectorcraft_doc::TextKind::Point) {
let lay = vectorcraft_text::layout(vectorcraft_text::FontDb::global(), t);
v["overflow"] = json!(lay.overflow);
if matches!(t.kind, vectorcraft_doc::TextKind::Area { .. }) {
v["fit"] = json!(t.area.fit.id());
v["fitScale"] = json!(lay.fit_scale);
}
}
}
_ => {}
}
if let Some(ch) = n.children() {
let total = ch.len();
let take_n = opts.child_limit.map_or(total, |l| l.min(total as u64) as usize);
if opts.depth.is_none_or(|d| d > 0) {
let next = SummaryOpts {
depth: opts.depth.map(|d| d.saturating_sub(1)),
child_limit: opts.child_limit,
compound_member: matches!(n.kind, NodeKind::Compound { .. }),
};
v["children"] = Value::Array(ch.iter().rev().take(take_n).map(|c| node_summary_opts(c, next, symbols)).collect());
}
if take_n < total || v.get("children").is_none() {
v["childCount"] = json!(total);
}
}
v
}
pub fn document(s: &Session) -> Value {
document_opts(s, SummaryOpts::default())
}
/// An artboard's name and rectangle, its background color (`#rrggbb`) when it has one,
/// `locked: true` when it is locked, `showCenterMark: true`, `showCrossHairs: true` and
/// `showVideoSafeAreas: true` when it shows them, and `videoRulerPixelAspectRatio` when it isn't 1.
fn artboard_summary(a: &vectorcraft_doc::Artboard) -> Value {
let mut v = json!({"name": a.name, "x": a.rect.x0, "y": a.rect.y0, "width": a.rect.width(), "height": a.rect.height()});
if let Some(c) = a.color {
v["color"] = json!(c.to_hex());
}
for (key, on) in [
("locked", a.locked),
("showCenterMark", a.show_center_mark),
("showCrossHairs", a.show_cross_hairs),
("showVideoSafeAreas", a.show_video_safe_areas),
] {
if on {
v[key] = json!(true);
}
}
if a.video_ruler_pixel_aspect_ratio != 1.0 {
v["videoRulerPixelAspectRatio"] = json!(a.video_ruler_pixel_aspect_ratio);
}
v
}
/// The same summary with [`SummaryOpts`] applied to the layer tree (artboards and
/// the rest always come whole): `depth: 0` is the skeleton — top layers with counts.
pub fn document_opts(s: &Session, opts: SummaryOpts) -> Value {
document_scoped(s, opts, &Scope::default())
}
/// Which nodes `document.inspect` lists in place of the whole layer tree.
#[derive(Clone, Debug, Default)]
pub struct Scope {
/// Only these nodes (any level, already checked to exist), in the order given.
pub ids: Option<Vec<vectorcraft_doc::NodeId>>,
/// Only nodes of this panel label (case-insensitive), searched in the subtrees of `ids`
/// or else of every layer.
pub kind: Option<String>,
/// At most this many entries after `offset` (`None`: all).
pub limit: Option<u64>,
/// Entries skipped first.
pub offset: u64,
}
impl Scope {
fn scoped(&self) -> bool {
self.ids.is_some() || self.kind.is_some()
}
}
/// A node with the ids of its ancestors (layer first).
type Hit<'a> = (&'a Node, Vec<u64>);
fn ancestors(d: &Document, id: vectorcraft_doc::NodeId) -> Vec<u64> {
let mut out = Vec::new();
let mut cur = d.parent_of(id);
// The bound keeps a malformed tree from looping.
while let Some(p) = cur.filter(|_| out.len() < 10_000) {
out.push(p.0);
cur = d.parent_of(p);
}
out.reverse();
out
}
fn collect_kind<'a>(n: &'a Node, kind: &str, path: &mut Vec<u64>, out: &mut Vec<Hit<'a>>) {
if n.kind_label().eq_ignore_ascii_case(kind) {
out.push((n, path.clone()));
}
if let Some(ch) = n.children() {
path.push(n.id.0);
for c in ch.iter().rev() {
collect_kind(c, kind, path, out);
}
path.pop();
}
}
/// [`document_opts`] with the layer tree replaced by the nodes `scope` picks. Without `ids`
/// or `kind` they are the top layers (`layers`, paged by `limit`/`offset`); with either they
/// are `nodes` (each with its `path` of ancestor ids when picked by `kind`). A paged or scoped
/// reply also reports `total`, the entries before paging.
pub fn document_scoped(s: &Session, opts: SummaryOpts, scope: &Scope) -> Value {
let Some(st) = s.active() else { return Value::Null };
let d = &st.doc;
let symbols = d.symbol_boxes();
let mut hits: Vec<Hit> = Vec::new();
match (&scope.ids, scope.kind.as_deref().filter(|k| !k.is_empty())) {
(None, None) => hits.extend(d.layers.iter().rev().map(|l| (&**l, Vec::new()))),
(Some(ids), None) => hits.extend(ids.iter().filter_map(|&i| d.node(i)).map(|n| (n, Vec::new()))),
(ids, Some(kind)) => {
let mut path = Vec::new();
match ids {
Some(ids) => {
for n in ids.iter().filter_map(|&i| d.node(i)) {
path = ancestors(d, n.id);
collect_kind(n, kind, &mut path, &mut hits);
}
}
None => d.layers.iter().rev().for_each(|l| collect_kind(l, kind, &mut path, &mut hits)),
}
}
}
let total = hits.len();
let skip = usize::try_from(scope.offset).unwrap_or(usize::MAX);
let take = scope.limit.map_or(usize::MAX, |l| usize::try_from(l).unwrap_or(usize::MAX));
let by_kind = scope.kind.as_deref().is_some_and(|k| !k.is_empty());
let nodes: Vec<Value> = hits
.into_iter()
.skip(skip)
.take(take)
.map(|(n, path)| {
let member = d.parent_of(n.id).and_then(|p| d.node(p)).is_some_and(|p| matches!(p.kind, NodeKind::Compound { .. }));
let mut v = node_summary_opts(n, SummaryOpts { compound_member: member, ..opts }, &symbols);
if by_kind {
v["path"] = json!(path);
}
v
})
.collect();
let mut out = document_base(s);
if let Some(o) = out.as_object_mut() {
o.insert(if scope.scoped() { "nodes" } else { "layers" }.into(), Value::Array(nodes));
if scope.scoped() || scope.limit.is_some() || scope.offset > 0 {
o.insert("total".into(), json!(total));
}
}
out
}
/// Everything `document.inspect` reports except the layer tree.
fn document_base(s: &Session) -> Value {
let Some(st) = s.active() else { return Value::Null };
let d = &st.doc;
json!({
"uid": st.uid,
"title": st.title(),
// The File Info title (`file.info`), where `title` comes from the file name once the document has one.
"fileInfoTitle": d.title,
"path": st.path,
"dirty": st.is_dirty(),
"revision": st.revision,
"units": d.units.label(),
"colorMode": format!("{:?}", d.color_mode),
"artboards": d.artboards.iter().map(artboard_summary).collect::<Vec<_>>(),
"currentLayer": st.active_layer.map(|l| l.0),
// The rows highlighted in the Layers panel (`layer.setCurrent`, `layer.highlight`).
"layerRows": st.highlighted_rows().iter().map(|i| i.0).collect::<Vec<_>>(),
"isolation": st.isolation.map(|l| l.0),
"selection": st.selection.objects.iter().map(|i| i.0).collect::<Vec<_>>(),
"selectionBounds": rect_json(d.bounds_of(&st.selection.objects, false)),
// The angle the selection's bounding box stands at (counter-clockwise degrees).
"selectionRotation": d.bbox_angle(&st.selection.objects),
// The layer, group or object targeted through the Layers panel (`layer.target`).
"target": st.selection.target.map(|t| t.0),
// The key object Align aligns to and Distribute Spacing spaces from (`select.key`).
"key": st.selection.key.map(|k| k.0),
// The ruler guide that is the key instead (`select.key {guide}`): an index into `guide.list`.
"keyGuide": st.selection.key_guide,
"history": st.history.undo.iter().map(|h| h.label.clone()).collect::<Vec<_>>(),
"redo": st.history.redo.iter().rev().map(|h| h.label.clone()).collect::<Vec<_>>(),
"objects": d.node_count(),
"tool": s.tool_id(),
"paint": {"fill": s.paint.fill.label(), "stroke": s.paint.stroke.label(), "strokeWidth": s.paint.stroke_width, "fillActive": s.fill_active, "appearanceItem": s.appearance_item()},
"pasteRemembersLayers": d.paste_remembers_layers,
})
}
/// What `document.find` matches: every given filter must hit (AND). All matching is
/// case-insensitive; `name` and `text` are substrings, `kind` is the exact panel label
/// (`Layer`, `Group`, `Path`, `Type`, `Image`, ...). The geometric filters read an object's
/// geometric bounds as `document.inspect` reports them; layers and sublayers fail them, and so
/// does a node without bounds (an empty group); `anchors` counts a path's anchor points, summed
/// over a compound path's members, and a node that is neither fails it.
#[derive(Default)]
pub struct FindFilter {
pub name: Option<String>,
pub kind: Option<String>,
pub text: Option<String>,
/// The bounds lie inside this rectangle, edges included.
pub within: Option<Rect>,
/// The bounds touch or overlap this rectangle.
pub intersects: Option<Rect>,
/// The bounds' width.
pub width: FindRange,
/// The bounds' height.
pub height: FindRange,
/// The smaller of the bounds' width and height.
pub thickness: FindRange,
/// The bounds' width times their height.
pub area: FindRange,
/// The anchor points of a path, or of a compound path's members together.
pub anchors: FindRange,
}
/// Inclusive limits on one measure of a [`FindFilter`]; neither given matches everything.
#[derive(Clone, Copy, Debug, Default, PartialEq)]
pub struct FindRange {
pub min: Option<f64>,
pub max: Option<f64>,
}
impl FindRange {
pub fn is_empty(&self) -> bool {
self.min.is_none() && self.max.is_none()
}
fn hits(&self, v: f64) -> bool {
self.min.is_none_or(|m| v >= m) && self.max.is_none_or(|m| v <= m)
}
}
impl FindFilter {
/// True when no effective filter was given (empty strings count as absent).
pub fn is_empty(&self) -> bool {
[self.name.as_ref(), self.kind.as_ref(), self.text.as_ref()].iter().all(|f| f.is_none())
&& self.within.is_none()
&& self.intersects.is_none()
&& self.ranges().iter().all(|r| r.is_empty())
&& self.anchors.is_empty()
}
/// The limits read from the bounds.
fn ranges(&self) -> [FindRange; 4] {
[self.width, self.height, self.thickness, self.area]
}
fn hits(&self, n: &Node, symbols: &SymbolBoxes) -> bool {
if self.within.is_some() || self.intersects.is_some() || self.ranges().iter().any(|r| !r.is_empty()) {
if matches!(n.kind, NodeKind::Layer { .. }) {
return false;
}
let Some(b) = n.geometric_bounds_with(symbols) else { return false };
if self.within.is_some_and(|r| b.x0 < r.x0 || b.y0 < r.y0 || b.x1 > r.x1 || b.y1 > r.y1) {
return false;
}
if self.intersects.is_some_and(|r| b.x0 > r.x1 || b.x1 < r.x0 || b.y0 > r.y1 || b.y1 < r.y0) {
return false;
}
let (w, h) = (b.width(), b.height());
if !(self.width.hits(w) && self.height.hits(h) && self.thickness.hits(w.min(h)) && self.area.hits(w * h)) {
return false;
}
}
if !self.anchors.is_empty() && !anchor_count(n).is_some_and(|c| self.anchors.hits(c as f64)) {
return false;
}
self.hits_text(n)
}
fn hits_text(&self, n: &Node) -> bool {
if let Some(needle) = &self.name
&& !n.display_name().to_lowercase().contains(needle)
{
return false;
}
if let Some(kind) = &self.kind
&& !n.kind_label().eq_ignore_ascii_case(kind)
{
return false;
}
if let Some(needle) = &self.text {
let NodeKind::Text(t) = &n.kind else { return false };
if !t.plain_text().to_lowercase().contains(needle) {
return false;
}
}
true
}
}
/// The anchor points of a path, or of a compound path's members together; `None` for any other
/// node.
fn anchor_count(n: &Node) -> Option<usize> {
match &n.kind {
NodeKind::Path { path, .. } => Some(path.anchor_count()),
NodeKind::Compound { children, .. } => Some(children.iter().filter_map(|c| anchor_count(c)).sum()),
_ => None,
}
}
/// Search the whole layer tree, top of the stack first like the Layers panel.
/// Returns at most `limit` hits as `{id, name, kind, path}` (`path` is the ancestor
/// chain, layer first) plus the ids of every hit, so a capped reply stays explicit.
pub fn find_nodes(doc: &Document, filter: &FindFilter, limit: u64) -> (Vec<Value>, Vec<NodeId>) {
use std::sync::Arc;
struct Walk<'a> {
filter: &'a FindFilter,
symbols: SymbolBoxes<'a>,
limit: u64,
ancestors: Vec<u64>,
out: Vec<Value>,
ids: Vec<NodeId>,
}
fn walk(nodes: &[Arc<Node>], w: &mut Walk) {
for n in nodes.iter().rev() {
if w.filter.hits(n, &w.symbols) {
w.ids.push(n.id);
if (w.out.len() as u64) < w.limit {
w.out.push(json!({"id": n.id.0, "name": n.display_name(), "kind": n.kind_label(), "path": w.ancestors}));
}
}
if let Some(ch) = n.children() {
w.ancestors.push(n.id.0);
walk(ch, w);
w.ancestors.pop();
}
}
}
let mut w = Walk { filter, symbols: doc.symbol_boxes(), limit, ancestors: Vec::new(), out: Vec::new(), ids: Vec::new() };
walk(&doc.layers, &mut w);
(w.out, w.ids)
}
/// Cap names as `stroke.set` takes them.
pub const CAPS: [(LineCap, &str); 3] = [(LineCap::Butt, "butt"), (LineCap::Round, "round"), (LineCap::Square, "square")];
/// Join names as `stroke.set` takes them.
pub const JOINS: [(LineJoin, &str); 3] = [(LineJoin::Miter, "miter"), (LineJoin::Round, "round"), (LineJoin::Bevel, "bevel")];
/// Stroke alignment names as `stroke.set` takes them.
pub const ALIGNS: [(StrokeAlign, &str); 3] = [(StrokeAlign::Center, "center"), (StrokeAlign::Inside, "inside"), (StrokeAlign::Outside, "outside")];
fn name_of<T: PartialEq>(table: &[(T, &'static str)], v: T) -> &'static str {
table.iter().find(|(k, _)| *k == v).map_or("", |(_, n)| n)
}
/// The stroke an object's Stroke panel options describe: type's first run's character stroke,
/// else the topmost stroke of its own (groups and layers too). None without a stroke.
pub fn node_stroke(n: &Node) -> Option<StrokeLayer> {
match &n.kind {
NodeKind::Text(t) => {
let mut st = t.runs.first().map_or_else(|| vectorcraft_doc::CharStyle::default().stroke_layer(), |r| r.style.stroke_layer());
// Character strokes are drawn in text space: report the document-space weight.
if let Some(k) = vectorcraft_doc::Scaling::factor(t.xf).filter(|k| k.is_finite()) {
scale_layer(&mut st, k);
}
Some(st)
}
_ => n.appearance.stroke().cloned(),
}
}
/// Scale a stroke's weight and dash lengths by `s`.
pub(crate) fn scale_layer(st: &mut StrokeLayer, s: f64) {
st.width *= s;
if let Some(d) = &mut st.dash {
d.scale(s);
}
}
/// A stroke's options in `stroke.set` terms: cap, join, miterLimit, align, dash (null when
/// solid), dashOffset, alignDashes, startArrow/endArrow (null for none), arrowAlign and profile,
/// plus widthPoints: the profile's `[t, left, right]` points (width factors; null when uniform)
/// and gradientMode: how a gradient lies on it (`paint.editGradient` strokeMode).
pub fn stroke_options(st: &StrokeLayer) -> Value {
json!({
"cap": name_of(&CAPS, st.cap),
"join": name_of(&JOINS, st.join),
"miterLimit": st.miter_limit,
"align": name_of(&ALIGNS, st.align),
"dash": st.dash.as_ref().map(|d| &d.pattern),
"dashOffset": st.dash.as_ref().map_or(0.0, |d| d.offset),
"alignDashes": st.dash.as_ref().is_some_and(|d| d.align_corners),
"startArrow": st.start_arrow,
"endArrow": st.end_arrow,
"arrowAlign": if st.arrow_align == ArrowAlign::Tip { "tip" } else { "extend" },
"profile": WidthProfile::id_of(st.profile.as_ref()),
"widthPoints": st.profile.as_ref().map(|p| &p.points),
"gradientMode": st.gradient_mode.name(),
})
}
/// Which Stroke panel values the selected objects don't share (their fields show blank), and
/// whether Align Stroke applies to them (no open path or type among them).
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
pub struct StrokeMixed {
pub weight: bool,
pub cap: bool,
pub join: bool,
pub miter_limit: bool,
pub align: bool,
pub dash: bool,
pub can_align: bool,
}