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
// =============================================================================
// Copyright (c) 2026 Haixing Hu.
//
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Unpublished independently resolvable text owned by the batch path.
use crate::RedactionTextOutput;
/// Accumulates unpublished text outputs for one batch transaction.
pub(super) struct BatchOutputBuffer {
/// Items in their caller-observed publication order.
items: Vec<RedactionTextOutput>,
/// First item whose output capacity was exhausted, if one exists.
exhausted_item: Option<usize>,
}
impl BatchOutputBuffer {
/// Creates an empty unpublished batch buffer.
///
/// # Returns
///
/// An empty buffer with no exhausted-item sentinel.
#[must_use]
#[inline(always)]
pub(super) const fn new() -> Self {
Self {
items: Vec::new(),
exhausted_item: None,
}
}
/// Returns the number of buffered items.
///
/// # Returns
///
/// The number of staged items, including an exhausted sentinel if present.
#[must_use]
#[inline(always)]
pub(super) const fn len(&self) -> usize {
self.items.len()
}
/// Returns the first exhausted item index, if recorded.
///
/// # Returns
///
/// `Some(index)` identifies the first stored exhausted sentinel; `None`
/// means no such sentinel has been recorded.
#[must_use]
#[inline(always)]
pub(super) const fn exhausted_item(&self) -> Option<usize> {
self.exhausted_item
}
/// Appends one rendered item and returns its stable batch index.
///
/// # Parameters
///
/// - `text`: Already escaped text for one admitted operation.
/// - `summary`: Accounting and completion for that operation.
///
/// # Returns
///
/// The stable insertion index of the new item.
#[inline]
pub(super) fn push(&mut self, text: String, summary: crate::RedactionSummary) -> usize {
let index = self.items.len();
self.items.push(RedactionTextOutput::new(
crate::RedactedText::from_escaped(text),
summary,
));
index
}
/// Records the first item index that exhausted shared output capacity.
///
/// # Parameters
///
/// - `index`: Index of the first exhausted sentinel, recorded once by the
/// caller.
#[inline(always)]
pub(super) fn set_exhausted_item(&mut self, index: usize) {
self.exhausted_item = Some(index);
}
/// Consumes the buffer into the ordered published item collection.
///
/// # Returns
///
/// The staged items in insertion order, consuming the unpublished buffer.
#[must_use]
#[inline(always)]
pub(super) fn publish(self) -> Vec<RedactionTextOutput> {
self.items
}
}