@babylonjs/core 5.28.0 → 5.30.0

package/Events/pointerEvents.d.ts

@@ -2,6 +2,7 @@ import type { Nullable } from "../types";
 import { Vector2 } from "../Maths/math.vector";
 import type { PickingInfo } from "../Collisions/pickingInfo";
 import type { IMouseEvent } from "./deviceInputEvents";
+import type { InputManager } from "../Inputs/scene.inputManager";
 declare type Ray = import("../Culling/ray").Ray;
 /**
  * Gather the list of pointer event types as constants.
@@ -102,21 +103,25 @@ export declare class PointerInfoPre extends PointerInfoBase {
  * The event member is an instance of PointerEvent for all types except PointerWheel and is of type MouseWheelEvent when type equals PointerWheel. The different event types can be found in the PointerEventTypes class.
  */
 export declare class PointerInfo extends PointerInfoBase {
+    private _pickInfo;
+    private _inputManager;
     /**
-     * Defines the picking info associated to the info (if any)\
+     * Defines the picking info associated with this PointerInfo object (if applicable)
      */
-    pickInfo: Nullable<PickingInfo>;
+    get pickInfo(): Nullable<PickingInfo>;
     /**
      * Instantiates a PointerInfo to store pointer related info to the onPointerObservable event.
      * @param type Defines the type of event (PointerEventTypes)
      * @param event Defines the related dom event
-     * @param pickInfo Defines the picking info associated to the info (if any)\
+     * @param pickInfo Defines the picking info associated to the info (if any)
+     * @param inputManager Defines the InputManager to use if there is no pickInfo
      */
-    constructor(type: number, event: IMouseEvent, 
+    constructor(type: number, event: IMouseEvent, pickInfo: Nullable<PickingInfo>, inputManager?: Nullable<InputManager>);
     /**
-     * Defines the picking info associated to the info (if any)\
+     * Generates the picking info if needed
      */
-    pickInfo: Nullable<PickingInfo>);
+    /** @internal */
+    _generatePickInfo(): void;
 }
 /**
  * Data relating to a touch event on the screen.

package/Events/pointerEvents.js

@@ -89,15 +89,33 @@ export class PointerInfo extends PointerInfoBase {
      * Instantiates a PointerInfo to store pointer related info to the onPointerObservable event.
      * @param type Defines the type of event (PointerEventTypes)
      * @param event Defines the related dom event
-     * @param pickInfo Defines the picking info associated to the info (if any)\
+     * @param pickInfo Defines the picking info associated to the info (if any)
+     * @param inputManager Defines the InputManager to use if there is no pickInfo
      */
-    constructor(type, event, 
+    constructor(type, event, pickInfo, inputManager = null) {
+        super(type, event);
+        this._pickInfo = pickInfo;
+        this._inputManager = inputManager;
+    }
     /**
-     * Defines the picking info associated to the info (if any)\
+     * Defines the picking info associated with this PointerInfo object (if applicable)
      */
-    pickInfo) {
-        super(type, event);
-        this.pickInfo = pickInfo;
+    get pickInfo() {
+        if (!this._pickInfo) {
+            this._generatePickInfo();
+        }
+        return this._pickInfo;
+    }
+    /**
+     * Generates the picking info if needed
+     */
+    /** @internal */
+    _generatePickInfo() {
+        if (this._inputManager) {
+            this._pickInfo = this._inputManager._pickMove(this.event.pointerId);
+            this._inputManager._setRayOnPointerInfo(this._pickInfo, this.event);
+            this._inputManager = null;
+        }
     }
 }
 //# sourceMappingURL=pointerEvents.js.map

package/Events/pointerEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointerEvents.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Events/pointerEvents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAM/C;;GAEG;AACH,MAAM,OAAO,iBAAiB;;AAC1B;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,2BAAS,GAAG,IAAI,CAAC;AACxC;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,8BAAY,GAAG,IAAI,CAAC;AAC3C;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,4BAAU,GAAG,IAAI,CAAC;AACzC;;GAEG;AACoB,kCAAgB,GAAG,IAAI,CAAC;AAGnD;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;;;OAIG;IACH;IACI;;OAEG;IACI,IAAY;IACnB;;OAEG;IACI,KAAkB;QAJlB,SAAI,GAAJ,IAAI,CAAQ;QAIZ,UAAK,GAAL,KAAK,CAAa;IAC1B,CAAC;CACP;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IA0B/C;;;;;;OAMG;IACH,YAAY,IAAY,EAAE,KAAkB,EAAE,MAAc,EAAE,MAAc;QACxE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAjCvB;;WAEG;QACI,QAAG,GAAkB,IAAI,CAAC;QAOjC;;WAEG;QACI,wBAAmB,GAA0B,IAAI,CAAC;QAqBrD,IAAI,CAAC,uBAAuB,GAAG,KAAK,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC5C;;;;;OAKG;IACH,YACI,IAAY,EACZ,KAAkB;IAClB;;OAEG;IACI,QAA+B;QAEtC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAFZ,aAAQ,GAAR,QAAQ,CAAuB;IAG1C,CAAC;CACJ","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { Vector2 } from \"../Maths/math.vector\";\r\nimport type { PickingInfo } from \"../Collisions/pickingInfo\";\r\nimport type { IMouseEvent } from \"./deviceInputEvents\";\r\n\r\ndeclare type Ray = import(\"../Culling/ray\").Ray;\r\n\r\n/**\r\n * Gather the list of pointer event types as constants.\r\n */\r\nexport class PointerEventTypes {\r\n    /**\r\n     * The pointerdown event is fired when a pointer becomes active. For mouse, it is fired when the device transitions from no buttons depressed to at least one button depressed. For touch, it is fired when physical contact is made with the digitizer. For pen, it is fired when the stylus makes physical contact with the digitizer.\r\n     */\r\n    public static readonly POINTERDOWN = 0x01;\r\n    /**\r\n     * The pointerup event is fired when a pointer is no longer active.\r\n     */\r\n    public static readonly POINTERUP = 0x02;\r\n    /**\r\n     * The pointermove event is fired when a pointer changes coordinates.\r\n     */\r\n    public static readonly POINTERMOVE = 0x04;\r\n    /**\r\n     * The pointerwheel event is fired when a mouse wheel has been rotated.\r\n     */\r\n    public static readonly POINTERWHEEL = 0x08;\r\n    /**\r\n     * The pointerpick event is fired when a mesh or sprite has been picked by the pointer.\r\n     */\r\n    public static readonly POINTERPICK = 0x10;\r\n    /**\r\n     * The pointertap event is fired when a the object has been touched and released without drag.\r\n     */\r\n    public static readonly POINTERTAP = 0x20;\r\n    /**\r\n     * The pointerdoubletap event is fired when a the object has been touched and released twice without drag.\r\n     */\r\n    public static readonly POINTERDOUBLETAP = 0x40;\r\n}\r\n\r\n/**\r\n * Base class of pointer info types.\r\n */\r\nexport class PointerInfoBase {\r\n    /**\r\n     * Instantiates the base class of pointers info.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     */\r\n    constructor(\r\n        /**\r\n         * Defines the type of event (PointerEventTypes)\r\n         */\r\n        public type: number,\r\n        /**\r\n         * Defines the related dom event\r\n         */\r\n        public event: IMouseEvent\r\n    ) {}\r\n}\r\n\r\n/**\r\n * This class is used to store pointer related info for the onPrePointerObservable event.\r\n * Set the skipOnPointerObservable property to true if you want the engine to stop any process after this event is triggered, even not calling onPointerObservable\r\n */\r\nexport class PointerInfoPre extends PointerInfoBase {\r\n    /**\r\n     * Ray from a pointer if available (eg. 6dof controller)\r\n     */\r\n    public ray: Nullable<Ray> = null;\r\n\r\n    /**\r\n     * Defines picking info coming from a near interaction (proximity instead of ray-based picking)\r\n     */\r\n    public nearInteractionPickingInfo: Nullable<PickingInfo>;\r\n\r\n    /**\r\n     * The original picking info that was used to trigger the pointer event\r\n     */\r\n    public originalPickingInfo: Nullable<PickingInfo> = null;\r\n\r\n    /**\r\n     * Defines the local position of the pointer on the canvas.\r\n     */\r\n    public localPosition: Vector2;\r\n\r\n    /**\r\n     * Defines whether the engine should skip the next OnPointerObservable associated to this pre.\r\n     */\r\n    public skipOnPointerObservable: boolean;\r\n\r\n    /**\r\n     * Instantiates a PointerInfoPre to store pointer related info to the onPrePointerObservable event.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     * @param localX Defines the local x coordinates of the pointer when the event occured\r\n     * @param localY Defines the local y coordinates of the pointer when the event occured\r\n     */\r\n    constructor(type: number, event: IMouseEvent, localX: number, localY: number) {\r\n        super(type, event);\r\n        this.skipOnPointerObservable = false;\r\n        this.localPosition = new Vector2(localX, localY);\r\n    }\r\n}\r\n\r\n/**\r\n * This type contains all the data related to a pointer event in Babylon.js.\r\n * The event member is an instance of PointerEvent for all types except PointerWheel and is of type MouseWheelEvent when type equals PointerWheel. The different event types can be found in the PointerEventTypes class.\r\n */\r\nexport class PointerInfo extends PointerInfoBase {\r\n    /**\r\n     * Instantiates a PointerInfo to store pointer related info to the onPointerObservable event.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     * @param pickInfo Defines the picking info associated to the info (if any)\\\r\n     */\r\n    constructor(\r\n        type: number,\r\n        event: IMouseEvent,\r\n        /**\r\n         * Defines the picking info associated to the info (if any)\\\r\n         */\r\n        public pickInfo: Nullable<PickingInfo>\r\n    ) {\r\n        super(type, event);\r\n    }\r\n}\r\n\r\n/**\r\n * Data relating to a touch event on the screen.\r\n */\r\nexport interface PointerTouch {\r\n    /**\r\n     * X coordinate of touch.\r\n     */\r\n    x: number;\r\n    /**\r\n     * Y coordinate of touch.\r\n     */\r\n    y: number;\r\n    /**\r\n     * Id of touch. Unique for each finger.\r\n     */\r\n    pointerId: number;\r\n    /**\r\n     * Event type passed from DOM.\r\n     */\r\n    type: any;\r\n}\r\n"]}
+{"version":3,"file":"pointerEvents.js","sourceRoot":"","sources":["../../../../../lts/core/generated/Events/pointerEvents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAO/C;;GAEG;AACH,MAAM,OAAO,iBAAiB;;AAC1B;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,2BAAS,GAAG,IAAI,CAAC;AACxC;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,8BAAY,GAAG,IAAI,CAAC;AAC3C;;GAEG;AACoB,6BAAW,GAAG,IAAI,CAAC;AAC1C;;GAEG;AACoB,4BAAU,GAAG,IAAI,CAAC;AACzC;;GAEG;AACoB,kCAAgB,GAAG,IAAI,CAAC;AAGnD;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB;;;;OAIG;IACH;IACI;;OAEG;IACI,IAAY;IACnB;;OAEG;IACI,KAAkB;QAJlB,SAAI,GAAJ,IAAI,CAAQ;QAIZ,UAAK,GAAL,KAAK,CAAa;IAC1B,CAAC;CACP;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IA0B/C;;;;;;OAMG;IACH,YAAY,IAAY,EAAE,KAAkB,EAAE,MAAc,EAAE,MAAc;QACxE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAjCvB;;WAEG;QACI,QAAG,GAAkB,IAAI,CAAC;QAOjC;;WAEG;QACI,wBAAmB,GAA0B,IAAI,CAAC;QAqBrD,IAAI,CAAC,uBAAuB,GAAG,KAAK,CAAC;QACrC,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IAc5C;;;;;;OAMG;IACH,YAAY,IAAY,EAAE,KAAkB,EAAE,QAA+B,EAAE,eAAuC,IAAI;QACtH,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACtC,CAAC;IArBD;;OAEG;IACH,IAAW,QAAQ;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACjB,IAAI,CAAC,iBAAiB,EAAE,CAAC;SAC5B;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAcD;;OAEG;IACH,gBAAgB;IACT,iBAAiB;QACpB,IAAI,IAAI,CAAC,aAAa,EAAE;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAE,IAAI,CAAC,KAAuB,CAAC,SAAS,CAAC,CAAC;YACvF,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACpE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;SAC7B;IACL,CAAC;CACJ","sourcesContent":["import type { Nullable } from \"../types\";\r\nimport { Vector2 } from \"../Maths/math.vector\";\r\nimport type { PickingInfo } from \"../Collisions/pickingInfo\";\r\nimport type { IMouseEvent, IPointerEvent } from \"./deviceInputEvents\";\r\nimport type { InputManager } from \"../Inputs/scene.inputManager\";\r\n\r\ndeclare type Ray = import(\"../Culling/ray\").Ray;\r\n\r\n/**\r\n * Gather the list of pointer event types as constants.\r\n */\r\nexport class PointerEventTypes {\r\n    /**\r\n     * The pointerdown event is fired when a pointer becomes active. For mouse, it is fired when the device transitions from no buttons depressed to at least one button depressed. For touch, it is fired when physical contact is made with the digitizer. For pen, it is fired when the stylus makes physical contact with the digitizer.\r\n     */\r\n    public static readonly POINTERDOWN = 0x01;\r\n    /**\r\n     * The pointerup event is fired when a pointer is no longer active.\r\n     */\r\n    public static readonly POINTERUP = 0x02;\r\n    /**\r\n     * The pointermove event is fired when a pointer changes coordinates.\r\n     */\r\n    public static readonly POINTERMOVE = 0x04;\r\n    /**\r\n     * The pointerwheel event is fired when a mouse wheel has been rotated.\r\n     */\r\n    public static readonly POINTERWHEEL = 0x08;\r\n    /**\r\n     * The pointerpick event is fired when a mesh or sprite has been picked by the pointer.\r\n     */\r\n    public static readonly POINTERPICK = 0x10;\r\n    /**\r\n     * The pointertap event is fired when a the object has been touched and released without drag.\r\n     */\r\n    public static readonly POINTERTAP = 0x20;\r\n    /**\r\n     * The pointerdoubletap event is fired when a the object has been touched and released twice without drag.\r\n     */\r\n    public static readonly POINTERDOUBLETAP = 0x40;\r\n}\r\n\r\n/**\r\n * Base class of pointer info types.\r\n */\r\nexport class PointerInfoBase {\r\n    /**\r\n     * Instantiates the base class of pointers info.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     */\r\n    constructor(\r\n        /**\r\n         * Defines the type of event (PointerEventTypes)\r\n         */\r\n        public type: number,\r\n        /**\r\n         * Defines the related dom event\r\n         */\r\n        public event: IMouseEvent\r\n    ) {}\r\n}\r\n\r\n/**\r\n * This class is used to store pointer related info for the onPrePointerObservable event.\r\n * Set the skipOnPointerObservable property to true if you want the engine to stop any process after this event is triggered, even not calling onPointerObservable\r\n */\r\nexport class PointerInfoPre extends PointerInfoBase {\r\n    /**\r\n     * Ray from a pointer if available (eg. 6dof controller)\r\n     */\r\n    public ray: Nullable<Ray> = null;\r\n\r\n    /**\r\n     * Defines picking info coming from a near interaction (proximity instead of ray-based picking)\r\n     */\r\n    public nearInteractionPickingInfo: Nullable<PickingInfo>;\r\n\r\n    /**\r\n     * The original picking info that was used to trigger the pointer event\r\n     */\r\n    public originalPickingInfo: Nullable<PickingInfo> = null;\r\n\r\n    /**\r\n     * Defines the local position of the pointer on the canvas.\r\n     */\r\n    public localPosition: Vector2;\r\n\r\n    /**\r\n     * Defines whether the engine should skip the next OnPointerObservable associated to this pre.\r\n     */\r\n    public skipOnPointerObservable: boolean;\r\n\r\n    /**\r\n     * Instantiates a PointerInfoPre to store pointer related info to the onPrePointerObservable event.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     * @param localX Defines the local x coordinates of the pointer when the event occured\r\n     * @param localY Defines the local y coordinates of the pointer when the event occured\r\n     */\r\n    constructor(type: number, event: IMouseEvent, localX: number, localY: number) {\r\n        super(type, event);\r\n        this.skipOnPointerObservable = false;\r\n        this.localPosition = new Vector2(localX, localY);\r\n    }\r\n}\r\n\r\n/**\r\n * This type contains all the data related to a pointer event in Babylon.js.\r\n * The event member is an instance of PointerEvent for all types except PointerWheel and is of type MouseWheelEvent when type equals PointerWheel. The different event types can be found in the PointerEventTypes class.\r\n */\r\nexport class PointerInfo extends PointerInfoBase {\r\n    private _pickInfo: Nullable<PickingInfo>;\r\n    private _inputManager: Nullable<InputManager>;\r\n\r\n    /**\r\n     * Defines the picking info associated with this PointerInfo object (if applicable)\r\n     */\r\n    public get pickInfo(): Nullable<PickingInfo> {\r\n        if (!this._pickInfo) {\r\n            this._generatePickInfo();\r\n        }\r\n\r\n        return this._pickInfo;\r\n    }\r\n    /**\r\n     * Instantiates a PointerInfo to store pointer related info to the onPointerObservable event.\r\n     * @param type Defines the type of event (PointerEventTypes)\r\n     * @param event Defines the related dom event\r\n     * @param pickInfo Defines the picking info associated to the info (if any)\r\n     * @param inputManager Defines the InputManager to use if there is no pickInfo\r\n     */\r\n    constructor(type: number, event: IMouseEvent, pickInfo: Nullable<PickingInfo>, inputManager: Nullable<InputManager> = null) {\r\n        super(type, event);\r\n        this._pickInfo = pickInfo;\r\n        this._inputManager = inputManager;\r\n    }\r\n\r\n    /**\r\n     * Generates the picking info if needed\r\n     */\r\n    /** @internal */\r\n    public _generatePickInfo(): void {\r\n        if (this._inputManager) {\r\n            this._pickInfo = this._inputManager._pickMove((this.event as IPointerEvent).pointerId);\r\n            this._inputManager._setRayOnPointerInfo(this._pickInfo, this.event);\r\n            this._inputManager = null;\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Data relating to a touch event on the screen.\r\n */\r\nexport interface PointerTouch {\r\n    /**\r\n     * X coordinate of touch.\r\n     */\r\n    x: number;\r\n    /**\r\n     * Y coordinate of touch.\r\n     */\r\n    y: number;\r\n    /**\r\n     * Id of touch. Unique for each finger.\r\n     */\r\n    pointerId: number;\r\n    /**\r\n     * Event type passed from DOM.\r\n     */\r\n    type: any;\r\n}\r\n"]}

package/IAccessibilityTag.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Define an interface for a node to indicate it's info for accessibility.
+ * By default, Node type doesn't imply accessibility info unless this tag is assigned. Whereas GUI controls already indicate accessibility info, but one can override the info using this tag.
+ */
+export interface IAccessibilityTag {
+    /**
+     * A string as alt text of the node, describing what the node is/does, for accessibility purpose.
+     */
+    description?: string;
+    /**
+     * Customize the event of the accessible object.
+     * This will be applied on the generated HTML twin node.
+     */
+    eventHandler?: {
+        [key in keyof HTMLElementEventMap]: (e?: Event) => void;
+    };
+    /**
+     * ARIA roles and attributes to customize accessibility support.
+     * If you use BabylonJS's accessibility html twin renderer, and want to override the default behavior (not suggested), this can be your way.
+     * Learn more about ARIA: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA
+     */
+    role?: AcceptedRole;
+    aria?: {
+        [key in AcceptedARIA]: any;
+    };
+}
+declare type AcceptedRole = "toolbar" | "tooltip" | "feed" | "math" | "presentation" | "none" | "note" | "application" | "article" | "cell" | "columnheader" | "definition" | "directory" | "document" | "figure" | "group" | "heading" | "img" | "list" | "listitem" | "meter" | "row" | "rowgroup" | "rowheader" | "separator" | "table" | "term" | "scrollbar" | "searchbox" | "separator" | "slider" | "spinbutton" | "switch" | "tab" | "tabpanel" | "treeitem" | "combobox" | "menu" | "menubar" | "tablist" | "tree" | "treegrid" | "banner" | "complementary" | "contentinfo" | "form" | "main" | "navigation" | "region" | "search" | "alert" | "log" | "marquee" | "status" | "timer" | "alertdialog" | "dialog";
+declare type AcceptedARIA = "aria-autocomplete" | "aria-checked" | "aria-disabled" | "aria-errormessage" | "aria-expanded" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-label" | "aria-level" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-placeholder" | "aria-pressed" | "aria-readonly" | "aria-required" | "aria-selected" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "aria-busy" | "aria-live" | "aria-relevant" | "aria-atomic" | "aria-dropeffect" | "aria-grabbed" | "aria-activedescendant" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-describedby" | "aria-description" | "aria-details" | "aria-errormessage" | "aria-flowto" | "aria-labelledby" | "aria-owns" | "aria-posinset" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-setsize";
+export {};

package/IAccessibilityTag.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IAccessibilityTag.js.map

package/IAccessibilityTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAccessibilityTag.js","sourceRoot":"","sources":["../../../../lts/core/generated/IAccessibilityTag.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * Define an interface for a node to indicate it's info for accessibility.\r\n * By default, Node type doesn't imply accessibility info unless this tag is assigned. Whereas GUI controls already indicate accessibility info, but one can override the info using this tag.\r\n */\r\nexport interface IAccessibilityTag {\r\n    /**\r\n     * A string as alt text of the node, describing what the node is/does, for accessibility purpose.\r\n     */\r\n    description?: string;\r\n\r\n    /**\r\n     * Customize the event of the accessible object.\r\n     * This will be applied on the generated HTML twin node.\r\n     */\r\n    eventHandler?: { [key in keyof HTMLElementEventMap]: (e?: Event) => void };\r\n\r\n    /**\r\n     * ARIA roles and attributes to customize accessibility support.\r\n     * If you use BabylonJS's accessibility html twin renderer, and want to override the default behavior (not suggested), this can be your way.\r\n     * Learn more about ARIA: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA\r\n     */\r\n    role?: AcceptedRole;\r\n    aria?: { [key in AcceptedARIA]: any };\r\n}\r\n\r\n// Based on https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles\r\ntype AcceptedRole =\r\n    | \"toolbar\"\r\n    | \"tooltip\"\r\n    | \"feed\"\r\n    | \"math\"\r\n    | \"presentation\"\r\n    | \"none\"\r\n    | \"note\"\r\n    | \"application\"\r\n    | \"article\"\r\n    | \"cell\"\r\n    | \"columnheader\"\r\n    | \"definition\"\r\n    | \"directory\"\r\n    | \"document\"\r\n    | \"figure\"\r\n    | \"group\"\r\n    | \"heading\"\r\n    | \"img\"\r\n    | \"list\"\r\n    | \"listitem\"\r\n    | \"meter\"\r\n    | \"row\"\r\n    | \"rowgroup\"\r\n    | \"rowheader\"\r\n    | \"separator\"\r\n    | \"table\"\r\n    | \"term\"\r\n    | \"scrollbar\"\r\n    | \"searchbox\"\r\n    | \"separator\"\r\n    | \"slider\"\r\n    | \"spinbutton\"\r\n    | \"switch\"\r\n    | \"tab\"\r\n    | \"tabpanel\"\r\n    | \"treeitem\"\r\n    | \"combobox\"\r\n    | \"menu\"\r\n    | \"menubar\"\r\n    | \"tablist\"\r\n    | \"tree\"\r\n    | \"treegrid\"\r\n    | \"banner\"\r\n    | \"complementary\"\r\n    | \"contentinfo\"\r\n    | \"form\"\r\n    | \"main\"\r\n    | \"navigation\"\r\n    | \"region\"\r\n    | \"search\"\r\n    | \"alert\"\r\n    | \"log\"\r\n    | \"marquee\"\r\n    | \"status\"\r\n    | \"timer\"\r\n    | \"alertdialog\"\r\n    | \"dialog\";\r\n\r\n// Based on https://developer.mozilla.org/en-US/docs/web/Accessibility/ARIA/Attributes#aria_attribute_types\r\ntype AcceptedARIA =\r\n    | \"aria-autocomplete\"\r\n    | \"aria-checked\"\r\n    | \"aria-disabled\"\r\n    | \"aria-errormessage\"\r\n    | \"aria-expanded\"\r\n    | \"aria-haspopup\"\r\n    | \"aria-hidden\"\r\n    | \"aria-invalid\"\r\n    | \"aria-label\"\r\n    | \"aria-level\"\r\n    | \"aria-modal\"\r\n    | \"aria-multiline\"\r\n    | \"aria-multiselectable\"\r\n    | \"aria-orientation\"\r\n    | \"aria-placeholder\"\r\n    | \"aria-pressed\"\r\n    | \"aria-readonly\"\r\n    | \"aria-required\"\r\n    | \"aria-selected\"\r\n    | \"aria-sort\"\r\n    | \"aria-valuemax\"\r\n    | \"aria-valuemin\"\r\n    | \"aria-valuenow\"\r\n    | \"aria-valuetext\"\r\n    | \"aria-busy\"\r\n    | \"aria-live\"\r\n    | \"aria-relevant\"\r\n    | \"aria-atomic\"\r\n    | \"aria-dropeffect\"\r\n    | \"aria-grabbed\"\r\n    | \"aria-activedescendant\"\r\n    | \"aria-colcount\"\r\n    | \"aria-colindex\"\r\n    | \"aria-colspan\"\r\n    | \"aria-controls\"\r\n    | \"aria-describedby\"\r\n    | \"aria-description\"\r\n    | \"aria-details\"\r\n    | \"aria-errormessage\"\r\n    | \"aria-flowto\"\r\n    | \"aria-labelledby\"\r\n    | \"aria-owns\"\r\n    | \"aria-posinset\"\r\n    | \"aria-rowcount\"\r\n    | \"aria-rowindex\"\r\n    | \"aria-rowspan\"\r\n    | \"aria-setsize\";\r\n"]}

package/Inputs/scene.inputManager.d.ts

@@ -2,6 +2,7 @@ import type { Nullable } from "../types";
 import { PickingInfo } from "../Collisions/pickingInfo";
 import { Vector2 } from "../Maths/math.vector";
 import type { AbstractMesh } from "../Meshes/abstractMesh";
+import type { IMouseEvent } from "../Events/deviceInputEvents";
 declare type Scene = import("../scene").Scene;
 /**
  * Class used to manage all inputs for the scene.
@@ -32,6 +33,8 @@ export declare class InputManager {
     private _previousPickResult;
     private _totalPointersPressed;
     private _doubleClickOccured;
+    private _isSwiping;
+    private _swipeButtonPressed;
     private _pointerOverMesh;
     private _pickedDownMesh;
     private _pickedUpMesh;
@@ -45,6 +48,7 @@ export declare class InputManager {
     private _previousStartingPointerTime;
     private _pointerCaptures;
     private _meshUnderPointerId;
+    private _movePointerInfo;
     private _onKeyDown;
     private _onKeyUp;
     private _scene;
@@ -84,8 +88,12 @@ export declare class InputManager {
     set pointerY(value: number);
     private _updatePointerPosition;
     private _processPointerMove;
-    private _setRayOnPointerInfo;
+    /** @internal */
+    _setRayOnPointerInfo(pickInfo: Nullable<PickingInfo>, event: IMouseEvent): void;
     private _checkPrePointerObservable;
+    /** @internal */
+    _pickMove(pointerId: number): PickingInfo;
+    private _setCursorAndPointerOverMesh;
     /**
      * Use this method to simulate a pointer move on a mesh
      * The pickResult parameter can be obtained from a scene.pick or scene.pickWithRay

package/Inputs/scene.inputManager.js

@@ -58,6 +58,8 @@ export class InputManager {
         this._previousPickResult = null;
         this._totalPointersPressed = 0;
         this._doubleClickOccured = false;
+        this._isSwiping = false;
+        this._swipeButtonPressed = -1;
         this._pointerX = 0;
         this._pointerY = 0;
         this._startingPointerPosition = new Vector2(0, 0);
@@ -66,6 +68,7 @@ export class InputManager {
         this._previousStartingPointerTime = 0;
         this._pointerCaptures = {};
         this._meshUnderPointerId = {};
+        this._movePointerInfo = null;
         this._deviceSourceManager = null;
         this._scene = scene || EngineStore.LastCreatedScene;
         if (!this._scene) {
@@ -77,6 +80,13 @@ export class InputManager {
      * @returns Mesh that the pointer is pointer is hovering over
      */
     get meshUnderPointer() {
+        if (this._movePointerInfo) {
+            // Because _pointerOverMesh is populated as part of _pickMove, we need to force a pick to update it.
+            // Calling _pickMove calls _setCursorAndPointerOverMesh which calls setPointerOverMesh
+            this._movePointerInfo._generatePickInfo();
+            // Once we have what we need, we can clear _movePointerInfo because we don't need it anymore
+            this._movePointerInfo = null;
+        }
         return this._pointerOverMesh;
     }
     /**
@@ -135,40 +145,37 @@ export class InputManager {
                 canvas.style.cursor = scene.defaultCursor;
             }
         }
-        const isMeshPicked = pickResult && pickResult.hit && pickResult.pickedMesh ? true : false;
-        if (isMeshPicked) {
-            scene.setPointerOverMesh(pickResult.pickedMesh, evt.pointerId, pickResult);
-            if (!scene.doNotHandleCursors && canvas && this._pointerOverMesh) {
-                const actionManager = this._pointerOverMesh._getActionManagerForTrigger();
-                if (actionManager && actionManager.hasPointerTriggers) {
-                    canvas.style.cursor = actionManager.hoverCursor || scene.hoverCursor;
-                }
-            }
-        }
-        else {
-            scene.setPointerOverMesh(null, evt.pointerId, pickResult);
-        }
+        this._setCursorAndPointerOverMesh(pickResult, evt.pointerId, scene);
         for (const step of scene._pointerMoveStage) {
+            const isMeshPicked = (pickResult === null || pickResult === void 0 ? void 0 : pickResult.pickedMesh) ? true : false;
             pickResult = step.action(this._unTranslatedPointerX, this._unTranslatedPointerY, pickResult, isMeshPicked, canvas);
         }
+        const type = evt.inputIndex >= PointerInput.MouseWheelX && evt.inputIndex <= PointerInput.MouseWheelZ ? PointerEventTypes.POINTERWHEEL : PointerEventTypes.POINTERMOVE;
+        if (scene.onPointerMove) {
+            // Because of lazy picking, we need to force a pick to update the pickResult
+            const pr = pickResult ? pickResult : this._pickMove(evt.pointerId);
+            scene.onPointerMove(evt, pr, type);
+        }
+        let pointerInfo;
         if (pickResult) {
-            const type = evt.inputIndex >= PointerInput.MouseWheelX && evt.inputIndex <= PointerInput.MouseWheelZ ? PointerEventTypes.POINTERWHEEL : PointerEventTypes.POINTERMOVE;
-            if (scene.onPointerMove) {
-                scene.onPointerMove(evt, pickResult, type);
-            }
-            if (scene.onPointerObservable.hasObservers()) {
-                const pi = new PointerInfo(type, evt, pickResult);
-                this._setRayOnPointerInfo(pi);
-                scene.onPointerObservable.notifyObservers(pi, type);
-            }
+            pointerInfo = new PointerInfo(type, evt, pickResult);
+            this._setRayOnPointerInfo(pickResult, evt);
+        }
+        else {
+            pointerInfo = new PointerInfo(type, evt, null, this);
+            this._movePointerInfo = pointerInfo;
+        }
+        if (scene.onPointerObservable.hasObservers()) {
+            scene.onPointerObservable.notifyObservers(pointerInfo, type);
         }
     }
     // Pointers handling
-    _setRayOnPointerInfo(pointerInfo) {
+    /** @internal */
+    _setRayOnPointerInfo(pickInfo, event) {
         const scene = this._scene;
-        if (pointerInfo.pickInfo && !pointerInfo.pickInfo._pickingUnavailable) {
-            if (!pointerInfo.pickInfo.ray) {
-                pointerInfo.pickInfo.ray = scene.createPickingRay(pointerInfo.event.offsetX, pointerInfo.event.offsetY, Matrix.Identity(), scene.activeCamera);
+        if (pickInfo && scene._pickingAvailable) {
+            if (!pickInfo.ray) {
+                pickInfo.ray = scene.createPickingRay(event.offsetX, event.offsetY, Matrix.Identity(), scene.activeCamera);
             }
         }
     }
@@ -190,6 +197,29 @@ export class InputManager {
             return false;
         }
     }
+    /** @internal */
+    _pickMove(pointerId) {
+        const scene = this._scene;
+        const pickResult = scene.pick(this._unTranslatedPointerX, this._unTranslatedPointerY, scene.pointerMovePredicate, false, scene.cameraToUseForPointers, scene.pointerMoveTrianglePredicate);
+        this._setCursorAndPointerOverMesh(pickResult, pointerId, scene);
+        return pickResult;
+    }
+    _setCursorAndPointerOverMesh(pickResult, pointerId, scene) {
+        const engine = scene.getEngine();
+        const canvas = engine.getInputElement();
+        if (pickResult === null || pickResult === void 0 ? void 0 : pickResult.pickedMesh) {
+            this.setPointerOverMesh(pickResult.pickedMesh, pointerId, pickResult);
+            if (!scene.doNotHandleCursors && canvas && this._pointerOverMesh) {
+                const actionManager = this._pointerOverMesh._getActionManagerForTrigger();
+                if (actionManager && actionManager.hasPointerTriggers) {
+                    canvas.style.cursor = actionManager.hoverCursor || scene.hoverCursor;
+                }
+            }
+        }
+        else {
+            this.setPointerOverMesh(null, pointerId, pickResult);
+        }
+    }
     /**
      * Use this method to simulate a pointer move on a mesh
      * The pickResult parameter can be obtained from a scene.pick or scene.pickWithRay
@@ -268,7 +298,7 @@ export class InputManager {
             }
             if (scene.onPointerObservable.hasObservers()) {
                 const pi = new PointerInfo(type, evt, pickResult);
-                this._setRayOnPointerInfo(pi);
+                this._setRayOnPointerInfo(pickResult, evt);
                 scene.onPointerObservable.notifyObservers(pi, type);
             }
         }
@@ -278,8 +308,7 @@ export class InputManager {
      * @internals Boolean if delta for pointer exceeds drag movement threshold
      */
     _isPointerSwiping() {
-        return (Math.abs(this._startingPointerPosition.x - this._pointerX) > InputManager.DragMovementThreshold ||
-            Math.abs(this._startingPointerPosition.y - this._pointerY) > InputManager.DragMovementThreshold);
+        return this._isSwiping;
     }
     /**
      * Use this method to simulate a pointer up on a mesh
@@ -314,7 +343,7 @@ export class InputManager {
                 if (clickInfo.singleClick && !clickInfo.ignore && scene.onPointerObservable.hasObservers()) {
                     const type = PointerEventTypes.POINTERPICK;
                     const pi = new PointerInfo(type, evt, pickResult);
-                    this._setRayOnPointerInfo(pi);
+                    this._setRayOnPointerInfo(pickResult, evt);
                     scene.onPointerObservable.notifyObservers(pi, type);
                 }
             }
@@ -354,14 +383,14 @@ export class InputManager {
                 }
                 if (type) {
                     const pi = new PointerInfo(type, evt, pickResult);
-                    this._setRayOnPointerInfo(pi);
+                    this._setRayOnPointerInfo(pickResult, evt);
                     scene.onPointerObservable.notifyObservers(pi, type);
                 }
             }
             if (!clickInfo.ignore) {
                 type = PointerEventTypes.POINTERUP;
                 const pi = new PointerInfo(type, evt, pickResult);
-                this._setRayOnPointerInfo(pi);
+                this._setRayOnPointerInfo(pickResult, evt);
                 scene.onPointerObservable.notifyObservers(pi, type);
             }
         }
@@ -400,7 +429,7 @@ export class InputManager {
         // Because this is only called from _initClickEvent, which is called in _onPointerUp, we'll use the pointerUpPredicate for the pick call
         this._initActionManager = (act) => {
             if (!this._meshPickProceed) {
-                const pickResult = scene.skipPointerUpPicking
+                const pickResult = scene.skipPointerUpPicking || (scene._registeredActions === 0 && !scene.onPointerObservable.hasObservers())
                     ? null
                     : scene.pick(this._unTranslatedPointerX, this._unTranslatedPointerY, scene.pointerUpPredicate, false, scene.cameraToUseForPointers);
                 this._currentPickResult = pickResult;
@@ -547,8 +576,13 @@ export class InputManager {
                     (mesh.enablePointerMoveEvents || scene.constantlyUpdateMeshUnderPointer || mesh._getActionManagerForTrigger() !== null) &&
                     (!scene.cameraToUseForPointers || (scene.cameraToUseForPointers.layerMask & mesh.layerMask) !== 0);
             }
-            // Meshes
-            const pickResult = scene.pick(this._unTranslatedPointerX, this._unTranslatedPointerY, scene.pointerMovePredicate, false, scene.cameraToUseForPointers, scene.pointerMoveTrianglePredicate);
+            // Check if pointer leaves DragMovementThreshold range to determine if swipe is occurring
+            if (!this._isSwiping && this._swipeButtonPressed !== -1) {
+                this._isSwiping =
+                    Math.abs(this._startingPointerPosition.x - this._pointerX) > InputManager.DragMovementThreshold ||
+                        Math.abs(this._startingPointerPosition.y - this._pointerY) > InputManager.DragMovementThreshold;
+            }
+            const pickResult = scene._registeredActions > 0 ? this._pickMove(evt.pointerId) : null;
             this._processPointerMove(pickResult, evt);
         };
         this._onPointerDown = (evt) => {
@@ -560,6 +594,9 @@ export class InputManager {
                 evt.pointerId = 0;
             }
             this._updatePointerPosition(evt);
+            if (this._swipeButtonPressed === -1) {
+                this._swipeButtonPressed = evt.button;
+            }
             if (scene.preventDefaultOnPointerDown && elementToAttachTo) {
                 evt.preventDefault();
                 elementToAttachTo.focus();
@@ -587,7 +624,7 @@ export class InputManager {
             // Meshes
             this._pickedDownMesh = null;
             let pickResult;
-            if (scene.skipPointerDownPicking) {
+            if (scene.skipPointerDownPicking || (scene._registeredActions === 0 && !scene.onPointerObservable.hasObservers())) {
                 pickResult = new PickingInfo();
             }
             else {
@@ -629,6 +666,11 @@ export class InputManager {
                             }
                         }
                         if (this._checkPrePointerObservable(null, evt, PointerEventTypes.POINTERUP)) {
+                            // If we're skipping the next observable, we need to reset the swipe state before returning
+                            if (this._swipeButtonPressed === evt.button) {
+                                this._isSwiping = false;
+                                this._swipeButtonPressed = -1;
+                            }
                             return;
                         }
                     }
@@ -655,6 +697,10 @@ export class InputManager {
                 }
                 this._processPointerUp(pickResult, evt, clickInfo);
                 this._previousPickResult = this._currentPickResult;
+                if (this._swipeButtonPressed === evt.button) {
+                    this._isSwiping = false;
+                    this._swipeButtonPressed = -1;
+                }
             });
         };
         this._onKeyDown = (evt) => {
@@ -798,7 +844,7 @@ export class InputManager {
      * @returns a Mesh or null if no mesh is under the pointer
      */
     getPointerOverMesh() {
-        return this._pointerOverMesh;
+        return this.meshUnderPointer;
     }
     /**
      * @param mesh - Mesh to invalidate