feat: expose setZoom and getZoom API on SuperDoc

[tupizz]

Demo

CleanShot.2026-02-19.at.13.33.58.mp4

Summary

Add public methods to programmatically control zoom level on SuperDoc instances:

• setZoom(percent) - Set zoom level as a percentage (e.g., 150 for 150%)
• getZoom() - Get current zoom level as percentage
• zoomChange event - Emitted when zoom changes

This allows developers to implement custom zoom controls (e.g., Ctrl+scroll, pinch-to-zoom, custom UI buttons) without relying on the toolbar.

Implementation

Both setZoom and getZoom go through superdocStore.activeZoom — the same centralized state used by the toolbar's zoom dropdown. The Vue watcher on activeZoom propagates changes to all downstream systems:

• PresentationEditor.setGlobalZoom() — all editors
• pdfViewer.updateScale() — PDF viewer
• Whiteboard page sizes/offsets

This ensures overlays, comment highlights, hit-testing, and PDF rendering all stay in sync with the zoom level.

Usage

const superdoc = new SuperDoc({
  selector: '#editor',
  document: file,
});

// Set zoom to 150%
superdoc.setZoom(150);

// Get current zoom
const zoom = superdoc.getZoom(); // Returns 100, 150, etc.

// Listen for zoom changes
superdoc.on('zoomChange', ({ zoom }) => {
  console.log(`Zoom changed to ${zoom}%`);
});

// Example: Ctrl+scroll zoom
window.addEventListener('wheel', (event) => {
  if (event.ctrlKey) {
    event.preventDefault();
    const currentZoom = superdoc.getZoom();
    const delta = event.deltaY > 0 ? -10 : 10;
    superdoc.setZoom(Math.max(25, Math.min(400, currentZoom + delta)));
  }
}, { passive: false });

Test plan

• setZoom(150) updates superdocStore.activeZoom to 150
• getZoom() returns current activeZoom from store
• getZoom() reflects value set by setZoom() (round-trip)
• zoomChange event fires with correct payload
• Invalid values (negative, NaN, zero, Infinity, string) warn and don't update
• Programmatic API uses the same store path as toolbar zoom
• Dev app has zoom +/- buttons for manual testing

References

• Linear: SD-1221 — Add public setZoom and getZoom methods to SuperDoc API

Closes #928
Closes SD-1221

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[Copilot]

Pull request overview

This PR adds programmatic zoom control to SuperDoc by exposing setZoom() and getZoom() public API methods, along with a zoomChange event. This enables developers to implement custom zoom controls (e.g., keyboard shortcuts, custom UI buttons, gesture controls) without relying on the built-in toolbar.

• Adds getZoom() method to retrieve current zoom level as a percentage
• Adds setZoom(percent) method to programmatically set zoom level for all documents
• Emits zoomChange event when zoom is changed programmatically

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[tupizz]

@edoversb 🙏🏻

[andrii-harbour]

LGTM!

[harbournick]

LGTM

[harbournick]

merged via #2137