selection-capture 0.1.4

Sync, cancellable selected-text capture engine with strategy-aware fallbacks
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

use crate::types::{ActiveApp, CaptureFailure, CaptureMethod, CaptureOptions, CaptureTrace};

/// Explicit format tag for a rich-text payload.
///
/// Reserved for future use — currently not attached to payload fields,
/// but preserved in the public API for upcoming typed format annotations.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum RichFormat {
    Html,
    Rtf,
}

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum RichSource {
    ClipboardHtml,
    ClipboardRtf,
    AccessibilityAttributed,
}

#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum RichConversion {
    Markdown,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct ContentMetadata {
    pub active_app: Option<ActiveApp>,
    pub method: CaptureMethod,
    pub source: RichSource,
    pub captured_at_unix_ms: u128,
    /// FNV-1a 64-bit hash of `plain_text`. Stable across process restarts and Rust
    /// versions — safe for persistent deduplication and cross-process comparison.
    pub plain_text_hash: u64,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct RichPayload {
    pub plain_text: String,
    pub html: Option<String>,
    pub rtf: Option<String>,
    pub markdown: Option<String>,
    pub metadata: ContentMetadata,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub enum CapturedContent {
    Plain(String),
    Rich(RichPayload),
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct CaptureRichSuccess {
    pub content: CapturedContent,
    pub method: CaptureMethod,
    pub trace: Option<CaptureTrace>,
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub enum CaptureRichOutcome {
    Success(CaptureRichSuccess),
    Failure(CaptureFailure),
}

#[derive(Clone, Debug, PartialEq, Eq)]
pub struct CaptureRichOptions {
    pub base: CaptureOptions,
    pub prefer_rich: bool,
    pub allow_clipboard_rich: bool,
    pub allow_direct_accessibility_rich: bool,
    pub conversion: Option<RichConversion>,
    pub max_rich_payload_bytes: usize,
    pub require_plain_text_match: bool,
}

impl Default for CaptureRichOptions {
    fn default() -> Self {
        Self {
            base: CaptureOptions::default(),
            prefer_rich: true,
            allow_clipboard_rich: true,
            allow_direct_accessibility_rich: true,
            conversion: None,
            max_rich_payload_bytes: 256 * 1024,
            require_plain_text_match: true,
        }
    }
}