zkv 0.1.2

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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

//! 输入组件:文本输入框、口令模态、通用确认模态。对应 PRD §8。

use ratatui::layout::{Alignment, Constraint, Layout, Rect};
use ratatui::widgets::{Block, BorderType, Borders, Clear, Paragraph, Wrap};
use ratatui::Frame;

use super::theme;

/// 单行输入字段(带可选掩码,用于口令)。
#[derive(Debug, Clone)]
pub struct InputField {
    pub value: String,
    pub mask: bool,
}

impl InputField {
    pub fn new(mask: bool) -> Self {
        Self {
            value: String::new(),
            mask,
        }
    }

    /// 追加一个字符。
    pub fn push_char(&mut self, c: char) {
        self.value.push(c);
    }

    /// 退格删除末尾字符。
    pub fn backspace(&mut self) {
        self.value.pop();
    }

    /// 清空。
    pub fn clear(&mut self) {
        self.value.clear();
    }

    /// 用于渲染的文本:掩码时返回与长度等量的 `•`,否则返回原值。
    pub fn rendered(&self) -> String {
        if self.mask {
            "•".repeat(self.value.chars().count())
        } else {
            self.value.clone()
        }
    }
}

/// 渲染单行输入框(label + 值)。
pub fn render_input(frame: &mut Frame, area: Rect, field: &InputField, label: &str) {
    let block = Block::default()
        .borders(Borders::ALL)
        .border_style(theme::border())
        .title(label)
        .title_style(theme::title_style());
    let text = if field.value.is_empty() {
        // 占位提示
        Paragraph::new("")
            .style(theme::muted())
            .block(block)
    } else {
        Paragraph::new(field.rendered()).style(theme::fg()).block(block)
    };
    frame.render_widget(text, area);
}

/// 渲染一个居中模态:用 `Clear` 清底,带标题与多行正文。
pub fn render_modal(frame: &mut Frame, area: Rect, title: &str, body_lines: &[&str]) {
    // 清底
    frame.render_widget(Clear, area);

    let block = Block::default()
        .borders(Borders::ALL)
        .border_type(BorderType::Rounded)
        .border_style(theme::accent2())
        .title(format!(" {title} "))
        .title_style(theme::title_style())
        .style(theme::fg());

    let inner = {
        let chunks = Layout::vertical([Constraint::Min(1)]).split(area);
        block.inner(chunks[0])
    };
    frame.render_widget(block, area);

    let lines: Vec<ratatui::text::Line> = body_lines
        .iter()
        .map(|s| ratatui::text::Line::from(*s).style(theme::fg()))
        .collect();
    let para = Paragraph::new(lines)
        .alignment(Alignment::Center)
        .wrap(Wrap { trim: true });
    frame.render_widget(para, inner);
}

#[cfg(test)]
mod tests {
    use super::InputField;

    #[test]
    fn push_and_backspace() {
        let mut f = InputField::new(false);
        for c in "abc".chars() {
            f.push_char(c);
        }
        assert_eq!(f.value, "abc");
        f.backspace();
        assert_eq!(f.value, "ab");
    }

    #[test]
    fn mask_renders_bullets() {
        let mut f = InputField::new(true);
        for c in "secret".chars() {
            f.push_char(c);
        }
        assert_eq!(f.rendered(), "•".repeat(6));
        f.clear();
        assert_eq!(f.rendered(), "");
    }
}