#[non_exhaustive]pub struct HostProjection {
pub text_nodes: Vec<HostText>,
pub clipboard: Option<ClipboardPayload>,
}Expand description
Leak surface. Contract tests serialize this, not the pixmap.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.text_nodes: Vec<HostText>Strings the host may place in the DOM / ARIA.
clipboard: Option<ClipboardPayload>Clipboard. ClipboardPayload::None when sealed.
Implementations§
Source§impl HostProjection
impl HostProjection
Sourcepub fn audit_text(&self) -> String
pub fn audit_text(&self) -> String
Concatenate host text + clipboard for grep tests.
Examples found in repository?
examples/scatter.rs (line 49)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut a = Vec::new();
17 let mut b = Vec::new();
18 for i in 0..28u32 {
19 let t = f64::from(i);
20 a.push(SeriesPoint::new(
21 6.0 + (t * 0.37).sin() * 5.0 + t * 0.12,
22 22.0 + (t * 0.51).cos() * 8.0,
23 ));
24 b.push(SeriesPoint::new(
25 18.0 + (t * 0.29).cos() * 6.0,
26 12.0 + (t * 0.41).sin() * 7.0 + t * 0.15,
27 ));
28 }
29 a[10] = SeriesPoint::new(12.0, 49.37);
30
31 let layout = SeriesLayout::try_new(vec![Series::new(0, "a", a), Series::new(1, "b", b)])?;
32 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
33 fs::create_dir_all(&dir)?;
34
35 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
36 let vp = Viewport::window(520, 240);
37 let rest = FrameRequest::full(vp).caption("scatter");
38 let idle = sealed.render_scatter(&layout, &rest)?;
39 fs::write(dir.join("sc_sealed.png"), &idle.png)?;
40 fs::write(dir.join("readme_scatter.png"), &idle.png)?;
41
42 let hit = sealed.render_scatter(&layout, &rest.clone().pointer(Pointer::new(240, 110)))?;
43 fs::write(dir.join("sc_crosshair.png"), &hit.png)?;
44 if let Some(tip) = &hit.tooltip_png {
45 fs::write(dir.join("sc_tooltip.png"), tip)?;
46 }
47 println!(
48 "sealed scatter audit={:?} tooltip={}",
49 hit.host.audit_text(),
50 hit.tooltip_png.as_ref().map_or(0, Vec::len)
51 );
52
53 sealed.set_mode(SurfaceMode::Copyable);
54 let copy = sealed.render_scatter(&layout, &rest)?;
55 fs::write(dir.join("sc_copyable.png"), ©.png)?;
56
57 let trial = Surface::new(
58 SurfaceMode::Sealed,
59 LicenseLens::from_tier(AccessTier::Trial),
60 );
61 let t = trial.render_scatter(&layout, &rest)?;
62 fs::write(dir.join("sc_trial_lens.png"), &t.png)?;
63 println!(
64 "wrote scatter renders; trial viewed rows={}",
65 t.viewed.rows.len()
66 );
67 Ok(())
68}More examples
examples/host_contract.rs (line 84)
37fn main() -> Result<(), Box<dyn std::error::Error>> {
38 let mut rows = Vec::new();
39 for i in 0..80u32 {
40 rows.push(Row::new(
41 i,
42 vec![
43 CellValue::text(format!("ACME-SKU-{i}")),
44 CellValue::float(10.0 + f64::from(i), 2),
45 ],
46 ));
47 }
48 let grid = Grid::try_new(vec![Column::new(0, "sku"), Column::new(1, "price")], rows)?;
49
50 let surface = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
51 let metrics = surface.metrics(&grid);
52
53 // Host scrollbar: window 480×160, content from metrics.
54 let window = Viewport {
55 origin_x: 0,
56 origin_y: 0,
57 width: 480,
58 height: 160,
59 };
60 println!(
61 "host scrollbar: content {}x{} window {}x{} max_origin_y={}",
62 metrics.content_width,
63 metrics.content_height,
64 window.width,
65 window.height,
66 metrics.content_height.saturating_sub(window.height)
67 );
68
69 let dir = std::env::temp_dir().join("sealed-surface-examples");
70 fs::create_dir_all(&dir)?;
71
72 for (name, origin_y) in [("y0", 0u32), ("y180", 180), ("y360", 360)] {
73 let mut req = FrameRequest::full(Viewport {
74 origin_x: 0,
75 origin_y,
76 width: window.width,
77 height: window.height,
78 });
79 req.pointer = Some(Pointer { x: 24, y: 40 });
80 let frame = surface.render(&grid, &req)?;
81 let path = dir.join(format!("host_{name}.png"));
82 fs::write(&path, &frame.png)?;
83 assert!(
84 frame.host.audit_text().is_empty(),
85 "sealed host leaked: {:?}",
86 frame.host.audit_text()
87 );
88 println!(
89 "{name}: rows {}..{} png={} tooltip={} file={}",
90 frame.visible_row_start,
91 frame.visible_row_end,
92 frame.png.len(),
93 frame.tooltip_png.as_ref().map_or(0, Vec::len),
94 path.display()
95 );
96 }
97
98 println!("forbidden: interpolating cell values, tooltip JSON, CSS blur over live rows");
99 println!("allowed: <img alt=\"\"> + tooltip PNG + metrics-driven origin");
100 Ok(())
101}examples/treemap.rs (line 58)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let layout = TreeLayout::try_new(TreeNode::branch(
17 0,
18 "catalog",
19 vec![
20 TreeNode::branch(
21 1,
22 "apparel",
23 vec![
24 TreeNode::leaf(2, "shirts", 42.0),
25 TreeNode::leaf(3, "pants", 18.0),
26 TreeNode::leaf(4, "hats", 9.0),
27 ],
28 ),
29 TreeNode::branch(
30 5,
31 "home",
32 vec![
33 TreeNode::leaf(6, "lamps", 21.0),
34 TreeNode::leaf(7, "rugs", 14.0),
35 ],
36 ),
37 TreeNode::leaf(8, "other", 7.0),
38 ],
39 ))?;
40
41 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
42 fs::create_dir_all(&dir)?;
43
44 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
45 let vp = Viewport::window(520, 280);
46 let rest = FrameRequest::full(vp).caption("catalog");
47 let idle = sealed.render_tree(&layout, &rest)?;
48 fs::write(dir.join("tm_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_tree.png"), &idle.png)?;
50
51 let hit = sealed.render_tree(&layout, &rest.clone().pointer(Pointer::new(80, 90)))?;
52 fs::write(dir.join("tm_hover.png"), &hit.png)?;
53 if let Some(tip) = &hit.tooltip_png {
54 fs::write(dir.join("tm_tooltip.png"), tip)?;
55 }
56 println!(
57 "sealed tree audit={:?} hits={} tooltip={}",
58 hit.host.audit_text(),
59 hit.hits.len(),
60 hit.tooltip_png.as_ref().map_or(0, Vec::len)
61 );
62
63 sealed.set_mode(SurfaceMode::Copyable);
64 let copy = sealed.render_tree(&layout, &rest)?;
65 fs::write(dir.join("tm_copyable.png"), ©.png)?;
66 println!(
67 "copyable TSV (120): {:?}",
68 copy.host.audit_text().chars().take(120).collect::<String>()
69 );
70
71 let trial = Surface::new(
72 SurfaceMode::Sealed,
73 LicenseLens::from_tier(AccessTier::Trial),
74 );
75 let t = trial.render_tree(&layout, &rest)?;
76 fs::write(dir.join("tm_trial_lens.png"), &t.png)?;
77 println!(
78 "wrote treemap renders; trial viewed rows={}",
79 t.viewed.rows.len()
80 );
81 Ok(())
82}examples/timeseries.rs (line 57)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let mut pts = Vec::new();
17 for i in 0..48u32 {
18 let x = f64::from(i);
19 let y = 40.0 + 12.0 * (x * 0.28).sin() + x * 0.35;
20 pts.push(SeriesPoint::new(x, y));
21 }
22 // Distinct sealed-contract values near the middle of the window.
23 pts[20] = SeriesPoint::new(20.0, 49.37);
24
25 let layout = SeriesLayout::try_new(vec![
26 Series::new(0, "px", pts),
27 Series::new(
28 1,
29 "qty",
30 (0..48u32)
31 .map(|i| {
32 let x = f64::from(i);
33 SeriesPoint::new(x, 8.0 + (x * 0.19).cos() * 3.0)
34 })
35 .collect(),
36 ),
37 ])?;
38
39 let dir = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
40 fs::create_dir_all(&dir)?;
41
42 let mut sealed = Surface::new(SurfaceMode::Sealed, LicenseLens::open());
43 let vp = Viewport::window(520, 240);
44 let rest = FrameRequest::full(vp).caption("px / qty");
45 let rest_hit = rest.clone().pointer(Pointer::new(240, 110));
46
47 let idle = sealed.render_series(&layout, &rest)?;
48 fs::write(dir.join("ts_sealed.png"), &idle.png)?;
49 fs::write(dir.join("readme_chart.png"), &idle.png)?;
50 let hit = sealed.render_series(&layout, &rest_hit)?;
51 fs::write(dir.join("ts_crosshair.png"), &hit.png)?;
52 if let Some(tip) = &hit.tooltip_png {
53 fs::write(dir.join("ts_tooltip.png"), tip)?;
54 }
55 println!(
56 "sealed audit (must be empty of values): {:?}",
57 hit.host.audit_text()
58 );
59 println!(
60 "crosshair tooltip_png={} hits={}",
61 hit.tooltip_png.as_ref().map_or(0, Vec::len),
62 hit.hits.len()
63 );
64
65 sealed.set_mode(SurfaceMode::Copyable);
66 let copy = sealed.render_series(&layout, &rest)?;
67 fs::write(dir.join("ts_copyable.png"), ©.png)?;
68 println!("copyable TSV (first 120 chars): {:?}", {
69 let a = copy.host.audit_text();
70 a.chars().take(120).collect::<String>()
71 });
72
73 let trial = Surface::new(
74 SurfaceMode::Sealed,
75 LicenseLens::from_tier(AccessTier::Trial),
76 );
77 let t = trial.render_series(&layout, &rest)?;
78 fs::write(dir.join("ts_trial_lens.png"), &t.png)?;
79 println!(
80 "trial lens viewed rows={} (two sample points per series)",
81 t.viewed.rows.len()
82 );
83
84 println!("wrote {}", dir.display());
85 Ok(())
86}examples/paint_grid.rs (line 89)
15fn main() -> Result<(), Box<dyn std::error::Error>> {
16 let grid = Grid::try_new(
17 vec![
18 Column::new(0, "sku"),
19 Column::new(1, "price"),
20 Column::new(2, "qty"),
21 ],
22 vec![
23 Row::new(
24 0,
25 vec![
26 CellValue::text("ACME-SKU-1"),
27 CellValue::float(49.00, 2),
28 CellValue::int(12),
29 ],
30 ),
31 Row::new(
32 1,
33 vec![
34 CellValue::text("ACME-SKU-2"),
35 CellValue::float(19.50, 2),
36 CellValue::int(3),
37 ],
38 ),
39 Row::new(
40 2,
41 vec![
42 CellValue::text("SECRET-ROW"),
43 CellValue::float(999.00, 2),
44 CellValue::int(1),
45 ],
46 ),
47 ],
48 )?;
49
50 let mut surface = Surface::new(
51 SurfaceMode::Sealed,
52 LicenseLens::from_tier(AccessTier::Trial),
53 );
54 let metrics = surface.metrics(&grid);
55 let mut req = FrameRequest::full(Viewport {
56 origin_x: 0,
57 origin_y: 0,
58 width: metrics.content_width.clamp(320, 960),
59 height: metrics.content_height.clamp(120, 360),
60 });
61 req.pointer = Some(Pointer { x: 24, y: 36 });
62
63 let frame = surface.render(&grid, &req)?;
64 let dir = example_out_dir();
65 fs::create_dir_all(&dir)?;
66 let frame_path = dir.join("frame.png");
67 fs::write(&frame_path, &frame.png)?;
68 if let Some(tip) = &frame.tooltip_png {
69 fs::write(dir.join("tooltip.png"), tip)?;
70 }
71 let renders = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("examples/renders");
72 fs::create_dir_all(&renders)?;
73 fs::write(renders.join("readme_table.png"), &frame.png)?;
74 if let Some(tip) = &frame.tooltip_png {
75 fs::write(renders.join("readme_tooltip.png"), tip)?;
76 }
77
78 println!("mode={:?} lens=trial", surface.mode());
79 println!(
80 "content={}x{} visible_rows={}..{} png_bytes={}",
81 frame.content_width,
82 frame.content_height,
83 frame.visible_row_start,
84 frame.visible_row_end,
85 frame.png.len()
86 );
87 println!(
88 "host audit (must not contain prices): {:?}",
89 frame.host.audit_text()
90 );
91 println!("wrote {}", frame_path.display());
92
93 surface.set_mode(SurfaceMode::Copyable);
94 let copyable = surface.render(&grid, &req)?;
95 println!("copyable TSV:\n{}", copyable.host.audit_text());
96
97 write_readme_shots(&renders)?;
98 Ok(())
99}Trait Implementations§
Source§impl Clone for HostProjection
impl Clone for HostProjection
Source§impl Debug for HostProjection
impl Debug for HostProjection
impl Eq for HostProjection
Source§impl PartialEq for HostProjection
impl PartialEq for HostProjection
impl StructuralPartialEq for HostProjection
Auto Trait Implementations§
impl Forget for HostProjection
impl Freeze for HostProjection
impl Move for HostProjection
impl RefUnwindSafe for HostProjection
impl Send for HostProjection
impl Sync for HostProjection
impl Unpin for HostProjection
impl UnsafeUnpin for HostProjection
impl UnwindSafe for HostProjection
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more