Source Inspector: Shift+Cmd/Ctrl+Click shortcut conflicts with macOS screenshot (should be configurable)

[ethan-huo]

Problem

The Source Inspector ("Go to source") is triggered by Shift + Cmd (Meta) + Click, which is hardcoded in source-inspector.tsx:

const isShiftHeld = keys.includes('SHIFT')
const isCtrlHeld = keys.includes('CONTROL')
const isMetaHeld = keys.includes('META')
return isShiftHeld && (isCtrlHeld || isMetaHeld)

On macOS, Shift + Cmd + 4 is the system screenshot shortcut (region capture). When you press Shift + Cmd to start a screenshot, the Source Inspector immediately activates and highlights elements under the cursor — the highlight overlay ends up captured in the screenshot.

This is a pretty common workflow conflict since virtually every Mac user uses Shift+Cmd+4 regularly.

Proposed Solution

Make the Source Inspector modifier keys configurable via the Vite plugin options, e.g.:

devtools({
  injectSource: {
    enabled: true,
    modifierKeys: ['Alt', 'Shift'], // default: ['Shift', 'Meta'] or ['Shift', 'Control']
  },
})

The current hardcoded Shift + Meta/Ctrl default is fine, but users should be able to change it to avoid conflicts with OS-level shortcuts.

Environment

• macOS (Apple Silicon)
• @tanstack/devtools-vite
• Affects any Mac user who takes screenshots with Shift+Cmd+4

[github-actions]

Hi @ethan-huo, thanks for the detailed write-up! The conflict with macOS's Shift+Cmd+4 screenshot shortcut is a clear and well-explained issue, and the proposed configurable modifier keys solution makes a lot of sense.

Before we can triage this further, could you fill in a few details that are required by our bug report template?

1. TanStack Devtools version — Which exact version of @tanstack/devtools-vite are you using? (e.g. v0.x.x, not just "latest")
2. Framework/Library version — Which framework and version are you using? (e.g. React v18.3.1, Vue v3.5.0, etc.)
3. Minimal Reproducible Example — A CodeSandbox or Stackblitz link would help, though we understand this one is fairly straightforward to reproduce on any Mac.

Thanks!

[bensenescu]

Huge +1 on this ^^^^

I started this PR on it, but couldn't figure out how to reliably trigger the inspector with other hot keys on mac: bensenescu#1