FE-594: Fix PDFDocumentProxy type mismatch in pdf-preview

[TimDiekmann]

🌟 What is the purpose of this PR?

Fix a tsc error in pdf-preview.tsx / pdf-search.tsx caused by PDFDocumentProxy type divergence between the hoisted pdfjs-dist and the version bundled inside react-pdf.

🔗 Related links

• FE-594

🚫 Blocked by

Nothing.

🔍 What does this change?

• Replaces import type { PDFDocumentProxy } from "pdfjs-dist" with DocumentCallback from react-pdf/dist/cjs/shared/types in both pdf-preview.tsx and pdf-search.tsx.
• DocumentCallback is react-pdf's own alias for PDFDocumentProxy, guaranteed to match its bundled pdfjs-dist version.
• pdfjs-dist was never a declared dependency of @apps/hash-frontend — the import only resolved via yarn hoisting. import/no-extraneous-dependencies didn't catch it because the rule is only scoped to test/storybook/config files in the base eslint config.

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• does not modify any publishable blocks or libraries, or modifications do not need publishing

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph

⚠️ Known issues

• pdfjs-dist is still not a declared dependency — TextItem in pdf-search.tsx still imports from pdfjs-dist/types/src/display/api (react-pdf v9 doesn't re-export it). Adding it explicitly or bumping to react-pdf v10 (which does re-export TextItem) are follow-up options.
• import/no-extraneous-dependencies is not active for regular source files in the base eslint config — only for tests, storybooks, and config files. This allowed the undeclared import to go unnoticed.

🐾 Next steps

• Consider adding pdfjs-dist as an explicit dependency pinned to react-pdf's version.
• Consider enabling import/no-extraneous-dependencies globally in the eslint base config.

🛡 What tests cover this?

• tsc --noEmit (the build would have failed without this fix)

❓ How to test this?

1. cd apps/hash-frontend && yarn lint:tsc
2. Confirm no errors in pdf-preview.tsx or pdf-search.tsx.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	Apr 16, 2026 11:59am

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
hashdotdesign	Ignored		Apr 16, 2026 11:59am
hashdotdesign-tokens	Ignored		Apr 16, 2026 11:59am
petrinaut	Skipped		Apr 16, 2026 11:59am

[cursor]

PR Summary

Low Risk
Type-only changes to align third-party library typings; no runtime logic changes beyond compile-time safety.

Overview
Fixes a TypeScript type mismatch introduced by the react-pdf upgrade by no longer importing PDFDocumentProxy from the hoisted pdfjs-dist.

pdf-preview.tsx and pdf-search.tsx now type the loaded PDF document as react-pdf’s DocumentCallback (including the PdfSearch prop and documentProxy state), aligning types with the pdfjs-dist version bundled inside react-pdf and unblocking tsc.

^{Reviewed by Cursor Bugbot for commit 83d9f4b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[augmentcode]

🤖 Augment PR Summary

Summary: Resolves a TypeScript type mismatch in the PDF preview/search components caused by divergent PDFDocumentProxy types between hoisted pdfjs-dist and the version used by react-pdf.
Change: Switches the document proxy types to DocumentCallback from react-pdf/dist/cjs/shared/types in pdf-preview.tsx and pdf-search.tsx to ensure they match react-pdf’s bundled PDF.js types.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

[alex-e-leon]

LGTM. Next steps sound great too.