perf(app): improve responsiveness across the app

.github/workflows/ci.yml

@@ -9,6 +9,7 @@ on:
       - "packaging/**"
       - "rfd/**"
       - "scripts/**"
+      - "benchmarks/**"
       - "Cargo.toml"
       - "Cargo.lock"
       - "Makefile"
@@ -23,6 +24,7 @@ on:
       - "packaging/**"
       - "rfd/**"
       - "scripts/**"
+      - "benchmarks/**"
       - "Cargo.toml"
       - "Cargo.lock"
       - "Makefile"

Cargo.toml

@@ -14,3 +14,6 @@ anyhow = "1"
 thiserror = "2"
 bytes = "1"
 percent-encoding = "2"
+
+[profile.dev]
+opt-level = 1

benchmarks/epub-page-turn/2026-08-17/README.md

@@ -31,7 +31,8 @@ stabilization, discards five operation warmups, then records 50 samples.
 The generated books contain 16 chapters so one run can select stable
 within-chapter and chapter-boundary pairs. Generated archives are byte-stable.
 The runner fails if a run reports an error, never produces pages, omits one of
-the 16 summaries, or records a different sample count.
+the 15 summaries, records a different sample count, or exceeds an operation's
+p50 or p95 budget below.
 
 ## Initial budgets
 
@@ -57,7 +58,6 @@ All values are milliseconds.
 |---|---|---|---:|---:|
 | `sample.epub` | Single | Chapter transition | 0.581 | 1.618 |
 | `sample.epub` | Single | Relayout | 0.432 | 0.662 |
-| `sample.epub` | Spread | Chapter transition | 0.684 | 1.699 |
 | `sample.epub` | Spread | Relayout | 0.366 | 0.598 |
 | Generated large text | Single | Warm page turn | 1.603 | 2.906 |
 | Generated large text | Single | Chapter transition | 1.370 | 3.465 |
@@ -72,8 +72,9 @@ All values are milliseconds.
 | Generated large image | Spread | Chapter transition | 0.846 | 2.204 |
 | Generated large image | Spread | Relayout | 1.223 | 2.010 |
 
-The small checked-in fixture has no within-chapter warm pair, so that cell is
-intentionally omitted. Large-text relayout is the dominant native cost but
-remains within the initial budget. These numbers are a renderer-comparison
-baseline, not a universal guarantee. Repeat the same protocol on released
-platforms and under representative power and display conditions.
+The small checked-in fixture has no within-chapter warm pair, and its two
+chapters can share one spread, so those cells are intentionally omitted.
+Large-text relayout is the dominant native cost but remains within the initial
+budget. These numbers are a renderer-comparison baseline, not a universal
+guarantee. Repeat the same protocol on released platforms and under
+representative power and display conditions.

benchmarks/epub-page-turn/2026-08-17/run.sh

@@ -38,7 +38,11 @@ run() {
 # The checked-in sample is intentionally small, so it covers chapter transitions
 # and relayout. Generated fixtures add stable warm-turn pairs and text/image load.
 for width in 700 1000; do
-  run "$root/crates/shosai-core/tests/fixtures/sample.epub" chapter "$width"
+  # The sample's two chapters can share one spread, so only single-page mode has
+  # a stable transition between page-turn destinations.
+  if [[ "$width" == 700 ]]; then
+    run "$root/crates/shosai-core/tests/fixtures/sample.epub" chapter "$width"
+  fi
   run "$root/crates/shosai-core/tests/fixtures/sample.epub" relayout "$width"
   for fixture in "$fixtures/large-text.epub" "$fixtures/large-image.epub"; do
     run "$fixture" warm "$width"

benchmarks/epub-page-turn/2026-08-17/tests/test_tools.py

@@ -65,6 +65,26 @@ def test_validator_rejects_reported_errors(self):
         with self.assertRaisesRegex(ValueError, "reported an error"):
             validator.validate(self.complete_log() + "\nperf-error fixture=sample.epub", 50)
 
+    def test_validator_rejects_a_latency_budget_regression(self):
+        content = self.complete_log().replace(
+            "operation=warm-page-turn fixture=large-image.epub samples=50 p50_ms=1 p95_ms=2",
+            "operation=warm-page-turn fixture=large-image.epub samples=50 p50_ms=1 p95_ms=17",
+            1,
+        )
+        with self.assertRaisesRegex(
+            ValueError, "p95_ms=17ms budget=16.7ms"
+        ):
+            validator.validate(content, 50)
+
+    def test_validator_rejects_missing_or_non_finite_latency(self):
+        missing = self.complete_log().replace(" p95_ms=2", "", 1)
+        with self.assertRaisesRegex(ValueError, "invalid p95_ms"):
+            validator.validate(missing, 50)
+
+        non_finite = self.complete_log().replace("p50_ms=1", "p50_ms=nan", 1)
+        with self.assertRaisesRegex(ValueError, "invalid p50_ms"):
+            validator.validate(non_finite, 50)
+
 
 if __name__ == "__main__":
     unittest.main()

benchmarks/epub-page-turn/2026-08-17/validate-results.py

@@ -2,6 +2,7 @@
 """Validate that the 2026-08-17 EPUB performance matrix completed."""
 
 import argparse
+import math
 from pathlib import Path
 import shlex
 
@@ -13,6 +14,11 @@
     "chapter": "chapter-transition",
     "relayout": "relayout",
 }
+OPERATION_BUDGETS_MS = {
+    "warm-page-turn": {"p50_ms": 8.0, "p95_ms": 16.7},
+    "chapter-transition": {"p50_ms": 16.7, "p95_ms": 33.3},
+    "relayout": {"p50_ms": 50.0, "p95_ms": 100.0},
+}
 
 
 def fields(line: str) -> dict[str, str]:
@@ -22,7 +28,8 @@ def fields(line: str) -> dict[str, str]:
 def expected_runs() -> set[tuple[str, str, str]]:
     expected = set()
     for width in WIDTHS:
-        expected.add(("sample.epub", "chapter", width))
+        if width == "700":
+            expected.add(("sample.epub", "chapter", width))
         expected.add(("sample.epub", "relayout", width))
         for fixture in FIXTURES:
             for action in ACTION_OPERATION:
@@ -77,6 +84,21 @@ def validate(content: str, requested_samples: int) -> None:
             raise ValueError(f"summary does not match run {key}: {summary}")
         if summary.get("samples") != expected_samples:
             raise ValueError(f"summary sample count does not match for {key}: {summary}")
+        budgets = OPERATION_BUDGETS_MS[expected_operation]
+        for metric, budget in budgets.items():
+            try:
+                value = float(summary.get(metric, ""))
+            except ValueError as error:
+                raise ValueError(
+                    f"summary has invalid {metric} for {key}: {summary.get(metric)!r}"
+                ) from error
+            if not math.isfinite(value) or value < 0:
+                raise ValueError(f"summary has invalid {metric} for {key}: {value}")
+            if value > budget:
+                raise ValueError(
+                    f"performance budget exceeded for {key}: "
+                    f"{metric}={value:g}ms budget={budget:g}ms"
+                )
 
     expected = expected_runs()
     if actual != expected:

crates/shosai-app/locales/en-US/main.ftl

@@ -138,6 +138,7 @@ add-first-books = ＋ Add your first books
 continue-reading = Continue reading
 search-results = Search results
 loading-more = Loading more…
+opening-document = Opening document…
 unknown-author = Unknown author
 not-started = Not started
 percent = { $percentage }%

crates/shosai-app/locales/ja/main.ftl

@@ -138,6 +138,7 @@ add-first-books = ＋ 最初の本を追加
 continue-reading = 読書を続ける
 search-results = 検索結果
 loading-more = さらに読み込み中…
+opening-document = ドキュメントを開いています…
 unknown-author = 著者不明
 not-started = 未読
 percent = { $percentage }%