@mintjamsinc/ichigojs 0.1.61 → 0.1.62

package/README.md

@@ -277,7 +277,27 @@ Event handling with modifiers:
 <div @click.stop="handleClick">Stop propagation</div>
 ```
 
-Supported modifiers: `.stop`, `.prevent`, `.capture`, `.self`, `.once`
+Event modifiers: `.stop`, `.prevent`, `.capture`, `.self`, `.once`
+
+Key modifiers (KeyboardEvent): `.enter`, `.tab`, `.delete` (matches Delete/Backspace), `.esc` / `.escape`, `.space`, `.up`, `.down`, `.left`, `.right`
+
+Mouse button modifiers (MouseEvent): `.left`, `.middle`, `.right`
+
+System modifier keys (KeyboardEvent and MouseEvent): `.shift`, `.ctrl`, `.alt`, `.meta`. Add `.exact` to require that no other system modifiers are held.
+
+```html
+<!-- Shift + Click -->
+<button @click.shift="onShiftClick">Shift+Click</button>
+
+<!-- Right-click without bringing up the browser menu -->
+<div @contextmenu.prevent="onMenu">Right-click me</div>
+
+<!-- Middle-click -->
+<a @mousedown.middle="onMiddleClick">Middle-click</a>
+
+<!-- Ctrl+Click only (no other modifiers held) -->
+<button @click.ctrl.exact="onCtrlClickOnly">Ctrl+Click only</button>
+```
 
 **Event Handlers with Context:**
 

package/dist/ichigo.cjs

@@ -11322,6 +11322,10 @@
      * The `v-on` directive supports event modifiers such as `.stop`, `.prevent`, `.capture`, `.self`, and `.once` to modify the behavior of the event listener.
      * For example, `v-on:click.stop="handleClick"` will stop the event from propagating up the DOM tree.
      *
+     * Key modifiers (KeyboardEvent): `.enter`, `.tab`, `.delete` (Delete/Backspace), `.esc` / `.escape`, `.space`, `.up`, `.down`, `.left`, `.right`.
+     * Mouse button modifiers (MouseEvent): `.left`, `.middle`, `.right`.
+     * System modifiers (KeyboardEvent and MouseEvent): `.shift`, `.ctrl`, `.alt`, `.meta`, plus `.exact` to require that no other system modifiers are held.
+     *
      * Additionally, this directive supports lifecycle hooks:
      *     @mount="onMount"       - Called before the VNode is mounted to the DOM element
      *     @mounted="onMounted"   - Called after the VNode is mounted to the DOM element
@@ -11514,14 +11518,14 @@
             const eventName = this.#eventName;
             const useCapture = this.#modifiers.has('capture');
             const isOnce = this.#modifiers.has('once');
+            // System modifier keys (held during the event) shared by KeyboardEvent and MouseEvent.
+            const systemModifiers = ['shift', 'ctrl', 'alt', 'meta'];
             // Create the event listener function
             this.#listener = (event) => {
-                // Check key modifiers for keyboard events
+                // Check key modifiers for keyboard events.
+                // The `.left` / `.right` aliases here mean ArrowLeft / ArrowRight; the same tokens
+                // map to mouse buttons further below, dispatched by event type to avoid ambiguity.
                 if (event instanceof KeyboardEvent) {
-                    // Map of modifier alias -> KeyboardEvent.key values it matches.
-                    // Multiple values allow a single modifier to match several physical keys
-                    // (e.g. `.delete` matches both Delete and Backspace, matching Vue's behavior).
-                    // Multiple aliases pointing to the same key are allowed (e.g. `.esc` / `.escape`).
                     const keyMap = {
                         'enter': ['Enter'],
                         'tab': ['Tab'],
@@ -11549,6 +11553,46 @@
                         }
                     }
                 }
+                // Check mouse button modifiers for mouse events.
+                // `.left` / `.middle` / `.right` map to MouseEvent.button values 0 / 1 / 2.
+                if (event instanceof MouseEvent) {
+                    const buttonMap = {
+                        'left': 0,
+                        'middle': 1,
+                        'right': 2
+                    };
+                    const hasButtonModifier = Object.keys(buttonMap).some(b => this.#modifiers.has(b));
+                    if (hasButtonModifier) {
+                        let buttonMatched = false;
+                        for (const [modifier, buttonValue] of Object.entries(buttonMap)) {
+                            if (this.#modifiers.has(modifier) && event.button === buttonValue) {
+                                buttonMatched = true;
+                                break;
+                            }
+                        }
+                        if (!buttonMatched) {
+                            return;
+                        }
+                    }
+                }
+                // Check system modifier keys (shift / ctrl / alt / meta) and `.exact`.
+                // These properties exist on both KeyboardEvent and MouseEvent.
+                if (event instanceof KeyboardEvent || event instanceof MouseEvent) {
+                    // Required system modifiers must be held.
+                    for (const mod of systemModifiers) {
+                        if (this.#modifiers.has(mod) && !event[`${mod}Key`]) {
+                            return;
+                        }
+                    }
+                    // `.exact` rejects events with extra system modifiers held that weren't listed.
+                    if (this.#modifiers.has('exact')) {
+                        for (const mod of systemModifiers) {
+                            if (event[`${mod}Key`] && !this.#modifiers.has(mod)) {
+                                return;
+                            }
+                        }
+                    }
+                }
                 // Apply event modifiers
                 if (this.#modifiers.has('stop')) {
                     event.stopPropagation();