Serve book outlines and segment pages from the host (#436)

AGENTS.md

@@ -52,7 +52,7 @@ This is a **Platform.Bible extension** for interlinear Bible text alignment. Pla
 
 [src/interlinearizer.web-view.tsx](src/interlinearizer.web-view.tsx) — entry point rendered inside Platform.Bible's WebView iframe; delegates to [InterlinearizerLoader](src/components/InterlinearizerLoader.tsx) when a `projectId` is present. `useWebViewScrollGroupScrRef` and `useWebViewState` are **props injected by the PAPI host** (not hook imports).
 
-[InterlinearizerLoader](src/components/InterlinearizerLoader.tsx) — real top of the React tree: owns modal state, persists the active interlinear project, fetches the tokenized book, and routes top-menu commands to the appropriate modal.
+[InterlinearizerLoader](src/components/InterlinearizerLoader.tsx) — real top of the React tree: owns modal state, persists the active interlinear project, fetches the tokenized book and its segment pages, and routes top-menu commands to the appropriate modal.
 
 [Interlinearizer](src/components/Interlinearizer.tsx) — renders the interlinear view from the loaded book data.
 

e2e-tests/tests/perf/app-perf.spec.ts

@@ -143,8 +143,8 @@ async function deleteLeftoverProjects(page: Page, projectId: string): Promise<vo
 }
 
 /**
- * Opens a fresh view on `book` and adds its load, the host's draft and book fetches included, to
- * `open`.
+ * Opens a fresh view on `book` and adds its load, the host's draft, book, outline and page fetches
+ * included, to `open`.
  */
 async function measureOpen(
   page: Page,
@@ -165,6 +165,11 @@ async function measureOpen(
   const hostEntries = await takeHostEntries(page);
   open.addHostCall(HOST_CALLS.getDraft, hostEntries, settled);
   open.addHostCall(HOST_CALLS.getTokenizedBook, hostEntries, settled);
+  open.addHostCall(HOST_CALLS.getBookOutline, hostEntries, settled);
+  // The first pages load side by side, so each is sampled without a transport to pair it with.
+  hostEntries
+    .filter(({ name }) => name === 'getSegments')
+    .forEach(({ duration }) => open.host.addValue('page-fetch', duration));
   const tokenizes = hostEntries.filter(({ name }) => name === 'getTokenizedBook:tokenize').length;
   if (tokenizes !== 1) console.warn(`Opening ${book} tokenized it ${tokenizes} times, not once`);
   await closeView(page);
@@ -272,7 +277,16 @@ async function measureTier(
     switchBook.add(
       // eslint-disable-next-line no-await-in-loop
       await waitForMeasure(frame, 'reanchor', tier.viewBook),
-      ['book-fetch', 'book-parse', 'reanchor', 'book-render'],
+      [
+        'book-fetch',
+        'book-parse',
+        'outline-fetch',
+        'outline-parse',
+        'page-fetch',
+        'page-parse',
+        'reanchor',
+        'book-render',
+      ],
     );
   }
   result.switchBook = switchBook.summary();

e2e-tests/tests/perf/view-driver.ts

@@ -32,6 +32,11 @@ export const HOST_CALLS = {
     command: 'getTokenizedBook',
     phasePrefixes: ['getTokenizedBook'],
   },
+  getBookOutline: {
+    measure: 'outline-fetch',
+    command: 'getBookOutline',
+    phasePrefixes: ['getBookOutline'],
+  },
   saveDraft: { measure: 'autosave', command: 'saveDraft', phasePrefixes: ['saveDraft'] },
   getProjectsForSource: {
     measure: 'projects-fetch',

perf/summary/cli.ts

@@ -92,6 +92,10 @@ const METRIC_LABELS: Record<string, string> = {
   tokenize: 'Tokenize book',
   'book-fetch': 'Fetch tokenized book',
   'book-parse': 'Parse tokenized book',
+  'outline-fetch': 'Fetch book outline',
+  'outline-parse': 'Parse book outline',
+  'page-fetch': 'Fetch a page of segments',
+  'page-parse': 'Parse a page of segments',
   'book-render': 'Book change to rendered',
   'draft-fetch': 'Fetch draft',
   'draft-parse': 'Parse draft',
@@ -122,6 +126,7 @@ const PHASE_LABELS: Record<string, string> = {
   read: 'read storage',
   usj: 'fetch USJ',
   tokenize: 'extract and tokenize',
+  resegment: 'segment by boundaries',
   parse: 'parse and validate',
   compare: 'split and compare shards',
   serialize: 'serialize reply',