mirror of
https://github.com/storytold/figcraft.git
synced 2026-10-30 05:16:56 -06:00
- Versions now belong to the document (DocState.versions) instead of a process-global map keyed by
document uid, so they survive closing the file. A new, renamed or deleted version marks the file
as changed.
- .figcraft: `versions/index.json` (id, name, description, time, image hashes) plus one deflated
`versions/<id>.json` snapshot per version; images only versions use are stored once and kept with
them. Snapshots read from a file are parsed on first use (and written back as-is). Readers that
don't know versions ignore the entries; files without versions load unchanged. Damaged, missing,
oversized or duplicate entries are skipped and reported, never failing the load. At most 100
versions per file; names and descriptions are clipped.
- Commands: `file.saveVersion {name?, description?}` returns the version; `version.list`;
`version.restore {id | index}` (one undo step, keeps the file name, stays on the current page);
`version.rename {id | index, name, description?}`; `version.delete`; `version.duplicate` (opens
the snapshot in a new tab). Indexes are validated: a negative index used to restore version 0.
`req_index` param helper shared with the guide commands.
- Version history panel in the left sidebar in place of Pages and Layers (File > Show version
history; Save to version history opens it with the form): save form (title, description),
"Current version" on top and the versions newest first on a timeline with name, relative time and
description; per-version menu (also right-click): Restore, Rename (title and description inline),
Duplicate, Delete (confirmed inline). New shared `widgets::button`.
- `figcraft-cli run --out x.figcraft` keeps the version history.
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
160 lines
6.4 KiB
Rust
160 lines
6.4 KiB
Rust
//! Pages.
|
|
|
|
use figcraft_doc::*;
|
|
use serde_json::{Value, json};
|
|
|
|
use super::{CommandSpec, ok};
|
|
use crate::params::*;
|
|
use crate::{bad, spec};
|
|
|
|
pub fn specs() -> Vec<CommandSpec> {
|
|
vec![
|
|
spec!("page.add", "Add page", "{name?}", true, |s, p| {
|
|
let doc = s.doc_mut()?;
|
|
let name = string(p, "name").unwrap_or_else(|| format!("Page {}", doc.pages.len() + 1));
|
|
let id = doc.add_page(&name);
|
|
let ds = s.ds_mut()?;
|
|
ds.page = id;
|
|
ds.selection.clear();
|
|
ds.zoom_to_fit();
|
|
Ok(json!({"id": id}))
|
|
}),
|
|
spec!("page.select", "Go to page", "{id | index}", false, |s, p| {
|
|
let doc = s.doc()?;
|
|
let id = match id(p, "id") {
|
|
Some(i) => i,
|
|
None => {
|
|
let k = req_num("page.select", p, "index")? as usize;
|
|
*doc.pages.get(k).ok_or_else(|| bad("page.select", "no such page"))?
|
|
}
|
|
};
|
|
if !doc.pages.contains(&id) {
|
|
return Err(bad("page.select", format!("{id} is not a page")));
|
|
}
|
|
let ds = s.ds_mut()?;
|
|
ds.page = id;
|
|
ds.selection.clear();
|
|
ds.text_edit = None;
|
|
ds.zoom_to_fit();
|
|
ok()
|
|
}),
|
|
spec!("page.rename", "Rename page", "{id?, name}", true, |s, p| {
|
|
let name = req_string("page.rename", p, "name")?;
|
|
let id = id(p, "id").unwrap_or(s.page()?);
|
|
s.doc_mut()?.get_mut(id)?.name = name;
|
|
ok()
|
|
}),
|
|
spec!("page.delete", "Delete page", "{id?}", true, |s, p| {
|
|
let id = id(p, "id").unwrap_or(s.page()?);
|
|
let doc = s.doc_mut()?;
|
|
doc.remove(id)?;
|
|
let first = doc.first_page();
|
|
let ds = s.ds_mut()?;
|
|
if ds.page == id
|
|
&& let Some(f) = first
|
|
{
|
|
ds.page = f;
|
|
ds.selection.clear();
|
|
}
|
|
ok()
|
|
}),
|
|
spec!("page.duplicate", "Duplicate page", "{id?}", true, |s, p| {
|
|
let src = id(p, "id").unwrap_or(s.page()?);
|
|
let doc = s.doc_mut()?;
|
|
let name = format!("{} (Copy)", doc.get(src)?.name);
|
|
let np = doc.add_page(&name);
|
|
if let NodeKind::Page { background, .. } = doc.get(src)?.kind.clone()
|
|
&& let NodeKind::Page { background: b, .. } = &mut doc.get_mut(np)?.kind
|
|
{
|
|
*b = background;
|
|
}
|
|
for c in doc.get(src)?.children.clone() {
|
|
doc.duplicate_into(c, np, None)?;
|
|
}
|
|
// Keep the new page right after the source.
|
|
if let Some(si) = doc.pages.iter().position(|x| *x == src) {
|
|
doc.pages.retain(|x| *x != np);
|
|
doc.pages.insert(si + 1, np);
|
|
}
|
|
s.ds_mut()?.page = np;
|
|
Ok(json!({"id": np}))
|
|
}),
|
|
spec!("page.move", "Move page", "{id?, index}", true, |s, p| {
|
|
let id = id(p, "id").unwrap_or(s.page()?);
|
|
let k = req_num("page.move", p, "index")?.max(0.0) as usize;
|
|
let doc = s.doc_mut()?;
|
|
doc.pages.retain(|x| *x != id);
|
|
let k = k.min(doc.pages.len());
|
|
doc.pages.insert(k, id);
|
|
ok()
|
|
}),
|
|
spec!("page.setBackground", "Page background", "{id?, color}", true, |s, p| {
|
|
let c = color(p, "color").ok_or_else(|| bad("page.setBackground", "`color` required"))?;
|
|
let id = id(p, "id").unwrap_or(s.page()?);
|
|
if let NodeKind::Page { background, .. } = &mut s.doc_mut()?.get_mut(id)?.kind {
|
|
*background = c;
|
|
}
|
|
ok()
|
|
}),
|
|
spec!("page.list", "List pages", "{}", false, |s, _| {
|
|
let doc = s.doc()?;
|
|
let cur = s.page()?;
|
|
Ok(Value::Array(
|
|
doc.pages
|
|
.iter()
|
|
.filter_map(|p| doc.node(*p))
|
|
.map(|n| json!({"id": n.id, "name": n.name, "current": n.id == cur, "children": n.children.len()}))
|
|
.collect(),
|
|
))
|
|
}),
|
|
spec!("guide.add", "Add guide", "{vertical (bool), offset, page?} → {index}", true, |s, p| {
|
|
let id = id(p, "page").unwrap_or(s.page()?);
|
|
let offset = req_num("guide.add", p, "offset")?.clamp(-1e7, 1e7);
|
|
let g = Guide { vertical: boolean(p, "vertical").unwrap_or(true), offset };
|
|
match &mut s.doc_mut()?.get_mut(id)?.kind {
|
|
NodeKind::Page { guides, .. } if guides.len() < 10_000 => {
|
|
guides.push(g);
|
|
Ok(json!({"index": guides.len() - 1}))
|
|
}
|
|
NodeKind::Page { .. } => Err(bad("guide.add", "too many guides")),
|
|
_ => Err(bad("guide.add", "`page` must be a page")),
|
|
}
|
|
}),
|
|
spec!("guide.move", "Move guide", "{index, offset, page?}", true, |s, p| {
|
|
let id = id(p, "page").unwrap_or(s.page()?);
|
|
let k = guide_index("guide.move", p)?;
|
|
let offset = req_num("guide.move", p, "offset")?.clamp(-1e7, 1e7);
|
|
match &mut s.doc_mut()?.get_mut(id)?.kind {
|
|
NodeKind::Page { guides, .. } => {
|
|
guides.get_mut(k).ok_or_else(|| bad("guide.move", "no such guide"))?.offset = offset;
|
|
ok()
|
|
}
|
|
_ => Err(bad("guide.move", "`page` must be a page")),
|
|
}
|
|
}),
|
|
spec!("guide.remove", "Remove guide", "{index, page?}", true, |s, p| {
|
|
let id = id(p, "page").unwrap_or(s.page()?);
|
|
let k = guide_index("guide.remove", p)?;
|
|
match &mut s.doc_mut()?.get_mut(id)?.kind {
|
|
NodeKind::Page { guides, .. } if k < guides.len() => {
|
|
guides.remove(k);
|
|
ok()
|
|
}
|
|
_ => Err(bad("guide.remove", "no such guide")),
|
|
}
|
|
}),
|
|
spec!("guide.clear", "Remove all guides", "{page?}", true, |s, p| {
|
|
let id = id(p, "page").unwrap_or(s.page()?);
|
|
if let NodeKind::Page { guides, .. } = &mut s.doc_mut()?.get_mut(id)?.kind {
|
|
guides.clear();
|
|
}
|
|
ok()
|
|
}),
|
|
]
|
|
}
|
|
|
|
/// A guide index from params (never negative).
|
|
fn guide_index(cmd: &str, p: &Value) -> crate::Result<usize> {
|
|
req_index(cmd, p, "index")
|
|
}
|