LightCraft: An open-source non-destructive photo editor written by scratch in pure Rust
Folders: every folder its own node; choosing one loads it like an album
Nathaniel Ledford0732edc64f96
diff --git a/crates/catalog/src/folders.rs b/crates/catalog/src/folders.rsindex 3861fd5f1..61a8f8c4a 100644--- a/crates/catalog/src/folders.rs+++ b/crates/catalog/src/folders.rs@@ -5,10 +5,10 @@//! ones above them, never a folder that holds nothing of the library, with how many photos each//! holds — its subfolders included, like a year in By Date counts its months.//!-//! Folders above the imported ones that hold nothing themselves and lead to a single folder fold-//! into one row (`/Users/me/Pictures`) instead of a staircase of single-child levels; the row-//! stands for the deepest folder it names. A folder spelled two ways (`/` or `\`, repeated or-//! trailing separators, `.`) is one folder (see [`crate::query::folder_key`]).+//! Every folder is a row of its own, the ones above the imported photos included+//! (`/Users` → `me` → `Pictures`), so a row is exactly the folder it names. A folder spelled two+//! ways (`/` or `\`, repeated or trailing separators, `.`) is one folder (see+//! [`crate::query::folder_key`]).//!//! Each disk is a *volume*, a top-level row of its own: a drive letter (`D:`), a Windows share//! (`//server/share`), a mounted disk or share (macOS `/Volumes/tokyo`, Linux `/media/me/usb`,@@ -41,8 +41,8 @@ pub const MAX_DEPTH: usize = 64;/// One row of the library's folder tree.#[derive(Clone, Debug, PartialEq, Serialize)]pub struct FolderNode {- /// What the row says: the folder's name, or the whole run (`Users/me/Pictures`) of folded- /// levels; for a volume, its name (`nas`, `D:`, `//server/share`, `/` for the startup disk).+ /// What the row says: the folder's name; for a volume, its name (`nas`, `D:`,+ /// `//server/share`, `/` for the startup disk).pub name: String,/// The folder the row stands for, written out from the names of the photos' paths (forward/// slashes, no verbatim prefix); hand it back to [`crate::Filter::library_folder`] to see its@@ -205,17 +205,12 @@ impl Catalog {}}-/// The node for `key` with everything below it (at most [`MAX_DEPTH`] deep), folding a level-/// that holds nothing and leads to one folder into that folder (never a volume).+/// The node for `key` with everything below it (at most [`MAX_DEPTH`] deep).fn build(key: &str, levels: &HashMap<String, Level>) -> Option<FolderNode> {let l = levels.get(key)?;let mut children: Vec<FolderNode> = l.children.iter().filter_map(|k| build(k, levels)).collect();sort(&mut children);let count = l.own + children.iter().map(|c| c.count).sum::<usize>();- if !l.volume && l.own == 0 && children.len() == 1 {- let c = children.remove(0);- return Some(FolderNode { name: format!("{}/{}", l.name, c.name), ..c });- }Some(FolderNode { name: l.name.clone(), path: l.path.clone(), count, own: l.own, volume: l.volume, selectable: true, children })}diff --git a/crates/catalog/src/tests_folders.rs b/crates/catalog/src/tests_folders.rsindex 6c7c9ab7d..1a5a6128e 100644--- a/crates/catalog/src/tests_folders.rs+++ b/crates/catalog/src/tests_folders.rs@@ -5,8 +5,7 @@//! * Given photos imported from several folders, the tree lists those folders and no others,//! each with how many photos it holds, under the disk (volume) they are on.//! * A folder's count includes the folders inside it.-//! * Folders above the imported ones that hold nothing themselves fold into one row, until the-//! library branches.+//! * Every folder is a row of its own, the ones above the imported photos included.//! * Photos only browsed in Local, deleted photos and demo scenes are not "imported from" anywhere.//! * However a folder is spelled, it is one folder.//! * Choosing a folder shows what was imported from it and from the folders inside it — exactly@@ -71,18 +70,27 @@ fn only_folders_with_imported_photos_are_listed_with_their_counts() {#[test]fn a_folders_count_includes_the_folders_inside_it() {let r = rows(&["/pics/trip/a.jpg", "/pics/trip/day1/b.jpg", "/pics/trip/day1/c.jpg", "/pics/trip/day2/d.jpg"]);- assert_eq!(r, vec![row("/", 4, 0), row("pics/trip", 4, 1), row("day1", 2, 2), row("day2", 1, 1)]);+ assert_eq!(r, vec![row("/", 4, 0), row("pics", 4, 0), row("trip", 4, 1), row("day1", 2, 2), row("day2", 1, 1)]);}#[test]-fn folders_that_hold_nothing_fold_into_one_row_until_the_library_branches() {+fn every_folder_is_a_row_of_its_own_even_when_it_holds_nothing_itself() {let c = library(&["/Users/me/Pictures/2024/a.jpg", "/Users/me/Pictures/2025/b.jpg", "/Volumes/nas/photos/c.jpg"]);let tree = c.folder_tree();assert_eq!(outline(&tree),- vec![row("/", 2, 0), row("Users/me/Pictures", 2, 0), row("2024", 1, 1), row("2025", 1, 1), row("nas", 1, 0), row("photos", 1, 1)]+ vec![+ row("/", 2, 0),+ row("Users", 2, 0),+ row("me", 2, 0),+ row("Pictures", 2, 0),+ row("2024", 1, 1),+ row("2025", 1, 1),+ row("nas", 1, 0),+ row("photos", 1, 1)+ ]);- assert_eq!(tree[0].children[0].path, "/Users/me/Pictures", "the folded row stands for the deepest folder it names");+ assert_eq!(tree[0].children[0].children[0].children[0].path, "/Users/me/Pictures", "a row is exactly the folder it names");}#[test]@@ -99,13 +107,13 @@ fn browsed_deleted_and_demo_photos_are_not_imported_from_anywhere() {let id = c.alloc_photo_id();let demo = Photo::new(id, Source::Demo { scene: 1 }, "demo", "JPEG", 60, 40, "2026-01-01T10:00:00");c.apply(Op::AddPhoto { photo: Box::new(demo) }).unwrap();- assert_eq!(outline(&c.folder_tree()), vec![row("/", 1, 0), row("pics/kept", 1, 1)]);+ assert_eq!(outline(&c.folder_tree()), vec![row("/", 1, 0), row("pics", 1, 0), row("kept", 1, 1)]);}#[test]fn however_a_folder_is_spelled_it_is_one_folder() {let r = rows(&["/pics/trip/a.jpg", "/pics//trip/./b.jpg", "/pics\\trip\\c.jpg", "/pics/x/../trip/d.jpg"]);- assert_eq!(r, vec![row("/", 4, 0), row("pics/trip", 4, 4)]);+ assert_eq!(r, vec![row("/", 4, 0), row("pics", 4, 0), row("trip", 4, 4)]);}#[test]@@ -159,7 +167,14 @@ fn shares_the_other_systems_mount_are_volumes_too() {let r = rows(&[r"\\tokyo.local\photos\a.jpg", r"\\192.168.1.5\scans\b.jpg", r"\\wsl$\Ubuntu\home\me\c.jpg", r"Z:\d.jpg"]);assert_eq!(r,- vec![row("//192.168.1.5/scans", 1, 1), row("//tokyo.local/photos", 1, 1), row("//wsl$/Ubuntu", 1, 0), row("home/me", 1, 1), row("Z:", 1, 1)]+ vec![+ row("//192.168.1.5/scans", 1, 1),+ row("//tokyo.local/photos", 1, 1),+ row("//wsl$/Ubuntu", 1, 0),+ row("home", 1, 0),+ row("me", 1, 1),+ row("Z:", 1, 1)+ ]);}diff --git a/crates/engine/src/cmd/browse.rs b/crates/engine/src/cmd/browse.rsindex 338dff699..26d6130bd 100644--- a/crates/engine/src/cmd/browse.rs+++ b/crates/engine/src/cmd/browse.rs@@ -251,17 +251,9 @@ pub(crate) fn rename_folder_on_disk(from: &str, to: &str) -> std::result::Result/// After a folder moved from `from` to `to`: a browsed folder at or below it follows.pub(crate) fn follow_folder(s: &mut Session, from: &str, to: &str) {- // a chosen library folder at or below it follows too (compared the way the filter does, by- // folder identity, so a differently spelled choice is not widened to the folder itself)- if let Some(chosen) = s.filter.library_folder.clone() {- let (ck, fk) = (lightcraft_catalog::query::folder_key(&chosen), lightcraft_catalog::query::folder_key(from));- if !fk.is_empty()- && let Some(rest) = ck.strip_prefix(fk.as_str()).filter(|r| r.is_empty() || r.starts_with('/') || fk.ends_with('/'))- {- let rest = rest.trim_start_matches('/');- s.filter.library_folder = Some(if rest.is_empty() { to.to_string() } else { format!("{}/{rest}", to.trim_end_matches(['/', '\\'])) });- }- }+ // a library folder chosen at or below it follows too, as a source or as a filter+ follow_library_folder(&mut s.library_folder, from, to);+ follow_library_folder(&mut s.filter.library_folder, from, to);if let Some(b) = &mut s.browse&& let Ok(rel) = Path::new(&b.path).strip_prefix(from){@@ -271,6 +263,21 @@ pub(crate) fn follow_folder(s: &mut Session, from: &str, to: &str) {}}+/// A chosen library folder at or below `from` becomes the same place below `to`. Compared the+/// way the filter does, by folder identity, so a differently spelled choice is not widened to+/// the folder itself.+fn follow_library_folder(chosen: &mut Option<String>, from: &str, to: &str) {+ let Some(c) = chosen.as_deref() else { return };+ let (ck, fk) = (lightcraft_catalog::query::folder_key(c), lightcraft_catalog::query::folder_key(from));+ if fk.is_empty() {+ return;+ }+ if let Some(rest) = ck.strip_prefix(fk.as_str()).filter(|r| r.is_empty() || r.starts_with('/') || fk.ends_with('/')) {+ let rest = rest.trim_start_matches('/');+ *chosen = Some(if rest.is_empty() { to.to_string() } else { format!("{}/{rest}", to.trim_end_matches(['/', '\\'])) });+ }+}+/// Rename or move a folder on disk (everything in it goes along, sidecars included) and relink/// the photos inside, as one undo step: undo renames the folder back and restores the photos'/// paths, redo repeats the move — each refused (and reported) when the destination is taken.diff --git a/crates/engine/src/cmd/library.rs b/crates/engine/src/cmd/library.rsindex 688d84b35..844bae89c 100644--- a/crates/engine/src/cmd/library.rs+++ b/crates/engine/src/cmd/library.rs@@ -251,7 +251,7 @@ pub fn specs() -> Vec<CommandSpec> {"Show Source",[],None,- "{kind: all|recentlyAdded|album|recentlyDeleted|picks|missing, id?: albumId}",+ "{kind: all|recentlyAdded|album|recentlyDeleted|picks|missing|libraryFolder, id?: albumId, path?: a path from library.folders (for libraryFolder)}",always,|s, p| {let kind = str_param(p, "kind").unwrap_or("all");@@ -268,6 +268,12 @@ pub fn specs() -> Vec<CommandSpec> {}LibrarySource::Album(a)}+ "libraryFolder" => {+ let path = str_param(p, "path").map(str::trim).filter(|d| !lightcraft_catalog::query::folder_key(d).is_empty());+ let path = path.ok_or_else(|| bad("library.source", "libraryFolder needs the `path` of a folder from library.folders"))?;+ s.library_folder = Some(path.to_string());+ LibrarySource::LibraryFolder+ }other => return Err(bad("library.source", format!("unknown source `{other}`"))),};let vis = s.visible_cloned();@@ -334,6 +340,13 @@ pub fn specs() -> Vec<CommandSpec> {if s.filter.library_folder.as_deref().is_some_and(|c| lightcraft_catalog::query::folder_within(c, path)) {s.filter.library_folder = None;}+ // the folder being shown is gone: back to everything, as for a deleted album+ if s.library_folder.as_deref().is_some_and(|c| lightcraft_catalog::query::folder_within(c, path)) {+ s.library_folder = None;+ if s.source == LibrarySource::LibraryFolder {+ s.source = LibrarySource::All;+ }+ }let vis = s.visible_cloned();s.selection = vis.first().map(|f| Selection::single(*f)).unwrap_or_default();Ok(json!({"removed": ids.len()}))diff --git a/crates/engine/src/cmd/query.rs b/crates/engine/src/cmd/query.rsindex e7ffde143..9b0777b37 100644--- a/crates/engine/src/cmd/query.rs+++ b/crates/engine/src/cmd/query.rs@@ -5,7 +5,7 @@ use lightcraft_develop::{CONTROLS, controls};use serde_json::{Value, json};use super::{CommandSpec, always, bad, cmd, has_active};-use crate::Session;+use crate::{LibrarySource, Session};pub fn photo_summary(p: &Photo) -> Value {json!({@@ -81,10 +81,14 @@ pub fn specs() -> Vec<CommandSpec> {}))}),cmd!(query "library.state", "Library State", [], None, "{}", always, |s, _| {- let label = s.source.label(&s.catalog);+ let label = match (s.source, s.library_folder.as_deref()) {+ (LibrarySource::LibraryFolder, Some(path)) => lightcraft_catalog::folders::folder_label(path),+ _ => s.source.label(&s.catalog),+ };let n = s.visible().len();Ok(json!({"source": s.source,+ "libraryFolder": s.library_folder,"sourceLabel": label,"filter": s.filter,"sort": s.sort,diff --git a/crates/engine/src/lib.rs b/crates/engine/src/lib.rsindex cbbbbd639..bfc198dce 100644--- a/crates/engine/src/lib.rs+++ b/crates/engine/src/lib.rs@@ -134,6 +134,9 @@ pub struct Session {pub clipboard: Option<Value>,/// The folder on disk the [`LibrarySource::Folder`] view browses.pub browse: Option<Browse>,+ /// The folder the [`LibrarySource::LibraryFolder`] view shows: the library's photos imported+ /// from it and from the folders inside it.+ pub library_folder: Option<String>,/// Copied metadata (`photo.copyMetadata`): photo.setMeta params.pub meta_clipboard: Option<Value>,/// The photo that was active before the current one (Paste Settings from Previous).@@ -234,6 +237,7 @@ impl Session {clipboard: None,meta_clipboard: None,browse: None,+ library_folder: None,previous_active: None,copy_groups: lightcraft_develop::SettingsGroup::default_copy(),presets: presets::builtin(),@@ -590,7 +594,8 @@ impl Session {/// Photos shown in the grid/filmstrip for the current source, filter and sort.pub fn visible(&mut self) -> &[PhotoId] {- let mut key = (self.catalog.revision, format!("{:?}|{:?}|{:?}|{:?}", self.source, self.filter, self.sort, self.browse));+ let mut key =+ (self.catalog.revision, format!("{:?}|{:?}|{:?}|{:?}|{:?}", self.source, self.filter, self.sort, self.browse, self.library_folder));if self.source == LibrarySource::Missing && self.media.availability.is_background() {// the view fills in as the background checks find files gonekey.1.push_str(&format!("|{}", self.media.availability.generation()));@@ -605,6 +610,10 @@ impl Session {f.folder = Some(b.path);f.subfolders = b.subfolders;}+ if self.source == LibrarySource::LibraryFolder {+ // no folder chosen: nothing (an empty path names no folder)+ f.library_folder = Some(self.library_folder.clone().unwrap_or_default());+ }let mut visible = self.catalog.query(&f, &self.sort);if matches!(self.source, LibrarySource::Album(_))&& self.sort.key == lightcraft_catalog::SortKey::CaptureDate@@ -648,7 +657,7 @@ impl Session {if self.source == LibrarySource::Missing {return None;}- let key = (self.catalog.revision, format!("{:?}|{:?}", self.source, self.browse));+ let key = (self.catalog.revision, format!("{:?}|{:?}|{:?}", self.source, self.browse, self.library_folder));if self.total.as_ref().map(|t| &t.0) != Some(&key) {let mut f = self.source.to_filter(&Filter::default(), &self.catalog);if self.source == LibrarySource::Folder {@@ -656,6 +665,9 @@ impl Session {f.folder = Some(b.path);f.subfolders = b.subfolders;}+ if self.source == LibrarySource::LibraryFolder {+ f.library_folder = Some(self.library_folder.clone().unwrap_or_default());+ }let n = self.catalog.query(&f, &self.sort).len();self.total = Some((key, n));}diff --git a/crates/engine/src/library.rs b/crates/engine/src/library.rsindex 6a63e378e..b6448380f 100644--- a/crates/engine/src/library.rs+++ b/crates/engine/src/library.rs@@ -102,6 +102,8 @@ struct PresetsFile {struct ViewFile {source: LibrarySource,browse: Option<crate::Browse>,+ /// The folder a `libraryFolder` source shows.+ library_folder: Option<String>,// No filter: a library opens unfiltered. A date, keyword or person left over from the last session// would silently hide photos, with only a small badge to say so.sort: lightcraft_catalog::Sort,@@ -309,6 +311,7 @@ impl Session {self.pending_log.clear();self.selection = Selection::default();self.source = LibrarySource::All;+ self.library_folder = None;if report.created && seed_demo {crate::demo::load(self);journal.snapshot(&self.catalog)?;@@ -353,6 +356,11 @@ impl Session {if let Some(v) = settings.read::<ViewFile>(files.as_mut(), "view.json") {self.source = v.source;self.browse = v.browse;+ self.library_folder = v.library_folder.filter(|f| !f.trim().is_empty());+ if self.source == LibrarySource::LibraryFolder && self.library_folder.is_none() {+ // no folder to show: everything, not an empty grid+ self.source = LibrarySource::All;+ }self.sort = v.sort;self.selection = v.selection;self.selection.ids.retain(|id| self.catalog.photo(*id).is_some());@@ -500,7 +508,13 @@ impl Session {}fn view_json(&self) -> Vec<u8> {- let view = ViewFile { source: self.source, browse: self.browse.clone(), sort: self.sort, selection: self.selection.clone() };+ let view = ViewFile {+ source: self.source,+ browse: self.browse.clone(),+ library_folder: self.library_folder.clone(),+ sort: self.sort,+ selection: self.selection.clone(),+ };serde_json::to_vec_pretty(&view).unwrap_or_default()}diff --git a/crates/engine/src/tests_folders.rs b/crates/engine/src/tests_folders.rsindex 887870b59..e95774435 100644--- a/crates/engine/src/tests_folders.rs+++ b/crates/engine/src/tests_folders.rs@@ -14,6 +14,10 @@ use serde_json::json;use crate::{LibrarySource, Session, filter_chips};+fn source_folder(s: &mut Session, path: &str) -> serde_json::Value {+ s.execute("library.source", &json!({"kind": "libraryFolder", "path": path})).unwrap()+}+fn add(s: &mut Session, path: &str) {let id = s.catalog.alloc_photo_id();let p = Photo::new(id, Source::File { path: path.into() }, "x.jpg", "JPEG", 60, 40, "2026-01-01T10:00:00");@@ -230,3 +234,78 @@ fn following_a_folder_reads_both_spellings_the_same_way() {crate::cmd::browse::follow_folder(&mut s, "/a/b", "/a/c");assert_eq!(s.filter.library_folder.as_deref(), Some("/elsewhere/b"), "other folders are left alone");}++#[test]+fn choosing_a_folder_replaces_the_source_the_way_an_album_does() {+ let mut s = session();+ s.execute("library.source", &json!({"kind": "picks"})).unwrap();+ assert_eq!(s.visible().len(), 0, "no picks");+ let r = source_folder(&mut s, "/pics/trip");+ assert_eq!(r["count"], 2, "the folder's photos, whatever was shown before");+ assert_eq!((s.source, s.library_folder.as_deref()), (LibrarySource::LibraryFolder, Some("/pics/trip")));+ assert!(filter_chips(&s.filter, &s.catalog).is_empty(), "a source is not a filter chip");+ let state = s.execute("library.state", &json!({})).unwrap();+ assert_eq!((state["sourceLabel"].as_str(), state["libraryFolder"].as_str()), (Some("pics/trip"), Some("/pics/trip")), "agents see which folder");+ // the filter bar narrows it further, as it does an album+ s.execute("library.filter", &json!({"rating": 1})).unwrap();+ assert_eq!(s.visible().len(), 0);+ s.execute("library.clearFilter", &json!({})).unwrap();+ assert_eq!(s.visible().len(), 2);+ s.execute("library.source", &json!({"kind": "all"})).unwrap();+ assert_eq!(s.visible().len(), 3, "back to everything");+}++#[test]+fn the_folder_source_takes_a_library_folder_path_only() {+ let mut s = session();+ for params in [+ json!({"kind": "libraryFolder"}),+ json!({"kind": "libraryFolder", "path": 5}),+ json!({"kind": "libraryFolder", "path": " "}),+ json!({"kind": "libraryFolder", "path": "."}),+ ] {+ assert!(s.execute("library.source", ¶ms).is_err(), "{params}");+ }+ assert_eq!(s.source, LibrarySource::All, "refused, nothing changed");+ assert_eq!(source_folder(&mut s, "/elsewhere")["count"], 0, "a folder with no photos shows nothing, not everything");+}++#[test]+fn removing_the_folder_being_shown_returns_to_all_photos() {+ let mut s = session();+ source_folder(&mut s, "/pics/trip");+ s.execute("library.removeFolder", &json!({"path": "/pics/trip"})).unwrap();+ assert_eq!((s.source, s.library_folder.as_deref()), (LibrarySource::All, None));+ assert_eq!(s.visible().len(), 1);+ // removing another folder leaves the source alone+ let mut s = session();+ source_folder(&mut s, "/pics/home");+ s.execute("library.removeFolder", &json!({"path": "/pics/trip"})).unwrap();+ assert_eq!(s.source, LibrarySource::LibraryFolder);+ assert_eq!(s.visible().len(), 1);+}++#[test]+fn a_renamed_folder_stays_the_one_shown_and_undo_follows_it_back() {+ let dir = Scratch::new("source-rename");+ std::fs::create_dir_all(dir.0.join("trip/day1")).unwrap();+ let (trip, day1, renamed) = (dir.path("trip"), dir.path("trip/day1"), dir.path("holiday"));+ let mut s = Session::new();+ add(&mut s, &format!("{trip}/a.jpg"));+ add(&mut s, &format!("{day1}/b.jpg"));+ source_folder(&mut s, &day1);+ s.execute("folder.rename", &json!({"path": trip, "name": "holiday"})).unwrap();+ assert_eq!(s.library_folder.as_deref(), Some(format!("{renamed}/day1").as_str()), "the subfolder follows its parent");+ assert_eq!(s.visible().len(), 1);+ s.execute("edit.undo", &json!({})).unwrap();+ assert_eq!(s.library_folder.as_deref(), Some(day1.as_str()));+ assert_eq!(s.visible().len(), 1);+}++#[test]+fn the_shown_folder_follows_reading_both_spellings_the_same_way() {+ let mut s = Session::new();+ s.library_folder = Some("/a/x/../b/sub".into());+ crate::cmd::browse::follow_folder(&mut s, "/a/b", "/a/c");+ assert_eq!(s.library_folder.as_deref(), Some("/a/c/sub"));+}diff --git a/crates/engine/src/tests_library.rs b/crates/engine/src/tests_library.rsindex 45a56b2e0..91ae195af 100644--- a/crates/engine/src/tests_library.rs+++ b/crates/engine/src/tests_library.rs@@ -212,6 +212,23 @@ fn profile_favorites_and_recent_survive_reopen() {let _ = std::fs::remove_dir_all(&dir);}+#[test]+fn the_shown_library_folder_survives_reopen() {+ let dir = temp_dir("libfolder");+ let mut s = open(&dir, true);+ s.execute("library.source", &json!({"kind": "libraryFolder", "path": "/pics/trip"})).unwrap();+ s.save_view();+ drop(s);+ let s = open(&dir, false);+ assert_eq!((s.source, s.library_folder.as_deref()), (crate::LibrarySource::LibraryFolder, Some("/pics/trip")));+ drop(s);+ // a view file that names the source but no folder opens on everything, never an empty grid+ std::fs::write(dir.join("view.json"), br#"{"source": {"kind": "libraryFolder"}}"#).unwrap();+ let s = open(&dir, false);+ assert_eq!((s.source, s.library_folder), (crate::LibrarySource::All, None));+ let _ = std::fs::remove_dir_all(&dir);+}+/// Smart albums with a rule set: all / any / none, nested groups, validation, live updates.#[test]fn smart_album_rule_sets() {diff --git a/crates/engine/src/view.rs b/crates/engine/src/view.rsindex 1b0f0ca42..181499299 100644--- a/crates/engine/src/view.rs+++ b/crates/engine/src/view.rs@@ -19,6 +19,9 @@ pub enum LibrarySource {Folder,/// Photos whose original file can't be found (`library.missing`).Missing,+ /// A folder the library's photos were imported from ([`crate::Session::library_folder`]),+ /// and the folders inside it (`library.folders`).+ LibraryFolder,}/// The folder a [`LibrarySource::Folder`] view shows.@@ -49,7 +52,7 @@ impl LibrarySource {LibrarySource::RecentlyDeleted => f.deleted = true,LibrarySource::Picks => f.flag = Some(lightcraft_catalog::Flag::Pick),// the folder itself is filled in by the session (it holds the path)- LibrarySource::Folder | LibrarySource::Missing => {}+ LibrarySource::Folder | LibrarySource::Missing | LibrarySource::LibraryFolder => {}}f}@@ -62,6 +65,7 @@ impl LibrarySource {LibrarySource::RecentlyDeleted => "Recently Deleted".into(),LibrarySource::Picks => "Picks".into(),LibrarySource::Folder => "Folder".into(),+ LibrarySource::LibraryFolder => "Folder".into(),LibrarySource::Missing => "Missing Photos".into(),}}diff --git a/crates/ui-egui/src/i18n.rs b/crates/ui-egui/src/i18n.rsindex 987631843..7ed26d56a 100644--- a/crates/ui-egui/src/i18n.rs+++ b/crates/ui-egui/src/i18n.rs@@ -216,6 +216,15 @@ pub fn source_label(source: lightcraft_engine::LibrarySource, catalog: &lightcraif matches!(source, lightcraft_engine::LibrarySource::Album(id) if catalog.album(id).is_some()) { label } else { tr(&label).to_string() }}+/// What the grid is titled for the session's source: [`source_label`], or a library folder's last+/// two names (`photos/travel`; the folder's name is the user's and stays verbatim).+pub fn source_title(session: &lightcraft_engine::Session) -> String {+ match (session.source, session.library_folder.as_deref()) {+ (lightcraft_engine::LibrarySource::LibraryFolder, Some(path)) => lightcraft_catalog::folders::folder_label(path),+ (source, _) => source_label(source, &session.catalog),+ }+}+/// A date group heading (`2026-09-20`, `2026-09`, `2026`) in the UI language: the grid's full/// form, or the date sidebar's `short` one ("Sunday, 20" / "September" / "2026"). English keeps the/// catalog's own wording; every other language formats it with its `*-formats.json` datediff --git a/crates/ui-egui/src/panels/grid.rs b/crates/ui-egui/src/panels/grid.rsindex 7dc07602a..bb7b27f09 100644--- a/crates/ui-egui/src/panels/grid.rs+++ b/crates/ui-egui/src/panels/grid.rs@@ -150,7 +150,7 @@ fn show_inner(app: &mut LightcraftApp, ui: &mut egui::Ui) {folder_header(app, ui, hr, &b, &ids, local, &cnt)}None => {- let title = crate::i18n::source_label(app.session.source, &app.session.catalog);+ let title = crate::i18n::source_title(&app.session);ui.painter().text(pos2(hr.left() + 20.0, hr.center().y), Align2::LEFT_CENTER, &title, t.semibold(17.0), t.text);ui.painter().text(pos2(hr.right() - 20.0, hr.center().y), Align2::RIGHT_CENTER, cnt, t.font(12.5), t.text_dim);}@@ -164,11 +164,7 @@ fn show_inner(app: &mut LightcraftApp, ui: &mut egui::Ui) {if !chips.is_empty() {let body = match total {Some(n) if n > 0 => {- crate::i18n::tr_format!(- "{n} photos in {} are hidden by the filters above",- crate::i18n::source_label(app.session.source, &app.session.catalog),- n = n- )+ crate::i18n::tr_format!("{n} photos in {} are hidden by the filters above", crate::i18n::source_title(&app.session), n = n)}_ => "Remove a filter above, or choose Clear all".to_string(),};diff --git a/crates/ui-egui/src/panels/left.rs b/crates/ui-egui/src/panels/left.rsindex 884d346a0..be47fa212 100644--- a/crates/ui-egui/src/panels/left.rs+++ b/crates/ui-egui/src/panels/left.rs@@ -733,8 +733,9 @@ fn is_within(app: &LightcraftApp, id: lightcraft_catalog::AlbumId, ancestor: lig}/// "Folders": where on disk the library's photos were imported from, with photo counts (see-/// `lightcraft_catalog::folders`). A click shows the photos imported from that folder and the-/// folders inside it, the triangle opens a level. Only folders holding imported photos are+/// `lightcraft_catalog::folders`). A click makes that folder the source, like an album or a+/// Local folder: its photos and those of the folders inside it fill the grid. The triangle opens+/// a level. Only folders holding imported photos are/// listed; every folder on disk is under Local.fn folders_section(app: &mut LightcraftApp, ui: &mut egui::Ui) {let tree = app.caches.folder_tree(&app.session.catalog);@@ -774,10 +775,11 @@ fn elide_head(text: &str, max: f32, width: impl Fn(&str) -> f32) -> String {"…".to_string()}-/// Whenever the chosen folder changes (a click, an agent, a rename or its undo), open the rows+/// Whenever the shown folder changes (a click, an agent, a rename or its undo), open the rows/// above it so it is on screen; folding one by hand afterwards sticks until the choice changes.fn reveal_chosen(app: &LightcraftApp, ui: &egui::Ui, tree: &[FolderNode]) {- let chosen = app.session.filter.library_folder.clone().filter(|c| !lightcraft_catalog::query::folder_key(c).is_empty());+ let shown = app.session.library_folder.clone().filter(|_| app.session.source == LibrarySource::LibraryFolder);+ let chosen = shown.filter(|c| !lightcraft_catalog::query::folder_key(c).is_empty());let seen = egui::Id::new("libfolder-revealed");let now = chosen.as_deref().map(lightcraft_catalog::query::folder_key);if ui.data(|d| d.get_temp::<Option<String>>(seen)) == Some(now.clone()) {@@ -802,11 +804,15 @@ fn folder_rows(app: &mut LightcraftApp, ui: &mut egui::Ui, nodes: &[FolderNode],for n in nodes {let key = lightcraft_catalog::query::folder_key(&n.path);let open_id = egui::Id::new(("libfolder-open", key.clone()));- // a disk starts open: its folders are what the section is for- let mut open: bool = ui.data(|d| d.get_temp(open_id)).unwrap_or(n.volume);+ // a disk starts open, and so does a folder that holds nothing itself and leads to one+ // folder (`Users` → `me`): the first row where the library branches is what you look for+ let leads_on = n.own == 0 && n.children.len() == 1;+ let mut open: bool = ui.data(|d| d.get_temp(open_id)).unwrap_or(n.volume || leads_on);// a row whose path would cover other disks' photos too only opens and closeslet selectable = n.selectable;- let sel = selectable && app.session.filter.library_folder.as_deref().is_some_and(|f| same_folder(f, &n.path));+ let sel = selectable+ && app.session.source == LibrarySource::LibraryFolder+ && app.session.library_folder.as_deref().is_some_and(|f| same_folder(f, &n.path));let name = if selectable { n.name.clone() } else { crate::i18n::tr("This Computer").to_string() };// room for the name: between the icon and the countlet font = t.font(13.5);@@ -837,12 +843,8 @@ fn folder_rows(app: &mut LightcraftApp, ui: &mut egui::Ui, nodes: &[FolderNode],let resp = resp.on_hover_text(tip);if resp.clicked() && !toggled {if selectable {- // the library's folder, not a mix with the Local folder being browsed- if app.session.source == LibrarySource::Folder {- let _ = app.run("library.source", json!({"kind": "all"}));- }- let v = if sel { serde_json::Value::Null } else { json!(n.path) };- let _ = app.run("library.filter", json!({"libraryFolder": v}));+ // a source like an album or a Local folder: it replaces what the grid showed+ let _ = app.run("library.source", json!({"kind": "libraryFolder", "path": n.path}));} else {toggled = true;}diff --git a/crates/ui-egui/src/tests_panels.rs b/crates/ui-egui/src/tests_panels.rsindex e5134290e..585a3e952 100644--- a/crates/ui-egui/src/tests_panels.rs+++ b/crates/ui-egui/src/tests_panels.rs@@ -241,9 +241,11 @@ fn folders_section_lists_where_photos_were_imported_from_and_narrows_the_grid()assert_eq!(h.app.session.visible().len(), 3);click(&mut h, "source:libfolder:/pics/trip");assert_eq!(h.app.session.visible().len(), 2, "only the photos imported from that folder");- assert_eq!(h.app.session.filter.library_folder.as_deref(), Some("/pics/trip"));- click(&mut h, "source:libfolder:/pics/trip");- assert_eq!(h.app.session.visible().len(), 3, "choosing it again shows everything");+ assert_eq!(h.app.session.source, lightcraft_engine::LibrarySource::LibraryFolder);+ assert_eq!(h.app.session.library_folder.as_deref(), Some("/pics/trip"));+ assert_eq!(h.app.session.filter, lightcraft_catalog::Filter::default(), "a source, not a filter");+ click(&mut h, "source:all");+ assert_eq!(h.app.session.visible().len(), 3, "All Photos shows everything again");// the section folds like the othersclick(&mut h, "sidebarSection:folders");assert!(!has(&h, "source:libfolder:/pics"), "folded");@@ -259,7 +261,7 @@ fn disks_are_rows_of_their_own() {assert!(has(&h, "source:libfolder:/") && has(&h, "source:libfolder:/Volumes/nas"), "both disks are listed");assert!(has(&h, "source:libfolder:/Volumes/nas/p"), "an open disk shows its folders");click(&mut h, "source:libfolder:/");- assert_eq!(h.app.session.filter.library_folder, None, "the startup disk's path would cover every disk");+ assert_eq!(h.app.session.library_folder, None, "the startup disk's path would cover every disk");assert!(!has(&h, "source:libfolder:/Users/me"), "a click on it folds it instead");click(&mut h, "source:libfolder:/");assert!(has(&h, "source:libfolder:/Users/me"));@@ -267,15 +269,42 @@ fn disks_are_rows_of_their_own() {assert_eq!(h.app.session.visible().len(), 2, "everything on the nas");}-/// Choosing a folder while Local is the source shows the library's folder, not a mix.+/// A folder loads into the grid the way an album, a Local folder or Picks does: whatever was+/// shown before is replaced, and the folder's own row is highlighted.#[test]-fn choosing_a_library_folder_leaves_a_local_folder_view() {+fn choosing_a_library_folder_replaces_whatever_was_shown() {+ use lightcraft_engine::LibrarySource;let mut h = folders_app(&["/pics/trip/a.jpg", "/pics/home/b.jpg"]);- h.app.session.source = lightcraft_engine::LibrarySource::Folder;click(&mut h, "libraryFolderToggle:/pics");+ for before in [LibrarySource::Picks, LibrarySource::Folder, LibrarySource::RecentlyDeleted, LibrarySource::Missing] {+ h.app.session.source = before;+ click(&mut h, "source:libfolder:/pics/trip");+ assert_eq!(h.app.session.source, LibrarySource::LibraryFolder, "from {before:?}");+ assert_eq!(h.app.session.visible().len(), 1);+ }click(&mut h, "source:libfolder:/pics/trip");- assert_eq!(h.app.session.source, lightcraft_engine::LibrarySource::All);- assert_eq!(h.app.session.visible().len(), 1);+ assert_eq!(h.app.session.source, LibrarySource::LibraryFolder, "choosing it again keeps it, as an album does");+ click(&mut h, "source:libfolder:/pics/home");+ assert_eq!(h.app.session.library_folder.as_deref(), Some("/pics/home"));+}++#[test]+fn the_grid_is_titled_after_the_folder() {+ let mut h = folders_app(&["/Volumes/tokyo/photos/travel/a.jpg"]);+ h.app.session.source = lightcraft_engine::LibrarySource::LibraryFolder;+ h.app.session.library_folder = Some("/Volumes/tokyo/photos/travel".into());+ assert_eq!(crate::i18n::source_title(&h.app.session), "photos/travel");+ h.app.session.source = lightcraft_engine::LibrarySource::All;+ assert_eq!(crate::i18n::source_title(&h.app.session), "All Photos");+}++/// A folder that holds nothing itself and leads to one folder starts open: the tree opens down to+/// where the library branches.+#[test]+fn a_chain_of_single_folders_starts_open() {+ let h = folders_app(&["/Users/me/Pictures/2024/a.jpg", "/Users/me/Pictures/2025/b.jpg"]);+ assert!(has(&h, "source:libfolder:/Users/me/Pictures"), "Users and me opened by themselves");+ assert!(!has(&h, "source:libfolder:/Users/me/Pictures/2024"), "the branching folder waits to be opened");}/// Removing a folder from the library asks first, then moves its photos to Recently Deleted.@@ -310,7 +339,7 @@ fn a_folder_that_holds_other_disks_only_opens() {let mut h = folders_app(&["/Volumes/1.jpg", "/Volumes/tokyo/x.jpg"]);assert!(has(&h, "source:libfolder:/Volumes"));click(&mut h, "source:libfolder:/Volumes");- assert_eq!(h.app.session.filter.library_folder, None, "choosing it would show the tokyo disk too");+ assert_eq!(h.app.session.library_folder, None, "choosing it would show the tokyo disk too");click(&mut h, "source:libfolder:/Volumes/tokyo");assert_eq!(h.app.session.visible().len(), 1, "a disk's own row does choose");}@@ -320,7 +349,8 @@ fn a_folder_that_holds_other_disks_only_opens() {fn the_chosen_folder_is_always_in_view() {let mut h = folders_app(&["/pics/trip/day1/a.jpg", "/pics/trip/b.jpg", "/pics/home/c.jpg"]);assert!(!has(&h, "source:libfolder:/pics/trip/day1"), "folded to begin with");- h.app.session.filter.library_folder = Some("/pics/trip/day1".into());+ h.app.session.source = lightcraft_engine::LibrarySource::LibraryFolder;+ h.app.session.library_folder = Some("/pics/trip/day1".into());h.step();h.step();assert!(has(&h, "source:libfolder:/pics/trip/day1"), "the rows above it opened");@@ -337,7 +367,8 @@ fn a_renamed_folder_keeps_its_place_in_the_tree() {std::fs::create_dir_all(base.join("pics/home")).unwrap();let b = base.to_string_lossy().to_string();let mut h = folders_app(&[&format!("{b}/pics/trip/a.jpg"), &format!("{b}/pics/home/b.jpg")]);- h.app.session.filter.library_folder = Some(format!("{b}/pics/trip"));+ h.app.session.source = lightcraft_engine::LibrarySource::LibraryFolder;+ h.app.session.library_folder = Some(format!("{b}/pics/trip"));h.step();h.step();assert!(has(&h, &format!("source:libfolder:{b}/pics/trip")));diff --git a/docs/parity.md b/docs/parity.mdindex 23582ca34..206e2c3ec 100644--- a/docs/parity.md+++ b/docs/parity.md@@ -718,7 +718,7 @@ From `08-lightroom-classic-extras.md` (Classic-only features) and part 2 of `06-| LRC-LIB-CATALOG-PANEL | Catalog sets | P1 | ✅ | `cmd:library.source` (`missing`) | all, recently added, picks, recently deleted, missing photos (when any) || LRC-LIB-CATALOG-LOCK | Catalog open in one program at a time | P1 | ✅ | `cmd:app.openLibrary`, `crates/catalog/src/lock.rs`, `crates/engine/src/library.rs` (`open_library`) | exclusive OS lock on `catalog.lock` for the session (app and `lightcraft-cli --library`); a second opener is refused with who has it (`catalog.lock.owner`: program, process, computer); released by the OS on a crash, so never stale; file systems without locks open unprotected with a warning; no read-only mode; the browser build (OPFS) has no guard across tabs yet. A library that can't be opened at launch (locked, unreadable, newer format, drive missing) shows a window — Try Again, Choose Another Library…, Continue Without Saving (then a banner; nothing written), Quit — instead of a silent demo session (`crates/ui-egui/src/panels/library_problem.rs`) || LRC-LIB-FOLDERS | Disk folder tree | P1 | ✅ | `cmd:library.browse`, `cmd:folder.rename`, `cmd:folder.move`, `crates/ui-egui/src/panels/left.rs` (`local_section`, `folder_tree`) | standard places + the browsed folder + Browse Folder…, each an expandable tree of subfolders, breadcrumb navigation; context menu: Rename Folder…, Move Folder To…, Show in Finder (on disk, photos relinked; one undo step each: undo / redo move the folder back and forth, refused when the destination is taken) |-| LRC-LIB-LIBFOLDERS | Library folders | P1 | ✅ | `cmd:library.folders`, `cmd:library.filter` (`libraryFolder`), `cmd:library.removeFolder`, `cmd:folder.rename`, `cmd:folder.move`, `crates/catalog/src/folders.rs`, `crates/ui-egui/src/panels/left.rs` (`folders_section`, `folder_menu_for_library`, `row_menu`), `crates/ui-egui/src/tests_panels.rs` | sidebar Folders: the folders the library's photos were imported from, with photo counts (subfolders included), as another way to explore the library next to By Date and Keywords; Local stays the way to browse any folder on disk. Each disk is a row of its own and starts open: a drive letter, a Windows share (`\\server\share`, `\\?\UNC\…`, `\\wsl$\…`), a macOS share or disk (`/Volumes/tokyo`), a Linux mount (`/media`, `/run/media`, `/mnt`, gvfs `smb-share:…`, `/net/<host>`), NFS (`/Network/Servers/<host>`), else “This Computer” — told apart from the stored paths alone, so an offline share lists like a mounted one and the sidebar never waits on a network. Only folders that hold imported photos are listed (browsed, deleted and demo photos don't count); levels that hold nothing and lead to one folder fold into one row (`Users/me/Pictures`); long names are cut at the end with the full path in the tooltip; click chooses a folder and the folders inside it (click again clears; chip “Folder: pics/trip”), and its row is always opened into view, also after a rename or move and their undo. A row that would cover other disks' photos too (the startup disk, `/Volumes`, `/mnt`…) only opens. Right-click (row or triangle): Rename Folder…, Move Folder To…, Show in Finder (on disk, photos relinked, as in Local) and Remove from Library… (asks; moves the folder's photos to Recently Deleted, one undo step, no file touched); a disk row offers Remove Disk from Library… (the command needs `disk: true` for a whole disk or a folder spanning several). Limits: names are compared as written (macOS `/Volumes/tokyo` vs `/Volumes/TOKYO` are two disks; `/Volumes/Macintosh HD/…` and `/…` two rows); no disk capacity / online status; no “include subfolders” switch (a folder always includes the ones inside it); creating a folder and moving photos between folders are not here |+| LRC-LIB-LIBFOLDERS | Library folders | P1 | ✅ | `cmd:library.folders`, `cmd:library.source` (`libraryFolder`), `cmd:library.filter` (`libraryFolder`), `cmd:library.removeFolder`, `cmd:folder.rename`, `cmd:folder.move`, `crates/catalog/src/folders.rs`, `crates/ui-egui/src/panels/left.rs` (`folders_section`, `folder_menu_for_library`, `row_menu`), `crates/ui-egui/src/tests_panels.rs` | sidebar Folders: the folders the library's photos were imported from, with photo counts (subfolders included), as another way to explore the library next to By Date and Keywords; Local stays the way to browse any folder on disk. Each disk is a row of its own and starts open: a drive letter, a Windows share (`\\server\share`, `\\?\UNC\…`, `\\wsl$\…`), a macOS share or disk (`/Volumes/tokyo`), a Linux mount (`/media`, `/run/media`, `/mnt`, gvfs `smb-share:…`, `/net/<host>`), NFS (`/Network/Servers/<host>`), else “This Computer” — told apart from the stored paths alone, so an offline share lists like a mounted one and the sidebar never waits on a network. Only folders that hold imported photos are listed (browsed, deleted and demo photos don't count); every folder is a row of its own (`Users` → `me` → `Pictures`), and a folder that holds nothing itself and leads to one folder starts open; long names are cut at the end with the full path in the tooltip; click makes the folder the source, like an album or a Local folder (its photos and those of the folders inside it fill the grid, titled “photos/travel”; the filter bar narrows it further; `library.source` `libraryFolder` + `path`; kept with the library's view), and its row is always opened into view, also after a rename or move and their undo. A row that would cover other disks' photos too (the startup disk, `/Volumes`, `/mnt`…) only opens. Right-click (row or triangle): Rename Folder…, Move Folder To…, Show in Finder (on disk, photos relinked, as in Local) and Remove from Library… (asks; moves the folder's photos to Recently Deleted, one undo step, no file touched); a disk row offers Remove Disk from Library… (the command needs `disk: true` for a whole disk or a folder spanning several). Limits: names are compared as written (macOS `/Volumes/tokyo` vs `/Volumes/TOKYO` are two disks; `/Volumes/Macintosh HD/…` and `/…` two rows); no disk capacity / online status; no “include subfolders” switch (a folder always includes the ones inside it); creating a folder and moving photos between folders are not here || LRC-LIB-COLLECTIONS | Collections & sets | P1 | ✅ | `cmd:album.create`, `cmd:album.createSmart`, `cmd:album.toggleTarget`, `cmd:album.setTarget`, `cmd:album.clearQuick` | albums + folders (sets), smart albums (rule editor; rules incl. File Path — the whole string, either separator, case-insensitive), Quick Collection and target album (B in the grids adds / removes the selection; album menu ▸ Set as Target Album; the target is marked +) || LRC-LIB-SMARTCOLL | Smart-collection rules | P1 | ✅ | `cmd:album.createSmart`, `cmd:album.setRules`, `cmd:album.ruleFields`, `cmd:dialog.smartAlbum`, `crates/catalog/src/rules.rs`, `crates/ui-egui/src/panels/rules_editor.rs` | rule editor: match all / any / none, nested groups (⌥+ or + Group), 30 fields (rating, flag, label, type, edits, keywords, any text, filename, file path, format, title, caption, camera, lens, location, creator, copyright, copyright status, capture / import / edit date, ISO, aperture, focal length, megapixels, GPS, virtual copy, album) with text / number / date / in-the-last operators; live match count; also usable as a library filter (`ruleSet`) || LRC-LIB-PUBLISH | Publish services | P2 | ⬜ | | |