Add optional chaining to event method calls

Replaced direct method calls on event objects with optional chaining to prevent errors if methods are undefined. Updated documentation for the dispose method to clarify its behavior. Updated build artifacts and documentation accordingly.

Author: jonobr1

build/two.js

@@ -1220,7 +1220,7 @@ var Two = (() => {
      * @name Two.PublishDate
      * @property {String} - The automatically generated publish date in the build process to verify version release candidates.
      */
-    PublishDate: "2025-12-05T06:10:07.715Z",
+    PublishDate: "2025-12-22T19:56:52.386Z",
     /**
      * @name Two.Identifier
      * @property {String} - String prefix for all Two.js object's ids. This trickles down to SVG ids.
@@ -1785,34 +1785,34 @@ var Two = (() => {
       this.#events._bound = v;
     }
     addEventListener() {
-      return this.#events.addEventListener.apply(this, arguments);
+      return this.#events.addEventListener?.apply(this, arguments);
     }
     on() {
-      return this.#events.on.apply(this, arguments);
+      return this.#events.on?.apply(this, arguments);
     }
     bind() {
-      return this.#events.bind.apply(this, arguments);
+      return this.#events.bind?.apply(this, arguments);
     }
     removeEventListener() {
-      return this.#events.removeEventListener.apply(this, arguments);
+      return this.#events.removeEventListener?.apply(this, arguments);
     }
     off() {
-      return this.#events.off.apply(this, arguments);
+      return this.#events.off?.apply(this, arguments);
     }
     unbind() {
-      return this.#events.unbind.apply(this, arguments);
+      return this.#events.unbind?.apply(this, arguments);
     }
     dispatchEvent() {
-      return this.#events.dispatchEvent.apply(this, arguments);
+      return this.#events.dispatchEvent?.apply(this, arguments);
     }
     trigger() {
-      return this.#events.trigger.apply(this, arguments);
+      return this.#events.trigger?.apply(this, arguments);
     }
     listen() {
-      return this.#events.listen.apply(this, arguments);
+      return this.#events.listen?.apply(this, arguments);
     }
     ignore() {
-      return this.#events.ignore.apply(this, arguments);
+      return this.#events.ignore?.apply(this, arguments);
     }
     constructor() {
       super();
@@ -4139,8 +4139,7 @@ var Two = (() => {
     /**
      * @name Two.Shape#dispose
      * @function
-     * @description Release the element's renderer object and detach any events.
-     * This cleans up renderer-specific resources and unbinds all event listeners.
+     * @description Release the shape's bound objects by unbinding relevant events.
      */
     dispose() {
       super.dispose();
@@ -15624,34 +15623,34 @@ var Two = (() => {
       this._events._bound = v;
     }
     addEventListener() {
-      return this._events.addEventListener.apply(this, arguments);
+      return this._events.addEventListener?.apply(this, arguments);
     }
     on() {
-      return this._events.addEventListener.apply(this, arguments);
+      return this._events.addEventListener?.apply(this, arguments);
     }
     bind() {
-      return this._events.addEventListener.apply(this, arguments);
+      return this._events.addEventListener?.apply(this, arguments);
     }
     removeEventListener() {
-      return this._events.removeEventListener.apply(this, arguments);
+      return this._events.removeEventListener?.apply(this, arguments);
     }
     off() {
-      return this._events.removeEventListener.apply(this, arguments);
+      return this._events.removeEventListener?.apply(this, arguments);
     }
     unbind() {
-      return this._events.removeEventListener.apply(this, arguments);
+      return this._events.removeEventListener?.apply(this, arguments);
     }
     dispatchEvent() {
-      return this._events.dispatchEvent.apply(this, arguments);
+      return this._events.dispatchEvent?.apply(this, arguments);
     }
     trigger() {
-      return this._events.dispatchEvent.apply(this, arguments);
+      return this._events.dispatchEvent?.apply(this, arguments);
     }
     listen() {
-      return this._events.listen.apply(this, arguments);
+      return this._events.listen?.apply(this, arguments);
     }
     ignore() {
-      return this._events.ignore.apply(this, arguments);
+      return this._events.ignore?.apply(this, arguments);
     }
     /**
      * @name Two#type

build/two.min.js

@@ -1228,7 +1228,7 @@ var Constants = {
    * @name Two.PublishDate
    * @property {String} - The automatically generated publish date in the build process to verify version release candidates.
    */
-  PublishDate: "2025-12-05T06:10:07.715Z",
+  PublishDate: "2025-12-22T19:56:52.386Z",
   /**
    * @name Two.Identifier
    * @property {String} - String prefix for all Two.js object's ids. This trickles down to SVG ids.
@@ -1804,34 +1804,44 @@ var Collection = class extends Array {
     __privateGet(this, _events)._bound = v;
   }
   addEventListener() {
-    return __privateGet(this, _events).addEventListener.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).addEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   on() {
-    return __privateGet(this, _events).on.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).on) == null ? void 0 : _a.apply(this, arguments);
   }
   bind() {
-    return __privateGet(this, _events).bind.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).bind) == null ? void 0 : _a.apply(this, arguments);
   }
   removeEventListener() {
-    return __privateGet(this, _events).removeEventListener.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).removeEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   off() {
-    return __privateGet(this, _events).off.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).off) == null ? void 0 : _a.apply(this, arguments);
   }
   unbind() {
-    return __privateGet(this, _events).unbind.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).unbind) == null ? void 0 : _a.apply(this, arguments);
   }
   dispatchEvent() {
-    return __privateGet(this, _events).dispatchEvent.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).dispatchEvent) == null ? void 0 : _a.apply(this, arguments);
   }
   trigger() {
-    return __privateGet(this, _events).trigger.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).trigger) == null ? void 0 : _a.apply(this, arguments);
   }
   listen() {
-    return __privateGet(this, _events).listen.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).listen) == null ? void 0 : _a.apply(this, arguments);
   }
   ignore() {
-    return __privateGet(this, _events).ignore.apply(this, arguments);
+    var _a;
+    return (_a = __privateGet(this, _events).ignore) == null ? void 0 : _a.apply(this, arguments);
   }
   pop() {
     const popped = super.pop.apply(this, arguments);
@@ -4147,8 +4157,7 @@ var _Shape = class _Shape extends Element {
   /**
    * @name Two.Shape#dispose
    * @function
-   * @description Release the element's renderer object and detach any events.
-   * This cleans up renderer-specific resources and unbinds all event listeners.
+   * @description Release the shape's bound objects by unbinding relevant events.
    */
   dispose() {
     super.dispose();
@@ -15769,34 +15778,44 @@ var _Two = class _Two {
     this._events._bound = v;
   }
   addEventListener() {
-    return this._events.addEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.addEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   on() {
-    return this._events.addEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.addEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   bind() {
-    return this._events.addEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.addEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   removeEventListener() {
-    return this._events.removeEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.removeEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   off() {
-    return this._events.removeEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.removeEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   unbind() {
-    return this._events.removeEventListener.apply(this, arguments);
+    var _a;
+    return (_a = this._events.removeEventListener) == null ? void 0 : _a.apply(this, arguments);
   }
   dispatchEvent() {
-    return this._events.dispatchEvent.apply(this, arguments);
+    var _a;
+    return (_a = this._events.dispatchEvent) == null ? void 0 : _a.apply(this, arguments);
   }
   trigger() {
-    return this._events.dispatchEvent.apply(this, arguments);
+    var _a;
+    return (_a = this._events.dispatchEvent) == null ? void 0 : _a.apply(this, arguments);
   }
   listen() {
-    return this._events.listen.apply(this, arguments);
+    var _a;
+    return (_a = this._events.listen) == null ? void 0 : _a.apply(this, arguments);
   }
   ignore() {
-    return this._events.ignore.apply(this, arguments);
+    var _a;
+    return (_a = this._events.ignore) == null ? void 0 : _a.apply(this, arguments);
   }
   /**
    * @name Two#appendTo

build/two.module.js

@@ -11,8 +11,11 @@ All notable changes to this project will be documented in this file. The format
 
 <carbon-ads />
 
-## Nightly
+## December 22, 2025 v0.8.23
 
+<h3 class="visible">Dec 22, 2025</h3><version-link v="v0.8.23" />
+
+- Made `Two.Event` private getter more relaxed
 - Added `Two.Shape.dispose`
 - Added test suite for `dispose` methods
 

wiki/changelog/README.md

@@ -30,7 +30,7 @@ A convenient package to display still or animated images organized as a series o
 
 | Argument | Description |
 | ---- | ----------- |
-|  paths  | A list of URLs or [Two.Texture](/docs/effects/texture/)s. |
+|  src  | A list of URLs or [Two.Texture](/docs/effects/texture/)s. |
 |  ox  | The initial `x` position of the Two.ImageSequence. |
 |  oy  | The initial `y` position of the Two.ImageSequence. |
 |  frameRate  | The frame rate at which the images should playback at. |

wiki/docs/effects/image-sequence/README.md

@@ -30,7 +30,7 @@ A convenient package to display images scaled to fit specific dimensions. Unlike
 
 | Argument | Description |
 | ---- | ----------- |
-|  path  | The URL path or [Two.Texture](/docs/effects/texture/) to be used as the bitmap data displayed on the image. |
+|  src  | The URL path or [Two.Texture](/docs/effects/texture/) to be used as the bitmap data displayed on the image. |
 |  ox  | The initial `x` position of the Two.Image. |
 |  oy  | The initial `y` position of the Two.Image. |
 |  width  | The width to display the image at. |

wiki/docs/effects/image/README.md

@@ -30,7 +30,7 @@ A convenient package to display still or animated images through a tiled image s
 
 | Argument | Description |
 | ---- | ----------- |
-|  path  | The URL path or [Two.Texture](/docs/effects/texture/) to be used as the bitmap data displayed on the sprite. |
+|  src  | The URL path or [Two.Texture](/docs/effects/texture/) to be used as the bitmap data displayed on the sprite. |
 |  ox  | The initial `x` position of the Two.Sprite. |
 |  oy  | The initial `y` position of the Two.Sprite. |
 |  cols  | The number of columns the sprite contains. |

wiki/docs/effects/sprite/README.md

@@ -1878,8 +1878,8 @@ The sum of distances between all [Two.Path.vertices](/docs/path/#vertices).
 
 <div class="meta">
 
-  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1613">
-    path.js:1613
+  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1621">
+    path.js:1621
   </a>
 
 </div>
@@ -1925,8 +1925,8 @@ The shape whose alpha property becomes a clipping area for the path.
 
 <div class="meta">
 
-  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1722">
-    path.js:1722
+  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1730">
+    path.js:1730
   </a>
 
 </div>
@@ -1982,8 +1982,8 @@ Tells Two.js renderer if this object represents a mask for another object (or no
 
 <div class="meta">
 
-  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1743">
-    path.js:1743
+  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1751">
+    path.js:1751
   </a>
 
 </div>
@@ -2035,8 +2035,8 @@ When `strokeAttenuation` is `false`, the stroke width is automatically adjusted
 
 <div class="meta">
 
-  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1771">
-    path.js:1771
+  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/path.js#L1779">
+    path.js:1779
   </a>
 
 </div>

wiki/docs/path/README.md

@@ -917,3 +917,48 @@ Works in conjunction with [Two.Shape.fromObject](/docs/shape/#fromobject)
 </div>
 
 
+
+<div class="instance function ">
+
+## dispose
+
+<h2 class="longname" aria-hidden="true"><a href="#dispose"><span class="prefix">Two.Shape.</span><span class="shortname">dispose</span></a></h2>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="description">
+
+Release the shape's bound objects by unbinding relevant events.
+
+</div>
+
+
+
+
+
+<div class="meta">
+
+  <a class="lineno" target="_blank" rel="noopener noreferrer" href="https://github.com/jonobr1/two.js/blob/main/src/shape.js#L354">
+    shape.js:354
+  </a>
+
+</div>
+
+
+
+
+</div>
+
+