pdfjs-reader-core 0.4.1 → 0.4.3

package/README.md

@@ -1105,12 +1105,15 @@ export function TutorScene({
   pdfUrl,
   bboxData,
   currentPage,
+  onPageChange,
   currentChunk,
   llm,
 }: {
   pdfUrl: string;
   bboxData: PageBBoxData[];
   currentPage: number;
+  /** Called when the viewer (or agent) changes the page — keep state in sync. */
+  onPageChange: (page: number) => void;
   /** The text the voice agent is currently speaking. Update reactively. */
   currentChunk: string | null;
   llm: LlmConfig;
@@ -1124,6 +1127,7 @@ export function TutorScene({
         <DocumentLoader url={pdfUrl} />
         <TutorModeContainer
           pageNumber={currentPage}
+          onPageChange={onPageChange}   // ← bidirectional sync for agent nav
           bboxData={bboxData}
           narrationStore={storeRef.current}
           scale={1}
@@ -1273,6 +1277,7 @@ default. Clicking it clears every overlay and returns the camera to fit-page.
 | `onExitTutorMode` | `() => void` | — | Optional callback fired AFTER the reset — use it to also leave tutor mode |
 | `backgroundColor` | `string` | `'#ffffff'` | Surround colour visible around the PDF when the viewport is larger than the page fit. v0.4.1+ |
 | `loadingComponent` | `ReactNode` | default spinner | Custom loading state shown while the PDF document/page is still fetching. v0.4.1+ |
+| `onPageChange` | `(page: number) => void` | — | Called when the viewer's page changes from any source (agent API, sidebar, programmatic). Pair with the `pageNumber` prop for bidirectional sync. **Required** when agents call `goToPage`/`nextPage`/`previousPage`. v0.4.2+ |
 | `className` | `string` | — | Passes through to the root container for custom theming |
 
 ### LlmConfig