(a136d13) Draw the discarded column behind a three-state visibility rotation, and bump to 0.31.1

This commit is contained in:
Ansho Rei
2026-08-25 03:33:38 +02:00
parent 5bf0fd1bfe
commit 60b43a682e
7 changed files with 321 additions and 162 deletions
+12 -22
View File
@@ -2707,8 +2707,8 @@ pub enum Status {
impl Status {
/// Every status, in flow order with discarded last. The one list, which
/// [`status_dirs`], `mv` and every caller of [`by_status_order`] read rather than
/// spelling the five names again.
/// [`status_dirs`], `mv`, the board's columns and every caller of
/// [`by_status_order`] read rather than spelling the five names again.
pub const ALL: [Status; 5] = [
Status::Backlog,
Status::Committed,
@@ -2717,19 +2717,6 @@ impl Status {
Status::Discarded,
];
/// The stages work moves through: every status but discarded, which work never
/// moves through, it only ends up in.
///
/// What the board draws its columns from, so done stays the last drawn column and
/// hiding it stays a prefix of the list. Showing a discarded column is a136d13's,
/// not a side effect of the status existing.
pub const FLOW: [Status; 4] = [
Status::Backlog,
Status::Committed,
Status::Reviewing,
Status::Done,
];
/// The field `mv` stamps on entering this status, for the four that have one.
///
/// Derived from the status rather than spelled at the call site, so the mapping is
@@ -2762,17 +2749,20 @@ pub fn status_dirs() -> Vec<&'static str> {
Status::ALL.iter().map(|status| status.as_str()).collect()
}
/// The end of the flow, and the one status both views treat differently: `ls` counts it
/// in the summary and leaves it out of the listing, and the board hides its column until
/// asked. Named because that rule now has two readers.
/// The end of the flow, and one of the two statuses both views treat differently: `ls`
/// counts it in the summary and leaves it out of the listing, and the board hides its
/// column until `d` reveals it. Named because that rule now has two readers.
///
/// It is deliberately last in [`Status::FLOW`], which is what the board draws. The board
/// leans on that: hiding done drops the final column, so the other three keep their
/// indices and the selection only has to be handled when it is sitting on done itself.
/// Done and discarded are deliberately the last two in [`Status::ALL`], which is what
/// the board builds its columns from: hiding either is then a prefix of that list, so
/// the columns before them keep their indices and the selection only has to be handled
/// when it is sitting on a column that just went away. Discarded after done is also
/// what lets the stamp arrival rule keep a discard's journey.
pub const DONE: &str = Status::Done.as_str();
/// Where a ticket that will not be done ends up: the other terminal status, and the
/// other one `ls` leaves out of the listing.
/// other one `ls` leaves out of the listing and the board keeps off the screen until
/// asked, last in the rotation because it is the least likely thing to be looking for.
///
/// A discarded ticket counts as finished wherever progress is measured, since nothing is
/// left to do, and blocks nothing. What it is not is done: the two directories keep