todo.list

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::{validate_draft, Todo, TodoDraft};  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_draft::{todo_draft_from_value, trim_space};
use super::todo_item_validate_todo::{is_utc_timestamp, todos_from_value, todos_to_value};
use super::todo_normalise_tags::normalise_tags;  ← from todo.normalise-tags ^1.0.0 · built alongside by fune

/// Refuse a clock reading that would not compare as a string with the stored ones.
pub fn require_utc_now(now: &str) {
    if !is_utc_timestamp(now) {
        panic!("now must be a UTC timestamp like 2026-09-28T09:30:00Z");
    }
}

/// The draft as it will be stored: title and notes trimmed (ASCII only),
/// blank notes as None, tags in normal form. Then checked with validate_draft;
/// the first field in field order that fails is the error.
pub fn checked_draft(draft: &TodoDraft) -> TodoDraft {
    let notes = draft.notes.as_deref().map(trim_space).unwrap_or("");
    let clean = TodoDraft {
        title: trim_space(&draft.title).to_string(),
        notes: if notes.is_empty() { None } else { Some(notes.to_string()) },
        priority: draft.priority.clone(),
        due: draft.due.clone(),
        tags: normalise_tags(&draft.tags),
        recurrence: draft.recurrence.clone(),
    };
    let verdict = validate_draft(&clean);
    if let Some((field, message)) = verdict.errors.first() {
        panic!("invalid todo: {}: {}", field, message);
    }
    clean
}

/// Add a todo from the add form: open, created now, last in manual order,
/// appended. Caller mistakes (id, clock) are reported before form mistakes.
///
/// # Panics
/// On a blank or duplicate id, a `now` that is not a UTC timestamp, or an
/// invalid draft.
pub fn add_todo(todos: &[Todo], draft: &TodoDraft, id: &str, now: &str) -> Vec<Todo> {
    if trim_space(id).is_empty() {
        panic!("a todo needs an id");
    }
    if todos.iter().any(|t| t.id == id) {
        panic!("a todo with id \"{}\" already exists", id);
    }
    require_utc_now(now);
    let clean = checked_draft(draft);
    let order = todos.iter().map(|t| t.order + 1).fold(0, i64::max);
    let mut out = todos.to_vec();
    out.push(Todo {
        id: id.to_string(),
        title: clean.title,
        notes: clean.notes,
        done: false,
        priority: clean.priority,
        due: clean.due,
        tags: clean.tags,
        recurrence: clean.recurrence,
        created_at: now.to_string(),
        completed_at: None,
        order,
    });
    out
}

pub fn fune_vector(args: &[Value]) -> Value {
    let todos = todos_from_value(&args[0]);
    todos_to_value(&add_todo(&todos, &todo_draft_from_value(&args[1]), args[2].as_str(), args[3].as_str()))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::{Todo, TodoDraft};  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_draft::todo_draft_from_value;
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};
use super::todo_list_add_todo::checked_draft;  ← addTodo, another function of this group · built into the same file, even by a slim install

/// The position of the todo with this id, or the unknown-id panic every list
/// operation shares.
pub fn index_of_todo(todos: &[Todo], id: &str) -> usize {
    match todos.iter().position(|t| t.id == id) {
        Some(at) => at,
        None => panic!("no todo with id \"{}\"", id),
    }
}

/// Save the edit form; id, done state, timestamps, order and place are kept.
///
/// # Panics
/// On an unknown id or an invalid draft.
pub fn update_todo(todos: &[Todo], id: &str, draft: &TodoDraft) -> Vec<Todo> {
    let at = index_of_todo(todos, id);
    let clean = checked_draft(draft);
    let mut out = todos.to_vec();
    let t = &mut out[at];
    t.title = clean.title;
    t.notes = clean.notes;
    t.priority = clean.priority;
    t.due = clean.due;
    t.tags = clean.tags;
    t.recurrence = clean.recurrence;
    out
}

pub fn fune_vector(args: &[Value]) -> Value {
    let todos = todos_from_value(&args[0]);
    todos_to_value(&update_todo(&todos, args[1].as_str(), &todo_draft_from_value(&args[2])))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::Todo;  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_draft::is_iso_date;
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};
use super::todo_list_add_todo::require_utc_now;  ← addTodo, another function of this group · built into the same file, even by a slim install
use super::todo_list_update_todo::index_of_todo;  ← updateTodo, another function of this group · built into the same file, even by a slim install
use super::todo_next_occurrence::next_occurrence;  ← from todo.next-occurrence ^1.0.0 · built alongside by fune

/// Refuse a today that is not a real YYYY-MM-DD date, whether or not a repeat needs it.
pub fn require_today(today: &str) {
    if !is_iso_date(today) {
        panic!("today must be a date like 2026-09-28");
    }
}

/// Complete one open todo. A one-off is done at `now`; a repeating one stays
/// open and rolls forward to its next occurrence (todo.next-occurrence).
pub fn complete_todo(todo: &Todo, now: &str, today: &str) -> Todo {
    let mut next = todo.clone();
    match (&todo.recurrence, todo.due.as_deref()) {
        (None, _) => {
            next.done = true;
            next.completed_at = Some(now.to_string());
        }
        (Some(_), None) => panic!("repeating todo \"{}\" has no due date", todo.id),
        (Some(rule), Some(due)) => {
            next.done = false;
            next.completed_at = None;
            next.due = Some(next_occurrence(rule, due, today));
        }
    }
    next
}

/// Tick or untick one todo. Reopening clears the completion time.
///
/// # Panics
/// On an unknown id, a `now` that is not a UTC timestamp or a `today` that is
/// not a date.
pub fn toggle_todo(todos: &[Todo], id: &str, now: &str, today: &str) -> Vec<Todo> {
    let at = index_of_todo(todos, id);
    require_utc_now(now);
    require_today(today);
    let mut out = todos.to_vec();
    if out[at].done {
        out[at].done = false;
        out[at].completed_at = None;
    } else {
        out[at] = complete_todo(&todos[at], now, today);
    }
    out
}

pub fn fune_vector(args: &[Value]) -> Value {
    let todos = todos_from_value(&args[0]);
    todos_to_value(&toggle_todo(&todos, args[1].as_str(), args[2].as_str(), args[3].as_str()))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::Todo;  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};
use super::todo_list_update_todo::index_of_todo;  ← updateTodo, another function of this group · built into the same file, even by a slim install

/// Delete one todo; the others keep their order values (gaps are harmless).
///
/// # Panics
/// On an unknown id.
pub fn remove_todo(todos: &[Todo], id: &str) -> Vec<Todo> {
    let at = index_of_todo(todos, id);
    let mut out = todos.to_vec();
    out.remove(at);
    out
}

pub fn fune_vector(args: &[Value]) -> Value {
    let todos = todos_from_value(&args[0]);
    todos_to_value(&remove_todo(&todos, args[1].as_str()))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::Todo;  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};

/// Every done todo removed, the rest untouched and in order.
pub fn clear_completed(todos: &[Todo]) -> Vec<Todo> {
    todos.iter().filter(|t| !t.done).cloned().collect()
}

pub fn fune_vector(args: &[Value]) -> Value {
    todos_to_value(&clear_completed(&todos_from_value(&args[0])))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::Todo;  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};
use super::todo_list_add_todo::require_utc_now;  ← addTodo, another function of this group · built into the same file, even by a slim install
use super::todo_list_toggle_todo::{complete_todo, require_today};  ← toggleTodo, another function of this group · built into the same file, even by a slim install

/// Complete every open todo as toggle_todo would (repeating ones roll forward
/// and stay open), or reopen all once none is open.
///
/// # Panics
/// On a `now` that is not a UTC timestamp or a `today` that is not a date.
pub fn toggle_all(todos: &[Todo], now: &str, today: &str) -> Vec<Todo> {
    require_utc_now(now);
    require_today(today);
    if todos.iter().any(|t| !t.done) {
        return todos.iter().map(|t| if t.done { t.clone() } else { complete_todo(t, now, today) }).collect();
    }
    todos
        .iter()
        .map(|t| {
            let mut open = t.clone();
            open.done = false;
            open.completed_at = None;
            open
        })
        .collect()
}

pub fn fune_vector(args: &[Value]) -> Value {
    todos_to_value(&toggle_all(&todos_from_value(&args[0]), args[1].as_str(), args[2].as_str()))
}

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::todo_item::Todo;  ← from todo.item ^1.0.0 · built alongside by fune
use super::todo_item_validate_todo::{todos_from_value, todos_to_value};
use super::todo_list_update_todo::index_of_todo;  ← updateTodo, another function of this group · built into the same file, even by a slim install

/// Move a todo to `to_index` in manual order (order ascending, ties by array
/// position, which need not already be sorted) and renumber every order 0 to
/// n-1. The result is in that manual order.
///
/// # Panics
/// On an unknown id or a `to_index` outside 0..n-1.
pub fn move_todo(todos: &[Todo], id: &str, to_index: i64) -> Vec<Todo> {
    let from = index_of_todo(todos, id);
    let last = todos.len() as i64 - 1;
    if to_index < 0 || to_index > last {
        panic!("toIndex must be between 0 and {}, received {}", last, to_index);
    }
    let mut positions: Vec<usize> = (0..todos.len()).collect();
    positions.sort_by_key(|&i| (todos[i].order, i));
    positions.retain(|&i| i != from);
    positions.insert(to_index as usize, from);
    positions
        .iter()
        .enumerate()
        .map(|(n, &i)| {
            let mut t = todos[i].clone();
            t.order = n as i64;
            t
        })
        .collect()
}

pub fn fune_vector(args: &[Value]) -> Value {
    let todos = todos_from_value(&args[0]);
    if let Value::Float(f) = &args[2] {
        panic!("toIndex must be between 0 and {}, received {}", todos.len() as i64 - 1, f);
    }
    todos_to_value(&move_todo(&todos, args[1].as_str(), args[2].as_i64()))
}