Add onAuxClick test page in View example and docsite entry

- Add MouseClickEventsExample to ViewExample.js with both a plain View
  and a Pressable target to verify onAuxClick fires and onPress does not
  on right-click
- Document onAuxClick in docsite view-events.md with event data spec
  and usage example
- Add button property to onDoubleClick event data docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Saadnajmi

docsite/api/view-events.md

@@ -126,6 +126,34 @@ Example:
 
 ---
 
+### `onAuxClick`
+
+Fired when the user clicks on the view with a non-primary button (e.g., right-click or middle-click). This follows the [W3C `auxclick` event](https://developer.mozilla.org/en-US/docs/Web/API/Element/auxclick_event) specification.
+
+**Event Data:** Mouse event with the following properties:
+- `clientX`: Horizontal position in the target view
+- `clientY`: Vertical position in the target view
+- `screenX`: Horizontal position in the window
+- `screenY`: Vertical position in the window
+- `altKey`: Whether Alt/Option key is pressed
+- `ctrlKey`: Whether Control key is pressed
+- `shiftKey`: Whether Shift key is pressed
+- `metaKey`: Whether Command key is pressed
+- `button`: The button number that was pressed (2 for right-click)
+
+Example:
+```javascript
+<View onAuxClick={(event) => {
+  console.log('Right clicked, button:', event.nativeEvent.button);
+}}>
+  <Text>Right click me</Text>
+</View>
+```
+
+> **Note:** Right-clicking a `Pressable` will fire `onAuxClick` but will **not** trigger `onPress`. Only primary (left) button clicks trigger `onPress`.
+
+---
+
 ### `onDoubleClick`
 
 Fired when the user double-clicks on the view.
@@ -139,6 +167,7 @@ Fired when the user double-clicks on the view.
 - `ctrlKey`: Whether Control key is pressed
 - `shiftKey`: Whether Shift key is pressed
 - `metaKey`: Whether Command key is pressed
+- `button`: The button number that was pressed (0 for left-click)
 
 Example:
 ```javascript

packages/rn-tester/js/examples/View/ViewExample.js

@@ -768,6 +768,106 @@ function FocusBlurExample(): React.Node {
   );
 }
 
+// [macOS
+function MouseClickEventsExample(): React.Node {
+  const [eventLog, setEventLog] = useState<Array<string>>([]);
+
+  const appendEvent = (eventName: string) => {
+    setEventLog(prev => [eventName, ...prev.slice(0, 19)]);
+  };
+
+  return (
+    <View>
+      <View
+        style={mouseClickStyles.targetBox}
+        onAuxClick={e => appendEvent(`auxClick (button=${e.nativeEvent.button})`)}
+        onDoubleClick={() => appendEvent('doubleClick')}
+        onMouseEnter={() => appendEvent('mouseEnter')}
+        onMouseLeave={() => appendEvent('mouseLeave')}>
+        <RNTesterText style={mouseClickStyles.targetText}>
+          Click Target
+        </RNTesterText>
+        <RNTesterText style={mouseClickStyles.hintText}>
+          Left-click, right-click, or double-click this box
+        </RNTesterText>
+      </View>
+      <Pressable
+        style={mouseClickStyles.pressableBox}
+        onAuxClick={e =>
+          appendEvent(`pressable auxClick (button=${e.nativeEvent.button})`)
+        }
+        onPress={() => appendEvent('pressable onPress')}
+        onDoubleClick={() => appendEvent('pressable doubleClick')}>
+        <RNTesterText style={mouseClickStyles.targetText}>
+          Pressable Target
+        </RNTesterText>
+        <RNTesterText style={mouseClickStyles.hintText}>
+          Right-click should fire auxClick but NOT onPress
+        </RNTesterText>
+      </Pressable>
+      <View style={mouseClickStyles.logBox}>
+        <RNTesterText style={mouseClickStyles.logHeader}>
+          Event Log:
+        </RNTesterText>
+        {eventLog.length === 0 ? (
+          <RNTesterText style={mouseClickStyles.logEntry}>
+            No events yet
+          </RNTesterText>
+        ) : (
+          eventLog.map((event, i) => (
+            <RNTesterText key={i} style={mouseClickStyles.logEntry}>
+              {event}
+            </RNTesterText>
+          ))
+        )}
+      </View>
+    </View>
+  );
+}
+
+const mouseClickStyles = StyleSheet.create({
+  targetBox: {
+    backgroundColor: '#527FE4',
+    borderRadius: 5,
+    padding: 20,
+    marginBottom: 10,
+    alignItems: 'center',
+  },
+  pressableBox: {
+    backgroundColor: '#7B61FF',
+    borderRadius: 5,
+    padding: 20,
+    marginBottom: 10,
+    alignItems: 'center',
+  },
+  targetText: {
+    color: 'white',
+    fontWeight: 'bold',
+    fontSize: 16,
+  },
+  hintText: {
+    color: 'rgba(255, 255, 255, 0.7)',
+    fontSize: 12,
+    marginTop: 4,
+  },
+  logBox: {
+    backgroundColor: '#f0f0f0',
+    borderRadius: 5,
+    padding: 10,
+    maxHeight: 200,
+  },
+  logHeader: {
+    fontWeight: 'bold',
+    marginBottom: 5,
+  },
+  logEntry: {
+    fontSize: 12,
+    fontFamily: Platform.OS === 'macos' ? 'Menlo' : 'monospace',
+    color: '#333',
+  },
+});
+// macOS]
+
 export default ({
   title: 'View',
   documentationURL: 'https://reactnative.dev/docs/view',
@@ -1437,5 +1537,11 @@ export default ({
       name: 'focus-blur',
       render: FocusBlurExample,
     },
+    {
+      title: 'Mouse Click Events',
+      name: 'mouse-click-events',
+      platform: 'macos',
+      render: MouseClickEventsExample,
+    },
   ],
 }: RNTesterModule);