From 43ee6312f206bda8ca8f854e981f496ce8e3cd00 Mon Sep 17 00:00:00 2001
From: Lester Caine <lester@lsces.co.uk>
Date: Tue, 16 Jun 2026 15:24:30 +0100
Subject: Document pdfjs findbar patch and add to icon/header notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 6b9492a..5592ce6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -89,6 +89,26 @@ separate included templates (matching the stock assembly pattern):
 - Do not use a separate `<div class="gallerybar">` or `<nav>` breadcrumb bar above the page;
   integrate breadcrumbs into `<small>` inside `<header>` instead
 
+## pdfjs local patch (themes/js/pdfjs-5.2.133/web/viewer.mjs)
+Standard pdfjs handles `#search=term` in the URL hash by highlighting matches silently but
+does NOT open the findbar UI. A local patch restores that behaviour. Find the block:
+
+```javascript
+if (params.has("search")) {
+    const query = params.get("search").replaceAll('"', ""),
+```
+
+And insert before the `this.eventBus.dispatch("findfromurlhash", ...)` call:
+
+```javascript
+if (query) {
+    PDFViewerApplication.findBar.open();
+    PDFViewerApplication.findBar.findField.value = query;
+}
+```
+
+**Re-apply this patch after any pdfjs version upgrade.**
+
 ## Icon sets (tango vs tango5)
 `util/iconsets/tango/` is the default iconset; `tango5/` is a richer superset. The `{biticon}`
 plugin searches the active style first, then falls back to `tango` — it does NOT fall back to
-- 
cgit v1.3