initial commit

tests/fixtures/performance/README.md

@@ -0,0 +1,16 @@
+# Performance corpus
+
+All document content is generated locally by `tests/generate_performance_corpus.py`. Individual file sizes, SHA-256 hashes and font provenance are recorded in `manifest.json`. The 500-page/500-chapter corpus is separate from the large raster stress workload.
+
+## EPUB navigation destinations
+
+`standard-500.epub` contains 500 chapters, each with one h1 and twelve h2 headings. Its final section has `min-height:100vh`. This authored fixture style provides enough trailing room for all thirteen headings to have distinct scroll destinations, so the fixed benchmark can execute twelve forward and twelve backward moves without counting stationary end-clamped commands as physical navigation. The benchmark retains its original traversal span and requires every counted heading move to change the validated reading position.
+
+Only the EPUB `style.css` entry changed. Its chapter text, headings, images, spine and navigation document are unchanged. HTML, ZIP HTML and PDF fixtures are unchanged.
+
+| Fixture | Bytes | SHA-256 | Purpose |
+|---|---:|---|---|
+| `standard-500.epub` | 300640 | `c5816283075fe2915672cbb2daa33229d74eeffb11041ef4a1f927886cdd2aa6` | Fixed performance movement sequence with distinct terminal destinations |
+| `standard-500-clamped.epub` | 300618 | `d4136e2c7e5e67bc10e640589c34fc629e80e66edd2ab2bd25dda238c7a2314d` | Original short final section, retained byte-for-byte for end-clamping regressions and old result interpretation |
+
+The generator reproduces both files byte-for-byte. The original failing measurement is preserved in `tests/results/benchmark-xhtml/clamp-diagnostic/epub.json`: the twelfth heading command was acknowledged, but both before and after positions were `chapter-0.xhtml`, progression 1. The corresponding 125-operation failure is preserved in `tests/results/benchmark-xhtml/standard-clamped/epub.json`. Product handling of consecutive clamped headings is tested independently on unmodified short-tail XHTML and must not be inferred from performance on the extended-tail fixture.

tests/fixtures/performance/html/image.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="480" height="240"><rect width="480" height="240" fill="#dae8ed"/><circle cx="240" cy="120" r="85" fill="#247b84"/></svg>

tests/fixtures/performance/html/style.css

@@ -0,0 +1 @@
+body{font:18px sans-serif;line-height:1.6;margin:3em;max-width:55em}h1,h2{color:#165f69}img{width:240px}

tests/fixtures/performance/manifest.json

@@ -0,0 +1,41 @@
+{
+  "origin": "DocView original generated test content; PDF embeds the OFL font described in ../pdf/extended/manifest.json",
+  "limits": "500 PDF pages and 500 EPUB chapters, small reused images; not a 1 GiB scan corpus",
+  "files": {
+    "html/image.svg": {
+      "bytes": 167,
+      "sha256": "75a9e53bba15133453cd3c4fc643ab07b7496b7430cd3ed491105fc3754616cb"
+    },
+    "html/index.html": {
+      "bytes": 88685,
+      "sha256": "759428ab7ba6f268964f7511f486cffee82490747128ec7a8b5d65b44a7f5c1d"
+    },
+    "html/style.css": {
+      "bytes": 104,
+      "sha256": "95f79af1fb8a6ed283ddac428708405acb2f6aad86faf633bb45a44ad3a471ae"
+    },
+    "standard-500.epub": {
+      "bytes": 300640,
+      "sha256": "c5816283075fe2915672cbb2daa33229d74eeffb11041ef4a1f927886cdd2aa6",
+      "purpose": "Timed navigation: 13 distinct heading destinations per chapter; final section minimum height is one viewport."
+    },
+    "standard-500.pdf": {
+      "bytes": 187414,
+      "sha256": "cf0d33129971f0efa53434f2c827f70877c3d36b4146fdf1cf3ba0df6c9783e4"
+    },
+    "standard-html.zip": {
+      "bytes": 32821,
+      "sha256": "40ac84446c8e684f4085653a7cc016ca4aa92fc18dcccef443266498b227ed9d"
+    },
+    "standard-headings-500.pdf": {
+      "bytes": 293605,
+      "sha256": "55431198ea6b67e52c81eeef4f12c330f03558f78c01ac3a49768fc9076cac31",
+      "purpose": "Same 500 original generated pages with 500 authored page-start outline headings for fixed 100-command navigation sequences."
+    },
+    "standard-500-clamped.epub": {
+      "bytes": 300618,
+      "sha256": "d4136e2c7e5e67bc10e640589c34fc629e80e66edd2ab2bd25dda238c7a2314d",
+      "purpose": "Original short-tail corpus, retained unchanged for end-clamping regressions and prior failed benchmark hashes."
+    }
+  }
+}