zkv 0.3.0

Zero-knowledge encrypted personal vault: a local-first, end-to-end encrypted TUI manager for passwords, notes, and cards.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

//! 列表视图:条目列表(含搜索框)。对应 PRD §8。
//!
//! 重排后不再有常驻侧边栏;分类/标签计数折进 header,管理走 `c`/`t` 模态。
//! 列表项两行:第 1 行类型标签 + 标题,第 2 行次要信息(用户名/预览)。

use ratatui::layout::{Constraint, Layout, Rect};
use ratatui::widgets::{List, ListItem, ListState, Paragraph, Wrap};
use ratatui::Frame;

use super::input;
use super::theme;
use crate::app::App;
use crate::model::{FieldKind, Item};

/// 渲染条目列表(Search 模式时顶部叠搜索框)。
pub fn render_list(frame: &mut Frame, area: Rect, app: &App, tick: u64) {
    // Search 模式:顶部一行搜索输入框。
    let (list_area, search_widget) = if app.mode == crate::app::Mode::Search {
        let chunks = Layout::vertical([Constraint::Length(3), Constraint::Min(1)]).split(area);
        let field = input::InputField {
            value: app.input.clone(),
            mask: false,
        };
        (chunks[1], Some((chunks[0], field)))
    } else {
        (area, None)
    };

    if let Some((sarea, field)) = search_widget {
        input::render_input(frame, sarea, &field, " / search ", tick);
    }

    let inner = theme::panel_frame(frame, list_area, Some("Items"));

    if app.items.is_empty() {
        let empty = Paragraph::new("(no items)\npress n to create")
            .style(theme::muted())
            .wrap(Wrap { trim: true });
        frame.render_widget(empty, inner);
        return;
    }

    let items: Vec<ListItem> = app
        .items
        .iter()
        .map(|it| {
            // 第 1 行:留 2 列给选中标记 "▸ ";类型标签 + 标题。
            let l1 = ratatui::text::Line::from(vec![
                ratatui::text::Span::raw("  "),
                type_span(&it.template_id),
                ratatui::text::Span::raw(" "),
                ratatui::text::Span::styled(it.title.clone(), theme::fg()),
            ]);
            // 第 2 行:次要信息,弱化、缩进。
            let l2 = ratatui::text::Line::from(vec![
                ratatui::text::Span::raw("      "),
                ratatui::text::Span::styled(secondary(it), theme::muted()),
            ]);
            ListItem::new(vec![l1, l2])
        })
        .collect();

    let list = List::new(items)
        .highlight_style(theme::selected_bar())
        .highlight_symbol("▶ ");

    let mut state = ListState::default();
    if app.selected < app.items.len() {
        state.select(Some(app.selected));
    }
    frame.render_stateful_widget(list, inner, &mut state);
}

/// 模板 id → 配色标签 span。password/note/card 保留旧配色;其余用通用 `[…]` 标签。
fn type_span(template_id: &str) -> ratatui::text::Span<'static> {
    let (label, style) = match template_id {
        "password" => ("[PW]", theme::accent2()),
        "note" => ("[NO]", theme::accent()),
        "card" => ("[CD]", theme::title_style()),
        _ => ("[··]", theme::muted()),
    };
    ratatui::text::Span::styled(label, style)
}

/// 条目的次要信息:取 `username` 字段值;否则首个 Text 字段预览;否则标题。
fn secondary(it: &Item) -> String {
    // username 字段优先。
    if let Some(v) = it.field_value("username") {
        if !v.is_empty() {
            return v.to_string();
        }
    }
    // 否则取首个 Text 字段(取首行预览)。
    if let Some(f) = it.fields.iter().find(|f| f.kind == FieldKind::Text) {
        let first = f.value.lines().next().unwrap_or("");
        if !first.is_empty() {
            return first.chars().take(24).collect();
        }
    }
    // 都没有 → 标题。
    if it.title.is_empty() {
        "(empty)".into()
    } else {
        it.title.clone()
    }
}