NSX Service Manual Navigator — AGENTS.md

Scope

Build a browser-based PDF navigator using PDF.js. Each PDF has a JSON sidecar describing interactive buttons extracted via mutool. The app overlays clickable regions and performs GoTo / GoToR navigation.

Architecture

• viewer.html loads PDF.js
• hash param selects file: viewer.html#NS9705MAINIDX.pdf
• load sidecar: NS9705MAINIDX.json
• render PDF page to canvas
• overlay clickable divs using rect coordinates
• clicking performs navigation

Sidecar Format

{ "pages": { "1": [ { "rect": [x1,y1,x2,y2], "action": { "type": "GoToR", "file": "NS9705SRSWARN.pdf", "page": 0 } } ] } }

Supported Actions

Implement only:

• GoTo (same file page jump)
• GoToR (load different PDF + page)

Ignore:

• JavaScript
• Named destinations
• Zoom modes
• Fit options

Coordinate System

Rect coordinates are PDF-space. Convert to canvas space using viewport transform.

Example: left = rect[0] * scale top = (pageHeight - rect[3]) * scale width = (rect[2] - rect[0]) * scale height = (rect[3] - rect[1]) * scale

Navigation Rules

GoTo:

• same file
• set page number
• re-render

GoToR:

• update hash to target file
• load new PDF
• jump to page

Files Codex May Modify

• pdf-view.html
• viewer.js
• styles.css
• sidecar loader utilities

Files Codex Must Not Modify

• original PDF files
• generated JSON sidecars
• mutool extraction scripts

Acceptance Criteria

• viewer.html#NS9705MAINIDX.pdf loads correctly
• clickable areas appear
• clicking loads target PDF
• page jump works
• overlay aligns with buttons
• no dependencies besides PDF.js

Commands to Run

Serve locally:

python3 -m http.server

or

npx serve .

Implementation Notes

• use absolute positioned div overlay
• pointer-events enabled
• transparent background
• optional hover highlight

Non-Goals

• full PDF form support
• text selection
• search
• zoom UI
• mobile layout

Keep implementation minimal.