proofsheet-core 0.1.14

Core driver for proofsheet: CDP browser control, deterministic capture, receipts.
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

# proofsheet-core

The engine behind [proofsheet](https://crates.io/crates/proofsheet): exact-pixel
App Store and Google Play screenshots from a real browser, deterministic and
local-first.

This crate is the library. For the command-line tool, install
[`proofsheet`](https://crates.io/crates/proofsheet).

```toml
[dependencies]
proofsheet-core = "0.1"
```

```rust
use proofsheet_core::{device, find_browser, progress::Silent, run,
                      Determinism, RunOptions, Stability, Store};

let presets = device::builtin();
let report = run(&RunOptions {
    url: "http://localhost:5173".into(),
    devices: device::for_store(&presets, Store::Apple),
    out_dir: "./shots".into(),
    determinism: Determinism { seed: 42, ..Default::default() },
    stability: Stability::default(),
    browser: find_browser(None)?,
    fail_fast: false,
}, &mut Silent)?;

// `ok`, not `failed == 0` -- the latter is also true when nothing was captured.
assert!(report.ok, "{} off-size, {} failed", report.off_size, report.failed);
```

## What it does that a screenshot script doesn't

**Exact pixels by construction.** A preset stores the output size the store
requires and derives the viewport as `output / scale`. A preset whose output
doesn't divide evenly is rejected at parse time, so "the size we emit is a size
the store accepts" is structural rather than arithmetic someone got right.

**Deterministic runs.** A preamble injected before any page script seeds
`Math.random`, freezes `Date.now` and `performance.now`, drives
`requestAnimationFrame` on a fixed virtual step, and pins locale and timezone
through CDP. Same seed, byte-identical PNGs.

**Wrong-layout detection.** A page can be captured at exactly the right pixel
count and still show a desktop layout scaled into a phone frame. Every
`Capture` carries an `Environment` recording what the page actually did —
assert on `viewport_honoured`, not just the dimensions.

No async runtime, no browser automation framework, no HTTP client. The
WebSocket and CDP client are hand-rolled `std`.

## Documentation

Full docs, device tables and examples:
[github.com/interchained/proofsheet](https://github.com/interchained/proofsheet)

## License

BUSL-1.1, converting to MIT on 2030-08-22.
Property made in part by **Interchained LLC Labs**.