@primitiv/input 0.19.0

package/LICENSE.txt

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Thomas Piquet (THP Software)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,9 @@
+# @primitiv/input
+
+> **Internal package** - This is an internal module of the [Primitiv Engine](https://primitivengine.com/).
+
+For documentation, examples, and guides, visit **[primitivengine.com](https://primitivengine.com/)**.
+
+## 📄 License
+
+Apache-2.0 - See [LICENSE.txt](./LICENSE.txt).

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var G=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var z=Object.prototype.hasOwnProperty;var V=(h,e)=>{for(var t in e)G(h,t,{get:e[t],enumerable:!0})},F=(h,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of J(e))!z.call(h,n)&&n!==t&&G(h,n,{get:()=>e[n],enumerable:!(s=W(e,n))||s.enumerable});return h};var U=h=>F(G({},"__esModule",{value:!0}),h);var N={};V(N,{BaseInputs:()=>f,GamepadInputs:()=>D,InputCollector:()=>O,InputRouter:()=>j,KeyboardInputs:()=>P,MobileVibration:()=>x,MotionInputs:()=>L,MouseInputs:()=>I,TouchInputs:()=>A,TouchZoneInputs:()=>B,VibrationPatterns:()=>y,getMobileVibration:()=>q});module.exports=U(N);var f=class{isActive=!1;targetElement;config;constructor(e=window,t={}){this.targetElement=e,this.config={enabled:!0,preventDefault:!1,stopPropagation:!1,debug:!1,...t}}isListening(){return this.isActive}destroy(){this.stop()}getTargetElement(){return this.targetElement}enable(){this.config.enabled=!0,this.isActive||this.start()}disable(){this.config.enabled=!1,this.isActive&&this.stop()}isEnabled(){return this.config.enabled??!0}};var r=require("@primitiv/types");var P=class extends f{keys={};textInputsThisFrame=[];keyboardCallbacks={};boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={keyDown:this.handleKeyDown.bind(this),keyUp:this.handleKeyUp.bind(this),blur:this.handleBlur.bind(this)}}start(){this.isActive||(this.targetElement.addEventListener("keydown",this.boundHandlers.keyDown),this.targetElement.addEventListener("keyup",this.boundHandlers.keyUp),window.addEventListener("blur",this.boundHandlers.blur),this.isActive=!0)}stop(){this.isActive&&(this.targetElement.removeEventListener("keydown",this.boundHandlers.keyDown),this.targetElement.removeEventListener("keyup",this.boundHandlers.keyUp),window.removeEventListener("blur",this.boundHandlers.blur),this.isActive=!1)}reset(){this.keys={},this.textInputsThisFrame=[]}resetDelta(){}poll(){for(let e in this.keys)this.keys[e].justPressed=!1,this.keys[e].justReleased=!1;this.textInputsThisFrame=[]}setCallbacks(e){this.keyboardCallbacks={...this.keyboardCallbacks,...e}}getTextInputs(){return this.textInputsThisFrame}isKeyPressed(e){return this.keys[e]?.pressed||!1}isKeyJustPressed(e){return this.keys[e]?.justPressed||!1}isKeyJustReleased(e){return this.keys[e]?.justReleased||!1}getKeysJustPressed(){let e=[];for(let t in this.keys)this.keys[t].justPressed&&e.push(t);return e}getKeysHeld(){let e=[];for(let t in this.keys)this.keys[t].pressed&&e.push(t);return e}shouldAllowDefault(e,t){let s=/^F([1-9]|1[0-2])$/.test(e),n=(t.ctrlKey||t.metaKey)&&(e==="KeyT"||e==="KeyW"||e==="KeyR"||e==="KeyN"||e==="Tab");return s||n}handleKeyDown(e){let t=e.code,s=this.shouldAllowDefault(t,e);this.config.preventDefault&&!s&&e.preventDefault(),this.config.stopPropagation&&!s&&e.stopPropagation(),this.keys[t]||(this.keys[t]={pressed:!1,justPressed:!1,justReleased:!1}),this.keys[t].pressed||(this.keys[t].justPressed=!0,this.keyboardCallbacks.onKeyDown?.(t,e)),this.keys[t].pressed=!0,this.keys[t].justReleased=!1;let n=e.key;n.length===1&&!e.ctrlKey&&!e.metaKey&&this.textInputsThisFrame.push(n)}handleKeyUp(e){let t=e.code,s=this.shouldAllowDefault(t,e);this.config.preventDefault&&!s&&e.preventDefault(),this.config.stopPropagation&&!s&&e.stopPropagation(),this.keys[t]||(this.keys[t]={pressed:!1,justPressed:!1,justReleased:!1}),this.keys[t].pressed&&(this.keys[t].justReleased=!0,this.keyboardCallbacks.onKeyUp?.(t,e)),this.keys[t].pressed=!1,this.keys[t].justPressed=!1}handleBlur(){this.reset()}};var T=require("@primitiv/types");var I=class h extends f{mouseButtons={left:{pressed:!1,justPressed:!1,justReleased:!1},middle:{pressed:!1,justPressed:!1,justReleased:!1},right:{pressed:!1,justPressed:!1,justReleased:!1}};mousePosition=new T.Vector2(0,0);mouseDelta=new T.Vector2(0,0);wheelDelta=0;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={mouseDown:this.handleMouseDown.bind(this),mouseUp:this.handleMouseUp.bind(this),mouseMove:this.handleMouseMove.bind(this),wheel:this.handleWheel.bind(this),contextMenu:this.handleContextMenu.bind(this),blur:this.handleBlur.bind(this)}}start(){this.isActive||(this.targetElement.addEventListener("mousedown",this.boundHandlers.mouseDown),this.targetElement.addEventListener("mouseup",this.boundHandlers.mouseUp),this.targetElement.addEventListener("mousemove",this.boundHandlers.mouseMove),this.targetElement.addEventListener("wheel",this.boundHandlers.wheel),this.targetElement.addEventListener("contextmenu",this.boundHandlers.contextMenu),window.addEventListener("blur",this.boundHandlers.blur),this.isActive=!0)}stop(){this.isActive&&(this.targetElement.removeEventListener("mousedown",this.boundHandlers.mouseDown),this.targetElement.removeEventListener("mouseup",this.boundHandlers.mouseUp),this.targetElement.removeEventListener("mousemove",this.boundHandlers.mouseMove),this.targetElement.removeEventListener("wheel",this.boundHandlers.wheel),this.targetElement.removeEventListener("contextmenu",this.boundHandlers.contextMenu),window.removeEventListener("blur",this.boundHandlers.blur),this.isActive=!1)}reset(){this.mouseButtons={left:{pressed:!1,justPressed:!1,justReleased:!1},middle:{pressed:!1,justPressed:!1,justReleased:!1},right:{pressed:!1,justPressed:!1,justReleased:!1}},this.mousePosition=new T.Vector2(0,0),this.mouseDelta=new T.Vector2(0,0),this.wheelDelta=0}poll(){this.mouseButtons.left.justPressed=!1,this.mouseButtons.left.justReleased=!1,this.mouseButtons.middle.justPressed=!1,this.mouseButtons.middle.justReleased=!1,this.mouseButtons.right.justPressed=!1,this.mouseButtons.right.justReleased=!1,this.resetDelta()}resetDelta(){this.mouseDelta=new T.Vector2(0,0),this.wheelDelta=0}isLeftMousePressed(){return this.mouseButtons.left.pressed}isLeftMouseJustPressed(){return this.mouseButtons.left.justPressed}isLeftMouseJustReleased(){return this.mouseButtons.left.justReleased}isRightMousePressed(){return this.mouseButtons.right.pressed}isRightMouseJustPressed(){return this.mouseButtons.right.justPressed}isRightMouseJustReleased(){return this.mouseButtons.right.justReleased}isMiddleMousePressed(){return this.mouseButtons.middle.pressed}getMousePosition(){return this.mousePosition.clone()}getMouseDelta(){return this.mouseDelta.clone()}getWheelDelta(){return this.wheelDelta}static BUTTON_NAMES=["left","middle","right"];handleMouseDown(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault();let t=h.BUTTON_NAMES[e.button];if(t){let s=this.mouseButtons[t];s.pressed||(s.justPressed=!0),s.pressed=!0,s.justReleased=!1}}handleMouseUp(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault();let t=h.BUTTON_NAMES[e.button];if(t){let s=this.mouseButtons[t];s.pressed&&(s.justReleased=!0),s.pressed=!1,s.justPressed=!1}}handleMouseMove(e){let t=new T.Vector2(e.clientX,e.clientY);this.mouseDelta=t.subtract(this.mousePosition),this.mousePosition=t}handleWheel(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault(),this.wheelDelta=e.deltaY}handleContextMenu(e){this.isInteractiveSurfaceEvent(e)&&e.preventDefault()}handleBlur(){this.reset()}isInteractiveSurfaceEvent(e){let t=e.target;return t?(t.tagName||"").toLowerCase()==="canvas"||(t.getAttribute?.("data-primitiv-input-surface")??"").toLowerCase()==="true"?!0:!!t.closest?.('canvas, [data-primitiv-input-surface="true"]'):!1}};var D=class extends f{gamepads=new Map;previousGameState=new Map;rafId=null;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={connected:this.handleGamepadConnected.bind(this),disconnected:this.handleGamepadDisconnected.bind(this)}}start(){this.isActive||(window.addEventListener("gamepadconnected",this.boundHandlers.connected),window.addEventListener("gamepaddisconnected",this.boundHandlers.disconnected),this.startPolling(),this.isActive=!0)}stop(){this.isActive&&(window.removeEventListener("gamepadconnected",this.boundHandlers.connected),window.removeEventListener("gamepaddisconnected",this.boundHandlers.disconnected),this.stopPolling(),this.isActive=!1)}startPolling(){let e=()=>{this.poll(),this.rafId=requestAnimationFrame(e)};this.rafId=requestAnimationFrame(e)}stopPolling(){this.rafId!==null&&(cancelAnimationFrame(this.rafId),this.rafId=null)}poll(){let e=navigator.getGamepads();for(let t=0;t<e.length;t++){let s=e[t];s&&this.updateGamepadState(s)}}reset(){this.gamepads.clear(),this.previousGameState.clear()}resetDelta(){this.previousGameState.clear();for(let[e,t]of this.gamepads)this.previousGameState.set(e,this.cloneState(t))}updateGamepadState(e){let t=this.gamepads.get(e.index),s=e.buttons.map((n,i)=>{let o=t?.buttons[i],a=n.pressed,l=o?.pressed??!1;return{pressed:a,justPressed:a&&!l,justReleased:!a&&l,value:n.value,touched:n.touched}});this.gamepads.set(e.index,{id:e.id,index:e.index,connected:e.connected,buttons:s,axes:[...e.axes],timestamp:e.timestamp,mapping:e.mapping})}isButtonPressed(e,t){return this.gamepads.get(e)?.buttons[t]?.pressed??!1}isButtonJustPressed(e,t){return this.gamepads.get(e)?.buttons[t]?.justPressed??!1}isButtonJustReleased(e,t){return this.gamepads.get(e)?.buttons[t]?.justReleased??!1}getAxis(e,t){let s=this.gamepads.get(e);return s?t===4?s.buttons[6]?.value??0:t===5?s.buttons[7]?.value??0:s.axes[t]??0:0}getButtonValue(e,t){return this.gamepads.get(e)?.buttons[t]?.value??0}vibrationPresets={tap:{duration:50,strongMagnitude:.3,weakMagnitude:.5},impact:{duration:100,strongMagnitude:.7,weakMagnitude:.3},heavy:{duration:200,strongMagnitude:1,weakMagnitude:.2},success:{duration:150,strongMagnitude:.4,weakMagnitude:.6},error:{duration:300,strongMagnitude:.8,weakMagnitude:.4},explosion:{duration:400,strongMagnitude:1,weakMagnitude:.8}};async vibrate(e,t){let s=navigator.getGamepads()[e];if(!s||!s.vibrationActuator)return!1;try{return await s.vibrationActuator.playEffect("dual-rumble",{startDelay:t.startDelay??0,duration:t.duration,strongMagnitude:t.strongMagnitude??1,weakMagnitude:t.weakMagnitude??1}),!0}catch{return!1}}async vibratePreset(e,t){return this.vibrate(e,this.vibrationPresets[t])}async vibrateAll(e){let t=Array.from(this.gamepads.keys()).map(s=>this.vibrate(s,e));await Promise.all(t)}async stopVibration(e){let t=navigator.getGamepads()[e];if(t&&t.vibrationActuator)try{await t.vibrationActuator.reset()}catch{}}handleGamepadConnected(e){this.updateGamepadState(e.gamepad)}handleGamepadDisconnected(e){this.gamepads.delete(e.gamepad.index),this.previousGameState.delete(e.gamepad.index)}cloneState(e){return{...e,buttons:e.buttons.map(t=>({...t})),axes:[...e.axes]}}};var A=class extends f{touches=new Map;nativeToInternal=new Map;maxTouches=10;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={touchStart:this.handleTouchStart.bind(this),touchEnd:this.handleTouchEnd.bind(this),touchMove:this.handleTouchMove.bind(this),touchCancel:this.handleTouchCancel.bind(this),visibilityChange:this.handleVisibilityChange.bind(this)}}start(){if(this.isActive)return;let e={passive:!this.config.preventDefault};this.targetElement.addEventListener("touchstart",this.boundHandlers.touchStart,e),this.targetElement.addEventListener("touchend",this.boundHandlers.touchEnd,e),this.targetElement.addEventListener("touchmove",this.boundHandlers.touchMove,e),this.targetElement.addEventListener("touchcancel",this.boundHandlers.touchCancel,e),document.addEventListener("visibilitychange",this.boundHandlers.visibilityChange),this.isActive=!0}stop(){this.isActive&&(this.targetElement.removeEventListener("touchstart",this.boundHandlers.touchStart),this.targetElement.removeEventListener("touchend",this.boundHandlers.touchEnd),this.targetElement.removeEventListener("touchmove",this.boundHandlers.touchMove),this.targetElement.removeEventListener("touchcancel",this.boundHandlers.touchCancel),document.removeEventListener("visibilitychange",this.boundHandlers.visibilityChange),this.isActive=!1)}poll(){let e=[];for(let[t,s]of this.touches)s.justReleased?e.push(t):(s.justPressed=!1,s.justReleased=!1);for(let t of e){let s=this.touches.get(t);s&&(this.nativeToInternal.delete(s.nativeId),this.touches.delete(t))}}reset(){this.touches.clear(),this.nativeToInternal.clear()}resetDelta(){}isTouchActive(e){return this.touches.get(e)?.active??!1}isTouchJustPressed(e){return this.touches.get(e)?.justPressed??!1}isTouchJustReleased(e){return this.touches.get(e)?.justReleased??!1}getTouchPosition(e){let t=this.touches.get(e);return t?{x:t.x,y:t.y}:null}getAllTouches(){return Array.from(this.touches.values()).filter(e=>e.active)}updateTouches(e){let t=new Set;for(let s=0;s<e.touches.length;s++){let n=e.touches[s],i=n.identifier;t.add(i);let o=this.nativeToInternal.get(i),a;if(o===void 0){if(this.touches.size>=this.maxTouches)continue;for(let c=0;c<this.maxTouches;c++)if(!this.touches.has(c)){o=c;break}if(o===void 0)continue;this.nativeToInternal.set(i,o),a=void 0}else a=this.touches.get(o);let l=!0,d=a?.active??!1;this.touches.set(o,{id:o,nativeId:i,active:l,justPressed:l&&!d,justReleased:!1,x:n.clientX,y:n.clientY,startX:a?.startX??n.clientX,startY:a?.startY??n.clientY})}for(let[s,n]of this.nativeToInternal)if(!t.has(s)){let i=this.touches.get(n);i&&i.active&&(i.active=!1,i.justReleased=!0)}}handleTouchStart(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchEnd(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchMove(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchCancel(e){this.handleTouchEnd(e)}handleVisibilityChange(){document.visibilityState==="hidden"&&this.reset()}};var B=class extends f{constructor(t,s){super(s.targetElement,s);this.touch=t;this.gridWidth=s.gridWidth,this.gridHeight=s.gridHeight,this.rendererOffsets=s.rendererOffsets??{offsetX:0,offsetY:0},s.zones&&this.setZones(s.zones)}zones=[];zoneStates=new Map;gridWidth;gridHeight;rendererOffsets;start(){this.isActive=!0}stop(){this.isActive=!1}reset(){this.clearZones()}resetDelta(){}setTargetElement(t){this.targetElement=t}setLayout(t,s,n){this.gridWidth=t,this.gridHeight=s,n&&(this.rendererOffsets=n)}setZones(t){this.zones=t.filter(s=>s.id>=0&&s.id<=31),this.zoneStates.clear();for(let s of this.zones)this.zoneStates.set(s.id,{pressed:!1,justPressed:!1,justReleased:!1,lastX:s.x,lastY:s.y})}clearZones(){this.zones=[],this.zoneStates.clear()}updateFromTouches(){if(this.zones.length===0)return;let t=this.targetElement,s=t.getBoundingClientRect(),{renderWidth:n,renderHeight:i,offsetX:o,offsetY:a}=this.calculateRenderMetrics(t,s),l=n/this.gridWidth,d=i/this.gridHeight,c=this.touch.getAllTouches(),v=new Set,g=new Map;for(let M of c){let p=M.x-s.left-o,b=M.y-s.top-a,E=Math.floor(p/l),w=Math.floor(b/d);for(let m of this.zones)E>=m.x&&E<m.x+m.width&&w>=m.y&&w<m.y+m.height&&(v.add(m.id),g.set(m.id,{x:Math.max(m.x,Math.min(m.x+m.width-1,E)),y:Math.max(m.y,Math.min(m.y+m.height-1,w))}))}for(let M of this.zones){let p=this.zoneStates.get(M.id);if(!p)continue;let b=v.has(M.id);b&&!p.pressed&&(p.justPressed=!0),!b&&p.pressed&&(p.justReleased=!0),p.pressed=b;let E=g.get(M.id);E&&(p.lastX=E.x,p.lastY=E.y)}}poll(){for(let t of this.zoneStates.values())t.justPressed=!1,t.justReleased=!1}isZonePressed(t){return this.zoneStates.get(t)?.pressed??!1}isZoneJustPressed(t){return this.zoneStates.get(t)?.justPressed??!1}isZoneJustReleased(t){return this.zoneStates.get(t)?.justReleased??!1}getZoneAxis(t,s){let n=this.zoneStates.get(t);if(!n||!n.pressed)return 0;let i=this.zones.find(o=>o.id===t);if(!i)return 0;if(s==="x"){let o=(i.width-1)/2,a=i.x+o;return o>0?(n.lastX-a)/o:0}else{let o=(i.height-1)/2,a=i.y+o;return o>0?(n.lastY-a)/o:0}}getZonePosition(t){let s=this.zoneStates.get(t);return s?{x:s.lastX,y:s.lastY}:null}calculateRenderMetrics(t,s){let n=t.width,i=t.height;if(!n||!i)return{renderWidth:s.width,renderHeight:s.height,offsetX:this.rendererOffsets.offsetX,offsetY:this.rendererOffsets.offsetY};let o=n/i,a=s.width/s.height,l,d,c,v;o>a?(l=s.width,d=s.width/o,c=0,v=(s.height-d)/2):(l=s.height*o,d=s.height,c=(s.width-l)/2,v=0);let g=this.rendererOffsets;return c+=g.offsetX,v+=g.offsetY,l-=g.offsetX*2,d-=g.offsetY*2,{renderWidth:l,renderHeight:d,offsetX:c,offsetY:v}}};var Z=require("@primitiv/types");var L=class extends f{accelerometer={x:0,y:0,z:0,includesGravity:!1,timestamp:0};gyroscope={alpha:0,beta:0,gamma:0,timestamp:0};orientation={alpha:null,beta:null,gamma:null,absolute:!1,timestamp:0};smoothedAccel={x:0,y:0,z:0};smoothedGyro={alpha:0,beta:0,gamma:0};smoothedOrientation={alpha:0,beta:0,gamma:0};smoothedTiltX=0;smoothedTiltY=0;calibrationOffset={alpha:0,beta:0,gamma:0};isCalibrated=!1;motionCallbacks={};motionConfig;permissionGranted=!1;smoothingFactor=.85;hasReceivedMotion=!1;hasReceivedOrientation=!1;boundHandlers;constructor(e=window,t={}){super(e,t),this.motionConfig={targetElement:e,includeGravity:t.includeGravity??!0,threshold:t.threshold??.001,autoRequestPermission:t.autoRequestPermission??!1,enabled:t.enabled??!0,debug:t.debug??!1,preventDefault:t.preventDefault??!1,stopPropagation:t.stopPropagation??!1,smoothing:t.smoothing??.85,useAbsoluteOrientation:t.useAbsoluteOrientation??!0},this.smoothingFactor=this.motionConfig.smoothing,this.boundHandlers={devicemotion:this.handleDeviceMotion.bind(this),deviceorientation:this.handleDeviceOrientation.bind(this),deviceorientationabsolute:this.handleDeviceOrientationAbsolute.bind(this)}}async requestPermission(){let e=!0,t=!0;if(typeof DeviceMotionEvent.requestPermission=="function")try{e=await DeviceMotionEvent.requestPermission()==="granted"}catch{e=!1}if(typeof DeviceOrientationEvent.requestPermission=="function")try{t=await DeviceOrientationEvent.requestPermission()==="granted"}catch{t=!1}return this.permissionGranted=e&&t,this.permissionGranted}isPermissionGranted(){return this.permissionGranted}isReceivingMotion(){return this.hasReceivedMotion}isReceivingOrientation(){return this.hasReceivedOrientation}start(){this.isActive||(window.addEventListener("devicemotion",this.boundHandlers.devicemotion),this.motionConfig.useAbsoluteOrientation&&window.addEventListener("deviceorientationabsolute",this.boundHandlers.deviceorientationabsolute),window.addEventListener("deviceorientation",this.boundHandlers.deviceorientation),this.isActive=!0)}stop(){this.isActive&&(window.removeEventListener("devicemotion",this.boundHandlers.devicemotion),window.removeEventListener("deviceorientation",this.boundHandlers.deviceorientation),window.removeEventListener("deviceorientationabsolute",this.boundHandlers.deviceorientationabsolute),this.isActive=!1)}setCallbacks(e){this.motionCallbacks={...this.motionCallbacks,...e}}poll(){}reset(){this.accelerometer={x:0,y:0,z:0,includesGravity:!1,timestamp:0},this.gyroscope={alpha:0,beta:0,gamma:0,timestamp:0},this.orientation={alpha:null,beta:null,gamma:null,absolute:!1,timestamp:0},this.smoothedAccel={x:0,y:0,z:0},this.smoothedGyro={alpha:0,beta:0,gamma:0},this.smoothedOrientation={alpha:0,beta:0,gamma:0},this.smoothedTiltX=0,this.smoothedTiltY=0,this.hasReceivedMotion=!1,this.hasReceivedOrientation=!1}resetDelta(){}calibrate(){this.orientation.beta!==null&&this.orientation.gamma!==null&&(this.calibrationOffset={alpha:this.orientation.alpha??0,beta:this.orientation.beta,gamma:this.orientation.gamma},this.isCalibrated=!0)}clearCalibration(){this.calibrationOffset={alpha:0,beta:0,gamma:0},this.isCalibrated=!1}getIsCalibrated(){return this.isCalibrated}getAccelerometer(){return{...this.smoothedAccel,includesGravity:this.motionConfig.includeGravity,timestamp:this.accelerometer.timestamp}}getGyroscope(){return{...this.smoothedGyro,timestamp:this.gyroscope.timestamp}}getOrientation(){let e=this.smoothedOrientation.alpha,t=this.smoothedOrientation.beta-(this.isCalibrated?this.calibrationOffset.beta:0),s=this.smoothedOrientation.gamma-(this.isCalibrated?this.calibrationOffset.gamma:0);return{alpha:this.orientation.alpha!==null?e:null,beta:this.orientation.beta!==null?t:null,gamma:this.orientation.gamma!==null?s:null,absolute:this.orientation.absolute,timestamp:this.orientation.timestamp}}getRawAccelerometer(){return{...this.accelerometer}}getRawGyroscope(){return{...this.gyroscope}}getRawOrientation(){return{...this.orientation}}getNormalizedTilt(){let e=this.smoothedTiltX,t=this.smoothedTiltY;return this.isCalibrated&&(e-=this.calibrationOffset.gamma/90,t-=this.calibrationOffset.beta/90,e=Math.max(-1,Math.min(1,e)),t=Math.max(-1,Math.min(1,t))),new Z.Vector2(e,t)}getCompassHeading(){return this.orientation.alpha===null?null:this.smoothedOrientation.alpha}setSmoothing(e){this.smoothingFactor=Math.max(0,Math.min(.99,e))}lowPass(e,t){return e*this.smoothingFactor+t*(1-this.smoothingFactor)}lowPassAngle(e,t,s=360){let n=t-e;n>s/2&&(n-=s),n<-s/2&&(n+=s);let i=e+n*(1-this.smoothingFactor);for(;i<0;)i+=s;for(;i>=s;)i-=s;return i}handleDeviceMotion(e){let t=performance.now(),s=this.motionConfig.includeGravity?e.accelerationIncludingGravity:e.acceleration;if(s&&(s.x!==null||s.y!==null||s.z!==null)){this.hasReceivedMotion=!0;let i=s.x??0,o=s.y??0,a=s.z??0;this.accelerometer={x:i,y:o,z:a,includesGravity:this.motionConfig.includeGravity,timestamp:t},this.smoothedAccel={x:this.lowPass(this.smoothedAccel.x,i),y:this.lowPass(this.smoothedAccel.y,o),z:this.lowPass(this.smoothedAccel.z,a)},this.motionCallbacks.onAccelerometer?.(this.getAccelerometer())}let n=e.rotationRate;if(n&&(n.alpha!==null||n.beta!==null||n.gamma!==null)){let i=n.alpha??0,o=n.beta??0,a=n.gamma??0;this.gyroscope={alpha:i,beta:o,gamma:a,timestamp:t},this.smoothedGyro={alpha:this.lowPass(this.smoothedGyro.alpha,i),beta:this.lowPass(this.smoothedGyro.beta,o),gamma:this.lowPass(this.smoothedGyro.gamma,a)},this.motionCallbacks.onGyroscope?.(this.getGyroscope())}}handleDeviceOrientation(e){this.motionConfig.useAbsoluteOrientation&&this.orientation.absolute||this.processOrientationEvent(e,!1)}handleDeviceOrientationAbsolute(e){this.processOrientationEvent(e,!0)}processOrientationEvent(e,t){let s=performance.now();if(e.alpha===null&&e.beta===null&&e.gamma===null)return;this.hasReceivedOrientation=!0;let n=e.alpha??0,i=e.beta??0,o=e.gamma??0;this.orientation={alpha:e.alpha,beta:e.beta,gamma:e.gamma,absolute:t||e.absolute,timestamp:s},this.smoothedOrientation.alpha=this.lowPassAngle(this.smoothedOrientation.alpha,n,360),this.smoothedOrientation.beta=this.lowPass(this.smoothedOrientation.beta,i),this.smoothedOrientation.gamma=this.lowPass(this.smoothedOrientation.gamma,o),this.smoothedTiltX=this.lowPass(this.smoothedTiltX,Math.max(-1,Math.min(1,o/90))),this.smoothedTiltY=this.lowPass(this.smoothedTiltY,Math.max(-1,Math.min(1,Math.max(-90,Math.min(90,i))/90))),this.motionCallbacks.onOrientation?.(this.getOrientation())}};var y={tap:10,mediumTap:25,heavyTap:50,success:[30,50,30],error:[50,30,50,30,50],warning:[100],selection:5,impactLight:15,impactMedium:30,impactHeavy:50,notification:[100,100,100,100,100],sos:[100,30,100,30,100,30,200,30,200,30,200,30,100,30,100,30,100]},x=class{enabled;intensity;supported;userActivated=!1;constructor(e={}){this.enabled=e.enabled??!0,this.intensity=Math.max(0,Math.min(1,e.intensity??1)),this.supported=typeof navigator<"u"&&typeof navigator.vibrate=="function"}isSupported(){return this.supported}isEnabled(){return this.enabled&&this.supported}setEnabled(e){this.enabled=e}setIntensity(e){this.intensity=Math.max(0,Math.min(1,e))}getIntensity(){return this.intensity}hasUserActivation(){return this.userActivated}vibrate(e){if(!this.isEnabled())return!1;let t=this.scalePattern(e),s=navigator.vibrate(t);return s&&(this.userActivated=!0),s}cancel(){this.supported&&navigator.vibrate(0)}tap(){return this.vibrate(y.tap)}mediumTap(){return this.vibrate(y.mediumTap)}heavyTap(){return this.vibrate(y.heavyTap)}success(){return this.vibrate(y.success)}error(){return this.vibrate(y.error)}warning(){return this.vibrate(y.warning)}selection(){return this.vibrate(y.selection)}impactLight(){return this.vibrate(y.impactLight)}impactMedium(){return this.vibrate(y.impactMedium)}impactHeavy(){return this.vibrate(y.impactHeavy)}notification(){return this.vibrate(y.notification)}scalePattern(e){return this.intensity===1?e:typeof e=="number"?Math.round(e*this.intensity):e.map((t,s)=>s%2===0?Math.round(t*this.intensity):t)}},S=null;function q(h){return S||(S=new x(h)),S}var j=class{keyboard=null;mouse=null;gamepad=null;touch=null;touchZone=null;motion=null;vibration=null;config;constructor(e={}){this.config={enableKeyboardMouse:e.enableKeyboardMouse??!0,enableGamepad:e.enableGamepad??!0,enableTouch:e.enableTouch??!0,targetElement:e.targetElement??window,gridWidth:e.gridWidth??80,gridHeight:e.gridHeight??25,debug:e.debug??!1},this.initialize()}initialize(){let e=this.config.targetElement;if(this.config.enableKeyboardMouse&&(this.keyboard=new P(e),this.mouse=new I(e)),this.config.enableGamepad&&(this.gamepad=new D(e)),this.config.enableTouch){this.touch=new A(e);let t=e instanceof Window?document.body:e;this.touchZone=new B(this.touch,{targetElement:t,gridWidth:this.config.gridWidth,gridHeight:this.config.gridHeight}),this.motion=new L(e),this.vibration=new x}this.start()}getButton(e,t){switch(e){case r.InputDeviceType.Keyboard:return this.keyboard?.isKeyPressed(r.KeyboardInput[t])??!1;case r.InputDeviceType.Mouse:return this.getMouseButton(t);case r.InputDeviceType.Gamepad:return this.gamepad?.isButtonPressed(0,t)??!1;case r.InputDeviceType.Touch:return this.touch?.isTouchActive(t)??!1;case r.InputDeviceType.TouchZone:return this.touchZone?.isZonePressed(t)??!1;default:return!1}}getButtonJustPressed(e,t){switch(e){case r.InputDeviceType.Keyboard:return this.keyboard?.isKeyJustPressed(r.KeyboardInput[t])??!1;case r.InputDeviceType.Mouse:return this.getMouseButtonJustPressed(t);case r.InputDeviceType.Gamepad:return this.gamepad?.isButtonJustPressed(0,t)??!1;case r.InputDeviceType.Touch:return this.touch?.isTouchJustPressed?.(t)??!1;case r.InputDeviceType.TouchZone:return this.touchZone?.isZoneJustPressed(t)??!1;default:return!1}}getButtonJustReleased(e,t){switch(e){case r.InputDeviceType.Keyboard:return this.keyboard?.isKeyJustReleased(r.KeyboardInput[t])??!1;case r.InputDeviceType.Mouse:return this.getMouseButtonJustReleased(t);case r.InputDeviceType.Gamepad:return this.gamepad?.isButtonJustReleased(0,t)??!1;case r.InputDeviceType.Touch:return this.touch?.isTouchJustReleased?.(t)??!1;case r.InputDeviceType.TouchZone:return this.touchZone?.isZoneJustReleased(t)??!1;default:return!1}}getAxis(e,t){switch(e){case r.InputDeviceType.Mouse:return this.getMouseAxis(t);case r.InputDeviceType.Gamepad:return this.gamepad?.getAxis(0,t-100)??0;case r.InputDeviceType.Touch:return this.getTouchAxis(t);case r.InputDeviceType.TouchZone:return this.getTouchZoneAxis(t);case r.InputDeviceType.Motion:return this.getMotionAxis(t);default:return 0}}getButtonValue(e,t){return e===r.InputDeviceType.Gamepad?this.gamepad?.getButtonValue(0,t)??0:this.getButton(e,t)?1:0}isLeftMousePressed(){return this.mouse?.isLeftMousePressed()??!1}getTextInputs(){return this.keyboard?.getTextInputs()??[]}getMouseButton(e){return this.mouse?e===r.MouseInput.LeftButton?this.mouse.isLeftMousePressed():e===r.MouseInput.RightButton?this.mouse.isRightMousePressed():e===r.MouseInput.MiddleButton?this.mouse.isMiddleMousePressed():!1:!1}getMouseButtonJustPressed(e){return this.mouse?e===r.MouseInput.LeftButton?this.mouse.isLeftMouseJustPressed():e===r.MouseInput.RightButton?this.mouse.isRightMouseJustPressed():!1:!1}getMouseButtonJustReleased(e){return this.mouse?e===r.MouseInput.LeftButton?this.mouse.isLeftMouseJustReleased():e===r.MouseInput.RightButton?this.mouse.isRightMouseJustReleased():!1:!1}getMouseAxis(e){return this.mouse?e===r.MouseInput.PositionX?this.mouse.getMousePosition().x:e===r.MouseInput.PositionY?this.mouse.getMousePosition().y:e===r.MouseInput.DeltaX?this.mouse.getMouseDelta().x:e===r.MouseInput.DeltaY?this.mouse.getMouseDelta().y:e===r.MouseInput.WheelDeltaY?this.mouse.getWheelDelta():0:0}getTouchAxis(e){if(!this.touch)return 0;if(e>=100&&e<200){let t=Math.floor((e-100)/2),s=(e-100)%2===1,n=this.touch.getTouchPosition(t);return n?s?n.y:n.x:0}return 0}getTouchZoneAxis(e){if(!this.touchZone)return 0;if(e>=100&&e<200){let t=Math.floor((e-100)/2),s=(e-100)%2===1;return this.touchZone.getZoneAxis(t,s?"y":"x")}return 0}getMotionAxis(e){if(!this.motion)return 0;switch(e){case r.MotionInput.AccelerometerX:return this.motion.getAccelerometer().x;case r.MotionInput.AccelerometerY:return this.motion.getAccelerometer().y;case r.MotionInput.AccelerometerZ:return this.motion.getAccelerometer().z;case r.MotionInput.GyroscopeAlpha:return this.motion.getGyroscope().alpha;case r.MotionInput.GyroscopeBeta:return this.motion.getGyroscope().beta;case r.MotionInput.GyroscopeGamma:return this.motion.getGyroscope().gamma;case r.MotionInput.OrientationAlpha:return this.motion.getOrientation().alpha??0;case r.MotionInput.OrientationBeta:return this.motion.getOrientation().beta??0;case r.MotionInput.OrientationGamma:return this.motion.getOrientation().gamma??0;case r.MotionInput.TiltX:return this.motion.getNormalizedTilt().x;case r.MotionInput.TiltY:return this.motion.getNormalizedTilt().y;case r.MotionInput.CompassHeading:return this.motion.getCompassHeading()??0;default:return 0}}getMotion(){return this.motion}getVibration(){return this.vibration}getMouseGridX(){if(!this.mouse)return 0;let e=this.mouse.getMousePosition().x,t=this.config.targetElement,s,n;if(t instanceof Window)s=t.innerWidth,n=0;else{let i=t.getBoundingClientRect();s=i.width,n=i.left}return s===0?0:Math.floor((e-n)/s*this.config.gridWidth)}getMouseGridY(){if(!this.mouse)return 0;let e=this.mouse.getMousePosition().y,t=this.config.targetElement,s,n;if(t instanceof Window)s=t.innerHeight,n=0;else{let i=t.getBoundingClientRect();s=i.height,n=i.top}return s===0?0:Math.floor((e-n)/s*this.config.gridHeight)}isMouseButtonDown(e){return this.mouse?e===0?this.mouse.isLeftMousePressed():e===1?this.mouse.isMiddleMousePressed():e===2?this.mouse.isRightMousePressed():!1:!1}getKeysPressed(){return this.keyboard?.getKeysJustPressed()??[]}getKeysHeld(){return this.keyboard?.getKeysHeld()??[]}setTouchZones(e){this.touchZone&&this.touchZone.setZones(e.map(t=>({id:t.zoneId,x:t.x,y:t.y,width:t.width,height:t.height})))}setTouchLayout(e,t,s,n){this.touchZone&&(this.touchZone.setTargetElement(e),this.touchZone.setLayout(t,s,n))}start(){this.keyboard?.start(),this.mouse?.start(),this.gamepad?.start(),this.touch?.start(),this.touchZone?.start(),this.motion?.start()}stop(){this.keyboard?.stop(),this.mouse?.stop(),this.gamepad?.stop(),this.touch?.stop(),this.touchZone?.stop(),this.motion?.stop()}reset(){this.keyboard?.reset(),this.mouse?.reset(),this.gamepad?.reset(),this.touch?.reset(),this.touchZone?.reset(),this.motion?.reset()}poll(){this.keyboard?.poll(),this.mouse?.poll(),this.gamepad?.poll(),this.touchZone?.poll(),this.touch?.poll(),this.touchZone?.updateFromTouches(),this.motion?.poll()}resetDelta(){this.keyboard?.resetDelta(),this.mouse?.resetDelta(),this.gamepad?.resetDelta(),this.touch?.resetDelta(),this.touchZone?.resetDelta(),this.motion?.resetDelta()}destroy(){this.stop(),this.keyboard?.destroy(),this.mouse?.destroy(),this.gamepad?.destroy(),this.touch?.destroy(),this.touchZone?.destroy(),this.motion?.destroy()}};var u=require("@primitiv/types"),O=class h{static calculateRenderMetrics(e,t){let s=e.getBoundingClientRect(),n=e.width/e.height,i=s.width/s.height,o,a,l,d;n>i?(o=s.width,a=s.width/n,l=0,d=(s.height-a)/2):(o=s.height*n,a=s.height,l=(s.width-o)/2,d=0);let c=t?.offsetX||0,v=t?.offsetY||0;return l+=c,d+=v,o-=c*2,a-=v*2,{renderWidth:o,renderHeight:a,offsetX:l,offsetY:d,rect:s}}static collectAxisSources(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=0,a=!1;if(i.type===u.InputDeviceType.Keyboard&&i.negativeKey!==void 0&&i.positiveKey!==void 0){let l=t.getButton(u.InputDeviceType.Keyboard,i.negativeKey);t.getButton(u.InputDeviceType.Keyboard,i.positiveKey)&&(o+=1),l&&(o-=1),a=!0}else if(i.type===u.InputDeviceType.Mouse&&i.mouseAxis!==void 0)o=t.getAxis(u.InputDeviceType.Mouse,i.mouseAxis),a=!0;else if(i.type===u.InputDeviceType.Gamepad&&i.axis!==void 0)o=t.getAxis(u.InputDeviceType.Gamepad,i.axis),a=!0;else if(i.type===u.InputDeviceType.Touch&&i.touchId!==void 0&&i.touchAxis!==void 0){let l=100+i.touchId*2,d=i.touchAxis==="x"?l:l+1;o=t.getAxis(u.InputDeviceType.Touch,d),a=!0}else if(i.type===u.InputDeviceType.TouchZone&&i.touchZoneId!==void 0&&i.touchZoneAxis!==void 0){let l=100+i.touchZoneId*2,d=i.touchZoneAxis==="x"?l:l+1;o=t.getAxis(u.InputDeviceType.TouchZone,d),a=!0}else i.type===u.InputDeviceType.Motion&&i.motionAxis!==void 0&&(o=t.getAxis(u.InputDeviceType.Motion,i.motionAxis),a=!0);a&&s.set(i.sourceId,o)}return s}static collectButtonSources(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=!1,a=!1;i.type===u.InputDeviceType.Keyboard&&i.key!==void 0?(o=t.getButton(u.InputDeviceType.Keyboard,i.key),a=!0):i.type===u.InputDeviceType.Mouse&&i.mouseButton!==void 0?(o=t.getButton(u.InputDeviceType.Mouse,i.mouseButton),a=!0):i.type===u.InputDeviceType.Gamepad&&i.button!==void 0?(o=t.getButton(u.InputDeviceType.Gamepad,i.button),a=!0):i.type===u.InputDeviceType.Touch&&i.touchButton!==void 0?(o=t.getButton(u.InputDeviceType.Touch,i.touchButton),a=!0):i.type===u.InputDeviceType.TouchZone&&i.touchZoneId!==void 0&&(o=t.getButton(u.InputDeviceType.TouchZone,i.touchZoneId),a=!0),a&&s.set(i.sourceId,o)}return s}static collectButtonSourcesWithTransitions(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=!1,a=!1,l=!1,d=!1;i.type===u.InputDeviceType.Keyboard&&i.key!==void 0?(o=t.getButton(u.InputDeviceType.Keyboard,i.key),a=t.getButtonJustPressed(u.InputDeviceType.Keyboard,i.key),l=t.getButtonJustReleased(u.InputDeviceType.Keyboard,i.key),d=!0):i.type===u.InputDeviceType.Mouse&&i.mouseButton!==void 0?(o=t.getButton(u.InputDeviceType.Mouse,i.mouseButton),a=t.getButtonJustPressed(u.InputDeviceType.Mouse,i.mouseButton),l=t.getButtonJustReleased(u.InputDeviceType.Mouse,i.mouseButton),d=!0):i.type===u.InputDeviceType.Gamepad&&i.button!==void 0?(o=t.getButton(u.InputDeviceType.Gamepad,i.button),a=t.getButtonJustPressed(u.InputDeviceType.Gamepad,i.button),l=t.getButtonJustReleased(u.InputDeviceType.Gamepad,i.button),d=!0):i.type===u.InputDeviceType.Touch&&i.touchButton!==void 0?(o=t.getButton(u.InputDeviceType.Touch,i.touchButton),a=t.getButtonJustPressed(u.InputDeviceType.Touch,i.touchButton),l=t.getButtonJustReleased(u.InputDeviceType.Touch,i.touchButton),d=!0):i.type===u.InputDeviceType.TouchZone&&i.touchZoneId!==void 0&&(o=t.getButton(u.InputDeviceType.TouchZone,i.touchZoneId),a=t.getButtonJustPressed(u.InputDeviceType.TouchZone,i.touchZoneId),l=t.getButtonJustReleased(u.InputDeviceType.TouchZone,i.touchZoneId),d=!0),d&&s.set(i.sourceId,{pressed:o,justPressed:a,justReleased:l})}return s}static collectMousePosition(e,t,s,n,i){let o=e.getAxis(u.InputDeviceType.Mouse,100),a=e.getAxis(u.InputDeviceType.Mouse,101),l=e.getButton(u.InputDeviceType.Mouse,0),{renderWidth:d,renderHeight:c,offsetX:v,offsetY:g,rect:M}=h.calculateRenderMetrics(t,i),p=o-M.left-v,b=a-M.top-g,E=d/s,w=c/n,m=Math.floor(p/E),R=Math.floor(b/w),H=p>=0&&p<d&&b>=0&&b<c;return{x:Math.max(0,Math.min(s-1,m)),y:Math.max(0,Math.min(n-1,R)),over:H,isLeftDown:l}}static collectTouchPositions(e,t,s,n,i=10,o){let a=[],{renderWidth:l,renderHeight:d,offsetX:c,offsetY:v,rect:g}=h.calculateRenderMetrics(t,o),M=l/s,p=d/n;for(let b=0;b<i;b++)if(e.getButton(u.InputDeviceType.Touch,b)){let w=100+b*2,m=100+b*2+1,R=e.getAxis(u.InputDeviceType.Touch,w),H=e.getAxis(u.InputDeviceType.Touch,m),C=R-g.left-c,k=H-g.top-v,K=Math.floor(C/M),Y=Math.floor(k/p),X=C>=0&&C<l&&k>=0&&k<d;a.push({id:b,x:Math.max(0,Math.min(s-1,K)),y:Math.max(0,Math.min(n-1,Y)),over:X})}return a}static collectTextInputs(e){return typeof e.getTextInputs=="function"?e.getTextInputs():[]}};

package/dist/index.d.ts

@@ -0,0 +1,706 @@
+import { Vector2, IInputSystem, InputDeviceType, AxisBinding, ButtonBinding } from '@primitiv/types';
+
+/**
+ * Common button state interface
+ */
+interface ButtonState {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+    timestamp?: number;
+}
+/**
+ * Configuration options for input systems
+ */
+interface InputConfig {
+    /**
+     * Target element to attach listeners to (default: window)
+     */
+    targetElement?: HTMLElement | Window;
+    /**
+     * Enable/disable specific input types
+     */
+    enabled?: boolean;
+    /**
+     * Prevent default browser behaviors
+     */
+    preventDefault?: boolean;
+    /**
+     * Stop event propagation
+     */
+    stopPropagation?: boolean;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+}
+/**
+ * Abstract base class for input systems
+ */
+declare abstract class BaseInputs {
+    protected isActive: boolean;
+    protected targetElement: HTMLElement | Window;
+    protected config: InputConfig;
+    constructor(targetElement?: HTMLElement | Window, config?: InputConfig);
+    abstract start(): void;
+    abstract stop(): void;
+    abstract reset(): void;
+    abstract resetDelta(): void;
+    isListening(): boolean;
+    destroy(): void;
+    getTargetElement(): HTMLElement | Window;
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+}
+
+interface AccelerometerData {
+    x: number;
+    y: number;
+    z: number;
+    includesGravity: boolean;
+    timestamp: number;
+}
+interface GyroscopeData {
+    alpha: number;
+    beta: number;
+    gamma: number;
+    timestamp: number;
+}
+interface OrientationData {
+    /** Compass heading: 0-360° (0 = North, 90 = East). null if unavailable. */
+    alpha: number | null;
+    /** Front/back tilt: -180° to +180° (0 = flat, positive = tilted back). */
+    beta: number | null;
+    /** Left/right tilt: -90° to +90° (0 = flat, positive = tilted right). */
+    gamma: number | null;
+    /** True if alpha is relative to true north (compass), false if arbitrary. */
+    absolute: boolean;
+    timestamp: number;
+}
+interface MotionCallbacks {
+    onAccelerometer?: (data: AccelerometerData) => void;
+    onGyroscope?: (data: GyroscopeData) => void;
+    onOrientation?: (data: OrientationData) => void;
+}
+interface MotionInputsConfig extends InputConfig {
+    /** Include gravity in accelerometer readings. Default: true. */
+    includeGravity?: boolean;
+    /** Minimum change threshold to trigger callbacks. Default: 0.001. */
+    threshold?: number;
+    /** Automatically request permission on iOS. Default: false. */
+    autoRequestPermission?: boolean;
+    enabled?: boolean;
+    debug?: boolean;
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+    /** Low-pass filter smoothing (0 = raw, 0.95 = very smooth). Default: 0.85. */
+    smoothing?: number;
+    /** Use absolute orientation (true north compass) when available. Default: true. */
+    useAbsoluteOrientation?: boolean;
+}
+declare class MotionInputs extends BaseInputs {
+    private accelerometer;
+    private gyroscope;
+    private orientation;
+    private smoothedAccel;
+    private smoothedGyro;
+    private smoothedOrientation;
+    private smoothedTiltX;
+    private smoothedTiltY;
+    private calibrationOffset;
+    private isCalibrated;
+    private motionCallbacks;
+    private motionConfig;
+    private permissionGranted;
+    private smoothingFactor;
+    private hasReceivedMotion;
+    private hasReceivedOrientation;
+    private boundHandlers;
+    constructor(targetElement?: HTMLElement | Window, config?: MotionInputsConfig);
+    /**
+     * Request permission for motion sensors (required on iOS 13+).
+     * Must be called from a user gesture (tap, click).
+     */
+    requestPermission(): Promise<boolean>;
+    /** Check if permission has been granted. */
+    isPermissionGranted(): boolean;
+    /** Check if we're receiving motion data. */
+    isReceivingMotion(): boolean;
+    /** Check if we're receiving orientation data. */
+    isReceivingOrientation(): boolean;
+    start(): void;
+    stop(): void;
+    setCallbacks(callbacks: MotionCallbacks): void;
+    poll(): void;
+    reset(): void;
+    resetDelta(): void;
+    /**
+     * Calibrate sensors: set current orientation as the "zero" reference.
+     * Useful for games where the player holds the phone at an angle.
+     */
+    calibrate(): void;
+    /** Clear calibration and return to absolute values. */
+    clearCalibration(): void;
+    /** Check if sensors are calibrated. */
+    getIsCalibrated(): boolean;
+    /** Get smoothed accelerometer data (m/s²). */
+    getAccelerometer(): AccelerometerData;
+    /** Get smoothed gyroscope/rotation rate (°/s). */
+    getGyroscope(): GyroscopeData;
+    /** Get smoothed orientation with calibration applied. */
+    getOrientation(): OrientationData;
+    /** Get raw (unsmoothed) accelerometer data. */
+    getRawAccelerometer(): AccelerometerData;
+    /** Get raw (unsmoothed) gyroscope data. */
+    getRawGyroscope(): GyroscopeData;
+    /** Get raw (unsmoothed) orientation data. */
+    getRawOrientation(): OrientationData;
+    /**
+     * Get normalized tilt as a Vector2 (-1 to +1).
+     * Calibration is applied if set.
+     *
+     * - X: Left/right tilt (positive = tilted right)
+     * - Y: Forward/backward tilt (positive = tilted back)
+     */
+    getNormalizedTilt(): Vector2;
+    /**
+     * Get compass heading in degrees (0-360, 0 = North, 90 = East).
+     * Returns null if compass is unavailable.
+     */
+    getCompassHeading(): number | null;
+    /** Set the smoothing factor (0 = raw/noisy, 0.95 = very smooth). */
+    setSmoothing(factor: number): void;
+    /** Low-pass filter for regular values. */
+    private lowPass;
+    /** Low-pass filter for angles that wrap (0-360). */
+    private lowPassAngle;
+    private handleDeviceMotion;
+    private handleDeviceOrientation;
+    private handleDeviceOrientationAbsolute;
+    private processOrientationEvent;
+}
+
+/**
+ * MobileVibration - Named vibration presets with intensity scaling.
+ *
+ * Wraps navigator.vibrate() with convenience methods and
+ * a configurable intensity multiplier that scales vibration durations.
+ */
+type VibrationPattern = number | readonly number[];
+interface MobileVibrationConfig {
+    enabled?: boolean;
+    intensity?: number;
+}
+declare const VibrationPatterns: {
+    readonly tap: 10;
+    readonly mediumTap: 25;
+    readonly heavyTap: 50;
+    readonly success: readonly number[];
+    readonly error: readonly number[];
+    readonly warning: readonly number[];
+    readonly selection: 5;
+    readonly impactLight: 15;
+    readonly impactMedium: 30;
+    readonly impactHeavy: 50;
+    readonly notification: readonly number[];
+    readonly sos: readonly number[];
+};
+declare class MobileVibration {
+    private enabled;
+    private intensity;
+    private supported;
+    private userActivated;
+    constructor(config?: MobileVibrationConfig);
+    isSupported(): boolean;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    setIntensity(intensity: number): void;
+    getIntensity(): number;
+    hasUserActivation(): boolean;
+    vibrate(pattern: VibrationPattern): boolean;
+    cancel(): void;
+    tap(): boolean;
+    mediumTap(): boolean;
+    heavyTap(): boolean;
+    success(): boolean;
+    error(): boolean;
+    warning(): boolean;
+    selection(): boolean;
+    impactLight(): boolean;
+    impactMedium(): boolean;
+    impactHeavy(): boolean;
+    notification(): boolean;
+    /**
+     * Scale vibration durations by intensity.
+     * Only "on" segments (even indices in an array pattern) are scaled;
+     * pauses (odd indices) are kept as-is so rhythm is preserved.
+     */
+    private scalePattern;
+}
+declare function getMobileVibration(config?: MobileVibrationConfig): MobileVibration;
+
+interface InputRouterConfig {
+    enableKeyboardMouse?: boolean;
+    enableGamepad?: boolean;
+    enableTouch?: boolean;
+    targetElement?: HTMLElement | Window;
+    gridWidth?: number;
+    gridHeight?: number;
+    debug?: boolean;
+}
+/**
+ * Unified input router - manages all input devices
+ */
+declare class InputRouter implements IInputSystem {
+    private keyboard;
+    private mouse;
+    private gamepad;
+    private touch;
+    private touchZone;
+    private motion;
+    private vibration;
+    private config;
+    constructor(config?: InputRouterConfig);
+    private initialize;
+    getButton(device: InputDeviceType, input: number): boolean;
+    getButtonJustPressed(device: InputDeviceType, input: number): boolean;
+    getButtonJustReleased(device: InputDeviceType, input: number): boolean;
+    getAxis(device: InputDeviceType, input: number): number;
+    /**
+     * Get analog value (0.0 – 1.0) for a gamepad button.
+     * Primarily useful for L2/R2 triggers which have a linear pressure range.
+     */
+    getButtonValue(device: InputDeviceType, input: number): number;
+    isLeftMousePressed(): boolean;
+    getTextInputs(): string[];
+    private getMouseButton;
+    private getMouseButtonJustPressed;
+    private getMouseButtonJustReleased;
+    private getMouseAxis;
+    private getTouchAxis;
+    private getTouchZoneAxis;
+    private getMotionAxis;
+    /** Get the motion input device (accelerometer, gyroscope, orientation). */
+    getMotion(): MotionInputs | null;
+    /** Get the vibration controller. */
+    getVibration(): MobileVibration | null;
+    /** Mouse X position converted to grid column. */
+    getMouseGridX(): number;
+    /** Mouse Y position converted to grid row. */
+    getMouseGridY(): number;
+    /** Whether the given mouse button (0=left, 1=middle, 2=right) is down. */
+    isMouseButtonDown(button: number): boolean;
+    /** Key codes just pressed this frame. */
+    getKeysPressed(): string[];
+    /** Key codes currently held down. */
+    getKeysHeld(): string[];
+    /**
+     * Push touch-zone layout from the input binding registry to the TouchZoneInputs device.
+     *
+     * Must be called whenever the server (or standalone engine) sends updated
+     * input bindings so that hit-testing uses the current zone geometry.
+     *
+     * @param zones - Array of zone definitions from `InputBindingRegistry.getAllTouchZones()`.
+     */
+    setTouchZones(zones: {
+        zoneId: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[]): void;
+    /**
+     * Configure the touch-zone coordinate system.
+     *
+     * This MUST be called whenever:
+     *  - A new canvas is created (or the first render completes)
+     *  - The display grid dimensions change
+     *  - The renderer offsets (letterbox/pillarbox) change
+     *
+     * Without correct layout info, touch coordinates cannot be converted to
+     * grid cell coordinates and zone hit-testing will fail.
+     *
+     * @param canvas - The actual canvas element from the renderer
+     * @param gridWidth - Display width in cells
+     * @param gridHeight - Display height in cells
+     * @param rendererOffsets - Optional letterbox/pillarbox offsets from the renderer
+     */
+    setTouchLayout(canvas: HTMLCanvasElement, gridWidth: number, gridHeight: number, rendererOffsets?: {
+        offsetX: number;
+        offsetY: number;
+    }): void;
+    start(): void;
+    stop(): void;
+    reset(): void;
+    poll(): void;
+    resetDelta(): void;
+    destroy(): void;
+}
+
+/**
+ * Button state with transition detection
+ */
+interface ButtonStateWithTransitions {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+}
+/**
+ * InputCollector - Adapter between InputRouter and Binding evaluation
+ */
+declare class InputCollector {
+    /**
+     * Calculate canvas render metrics for proper coordinate mapping
+     *
+     * Handles:
+     * - object-fit: contain (letterbox/pillarbox black bars)
+     * - Renderer centering offsets (Terminal2D may not fill its parent)
+     */
+    private static calculateRenderMetrics;
+    /**
+     * Collects raw source values for all axis bindings
+     */
+    static collectAxisSources(bindings: AxisBinding[], router: IInputSystem): Map<number, number>;
+    /**
+     * Collects raw source states for all button bindings
+     */
+    static collectButtonSources(bindings: ButtonBinding[], router: IInputSystem): Map<number, boolean>;
+    /**
+     * Collects raw source states with transition detection for all button bindings
+     */
+    static collectButtonSourcesWithTransitions(bindings: ButtonBinding[], router: IInputSystem): Map<number, ButtonStateWithTransitions>;
+    /**
+     * Calculate mouse position in grid coordinates
+     */
+    static collectMousePosition(router: IInputSystem, canvas: HTMLCanvasElement, gridWidth: number, gridHeight: number, rendererOffsets?: {
+        offsetX: number;
+        offsetY: number;
+    }): {
+        x: number;
+        y: number;
+        over: boolean;
+        isLeftDown: boolean;
+    };
+    /**
+     * Calculate touch positions in grid coordinates
+     */
+    static collectTouchPositions(router: IInputSystem, canvas: HTMLCanvasElement, gridWidth: number, gridHeight: number, maxTouches?: number, rendererOffsets?: {
+        offsetX: number;
+        offsetY: number;
+    }): Array<{
+        id: number;
+        x: number;
+        y: number;
+        over: boolean;
+    }>;
+    /**
+     * Collects text input events from keyboard
+     */
+    static collectTextInputs(router: IInputSystem): string[];
+}
+
+/**
+ * Keyboard button state with press/release detection
+ */
+interface KeyButtonState {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+}
+interface KeyState {
+    [key: string]: KeyButtonState;
+}
+interface KeyboardCallbacks {
+    onKeyDown?: (key: string, event: KeyboardEvent) => void;
+    onKeyUp?: (key: string, event: KeyboardEvent) => void;
+}
+declare class KeyboardInputs extends BaseInputs {
+    private keys;
+    private textInputsThisFrame;
+    private keyboardCallbacks;
+    private boundHandlers;
+    constructor(targetElement?: HTMLElement | Window, config?: InputConfig);
+    start(): void;
+    stop(): void;
+    reset(): void;
+    resetDelta(): void;
+    poll(): void;
+    setCallbacks(callbacks: KeyboardCallbacks): void;
+    getTextInputs(): string[];
+    isKeyPressed(key: string): boolean;
+    isKeyJustPressed(key: string): boolean;
+    isKeyJustReleased(key: string): boolean;
+    /** Returns all key codes that were just pressed this frame. */
+    getKeysJustPressed(): string[];
+    /** Returns all key codes currently held down. */
+    getKeysHeld(): string[];
+    private shouldAllowDefault;
+    private handleKeyDown;
+    private handleKeyUp;
+    private handleBlur;
+}
+
+interface MouseButtonState {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+}
+interface MouseButtons {
+    left: MouseButtonState;
+    middle: MouseButtonState;
+    right: MouseButtonState;
+}
+declare class MouseInputs extends BaseInputs {
+    private mouseButtons;
+    private mousePosition;
+    private mouseDelta;
+    private wheelDelta;
+    private boundHandlers;
+    constructor(targetElement?: HTMLElement | Window, config?: InputConfig);
+    start(): void;
+    stop(): void;
+    reset(): void;
+    poll(): void;
+    resetDelta(): void;
+    isLeftMousePressed(): boolean;
+    isLeftMouseJustPressed(): boolean;
+    isLeftMouseJustReleased(): boolean;
+    isRightMousePressed(): boolean;
+    isRightMouseJustPressed(): boolean;
+    isRightMouseJustReleased(): boolean;
+    isMiddleMousePressed(): boolean;
+    getMousePosition(): Vector2;
+    getMouseDelta(): Vector2;
+    getWheelDelta(): number;
+    private static readonly BUTTON_NAMES;
+    private handleMouseDown;
+    private handleMouseUp;
+    private handleMouseMove;
+    private handleWheel;
+    private handleContextMenu;
+    private handleBlur;
+    /**
+     * Checks if the event target is the game canvas or a designated input surface.
+     * This logic helps isolate game inputs from standard web UI elements.
+     */
+    private isInteractiveSurfaceEvent;
+}
+
+/**
+ * Gamepad button state with press detection
+ */
+interface GamepadButtonState {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+    value: number;
+    touched: boolean;
+}
+/**
+ * Complete state of a single gamepad
+ */
+interface GamepadState {
+    id: string;
+    index: number;
+    connected: boolean;
+    buttons: GamepadButtonState[];
+    axes: number[];
+    timestamp: number;
+    mapping: string;
+}
+interface GamepadVibrationOptions {
+    duration: number;
+    strongMagnitude?: number;
+    weakMagnitude?: number;
+    startDelay?: number;
+}
+declare class GamepadInputs extends BaseInputs {
+    private gamepads;
+    private previousGameState;
+    private rafId;
+    private boundHandlers;
+    constructor(targetElement?: HTMLElement | Window, config?: InputConfig);
+    start(): void;
+    stop(): void;
+    private startPolling;
+    private stopPolling;
+    poll(): void;
+    reset(): void;
+    resetDelta(): void;
+    private updateGamepadState;
+    isButtonPressed(gamepadIndex: number, buttonIndex: number): boolean;
+    isButtonJustPressed(gamepadIndex: number, buttonIndex: number): boolean;
+    isButtonJustReleased(gamepadIndex: number, buttonIndex: number): boolean;
+    getAxis(gamepadIndex: number, axisIndex: number): number;
+    /**
+     * Get the analog value (0.0 – 1.0) of a button.
+     * Useful for L2/R2 triggers which report a continuous pressure value.
+     */
+    getButtonValue(gamepadIndex: number, buttonIndex: number): number;
+    readonly vibrationPresets: {
+        tap: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+        impact: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+        heavy: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+        success: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+        error: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+        explosion: {
+            duration: number;
+            strongMagnitude: number;
+            weakMagnitude: number;
+        };
+    };
+    vibrate(gamepadIndex: number, options: GamepadVibrationOptions): Promise<boolean>;
+    vibratePreset(gamepadIndex: number, preset: keyof typeof this.vibrationPresets): Promise<boolean>;
+    vibrateAll(options: GamepadVibrationOptions): Promise<void>;
+    stopVibration(gamepadIndex: number): Promise<void>;
+    private handleGamepadConnected;
+    private handleGamepadDisconnected;
+    private cloneState;
+}
+
+interface TouchPoint {
+    id: number;
+    nativeId: number;
+    active: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+    x: number;
+    y: number;
+    startX: number;
+    startY: number;
+}
+declare class TouchInputs extends BaseInputs {
+    private touches;
+    private nativeToInternal;
+    private maxTouches;
+    private boundHandlers;
+    constructor(targetElement?: HTMLElement | Window, config?: InputConfig);
+    start(): void;
+    stop(): void;
+    poll(): void;
+    reset(): void;
+    resetDelta(): void;
+    isTouchActive(id: number): boolean;
+    isTouchJustPressed(id: number): boolean;
+    isTouchJustReleased(id: number): boolean;
+    getTouchPosition(id: number): {
+        x: number;
+        y: number;
+    } | null;
+    getAllTouches(): TouchPoint[];
+    private updateTouches;
+    private handleTouchStart;
+    private handleTouchEnd;
+    private handleTouchMove;
+    private handleTouchCancel;
+    private handleVisibilityChange;
+}
+
+interface TouchZoneDefinition {
+    id: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface TouchZoneState {
+    pressed: boolean;
+    justPressed: boolean;
+    justReleased: boolean;
+    lastX: number;
+    lastY: number;
+}
+interface TouchZoneConfig extends InputConfig {
+    targetElement: HTMLElement;
+    gridWidth: number;
+    gridHeight: number;
+    /** Optional renderer offsets (content centered inside canvas) */
+    rendererOffsets?: {
+        offsetX: number;
+        offsetY: number;
+    };
+    zones?: TouchZoneDefinition[];
+}
+declare class TouchZoneInputs extends BaseInputs {
+    private touch;
+    private zones;
+    private zoneStates;
+    private gridWidth;
+    private gridHeight;
+    private rendererOffsets;
+    constructor(touch: TouchInputs, config: TouchZoneConfig);
+    start(): void;
+    stop(): void;
+    reset(): void;
+    resetDelta(): void;
+    /**
+     * Update the target element used for coordinate calculations.
+     *
+     * By default this is `document.body`, but for accurate hit-testing it MUST
+     * be set to the actual canvas element rendered by the game's renderer.
+     * Otherwise touch coordinates cannot be mapped to grid cells correctly.
+     */
+    setTargetElement(element: HTMLElement): void;
+    /** Update layout info (grid size / offsets) when display changes */
+    setLayout(gridWidth: number, gridHeight: number, rendererOffsets?: {
+        offsetX: number;
+        offsetY: number;
+    }): void;
+    /** Define zones (replace all). Zone IDs must be 0-31. */
+    setZones(zones: TouchZoneDefinition[]): void;
+    /** Clear all zones and their state */
+    clearZones(): void;
+    /** Must be called before reads each frame to sync with current touches */
+    updateFromTouches(): void;
+    poll(): void;
+    isZonePressed(id: number): boolean;
+    isZoneJustPressed(id: number): boolean;
+    isZoneJustReleased(id: number): boolean;
+    /**
+     * Get zone axis value (normalized -1 to +1 relative to zone center)
+     *
+     * For joystick-like zones: returns position within zone as -1 to +1
+     * - Center of zone = 0
+     * - Left/Top edge = -1
+     * - Right/Bottom edge = +1
+     *
+     * Returns 0 if zone not found or not pressed.
+     */
+    getZoneAxis(zoneId: number, axis: 'x' | 'y'): number;
+    /**
+     * Get zone position in display cell coordinates (absolute)
+     */
+    getZonePosition(zoneId: number): {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Calculate render metrics accounting for object-fit: contain
+     * (letterbox/pillarbox) and renderer content offsets.
+     */
+    private calculateRenderMetrics;
+}
+
+export { BaseInputs, GamepadInputs, InputCollector, InputRouter, KeyboardInputs, MobileVibration, MotionInputs, MouseInputs, TouchInputs, TouchZoneInputs, VibrationPatterns, getMobileVibration };
+export type { AccelerometerData, ButtonState, ButtonStateWithTransitions, GamepadButtonState, GamepadState, GamepadVibrationOptions, GyroscopeData, InputConfig, InputRouterConfig, KeyButtonState, KeyState, KeyboardCallbacks, MobileVibrationConfig, MotionCallbacks, MotionInputsConfig, MouseButtonState, MouseButtons, OrientationData, TouchPoint, TouchZoneConfig, TouchZoneDefinition, TouchZoneState, VibrationPattern };

package/dist/index.mjs

@@ -0,0 +1 @@
+var v=class{isActive=!1;targetElement;config;constructor(e=window,t={}){this.targetElement=e,this.config={enabled:!0,preventDefault:!1,stopPropagation:!1,debug:!1,...t}}isListening(){return this.isActive}destroy(){this.stop()}getTargetElement(){return this.targetElement}enable(){this.config.enabled=!0,this.isActive||this.start()}disable(){this.config.enabled=!1,this.isActive&&this.stop()}isEnabled(){return this.config.enabled??!0}};import{InputDeviceType as d,KeyboardInput as O,MouseInput as y,MotionInput as M}from"@primitiv/types";var D=class extends v{keys={};textInputsThisFrame=[];keyboardCallbacks={};boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={keyDown:this.handleKeyDown.bind(this),keyUp:this.handleKeyUp.bind(this),blur:this.handleBlur.bind(this)}}start(){this.isActive||(this.targetElement.addEventListener("keydown",this.boundHandlers.keyDown),this.targetElement.addEventListener("keyup",this.boundHandlers.keyUp),window.addEventListener("blur",this.boundHandlers.blur),this.isActive=!0)}stop(){this.isActive&&(this.targetElement.removeEventListener("keydown",this.boundHandlers.keyDown),this.targetElement.removeEventListener("keyup",this.boundHandlers.keyUp),window.removeEventListener("blur",this.boundHandlers.blur),this.isActive=!1)}reset(){this.keys={},this.textInputsThisFrame=[]}resetDelta(){}poll(){for(let e in this.keys)this.keys[e].justPressed=!1,this.keys[e].justReleased=!1;this.textInputsThisFrame=[]}setCallbacks(e){this.keyboardCallbacks={...this.keyboardCallbacks,...e}}getTextInputs(){return this.textInputsThisFrame}isKeyPressed(e){return this.keys[e]?.pressed||!1}isKeyJustPressed(e){return this.keys[e]?.justPressed||!1}isKeyJustReleased(e){return this.keys[e]?.justReleased||!1}getKeysJustPressed(){let e=[];for(let t in this.keys)this.keys[t].justPressed&&e.push(t);return e}getKeysHeld(){let e=[];for(let t in this.keys)this.keys[t].pressed&&e.push(t);return e}shouldAllowDefault(e,t){let s=/^F([1-9]|1[0-2])$/.test(e),n=(t.ctrlKey||t.metaKey)&&(e==="KeyT"||e==="KeyW"||e==="KeyR"||e==="KeyN"||e==="Tab");return s||n}handleKeyDown(e){let t=e.code,s=this.shouldAllowDefault(t,e);this.config.preventDefault&&!s&&e.preventDefault(),this.config.stopPropagation&&!s&&e.stopPropagation(),this.keys[t]||(this.keys[t]={pressed:!1,justPressed:!1,justReleased:!1}),this.keys[t].pressed||(this.keys[t].justPressed=!0,this.keyboardCallbacks.onKeyDown?.(t,e)),this.keys[t].pressed=!0,this.keys[t].justReleased=!1;let n=e.key;n.length===1&&!e.ctrlKey&&!e.metaKey&&this.textInputsThisFrame.push(n)}handleKeyUp(e){let t=e.code,s=this.shouldAllowDefault(t,e);this.config.preventDefault&&!s&&e.preventDefault(),this.config.stopPropagation&&!s&&e.stopPropagation(),this.keys[t]||(this.keys[t]={pressed:!1,justPressed:!1,justReleased:!1}),this.keys[t].pressed&&(this.keys[t].justReleased=!0,this.keyboardCallbacks.onKeyUp?.(t,e)),this.keys[t].pressed=!1,this.keys[t].justPressed=!1}handleBlur(){this.reset()}};import{Vector2 as P}from"@primitiv/types";var A=class b extends v{mouseButtons={left:{pressed:!1,justPressed:!1,justReleased:!1},middle:{pressed:!1,justPressed:!1,justReleased:!1},right:{pressed:!1,justPressed:!1,justReleased:!1}};mousePosition=new P(0,0);mouseDelta=new P(0,0);wheelDelta=0;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={mouseDown:this.handleMouseDown.bind(this),mouseUp:this.handleMouseUp.bind(this),mouseMove:this.handleMouseMove.bind(this),wheel:this.handleWheel.bind(this),contextMenu:this.handleContextMenu.bind(this),blur:this.handleBlur.bind(this)}}start(){this.isActive||(this.targetElement.addEventListener("mousedown",this.boundHandlers.mouseDown),this.targetElement.addEventListener("mouseup",this.boundHandlers.mouseUp),this.targetElement.addEventListener("mousemove",this.boundHandlers.mouseMove),this.targetElement.addEventListener("wheel",this.boundHandlers.wheel),this.targetElement.addEventListener("contextmenu",this.boundHandlers.contextMenu),window.addEventListener("blur",this.boundHandlers.blur),this.isActive=!0)}stop(){this.isActive&&(this.targetElement.removeEventListener("mousedown",this.boundHandlers.mouseDown),this.targetElement.removeEventListener("mouseup",this.boundHandlers.mouseUp),this.targetElement.removeEventListener("mousemove",this.boundHandlers.mouseMove),this.targetElement.removeEventListener("wheel",this.boundHandlers.wheel),this.targetElement.removeEventListener("contextmenu",this.boundHandlers.contextMenu),window.removeEventListener("blur",this.boundHandlers.blur),this.isActive=!1)}reset(){this.mouseButtons={left:{pressed:!1,justPressed:!1,justReleased:!1},middle:{pressed:!1,justPressed:!1,justReleased:!1},right:{pressed:!1,justPressed:!1,justReleased:!1}},this.mousePosition=new P(0,0),this.mouseDelta=new P(0,0),this.wheelDelta=0}poll(){this.mouseButtons.left.justPressed=!1,this.mouseButtons.left.justReleased=!1,this.mouseButtons.middle.justPressed=!1,this.mouseButtons.middle.justReleased=!1,this.mouseButtons.right.justPressed=!1,this.mouseButtons.right.justReleased=!1,this.resetDelta()}resetDelta(){this.mouseDelta=new P(0,0),this.wheelDelta=0}isLeftMousePressed(){return this.mouseButtons.left.pressed}isLeftMouseJustPressed(){return this.mouseButtons.left.justPressed}isLeftMouseJustReleased(){return this.mouseButtons.left.justReleased}isRightMousePressed(){return this.mouseButtons.right.pressed}isRightMouseJustPressed(){return this.mouseButtons.right.justPressed}isRightMouseJustReleased(){return this.mouseButtons.right.justReleased}isMiddleMousePressed(){return this.mouseButtons.middle.pressed}getMousePosition(){return this.mousePosition.clone()}getMouseDelta(){return this.mouseDelta.clone()}getWheelDelta(){return this.wheelDelta}static BUTTON_NAMES=["left","middle","right"];handleMouseDown(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault();let t=b.BUTTON_NAMES[e.button];if(t){let s=this.mouseButtons[t];s.pressed||(s.justPressed=!0),s.pressed=!0,s.justReleased=!1}}handleMouseUp(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault();let t=b.BUTTON_NAMES[e.button];if(t){let s=this.mouseButtons[t];s.pressed&&(s.justReleased=!0),s.pressed=!1,s.justPressed=!1}}handleMouseMove(e){let t=new P(e.clientX,e.clientY);this.mouseDelta=t.subtract(this.mousePosition),this.mousePosition=t}handleWheel(e){this.config.preventDefault&&this.isInteractiveSurfaceEvent(e)&&e.preventDefault(),this.wheelDelta=e.deltaY}handleContextMenu(e){this.isInteractiveSurfaceEvent(e)&&e.preventDefault()}handleBlur(){this.reset()}isInteractiveSurfaceEvent(e){let t=e.target;return t?(t.tagName||"").toLowerCase()==="canvas"||(t.getAttribute?.("data-primitiv-input-surface")??"").toLowerCase()==="true"?!0:!!t.closest?.('canvas, [data-primitiv-input-surface="true"]'):!1}};var B=class extends v{gamepads=new Map;previousGameState=new Map;rafId=null;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={connected:this.handleGamepadConnected.bind(this),disconnected:this.handleGamepadDisconnected.bind(this)}}start(){this.isActive||(window.addEventListener("gamepadconnected",this.boundHandlers.connected),window.addEventListener("gamepaddisconnected",this.boundHandlers.disconnected),this.startPolling(),this.isActive=!0)}stop(){this.isActive&&(window.removeEventListener("gamepadconnected",this.boundHandlers.connected),window.removeEventListener("gamepaddisconnected",this.boundHandlers.disconnected),this.stopPolling(),this.isActive=!1)}startPolling(){let e=()=>{this.poll(),this.rafId=requestAnimationFrame(e)};this.rafId=requestAnimationFrame(e)}stopPolling(){this.rafId!==null&&(cancelAnimationFrame(this.rafId),this.rafId=null)}poll(){let e=navigator.getGamepads();for(let t=0;t<e.length;t++){let s=e[t];s&&this.updateGamepadState(s)}}reset(){this.gamepads.clear(),this.previousGameState.clear()}resetDelta(){this.previousGameState.clear();for(let[e,t]of this.gamepads)this.previousGameState.set(e,this.cloneState(t))}updateGamepadState(e){let t=this.gamepads.get(e.index),s=e.buttons.map((n,i)=>{let o=t?.buttons[i],a=n.pressed,u=o?.pressed??!1;return{pressed:a,justPressed:a&&!u,justReleased:!a&&u,value:n.value,touched:n.touched}});this.gamepads.set(e.index,{id:e.id,index:e.index,connected:e.connected,buttons:s,axes:[...e.axes],timestamp:e.timestamp,mapping:e.mapping})}isButtonPressed(e,t){return this.gamepads.get(e)?.buttons[t]?.pressed??!1}isButtonJustPressed(e,t){return this.gamepads.get(e)?.buttons[t]?.justPressed??!1}isButtonJustReleased(e,t){return this.gamepads.get(e)?.buttons[t]?.justReleased??!1}getAxis(e,t){let s=this.gamepads.get(e);return s?t===4?s.buttons[6]?.value??0:t===5?s.buttons[7]?.value??0:s.axes[t]??0:0}getButtonValue(e,t){return this.gamepads.get(e)?.buttons[t]?.value??0}vibrationPresets={tap:{duration:50,strongMagnitude:.3,weakMagnitude:.5},impact:{duration:100,strongMagnitude:.7,weakMagnitude:.3},heavy:{duration:200,strongMagnitude:1,weakMagnitude:.2},success:{duration:150,strongMagnitude:.4,weakMagnitude:.6},error:{duration:300,strongMagnitude:.8,weakMagnitude:.4},explosion:{duration:400,strongMagnitude:1,weakMagnitude:.8}};async vibrate(e,t){let s=navigator.getGamepads()[e];if(!s||!s.vibrationActuator)return!1;try{return await s.vibrationActuator.playEffect("dual-rumble",{startDelay:t.startDelay??0,duration:t.duration,strongMagnitude:t.strongMagnitude??1,weakMagnitude:t.weakMagnitude??1}),!0}catch{return!1}}async vibratePreset(e,t){return this.vibrate(e,this.vibrationPresets[t])}async vibrateAll(e){let t=Array.from(this.gamepads.keys()).map(s=>this.vibrate(s,e));await Promise.all(t)}async stopVibration(e){let t=navigator.getGamepads()[e];if(t&&t.vibrationActuator)try{await t.vibrationActuator.reset()}catch{}}handleGamepadConnected(e){this.updateGamepadState(e.gamepad)}handleGamepadDisconnected(e){this.gamepads.delete(e.gamepad.index),this.previousGameState.delete(e.gamepad.index)}cloneState(e){return{...e,buttons:e.buttons.map(t=>({...t})),axes:[...e.axes]}}};var L=class extends v{touches=new Map;nativeToInternal=new Map;maxTouches=10;boundHandlers;constructor(e=window,t={}){super(e,t),this.boundHandlers={touchStart:this.handleTouchStart.bind(this),touchEnd:this.handleTouchEnd.bind(this),touchMove:this.handleTouchMove.bind(this),touchCancel:this.handleTouchCancel.bind(this),visibilityChange:this.handleVisibilityChange.bind(this)}}start(){if(this.isActive)return;let e={passive:!this.config.preventDefault};this.targetElement.addEventListener("touchstart",this.boundHandlers.touchStart,e),this.targetElement.addEventListener("touchend",this.boundHandlers.touchEnd,e),this.targetElement.addEventListener("touchmove",this.boundHandlers.touchMove,e),this.targetElement.addEventListener("touchcancel",this.boundHandlers.touchCancel,e),document.addEventListener("visibilitychange",this.boundHandlers.visibilityChange),this.isActive=!0}stop(){this.isActive&&(this.targetElement.removeEventListener("touchstart",this.boundHandlers.touchStart),this.targetElement.removeEventListener("touchend",this.boundHandlers.touchEnd),this.targetElement.removeEventListener("touchmove",this.boundHandlers.touchMove),this.targetElement.removeEventListener("touchcancel",this.boundHandlers.touchCancel),document.removeEventListener("visibilitychange",this.boundHandlers.visibilityChange),this.isActive=!1)}poll(){let e=[];for(let[t,s]of this.touches)s.justReleased?e.push(t):(s.justPressed=!1,s.justReleased=!1);for(let t of e){let s=this.touches.get(t);s&&(this.nativeToInternal.delete(s.nativeId),this.touches.delete(t))}}reset(){this.touches.clear(),this.nativeToInternal.clear()}resetDelta(){}isTouchActive(e){return this.touches.get(e)?.active??!1}isTouchJustPressed(e){return this.touches.get(e)?.justPressed??!1}isTouchJustReleased(e){return this.touches.get(e)?.justReleased??!1}getTouchPosition(e){let t=this.touches.get(e);return t?{x:t.x,y:t.y}:null}getAllTouches(){return Array.from(this.touches.values()).filter(e=>e.active)}updateTouches(e){let t=new Set;for(let s=0;s<e.touches.length;s++){let n=e.touches[s],i=n.identifier;t.add(i);let o=this.nativeToInternal.get(i),a;if(o===void 0){if(this.touches.size>=this.maxTouches)continue;for(let h=0;h<this.maxTouches;h++)if(!this.touches.has(h)){o=h;break}if(o===void 0)continue;this.nativeToInternal.set(i,o),a=void 0}else a=this.touches.get(o);let u=!0,l=a?.active??!1;this.touches.set(o,{id:o,nativeId:i,active:u,justPressed:u&&!l,justReleased:!1,x:n.clientX,y:n.clientY,startX:a?.startX??n.clientX,startY:a?.startY??n.clientY})}for(let[s,n]of this.nativeToInternal)if(!t.has(s)){let i=this.touches.get(n);i&&i.active&&(i.active=!1,i.justReleased=!0)}}handleTouchStart(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchEnd(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchMove(e){this.config.preventDefault&&e.preventDefault(),this.updateTouches(e)}handleTouchCancel(e){this.handleTouchEnd(e)}handleVisibilityChange(){document.visibilityState==="hidden"&&this.reset()}};var R=class extends v{constructor(t,s){super(s.targetElement,s);this.touch=t;this.gridWidth=s.gridWidth,this.gridHeight=s.gridHeight,this.rendererOffsets=s.rendererOffsets??{offsetX:0,offsetY:0},s.zones&&this.setZones(s.zones)}zones=[];zoneStates=new Map;gridWidth;gridHeight;rendererOffsets;start(){this.isActive=!0}stop(){this.isActive=!1}reset(){this.clearZones()}resetDelta(){}setTargetElement(t){this.targetElement=t}setLayout(t,s,n){this.gridWidth=t,this.gridHeight=s,n&&(this.rendererOffsets=n)}setZones(t){this.zones=t.filter(s=>s.id>=0&&s.id<=31),this.zoneStates.clear();for(let s of this.zones)this.zoneStates.set(s.id,{pressed:!1,justPressed:!1,justReleased:!1,lastX:s.x,lastY:s.y})}clearZones(){this.zones=[],this.zoneStates.clear()}updateFromTouches(){if(this.zones.length===0)return;let t=this.targetElement,s=t.getBoundingClientRect(),{renderWidth:n,renderHeight:i,offsetX:o,offsetY:a}=this.calculateRenderMetrics(t,s),u=n/this.gridWidth,l=i/this.gridHeight,h=this.touch.getAllTouches(),f=new Set,g=new Map;for(let E of h){let m=E.x-s.left-o,p=E.y-s.top-a,T=Math.floor(m/u),x=Math.floor(p/l);for(let c of this.zones)T>=c.x&&T<c.x+c.width&&x>=c.y&&x<c.y+c.height&&(f.add(c.id),g.set(c.id,{x:Math.max(c.x,Math.min(c.x+c.width-1,T)),y:Math.max(c.y,Math.min(c.y+c.height-1,x))}))}for(let E of this.zones){let m=this.zoneStates.get(E.id);if(!m)continue;let p=f.has(E.id);p&&!m.pressed&&(m.justPressed=!0),!p&&m.pressed&&(m.justReleased=!0),m.pressed=p;let T=g.get(E.id);T&&(m.lastX=T.x,m.lastY=T.y)}}poll(){for(let t of this.zoneStates.values())t.justPressed=!1,t.justReleased=!1}isZonePressed(t){return this.zoneStates.get(t)?.pressed??!1}isZoneJustPressed(t){return this.zoneStates.get(t)?.justPressed??!1}isZoneJustReleased(t){return this.zoneStates.get(t)?.justReleased??!1}getZoneAxis(t,s){let n=this.zoneStates.get(t);if(!n||!n.pressed)return 0;let i=this.zones.find(o=>o.id===t);if(!i)return 0;if(s==="x"){let o=(i.width-1)/2,a=i.x+o;return o>0?(n.lastX-a)/o:0}else{let o=(i.height-1)/2,a=i.y+o;return o>0?(n.lastY-a)/o:0}}getZonePosition(t){let s=this.zoneStates.get(t);return s?{x:s.lastX,y:s.lastY}:null}calculateRenderMetrics(t,s){let n=t.width,i=t.height;if(!n||!i)return{renderWidth:s.width,renderHeight:s.height,offsetX:this.rendererOffsets.offsetX,offsetY:this.rendererOffsets.offsetY};let o=n/i,a=s.width/s.height,u,l,h,f;o>a?(u=s.width,l=s.width/o,h=0,f=(s.height-l)/2):(u=s.height*o,l=s.height,h=(s.width-u)/2,f=0);let g=this.rendererOffsets;return h+=g.offsetX,f+=g.offsetY,u-=g.offsetX*2,l-=g.offsetY*2,{renderWidth:u,renderHeight:l,offsetX:h,offsetY:f}}};import{Vector2 as J}from"@primitiv/types";var H=class extends v{accelerometer={x:0,y:0,z:0,includesGravity:!1,timestamp:0};gyroscope={alpha:0,beta:0,gamma:0,timestamp:0};orientation={alpha:null,beta:null,gamma:null,absolute:!1,timestamp:0};smoothedAccel={x:0,y:0,z:0};smoothedGyro={alpha:0,beta:0,gamma:0};smoothedOrientation={alpha:0,beta:0,gamma:0};smoothedTiltX=0;smoothedTiltY=0;calibrationOffset={alpha:0,beta:0,gamma:0};isCalibrated=!1;motionCallbacks={};motionConfig;permissionGranted=!1;smoothingFactor=.85;hasReceivedMotion=!1;hasReceivedOrientation=!1;boundHandlers;constructor(e=window,t={}){super(e,t),this.motionConfig={targetElement:e,includeGravity:t.includeGravity??!0,threshold:t.threshold??.001,autoRequestPermission:t.autoRequestPermission??!1,enabled:t.enabled??!0,debug:t.debug??!1,preventDefault:t.preventDefault??!1,stopPropagation:t.stopPropagation??!1,smoothing:t.smoothing??.85,useAbsoluteOrientation:t.useAbsoluteOrientation??!0},this.smoothingFactor=this.motionConfig.smoothing,this.boundHandlers={devicemotion:this.handleDeviceMotion.bind(this),deviceorientation:this.handleDeviceOrientation.bind(this),deviceorientationabsolute:this.handleDeviceOrientationAbsolute.bind(this)}}async requestPermission(){let e=!0,t=!0;if(typeof DeviceMotionEvent.requestPermission=="function")try{e=await DeviceMotionEvent.requestPermission()==="granted"}catch{e=!1}if(typeof DeviceOrientationEvent.requestPermission=="function")try{t=await DeviceOrientationEvent.requestPermission()==="granted"}catch{t=!1}return this.permissionGranted=e&&t,this.permissionGranted}isPermissionGranted(){return this.permissionGranted}isReceivingMotion(){return this.hasReceivedMotion}isReceivingOrientation(){return this.hasReceivedOrientation}start(){this.isActive||(window.addEventListener("devicemotion",this.boundHandlers.devicemotion),this.motionConfig.useAbsoluteOrientation&&window.addEventListener("deviceorientationabsolute",this.boundHandlers.deviceorientationabsolute),window.addEventListener("deviceorientation",this.boundHandlers.deviceorientation),this.isActive=!0)}stop(){this.isActive&&(window.removeEventListener("devicemotion",this.boundHandlers.devicemotion),window.removeEventListener("deviceorientation",this.boundHandlers.deviceorientation),window.removeEventListener("deviceorientationabsolute",this.boundHandlers.deviceorientationabsolute),this.isActive=!1)}setCallbacks(e){this.motionCallbacks={...this.motionCallbacks,...e}}poll(){}reset(){this.accelerometer={x:0,y:0,z:0,includesGravity:!1,timestamp:0},this.gyroscope={alpha:0,beta:0,gamma:0,timestamp:0},this.orientation={alpha:null,beta:null,gamma:null,absolute:!1,timestamp:0},this.smoothedAccel={x:0,y:0,z:0},this.smoothedGyro={alpha:0,beta:0,gamma:0},this.smoothedOrientation={alpha:0,beta:0,gamma:0},this.smoothedTiltX=0,this.smoothedTiltY=0,this.hasReceivedMotion=!1,this.hasReceivedOrientation=!1}resetDelta(){}calibrate(){this.orientation.beta!==null&&this.orientation.gamma!==null&&(this.calibrationOffset={alpha:this.orientation.alpha??0,beta:this.orientation.beta,gamma:this.orientation.gamma},this.isCalibrated=!0)}clearCalibration(){this.calibrationOffset={alpha:0,beta:0,gamma:0},this.isCalibrated=!1}getIsCalibrated(){return this.isCalibrated}getAccelerometer(){return{...this.smoothedAccel,includesGravity:this.motionConfig.includeGravity,timestamp:this.accelerometer.timestamp}}getGyroscope(){return{...this.smoothedGyro,timestamp:this.gyroscope.timestamp}}getOrientation(){let e=this.smoothedOrientation.alpha,t=this.smoothedOrientation.beta-(this.isCalibrated?this.calibrationOffset.beta:0),s=this.smoothedOrientation.gamma-(this.isCalibrated?this.calibrationOffset.gamma:0);return{alpha:this.orientation.alpha!==null?e:null,beta:this.orientation.beta!==null?t:null,gamma:this.orientation.gamma!==null?s:null,absolute:this.orientation.absolute,timestamp:this.orientation.timestamp}}getRawAccelerometer(){return{...this.accelerometer}}getRawGyroscope(){return{...this.gyroscope}}getRawOrientation(){return{...this.orientation}}getNormalizedTilt(){let e=this.smoothedTiltX,t=this.smoothedTiltY;return this.isCalibrated&&(e-=this.calibrationOffset.gamma/90,t-=this.calibrationOffset.beta/90,e=Math.max(-1,Math.min(1,e)),t=Math.max(-1,Math.min(1,t))),new J(e,t)}getCompassHeading(){return this.orientation.alpha===null?null:this.smoothedOrientation.alpha}setSmoothing(e){this.smoothingFactor=Math.max(0,Math.min(.99,e))}lowPass(e,t){return e*this.smoothingFactor+t*(1-this.smoothingFactor)}lowPassAngle(e,t,s=360){let n=t-e;n>s/2&&(n-=s),n<-s/2&&(n+=s);let i=e+n*(1-this.smoothingFactor);for(;i<0;)i+=s;for(;i>=s;)i-=s;return i}handleDeviceMotion(e){let t=performance.now(),s=this.motionConfig.includeGravity?e.accelerationIncludingGravity:e.acceleration;if(s&&(s.x!==null||s.y!==null||s.z!==null)){this.hasReceivedMotion=!0;let i=s.x??0,o=s.y??0,a=s.z??0;this.accelerometer={x:i,y:o,z:a,includesGravity:this.motionConfig.includeGravity,timestamp:t},this.smoothedAccel={x:this.lowPass(this.smoothedAccel.x,i),y:this.lowPass(this.smoothedAccel.y,o),z:this.lowPass(this.smoothedAccel.z,a)},this.motionCallbacks.onAccelerometer?.(this.getAccelerometer())}let n=e.rotationRate;if(n&&(n.alpha!==null||n.beta!==null||n.gamma!==null)){let i=n.alpha??0,o=n.beta??0,a=n.gamma??0;this.gyroscope={alpha:i,beta:o,gamma:a,timestamp:t},this.smoothedGyro={alpha:this.lowPass(this.smoothedGyro.alpha,i),beta:this.lowPass(this.smoothedGyro.beta,o),gamma:this.lowPass(this.smoothedGyro.gamma,a)},this.motionCallbacks.onGyroscope?.(this.getGyroscope())}}handleDeviceOrientation(e){this.motionConfig.useAbsoluteOrientation&&this.orientation.absolute||this.processOrientationEvent(e,!1)}handleDeviceOrientationAbsolute(e){this.processOrientationEvent(e,!0)}processOrientationEvent(e,t){let s=performance.now();if(e.alpha===null&&e.beta===null&&e.gamma===null)return;this.hasReceivedOrientation=!0;let n=e.alpha??0,i=e.beta??0,o=e.gamma??0;this.orientation={alpha:e.alpha,beta:e.beta,gamma:e.gamma,absolute:t||e.absolute,timestamp:s},this.smoothedOrientation.alpha=this.lowPassAngle(this.smoothedOrientation.alpha,n,360),this.smoothedOrientation.beta=this.lowPass(this.smoothedOrientation.beta,i),this.smoothedOrientation.gamma=this.lowPass(this.smoothedOrientation.gamma,o),this.smoothedTiltX=this.lowPass(this.smoothedTiltX,Math.max(-1,Math.min(1,o/90))),this.smoothedTiltY=this.lowPass(this.smoothedTiltY,Math.max(-1,Math.min(1,Math.max(-90,Math.min(90,i))/90))),this.motionCallbacks.onOrientation?.(this.getOrientation())}};var w={tap:10,mediumTap:25,heavyTap:50,success:[30,50,30],error:[50,30,50,30,50],warning:[100],selection:5,impactLight:15,impactMedium:30,impactHeavy:50,notification:[100,100,100,100,100],sos:[100,30,100,30,100,30,200,30,200,30,200,30,100,30,100,30,100]},I=class{enabled;intensity;supported;userActivated=!1;constructor(e={}){this.enabled=e.enabled??!0,this.intensity=Math.max(0,Math.min(1,e.intensity??1)),this.supported=typeof navigator<"u"&&typeof navigator.vibrate=="function"}isSupported(){return this.supported}isEnabled(){return this.enabled&&this.supported}setEnabled(e){this.enabled=e}setIntensity(e){this.intensity=Math.max(0,Math.min(1,e))}getIntensity(){return this.intensity}hasUserActivation(){return this.userActivated}vibrate(e){if(!this.isEnabled())return!1;let t=this.scalePattern(e),s=navigator.vibrate(t);return s&&(this.userActivated=!0),s}cancel(){this.supported&&navigator.vibrate(0)}tap(){return this.vibrate(w.tap)}mediumTap(){return this.vibrate(w.mediumTap)}heavyTap(){return this.vibrate(w.heavyTap)}success(){return this.vibrate(w.success)}error(){return this.vibrate(w.error)}warning(){return this.vibrate(w.warning)}selection(){return this.vibrate(w.selection)}impactLight(){return this.vibrate(w.impactLight)}impactMedium(){return this.vibrate(w.impactMedium)}impactHeavy(){return this.vibrate(w.impactHeavy)}notification(){return this.vibrate(w.notification)}scalePattern(e){return this.intensity===1?e:typeof e=="number"?Math.round(e*this.intensity):e.map((t,s)=>s%2===0?Math.round(t*this.intensity):t)}},j=null;function ae(b){return j||(j=new I(b)),j}var Z=class{keyboard=null;mouse=null;gamepad=null;touch=null;touchZone=null;motion=null;vibration=null;config;constructor(e={}){this.config={enableKeyboardMouse:e.enableKeyboardMouse??!0,enableGamepad:e.enableGamepad??!0,enableTouch:e.enableTouch??!0,targetElement:e.targetElement??window,gridWidth:e.gridWidth??80,gridHeight:e.gridHeight??25,debug:e.debug??!1},this.initialize()}initialize(){let e=this.config.targetElement;if(this.config.enableKeyboardMouse&&(this.keyboard=new D(e),this.mouse=new A(e)),this.config.enableGamepad&&(this.gamepad=new B(e)),this.config.enableTouch){this.touch=new L(e);let t=e instanceof Window?document.body:e;this.touchZone=new R(this.touch,{targetElement:t,gridWidth:this.config.gridWidth,gridHeight:this.config.gridHeight}),this.motion=new H(e),this.vibration=new I}this.start()}getButton(e,t){switch(e){case d.Keyboard:return this.keyboard?.isKeyPressed(O[t])??!1;case d.Mouse:return this.getMouseButton(t);case d.Gamepad:return this.gamepad?.isButtonPressed(0,t)??!1;case d.Touch:return this.touch?.isTouchActive(t)??!1;case d.TouchZone:return this.touchZone?.isZonePressed(t)??!1;default:return!1}}getButtonJustPressed(e,t){switch(e){case d.Keyboard:return this.keyboard?.isKeyJustPressed(O[t])??!1;case d.Mouse:return this.getMouseButtonJustPressed(t);case d.Gamepad:return this.gamepad?.isButtonJustPressed(0,t)??!1;case d.Touch:return this.touch?.isTouchJustPressed?.(t)??!1;case d.TouchZone:return this.touchZone?.isZoneJustPressed(t)??!1;default:return!1}}getButtonJustReleased(e,t){switch(e){case d.Keyboard:return this.keyboard?.isKeyJustReleased(O[t])??!1;case d.Mouse:return this.getMouseButtonJustReleased(t);case d.Gamepad:return this.gamepad?.isButtonJustReleased(0,t)??!1;case d.Touch:return this.touch?.isTouchJustReleased?.(t)??!1;case d.TouchZone:return this.touchZone?.isZoneJustReleased(t)??!1;default:return!1}}getAxis(e,t){switch(e){case d.Mouse:return this.getMouseAxis(t);case d.Gamepad:return this.gamepad?.getAxis(0,t-100)??0;case d.Touch:return this.getTouchAxis(t);case d.TouchZone:return this.getTouchZoneAxis(t);case d.Motion:return this.getMotionAxis(t);default:return 0}}getButtonValue(e,t){return e===d.Gamepad?this.gamepad?.getButtonValue(0,t)??0:this.getButton(e,t)?1:0}isLeftMousePressed(){return this.mouse?.isLeftMousePressed()??!1}getTextInputs(){return this.keyboard?.getTextInputs()??[]}getMouseButton(e){return this.mouse?e===y.LeftButton?this.mouse.isLeftMousePressed():e===y.RightButton?this.mouse.isRightMousePressed():e===y.MiddleButton?this.mouse.isMiddleMousePressed():!1:!1}getMouseButtonJustPressed(e){return this.mouse?e===y.LeftButton?this.mouse.isLeftMouseJustPressed():e===y.RightButton?this.mouse.isRightMouseJustPressed():!1:!1}getMouseButtonJustReleased(e){return this.mouse?e===y.LeftButton?this.mouse.isLeftMouseJustReleased():e===y.RightButton?this.mouse.isRightMouseJustReleased():!1:!1}getMouseAxis(e){return this.mouse?e===y.PositionX?this.mouse.getMousePosition().x:e===y.PositionY?this.mouse.getMousePosition().y:e===y.DeltaX?this.mouse.getMouseDelta().x:e===y.DeltaY?this.mouse.getMouseDelta().y:e===y.WheelDeltaY?this.mouse.getWheelDelta():0:0}getTouchAxis(e){if(!this.touch)return 0;if(e>=100&&e<200){let t=Math.floor((e-100)/2),s=(e-100)%2===1,n=this.touch.getTouchPosition(t);return n?s?n.y:n.x:0}return 0}getTouchZoneAxis(e){if(!this.touchZone)return 0;if(e>=100&&e<200){let t=Math.floor((e-100)/2),s=(e-100)%2===1;return this.touchZone.getZoneAxis(t,s?"y":"x")}return 0}getMotionAxis(e){if(!this.motion)return 0;switch(e){case M.AccelerometerX:return this.motion.getAccelerometer().x;case M.AccelerometerY:return this.motion.getAccelerometer().y;case M.AccelerometerZ:return this.motion.getAccelerometer().z;case M.GyroscopeAlpha:return this.motion.getGyroscope().alpha;case M.GyroscopeBeta:return this.motion.getGyroscope().beta;case M.GyroscopeGamma:return this.motion.getGyroscope().gamma;case M.OrientationAlpha:return this.motion.getOrientation().alpha??0;case M.OrientationBeta:return this.motion.getOrientation().beta??0;case M.OrientationGamma:return this.motion.getOrientation().gamma??0;case M.TiltX:return this.motion.getNormalizedTilt().x;case M.TiltY:return this.motion.getNormalizedTilt().y;case M.CompassHeading:return this.motion.getCompassHeading()??0;default:return 0}}getMotion(){return this.motion}getVibration(){return this.vibration}getMouseGridX(){if(!this.mouse)return 0;let e=this.mouse.getMousePosition().x,t=this.config.targetElement,s,n;if(t instanceof Window)s=t.innerWidth,n=0;else{let i=t.getBoundingClientRect();s=i.width,n=i.left}return s===0?0:Math.floor((e-n)/s*this.config.gridWidth)}getMouseGridY(){if(!this.mouse)return 0;let e=this.mouse.getMousePosition().y,t=this.config.targetElement,s,n;if(t instanceof Window)s=t.innerHeight,n=0;else{let i=t.getBoundingClientRect();s=i.height,n=i.top}return s===0?0:Math.floor((e-n)/s*this.config.gridHeight)}isMouseButtonDown(e){return this.mouse?e===0?this.mouse.isLeftMousePressed():e===1?this.mouse.isMiddleMousePressed():e===2?this.mouse.isRightMousePressed():!1:!1}getKeysPressed(){return this.keyboard?.getKeysJustPressed()??[]}getKeysHeld(){return this.keyboard?.getKeysHeld()??[]}setTouchZones(e){this.touchZone&&this.touchZone.setZones(e.map(t=>({id:t.zoneId,x:t.x,y:t.y,width:t.width,height:t.height})))}setTouchLayout(e,t,s,n){this.touchZone&&(this.touchZone.setTargetElement(e),this.touchZone.setLayout(t,s,n))}start(){this.keyboard?.start(),this.mouse?.start(),this.gamepad?.start(),this.touch?.start(),this.touchZone?.start(),this.motion?.start()}stop(){this.keyboard?.stop(),this.mouse?.stop(),this.gamepad?.stop(),this.touch?.stop(),this.touchZone?.stop(),this.motion?.stop()}reset(){this.keyboard?.reset(),this.mouse?.reset(),this.gamepad?.reset(),this.touch?.reset(),this.touchZone?.reset(),this.motion?.reset()}poll(){this.keyboard?.poll(),this.mouse?.poll(),this.gamepad?.poll(),this.touchZone?.poll(),this.touch?.poll(),this.touchZone?.updateFromTouches(),this.motion?.poll()}resetDelta(){this.keyboard?.resetDelta(),this.mouse?.resetDelta(),this.gamepad?.resetDelta(),this.touch?.resetDelta(),this.touchZone?.resetDelta(),this.motion?.resetDelta()}destroy(){this.stop(),this.keyboard?.destroy(),this.mouse?.destroy(),this.gamepad?.destroy(),this.touch?.destroy(),this.touchZone?.destroy(),this.motion?.destroy()}};import{InputDeviceType as r}from"@primitiv/types";var K=class b{static calculateRenderMetrics(e,t){let s=e.getBoundingClientRect(),n=e.width/e.height,i=s.width/s.height,o,a,u,l;n>i?(o=s.width,a=s.width/n,u=0,l=(s.height-a)/2):(o=s.height*n,a=s.height,u=(s.width-o)/2,l=0);let h=t?.offsetX||0,f=t?.offsetY||0;return u+=h,l+=f,o-=h*2,a-=f*2,{renderWidth:o,renderHeight:a,offsetX:u,offsetY:l,rect:s}}static collectAxisSources(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=0,a=!1;if(i.type===r.Keyboard&&i.negativeKey!==void 0&&i.positiveKey!==void 0){let u=t.getButton(r.Keyboard,i.negativeKey);t.getButton(r.Keyboard,i.positiveKey)&&(o+=1),u&&(o-=1),a=!0}else if(i.type===r.Mouse&&i.mouseAxis!==void 0)o=t.getAxis(r.Mouse,i.mouseAxis),a=!0;else if(i.type===r.Gamepad&&i.axis!==void 0)o=t.getAxis(r.Gamepad,i.axis),a=!0;else if(i.type===r.Touch&&i.touchId!==void 0&&i.touchAxis!==void 0){let u=100+i.touchId*2,l=i.touchAxis==="x"?u:u+1;o=t.getAxis(r.Touch,l),a=!0}else if(i.type===r.TouchZone&&i.touchZoneId!==void 0&&i.touchZoneAxis!==void 0){let u=100+i.touchZoneId*2,l=i.touchZoneAxis==="x"?u:u+1;o=t.getAxis(r.TouchZone,l),a=!0}else i.type===r.Motion&&i.motionAxis!==void 0&&(o=t.getAxis(r.Motion,i.motionAxis),a=!0);a&&s.set(i.sourceId,o)}return s}static collectButtonSources(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=!1,a=!1;i.type===r.Keyboard&&i.key!==void 0?(o=t.getButton(r.Keyboard,i.key),a=!0):i.type===r.Mouse&&i.mouseButton!==void 0?(o=t.getButton(r.Mouse,i.mouseButton),a=!0):i.type===r.Gamepad&&i.button!==void 0?(o=t.getButton(r.Gamepad,i.button),a=!0):i.type===r.Touch&&i.touchButton!==void 0?(o=t.getButton(r.Touch,i.touchButton),a=!0):i.type===r.TouchZone&&i.touchZoneId!==void 0&&(o=t.getButton(r.TouchZone,i.touchZoneId),a=!0),a&&s.set(i.sourceId,o)}return s}static collectButtonSourcesWithTransitions(e,t){let s=new Map;for(let n of e)for(let i of n.sources){if(s.has(i.sourceId))continue;let o=!1,a=!1,u=!1,l=!1;i.type===r.Keyboard&&i.key!==void 0?(o=t.getButton(r.Keyboard,i.key),a=t.getButtonJustPressed(r.Keyboard,i.key),u=t.getButtonJustReleased(r.Keyboard,i.key),l=!0):i.type===r.Mouse&&i.mouseButton!==void 0?(o=t.getButton(r.Mouse,i.mouseButton),a=t.getButtonJustPressed(r.Mouse,i.mouseButton),u=t.getButtonJustReleased(r.Mouse,i.mouseButton),l=!0):i.type===r.Gamepad&&i.button!==void 0?(o=t.getButton(r.Gamepad,i.button),a=t.getButtonJustPressed(r.Gamepad,i.button),u=t.getButtonJustReleased(r.Gamepad,i.button),l=!0):i.type===r.Touch&&i.touchButton!==void 0?(o=t.getButton(r.Touch,i.touchButton),a=t.getButtonJustPressed(r.Touch,i.touchButton),u=t.getButtonJustReleased(r.Touch,i.touchButton),l=!0):i.type===r.TouchZone&&i.touchZoneId!==void 0&&(o=t.getButton(r.TouchZone,i.touchZoneId),a=t.getButtonJustPressed(r.TouchZone,i.touchZoneId),u=t.getButtonJustReleased(r.TouchZone,i.touchZoneId),l=!0),l&&s.set(i.sourceId,{pressed:o,justPressed:a,justReleased:u})}return s}static collectMousePosition(e,t,s,n,i){let o=e.getAxis(r.Mouse,100),a=e.getAxis(r.Mouse,101),u=e.getButton(r.Mouse,0),{renderWidth:l,renderHeight:h,offsetX:f,offsetY:g,rect:E}=b.calculateRenderMetrics(t,i),m=o-E.left-f,p=a-E.top-g,T=l/s,x=h/n,c=Math.floor(m/T),C=Math.floor(p/x),k=m>=0&&m<l&&p>=0&&p<h;return{x:Math.max(0,Math.min(s-1,c)),y:Math.max(0,Math.min(n-1,C)),over:k,isLeftDown:u}}static collectTouchPositions(e,t,s,n,i=10,o){let a=[],{renderWidth:u,renderHeight:l,offsetX:h,offsetY:f,rect:g}=b.calculateRenderMetrics(t,o),E=u/s,m=l/n;for(let p=0;p<i;p++)if(e.getButton(r.Touch,p)){let x=100+p*2,c=100+p*2+1,C=e.getAxis(r.Touch,x),k=e.getAxis(r.Touch,c),G=C-g.left-h,S=k-g.top-f,Y=Math.floor(G/E),X=Math.floor(S/m),W=G>=0&&G<u&&S>=0&&S<l;a.push({id:p,x:Math.max(0,Math.min(s-1,Y)),y:Math.max(0,Math.min(n-1,X)),over:W})}return a}static collectTextInputs(e){return typeof e.getTextInputs=="function"?e.getTextInputs():[]}};export{v as BaseInputs,B as GamepadInputs,K as InputCollector,Z as InputRouter,D as KeyboardInputs,I as MobileVibration,H as MotionInputs,A as MouseInputs,L as TouchInputs,R as TouchZoneInputs,w as VibrationPatterns,ae as getMobileVibration};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@primitiv/input",
+  "version": "0.19.0",
+  "description": "Primitiv input module",
+  "author": "THP Software",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thp-software/primitiv",
+    "directory": "packages/input"
+  },
+  "homepage": "https://primitivengine.com",
+  "bugs": {
+    "url": "https://github.com/thp-software/primitiv/issues"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@primitiv/types": "0.19.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "rimraf dist && node ../../scripts/build-package.mjs packages/input",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings 0",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --import tsx src/**/*.test.ts"
+  }
+}