tw5-typed 0.4.4 → 0.4.5

package/package.json

@@ -2,7 +2,7 @@
   "description": "Types for tiddlywiki",
   "license": "MIT",
   "name": "tw5-typed",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "url": "https://github.com/tiddly-gittly/tw5-typed",
   "homepage": "https://github.com/tiddly-gittly/tw5-typed",
   "bugs": {

package/src/modules/widgets/index.d.ts

@@ -388,7 +388,10 @@ declare module 'tiddlywiki' {
     ): void;
 
     /**
-     * Add an event listener
+     * Add an event listener.
+     * If the handler is sync, then should return a boolean, `false` means the event is handled and don't propagate, and `true` will be dispatched to the parent widget.
+     * If the handler is async, then it is always propagate to the parent widget.
+     * @returns should propagate to parent widget
      */
     addEventListener(
       type: string,
@@ -399,7 +402,7 @@ declare module 'tiddlywiki' {
      * Dispatch an event to a widget. If the widget doesn't handle the event then it is also dispatched to the parent widget
      * Events added via `addEventListener`, like `tm-notify`, can be invoked by this.
      */
-    dispatchEvent(typeOrEvent: string | Omit<IWidgetEvent, 'widget'>): void;
+    dispatchEvent(widgetEvent: Omit<IWidgetEvent, 'widget'> & { widget?: IWidgetEvent['widget'] }): void;
 
     /**
      * Rebuild a previously rendered widget
@@ -472,13 +475,6 @@ declare module 'tiddlywiki' {
       variables: Record<string, IWidgetVariable>,
     ): boolean;
 
-    /**
-     * The destroy method will be called by parent widget.
-     * If you widget don't have any child widget, you can just write your own tear down logic. If it may have some child widget, don't forget to call original destroy method in the Widget class to destroy children widgets.
-     * @version >=5.3.0
-     * @url https://tiddlywiki.com/dev/#Widget%20%60destroy%60%20method%20examples
-     */
-    destroy(): void;
     removeLocalDomNodes(): void;
   }
 }