@m2c2kit/addons 0.3.17 → 0.3.19

package/dist/index.d.ts

@@ -968,17 +968,26 @@ declare class CountdownTimer extends Composite implements CountdownTimerOptions
     /**
      * Starts the countdown timer.
      *
-     * @remarks Calling start on a running timer or a stopped timer will raise
-     * an error.
+     * @remarks Calling `start()` on a timer whose state is running (already started)
+     * or stopped will raise an error.
      */
     start(): void;
     /**
      * Stops the countdown timer.
      *
-     * @remarks This method is idempotent. Calling stop() on a stopped timer has
-     * no effect and will not raise an error.
+     * @remarks This method is idempotent. Calling `stop()` on a stopped timer
+     * has no effect and will not raise an error. This can be called on a
+     * CountdownTimer in any state.
      */
     stop(): void;
+    /**
+     * Resets the countdown timer to its initial state so it can be started
+     * again.
+     *
+     * @remarks This method is idempotent. Calling reset() multiple times will
+     * not raise an error. This can be called on a CountdownTimer in any state.
+     */
+    reset(): void;
     /**
      * Returns true if the countdown timer is running.
      */

package/dist/index.js

@@ -840,7 +840,7 @@ class Dialog extends Composite {
   }
   set hidden(hidden) {
     this._hidden = hidden;
-    this.needsInitialization;
+    this.needsInitialization = true;
   }
   /**
    * Duplicates a node using deep copy.
@@ -3024,10 +3024,13 @@ class CountdownTimer extends Composite {
   }
   initialize() {
     this.removeAllChildren();
+    this._isRunning = false;
+    this.hasStopped = false;
     if (this.timerShape?.circle === void 0 && this.timerShape?.rectangle === void 0 || this.timerShape?.circle !== void 0) {
       this.timerShapeNode = new Shape({
         circleOfRadius: this.timerShape.circle?.radius ?? 100,
-        fillColor: this.timerShape?.fillColor ?? WebColors.RoyalBlue
+        fillColor: this.timerShape?.fillColor ?? WebColors.RoyalBlue,
+        suppressEvents: true
       });
       this.addChild(this.timerShapeNode);
     } else if (this.timerShape?.rectangle !== void 0) {
@@ -3037,7 +3040,8 @@ class CountdownTimer extends Composite {
           height: this.timerShape?.rectangle?.height ?? 200
         },
         cornerRadius: this.timerShape?.rectangle?.cornerRadius,
-        fillColor: this.timerShape?.fillColor ?? WebColors.RoyalBlue
+        fillColor: this.timerShape?.fillColor ?? WebColors.RoyalBlue,
+        suppressEvents: true
       });
       this.addChild(this.timerShapeNode);
     } else {
@@ -3063,7 +3067,8 @@ class CountdownTimer extends Composite {
           endToEndOf: this.timerShapeNode,
           verticalBias: this.textVerticalBias
         }
-      }
+      },
+      suppressEvents: true
     });
     this.timerShapeNode.addChild(this.timerNumberLabel);
     this.countdownSequence = new Array();
@@ -3132,8 +3137,8 @@ class CountdownTimer extends Composite {
   /**
    * Starts the countdown timer.
    *
-   * @remarks Calling start on a running timer or a stopped timer will raise
-   * an error.
+   * @remarks Calling `start()` on a timer whose state is running (already started)
+   * or stopped will raise an error.
    */
   start() {
     if (this.isRunning) {
@@ -3141,9 +3146,12 @@ class CountdownTimer extends Composite {
     }
     if (this.hasStopped) {
       throw new Error(
-        "CountdownTimer: It has stopped. You cannot start a stopped CountdownTimer. Instead, create a new CountdownTimer."
+        "CountdownTimer: It has stopped. You cannot start a stopped CountdownTimer. Instead, create a new CountdownTimer or call CountdownTimer.reset() before starting."
       );
     }
+    if (this.needsInitialization) {
+      this.initialize();
+    }
     this.run(
       Action.sequence(this.countdownSequence),
       "__countdownSequenceAction"
@@ -3153,8 +3161,9 @@ class CountdownTimer extends Composite {
   /**
    * Stops the countdown timer.
    *
-   * @remarks This method is idempotent. Calling stop() on a stopped timer has
-   * no effect and will not raise an error.
+   * @remarks This method is idempotent. Calling `stop()` on a stopped timer
+   * has no effect and will not raise an error. This can be called on a
+   * CountdownTimer in any state.
    */
   stop() {
     if (this.isRunning) {
@@ -3163,6 +3172,17 @@ class CountdownTimer extends Composite {
       this.hasStopped = true;
     }
   }
+  /**
+   * Resets the countdown timer to its initial state so it can be started
+   * again.
+   *
+   * @remarks This method is idempotent. Calling reset() multiple times will
+   * not raise an error. This can be called on a CountdownTimer in any state.
+   */
+  reset() {
+    this.stop();
+    this.initialize();
+  }
   /**
    * Returns true if the countdown timer is running.
    */
@@ -3242,6 +3262,7 @@ class CountdownTimer extends Composite {
       return;
     }
     this._milliseconds = milliseconds;
+    this.needsInitialization = true;
     this.savePropertyChangeEvent("milliseconds", milliseconds);
   }
   get tickIntervalMilliseconds() {
@@ -3252,6 +3273,7 @@ class CountdownTimer extends Composite {
       return;
     }
     this._tickIntervalMilliseconds = tickIntervalMilliseconds;
+    this.needsInitialization = true;
     this.savePropertyChangeEvent(
       "tickIntervalMilliseconds",
       tickIntervalMilliseconds
@@ -3298,6 +3320,7 @@ class CountdownTimer extends Composite {
       return;
     }
     this._zeroString = zeroString;
+    this.needsInitialization = true;
     this.savePropertyChangeEvent("zeroString", zeroString);
   }
   get timerShape() {
@@ -3308,6 +3331,7 @@ class CountdownTimer extends Composite {
       return;
     }
     this._timerShape = shape;
+    this.needsInitialization = true;
     this.savePropertyChangeEvent("timerShape", shape);
   }
   get textVerticalBias() {
@@ -3318,6 +3342,7 @@ class CountdownTimer extends Composite {
       return;
     }
     this._textVerticalBias = textVerticalBias;
+    this.needsInitialization = true;
     this.savePropertyChangeEvent("textVerticalBias", textVerticalBias);
   }
   /**
@@ -3350,7 +3375,7 @@ M2c2KitHelpers.registerM2NodeClass(
   CountdownTimer
 );
 
-console.log("\u26AA @m2c2kit/addons version 0.3.17 (faa531ea)");
+console.log("\u26AA @m2c2kit/addons version 0.3.19 (33cadc6d)");
 
 export { Button, CountdownScene, CountdownTimer, Dialog, DialogResult, DrawPad, DrawPadEventType, DrawPadItemEventType, Grid, Instructions, LocalePicker, VirtualKeyboard };
 //# sourceMappingURL=index.js.map