weavatrix-edit 0.1.7

Deterministic, Unicode-safe edit-plan validation and application for source refactoring
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

/// Absolute UTF-8 byte ceiling for a caller-defined operation label.
///
/// This hard ceiling is independent of caller-configurable plan budgets so a
/// validated plan cannot carry unbounded metadata into hashing or journaling.
pub const MAX_PLAN_OPERATION_BYTES: usize = 4_096;

/// Bounded validation limits for a multi-file edit plan.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct PlanLimits {
    pub max_files: usize,
    pub max_edits_per_file: usize,
    pub max_total_edits: usize,
    pub max_path_bytes: usize,
    pub max_total_text_bytes: usize,
}

impl Default for PlanLimits {
    fn default() -> Self {
        Self {
            max_files: 500,
            max_edits_per_file: 2_000,
            max_total_edits: 1_000_000,
            max_path_bytes: 4_096,
            max_total_text_bytes: 64 * 1024 * 1024,
        }
    }
}

/// Bounded in-memory application limits for one source file.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct ApplyLimits {
    pub max_source_bytes: usize,
    pub max_edits: usize,
    pub max_output_bytes: usize,
}

impl Default for ApplyLimits {
    fn default() -> Self {
        Self {
            max_source_bytes: 16 * 1024 * 1024,
            max_edits: 2_000,
            max_output_bytes: 64 * 1024 * 1024,
        }
    }
}

/// Resource limits for building a reusable full [`crate::LineIndex`].
///
/// The byte ceiling covers the line-start offset table, not the borrowed source
/// text. Position-based one-shot application uses a separate sparse index
/// bounded by the existing [`ApplyLimits::max_edits`] ceiling.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct LineIndexLimits {
    pub max_lines: usize,
    pub max_index_bytes: usize,
}

impl Default for LineIndexLimits {
    fn default() -> Self {
        Self {
            max_lines: 1_000_000,
            max_index_bytes: 8 * 1024 * 1024,
        }
    }
}

/// Hard resource limits for incrementally building one original-source batch.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct BatchLimits {
    pub max_source_bytes: usize,
    pub max_edits: usize,
    pub max_before_bytes: usize,
    pub max_replacement_bytes: usize,
    pub max_output_bytes: usize,
}

impl Default for BatchLimits {
    fn default() -> Self {
        Self {
            max_source_bytes: 16 * 1024 * 1024,
            max_edits: 2_000,
            max_before_bytes: 16 * 1024 * 1024,
            max_replacement_bytes: 64 * 1024 * 1024,
            max_output_bytes: 64 * 1024 * 1024,
        }
    }
}